WorldEdit ${version}

Thanks for choosing WorldEdit! WorldEdit provides you with powerful in-game map editing tools and it is an indispensable tool for both creative and survival play.

First Steps

For Bukkit

  1. Install the plugin: Copy WorldEdit.jar into your Bukkit server's "plugins" directory. Create the folder if it doesn't exist.
  2. Install the bundled scripts Optional: Copy the "craftscripts/" folder into your root folder. These add additional functionality through JavaScript scripts. You also need to download and install Rhino to use these.
  3. Change the configuration: Run your server once (with WorldEdit) and then edit the config.yml file that is generated inside "plugins/WorldEdit". Use /worldedit reload in the console to reload the configuration.
  4. Setup permissions: Visit the WorldEdit wiki to learn the permissions. However, if you're new to WorldEdit, you may not know what permissions to give, so give worldedit.* to play with WorldEdit.

For Single Player Commands

  1. Install Single Player Commands. Be sure to delete "META-INF" to prevent black screens from occuring.
  2. Install WorldEdit: Copy WorldEdit.jar into your ".minecraft/bin" folder. Do not put WorldEdit.jar into minecraft.jar.
  3. Install the bundled scripts Optional: Copy the "craftscripts/" folder into your ".minecraft" folder. These add additional functionality through JavaScript scripts. You also need to download and install Rhino to use these.

Be sure to:

Learning WorldEdit

The best three ways to getting to know WorldEdit are:

  1. Print the reference guide first and foremost. It contains a listing of all WorldEdit commands and allows you to quickly look up a command.
  2. Read the quick start tutorial. This guides you through the basic commands.
  3. Check out the wiki. The wiki is the definitive reference for all commands. It contains verbose information about commands and provides warning information.

Additionally, some users have made some introductory videos.

Remember that WorldEdit has a history. Use //undo to undo and //redo to redo. If you have limited RAM, be sure to clear your history with /clearhistory after large operations.

Warning: The history in the Bukkit version of WorldEdit is reliable, but in Single Player Commands, not all commands can be undone!

Highlighted Features

WorldEdit is largely an in-game map editor where you define areas and modify them, but it has a lot of extra tools that many are unfamiliar with. Once you've mastered the core features, be sure to check out these extras:

Snapshots

Snapshots allow you to restore a cuboid from a backup (even from a .zip). The obvious way to use this is to select a damaged region and use //restore to load the region from a backup. However, sometimes you may want to rollback your world to an older backup but hook WorldEdit's snapshots to the corrupt world (in the opposite way), allowing you to reverse restore. See snapshots.

Scripting

Hate Java? Love JavaScript? WorldEdit has a scripting interface backed by JavaScript, allowing you to write scripts to generate terrain or to fix problems. WorldEdit comes bundled with a few scripts that can be found in the "craftscripts/" folder in the download. Check out the scripting information page.

Some example scripts include:

Brushes and Tools

WorldEdit has "tools" that you can "bind" to an item that you are holding. You can, for example, bind the /repl wood tool so that every time you right click with, say for example, a wooden sword, the block you right click becomes wood. You can also use the /tree tool to generate trees instantly. See the tools page.

Getting Help

If you need help with WorldEdit, two good places to go are:

Contributing

WorldEdit is entirely open source! You can download all of the plugin code to learn from it, modify it for your own self, or even contribute back!

The code is covered under the GNU General Public License v3.

Maven information: ${groupId}/${artifactId}/${version}