Worldedit

From Nitradopedia EN
Jump to: navigation, search
WorldEdit
Pluginlogo-WorldEdit.png
Servermod: Bukkit‎
Category: World-Editing
Developer: sk89q
Developer Website: sk89q.com/
Description: Allows admins fast and easy
access and editing tools to use in the world
Features: Is used by many other plugins for defining a region
Download: Link

What is Worldedit? (Abbreviation: WE)
WorldEdit is one of the most fundamental Bukkit-plugins. It allows server admins to make big changes in the Minecraft world with very small effort.
It is also used by various different plugins(e.g. LogBlock etc.) as a tool to define certain regions or as a basis of other plugins(e.g. WorldGuard etc.).

Are there any alternatives to WorldEdit?
Yes there is another tool, which has the same functions as WorldEdit.
The plugin is called VoxelSniper and has one big advantage over WorldEdit as you can define regions while you are staying at one spot.
But as said before, WorldEdit is used by other plugins which makes it a requirement. It is also used more because it was the first and original plugin of this kind.


How can I make the defining process easier?
There is a client side add-on which shows your selected region. This can make the whole process a lot easier.

Installing WorldEdit

With the Nitrado-Webinterface

If you aren't in the webinterface already, go to "My Services->Gameserver->Webinterface Login"
Then you have to navigate to "Minecraft->Plugins->Avaible Plugins->WorldEdit.jar->Install"
Done!

Without the Nitrado-Webinterface

Go to the DevBukkit project site and download the plugin which uses your server version.
Now you have to upload the plugin to the plugins folder in your server folder. You can do this by using the FTP server which is explained here.
Done!

Configuration

Before

  • Don't get rid of the indents. They are intended so some entries are in categories (like "max-blocks-changed" is in the "limits" category).
  • DO NOT USE TABS. You MUST use spaces or Bukkit will complain.

The process

There is a file called config.yml in the WorldEdit folder which you can open with editors like Notepad++.

limits:
    max-blocks-changed:
        default: -1
        maximum: -1
    max-radius: -1
    max-super-pickaxe-size: 5
    max-brush-radius: 5
    disallowed-blocks: [6, 7, 14, 15, 16, 26, 27, 28, 29, 39, 31, 32, 33, 34, 36, 37, 38, 39, 40, 46, 50, 51, 56, 59, 69, 73, 74, 75, 76, 77, 81, 83]

max-blocks-changed: A limit of blocks that can be changed in one operation.
max-radius: The maximum radius that can be used for the commands that take a radius parameter. Use -1 for no limit.
max-super-pickaxe-size: The maximum useable size for the super pickaxe.

use-inventory:
    enable: false
    allow-override: true

logging:
    log-commands: false
    file: worldedit.log

log-commands: Choose to log used commands to console.
file: Path to a log file to log used commands. log-commands must be enabled.

super-pickaxe:
    drop-items: true
    many-drop-items: false

drop-items: Drop items with the single super pickaxe.

snapshots:
    directory:

navigation-wand:
    item: 345
    max-distance: 300

scripting:
    timeout: 3000
    dir: craftscripts

saving:
    dir: schematics

history:
    size: 15

wand-item: 271
shell-save-type: 
debug: false

wand-item: 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.

# See http://wiki.sk89q.com/wiki/WorldEdit/Permissions/Bukkit
permissions:
    groups:
        default:
            permissions:
                - /reloadwe
                - /worldeditselect
    users:
        sk89q:
            permissions:
                - /worldedit
                - /reloadwe

Here you are able to specify which users have permission to certain commands. If you are using the plugin "Permissions" you don't need to pay attention to this part.

<spoiler text="Example">

groups:
  Owner:
    permissions:
    - worldedit.*
  Admins:
    permissions:
    - worldedit.*
  Moderator:
    permissions: 
    - worldedit.navigation.* 
  Supporter:
    permissions:
  VIP:
    permissions:  
  Player:
    permissions:
  Guest:
    permissions:
  
users:

</spoiler>


Commands and Permission-Nodes

Command syntax: <command> [-<flags>-] <arguments>
Here is a pretty long list explaining the commands in detail.
<spoiler hide="hide_message">{| class="wikitable" |- ! style="width: 140px;" | Command ! style="width: 140px;" | Permission ! style="width: 170px;" | Aliases ! style="width: 50px;" | Flags ! Description |- | /biomeinfo || worldedit.biome.info || /biomeinfo || pt || Get the biome of the targeted block. |- | //setbiome || worldedit.biome.set || //setbiome || p || Sets the biome of the player's current block or region. |- | /biomelist || worldedit.biome.list || /biomelist
/biomels || || Gets all biomes available. |- | /chunkinfo || worldedit.chunkinfo || /chunkinfo || || Get information about the chunk that you are inside |- | /listchunks || worldedit.listchunks || /listchunks || || List chunks that your selection includes |- | /delchunks || worldedit.delchunks || /delchunks || || Delete chunks that your selection includes |- | //cut || worldedit.clipboard.cut || //cut || e || Cut the selection to the clipboard |- | //paste || worldedit.clipboard.paste || //paste || sao || Paste the clipboard's contents |- | //schematic || || //schematic
//schem || || Schematic-related commands |- | //schematic formats || worldedit.schematic.formats || //schematic formats
//schematic listformats
//schematic f || || List available schematic formats |- | //schematic load || worldedit.clipboard.load, worldedit.schematic.load || //schematic load
//schematic l || f || Load a schematic into your clipboard |- | //schematic list || worldedit.schematic.list || //schematic list
//schematic all
//schematic ls || dn || List available schematics |- | //schematic save || worldedit.clipboard.save, worldedit.schematic.save || //schematic save
//schematic s || || Save a schematic into your clipboard |- | /clearclipboard || worldedit.clipboard.clear || /clearclipboard || || Clear your clipboard |- | //load || worldedit.clipboard.load || //load || || Load a schematic into your clipboard |- | //save || worldedit.clipboard.save || //save || || Save a schematic into your clipboard |- | //copy || worldedit.clipboard.copy || //copy || e || Copy the selection to the clipboard |- | //flip || worldedit.clipboard.flip || //flip || p || Flip the contents of the clipboard. |- | //rotate || worldedit.clipboard.rotate || //rotate || || Rotate the contents of the clipboard |- | /we || || /we
/worldedit || || WorldEdit commands |- | /we reload || worldedit.reload || /we reload || || Reload WorldEdit |- | /we cui || || /we cui || || Complete CUI handshake |- | /we tz || || /we tz || || Set your timezone |- | /we version || || /we version
/we ver || || Get WorldEdit version |- | /we help || worldedit.help || /we help || || Displays help for the given command or lists all commands. |- | //fast || worldedit.fast || //fast || || Toggle fast mode |- | //gmask || worldedit.global-mask || //gmask
/gmask || || Set the global mask |- | //toggleplace || || //toggleplace
/toggleplace || || Switch between your position and pos1 for placement |- | //searchitem || || //searchitem
//l
//search
/searchitem || bi || Search for an item |- | //limit || worldedit.limit || //limit || || Modify block change limit |- | //hcyl || worldedit.generation.cylinder || //hcyl || || Generates a hollow cylinder. |- | //cyl || worldedit.generation.cylinder || //cyl || || Generates a cylinder. |- | //hsphere || worldedit.generation.sphere || //hsphere || || Generates a hollow sphere. |- | //sphere || worldedit.generation.sphere || //sphere || || Generates a filled sphere. |- | /forestgen || worldedit.generation.forest || /forestgen || || Generate a forest |- | /pumpkins || worldedit.generation.pumpkins || /pumpkins || || Generate pumpkin patches |- | //pyramid || worldedit.generation.pyramid || //pyramid || || Generate a filled pyramid |- | //hpyramid || worldedit.generation.pyramid || //hpyramid || || Generate a hollow pyramid |- | //generate || worldedit.generation.shape || //generate
//gen
//g || hroc || Generates a shape according to a formula. |- | //generatebiome || worldedit.generation.shape, worldedit.biome.set || //generatebiome
//genbiome
//gb || hroc || Sets biome according to a formula. |- | //undo || worldedit.history.undo || //undo
/undo || || Undoes the last action |- | //redo || worldedit.history.redo || //redo
/redo || || Redoes the last action (from history) |- | //clearhistory || worldedit.history.clear || //clearhistory
/clearhistory || || Clear your history |- | /unstuck || worldedit.navigation.unstuck || /unstuck
/! || || Escape from being stuck inside a block |- | /ascend || worldedit.navigation.ascend || /ascend
/asc || || Go up a floor |- | /descend || worldedit.navigation.descend || /descend
/desc || || Go down a floor |- | /ceil || worldedit.navigation.ceiling || /ceil || fg || Go to the celing |- | /thru || worldedit.navigation.thru.command || /thru || || Passthrough walls |- | /jumpto || worldedit.navigation.jumpto.command || /jumpto
/j || || Teleport to a location |- | /up || worldedit.navigation.up || /up || fg || Go upwards some distance |- | //hollow || worldedit.region.hollow || //hollow || || Hollows out the object contained in this selection |- | //line || worldedit.region.line || //line || h || Draws a line segment between cuboid selection corners |- | //curve || worldedit.region.curve || //curve || h || Draws a spline through selected points |- | //overlay || worldedit.region.overlay || //overlay || || Set a block on top of blocks in the region |- | //center || worldedit.region.center || //center
//middle || || Set the center block(s) |- | //naturalize || worldedit.region.naturalize || //naturalize || || 3 layers of dirt on top then rock below |- | //walls || worldedit.region.walls || //walls || || Build the four sides of the selection |- | //faces || worldedit.region.faces || //faces
//outline || || Build the walls, ceiling, and floor of a selection |- | //smooth || worldedit.region.smooth || //smooth || n || Smooth the elevation in the selection |- | //move || worldedit.region.move || //move || s || Move the contents of the selection |- | //regen || worldedit.regen || //regen || || Regenerates the contents of the selection |- | //deform || worldedit.region.deform || //deform || ro || Deforms a selected region with an expression |- | //forest || worldedit.region.forest || //forest || || Make a forest within the region |- | //replace || worldedit.region.replace || //replace
//re
//rep || f || Replace all blocks in the selection with another |- | //stack || worldedit.region.stack || //stack || sa || Repeat the contents of the selection |- | //set || worldedit.region.set || //set || || Set all the blocks inside the selection to a block |- | /.s || worldedit.scripting.execute || /.s || || Execute last CraftScript |- | /cs || worldedit.scripting.execute || /cs || || Execute a CraftScript |- | //pos2 || worldedit.selection.pos || //pos2 || || Set position 2 |- | //chunk || worldedit.selection.chunk || //chunk || sc || Set the selection to your current chunk. |- | //pos1 || worldedit.selection.pos || //pos1 || || Set position 1 |- | //hpos1 || worldedit.selection.hpos || //hpos1 || || Set position 1 to targeted block |- | //hpos2 || worldedit.selection.hpos || //hpos2 || || Set position 2 to targeted block |- | //wand || worldedit.wand || //wand || || Get the wand object |- | /toggleeditwand || worldedit.wand.toggle || /toggleeditwand || || Toggle functionality of the edit wand |- | //contract || worldedit.selection.contract || //contract || || Contract the selection area |- | //outset || worldedit.selection.outset || //outset || hv || Outset the selection area |- | //inset || worldedit.selection.inset || //inset || hv || Inset the selection area |- | //distr || worldedit.analysis.distr || //distr || cd || Get the distribution of blocks in the selection |- | //sel || || //sel
/; || || Choose a region selector |- | //desel || || //desel
//deselect || || Deselect the current selection |- | //count || worldedit.analysis.count || //count || d || Counts the number of a certain type of block |- | //size || worldedit.selection.size || //size || c || Get information about the selection |- | //expand || worldedit.selection.expand || //expand || || Expand the selection area |- | //shift || worldedit.selection.shift || //shift || || Shift the selection area |- | /snapshot || || /snapshot
/snap || || Snapshot commands |- | /snapshot use || worldedit.snapshots.restore || /snapshot use || || Choose a snapshot to use |- | /snapshot sel || worldedit.snapshots.restore || /snapshot sel || || Choose the snapshot based on the list id |- | /snapshot list || worldedit.snapshots.list || /snapshot list || || List snapshots |- | /snapshot after || worldedit.snapshots.restore || /snapshot after || || Choose the nearest snapshot after a date |- | /snapshot before || worldedit.snapshots.restore || /snapshot before || || Choose the nearest snapshot before a date |- | /restore || worldedit.snapshots.restore || /restore
//restore || || Restore the selection from a snapshot |- | // || worldedit.superpickaxe || //
/, || || Toggle the super pickaxe pickaxe function |- | /superpickaxe || || /superpickaxe
/pickaxe
/sp || || Select super pickaxe mode |- | /superpickaxe single || worldedit.superpickaxe || /superpickaxe single || || Enable the single block super pickaxe mode |- | /superpickaxe area || worldedit.superpickaxe.area || /superpickaxe area || || Enable the area super pickaxe pickaxe mode |- | /superpickaxe recur || worldedit.superpickaxe.recursive || /superpickaxe recur
/superpickaxe recursive || || Enable the recursive super pickaxe pickaxe mode |- | /tool || || /tool || || Select a tool to bind |- | /tool none || || /tool none || || Unbind a bound tool from your current item |- | /tool tree || worldedit.tool.tree || /tool tree || || Tree generator tool |- | /tool repl || worldedit.tool.replacer || /tool repl || || Block replacer tool |- | /tool cycler || worldedit.tool.data-cycler || /tool cycler || || Block data cycler tool |- | /tool floodfill || worldedit.tool.flood-fill || /tool floodfill
/tool flood || || Flood fill tool |- | /tool brush || || /tool brush
/tool br || || Brush tool |- | /tool brush sphere || worldedit.brush.sphere || /tool brush sphere
/tool brush s || h || Choose the sphere brush |- | /tool brush cylinder || worldedit.brush.cylinder || /tool brush cylinder
/tool brush cyl
/tool brush c || h || Choose the cylinder brush |- | /tool brush clipboard || worldedit.brush.clipboard || /tool brush clipboard
/tool brush copy || a || Choose the clipboard brush |- | /tool brush smooth || worldedit.brush.smooth || /tool brush smooth || n || Choose the terrain softener brush |- | /tool brush ex || worldedit.brush.ex || /tool brush ex
/tool brush extinguish || || Shortcut fire extinguisher brush |- | /tool brush gravity || worldedit.brush.gravity || /tool brush gravity
/tool brush grav || h || Gravity brush |- | /tool brush butcher || worldedit.brush.butcher || /tool brush butcher
/tool brush kill || || Butcher brush |- | /tool deltree || worldedit.tool.deltree || /tool deltree || || Floating tree remover tool |- | /tool farwand || worldedit.tool.farwand || /tool farwand || || Wand at a distance tool |- | /tool lrbuild || worldedit.tool.lrbuild || /tool lrbuild
/tool /lrbuild || || Long-range building tool |- | /tool info || worldedit.tool.info || /tool info || || Block information tool |- | /mat || worldedit.brush.options.material || /mat
/material || || Set the brush material |- | /range || worldedit.brush.options.range || /range || || Set the brush range |- | /size || worldedit.brush.options.size || /size || || Set the brush size |- | /mask || worldedit.brush.options.mask || /mask || || Set the brush mask |- | /none || || /none || || Unbind a bound tool from your current item |- | /tree || worldedit.tool.tree || /tree || || Tree generator tool |- | /repl || worldedit.tool.replacer || /repl || || Block replacer tool |- | /cycler || worldedit.tool.data-cycler || /cycler || || Block data cycler tool |- | /floodfill || worldedit.tool.flood-fill || /floodfill
/flood || || Flood fill tool |- | /brush || || /brush
/br || || Brush tool |- | /brush sphere || worldedit.brush.sphere || /brush sphere
/brush s || h || Choose the sphere brush |- | /brush cylinder || worldedit.brush.cylinder || /brush cylinder
/brush cyl
/brush c || h || Choose the cylinder brush |- | /brush clipboard || worldedit.brush.clipboard || /brush clipboard
/brush copy || a || Choose the clipboard brush |- | /brush smooth || worldedit.brush.smooth || /brush smooth || n || Choose the terrain softener brush |- | /brush ex || worldedit.brush.ex || /brush ex
/brush extinguish || || Shortcut fire extinguisher brush |- | /brush gravity || worldedit.brush.gravity || /brush gravity
/brush grav || h || Gravity brush |- | /brush butcher || worldedit.brush.butcher || /brush butcher
/brush kill || || Butcher brush |- | /deltree || worldedit.tool.deltree || /deltree || || Floating tree remover tool |- | /farwand || worldedit.tool.farwand || /farwand || || Wand at a distance tool |- | /lrbuild || worldedit.tool.lrbuild || /lrbuild
//lrbuild || || Long-range building tool |- | /info || worldedit.tool.info || /info || || Block information tool |- | //fillr || worldedit.fill.recursive || //fillr || || Fill a hole recursively |- | //drain || worldedit.drain || //drain || || Drain a pool |- | //fixlava || worldedit.fixlava || //fixlava
/fixlava || || Fix lava to be stationary |- | //fixwater || worldedit.fixwater || //fixwater
/fixwater || || Fix water to be stationary |- | //removeabove || worldedit.removeabove || //removeabove
/removeabove || || Remove blocks above your head. |- | //removebelow || worldedit.removebelow || //removebelow
/removebelow || || Remove blocks below you. |- | //removenear || worldedit.removenear || //removenear
/removenear || || Remove blocks near you. |- | //replacenear || worldedit.replacenear || //replacenear
/replacenear || f || Replace nearby blocks |- | //snow || worldedit.snow || //snow
/snow || || Simulates snow |- | //thaw || worldedit.thaw || //thaw
/thaw || || Thaws the area |- | //green || worldedit.green || //green
/green || f || Greens the area |- | //ex || worldedit.extinguish || //ex
//ext
//extinguish
/ex
/ext
/extinguish || || Extinguish nearby fire |- | /butcher || worldedit.butcher || /butcher || plangbf || Kill all or nearby mobs |- | /remove || worldedit.remove || /remove
/rem
/rement || || Remove all entities of a type |- | //fill || worldedit.fill || //fill || || Fill a hole |- | //help || worldedit.help || //help || || Displays help for the given command or lists all commands. |}</spoiler>


Usage

1. Give yourself access to the needed commands.
2. Open the Chat and use the "//wand" command. This will give you a tool to define regions(default: wooden axe).
3. Define the desired region by using your tool with a left click on one corner and right click on the opposite corner.
WorldEdit-Cuboid.png

ATTENTION: Please keep in mind that this process uses more and more resources the more blocks you remove/edit at once to the point where the server can start lagging/crash

Ingame:

1. Step: Find two points to use. In this picture wooden planks are used to make it more visible.
2. Step: Select one corner with a left click.
3. Step: Select the other corner of the region with a right click.
4. Step: Use you desired command to edit/delete the region. In my case this would be //set 5. This command is used to fill the region with a different block. If you are wondering, the block I used is the wooden plank. A list of the block ID's can be found here

.

5. Step: You get a message telling you how many blocks have been changed.