Minecraft插件百科 - 用户贡献 [zh-cn]

FastAsyncWorldEdit

2021-01-25T16:51:23Z

Mcdarc：附属插件 => 替代插件（https://intellectualsites.github.io/download/fawe.html 处提到 "FAWE is a replacement"）

== <code>FastAsyncWorldEdit</code> ==

<blockquote>FAWE 是 WorldEdit 的一款替代插件，它通过改变大量 WorldEdit 中的核心类，在大幅度提升原插件的性能的同时，也为其大量增添了新功能。</blockquote>

相关链接：
* [https://github.com/boy0001/FastAsyncWorldedit/releases 安装]
* [https://discord.gg/ngZCzbU Discord 聊天频道] | [https://www.spigotmc.org/threads/fast-async-worldedit.100104/ Spigot 论坛]
* [https://ci.athion.net/job/FastAsyncWorldEdit/ 构建版本]
* [https://github.com/boy0001/FastAsyncWorldedit/wiki/Commands 命令]
* [https://github.com/boy0001/FastAsyncWorldedit/wiki/Permissions 权限]
* [https://github.com/boy0001/FastAsyncWorldedit/issues/new 反馈问题|提供建议]

=== 目前支持的平台 ===

* CraftBukkit
* Spigot
* Paper
* Forge
* Sponge

目前停止更新的旧平台：
* Nukkit
* Thermos

=== 汉化 ===

* Jenkins 上从#1209号构建开始已经内置中文
* 汉化文件的修改 [https://github.com/boy0001/FastAsyncWorldedit/blob/master/core/src/main/resources/cn/message.yml Github]

=== 区域限制： ===

<blockquote>当前支持下列区域插件：
</blockquote>
* WorldGuard
* Towny
* GriefPrevention
* PreciousStones
* Factions (mcore, uuid, one)
* Residence
* Regios
* PlotSquared
* PlotMe

<blockquote>你可以在配置中禁用本项，也可以使用 <code>/wea</code> 或者 <code>fawe.bypass</code> 来跳过检查
</blockquote>
=== 记录与回滚操作 ===

<blockquote>请在 <code>config.yml</code> 中启用 <code>use-disk</code> 和 <code>use-database</code> 两个选项来开启 FAWE 插件提供的记录与回滚操作。为了实现记录的功能，首先请安装 [https://www.spigotmc.org/resources/blockshub.331/ BlocksHub] 插件，随后你就能使用以下记录插件之一来记录了：
</blockquote>
* CoreProtect
* LogBlock
* Prism
* HawkEye

<blockquote>给予普通玩家使用 FAWE 回滚操作的权限并不危险，要想跳过记录请使用 <code>//fast</code> 命令
</blockquote>

== 命令 ==
=== 总览 ===
要想在游戏中查看这些命令的话，请使用 <code>//help [类型|命令]</code> ## 命令的用法 
- <code><arg></code> - 一个必需参数 
- <code>[arg]</code> - 一个可选参数 
- <code><arg1|arg2></code> - 在这些选项中选择 
- <code><arg=value></code> - 缺省值 
- <code>-a</code> - 一条命令的标记，如 <code>//<command> -a [命令的标记的值]</code>
## 详阅
* [https://github.com/c7w/FastAsyncWorldedit/wiki/WorldEdit---FAWE-mask-list 蒙版]
* [https://github.com/c7w/FastAsyncWorldedit/wiki/WorldEdit-and-FAWE-patterns 样式]
* [https://github.com/c7w/FastAsyncWorldedit/wiki/Transforms 变换式]

* 未分类的命令
{|
! 别称
! 权限
! 标记
! 使用方法
|-
| //cancel
| fawe.cancel
|

| 取消你当前正在进行的任务
|-
| /plot replaceall
| plots.replaceall
|

| 替换地皮世界中所有的方块
|-
| /plot createfromimage
| plots.createfromimage
|

| 从一张高度图图片开始世界生成： [https://github.com/c7w/FastAsyncWorldedit/wiki/CreateFromImage 更多信息]
|}

=== '''World Edit 命令''' ===
*<code>/we threads</code>
'''权限'''： <code>worldedit.threads</code> 
'''说明'''：显示出目前插件使用的所有线程 
* <code>/we version</code>
'''说明'''：获取当前 WorldEdit / FAWE 插件的版本信息
* <code>/we help [<command>]</code> 
'''权限'''： <code>worldedit.help</code> 
'''说明'''：显示 FAWE 插件的命令帮助信息 
* <code>/we debugpaste</code>
'''权限'''： <code>worldedit.debugpaste</code> 
'''说明'''：将调试信息上传到 hastebin.com 
* <code>/we changelog</code>
'''权限'''： <code>worldedit.changelog</code> 
'''说明'''：查看 FAWE 插件的更新日志 
* <code>/we reload</code>
'''权限'''： <code>worldedit.reload</code> 
'''说明'''：重载插件配置 
* <code>/we tz [timezone]</code>
'''说明'''：设定时区，方便为快照命名 
* <code>/we cui</code>
'''说明'''：完成 CUI 信息交换（内部开发使用）

=== '''Utility 命令''' ===

<blockquote>(一些实用性的命令： [http://wiki.sk89q.com/wiki/WorldEdit/Utilities 更多信息])
</blockquote>

*<code>/remove <type> <radius></code>
'''权限'''： <code>worldedit.remove</code> 
'''描述'''：移除所有指定类型的实体 
* <code>//fill <block> <radius> [depth]</code>
'''权限'''： <code>worldedit.fill</code> 
'''描述'''：填充一块洞 
* <code>//help [<command>]</code>
'''描述'''：显示 WorldEdit 插件的帮助命令 
* <code>//drain <radius></code>
'''权限'''： <code>worldedit.drain</code> 
'''描述'''：移除一片池塘内的水 
* <code>//removenear <block> [size]</code>
'''权限'''： <code>worldedit.removenear</code> 
'''描述'''：移除你附近的方块 
* <code>//fillr <block> <radius> [depth]</code>
'''权限'''： <code>worldedit.fill.recursive</code> 
'''描述'''：递归填充周围的洞 
* <code>//removeabove [size] [height]</code>
'''权限'''： <code>worldedit.removeabove</code> 
'''描述'''：移除你头上方的方块 
* <code>//fixlava <radius></code>
'''权限'''： <code>worldedit.fixlava</code> 
'''描述'''：让岩浆静止 
* <code>//removebelow [size] [height]</code>
'''权限'''： <code>worldedit.removebelow</code> 
'''描述'''：移除你脚下方的方块 
* <code>//fixwater <radius></code>
'''权限'''： <code>worldedit.fixwater</code> 
'''描述'''：让水静止 
* <code>//green [radius] [-f]</code>
'''权限'''： <code>worldedit.green</code> 
'''描述'''：绿化半径中的区域 
* <code>//replacenear <size> <from-id> <to-id> [-f]</code>
'''权限'''： <code>worldedit.replacenear</code> 
'''描述'''：替换附近的方块 
* <code>//snow [radius]</code>
'''权限'''： <code>worldedit.snow</code> 
'''描述'''：模仿下雪 
* <code>/butcher [radius] [-p] [-l] [-a] [-n] [-g] [-b] [-t] [-f] [-r]</code>
'''权限'''： <code>worldedit.butcher</code> 
'''描述'''：击杀附近的怪物，根据半径，如果没有特别给出半径的话则使用配置文件中的默认半径。 可用的标记： -p 也击杀宠物 -n 也击杀 NPC -g 也击杀铁傀儡 -a 也击杀动物。 -b 也击杀中立生物 -t 也击杀带有名字的怪物 -f 相当于这以前所有标记的混合 -r 也击杀盔甲架 -l 目前没有具体作用
* <code>//ex [radius]</code>
'''权限'''： <code>worldedit.extinguish</code> 
'''描述'''：熄灭周围的火
* <code>//thaw [radius]</code>
'''权限'''： <code>worldedit.thaw</code> 
'''描述'''：移除周围的区域中的雪与冰 
* <code>//calc <expression></code>
'''权限'''： <code>worldedit.calc</code> 
'''描述'''：求一个数学表达式的值 
* <code>//confirm</code>
'''描述'''：确认一条命令

=== '''Region 命令''' ===

<blockquote>(一些对区域起作用的命令： [http://wiki.sk89q.com/wiki/WorldEdit/Region_operations 更多信息])
</blockquote>

*<code>//replace [from-mask] <to-pattern> [-f]</code>
'''权限'''： <code>worldedit.region.replace</code> 
'''说明'''：用给定的方块替换选区中所有另一给定的方块
* <code>//stack [count] [direction] [-s] [-a] [-m]</code>
'''权限'''： <code>worldedit.region.stack</code> 
'''说明'''：堆叠复制选区中的内容 标记： -s 将选区移动到最后一次被堆叠复制的区域 -a 跳过空气方块
* <code>//set [pattern]</code>
'''权限'''： <code>worldedit.region.set</code> 
'''说明'''：将选区填充为给定方块 
* <code>//fall [replace] [-m]</code>
'''权限'''： <code>worldedit.region.fall</code> 
'''说明'''：让选区中的方块自然掉落 -m 标记仅会让方块在垂直方向上下落 
* <code>//faces <block></code>
'''权限'''： <code>worldedit.region.faces</code> 
'''说明'''：建造出选区的墙壁，天花板和地板
* <code>//center <block></code>
'''权限'''： <code>worldedit.region.center</code> 
'''说明'''：填充出选区的中心方块
* <code>//hollow [<thickness>[ <block>]]</code>
'''权限'''： <code>worldedit.region.hollow</code> 
'''说明'''：将本区域设置为中空 可以设置“中空”的部分用什么方块来填充 厚度用[[https://baike.baidu.com/item/%E6%9B%BC%E5%93%88%E9%A1%BF%E8%B7%9D%E7%A6%BB/743092?fr=aladdin 曼哈顿距离]]来计算。
* <code>//smooth [iterations] [-n]</code>
'''权限'''： <code>worldedit.region.smoothsnow</code> 
'''说明'''：将区域平滑化 -n 标记仅更改自然生成的方块。 -s 标记只更改雪方块。
* <code>//nbtinfo</code>
'''权限'''： <code>worldedit.nbtinfo</code> 
'''说明'''：查看一个方块的NBT信息 
* <code>//setskylight</code>
'''权限'''： <code>worldedit.light.set</code> 
'''说明'''：设置一个选区的天空亮度 
* <code>//line <block> [thickness] [-h]</code>
'''权限'''： <code>worldedit.region.line</code> 
'''说明'''：以长方体选择区域的两个对角绘制出一条对角线线段。 仅能够在长方体选区中使用。 可用的标记： -h 仅会生成外壳
* <code>//getlighting</code>
'''权限'''： <code>worldedit.light.fix</code> 
'''说明'''：获取某位置的亮度信息 
* <code>//overlay <block></code>
'''权限'''： <code>worldedit.region.overlay</code> 
'''说明'''：在给定区域的顶层方块上方覆盖给定方块 
* <code>//wea</code>
'''权限'''： <code>fawe.admin</code> 
'''说明'''：跳过区域的权限检测限制 
* <code>//wer</code>
'''权限'''： <code>fawe.worldeditregion</code> 
'''说明'''：将当前你有权限更改的区域设为选区 
* <code>//fixlighting</code>
'''权限'''： <code>worldedit.light.fix</code> 
'''说明'''：修复某位置的光照 
* <code>//removelight</code>
'''权限'''： <code>worldedit.light.remove</code> 
'''说明'''：移除选区中的光照 
* <code>//curve <block> [thickness] [-h]</code>
'''权限'''： <code>worldedit.region.curve</code> 
'''说明'''：过选择的点画一条曲线。 只能在使用凸多面体选区类型时才能使用。 Flags: -h 仅会生成外壳 
* <code>//naturalize</code>
'''权限'''： <code>worldedit.region.naturalize</code> 
'''说明'''：顶层覆盖3层泥土，下面填充为石头 
* <code>//walls <block></code>
'''权限'''： <code>worldedit.region.walls</code> 
'''说明'''：围上选区的四边，即将选区用墙围起来 
* <code>//setblocklight</code>
'''权限'''： <code>worldedit.light.set</code> 
'''说明'''：设置选区中的方块亮度 
* <code>//lay <block></code>
'''权限'''： <code>worldedit.region.overlay</code> 
'''说明'''：设置选区的顶层方块 
* <code>//move [count] [direction] [leave-id] [-s]</code>
'''权限'''： <code>worldedit.region.move</code> 
'''说明'''：将选区中的内容移动。. -s 标记会将选区设定到目标位置。 -b 也会复制生物群系 -e 忽略实体 -a 忽略空气 自动使用 <leave-id> 填充被移动区域。 
* <code>//forest [type] [density]</code>
'''权限'''： <code>worldedit.region.forest</code> 
'''说明'''：在区域内生成森林 
* <code>//flora [density]</code>
'''权限'''： <code>worldedit.region.flora</code> 
'''说明'''：在区域内生成植物群
* <code>//deform <expression> [-r] [-o]</code>
'''权限'''： <code>worldedit.region.deform</code> 
'''说明'''：使用给定的表达式使区域变形 表达式对每个方块都会执行，它可以 将方块的x，y，z修改到新方块的位置 来实现。详阅 tinyurl.com/wesyntax。 
* <code>//regen [biome] [seed]</code>
'''权限'''： <code>worldedit.regen</code> 
'''说明'''：重新生成当前选区中的地图。 注意：这条命令会按照区块为单位来执行， 即会自动将选区内的所有区块自动重新生成。

=== '''Selection 命令''' ===

<blockquote>(改变你的选区位置，选区的模式或是查看关于你的选区的信息： [http://wiki.sk89q.com/wiki/WorldEdit/Selection 更多信息])
</blockquote>

* <code>//count <block> [-d]</code>
'''权限'''： <code>worldedit.analysis.count</code> 
'''说明'''：为当前选区中某种类型的方块计数 
* <code>//size [-c]</code>
'''权限'''： <code>worldedit.selection.size</code> 
'''说明'''：获取当前选区的信息 
* <code>//expand <amount> [reverse-amount] <direction></code>
'''权限'''： <code>worldedit.selection.expand</code> 
'''说明'''：延展选区区域 
* <code>//shift <amount> [direction]</code>
'''权限'''： <code>worldedit.selection.shift</code> 
'''说明'''：移动选区区域 
* <code>//sel [cuboid|extend|poly|ellipsoid|sphere|cyl|convex] [-d]</code>
'''说明'''：选择选区类型 
* <code>//contract <amount> [reverse-amount] [direction]</code>
'''权限'''： <code>worldedit.selection.contract</code> 
'''说明'''：缩小选区区域 
* <code>//pos1 [coordinates]</code>
'''权限'''： <code>worldedit.selection.pos</code> 
'''说明'''：设置选取点1 
* <code>//pos2 [coordinates]</code>
'''权限'''： <code>worldedit.selection.pos</code> 
'''说明'''：设置选取点2 
* <code>//chunk [x,z coordinates] [-s] [-c]</code>
'''权限'''： <code>worldedit.selection.chunk</code> 
'''说明'''：将选取范围设置为当前你所在的区块。 使用 -s 标记，则你目前选区范围会扩展到包含目前选区范围的全部区块 也可以使用给定的坐标，这会替代你的 当前位置。使用-c来指定区块坐标， 否则将自动使用全局坐标。 （举个例子，全局坐标5,5和 -c 0,0 所指代的位置是相同的）
* <code>//hpos1</code>
'''权限'''： <code>worldedit.selection.hpos</code> 
'''说明'''：将选取点1设置为看向的方块 
* <code>//wand</code>
'''权限'''： <code>worldedit.wand</code> 
'''说明'''：获取魔杖物品 
* <code>/toggleeditwand</code>
'''权限'''： <code>worldedit.wand.toggle</code> 
'''说明'''：切换编辑魔杖功能的启用与否 
* <code>//hpos2</code>
'''权限'''： <code>worldedit.selection.hpos</code> 
'''说明'''：将选取点2设置为看向的方块 
* <code>//outset <amount> [-h] [-v]</code>
'''权限'''： <code>worldedit.selection.outset</code> 
'''说明'''：使用给定的数值，在所有方向上延展选区。 可用标记： -h 仅会延展横向 -v 仅会延展纵向 
* <code>//distr [-c] [-d]</code>
'''权限'''： <code>worldedit.analysis.distr</code> 
'''说明'''：获得选区内方块的分布情况。 -c 标记会获得你剪切板内容的分布情况。 -d 标记会将数据值不同的方块分开统计 
* <code>//inset <amount> [-h] [-v]</code>
'''权限'''： <code>worldedit.selection.inset</code> 
'''说明'''：使用给定的数值，在所有方向上缩小选区。 可用标记： -h 仅会缩小横向 -v 仅会缩小纵向

=== '''History 命令''' ===

<blockquote>(能够撤销操作，反撤销操作，清除历史的相关命令： [http://wiki.sk89q.com/wiki/WorldEdit/Features#History 更多信息])
</blockquote>

* <code>//redo [times] [player]</code>
'''权限'''： <code>worldedit.history.redo</code> 
'''说明'''：（从历史记录中）反撤销上个操作 
* <code>//clearhistory</code>
'''权限'''： <code>worldedit.history.clear</code> 
'''说明'''：清除你的历史记录 
* <code>//undo [times] [player]</code>
'''权限'''： <code>worldedit.history.undo</code> 
'''说明'''：撤销上个操作 
* <code>//frb <user=Empire92> <radius=5> <time=3d4h></code>
'''权限'''： <code>worldedit.history.rollback</code> 
'''说明'''：撤销某个给定的操作。 - 时间使用以下单位： s（秒）, m（分钟）, h（小时）, d（天）, y（年）。 - 从硬盘中导入： /frb #import

=== '''Schematic 命令''' ===

<blockquote>(跟 schematic 文件有关的命令)
</blockquote>
* <code>/schematic load [<format>] <filename></code>
'''权限'''： <code>worldedit.clipboard.load</code>, <code>worldedit.schematic.load</code>, <code>worldedit.schematic.upload</code>, <code>worldedit.schematic.load.other</code> 
'''说明'''：将某个schematic文件导入到你的剪切板中 
* <code>/schematic delete <filename></code>
'''权限'''： <code>worldedit.schematic.delete</code> 
'''说明'''：将某个schematic文件从文件列表中移除 
* <code>/schematic list [mine|<filter>] [page=1] [-d] [-n] [-p]</code>
'''权限'''： <code>worldedit.schematic.list</code> 
'''说明'''：列出所有schematic路径下的可用文件 -p <页码数> 能够列出指定页面的文件 -f <format> 启用格式限制 
* <code>/schematic save [<format>] <filename></code>
'''权限'''： <code>worldedit.clipboard.save</code>, <code>worldedit.schematic.save</code>, <code>worldedit.schematic.save.other</code> 
'''说明'''：将你的剪切板中的内容储存到schematic文件中 
* <code>/schematic remap</code>
'''权限'''： <code>worldedit.schematic.remap</code> 
'''说明'''：将剪切板在MCPE/PC的格式间进行转换
* <code>/schematic formats</code>
'''权限'''： <code>worldedit.schematic.formats</code> 
'''说明'''：列出所有可用的格式 
* <code>/schematic loadall [<format>] <filename|url></code>
'''权限'''： <code>worldedit.clipboard.load</code>, <code>worldedit.schematic.load</code>, <code>worldedit.schematic.upload</code> 
'''说明'''：读取多个剪切板 -r 标记可以启用随机位置旋转

=== '''Clipboard 命令''' ===

<blockquote>(跟复制和粘贴方块有关的命令： [https://goo.gl/z2ScQR 更多信息])
</blockquote>

* <code>//copy [-e] [-m]</code>

'''权限'''： <code>worldedit.clipboard.copy</code> 
'''说明'''：将选区中的内容复制到剪切板中 可用标记： -e 跳过复制实体 -m 设置资源蒙版，蒙版外的方块会作为空气复制 -b 也会复制生物群系 警告：实体的粘贴不能通过命令撤销！ 
* <code>//flip [<direction>]</code>
'''权限'''： <code>worldedit.clipboard.flip</code> 
'''说明'''：以复制点为基点，对剪切板中的内容进行镜面翻转。 
* <code>//rotate <y-axis> [<x-axis>] [<z-axis>]</code>
'''权限'''： <code>worldedit.clipboard.rotate</code> 
'''说明'''：在不产生破坏的情况下，旋转剪切板中的内容。 角度需要输入度数，正数代表进行顺时针旋转。你也可以堆叠进行多次旋转。我们并不接受非90度倍数的值，否则将不会起任何作用，所以输入的度数应该是90的倍数。 
* <code>//lazycopy [-e] [-m]</code>
'''权限'''： <code>worldedit.clipboard.lazycopy</code> 
'''说明'''：将选区中的内容延迟复制到剪切板中 可用标记： -e 跳过复制实体 -m 设置资源蒙版，蒙版外的方块会作为空气复制 -b 也会复制生物群系 警告：实体的粘贴不能通过命令撤销！ 
* <code>//place [-s] [-a] [-o]</code>
'''权限'''： <code>worldedit.clipboard.place</code> 
'''说明'''：在不应用任何变化（如旋转）的前提下，直接放置剪切板中的内容。 可用参数： -a 跳过空气方块 -o 粘贴在原位置 -s 粘贴之后将选区设定在粘贴区域 
* <code>//cut [leave-id] [-e] [-m]</code>
'''权限'''： <code>worldedit.clipboard.cut</code> 
'''说明'''：将选区剪切到粘贴板之中 可用参数： -e 跳过复制实体 -m 设置资源蒙版，蒙版外的方块会作为空气复制 -b 也会复制生物群系 警告：实体的粘贴不能通过命令撤销！
* <code>/download</code>
'''权限'''： <code>worldedit.clipboard.download</code> 
'''说明'''：通过配置的网页接口下载剪切板的内容 
* <code>/asset [category]</code>
'''权限'''： <code>worldedit.clipboard.asset</code> 
'''说明'''：将你的剪切板的内容保存到网页资源接口中 
* <code>//paste [-s] [-a] [-o]</code>
'''权限'''： <code>worldedit.clipboard.paste</code> 
'''说明'''：粘贴剪切板的内容。 可用参数： -a 跳过空气方块 -b 跳过粘贴生物群系 -e 跳过粘贴实体 -o 粘贴到原位置 -s 在粘贴之后将选区设定在粘贴区域 
* <code>//lazycut [-e] [-m]</code>
'''权限'''： <code>worldedit.clipboard.lazycut</code> 
'''说明'''：将选区中的内容延迟剪切到剪切板之中 可用参数： -e 跳过复制实体 -m 设置资源蒙版，蒙版外的方块会作为空气复制 -b 也会复制生物群系 警告：实体的粘贴不能通过命令撤销！ 
* <code>/clearclipboard</code>
'''权限'''： <code>worldedit.clipboard.clear</code> 
'''说明'''：清除你的剪切板
=== '''Generation 命令''' ===

<blockquote>(创建特殊结构或更多有关特性： [https://goo.gl/KuLFRW 更多信息])
</blockquote>

* <code>//image <imgur> [randomize=true] [complexity=100]</code>
'''权限'''： <code>worldedit.generation.image</code> 
'''说明'''：创建一张图片 
* <code>//generate <block> <expression> [-h] [-r] [-o] [-c]</code>
'''权限'''： <code>worldedit.generation.shape</code> 
'''说明'''：根据表达式创建结构，表达式返回的值 应该是正数（返回true，如果选择点在结构内的话） 作为可选项，你可以设置目标方块的类型或数据。 可选参数： -h 创建凹下去的结构 -r 使用原版Minecraft坐标 -o 与 -r 相似，但使用相对坐标。 -c 与 -r 相似，但相对坐标的中心不同。 如果你既没有没有输入 -r ，也没有输入 -o 的话，选区会自动映射为 -1..1 详见 tinyurl.com/wesyntax。 
* <code>//cyl <block> <radius>[,<radius>] [height] [-h]</code>
'''权限'''： <code>worldedit.generation.cylinder</code> 
'''说明'''：生成圆柱体。 通过指定用逗号分隔的两个半径， 你能够创建椭圆体。 第一个参数指定南北距离，第二个参数指定东西距离。 
* <code>//sphere <block> <radius>[,<radius>,<radius>] [raised?] [-h]</code>
'''权限'''： <code>worldedit.generation.sphere</code> 
'''说明'''：生成实心球。 通过指定用逗号分隔的三个半径， 你能够创建椭球体。椭球体半径的距离的指定顺序为： 南北，上下，东西。 
* <code>//ore <mask> <pattern> <size> <freq> <rarity> <minY> <maxY></code>
'''权限'''： <code>worldedit.generation.ore</code> 
'''说明'''：生成矿物 
* <code>//caves [size=8] [freq=40] [rarity=7] [minY=8] [maxY=127] [sysFreq=1] [sysRarity=25] [pocketRarity=0] [pocketMin=0] [pocketMax=3]</code>
'''权限'''： <code>worldedit.generation.caves</code> 
'''说明'''：生成网状的洞穴结构 
* <code>//hcyl <pattern> <radius>[,<radius>] [height]</code>
'''权限'''： <code>worldedit.generation.cylinder</code> 
'''说明'''：生成中空的圆柱体。 通过指定用逗号分隔的两个半径， 你能够创建椭圆体。 第一个参数指定南北距离，第二个参数指定东西距离。 
* <code>//ores</code>
'''权限'''： <code>worldedit.generation.ore</code> 
'''说明'''：生成矿物 
* <code>//hsphere <block> <radius>[,<radius>,<radius>] [raised?]</code>
'''权限'''： <code>worldedit.generation.sphere</code> 
'''说明'''：生成中空的球体。 通过指定用逗号分隔的三个半径， 你能够创建椭球体。椭球体半径的距离的指定顺序为： 南北，上下，东西。 
* <code>/forestgen [size] [type] [density]</code>
'''权限'''： <code>worldedit.generation.forest</code> 
'''说明'''：生成森林 
* <code>//hpyramid <block> <size></code>
'''权限'''： <code>worldedit.generation.pyramid</code> 
'''说明'''：生成中空的金字塔 
* <code>/pumpkins [size]</code>
'''权限'''： <code>worldedit.generation.pumpkins</code> 
'''说明'''：生成南瓜群 
* <code>//pyramid <block> <size> [-h]</code>
'''权限'''： <code>worldedit.generation.pyramid</code> 
'''说明'''：生成填充过的金字塔 
* <code>//generatebiome <biome> <expression> [-h] [-r] [-o] [-c]</code>
'''权限'''： <code>worldedit.generation.shape</code>, <code>worldedit.biome.set</code> 
'''说明'''：根据表达式创建结构，表达式返回的值 应该是正数（返回true，如果选择点在结构内的话） 作为选择项，你可以设置目标方块的类型或数据。 可选参数： -h 创建凹下去的结构 -r 使用原版Minecraft坐标 -o 与 -r 相似，但使用相对坐标。 -c 与 -r 相似，但相对坐标的中心不同。 如果你既没有没有输入 -r ，也没有输入 -o 的话，选区会自动映射为 -1..1 详见 tinyurl.com/wesyntax。

=== '''Biome 命令''' ===

<blockquote>(更改当前生物群系，或查看当前或所有生物群系)
</blockquote>

* <code>//setbiome <biome> [-p]</code>

'''权限'''： <code>worldedit.biome.set</code> 
'''说明'''：设置区域的生物群系。 默认来说，我们会将你选区中的所有方块直接设置为对应生物群系。 -p 标记则将选区所在区块设置为对应生物群系。 
* <code>/biomeinfo [-p] [-t]</code>
'''权限'''： <code>worldedit.biome.info</code> 
'''说明'''：获取当前位置的生物群系。 默认来说，我们会检测你选区中所有的方块，列出所有包含的生物群系。 -t 则检测你目光指向的那个区块。 -p 会检查你当前所在的区块。 
* <code>/biomelist [page]</code>
'''权限'''： <code>worldedit.biome.list</code> 
'''说明'''：获取所有可用的生物群系。

=== '''Anvil 命令''' ===

<blockquote>(操纵大量方块：[https://github.com/c7w/FastAsyncWorldedit/wiki/Anvil-API 更多信息])
</blockquote>

* <code>/anvil count <ids> [-d]</code>
'''权限'''： <code>worldedit.anvil.count</code> 
'''说明'''：为选区中的方块计数 
* <code>/anvil replace [from-block] <to-block></code>
'''权限'''： <code>worldedit.anvil.replace</code> 
'''说明'''：用一种方块替换选区中的所有另一种方块 
* <code>/anvil replaceall <folder> [from-block] <to-block> [-d] [-f]</code>
'''权限'''： <code>worldedit.anvil.replaceall</code> 
'''说明'''：用另一种方块替换选区中的所有方块 -d 标记会禁用通配符的匹配 
* <code>/anvil copy</code>
'''权限'''： <code>worldedit.anvil.copychunks</code> 
'''说明'''：将区块延迟复制到你的anvil剪切板中 
* <code>/anvil paste [-c]</code>
'''权限'''： <code>worldedit.anvil.pastechunks</code> 
'''说明'''：从anvil剪切板将内容粘贴出来。 -c 标记会调整将内容粘贴到区块中。 
* <code>/anvil distr</code>
'''权限'''： <code>worldedit.anvil.distr</code> 
'''说明'''：用另一种方块替换选区中的所有方块 
* <code>/anvil trimallplots</code>
'''权限'''： <code>worldedit.anvil.trimallplots</code> 
'''说明'''：修剪地皮世界中的区块 未认领的区块会被删除 未修改的区块会被删除 使用 -v 来删除没有人去过的区块 
* <code>/anvil countall <folder> [hasSky] <id> [-d]</code>
'''权限'''： <code>worldedit.anvil.countall</code> 
'''说明'''：为世界中的方块计数 
* <code>/anvil clear</code>
'''权限'''： <code>worldedit.anvil.clear</code> 
'''说明'''：清除选区的区块（不整理磁盘碎片，直接删除） 
* <code>/anvil removelayers <id></code>
'''权限'''： <code>worldedit.anvil.removelayer</code> 
'''说明'''：如果某一区块的顶层方块全部都与提供的方块类型匹配成功的话，就移除顶层方块。 
* <code>/anvil replacepattern [from-mask] <to-pattern></code>
'''权限'''： <code>worldedit.anvil.replace</code> 
'''说明'''：移除选区内所有匹配对应样式模板的方块 
* <code>/anvil remapall <folder></code>
'''权限'''： <code>worldedit.anvil.remapall</code> 
'''说明'''：将世界在MCPE和PC的存档格式之间转换 
* <code>/anvil deletealloldregions <folder> <time></code>
'''权限'''： <code>worldedit.anvil.deletealloldregions</code> 
'''说明'''：移除一段时间内没有人进入的区域 你可以使用秒 (s), 分钟 (m), 小时 (h), 天 (d), 周 (w),和年 (y) 来计算时间 (请注意：月份不是计算时间的单位) 举个例子： 8h5m12s 
* <code>/anvil replaceallpattern <folder> [from-block] <to-pattern> [-d] [-m]</code>
'''权限'''： <code>worldedit.anvil.replaceall</code> 
'''说明'''：将选区中所有的方块替换成另一种方块样式 
* <code>/anvil deleteallunvisited <folder> <age-ticks> [file-age=60000]</code>
'''权限'''： <code>worldedit.anvil.deleteallunvisited</code> 
'''说明'''：会将满足以下条件之一的全部区块移除：
加载时间没有到指定整数游戏刻的区块(20t = 1s)； 
在创建后，持续时间 <code>file-duration</code> (ms) 内没有被玩家访问的； 
在过去的 <code>chunk-inactivity</code> (ms)时间中没有被使用的。
因此，我们推荐的自动保存时间间隔便是 <code>file-duration</code> 和 <code>chunk-inactivity</code> 的值。

=== '''Super Pickaxe 命令''' ===

<blockquote>(超级镐子相关命令： [https://goo.gl/aBtGHo 更多信息])
</blockquote>

* <code>/sp recur <radius></code>

'''权限'''： <code>worldedit.superpickaxe.recursive</code> 
'''说明'''：启用递归超级镐子模式 
* <code>/sp area <radius></code>
'''权限'''： <code>worldedit.superpickaxe.area</code> 
'''说明'''：启用区域超级镐子模式 
* <code>/sp single</code>
'''权限'''： <code>worldedit.superpickaxe</code> 
'''说明'''：启用单个方块的超级镐子模式

=== '''Navigation 命令''' ===

<blockquote>(关于玩家在地图上移动的相关命令： [https://goo.gl/uQTUiT 更多信息])
</blockquote>

* <code>/descend [# of floors]</code>
'''权限'''： <code>worldedit.navigation.descend</code> 
'''说明'''：向下降一层 
* <code>/ascend [# of levels]</code>
'''权限'''： <code>worldedit.navigation.ascend</code> 
'''说明'''：向上升一层 
* <code>/thru</code>
'''权限'''： <code>worldedit.navigation.thru.command</code> 
'''说明'''：穿过面前的墙壁 
* <code>/jumpto [world,x,y,z]</code>
'''权限'''： <code>worldedit.navigation.jumpto.command</code> 
'''说明'''：传送到某一位置 
* <code>/ceil [clearance] [-f] [-g]</code>
'''权限'''： <code>worldedit.navigation.ceiling</code> 
'''说明'''：前往当前的最顶层，即“天花板”上 
* <code>/up <block> [-f] [-g]</code>
'''权限'''： <code>worldedit.navigation.up</code> 
'''说明'''：向上移动一段距离，并在脚下生成方块 
* <code>/unstuck</code>
'''权限'''： <code>worldedit.navigation.unstuck</code> 
'''说明'''：在卡在方块中的情况下逃脱

=== '''Snapshot 命令''' ===

<blockquote>(列出，读取快照以及查看跟快照有关的信息)
</blockquote>

* <code>/snapshotlist [num]</code>

'''权限'''： <code>worldedit.snapshots.list</code> 
'''说明'''：列出快照列表的对应页数 
* <code>/snapshotafter <date></code>
'''权限'''： <code>worldedit.snapshots.restore</code> 
'''说明'''：选择发布时间在该时间之后，距离时间最近的一个快照 
* <code>/snapshotbefore <date></code>
'''权限'''： <code>worldedit.snapshots.restore</code> 
'''说明'''：选择发布时间在该时间之前，距离时间最近的一个快照 
* <code>/snapshotuse <snapshot></code>
'''权限'''： <code>worldedit.snapshots.restore</code> 
'''说明'''：选择要使用的快照 
* <code>/snapshotsel <index></code>
'''权限'''： <code>worldedit.snapshots.restore</code> 
'''说明'''：选择根据列表ID排序的某一快照

==== '''Snapshot Util 命令''' ====

<blockquote>([http://wiki.sk89q.com/wiki/WorldEdit/Snapshots 更多信息])
</blockquote>

* <code>/restore [snapshot]</code>
'''权限'''： <code>worldedit.snapshots.restore</code> 
'''说明'''：从某一快照恢复选区

=== '''Scripting 命令''' ===

<blockquote>(执行 CraftScript 脚本 [https://goo.gl/dHDxLG 更多信息])
</blockquote>

* <code>/cs <filename> [args...]</code>

'''权限'''： <code>worldedit.scripting.execute</code> 
'''说明'''：执行一个 CraftScript 脚本 
* <code>/.s [args...]</code>
'''权限'''： <code>worldedit.scripting.execute</code> 
'''说明'''：执行上一个 CraftScript 脚本

=== '''Chunk 命令''' ===

<blockquote>([旧版使用] 检索区块： [http://wiki.sk89q.com/wiki/WorldEdit/Chunk_tools 更多信息])
</blockquote>

* <code>/chunkinfo</code>
'''权限'''： <code>worldedit.chunkinfo</code> 
'''说明'''：获得你当前所在的区块的有关信息 
* <code>/listchunks</code>
'''权限'''： <code>worldedit.listchunks</code> 
'''说明'''：列出你的选区所在的所有区块 
* <code>/delchunks</code>
'''权限'''： <code>worldedit.delchunks</code> 
'''说明'''：已过期，请使用 anvil 命令来执行对应操作

=== '''Options 命令''' ===

<blockquote>(玩家切换设置和物品信息)
</blockquote>

* <code>//searchitem <query> [-b] [-i]</code>

'''说明'''：搜索某个物品。 Flags: -b 仅搜索方块 -i 仅搜索物品 
* <code>//gtransform [transform]</code>
'''权限'''： <code>worldedit.global-trasnform</code> 
'''说明'''：获取全局变换式 
* <code>//toggleplace</code>
'''说明'''：在你当前位置和第一个选取点之间切换位置 
* <code>//tips</code>
'''说明'''：切换FAWE提示是否开启 
* <code>//gsmask [mask]</code>
'''权限'''： <code>worldedit.global-mask</code> 
'''说明'''：设置应用到你所有编辑的全局资源蒙版，任何作为源资源存储的方块数据均需要经过本蒙版判定（例如：判定方块能否被复制到剪切板中） 
* <code>//gmask [mask]</code>
'''权限'''： <code>worldedit.global-mask</code> 
'''说明'''：设置应用给你所有编辑的全局目标蒙版，与上面一个指令相对的，所有你的目标性更改均需通过本蒙版的判定（例如：判定能否修改世界中的方块） 
* <code>//fast [on|off]</code>
'''权限'''： <code>worldedit.fast</code> 
'''说明'''：切换FAWE插件是否进入快速模式，在该模式下你的操作不会记录到相关历史记录中，即无法进行撤销操作

=== '''Brush Options 命令''' ===

<blockquote>(工具命令)
</blockquote>

* <code>/target [mode]</code>

'''说明'''：在不同的目标模式之间切换 
* <code>/size [pattern]</code>
'''权限'''： <code>worldedit.brush.options.size</code> 
'''说明'''：设置笔刷大小 
* <code>//listbrush [mine|<filter>] [page=1] [-d] [-n] [-p]</code>
'''权限'''： <code>worldedit.brush.list</code> 
'''说明'''：列出或搜索所有你能使用的笔刷 -p <页码数> 列出指定页面 
* <code>/mask [mask]</code>
'''权限'''： <code>worldedit.brush.options.mask</code> 
'''说明'''：设置笔刷的目标蒙版 
* <code>/range [pattern]</code>
'''权限'''： <code>worldedit.brush.options.range</code> 
'''说明'''：设置笔刷的范围 
* <code>/transform [transform]</code>
'''权限'''： <code>worldedit.brush.options.transform</code> 
'''说明'''：设置笔刷的变换式 
* <code>/mat [pattern]</code>
'''权限'''： <code>worldedit.brush.options.material</code> 
'''说明'''：设置笔刷的填充方块样式 
* <code>/patterns [page=1|search|pattern]</code>
'''说明'''：决定被放置的方块样式 
使用[括号]来输入参数 
使用 , 来代表或的分割 
例如： #surfacespread[10][#existing],andesite 
更多信息: https://git.io/vSPmA 
* <code>/savebrush [name]</code>
'''权限'''： <code>worldedit.brush.save</code> 
'''说明'''：保存你当前的笔刷 使用 -g 标记以储存到全局 
* <code>/loadbrush [name]</code>
'''权限'''： <code>worldedit.brush.load</code> 
'''说明'''：读取笔刷 
* <code>/transforms [page=1|search|transform]</code>
'''说明'''：变换方块被放置的方式 
使用[括号]来输入参数 
使用 , 来代表或的分割 
使用 & 来表示和的分割 
更多信息: https://git.io/v9KHO 
* <code>/primary [brush arguments]</code>
'''说明'''：设置右键点击激活的笔刷 
* <code>// [on|off]</code>
'''权限'''： <code>worldedit.superpickaxe</code> 
'''说明'''：切换是否开启超级镐子功能 
* <code>/targetmask [mask]</code>
'''说明'''：设置目标蒙版 
* <code>/none</code>
'''说明'''：从当前物品上解除绑定功能 
* <code>/visualize [mode=0]</code>
'''说明'''：在不同的预览模式之间进行切换 0 = 没有预览 1 = 预览单个目标方块 2 = 用玻璃预览所有将会改变的方块 
* <code>/scroll [none|clipboard|mask|pattern|range|size|visual|target]</code>
'''说明'''：在不同的目标模式之间进行切换 
* <code>/secondary [brush arguments]</code>
'''说明'''：设置左键点击激活的笔刷 
* <code>/smask [mask]</code>
'''权限'''： <code>worldedit.brush.options.mask</code> 
'''说明'''：设置笔刷的资源蒙版 
* <code>/masks [page=1|search|mask]</code>
'''说明'''：查看所有用来决定方块能否被放置的蒙版 
使用[括号]来输入参数 
使用 , 来代表或的分割 
使用 & 来表示和的分割 
举个例子： >[stone,dirt],#light[0][5],$jungle 
更多信息: https://git.io/v9r4K

=== '''Tool 命令''' ===

<blockquote>(将某些功能绑定到持有的物品之上： [https://goo.gl/xPnPxj 更多信息])
</blockquote>

* <code>/tool tree [type]</code>
'''权限'''： <code>worldedit.tool.tree</code> 
'''说明'''：生成树的工具 
* <code>/tool repl <block></code>
'''权限'''： <code>worldedit.tool.replacer</code> 
'''说明'''：方块替换工具 
* <code>/tool info</code>
'''权限'''： <code>worldedit.tool.info</code> 
'''说明'''：方块信息工具 
* <code>/tool lrbuild <leftclick block> <rightclick block></code>
'''权限'''： <code>worldedit.tool.lrbuild</code> 
'''说明'''：大范围建筑工具 
* <code>/tool cycler</code>
'''权限'''： <code>worldedit.tool.data-cycler</code> 
'''说明'''：方块数据值循环工具 
* <code>/tool deltree</code>
'''权限'''： <code>worldedit.tool.deltree</code> 
'''说明'''：移除漂浮的树的工具 
* <code>/tool inspect</code>
'''权限'''： <code>worldedit.tool.inspect</code> 
'''说明'''：选择检查笔刷 
* <code>/tool floodfill <pattern> <range></code>
'''权限'''： <code>worldedit.tool.flood-fill</code> 
'''说明'''：池塘填充工具 
* <code>/tool farwand</code>
'''权限'''： <code>worldedit.tool.farwand</code> 
'''说明'''：远程选区工具

=== '''Brush 命令''' ===

<blockquote>(从远程建筑与涂画的工具。 [https://git.io/vSPYf 更多信息])
</blockquote>

* <code>/brush copypaste [depth=5]</code>
'''权限'''： <code>worldedit.brush.copy</code> 
'''说明'''：左键点击一个物体的底座来复制。 右键点击来粘贴 -r 标记能够在粘贴时应用随机旋转 注意：能和剪切板滚动一起搭配使用 
视频： https://www.youtube.com/watch?v=RPZIaTbqoZw 
* <code>/brush command <radius> [cmd1;cmd2...]</code>
'''权限'''： <code>worldedit.brush.command</code> 
'''说明'''：在点击的位置执行一条命令。 
你的选区会延展到包括该点 
可用的变量： {x}, {y}, {z}, {world}, {size} 
* <code>/brush populateschematic <mask> <file|folder|url> [radius=30] [points=5] [-r]</code>
'''权限'''： <code>worldedit.brush.populateschematic</code> 
'''说明'''：选择分散型schematic笔刷。 -r 标记能够应用随机旋转 
* <code>/brush scmd <scatter-radius> <points> <cmd-radius=1> <cmd1;cmd2...></code>
'''权限'''： <code>worldedit.brush.scattercommand</code> 
'''说明'''：在表面的随机一点执行命令 
分散的半径是每个点之间的最小距离 
你的选区会延展到包括该点 
可用的变量： {x}, {y}, {z}, {world}, {size} 
* <code>/brush erode [radius=5]</code>
'''权限'''： <code>worldedit.brush.erode</code> 
'''说明'''：侵蚀地形 
* <code>/brush pull [radius=5]</code>
'''权限'''： <code>worldedit.brush.pull</code> 
'''说明'''：将地形朝着你所在的方向隆起 
* <code>/brush blendball [radius=5]</code>
'''权限'''： <code>worldedit.brush.blendball</code> 
'''说明'''：平滑化，混合化地形 
图片： https://i.imgur.com/cNUQUkj.png -> https://i.imgur.com/hFOFsNf.png 
* <code>/brush stencil <pattern> [radius=5] [file|#clipboard|imgur=null] [rotation=360] [yscale=1.0]</code>
'''权限'''： <code>worldedit.brush.stencil</code> 
'''说明'''：使用高度图来绘制出地形表面。 -w 标记仅会应用于最大饱和度 -r 标记会应用随机旋转 
* <code>/brush splatter <pattern> [radius=5] [seeds=1] [recursion=5] [solid=true]</code>
'''权限'''： <code>worldedit.brush.splatter</code> 
'''说明'''：设置物体表面为随机方块。 图片： https://i.imgur.com/hMD29oO.png 使用示例： /br splatter stone,dirt 30 15 注意：种子决定着会有多少斑点，递归次数决定着其大小，solid决定着模型是按照每个种子应用还是按照每个方块应用。 
* <code>/brush cylinder <block> [radius=2] [height=1] [-h]</code>
'''权限'''： <code>worldedit.brush.cylinder</code> 
'''说明'''：创建圆柱体。 -h 标记会创建中空的圆柱体。 
* <code>/brush shatter <pattern> [radius=10] [count=10]</code>
'''权限'''： <code>worldedit.brush.shatter</code> 
'''说明'''：创建将地形分成多个部分的不均匀的线 图片： https://i.imgur.com/2xKsZf2.png 
* <code>/brush circle <pattern> [radius=5]</code>
'''权限'''： <code>worldedit.brush.sphere</code> 
'''说明'''：围绕着你看向的方向创建一个圆。 注意：无视笔刷的半径，并且启用预览可以帮助你操作的可能结果 
* <code>/brush smooth [size=2] [iterations=4] [-n]</code>
'''权限'''： <code>worldedit.brush.smooth</code> 
'''说明'''：选择地形平滑化笔刷。 -n 标记会只更改自然生成的方块。 
* <code>/brush ex [radius=5]</code>
'''权限'''： <code>worldedit.brush.ex</code> 
'''说明'''：火焰熄灭笔刷的简写 
* <code>/brush gravity [radius=5] [-h]</code>
'''权限'''： <code>worldedit.brush.gravity</code> 
'''说明'''：这个笔刷会模仿重力的作用。 -h 标记能够让它从世界的最大Y坐标开始计算，而不是点击方块的Y坐标。 
* <code>/brush sspl <pattern> [size=0] [tension=0] [bias=0] [continuity=0] [quality=10]</code>
'''权限'''： <code>worldedit.brush.surfacespline</code> 
'''说明'''：在地面上创建一条曲线。 视频： https://www.youtube.com/watch?v=zSN-2jJxXlM 
* <code>/brush spline <pattern></code>
'''权限'''： <code>worldedit.brush.spline</code> 
'''说明'''：点击一些物体，然后再次点击相同的方块来让你的物体之间进行连接。 笔刷半径设置过小，或是点击位置错误或导致变形。形状必须是简单的线条或者封闭的环形。 图片： http://i.imgur.com/CeRYAoV.jpg -> http://i.imgur.com/jtM0jA4.png 图片2： http://i.imgur.com/bUeyc72.png -> http://i.imgur.com/tg6MkcF.png 
* <code>/brush surface <pattern> [radius=5]</code>
'''权限'''： <code>worldedit.brush.surface</code> 
'''说明'''：使用高度图来画出表面。 -w 标记仅会应用于最大饱和度 -r 标记会应用随机旋转 
* <code>/brush layer <radius> [color|<pattern1> <patern2>...]</code>
'''权限'''： <code>worldedit.brush.layer</code> 
'''说明'''：使用覆盖层来替换地形。 示例：/br layer 5 95:1 95:2 35:15 - 会在地面上放置一些覆盖层 图片： https://i.imgur.com/XV0vYoX.png 
* <code>/brush sphere <pattern> [radius=2] [-h]</code>
'''权限'''： <code>worldedit.brush.sphere</code> 
'''说明'''：创建一个球体。 -h 标记能够创建中空的球体。 
* <code>/brush clipboard</code>
'''权限'''： <code>worldedit.brush.clipboard</code> 
'''说明'''：选择剪切板笔刷。 -a 标记会使其不会粘贴空气方块。 不输入 -p 标记，粘贴后的内容的中心会出现在目标位置。输入该标记后，粘贴内容所在的位置就会根据你在复制内容时所站的位置而定义了。 
* <code>/brush recursive <pattern-to> [radius=5]</code>
'''权限'''： <code>worldedit.brush.recursive</code> 
'''说明'''：设置所有连接起来的方块。 -d 标记会应用深度优先的顺序 注意：设置蒙版可以递归指定的方块 
* <code>/brush scatter <pattern> [radius=5] [points=5] [distance=1] [-o]</code>
'''权限'''： <code>worldedit.brush.scatter</code> 
'''说明'''：在地面上随机散布方块。 -o 标记会覆盖原方块 视频： https://youtu.be/RPZIaTbqoZw?t=34s 
* <code>/brush line <pattern> [radius=0] [-h] [-s] [-f]</code>
'''权限'''： <code>worldedit.brush.line</code> 
'''说明'''：创建线段。 -h 标记仅会创建其外壳 -s 标记在创建之后会选择点击的点。 -f 标记会创建平坦的线段。 
* <code>/brush height [radius=5] [file|#clipboard|imgur=null] [rotation=0] [yscale=1.00] [-h]</code>
'''权限'''： <code>worldedit.brush.height</code> 
'''说明'''：这个笔刷可以使地形上升或下降。 - <code>-r</code> 标记启用随机坐标旋转 - <code>-l</code> 标记使得该笔刷也会在雪层中工作 - <code>-s</code> 标记禁用平滑 注意！注意！如果你要降低地形的话请将yscale的值设置为负数！ 在雪层中应用的图片： https://i.imgur.com/Hrzn0I4.png 
* <code>/brush butcher [radius=5] [-p] [-l] [-a] [-n] [-g] [-b] [-t] [-f] [-r]</code>
'''权限'''： <code>worldedit.brush.butcher</code> 
'''说明'''：击杀在指定的半径内的怪物。 可用的标记： -p 也击杀宠物 -n 也击杀 NPC -g 也击杀铁傀儡 -a 也击杀动物。 -b 也击杀中立生物 -t 也击杀带有名字的怪物 -f 相当于这以前所有标记的混合 -r 也击杀盔甲架 -l 目前无任何作用 
* <code>/brush flatten [radius=5] [file|#clipboard|imgur=null] [rotation=0] [yscale=1.00] [-h]</code>
'''权限'''： <code>worldedit.brush.height</code> 
'''说明'''：平坦笔刷，可以使地形平坦 - <code>-r</code> 标记启用随机坐标旋转 - <code>-l</code> 标记使得该笔刷也会在雪层中工作 - <code>-s</code> 标记禁用平滑 
* <code>/brush cliff [radius=5] [file|#clipboard|imgur=null] [rotation=0] [yscale=1.00] [-h]</code>
'''权限'''： <code>worldedit.brush.height</code> 
'''说明'''：这个笔刷可以平坦地形且创建悬崖。 - <code>-r</code> 标记启用随机坐标旋转 - <code>-l</code> 标记使得该笔刷也会在雪层中工作 - <code>-s</code> 标记禁用平滑

== 蒙版 '''/Masks''' ==

<blockquote>(关于蒙版方面的帮助 [https://git.io/v9r4K 更多信息]) 
蒙版决定了方块能否被放置 
- 使用 [brackets] 来输入参数 - 使用 , 来代表或的分割 
- 使用 & 来代表与的分割 
例如： >[stone,dirt],#light[0][5],$jungle 更多信息: https://git.io/v9r4K
</blockquote>

* <code>#offset <dx> <dy> <dz> <mask></code>
'''说明'''：使蒙版偏移对应坐标值 
* <code>% <chance></code>
'''说明'''：百分比几率 
* <code>#id</code>
'''说明'''：限制初始ID 
* <code>#data</code>
'''说明'''：限制初始数据值 
* <code>{ <min> <max></code>
'''说明'''：限制方块与初始方块的距离范围 
* <code>#existing</code>
'''说明'''：设置限制为非空气方块 
* <code>$ <biome></code>
'''说明'''：限制操作在特殊的生物群系中，要想列出所有的生物群系请使用 //biomelist 
* <code>#surface</code>
'''说明'''：限制操作在表面方块上（任何接触空气的固体方块） 
* <code>! <mask></code>
'''说明'''：取对应蒙版的“非”值 
* <code>= <expression></code>
'''说明'''：表达式蒙版 
* <code>#region</code>
'''说明'''：在某个提供的区域内部 
* <code>\ <min> <max></code>
'''说明'''：限制为特殊的地形坡度 -o 标记仅仅会覆盖，举个例子： /[0d][45d] 作用解释：能够选出任何坡度在0-45度之间的方块 示例：/[3][20] 作用解释：能够选出任何坡度在3-20度之间的方块 
* <code>#dregion</code>
'''说明'''：在玩家的选取之中 
* <code>#xaxis</code>
'''说明'''：限制为特殊的x轴坐标位置 
* <code>#yaxis</code>
'''说明'''：限制为特殊的y轴坐标位置 
* <code>#opacity <min> <max></code>
'''说明'''：限制为指定的不透明度等级 
* <code>#light <min> <max></code>
'''说明'''：限制为指定的光亮等级 
* <code>#blocklight <min> <max></code>
'''说明'''：限制为指定的方块亮度等级 
* <code>#haslight</code>
'''说明'''：限制为方块是否拥有光照（天空或环境） 
* <code>~ <mask> [min=1] [max=8]</code>
'''说明'''：邻近的其他方块的数量 
* <code>#brightness <min> <max></code>
'''说明'''：限制指定的方块光照等级 
* <code>#nolight</code>
'''说明'''：限制方块需要没有光亮（天空或环境） 
* <code>#skylight <min> <max></code>
'''说明'''：限制需要指定天空光亮等级 
* <code>#simplex <scale=10> <min=0> <max=100></code>
'''说明'''：使用噪声算法作为蒙版 
* <code>#zaxis</code>
'''说明'''：限制为特殊的z轴坐标位置 
* <code>> <mask></code>
'''说明'''：限制在某一指定方块的上面 
* <code>#wall</code>
'''说明'''：限制为墙壁（任意方块，东西南北任意一面为空气） 
* <code>| <mask> <min> <max></code>
'''说明'''：限制旁边位置拥有指定数量的其他方块 
* <code>#iddata</code>
'''说明'''：限制指定的方块ID与数据值 
* <code>< <mask></code>
'''说明'''：在某一指定方块之下 
* <code>#solid</code>
'''说明'''：限制仅操作固体方块

== 样式 '''/Patterns''' ==

<blockquote>(对于某些方块样式信息的帮助。 [https://git.io/vSPmA 更多信息]) 
样式决定放置什么方块 
- 使用 [brackets] 输入参数 
- 使用 , 来代表或的分割 
举个例子： #surfacespread[10][#existing],andesite 
更多信息: https://git.io/vSPmA
</blockquote>
* <code>#offset <dx> <dy> <dz> <pattern></code>
'''说明'''：使样式偏移对应坐标值 
* <code>#mask <mask> <pattern-true> <pattern-false></code>
'''说明'''：根据蒙版应用样式 
* <code>#id <pattern></code>
'''说明'''：只改变方块ID 
* <code>#spread <dx> <dy> <dz> <pattern></code>
'''说明'''：随机扩散方块 
* <code>#buffer <pattern></code>
'''说明'''：只有当样式在使用时才放置方块 如果你不想点击某些地方两次时，用它和笔刷搭配 
* <code>#clipboard</code>
'''说明'''：使用你剪切板中的方块作为样式 
* <code>#relative <pattern></code>
'''说明'''：将样式偏移到你所点击的位置 
* <code>#data <pattern></code>
'''说明'''：只会改变方块的数据值 
* <code>#biome <biome></code>
'''说明'''：设置生物群系 
* <code>#existing</code>
'''说明'''：仅更改已经存在的方块 
* <code>= <expression></code>
'''说明'''：样式表达式： http://wiki.sk89q.com/wiki/WorldEdit/Expression_syntax 
* <code>#simplex <scale=10> <pattern></code>
'''说明'''：使用噪声算法来随机放置方块 
* <code>#averagecolor <color> [randomize=true] [max-complexity=100]</code>
'''说明'''：在已经存在的方块和颜色之间平均化 
* <code>#desaturate [percent=100] [randomize=true] [max-complexity=100]</code>
'''说明'''：减小已经存在的方块的饱和度 
* <code>#darken [randomize=true] [max-complexity=100]</code>
'''说明'''：减小已经存在的方块的亮度 
* <code>#fullcopy [schem|folder|url=#copy] [rotate=false] [flip=false]</code>
'''说明'''：将你完整的剪切板填充到方块上 
* <code>#buffer2d <pattern></code>
'''说明'''：只有在一列中的样式被使用时才会放置方块 
* <code>#lighten [randomize=true] [max-complexity=100]</code>
'''说明'''：增大已存在的方块的亮度 
* <code>#saturate <color> [randomize=true] [max-complexity=100]</code>
'''说明'''：增加已经存在的方块的饱和度 
* <code>#anglecolor [randomize=true] [max-complexity=100]</code>
'''说明'''：根据坡度角的大小，计算出的较正常方块暗的方块 
* <code>#iddatamask <bitmask=15> <pattern></code>
'''说明'''：使用样式的ID和目的方块的数据值放置方块 - 用于替换半砖或其他方块数据值需要修改的方块 
* <code>#angledata</code>
'''说明'''：根据坡度角提供方块数据值 
* <code>#!x <pattern></code>
'''说明'''：本样式不会提供z轴的信息。 举个例子： #!x[#!z[#~[#l3d[pattern]]]] 
* <code>#!y <pattern></code>
'''说明'''：本样式不会提供y轴的信息 
* <code>#linear <pattern></code>
'''说明'''：循环从样式列表中读取并设置方块 
* <code>#!z <pattern></code>
'''说明'''：本样式不会提供z轴的信息 
* <code>#surfacespread <distance> <pattern></code>
'''说明'''：随机改变地面上一个方块的位置 
* <code>#linear3d <pattern></code>
'''说明'''：使用 x,y,z 坐标选定一个来自列表中的方块 
* <code>#solidspread <dx> <dy> <dz> <pattern></code>
'''说明'''：随机传播固体方块 
* <code>#color <color></code>
'''说明'''：使用接近于指定颜色的方块

== 变换式 '''/Transforms''' ==

<blockquote>(变换式的有关帮助。 [https://git.io/v9KHO 更多信息]) 
变换式会在放置方块之前，对其作出某种变化 
- 在 [brackets] 中输入参数 
- 使用 , 来代表或的分割 
- 使用 & 来代表与的分割 
更多信息: https://git.io/v9KHO
</blockquote>

* <code>#offset <dx> <dy> <dz> [transform]</code>
'''说明'''：偏移变换式，将方块偏移指定坐标后放置 
* <code>#rotate <rotateX> <rotateY> <rotateZ> [transform]</code>
'''说明'''：所有的变化都会被绕着指定位置旋转 
* <code>#scale <dx> <dy> <dz> [transform]</code>
'''说明'''：所有的变化都会按比例进行缩放 
* <code>#pattern <pattern> [transform]</code>
'''说明'''：使用给定的方块样式 
* <code>#spread <dx> <dy> <dz> [transform]</code>
'''说明'''：随机偏移变换式 
* <code>#linear <transform></code>
'''说明'''：从变换式列表中循环选择变换式 
* <code>#linear3d <transform></code>
'''说明'''：使用 x,y,z 坐标选定一个来自列表中的变换式

== 配置 ==
FAWE 安装后，即使不经过配置，也已经非常高效了，但是在配置或微调操作限制和队列操作的相关设置后，FAWE的效率还会有一定的提升。请参阅下列的内容以及默认配置文件中的注释行。

如果你在修改了配置之后，发现之后插件不正常工作，那么请把你微调的那一项设置改回默认。

要想重置 config.yml 文件的话，请删除它，然后重启服务器或使用 '''<code>/fawe</code>''' 命令重新载入 FAWE 插件。

=== 异步操作 ===

WorldEdit 插件会在放置方块之前，尝试将所有编辑操作全部储存在内存之中。

WorldEdit 也会在内存中储存撤销方块等等历史记录，在大型编辑时这会增加内存的需求，甚至会导致服务器内存溢出崩溃，或导致编辑失败。

FAWE 则对速度有极大的提升，它将每个编辑操作都分割到了异步线程上进行。

本插件会在计算完成之前，部分计算完成之后就开始放置方块。

这让全局编辑的整体速度得到有效提升。

同时，因为方块在有关计算完毕之后就开始放置，它们不会占用内存的空间。

FAWE 也能够通过配置将撤销方块（等有关历史记录）储存在硬盘之上，这可以与其他性能的改善搭配使用，最终使 FAWE 插件能够在极小占用的情况下完成数倍于 Worldedit 插件的编辑内容。

=== 操作限制设置 ===

这些设置能够让你控制某些用户组单次编辑可以放置的方块数目。

“default”（默认）小节就是为非管理组用户和没有权限跳过限制的用户所准备的。

查看 '''fawe.bypass''' 和 '''fawe.admin''' 权限来获取更多信息。

你也能通过使用权限节点来定义某些特定用户组的限制，请查看下方的默认配置文件中的注释行。

=== 队列设置 ===

这小节中的设置能够让你微调异步队列操作，影响内存的使用情况与编辑速度。

==== 本地队列 ====

FAWE 会将每个编辑命令放在分割的异步线程之中，以此来代替把操作塞进服务器主线程的做法，队列中的方块由每个玩家的本地队列来处理。

在队列中，方块按照区域来排序，这能够让 FAWE 使用更高效的优化算法，最终将方块放置（分配）进世界之中。

举个例子，WorldEdit会使用插件本体来执行光照和物理效果，然后发包，最后改变每一个方块。

但是取而代之的是，FAWE将它队列中的方块按照区块分开检测，使用更高效的优化算法，将方块放置进世界中。

在编辑开始时，本地队列进入未完成阶段。

当需要处理的队列方块为简单的 //set 或者是 //copy 这种类型的命令时，方块已经直接准备好放置了。

当使用其他命令（例如 //smooth 或 //deform）来编辑方块时，方块的变化要依赖于世界中的其他方块，并且编辑所涉及的方块可能要改变好几次。

（一般来说，本地化队列的所有编辑都能够在涉及64个区块内完成）

当编辑全部完成之后，本地队列变化成完成状态。

==== 全局队列 ====

FAWE 使用全局队列来放置当前激活的本地队列中的编辑内容。

全局队列按照编辑的优先级来处理编辑顺序，所以提交时间最长的编辑会首先开始进行。全局队列中的方块放置是在服务器的主线程上工作的。

FAWE 首先会放置完成状态的本地队列中的方块。因此，在放置未完成状态的本地队列中的方块之前，完成状态的本地队列列表必须是空的。

全局队列和本地队列相互连接配合，便实现了编辑的成功进行。

（从内部代码实现的角度来说，我们使用两个队列<queue>来存储相关队列内容，一个是完成状态的本地队列，另一个是未完成状态的）

==== 效率改善 ====

FAWE 也尝试通过“在没有完成状态的本地队列时，放置未完成状态的本地队列中的方块”的方式来改善插件的效率。

* '''target–size'''

FAWE 使用 '''target–size''' 来控制放置未完成队列中的方块数目，同时确保将要被放置的方块将不再因后续的计算而改变。

虽说在大多数情况下，类似于 //smooth 或 //deform 的这些命令，它们涉及的区块数目远小于64个区块，但是，如果在指令仍在计算方块更改时，涉及的方块数目便已经超过了本选项设置的限度，这些指令的最终实现效果便可能不是那么理想。

这是因为，这些命令所涉及的方块改变会参考世界中其他位置方块的情况，并且所涉及的一些方块可能要经历多次改变。

而在这种设置的情况下，在附近的64个区块进入处理队列之后，其他方块被重新计算、修改的可能性便被抹除了。

但是对于简单的操作来说，不会存在这种问题，例如 //copy 和 //set，因为这些命令涉及的方块不会进行多次的改变。

如果队列中不存在完成的本地队列正等待放置方块，且队列中排队的区块数目大于等于target-size选项所设置的值的话，全局队列会直接开始处理仍然在计算中的可放置方块。

调高这项设置能够确保像 //smooth 和 //deform 这样的命令稳定，但调低这项设置也能确保全局队列一直在放置可用的方块，而不是处于闲置状态。

默认的 '''target–size''' 的值是64.

如果没有 '''target–size''' 选项的话，使用 /fastmode 运行巨大的编辑会导致未完成的队列的填充速度比 '''max–wait–ms''' 的清空队列速度更快。

减小 '''target–size''' 选项的值，可能会使例如 //smooth 和 //deform 这些命令的成效变差，因为在方块确定被放置之后，将花费在计算重新改变方块上的时间被取消了。

同时，也正因为这些命令会依赖于其他位置的方块，如果 '''target–size''' 设置不够大的话，与先经过完全计算，再开始放置方块的模式相比，直接从未完成队列中放置方块这种模式最后所表现出的效果可能有一些差异。

这可能会导致命令的最终效果不正确。

所以请将 '''target–size''' 选项的值设定的适当大，来避免这个问题。

将 '''target–size''' 的值设置的过大可能收效不大，因为大多数涉及的方块编辑操作都能限制在64个区块之中。

同时如果将它设置的很大的话，就会降低 FAWE 阻止大型编辑使服务器内存溢出的能力。

* '''max–wait–ms'''

FAWE 对于放置已经完成计算的相关编辑方块来说，也是非常高效的。

但是，等待计算完成既耗费时间，也占用内存。

因此，本设置就是用来避免编辑计算没有完全完成时，部分已经完成计算的方块一直闲置在内存中的问题。

本选项主要用来保持全局队列持续处于放置方块的状态之中。

全局队列会在队列中没有处于完成的本地队列，并且全局队列处于空闲状态时间的比 '''max–wait–ms''' 所设置的时间长（单位为毫秒）时，开始放置仍然在处理中的方块。

'''max–wait–ms''' 设置也能解决区块读取连接超时的问题。通常区块的读取速度都是小于一秒的，所以默认的 '''max–wait–ms''' 的值是 1000，用于避免编辑冻结或是区块读取错误。

如果区块没有及时加载的话，请尝试将这个数值调大。

=== 默认配置文件 ===
默认的配置文件如下面的代码所示。

请注意，服务器文件夹内生成的配置文件是不带注释的。

<pre class="yml"># 前六项是不能配置的
issues: "https://github.com/boy0001/FastAsyncWorldedit/issues"
wiki: "https://github.com/boy0001/FastAsyncWorldedit/wiki/"
date: "27 Aug 2017 14:00:00 GMT"
build: "https://ci.athion.net/job/FastAsyncWorldEdit/<build>"
commit: "https://github.com/boy0001/FastAsyncWorldedit/commit/<hash>"
platform: "<platform>"
# 可用选项：de
# 请发起pull request来贡献翻译： https://github.com/boy0001/FastAsyncWorldedit/new/master/core/src/main/resources
language: ''
# 是否允许插件自动更新
update: true
# 是否将插件的使用统计发送到 mcstats.org
metrics: true
# FAWE 在没有足够的可用内存时，是否会跳过处理相关区块以防止崩溃
prevent-crashes: false
# 设置为 true 来启用支持 WorldEdit 的相关插件对区域的限制。（例如： PlotSquared 或 WorldGuard）
# 要想在区域中启用 WorldEdit 的话，用户需要相关权限：
# fawe.<plugin> 权限。查看权限页面来获取所有目前支持的区域插件。
region-restrictions: true
# FAWE 在内存占用超过这个百分比时会取消非管理员做出的编辑
# - 使用 `/wea` 或 `//fast` 或 `fawe.bypass` 命令跳过检测
# - 设置为 100 或 -1 禁用本设置。
max-memory-percent: 95

clipboard:
# 是否将用户剪切板内容储存到硬盘上，而非储存在内存中
# - 执行剪切板操作相关命令的速度将会有一定程度的下降
# - 剪切板中每个方块占用 2 字节的存储空间
use-disk: true
# 是否将剪切板压缩，以减少文件大小：
# - TODO: 目前还没有实现在硬盘上的压缩随机访问
# - 0 = 不进行压缩
# - 1 = 快速压缩
# - 2-17 = 较慢速度压缩
compression-level: 1
# 用户剪切板信息在删除之前，储存在硬盘上的时间，单位为天
delete-after-days: 1

lighting:
# 是否应该在重新计算光照完成后再发包
delay-packet-sending: true
async: true
# 重新计算光照的模式：
# - 0 = 无（不重新计算光照）
# - 1 = 优化（重新计算光源和改变的方块的光照）
# - 2 = 全局（缓慢重新计算每个方块的光照）
mode: 1

# 一般的游戏刻限制（对 WorldEdit 来说不必要，但是可以防止滥用）
tick-limiter:
# 是否启用限制
enabled: true
# 限制间隔，单位游戏刻
interval: 20
# 在每个间隔间最大的掉落方块数目（每区块）
falling: 64
# 每个间隔中最大执行的物理效果数目（每区块）
physics: 8192
# 每间隔最大生成的物品数目（每区块）
items: 256

web:
# 剪切板的网页接口
# - 所有的剪切板都匿名私有储存
# - 下载可以被用户删除
# - 支持剪切板的上传，下载和保存
url: "http://empcraft.com/fawe/"
# 资源的网页接口
# - 所有剪切板都是组织好后公开的
# - 资源能够被搜索，选择和下载
assets: "http://empcraft.com/assetpack/"

extent:
# 当这些插件拖慢了 WorldEdit 的操作速度时不要提示控制台
# - 如果你需要改变本选项时你会在控制台收到提示信息
allowed-plugins: []
# 第三方延展插件安装后是否应该显示调试信息
debug: true

# 仍在开发实验中的选项，你可以试着用用
experimental:
# [不安全] 直接修改区域文件（已过期——请使用Anvil命令）
# - 使用不当会导致世界错误！
anvil-queue-mode: false
# [安全] 动态增加渲染的区块的数目
# - 需要 Paper 服务端： ci.destroystokyo.com/job/PaperSpigot/
# - 将你的服务器视距上设置为 1 (spigot.yml, server.properties)
# - 取决于服务器的 tps 和玩家的移动
# - 请给我们提供反馈信息
dynamic-chunk-rendering: false

# 队列相关配置，与 FAWE 放置区块的方法相关联
queue:
# 这个数值应该和你处理器拥有的核数相同
# - 如果你需要可信度高的 `/timings` 的话，将此选项设置为1
parallel-threads: 8
progress:
# 显示一位用户的编辑的进度的恒定 title
# - false = 禁用
# - title = 显示进度title
# - chat = 在聊天栏中显示进度
display: "false"
# 编辑进度多久显示一次
interval: 1
# 发送进度的延迟，单位毫秒（防止编辑进度刷屏的情况发生）
delay: 5000
# 在编辑比这数目还多的区块时：
# - FAWE 会在所有运算完成之前直接开始放置方块
# - 大些的值会些微减少CPU的运算时间
# - 小写的值可以减少内存使用
# - 太小的值会导致一些命令执行效果变差（例如 deform）
target-size: 64
# 不管一项编辑是否计算处理完成，强制 FAWE 开始放置区块
# - 大些的值会在一定程度上减少CPU的运算时间
# - 小些的值可以减少内存使用
# - 太小的值会导致一些操作执行效果变差（例如 deform）
max-wait-ms: 1000
# 增加或减少队列强度（毫秒） [-50,50]:
# 0 = 平衡性能与稳定性
# -10 = 为区块放置少分配 10ms
# 值太大的话会造成卡顿（可能你感觉不到）
# 值太小的话编辑进度会很慢
extra-time-ms: 0
# 在提速操作之前读取多少数量的区块
# - 值太小的话会导致FAWE等待主线程的请求
# - 值太大的话会占用更多内存，但并不会感觉变快
preload-chunks: 32
# 放弃已经闲置了一段时间（ms）的编辑
# - 例如：一款插件创建了 EditSession 但没有使用它做任何事
# - 这只会对不正确使用 WorldEdit 的旧版 API 的插件起作用
discard-after-ms: 60000

history:
# 历史记录是否应储存在硬盘上：
# - 空闲大量的内存
# - 服务器重启可以存留历史记录
# - 可以无限次撤销
# - 不会影响编辑的性能，依照 `combine-stages`
use-disk: true
# 使用数据库来储存硬盘储存的概要：
# - 启用检测和回档
# - 不会影响性能
use-database: true
# 在分配时记录到历史中：
# - 速度更快，因为它避免了重复的方块检查
# - 压缩可能会糟糕一些，因为分配顺序不同
combine-stages: true
# 大些的压缩等级减少历史记录的大小，但以占用 CPU 使用率为代价
# 0 = 不压缩字节数组（最快）
# 1 = 1 级快速压缩（默认）
# 2 = 2 x 快速
# 3 = 3 x 快速
# 4 = 1 x 中速, 1 x 快速
# 5 = 1 x 中速, 2 x 快速
# 6 = 1 x 中速, 3 x 快速
# 7 = 1 x 慢速, 1 x 中速, 1 x 快速
# 8 = 1 x 慢速, 1 x 中速, 2 x 快速
# 9 = 1 x 慢速, 1 x 中速, 3 x 快速（最佳压缩文件）
# 注意：如果你使用硬盘的话，请最好使用压缩，因为较小的文件可以储存的更快
compression-level: 3
# 压缩的缓冲大小：
# - 较大 = 更好的比率，但是占用更多内存
# - 必须在以下范围中 [64, 33554432]
buffer-size: 531441
# 编辑时最大等待一个区块加载的时间，单位是毫秒。
# (50ms = 1 游戏刻, 0 = 最快).
# 默认值 100 应该对大多数情况来说都是安全的。
#
# 需要读取区块的操作（例如：复制）在没有及时读取区块时
# 会使用上个区块作为过滤器，这会出现大量复制出的方块。
# 每个读取区块的操作在读取区块时通常都需要25-50ms，在服务器卡顿时甚至更多。
# 所以即使设置100ms的等待时间，如果区块在10ms内加载完毕了的话，也不需要等待100ms。
#
# 本值也可以作为万一区块无法读取时（不管是什么原因）操作超时的值
# 如果操作超时了的话，操作就会使用上个区块作为过滤器，
# 然后显示出一条错误信息，在这种情况下，你需要要么将选区调整的更小，
# 要么将本项的值设置的大一些。
# 如果设置为 0，这个值的处理速度会很快，因为它既不会阻止读取区块，也不会等待。
chunk-wait-ms: 1000
# 在几天之后删除硬盘上的历史记录
delete-after-days: 7
# 在玩家登出时是否删除内存中的历史记录（不影响硬盘存储）
delete-on-logout: true
# 对于一些使用 WorldEdit 的插件来说，历史记录是否默认启用：
# - 禁用本项速度会更快
# - 使用 FAWE API 的插件不会受影响
enable-for-console: true
# 是否储存反撤销的相关信息：
# - 历史记录文件要大大约 20%
# - 允许使用 /redo 命令
store-redo: true
# 仅记录所有比 4096x256x256 小的编辑：
# - 减少历史记录文件的大小大概10%
small-edits: false

# 一些路径的文件夹名
paths:
# 将任何Minecraft或Mod的Jar文件放在这里来使用方块的材质
textures: "textures"
heightmap: "heightmap"
history: "history"
# 群组服务器可以使用相同的剪切板
clipboard: "clipboard"
# 是否分离每个玩家schematic文件的路径
per-player-schematics: true
# "default" 权限组会影响没有特殊限制权限的用户。
# 要想给某人不同的权限配置，请复制默认限制组
# 然后重新给这个权限组命个名（例如：newbie）。然后给予用户限制的
# 权限节点，使用该限制名（例如： fawe.limit.newbie ）
limits:
default:
# 能够最多同时运行的操作（例如：命令）
max-actions: 1
# 每次最大改变的方块数量（例如：使用 `//set stone` ）。
max-changes: 50000000
# 每次最大检测的方块数量（例如：使用 `//count stone` 不会改变方块的命令）
max-checks: 50000000
# 一次更改失败的最大次数（例如：玩家没有访问该区域的权限）
max-fails: 50000000
# 最大允许的笔刷递归次数（例如： `//brush smooth` ）
max-iterations: 1000
# 一次操作最大能够允许的实体数目（例如：牛）
max-entities: 1337
# 包括 Banner, Beacon, BrewingStand, Chest, CommandBlock,
# CreatureSpawner, Dispenser, Dropper, EndGateway, Furnace, Hopper, Jukebox,
# NoteBlock, Sign, Skull, Structure 的最大方块状态
max-blockstates: 1337
# 玩家历史文件的最大尺寸，单位是MB：
# - 超过这个尺寸的历史文件，不管是在硬盘上还是内存中都会被删除
max-history-mb: -1
# //calc 能够执行的每次操作的最大时间，单位毫秒
max-expression-ms: 50
# 动画化方块放置：
# - 为方块放置增加延迟（ms/方块）
# - 使用虚伪的延迟会导致使用更多CPU与内存
speed-reduction: 0
# 放置区块，而不是单个方块：
# - 禁用本项会大幅度降低性能
# - 只有在与动画化方块放置冲突时才禁用本项
fast-placement: true
# WorldEdit 应该使用玩家的物品栏放置物品吗？
# 0 = 不使用物品栏（创造模式）
# 1 = 移除和放置都使用物品栏（免费建筑区）
# 2 = 仅放置使用物品栏（生存模式）
inventory-mode: 0
# 大型的编辑是否需要确认（需要区块数目大于16384）
confirm-large: true</pre>

== Bukkit API ==
插件开发相关，暂略

==参考资料==
* [https://github.com/boy0001/FastAsyncWorldedit/wiki Legacy Wiki(Primary)]
* [https://wiki.intellectualsites.com/en/FastAsyncWorldEdit New Wiki]

Bootstrap:Footer

2016-08-10T11:58:40Z

Mcdarc：

大家好, 百科已经被Liuzln我占领了[雾

Bootstrap:Footer

2016-08-10T11:56:42Z

Mcdarc：创建页面，内容为“233333333”

233333333

TerrainControl

2016-03-20T09:32:16Z

Mcdarc：/* variable name */

{{待搬运}}

{{Bukkit Plugin Infobox
|插件名=TerrainControl
|版本=v2.7.2
|前置插件=无
|兼容服务端版本=1.7.2-1.8.3
|網址=[https://github.com/MCTCP/TerrainControl/wiki/ WikiOnGithub]
}}

:对于本页面使用到的译名，请使用[[Minecraftwiki:Minecraft_Wiki:译名标准化#生物群系|Minecraft_Wiki:译名标准化]]的标准
:[[TerrainControl/en|查看原文]]
:[https://github.com/MCTCP/TerrainControl/wiki Github Wiki]
Terrain Control 是一款高级的地形生成器。通过多种配置文件，它使用户可以在不了解Java的情况下，对Minecraft地形生成机制的大多数方面进行控制。它可以运行在Bukkit/Forge服务端或带有Forge的单人游戏上。Terrain Control 继承自旧版的 PhoenixTerrainMod，而其又是基于著名的 BiomeTerrainMod。Terrain Control 由Khoorn维护 (在Github上名为 Wickth )。
* 控制水平与垂直方向的地形生成噪声函数
* 控制每个生态群系的地形生成高度以及波动性
* 由图像生成生态群系图
* 控制生态群系，岛屿和大陆的规模
* 自定义生态群系
* 众多关于洞穴与峡谷的设置项
* 控制自然结构的生成，诸如天然矿井、要塞和村庄
* 对矿物、植物、地牢、池塘和其他生成物的完全控制
* 自定义树木和其他对象（BO2 以及 BO3）
* 替换方块
* 支持视觉设置，如设置树叶的颜色（需要客户端也安装TerrainControl）

想了解更多，请继续阅读。

== 向导 ==
=== 准备工作 ===
==== 安装向导 ====
Terrain Control 插件支持CraftBukkit，Spigot，Cauldron和Forge （甚至单人游戏），jar文件可以在所有这些平台上面运行。
===== Forge （单人游戏） =====
首先，下载并且安装Forge，运行一次Minecraft以确保所有文件正常运行。然后通过Terrain Control百科主页面上的下载链接下载插件，确保和Minecraft本体的版本对应。把文件放进.minecraft文件夹下的mods文件夹。
你现在可以创建一个Terrain Control所定义的世界类型。这个 Mod 只会影响到这一个世界与这个世界的类型。如果你没有更改在 .minecraft/mods/TerrainControl/worlds/YOUR_WORLD_NAME/ 里面的配置文件，这个世界只会成为一个默认的Minecraft世界。每当你改变了配置，你必须删除.minecraft/saves/YOUR_WORLD_NAME/region 文件夹来重新生成世界，被更改的设置不会影响到已经生成的区块。向导会教给你如何自定义一个世界类型。
2.1.1.2 CraftBukkit，Spigot 和 Cauldron 服务器
只需要把jar文件放入plugins文件夹，就像其他的Bukkit插件一样。此时并不需要在玩家的客户端上安装相应的单人游戏版本的Terrain Control，但是如果安装了可以体验到更多的特性。
在你安装完成之后，你必须为你新的世界激活这个插件。如果你没有一个类似于Multiverse的多世界管理插件，可以通过如下修改bukkit.yml 来允许插件操作这个世界（请在yml文件里使用空格，不要使用 tabs!）:
 
<code>worlds:
你的世界名称:
generator: TerrainControl</code>
如果你使用了 Multiverse，你可以创建一个Terrain Control 类型的时间通过使用命令：
/mv create 世界名称 normal -g TerrainControl
如果你通过配置多世界插件来使用Terrain Control 更改你的一个默认类型的世界，也需要把Terrain Control 添加到 bukkit.yml （操作如上），Terrain Control 需要这个来正确地为默认世界进行初始化。如果你使用其他的多世界管理插件，请自行查看其介绍文档进行配置。请使用 TerrainControl （在 Terrain 和 Control之间没有空格）作为generator名称(即generator 后面填的)，区分大小写。
如果你没有更改在 plugins/TerrainControl/worlds/YOUR_WORLD_NAME/ 目录下的配置，这个世界只会成为一个默认的Minecraft世界。每当你改变了配置，你必须删除 .minecraft/saves/YOUR_WORLD_NAME/region 文件夹来重新生成世界。被更改的设置不会影响到已经生成的区块。向导会教给你如何自定义一个世界类型。
===== Forge服务器(也就是官服) =====
确保Forge安装到了服务器。把插件放进mods文件夹。去 server.properties 文件然后设置level-type 到 TerrainControl (没有一个空格在 Terrain 和 Control之间)。删除主世界的 level.dat 来得到一个正确的世界类型。
如果你没有更改在 .minecraft/mods/TerrainControl/worlds/YOUR_WORLD_NAME/ 里面的配置文件，世界只会成为一个默认的Minecraft世界。每当你改变了配置，你必须删除 .minecraft/saves/YOUR_WORLD_NAME/region 文件夹来重新生成世界。被更改的设置不会影响到已经生成的区块。下面的向导会教你如何自定义一个世界类型。
==== 准备工作向导 ====
欢迎使用Terrain Control。
在你成功的安装Terrain Control之后，你可以开始创建你的新世界。我们先创建一个种子为”12”的创造模式的世界（TerrainControl作为generator），使用这个特定的种子是为了使你的世界与教程所介绍的相同。如果你需要创建一个不同的世界，只需要跳过这个列表。
* 如果你是单人游戏，点击创建新的世界按钮，选择创造模式作为游戏模式然后填写一个名称。点击更多世界选项按钮，把种子改成12然后选择 TerrainControl 作为世界类型。确保打开了允许作弊（你需要使用 /tp 命令）。
* 如果你在 Bukkit 服务器上然后你有 Multiverse 多世界插件,你可以使用 /mv create world_name NORMAL -s 12 -g TerrainControl 来创建世界然后使用 /mv tp world_name 来传送到这个世界。
* 如果使用的是其他的多世界管理插件且使用的是Bukkit服务器，请查询该多世界插件的帮助文档。创建一个新世界（记得把12作为世界的种子），然后将TerrainControl作为世界类型。
* 如果你在使用Bukkit服务器，但是没有任何多世界管理插件，请前往 bukkit.yml 增加下列内容：
worlds:
你的世界名称:
generator: TerrainControl
记得把 “你的世界名称” 改为你所习惯的世界名称。而且，在文件里面不要使用tab键，只能使用空格键。前往 server.properties 文件然后将 level-seed 设置为12。之后删除整个世界文件夹来得到一个全新的含有正确地图种子的 level.dat 文件。
* 如果你使用的是Forge服务器（官服），前往 server.properties ，把 level-type 设置为TerrainControl ， level-seed 设置为12。删除整个世界文件夹来得到一个全新的含有正确的种子的 level.dat 文件。
此时可以登陆一次你的世界让 Terrain Control 生成新的配置。但你会注意到这个世界和默认的Minecraft世界没有任何区别，因为你还没有更改配置文件。
找到你的Terrain Control 设置文件夹（如果不知道在哪儿可以参考安装说明）,你应该可以看到一些类似于这样的东西：

[[文件:TerrainControl-1.png||TerrainControl-1]]

打开 WorldConfig.ini（推荐使用Notepad，但是不要使用含有字体样式的编辑器，比如说Word）
带有 # 开头的行是注释，是对每一个变量进行的解释。在Wiki的WorldConfig页面上，你还可以找到更多的信息。
为了验证所有的东西都正常工作，我们来更改一个数值试试。GenerationDepth是一个非常有用的变量，如果你把它设置成9，所有的生物群系大小将减半（仅仅是x和z两个方向，就是说高度还是原来的）。如果你设定为了11，所有的生物群系大小翻倍（同时也只是在x和z两个方向）。如果你设置为12，那么生物群系的大小将会变得和”巨型生物群系”世界类型的生物群系大小一样大。让我们试试把它改成12，然后保存。
如果此时（重新）打开游戏/服务器，你并不能看到任何变化，必须探索新的区块来查看新的地形，这和其他的编辑器（如WorldEdit）一样。你可以删除region文件夹来重新生成地图，但是如果你删除世界文件夹里面的region文件夹，仅仅是删除了地形，而保存了玩家的位置信息和地图种子。注意！不要在服务器/游戏运行时这么做！
在你成功删除了region文件夹之后，打开服务器/游戏来测试你的更改。你应该能看到含有一个大型生物群系的世界。
现在可以浏览一下WorldBiomes文件夹。再次强调：不要忘记关掉服务器/游戏。你会发现里面有很多代表生物群系配置（BiomesConfig）的 .bc 文件。有些文件看起来难以理解（比如Sky.bc文件），还有一些根本不是生物群系（比如沙滩和河流生物群系并不存在），还有一些有非常奇怪的名称（如Mesa Plateau F M）。然而这些名称都是Mojang确定的。

[[文件:TerrainControl-2.png||TerrainControl-2]]

你可以先忽略这些奇怪的生物群系名称，打开 Desert.bc 文件。如果你往下翻这个文件，你可以发现BiomeHeight 和 BiomeVolatility变量（就是在Terrain Generator Variables下面的东西）。我们先在沙漠上面加点山丘，设置 BiomeHeight 为 0.2（让地形更高一点，而不是多加点山丘）还有 BiomeVolatility 设置为 0.4 （让这里多加点山丘）。现在保存文件，删除region文件夹。如果你确定使用的是12地图种子，可以使用/tp -19 80 -306来传送到一块沙漠里面。

[[文件:TerrainControl-3.png||TerrainControl-3]]

也许悬崖边的石头显得有些突兀，沙石看起来会更棒。请关闭游戏/服务器，然后打开 Desert.bc 然后设置 StoneBlock (在“Block”部分) 为 SANDSTONE。这把所有的石头改成了沙石。关闭游戏/服务器，删除region文件夹然后打开服务器/游戏。
[[文件:TerrainControl-4.png||TerrainControl-4]]

现在也许你已经体验到了Terrain Control的力量。如果你想知道其他的设置会产生什么效果，可以好好看一下 WorldConfig 和 BiomeConfigs文件里面的设置。如果需要创建自定义的生物群系，你应该继续读下去直到向导结束。在主页面你还可以发现大量其他的向导，示例页面也会对你很有用处。

==== 你的第一个自定义生物群系 ====
在这个向导里面我们来创建第一个自定义生物群系。在前面的教程中我们把默认的沙漠多加入了一些丘陵，把石头替换为沙石。我们现在将创建一个有很多花和一些树的山地。
你可以使用之前的世界继续工作。或者，您可以创建一个种子为12的新的世界。请确保GenerationDepth也设置为了 12 (在 WorldConfig.ini 中找到)，使生物群落变得更大。如果你已经这么做了，可以使用本教程中的坐标。如果不是，在给定的坐标里会找到其他的生物群系，必须自己寻找需要的群系。
我们需要先向生物群系列表添加自定义的生物群系。需要修改的第一个选项是 CustomBiomes。打开 WorldConfig.ini 文件，并搜索该选项。需要如此编辑CustomBiomes的一行:
CustomBiomes:Flowerfield:40
这样Terrain Control的控制器就能读取叫做Flowerfield 的生物群系了。生物群系的ID将设置为40。生物群系ID就像方块ID一样，但是这有专门的列表记录以及最高的生物群系ID只能是254，两个生物群系不能出现相同的ID。
如果你重启了你的游戏/服务器，你会在 BiomeConfigs 目录下发现一个新文件： FlowerfieldBiomeConfig.ini。然而，你的世界看起来没什么变化。我们需要将我们生物群落系添加到生物群系列表。通过在NormalBiomes（位于WorldConfig.ini）里加入项，我们可以让它成为正常生成的生物群系，就和大多数生物群系一样。下面来把你的生物群系添加到NormalBiomes 列表：
NormalBiomes:Desert,Forest,Extreme Hills,Swampland,Plains,Taiga,Jungle,Flowerfield
确保服务器关闭/游戏地图未开启后，删除世界文件夹里的region文件夹然后重新打开服务器/地图。使用/tp -1010 78 -11来传送到这个位置后，你可以看见你自定义的生物群系。虽然它看起来还不令人满意，但别忘记，你还没有改变任何设置呢：

[[文件:TerrainControl-5.png|TerrainControl-5]]

如果你没有使用单人游戏Mod的Terrain Control，颜色会出现一点点差别。
首先，我们来绿化一下生物群系。打开 FlowerfieldBiomeConfig.ini，向下滚动直到你看见 Visuals 和 weather section（视觉效果&天气部分）。在这里你可以更改生物群系的颜色。但是，如果在客户端上没有TerrainControl的Mod，则不会有任何效果。如果你把地图应用在单人游戏上面，这当然没有任何问题；但是如果你使用在Bukkit服务器上面，你的玩家只能看见Minecraft标准颜色模式。颜色都是十六进制的，为了找到想要的颜色，你可以搜索一下“拾色器（Color picker）”，请注意一下大多数拾色器使用的是带有前缀#的颜色编号，这在网页设计中是常见的。但是，TerrainControl要求使用0x来代替#，这在Java中是常见的。
在本教程中，我们并不会启用颜色设置。TerrainControl有一个很有用的选项，可以使用别的生物群系的ID来保存我们自己的生物群系。这将会使颜色，天气和生物都和另外一个生物群系相类似。然而，地形的形状和特性仍然看起来一样。我们打算使用蘑菇岛生物群系，因为它有很好看的绿色草地（通常不常见，因为那里覆盖满了菌丝，但试着在那里种一块草你就能发现了）。另外，没有敌对生物会生成在上面。向上滚动找到 ReplaceToBiomeName ，并将其设置为 MushroomIsland。
请确保服务器关掉/地图没有打开，删除世界文件夹内的region文件夹并重新启动服务器/打开地图。使用命令 /tp-1010 78-11 传送到该位置，您现在可以看到生物群落绿了很多：

[[文件:TerrainControl-6.png|TerrainControl-6]]

现在，我们要让生物群落多一点山丘。再次打开 FlowerfieldBiomeConfig.ini，将 BiomeVolatility 设置为 0.5。如果你现在再测试地图，你会看到，在一些地方土地低于海平面。为了解决这个问题，我们需要把生物群系的海拔提高一下，而不是增加山丘的数量。将 BiomeHeight 设置为 0.5，使生物群落高一点。
关闭服务器/世界，删除region文件夹并重新打开服务器/世界。现在，您应该看到一些小山：

[[文件:TerrainControl-7.png|TerrainControl-7]]

现在我们要将一些资源添加到生物群系。TerrainControl拥有强大的资源控制体系，由一长串的列表来控制，资源可以是矿、植物、树或者小湖等。几乎所有资源都有其生成频率选项，该数据选项设置其生成频率是默认的多少倍。几乎所有的资源都有稀有程度设置，来确定资源生成的概率。通常的地形还有另一个限制因素：比如如果没有足够的空间来生成一棵树，它就不会生成，即使概率是100。
资源系统所使用的函数语法也用于其他地方的一些配置，它是这样使用的：
NameOfFunction(parameter,parameter,parameter,…)
函数名(参数,参数,参数,……)
如果你有 Microsoft Excel 电子表格的使用经验，应该对这种语法熟悉：每个参数所做改变都会影响在资源中的一些东西。
所有的资源同时摆放在一个列表中，叫做资源队列（Resources queue）。这已经超出了本向导所能够介绍到的范围，然而一些关于我们的植物生物群系的有趣的资源也许会被描述到。
一方块高的花在Minecraft中是单一的方块资源。在资源队列中，有两个资源设计是为了单一方块。草的工作（即草在TerrainControl的生成时做的运算）比其他植物更容易一些，但它只可以在地形的顶端生成。而植物在会在最小和最大高度之间选择一个随机值，然后检查这个位置是否合适。而草只是简单的把自己生成在最高的方块上面，关于这个你可以查看一下高度图。
出于某种原因Mojang在Minecraft游戏中使用植物的资源方式来生成花，我们没有理由也这样做，于是将使用草的资源生成方式来生成。草的资源生成方式的语法如下所示：
Grass(Block,BlockData,Frequency,Rarity,BlockSource[,BlockSource2,BlockSource3.....])
草(方块,方块数据,生成频率,稀有度,方块源[,方块源2,方块源3…])
Block是方块的ID或者方块的名称。BlockData是方块的数据，取值氛围为0到15。Frequency 和 Rarity在之前已经讲解过。BlockSource是可以在此方块上生成的所指定的方块。
首先，我们删除掉标准的控制花生成的两行代码，因为我们并不打算使用植物的资源生成方式。从资源队列中删除这两行：
Plant(RED_ROSE,2,100.0,0,128,GRASS,DIRT,SOIL) Plant(YELLOW_FLOWER,2,100.0,0,128,GRASS,DIRT,SOIL)
然后我们在资源队列的末尾添加如下的草地资源生成方式：
Grass(RED_ROSE,0,40,100,GRASS) Grass(YELLOW_FLOWER,0,80,100,GRASS)
这理论上会在每个区块上面多生成40个红玫瑰和80朵黄花（1.7.2后为罂粟和蒲公英）。当然，地形并不总是适合花的生成，所以我们不会看到那么多的花。另外一件事情是每次生成位置的选择是随机的，这意味着它可能替换一朵已经生成了的花！
像之前一样，如果你关掉了服务器/游戏，删除region文件夹然后重新打开，你会看到这样的景象：

[[文件:TerrainControl-8.png|TerrainControl-8]]

哇！好多好多花啊！让我们再添加一些高大的草来让我们的生物群系更好看一点怎么样哟？这儿已经有关于高大的草在资源队列里面了，所以我们只是更改一下资源生成的概率罢了。把这一行这么改一下：

Grass(LONG_GRASS,1,10,100.0,GRASS,DIRT)
找到这一行: (注意把10替换成80)

Grass(LONG_GRASS,1,80,100.0,GRASS,DIRT)
关掉服务器/游戏，删除区块文件夹然后重新打开游戏/服务器。看起来好多了，难道不是么？

[[文件:TerrainControl-9.png|TerrainControl-9]]

本教程几乎已经结束了，但是我们还需要添加一些树。如果没有树，那么在这个生物群系中将很难生存下去。树资源的语法如下所示：

Tree(Frequency,TreeType,TreeType_Chance[,Additional_TreeType,Additional_TreeType_Chance.....])
Tree(生成概率,树的类型,树的类型的概率[,附加的树的类型,附加的树的类型的概率.....])

它有一个很俏皮的语法来生成你想要什么类型的树。每次尝试（有概率的尝试），它首先选择第一个TreeType。如果这个TreeType没有成功的生成，那是因为TreeType_Chance（这一一个控制成功生成的概率）或者因为地形不合适。然后它继续选择下一个 Additional_TreeType。如果那棵树还是不能生成，将会继续，直到列表中的所有树都被处理。

有些树的名字并不好记，比如说Forest其实是白桦木，而Tree却只是橡树。

把这一行加入到资源队列的末尾:

Tree(1,Forest,4,Tree,4)
这意味着每个区块中只有一次尝试。这种尝试，只有4%的概率（地形是合适的）能成功生成白桦树。如果白桦树没有成功的生成，只有4%的概率会生成一棵普通的橡树。

关掉服务器/游戏，删除区块文件夹然后重新打开服务器/游戏。我们的生物群系从技术上讲已经完成了：

[[文件:TerrainControl-10.png|TerrainControl-10]]

然而，如果你在Bukkit服务器上面而且使用了/tc map，生物群系就会显示为方块生物群系。你可以通过改变BiomeColor来改变这个事实。我们将会使用0xb8e65c。关掉服务器/游戏，删除区块文件夹然后重新打开服务器/游戏。执行命令/tc map，你会得到一张像这样的地图：

[[文件:TerrainControl-11.png|TerrainControl-11]]

如果关于这个世界你有任何问题，你可以在这里下载已经完成的地图版本。

恭喜，你已经完成了你的自定义生物群系！现在你可以创建如你所愿的生物群系啦。你已经知道如何创建山丘、森林、草地、鲜花等等。下面是一些额外的贴士：
* BiomeTemperature:0 将会导致生物群系被雪覆盖。但是在客户端没有安装本Mod的，将会在地上看到雪，但却下着雨。解决这个问题你可以使用ReplaceToBiomeName:Taiga.
* 水将会在地形地狱海平面试产生。使用 BiomeVolatility 以及 BiomeHeight 设置你可以更好的控制陆地形状的生成。
* 看一下默认的配置文件来寻找如何让你的生物群系取得一定的效果。TC论坛帖子中的下载资源同样也是一份有价值的资源。

祝你好运!

==== 常见问题 ====
本插件并不一定总能把地形制作的如你所愿。此页面将把初学者经常遇见的一些问题罗列出来。如果你仍然困惑，你可以创建一个[http://dev.bukkit.org/server-mods/terrain-control/forum/ 论坛话题] 来描述你的问题。问题应当描述的尽可能详细，并且把你的日志也发送出来(最好是 pastebin.com 上的这种或者类似的) 或者把你的日志放进ZIP压缩文件当中。
* 我的world文件夹没有被创建，只有GlobalObjects 存在。
本插件不会在你安装时接管你的世界。你需要为一个世界打开本插件。同安装说明一模一样的来安装。如果你仍然困惑，发布一个论坛话题并且把启动日志加上是很重要的。
* 我的设置没有对地形产生任何影响。
你试过再生地形（即删除区块文件夹）么？如果是，把你的TerrainControl文件夹放到另外一个地方并且重新打开服务器/游戏然后看看本插件是否已经重新生成了配置文件。如果没有，那么本插件甚至没有读取它们。参阅上述有关问题来寻找这个插件的解决方案。如果是，请看看BiomeMode 和 TerrainMode ，确保它们没有设置为默认（Default）（这使得本插件忽略你的配置来使用香草来代替）。
* 我出生在一片海洋中而没有任何陆地。
别担心，陆地存在。不停地游泳。或者你可以改变地图的种子（服务器: 你需要新的 level.dat，仅仅改变 server.properies 是不行的）。11号种子将会把你生成在陆地上面。你也可以禁止或海洋面积（改变WorldConfig中LandRarity 设置）：

[[文件:TerrainControl-12.png|TerrainControl-12]]

* 特定的设置并不起作用（但是其他的设置正常工作）。
大多数设置区分大小写和空格的，这是为了使它更加准确。某些设置需要较高的数值来使其具有明显效果。有些设置需要在客户端上面有对应的Mod（见文件/此wiki中的注释）。有些设置并不依赖于其他的设置（同上，见文件/此wiki中的注）。

如果你不熟悉本插件，始终确保SettingsMode 设置为 WriteAll。这会使地形控制重置或删除它一概不听（译者：并不清楚作者到底要表达什么），所以，你会立刻注意到有些不对劲。

=== 中期讲解 ===
==== 如何从一张图片创建世界 ====
'''如果你不能找到你所需要的信息，你可以参考论坛或使用mysource所作的[http://kartwork.de/tutorial/html/map_by_image.html 这个教程]'''

创造属于你自己的世界是很困难的，河流，岛屿，也许总是会在错误的地方产生，这应该不是你想要的。也许你的山看起来不够好，当然，你也可以拥有更多生物群系的选项。但是，运用地形控制的功能，从一个图像生成生物群系。你可以完全操控你的世界,或者使用原有生态环境并改变地形来创建一个图片。

[https://github.com/MCTCP/TerrainControl/wiki/Creating-a-world-from-an-image#small-map-improvements 做一些小型图片].

===== 优点与缺点 =====
优点:
* 完全控制你的生物群落
* 使其更容易处理
* 可以用来定制冒险的地图

缺点:
* 图片并不是无限大的，你必须让生物群系控制器生成别的生物群系当你在图片所表示的范围之外时。
* 没有随机生物群系组合：生物群系布局看起来一样好（或坏），正如你所画的。
* 有一些怪异的东西，将在下面说明。

===== 创建一个图像 =====
在每一个[https://github.com/MCTCP/TerrainControl/wiki/BiomeConfigs BiomeConfigs] 有一个''BiomeColor''变量. 这个变量应该是生物群系的十六进制颜色。它不仅用作 ''/tc map'' 命令输出颜色,而且作为输入图像的颜色。必须使用准确的设置“BiomeColor”，让图片所生成的生物群系更准确。两个生物群系不一定是同样的颜色，如果是一样的颜色将出现奇怪的问题。每一个自定义生物群系你都应该把 ''BiomeColor'' 从 0x000000 (黑色) 到另一种颜色。

默认生物群系的RGB（红绿蓝）数值和16（0xXXXXXX）进制数值 (本插件使用和 [http://www.minecraftforum.net/topic/626786-amidst/ AMIDST]一样的生物群系颜色):

[[文件:TerrainControl-13.png|TerrainControl-13]]

图片上面的每一个像素代表一个4x4的方块。正如上文所讲，图片中的颜色必须同 ''BiomeColor'' 一样。大多数图片编辑器的笔刷工具不管用，因为它们把颜色改成了另外一个。

[[文件:TerrainControl-14.png|TerrainControl-14]]

模糊工具(称为抗锯齿)允许对象正确的混合图像但是，本插件并不能正确的识别这些颜色。当本插件发现一种颜色没有在配置文件里面提到时，将会在那里生成海洋。所以还是使用编辑（俗称）铅笔工具更好一点，因为这个并没有使用到抗锯齿。一定要把文件保存为png格式，因为本插件只支持这一种格式，其他的大多数格式会在压缩（保存）时改变颜色。在使用图片生成世界时一定要确保它没有使用抗锯齿或者被压缩。

另外一种常见错误是在调整图片大时没有禁用抗锯齿：

[[文件:TerrainControl-15.png|TerrainControl-15]]

当使用草图开始绘画时，可以假定右侧为北方，也可以使用上侧为北方（这是最常用的），在生成时请将图像旋转90度。如果要编辑使用“/tc map”命令得到的地图，请参见下方章节。

===== 让本插件更正确的生成地形 =====
当你满意你的结果之后（确保大小和角度都调整正确），是时候让本插件来生成啦。把图像放到WorldConfig.ini旁边然后看一下以下设置：

''ImageMode''-可以设置为 ''ContinueNormal'' 或 '' FillEmpty ''。 'ContinueNormal' 会告诉地形控制生成随机地形(如 ''BiomeMode:Normal ''，基于它的设置) 在图像所表示的范围之外。 ''FillEmpty'' 将填补图像外区域与 ''ImageFillBiome'' 设置相同，默认海洋生物群落。

''ImageFile'' - 你要使用的图片的名字，默认为map.png，必须是png格式。

''ImageFillBiome'' - 生物群落设置'ImageMode' 设置为 FillEmpty 时用于生成图像表示区域之外的地形生成(注意: 在TerrainControl找到一个无法辨识或起冲突的生物群系颜色时，如果这个更改了使用的生物群系，则需要进行测试)

''ImageXOffset'' 以及 ''ImageYOffset'' - 改变图片的坐标位置，常用来改变x：0 y：0坐标相对应的图片位置。使用 ''ContinueNormal'' 来把图片大小减半的时候，使用FillEmpty 模式把减半的图像大小改为相反的数值。样例：一个 500x500 大小 map.png文件在''ContinueNormal''模式下，X和Y坐标设置为250，但是FillEmpty模式为 -250 。

===== 使用/tc map和ContinueNormal来编辑一副随机地图 =====
本插件使用命令/tc map来到处一副生物群系地图。它所生成的图像有一些额外的功能，可以重新作用为输入图像的 ''FromImage'' 。

当时也/tc map时，本插件将会把图片的右边设置为地图的北边，所以如果你假定顶端为北边，请旋转90度。/tc map命令到处的是1像素相当于1方块但是导入时为1像素等于4x4方块。当图片是你地图的尺寸时你应当把它缩小四分之一来使世界的大小正常。

==== 基本的自定义世界 ====
'''''在自定义之前，岛屿生物群系以及边界生物群系仍然要讲一讲。'''''
这个教程将会帮助你定义世界的形状。本教程仅仅描述了 BiomeMode:Normal 模式。此教程可以使用于单人游戏以及多人游戏模式，拥有也许没有 [https://github.com/MCTCP/TerrainControl/wiki/Terrain-Control-User-Interface 用户界面]. 你应该已经安装本插件，你也应该知道如何更改设置以及如何重新生成世界。如果并没有，请看[https://github.com/MCTCP/TerrainControl/wiki/Installation-instructions 这里] 来寻求安装帮助以及 [https://github.com/MCTCP/TerrainControl/wiki/Beginners%27-tutorial-without-the-UI 这里] 来查看准备工作教程。

再一次打开一个新的世界。首先，查看[https://github.com/MCTCP/TerrainControl/wiki/WorldConfig WorldConfig.ini] 文件然后看看在'Biome Generator Variables'下面的设置 (用户界面: World tab -> Biomes tab). 往下滚动一点，你将会看见四个变量：

''NormalBiomes'' , ''IceBiomes'' , ''IsleBiomes'' and ''BorderBiomes'' .

理解他们需要了解一些背景信息。游戏中的世界是由各大洲为原型的。在'NormalBiomes ' 生成。其余部分则由海洋生物群落区填补。使这更有趣的你可以给生物群落知道边界 (例如，海滩生物群落区是海洋和大多数其他生物群落之间的边界) ，要使用 'BorderBiomes（译为边界生物群系） '。此外可以生成其他生物群落内部的生物群落。他们被称为 ' IsleBiomes （译为岛屿生物群系）'。例如，蘑菇岛是岛内海洋生物群落内部的生物群落。一些地区在地图标记为 'frozen（冻土）'。如果冻土区在大陆的上面将会生成一个 'IceBiomes（冰雪生物群系） ' (而不是一个 'NormalBiomes')。如果它出现在海洋上面将会生成一个 FrozenOcean （上冻的海洋）(然而你可以关掉) 生物群落。

===== Technical biomes(表面生物群系) =====
也有一些'technical biomes(表面生物群系)'。他们不被视为真正的生物群落区，但他们让地形更加多样化。本节描述其功能的默认设置，并可能激发您原创的灵魂。请记住你可以改变一切: 如果你想要的你甚至可以生成 TaigaHills 生物群落作为丛林和沙漠之间的边界。

河是表明生物群系之一: 它被称为一条河，但它是只是一个生物群落含有大量的水。世界控制器将会在大陆顶端生成该生物群落（形似一条河），并且当冻土区出现在一条河上面的时候，FrozenRiver（上冻的河流）生物群落区将会代替它(但是您可以关掉)。您可以编辑 RiverBiomeConfig 里面生成的东西使它生成的根本不像一条河：

[[文件:TerrainControl-S1.jpg|TerrainControl-S1]]

也有一些山生物群落: TaigaHills、 JungleHills、 DesertHills 和 ForestHills。那些将作为 IsleBiome（岛屿生物群系）和他们生成在针叶林、丛林、沙漠和森林之间。当你看到一座大山在这些生物群落之一的里面的时候，可以确保你看到了 HillsBiome。(因为Extreme Hills（极高的山）添加到 'NormalBiomes'并不会产生在其他生物群落内)。河，也就是含有很多水的生物群落，同时也作为了 IsleBiome的一员：它生成为沼泽里面的小岛。

作为 BorderBiome的 MushroomIsland 与其他所有生物群落 (通常是海洋) 来平滑地过渡，生成 MushroomIslandShore ，极端高的山 (也是 BorderBiome) 为平滑过渡极端高的山和大多数其他生物群落。

大多数使用本插件的人经常使用表面生物群系来把它们的生物群系做成它们想要的，他们使用它来平滑的过渡两个生物群系，这使得生物群系更加多样化，比如说生成雪山等等。例如， [https://github.com/Burckhart Burckhart(布什)] [http://dev.bukkit.org/server-mods/terrain-control/forum/41337-nested-biomes/#p2 使用了] 一大堆边界生物群系和岛屿生物群系来生成一条山脉。

[[文件:TerrainControl-17.jpg|TerrainControl-17]]

===== NormalBiomes(标准生物群系) =====
说明：文中的香草生物群系指的是已经存在的生物群系，换句话说就是纯净Minecraft中所有的生物群系。

在这里你可以看到地图上只有陆地和海洋。

[[文件:TerrainControl-18.png|TerrainControl-18]]

绿色区域是 NormalBiomes （标准生物群系），蓝色区域是海洋生物群落区。

你可以使用 LandRarity 变量来设置海洋和陆地之间的比例：

[[文件:TerrainControl-12.png|TerrainControl-12]]

现在是时候来看看如何填充那绿色的土地。我们在设置 LandRarity为100。如果你看看了NormalBiomes 变量，你将看到以下内容：

NormalBiomes:Desert,Forest,Extreme Hills,Swampland,Plains,Taiga,Jungle
NormalBiomes:沙漠,森林,高山,沼泽,平原,针叶林,丛林

其中给出了以下生物群落区地图 (IsleBiomes 和 IceBiomes生物群系被移除了，这使图像看起来更干净):

[[文件:TerrainControl-20.png|TerrainControl-20]]

如果你想要一个单调(热)的世界，你可以把 NormalBiomes 中的大多数生物群落移除:

NormalBiomes:Desert,Jungle
NormalBiomes:沙漠,丛林

[[文件:TerrainControl-21.png|TerrainControl-21]]

(如果你仍然看到有一些寒冷地区在游戏里面，是因为 IceBiomes的存在。我们一会再管他。)

你可以更改生物群系稀有度在 [https://github.com/MCTCP/TerrainControl/wiki/BiomeConfigs BiomeConfigs]里面。如果你想要在你的世界有更少的丛林，去 JungleBiomeConfig.ini 找到BiomeRarity (这是实际上生物群落生成的概率) 设置为 25。

[[文件:TerrainControl-22.png|TerrainControl-22]]

现在我们在讨论 NormalBiomes。稍后我们将制作我们自己自定义的生物群落。

===== IsleBiomes(岛屿生物群系) =====
''TODO: 我们是在这里只是玩弄一些岛屿生物群落''

岛屿生物群落是可以生成在其他生物群落之内的生物群落。生物群落需要较小的面积 (所以 BiomeSize 需要更高)才能够在另一生物群落区之内生成。

当生物群落为岛屿生物群落时， BiomeRarity 变量会略有不同。它现在非常敏感: BiomeRarity:100 将使它生成在生物群落区之内的各个位置 (除了在边界（两生物群系区之间位置）-填补这一区域应使用边界生物群落)。 BiomeRarity:99 将使它生成约 50%的区域，25%的区域为 BiomeRarity:98，等等。

Mister_Tesseract 做了有关岛屿生物群落的详细的教程。[https://docs.google.com/document/d/1pVqAE28zkS-VFyxt3HtnLwEkJrGcPShEORhoGxZbOk/edit 在这里阅读它]。

===== BorderBiomes(边界生物群系) =====
''TODO''
译者注:这是作者还没有完成,不是译者没有翻译

===== IceBiomes(冰雪生物群系) =====
一些地区在地图标记为 'frozen（冻土）'。如果冻土区在大陆的上面将会生成一个 'IceBiomes（冰雪生物群系） ' (而不是一个 'NormalBiomes') (然而你可以关掉：通过设置([https://github.com/MCTCP/TerrainControl/wiki/WorldConfig WorldConfig]) 中的 FrozenRivers 为 false)。如果它出现在海洋上面将会生成一个 FrozenOcean （上冻的海洋）生物群落(然而你可以关掉：通过设置([https://github.com/MCTCP/TerrainControl/wiki/WorldConfig WorldConfig]) 中的 FrozenOcean 为 false)。

您可以通过更改 IceRarity 变量更改冻土区域生成的概率。较低的值将生成比较少冻结的区域，较高的值会使地图的绝大部分冻结。

请注意生物群落区的温度并不是取决于将它添加到 IceBiomes 列表，而是更改在 BiomeConfigs 中的 BiomeTemperature 变量。你可以在 NormalBiomes 列表中获取到冰冻的生物群系 (针叶林是在默认配置中的例子)，你可以在 IceBiomes 列表中有炎热的生物群落。这使名称 IceBiomes 出现了小小的误差。

===== CustomBiomes(自定义生物群系) =====
默认情况下只有香草生物群落在 BiomeConfigs 文件夹中。若要添加您自己生物群落区，您必须先将其添加到 CustomBiomes 列表。这将使本插件生成它的配置文件 (或如果它已经存在，请使用该文件)。然而，它不会控制它们产生在你的世界。就像香草生物群落，你必须将它添加到四个生物群系中的一个或多个物群落区列表。所以您自定义的生物群落是总是在WorldConfig.ini 出现在至少两个地方。

(但是，您还可以让你的生物群系从一幅图像中生成，你只是将其添加到 CustomBiomes 列表以及图像所对应的生物群落区。欲获取更多信息，请查看 [https://github.com/MCTCP/TerrainControl/wiki/Creating-a-world-from-an-image这里])。

在每个列表中的条目之后，您将看到":"与它的数量 (如果您自己没有添加它，本插件将替你添加它):

CustomBiomes:MyBiome:50,MyOtherBiome:51

这是保存在世界中的生物群落区 id。这个永远不会改变除非你重置了世界!(想象假如你自定义的丛林生物群落与 id 50，现在使用 id 50 是雪生物群落。这会导致所有自定义的丛林被冰冻!)此外，永远不要使用一个已在香草生物群系使用的 id。目前香草生物群系使用 id 0-22，但随着新的生物群落区添加到香草生物群系，将按照顺序使用新的生物群落区 id。所以如果您使用的生物群落区 id 为40 ，你应该可以保留它很长时间。

==== 基本的自定义生物群系 ====
此页重点介绍创建和编辑生物群落的基础知识，包括更改地面和水、矿石、树/植物的生成以及山/坑的生成。ReplacedBlocks 特性的信息，请使用 CustomHeightControl 等更难一些的功能，比如说瀑布(建设中)。

生物群落区的编辑和设置可以分成四个主要部分: 生物群落区位置、地形形状、生物群落区的实体数量和外观。有关更多生物群落的生成位置信息请参阅 [https://github.com/MCTCP/TerrainControl/wiki/Basic-world-customization 本教程]。

===== 地形形状 =====
地形的形状被一大堆变量所控制。你可以改变它的高度，有多不平坦（即丘陵），多少空气要被填充为水。地形的形状是计算地形之后，地形控制器所要过的第一道关口。

====== 地形高度 ======
其中确定生物群落高度的第一个和最重要的变量是 BiomeHeight 。这个变量依赖在 worldconfig 中的WorldHeightBits 设置。Minecraft 将它生成的地形高度划分为相等的正负值与以及BiomeHeight设置为 0.0 代表中间。在默认设置 (WorldHeightBits:7) 的地形将生成达 128 的高度，将把 BiomeHeight:0.0 放在 y = 64的位置。如果 WorldHeightBits 更改为 8 ，高度就会成为 256，然后每个关于高度的设置，其效果大致增加一倍。BiomeHeight:0.0 将会成为 y = 128的位置，加大到 0.1 将双倍地对 WorldHeightBits:7 产生影响。把WorldHeightBits提高为8，会使得地形生成最多 256的高度。如果将WorldHeightBits 降低，将会产生相反的效果，每一次降低会使地形生成最大高度减半。WorldHeightBits 为6也不能使地形高64左右。提示：这两个变量不会有效果如果控制器被设置为OldGenerator（此设置在[https://github.com/MCTCP/TerrainControl/wiki/WorldConfig WorldConfig]里面）。

改变 ExtraBiomeHeight 将会以“8乘以它的值”的次数来创建悬崖。改变 ExtraHeightConstrictWaist 可以确定悬崖的生成。保持它的数值在-0.4和1.0之间。大于 1.0 可以导致悬挂和漂浮的地形。负值会导致中部地区 (4 x ExtraBiomeHeight) 扩大。降低到 -0.4 以下可以创建地下的巨大洞穴。

下表可以帮助确定基于WorldHeightBits 为 7 和 8的高度设置。不要使用-2.0 作为 BiomeHeight 的设置，因为这是BUG。此外请注意地形不会生成最大的256 高度，它将停止在 255，如果在此之前没有别的方块。 BiomeHeight 可能会是-10 到 10 之间的任意值，虽然低于/高于-4/4 的任何值没有任何其他的效果了。

{| class="wikitable"
|-
! BiomeHeight !! WorldHeightBits:7 !! WorldHeightBits:8
|-
| -4 || 0 || 0
|-
| -3.5 || 7 || 10
|-
| -3 || 16 || 28
|-
| -2.5 || 24 || 45
|-
| -2 || Error || Error
|-
| -1.99 || 32 || 60
|-
| -1.5 || 40 || 78
|-
| -1 || 48 || 95
|-
| -0.5 || 57 || 111
|-
| 0 || 67 || 128
|-
| 0.5 || 76 || 144
|-
| 1 || 85 || 156
|-
| 1.5 || 94 || 173
|-
| 2 || 102 || 190
|-
| 2.5 || 111 || 207
|-
| 3 || 119 || 223
|-
| 3.5 || 128 || 240
|-
| 4 || 128 || 255
|}

====== 地形波动率 ======
有很多的设置来调整有多少丘陵（换句话说，就是多么的不平坦）。其中最重要的是 BiomeVolatility。它增加将使地形成为一个多山的地形。0.0 使地形几乎变成超平坦。1.0 会给你小山。2.0 出现了悬崖。就像 BiomeHeight 一样，如果 WorldHeightBits设置为8，它的效果将会翻一番。此设置不能在 TerrainMode:OldGenerator模式下启用。

===== 生物群系的实体(资源)数量 =====
在地形生成过程中的第二步，我们将生物群落填充资源，如矿石、草丛、树、花、自定义对象、低于（或高于）海平面的小池塘。这完成后，将根据BiomeTemperature来生成雪地。你可以在 [https://github.com/MCTCP/TerrainControl/wiki/Resources-queue 资源队列] 中查找所有资源。

===== 外观 =====
这些设置对地形没有影响，但是，这是你仍然想要改变的东西。例如，你可以编辑生物群系的颜色和天气。可悲的是，普通的单人模式客户端将忽略所有这些设置。但它也将显示自定义 (非普通的) 生物群系的颜色与天气（不过变成了平原生物群系的设置）。玩家将需要安装Forge版本的地形控制来解决此问题。

这些配置的单独介绍可以在[https://github.com/MCTCP/TerrainControl/wiki/BiomeConfigs#wiki-biome-visual-settings 这里]查询。

=== 高级部分 ===
{{Main|TerrainControl/高级部分}}
===== 赞助 =====
[https://github.com/MCTCP/TerrainControl/wiki/A-TerrainControl-Analysis#top 回到顶部]
mysource for the [http://www.kartwork.de/annocraft2165/html/tutorial.html tutorials] that helped me put the first toe in TerrainControl.

== 配置释义 ==
=== 变量名 ===
这是一个关于变量名的小提示以便让你更快地理解它.

大多数变量命名为 somethingRARITY 事实上是 somethingPROBABILITY . 数量越多，东西越多.

当他命名为 somethingSIZE 时, 数量越高，东西越少. 他的功能有点像一个分数的分母: "1/65" "1/39" "1/2".

对于大多数变量命名为 somethingHEIGHT 他们更像指数而不是线性的. 如果你把一个数值从4改为5，你将会得到更大的结果相比于从1改为2. 因此在使用他们的时候小心一点.

也请注意：一些变量的互相影响. 这些生物群系生成器的特殊部分. 用这些指令来看看真正的效果[https://github.com/MCTCP/TerrainControl/wiki/Commands-and-Permissions /tc map command] 然后再试着改变他们.

记住，这只是个简短的小提示. 更多关于变量的详细信息见其他配置文件信息页面.

=== WorldConfig ===
The WorldConfig.ini is the main settings file used by the TerrainControl plugin. It controls most of the biome placement, cave and canyon distribution, structure spawning and some other settings. Settings that are biome specific can be found in the [https://github.com/MCTCP/TerrainControl/wiki/BiomeConfigs BiomeConfigs]. On the following page the settings of this file will each be explained in detail.

==== Jump to ====
* [https://github.com/MCTCP/TerrainControl/wiki/WorldConfig#generator-modes Generator modes]
* [https://github.com/MCTCP/TerrainControl/wiki/WorldConfig#custom-biomes Custom biomes]
* [https://github.com/MCTCP/TerrainControl/wiki/WorldConfig#settings-for-biomemodenormal Settings for BiomeMode:Normal]
* [https://github.com/MCTCP/TerrainControl/wiki/WorldConfig#settings-for-biomemodefromimage Settings for BiomeMode:FromImage]
* [https://github.com/MCTCP/TerrainControl/wiki/WorldConfig#terrain-height-and-volatility Terrain height and volatility]
* [https://github.com/MCTCP/TerrainControl/wiki/WorldConfig#blocks Blocks]
* [https://github.com/MCTCP/TerrainControl/wiki/WorldConfig#structures Structures]
* [https://github.com/MCTCP/TerrainControl/wiki/WorldConfig#world-visual-settings World visual settings]
* [https://github.com/MCTCP/TerrainControl/wiki/WorldConfig#cave-variables Cave variables]
* [https://github.com/MCTCP/TerrainControl/wiki/WorldConfig#canyon-variables Canyon variables]
* [https://github.com/MCTCP/TerrainControl/wiki/WorldConfig#settings-for-biomemodeoldgenerator Settings for BiomeMode:OldGenerator]

==== Generator modes ====
[https://github.com/MCTCP/TerrainControl/wiki/WorldConfig#top Back to top]
SettingsMode: WriteAll

Normally, each time Terrain Control reads the config files, it also writes to them. With this setting you can change how Terrain Control writes to the config files. Possible modes:
* WriteAll - Autoupdate settings from old versions, order them, add comments, reset invalid settings and remove custom comments.
* WriteWithoutComments - Same as WriteAll, but removes all comments, both the ones of Terrain Control and your own.
* WriteDisable - Don't write to the comment files. Errors are not corrected, old settings are read, but they are also not corrected. Custom comments won't be removed with this mode.

TerrainMode: Normal

These are different generators that can be used to generate your terrain.
* Normal - This mode uses all the features of the terrain generator. Biomes still look like the ones in vanilla Minecraft.
* OldGenerator - This generator will generate the terrain in the way the Minecraft Beta 1.7.3 terrain generator created it.
* TerrainTest - This generator creates terrain normally but adds no resources. Is faster than Normal.
* NotGenerate - This setting will create empty chunks of terrain.
* Default - This generator creates default terrain. Except the biomes, all the mod settings are ignored.

BiomeMode: Normal

Here you can define how Biomes are to be generated. The following settings are available:
* Normal - Uses all features of Terrain Control. Even with the default settings your biomes will be placed diffently than vanilla Minecraft.
* FromImage - Reads the biomes from an image file. See 'Biome Image Generator Variables' below for more information.
* BeforeGroups - Minecraft 1.0 - 1.6.4 biome generator, only supports the biome groups NormalBiomes and IceBiomes
* OldGenerator - Generates biomes like in Minecraft Beta 1.7.3.
* Default - Means the default biome generator of vanilla Minecraft will be used.

==== Custom biomes ====
(回到顶部请使用“Home”按钮,下同)
CustomBiomes:

You need to register your custom biomes here. This setting will make Terrain Control generate and read the setting files for them. However, it won't place them in the world automatically. See the settings for your BiomeMode below on how to add them to the world.

Syntax: CustomBiomes:BiomeName:id[,AnotherBiomeName:id[,...]]

Example: CustomBiomes:TestBiome1:30,BiomeTest2:31

This will add two biomes and generate the BiomeConfigs for them. All changes here need a server restart.

Due to the way Mojang's loading code works, all biome ids need to be unique on the server. If you don't do this, the client will display the biomes just fine, but the server can think it is another biome with the same id. This will cause saplings, snowfall and mobs to work as in the other biome.

The available ids range from 0 to 1023, inclusive. Minecraft 1.7 uses most IDs between the ranges of 0-39 and 129-167. Using those IDs is not possible. It is recommend to leave some room around the vanilla IDs in case new biomes are added in the future.

IDs above 255 can not be saved by Minecraft. You will need to add a [https://github.com/MCTCP/TerrainControl/wiki/Biome-Placement#replace-to-biome-name ReplaceToBiomeName] setting to those biomes to make sure that they are saved to the world files using an id below 256.

==== Settings for BiomeMode:Normal ====
The values in this section only work when BiomeMode is set to Normal or BiomeMode is FromImage and ImageMode is ContinueNormal

GenerationDepth:10

Main value for generation. Bigger values 'zoom in', so that the biomes get larger:

[[文件:TerrainControl-S9.png]]

All sizes ( *Size ) must be smaller than this.

So if you want big objects (biomes/rivers/etc.) you must set size of that objects near 0.

If you want small objects you must set size of the objects near GenerationDepth .

Also small values (about 1-2) and big values (about 20) may affect generator performance.

A tutorial (by thedeadlytao) about GenerationDepth , LandSize and LandRarity can be found [http://dev.bukkit.org/server-mods/terrain-control/forum/35885-generation-depth-and-land-size-rarity-explained/ here].

BiomeRarityScale:100

Max biome rarity from 1 to infinity. By default this is 100, but you can raise it for fine-grained control, or to create biomes with a chance of occurring smaller than 1/100.

==== Biome groups ====
Minecraft groups similar biomes together, so that they spawn next to each other. Most biomes in the world (but not all) spawn as part of a biome group.

Syntax: BiomeGroup(Name, Size, Rarity, BiomeName[, AnotherName[, ...]]) Name - just for clarity, choose something descriptive Size - layer to generate on, from 0 to GenerationDepth. All biomes in the group must have a BiomeSize larger than or equal to this value. Rarity - relative spawn chances. BiomeName... - names of the biome that spawn in the group. Case sensitive.

Note: if (and only if) you're using BiomeMode: BeforeGroups , only the biomes listed in the groups named NormalBiomes and IceBiomes and the size and rarity of the group named IceBiomes will be used. Other groups are ignored. The size and rarity of the NormalBiomes group is ignored as well, use LandSize and LandRarity instead.

Default biome groups:

BiomeGroup(NormalBiomes, 0, 97, Forest, Roofed Forest, Extreme Hills, Plains, Birch Forest, Swampland, Flower Forest, Roofed Forest M, Extreme Hills+, Sunflower Plains, Birch Forest M, Swampland M)
BiomeGroup(IceBiomes, 3, 90, Ice Plains, Cold Taiga, Ice Plains Spikes, Cold Taiga M)
BiomeGroup(HotBiomes, 0, 97, Desert, Savanna, Plains, Desert M, Savanna M, Sunflower Plains)
BiomeGroup(ColdBiomes, 0, 97, Forest, Extreme Hills, Taiga, Plains, Flower Forest, Extreme Hills+, Taiga M, Sunflower Plains)
BiomeGroup(MesaBiomes, 1, 40, Mesa)
BiomeGroup(JungleBiomes, 1, 40, Jungle, Jungle M)
BiomeGroup(Mega TaigaBiomes, 1, 40, Mega Taiga, Mega Spruce Taiga)

==== Biome lists ====
Not all biomes spawn as part of a group. Some biomes spawn as "isles" in other biomes, or as borders on other biomes.

IsleBiomes: Deep Ocean, MushroomIsland, Ice Mountains, DesertHills, ForestHills, Forest, TaigaHills, JungleHills, Cold Taiga Hills, Birch Forest Hills, Extreme Hills+, Mesa Plateau, Mesa Plateau F, Mesa Plateau M, Mesa Plateau F M, Mesa (Bryce), Mega Taiga Hills, Mega Spruce Taiga Hills

Biomes which used as isles. Biome name is case sensitive. Inside the biome config of the biome you can decide in which biome this isle should spawn. Please note that the Hills-biomes are actually 'islands' inside a biome. [https://github.com/jebox Jeb_] has done this in Minecraft 1.1 to make the terrain generator more interesting: players were complaining that the biomes were too flat.

BorderBiomes: MushroomIslandShore, Beach, Extreme Hills Edge, Desert, Taiga

Biomes that are used as borders. Biome name is case sensitive. In the biome config of the biome you can specify next to which biome this border should spawn. You can also set there next to which biome this border should '''not''' spawn.

==== Landmass settings ====
LandRarity: 97

Land rarity from 100 to 1. Higher numbers give more land. Values are quite sensitive, look at the image. Set it to 100 to completely disable oceans.

[[文件:TerrainControl-12.png]]

As you can see the oceans are completely gone with LandRarity:100 .

LandSize: 0

Land size from 0 to GenerationDepth . Making LandSize larger will make the size of the land smaller.

LandFuzzy: 6

Generates more lakes (=small ocean biomes) at the edge of the continent. As a side effect, the continent will also get a bit larger. Must be from 0 to GenerationDepth - LandSize . Map of the edge of a continent:

[[文件:TerrainControl-S10.png]]

==== Ice area settings ====
FrozenOcean:true

Make the water of the oceans near a cold biome frozen. The exact definition of 'cold' is controlled by the next setting.

OceanFreezingTemperature: 0.15

This is the maximum biome temperature when a biome is still considered cold. Water in oceans nearby cold biomes freezes if FrozenOcean is set to true. Temperature reference from vanilla Minecraft: < 0.15 for snow, 0.15 - 0.95 for rain, or > 1.0 for dry

FreezeAllBiomesInColdGroup: false

If the average of all biome temperatures in a biome group is less than "OceanFreezingTemperature", then:

* When this setting is true, all biomes in the group will have frozen oceans
* When this setting is false, only individual biomes with a temperature below "OceanFreezingTemperature" will have frozen oceans

==== River settings ====
RiverRarity:4

River rarity. Must be from 0 to GenerationDepth .

RiverSize:0

River size from 0 to GenerationDepth - RiverRarity . Making this larger will make the rivers larger, without affecting how much rivers will spawn.

[[文件:TerrainControl-S11.png]]

RiversEnabled:true

Enable or disable rivers. If you just want rivers in some biomes, set this to true and disable the rivers in the [https://github.com/MCTCP/TerrainControl/wiki/BiomeConfigs BiomeConfigs] instead.

RandomRivers:false

Normally the rivers follow the biome borders most of the time. Set this setting to true to disable this behaviour.

ImprovedRivers:false

Normally rivers use technical biomes to generate. In the default settings the biomes River and FrozenRiver are used.

If you set this setting to true, the technical biomes won't be used anymore in the world. This causes the rivers to look exactly like the biome they are flowing through: no more sudden changes of grass color. The height settings of the river can now be found in the biome the river is flowing through.

==== Settings for BiomeMode:FromImage ====
The values in this section only work when BiomeMode is set to FromImage.

ImageMode:Repeat

What to do when terrain is generated outside the boundaries of the image: Repeat , ContinueNormal , FillEmpty

Repeat - repeat the image.

Mirror - mirrors the image.

ContinueNormal - continue normal generation.

FillEmpty - fill it with one biome.

ImageFile:map.png

PNG file to read the biomes from. Place it next to the WorldConfig.ini file.

ImageOrientation: East

How the image is oriented: North , South , East or West . When this is set to North , the image is placed in the world in the normal way. When it is set to East , the image is rotated 90 degrees counter-clockwise in memory so, that what is on the east in the image becomes north in the world.

ImageFillBiome:Ocean

When using the FillEmpty mode this biome will be used when generating outside the image.

ImageXOffset:0

ImageZOffset:0

Translates the map origin. For some reason, this number needs to be multiplied with -1 when using FillEmpty .

=== BiomeConfigs ===
=== PluginConfig ===
=== BO2 Objects ===
=== BO3 Objects ===
=== Land Fuzzy ===

== Other pages ==
=== Examples page ===
=== Commands and Permissions ===
=== Compatibility with other mods ===
=== Compatibility with WorldPainter ===
== External tutorials ==
* General tutorial by mysource
* Effect of the seed on a map and working with higher (y>128) worlds by mysource
* Achieve certain world styles by mysource
* Create a map by image by mysource
* World merging by mysource
* How Terrain Control's biome generator works by Khoorn
* Cave variables explained by thedeadlytao
* GenerationDepth and LandSize/Rarity Explained by thedeadlytao
{{Languages|TerrainControl}}

MadAuth

2016-03-12T15:28:40Z

Mcdarc：

[[Category:管理]]
[[Category:安全]]
[[Category:修正]]
[[Category:网页]]

<div style="float:none;-webkit-border-image: none;color: #333;height: auto;margin: 0 0 35px 0;min-height: 20px;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);">


欢迎来到MadAuth词条

<div style="float:none;-webkit-border-image: none;height: auto;line-height: 20px;background-color:#74c0ff;display:table;width:100%;color:#ffffff;">


插件名 '''MadAuth'''


作者 '''Mcdarc'''


版本 '''v3.1'''


兼容版本 '''1.5.1-1.9'''

</div>
</div>
<div style="float:none;-webkit-border-image: none;color: #333;height: auto;line-height: 20px;margin: 35px 0 0 0;min-height: 20px;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);width:100%;">

介绍 · Introduction
<div style="padding:10px 20px;">
这是一个逗逼的'''外置登录'''！

这个网页验证使用'''''SQLite''''' + '''''Python''''' + '''''Django'''''环境，无需搭建'''''MySQL'''''环境！

'''''MySQL'''''的设置教程请看下文

并且如果合理部署的话，可以说是几乎不占用性能的！
</div>
</div>
<div style="float:none;-webkit-border-image: none;color: #333;height: auto;line-height: 20px;margin: 35px 0 0 0;min-height: 20px;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);width:100%;">

环境 · Requirment
</div>


<div id="mf-documentation" style="display: table-cell; -webkit-border-image: none;height: auto;line-height: 20px;min-height: 20px;width: 49%;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5); padding:20px;">
<p style="color:#ffffff;font-size: 20px;text-align: center;margin:0; padding:20px;background-color: #3385ff;box-shadow:0 0 30px rgba(51, 133, 255, 0.5);-webkit-box-shadow:0 0 30px rgba(51, 133, 255, 0.5);-moz-box-shadow:0 0 30px rgba(51, 133, 255, 0.5);margin:0 0 20px 0;">
Python & Django


'''Python'''目前来说的话，还是一个挺不错的语言。 
'''Python'''最新版本已更新到 3.X 了。然而我们并不需要它=A= 
我们需要的是 2.7.10 版本的'''Python'''。 
安装时切记要安装'''pip'''，否则后面将会很麻烦。 
'''Django'''是一个非常好的'''PyThon'''下的网页框架。 
目前最新版本的'''Django'''为'''1.9.2'''，同时这也是编写本外置登录系统的版本。 
使用<code>pip install django</code>Django一般都是向下兼容.

</div>

<div style="padding: 4px; display: table-cell;"></div>


<div id="mf-join" style="display: table-cell;-webkit-border-image: none;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);color: #333;font-size: 14px;height: auto;line-height: 20px;margin: 0px 0px 5px;min-height: 20px;width: 49%; padding:20px;">
<p style="color:#ffffff;font-size: 20px;text-align:center;padding:20px;background-color: #3385ff;margin:0 0 20px 0;box-shadow:0 0 30px rgba(51, 133, 255, 0.5);-webkit-box-shadow:0 0 30px rgba(51, 133, 255, 0.5);-moz-box-shadow:0 0 30px rgba(51, 133, 255, 0.5);">
MySQLdb(可选)


'''MySQLdb'''是一个'''Python'''下的'''''MySQL'''''操作模块。 
他为'''Django'''提供'''''MySQL'''''支持。 
如果你不使用'''''MySQL'''''则无需安装。 
同样的，安装这个也只需要输入 
<code>pip install mysqldb</code>

</div>
<div style="float:none;-webkit-border-image: none;color: #333;height: auto;line-height: 20px;margin: 35px 0 0 0;min-height: 20px;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);width:100%;">

部署 · Deployment
</div>


<div id="mf-documentation" style="display: table-cell; -webkit-border-image: none;height: auto;line-height: 20px;min-height: 20px;width: 49%;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5); padding:20px;">
<p style="color:#ffffff;font-size: 20px;text-align: center;margin:0; padding:20px;background-color: #3385ff;box-shadow:0 0 30px rgba(51, 133, 255, 0.5);-webkit-box-shadow:0 0 30px rgba(51, 133, 255, 0.5);-moz-box-shadow:0 0 30px rgba(51, 133, 255, 0.5);margin:0 0 20px 0;">
使用开发服务器


我相信这里有很多懒癌晚期的患者=A=。 
但是值得庆幸的是，'''Django'''为我们提供了'''开发服务器'''。 
我们可以直接使用开发服务器部署。 
这是最为简单的部署方法！ 
#你先要设置setting.py中的<code>ALLOWED_HOSTS = [你的域名]</code>
##[]不可去掉，并设置setting.py中的<code>Debug = False</code>
##'''Python'''区分大小写！
#进入根目录，打开命令行(或者ssh使用cd进入根目录)。
#使用<code>python manage.py runserver <你需要的端口></code>
##端口那里选填。若不填默认8000。
##不要修改manage.py！
##若出现python未找到请重新安装。
##若出现语法错误请确认python版本为2.7.10

</div>

<div style="padding: 4px; display: table-cell;"></div>


<div id="mf-join" style="display: table-cell;-webkit-border-image: none;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);color: #333;font-size: 14px;height: auto;line-height: 20px;margin: 0px 0px 5px;min-height: 20px;width: 49%; padding:20px;">
<p style="color:#ffffff;font-size: 20px;text-align:center;padding:20px;background-color: #3385ff;margin:0 0 20px 0;box-shadow:0 0 30px rgba(51, 133, 255, 0.5);-webkit-box-shadow:0 0 30px rgba(51, 133, 255, 0.5);-moz-box-shadow:0 0 30px rgba(51, 133, 255, 0.5);">
使用Screen(可选)


由于'''''Linux'''''服务器版本一般没有桌面环境。 
但是一退出远程连接又会'''kill'''掉进程。 
所以我们要使用'''screen'''来<nowiki>''保护''</nowiki>我们可怜的进程=A= 
#使用<code>apt-get install screen</code>或<code>yum install screen</code>即可安装
#然后使用<code>screen -S <选填参数：你的自定义作业名> ./start.sh</code>即可

</div>

MadAuth

2016-03-12T15:27:47Z

Mcdarc：添加图像至页面

[[File:=A=_2016-03-12_15-28.png|thumbnail|=A=]]

[[Category:管理]]
[[Category:安全]]
[[Category:修正]]
[[Category:网页]]

<div style="float:none;-webkit-border-image: none;color: #333;height: auto;margin: 0 0 35px 0;min-height: 20px;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);">


欢迎来到MadAuth词条

<div style="float:none;-webkit-border-image: none;height: auto;line-height: 20px;background-color:#74c0ff;display:table;width:100%;color:#ffffff;">


插件名 '''MadAuth'''


作者 '''Mcdarc'''


版本 '''v3.1'''


兼容版本 '''1.5.1-1.9'''

</div>
</div>
<div style="float:none;-webkit-border-image: none;color: #333;height: auto;line-height: 20px;margin: 35px 0 0 0;min-height: 20px;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);width:100%;">

介绍 · Introduction
<div style="padding:10px 20px;">
这是一个逗逼的'''外置登录'''！

这个网页验证使用'''''SQLite''''' + '''''Python''''' + '''''Django'''''环境，无需搭建'''''MySQL'''''环境！

'''''MySQL'''''的设置教程请看下文

并且如果合理部署的话，可以说是几乎不占用性能的！
</div>
</div>
<div style="float:none;-webkit-border-image: none;color: #333;height: auto;line-height: 20px;margin: 35px 0 0 0;min-height: 20px;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);width:100%;">

环境 · Requirment
</div>


<div id="mf-documentation" style="display: table-cell; -webkit-border-image: none;height: auto;line-height: 20px;min-height: 20px;width: 49%;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5); padding:20px;">
<p style="color:#ffffff;font-size: 20px;text-align: center;margin:0; padding:20px;background-color: #3385ff;box-shadow:0 0 30px rgba(51, 133, 255, 0.5);-webkit-box-shadow:0 0 30px rgba(51, 133, 255, 0.5);-moz-box-shadow:0 0 30px rgba(51, 133, 255, 0.5);margin:0 0 20px 0;">
Python & Django


'''Python'''目前来说的话，还是一个挺不错的语言。 
'''Python'''最新版本已更新到 3.X 了。然而我们并不需要它=A= 
我们需要的是 2.7.10 版本的'''Python'''。 
安装时切记要安装'''pip'''，否则后面将会很麻烦。 
'''Django'''是一个非常好的'''PyThon'''下的网页框架。 
目前最新版本的'''Django'''为'''1.9.2'''，同时这也是编写本外置登录系统的版本。 
使用<code>pip install django</code>Django一般都是向下兼容.

</div>

<div style="padding: 4px; display: table-cell;"></div>


<div id="mf-join" style="display: table-cell;-webkit-border-image: none;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);color: #333;font-size: 14px;height: auto;line-height: 20px;margin: 0px 0px 5px;min-height: 20px;width: 49%; padding:20px;">
<p style="color:#ffffff;font-size: 20px;text-align:center;padding:20px;background-color: #3385ff;margin:0 0 20px 0;box-shadow:0 0 30px rgba(51, 133, 255, 0.5);-webkit-box-shadow:0 0 30px rgba(51, 133, 255, 0.5);-moz-box-shadow:0 0 30px rgba(51, 133, 255, 0.5);">
MySQLdb(可选)


'''MySQLdb'''是一个'''Python'''下的'''''MySQL'''''操作模块。 
他为'''Django'''提供'''''MySQL'''''支持。 
如果你不使用'''''MySQL'''''则无需安装。 
同样的，安装这个也只需要输入 
<code>pip install mysqldb</code>

</div>
<div style="float:none;-webkit-border-image: none;color: #333;height: auto;line-height: 20px;margin: 35px 0 0 0;min-height: 20px;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);width:100%;">

部署 · Deployment
</div>


<div id="mf-documentation" style="display: table-cell; -webkit-border-image: none;height: auto;line-height: 20px;min-height: 20px;width: 49%;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5); padding:20px;">
<p style="color:#ffffff;font-size: 20px;text-align: center;margin:0; padding:20px;background-color: #3385ff;box-shadow:0 0 30px rgba(51, 133, 255, 0.5);-webkit-box-shadow:0 0 30px rgba(51, 133, 255, 0.5);-moz-box-shadow:0 0 30px rgba(51, 133, 255, 0.5);margin:0 0 20px 0;">
使用开发服务器


我相信这里有很多懒癌晚期的患者=A=。 
但是值得庆幸的是，'''Django'''为我们提供了'''开发服务器'''。 
我们可以直接使用开发服务器部署。 
这是最为简单的部署方法！ 
#你先要设置setting.py中的<code>ALLOWED_HOSTS = [你的域名]</code>
##[]不可去掉，并设置setting.py中的<code>Debug = False</code>
##'''Python'''区分大小写！
#进入根目录，打开命令行(或者ssh使用cd进入根目录)。
#使用<code>python manage.py runserver <你需要的端口></code>
##端口那里选填。若不填默认8000。
##不要修改manage.py！
##若出现python未找到请重新安装。
##若出现语法错误请确认python版本为2.7.10

</div>

<div style="padding: 4px; display: table-cell;"></div>


<div id="mf-join" style="display: table-cell;-webkit-border-image: none;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);color: #333;font-size: 14px;height: auto;line-height: 20px;margin: 0px 0px 5px;min-height: 20px;width: 49%; padding:20px;">
<p style="color:#ffffff;font-size: 20px;text-align:center;padding:20px;background-color: #3385ff;margin:0 0 20px 0;box-shadow:0 0 30px rgba(51, 133, 255, 0.5);-webkit-box-shadow:0 0 30px rgba(51, 133, 255, 0.5);-moz-box-shadow:0 0 30px rgba(51, 133, 255, 0.5);">
使用Screen(可选)


由于'''''Linux'''''服务器版本一般没有桌面环境。 
但是一退出远程连接又会'''kill'''掉进程。 
所以我们要使用'''screen'''来<nowiki>''保护''</nowiki>我们可怜的进程=A= 
#使用<code>apt-get install screen</code>或<code>yum install screen</code>即可安装
#然后使用<code>screen -S <选填参数：你的自定义作业名> ./start.sh</code>即可

</div>

文件:=A= 2016-03-12 15-28.png

2016-03-12T15:27:46Z

Mcdarc：贡献图像自Special:Uploads

== {{int:filedesc}} ==
{{Information
|description==A=
|source={{own}}
|author=[[User:Mcdarc]]
}}

== {{int:license-header}} ==
{{self|cc-by-sa-3.0}}

MadAuth

2016-03-12T15:13:22Z

Mcdarc：

MadAuth

2016-03-12T15:07:31Z

Mcdarc：

[[Category:管理]]
[[Category:安全]]
[[Category:修正]]
[[Category:网页]]

<div style="float:none;-webkit-border-image: none;color: #333;height: auto;margin: 0 0 35px 0;min-height: 20px;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);">


欢迎来到MadAuth词条

<div style="float:none;-webkit-border-image: none;height: auto;line-height: 20px;background-color:#74c0ff;display:table;width:100%;color:#ffffff;">


插件名 '''MadAuth'''


作者 '''Mcdarc'''


版本 '''v3.1'''


兼容版本 '''1.5.1-1.9'''

</div>
</div>
<div style="float:none;-webkit-border-image: none;color: #333;height: auto;line-height: 20px;margin: 35px 0 0 0;min-height: 20px;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);width:100%;">

介绍 · Introduction
<div style="padding:10px 20px;">
这是一个逗逼的'''外置登录'''！

这个网页验证使用'''''SQLite''''' + '''''Python''''' + '''''Django'''''环境，无需搭建'''''MySQL'''''环境！

'''''MySQL'''''的设置教程请看下文

并且如果合理部署的话，可以说是几乎不占用性能的！
</div>
</div>
<div style="float:none;-webkit-border-image: none;color: #333;height: auto;line-height: 20px;margin: 35px 0 0 0;min-height: 20px;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);width:100%;">

环境 · Requirment
</div>


<div id="mf-documentation" style="display: table-cell; -webkit-border-image: none;height: auto;line-height: 20px;min-height: 20px;width: 49%;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5); padding:20px;">
<p style="color:#ffffff;font-size: 20px;text-align: center;margin:0; padding:20px;background-color: #3385ff;box-shadow:0 0 30px rgba(51, 133, 255, 0.5);-webkit-box-shadow:0 0 30px rgba(51, 133, 255, 0.5);-moz-box-shadow:0 0 30px rgba(51, 133, 255, 0.5);margin:0 0 20px 0;">
Python & Django


'''Python'''目前来说的话，还是一个挺不错的语言。 
'''Python'''最新版本已更新到 3.X 了。然而我们并不需要它=A= 
我们需要的是 2.7.10 版本的'''Python'''。 
安装时切记要安装'''pip'''，否则后面将会很麻烦。 
'''Django'''是一个非常好的'''PyThon'''下的网页框架。 
目前最新版本的'''Django'''为'''1.9.2'''，同时这也是编写本外置登录系统的版本。 
使用<code>pip install django</code>Django一般都是向下兼容.

</div>

<div style="padding: 4px; display: table-cell;"></div>


<div id="mf-join" style="display: table-cell;-webkit-border-image: none;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);color: #333;font-size: 14px;height: auto;line-height: 20px;margin: 0px 0px 5px;min-height: 20px;width: 49%; padding:20px;">
<p style="color:#ffffff;font-size: 20px;text-align:center;padding:20px;background-color: #3385ff;margin:0 0 20px 0;box-shadow:0 0 30px rgba(51, 133, 255, 0.5);-webkit-box-shadow:0 0 30px rgba(51, 133, 255, 0.5);-moz-box-shadow:0 0 30px rgba(51, 133, 255, 0.5);">
MySQLdb(可选)


'''MySQLdb'''是一个'''Python'''下的'''''MySQL'''''操作模块。 
他为'''Django'''提供'''''MySQL'''''支持。 
如果你不使用'''''MySQL'''''则无需安装。 
同样的，安装这个也只需要输入 
<code>pip install mysqldb</code>

</div>

== 部署 ==
=== 使用开发服务器 ===
我相信这里有很多懒癌晚期的患者=A=。

但是值得庆幸的是，'''Django'''为我们提供了'''开发服务器'''。

我们可以直接使用开发服务器部署。

这是最为简单的部署方法！

#你先要设置setting.py中的<code>ALLOWED_HOSTS = [你的域名]</code>
##[]不可去掉，并设置setting.py中的<code>Debug = False</code>
##'''Python'''区分大小写！
#进入根目录，打开命令行(或者ssh使用cd进入根目录)。
#使用<code>python manage.py runserver <你需要的端口></code>
##端口那里选填。若不填默认8000。
##不要修改manage.py！
##若出现python未找到请重新安装。
##若出现语法错误请确认python版本为2.7.10
==== 使用screen ====
由于'''''Linux'''''服务器版本一般没有桌面环境。

但是一退出远程连接又会'''kill'''掉进程。

所以我们要使用'''screen'''来<nowiki>''保护''</nowiki>我们可怜的进程=A=

#使用<code>apt-get install screen</code>或<code>yum install screen</code>即可安装
#然后使用<code>screen -S <选填参数：你的自定义作业名> ./start.sh</code>即可

MadAuth

2016-03-12T15:05:57Z

Mcdarc：

[[Category:管理]]
[[Category:安全]]
[[Category:修正]]
[[Category:网页]]

<div style="float:none;-webkit-border-image: none;color: #333;height: auto;margin: 0 0 35px 0;min-height: 20px;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);">


欢迎来到MadAuth词条

<div style="float:none;-webkit-border-image: none;height: auto;line-height: 20px;background-color:#74c0ff;display:table;width:100%;color:#ffffff;">


插件名 '''MadAuth'''


作者 '''Mcdarc'''


版本 '''v3.1'''


兼容版本 '''1.5.1-1.9'''

</div>
</div>
<div style="float:none;-webkit-border-image: none;color: #333;height: auto;line-height: 20px;margin: 35px 0 0 0;min-height: 20px;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);width:100%;">

介绍 · Introduction
<div style="padding:10px 20px;">
这是一个逗逼的'''外置登录'''！

这个网页验证使用'''''SQLite''''' + '''''Python''''' + '''''Django'''''环境，无需搭建'''''MySQL'''''环境！

'''''MySQL'''''的设置教程请看下文

并且如果合理部署的话，可以说是几乎不占用性能的！
</div>
</div>
<div style="float:none;-webkit-border-image: none;color: #333;height: auto;line-height: 20px;margin: 35px 0 0 0;min-height: 20px;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);width:100%;">

环境 · Requirment
</div>


<div id="mf-documentation" style="display: table-cell; -webkit-border-image: none;height: auto;line-height: 20px;min-height: 20px;width: 49%;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5); padding:20px;">
<p style="color:#ffffff;font-size: 20px;text-align: center;margin:0; padding:20px;background-color: #3385ff;box-shadow:0 0 30px rgba(51, 133, 255, 0.5);-webkit-box-shadow:0 0 30px rgba(51, 133, 255, 0.5);-moz-box-shadow:0 0 30px rgba(51, 133, 255, 0.5);margin:0 0 20px 0;">
Python & Django


'''Python'''目前来说的话，还是一个挺不错的语言。

'''Python'''最新版本已更新到 3.X 了。然而我们并不需要它=A=

我们需要的是 2.7.10 版本的'''Python'''。

安装时切记要安装'''pip'''，否则后面将会很麻烦。

'''Django'''是一个非常好的'''PyThon'''下的网页框架。

目前最新版本的'''Django'''为'''1.9.2'''，同时这也是编写本外置登录系统的版本。

使用<code>pip install django</code>Django一般都是向下兼容。

</div>

<div style="padding: 4px; display: table-cell;"></div>


<div id="mf-join" style="display: table-cell;-webkit-border-image: none;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);color: #333;font-size: 14px;height: auto;line-height: 20px;margin: 0px 0px 5px;min-height: 20px;width: 49%; padding:20px;">
<p style="color:#ffffff;font-size: 20px;text-align:center;padding:20px;background-color: #3385ff;margin:0 0 20px 0;box-shadow:0 0 30px rgba(51, 133, 255, 0.5);-webkit-box-shadow:0 0 30px rgba(51, 133, 255, 0.5);-moz-box-shadow:0 0 30px rgba(51, 133, 255, 0.5);">
MySQLdb(可选)


'''MySQLdb'''是一个'''Python'''下的'''''MySQL'''''操作模块。

他为'''Django'''提供'''''MySQL'''''支持。

如果你不使用'''''MySQL'''''则无需安装。

同样的，安装这个也只需要输入

<code>pip install mysqldb</code>

</div>

== 部署 ==
=== 使用开发服务器 ===
我相信这里有很多懒癌晚期的患者=A=。

但是值得庆幸的是，'''Django'''为我们提供了'''开发服务器'''。

我们可以直接使用开发服务器部署。

这是最为简单的部署方法！

#你先要设置setting.py中的<code>ALLOWED_HOSTS = [你的域名]</code>
##[]不可去掉，并设置setting.py中的<code>Debug = False</code>
##'''Python'''区分大小写！
#进入根目录，打开命令行(或者ssh使用cd进入根目录)。
#使用<code>python manage.py runserver <你需要的端口></code>
##端口那里选填。若不填默认8000。
##不要修改manage.py！
##若出现python未找到请重新安装。
##若出现语法错误请确认python版本为2.7.10
==== 使用screen ====
由于'''''Linux'''''服务器版本一般没有桌面环境。

但是一退出远程连接又会'''kill'''掉进程。

所以我们要使用'''screen'''来<nowiki>''保护''</nowiki>我们可怜的进程=A=

#使用<code>apt-get install screen</code>或<code>yum install screen</code>即可安装
#然后使用<code>screen -S <选填参数：你的自定义作业名> ./start.sh</code>即可

MadAuth

2016-03-12T15:05:13Z

Mcdarc：

[[Category:管理]]
[[Category:安全]]
[[Category:修正]]
[[Category:网页]]

<div style="float:none;-webkit-border-image: none;color: #333;height: auto;margin: 0 0 35px 0;min-height: 20px;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);">


欢迎来到MadAuth词条

<div style="float:none;-webkit-border-image: none;height: auto;line-height: 20px;background-color:#74c0ff;display:table;width:100%;color:#ffffff;">


插件名 '''MadAuth'''


作者 '''Mcdarc'''


版本 '''v3.1'''


兼容版本 '''1.5.1-1.9'''

</div>
</div>
<div style="float:none;-webkit-border-image: none;color: #333;height: auto;line-height: 20px;margin: 35px 0 0 0;min-height: 20px;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);width:100%;">

介绍 · Introduction
<div style="padding:10px 20px;">
这是一个逗逼的'''外置登录'''！

这个网页验证使用'''''SQLite''''' + '''''Python''''' + '''''Django'''''环境，无需搭建'''''MySQL'''''环境！

'''''MySQL'''''的设置教程请看下文

并且如果合理部署的话，可以说是几乎不占用性能的！
</div>
</div>
<div style="float:none;-webkit-border-image: none;color: #333;height: auto;line-height: 20px;margin: 35px 0 0 0;min-height: 20px;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);width:100%;">

环境 · Requirment
</div>


<div id="mf-documentation" style="display: table-cell; -webkit-border-image: none;height: auto;line-height: 20px;min-height: 20px;width: 49%;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5); padding:20px;">
<p style="color:#ffffff;font-size: 20px;text-align: center;margin:0; padding:20px;background-color: #3385ff;box-shadow:0 0 30px rgba(51, 133, 255, 0.5);-webkit-box-shadow:0 0 30px rgba(51, 133, 255, 0.5);-moz-box-shadow:0 0 30px rgba(51, 133, 255, 0.5);margin:0 0 20px 0;">
Python & Django


'''Python'''目前来说的话，还是一个挺不错的语言。

'''Python'''最新版本已更新到 3.X 了。然而我们并不需要它=A=

我们需要的是 2.7.10 版本的'''Python'''。

安装时切记要安装'''pip'''，否则后面将会很麻烦。

'''Django'''是一个非常好的'''PyThon'''下的网页框架。

目前最新版本的'''Django'''为'''1.9.2'''，同时这也是编写本外置登录系统的版本。

使用<code>pip install django</code>Django一般都是向下兼容。

</div>

<div style="padding: 4px; display: table-cell;"></div>


<div id="mf-join" style="display: table-cell;-webkit-border-image: none;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);color: #333;font-size: 14px;height: auto;line-height: 20px;margin: 0px 0px 5px;min-height: 20px;width: 49%; padding:20px;">
<p style="color:#ffffff;font-size: 20px;text-align:center;padding:20px;background-color: #3385ff;margin:0 0 20px 0;box-shadow:0 0 30px rgba(51, 133, 255, 0.5);-webkit-box-shadow:0 0 30px rgba(51, 133, 255, 0.5);-moz-box-shadow:0 0 30px rgba(51, 133, 255, 0.5);">
MySQLdb(可选)


'''MySQLdb'''是一个'''Python'''下的'''''MySQL'''''操作模块。

他为'''Django'''提供'''''MySQL'''''支持。

如果你不使用'''''MySQL'''''则无需安装。

同样的，安装这个也只需要输入

<code>pip install mysqldb</code>

</div>
</div>

== 部署 ==
=== 使用开发服务器 ===
我相信这里有很多懒癌晚期的患者=A=。

但是值得庆幸的是，'''Django'''为我们提供了'''开发服务器'''。

我们可以直接使用开发服务器部署。

这是最为简单的部署方法！

#你先要设置setting.py中的<code>ALLOWED_HOSTS = [你的域名]</code>
##[]不可去掉，并设置setting.py中的<code>Debug = False</code>
##'''Python'''区分大小写！
#进入根目录，打开命令行(或者ssh使用cd进入根目录)。
#使用<code>python manage.py runserver <你需要的端口></code>
##端口那里选填。若不填默认8000。
##不要修改manage.py！
##若出现python未找到请重新安装。
##若出现语法错误请确认python版本为2.7.10
==== 使用screen ====
由于'''''Linux'''''服务器版本一般没有桌面环境。

但是一退出远程连接又会'''kill'''掉进程。

所以我们要使用'''screen'''来<nowiki>''保护''</nowiki>我们可怜的进程=A=

#使用<code>apt-get install screen</code>或<code>yum install screen</code>即可安装
#然后使用<code>screen -S <选填参数：你的自定义作业名> ./start.sh</code>即可

MadAuth

2016-03-12T15:01:21Z

Mcdarc：

[[Category:管理]]
[[Category:安全]]
[[Category:修正]]
[[Category:网页]]

<div style="float:none;-webkit-border-image: none;color: #333;height: auto;margin: 0 0 35px 0;min-height: 20px;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);">


欢迎来到MadAuth词条

<div style="float:none;-webkit-border-image: none;height: auto;line-height: 20px;background-color:#74c0ff;display:table;width:100%;color:#ffffff;">


插件名 '''MadAuth'''


作者 '''Mcdarc'''


版本 '''v3.1'''


兼容版本 '''1.5.1-1.9'''

</div>
</div>
<div style="float:none;-webkit-border-image: none;color: #333;height: auto;line-height: 20px;margin: 35px 0 0 0;min-height: 20px;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);width:100%;">

介绍 · Introduction
<div style="padding:10px 20px;">
这是一个逗逼的'''外置登录'''！

这个网页验证使用'''''SQLite''''' + '''''Python''''' + '''''Django'''''环境，无需搭建'''''MySQL'''''环境！

'''''MySQL'''''的设置教程请看下文

并且如果合理部署的话，可以说是几乎不占用性能的！
</div>
</div>
<div style="float:none;-webkit-border-image: none;color: #333;height: auto;line-height: 20px;margin: 35px 0 0 0;min-height: 20px;background-color: #f8f8f8;box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-webkit-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);-moz-box-shadow:0 0 10px rgba(193, 193, 193, 0.5);width:100%;">

环境 · Requirment
</div>


== 部署 ==
=== 使用开发服务器 ===
我相信这里有很多懒癌晚期的患者=A=。

但是值得庆幸的是，'''Django'''为我们提供了'''开发服务器'''。

我们可以直接使用开发服务器部署。

这是最为简单的部署方法！

#你先要设置setting.py中的<code>ALLOWED_HOSTS = [你的域名]</code>
##[]不可去掉，并设置setting.py中的<code>Debug = False</code>
##'''Python'''区分大小写！
#进入根目录，打开命令行(或者ssh使用cd进入根目录)。
#使用<code>python manage.py runserver <你需要的端口></code>
##端口那里选填。若不填默认8000。
##不要修改manage.py！
##若出现python未找到请重新安装。
##若出现语法错误请确认python版本为2.7.10
==== 使用screen ====
由于'''''Linux'''''服务器版本一般没有桌面环境。

但是一退出远程连接又会'''kill'''掉进程。

所以我们要使用'''screen'''来<nowiki>''保护''</nowiki>我们可怜的进程=A=

#使用<code>apt-get install screen</code>或<code>yum install screen</code>即可安装
#然后使用<code>screen -S <选填参数：你的自定义作业名> ./start.sh</code>即可

MadAuth

2016-03-12T14:56:49Z

Mcdarc：

2016-03-12T14:22:25Z

Mcdarc：

MadAuth

2016-03-12T14:21:14Z

Mcdarc：

讨论:MadAuth

2016-03-12T14:18:27Z

Mcdarc：创建页面，内容为“== FAQ == === 网页系统问题 === === 插件问题 === === 启动器问题 === == 建议 == === 网页建议 === === 插件建议 === === 启动器建议 ===”

== FAQ ==
=== 网页系统问题 ===
=== 插件问题 ===
=== 启动器问题 ===
== 建议 ==
=== 网页建议 ===
=== 插件建议 ===
=== 启动器建议 ===

MadAuth

2016-03-12T14:15:09Z

Mcdarc：

MadAuth

2016-03-12T14:02:28Z

Mcdarc：Create a new page

== 介绍 ==
这是一个逗逼的'''外置登录'''！

这个网页验证使用'''''SQLite''''' + '''''Python''''' + '''''Django'''''环境，无需搭建'''''MySQL'''''环境！

BungeeCord开发教程

2016-02-26T15:14:16Z

Mcdarc：/* 利用工具 */

{{待完善}}
{{待更新|url=https://www.spigotmc.org/wiki/bungeecord-plugin-development/}}

== 介绍 ==

BungeeCord是一个转发服务端. 你也可以把它理解为代理服务端. 鉴于国内似乎没有BungeeCord插件, 我觉得写一篇教程会好些.

== 利用工具 ==

官方提供了一个极其好用的工具网页. 它可以让你方便地生成一个新的, 配置好的'''BungeeCord'''插件项目.

该页面的地址 [http://utilities.shall.fail/bungeecord/pluginhelper/]

只要简单地输入''Plugin name'', ''Plugin package'', ''Plugin author'', ''Plugin version''

他就会自动为你生成一个项目, 和一些基础的代码.

如果你是新手, 你大可以勾选''Include a listener for me, please.''. 这样他会为你生成一个玩家连接的监听器.

2015-08-11T10:22:44Z

Mcdarc：/* IMPORTANT NOTICES */

{{待翻译}}
{{Bukkit Plugin Infobox
|插件名=PermissonEX(PEX)
|版本=v1.23.1
|前置插件=无
|兼容服务端版本=1.8.1
|網址=http://dev.bukkit.org/bukkit-plugins/permissionsex/
}}
=概述=
==介绍==
PermissionsEx (PEX) 是一个新的权限（组）, 基于权限组和它的所有功能. 但是PEX插件能做到更多！它提供了各式各样有力的后台和游戏内管理方式, 很好的限制了一些玩家对于服务器的修改.

==现有特性==
版本V1.21开始支持UUID
不同的存储方式。目前的存储方式有:文本存储(YAML),数据库存储(MySQL，SQLite)。当然,也支持你自己添加！
YAML存储方式,对于新手,最容易配置的方式,所有玩家的信息都存储在 permission.yml 文件里面,缺点:后期读取可能出现卡顿。
SQL存储方式,对于有一定基础的人,推荐此方式，目前支持MySQL和SQLite，其他的数据库(如Postgre)也是可以的。PEX会自动创建数据库的表单。这就说明了,你只需要设置好PEX如何连接到数据库，剩余的你就只需要看着PEX自己完成了。
简明的构架和API接口，如果你对编程有一定了解，那么你可以改变很多。
全面的指令，你可以在游戏里/控制台，做到你想做的任何事情。指令列表看下文。
多世界 - 你可以设置一个玩家在某个世界的单独权限，比如在世界A不能破坏，在世界B不能拾取等等。(设置个别方块等权限,见下文)
权限组的继承，用户可以继承组的权限,组也可以继承组的权限，并且可以选择继承他们的权限、前缀、后缀。
权限的表达方式，这说明,如果你习惯于GroupManager,你也不用担心更换权限插件之后的不习惯。例子: - essentials.fly 这个权限就是允许玩家使用/fly指令
多世界权限继承，你可以继承不同世界的权限。也可以在不同世界继承不同的权限。
良好的优化，当你拥有大量用户的时候,你会发现没有延迟！
排行榜,你可以设置权限组的排列顺序
计时权限!你可以使用指令给玩家添加一个时限权限！注意:当服务端重启,或者崩溃将会失效。
V1.21.1版本开始 PEX支持自动更新,不过并不是跨阶段的更新,只支持BUG修复等更新,防止出现大更新,没有备份而导致文件丢失(V1.21.1→V1.21.2 而不是 V1.21.1 →V1.22.1),当然你也可以在config.yml文件中关闭更新。
Bukkit权限的兼容
禁用错误报告,在插件文件夹目录下创建一个文件,名为'report-disable'。

=进阶权限管理=
===权限的继承 ===

很多服务器配置了多个权限组, 添加权限要各组分别添加. 权限继承可以服务器管理最大限度的减少每一组重复的节点数量.

这里假定您已经完成了基本教程，如还没有，请看基础权限知识，不然的话不能保证您能明白这里的每一步.

实际上，使用了基本教程中的案例，你会发现Member, VIP 和Moderator组都有共同的节点 , modifyworld.* .这里不需要使用继承.

===权限继承规则===

当继承需要处理,PEX会遵循下列规则:

对玩家的设置(前缀,后缀,权限节点,etc.)拥有比组更高的优先权.
设置给一个组的玩家权限在当玩家个人设置生效前被组中任意玩家继承.
Permission nodes are evaluated in order of the inheritance tree (see The Inheritance Tree for details)
A group set to inherit from another group will inherit everything (this includes other inheritance directives!) from the source group, not just permissions. For example, if you have group B inheriting from group A, and group A is set to inherit from group B, PEX will follow the inheritance chain on group A, which is set to inherit from B, which inherits from A, and so on. Watch for this, it will cause a loop that will crash PEX.

===对现有的权限组使用继承功能 ===

用现有的组使用继承功能的话设置PEX默认组的命令会很容易.

用Moderator权限组继承VIP权限组的例子

pex group VIP parents set Member （这个命令是VIP组组继承了Moderator组的所有权限）
pex group Moderator parents set VIP （这个命令是Moderator组继承了VIP组的所有权限）
删除多余的权限节点

pex group VIP remove modifyworld.*
pex group Moderator remove modifyworld.*
现在，VIP组和Moderator组仍然具有相同的权限，VIP组得到 modifyworld.* 权限节点 VIP组成员获得了 -modifyworld.mobtarget.monster.creeper 的权限节点，和Moderator组继承来自VIP组的节点（包括从它的组成员继承的节点）同时获得了modifyworld。mobtarget节点。

权限文件的相关部分现在看起来应该像这样:

Member:
prefix: '&0(&8M&7ember&0)&7 '
permissions:
- modifyworld.*
options:
rank: '900'
VIP:
prefix: '&0(&eVIP&0)&7 '
inheritance:
- Member
permissions:
- -modifyworld.mobtarget.monster.creeper
options:
rank: '800'
Moderator:
prefix: '&0(&1Moderator&0)&7 '
inheritance:
- VIP
permissions:
- -modifyworld.mobtarget.*
options:
rank: '100'
这个例子不能大幅度的减少文件大小, 但是如果一个服务器有几个权限组十几个权限组或者更多的权限节点与权限组的话，权限文件大小是可以被大幅度的压缩的.

这种继承也可以应用于服务器的一个世界或多个世界。想知道更多的话可以去看 multiworld 继承部分哦.

===继承树===

(Thanks goes to aviator14 for use of these nodes)

Due to the way PEX deals with file backends, it may help to view inheritance as a tree. For example, we have the following permission nodes:

Guest:
prefix: '&7'
default: true
permissions: []
Player:
prefix: '&f'
default: false
permissions:
- generic.user.permissions
- -multiverse.access.world_creative
- -multiverse.portal.access.end
- multiverse.access.*
- multiverse.core.coord
- multiverse.core.info
- multiverse.core.list.who
- multiverse.portal.access.*
inheritance:
- Guest
Donator:
prefix: '&5'
permissions:
- generic.donor.permissions
- multiverse.access.world_creative
inheritance:
- Player
Supporter:
prefix: '&6'
permissions:
- more.generic.donor.permissons
- multiverse.portal.access.end
inheritance:
- Donator
Moderator:
prefix: '&d'
permissions:
- generic.moderator.permissions
inheritance:
- Player
ModD:
prefix: '&d'
permissions: []
inheritance:
- Moderator
- Donator
ModS:
prefix: '&d'
permissions: []
inheritance:
- Moderator
- Supporter
The original forum post these nodes came from was asking why the ModD group was not getting the multiverse.portal.access.end node it was inheriting from the Donator group. Well, the reason for this is because of the way PEX evaluates nodes in a file backend and the inheritance tree.

An abbreviated version of the tree for the ModD group is this:

ModD permissions (none)
Moderator (generic.moderator.permissions) which inherits from Player
Player (which has -multiverse.access.world_creative among others) and inherits from Guest
Guest (no permissions)
Donator (generic.donor.permissions, multiverse portal access node) which inherits from Player
Player (which has -multiverse.access.world_creative among others) and inherits from Guest
Guest (no permissions)
In this case, the issue was due to the Moderator tree being evaluated first, which finds the negation node for multiverse and stops looking. If the Donator tree was listed first (which was the suggested fix), PEX would follow that inheritance tree first, which has the multiverse permissions, and allow access to that node.

===Regular Expressions (regex)===

Regular Expressions, also known as regex or regexp, is a way to 'match' strings of text, such as particular characters, words, or patterns of characters. PEX supports a subset of regex in it's permission node checks.

PEX supports open and closed parentheses ( ) for grouping, curly braces { } for pattern matching, a pipe | for "or", and a dash - for through (as in numbers 1 through 5).

WARNING: If you have any nodes that use these characters then you MUST either put the line in quotes or escape with a backslash the character. If you do not, PEX may mistake the character as an attempt to use a regex, causing a Java error and rendering your permissions useless!

To use it, place the conditions/keywords and/or id numbers in a group, separated by a pipe or a dash if wanting to cover multiple numbers in a sequence.

If this is confusing, worry not. There is a reason why several technical book publishers sell books dedicated to regular expressions. Fortunately, for the purposes of PEX and permission nodes, it's much simpler to deal with, especially with examples of it in action.

Assume that you have a group that you don't want opening the following:

Dispensers ('dispenser', or 23)
Chests ('chest', or 54)
Furnaces ('furnace', or 61 unlit and 'burning_furnance', or 62 lit)
Jukeboxes ('jukebox', or 84)
Remember to check your use-material-names node setting.

You could have a set of nodes like this:

- -modifyworld.blocks.interact.dispenser
- -modifyworld.blocks.interact.chest
- -modifyworld.blocks.interact.furnace
- -modifyworld.blocks.interact.burning_furnace
- -modifyworld.blocks.interact.jukebox
However, this is unnecessary. Using the regex support in PEX, you can combine the nodes into a single line: - -modifyworld.blocks.interact.(dispenser|chest|burning_furnace|furnace|jukebox) - -modifyworld.blocks.interact.(23|54|61|62|84) (for use-material-names: false)

If you wanted to keep a group from destroying stone (1), grass (2), dirt (3), and cobblestone (4), you can use modifyworld.blocks.destroy.(1-4)

You can also use 'or' on other parts of the node.

Keeping with the previous example, adding the ability to place the blocks looks like modifyworld.blocks.(destroy|place).(1-4) Adding sand (12) to this example, you could use modifyworld.blocks.(destroy|place).(1-4|12)

Adding this to a group, such as the default group, is as simple as using the pex group <group> add <node> command.

pex group default add modifyworld.blocks.(destroy|place).(1-4|12)
Any extra nodes can be removed with the pex group <group> remove <node> command. See Commands for more on the add/remove commands.

For advanced users, users can place a $ character directly in front of the node (after any other flag characters) to prevent PEX from performing regex escaping of . and *, so that they behave as normal regex characters rather than their function as delimiters in permissions nodes (escaped by default for backwards compatibility and user sanity)

As you can see, the ability to use regex in permissions can save a lot of typing.

File Back-end Example

In the interest of completeness, this is the full permissions file after the inheritance and regex commands listed above. This example assume use-material-names: false in your plugins/Modifyworld/config.yml file.

groups:
default:
default: true
options:
rank: '1000'
permissions:
- modifyworld.chat
- modifyworld.blocks.(destroy|place).(1-4|12)
Member:
prefix: '&0(&8M&7ember&0)&7 '
permissions:
- modifyworld.*
options:
rank: '900'
VIP:
prefix: '&0(&eVIP&0)&7 '
inheritance:
- Member
permissions:
- -modifyworld.mobtarget.monster.creeper
options:
rank: '800'
Moderator:
prefix: '&0(&1Moderator&0)&7 '
inheritance:
- VIP
permissions:
- -modifyworld.mobtarget.*
options:
rank: '100'
Admins:
prefix: '&0(&4Admins&0)&7 '
permissions:
- -modifyworld.mobtarget.*
- modifyworld.*
- permissions.*
options:
rank: '1'
users:
AnotherPlayer:
group:
- default
YourPlayerName:
group:
- Admins
===Multiworld===[[Multiworld]]

Having several maps (or worlds) on a server is a common way to offer more than one game play experience. However, not all commands are suitable for all worlds. You wouldn't want a hardcore survival world to have access to the give command, but it may be perfectly fine, if not required, in a world intended for free building. Fortunately, limiting a permission node to a specific world is easy with PEX by specifying the world when adding the permission node.

Assume the following server setup:

A survival world with Nether and End worlds (named survival, survival_nether, and survival_the_end respectively)
A free build world (named freebuild)
A group (pvp) that has the ability to build in the survival world only (modifyworld.*)
A group (build) that has the ability to build in the survival and free build world (modifyworld.*)
See Modifyworld page for details on block placement permission nodes.

The commands to set this up are:

/pex group pvp add modifyworld.* survival (add build permissions to the survival world for the pvp group)
/pex group build add modifyworld.* freebuild (add build permissions to the freebuild world for the build group)
/pex group build parents set pvp (Set the build group to inherit the permission to build in the survival world)
Keep in mind that if you edit/add the multiworld lines into the permissions file by hand, make sure the name you use matches the one used in the bukkit configs and what is on the server, capitalization matters here!

The resulting permissions will look like this in the file back-end:

groups:
pvp:
permissions:
worlds:
survival:
permissions:
- modifyworld.*
build:
inheritance:
- pvp
permissions:
worlds:
freebuild:
permissions:
- modifyworld.*
===多世界继承===

你也许看到了这一步的缺陷, 这两个权限组都被允许在地狱与末地使用. 可以用这两种方法对其纠正:

为每个世界单独添加modifyworld.*权限
用以下指令来/pex world <world> inherit <parentWorlds> /pex world pvp_nether inherit pvp /pex world pvp_the_end inherit pvp进行世界权限继承
这些指令执行后后台的配置文件应该会像这样:

worlds:
pvp_nether:
inheritance:
- pvp
pvp_the_end:
inheritance:
- pvp

=Backends=
原帖是这么说的
PermissionsEx provides several backends to store permissions data. This page (will explain) explains them all.
（PEX插件提供了一些用于保存权限数据的后台，这个页面会解释所有）
但其实这个页面只有这一句话（或许是服务器问题）
所以请等待更新。

=基础的权限设定=
==权限节点的基本添加和否定 ==
PEX插件有一个普遍原则，就是权限运行命令是不允许的，除非这个权限节点是具体列出的. 对于那些可以被默认（default）操作的事件和命令, PEX插件可以拒绝访问那些被否定的节点.

使用一个可以拒绝访问节点就像用 pex group <group> add <node>（最基本的权限给予命令）命令那样简单. 使用同样的命令，只在权限节点前加一个负号（-）即可.

举个例子 /give 和 /plugins 命令是水桶客户端的一部分（基本命令）

/give 命令有一个权限节点 command.give 这个命令一般限制在ops.txt列出的人使用（管理员命令）
/plugins 命令也有个权限节点 command.plugins 它可以被服务器中任何人使用。
我们可以试试对于某个权限组增加和否定这两个节点:

如果允许某个权限组使用/give, 就可以输入命令 pex group 组别名 add bukkit.command.give
不允许某个权限组使用 /plugins, 这时候的命令就为 pex group 组别名 add -bukkit.command.plugins

===重要的关于*的信息 ===
PEX插件允许使用XXX*来给予XXX下的所有的分权限节点，但是呢，在使用这个前，''你必须要明白它怎么工作以及会造成什么效果''。一开始浏览的时候，这看上去很简单，给一个权限组“*”使它可以访问所有的权限节点，但是这也可能会导致你给了你不想要给这个权限组的权限。例如，在插件VanishNoPacket（简称VNP）中，它提供了一个权限vanish.silentjoin，使得所有的用户在登入时都不会显示加入公告，这是大多数服务器主人都不想要的效果。实际上这也可以用否定节点来简单解决（否定节点优先），任何给默认组使用的权限节点都能被否定以“关闭功能”

===重要的后台文件 ===
如果你要在后台修改编辑权限的话，请阅读并遵守以下规则:
权限必须以一个空格或者负号开始
- modifyworld.chat 和 - -modifyworld.mobtarget.*是在后台文件中有效的（格式正确）。
modifyworld.chat 和 -modifyworld.mobtarget.* 在后台文件中无效（格式不正确，无空格或负号）。
所有在YAML文件中的格式规则在PEX插件基本文件中必须被遵守，错误的文件会使得PEX插件无法启动，然后把log文件塞满错误信息。
PEX插件用自上而下的方式来检查用户和组别的权限节点，就像网络防火墙一样，如果它找到了一个与它想找的匹配的节点，它就会停止寻找，这就意味着在现实中，如果一个权限给了主要组别和它所有的子组别，它在看到允许的权限后就会停止寻找而忽略否定节点。
我们举个错误的例子

default:
options:
default: true
permissions:
- modifyworld.*
- -modifyworld.blocks.interact.23
用这样的权限节点文件，如果一个玩家想要打开一个发射器（ID 23），它第一个会匹配到modifyworld.*节点然后停止，以至于允许玩家打开！（实际上第二个权限节点是不允许这样的事情发生的。

不过，如果把这两行互换，-modifyworld.blocks.interact.23在modifyworld.*之前，玩家会被拒绝访问发射器（插件先检测到-modifyworld.blocks.interact.23节点）如果一个玩家想要打开一个熔炉（ID 61）插件就会检测到modifyworld.*节点，然后认为是modifyworld.blocks.interact.61节点，使得玩家可以打开。

==上机操作==

先来试试基本的权限指令和插件基本功能（以下作为教程实例并且推荐各服务器使用。）
创建五个组别个组别：Default，Member，VIP,Mod,Admin。
"Default" 可以聊天但是不可以改动任何东西，没有称号
"Member"信任的玩家组别，可以改动世界，拥有称号 ("&0(&8M&7ember&0)&7 ")
"VIP" 可以改动世界还可以不受到苦力怕的烦恼（这个VIP棒）！并且拥有称号"&0(&eVIP&0)&7 ".
A "Mod" 可以不受到任何怪物的困扰（万岁！）.
An "Admin" (管理员) 是超级用户，可以使用这个插件的所有功能并且拥有炫酷的称号比如 "&0(&4Admin&0)&7 ".
可选: 去除 modifyworld.* 权限从 "Default" 权限组中
可选: 添加 modifyworld.chat 权限到 "Default" 权限组里
是时候测试环境了

===准备===
安装PEX插件（放在插件目录下）

开启服务器.

打开浏览器控制台（租借，后台服务器的话）

在浏览器中打开PEX插件的配置文件

===开始基础及基本权限 ===
这些命令必须在控制台输入

创建一个Admin权限组（pex group admin create命令）

把 permissions.* 权限加入到组别中（pex group Admin add pressions.*命令）
把你自己加入组中（pex user 你的游戏名 group set Admin）, 其中你的游戏名是你在游戏内的ID名.
可选的:给自己所有权限不管自己是不是在拥有permissions.*权限的权限组里

====如果你不想（不能）在控制台输入====
创建一个permissions.yml文件输入以下文字，并上传（放置）到PEX插件的目录，请确保你的格式是正确的！看上面的YAML后台信息的帮助。

groups:
Default:
options:
default: true
permissions:

modifyworld.* Admin: options: prefix: '&0(&4Admin&0)&7 ' permissions:
permissions.* users:你的用户名: group:
Admin permissions:
permissions.*
是时候创建其他组别了

===创建其他组别: Member, VIP, Mod ===

使用这个命令创建Member组 /pex group Member create
使用这个命令创建VIP组 /pex group VIP create
使用这个命令创建Mod组 /pex group Mod create
接下来我们要标注这几个组别的阶级使得符合这样的顺序 Member -> VIP -> Mod -> Admin.看阶级页面以知道更多

===设置阶级 ===
输入以下命令
/pex group default set rank 1000
/pex group Member set rank 900
/pex group VIP set rank 800
/pex group Mod set rank 100
/pex group Admin set rank 1
阶级100是最高提升的阶级数。

升级和降级命令都会在游戏内收到限制 (但在控制台不会). 在游戏中，你不可以:

把一个低于你阶级的升到你的阶级 (Mod到Admin, 用前面的例子)
把一个阶级高于你的降到低于你的阶级(Admin到Mod,用前面的例子)
不能对于你同样阶级的升降级 (Mob不能对Mob操作，Admin不能对Admin操作。)
如果你在游戏内（只是举个例子）是Admin，想要把一个玩家提高到你一样的阶级必须使用/pex user PlayerName group set Admin.

在控制台，你很自由可以不受以上限制。

===炫酷的滑板鞋!(好吧只是称号吗)===
使用以下命令
/pex group Member prefix "&0(&8M&7ember&0)&7 "
/pex group VIP prefix "&0(&eVIP&0)&7 "
/pex group Mod prefix "&0(&1Mod&0)&7 "
/pex group Admin prefix "&0(&4Admin&0)&7 "
确保在每个称号后面都加上了个空格，这可以阻止称号和用户名混在一起在聊天中。实际上，后缀前也是因为同样的理由加一个空格为好。还有一种可以显示前缀后缀的方法就是前缀后缀相同（只需把prefix变成suffix就行）。

===给每个组别添加权限 ===
注意: 如果你还没有允许这些组别修改世界，那么删除modifiyworld.*这一步是不需要的.

可选的: /pex group default remove modifyworld.*
可选的: /pex group default add modifyworld.chat (Only needed if modifyworld.* has been removed)
/pex group Member add modifyworld.*
/pex group VIP add modifyworld.*
/pex group VIP add -modifyworld.mobtarget.monster.creeper
/pex group Mod add modifyworld.*
/pex group Mod add -modifyworld.mobtarget.*
/pex group Admin add permissions.*
/pex group Admin add modifyworld.*
/pex group Admin add -modifyworld.mobtarget.*
来看看成果吧！

===见证奇迹！===

你想要改变你的权限组的话，使用这个命令 /pex user 玩家名 group set 权限组名，接下来就测试啦！

Default

验证你可以聊天
验证你有正确的前缀在聊天时
验证你可以在出生点外破坏方块
注意: 如果你把modifyworld.* 节点之前移除了，就不能破坏（之前是可选项）
如果你可以破坏但是modifyworld.* 节点被移除了！, 找到个爬行者然后拥抱它！ (别担心，它保证对你没兴趣但是你伤得了它)
Member

验证你可以聊天
验证你有正确的前缀在聊天时
验证你可以在出生点外破坏方块
VIP

验证你可以聊天
验证你有正确的前缀在聊天时
验证你可以在出生点外破坏方块
如果你可以破坏但是modifyworld.* 节点被移除了！, 找到个爬行者然后拥抱它！ (别担心，它保证对你没兴趣但是你伤得了它)
Admin

验证你可以聊天
验证你有正确的前缀在聊天时
验证你可以在出生点外破坏方块 (如果你把玩家名字放在了OP文件中，并且在PEX插件配置config文档里把allowOps设置为了true，你将可以在出生点附近破坏).
验证你可以使用PEX插件所有命令(使用/pex reload命令测试，它应该会回复 "Permissions Reloaded（权限重新加载）")
验证所有怪物都对你没兴趣
下一步你可以换一个玩家作为“实验对象”比如加入游戏的好基友(这是为了科学！!)

===测试阶级 ===

首先使用/pex user 另一个玩家 group set default
验证升降级别命令有效使用/pex promote 前面你移动的那个玩家. 你会看见 "User AnotherPlayer promoted to NextGroup（这个玩家到了下个组别）"
一直使用这个命令直到出现 "Promotion error: User is not promotable（升级错误，用户不允许）". 使用 /pex user 这个玩家命令会显示:
playername are member of:
Mod (rank 100 @ default)
playername's permissions:
-modifyworld.mobtarget.* (from Mod)
modifyworld.* (from Mod)
playername's options:
降级和升级一样，只不过把命令中的promote变成demote
如果那个玩家只是个机器人, 如果你想的话，使用这个命令把它删掉 /pex user 玩家名 delete
如果那个玩家是真人，确保每个组别都正常工作（看上机教程最前面。）

===后台文件案例===
如果你成功了上面那个案例，你就会发现后台文件变成了这样。很具有参考性:

groups:
default:
options:
rank: '1000'
default: true
permissions:
- modifyworld.chat
Member:
permissions:
- modifyworld.*
options:
rank: '900'
prefix: '&0(&8M&7ember&0)&7 '
VIP:
permissions:
- -modifyworld.mobtarget.monster.creeper
- modifyworld.*
options:
rank: '800'
prefix: '&0(&eVIP&0)&7 '
Mod:
permissions:
- -modifyworld.mobtarget.*
- modifyworld.*
options:
rank: '100'
prefix: '&0(&1Mod&0)&7 '
Admin:
permissions:
- -modifyworld.mobtarget.*
- modifyworld.*
- permissions.*
options:
rank: '1'
prefix: '&0(&4Admin&0)&7 '
users:
AnotherPlayer:
group:
- default
YourPlayerName:
group:
- Admin
这就是被解析后的文件的样子，但是最好使用YAML编写工具来确保你的文件已经正确，不然插件可能会出所有类别的错误！

{
"users": {
"AnotherPlayer": {
"group": [
"default"
]
},
"YourPlayerName": {
"group": [
"Admin"
]
}
},
"groups": {
"default": {
"options": {
"default": true,
"rank": "1000"
},
"permissions": [
"modifyworld.chat"
]
},
"Member": {
"options": {
"prefix": "&0(&8M&7ember&0)&7 ",
"rank": "900"
},
"permissions": [
"modifyworld.*"
]
},
"VIP": {
"options": {
"prefix": "&0(&eVIP&0)&7 ",
"rank": "800"
},
"permissions": [
"-modifyworld.mobtarget.monster.creeper",
"modifyworld.*"
]
},
"Mod": {
"options": {
"prefix": "&0(&1Mod&0)&7 ",
"rank": "100"
},
"permissions": [
"-modifyworld.mobtarget.*",
"modifyworld.*"
]
},
"Admin": {
"options": {
"prefix": "&0(&4Admin&0)&7 ",
"rank": "1"
},
"permissions": [
"-modifyworld.mobtarget.*",
"modifyworld.*",
"permissions.*"
]
}
}
}

=Chat Manager=
=命令=
===实用指令===
注意，在以下命令里 user=玩家名字，world=世界名字 permission=权限 node=节点 backend=后台文件 group=权限组别
/pex 显示帮助
permissions.manage
/pex toggle debug 调试开关（不要总开着！，要不然会出很多信息文件）
permissions.debug
/pex user <user> toggle debug 给指定的一个人测试调整（上面一样）
permissions.manage.<user>
/pex user <user> check <permission> 检查一个具体的玩家的具体的权限
permissions.manage.<user>
/pex reload 重新载入所有pex文件
permissions.manage.reload
/pex config <node> [value] 看节点的值（写上后面的更改值）
permissions.manage.config
/pex backend 看现在的后台文件（也就是正在用的文件）
permissions.manage.backend
/pex hierarchy 看现在服务器结构（阶级）
permissions.manage.users
/pex dump <backend> <filename> 把你的后台文件倒到另外一个文件里谨慎使用！不会立刻保存，但会在游戏中有效果
permissions.manage.dump
/pex users cleanup <group> [threshold] 清走“死亡”的会员（默认30天不活动）
permissions.manage.users.cleanup

===世界管理===
/pex worlds 看PEX里面的世界
permissions.manage.worlds
/pex world <world> 看这个世界的层次信息
permissions.manage.worlds
/pex world <world> inherit <parentWorlds> 让你选择的世界继承一个世界（继承permission,etc.)
permissions.manage.worlds.inheritance
玩家指令：
/pex users list 看所有在PEX里面的玩家
permissions.manage.users
/pex users 一样一样
/pex user 一样一样 = =
玩家permission管理：
/pex user 一样.....······
permissions.manage.users
/pex user <user> 看玩家的权限
permissions.manage.users.permissions.<user>
/pex user <user> prefix [newprefix] 设置玩家前缀颜色
permissions.manage.users.prefix.<user>
/pex user <user> suffix [newsuffix] 设置玩家后缀颜色
permissions.manage.users.suffix.<user>
/pex user <user> delete 把玩家从权限文件里面移除
permissions.manage.users.<user>
/pex user <user> list [world] 看玩家的权限
permissions.manage.users.permissions.<user>
/pex user <user> add <permission> [world] 给玩家增加权限
permissions.manage.users.permissions.<user>
/pex user <user> remove <permission> [world] 给玩家移除权限
permissions.manage.users.permissions.<user>
/pex user <user> timed add <permission> <lifetime in seconds> [world] 给玩家在时间内（秒）添加权限
permissions.manage.users.permissions.timed.<user>
/pex user <user> timed remove <permission> <lifetime in seconds> [world]给玩家在时间内（秒）移除权限
permissions.manage.users.permissions.timed.<user>
/pex user <user> set <option> <value> [world] 给玩家设选择值（不怎么懂表示，望进一步翻译和解释）
permissions.manage.users.permissions.<user>

===玩家组管理===
/pex user <user> group list 给出玩家所有现在在的组
permissions.manage.membership.<user>
/pex user <user> group add <group> [world] [lifetime]把玩家加入组（时间，秒，不设默认永久）
permissions.manage.membership.<group>
/pex user <user> group set <group> [world] 把玩家放进组，注意这将会把玩家从另一个组移除
permissions.manage.membership.<group>
/pex user <user> group remove <group> [world] 把玩家从组移除
permissions.manage.membership.<group>

===默认组管理===
/pex default group [world] 看默认的管理组情况
permissions.manage.groups.inheritance
/pex set default group <group> [world] 把权限组组设成默认
permissions.manage.groups.inheritance

===组的指令===
/pex group 显示所有创建了的组
permissions.manage.groups.list
/pex groups ↑（同上）
permissions.manage.groups.list
/pex groups list ↑
permissions.manage.groups.list
/pex group <group> prefix [newprefix] 设置组前缀
permissions.manage.groups.prefix.<group>
/pex group <group> suffix [newsuffix] 设置组后缀
permissions.manage.groups.suffix.<group>
/pex group <group> create [parents] 创建组，parents（母权限组）是说他是从哪里升级得来的（继承权限)
permissions.manage.groups.create.<group>
/pex group <group> delete 删除权限组
permissions.manage.groups.remove.<group>
/pex group <group> parents list 看权限组的继承表
permissions.manage.groups.inheritance.<group>
/pex group <group> parents set <parents> 设置权限组组的母权限组
permissions.manage.groups.inheritance.<group>
/pex group <group> 显示所有组的权限
permissions.manage.groups.permissions.<group>
/pex group <group> list [world] 组的所有权限，加上世界名称可以看单个世界的权限
permissions.manage.groups.permissions.<group>
/pex group <group> add <permission> [world] 给小组加权限
permissions.manage.groups.permissions.<group>
/pex group <group> remove <permission> [world] 移除权限
permissions.manage.groups.permissions.<group>
/pex group <group> timed add <permission> [lifetime] [world] 给权限组限时加权限，不填默认永久
permissions.manage.groups.permissions.timed.<group>
/pex group <group> timed remove <permission> [world] 给权限组限时移除权限组，不填默认永久
permissions.manage.groups.permissions.timed.<group>
/pex group <group> set <option> <value> [world] 给组的人设置选则的值
permissions.manage.groups.permissions.<group>

===组的玩家的管理===
/pex group <group> users 所有在组里的玩家
permissions.manage.membership.<group>
/pex group <group> user add <user> 把玩家弄进小组
permissions.manage.membership.<group>
/pex group <group> user remove <user> 把玩家从组里移除
permissions.manage.membership.<group>
/pex promote <user> <ladder> 不知道怎么翻译了Promote <玩家名> on <ladder>. If <ladder> is not specified, the default ladder (named default) will be used.
permissions.user.promote.<ladder>
/pex demote <user> <ladder> 大题同上
permissions.user.demote.<ladder>

=FAQ=
=Features=
=Integrating with PEX=
=Migration=
=Migration and UUIDs=
=Modifyworld（中译世界修改）=
===需要注意的地方===

这些需要你已经安装了一个权限插件，其中需要先设置默认组只能聊天。

默认情况下，玩家不会受限制，但是服务器通常需要通过自定义取消用户的权限节点来限制玩家的行为，你可以把modifyworld.*这个权限否定，这样玩家就什么都干不了了

除了以上，默认时，这些关于世界修改的权限是使用方块名字来替代物品ID，如果你想使用ID，设置或增加config文件中的use-material-names: false即可

否定一个节点（在前面加负号"－",或者把它的值设为false）来否定玩家或者组别的一些功能。而通配符*是指父（即*前）权限节点下的所有子权限节点。

当你在使用PEX插件时，你可以在文件里一行指定多个物品，用|分开，打出这个需要按住shift后按反斜杠\，比如(260|296|297) 就是苹果，小麦和面包，当然先要设置use-material-names: false
===重要提醒===

Thanks to Bukkit user @Tahg we were notified about one issue with the modifyworld.blocks.place.* node: If you remove modifyworld.* from a group, for the group to place blocks, you will need to specify what blocks the group is allowed to place other blocks on using the modifyworld.blocks.interact.* (alternately you can use a wildcard for the block ID with modifyworld.blocks.interact.*) in addition to the modifyworld.blocks.place.* for the blocks the group is allowed to place. This is because Bukkit checks first for onPlayerInteract() then for onBlockPlace().
For example, when trying to place a sand block on a grass block, the permission node checks are modifyworld.blocks.interact.grass then modifyworld.blocks.place.sand. Consider the block being targeted with this action - the interact permission is required for the block that is targeted with right-click, and thus could be to the side or above the placed block.
Metadata can appear on a lot of blocks and items that you might not expect, please make sure you read the section on Metadata and check the debug output before posting in the forums!

===配置文件===

Modifyworld 的配置文件储存在 plugins/Modifyworld/config.yml

下面是 ModifyWorld 的配置文件:

informPlayers: true
itemRestrictions: true
whitelist: false
messages:
prohibitedItem: 你拥有违禁物品 "%s".
whitelist: 你没有白名单加入这个服务器.拜拜!
permissionDenied: 对不起,你没有足够的权限！
use-material-names: true
drop-restricted-item: false
item-use-check: false

===Configuration Properties===

由于搬运，格式有些耽误此处格式为：

权限/实体...名（默认是否开启，false为不开启，或者该项的值）简介
informPlayers false 是否通知玩家该玩家的权限变化
itemRestrictions false Enable/disable item restrictions. If this is enabled, items not configured to be allowed will be removed from the player's inventory if it's found.
messages.prohibitedItem 你禁止某项物品后，会发送信息给拥有被禁止的物品者
messages.whitelist You are not allowed to join this server. Goodbye! 给不在白名单内玩家的信息
messages.permissionDenied Sorry, you don't have enough permissions 给尝试做没有权限的事情的玩家的信息
whitelist false 是否开启白名单
drop-restricted-item false 设置为true后玩家丢出物品时是“吐出”然而设置为false后玩家丢物品，物品会直接不见！
use-material-names true true时，检查节点时会使用物品名字来代替ID
check-metadata (版本 1.19.1后无) false If true, modifyworld will use the meta-data for blocks and items in the permissions checks. This means that your nodes may need a :* or .* added to the end of them!
item-use-check false 设置为true后，可以设置modifyworld.item.use.<物品id>.on.block.<方块id> 的节点，即检查物品使用的对象，基本取代了modifyworld.interact.<实体名称>
===Metadata Notes===

Starting with release 1.19.1, metadata handling has been changed a bit.

There is no longer a need to specifically turn on metadata handling for modifyworld. However, a lot of blocks and items have metadata that one might not expect, or now has metadata due to changes in minecraft and bukkit.

A few examples are leaf blocks (each type has it's own value), planks (for the different colours), and sandstone (the different designs).

For item ID's that have metadata, using :* will cover all possible values for the metadata. For nodes that cover multiple items/blocks where some have metadata and others do not, the regex value of :?* will cover ID's that have metadata and ID's that do not.

Many blocks that you might not expect can have metadata, such as chests and doors that are freshly placed but have not been opened yet. When in doubt and you can't get a permission node, turning on debug will show what is being looked for. Please do this before posting in the forums, I can't stress this enough. Metadata is a very large stumbling block for many new users to PEX.

===Generic Nodes===

modifyworld.login 是否允许玩家加入游戏，你需要吧白名单开启来启动这个功能
modifyworld.chat 是否允许玩家能发布公告，聊天
modifyworld.sneak Player can crouch (check your Minecraft client config for the key) NOTE: Per https://github.com/PEXPlugins/PermissionsEx/issues/78, 这个节点在bukkit中因为缺少支持难以工作
modifyworld.sprint Player can sprint (double tap your forward key) NOTE: Per http://github.com/t3hk0d3/PermissionsEx/issues/78,也因为同样的原因难以工作。
modifyworld.chat.private 玩家是否能私聊
modifyworld.usebeds 玩家是否能使用床
modifyworld.bucket.empty.<fluid> 玩家是否能使用液体（清空桶）
<fluid>指的是水或岩浆
modifyworld.bucket.fill.<fluid> 玩家是否能用桶装东西
<fluid> 指的是谁，岩浆或牛奶（早期版本里，air就是牛奶）
modifyworld.digestion Allows players' energy bar to deplete. A popular application of this would be to do -modifyworld.digestion to disable energy consumption whilst still enabling modifyworld.*

===Block Nodes===

See Materials for <blockid> values.

modifyworld.blocks.destroy.<blockid> Player can break <blockid>. It's also possible to specify <blockid> by name. Example: modifyworld.blocks.destroy.stone
modifyworld.blocks.place.<blockid> Player can place <blockid>. NOTICE: This permission requires modifyworld.blocks.interact.<blockid> to work properly.
modifyworld.blocks.interact.<blockid> Player can interact with <blockid> (use levers, press buttons, etc.)
===Item Nodes===

See Materials for <itemid> values.

modifyworld.items.craft.<itemid> Player can craft <itemid>.
modifyworld.items.drop.<itemid> Player can drop <itemid>.
modifyworld.items.enchant.<itemid> Player can enchant <itemid>.
modifyworld.items.have.<itemid> Player can have <itemid> in their inventory. itemRestrictions: true need to be set for this to work.
modifyworld.items.hold.<itemid> Player can have <itemid> in their hand. itemRestrictions: true need to be set for this to work.
modifyworld.items.pickup.<itemid> Player can pickup <itemid>. Also it's possible to specify <itemid> by name, example: 、modifyworld.items.pickup.diamondpickaxe
modifyworld.item.use.<itemid>.on.block.<blockid> Player can use <itemid> on block <blockid>. item-use-check: true need to be set for this to work and is check in addition to the modifyworld.interact.<entityName> checks
As of 1.19.3
modifyworld.items.use.<itemid>.on.block.<blockid> Player can use <itemid> on block <blockid>. item-use-check: true need to be set for this to work and is check in addition to the modifyworld.interact.<entityName> checks
modifyworld.items.throw.<itemid> Player may throw eggs, snowballs, splash potions or experience bottles. Potion metadata excludes splash flag: potion:34 will match a Splash Potion of Swiftness II.
As of 1.19.4
modifyworld.items.take.<itemid>.of.<container> Player may take items from containers, such as chests.
modifyworld.items.put.<itemid>.of.<container> Player may take put items in containers, such as chests.
===实体权限节点===

modifyworld.damage.deal.<实体名称> Player can deal damage to <entityName> (e.g. skeleton, spider, creeper, cow, pig, minecart, etc)
modifyworld.damage.take.<实体名称> Player can take damage from <entityName>
modifyworld.mobtarget.<实体名称> Player can be targeted by <entityName>
modifyworld.interact.<实体名称> Player can interact with <entityName>
modifyworld.tame.<实体名称> Player can tame <entityName>. This permission won't give you ability to tame animals or mobs that are not normally tameable (no pet creepers). Currently, only animal.wolf and animal.ocelot are applicable.

===Possible <entityName> values===

Players and Wolves
player.<playerName> Player called <playerName>. (Example: player.t3hk0d3)
group.<groupName> Any member of <groupName> group. (Example: group.admins)
animal.wolf Wild wolf
animal.wolf.<playerName> Wolf tamed by <playerName> (Example: wolf.t3hk0d3)
animal.ocelot Wild ocelot (cat)
animal.ocelot.<playerName> Tamed cat (ocelot)
Example: animal.ocelot.t3hk0d3
npc.villager Not related to Bert
snowman Not related Frosty
irongolem Defenders of the Villagers
Animals
animal.chicken cluck-cluck
animal.cow Mooo
animal.mushroomcow Mooshroom
animal.pig Pig
animal.sheep Sheep
animal.squid Squid
Monsters
monster.blaze Pyros, every one...
monster.cavespider Worse than spiders
monster.creeper SssssSSSssss
monster.enderman Don't look at them directly
monster.ghast AWWWWWWW
monster.giant Giant Zombie
monster.pigzombie Pig Zombie, omg
monster.silverfish Beware the horde
monster.skeleton Them bones, them dry bones...
monster.slime Covers regular slimes and magma cubes
monster.spider Yep, this is Spider, he is annoying.
monster.zombie Brainzzzz...
Environment
starvation Num nums, or lack there of
fire Initial fire damage
lava Lava damage. Add firetick too for full protection.
firetick Damage from touching fire (or after stepping into lava) over time.
blockexplosion Damage from TNT explosion.
projectile.arrow Arrows shot at player
drowning Failing to grab a breath of fresh air
fall Jumping without a parachute
suicide Committing Seppuku
poison Poison potions
===坐骑权限===

注意：如果你想有权限进入或跳下一个坐骑（矿车马等），你还需要modifyworld.*权限。

modifyworld.vehicle.destroy.<坐骑名称> 玩家能破坏这个矿车 (坐骑名称要是英文)
modifyworld.vehicle.enter.<坐骑名称> 玩家能够骑上一个坐骑(坐骑名称要是英文)
modifyworld.vehicle.collide.<坐骑名称> 玩家能够跳下一个坐骑 (坐骑名称要是英文)

===Possible <vehicleName> values===

Boat
boat Not related to the Love Boat
Minecart
minecart Indiana Jones rides in one of these
===物品名称===

如果 use-material-names 设置为 false 就使用物品 ID . 否则使用物品英文名称.

你可以找到更多的细节，包括数据值信息，在Minecraft wiki.

=Pex basics=
===权限和服务器术语===

服务器控制台 (又叫控制台); 就是当服务器启动时出现的黑色窗口.显示服务器和插件启动信息，以及服务器和插件错误.

全局权限: 就是在服务器上所有世界通用的权限.

世界特定权限: 只在某一个世界启用的特定权限.（如world世界允许飞行而别的世界不可以）

用户: 你服务器的玩家们.

权限组: 一个命名的许多权限权限在一起就叫权限组, 通常用于在服务器上指定各种权限级别（如VIP1，VIP2）

权限组可以拥有全局和世界特定权限，以及其他插件使用的权限.

权限：表示一个命令、动作或能力是否允许。例如，/give 命令在Bukkit里具有bukkit.command.give节点.

否定权限: 标记为不可用的节点. 一般只在某些特定情况下使用.

继承：一个权限组能够自动使用另一个权限组的所有权限的能力。PEX支持组和世界继承。

数据值: (又叫附加值) 数据值是另一个值添加到一个物品ID号的值，如不同颜色的羊毛块，一个开关的位置，如果一扇门打开或关闭，等等。主要用于
modifyworld。

===权限层次 ===

PEX支持基于文件和SQL权限的权限等级: 。为了方便解释和可视化，下面的示例将使用一个基于文件的权限层次结构.

users: <- 玩家部分
t3hk0d3: <- 玩家名字
group: <- 玩家组部分
- default <- 玩家所在的组的名字
permissions: <- 玩家特定权限部分
- permissions.* <- 玩家所拥有的特定权限
worlds: <- 世界特定权限部分
world: <- 世界名称
permissions: <- 世界特定的权限组
- test.* <- 世界特定权限
group: <- 世界特定权限组部分
- testers <- 世界特定权限组
prefix: '&5[YARR]&f' <- 世界特定称号
groups: <- 权限组部分
default: <- 权限组名称
default: true <- 默认组部分
permissions: <- 权限组部分
- -modifyworld.blocks.interact.23 <- 否认权限节点
- modifyworld.* <- 权限节点
admins:
inheritance: <- 该组继承的组
- default <- 从default继承
permissions:
- example.permission
- -punish.noobs
options: <- 组选项部分
test.test: '100500' <- 额外数据
rank: '1' <- 阶级
worlds:
nether:
permissions:
- nocheat.fly
prefix: '&7[ADMIN FROM HELL]'
testers:
inheritance:
- admins
options:
test.test: '9000'
worlds: <- 世界特定部分
nether: <- 世界名称
inheritance: <- 继承世界部分
- world <- 从world世界里继承

===PEX文件格式（YAML） (YAML)===

PEX,像许多别的插件一样, 使用的文件格式是 YAML (YAML Ain't Markup Language, 如果你想知道更多猛点这个网址 http://yaml.org/). YAML, 不像其他的文件格式，有着非常挑剔的格式和字符使用。所以PEX的配置文件，包括权限的文件，必须缩进正确！Capitalization matters as well!

适用于PEX的YAML规则:

Certain characters are reserved for use by YAML. Some of the characters are ' - : # and %. If the data for an entry is going to use one of those characters, it must be in quotes.
%prefix%player%suffix> &e%message is invalid. "%prefix%player%suffix> &e%message" is valid
Any entries that are made of numbers only must be in quotes.
rank: 1000 or 45625: is invalid. rank: '1000' or '45625': is valid.
Tabs are not allowed to be in the file anywhere, unless it is in quotes. Any place where you would use a tab must use exactly two spaces.
Each group must start at the very beginning of the line, and each section contained within that section must be indented.
Due to the regex support in PEX, there are other characters that one has to be aware of. Characters such as } { ) ( ? and * must be quoted or escaped (a backslash works well). This isn't a YAML limitation, but is a similar situation to the reserved characters in YAML.

=PEXML=
=Plugin Configuration=
=Ranks (Promotion and Demotion)=
=Troubleshooting and FAQ=