Got a question that the wiki doesn't answer? Ask on the forum (preferred), or join us on IRC.



From Wiki
Jump to: navigation, search

When you first run the server with WorldEdit installed, a file will be generated and put into the same directory as the server's files. You can configure various WorldEdit settings with this file. The settings are as follows:

Configuration Value Default Description
wand-item integer 271 ID of the item to use for the wand, a tool that allows the selection of points by left or right clicking. The default is set at a wooden axe.
max-blocks-changed integer -1 A limit of blocks that can be changed in one operation. The value of this option specifies a maximum that a user cannot set a limit past. If you just want to set a default value (which is per-user), use default-max-blocks-changed. A value of -1 indicates no limit.
default-max-blocks-changed integer -1 The default block change limit. If this value is higher than the maximum as specified by max-blocks-changed, the maximum overrides. A value of -1 indicates no default limit.
max-radius integer -1 The maximum radius that can be used for the commands that take a radius parameter. Use -1 for no limit.
max-super-pickaxe-size integer 5 The maximum useable size for the super pickaxe.
register-help true/false true Whether to register the commands with the help system. WorldEdit has quite a few commands.
log-commands true/false false Choose to log used commands to console.
log-file string Path to a log file to log used commands. log-commands must be enabled.
super-pickaxe-drop-items true/false true Drop items with the single super pickaxe.
super-pickaxe-many-drop-items true/false false Drop items with the non-single block super pickaxe modes. Note that these other modes may destroy a lot of blocks and thus drop an excessive amount of blocks.
snapshots-dir string Directory to read snapshots from.
shell-save-type bat Batch file type to use. This is used by the /delchunks command.
use-inventory true/false false Get all required blocks from a player's inventory.
use-inventory-override true/false false Enable the /worldeditunlimited permission that allows a user to bypass inventory if use-inventory is enabled.
disallowed-blocks list of block IDs (a long list) List of block and items that cannot be used. Note that the //stack command does not obey this configuration.
debug-profile true/false false If enabled, the amount of time that a command takes to complete will be printed after each command.

To reload WorldEdit's settings in-game, you can reload the plugin with /reloadplugin WorldEdit, although be aware that this will also reset everyone's history and session and you will be spoken about behind your back.

Using inventory

Enabling the use-inventory configuration setting forces WorldEdit to take blocks only from a player's inventory. In addition, blocks will be "mined" and put into a player's inventory if there is room when blocks are replaced or removed.

When a block cannot be fetched (if, for example, the player has no more of that block), the operation will still continue but be unable to set any further blocks (at least of that type). Players will be given a list of missing block types at the end. If there are any missing blocks that do not require another block (such as a torch, which requires a wall or floor), the operation will abort before these dependent blocks are placed. In the case of failure, //undo and //redo can be utilized to repeat an operation. When a block is placed into a player's inventory as a result of a block being removed, it will be the mined block, or no block in some cases. Glass and bookshelf books are given. Water and lava blocks are not given and are not needed for setting. Note that chests will not copy correctly and instead drop their items when they are removed, preventing the copying and pasting of chests in order to duplicate items. Inventory usage is programmed into a very low level of WorldEdit, and so all operations will use it.

If you want some users to not have to use their inventory, you can enable the use-inventory-override configuration setting and give the /worldeditunlimited permission.

Navigation menu