Update CONTRIBUTING.md with template

This commit is contained in:
VorTechnix 2021-07-26 16:29:01 -07:00
parent 2687c4a5f6
commit 77fef22d29
2 changed files with 37 additions and 0 deletions

View File

@ -16,6 +16,41 @@ Additionally, every command should be implemented in its own file. This helps ke
Don't forget to update `init.lua` to `dofile()` the new file(s) you create in each submod :-)
## Chat command template
```lua
-- ███ ██ █████ ███ ███ ███████
-- ████ ██ ██ ██ ████ ████ ██
-- ██ ██ ██ ███████ ██ ████ ██ █████
-- ██ ██ ██ ██ ██ ██ ██ ██ ██
-- ██ ████ ██ ██ ██ ██ ███████
local wea = worldeditadditions
worldedit.register_command("{name}", {
params = "<argument> <argument=default> <option1|option2|...> [<optional_argument> <optional_argument2> ...] | [<optional_argument> [<optional_argument2>]]",
description = "A **brief** description of what this command does",
privs = { worldedit = true },
require_pos = 0, -- Optional | (0|1|2)
parse = function(params_text)
-- Do stuff with params_text
return true, param1, param2
end,
nodes_needed = function(name) --Optional
return worldedit.volume(worldedit.pos1[name], worldedit.pos2[name])
end,
func = function(name, param1, param2)
-- Start a timer
local start_time = wea.get_ms_time()
-- Do stuff
-- Finish timer
local time_taken = wea.get_ms_time() - start_time
minetest.log("This is a logged message!")
return true, "Completed command in " .. wea.format.human_time(time_taken)
end
})
```
## Guidelines
When actually implementing stuff, here are a few guidelines that I recommend to summarise everything:

View File

@ -140,6 +140,8 @@ Contributions are welcome! Please state in your pull request(s) that you release
Please also make sure that the logic for every new command has it's own file. For example, the logic for `//floodfill` goes in `worldeditadditions/floodfill.lua`, the logic for `//overlay` goes in `worldeditadditions/overlay.lua`, etc. More contributing help can be found in [the contributing guide](./Contributing.md)
For more information check out [CONTRIBUTING.md](CONTRIBUTING.md).
I, Starbeamrainbowlabs (@sbrl), have the ultimate final say.