查看“WorldEdit”的源代码

{{模板:待完善}}
{{Bukkit Plugin Infobox
|版本=6.1
|兼容服务端版本=1.8.8
|网址=http://dev.bukkit.org/bukkit-plugins/worldedit/}}
[[Category:整地]][[Category:管理]][[Category:创世]][[Category:传送]][[Category:信息]]
[[文件:WorldEdit Logo.png|缩略图|右|WorldEdit图标]]
<br />

=安装=
<br />
# 下载WorldEdit http://dev.bukkit.org/bukkit-plugins/worldedit/files/ <br />
# 解压压缩包(如果为压缩文件) <br />
# 将jar文件放进plugins文件夹 <br />
# 重启服务器 <br />
<br />

=命令=

====参数格式对照====
为便于理解命令写法，每种参数使用特定的格式表示
{| class="wikitable"
|-
! 参数 !! 例子 !! 说明
|-
| <参数> || <数量> || 必须填写的参数，内容为参数中说明的，如数量可以为1,2,3等
|-
| [参数] || [数量] || 非必须填写的参数，内容为参数中说明的，如数量可以为1,2,3等，如不填写会由插件进行判定或使用默认值
|-
| 
<参数A|参数B> 
|| <cuboid|extend> 
|| 需要从给出的多个参数中选择一个填写，必须性依情况不同
|-
| ''参数'' 
|| ''cuboid'' 
|| 参数为给出的字符串，使用时须原样输入
|-
| [-参数A参数B] 
|| [-hb] 
|| 参数为可以使用的标签，从多个单字符中选择需要一个或多个输入，可以输入在命令的任何位置，如[-hb]可以输入-h,-b或者-h -b
|}
===限制===
{| class="wikitable"
|-
! 命令 !! 参数 !! 介绍
|-
| //limit || <限制> || 设置大部分操作方块修改数量的最大上限，只对使用者有效，你可以使用这个命令来避免严重后果的错误，如果在配置文件中设置了最大上限，此命令设置的上限不会覆盖配置文件中设定的的上限
|}

===历史===
{| class="wikitable"
|-
! 命令 !! 参数 !! 介绍
|-
| //undo || [步数] || 撤销你的上一个(或几个)操作
|-
| //redo || [步数] || 重做你上一个(或几个)被撤销的操作
|-
| /clearhistory ||  || 清除你的历史记录
|}

===选区===
{| class="wikitable"
|-
! 命令 !! 参数 !! 介绍
|-
| //wand ||  || 给予你编辑工具（默认为木斧）使用这个工具左键点击来选择第一个位置，右键点击来选择第二个位置
|-
| /toggleeditwand ||  || 切换选择工具模式，使你可以正常使用作为选择工具的物品
|-
| //sel ||
<''cuboid''|''extend''|''poly''|''ellipsoid''|''sphere''|''cyl''> 
|| 设置选区使用的形状
|-
| //desel ||  || 清除当前的选区
|-
| //pos1 ||  || 将你站立的方块上方的方块的位置设置为第一个选区位置
|-
| //pos2 ||  || 将你站立的方块上方的方块的位置设置为第二个选区位置
|-
| //hpos1 ||  || 将你指针所指的方块的位置设置为第一个选区位置
|-
| //hpos2 ||  || 将你指针所指的方块的位置设置为第二个选区位置
|-
| //expand || <数量> || 向你所看的方向扩大选区范围
|-
| //expand || <数量> <方向> || 向指定方向扩大选区范围 (可用方向有 north,south,east,west,up,down)
|-
| //expand || <数量> <反方向数量> [方向] || 同时向两个方向扩大选区范围
|-
| //expand || ''vert'' || 将选区扩大到从天空到基岩
|-
| //contract || <数量> || 向你所看的方向缩小选区范围
|-
| //contract || <数量> <方向> || 向指定方向缩小选区范围 (可用方向有 north,south,east,west,up,down)
|-
| //contract || <数量> <反方向数量> [方向] || 同时向两个方向缩小选区范围
|-
| //outset || [-hv] <数量> || 向所有方向扩大选区范围
|-
| //inset || [-hv] <数量> || 向所有方向缩小选区范围
|-
| //shift || <数量> [方向] || 移动选区范围，不移动选区中的内容
|-
| //size ||  || 得到当前选区的大小
|-
| //count || <方块ID> || 计算选区内指定方块的数量
|-
| //distr || [-c] || 计算选区内的方块分布比例
|}

===选区操作===
{| class="wikitable"
|-
! 命令 !! 参数 !! 介绍
|-
| //set || <方块ID> || 将选区内的所有方块设定为指定方块
|-
| //replace || <到方块ID> || 替换所有非空气方块为指定方块
|-
| //replace || <从方块ID> <到方块ID> || 将所有指定方块替换成另一个指定方块
|-
| //overlay || <方块ID> || 将指定方块放在选区内所有方块上方
|-
| //walls || <方块ID> || 用指定方块在选区四周建立墙壁（不包括屋顶与地面）
|-
| //outline || <方块ID> || 用指定方块在选区周围建立墙壁，屋顶与地面
|-
| //smooth || [迭代次数] || 平滑化选区的高度图
|-
| //deform ||  || 按照几何表达式使选区内容变形
|-
| //hollow ||  || 使选区内部的物体空心
|-
| //regen ||  || 重新生成选择区域
|-
| //move || [数量] [方向] [留存方块ID] || 移动选区内容，可以指定一个方块来填充移动后留空的区域
|-
| //stack || [数量] [方向] || 叠加选区内容
|-
| //naturalize ||  || 将选区表面3格设定为泥土，下面设定为原石
|}

===剪贴板===

{| class="wikitable"
|-
! 命令 !! 参数 !! 介绍
|-
| //copy ||  || 复制当前选区内容，注意你与选区的相对位置将被储存
|-
| //cut ||  || 剪切当前选区内容
|-
| //paste || [-ao] || 粘贴剪贴板内容。如果你使用-a标签，空气方块将会被忽略
|-
| //rotate || <角度> || 旋转剪贴板内容
|-
| //flip || [方向] || 翻转剪贴板内容
|-
| //schematic 或 //schem || ''save'' [格式] <文件名> || 将剪贴板内容保存为schematic文件（mcedit是目前唯一格式）
|-
| //schematic 或 //schem || ''load'' [格式] <文件名> || 将schematic文件加载到剪贴板
|-
| //schematic 或 //schem || ''list'' || 显示所有schematic文件列表
|-
| //schematic 或 //schem || ''formats'' || 显示所有可用的schematic格式
|-
| /clearclipboard || || 清空你的剪贴板内容
|}

===生成===

{| class="wikitable"
|-
! 命令 !! 参数 !! 介绍
|-
| //generate || <方块ID> <方程> || 根据给出的方程生成形状
|-
| //hcyl || <方块ID> <半径> [高度] || 生成一个竖直的空心圆柱体
|-
| //cyl || <方块ID> <半径> [高度] || 生成一个竖直的实心圆柱体
|-
| //sphere || <方块ID> <半径> [""yes""(是否生成在上方)] || 生成一个球体
|-
| //hsphere || <方块ID> <半径> [""yes""(是否生成在上方)] || 生成一个空心球体
|-
| //pyramid || <方块ID> <大小> || 生成一座金字塔
|-
| //hpyramid || <方块ID> <大小> || 生成一座空心金字塔
|-
| //forestgen || [大小] [种类] [密度] || 生成一片森林
|-
| //pumpkins || [大小] || 生成一片南瓜地
|}

===效用性===

{| class="wikitable"
|-
! 命令 !! 参数 !! 介绍
|-
| /toggleplace || || 在第一个选择点与你的位置之间切换
|-
| //fill || <方块> <半径> [深度] || 填充一个洞
|-
| //fillr || <方块> <半径> || 以递归模式填充完全一个洞
|-
| //drain || <半径> || 吸干附近的水或岩浆
|-
| /fixwater || <半径> || 平整附近的水面
|-
| /fixlava || <半径> || 平整附近的岩浆表面
|-
| /removeabove || [大小] [高度] || 移除你上方的方块
|-
| /removebelow || [大小] [高度] || 移除你下方的方块
|-
| /replacenear || <大小> <从方块ID> <到方块ID> || 替换附近的方块
|-
| /removenear || [方块] [范围] || 移除附近的方块
|-
| /snow || [半径] || 模拟降雪
|-
| /thaw || [半径] || 融化附近的积雪
|-
| //ex || [范围] || 扑灭附近的火焰
|-
| /butcher || [半径] || 杀死附近的生物
|-
| /remove || <种类> <范围> || 清除附近的实体，种类有"items"(物品)，"arrows"(箭)，"boats"(船)，"minecarts(矿车)"，"tnt"或"xp"(经验球)
|-
| //green ||  || 绿化附近
|}

===区块工具===

{| class="wikitable"
|-
!  命令 !! 参数 !! 介绍
|-
| /chunkinfo ||  || 得到你目前所在区块的文件名
|-
| /listchunks ||  || 显示使用的区块的列表
|-
| /delchunks ||  || 生成一个删除区块的脚本
|}

===超级镐子===

{| class="wikitable"
|-
! 命令 !! 参数 !! 介绍
|-
| // ||  || 调整超级镐子状态
|-
| /sp single ||  || 切换至单方块超级镐子模式
|-
| /sp area || <范围> || 切换至范围性超级镐子模式
|-
| /sp recur || <范围> || 切换至范围性递归超级镐子模式
|}

===工具===

{| class="wikitable"
|-
! 命令 !! 参数 !! 介绍
|-
| /tool 
|| <''repl''|''cycler''|''floodfill''|''brush''|''lrbuild''|''tree''|''deltree''|''farward''|''info''> 
|| 选择要绑定的工具
|-
| /none ||  || 切换至无工具
|-
| /info ||  || 切换至信息工具
|-
| /tree || [种类] || 切换至树木工具，可用树木种类 [''tree'', ''regular'', ''big'', ''bigtree'', ''redwood'', ''sequoia'', ''tallredwood'', ''tallsequoia'', ''birch'', ''white'', ''whitebark'', ''pine'', ''randredwood'', ''randomredwood'', ''anyredwood'', ''rand'', ''random'']
|-
| //repl || <方块ID> || 切换至方块替换器工具
|-
| //cycler ||  || 切换到数据值滚动工具
|-
| //tool brush 
|| <''sphere''|''smooth''|''gravity''|''cylinder''|''clipboard''|''ex''> 
|| 用/tool 命令选择刷子 (见 /brush)
|}

===刷子===

{| class="wikitable"
|-
! 命令 !! 参数 !! 介绍
|-
| /brush sphere || [-h] <方块ID> <范围> || 切换至球体刷子工具
|-
| /brush cylinder || [-h] <方块ID> <范围> [高度] || 切换至圆柱体刷子工具
|-
| /brush clipboard ||  || 切换至剪贴板刷子工具
|-
| /brush smooth || <范围> [迭代次数] || 切换至平滑刷子工具
|-
| /size || <范围> || 修改当前刷子的范围
|-
| //mat || <方块ID> || 修改当前刷子使用的材料
|-
| //mask ||  || 清除蒙版
|-
| //mask || <蒙版> || 设置蒙版
|-
| //gmask || <蒙版> || 设置全局蒙版
|}

===传送===

{| class="wikitable"
|-
! 命令 !! 参数 !! 介绍
|-
| /unstuck ||  || 传送至最近的空位
|-
| /ascend ||  || 向上传送一层
|-
| /descend ||  || 向下传送一层
|-
| /ceil || [''clearance''] || 传送至顶部
|-
| /thru ||  || 穿过所指的墙壁
|-
| /jumpto ||  || 传送至所指的方块
|-
| /up || [距离] || 向上传送一段距离
|}

===快照===

{| class="wikitable"
|-
! 命令 !! 参数 !! 介绍
|-
| //restore || [快照名] || 从指定的快照恢复
|-
| //snapshot use || <快照名> || 使用特定的快照
|-
| //snapshot list || [数量] || 显示最新的几个快照
|-
| //snapshot before || <日期> || 找到给出日期之前的第一个快照
|-
| //snapshot after || <日期> || 找到给出日期之后的第一个快照
|}

===脚本===

{| class="wikitable"
|-
! 命令 !! 参数 !! 介绍
|-
| /cs || <脚本名> [参数...] || 执行一个脚本
|-
| /.s || [参数...] || 用新的参数执行最后执行的脚本
|-
| /<脚本名>.js || [参数...] || 执行一个JS脚本
|}

===普命令===

{| class="wikitable"
|-
! 命令 !! 参数 !! 介绍
|-
| /searchitem ||  || 用名字搜索一个物品
|-
| /worldedit ||  || WorldEdit命令表
|-
| /worldedit help || [命令] || 显示给出的命令的介绍，或在没有给出命令时列出所有可用命令(同//help)
|-
| //worldedit reload ||  || 重新载入WorldEdit配置文件
|-
| //worldedit version ||  || 显示WorldEdit版本
|-
| //worldedit tz ||  || 暂时性设置你的时区
|-
| //fast ||  || 切换高速性能模式
|}

===生物群系===

{| class="wikitable"
|-
! 命令 !! 参数 !! 介绍
|-
| /biome || || 显示你所在位置的生物群系
|-
| /biomelist || || 显示所有可用的生物群系
|-
| /biomeinfo || [-pt] || 显示所指方块所在位置的生物群系
|-
| //setbiome || [-p] <生物群系> || 设置选区为指定生物群系 -p 参数设置你所在位置的生物群系
|}

=权限=

<pre style="color: red">此列表与上部分列表有些出入(命令数量，标示)且有可能略过期，需要进一步检查</pre>
每个命令可以使用的标示以及介绍见'''命令'''部分

==命令权限节点==
{| class="wikitable"
|-
! 命令 !! 权限 !! 其他写法
|-
| /biomeinfo || worldedit.biome.info || //biomeinfo
|-
| //setbiome || worldedit.biome.set || //setbiome
|-
| /biomelist || worldedit.biome.list || /biomelist<br />/biomels
|-
| /chuckinfo || worldedit.chunkinfo || /chunkinfo
|-
| /listchunks || worldedit.listchunks || /listchunks
|-
| /delchunks || worldedit.delchunks || /delchunks
|-
| //cut || worldedit.clipboard.cut || //cut
|-
| //paste || worldedit.clipboard.paste || //paste
|-
| //schematic ||  || //schematic<br />//schem
|-
|  //schematic formats|| worldedit.schematic.formats || //schematic formats<br />//schematic listformats<br />//schematic f
|-
| //schematic load || worldedit.clipboard.load<br />worldedit.schematic.load || //schematic load <br /> //schematic l
|-
| //schematic list || worldedit.schematic.list || //schematic list<br />//schematic all<br />//schematic ls
|-
| //schematic save || worldedit.clipboard.save<br />worldedit.schematic.save || //schematic save<br />//schematic s
|-
| /clearclipboard || worldedit.clipboard.clear || /clearclipboard 
|-
| //load || worldedit.clipboard.load || //load
|-
| //save || worldedit.clipboard.save || //save 
|-
| //copy || worldedit.clipboard.copy || //copy
|-
| //flip || worldedit.clipboatd.flip || //flip 
|-
| //rotate || worldedit.clipboard.rotate || //rotate
|-
| /we ||  || //we<br />/worldedit
|-
| /we reload || worldedit.reload || /we reload
|-
| /we cui ||  || /we cui
|-
| /we tz ||  || /we tz
|-
| /we version ||  || /we version<br />/we ver
|-
| /we help || worldedit.help || /we help
|-
| //fast || worldedit.fast || //fast
|-
| //gmask || worldedit.global-mask || //gmask<br />/gmask 
|-
| /toggleplace ||  || //toggleplace<br />/toggleplace
|-
| //searchitem ||  || //searchitem<br />//l<br />//search<br />/searchitem
|-
| //limit || worldedit.limit || //limit
|-
| //hcyl || worldedit.generation.cylinder || //hcyl
|-
| //cyl || worldedit.generation.cylinder || //cyl
|-
| //hsphere || worldedit.generation.sphere || //hsphere 
|-
| //sphere || worldedit.generation.sphere || //sphere 
|-
| /forestgen || worldedit.generation.forest || /forestgen 
|-
| /pumpkins || worldedit.generation.pinpkins || /pumpkins 
|-
| //pyramid || worldedit.generation.pyramid || //pyramid 
|-
| //hpyramid || worldedit.generation.pyramid || //hpyramid 
|-
| //generate || worldedit.generation.shape || //generate<br />//gen<br />//g 
|-
| //generatebiome || worldedit.generation.shape<br />worldedit.biome.set || //generatebiome<br />//genbiome<br />//gb 
|-
| //undo || worldedit.history.undo || //undo<br />/undo
|-
| //redo || worldedit.history.redo || //redo<br />/redo 
|-
| //clearhistory || worldedit.history.clear || //clearhistory<br />/clearhistory
|-
| /unstuck || worldedit.navigation.unstuck || /unstuck<br/>/!
|-
| /ascend || worldedit.navigation.ascend || /ascend<br />/asc
|-
| /descend || worldedit.navigation.descend || /descend<br />/desc
|-
| /ceil || worldedit.navigation.ceiling || /ceil
|-
| /thru || worldedit.navigation.thru.command || /thru
|-
| /jumpto || worldedit.navigation.jumpto.command || /jumpto<br />/j
|-
| /up || worldedit.navigation.up || /up
|-
| //hollow || worldedit.region.hollow || //hollow
|-
| //line || worldedit.region.line || //line 
|-
| //curve || worldedit.region.curve || //curve 
|-
| //overlay || worldedit.region.overlay || //overlay
|-
| //center || worldedit.region.center || //center<br />//middle 
|-
| //naturalize || worldedit.region.naturalize || //naturalize 
|-
| //walls || worldedit.region.walls || //walls 
|-
| //faces || worldedit.region.faces || //faces<br />//outline 
|-
| //smooth || worldedit.region.smooth || //smooth 
|-
| //move || worldedit.region.move || //move 
|-
| //regen || worldedit.regen || //regen 
|-
| //deform || worldedit.region.deform || //deform 
|-
| //forest || worldedit.region.forest || //forest 
|-
| //replace || worldedit.region.replace || //replace<br />//re<br />//rep 
|-
| //stack || worldedit.region.stack || //stack 
|-
| //set || worldedit.region.set || //set
|-
| /.s || worldedit.scripting.execute || /.s
|-
| /cs || worldedit.scripting.execute || /cs
|-
| //pos1 || worldedit.selection.pos || //pos1
|-
| //pos2 || worldedit.selection.pos || //pos1
|-
| //hpos1 || worldedit.selection.hpos || //hpos1
|-
| //hpos2 || worldedit.selection.hpos || //hpos2
|-
| //wand || worldedit.wand || //wand
|-
| /toggleeditwand || worldedit.wand.toggle || /toggleeditwand
|-
| //contract || worldedit.selection.contract || //contract
|-
| //outset || worldedit.selection.outset || //outset
|-
| //inset || worldedit.selection.inset || //inset
|-
| //distr || worldedit.analysis.distr || //distr 
|-
| //sel ||  || //sel<br />/; 
|-
| //desel ||  || //desel<br />//deselect 
|-
| //count || worldedit.analysis.count || //count 
|-
| //size || worldedit.selection.size || //size 
|-
| //expand || worldedit.selection.expand || //expand 
|-
| //shift || worldedit.selection.shift || //shift 
|-
| /snapshot ||  || /snapshot<br />/snap ||  
|-
| /snapshot use || worldedit.snapshots.restore || /snapshot use 
|-
| /snapshot sel || worldedit.snapshots.restore || /snapshot sel 
|-
| /snapshot list || worldedit.snapshots.list || /snapshot list 
|-
| /snapshot after || worldedit.snapshots.restore || /snapshot after 
|-
| /snapshot before || worldedit.snapshots.restore || /snapshot before 
|-
| /restore || worldedit.snapshots.restore || /restore<br />//restore 
|-
| // || worldedit.superpickaxe || //<br />/, 
|-
| /superpickaxe ||  || /superpickaxe<br />/pickaxe<br />/sp 
|-
| /superpickaxe single || worldedit.superpickaxe || /superpickaxe single 
|-
| /superpickaxe area || worldedit.superpickaxe.area || /superpickaxe area 
|-
| /superpickaxe recur || worldedit.superpickaxe.recursive || /superpickaxe recur<br />/superpickaxe recursive 
|-
| /tool ||  || /tool 
|-
| /tool none ||  || /tool none 
|-
| /tool tree || worldedit.tool.tree || /tool tree
|-
| /tool repl || worldedit.tool.replacer || /tool repl 
|-
| /tool cycler || worldedit.tool.data-cycler || /tool cycler
|-
| /tool floodfill || worldedit.tool.flood-fill || /tool floodfill<br />/tool flood
|-
| /tool brush ||  || /tool brush<br />/tool br
|-
| /tool brush sphere || worldedit.brush.sphere || /tool brush sphere<br />/tool brush s 
|-
| /tool brush cylinder || worldedit.brush.cylinder || /tool brush cylinder<br />/tool brush cyl<br />/tool brush c
|-
| /tool brush clipboard || worldedit.brush.clipboard || /tool brush clipboard<br />/tool brush copy 
|-
| /tool brush smooth || worldedit.brush.smooth || /tool brush smooth 
|-
| /tool brush ex || worldedit.brush.ex || /tool brush ex<br />/tool brush extinguish 
|-
| /tool brush gravity || worldedit.brush.gravity || /tool brush gravity<br />/tool brush grav 
|-
| /tool brush butcher || worldedit.brush.butcher || /tool brush butcher<br />/tool brush kill 
|-
| /tool deltree || worldedit.tool.deltree || /tool deltree 
|-
| /tool farwand || worldedit.tool.farwand || /tool farwand 
|-
| /tool lrbuild || worldedit.tool.lrbuild || /tool lrbuild<br />/tool /lrbuild 
|-
| /tool info || worldedit.tool.info || /tool info 
|-
| /mat || worldedit.brush.options.material || /mat<br />/material 
|-
| /range || worldedit.brush.options.range || /range 
|-
| /size || worldedit.brush.options.size || /size 
|-
| /mask || worldedit.brush.options.mask || /mask 
|-
| /none ||  || /none 
|-
| /tree || worldedit.tool.tree || /tree 
|-
| /repl || worldedit.tool.replacer || /repl 
|-
| /cycler || worldedit.tool.data-cycler || /cycler 
|-
| /floodfill || worldedit.tool.flood-fill || /floodfill<br />/flood 
|-
| /brush ||  || /brush<br />/br 
|-
| /brush sphere || worldedit.brush.sphere || /brush sphere<br />/brush s 
|-
| /brush cylinder || worldedit.brush.cylinder || /brush cylinder<br />/brush cyl<br />/brush c 
|-
| /brush clipboard || worldedit.brush.clipboard || /brush clipboard<br />/brush copy 
|-
| /brush smooth || worldedit.brush.smooth || /brush smooth
|-
| /brush ex || worldedit.brush.ex || /brush ex<br />/brush extinguish 
|-
| /brush gravity || worldedit.brush.gravity || /brush gravity<br />/brush grav 
|-
| /brush butcher || worldedit.brush.butcher || /brush butcher<br />/brush kill 
|-
| /deltree || worldedit.tool.deltree || /deltree 
|-
| /farwand || worldedit.tool.farwand || /farwand
|-
| /lrbuild || worldedit.tool.lrbuild || /lrbuild<br />//lrbuild 
|-
| /info || worldedit.tool.info || /info 
|-
| //fillr || worldedit.fill.recursive || //fillr
|-
| //drain || worldedit.drain || //drain 
|-
| //fixlava || worldedit.fixlava || //fixlava<br />/fixlava 
|-
| //fixwater || worldedit.fixwater || //fixwater<br />/fixwater 
|-
| //removeabove || worldedit.removeabove || //removeabove<br />/removeabove 
|-
| //removebelow || worldedit.removebelow || //removebelow<br />/removebelow 
|-
| //removenear || worldedit.removenear || //removenear<br />/removenear 
|-
| //replacenear || worldedit.replacenear || //replacenear<br />/replacenear 
|-
| //snow || worldedit.snow || //snow<br />/snow 
|-
| //thaw || worldedit.thaw || //thaw<br />/thaw 
|-
| //green || worldedit.green || //green<br />/green
|-
| //ex || worldedit.extinguish || //ex<br />//ext<br />//extinguish<br />/ex<br />/ext<br />/extinguish 
|-
| /butcher || worldedit.butcher || /butcher || plangbf 
|-
| /remove || worldedit.remove || /remove<br />/rem<br />/rement 
|-
| //fill || worldedit.fill || //fill 
|-
| //help || worldedit.help || //help
|}

==非命令权限节点==
{| class="wikitable"
|-
! 权限节点 !! 介绍
|-
| worldedit.limit.unrestricted || 拥有这个权限的用户可以无视设置的<code>//limit</code>命令的最大上限 
|-
| worldedit.inventory.unrestricted || 如果使用了<code>use-inventory</code>项，拥有这个权限的用户可以无视这个限制
|-
| worldedit.anyblock || 拥有这个权限的用户可以无视<code>disallowed-blocks</code>设置的限制
|-
| worldedit.override.bedrock || 一般情况下超级镐子无法破坏基岩，拥有这个权限的用户可以无视这个限制
|-
| worldedit.navigation.jumpto.tool<br />worldedit.navigation.thru.tool || 使用传送工具的权限
|}

=特性=
了解比如操作历史等WorldEdit的基础特性。
==会话==
在你创建选区或者在游戏内改变你的首选项时，你的相关信息会被储存在一个临时会话中，这个会话在你在线期间一直会处于激活状态。当你断开连接时，你的会话会在被保留10分钟被删除，你可以重新登录来保留你的会话，每个人连接到服务器时的会话是互相分离的。

会话包括:

* 你的当前选区
* 你的操作历史
* 你的方块修改上限
* 你选择的用于恢复的快照
==历史==
你的前15个操作会被保存在你的操作历史中。操作历史会记录WorldEdit改变的方块和之前的方块。如果你希望撤销一个修改，在聊天框中输入 //undo 。如果你改变了想法，你可以使用 //redo 来重做上一个操作。

如果你需要清除你的历史记录，使用 /clearhistory 命令。

==方块支持==
WorldEdit对于不同平台，不同版本以及你的不同配置有不同的方块支持等级。

如果WorldEdit不支持你的平台，你会注意到一些问题：

* 如果没有正确的支持，箱子，熔炉等在复制时不会保存他们的库存
* 如果没有正确的支持，在撤销对于箱子，熔炉等的改变时有可能使他们的内容丢失

{| class="wikitable"
! width="160"| 平台
! 状态
|-
| Bukkit
| Bukkit平台支持需要你使用与你CraftBukkit相对应版本的WorldEdit。WorldEdit 拥有需要特定版本的Bukkit来使用的“NMS 方块”或“适配器”（较新版本中）代码。 每个WorldEdit版本会有一个对应最新Bukkit版本的它们的列表。

如果出现问题，你可能需要升级或降级你的WorldEdit。
|-
| Spigot
| 见 Bukkit。
|-
| Minecraft Forge
| 在WorldEdit 6及以上完全支持。
|-
| MinecraftEdu
| MinecraftEdu 是 Forge 版 WorldEdit的修改，平台支持随MCEdu提供的版本而改变。
|-
| MCPC+
| 大部分版本支持。
|-
| Cauldron
| WorldEdit 5 尚未支持。WorldEdit 6 及以上如果安装Forge版本的WorldEdit即可以完全支持。推荐在使用 WorldEdit 6 及以上时同时安装 Forge 与 Bukkit 版 WorldEdit。
|-
| LiteLoader
| 这是一个非官方平台的 WorldEdit，暂时没有关于支持的相关信息。
|-
| Canary
| 这是一个非官方平台的 WorldEdit，暂时没有关于支持的相关信息。
|}

==物品支持==
在版本 5.4 及以上，所有支持自定义方块的平台 (主要 Bukkit) 会支持储存在方块内的物品。

之前的版本仅有粗略的物品支持，但仅限于第三方修改添加并放置在箱子内的物品 (第三方自定义方块完全不被支持)。

=选区=
==选择选区==
<br/>
<span style="color:red">本部分需要进一步检查</span><br/><br/>
WorldEdit的一个最基本的部分是使用选区进行的操作。举个例子，如果你想把一个方形区域内的草方块换成泥土，你需要告诉WorldEdit这个方形在哪。<br />
WorldEdit提供了多种选择一个要进行修改的选区的方法，这个部分将会向你介绍选择选区和你可以对选区进行的操作。
''提示：你可以选择其他形状如2D多边形，椭球，球体，圆柱体以及其他形状。其他形状的选择方式接下来在这部分会讲到。''

===选择长方体===

WorldEdit允许你以选择长方体的两个角上的点的方式来选择长方体（想象一个3D的长方形）。<br />
下方的图展示了如何用两点形成一个长方体。你选择的长方体必须与地图对齐（他们不能被以一个角度旋转）。<br />

[[文件:WorldEdit Cuboid.png|居中]]
<br />
有许多方法可以用来选择这两个点，你可以混合使用这些方法。

====使用法杖选择 ====

* //wand
<br />

最直观的选择选区的方式是使用法杖。使用 //wand可以得到法杖 (默认为木斧)。用法杖左键点击一个方块会把这个方块位置设定为你要选择的长方体的第一个角。右键点击会选择第二个角 。
<br/>
====选择你的当前位置 ====

* //pos1
* //pos2
<br/>
使用这些命令可以将你所站的方块上方一个方块的位置分别设定为第一个和第二个角。一般使用魔杖可以完成大部分操作，所以一般不会使用到这些命令。
<br/>
====使用指针选择====

* //hpos1
* //hpos2
<br/>
这两个命令会将你指针所指的位置分别设置为第一个和第二个顶点。通过这个方式可以选择远处的点以及方便地选择非常大的长方体选区。

====选择所在区块 ====

* //chunk
<br/>
这个命令会选择你所站区块的所有方块。区块是16x16, 256格高的范围。

===调整选区 ===

==== 扩大选区 ====

* //expand <数量> [方向]
* //expand <数量> <反方向数量> [方向]
* //expand vert
<br/>
这些命令可以简单地以许多方式扩大选区:
* 给出一个方向 (north, south, west, east, up, down)
* 看向一个方向 (仅north, south, west, east)
* 扩大选区到基岩和天空
<br/>
使用 "N", "S", "W", "E", "U" (上), 或 "D" (下) 来指定方向。如果你想看向一个方向，使用"me" 或不输入方向参数来指定那个方向。 你可以指定两个数字来使选区同时向两个方向扩大选区。

;例子：向上收缩
:使用//expand 10 up将选区向上扩大
如图，选区向上扩大
[[文件:WorldEdit Cuboid expansion up.png]]
<br/>
<br/>
使用//expand vert将选区扩展到基岩和天空

====缩小选区 ====

* //contract <数量> [方向]
* //contract <数量> <反方向数量> [方向]
<br/>
这个命令与 '''//expand'''类似。
<br/>
;例子：向下收缩
:选区会向哪边收缩？如果使用了//contract 10 down 选区会从上进行收缩。
[[文件:WorldEdit Cuboid contraction down.png]]
<br/>
=====在两轴同时收缩 =====

这个命令会将选区向内缩小。
<br/>
* //inset <数量> [方向]
* //inset <数量> <反方向数量> [方向]

==== 移动选区位置 ====

* //shift <数量> [方向]
<br/>
移动选区。这个命令的效果类似与向两个相反方向分别进行相同移动量的//expand与//contract。如此会将选区移动一段距离。这个命令不会移动选区中的内容；如果要达到该效果需要使用//move命令。

=== 选区信息 ===

WorldEdit提供了一些可以得到选择的区域的信息的命令。

==== 获得选区大小 ====

* //size [-c]

显示选区内的方块数量。空气方块不会被计算。
<br/>
<code>v.5.5以上</code>使用 -c 标签会对剪贴板进行计算 

==== 获取一种方块的数量 ====

* //count [-d] <方块种类>

显示一种指定方块在选区内的数量。

<code>v.5.5.1 以上</code> 使用 -d 标签可以支持不同附加值的方块。注意使用-d标签是需要给出一个附加值。

例子：
<pre>//count  torch
Counted: 34
//count -d torch
Counted: 0
//count -d torch:1
Counted: 3</pre>

====获取方块分布率====

* //distr [-cd]

显示选区内的方块分布。

例子：
<pre># total blocks: 6
1   (16.667%) Stone #1
2   (33.333%) Cobblestone #4
3   (50.000%) Air #0</pre>


<code>v.5.5以上</code> 使用 -c 标签会对剪贴板内容进行计算。

<code>v.5.5.1以上</code> 使用 -d 标签会对不同附加值的方块进行区分。

;例子： //distr 与 //distr -d 的区别(为比较省略了部分结果输出)

<pre>//distr
...
34      (0.386%) Torch #50
500     (5.682%) Stone brick stairs #109
</pre>
<pre>//distr -d
...
3       (0.034%) Torch #50:1
4       (0.045%) Torch #50:3
7       (0.080%) Torch #50:2
7       (0.080%) Torch #50:4
13      (0.148%) Torch #50:5
46      (0.523%) Stone brick stairs #109:2
48      (0.545%) Stone brick stairs #109:3
62      (0.705%) Stone brick stairs #109:0
64      (0.727%) Stone brick stairs #109:1
68      (0.773%) Stone brick stairs #109:6
69      (0.784%) Stone brick stairs #109:5
71      (0.807%) Stone brick stairs #109:7
72      (0.818%) Stone brick stairs #109:4
</pre>

===选择模式===

====长方体选择模式====
* //sel cuboid

左键点击选择第一个点，右键点击选择第二个点。选区为两个点形成的长方体。

====长方体扩大选择模式====
* //sel extend

<code>v.4.8-SNAPSHOT以上</code> 左键点击选择第一个点。之后的选择点使用右键选择。每次右键选择都会将选区扩大以包含新的选择点。

====多边形选择模式====
* //sel poly

左键点击选择第一个选择点。之后所有的选择点使用右键点击。每次右键点击选择都会增加一个新的点。


====椭球选择模式====
* //sel ellipsoid

左键点击选择中心，右键点击扩大选区。

你可以水平右键点击来选择一个水平椭圆，也可以垂直右键点击来选择一个垂直椭圆。
但如果需要选择一个椭球选区至少需要邮件点击两次。


====球体选择模式====
* //sel sphere
左键点击选择中心，右键点击扩大选区。

====圆柱体选择模式====
* //sel cyl

左键点击选择中心点，右键点击扩大选区。
<br/>
第一次右键点击可以扩大圆柱体的底面，第二次右键点击可以提升圆柱体的高度。


====多面体选择模式====

* //sel convex
<code>v6.0以上</code> 左键点击选择第一个点，其余的点使用右键点击选择。<br/>
//原wiki未更新部分

==选区操作==

选择了选区之后，真正有趣的部分就要开始了。
=== 设定方块  ===

*//set <方块种类>
<br/>
方块的列表可以在 [http://www.minecraftwiki.net/wiki/Data_values Minecraft wiki] 上找到
<br/>
;例子：设定选区为玻璃方块
:<code>//set glass</code>
;例子：删除选区内方块
:<code>//set 0</code>
<br/>
==== 复杂方块图案 ====
<br/>
除使用一种方块之外，可以使用不同方块构成的图案。例如，你可以将一个区域设定为由不同方块按照设定的百分比放置。
<br/>
;例子：设定选区的方块百分比
:<code>//set 25%stone,50%ironore,25%coalore</code>
<br/>
注意要使用''','''否则指令不会生效。
<br/>
如果你要填充一个区域，使用 ''//replace'' 或者 ''//fill''效果更好(接下来会提到)
<br/>
这里描述的百分比格式只是支持的方块图案中的一种。关于其他可以使用的方块图案见'方块图案'部分。
<br/>
=== 替换方块 ===
<br/>
* //replace ''<要替换掉的方块>'' ''<用于替换的方块>''
<br/>
虽然设定方块很有用，但是有时你需要根据一些规则替换一些已有的方块。WorldEdit有三种替换方块的方法：
<br/>
* 将所有非空气方块替换为另一种方块
* 将一种特定方块替换为另一种特定方块
* 将一系列指定方块替换为另一种方块
<br/>
使用''//replace''命令就可以完成这三种操作，让我们来看几个例子。
<br/>
;例子：将所有非空气方块替换为草方块
:<code>//replace grass</code>
<br/>
如果你想选择需要替换掉哪些方块，将它放在最后一个参数之前。
<br/>
;例子：将所有原石方块替换为羊毛方块
:<code>//replace stone cloth</code>
<br/>
如果你想替换掉一系列方块，在它们之间加上逗号即可。
<br/>
;例子：将泥土和草方块都替换为钻石矿
:<code>//replace grass,dirt diamondore</code>
<br/>
自己试试吧！记住你也可以通过替换空气方块的方式填充一个区域（虽然有一个对应的命令，后面会提到）。
<br/>
;例子：将空气方块替换为红石矿
:<code>//replace 0 redstoneore</code>
<br/>
注意''0''代表空气方块，但是你也可以使用''air''。
你可以使用这个命令将空气方块替换为水或岩浆来达到填充区域的效果，但是''//fill''命令更加适合。
<br/>
本命令支持方块图案。
<br/>
=== 修建墙壁 ===
<br/>
有时你需要在你的选区周围建起围墙，包括或不包括房顶。你有两个可以使用的命令：''//outline''和''//walls''。
<br/>
====在正方体四周建立墙壁 ====
<br/>
* //walls <墙体方块>
<br/>
''//walls'' 命令只会在你的选区四周创建墙壁，即会忽略房顶与地板。
<br/>
=== 表面覆盖 ===
<br/>
* //overlay <方块种类>
<br/>
''//overlay''命令允许你在选区内的方块表面覆盖一层另一种方块。<br/>
只有选区内最上方的方块会被覆盖；如果你的选区内有一个洞穴，它不会被覆盖，除非它是开放的，或者你的选区范围没有延伸到洞穴之上。你可以使用这个命令来创建积雪，（虽然WorldEdit有一个可以更好地完成这个操作的命令，会顾及到积雪不应该覆盖所有方块，比如火把上的问题），或者将栅栏覆盖到一个平坦过不平坦的表面。
<br/>
;例子：在选区上覆盖草方块
:<code>//overlay grass</code>
<br/>
<code>v.3.0以上</code> 本命令支持方块图案。
<br/>
=== 堆叠 ===
<br/>
* //stack <次数> [方向]
<br/>
这个命令会向你所看的方向重复放置你的选区内容。
<br/>
使用方法包括
<br/>
* 延长桥梁
* 制作隧道
* 重复一种结构
<br/>
;例子：将选区内容堆叠50次
:<code>//stack 50</code>
<br/>
你也可以指定一个方向，例如"north"，"up" 或 "down"。
<br/>
;例子：将选区内容向上堆叠5次
:<code>//stack 5 up</code>
<br/>
[[文件:WorldEdit Bridge stack.jpg|WorldEdit Bridge stack.jpg]]<br/>
利用WorldEdit延长桥梁
<br/>
//stack命令允许你复制任何方块，无论WorldEdit的方块配置是怎样的。
<br/>
[[文件:WorldEdit Tunnel stack.jpg|WorldEdit Tunnel stack.jpg]]<br/>
简单地延长一个隧道。注意将房顶与地板包括在选区内。
<br/>

=== 移动 ===
<br/>
* //move ''<距离>'' [方向] [填充方块]
<br/>
如果你建了一些东西，然后发现你需要把它向一边移动一点，这个命令十分好用，因为它可以魔法般地移动整个选择区域。<br/>
这个命令接受一个需要移动的距离，一个可选的方向，和一个填充移动后留下的空白的方块种类。方向参数的使用方法''//stack''的相同：你可以使用一个基本的方向 (north, south, west, east)， "up"，"down"，或"me" 来指定你朝向的方向。你不一定需要指定一个方向，因为''me''会被默认使用。
<br/>
;例子：将选区向上移动2格
:<code>//move 2 up</code>
<br/>
默认情况下，你不需要提供一个填充用方块，留下的区域将会是空气方块。如果你需要，可以指定另一种方块。
<br/>
;例子：将选择区域内容向朝向方向移动2方块，原位置留下原石方块
:<code>//move 2 me stone</code>
<br/>
;例子：将选区内容向下移动2方块，复制空气方块
:<code>//move 2 down</code>
<br/>
如果你需要移动一个物体且并不想每次重新选择它，可以使用//move -s <数量> [方向]
<br/>
;例子：将选区内容向下移动2方块，同时移动选区，复制空气方块
:<code>//move -s 2 down</code>
<br/>
复制受WorldEdit的特殊方块支持影响。注意这个因为某些修改操作无法还原，撤销操作也受相同的规则影响。
<pre style="color:red">?</pre>
<br/>
=== 平滑化 ===
<br/>
* //smooth [迭代次数]
<br/>
如果你需要平滑化一个粗糙的物体（如粗糙的山），这个指令可以做到。首先确认你选择了整个区域的选区，之后再使用命令。此外可以额外著名迭代次数，以达到连续多次进行算法计算来使结果成为更加平滑的表面。
<br/>
=== 重新生成 ===
<br/>
* //regen
<br/>
<code>v.4.2以上</code>这个命令会将你的选区重新生成为第一次生成地图时的状态。它会使用地图的种子，所以每次生成总会生成同样的地形。
<br/>
<span style="color:red">注意：如果你的地图是通过外部地图生成器预生成的，或者该地区是在地形生成器修改之前生成的，这个指令不会正常运行</span>
<br/>
===自然化===
<br/>
* //naturalize
<br/>
这个指令会使用原石，泥土与草方块“自然化”选区内容，以顶层草方块，下方3格泥土方块，泥土方块下方原石方块的构造对选区内方块进行替换。这个命令是一个需要使一个区域“看起来自然”
时可以使用的简单指令。
<br/>
[[文件:WorldEdit Naturalize.jpg]]<br/>
使地形看起来自然。
<br/>
=== 放置植物群 ===
<br/>
* //flora
<br/>
这个命令会将草丛与花以及仙人掌分散放置在选区内的草方块和沙子方块上。
<br/>

=== 选区变形 ===
<br/>
* //deform ''<表达式>''
<br/>
<code>v.4.8-SNAPSHOT以上</code> 对选区内容进行一个由用户指定的形变：

* 旋转
* 把你心爱的教堂变成达利风格作品
* 其他任何你能想象的东西
<br/>
标签:
* -r 使用原始坐标，即debug屏（F3）上出现的坐标
* -o 使用原点(0,0,0)位置设定为玩家位置或选区第一选择点的原始坐标，依设置而定
* 如果不使用标签，坐标会被正常化至-1..1
<br/>
变量:
* x, y, z (输入/输出) - 坐标
<br/>
;例子：使地形变得颠簸
:<code><nowiki>//deform y+=0.2*sin(x*10)</nowiki></code>
<br/>

本命令使用表达式解析器。
<br/>

=剪贴板=

=生成=

=工具=
==编辑工具==
==区块工具==
==超级镐子==
==刷子==
==传送==

=从快照恢复=

=其他=
==CraftScript代码==
==方块数据值==
==蒙版==
==树木种类==
=源码=
源代码 : https://github.com/sk89q/worldedit
=其他平台=
==WorldEdit MOD==
MinecraftForum: http://www.minecraftforum.net/forums/mapping-and-modding/minecraft-mods/1272389-worldedit-in-game-map-editor-testing-tool-for
CurseForge: http://minecraft.curseforge.com/projects/worldedit

==WorldEditWrapper (LiteMod)==
MinecraftForum: http://www.minecraftforum.net/forums/mapping-and-modding/minecraft-mods/1294341-worldeditwrapper-use-worldedit-in-single-player