Worldedit
Содержание:
Schematic and Clipboard Commands¶
(or , , )
Description | Schematic commands for saving/loading areas |
Permissions | , , , , , , |
Usage |
(or , )
Description |
List saved schematics Note: Format is not fully verified until loading. |
Permissions | |
Usage | |
Page to view. | |
Sort by date, oldest first | |
Sort by date, newest first |
(or , )
Description | List available formats |
Permissions | |
Usage |
Description | Load a schematic into your clipboard |
Permissions | , |
Usage | |
File name. | |
Format name. |
(or )
Description | Delete a saved schematic |
Permissions | |
Usage | |
File name. |
Description | Save a schematic into your clipboard |
Permissions | , |
Usage | |
File name. | |
Format name. | |
Overwrite an existing file. |
Description | Copy the selection to the clipboard |
Permissions | |
Usage | |
Also copy entities | |
Also copy biomes | |
Set the include mask, non-matching blocks become air |
Description | Cut the selection to the clipboard |
Permissions | |
Usage | |
Pattern to leave in place of the selection | |
Also cut entities | |
Also copy biomes, source biomes are unaffected | |
Set the exclude mask, non-matching blocks become air |
Description | Paste the clipboard’s contents |
Permissions | |
Usage | |
Skip air blocks | |
Paste at the original position | |
Select the region after pasting | |
No paste, select only. (Implies -s) | |
Paste entities if available | |
Paste biomes if available | |
Only paste blocks matching this mask |
Description |
Rotate the contents of the clipboard Non-destructively rotate the contents of the clipboard. |
Permissions | |
Usage | |
Amount to rotate on the y-axis | |
Amount to rotate on the x-axis | |
Amount to rotate on the z-axis |
Description | Flip the contents of the clipboard across the origin |
Permissions | |
Usage | |
The direction to flip, defaults to look direction. |
Utility Commands¶
Description | Fill a hole |
Permissions | |
Usage | |
The blocks to fill with | |
The radius to fill in | |
The depth to fill |
Description | Fill a hole recursively |
Permissions | |
Usage | |
The blocks to fill with | |
The radius to fill in | |
The depth to fill |
Description | Drain a pool |
Permissions | |
Usage | |
The radius to drain | |
Also un-waterlog blocks |
(or )
Description | Fix lava to be stationary |
Permissions | |
Usage | |
The radius to fix in |
(or )
Description | Fix water to be stationary |
Permissions | |
Usage | |
The radius to fix in |
(or )
Description | Remove blocks above your head. |
Permissions | |
Usage | |
The apothem of the square to remove from | |
The maximum height above you to remove from |
(or )
Description | Remove blocks below you. |
Permissions | |
Usage | |
The apothem of the square to remove from | |
The maximum height below you to remove from |
(or )
Description | Remove blocks near you. |
Permissions | |
Usage | |
The mask of blocks to remove | |
The radius of the square to remove from |
(or )
Description | Replace nearby blocks |
Permissions | |
Usage | |
The radius of the square to remove in | |
The mask matching blocks to remove | |
The pattern of blocks to replace with |
(or )
Description | Simulates snow |
Permissions | |
Usage | |
The radius of the cylinder to snow in | |
The height of the cylinder to snow in | |
Stack snow layers |
(or )
Description | Thaws the area |
Permissions | |
Usage | |
The radius of the cylinder to thaw in | |
The height of the cylinder to thaw in |
(or )
Description | Converts dirt to grass blocks in the area |
Permissions | |
Usage | |
The radius of the cylinder to convert in | |
The height of the cylinder to convert in | |
Also convert coarse dirt |
(or , , , , )
Description | Extinguish nearby fire |
Permissions | |
Usage | |
The radius of the square to remove in |
Description | Kill all or nearby mobs |
Permissions | |
Usage | |
Radius to kill mobs in | |
Also kill pets | |
Also kill NPCs | |
Also kill golems | |
Also kill animals | |
Also kill ambient mobs | |
Also kill mobs with name tags | |
Also kill all friendly mobs (Applies the flags -abgnpt) | |
Also destroy armor stands | |
Also kill water mobs |
(or , )
Description | Remove all entities of a type |
Permissions | |
Usage | |
The type of entity to remove | |
The radius of the cuboid to remove from |
(or , , , )
Description | Evaluate a mathematical expression |
Permissions | |
Usage | |
Expression to evaluate |
Description | Displays help for WorldEdit commands |
Permissions | |
Usage | |
List sub-commands of the given command, if applicable | |
The page to retrieve | |
The command to retrieve help for |
Special Block Data Syntax¶
Some blocks have additional syntax for setting extra information.
Sign Text
You can set text on signs by separating it with a pipe symbol (). Note that if the text has spaces, you must wrap the entire pattern in quotes .
Example: Setting sign text
Simple Example:
//set oak_sign|Line1|Line2
With spaces and rotation:
//set "oak_wall_sign|Hello world|Second|Third line"
Player Heads
You can set the skin of a player head by specifying a username after the pipe symbol.
Example: Setting a skin on a head
//set player_head|dinnerbone
Mob Spawners
You can set the type of mob to be spawned (again via the pipe symbol). Note that the name of the mob must be an . Prefixing minecraft: is optional, modded mobs must have a namespace.
Example: Creating a squid spawner
//set spawner|squid
Tool Commands¶
Description | Binds a tool to the item in your hand |
Usage |
Description | Block stacker tool |
Permissions | |
Usage | |
The max range of the stack | |
The mask to stack until |
Description | Selection wand tool |
Permissions | |
Usage |
Description | Tree generator tool |
Permissions | |
Usage | |
Type of tree to generate |
Description | Block replacer tool |
Permissions | |
Usage | |
The pattern of blocks to place |
Description | Wand at a distance tool |
Permissions | |
Usage |
(or )
Description | Unbind a bound tool from your current item |
Usage |
Description | Floating tree remover tool |
Permissions | |
Usage |
Description | Long-range building tool |
Permissions | |
Usage | |
Pattern to set on left-click | |
Pattern to set on right-click |
(or )
Description | Flood fill tool |
Permissions | |
Usage | |
The pattern to flood fill | |
The range to perform the fill |
Description | Block data cycler tool |
Permissions | |
Usage |
Description | Navigation wand tool |
Permissions | |
Usage |
Description | Block information tool |
Permissions | |
Usage |
Warning
This command is deprecated. Global tool names cause conflicts and will be removed in WorldEdit 8.
Please use instead.
Description | Unbind a bound tool from your current item |
Usage |
(or )
Warning
This command is deprecated. Global tool names cause conflicts and will be removed in WorldEdit 8.
Please use instead.
Description | Selection wand tool |
Permissions | |
Usage |
(or )
Warning
This command is deprecated. Global tool names cause conflicts and will be removed in WorldEdit 8.
Please use instead.
Description | Navigation wand tool |
Permissions | |
Usage |
Warning
This command is deprecated. Global tool names cause conflicts and will be removed in WorldEdit 8.
Please use instead.
Description | Block information tool |
Permissions | |
Usage |
Warning
This command is deprecated. Global tool names cause conflicts and will be removed in WorldEdit 8.
Please use instead.
Description | Tree generator tool |
Permissions | |
Usage | |
Type of tree to generate |
Warning
This command is deprecated. Global tool names cause conflicts and will be removed in WorldEdit 8.
Please use instead.
Description | Block replacer tool |
Permissions | |
Usage | |
The pattern of blocks to place |
Warning
This command is deprecated. Global tool names cause conflicts and will be removed in WorldEdit 8.
Please use instead.
Description | Block data cycler tool |
Permissions | |
Usage |
(or )
Warning
This command is deprecated. Global tool names cause conflicts and will be removed in WorldEdit 8.
Please use instead.
Description | Flood fill tool |
Permissions | |
Usage | |
The pattern to flood fill | |
The range to perform the fill |
Warning
This command is deprecated. Global tool names cause conflicts and will be removed in WorldEdit 8.
Please use instead.
Description | Floating tree remover tool |
Permissions | |
Usage |
Warning
This command is deprecated. Global tool names cause conflicts and will be removed in WorldEdit 8.
Please use instead.
Description | Wand at a distance tool |
Permissions | |
Usage |
(or )
Warning
This command is deprecated. Global tool names cause conflicts and will be removed in WorldEdit 8.
Please use instead.
Description | Long-range building tool |
Permissions | |
Usage | |
Pattern to set on left-click | |
Pattern to set on right-click |
(or )
Description | Toggle the super pickaxe function |
Permissions | |
Usage | |
The new super pickaxe state |
Description | Set the brush mask |
Permissions | |
Usage | |
The mask to set |
(or )
Description | Set the brush material |
Permissions | |
Usage | |
The pattern of blocks to use |
Description | Set the brush range |
Permissions | |
Usage | |
The range of the brush |
Description | Set the brush size |
Permissions | |
Usage | |
The size of the brush |
Loading and Saving¶
WorldEdit can work with “schematic” files to save or load your clipboard to disk.
To save your current clipboard to file, use .
To load a saved schematic, use .
A note on schematic formats
Before WorldEdit version 7 (corresponding to Minecraft 1.13), the files were saved with a “.schematic” file extension in a format that was compatible with many other software such as MCEdit, Redstone Simulator, and more. Unfortunately, the format wasn’t suited for the new block format Mojang was migrating to, so a new format was devised — named the Sponge schematic format, using the extension “.schem”.
Note that WorldEdit can still import old “.schematic” files saved in older versions (or third party programs) through a legacy compatibility layer, but they can no longer be written to.
Relative positions and schematics
Both the origin of the copy and your offset to the copy are saved with the file so that you can load it back later on and paste the copy at its original location or relative to you as if you had copied it. You should be familiar with how and store your relative position.
Note that third party software which uses the format may not necessarily use relative positions as WorldEdit does, so they may not have that information.
Schematic Management
List available schematics
//schem list
The or flag may be used to sort by newest/oldest file modification time. The flag will get a specific page number. Note that the output of this command is interactive — the arrows at the bottom will retrieve the previous/next page automatically, and the “button” on the left will load the schematic.
Deleting schematics
//schem delete <filename>
Listing available formats
//schem listformats
Although the note above only mentions the older “MCEdit” schematic format and the newer “Sponge” schematic format, WorldEdit actually has no limit on how clipboards are stored. Third-party plugins can register new formats with WorldEdit for saving and/or loading.
Schematic Storage
Schematics are saved to and loaded from WorldEdit’s schematic folder, which is named by default, but
can be changed in the config. The folder is not created until you save a schematic in-game.
If you’ve downloaded a schematic somewhere and want to add it, you can make the folder manually. The folder needs
to be inside WorldEdit’s config folder, which is on Bukkit/Spigot/Paper, and
on other platforms. This means that by default the schematics folder is located at or
.
Note
If you want to share schematic folders between servers/installations, or simply want to store them elsewhere, you will have to enable the “allow-symbolic-links” option in the config.
Tip
The save and load commands, although they ask for a file name, can take , in which case a sub-folder will be created in your schematics folder. This can be useful to organize your schematics.
Region Commands¶
Description | Sets all the blocks in the region |
Permissions | |
Usage | |
The pattern of blocks to set |
Description |
Draws line segments between cuboid selection corners or convex polyhedral selection vertices Can only be used with a cuboid selection or a convex polyhedral selection |
Permissions | |
Usage | |
The pattern of blocks to place | |
The thickness of the line | |
Generate only a shell |
Description |
Draws a spline through selected points Can only be used with a convex polyhedral selection |
Permissions | |
Usage | |
The pattern of blocks to place | |
The thickness of the curve | |
Generate only a shell |
(or , )
Description | Replace all blocks in the selection with another |
Permissions | |
Usage | |
The mask representing blocks to replace | |
The pattern of blocks to replace with |
Description | Set a block on top of blocks in the region |
Permissions | |
Usage | |
The pattern of blocks to overlay |
(or )
Description | Set the center block(s) |
Permissions | |
Usage | |
The pattern of blocks to set |
Description | 3 layers of dirt on top then rock below |
Permissions | |
Usage |
Description | Build the four sides of the selection |
Permissions | |
Usage | |
The pattern of blocks to set |
(or )
Description | Build the walls, ceiling, and floor of a selection |
Permissions | |
Usage | |
The pattern of blocks to set |
Description |
Smooth the elevation in the selection Example: ‘//smooth 1 grass_block,dirt,stone’ would only smooth natural surface terrain. |
Permissions | |
Usage | |
# of iterations to perform | |
The mask of blocks to use as the height map |
Description | Move the contents of the selection |
Permissions | |
Usage | |
number of times to apply the offset | |
The offset to move | |
The pattern of blocks to leave | |
Shift the selection to the target location | |
Ignore air blocks | |
Also copy entities | |
Also copy biomes | |
Set the include mask, non-matching blocks become air |
Description | Repeat the contents of the selection |
Permissions | |
Usage | |
# of copies to stack | |
How far to move the contents each stack | |
Shift the selection to the last stacked copy | |
Ignore air blocks | |
Also copy entities | |
Also copy biomes | |
Use block units | |
Set the include mask, non-matching blocks become air |
Description | Regenerates the contents of the selection |
Permissions | |
Usage | |
The seed to regenerate with, otherwise uses world seed | |
Regenerate biomes as well |
Description |
Deforms a selected region with an expression The expression is executed for each block and is expected |
Permissions | |
Usage | |
The expression to use | |
Use the game’s coordinate origin | |
Use the placement’s coordinate origin | |
Use the selection’s center as origin |
Description |
Hollows out the object contained in this selection Thickness is measured in manhattan distance. |
Permissions | |
Usage | |
Thickness of the shell to leave | |
The pattern of blocks to replace the hollowed area with |
Description | Make a forest within the region |
Permissions | |
Usage | |
The type of tree to place | |
The density of the forest |
Pasting¶
Once you have something in your clipboard, you can paste it to world. The last argument is optional: if you want the copy to paste at the same point that it was copied at, type , otherwise the paste will be placed relative to you. Remember that if you are pasting relatively, it will be relative to where you were when you made the initial copy. For example, if you were on top of your castle when you copied it, pasting it would result in the castle being pasted under you.
A primer on how relative positions work for clipboards
Like the copy/cut commands, the paste command also allows the same three flags:
- can be specified to also paste entities, if your clipboard contains any
- can be specified to also paste biomes, if your clipboard contains any
- can be used to specify a mask of blocks to paste. Blocks that do not match the mask will not be pasted.
In addition, there are some additional flags:
Утилиты
//repl — Делает инструмент в вашей руке «заменителем», правой кнопкой меняет выбранный блок на указанный.
//toggleplace
— переключение между первой позицией и вашим текущим положением.
//fill — заполнить отверстия блоком block, в радиусе radius и в глубину depth.
//fillr — рекурсивное заполнение отверстий блоком block, в радиусе radius.
//drain — осушить бассейны воды/лавы в радиусе radius.
//fixwater — уровень близлежащих водоемов.
//fixlava — уровень близлежащих бассейнов лавы.
//removeabove
— убрать блоки над вашей головой.
//removebelow —
убрать блоки под вашими ногами.
//replacenear — заменить блоки на расстоянии size, заменить блоки from-id на блоки to-id.
//removenear — удалить блоки block на расстоянии size.
//snow — покрыть все снегом в радиусе radius.
//thaw — убрать снег в радиусе radius.
//ex
— потушить огонь на расстоянии size. По умолчанию в радиусе 40 блоков.
//butcher
— убить всех мобов в радиусе radius. По умолчанию во всем мире.
// — если ломать блоки киркой, то они ломаются очень быстро.
//regen
— востанавливает выбранный регион. Заново его генерирует.
//limit — максимальное количество блоков используемое при командах. Действует только на вас. Используется для предотвращения катастрофических инцидентов.
Выделение
//wand — дает вам деревянный топор (топор редактирования). ЛКМ по блоку деревянным топором назначает первую позицию, ПКМ по блоку назначает вторую позицию.
//toggleeditwand — отключает деревянный топор. Теперь им можно пользоваться по прямому назначению.
//sel <cuboid|poly> — выбор формы выделяемого региона. cuboid — выделяет куб. poly — выделяет только в плоскости.
//pos1 — назначает первой позицией для выделения блок на котором вы стоите.
//pos2 — назначает второй позицией для выделения блок на котором вы стоите.
//hpos1 — назначает первой позицией для выделения блок на который вы смотрите.
//hpos2 — назначает второй позицией для выделения блок на который вы смотрите.
//chunk — выделяет весь чанк на котором вы находитесь.
//contract <amount> — уменьшает выбранный вами регион на amount блоков в направлении, в которое вы смотрите.
//contract <amount> <direction> — уменьшает выбранный вами регион на amount блоков в направлении direction (north, east, south, west, up, down).
//contract <amount> <reverse-amount> — уменьшает выбранный вами регион в двух направлениях. amount — количество блоков уменьшения в первом направлении, reverse-amount — количество блоков уменьшения в противоположном направлении, direction — направление (north, east, south, west, up, down). Например: //contract 10 7 south — уменьшит выбранный регион на 10 блоков к югу (south) и на 7 блоков к северу (north).
//expand <amount> — расширяет выбранный вами регион на amount блоков в направлении, в которое вы смотрите.
//expand <amount> <direction> — расширяет выбранный вами регион на amount блоков в направлении direction (north, east, south, west, up, down).
//expand <amount> <reverse-amount> — расширяет выбранный вами регион в двух направлениях. amount — количество блоков расширения в первом направлении, reverse-amount — количество блоков расширения в противоположном направлении, direction — направление (north, east, south, west, up, down). Например: //expand 10 7 south — расширит выбранный регион на 10 блоков к югу (south) и на 7 блоков к северу (north).
//expand vert — максимально расширит выбранный вами регион вверх и вниз.
//outset <amount> — Расширяет выбранный регион в каждом направлении.
//inset <amount> — Сужает выбранный регион в каждом направлении.
//shift <amount> — перемещает регион выбора. Не перемещает содержимое региона. amount — расстояние, direction (north, east, south, west, up, down).
//size — введите что-бы узнать размер выделенного региона.
//count <block> — введите что бы узнать сколько блоков чего либо (block) находится в выбранном регионе.
//distr — введите для получения списка блоков находящихся в выбранном регионе.
Selection Commands¶
Description | Set position 1 |
Permissions | |
Usage | |
Coordinates to set position 1 to |
Description | Set position 2 |
Permissions | |
Usage | |
Coordinates to set position 2 to |
Description | Set position 1 to targeted block |
Permissions | |
Usage |
Description | Set position 2 to targeted block |
Permissions | |
Usage |
Description |
Set the selection to your current chunk. This command selects 256-block-tall areas, |
Permissions | |
Usage | |
The chunk to select | |
Expand your selection to encompass all chunks that are part of it | |
Use chunk coordinates instead of block coordinates |
Description | Get the wand object |
Permissions | |
Usage | |
Get a navigation wand |
Description | Remind the user that the wand is now a tool and can be unbound with /tool none. |
Permissions | |
Usage |
Description | Contract the selection area |
Permissions | |
Usage | |
Amount to contract the selection by | |
Amount to contract the selection by in the other direction | |
Direction to contract |
Description | Shift the selection area |
Permissions | |
Usage | |
Amount to shift the selection by | |
Direction to contract |
Description | Outset the selection area |
Permissions | |
Usage | |
Amount to expand the selection by in all directions | |
Only expand horizontally | |
Only expand vertically |
Description | Inset the selection area |
Permissions | |
Usage | |
Amount to contract the selection by in all directions | |
Only contract horizontally | |
Only contract vertically |
Description | Get information about the selection |
Permissions | |
Usage | |
Get clipboard info instead |
Description | Counts the number of blocks matching a mask |
Permissions | |
Usage | |
The mask of blocks to match |
Description | Get the distribution of blocks in the selection |
Permissions | |
Usage | |
Get the distribution of the clipboard instead | |
Separate blocks by state | |
Gets page from a previous distribution. |
(or , , )
Description | Choose a region selector |
Usage | |
Selector to switch to | |
Set default selector |
Description | Expand the selection area |
Permissions | |
Usage | |
Amount to expand the selection by, can be vert to expand to the whole vertical column | |
Amount to expand the selection by in the other direction | |
Direction to expand |
Configuration Files¶
Once you have run your server with WorldEdit installed, you will find the main configuration file generated in a location which depends on your platform.
Bukkit Server
Configuration options for the Bukkit version of WorldEdit are found in , relative to the server root.
Note that the YAML format which Bukkit uses is very sensitive to errors. You must use 4 spaces for indentation (tabs will break the file!), and adhere to YAML’s syntax. If you are unfamiliar with editing YAML files, you can run your config through an online validator (like this one) and ensure that it does not return an error.
Forge/Fabric
Configuration options in Forge/Fabric can be found in the file. On a server, this is relative to the server root (where the main server .jar is). On a single-player installation, this is in your “.minecraft” folder.
Settings¶
Note
Since the underlying platforms are often in various states of development, not all settings will work on all platforms. Please notify us if you find this to be the case.
Setting | Default | Description |
---|---|---|
defaultLocale | default | The default locale to use for translations, defaults to the system locale. |
profile | false | Whether to print out a blocks changed/time info after each operation. |
traceUnflushedSessions | false | Display a debug message when an edit isn’t completed properly. |
disallowedBlocks | <list of blocks> | A list of blocks that cannot be used in patterns (mostly physics blocks that will “pop off” and may severely lag or crash the server if thousands of items are spawned). |
defaultChangeLimit | -1 | The default amount of blocks that can be set in one operation. |
maxChangeLimit | -1 | The maximum amount of blocks for the change limit (set with in-game) |
defaultMaxPolygonalPoints | -1 | The default amount of polygonal points that can be used (), -1 means use maximum |
maxPolygonalPoints | 20 | The maximum amount of polygonal points that can be used (, used if you have ) |
defaultMaxPolyhedronPoints | -1 | The default amount of polyhedron points that can be used (), -1 means use maximum |
maxPolyhedronPoints | 20 | The maximum amount of polyhedron points that can be used (, used if you have ) |
snapshotRepo | If not left empty, the directory name to look for snapshots | |
snapshotsExperimental | false | If true, uses the new snapshot code. Try it out and report bugs! |
maxRadius | -1 | Maximum radius of commands that take a radius |
maxSuperPickaxeSize | 5 | Maximum size of super pickaxe tools |
maxBrushRadius | 6 | Maximum size of brushes |
logCommands | false | Whether to log more informative information on command usage. |
logFile | If logCommands is true, the file to log to. | |
logFormat | : %5$s%6$s%n | The format of command logging |
wandItem | minecraft:wooden_axe | The default item used for selection regions, overriden by existing sessions |
superPickaxeDrop | true | Whether the single super pickaxe mode will drop items for blocks it breaks |
superPickaxeManyDrop | true | Whether multi super pickaxe modes will drop items for blocks they break |
useInventory | false | Require players to have items in their inventory to make edits (this option is not well supported and not recommended) |
useInventoryOverride | false | Allow a permission node to override the above setting |
useInventoryCreativeOverride | false | Allow creative mode to override the above setting |
navigationUseGlass | true | Whether the and commands should place a glass block for the player to stand on if in mid-air |
navigationWand | minecraft:compass | The default item used for the navigation wand which allows and as left-click/right-click, overriden by existing sessions |
navigationWandMaxDistance | 50 | The max distance the navigation wand should trace to find a block to jump to |
scriptTimeout | 3000 | The maximum time a craftscript can run before it is terminated |
calculationTimeout | 100 | The default time an expression can run before it is terminated |
maxCalculationTimeout | 300 | The maximum time an expression can run before termination (changed in game with ) |
allowedDataCycleBlocks | If not empty, a whitelist of blocks which the data cycler tool can be used on | |
saveDir | schematics | The directory in which to save schematics (relative to the worldedit folder) |
scriptsDir | craftscripts | The directory in which to look for craftscripts |
allowSymlinks | false | Whether to allow the above to be symlinked locations (useful for sharing between servers) |
butcherDefaultRadius | -1 | The default radius of the command (-1 for infinite) |
butcherMaxRadius | -1 | The maximum radius of the command |
serverSideCUI | true | Whether to allow the usage of |
defaultVerticalHeight | 256 | The height to use for commands that take an optional height. |
extendedYLimit | false | If true, use slower but unbounded positions. This should only be needed with a mod that extends the height limit. |