WorldEdit has a huge potential for abuse by untrusted players. Therefore, users will not be able to use WorldEdit unless they have the `worldedit` privelege. This is available by default in single player, but in multiplayer the permission must be explicitly given by someone with the right credentials, using the follwoing chat command: `/grant <player name> worldedit`. This privelege can later be removed using the following chat command: `/revoke <player name> worldedit`.

For in-game information about these commands, type `/help <command name>` in the chat. For example, to learn more about the `//copy` command, simply type `/help /copy` to display information relevant to copying a region.

Node names are required for many types of commands that identify or modify specific types of nodes. They can be specified in a number of ways.

Second, by name - the node name that is defined by code, but without the mod name prefix. This is case sensitive and includes values such as "piston_normal_off" and "cactus". Nodes defined in the `default` mod always take precedence over other nodes when searching for the correct one, and if there are multiple possible nodes (such as "a:celery" and "b:celery"), one is chosen in no particular order.

Finally, by full name - the unambiguous identifier of the node, prefixes and all. This is case sensitive and includes values such as "default:stone" and "mesecons:wire_00000000_off".

Regions

The ordering of the values and minor aspects of the syntax, such as trailing commas or newlines, are not guaranteed to stay the same in future versions.

Authors

Punch a nearby node. Be careful of breakable ones such as torches. A black cube reading "1" will appear around the node. This is the marker for WorldEdit position 1.

Look at the place between the two markers: it is now filled with MESE blocks!

Look around marker 1: it is now surrounded by a hollow glass dome!

There are many more commands than what is shown here. See the [Chat Commands Reference](Chat Commands.md) for a detailed list of them, along with descriptions and examples for every single one.

This only scratches the surface of what WorldEdit is capable of. Most of the functions in the WorldEdit GUI correspond to chat commands, and so the [Chat Commands Reference](Chat Commands.md) may be useful if you get stuck.

return "z", dir.z > 0 and 1 or -1

params = "",

description = "Get information about the mod",

func = function(name, param)

worldedit.player_notify(name, "WorldEdit " .. worldedit.version_string .. " is available on this server. Type /help to get a list of commands, or get more information at https://github.com/Uberi/MineTest-WorldEdit/")

end,

})

params = "on/off/1/0/true/false/yes/no/enable/disable/<blank>",

description = "Enable or disable node inspection",

privs = {worldedit=true},

end

end)

params = "",

description = "Reset the region so that it is empty",

privs = {worldedit=true},

end,

})

params = "",

description = "Show markers at the region positions",

privs = {worldedit=true},

end,

})

params = "",

description = "Hide markers if currently shown",

privs = {worldedit=true},

end,

})

params = "",

description = "Set WorldEdit region position 1 to the player's location",

privs = {worldedit=true},

end,

})

params = "",

description = "Set WorldEdit region position 2 to the player's location",

privs = {worldedit=true},

end,

})

params = "set/set1/set2/get",

description = "Set WorldEdit region, WorldEdit position 1, or WorldEdit position 2 by punching nodes, or display the current WorldEdit region",

privs = {worldedit=true},

end,

})

params = "set1/set2 x y z",

description = "Set a WorldEdit region position to the position at (<x>, <y>, <z>)",

privs = {worldedit=true},

end

end)

params = "",

description = "Display the volume of the current WorldEdit region",

privs = {worldedit=true},

end,

})

params = "<node>",

description = "Set the current WorldEdit region to <node>",

privs = {worldedit=true},

end, check_region),

})

params = "<node1> ...",

description = "Fill the current WorldEdit region with a random mix of <node1>, ...",

privs = {worldedit=true},

return check_region(name, param)

params = "<search node> <replace node>",

description = "Replace all instances of <search node> with <replace node> in the current WorldEdit region",

privs = {worldedit=true},

end, check_replace),

})

params = "<search node> <replace node>",

description = "Replace all nodes other than <search node> with <replace node> in the current WorldEdit region",

privs = {worldedit=true},

return math.ceil((4 * math.pi * (tonumber(radius) ^ 3)) / 3) --volume of sphere

params = "<radius> <node>",

description = "Add hollow sphere centered at WorldEdit position 1 with radius <radius>, composed of <node>",

privs = {worldedit=true},

end, check_sphere),

})

params = "<radius> <node>",

description = "Add sphere centered at WorldEdit position 1 with radius <radius>, composed of <node>",

privs = {worldedit=true},

return math.ceil((2 * math.pi * (tonumber(radius) ^ 3)) / 3) --volume of dome

params = "<radius> <node>",

description = "Add hollow dome centered at WorldEdit position 1 with radius <radius>, composed of <node>",

privs = {worldedit=true},

end, check_dome),

})

params = "<radius> <node>",

description = "Add dome centered at WorldEdit position 1 with radius <radius>, composed of <node>",

privs = {worldedit=true},

return math.ceil(math.pi * (tonumber(radius) ^ 2) * tonumber(length))

params = "x/y/z/? <length> <radius> <node>",

description = "Add hollow cylinder at WorldEdit position 1 along the x/y/z/? axis with length <length> and radius <radius>, composed of <node>",

privs = {worldedit=true},

end, check_cylinder),

})

params = "x/y/z/? <length> <radius> <node>",

description = "Add cylinder at WorldEdit position 1 along the x/y/z/? axis with length <length> and radius <radius>, composed of <node>",

privs = {worldedit=true},

end, check_cylinder),

})

params = "x/y/z/? <height> <node>",

description = "Add pyramid centered at WorldEdit position 1 along the x/y/z/? axis with height <height>, composed of <node>",

privs = {worldedit=true},

end),

})

params = "<length> <height> <space> <node>",

description = "Add spiral centered at WorldEdit position 1 with side length <length>, height <height>, space between walls <space>, composed of <node>",

privs = {worldedit=true},

end),

})

params = "x/y/z/? <amount>",

description = "Copy the current WorldEdit region along the x/y/z/? axis by <amount> nodes",

privs = {worldedit=true},

end),

})

params = "x/y/z/? <amount>",

description = "Move the current WorldEdit region along the x/y/z/? axis by <amount> nodes",

privs = {worldedit=true},

end, check_region),

})

params = "x/y/z/? <count>",

description = "Stack the current WorldEdit region along the x/y/z/? axis <count> times",

privs = {worldedit=true},

end),

})

params = "<count> <x> <y> <z>",

description = "Stack the current WorldEdit region <count> times by offset <x>, <y>, <z>",

privs = {worldedit=true},

})

params = "<stretchx> <stretchy> <stretchz>",

description = "Scale the current WorldEdit positions and region by a factor of <stretchx>, <stretchy>, <stretchz> along the X, Y, and Z axes, repectively, with position 1 as the origin",

privs = {worldedit=true},

end),

})

params = "x/y/z/? x/y/z/?",

description = "Transpose the current WorldEdit region along the x/y/z/? and x/y/z/? axes",

privs = {worldedit=true},

end),

})

params = "x/y/z/?",

description = "Flip the current WorldEdit region along the x/y/z/? axis",

privs = {worldedit=true},

end),

})

params = "<axis> <angle>",

description = "Rotate the current WorldEdit region around the axis <axis> by angle <angle> (90 degree increment)",

privs = {worldedit=true},

end),

})

params = "<angle>",

description = "Rotate oriented nodes in the current WorldEdit region around the Y axis by angle <angle> (90 degree increment)",

privs = {worldedit=true},

end),

})

params = "",

description = "Fix the lighting in the current WorldEdit region",

privs = {worldedit=true},

end),

})

params = "",

description = "Hide all nodes in the current WorldEdit region non-destructively",

privs = {worldedit=true},

end),

})

params = "<node>",

description = "Suppress all <node> in the current WorldEdit region non-destructively",

privs = {worldedit=true},

end, check_set),

})

params = "<node>",

description = "Highlight <node> in the current WorldEdit region by hiding everything else non-destructively",

privs = {worldedit=true},

end, check_set),

})

params = "",

description = "Restores nodes hidden with WorldEdit in the current WorldEdit region",

privs = {worldedit=true},

end),

})

params = "<file>",

description = "Save the current WorldEdit region to \"(world folder)/schems/<file>.we\"",

privs = {worldedit=true},

end),

})

params = "<file>",

description = "Set the region defined by nodes from \"(world folder)/schems/<file>.we\" as the current WorldEdit region",

privs = {worldedit=true},

end,

})

params = "<file>",

description = "Load nodes from \"(world folder)/schems/<file>[.we[m]]\" with position 1 of the current WorldEdit region as the origin",

privs = {worldedit=true},

end,

})

params = "<code>",

description = "Executes <code> as a Lua chunk in the global namespace",

privs = {worldedit=true, server=true},

end,

})

params = "<code>",

description = "Executes <code> as a Lua chunk in the global namespace with the variable pos available, for each node in the current WorldEdit region",

privs = {worldedit=true, server=true},

end),

})

params = "<file>",

description = "Save the current WorldEdit region using the Minetest Schematic format to \"(world folder)/schems/<filename>.mts\"",

privs = {worldedit=true},

end),

})

params = "<file>",

description = "Load nodes from \"(world folder)/schems/<file>.mts\" with position 1 of the current WorldEdit region as the origin",

privs = {worldedit=true},

end,

})

params = "start/finish/get",

description = "Begins node probability entry for Minetest schematics, gets the nodes that have probabilities set, or ends node probability entry",

privs = {worldedit=true},

end

)

params = "",

description = "Clears all objects within the WorldEdit region",

privs = {worldedit=true},

--save callback to call later

safe_region_callback[name], safe_region_param[name] = callback, param

end

params = "",

description = "Confirm a pending operation",

func = function(name)

end,

})

params = "",

description = "Confirm a pending operation",

func = function(name)

worldedit.alias_chatcommand = function(alias, original_command)

minetest.log("error", "worldedit_shortcommands: original command " .. original_command .. " does not exist")

return true

end

if minetest.chatcommands[alias] then

minetest.log("error", "worldedit_shortcommands: alias " .. alias .. " already exists")

return true

end

return false