When you first run the server with WorldEdit installed, a worldedit.properties 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:
|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.
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.