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.
Angles are provided in degrees and a positive angle will result in a clockwise rotation. Multiple rotations can be stacked. Interpolation is not performed so angles should be a multiple of 90 degrees.

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
to modify the variables x, y and z to point to a new block
to fetch. See also https://tinyurl.com/weexpr

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,
which can be specified by the y-coordinate.
E.g. -c x,1,z will select from y=256 to y=511.

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.
Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *

Adblock
detector