mirror of
https://github.com/sbrl/Minetest-WorldEditAdditions.git
synced 2024-11-22 23:42:59 +00:00
Update CONTRIBUTING.md with template
This commit is contained in:
parent
af07a158a8
commit
b4d07e9d75
2 changed files with 37 additions and 0 deletions
|
@ -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 :-)
|
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
|
## Guidelines
|
||||||
When actually implementing stuff, here are a few guidelines that I recommend to summarise everything:
|
When actually implementing stuff, here are a few guidelines that I recommend to summarise everything:
|
||||||
|
|
|
@ -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.
|
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.
|
||||||
|
|
||||||
|
For more information check out [CONTRIBUTING.md](CONTRIBUTING.md).
|
||||||
|
|
||||||
I, Starbeamrainbowlabs (@sbrl), have the ultimate final say.
|
I, Starbeamrainbowlabs (@sbrl), have the ultimate final say.
|
||||||
|
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue