WorldEditAdditions
Extra tools and commands to extend WorldEdit for Minetest
If you can dream of it, it probably belongs here!
WorldEditAdditions adds commands for everything from generating instant forests to advanced geometry to smoothing terrain, and that's barely starting to scratch the surface!
Important News: The master
branch has been renamed to main
, to follow the new standard across the Git ecosystem. If you've installed WorldEditAdditions through git, you will need to re-clone the repository.
Official Discord Server: https://discord.gg/y8VT6HTQr7
Quick Reference
Click a command name to view a detailed explanation of how it works. Particularly with some of the more complex commands (e.g. //erode
) the detailed explanation has a discussion on how it works and reference tables of supported parameters.
Geometry
//ellipsoid <rx> <ry> <rz> <node_name>
//hollowellipsoid <rx> <ry> <rz> <node_name>
//torus <major_radius> <minor_radius> <node_name>
//hollowtorus <major_radius> <minor_radius> <node_name>
//walls <replace_node>
//line [<replace_node> [<radius>]]
(new in v1.10)//hollow [<wall_thickness>]
(new in v1.11)//maze <replace_node> [<path_length> [<path_width> [<seed>]]]
//maze3d <replace_node> [<path_length> [<path_width> [<path_depth> [<seed>]]]]
Misc
//replacemix <target_node> [<chance>] <replace_node_a> [<chance_a>] [<replace_node_b> [<chance_b>]] [<replace_node_N> [<chance_N>]] ....
//floodfill [<replace_node> [<radius>]]
//scale <axis> <scale_factor> | <factor_x> [<factor_y> <factor_z> [<anchor_x> <anchor_y> <anchor_z>]]
(new in v1.11) experimental
Terrain
//overlay <node_name_a> [<chance_a>] <node_name_b> [<chance_b>] [<node_name_N> [<chance_N>]] ...
//layers [<node_name_1> [<layer_count_1>]] [<node_name_2> [<layer_count_2>]] ...
//fillcaves [<node_name>]
//convolve <kernel> [<width>[,<height>]] [<sigma>]
//erode [<snowballs|...> [<key_1> [<value_1>]] [<key_2> [<value_2>]] ...]
experimental
Flora
//bonemeal [<strength> [<chance>]]
//forest [<density>] <sapling_a> [<chance_a>] <sapling_b> [<chance_b>] [<sapling_N> [<chance_N>]] ...
(new in v1.9)//saplingaliases [aliases|all_saplings]
(new in v1.9)
Statistics
Meta
//multi <command_a> <command_b> ....
//many <times> <command>
(new in v1.9)//subdivide <size_x> <size_y> <size_z> <cmd_name> <args>
experimental//ellipsoidapply <command_name> <args>
(new in v1.9)
Extras
Tools
For a fully up-to-date list of available commands, including a full reference with comprehensive explanations and examples, please visit the README here.
Troubleshooting
If you're experiencing issues with this mod, try checking this FAQ before opening an issue.
I get an error saying that worldedit isn't installed
WorldEditAdditions requires that the worldedit
mod is installed as a dependency. Install it and then try launching Minetest (or the minetest-server
) again.
I get an error saying that worldedit.register_command()
is not a function
This is probably because your version of worldedit
is too old. Try updating it. Specifically the worldedit.register_command()
function was only added to worldedit
in December 2019.
I get a crash on startup saying attempt to call field 'alias_command' (a nil value)
Please update to v1.8+. There was a bug in earlier versions that caused a race condition that sometimes resulted in this crash.
Why don't the moretrees trees work with //forest
?
As far as I can tell, the saplings provided by the moretrees
mod don't properly interact with bonemeal from the bonemeal mod, which WorldEditAdditions uses to grow trees. WorldEditAdditions has everything in place needed to support them, but until applying bonemeal to moretrees
saplings results in a tree rather than waiting for one to grow over time, WorldEditAdditions will always fail to place trees provided by the moretrees
mod, unfortunately.
Contributing
Contributions are welcome! Please state in your pull request(s) that you release your contribution under the Mozilla Public License 2.0.
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/lib/floodfill.lua
, the logic for //overlay
goes in worldeditadditions/lib/overlay.lua
, etc.
Want to say hi or leave feedback? Open an issue!
License
This mod is licensed under the Mozilla Public License 2.0, a copy of which (along with a helpful summary as to what you can and can't do with it) can be found in the LICENSE
file in this repository.
All textures are licenced under CC-BY-SA 4.0 (Creative Commons Attribution Share-Alike International 4.0).
If you'd like to do something that the license prohibits, please get in touch as it's possible we can negotiate something.
If WorldEditAdditions has helped you out in a project, please consider adding a little sign in a corner of your project saying so :-)
Must-have if you use WorldEdit a lot!
The functions provided are mostly extremely useful and have practical applications in cleaning up griefed terrain, making buildings (and even 3D mazes!!), filling caves, adding a type of tree to a pre-existing biome, and much more. Unfortunately, a few crashes/bugs still exist, but this is an impressive mod with (hopefully) a bright future - Kudos to sbrl!
I like it and I'll test it
cool new features, love to test them!