WorldEditConfigurationBukkit

When you first run the server with WorldEdit installed, a config.yml file will be generated and put at plugins/WorldEdit/config.yml. You can configure various WorldEdit settings with this file.

Format

The file is written in the YAML format and you must follow these guidelines:

• Do not use tabs. You MUST use spaces or Bukkit will complain. If you use an editor like Notepad++ (recommended for Windows users), you must configure it to "replace tabs with spaces." In Notepad++, this can be changed in Settings > Preferences > Language Menu.
• Don't get rid of the indents. They are indented so some entries are in categories (like "max-blocks-changed" is in the "limits" category.
• If you want to check the format of this file before putting it into WorldEdit, paste it into http://yaml-online-parser.appspot.com/ and see if it gives "ERROR:".
• Lines starting with # are comments and so they are ignored.

Configuration

Note: For every period in the configuration's name as listed below, that means you indent it one level below the previous.

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.
shell-save-type	bash or bat		Batch file type to use. This is used by the /delchunks command.
debug	true/false	false	If enabled, the amount of time that a command takes to complete will be printed after each command.
Limits
limits.max-blocks-changed.maximum	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.
limits.max-blocks-changed.default	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.
limits.max-radius	integer	-1	The maximum radius that can be used for the commands that take a radius parameter. Use -1 for no limit.
limits.max-super-pickaxe-size	integer	5	The maximum useable size for the super pickaxe.
limits.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.
Use inventory
use-inventory.enable	true/false	false	Get all required blocks from a player's inventory.
use-inventory.override	true/false	true	Enable the worldedit.inventory.unrestricted permission that allows a user to bypass inventory if use-inventory is enabled.
Logging
logging.log-commands	true/false	false	Choose to log used commands to console.
logging.file	string		Path to a log file to log used commands. log-commands must be enabled.
Super pickaxe
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
snapshots.directory	string		Directory to read snapshots from. Unless an absolute path is specified, this directory is relative to the bukkit server .jar file.
Navigation wand
navigation-wand.item	integer	345	Item to bind /jumpto (left-click) and /thru (right-click). Default item is the compass.
navigation-wand.max-distance	integer	100	Maximum distance for the wand to work with.
Scripting
scripting.timeout	integer	3000	The number of milliseconds to let CraftScripts run for at most.

To reload WorldEdit's settings in-game, you can reload the plugin with /reloadwe.

Using inventory

Enabling the inventory usage 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 inventory override configuration setting and give the /worldeditunlimited permission.