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

Studio讨论:互助客栈

2016-02-26T21:31:10Z

Lichi2050：/* 成员名单贴 */

{{模板:互助客栈提示}}

{{Comment Title}}

== 插件百科新图标设计意见征求 ==

''百科图标许久未变，初始是为kaho同学所协助编辑，但时至今日，此图标显得并不正式，且未显示出插件百科值特色与理念。

故在此征求大家对新图标的意见。

意见初步统一之后将创建投票，最终全部通过后由指定成员（小组）进行创作。
''
[[用户:Iwar|Re_]]（[[用户讨论:Iwar|讨论]]） 2015年9月2日 (三) 14:19 (HKT)

== 成员名单贴 ==

因为不知道有多少人在这里...

所以在此留下你的ID...

......

正经点吧

用5级标题写自己的名字

除管理员外请不要删除别人的名字

本人为例

作者seesaw_233 2015-10-16
::可以在[http://mineplugin.org/%E7%89%B9%E6%AE%8A:%E8%B4%A1%E7%8C%AE%E5%BE%97%E5%88%86 这里]了解下最近活跃的成员 [[用户:Iwar|Re_]]（[[用户讨论:Iwar|讨论]]） 2015年10月25日 (日) 11:10 (HKT)
=== 在下面留名 ===
===== seesaw_233 =====
===== LocusAzzurro =====
===== Lzs =====
===== Lichi2050 路过看看 =====

WorldGuard

2015-12-17T19:27:04Z

Lichi2050：/* 开发者 API */

Mcbbs发布贴http://www.mcbbs.net/thread-505810-1-1.html
='''配设文件'''=
='''指令介绍'''=
==Region指令==
===定义和重定义区域（define和redifine）===

/region define 区域名称 (玩家1) (玩家2) （玩家...） 
/region def 区域名称 (玩家1) (玩家2) （玩家...） 
/region d 区域名称 (玩家1) (玩家2) （玩家...） 
（）内容为可选项，如果没有指定玩家，定义后的区域将会属于输入命令的玩家（可以设定多个拥有者） 

这个指令主要是创造区域，创造后才可以进行更多的设定，这个指令是没有限制区域大小的（根据WorldEdit选择的大小） 
玩家部分也可以设定为权限组，这个指令主要是给管理员使用，玩家会有另外一个指令 /claim 

/region define 区域名称 g:权限组名称玩家1 玩家2 
'''注*整个世界区域叫做 __global__'''

/region redefine 区域名称 
/region update 区域名称 
/region move 区域名称 

这个指令会重定义已定义区域，选择好新区域后，输入指令后就可以重定义指定区域 

===区域圈地（claim）===

/region claim 区域名称 (玩家1) (玩家2) (玩家...) 

'''注意！'''这个指令是在2010年11至12月出现的，是很早期的指令，比Bukkit都早，在不久的将来会受到改善！ 
这个指令和define指令非常相似，但是加入了一些其他设定 

如果配设内有启动claim功能，玩家将会被限制区域数量 
创造新区域时不可以重复区域名称，除非你是拥有者，那么就会重定义该区域 
新区域不可覆盖其他区域 
如果配设内有启动claim功能，重新新区域时可以覆盖玩家拥有的其他区域 
如果配设内有启动claim功能，玩家将会被限制区域大小 

===区域信息（information）===

/region info （-s）（世界名称）（区域名称） 

列出区域的详细信息，内含 

区域名称（区域类型，优先权） 
区域flags 
区域拥有者 
区域成员 
区域边界 

空的信息项不会显示 
在指令内加入-s 会在显示信息的同时选择该区域 
如果没有输入区域名称，插件会自动取读脚下的区域 

'''列子：查看“TownPlot”区域的信息'''
/region info townplot 

'''列子：查看地狱世界“TownPlot”区域的信息'''
/region info world_nether TownPlot 
 

===区域选择（select）===

/region select [区域名称] 
这个指令会选择区域 
如果没有输入区域名称，插件会自动取读脚下的区域 

'''列子：选择“TownPlot”区域'''
/region select townplot 

===区域表列（list）===

区域表列（list） 

/region list （页数）（-w 世界名称）（-p 玩家） 

'''列子：列出第一页区域列表'''
/region list 

'''列子：列出地狱世界第三页区域列表'''
/region list 3 -w world_nether 

同时也可以只显示"玩家"的区域，影藏其他区域，需要在指令内加入-p 玩家 

'''列子：列出玩家1的区域列表'''
/region list -p 玩家1 

===设定flag===

/region flag 区域名称 flag （-g 权限组） [-w 世界名称] （数据值） 
这个指令可以为区域设定flag，如果（数据值）没有填的话，选择的flag就会被清除（还原） 
你们必须明白区域优先权和父子区域的关系才可以正确的设定flag，所以最好去查看flag列表 

'''列子：“TownPlot”区域禁止pvp的flag''' 
/region flag townplot pvp deny 

'''列子：在“duduworld”世界“TownPlot”区域禁止pvp的flag''' 
/region flag townplot pvp -w duduworld deny 

'''列子：“TownPlot”区域设定欢迎信息的flag''' 
/region flag townplot greeting 欢迎你来到这个区域, %name%! 
进入“TownPlot”区域显示：欢迎你来到这个区域, 玩家ID! 

'''列子：“TownPlot”区域清除退出信息的flag''' 
/region flag townplot farewell 
效果：退出“TownPlot”区域时不显示退出信息 

===设定优先权(priority)f===

/region setpriority [区域名称] （-w 世界名称） [优先权] 
/region priority [区域名称] （-w 世界名称） [优先权] 
/region pri [区域名称] （-w 世界名称） [优先权] 

设定区域优先权，[优先权]处得填一个整数，可以是正数也可以是负数。 

===设定子区域（parent）===

/region setparent [子区域] [父区域] 
/region parent [子区域] [父区域] 
/region par [子区域] [父区域] 

设定子区域。 

===删除区域（remove）===

/region remove [区域名称] （-w 世界名称） 
/region rem [区域名称] （-w 世界名称） 
/region delete [区域名称] （-w 世界名称） 
/region del [区域名称] （-w 世界名称） 

删除一个区域 

===区域传送（teleport）===

/region teleport (-s) [区域名称] 
/region tp (-s) [区域名称] 

传送到某个区域内，如果加入-s就会传送到区域设定的重生点。 

===区域管理（management）===

/region load （-w 世界名称） 
/region save （-w 世界名称） 

加载或者保存设定完的区域。 
'''注意！如果没保存加载时会丢失设定的项目，但WorldGuard的指令在修改完某项设定会自动保存。（通常不会出现这种情况）''' 

/region migratedb [1] [2] 
转移region文件yml格式到数据库MySQL，或者相反。 

=权限介绍=
=regions教程=
==基础教程==

开始前我们必须安装Worldedit配合WorldGuard才可以使用！ 
不熟悉/不知道[[WorldEdit|Worldedit]]？ 
以下教程内Worledit会简称为WE,Worldguard为WG。 

1.通过WE选择2点来确定一个立方体（于平时WE选择一样） 
扩大选择区域 
指令：
//expand <amount> [direction] 
//expand <amount> <reverse-amount> [direction] 
//expand vert 
效果：第一个：通过指定的方向扩大（东南西北上下） 
第二个：通过面向的方向扩大（东南西北） 
第三个：垂直方向扩展到基岩以及天空 
说明：对于指定的方向，用”N”(北),”S”(南),”W”(西),”E”(东),”U”(上),”D”(下)来代表方向(实际太阳升起的方向是南方。。即S，至于为什么我也不知道)。对于面向的方向，如果不出入WENS之类的就会默认为像面向的方向扩展。最后一个则是垂直方向上下完全扩展。 

用法：
//expand 扩大格数（数字）方向（N S W E U D） 
//expand 扩大格数反向扩大格数（可以不写） 
//expand vert 

2.创造region 
/region define <region_名称> 
或（更详细指令） 
/region define <region_名称> [拥有者1] [拥有者2] [拥有者3] (…….) 
创造这个region，创造一个region后，例如我们的就叫做Mcbbs，那么默认玩家就不能破坏这个region内的物品（其他设定稍后再说） 

3.添加成员/会员以及删除 

/region addmember <region_名称> [会员1] [会员2] [会员3] (…….) 
例如 
/region addmember Mcbbs Lichi2050 
意思就是在Mcbbs这个region内，玩家Lichi2050也就是我，可以破坏（默认没有修改破坏flag时都有效）。 

删除也是原理，只不过指令稍微改变了一下 
/region remember <region_名称> [会员1] [会员2] [会员3] (…….) 

4.添加拥有者以及删除 

/region addowner <region_名称> [拥有者1] [拥有者2] [拥有者3] (…….) 
例如 
/region addowner Mcbbs Lichi2050 
意思就是在Mcbbs这个region内，我Lichi2050是这个region的拥有者（可以设定/修改这个region的任何设置）。 

删除也是原理，只不过指令稍微改变了一下 
/region remowner <region_名称> [拥有者1] [拥有者2] [拥有者3] (…….) 

5.region优先权以及子区域 

/region setpriority <region_名称> <优先权> 
<优先权>是一个数字，他可以是正数例如3，也可以是负数例如-1 
数字越大，优先权就越大，例如region1的优先权是2，region2的优先权是5 那么region2的配设会取代/覆盖region1的设定（当然如果2个区域没有覆盖那么设不设定优先权都无所谓）。 

/region setparent <子_region_名称> <父_region_名称> 
首先我们得先了解什么是子区域，子区域有什么用处其实设定父子区域意思和继承差不多（使用权限组插件的朋友相信会很清楚） 
子region会取读父region的拥有者，会员，以及flag设定（就不用重复设定了，方便） 

==flag列表==
===区域权限组===

区域权限组为 
members 成员 
nonmembers 非成员 
owners 拥有者 
nonowners 非拥有者 
everyone 全部玩家 

注*如果直接修改regions.yml区域权限组有改动（全部变成大写并且everyone变成ALL）！ 

MEMBERS 成员 
NON_MEMBERS 非成员 
OWNERS 拥有者 
NON_OWNERS 非拥有者 
ALL 全部玩家 

区域权限组有什么用呢？在设定flag时可以专门只为一个权限组设定flag（别和权限组插件搞混了！！！） 
例如 
/rg flag <region_名称> exit deny 
/rg flag <region_名称> exit -g nonowners 
我们的region还是叫做Mcbbs 

首先第一个指令禁止了退出（出去）这个region 
下一个指令设定了-g nonowners 意思就是非拥有者玩家不可退出Mcbbs这个region 

或者你也可以设定例如只禁止什么人进入，又或者什么人进入后会无敌等等（看各自的脑洞吧） 

==开发者 API==
===取读WorldGuard=== 

一个参考的列子 

Example: Getting a reference to WorldGuard 
import com.sk89q.worldguard.bukkit.WorldGuardPlugin; 
import org.bukkit.plugin.Plugin; 
private WorldGuardPlugin getWorldGuard() { 
Plugin plugin = getServer().getPluginManager().getPlugin("WorldGuard"); 

// WorldGuard 没有加载 
if (plugin == null || !(plugin instanceof WorldGuardPlugin)) { 
return null; // 也许你想提示一个错误 
}

return (WorldGuardPlugin) plugin; 
} 

在较新的Worldguard（我说版本）内，你可以使用Static方式 
列子：使用WGbukkit取读Worldguard 

import com.sk89q.worldguard.bukkit.WGBukkit; 

// 现在你需要取读Worldguard 
// 例如, 集合所有的region到一个点 
ApplicableRegionSet set = WGBukkit.getRegionManager(world).getApplicableRegions(location); 

===基础权限===

你成功取读/访问Worldguard后，你可以设定例如“can build?”就是“是否可建筑”在WorldGuardPlugin内查看 

boolean canBuild(org.bukkit.entity.Player player, org.bukkit.Location location) 

boolean canBuild(org.bukkit.entity.Player player, org.bukkit.block.Block block) 

列子 
玩家是否可以破坏脚下的方块 
<div>return getWorldGuard().canBuild(player,</div><div> player.getLocation().getBlock().getRelative(0, -1, 0));</div> 
===区域管理===
Worldguard可以直接查询全局设定，也可以在指定世界查询单独region，为了方便开发人员取读API，在WorldGuardPlugin内设定成这样即可访问单独region设定。 

com.sk89q.worldguard.protection.manager.RegionManager getRegionManager(org.bukkit.World world) 

Warning/注意: 这个方式可以设定为 can return null, 在指定世界关闭. 
列子 

return getWorldGuard().getRegionManager(world); 

获取Flags或build/破坏信息，你需要使用ApplicableRegionSet，设置完后可以转换玩家资料使用LocalPlayer，坐标使用Vector。 

还是看列子吧我难以表达： 

使用ApplicableRegionSet查询破坏权限 

<blockquote>import com.sk89q.worldguard.protection.managers.RegionManager; 
====查看Flags====

Flags都保存在com.sk89q.worldguard.protection.flags.DefaultFlag，你不可以直接添加自定义flag，你需要先到ApplicableRegionSet，使用正确的method设定，还得看flag的类型 

如果是StateFlag 使用 

boolean allows(StateFlag flag, LocalPlayer player) 

如果是StateFlag，where you can't pass a player, 使用（待翻译） 

boolean allows(StateFlag flag) 

如果是其他的Flag,使用 

mixed getFlag(Flag flag) 

检查Pvp的Flag 

return set.allows(DefaultFlag.PVP); 

DefaultFlag的一部分内容 

// ... 
public static final StateFlag PVP = new StateFlag("pvp", 'p', true); 
public static final StateFlag TNT = new StateFlag("tnt", 't', true); 
// ... 
====取读一个区域====

region保存在com.sk89q.worldguard.protection.regions.ProtectedRegion，有很多种子class可以设定，例如ProtectedCuboidRegion或ProtectedPolygonalRegion。 
如果想通过region的名称取读这个region，可以使用RegionManager 

ProtectedRegion getRegion(String id) 

如果想通过区域/Area取读region，可以使用ApplicableRegionSet 

for (ProtectedRegion region : set) { 
// region here 
} 

设定一个Flag，使用 

region.setFlag(flag, flag.parseInput(plugin, sender, value)) 

如果这个flag是复制于com.sk89q.worldguard.protection.flags.DefaultFlag，那么使用 

? parseInput(WorldGuardPlugin plugin, CommandSender sender, String input) 
===Javadocs===

查看[http://docs.sk89q.com/worldguard/apidocs/com/sk89q/worldguard/bukkit/WGBukkit.html Javadocs]

==数据格式==

'''Region数据都保存在regions.txt内. 打开后首先会有:'''

Region ID 
Region 类型(type) 

Worldguard3.0版本以下的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 
Priority 优先权（请勿设定为0） 
List of owners 拥有者列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 

Worldguard3.0版本以上的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 

Priority 优先权（请勿设定为0） 
ID of parent region 父regionID（设置过子region才会显示） 
List of owners 拥有者列表 
List of members 会员列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 
Exit message （退出region提示信息） 

拥有者以及会员数据保存方式: 
u: 玩家名称 
g: region权限组 

例如 
u:sk89q,u:tetsu,g:admins 

意思就是sk89q以及tetsu这两个玩家都在admins组内。

Flags数据保存方式: 
每一个flag都会有一个特殊的字母，例如Build就是b，通过一个+或者-我们能够查看这个flag的状态 
+就是启动 
-就是关闭/禁止 
如果没有+或- 那么代表这个flag默认就是启动的 
例如 
+bpmc-t-l-f-F 

{| class="wikitable"
|-
! Flag 名称 !! 代表字母
|-
| Passthrough || z
|-
| Build || b
|-
| PvP || p
|-
| Mob damage || m
|-
| Creeper explosion || c
|-
| TNT || t
|-
| Flint and steel || l
|-
| Fire spread || f
|-
| Lava fire spread || F
|}

=黑名单(Blacklist)=
worldguard黑名单可以指定玩家进行某些动作时的处理方法

比如：
阻止玩家挖掉金矿石。
当有人挖掘钻石块时通知在线管理员。
当玩家放置附魔台时，向放置者发送一条提示消息。

下面是一个黑名单的例子：

除admins,mods组以外禁止使用岩浆桶并向使用者发送自定义提示消息 
[lavabucket] 
ignore-groups=admins,mods 
on-use=deny,tell 
message=不可以使用岩浆桶呢喵！ 

禁止挖掉铁矿和金矿并提示默认消息同时通知在线管理员 
[goldore,ironore] 
ignore-groups=admins 
on-break=deny,tell,notify 

除admins组外禁止放置tnt 放置时会通知管理员并且踢出去 
[tnt] 
ignore-groups=admins 
on-place=deny,notify,kick 

黑名单配置文件

黑名单的配置文件保存在plugins\WorldGuard\worlds下面，每个世界都有单独的配置文件 
例子：

worlds/world/blacklist.txt 主世界 
worlds/world_the_end/blacklist.txt 末地 
worlds/mining_world/blacklist.txt 资源世界（如果服务器有多世界的话） 

提示
worldguard不支持多个世界共用同一个黑名单配置文件，但是你可以利用文件系统的“链接”实现。 
注意：编辑黑名单后需要用/wg reload重新加载才能生效 

格式： 

[物品或方块列表] 
事件=操作 
选项=值 

匹配规则： 

物品/方块列表可以填写数字id或bukkit的材料名（可参考 https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html） 
多个项目之间用半角逗号分隔 
[wood,brick,glass] 
还可以指定数据值如白桦木： 
[17:1] 
白桦木和丛林木： 
[17:1;3] 
指定数据值范围 
[wood:2-3] 
[wood:>=2,<=3] 
这些写法是可以混合使用的 
[wood:0;>=2,grass:1-2] 

事件：
{| class="wikitable"
|-
! Event !! Explanation
|-
| on-break || 破坏方块
|-
| on-destroy-with || 用此物品打破方块
|-
| on-place || 放置方块
|-
| on-use || 使用
|-
| on-interact || 交互，如右键门、拉杆、箱子等
|-
| on-drop || 丢弃特定物品
|-
| on-acquire || 获得物品
|-
| on-dispense || 针对发射器，发射特定物品
|-
|}

操作：
{| class="wikitable"
|-
! Action !! Explanation
|-
| deny || 阻止操作（黑名单模式）
|-
| allow || 允许操作（仅白名单模式）
|-
| notify || 发送通知消息给有worldguard.notify权限的人
|-
| log || 记录日志到终端、日志文件、数据库。
|-
| tell || 给玩家一个提示消息
|-
| kick || 踢出玩家
|-
| ban || 将玩家ban掉（永久性）
|-
|}

选项：
{| class="wikitable"
|-
! Option !! Explanation
|-
| ignore-groups || 忽略特定权限组，多个组用半角逗号分隔
|-
| ignore-perms || 忽略有特定权限的玩家，多个权限同样是用逗号分隔
|-
| comment || 自定义通知消息
|-
| message || 自定义tell的消息，可用%s表示相应物品名
|}

另外一个列子

放置和打破信标时通知在线管理员 
[beacon] 
on-break=notify 
on-place=notify 
阻止用钻石镐和金铲子破坏方块 
[diamond_pickaxe,284] 
on-destroy-with=tell,deny 
阻止使用铁锄、钻石剑耕地和攻击 
[iron_hoe,276] 
on-use=tell,deny 
阻止与箱子、石头按钮交互 
[chest,stone_button] 
on-interact=deny,tell 
阻止丢出命令方块 
[commandblock] 
on-drop=deny,tell 
message=不要乱丢命令方块～ 
除admins组外阻止获得基岩 
[bedrock] 
on-acquire=deny 
ignore-groups=admins 
阻止发射器发射岩浆桶和漏斗矿车 
[lavabucket,hopper_minecart] 
on-dispense=deny,log,notify 
[tnt] 
on-break=deny,notify,kick 
on-use=deny,notify,kick 
on-place=deny,ban 
on-acquire=deny 

日志
日志有三种选择
* 输出到终端（就是服务器后台）
* 记录日志到文件
* 记录到数据库

在worldguard配置文件（plugins\WorldGuard\config.yml）中可以对日志文件和数据库进行具体设置。

blacklist: 
use-as-whitelist: false 
logging: 
console: 
enable: true 
database: 
enable: false 
dsn: jdbc:mysql://localhost:3306/minecraft 
user: root 
pass: '' 
table: blacklist_events 
file: 
enable: false 
path: worldguard/logs/%Y-%m-%d.log 
open-files: 10 

日志文件的路径中可使用以下“变量”： 
%Y 年 (YYYY) 
%m 月 (MM) 
%d 日 (DD) 
%W 周 (00-52) 
%H 小时（24小时） (HH) 
%h 小时（12小时） (HH) 
%i 分 (mm) 
%s 秒 (ss) 
%u 用户名 
%% 表示“%”符号 

数据库 
worldguard可以将日志记录进mysql数据库，但需要先创建数据库和表，你可以使用下面的语句创建专用的表 

CREATE TABLE IF NOT EXISTS `blacklist_events` ( 
`id` int(11) NOT NULL AUTO_INCREMENT, 
`world` varchar(10) NOT NULL, 
`event` varchar(25) NOT NULL, 
`player` varchar(16) NOT NULL, 
`x` int(11) NOT NULL, 
`y` int(11) NOT NULL, 
`z` int(11) NOT NULL, 
`item` int(11) NOT NULL, 
`time` int(11) NOT NULL, 
`comment` varchar(255) DEFAULT NULL, 
PRIMARY KEY (`id`) 
); 

最后说一下，使用时发现，日志文件功能在某些平台下可能无法正常工作，同时会导致黑名单失效，开启此功能时请务必进行测试。
发射器的部分可能会和其他插件的发射器黑名单冲突导致报错。

=箱子保护=
WorldGuard提供基础的箱子保护服务，
玩家可以通过在箱子下方放置特殊字符的牌子来达到保护的目的。
我们不建议新设置的WorldGuard使用本功能因为本功能并不是WorldGuard常用的一部分
除此以外，区域设置是比本功能更好的保护拥有者财产的方法。
因为它不涉及像漏斗一类方块的问题。

提示：如果你是希望保护单块的方块，箱子等，
我们建议使用第三方保护插件。
例如Lockette 或者 LWC.

启用此功能：
首先箱子保护功能必须在配置文件中启用。
如果没有手动启用，箱子保护功能不会自动工作
这时不能使用牌子锁功能。(此项功能也可在配置文件中禁用)

使用方法：
# 必须是一个信息牌
# 必须位于箱子下面(如果是大箱子，只需在其一侧下面)
# 在第一行输入[Lock]
# 在第二行输入玩家的名字
# 在剩余两行写上其他允许使用玩家的名字
注：不可将其他玩家名字放在第二行的位置
提示：WorldGuard功能并不支持UUID功能
警告：由于Minecraft1.8版本的改变
从旧版本升级将会破坏掉所有的保护牌子
实际上它将破坏全部写有[]的牌子

=主机密码（登录密码）=
在过去由于Minecraft的登录代码问题，玩家可以登录到服务器的任何玩家包括拥有者和管理者的账号上，
在2010-2013年间，有五次利用该性质的漏洞经常导致成千上万的服务器被黑客攻击。

这项登录密码功能作为一个额外的登录屏障被添加到WorldGuard中。
其工作原理是作为一项额外的屏障来达到此功能，与Mojang的登录无关。
在登录时必须发送指定信息 (通俗的说就是输入你的密码)才能登录服务器。
即使攻击者有能力破坏Minecraft的登录系统来成为一个管理员。
但因在服务器缺少发送指定的信息，经服务器检测后无法活动。
注：这种登录验证方式的漏洞是很不明显的，很少见的。

启用功能：
当一个玩家通过某一个地址连接服务器时,输入play.example.com
Minecraft将会告诉服务器该玩家通过这个地址登录
管理者可以通过一个特殊的秘密语句来登录，
比如secretmod.play.example.com这个地址
服务器将会检测到该管理者登录使用的这个地址。
也就是一个类似密码的机制，不过密码是地址格式。

主机密码允许特定玩家使用特定地址登录，
如果地址错误，他将立即被踢下线

配置：

host-keys:
your_username: bagels.play.example.com
moderator1_name: manoverboard.play.example.com
提示:主机密码功能暂不支持UUID功能

DNS配置:
为了使此功能工作，你需要bagels.play.example.com 和 manoverboard.play.example.com 指向你的服务
然而不要在您使用的域名中添加域名的记录，因为很容易使得攻击者找出管理员域名从而登录。

相比之下，我们建议您安装通用地址-“wildcard addresses.”。例如设置了play.example.com，
这将意味着任何相同前缀会允许登录。（例如aa.play.example.com，ab.play.example.com，ac.play.example.com，等）。
提示：如果你没有一个域名或不能设置通配符地址，你可以使用xip.io。

=更多帮助=

你需要更多的帮助吗？我建议你 

你可以去[http://skq.me/irc/irc.esper.net/sk-dev/ IRC]提问 
注*IRC聊天频道是维基百科24小时开放的“聊天室” 

你可以在Twitter上联系[https://twitter.com/sk89q sk89q] 
sk89q是Worldguard的作者（也是Worldedit以及其他不少插件的作者） 

你可以查看[https://github.com/sk89q/worldguard/commits Changelog]（全英文，英文不好的直接跳过吧） 
Changelog就是更新信息（每次更新修改/增加/删除等等了什么） 

你如果有什么建议，或者发现了什么Bug可以到[http://youtrack.sk89q.com/issues?q=project%3A+WorldGuard 这里]反馈（全英文，英文不好的直接跳过吧）

WorldGuard

2015-12-17T19:19:35Z

Lichi2050：/* 取读WorldGuard */

Mcbbs发布贴http://www.mcbbs.net/thread-505810-1-1.html
='''配设文件'''=
='''指令介绍'''=
==Region指令==
===定义和重定义区域（define和redifine）===

/region define 区域名称 (玩家1) (玩家2) （玩家...） 
/region def 区域名称 (玩家1) (玩家2) （玩家...） 
/region d 区域名称 (玩家1) (玩家2) （玩家...） 
（）内容为可选项，如果没有指定玩家，定义后的区域将会属于输入命令的玩家（可以设定多个拥有者） 

这个指令主要是创造区域，创造后才可以进行更多的设定，这个指令是没有限制区域大小的（根据WorldEdit选择的大小） 
玩家部分也可以设定为权限组，这个指令主要是给管理员使用，玩家会有另外一个指令 /claim 

/region define 区域名称 g:权限组名称玩家1 玩家2 
'''注*整个世界区域叫做 __global__'''

/region redefine 区域名称 
/region update 区域名称 
/region move 区域名称 

这个指令会重定义已定义区域，选择好新区域后，输入指令后就可以重定义指定区域 

===区域圈地（claim）===

/region claim 区域名称 (玩家1) (玩家2) (玩家...) 

'''注意！'''这个指令是在2010年11至12月出现的，是很早期的指令，比Bukkit都早，在不久的将来会受到改善！ 
这个指令和define指令非常相似，但是加入了一些其他设定 

如果配设内有启动claim功能，玩家将会被限制区域数量 
创造新区域时不可以重复区域名称，除非你是拥有者，那么就会重定义该区域 
新区域不可覆盖其他区域 
如果配设内有启动claim功能，重新新区域时可以覆盖玩家拥有的其他区域 
如果配设内有启动claim功能，玩家将会被限制区域大小 

===区域信息（information）===

/region info （-s）（世界名称）（区域名称） 

列出区域的详细信息，内含 

区域名称（区域类型，优先权） 
区域flags 
区域拥有者 
区域成员 
区域边界 

空的信息项不会显示 
在指令内加入-s 会在显示信息的同时选择该区域 
如果没有输入区域名称，插件会自动取读脚下的区域 

'''列子：查看“TownPlot”区域的信息'''
/region info townplot 

'''列子：查看地狱世界“TownPlot”区域的信息'''
/region info world_nether TownPlot 
 

===区域选择（select）===

/region select [区域名称] 
这个指令会选择区域 
如果没有输入区域名称，插件会自动取读脚下的区域 

'''列子：选择“TownPlot”区域'''
/region select townplot 

===区域表列（list）===

区域表列（list） 

/region list （页数）（-w 世界名称）（-p 玩家） 

'''列子：列出第一页区域列表'''
/region list 

'''列子：列出地狱世界第三页区域列表'''
/region list 3 -w world_nether 

同时也可以只显示"玩家"的区域，影藏其他区域，需要在指令内加入-p 玩家 

'''列子：列出玩家1的区域列表'''
/region list -p 玩家1 

===设定flag===

/region flag 区域名称 flag （-g 权限组） [-w 世界名称] （数据值） 
这个指令可以为区域设定flag，如果（数据值）没有填的话，选择的flag就会被清除（还原） 
你们必须明白区域优先权和父子区域的关系才可以正确的设定flag，所以最好去查看flag列表 

'''列子：“TownPlot”区域禁止pvp的flag''' 
/region flag townplot pvp deny 

'''列子：在“duduworld”世界“TownPlot”区域禁止pvp的flag''' 
/region flag townplot pvp -w duduworld deny 

'''列子：“TownPlot”区域设定欢迎信息的flag''' 
/region flag townplot greeting 欢迎你来到这个区域, %name%! 
进入“TownPlot”区域显示：欢迎你来到这个区域, 玩家ID! 

'''列子：“TownPlot”区域清除退出信息的flag''' 
/region flag townplot farewell 
效果：退出“TownPlot”区域时不显示退出信息 

===设定优先权(priority)f===

/region setpriority [区域名称] （-w 世界名称） [优先权] 
/region priority [区域名称] （-w 世界名称） [优先权] 
/region pri [区域名称] （-w 世界名称） [优先权] 

设定区域优先权，[优先权]处得填一个整数，可以是正数也可以是负数。 

===设定子区域（parent）===

/region setparent [子区域] [父区域] 
/region parent [子区域] [父区域] 
/region par [子区域] [父区域] 

设定子区域。 

===删除区域（remove）===

/region remove [区域名称] （-w 世界名称） 
/region rem [区域名称] （-w 世界名称） 
/region delete [区域名称] （-w 世界名称） 
/region del [区域名称] （-w 世界名称） 

删除一个区域 

===区域传送（teleport）===

/region teleport (-s) [区域名称] 
/region tp (-s) [区域名称] 

传送到某个区域内，如果加入-s就会传送到区域设定的重生点。 

===区域管理（management）===

/region load （-w 世界名称） 
/region save （-w 世界名称） 

加载或者保存设定完的区域。 
'''注意！如果没保存加载时会丢失设定的项目，但WorldGuard的指令在修改完某项设定会自动保存。（通常不会出现这种情况）''' 

/region migratedb [1] [2] 
转移region文件yml格式到数据库MySQL，或者相反。 

=权限介绍=
=regions教程=
==基础教程==

开始前我们必须安装Worldedit配合WorldGuard才可以使用！ 
不熟悉/不知道[[WorldEdit|Worldedit]]？ 
以下教程内Worledit会简称为WE,Worldguard为WG。 

1.通过WE选择2点来确定一个立方体（于平时WE选择一样） 
扩大选择区域 
指令：
//expand <amount> [direction] 
//expand <amount> <reverse-amount> [direction] 
//expand vert 
效果：第一个：通过指定的方向扩大（东南西北上下） 
第二个：通过面向的方向扩大（东南西北） 
第三个：垂直方向扩展到基岩以及天空 
说明：对于指定的方向，用”N”(北),”S”(南),”W”(西),”E”(东),”U”(上),”D”(下)来代表方向(实际太阳升起的方向是南方。。即S，至于为什么我也不知道)。对于面向的方向，如果不出入WENS之类的就会默认为像面向的方向扩展。最后一个则是垂直方向上下完全扩展。 

用法：
//expand 扩大格数（数字）方向（N S W E U D） 
//expand 扩大格数反向扩大格数（可以不写） 
//expand vert 

2.创造region 
/region define <region_名称> 
或（更详细指令） 
/region define <region_名称> [拥有者1] [拥有者2] [拥有者3] (…….) 
创造这个region，创造一个region后，例如我们的就叫做Mcbbs，那么默认玩家就不能破坏这个region内的物品（其他设定稍后再说） 

3.添加成员/会员以及删除 

/region addmember <region_名称> [会员1] [会员2] [会员3] (…….) 
例如 
/region addmember Mcbbs Lichi2050 
意思就是在Mcbbs这个region内，玩家Lichi2050也就是我，可以破坏（默认没有修改破坏flag时都有效）。 

删除也是原理，只不过指令稍微改变了一下 
/region remember <region_名称> [会员1] [会员2] [会员3] (…….) 

4.添加拥有者以及删除 

/region addowner <region_名称> [拥有者1] [拥有者2] [拥有者3] (…….) 
例如 
/region addowner Mcbbs Lichi2050 
意思就是在Mcbbs这个region内，我Lichi2050是这个region的拥有者（可以设定/修改这个region的任何设置）。 

删除也是原理，只不过指令稍微改变了一下 
/region remowner <region_名称> [拥有者1] [拥有者2] [拥有者3] (…….) 

5.region优先权以及子区域 

/region setpriority <region_名称> <优先权> 
<优先权>是一个数字，他可以是正数例如3，也可以是负数例如-1 
数字越大，优先权就越大，例如region1的优先权是2，region2的优先权是5 那么region2的配设会取代/覆盖region1的设定（当然如果2个区域没有覆盖那么设不设定优先权都无所谓）。 

/region setparent <子_region_名称> <父_region_名称> 
首先我们得先了解什么是子区域，子区域有什么用处其实设定父子区域意思和继承差不多（使用权限组插件的朋友相信会很清楚） 
子region会取读父region的拥有者，会员，以及flag设定（就不用重复设定了，方便） 

==flag列表==
===区域权限组===

区域权限组为 
members 成员 
nonmembers 非成员 
owners 拥有者 
nonowners 非拥有者 
everyone 全部玩家 

注*如果直接修改regions.yml区域权限组有改动（全部变成大写并且everyone变成ALL）！ 

MEMBERS 成员 
NON_MEMBERS 非成员 
OWNERS 拥有者 
NON_OWNERS 非拥有者 
ALL 全部玩家 

区域权限组有什么用呢？在设定flag时可以专门只为一个权限组设定flag（别和权限组插件搞混了！！！） 
例如 
/rg flag <region_名称> exit deny 
/rg flag <region_名称> exit -g nonowners 
我们的region还是叫做Mcbbs 

首先第一个指令禁止了退出（出去）这个region 
下一个指令设定了-g nonowners 意思就是非拥有者玩家不可退出Mcbbs这个region 

或者你也可以设定例如只禁止什么人进入，又或者什么人进入后会无敌等等（看各自的脑洞吧） 

==开发者 API==
===取读WorldGuard=== 

一个参考的列子 

Example: Getting a reference to WorldGuard 
import com.sk89q.worldguard.bukkit.WorldGuardPlugin; 
import org.bukkit.plugin.Plugin; 

private WorldGuardPlugin getWorldGuard() { 
Plugin plugin = getServer().getPluginManager().getPlugin("WorldGuard"); 

// WorldGuard 没有加载 
if (plugin == null || !(plugin instanceof WorldGuardPlugin)) { 
return null; // 也许你想提示一个错误 
}

return (WorldGuardPlugin) plugin; 
} 

在较新的Worldguard（我说版本）内，你可以使用Static方式 
列子：使用WGbukkit取读Worldguard 

import com.sk89q.worldguard.bukkit.WGBukkit; 

// 现在你需要取读Worldguard 
// 例如, 集合所有的region到一个点 
ApplicableRegionSet set = WGBukkit.getRegionManager(world).getApplicableRegions(location); 

===基础权限===
===区域管理===
====查看Flags====
====取读一个区域====
===Javadocs===

查看[http://docs.sk89q.com/worldguard/apidocs/com/sk89q/worldguard/bukkit/WGBukkit.html Javadocs]

==数据格式==

'''Region数据都保存在regions.txt内. 打开后首先会有:'''

Region ID 
Region 类型(type) 

Worldguard3.0版本以下的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 
Priority 优先权（请勿设定为0） 
List of owners 拥有者列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 

Worldguard3.0版本以上的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 

Priority 优先权（请勿设定为0） 
ID of parent region 父regionID（设置过子region才会显示） 
List of owners 拥有者列表 
List of members 会员列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 
Exit message （退出region提示信息） 

拥有者以及会员数据保存方式: 
u: 玩家名称 
g: region权限组 

例如 
u:sk89q,u:tetsu,g:admins 

意思就是sk89q以及tetsu这两个玩家都在admins组内。

Flags数据保存方式: 
每一个flag都会有一个特殊的字母，例如Build就是b，通过一个+或者-我们能够查看这个flag的状态 
+就是启动 
-就是关闭/禁止 
如果没有+或- 那么代表这个flag默认就是启动的 
例如 
+bpmc-t-l-f-F 

{| class="wikitable"
|-
! Flag 名称 !! 代表字母
|-
| Passthrough || z
|-
| Build || b
|-
| PvP || p
|-
| Mob damage || m
|-
| Creeper explosion || c
|-
| TNT || t
|-
| Flint and steel || l
|-
| Fire spread || f
|-
| Lava fire spread || F
|}

=黑名单(Blacklist)=
worldguard黑名单可以指定玩家进行某些动作时的处理方法

比如：
阻止玩家挖掉金矿石。
当有人挖掘钻石块时通知在线管理员。
当玩家放置附魔台时，向放置者发送一条提示消息。

下面是一个黑名单的例子：

除admins,mods组以外禁止使用岩浆桶并向使用者发送自定义提示消息 
[lavabucket] 
ignore-groups=admins,mods 
on-use=deny,tell 
message=不可以使用岩浆桶呢喵！ 

禁止挖掉铁矿和金矿并提示默认消息同时通知在线管理员 
[goldore,ironore] 
ignore-groups=admins 
on-break=deny,tell,notify 

除admins组外禁止放置tnt 放置时会通知管理员并且踢出去 
[tnt] 
ignore-groups=admins 
on-place=deny,notify,kick 

黑名单配置文件

黑名单的配置文件保存在plugins\WorldGuard\worlds下面，每个世界都有单独的配置文件 
例子：

worlds/world/blacklist.txt 主世界 
worlds/world_the_end/blacklist.txt 末地 
worlds/mining_world/blacklist.txt 资源世界（如果服务器有多世界的话） 

提示
worldguard不支持多个世界共用同一个黑名单配置文件，但是你可以利用文件系统的“链接”实现。 
注意：编辑黑名单后需要用/wg reload重新加载才能生效 

格式： 

[物品或方块列表] 
事件=操作 
选项=值 

匹配规则： 

物品/方块列表可以填写数字id或bukkit的材料名（可参考 https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html） 
多个项目之间用半角逗号分隔 
[wood,brick,glass] 
还可以指定数据值如白桦木： 
[17:1] 
白桦木和丛林木： 
[17:1;3] 
指定数据值范围 
[wood:2-3] 
[wood:>=2,<=3] 
这些写法是可以混合使用的 
[wood:0;>=2,grass:1-2] 

事件：
{| class="wikitable"
|-
! Event !! Explanation
|-
| on-break || 破坏方块
|-
| on-destroy-with || 用此物品打破方块
|-
| on-place || 放置方块
|-
| on-use || 使用
|-
| on-interact || 交互，如右键门、拉杆、箱子等
|-
| on-drop || 丢弃特定物品
|-
| on-acquire || 获得物品
|-
| on-dispense || 针对发射器，发射特定物品
|-
|}

操作：
{| class="wikitable"
|-
! Action !! Explanation
|-
| deny || 阻止操作（黑名单模式）
|-
| allow || 允许操作（仅白名单模式）
|-
| notify || 发送通知消息给有worldguard.notify权限的人
|-
| log || 记录日志到终端、日志文件、数据库。
|-
| tell || 给玩家一个提示消息
|-
| kick || 踢出玩家
|-
| ban || 将玩家ban掉（永久性）
|-
|}

选项：
{| class="wikitable"
|-
! Option !! Explanation
|-
| ignore-groups || 忽略特定权限组，多个组用半角逗号分隔
|-
| ignore-perms || 忽略有特定权限的玩家，多个权限同样是用逗号分隔
|-
| comment || 自定义通知消息
|-
| message || 自定义tell的消息，可用%s表示相应物品名
|}

另外一个列子

放置和打破信标时通知在线管理员 
[beacon] 
on-break=notify 
on-place=notify 
阻止用钻石镐和金铲子破坏方块 
[diamond_pickaxe,284] 
on-destroy-with=tell,deny 
阻止使用铁锄、钻石剑耕地和攻击 
[iron_hoe,276] 
on-use=tell,deny 
阻止与箱子、石头按钮交互 
[chest,stone_button] 
on-interact=deny,tell 
阻止丢出命令方块 
[commandblock] 
on-drop=deny,tell 
message=不要乱丢命令方块～ 
除admins组外阻止获得基岩 
[bedrock] 
on-acquire=deny 
ignore-groups=admins 
阻止发射器发射岩浆桶和漏斗矿车 
[lavabucket,hopper_minecart] 
on-dispense=deny,log,notify 
[tnt] 
on-break=deny,notify,kick 
on-use=deny,notify,kick 
on-place=deny,ban 
on-acquire=deny 

日志
日志有三种选择
* 输出到终端（就是服务器后台）
* 记录日志到文件
* 记录到数据库

在worldguard配置文件（plugins\WorldGuard\config.yml）中可以对日志文件和数据库进行具体设置。

blacklist: 
use-as-whitelist: false 
logging: 
console: 
enable: true 
database: 
enable: false 
dsn: jdbc:mysql://localhost:3306/minecraft 
user: root 
pass: '' 
table: blacklist_events 
file: 
enable: false 
path: worldguard/logs/%Y-%m-%d.log 
open-files: 10 

日志文件的路径中可使用以下“变量”： 
%Y 年 (YYYY) 
%m 月 (MM) 
%d 日 (DD) 
%W 周 (00-52) 
%H 小时（24小时） (HH) 
%h 小时（12小时） (HH) 
%i 分 (mm) 
%s 秒 (ss) 
%u 用户名 
%% 表示“%”符号 

数据库 
worldguard可以将日志记录进mysql数据库，但需要先创建数据库和表，你可以使用下面的语句创建专用的表 

CREATE TABLE IF NOT EXISTS `blacklist_events` ( 
`id` int(11) NOT NULL AUTO_INCREMENT, 
`world` varchar(10) NOT NULL, 
`event` varchar(25) NOT NULL, 
`player` varchar(16) NOT NULL, 
`x` int(11) NOT NULL, 
`y` int(11) NOT NULL, 
`z` int(11) NOT NULL, 
`item` int(11) NOT NULL, 
`time` int(11) NOT NULL, 
`comment` varchar(255) DEFAULT NULL, 
PRIMARY KEY (`id`) 
); 

最后说一下，使用时发现，日志文件功能在某些平台下可能无法正常工作，同时会导致黑名单失效，开启此功能时请务必进行测试。
发射器的部分可能会和其他插件的发射器黑名单冲突导致报错。

=箱子保护=
WorldGuard提供基础的箱子保护服务，
玩家可以通过在箱子下方放置特殊字符的牌子来达到保护的目的。
我们不建议新设置的WorldGuard使用本功能因为本功能并不是WorldGuard常用的一部分
除此以外，区域设置是比本功能更好的保护拥有者财产的方法。
因为它不涉及像漏斗一类方块的问题。

提示：如果你是希望保护单块的方块，箱子等，
我们建议使用第三方保护插件。
例如Lockette 或者 LWC.

启用此功能：
首先箱子保护功能必须在配置文件中启用。
如果没有手动启用，箱子保护功能不会自动工作
这时不能使用牌子锁功能。(此项功能也可在配置文件中禁用)

使用方法：
# 必须是一个信息牌
# 必须位于箱子下面(如果是大箱子，只需在其一侧下面)
# 在第一行输入[Lock]
# 在第二行输入玩家的名字
# 在剩余两行写上其他允许使用玩家的名字
注：不可将其他玩家名字放在第二行的位置
提示：WorldGuard功能并不支持UUID功能
警告：由于Minecraft1.8版本的改变
从旧版本升级将会破坏掉所有的保护牌子
实际上它将破坏全部写有[]的牌子

=主机密码（登录密码）=
在过去由于Minecraft的登录代码问题，玩家可以登录到服务器的任何玩家包括拥有者和管理者的账号上，
在2010-2013年间，有五次利用该性质的漏洞经常导致成千上万的服务器被黑客攻击。

这项登录密码功能作为一个额外的登录屏障被添加到WorldGuard中。
其工作原理是作为一项额外的屏障来达到此功能，与Mojang的登录无关。
在登录时必须发送指定信息 (通俗的说就是输入你的密码)才能登录服务器。
即使攻击者有能力破坏Minecraft的登录系统来成为一个管理员。
但因在服务器缺少发送指定的信息，经服务器检测后无法活动。
注：这种登录验证方式的漏洞是很不明显的，很少见的。

启用功能：
当一个玩家通过某一个地址连接服务器时,输入play.example.com
Minecraft将会告诉服务器该玩家通过这个地址登录
管理者可以通过一个特殊的秘密语句来登录，
比如secretmod.play.example.com这个地址
服务器将会检测到该管理者登录使用的这个地址。
也就是一个类似密码的机制，不过密码是地址格式。

主机密码允许特定玩家使用特定地址登录，
如果地址错误，他将立即被踢下线

配置：

host-keys:
your_username: bagels.play.example.com
moderator1_name: manoverboard.play.example.com
提示:主机密码功能暂不支持UUID功能

DNS配置:
为了使此功能工作，你需要bagels.play.example.com 和 manoverboard.play.example.com 指向你的服务
然而不要在您使用的域名中添加域名的记录，因为很容易使得攻击者找出管理员域名从而登录。

相比之下，我们建议您安装通用地址-“wildcard addresses.”。例如设置了play.example.com，
这将意味着任何相同前缀会允许登录。（例如aa.play.example.com，ab.play.example.com，ac.play.example.com，等）。
提示：如果你没有一个域名或不能设置通配符地址，你可以使用xip.io。

=更多帮助=

你需要更多的帮助吗？我建议你 

你可以去[http://skq.me/irc/irc.esper.net/sk-dev/ IRC]提问 
注*IRC聊天频道是维基百科24小时开放的“聊天室” 

你可以在Twitter上联系[https://twitter.com/sk89q sk89q] 
sk89q是Worldguard的作者（也是Worldedit以及其他不少插件的作者） 

你可以查看[https://github.com/sk89q/worldguard/commits Changelog]（全英文，英文不好的直接跳过吧） 
Changelog就是更新信息（每次更新修改/增加/删除等等了什么） 

你如果有什么建议，或者发现了什么Bug可以到[http://youtrack.sk89q.com/issues?q=project%3A+WorldGuard 这里]反馈（全英文，英文不好的直接跳过吧）

用户讨论:Lichi2050

2015-10-26T12:07:48Z

Lichi2050：

== 用户讨论？ ==

这个页面是用来交流的，不需要放上自己的个人信息，在主页面写就好。 [[用户:Iwar|Re_]]（[[用户讨论:Iwar|讨论]]） 2015年10月25日 (日) 11:13 (HKT)

用户:Lichi2050

2015-10-21T18:31:50Z

Lichi2050：创建页面，内容为“Mcbbs个人资料： lichi2050 (UID: 265839) 基本资料 用户名 lichi2050 性别男 生日保密<br /...”

Mcbbs个人资料： 

lichi2050 (UID: 265839) 

基本资料 
用户名 lichi2050 
性别男 
生日保密 
PC正版用户名 Lichi2050 
PE正版用户名无 

联系方式 

QQ 1352633229 
Email 1352633229@qq.com 

妹子一声吼老鼠都吓怕！ 

帐号密码：123789456abcde7 ← 欢迎来盗

用户讨论:Lichi2050

2015-10-21T18:31:20Z

Lichi2050：

用户讨论:Lichi2050

2015-10-21T18:31:04Z

Lichi2050：

Mcbbs个人资料： 

lichi2050 (UID: 265839) 

基本资料
用户名 lichi2050 
性别男 
生日保密 
PC正版用户名 Lichi2050 
PE正版用户名无 

联系方式

QQ 1352633229 
Email 1352633229@qq.com 

妹子一声吼老鼠都吓怕！ 

帐号密码：123789456abcde7 ← 欢迎来盗

用户讨论:Lichi2050

2015-10-21T18:30:29Z

Lichi2050：创建页面，内容为“Mcbbs个人资料： lichi2050 (UID: 265839) 基本资料用户名 lichi2050 性别男生日保密 PC正版用户名 Lichi2050 PE...”

Mcbbs个人资料：

lichi2050 (UID: 265839)

基本资料
用户名 lichi2050
性别男
生日保密
PC正版用户名 Lichi2050
PE正版用户名无

联系方式

QQ 1352633229
Email 1352633229@qq.com

妹子一声吼老鼠都吓怕！

帐号密码：123789456abcde7 ← 欢迎来盗

WorldGuard

2015-10-21T18:26:10Z

Lichi2050：/* 区域权限组 */

Mcbbs发布贴http://www.mcbbs.net/thread-505810-1-1.html
='''配设文件'''=
='''指令介绍'''=
==Region指令==
===定义和重定义区域（define和redifine）===

/region define 区域名称 (玩家1) (玩家2) （玩家...） 
/region def 区域名称 (玩家1) (玩家2) （玩家...） 
/region d 区域名称 (玩家1) (玩家2) （玩家...） 
（）内容为可选项，如果没有指定玩家，定义后的区域将会属于输入命令的玩家（可以设定多个拥有者） 

这个指令主要是创造区域，创造后才可以进行更多的设定，这个指令是没有限制区域大小的（根据WorldEdit选择的大小） 
玩家部分也可以设定为权限组，这个指令主要是给管理员使用，玩家会有另外一个指令 /claim 

/region define 区域名称 g:权限组名称玩家1 玩家2 
'''注*整个世界区域叫做 __global__'''

/region redefine 区域名称 
/region update 区域名称 
/region move 区域名称 

这个指令会重定义已定义区域，选择好新区域后，输入指令后就可以重定义指定区域 

===区域圈地（claim）===

/region claim 区域名称 (玩家1) (玩家2) (玩家...) 

'''注意！'''这个指令是在2010年11至12月出现的，是很早期的指令，比Bukkit都早，在不久的将来会受到改善！ 
这个指令和define指令非常相似，但是加入了一些其他设定 

如果配设内有启动claim功能，玩家将会被限制区域数量 
创造新区域时不可以重复区域名称，除非你是拥有者，那么就会重定义该区域 
新区域不可覆盖其他区域 
如果配设内有启动claim功能，重新新区域时可以覆盖玩家拥有的其他区域 
如果配设内有启动claim功能，玩家将会被限制区域大小 

===区域信息（information）===

/region info （-s）（世界名称）（区域名称） 

列出区域的详细信息，内含 

区域名称（区域类型，优先权） 
区域flags 
区域拥有者 
区域成员 
区域边界 

空的信息项不会显示 
在指令内加入-s 会在显示信息的同时选择该区域 
如果没有输入区域名称，插件会自动取读脚下的区域 

'''列子：查看“TownPlot”区域的信息'''
/region info townplot 

'''列子：查看地狱世界“TownPlot”区域的信息'''
/region info world_nether TownPlot 
 

===区域选择（select）===

/region select [区域名称] 
这个指令会选择区域 
如果没有输入区域名称，插件会自动取读脚下的区域 

'''列子：选择“TownPlot”区域'''
/region select townplot 

===区域表列（list）===

区域表列（list） 

/region list （页数）（-w 世界名称）（-p 玩家） 

'''列子：列出第一页区域列表'''
/region list 

'''列子：列出地狱世界第三页区域列表'''
/region list 3 -w world_nether 

同时也可以只显示"玩家"的区域，影藏其他区域，需要在指令内加入-p 玩家 

'''列子：列出玩家1的区域列表'''
/region list -p 玩家1 

===设定flag===

/region flag 区域名称 flag （-g 权限组） [-w 世界名称] （数据值） 
这个指令可以为区域设定flag，如果（数据值）没有填的话，选择的flag就会被清除（还原） 
你们必须明白区域优先权和父子区域的关系才可以正确的设定flag，所以最好去查看flag列表 

'''列子：“TownPlot”区域禁止pvp的flag''' 
/region flag townplot pvp deny 

'''列子：在“duduworld”世界“TownPlot”区域禁止pvp的flag''' 
/region flag townplot pvp -w duduworld deny 

'''列子：“TownPlot”区域设定欢迎信息的flag''' 
/region flag townplot greeting 欢迎你来到这个区域, %name%! 
进入“TownPlot”区域显示：欢迎你来到这个区域, 玩家ID! 

'''列子：“TownPlot”区域清除退出信息的flag''' 
/region flag townplot farewell 
效果：退出“TownPlot”区域时不显示退出信息 

===设定优先权(priority)f===

/region setpriority [区域名称] （-w 世界名称） [优先权] 
/region priority [区域名称] （-w 世界名称） [优先权] 
/region pri [区域名称] （-w 世界名称） [优先权] 

设定区域优先权，[优先权]处得填一个整数，可以是正数也可以是负数。 

===设定子区域（parent）===

/region setparent [子区域] [父区域] 
/region parent [子区域] [父区域] 
/region par [子区域] [父区域] 

设定子区域。 

===删除区域（remove）===

/region remove [区域名称] （-w 世界名称） 
/region rem [区域名称] （-w 世界名称） 
/region delete [区域名称] （-w 世界名称） 
/region del [区域名称] （-w 世界名称） 

删除一个区域 

===区域传送（teleport）===

/region teleport (-s) [区域名称] 
/region tp (-s) [区域名称] 

传送到某个区域内，如果加入-s就会传送到区域设定的重生点。 

===区域管理（management）===

/region load （-w 世界名称） 
/region save （-w 世界名称） 

加载或者保存设定完的区域。 
'''注意！如果没保存加载时会丢失设定的项目，但WorldGuard的指令在修改完某项设定会自动保存。（通常不会出现这种情况）''' 

/region migratedb [1] [2] 
转移region文件yml格式到数据库MySQL，或者相反。 

=权限介绍=
=regions教程=
==基础教程==

开始前我们必须安装Worldedit配合WorldGuard才可以使用！ 
不熟悉/不知道[[WorldEdit|Worldedit]]？ 
以下教程内Worledit会简称为WE,Worldguard为WG。 

1.通过WE选择2点来确定一个立方体（于平时WE选择一样） 
扩大选择区域 
指令：
//expand <amount> [direction] 
//expand <amount> <reverse-amount> [direction] 
//expand vert 
效果：第一个：通过指定的方向扩大（东南西北上下） 
第二个：通过面向的方向扩大（东南西北） 
第三个：垂直方向扩展到基岩以及天空 
说明：对于指定的方向，用”N”(北),”S”(南),”W”(西),”E”(东),”U”(上),”D”(下)来代表方向(实际太阳升起的方向是南方。。即S，至于为什么我也不知道)。对于面向的方向，如果不出入WENS之类的就会默认为像面向的方向扩展。最后一个则是垂直方向上下完全扩展。 

用法：
//expand 扩大格数（数字）方向（N S W E U D） 
//expand 扩大格数反向扩大格数（可以不写） 
//expand vert 

2.创造region 
/region define <region_名称> 
或（更详细指令） 
/region define <region_名称> [拥有者1] [拥有者2] [拥有者3] (…….) 
创造这个region，创造一个region后，例如我们的就叫做Mcbbs，那么默认玩家就不能破坏这个region内的物品（其他设定稍后再说） 

3.添加成员/会员以及删除 

/region addmember <region_名称> [会员1] [会员2] [会员3] (…….) 
例如 
/region addmember Mcbbs Lichi2050 
意思就是在Mcbbs这个region内，玩家Lichi2050也就是我，可以破坏（默认没有修改破坏flag时都有效）。 

删除也是原理，只不过指令稍微改变了一下 
/region remember <region_名称> [会员1] [会员2] [会员3] (…….) 

4.添加拥有者以及删除 

/region addowner <region_名称> [拥有者1] [拥有者2] [拥有者3] (…….) 
例如 
/region addowner Mcbbs Lichi2050 
意思就是在Mcbbs这个region内，我Lichi2050是这个region的拥有者（可以设定/修改这个region的任何设置）。 

删除也是原理，只不过指令稍微改变了一下 
/region remowner <region_名称> [拥有者1] [拥有者2] [拥有者3] (…….) 

5.region优先权以及子区域 

/region setpriority <region_名称> <优先权> 
<优先权>是一个数字，他可以是正数例如3，也可以是负数例如-1 
数字越大，优先权就越大，例如region1的优先权是2，region2的优先权是5 那么region2的配设会取代/覆盖region1的设定（当然如果2个区域没有覆盖那么设不设定优先权都无所谓）。 

/region setparent <子_region_名称> <父_region_名称> 
首先我们得先了解什么是子区域，子区域有什么用处其实设定父子区域意思和继承差不多（使用权限组插件的朋友相信会很清楚） 
子region会取读父region的拥有者，会员，以及flag设定（就不用重复设定了，方便） 

==flag列表==
===区域权限组===

区域权限组为 
members 成员 
nonmembers 非成员 
owners 拥有者 
nonowners 非拥有者 
everyone 全部玩家 

注*如果直接修改regions.yml区域权限组有改动（全部变成大写并且everyone变成ALL）！ 

MEMBERS 成员 
NON_MEMBERS 非成员 
OWNERS 拥有者 
NON_OWNERS 非拥有者 
ALL 全部玩家 

区域权限组有什么用呢？在设定flag时可以专门只为一个权限组设定flag（别和权限组插件搞混了！！！） 
例如 
/rg flag <region_名称> exit deny 
/rg flag <region_名称> exit -g nonowners 
我们的region还是叫做Mcbbs 

首先第一个指令禁止了退出（出去）这个region 
下一个指令设定了-g nonowners 意思就是非拥有者玩家不可退出Mcbbs这个region 

或者你也可以设定例如只禁止什么人进入，又或者什么人进入后会无敌等等（看各自的脑洞吧） 

==开发者 API==
===取读WorldGuard===
===基础权限===
===区域管理===
====查看Flags====
====取读一个区域====
===Javadocs===

查看[http://docs.sk89q.com/worldguard/apidocs/com/sk89q/worldguard/bukkit/WGBukkit.html Javadocs]

==数据格式==

'''Region数据都保存在regions.txt内. 打开后首先会有:'''

Region ID 
Region 类型(type) 

Worldguard3.0版本以下的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 
Priority 优先权（请勿设定为0） 
List of owners 拥有者列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 

Worldguard3.0版本以上的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 

Priority 优先权（请勿设定为0） 
ID of parent region 父regionID（设置过子region才会显示） 
List of owners 拥有者列表 
List of members 会员列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 
Exit message （退出region提示信息） 

拥有者以及会员数据保存方式: 
u: 玩家名称 
g: region权限组 

例如 
u:sk89q,u:tetsu,g:admins 

意思就是sk89q以及tetsu这两个玩家都在admins组内。

Flags数据保存方式: 
每一个flag都会有一个特殊的字母，例如Build就是b，通过一个+或者-我们能够查看这个flag的状态 
+就是启动 
-就是关闭/禁止 
如果没有+或- 那么代表这个flag默认就是启动的 
例如 
+bpmc-t-l-f-F 

{| class="wikitable"
|-
! Flag 名称 !! 代表字母
|-
| Passthrough || z
|-
| Build || b
|-
| PvP || p
|-
| Mob damage || m
|-
| Creeper explosion || c
|-
| TNT || t
|-
| Flint and steel || l
|-
| Fire spread || f
|-
| Lava fire spread || F
|}

=黑名单(Blacklist)=
worldguard黑名单可以指定玩家进行某些动作时的处理方法

比如：
阻止玩家挖掉金矿石。
当有人挖掘钻石块时通知在线管理员。
当玩家放置附魔台时，向放置者发送一条提示消息。

下面是一个黑名单的例子：

除admins,mods组以外禁止使用岩浆桶并向使用者发送自定义提示消息 
[lavabucket] 
ignore-groups=admins,mods 
on-use=deny,tell 
message=不可以使用岩浆桶呢喵！ 

禁止挖掉铁矿和金矿并提示默认消息同时通知在线管理员 
[goldore,ironore] 
ignore-groups=admins 
on-break=deny,tell,notify 

除admins组外禁止放置tnt 放置时会通知管理员并且踢出去 
[tnt] 
ignore-groups=admins 
on-place=deny,notify,kick 

黑名单配置文件

黑名单的配置文件保存在plugins\WorldGuard\worlds下面，每个世界都有单独的配置文件 
例子：

worlds/world/blacklist.txt 主世界 
worlds/world_the_end/blacklist.txt 末地 
worlds/mining_world/blacklist.txt 资源世界（如果服务器有多世界的话） 

提示
worldguard不支持多个世界共用同一个黑名单配置文件，但是你可以利用文件系统的“链接”实现。 
注意：编辑黑名单后需要用/wg reload重新加载才能生效 

格式： 

[物品或方块列表] 
事件=操作 
选项=值 

匹配规则： 

物品/方块列表可以填写数字id或bukkit的材料名（可参考 https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html） 
多个项目之间用半角逗号分隔 
[wood,brick,glass] 
还可以指定数据值如白桦木： 
[17:1] 
白桦木和丛林木： 
[17:1;3] 
指定数据值范围 
[wood:2-3] 
[wood:>=2,<=3] 
这些写法是可以混合使用的 
[wood:0;>=2,grass:1-2] 

事件：
{| class="wikitable"
|-
! Event !! Explanation
|-
| on-break || 破坏方块
|-
| on-destroy-with || 用此物品打破方块
|-
| on-place || 放置方块
|-
| on-use || 使用
|-
| on-interact || 交互，如右键门、拉杆、箱子等
|-
| on-drop || 丢弃特定物品
|-
| on-acquire || 获得物品
|-
| on-dispense || 针对发射器，发射特定物品
|-
|}

操作：
{| class="wikitable"
|-
! Action !! Explanation
|-
| deny || 阻止操作（黑名单模式）
|-
| allow || 允许操作（仅白名单模式）
|-
| notify || 发送通知消息给有worldguard.notify权限的人
|-
| log || 记录日志到终端、日志文件、数据库。
|-
| tell || 给玩家一个提示消息
|-
| kick || 踢出玩家
|-
| ban || 将玩家ban掉（永久性）
|-
|}

选项：
{| class="wikitable"
|-
! Option !! Explanation
|-
| ignore-groups || 忽略特定权限组，多个组用半角逗号分隔
|-
| ignore-perms || 忽略有特定权限的玩家，多个权限同样是用逗号分隔
|-
| comment || 自定义通知消息
|-
| message || 自定义tell的消息，可用%s表示相应物品名
|}

另外一个列子

放置和打破信标时通知在线管理员 
[beacon] 
on-break=notify 
on-place=notify 
阻止用钻石镐和金铲子破坏方块 
[diamond_pickaxe,284] 
on-destroy-with=tell,deny 
阻止使用铁锄、钻石剑耕地和攻击 
[iron_hoe,276] 
on-use=tell,deny 
阻止与箱子、石头按钮交互 
[chest,stone_button] 
on-interact=deny,tell 
阻止丢出命令方块 
[commandblock] 
on-drop=deny,tell 
message=不要乱丢命令方块～ 
除admins组外阻止获得基岩 
[bedrock] 
on-acquire=deny 
ignore-groups=admins 
阻止发射器发射岩浆桶和漏斗矿车 
[lavabucket,hopper_minecart] 
on-dispense=deny,log,notify 
[tnt] 
on-break=deny,notify,kick 
on-use=deny,notify,kick 
on-place=deny,ban 
on-acquire=deny 

日志
日志有三种选择
* 输出到终端（就是服务器后台）
* 记录日志到文件
* 记录到数据库

在worldguard配置文件（plugins\WorldGuard\config.yml）中可以对日志文件和数据库进行具体设置。

blacklist: 
use-as-whitelist: false 
logging: 
console: 
enable: true 
database: 
enable: false 
dsn: jdbc:mysql://localhost:3306/minecraft 
user: root 
pass: '' 
table: blacklist_events 
file: 
enable: false 
path: worldguard/logs/%Y-%m-%d.log 
open-files: 10 

日志文件的路径中可使用以下“变量”： 
%Y 年 (YYYY) 
%m 月 (MM) 
%d 日 (DD) 
%W 周 (00-52) 
%H 小时（24小时） (HH) 
%h 小时（12小时） (HH) 
%i 分 (mm) 
%s 秒 (ss) 
%u 用户名 
%% 表示“%”符号 

数据库 
worldguard可以将日志记录进mysql数据库，但需要先创建数据库和表，你可以使用下面的语句创建专用的表 

CREATE TABLE IF NOT EXISTS `blacklist_events` ( 
`id` int(11) NOT NULL AUTO_INCREMENT, 
`world` varchar(10) NOT NULL, 
`event` varchar(25) NOT NULL, 
`player` varchar(16) NOT NULL, 
`x` int(11) NOT NULL, 
`y` int(11) NOT NULL, 
`z` int(11) NOT NULL, 
`item` int(11) NOT NULL, 
`time` int(11) NOT NULL, 
`comment` varchar(255) DEFAULT NULL, 
PRIMARY KEY (`id`) 
); 

最后说一下，使用时发现，日志文件功能在某些平台下可能无法正常工作，同时会导致黑名单失效，开启此功能时请务必进行测试。
发射器的部分可能会和其他插件的发射器黑名单冲突导致报错。

=箱子保护=
WorldGuard提供基础的箱子保护服务，
玩家可以通过在箱子下方放置特殊字符的牌子来达到保护的目的。
我们不建议新设置的WorldGuard使用本功能因为本功能并不是WorldGuard常用的一部分
除此以外，区域设置是比本功能更好的保护拥有者财产的方法。
因为它不涉及像漏斗一类方块的问题。

提示：如果你是希望保护单块的方块，箱子等，
我们建议使用第三方保护插件。
例如Lockette 或者 LWC.

启用此功能：
首先箱子保护功能必须在配置文件中启用。
如果没有手动启用，箱子保护功能不会自动工作
这时不能使用牌子锁功能。(此项功能也可在配置文件中禁用)

使用方法：
# 必须是一个信息牌
# 必须位于箱子下面(如果是大箱子，只需在其一侧下面)
# 在第一行输入[Lock]
# 在第二行输入玩家的名字
# 在剩余两行写上其他允许使用玩家的名字
注：不可将其他玩家名字放在第二行的位置
提示：WorldGuard功能并不支持UUID功能
警告：由于Minecraft1.8版本的改变
从旧版本升级将会破坏掉所有的保护牌子
实际上它将破坏全部写有[]的牌子

=主机密码（登录密码）=
在过去由于Minecraft的登录代码问题，玩家可以登录到服务器的任何玩家包括拥有者和管理者的账号上，
在2010-2013年间，有五次利用该性质的漏洞经常导致成千上万的服务器被黑客攻击。

这项登录密码功能作为一个额外的登录屏障被添加到WorldGuard中。
其工作原理是作为一项额外的屏障来达到此功能，与Mojang的登录无关。
在登录时必须发送指定信息 (通俗的说就是输入你的密码)才能登录服务器。
即使攻击者有能力破坏Minecraft的登录系统来成为一个管理员。
但因在服务器缺少发送指定的信息，经服务器检测后无法活动。
注：这种登录验证方式的漏洞是很不明显的，很少见的。

启用功能：
当一个玩家通过某一个地址连接服务器时,输入play.example.com
Minecraft将会告诉服务器该玩家通过这个地址登录
管理者可以通过一个特殊的秘密语句来登录，
比如secretmod.play.example.com这个地址
服务器将会检测到该管理者登录使用的这个地址。
也就是一个类似密码的机制，不过密码是地址格式。

主机密码允许特定玩家使用特定地址登录，
如果地址错误，他将立即被踢下线

配置：

host-keys:
your_username: bagels.play.example.com
moderator1_name: manoverboard.play.example.com
提示:主机密码功能暂不支持UUID功能

DNS配置:
为了使此功能工作，你需要bagels.play.example.com 和 manoverboard.play.example.com 指向你的服务
然而不要在您使用的域名中添加域名的记录，因为很容易使得攻击者找出管理员域名从而登录。

相比之下，我们建议您安装通用地址-“wildcard addresses.”。例如设置了play.example.com，
这将意味着任何相同前缀会允许登录。（例如aa.play.example.com，ab.play.example.com，ac.play.example.com，等）。
提示：如果你没有一个域名或不能设置通配符地址，你可以使用xip.io。

=更多帮助=

你需要更多的帮助吗？我建议你 

你可以去[http://skq.me/irc/irc.esper.net/sk-dev/ IRC]提问 
注*IRC聊天频道是维基百科24小时开放的“聊天室” 

你可以在Twitter上联系[https://twitter.com/sk89q sk89q] 
sk89q是Worldguard的作者（也是Worldedit以及其他不少插件的作者） 

你可以查看[https://github.com/sk89q/worldguard/commits Changelog]（全英文，英文不好的直接跳过吧） 
Changelog就是更新信息（每次更新修改/增加/删除等等了什么） 

你如果有什么建议，或者发现了什么Bug可以到[http://youtrack.sk89q.com/issues?q=project%3A+WorldGuard 这里]反馈（全英文，英文不好的直接跳过吧）

WorldGuard

2015-10-21T18:23:24Z

Lichi2050：/* 基础教程 */

Mcbbs发布贴http://www.mcbbs.net/thread-505810-1-1.html
='''配设文件'''=
='''指令介绍'''=
==Region指令==
===定义和重定义区域（define和redifine）===

/region define 区域名称 (玩家1) (玩家2) （玩家...） 
/region def 区域名称 (玩家1) (玩家2) （玩家...） 
/region d 区域名称 (玩家1) (玩家2) （玩家...） 
（）内容为可选项，如果没有指定玩家，定义后的区域将会属于输入命令的玩家（可以设定多个拥有者） 

这个指令主要是创造区域，创造后才可以进行更多的设定，这个指令是没有限制区域大小的（根据WorldEdit选择的大小） 
玩家部分也可以设定为权限组，这个指令主要是给管理员使用，玩家会有另外一个指令 /claim 

/region define 区域名称 g:权限组名称玩家1 玩家2 
'''注*整个世界区域叫做 __global__'''

/region redefine 区域名称 
/region update 区域名称 
/region move 区域名称 

这个指令会重定义已定义区域，选择好新区域后，输入指令后就可以重定义指定区域 

===区域圈地（claim）===

/region claim 区域名称 (玩家1) (玩家2) (玩家...) 

'''注意！'''这个指令是在2010年11至12月出现的，是很早期的指令，比Bukkit都早，在不久的将来会受到改善！ 
这个指令和define指令非常相似，但是加入了一些其他设定 

如果配设内有启动claim功能，玩家将会被限制区域数量 
创造新区域时不可以重复区域名称，除非你是拥有者，那么就会重定义该区域 
新区域不可覆盖其他区域 
如果配设内有启动claim功能，重新新区域时可以覆盖玩家拥有的其他区域 
如果配设内有启动claim功能，玩家将会被限制区域大小 

===区域信息（information）===

/region info （-s）（世界名称）（区域名称） 

列出区域的详细信息，内含 

区域名称（区域类型，优先权） 
区域flags 
区域拥有者 
区域成员 
区域边界 

空的信息项不会显示 
在指令内加入-s 会在显示信息的同时选择该区域 
如果没有输入区域名称，插件会自动取读脚下的区域 

'''列子：查看“TownPlot”区域的信息'''
/region info townplot 

'''列子：查看地狱世界“TownPlot”区域的信息'''
/region info world_nether TownPlot 
 

===区域选择（select）===

/region select [区域名称] 
这个指令会选择区域 
如果没有输入区域名称，插件会自动取读脚下的区域 

'''列子：选择“TownPlot”区域'''
/region select townplot 

===区域表列（list）===

区域表列（list） 

/region list （页数）（-w 世界名称）（-p 玩家） 

'''列子：列出第一页区域列表'''
/region list 

'''列子：列出地狱世界第三页区域列表'''
/region list 3 -w world_nether 

同时也可以只显示"玩家"的区域，影藏其他区域，需要在指令内加入-p 玩家 

'''列子：列出玩家1的区域列表'''
/region list -p 玩家1 

===设定flag===

/region flag 区域名称 flag （-g 权限组） [-w 世界名称] （数据值） 
这个指令可以为区域设定flag，如果（数据值）没有填的话，选择的flag就会被清除（还原） 
你们必须明白区域优先权和父子区域的关系才可以正确的设定flag，所以最好去查看flag列表 

'''列子：“TownPlot”区域禁止pvp的flag''' 
/region flag townplot pvp deny 

'''列子：在“duduworld”世界“TownPlot”区域禁止pvp的flag''' 
/region flag townplot pvp -w duduworld deny 

'''列子：“TownPlot”区域设定欢迎信息的flag''' 
/region flag townplot greeting 欢迎你来到这个区域, %name%! 
进入“TownPlot”区域显示：欢迎你来到这个区域, 玩家ID! 

'''列子：“TownPlot”区域清除退出信息的flag''' 
/region flag townplot farewell 
效果：退出“TownPlot”区域时不显示退出信息 

===设定优先权(priority)f===

/region setpriority [区域名称] （-w 世界名称） [优先权] 
/region priority [区域名称] （-w 世界名称） [优先权] 
/region pri [区域名称] （-w 世界名称） [优先权] 

设定区域优先权，[优先权]处得填一个整数，可以是正数也可以是负数。 

===设定子区域（parent）===

/region setparent [子区域] [父区域] 
/region parent [子区域] [父区域] 
/region par [子区域] [父区域] 

设定子区域。 

===删除区域（remove）===

/region remove [区域名称] （-w 世界名称） 
/region rem [区域名称] （-w 世界名称） 
/region delete [区域名称] （-w 世界名称） 
/region del [区域名称] （-w 世界名称） 

删除一个区域 

===区域传送（teleport）===

/region teleport (-s) [区域名称] 
/region tp (-s) [区域名称] 

传送到某个区域内，如果加入-s就会传送到区域设定的重生点。 

===区域管理（management）===

/region load （-w 世界名称） 
/region save （-w 世界名称） 

加载或者保存设定完的区域。 
'''注意！如果没保存加载时会丢失设定的项目，但WorldGuard的指令在修改完某项设定会自动保存。（通常不会出现这种情况）''' 

/region migratedb [1] [2] 
转移region文件yml格式到数据库MySQL，或者相反。 

=权限介绍=
=regions教程=
==基础教程==

开始前我们必须安装Worldedit配合WorldGuard才可以使用！ 
不熟悉/不知道[[WorldEdit|Worldedit]]？ 
以下教程内Worledit会简称为WE,Worldguard为WG。 

1.通过WE选择2点来确定一个立方体（于平时WE选择一样） 
扩大选择区域 
指令：
//expand <amount> [direction] 
//expand <amount> <reverse-amount> [direction] 
//expand vert 
效果：第一个：通过指定的方向扩大（东南西北上下） 
第二个：通过面向的方向扩大（东南西北） 
第三个：垂直方向扩展到基岩以及天空 
说明：对于指定的方向，用”N”(北),”S”(南),”W”(西),”E”(东),”U”(上),”D”(下)来代表方向(实际太阳升起的方向是南方。。即S，至于为什么我也不知道)。对于面向的方向，如果不出入WENS之类的就会默认为像面向的方向扩展。最后一个则是垂直方向上下完全扩展。 

用法：
//expand 扩大格数（数字）方向（N S W E U D） 
//expand 扩大格数反向扩大格数（可以不写） 
//expand vert 

2.创造region 
/region define <region_名称> 
或（更详细指令） 
/region define <region_名称> [拥有者1] [拥有者2] [拥有者3] (…….) 
创造这个region，创造一个region后，例如我们的就叫做Mcbbs，那么默认玩家就不能破坏这个region内的物品（其他设定稍后再说） 

3.添加成员/会员以及删除 

/region addmember <region_名称> [会员1] [会员2] [会员3] (…….) 
例如 
/region addmember Mcbbs Lichi2050 
意思就是在Mcbbs这个region内，玩家Lichi2050也就是我，可以破坏（默认没有修改破坏flag时都有效）。 

删除也是原理，只不过指令稍微改变了一下 
/region remember <region_名称> [会员1] [会员2] [会员3] (…….) 

4.添加拥有者以及删除 

/region addowner <region_名称> [拥有者1] [拥有者2] [拥有者3] (…….) 
例如 
/region addowner Mcbbs Lichi2050 
意思就是在Mcbbs这个region内，我Lichi2050是这个region的拥有者（可以设定/修改这个region的任何设置）。 

删除也是原理，只不过指令稍微改变了一下 
/region remowner <region_名称> [拥有者1] [拥有者2] [拥有者3] (…….) 

5.region优先权以及子区域 

/region setpriority <region_名称> <优先权> 
<优先权>是一个数字，他可以是正数例如3，也可以是负数例如-1 
数字越大，优先权就越大，例如region1的优先权是2，region2的优先权是5 那么region2的配设会取代/覆盖region1的设定（当然如果2个区域没有覆盖那么设不设定优先权都无所谓）。 

/region setparent <子_region_名称> <父_region_名称> 
首先我们得先了解什么是子区域，子区域有什么用处其实设定父子区域意思和继承差不多（使用权限组插件的朋友相信会很清楚） 
子region会取读父region的拥有者，会员，以及flag设定（就不用重复设定了，方便） 

==flag列表==
===区域权限组===
==开发者 API==
===取读WorldGuard===
===基础权限===
===区域管理===
====查看Flags====
====取读一个区域====
===Javadocs===

查看[http://docs.sk89q.com/worldguard/apidocs/com/sk89q/worldguard/bukkit/WGBukkit.html Javadocs]

==数据格式==

'''Region数据都保存在regions.txt内. 打开后首先会有:'''

Region ID 
Region 类型(type) 

Worldguard3.0版本以下的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 
Priority 优先权（请勿设定为0） 
List of owners 拥有者列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 

Worldguard3.0版本以上的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 

Priority 优先权（请勿设定为0） 
ID of parent region 父regionID（设置过子region才会显示） 
List of owners 拥有者列表 
List of members 会员列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 
Exit message （退出region提示信息） 

拥有者以及会员数据保存方式: 
u: 玩家名称 
g: region权限组 

例如 
u:sk89q,u:tetsu,g:admins 

意思就是sk89q以及tetsu这两个玩家都在admins组内。

Flags数据保存方式: 
每一个flag都会有一个特殊的字母，例如Build就是b，通过一个+或者-我们能够查看这个flag的状态 
+就是启动 
-就是关闭/禁止 
如果没有+或- 那么代表这个flag默认就是启动的 
例如 
+bpmc-t-l-f-F 

{| class="wikitable"
|-
! Flag 名称 !! 代表字母
|-
| Passthrough || z
|-
| Build || b
|-
| PvP || p
|-
| Mob damage || m
|-
| Creeper explosion || c
|-
| TNT || t
|-
| Flint and steel || l
|-
| Fire spread || f
|-
| Lava fire spread || F
|}

=黑名单(Blacklist)=
worldguard黑名单可以指定玩家进行某些动作时的处理方法

比如：
阻止玩家挖掉金矿石。
当有人挖掘钻石块时通知在线管理员。
当玩家放置附魔台时，向放置者发送一条提示消息。

下面是一个黑名单的例子：

除admins,mods组以外禁止使用岩浆桶并向使用者发送自定义提示消息 
[lavabucket] 
ignore-groups=admins,mods 
on-use=deny,tell 
message=不可以使用岩浆桶呢喵！ 

禁止挖掉铁矿和金矿并提示默认消息同时通知在线管理员 
[goldore,ironore] 
ignore-groups=admins 
on-break=deny,tell,notify 

除admins组外禁止放置tnt 放置时会通知管理员并且踢出去 
[tnt] 
ignore-groups=admins 
on-place=deny,notify,kick 

黑名单配置文件

黑名单的配置文件保存在plugins\WorldGuard\worlds下面，每个世界都有单独的配置文件 
例子：

worlds/world/blacklist.txt 主世界 
worlds/world_the_end/blacklist.txt 末地 
worlds/mining_world/blacklist.txt 资源世界（如果服务器有多世界的话） 

提示
worldguard不支持多个世界共用同一个黑名单配置文件，但是你可以利用文件系统的“链接”实现。 
注意：编辑黑名单后需要用/wg reload重新加载才能生效 

格式： 

[物品或方块列表] 
事件=操作 
选项=值 

匹配规则： 

物品/方块列表可以填写数字id或bukkit的材料名（可参考 https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html） 
多个项目之间用半角逗号分隔 
[wood,brick,glass] 
还可以指定数据值如白桦木： 
[17:1] 
白桦木和丛林木： 
[17:1;3] 
指定数据值范围 
[wood:2-3] 
[wood:>=2,<=3] 
这些写法是可以混合使用的 
[wood:0;>=2,grass:1-2] 

事件：
{| class="wikitable"
|-
! Event !! Explanation
|-
| on-break || 破坏方块
|-
| on-destroy-with || 用此物品打破方块
|-
| on-place || 放置方块
|-
| on-use || 使用
|-
| on-interact || 交互，如右键门、拉杆、箱子等
|-
| on-drop || 丢弃特定物品
|-
| on-acquire || 获得物品
|-
| on-dispense || 针对发射器，发射特定物品
|-
|}

操作：
{| class="wikitable"
|-
! Action !! Explanation
|-
| deny || 阻止操作（黑名单模式）
|-
| allow || 允许操作（仅白名单模式）
|-
| notify || 发送通知消息给有worldguard.notify权限的人
|-
| log || 记录日志到终端、日志文件、数据库。
|-
| tell || 给玩家一个提示消息
|-
| kick || 踢出玩家
|-
| ban || 将玩家ban掉（永久性）
|-
|}

选项：
{| class="wikitable"
|-
! Option !! Explanation
|-
| ignore-groups || 忽略特定权限组，多个组用半角逗号分隔
|-
| ignore-perms || 忽略有特定权限的玩家，多个权限同样是用逗号分隔
|-
| comment || 自定义通知消息
|-
| message || 自定义tell的消息，可用%s表示相应物品名
|}

另外一个列子

放置和打破信标时通知在线管理员 
[beacon] 
on-break=notify 
on-place=notify 
阻止用钻石镐和金铲子破坏方块 
[diamond_pickaxe,284] 
on-destroy-with=tell,deny 
阻止使用铁锄、钻石剑耕地和攻击 
[iron_hoe,276] 
on-use=tell,deny 
阻止与箱子、石头按钮交互 
[chest,stone_button] 
on-interact=deny,tell 
阻止丢出命令方块 
[commandblock] 
on-drop=deny,tell 
message=不要乱丢命令方块～ 
除admins组外阻止获得基岩 
[bedrock] 
on-acquire=deny 
ignore-groups=admins 
阻止发射器发射岩浆桶和漏斗矿车 
[lavabucket,hopper_minecart] 
on-dispense=deny,log,notify 
[tnt] 
on-break=deny,notify,kick 
on-use=deny,notify,kick 
on-place=deny,ban 
on-acquire=deny 

日志
日志有三种选择
* 输出到终端（就是服务器后台）
* 记录日志到文件
* 记录到数据库

在worldguard配置文件（plugins\WorldGuard\config.yml）中可以对日志文件和数据库进行具体设置。

blacklist: 
use-as-whitelist: false 
logging: 
console: 
enable: true 
database: 
enable: false 
dsn: jdbc:mysql://localhost:3306/minecraft 
user: root 
pass: '' 
table: blacklist_events 
file: 
enable: false 
path: worldguard/logs/%Y-%m-%d.log 
open-files: 10 

日志文件的路径中可使用以下“变量”： 
%Y 年 (YYYY) 
%m 月 (MM) 
%d 日 (DD) 
%W 周 (00-52) 
%H 小时（24小时） (HH) 
%h 小时（12小时） (HH) 
%i 分 (mm) 
%s 秒 (ss) 
%u 用户名 
%% 表示“%”符号 

数据库 
worldguard可以将日志记录进mysql数据库，但需要先创建数据库和表，你可以使用下面的语句创建专用的表 

CREATE TABLE IF NOT EXISTS `blacklist_events` ( 
`id` int(11) NOT NULL AUTO_INCREMENT, 
`world` varchar(10) NOT NULL, 
`event` varchar(25) NOT NULL, 
`player` varchar(16) NOT NULL, 
`x` int(11) NOT NULL, 
`y` int(11) NOT NULL, 
`z` int(11) NOT NULL, 
`item` int(11) NOT NULL, 
`time` int(11) NOT NULL, 
`comment` varchar(255) DEFAULT NULL, 
PRIMARY KEY (`id`) 
); 

最后说一下，使用时发现，日志文件功能在某些平台下可能无法正常工作，同时会导致黑名单失效，开启此功能时请务必进行测试。
发射器的部分可能会和其他插件的发射器黑名单冲突导致报错。

=箱子保护=
WorldGuard提供基础的箱子保护服务，
玩家可以通过在箱子下方放置特殊字符的牌子来达到保护的目的。
我们不建议新设置的WorldGuard使用本功能因为本功能并不是WorldGuard常用的一部分
除此以外，区域设置是比本功能更好的保护拥有者财产的方法。
因为它不涉及像漏斗一类方块的问题。

提示：如果你是希望保护单块的方块，箱子等，
我们建议使用第三方保护插件。
例如Lockette 或者 LWC.

启用此功能：
首先箱子保护功能必须在配置文件中启用。
如果没有手动启用，箱子保护功能不会自动工作
这时不能使用牌子锁功能。(此项功能也可在配置文件中禁用)

使用方法：
# 必须是一个信息牌
# 必须位于箱子下面(如果是大箱子，只需在其一侧下面)
# 在第一行输入[Lock]
# 在第二行输入玩家的名字
# 在剩余两行写上其他允许使用玩家的名字
注：不可将其他玩家名字放在第二行的位置
提示：WorldGuard功能并不支持UUID功能
警告：由于Minecraft1.8版本的改变
从旧版本升级将会破坏掉所有的保护牌子
实际上它将破坏全部写有[]的牌子

=主机密码（登录密码）=
在过去由于Minecraft的登录代码问题，玩家可以登录到服务器的任何玩家包括拥有者和管理者的账号上，
在2010-2013年间，有五次利用该性质的漏洞经常导致成千上万的服务器被黑客攻击。

这项登录密码功能作为一个额外的登录屏障被添加到WorldGuard中。
其工作原理是作为一项额外的屏障来达到此功能，与Mojang的登录无关。
在登录时必须发送指定信息 (通俗的说就是输入你的密码)才能登录服务器。
即使攻击者有能力破坏Minecraft的登录系统来成为一个管理员。
但因在服务器缺少发送指定的信息，经服务器检测后无法活动。
注：这种登录验证方式的漏洞是很不明显的，很少见的。

启用功能：
当一个玩家通过某一个地址连接服务器时,输入play.example.com
Minecraft将会告诉服务器该玩家通过这个地址登录
管理者可以通过一个特殊的秘密语句来登录，
比如secretmod.play.example.com这个地址
服务器将会检测到该管理者登录使用的这个地址。
也就是一个类似密码的机制，不过密码是地址格式。

主机密码允许特定玩家使用特定地址登录，
如果地址错误，他将立即被踢下线

配置：

host-keys:
your_username: bagels.play.example.com
moderator1_name: manoverboard.play.example.com
提示:主机密码功能暂不支持UUID功能

DNS配置:
为了使此功能工作，你需要bagels.play.example.com 和 manoverboard.play.example.com 指向你的服务
然而不要在您使用的域名中添加域名的记录，因为很容易使得攻击者找出管理员域名从而登录。

相比之下，我们建议您安装通用地址-“wildcard addresses.”。例如设置了play.example.com，
这将意味着任何相同前缀会允许登录。（例如aa.play.example.com，ab.play.example.com，ac.play.example.com，等）。
提示：如果你没有一个域名或不能设置通配符地址，你可以使用xip.io。

=更多帮助=

你需要更多的帮助吗？我建议你 

你可以去[http://skq.me/irc/irc.esper.net/sk-dev/ IRC]提问 
注*IRC聊天频道是维基百科24小时开放的“聊天室” 

你可以在Twitter上联系[https://twitter.com/sk89q sk89q] 
sk89q是Worldguard的作者（也是Worldedit以及其他不少插件的作者） 

你可以查看[https://github.com/sk89q/worldguard/commits Changelog]（全英文，英文不好的直接跳过吧） 
Changelog就是更新信息（每次更新修改/增加/删除等等了什么） 

你如果有什么建议，或者发现了什么Bug可以到[http://youtrack.sk89q.com/issues?q=project%3A+WorldGuard 这里]反馈（全英文，英文不好的直接跳过吧）

WorldGuard

2015-10-21T18:22:54Z

Lichi2050：/* 基础教程 */

Mcbbs发布贴http://www.mcbbs.net/thread-505810-1-1.html
='''配设文件'''=
='''指令介绍'''=
==Region指令==
===定义和重定义区域（define和redifine）===

/region define 区域名称 (玩家1) (玩家2) （玩家...） 
/region def 区域名称 (玩家1) (玩家2) （玩家...） 
/region d 区域名称 (玩家1) (玩家2) （玩家...） 
（）内容为可选项，如果没有指定玩家，定义后的区域将会属于输入命令的玩家（可以设定多个拥有者） 

这个指令主要是创造区域，创造后才可以进行更多的设定，这个指令是没有限制区域大小的（根据WorldEdit选择的大小） 
玩家部分也可以设定为权限组，这个指令主要是给管理员使用，玩家会有另外一个指令 /claim 

/region define 区域名称 g:权限组名称玩家1 玩家2 
'''注*整个世界区域叫做 __global__'''

/region redefine 区域名称 
/region update 区域名称 
/region move 区域名称 

这个指令会重定义已定义区域，选择好新区域后，输入指令后就可以重定义指定区域 

===区域圈地（claim）===

/region claim 区域名称 (玩家1) (玩家2) (玩家...) 

'''注意！'''这个指令是在2010年11至12月出现的，是很早期的指令，比Bukkit都早，在不久的将来会受到改善！ 
这个指令和define指令非常相似，但是加入了一些其他设定 

如果配设内有启动claim功能，玩家将会被限制区域数量 
创造新区域时不可以重复区域名称，除非你是拥有者，那么就会重定义该区域 
新区域不可覆盖其他区域 
如果配设内有启动claim功能，重新新区域时可以覆盖玩家拥有的其他区域 
如果配设内有启动claim功能，玩家将会被限制区域大小 

===区域信息（information）===

/region info （-s）（世界名称）（区域名称） 

列出区域的详细信息，内含 

区域名称（区域类型，优先权） 
区域flags 
区域拥有者 
区域成员 
区域边界 

空的信息项不会显示 
在指令内加入-s 会在显示信息的同时选择该区域 
如果没有输入区域名称，插件会自动取读脚下的区域 

'''列子：查看“TownPlot”区域的信息'''
/region info townplot 

'''列子：查看地狱世界“TownPlot”区域的信息'''
/region info world_nether TownPlot 
 

===区域选择（select）===

/region select [区域名称] 
这个指令会选择区域 
如果没有输入区域名称，插件会自动取读脚下的区域 

'''列子：选择“TownPlot”区域'''
/region select townplot 

===区域表列（list）===

区域表列（list） 

/region list （页数）（-w 世界名称）（-p 玩家） 

'''列子：列出第一页区域列表'''
/region list 

'''列子：列出地狱世界第三页区域列表'''
/region list 3 -w world_nether 

同时也可以只显示"玩家"的区域，影藏其他区域，需要在指令内加入-p 玩家 

'''列子：列出玩家1的区域列表'''
/region list -p 玩家1 

===设定flag===

/region flag 区域名称 flag （-g 权限组） [-w 世界名称] （数据值） 
这个指令可以为区域设定flag，如果（数据值）没有填的话，选择的flag就会被清除（还原） 
你们必须明白区域优先权和父子区域的关系才可以正确的设定flag，所以最好去查看flag列表 

'''列子：“TownPlot”区域禁止pvp的flag''' 
/region flag townplot pvp deny 

'''列子：在“duduworld”世界“TownPlot”区域禁止pvp的flag''' 
/region flag townplot pvp -w duduworld deny 

'''列子：“TownPlot”区域设定欢迎信息的flag''' 
/region flag townplot greeting 欢迎你来到这个区域, %name%! 
进入“TownPlot”区域显示：欢迎你来到这个区域, 玩家ID! 

'''列子：“TownPlot”区域清除退出信息的flag''' 
/region flag townplot farewell 
效果：退出“TownPlot”区域时不显示退出信息 

===设定优先权(priority)f===

/region setpriority [区域名称] （-w 世界名称） [优先权] 
/region priority [区域名称] （-w 世界名称） [优先权] 
/region pri [区域名称] （-w 世界名称） [优先权] 

设定区域优先权，[优先权]处得填一个整数，可以是正数也可以是负数。 

===设定子区域（parent）===

/region setparent [子区域] [父区域] 
/region parent [子区域] [父区域] 
/region par [子区域] [父区域] 

设定子区域。 

===删除区域（remove）===

/region remove [区域名称] （-w 世界名称） 
/region rem [区域名称] （-w 世界名称） 
/region delete [区域名称] （-w 世界名称） 
/region del [区域名称] （-w 世界名称） 

删除一个区域 

===区域传送（teleport）===

/region teleport (-s) [区域名称] 
/region tp (-s) [区域名称] 

传送到某个区域内，如果加入-s就会传送到区域设定的重生点。 

===区域管理（management）===

/region load （-w 世界名称） 
/region save （-w 世界名称） 

加载或者保存设定完的区域。 
'''注意！如果没保存加载时会丢失设定的项目，但WorldGuard的指令在修改完某项设定会自动保存。（通常不会出现这种情况）''' 

/region migratedb [1] [2] 
转移region文件yml格式到数据库MySQL，或者相反。 

=权限介绍=
=regions教程=
==基础教程==

开始前我们必须安装Worldedit配合WorldGuard才可以使用！ 
不熟悉/不知道[[WorldEdit|Worldedit]]？ 
以下教程内Worledit会简称为WE,Worldguard为WG。 

1.通过WE选择2点来确定一个立方体（于平时WE选择一样） 
扩大选择区域 
指令：//expand <amount> [direction] 
//expand <amount> <reverse-amount> [direction] 
//expand vert 
效果：第一个：通过指定的方向扩大（东南西北上下） 
第二个：通过面向的方向扩大（东南西北） 
第三个：垂直方向扩展到基岩以及天空 
说明：对于指定的方向，用”N”(北),”S”(南),”W”(西),”E”(东),”U”(上),”D”(下)来代表方向(实际太阳升起的方向是南方。。即S，至于为什么我也不知道)。对于面向的方向，如果不出入WENS之类的就会默认为像面向的方向扩展。最后一个则是垂直方向上下完全扩展。 

用法：//expand 扩大格数（数字）方向（N S W E U D） 
//expand 扩大格数反向扩大格数（可以不写） 
//expand vert 

2.创造region 
/region define <region_名称> 
或（更详细指令） 
/region define <region_名称> [拥有者1] [拥有者2] [拥有者3] (…….) 
创造这个region，创造一个region后，例如我们的就叫做Mcbbs，那么默认玩家就不能破坏这个region内的物品（其他设定稍后再说） 

3.添加成员/会员以及删除 

/region addmember <region_名称> [会员1] [会员2] [会员3] (…….) 
例如 
/region addmember Mcbbs Lichi2050 
意思就是在Mcbbs这个region内，玩家Lichi2050也就是我，可以破坏（默认没有修改破坏flag时都有效）。 

删除也是原理，只不过指令稍微改变了一下 
/region remember <region_名称> [会员1] [会员2] [会员3] (…….) 

4.添加拥有者以及删除 

/region addowner <region_名称> [拥有者1] [拥有者2] [拥有者3] (…….) 
例如 
/region addowner Mcbbs Lichi2050 
意思就是在Mcbbs这个region内，我Lichi2050是这个region的拥有者（可以设定/修改这个region的任何设置）。 

删除也是原理，只不过指令稍微改变了一下 
/region remowner <region_名称> [拥有者1] [拥有者2] [拥有者3] (…….) 

5.region优先权以及子区域 

/region setpriority <region_名称> <优先权> 
<优先权>是一个数字，他可以是正数例如3，也可以是负数例如-1 
数字越大，优先权就越大，例如region1的优先权是2，region2的优先权是5 那么region2的配设会取代/覆盖region1的设定（当然如果2个区域没有覆盖那么设不设定优先权都无所谓）。 

/region setparent <子_region_名称> <父_region_名称> 
首先我们得先了解什么是子区域，子区域有什么用处其实设定父子区域意思和继承差不多（使用权限组插件的朋友相信会很清楚） 
子region会取读父region的拥有者，会员，以及flag设定（就不用重复设定了，方便） 

==flag列表==
===区域权限组===
==开发者 API==
===取读WorldGuard===
===基础权限===
===区域管理===
====查看Flags====
====取读一个区域====
===Javadocs===

查看[http://docs.sk89q.com/worldguard/apidocs/com/sk89q/worldguard/bukkit/WGBukkit.html Javadocs]

==数据格式==

'''Region数据都保存在regions.txt内. 打开后首先会有:'''

Region ID 
Region 类型(type) 

Worldguard3.0版本以下的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 
Priority 优先权（请勿设定为0） 
List of owners 拥有者列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 

Worldguard3.0版本以上的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 

Priority 优先权（请勿设定为0） 
ID of parent region 父regionID（设置过子region才会显示） 
List of owners 拥有者列表 
List of members 会员列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 
Exit message （退出region提示信息） 

拥有者以及会员数据保存方式: 
u: 玩家名称 
g: region权限组 

例如 
u:sk89q,u:tetsu,g:admins 

意思就是sk89q以及tetsu这两个玩家都在admins组内。

Flags数据保存方式: 
每一个flag都会有一个特殊的字母，例如Build就是b，通过一个+或者-我们能够查看这个flag的状态 
+就是启动 
-就是关闭/禁止 
如果没有+或- 那么代表这个flag默认就是启动的 
例如 
+bpmc-t-l-f-F 

{| class="wikitable"
|-
! Flag 名称 !! 代表字母
|-
| Passthrough || z
|-
| Build || b
|-
| PvP || p
|-
| Mob damage || m
|-
| Creeper explosion || c
|-
| TNT || t
|-
| Flint and steel || l
|-
| Fire spread || f
|-
| Lava fire spread || F
|}

=黑名单(Blacklist)=
worldguard黑名单可以指定玩家进行某些动作时的处理方法

比如：
阻止玩家挖掉金矿石。
当有人挖掘钻石块时通知在线管理员。
当玩家放置附魔台时，向放置者发送一条提示消息。

下面是一个黑名单的例子：

除admins,mods组以外禁止使用岩浆桶并向使用者发送自定义提示消息 
[lavabucket] 
ignore-groups=admins,mods 
on-use=deny,tell 
message=不可以使用岩浆桶呢喵！ 

禁止挖掉铁矿和金矿并提示默认消息同时通知在线管理员 
[goldore,ironore] 
ignore-groups=admins 
on-break=deny,tell,notify 

除admins组外禁止放置tnt 放置时会通知管理员并且踢出去 
[tnt] 
ignore-groups=admins 
on-place=deny,notify,kick 

黑名单配置文件

黑名单的配置文件保存在plugins\WorldGuard\worlds下面，每个世界都有单独的配置文件 
例子：

worlds/world/blacklist.txt 主世界 
worlds/world_the_end/blacklist.txt 末地 
worlds/mining_world/blacklist.txt 资源世界（如果服务器有多世界的话） 

提示
worldguard不支持多个世界共用同一个黑名单配置文件，但是你可以利用文件系统的“链接”实现。 
注意：编辑黑名单后需要用/wg reload重新加载才能生效 

格式： 

[物品或方块列表] 
事件=操作 
选项=值 

匹配规则： 

物品/方块列表可以填写数字id或bukkit的材料名（可参考 https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html） 
多个项目之间用半角逗号分隔 
[wood,brick,glass] 
还可以指定数据值如白桦木： 
[17:1] 
白桦木和丛林木： 
[17:1;3] 
指定数据值范围 
[wood:2-3] 
[wood:>=2,<=3] 
这些写法是可以混合使用的 
[wood:0;>=2,grass:1-2] 

事件：
{| class="wikitable"
|-
! Event !! Explanation
|-
| on-break || 破坏方块
|-
| on-destroy-with || 用此物品打破方块
|-
| on-place || 放置方块
|-
| on-use || 使用
|-
| on-interact || 交互，如右键门、拉杆、箱子等
|-
| on-drop || 丢弃特定物品
|-
| on-acquire || 获得物品
|-
| on-dispense || 针对发射器，发射特定物品
|-
|}

操作：
{| class="wikitable"
|-
! Action !! Explanation
|-
| deny || 阻止操作（黑名单模式）
|-
| allow || 允许操作（仅白名单模式）
|-
| notify || 发送通知消息给有worldguard.notify权限的人
|-
| log || 记录日志到终端、日志文件、数据库。
|-
| tell || 给玩家一个提示消息
|-
| kick || 踢出玩家
|-
| ban || 将玩家ban掉（永久性）
|-
|}

选项：
{| class="wikitable"
|-
! Option !! Explanation
|-
| ignore-groups || 忽略特定权限组，多个组用半角逗号分隔
|-
| ignore-perms || 忽略有特定权限的玩家，多个权限同样是用逗号分隔
|-
| comment || 自定义通知消息
|-
| message || 自定义tell的消息，可用%s表示相应物品名
|}

另外一个列子

放置和打破信标时通知在线管理员 
[beacon] 
on-break=notify 
on-place=notify 
阻止用钻石镐和金铲子破坏方块 
[diamond_pickaxe,284] 
on-destroy-with=tell,deny 
阻止使用铁锄、钻石剑耕地和攻击 
[iron_hoe,276] 
on-use=tell,deny 
阻止与箱子、石头按钮交互 
[chest,stone_button] 
on-interact=deny,tell 
阻止丢出命令方块 
[commandblock] 
on-drop=deny,tell 
message=不要乱丢命令方块～ 
除admins组外阻止获得基岩 
[bedrock] 
on-acquire=deny 
ignore-groups=admins 
阻止发射器发射岩浆桶和漏斗矿车 
[lavabucket,hopper_minecart] 
on-dispense=deny,log,notify 
[tnt] 
on-break=deny,notify,kick 
on-use=deny,notify,kick 
on-place=deny,ban 
on-acquire=deny 

日志
日志有三种选择
* 输出到终端（就是服务器后台）
* 记录日志到文件
* 记录到数据库

在worldguard配置文件（plugins\WorldGuard\config.yml）中可以对日志文件和数据库进行具体设置。

blacklist: 
use-as-whitelist: false 
logging: 
console: 
enable: true 
database: 
enable: false 
dsn: jdbc:mysql://localhost:3306/minecraft 
user: root 
pass: '' 
table: blacklist_events 
file: 
enable: false 
path: worldguard/logs/%Y-%m-%d.log 
open-files: 10 

日志文件的路径中可使用以下“变量”： 
%Y 年 (YYYY) 
%m 月 (MM) 
%d 日 (DD) 
%W 周 (00-52) 
%H 小时（24小时） (HH) 
%h 小时（12小时） (HH) 
%i 分 (mm) 
%s 秒 (ss) 
%u 用户名 
%% 表示“%”符号 

数据库 
worldguard可以将日志记录进mysql数据库，但需要先创建数据库和表，你可以使用下面的语句创建专用的表 

CREATE TABLE IF NOT EXISTS `blacklist_events` ( 
`id` int(11) NOT NULL AUTO_INCREMENT, 
`world` varchar(10) NOT NULL, 
`event` varchar(25) NOT NULL, 
`player` varchar(16) NOT NULL, 
`x` int(11) NOT NULL, 
`y` int(11) NOT NULL, 
`z` int(11) NOT NULL, 
`item` int(11) NOT NULL, 
`time` int(11) NOT NULL, 
`comment` varchar(255) DEFAULT NULL, 
PRIMARY KEY (`id`) 
); 

最后说一下，使用时发现，日志文件功能在某些平台下可能无法正常工作，同时会导致黑名单失效，开启此功能时请务必进行测试。
发射器的部分可能会和其他插件的发射器黑名单冲突导致报错。

=箱子保护=
WorldGuard提供基础的箱子保护服务，
玩家可以通过在箱子下方放置特殊字符的牌子来达到保护的目的。
我们不建议新设置的WorldGuard使用本功能因为本功能并不是WorldGuard常用的一部分
除此以外，区域设置是比本功能更好的保护拥有者财产的方法。
因为它不涉及像漏斗一类方块的问题。

提示：如果你是希望保护单块的方块，箱子等，
我们建议使用第三方保护插件。
例如Lockette 或者 LWC.

启用此功能：
首先箱子保护功能必须在配置文件中启用。
如果没有手动启用，箱子保护功能不会自动工作
这时不能使用牌子锁功能。(此项功能也可在配置文件中禁用)

使用方法：
# 必须是一个信息牌
# 必须位于箱子下面(如果是大箱子，只需在其一侧下面)
# 在第一行输入[Lock]
# 在第二行输入玩家的名字
# 在剩余两行写上其他允许使用玩家的名字
注：不可将其他玩家名字放在第二行的位置
提示：WorldGuard功能并不支持UUID功能
警告：由于Minecraft1.8版本的改变
从旧版本升级将会破坏掉所有的保护牌子
实际上它将破坏全部写有[]的牌子

=主机密码（登录密码）=
在过去由于Minecraft的登录代码问题，玩家可以登录到服务器的任何玩家包括拥有者和管理者的账号上，
在2010-2013年间，有五次利用该性质的漏洞经常导致成千上万的服务器被黑客攻击。

这项登录密码功能作为一个额外的登录屏障被添加到WorldGuard中。
其工作原理是作为一项额外的屏障来达到此功能，与Mojang的登录无关。
在登录时必须发送指定信息 (通俗的说就是输入你的密码)才能登录服务器。
即使攻击者有能力破坏Minecraft的登录系统来成为一个管理员。
但因在服务器缺少发送指定的信息，经服务器检测后无法活动。
注：这种登录验证方式的漏洞是很不明显的，很少见的。

启用功能：
当一个玩家通过某一个地址连接服务器时,输入play.example.com
Minecraft将会告诉服务器该玩家通过这个地址登录
管理者可以通过一个特殊的秘密语句来登录，
比如secretmod.play.example.com这个地址
服务器将会检测到该管理者登录使用的这个地址。
也就是一个类似密码的机制，不过密码是地址格式。

主机密码允许特定玩家使用特定地址登录，
如果地址错误，他将立即被踢下线

配置：

host-keys:
your_username: bagels.play.example.com
moderator1_name: manoverboard.play.example.com
提示:主机密码功能暂不支持UUID功能

DNS配置:
为了使此功能工作，你需要bagels.play.example.com 和 manoverboard.play.example.com 指向你的服务
然而不要在您使用的域名中添加域名的记录，因为很容易使得攻击者找出管理员域名从而登录。

相比之下，我们建议您安装通用地址-“wildcard addresses.”。例如设置了play.example.com，
这将意味着任何相同前缀会允许登录。（例如aa.play.example.com，ab.play.example.com，ac.play.example.com，等）。
提示：如果你没有一个域名或不能设置通配符地址，你可以使用xip.io。

=更多帮助=

你需要更多的帮助吗？我建议你 

你可以去[http://skq.me/irc/irc.esper.net/sk-dev/ IRC]提问 
注*IRC聊天频道是维基百科24小时开放的“聊天室” 

你可以在Twitter上联系[https://twitter.com/sk89q sk89q] 
sk89q是Worldguard的作者（也是Worldedit以及其他不少插件的作者） 

你可以查看[https://github.com/sk89q/worldguard/commits Changelog]（全英文，英文不好的直接跳过吧） 
Changelog就是更新信息（每次更新修改/增加/删除等等了什么） 

你如果有什么建议，或者发现了什么Bug可以到[http://youtrack.sk89q.com/issues?q=project%3A+WorldGuard 这里]反馈（全英文，英文不好的直接跳过吧）

WorldGuard

2015-10-21T18:19:08Z

Lichi2050：/* 指令介绍 */

WorldGuard

2015-10-12T15:13:11Z

Lichi2050：/* 区域管理（management） */

Mcbbs发布贴http://www.mcbbs.net/thread-505810-1-1.html
='''配设文件'''=
=指令介绍=
==Region指令==
===定义和重定义区域（define和redifine）===

/region define 区域名称 (玩家1) (玩家2) （玩家...） 
/region def 区域名称 (玩家1) (玩家2) （玩家...） 
/region d 区域名称 (玩家1) (玩家2) （玩家...） 
（）内容为可选项，如果没有指定玩家，定义后的区域将会属于输入命令的玩家（可以设定多个拥有者） 

这个指令主要是创造区域，创造后才可以进行更多的设定，这个指令是没有限制区域大小的（根据WorldEdit选择的大小） 
玩家部分也可以设定为权限组，这个指令主要是给管理员使用，玩家会有另外一个指令 /claim 

/region define 区域名称 g:权限组名称玩家1 玩家2 
'''注*整个世界区域叫做 __global__'''

/region redefine 区域名称 
/region update 区域名称 
/region move 区域名称 

这个指令会重定义已定义区域，选择好新区域后，输入指令后就可以重定义指定区域 

===区域圈地（claim）===

/region claim 区域名称 (玩家1) (玩家2) (玩家...) 

'''注意！'''这个指令是在2010年11至12月出现的，是很早期的指令，比Bukkit都早，在不久的将来会受到改善！ 
这个指令和define指令非常相似，但是加入了一些其他设定 

如果配设内有启动claim功能，玩家将会被限制区域数量 
创造新区域时不可以重复区域名称，除非你是拥有者，那么就会重定义该区域 
新区域不可覆盖其他区域 
如果配设内有启动claim功能，重新新区域时可以覆盖玩家拥有的其他区域 
如果配设内有启动claim功能，玩家将会被限制区域大小 

===区域信息（information）===

/region info （-s）（世界名称）（区域名称） 

列出区域的详细信息，内含 

区域名称（区域类型，优先权） 
区域flags 
区域拥有者 
区域成员 
区域边界 

空的信息项不会显示 
在指令内加入-s 会在显示信息的同时选择该区域 
如果没有输入区域名称，插件会自动取读脚下的区域 

'''列子：查看“TownPlot”区域的信息'''
/region info townplot 

'''列子：查看地狱世界“TownPlot”区域的信息'''
/region info world_nether TownPlot 
 

===区域选择（select）===

/region select [区域名称] 
这个指令会选择区域 
如果没有输入区域名称，插件会自动取读脚下的区域 

'''列子：选择“TownPlot”区域'''
/region select townplot 

===区域表列（list）===

区域表列（list） 

/region list （页数）（-w 世界名称）（-p 玩家） 

'''列子：列出第一页区域列表'''
/region list 

'''列子：列出地狱世界第三页区域列表'''
/region list 3 -w world_nether 

同时也可以只显示"玩家"的区域，影藏其他区域，需要在指令内加入-p 玩家 

'''列子：列出玩家1的区域列表'''
/region list -p 玩家1 

===设定flag===

/region flag 区域名称 flag （-g 权限组） [-w 世界名称] （数据值） 
这个指令可以为区域设定flag，如果（数据值）没有填的话，选择的flag就会被清除（还原） 
你们必须明白区域优先权和父子区域的关系才可以正确的设定flag，所以最好去查看flag列表 

'''列子：“TownPlot”区域禁止pvp的flag''' 
/region flag townplot pvp deny 

'''列子：在“duduworld”世界“TownPlot”区域禁止pvp的flag''' 
/region flag townplot pvp -w duduworld deny 

'''列子：“TownPlot”区域设定欢迎信息的flag''' 
/region flag townplot greeting 欢迎你来到这个区域, %name%! 
进入“TownPlot”区域显示：欢迎你来到这个区域, 玩家ID! 

'''列子：“TownPlot”区域清除退出信息的flag''' 
/region flag townplot farewell 
效果：退出“TownPlot”区域时不显示退出信息 

===设定优先权(priority)f===

/region setpriority [区域名称] （-w 世界名称） [优先权] 
/region priority [区域名称] （-w 世界名称） [优先权] 
/region pri [区域名称] （-w 世界名称） [优先权] 

设定区域优先权，[优先权]处得填一个整数，可以是正数也可以是负数。 

===设定子区域（parent）===

/region setparent [子区域] [父区域] 
/region parent [子区域] [父区域] 
/region par [子区域] [父区域] 

设定子区域。 

===删除区域（remove）===

/region remove [区域名称] （-w 世界名称） 
/region rem [区域名称] （-w 世界名称） 
/region delete [区域名称] （-w 世界名称） 
/region del [区域名称] （-w 世界名称） 

删除一个区域 

===区域传送（teleport）===

/region teleport (-s) [区域名称] 
/region tp (-s) [区域名称] 

传送到某个区域内，如果加入-s就会传送到区域设定的重生点。 

===区域管理（management）===

/region load （-w 世界名称） 
/region save （-w 世界名称） 

加载或者保存设定完的区域。 
'''注意！如果没保存加载时会丢失设定的项目，但WorldGuard的指令在修改完某项设定会自动保存。（通常不会出现这种情况）''' 

/region migratedb [1] [2] 
转移region文件yml格式到数据库MySQL，或者相反。 

=权限介绍=
=regions教程=
==基础教程==
==flag列表==
===区域权限组===
==开发者 API==
===取读WorldGuard===
===基础权限===
===区域管理===
====查看Flags====
====取读一个区域====
===Javadocs===

查看[http://docs.sk89q.com/worldguard/apidocs/com/sk89q/worldguard/bukkit/WGBukkit.html Javadocs]

==数据格式==

'''Region数据都保存在regions.txt内. 打开后首先会有:'''

Region ID 
Region 类型(type) 

Worldguard3.0版本以下的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 
Priority 优先权（请勿设定为0） 
List of owners 拥有者列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 

Worldguard3.0版本以上的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 

Priority 优先权（请勿设定为0） 
ID of parent region 父regionID（设置过子region才会显示） 
List of owners 拥有者列表 
List of members 会员列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 
Exit message （退出region提示信息） 

拥有者以及会员数据保存方式: 
u: 玩家名称 
g: region权限组 

例如 
u:sk89q,u:tetsu,g:admins 

意思就是sk89q以及tetsu这两个玩家都在admins组内。

Flags数据保存方式: 
每一个flag都会有一个特殊的字母，例如Build就是b，通过一个+或者-我们能够查看这个flag的状态 
+就是启动 
-就是关闭/禁止 
如果没有+或- 那么代表这个flag默认就是启动的 
例如 
+bpmc-t-l-f-F 

{| class="wikitable"
|-
! Flag 名称 !! 代表字母
|-
| Passthrough || z
|-
| Build || b
|-
| PvP || p
|-
| Mob damage || m
|-
| Creeper explosion || c
|-
| TNT || t
|-
| Flint and steel || l
|-
| Fire spread || f
|-
| Lava fire spread || F
|}

=黑名单(Blacklist)=
worldguard黑名单可以指定玩家进行某些动作时的处理方法

比如：
阻止玩家挖掉金矿石。
当有人挖掘钻石块时通知在线管理员。
当玩家放置附魔台时，向放置者发送一条提示消息。

下面是一个黑名单的例子：

除admins,mods组以外禁止使用岩浆桶并向使用者发送自定义提示消息 
[lavabucket] 
ignore-groups=admins,mods 
on-use=deny,tell 
message=不可以使用岩浆桶呢喵！ 

禁止挖掉铁矿和金矿并提示默认消息同时通知在线管理员 
[goldore,ironore] 
ignore-groups=admins 
on-break=deny,tell,notify 

除admins组外禁止放置tnt 放置时会通知管理员并且踢出去 
[tnt] 
ignore-groups=admins 
on-place=deny,notify,kick 

黑名单配置文件

黑名单的配置文件保存在plugins\WorldGuard\worlds下面，每个世界都有单独的配置文件 
例子：

worlds/world/blacklist.txt 主世界 
worlds/world_the_end/blacklist.txt 末地 
worlds/mining_world/blacklist.txt 资源世界（如果服务器有多世界的话） 

提示
worldguard不支持多个世界共用同一个黑名单配置文件，但是你可以利用文件系统的“链接”实现。 
注意：编辑黑名单后需要用/wg reload重新加载才能生效 

格式： 

[物品或方块列表] 
事件=操作 
选项=值 

匹配规则： 

物品/方块列表可以填写数字id或bukkit的材料名（可参考 https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html） 
多个项目之间用半角逗号分隔 
[wood,brick,glass] 
还可以指定数据值如白桦木： 
[17:1] 
白桦木和丛林木： 
[17:1;3] 
指定数据值范围 
[wood:2-3] 
[wood:>=2,<=3] 
这些写法是可以混合使用的 
[wood:0;>=2,grass:1-2] 

事件：
{| class="wikitable"
|-
! Event !! Explanation
|-
| on-break || 破坏方块
|-
| on-destroy-with || 用此物品打破方块
|-
| on-place || 放置方块
|-
| on-use || 使用
|-
| on-interact || 交互，如右键门、拉杆、箱子等
|-
| on-drop || 丢弃特定物品
|-
| on-acquire || 获得物品
|-
| on-dispense || 针对发射器，发射特定物品
|-
|}

操作：
{| class="wikitable"
|-
! Action !! Explanation
|-
| deny || 阻止操作（黑名单模式）
|-
| allow || 允许操作（仅白名单模式）
|-
| notify || 发送通知消息给有worldguard.notify权限的人
|-
| log || 记录日志到终端、日志文件、数据库。
|-
| tell || 给玩家一个提示消息
|-
| kick || 踢出玩家
|-
| ban || 将玩家ban掉（永久性）
|-
|}

选项：
{| class="wikitable"
|-
! Option !! Explanation
|-
| ignore-groups || 忽略特定权限组，多个组用半角逗号分隔
|-
| ignore-perms || 忽略有特定权限的玩家，多个权限同样是用逗号分隔
|-
| comment || 自定义通知消息
|-
| message || 自定义tell的消息，可用%s表示相应物品名
|}

另外一个列子

放置和打破信标时通知在线管理员 
[beacon] 
on-break=notify 
on-place=notify 
阻止用钻石镐和金铲子破坏方块 
[diamond_pickaxe,284] 
on-destroy-with=tell,deny 
阻止使用铁锄、钻石剑耕地和攻击 
[iron_hoe,276] 
on-use=tell,deny 
阻止与箱子、石头按钮交互 
[chest,stone_button] 
on-interact=deny,tell 
阻止丢出命令方块 
[commandblock] 
on-drop=deny,tell 
message=不要乱丢命令方块～ 
除admins组外阻止获得基岩 
[bedrock] 
on-acquire=deny 
ignore-groups=admins 
阻止发射器发射岩浆桶和漏斗矿车 
[lavabucket,hopper_minecart] 
on-dispense=deny,log,notify 
[tnt] 
on-break=deny,notify,kick 
on-use=deny,notify,kick 
on-place=deny,ban 
on-acquire=deny 

日志
日志有三种选择
* 输出到终端（就是服务器后台）
* 记录日志到文件
* 记录到数据库

在worldguard配置文件（plugins\WorldGuard\config.yml）中可以对日志文件和数据库进行具体设置。

blacklist: 
use-as-whitelist: false 
logging: 
console: 
enable: true 
database: 
enable: false 
dsn: jdbc:mysql://localhost:3306/minecraft 
user: root 
pass: '' 
table: blacklist_events 
file: 
enable: false 
path: worldguard/logs/%Y-%m-%d.log 
open-files: 10 

日志文件的路径中可使用以下“变量”： 
%Y 年 (YYYY) 
%m 月 (MM) 
%d 日 (DD) 
%W 周 (00-52) 
%H 小时（24小时） (HH) 
%h 小时（12小时） (HH) 
%i 分 (mm) 
%s 秒 (ss) 
%u 用户名 
%% 表示“%”符号 

数据库 
worldguard可以将日志记录进mysql数据库，但需要先创建数据库和表，你可以使用下面的语句创建专用的表 

CREATE TABLE IF NOT EXISTS `blacklist_events` ( 
`id` int(11) NOT NULL AUTO_INCREMENT, 
`world` varchar(10) NOT NULL, 
`event` varchar(25) NOT NULL, 
`player` varchar(16) NOT NULL, 
`x` int(11) NOT NULL, 
`y` int(11) NOT NULL, 
`z` int(11) NOT NULL, 
`item` int(11) NOT NULL, 
`time` int(11) NOT NULL, 
`comment` varchar(255) DEFAULT NULL, 
PRIMARY KEY (`id`) 
); 

最后说一下，使用时发现，日志文件功能在某些平台下可能无法正常工作，同时会导致黑名单失效，开启此功能时请务必进行测试。
发射器的部分可能会和其他插件的发射器黑名单冲突导致报错。

=箱子保护=
WorldGuard提供基础的箱子保护服务，
玩家可以通过在箱子下方放置特殊字符的牌子来达到保护的目的。
我们不建议新设置的WorldGuard使用本功能因为本功能并不是WorldGuard常用的一部分
除此以外，区域设置是比本功能更好的保护拥有者财产的方法。
因为它不涉及像漏斗一类方块的问题。

提示：如果你是希望保护单块的方块，箱子等，
我们建议使用第三方保护插件。
例如Lockette 或者 LWC.

启用此功能：
首先箱子保护功能必须在配置文件中启用。
如果没有手动启用，箱子保护功能不会自动工作
这时不能使用牌子锁功能。(此项功能也可在配置文件中禁用)

使用方法：
# 必须是一个信息牌
# 必须位于箱子下面(如果是大箱子，只需在其一侧下面)
# 在第一行输入[Lock]
# 在第二行输入玩家的名字
# 在剩余两行写上其他允许使用玩家的名字
注：不可将其他玩家名字放在第二行的位置
提示：WorldGuard功能并不支持UUID功能
警告：由于Minecraft1.8版本的改变
从旧版本升级将会破坏掉所有的保护牌子
实际上它将破坏全部写有[]的牌子

=主机密码（登录密码）=
在过去由于Minecraft的登录代码问题，玩家可以登录到服务器的任何玩家包括拥有者和管理者的账号上，
在2010-2013年间，有五次利用该性质的漏洞经常导致成千上万的服务器被黑客攻击。

这项登录密码功能作为一个额外的登录屏障被添加到WorldGuard中。
其工作原理是作为一项额外的屏障来达到此功能，与Mojang的登录无关。
在登录时必须发送指定信息 (通俗的说就是输入你的密码)才能登录服务器。
即使攻击者有能力破坏Minecraft的登录系统来成为一个管理员。
但因在服务器缺少发送指定的信息，经服务器检测后无法活动。
注：这种登录验证方式的漏洞是很不明显的，很少见的。

启用功能：
当一个玩家通过某一个地址连接服务器时,输入play.example.com
Minecraft将会告诉服务器该玩家通过这个地址登录
管理者可以通过一个特殊的秘密语句来登录，
比如secretmod.play.example.com这个地址
服务器将会检测到该管理者登录使用的这个地址。
也就是一个类似密码的机制，不过密码是地址格式。

主机密码允许特定玩家使用特定地址登录，
如果地址错误，他将立即被踢下线

配置：

host-keys:
your_username: bagels.play.example.com
moderator1_name: manoverboard.play.example.com
提示:主机密码功能暂不支持UUID功能

DNS配置:
为了使此功能工作，你需要bagels.play.example.com 和 manoverboard.play.example.com 指向你的服务
然而不要在您使用的域名中添加域名的记录，因为很容易使得攻击者找出管理员域名从而登录。

相比之下，我们建议您安装通用地址-“wildcard addresses.”。例如设置了play.example.com，
这将意味着任何相同前缀会允许登录。（例如aa.play.example.com，ab.play.example.com，ac.play.example.com，等）。
提示：如果你没有一个域名或不能设置通配符地址，你可以使用xip.io。

=更多帮助=

你需要更多的帮助吗？我建议你 

你可以去[http://skq.me/irc/irc.esper.net/sk-dev/ IRC]提问 
注*IRC聊天频道是维基百科24小时开放的“聊天室” 

你可以在Twitter上联系[https://twitter.com/sk89q sk89q] 
sk89q是Worldguard的作者（也是Worldedit以及其他不少插件的作者） 

你可以查看[https://github.com/sk89q/worldguard/commits Changelog]（全英文，英文不好的直接跳过吧） 
Changelog就是更新信息（每次更新修改/增加/删除等等了什么） 

你如果有什么建议，或者发现了什么Bug可以到[http://youtrack.sk89q.com/issues?q=project%3A+WorldGuard 这里]反馈（全英文，英文不好的直接跳过吧）

WorldGuard

2015-10-12T15:12:46Z

Lichi2050：/* 区域传送（teleport） */

Mcbbs发布贴http://www.mcbbs.net/thread-505810-1-1.html
='''配设文件'''=
=指令介绍=
==Region指令==
===定义和重定义区域（define和redifine）===

/region define 区域名称 (玩家1) (玩家2) （玩家...） 
/region def 区域名称 (玩家1) (玩家2) （玩家...） 
/region d 区域名称 (玩家1) (玩家2) （玩家...） 
（）内容为可选项，如果没有指定玩家，定义后的区域将会属于输入命令的玩家（可以设定多个拥有者） 

这个指令主要是创造区域，创造后才可以进行更多的设定，这个指令是没有限制区域大小的（根据WorldEdit选择的大小） 
玩家部分也可以设定为权限组，这个指令主要是给管理员使用，玩家会有另外一个指令 /claim 

/region define 区域名称 g:权限组名称玩家1 玩家2 
'''注*整个世界区域叫做 __global__'''

/region redefine 区域名称 
/region update 区域名称 
/region move 区域名称 

这个指令会重定义已定义区域，选择好新区域后，输入指令后就可以重定义指定区域 

===区域圈地（claim）===

/region claim 区域名称 (玩家1) (玩家2) (玩家...) 

'''注意！'''这个指令是在2010年11至12月出现的，是很早期的指令，比Bukkit都早，在不久的将来会受到改善！ 
这个指令和define指令非常相似，但是加入了一些其他设定 

如果配设内有启动claim功能，玩家将会被限制区域数量 
创造新区域时不可以重复区域名称，除非你是拥有者，那么就会重定义该区域 
新区域不可覆盖其他区域 
如果配设内有启动claim功能，重新新区域时可以覆盖玩家拥有的其他区域 
如果配设内有启动claim功能，玩家将会被限制区域大小 

===区域信息（information）===

/region info （-s）（世界名称）（区域名称） 

列出区域的详细信息，内含 

区域名称（区域类型，优先权） 
区域flags 
区域拥有者 
区域成员 
区域边界 

空的信息项不会显示 
在指令内加入-s 会在显示信息的同时选择该区域 
如果没有输入区域名称，插件会自动取读脚下的区域 

'''列子：查看“TownPlot”区域的信息'''
/region info townplot 

'''列子：查看地狱世界“TownPlot”区域的信息'''
/region info world_nether TownPlot 
 

===区域选择（select）===

/region select [区域名称] 
这个指令会选择区域 
如果没有输入区域名称，插件会自动取读脚下的区域 

'''列子：选择“TownPlot”区域'''
/region select townplot 

===区域表列（list）===

区域表列（list） 

/region list （页数）（-w 世界名称）（-p 玩家） 

'''列子：列出第一页区域列表'''
/region list 

'''列子：列出地狱世界第三页区域列表'''
/region list 3 -w world_nether 

同时也可以只显示"玩家"的区域，影藏其他区域，需要在指令内加入-p 玩家 

'''列子：列出玩家1的区域列表'''
/region list -p 玩家1 

===设定flag===

/region flag 区域名称 flag （-g 权限组） [-w 世界名称] （数据值） 
这个指令可以为区域设定flag，如果（数据值）没有填的话，选择的flag就会被清除（还原） 
你们必须明白区域优先权和父子区域的关系才可以正确的设定flag，所以最好去查看flag列表 

'''列子：“TownPlot”区域禁止pvp的flag''' 
/region flag townplot pvp deny 

'''列子：在“duduworld”世界“TownPlot”区域禁止pvp的flag''' 
/region flag townplot pvp -w duduworld deny 

'''列子：“TownPlot”区域设定欢迎信息的flag''' 
/region flag townplot greeting 欢迎你来到这个区域, %name%! 
进入“TownPlot”区域显示：欢迎你来到这个区域, 玩家ID! 

'''列子：“TownPlot”区域清除退出信息的flag''' 
/region flag townplot farewell 
效果：退出“TownPlot”区域时不显示退出信息 

===设定优先权(priority)f===

/region setpriority [区域名称] （-w 世界名称） [优先权] 
/region priority [区域名称] （-w 世界名称） [优先权] 
/region pri [区域名称] （-w 世界名称） [优先权] 

设定区域优先权，[优先权]处得填一个整数，可以是正数也可以是负数。 

===设定子区域（parent）===

/region setparent [子区域] [父区域] 
/region parent [子区域] [父区域] 
/region par [子区域] [父区域] 

设定子区域。 

===删除区域（remove）===

/region remove [区域名称] （-w 世界名称） 
/region rem [区域名称] （-w 世界名称） 
/region delete [区域名称] （-w 世界名称） 
/region del [区域名称] （-w 世界名称） 

删除一个区域 

===区域传送（teleport）===

/region teleport (-s) [区域名称] 
/region tp (-s) [区域名称] 

传送到某个区域内，如果加入-s就会传送到区域设定的重生点。 

===区域管理（management）===
=权限介绍=
=regions教程=
==基础教程==
==flag列表==
===区域权限组===
==开发者 API==
===取读WorldGuard===
===基础权限===
===区域管理===
====查看Flags====
====取读一个区域====
===Javadocs===

查看[http://docs.sk89q.com/worldguard/apidocs/com/sk89q/worldguard/bukkit/WGBukkit.html Javadocs]

==数据格式==

'''Region数据都保存在regions.txt内. 打开后首先会有:'''

Region ID 
Region 类型(type) 

Worldguard3.0版本以下的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 
Priority 优先权（请勿设定为0） 
List of owners 拥有者列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 

Worldguard3.0版本以上的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 

Priority 优先权（请勿设定为0） 
ID of parent region 父regionID（设置过子region才会显示） 
List of owners 拥有者列表 
List of members 会员列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 
Exit message （退出region提示信息） 

拥有者以及会员数据保存方式: 
u: 玩家名称 
g: region权限组 

例如 
u:sk89q,u:tetsu,g:admins 

意思就是sk89q以及tetsu这两个玩家都在admins组内。

Flags数据保存方式: 
每一个flag都会有一个特殊的字母，例如Build就是b，通过一个+或者-我们能够查看这个flag的状态 
+就是启动 
-就是关闭/禁止 
如果没有+或- 那么代表这个flag默认就是启动的 
例如 
+bpmc-t-l-f-F 

{| class="wikitable"
|-
! Flag 名称 !! 代表字母
|-
| Passthrough || z
|-
| Build || b
|-
| PvP || p
|-
| Mob damage || m
|-
| Creeper explosion || c
|-
| TNT || t
|-
| Flint and steel || l
|-
| Fire spread || f
|-
| Lava fire spread || F
|}

=黑名单(Blacklist)=
worldguard黑名单可以指定玩家进行某些动作时的处理方法

比如：
阻止玩家挖掉金矿石。
当有人挖掘钻石块时通知在线管理员。
当玩家放置附魔台时，向放置者发送一条提示消息。

下面是一个黑名单的例子：

除admins,mods组以外禁止使用岩浆桶并向使用者发送自定义提示消息 
[lavabucket] 
ignore-groups=admins,mods 
on-use=deny,tell 
message=不可以使用岩浆桶呢喵！ 

禁止挖掉铁矿和金矿并提示默认消息同时通知在线管理员 
[goldore,ironore] 
ignore-groups=admins 
on-break=deny,tell,notify 

除admins组外禁止放置tnt 放置时会通知管理员并且踢出去 
[tnt] 
ignore-groups=admins 
on-place=deny,notify,kick 

黑名单配置文件

黑名单的配置文件保存在plugins\WorldGuard\worlds下面，每个世界都有单独的配置文件 
例子：

worlds/world/blacklist.txt 主世界 
worlds/world_the_end/blacklist.txt 末地 
worlds/mining_world/blacklist.txt 资源世界（如果服务器有多世界的话） 

提示
worldguard不支持多个世界共用同一个黑名单配置文件，但是你可以利用文件系统的“链接”实现。 
注意：编辑黑名单后需要用/wg reload重新加载才能生效 

格式： 

[物品或方块列表] 
事件=操作 
选项=值 

匹配规则： 

物品/方块列表可以填写数字id或bukkit的材料名（可参考 https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html） 
多个项目之间用半角逗号分隔 
[wood,brick,glass] 
还可以指定数据值如白桦木： 
[17:1] 
白桦木和丛林木： 
[17:1;3] 
指定数据值范围 
[wood:2-3] 
[wood:>=2,<=3] 
这些写法是可以混合使用的 
[wood:0;>=2,grass:1-2] 

事件：
{| class="wikitable"
|-
! Event !! Explanation
|-
| on-break || 破坏方块
|-
| on-destroy-with || 用此物品打破方块
|-
| on-place || 放置方块
|-
| on-use || 使用
|-
| on-interact || 交互，如右键门、拉杆、箱子等
|-
| on-drop || 丢弃特定物品
|-
| on-acquire || 获得物品
|-
| on-dispense || 针对发射器，发射特定物品
|-
|}

操作：
{| class="wikitable"
|-
! Action !! Explanation
|-
| deny || 阻止操作（黑名单模式）
|-
| allow || 允许操作（仅白名单模式）
|-
| notify || 发送通知消息给有worldguard.notify权限的人
|-
| log || 记录日志到终端、日志文件、数据库。
|-
| tell || 给玩家一个提示消息
|-
| kick || 踢出玩家
|-
| ban || 将玩家ban掉（永久性）
|-
|}

选项：
{| class="wikitable"
|-
! Option !! Explanation
|-
| ignore-groups || 忽略特定权限组，多个组用半角逗号分隔
|-
| ignore-perms || 忽略有特定权限的玩家，多个权限同样是用逗号分隔
|-
| comment || 自定义通知消息
|-
| message || 自定义tell的消息，可用%s表示相应物品名
|}

另外一个列子

放置和打破信标时通知在线管理员 
[beacon] 
on-break=notify 
on-place=notify 
阻止用钻石镐和金铲子破坏方块 
[diamond_pickaxe,284] 
on-destroy-with=tell,deny 
阻止使用铁锄、钻石剑耕地和攻击 
[iron_hoe,276] 
on-use=tell,deny 
阻止与箱子、石头按钮交互 
[chest,stone_button] 
on-interact=deny,tell 
阻止丢出命令方块 
[commandblock] 
on-drop=deny,tell 
message=不要乱丢命令方块～ 
除admins组外阻止获得基岩 
[bedrock] 
on-acquire=deny 
ignore-groups=admins 
阻止发射器发射岩浆桶和漏斗矿车 
[lavabucket,hopper_minecart] 
on-dispense=deny,log,notify 
[tnt] 
on-break=deny,notify,kick 
on-use=deny,notify,kick 
on-place=deny,ban 
on-acquire=deny 

日志
日志有三种选择
* 输出到终端（就是服务器后台）
* 记录日志到文件
* 记录到数据库

在worldguard配置文件（plugins\WorldGuard\config.yml）中可以对日志文件和数据库进行具体设置。

blacklist: 
use-as-whitelist: false 
logging: 
console: 
enable: true 
database: 
enable: false 
dsn: jdbc:mysql://localhost:3306/minecraft 
user: root 
pass: '' 
table: blacklist_events 
file: 
enable: false 
path: worldguard/logs/%Y-%m-%d.log 
open-files: 10 

日志文件的路径中可使用以下“变量”： 
%Y 年 (YYYY) 
%m 月 (MM) 
%d 日 (DD) 
%W 周 (00-52) 
%H 小时（24小时） (HH) 
%h 小时（12小时） (HH) 
%i 分 (mm) 
%s 秒 (ss) 
%u 用户名 
%% 表示“%”符号 

数据库 
worldguard可以将日志记录进mysql数据库，但需要先创建数据库和表，你可以使用下面的语句创建专用的表 

CREATE TABLE IF NOT EXISTS `blacklist_events` ( 
`id` int(11) NOT NULL AUTO_INCREMENT, 
`world` varchar(10) NOT NULL, 
`event` varchar(25) NOT NULL, 
`player` varchar(16) NOT NULL, 
`x` int(11) NOT NULL, 
`y` int(11) NOT NULL, 
`z` int(11) NOT NULL, 
`item` int(11) NOT NULL, 
`time` int(11) NOT NULL, 
`comment` varchar(255) DEFAULT NULL, 
PRIMARY KEY (`id`) 
); 

最后说一下，使用时发现，日志文件功能在某些平台下可能无法正常工作，同时会导致黑名单失效，开启此功能时请务必进行测试。
发射器的部分可能会和其他插件的发射器黑名单冲突导致报错。

=箱子保护=
WorldGuard提供基础的箱子保护服务，
玩家可以通过在箱子下方放置特殊字符的牌子来达到保护的目的。
我们不建议新设置的WorldGuard使用本功能因为本功能并不是WorldGuard常用的一部分
除此以外，区域设置是比本功能更好的保护拥有者财产的方法。
因为它不涉及像漏斗一类方块的问题。

提示：如果你是希望保护单块的方块，箱子等，
我们建议使用第三方保护插件。
例如Lockette 或者 LWC.

启用此功能：
首先箱子保护功能必须在配置文件中启用。
如果没有手动启用，箱子保护功能不会自动工作
这时不能使用牌子锁功能。(此项功能也可在配置文件中禁用)

使用方法：
# 必须是一个信息牌
# 必须位于箱子下面(如果是大箱子，只需在其一侧下面)
# 在第一行输入[Lock]
# 在第二行输入玩家的名字
# 在剩余两行写上其他允许使用玩家的名字
注：不可将其他玩家名字放在第二行的位置
提示：WorldGuard功能并不支持UUID功能
警告：由于Minecraft1.8版本的改变
从旧版本升级将会破坏掉所有的保护牌子
实际上它将破坏全部写有[]的牌子

=主机密码（登录密码）=
在过去由于Minecraft的登录代码问题，玩家可以登录到服务器的任何玩家包括拥有者和管理者的账号上，
在2010-2013年间，有五次利用该性质的漏洞经常导致成千上万的服务器被黑客攻击。

这项登录密码功能作为一个额外的登录屏障被添加到WorldGuard中。
其工作原理是作为一项额外的屏障来达到此功能，与Mojang的登录无关。
在登录时必须发送指定信息 (通俗的说就是输入你的密码)才能登录服务器。
即使攻击者有能力破坏Minecraft的登录系统来成为一个管理员。
但因在服务器缺少发送指定的信息，经服务器检测后无法活动。
注：这种登录验证方式的漏洞是很不明显的，很少见的。

启用功能：
当一个玩家通过某一个地址连接服务器时,输入play.example.com
Minecraft将会告诉服务器该玩家通过这个地址登录
管理者可以通过一个特殊的秘密语句来登录，
比如secretmod.play.example.com这个地址
服务器将会检测到该管理者登录使用的这个地址。
也就是一个类似密码的机制，不过密码是地址格式。

主机密码允许特定玩家使用特定地址登录，
如果地址错误，他将立即被踢下线

配置：

host-keys:
your_username: bagels.play.example.com
moderator1_name: manoverboard.play.example.com
提示:主机密码功能暂不支持UUID功能

DNS配置:
为了使此功能工作，你需要bagels.play.example.com 和 manoverboard.play.example.com 指向你的服务
然而不要在您使用的域名中添加域名的记录，因为很容易使得攻击者找出管理员域名从而登录。

相比之下，我们建议您安装通用地址-“wildcard addresses.”。例如设置了play.example.com，
这将意味着任何相同前缀会允许登录。（例如aa.play.example.com，ab.play.example.com，ac.play.example.com，等）。
提示：如果你没有一个域名或不能设置通配符地址，你可以使用xip.io。

=更多帮助=

你需要更多的帮助吗？我建议你 

你可以去[http://skq.me/irc/irc.esper.net/sk-dev/ IRC]提问 
注*IRC聊天频道是维基百科24小时开放的“聊天室” 

你可以在Twitter上联系[https://twitter.com/sk89q sk89q] 
sk89q是Worldguard的作者（也是Worldedit以及其他不少插件的作者） 

你可以查看[https://github.com/sk89q/worldguard/commits Changelog]（全英文，英文不好的直接跳过吧） 
Changelog就是更新信息（每次更新修改/增加/删除等等了什么） 

你如果有什么建议，或者发现了什么Bug可以到[http://youtrack.sk89q.com/issues?q=project%3A+WorldGuard 这里]反馈（全英文，英文不好的直接跳过吧）

WorldGuard

2015-10-12T15:12:31Z

Lichi2050：/* 删除区域（remove） */

Mcbbs发布贴http://www.mcbbs.net/thread-505810-1-1.html
='''配设文件'''=
=指令介绍=
==Region指令==
===定义和重定义区域（define和redifine）===

/region define 区域名称 (玩家1) (玩家2) （玩家...） 
/region def 区域名称 (玩家1) (玩家2) （玩家...） 
/region d 区域名称 (玩家1) (玩家2) （玩家...） 
（）内容为可选项，如果没有指定玩家，定义后的区域将会属于输入命令的玩家（可以设定多个拥有者） 

这个指令主要是创造区域，创造后才可以进行更多的设定，这个指令是没有限制区域大小的（根据WorldEdit选择的大小） 
玩家部分也可以设定为权限组，这个指令主要是给管理员使用，玩家会有另外一个指令 /claim 

/region define 区域名称 g:权限组名称玩家1 玩家2 
'''注*整个世界区域叫做 __global__'''

/region redefine 区域名称 
/region update 区域名称 
/region move 区域名称 

这个指令会重定义已定义区域，选择好新区域后，输入指令后就可以重定义指定区域 

===区域圈地（claim）===

/region claim 区域名称 (玩家1) (玩家2) (玩家...) 

'''注意！'''这个指令是在2010年11至12月出现的，是很早期的指令，比Bukkit都早，在不久的将来会受到改善！ 
这个指令和define指令非常相似，但是加入了一些其他设定 

如果配设内有启动claim功能，玩家将会被限制区域数量 
创造新区域时不可以重复区域名称，除非你是拥有者，那么就会重定义该区域 
新区域不可覆盖其他区域 
如果配设内有启动claim功能，重新新区域时可以覆盖玩家拥有的其他区域 
如果配设内有启动claim功能，玩家将会被限制区域大小 

===区域信息（information）===

/region info （-s）（世界名称）（区域名称） 

列出区域的详细信息，内含 

区域名称（区域类型，优先权） 
区域flags 
区域拥有者 
区域成员 
区域边界 

空的信息项不会显示 
在指令内加入-s 会在显示信息的同时选择该区域 
如果没有输入区域名称，插件会自动取读脚下的区域 

'''列子：查看“TownPlot”区域的信息'''
/region info townplot 

'''列子：查看地狱世界“TownPlot”区域的信息'''
/region info world_nether TownPlot 
 

===区域选择（select）===

/region select [区域名称] 
这个指令会选择区域 
如果没有输入区域名称，插件会自动取读脚下的区域 

'''列子：选择“TownPlot”区域'''
/region select townplot 

===区域表列（list）===

区域表列（list） 

/region list （页数）（-w 世界名称）（-p 玩家） 

'''列子：列出第一页区域列表'''
/region list 

'''列子：列出地狱世界第三页区域列表'''
/region list 3 -w world_nether 

同时也可以只显示"玩家"的区域，影藏其他区域，需要在指令内加入-p 玩家 

'''列子：列出玩家1的区域列表'''
/region list -p 玩家1 

===设定flag===

/region flag 区域名称 flag （-g 权限组） [-w 世界名称] （数据值） 
这个指令可以为区域设定flag，如果（数据值）没有填的话，选择的flag就会被清除（还原） 
你们必须明白区域优先权和父子区域的关系才可以正确的设定flag，所以最好去查看flag列表 

'''列子：“TownPlot”区域禁止pvp的flag''' 
/region flag townplot pvp deny 

'''列子：在“duduworld”世界“TownPlot”区域禁止pvp的flag''' 
/region flag townplot pvp -w duduworld deny 

'''列子：“TownPlot”区域设定欢迎信息的flag''' 
/region flag townplot greeting 欢迎你来到这个区域, %name%! 
进入“TownPlot”区域显示：欢迎你来到这个区域, 玩家ID! 

'''列子：“TownPlot”区域清除退出信息的flag''' 
/region flag townplot farewell 
效果：退出“TownPlot”区域时不显示退出信息 

===设定优先权(priority)f===

/region setpriority [区域名称] （-w 世界名称） [优先权] 
/region priority [区域名称] （-w 世界名称） [优先权] 
/region pri [区域名称] （-w 世界名称） [优先权] 

设定区域优先权，[优先权]处得填一个整数，可以是正数也可以是负数。 

===设定子区域（parent）===

/region setparent [子区域] [父区域] 
/region parent [子区域] [父区域] 
/region par [子区域] [父区域] 

设定子区域。 

===删除区域（remove）===

/region remove [区域名称] （-w 世界名称） 
/region rem [区域名称] （-w 世界名称） 
/region delete [区域名称] （-w 世界名称） 
/region del [区域名称] （-w 世界名称） 

删除一个区域 

===区域传送（teleport）===
===区域管理（management）===
=权限介绍=
=regions教程=
==基础教程==
==flag列表==
===区域权限组===
==开发者 API==
===取读WorldGuard===
===基础权限===
===区域管理===
====查看Flags====
====取读一个区域====
===Javadocs===

查看[http://docs.sk89q.com/worldguard/apidocs/com/sk89q/worldguard/bukkit/WGBukkit.html Javadocs]

==数据格式==

'''Region数据都保存在regions.txt内. 打开后首先会有:'''

Region ID 
Region 类型(type) 

Worldguard3.0版本以下的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 
Priority 优先权（请勿设定为0） 
List of owners 拥有者列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 

Worldguard3.0版本以上的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 

Priority 优先权（请勿设定为0） 
ID of parent region 父regionID（设置过子region才会显示） 
List of owners 拥有者列表 
List of members 会员列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 
Exit message （退出region提示信息） 

拥有者以及会员数据保存方式: 
u: 玩家名称 
g: region权限组 

例如 
u:sk89q,u:tetsu,g:admins 

意思就是sk89q以及tetsu这两个玩家都在admins组内。

Flags数据保存方式: 
每一个flag都会有一个特殊的字母，例如Build就是b，通过一个+或者-我们能够查看这个flag的状态 
+就是启动 
-就是关闭/禁止 
如果没有+或- 那么代表这个flag默认就是启动的 
例如 
+bpmc-t-l-f-F 

{| class="wikitable"
|-
! Flag 名称 !! 代表字母
|-
| Passthrough || z
|-
| Build || b
|-
| PvP || p
|-
| Mob damage || m
|-
| Creeper explosion || c
|-
| TNT || t
|-
| Flint and steel || l
|-
| Fire spread || f
|-
| Lava fire spread || F
|}

=黑名单(Blacklist)=
worldguard黑名单可以指定玩家进行某些动作时的处理方法

比如：
阻止玩家挖掉金矿石。
当有人挖掘钻石块时通知在线管理员。
当玩家放置附魔台时，向放置者发送一条提示消息。

下面是一个黑名单的例子：

除admins,mods组以外禁止使用岩浆桶并向使用者发送自定义提示消息 
[lavabucket] 
ignore-groups=admins,mods 
on-use=deny,tell 
message=不可以使用岩浆桶呢喵！ 

禁止挖掉铁矿和金矿并提示默认消息同时通知在线管理员 
[goldore,ironore] 
ignore-groups=admins 
on-break=deny,tell,notify 

除admins组外禁止放置tnt 放置时会通知管理员并且踢出去 
[tnt] 
ignore-groups=admins 
on-place=deny,notify,kick 

黑名单配置文件

黑名单的配置文件保存在plugins\WorldGuard\worlds下面，每个世界都有单独的配置文件 
例子：

worlds/world/blacklist.txt 主世界 
worlds/world_the_end/blacklist.txt 末地 
worlds/mining_world/blacklist.txt 资源世界（如果服务器有多世界的话） 

提示
worldguard不支持多个世界共用同一个黑名单配置文件，但是你可以利用文件系统的“链接”实现。 
注意：编辑黑名单后需要用/wg reload重新加载才能生效 

格式： 

[物品或方块列表] 
事件=操作 
选项=值 

匹配规则： 

物品/方块列表可以填写数字id或bukkit的材料名（可参考 https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html） 
多个项目之间用半角逗号分隔 
[wood,brick,glass] 
还可以指定数据值如白桦木： 
[17:1] 
白桦木和丛林木： 
[17:1;3] 
指定数据值范围 
[wood:2-3] 
[wood:>=2,<=3] 
这些写法是可以混合使用的 
[wood:0;>=2,grass:1-2] 

事件：
{| class="wikitable"
|-
! Event !! Explanation
|-
| on-break || 破坏方块
|-
| on-destroy-with || 用此物品打破方块
|-
| on-place || 放置方块
|-
| on-use || 使用
|-
| on-interact || 交互，如右键门、拉杆、箱子等
|-
| on-drop || 丢弃特定物品
|-
| on-acquire || 获得物品
|-
| on-dispense || 针对发射器，发射特定物品
|-
|}

操作：
{| class="wikitable"
|-
! Action !! Explanation
|-
| deny || 阻止操作（黑名单模式）
|-
| allow || 允许操作（仅白名单模式）
|-
| notify || 发送通知消息给有worldguard.notify权限的人
|-
| log || 记录日志到终端、日志文件、数据库。
|-
| tell || 给玩家一个提示消息
|-
| kick || 踢出玩家
|-
| ban || 将玩家ban掉（永久性）
|-
|}

选项：
{| class="wikitable"
|-
! Option !! Explanation
|-
| ignore-groups || 忽略特定权限组，多个组用半角逗号分隔
|-
| ignore-perms || 忽略有特定权限的玩家，多个权限同样是用逗号分隔
|-
| comment || 自定义通知消息
|-
| message || 自定义tell的消息，可用%s表示相应物品名
|}

另外一个列子

放置和打破信标时通知在线管理员 
[beacon] 
on-break=notify 
on-place=notify 
阻止用钻石镐和金铲子破坏方块 
[diamond_pickaxe,284] 
on-destroy-with=tell,deny 
阻止使用铁锄、钻石剑耕地和攻击 
[iron_hoe,276] 
on-use=tell,deny 
阻止与箱子、石头按钮交互 
[chest,stone_button] 
on-interact=deny,tell 
阻止丢出命令方块 
[commandblock] 
on-drop=deny,tell 
message=不要乱丢命令方块～ 
除admins组外阻止获得基岩 
[bedrock] 
on-acquire=deny 
ignore-groups=admins 
阻止发射器发射岩浆桶和漏斗矿车 
[lavabucket,hopper_minecart] 
on-dispense=deny,log,notify 
[tnt] 
on-break=deny,notify,kick 
on-use=deny,notify,kick 
on-place=deny,ban 
on-acquire=deny 

日志
日志有三种选择
* 输出到终端（就是服务器后台）
* 记录日志到文件
* 记录到数据库

在worldguard配置文件（plugins\WorldGuard\config.yml）中可以对日志文件和数据库进行具体设置。

blacklist: 
use-as-whitelist: false 
logging: 
console: 
enable: true 
database: 
enable: false 
dsn: jdbc:mysql://localhost:3306/minecraft 
user: root 
pass: '' 
table: blacklist_events 
file: 
enable: false 
path: worldguard/logs/%Y-%m-%d.log 
open-files: 10 

日志文件的路径中可使用以下“变量”： 
%Y 年 (YYYY) 
%m 月 (MM) 
%d 日 (DD) 
%W 周 (00-52) 
%H 小时（24小时） (HH) 
%h 小时（12小时） (HH) 
%i 分 (mm) 
%s 秒 (ss) 
%u 用户名 
%% 表示“%”符号 

数据库 
worldguard可以将日志记录进mysql数据库，但需要先创建数据库和表，你可以使用下面的语句创建专用的表 

CREATE TABLE IF NOT EXISTS `blacklist_events` ( 
`id` int(11) NOT NULL AUTO_INCREMENT, 
`world` varchar(10) NOT NULL, 
`event` varchar(25) NOT NULL, 
`player` varchar(16) NOT NULL, 
`x` int(11) NOT NULL, 
`y` int(11) NOT NULL, 
`z` int(11) NOT NULL, 
`item` int(11) NOT NULL, 
`time` int(11) NOT NULL, 
`comment` varchar(255) DEFAULT NULL, 
PRIMARY KEY (`id`) 
); 

最后说一下，使用时发现，日志文件功能在某些平台下可能无法正常工作，同时会导致黑名单失效，开启此功能时请务必进行测试。
发射器的部分可能会和其他插件的发射器黑名单冲突导致报错。

=箱子保护=
WorldGuard提供基础的箱子保护服务，
玩家可以通过在箱子下方放置特殊字符的牌子来达到保护的目的。
我们不建议新设置的WorldGuard使用本功能因为本功能并不是WorldGuard常用的一部分
除此以外，区域设置是比本功能更好的保护拥有者财产的方法。
因为它不涉及像漏斗一类方块的问题。

提示：如果你是希望保护单块的方块，箱子等，
我们建议使用第三方保护插件。
例如Lockette 或者 LWC.

启用此功能：
首先箱子保护功能必须在配置文件中启用。
如果没有手动启用，箱子保护功能不会自动工作
这时不能使用牌子锁功能。(此项功能也可在配置文件中禁用)

使用方法：
# 必须是一个信息牌
# 必须位于箱子下面(如果是大箱子，只需在其一侧下面)
# 在第一行输入[Lock]
# 在第二行输入玩家的名字
# 在剩余两行写上其他允许使用玩家的名字
注：不可将其他玩家名字放在第二行的位置
提示：WorldGuard功能并不支持UUID功能
警告：由于Minecraft1.8版本的改变
从旧版本升级将会破坏掉所有的保护牌子
实际上它将破坏全部写有[]的牌子

=主机密码（登录密码）=
在过去由于Minecraft的登录代码问题，玩家可以登录到服务器的任何玩家包括拥有者和管理者的账号上，
在2010-2013年间，有五次利用该性质的漏洞经常导致成千上万的服务器被黑客攻击。

这项登录密码功能作为一个额外的登录屏障被添加到WorldGuard中。
其工作原理是作为一项额外的屏障来达到此功能，与Mojang的登录无关。
在登录时必须发送指定信息 (通俗的说就是输入你的密码)才能登录服务器。
即使攻击者有能力破坏Minecraft的登录系统来成为一个管理员。
但因在服务器缺少发送指定的信息，经服务器检测后无法活动。
注：这种登录验证方式的漏洞是很不明显的，很少见的。

启用功能：
当一个玩家通过某一个地址连接服务器时,输入play.example.com
Minecraft将会告诉服务器该玩家通过这个地址登录
管理者可以通过一个特殊的秘密语句来登录，
比如secretmod.play.example.com这个地址
服务器将会检测到该管理者登录使用的这个地址。
也就是一个类似密码的机制，不过密码是地址格式。

主机密码允许特定玩家使用特定地址登录，
如果地址错误，他将立即被踢下线

配置：

host-keys:
your_username: bagels.play.example.com
moderator1_name: manoverboard.play.example.com
提示:主机密码功能暂不支持UUID功能

DNS配置:
为了使此功能工作，你需要bagels.play.example.com 和 manoverboard.play.example.com 指向你的服务
然而不要在您使用的域名中添加域名的记录，因为很容易使得攻击者找出管理员域名从而登录。

相比之下，我们建议您安装通用地址-“wildcard addresses.”。例如设置了play.example.com，
这将意味着任何相同前缀会允许登录。（例如aa.play.example.com，ab.play.example.com，ac.play.example.com，等）。
提示：如果你没有一个域名或不能设置通配符地址，你可以使用xip.io。

=更多帮助=

你需要更多的帮助吗？我建议你 

你可以去[http://skq.me/irc/irc.esper.net/sk-dev/ IRC]提问 
注*IRC聊天频道是维基百科24小时开放的“聊天室” 

你可以在Twitter上联系[https://twitter.com/sk89q sk89q] 
sk89q是Worldguard的作者（也是Worldedit以及其他不少插件的作者） 

你可以查看[https://github.com/sk89q/worldguard/commits Changelog]（全英文，英文不好的直接跳过吧） 
Changelog就是更新信息（每次更新修改/增加/删除等等了什么） 

你如果有什么建议，或者发现了什么Bug可以到[http://youtrack.sk89q.com/issues?q=project%3A+WorldGuard 这里]反馈（全英文，英文不好的直接跳过吧）

WorldGuard

2015-10-12T15:12:15Z

Lichi2050：/* 设定子区域（parent） */

Mcbbs发布贴http://www.mcbbs.net/thread-505810-1-1.html
='''配设文件'''=
=指令介绍=
==Region指令==
===定义和重定义区域（define和redifine）===

/region define 区域名称 (玩家1) (玩家2) （玩家...） 
/region def 区域名称 (玩家1) (玩家2) （玩家...） 
/region d 区域名称 (玩家1) (玩家2) （玩家...） 
（）内容为可选项，如果没有指定玩家，定义后的区域将会属于输入命令的玩家（可以设定多个拥有者） 

这个指令主要是创造区域，创造后才可以进行更多的设定，这个指令是没有限制区域大小的（根据WorldEdit选择的大小） 
玩家部分也可以设定为权限组，这个指令主要是给管理员使用，玩家会有另外一个指令 /claim 

/region define 区域名称 g:权限组名称玩家1 玩家2 
'''注*整个世界区域叫做 __global__'''

/region redefine 区域名称 
/region update 区域名称 
/region move 区域名称 

这个指令会重定义已定义区域，选择好新区域后，输入指令后就可以重定义指定区域 

===区域圈地（claim）===

/region claim 区域名称 (玩家1) (玩家2) (玩家...) 

'''注意！'''这个指令是在2010年11至12月出现的，是很早期的指令，比Bukkit都早，在不久的将来会受到改善！ 
这个指令和define指令非常相似，但是加入了一些其他设定 

如果配设内有启动claim功能，玩家将会被限制区域数量 
创造新区域时不可以重复区域名称，除非你是拥有者，那么就会重定义该区域 
新区域不可覆盖其他区域 
如果配设内有启动claim功能，重新新区域时可以覆盖玩家拥有的其他区域 
如果配设内有启动claim功能，玩家将会被限制区域大小 

===区域信息（information）===

/region info （-s）（世界名称）（区域名称） 

列出区域的详细信息，内含 

区域名称（区域类型，优先权） 
区域flags 
区域拥有者 
区域成员 
区域边界 

空的信息项不会显示 
在指令内加入-s 会在显示信息的同时选择该区域 
如果没有输入区域名称，插件会自动取读脚下的区域 

'''列子：查看“TownPlot”区域的信息'''
/region info townplot 

'''列子：查看地狱世界“TownPlot”区域的信息'''
/region info world_nether TownPlot 
 

===区域选择（select）===

/region select [区域名称] 
这个指令会选择区域 
如果没有输入区域名称，插件会自动取读脚下的区域 

'''列子：选择“TownPlot”区域'''
/region select townplot 

===区域表列（list）===

区域表列（list） 

/region list （页数）（-w 世界名称）（-p 玩家） 

'''列子：列出第一页区域列表'''
/region list 

'''列子：列出地狱世界第三页区域列表'''
/region list 3 -w world_nether 

同时也可以只显示"玩家"的区域，影藏其他区域，需要在指令内加入-p 玩家 

'''列子：列出玩家1的区域列表'''
/region list -p 玩家1 

===设定flag===

/region flag 区域名称 flag （-g 权限组） [-w 世界名称] （数据值） 
这个指令可以为区域设定flag，如果（数据值）没有填的话，选择的flag就会被清除（还原） 
你们必须明白区域优先权和父子区域的关系才可以正确的设定flag，所以最好去查看flag列表 

'''列子：“TownPlot”区域禁止pvp的flag''' 
/region flag townplot pvp deny 

'''列子：在“duduworld”世界“TownPlot”区域禁止pvp的flag''' 
/region flag townplot pvp -w duduworld deny 

'''列子：“TownPlot”区域设定欢迎信息的flag''' 
/region flag townplot greeting 欢迎你来到这个区域, %name%! 
进入“TownPlot”区域显示：欢迎你来到这个区域, 玩家ID! 

'''列子：“TownPlot”区域清除退出信息的flag''' 
/region flag townplot farewell 
效果：退出“TownPlot”区域时不显示退出信息 

===设定优先权(priority)f===

/region setpriority [区域名称] （-w 世界名称） [优先权] 
/region priority [区域名称] （-w 世界名称） [优先权] 
/region pri [区域名称] （-w 世界名称） [优先权] 

设定区域优先权，[优先权]处得填一个整数，可以是正数也可以是负数。 

===设定子区域（parent）===

/region setparent [子区域] [父区域] 
/region parent [子区域] [父区域] 
/region par [子区域] [父区域] 

设定子区域。 

===删除区域（remove）===
===区域传送（teleport）===
===区域管理（management）===
=权限介绍=
=regions教程=
==基础教程==
==flag列表==
===区域权限组===
==开发者 API==
===取读WorldGuard===
===基础权限===
===区域管理===
====查看Flags====
====取读一个区域====
===Javadocs===

查看[http://docs.sk89q.com/worldguard/apidocs/com/sk89q/worldguard/bukkit/WGBukkit.html Javadocs]

==数据格式==

'''Region数据都保存在regions.txt内. 打开后首先会有:'''

Region ID 
Region 类型(type) 

Worldguard3.0版本以下的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 
Priority 优先权（请勿设定为0） 
List of owners 拥有者列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 

Worldguard3.0版本以上的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 

Priority 优先权（请勿设定为0） 
ID of parent region 父regionID（设置过子region才会显示） 
List of owners 拥有者列表 
List of members 会员列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 
Exit message （退出region提示信息） 

拥有者以及会员数据保存方式: 
u: 玩家名称 
g: region权限组 

例如 
u:sk89q,u:tetsu,g:admins 

意思就是sk89q以及tetsu这两个玩家都在admins组内。

Flags数据保存方式: 
每一个flag都会有一个特殊的字母，例如Build就是b，通过一个+或者-我们能够查看这个flag的状态 
+就是启动 
-就是关闭/禁止 
如果没有+或- 那么代表这个flag默认就是启动的 
例如 
+bpmc-t-l-f-F 

{| class="wikitable"
|-
! Flag 名称 !! 代表字母
|-
| Passthrough || z
|-
| Build || b
|-
| PvP || p
|-
| Mob damage || m
|-
| Creeper explosion || c
|-
| TNT || t
|-
| Flint and steel || l
|-
| Fire spread || f
|-
| Lava fire spread || F
|}

=黑名单(Blacklist)=
worldguard黑名单可以指定玩家进行某些动作时的处理方法

比如：
阻止玩家挖掉金矿石。
当有人挖掘钻石块时通知在线管理员。
当玩家放置附魔台时，向放置者发送一条提示消息。

下面是一个黑名单的例子：

除admins,mods组以外禁止使用岩浆桶并向使用者发送自定义提示消息 
[lavabucket] 
ignore-groups=admins,mods 
on-use=deny,tell 
message=不可以使用岩浆桶呢喵！ 

禁止挖掉铁矿和金矿并提示默认消息同时通知在线管理员 
[goldore,ironore] 
ignore-groups=admins 
on-break=deny,tell,notify 

除admins组外禁止放置tnt 放置时会通知管理员并且踢出去 
[tnt] 
ignore-groups=admins 
on-place=deny,notify,kick 

黑名单配置文件

黑名单的配置文件保存在plugins\WorldGuard\worlds下面，每个世界都有单独的配置文件 
例子：

worlds/world/blacklist.txt 主世界 
worlds/world_the_end/blacklist.txt 末地 
worlds/mining_world/blacklist.txt 资源世界（如果服务器有多世界的话） 

提示
worldguard不支持多个世界共用同一个黑名单配置文件，但是你可以利用文件系统的“链接”实现。 
注意：编辑黑名单后需要用/wg reload重新加载才能生效 

格式： 

[物品或方块列表] 
事件=操作 
选项=值 

匹配规则： 

物品/方块列表可以填写数字id或bukkit的材料名（可参考 https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html） 
多个项目之间用半角逗号分隔 
[wood,brick,glass] 
还可以指定数据值如白桦木： 
[17:1] 
白桦木和丛林木： 
[17:1;3] 
指定数据值范围 
[wood:2-3] 
[wood:>=2,<=3] 
这些写法是可以混合使用的 
[wood:0;>=2,grass:1-2] 

事件：
{| class="wikitable"
|-
! Event !! Explanation
|-
| on-break || 破坏方块
|-
| on-destroy-with || 用此物品打破方块
|-
| on-place || 放置方块
|-
| on-use || 使用
|-
| on-interact || 交互，如右键门、拉杆、箱子等
|-
| on-drop || 丢弃特定物品
|-
| on-acquire || 获得物品
|-
| on-dispense || 针对发射器，发射特定物品
|-
|}

操作：
{| class="wikitable"
|-
! Action !! Explanation
|-
| deny || 阻止操作（黑名单模式）
|-
| allow || 允许操作（仅白名单模式）
|-
| notify || 发送通知消息给有worldguard.notify权限的人
|-
| log || 记录日志到终端、日志文件、数据库。
|-
| tell || 给玩家一个提示消息
|-
| kick || 踢出玩家
|-
| ban || 将玩家ban掉（永久性）
|-
|}

选项：
{| class="wikitable"
|-
! Option !! Explanation
|-
| ignore-groups || 忽略特定权限组，多个组用半角逗号分隔
|-
| ignore-perms || 忽略有特定权限的玩家，多个权限同样是用逗号分隔
|-
| comment || 自定义通知消息
|-
| message || 自定义tell的消息，可用%s表示相应物品名
|}

另外一个列子

放置和打破信标时通知在线管理员 
[beacon] 
on-break=notify 
on-place=notify 
阻止用钻石镐和金铲子破坏方块 
[diamond_pickaxe,284] 
on-destroy-with=tell,deny 
阻止使用铁锄、钻石剑耕地和攻击 
[iron_hoe,276] 
on-use=tell,deny 
阻止与箱子、石头按钮交互 
[chest,stone_button] 
on-interact=deny,tell 
阻止丢出命令方块 
[commandblock] 
on-drop=deny,tell 
message=不要乱丢命令方块～ 
除admins组外阻止获得基岩 
[bedrock] 
on-acquire=deny 
ignore-groups=admins 
阻止发射器发射岩浆桶和漏斗矿车 
[lavabucket,hopper_minecart] 
on-dispense=deny,log,notify 
[tnt] 
on-break=deny,notify,kick 
on-use=deny,notify,kick 
on-place=deny,ban 
on-acquire=deny 

日志
日志有三种选择
* 输出到终端（就是服务器后台）
* 记录日志到文件
* 记录到数据库

在worldguard配置文件（plugins\WorldGuard\config.yml）中可以对日志文件和数据库进行具体设置。

blacklist: 
use-as-whitelist: false 
logging: 
console: 
enable: true 
database: 
enable: false 
dsn: jdbc:mysql://localhost:3306/minecraft 
user: root 
pass: '' 
table: blacklist_events 
file: 
enable: false 
path: worldguard/logs/%Y-%m-%d.log 
open-files: 10 

日志文件的路径中可使用以下“变量”： 
%Y 年 (YYYY) 
%m 月 (MM) 
%d 日 (DD) 
%W 周 (00-52) 
%H 小时（24小时） (HH) 
%h 小时（12小时） (HH) 
%i 分 (mm) 
%s 秒 (ss) 
%u 用户名 
%% 表示“%”符号 

数据库 
worldguard可以将日志记录进mysql数据库，但需要先创建数据库和表，你可以使用下面的语句创建专用的表 

CREATE TABLE IF NOT EXISTS `blacklist_events` ( 
`id` int(11) NOT NULL AUTO_INCREMENT, 
`world` varchar(10) NOT NULL, 
`event` varchar(25) NOT NULL, 
`player` varchar(16) NOT NULL, 
`x` int(11) NOT NULL, 
`y` int(11) NOT NULL, 
`z` int(11) NOT NULL, 
`item` int(11) NOT NULL, 
`time` int(11) NOT NULL, 
`comment` varchar(255) DEFAULT NULL, 
PRIMARY KEY (`id`) 
); 

最后说一下，使用时发现，日志文件功能在某些平台下可能无法正常工作，同时会导致黑名单失效，开启此功能时请务必进行测试。
发射器的部分可能会和其他插件的发射器黑名单冲突导致报错。

=箱子保护=
WorldGuard提供基础的箱子保护服务，
玩家可以通过在箱子下方放置特殊字符的牌子来达到保护的目的。
我们不建议新设置的WorldGuard使用本功能因为本功能并不是WorldGuard常用的一部分
除此以外，区域设置是比本功能更好的保护拥有者财产的方法。
因为它不涉及像漏斗一类方块的问题。

提示：如果你是希望保护单块的方块，箱子等，
我们建议使用第三方保护插件。
例如Lockette 或者 LWC.

启用此功能：
首先箱子保护功能必须在配置文件中启用。
如果没有手动启用，箱子保护功能不会自动工作
这时不能使用牌子锁功能。(此项功能也可在配置文件中禁用)

使用方法：
# 必须是一个信息牌
# 必须位于箱子下面(如果是大箱子，只需在其一侧下面)
# 在第一行输入[Lock]
# 在第二行输入玩家的名字
# 在剩余两行写上其他允许使用玩家的名字
注：不可将其他玩家名字放在第二行的位置
提示：WorldGuard功能并不支持UUID功能
警告：由于Minecraft1.8版本的改变
从旧版本升级将会破坏掉所有的保护牌子
实际上它将破坏全部写有[]的牌子

=主机密码（登录密码）=
在过去由于Minecraft的登录代码问题，玩家可以登录到服务器的任何玩家包括拥有者和管理者的账号上，
在2010-2013年间，有五次利用该性质的漏洞经常导致成千上万的服务器被黑客攻击。

这项登录密码功能作为一个额外的登录屏障被添加到WorldGuard中。
其工作原理是作为一项额外的屏障来达到此功能，与Mojang的登录无关。
在登录时必须发送指定信息 (通俗的说就是输入你的密码)才能登录服务器。
即使攻击者有能力破坏Minecraft的登录系统来成为一个管理员。
但因在服务器缺少发送指定的信息，经服务器检测后无法活动。
注：这种登录验证方式的漏洞是很不明显的，很少见的。

启用功能：
当一个玩家通过某一个地址连接服务器时,输入play.example.com
Minecraft将会告诉服务器该玩家通过这个地址登录
管理者可以通过一个特殊的秘密语句来登录，
比如secretmod.play.example.com这个地址
服务器将会检测到该管理者登录使用的这个地址。
也就是一个类似密码的机制，不过密码是地址格式。

主机密码允许特定玩家使用特定地址登录，
如果地址错误，他将立即被踢下线

配置：

host-keys:
your_username: bagels.play.example.com
moderator1_name: manoverboard.play.example.com
提示:主机密码功能暂不支持UUID功能

DNS配置:
为了使此功能工作，你需要bagels.play.example.com 和 manoverboard.play.example.com 指向你的服务
然而不要在您使用的域名中添加域名的记录，因为很容易使得攻击者找出管理员域名从而登录。

相比之下，我们建议您安装通用地址-“wildcard addresses.”。例如设置了play.example.com，
这将意味着任何相同前缀会允许登录。（例如aa.play.example.com，ab.play.example.com，ac.play.example.com，等）。
提示：如果你没有一个域名或不能设置通配符地址，你可以使用xip.io。

=更多帮助=

你需要更多的帮助吗？我建议你 

你可以去[http://skq.me/irc/irc.esper.net/sk-dev/ IRC]提问 
注*IRC聊天频道是维基百科24小时开放的“聊天室” 

你可以在Twitter上联系[https://twitter.com/sk89q sk89q] 
sk89q是Worldguard的作者（也是Worldedit以及其他不少插件的作者） 

你可以查看[https://github.com/sk89q/worldguard/commits Changelog]（全英文，英文不好的直接跳过吧） 
Changelog就是更新信息（每次更新修改/增加/删除等等了什么） 

你如果有什么建议，或者发现了什么Bug可以到[http://youtrack.sk89q.com/issues?q=project%3A+WorldGuard 这里]反馈（全英文，英文不好的直接跳过吧）

WorldGuard

2015-10-12T15:11:56Z

Lichi2050：/* 设定优先权(priority)f */

Mcbbs发布贴http://www.mcbbs.net/thread-505810-1-1.html
='''配设文件'''=
=指令介绍=
==Region指令==
===定义和重定义区域（define和redifine）===

/region define 区域名称 (玩家1) (玩家2) （玩家...） 
/region def 区域名称 (玩家1) (玩家2) （玩家...） 
/region d 区域名称 (玩家1) (玩家2) （玩家...） 
（）内容为可选项，如果没有指定玩家，定义后的区域将会属于输入命令的玩家（可以设定多个拥有者） 

这个指令主要是创造区域，创造后才可以进行更多的设定，这个指令是没有限制区域大小的（根据WorldEdit选择的大小） 
玩家部分也可以设定为权限组，这个指令主要是给管理员使用，玩家会有另外一个指令 /claim 

/region define 区域名称 g:权限组名称玩家1 玩家2 
'''注*整个世界区域叫做 __global__'''

/region redefine 区域名称 
/region update 区域名称 
/region move 区域名称 

这个指令会重定义已定义区域，选择好新区域后，输入指令后就可以重定义指定区域 

===区域圈地（claim）===

/region claim 区域名称 (玩家1) (玩家2) (玩家...) 

'''注意！'''这个指令是在2010年11至12月出现的，是很早期的指令，比Bukkit都早，在不久的将来会受到改善！ 
这个指令和define指令非常相似，但是加入了一些其他设定 

如果配设内有启动claim功能，玩家将会被限制区域数量 
创造新区域时不可以重复区域名称，除非你是拥有者，那么就会重定义该区域 
新区域不可覆盖其他区域 
如果配设内有启动claim功能，重新新区域时可以覆盖玩家拥有的其他区域 
如果配设内有启动claim功能，玩家将会被限制区域大小 

===区域信息（information）===

/region info （-s）（世界名称）（区域名称） 

列出区域的详细信息，内含 

区域名称（区域类型，优先权） 
区域flags 
区域拥有者 
区域成员 
区域边界 

空的信息项不会显示 
在指令内加入-s 会在显示信息的同时选择该区域 
如果没有输入区域名称，插件会自动取读脚下的区域 

'''列子：查看“TownPlot”区域的信息'''
/region info townplot 

'''列子：查看地狱世界“TownPlot”区域的信息'''
/region info world_nether TownPlot 
 

===区域选择（select）===

/region select [区域名称] 
这个指令会选择区域 
如果没有输入区域名称，插件会自动取读脚下的区域 

'''列子：选择“TownPlot”区域'''
/region select townplot 

===区域表列（list）===

区域表列（list） 

/region list （页数）（-w 世界名称）（-p 玩家） 

'''列子：列出第一页区域列表'''
/region list 

'''列子：列出地狱世界第三页区域列表'''
/region list 3 -w world_nether 

同时也可以只显示"玩家"的区域，影藏其他区域，需要在指令内加入-p 玩家 

'''列子：列出玩家1的区域列表'''
/region list -p 玩家1 

===设定flag===

/region flag 区域名称 flag （-g 权限组） [-w 世界名称] （数据值） 
这个指令可以为区域设定flag，如果（数据值）没有填的话，选择的flag就会被清除（还原） 
你们必须明白区域优先权和父子区域的关系才可以正确的设定flag，所以最好去查看flag列表 

'''列子：“TownPlot”区域禁止pvp的flag''' 
/region flag townplot pvp deny 

'''列子：在“duduworld”世界“TownPlot”区域禁止pvp的flag''' 
/region flag townplot pvp -w duduworld deny 

'''列子：“TownPlot”区域设定欢迎信息的flag''' 
/region flag townplot greeting 欢迎你来到这个区域, %name%! 
进入“TownPlot”区域显示：欢迎你来到这个区域, 玩家ID! 

'''列子：“TownPlot”区域清除退出信息的flag''' 
/region flag townplot farewell 
效果：退出“TownPlot”区域时不显示退出信息 

===设定优先权(priority)f===

/region setpriority [区域名称] （-w 世界名称） [优先权] 
/region priority [区域名称] （-w 世界名称） [优先权] 
/region pri [区域名称] （-w 世界名称） [优先权] 

设定区域优先权，[优先权]处得填一个整数，可以是正数也可以是负数。 

===设定子区域（parent）===
===删除区域（remove）===
===区域传送（teleport）===
===区域管理（management）===
=权限介绍=
=regions教程=
==基础教程==
==flag列表==
===区域权限组===
==开发者 API==
===取读WorldGuard===
===基础权限===
===区域管理===
====查看Flags====
====取读一个区域====
===Javadocs===

查看[http://docs.sk89q.com/worldguard/apidocs/com/sk89q/worldguard/bukkit/WGBukkit.html Javadocs]

==数据格式==

'''Region数据都保存在regions.txt内. 打开后首先会有:'''

Region ID 
Region 类型(type) 

Worldguard3.0版本以下的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 
Priority 优先权（请勿设定为0） 
List of owners 拥有者列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 

Worldguard3.0版本以上的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 

Priority 优先权（请勿设定为0） 
ID of parent region 父regionID（设置过子region才会显示） 
List of owners 拥有者列表 
List of members 会员列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 
Exit message （退出region提示信息） 

拥有者以及会员数据保存方式: 
u: 玩家名称 
g: region权限组 

例如 
u:sk89q,u:tetsu,g:admins 

意思就是sk89q以及tetsu这两个玩家都在admins组内。

Flags数据保存方式: 
每一个flag都会有一个特殊的字母，例如Build就是b，通过一个+或者-我们能够查看这个flag的状态 
+就是启动 
-就是关闭/禁止 
如果没有+或- 那么代表这个flag默认就是启动的 
例如 
+bpmc-t-l-f-F 

{| class="wikitable"
|-
! Flag 名称 !! 代表字母
|-
| Passthrough || z
|-
| Build || b
|-
| PvP || p
|-
| Mob damage || m
|-
| Creeper explosion || c
|-
| TNT || t
|-
| Flint and steel || l
|-
| Fire spread || f
|-
| Lava fire spread || F
|}

=黑名单(Blacklist)=
worldguard黑名单可以指定玩家进行某些动作时的处理方法

比如：
阻止玩家挖掉金矿石。
当有人挖掘钻石块时通知在线管理员。
当玩家放置附魔台时，向放置者发送一条提示消息。

下面是一个黑名单的例子：

除admins,mods组以外禁止使用岩浆桶并向使用者发送自定义提示消息 
[lavabucket] 
ignore-groups=admins,mods 
on-use=deny,tell 
message=不可以使用岩浆桶呢喵！ 

禁止挖掉铁矿和金矿并提示默认消息同时通知在线管理员 
[goldore,ironore] 
ignore-groups=admins 
on-break=deny,tell,notify 

除admins组外禁止放置tnt 放置时会通知管理员并且踢出去 
[tnt] 
ignore-groups=admins 
on-place=deny,notify,kick 

黑名单配置文件

黑名单的配置文件保存在plugins\WorldGuard\worlds下面，每个世界都有单独的配置文件 
例子：

worlds/world/blacklist.txt 主世界 
worlds/world_the_end/blacklist.txt 末地 
worlds/mining_world/blacklist.txt 资源世界（如果服务器有多世界的话） 

提示
worldguard不支持多个世界共用同一个黑名单配置文件，但是你可以利用文件系统的“链接”实现。 
注意：编辑黑名单后需要用/wg reload重新加载才能生效 

格式： 

[物品或方块列表] 
事件=操作 
选项=值 

匹配规则： 

物品/方块列表可以填写数字id或bukkit的材料名（可参考 https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html） 
多个项目之间用半角逗号分隔 
[wood,brick,glass] 
还可以指定数据值如白桦木： 
[17:1] 
白桦木和丛林木： 
[17:1;3] 
指定数据值范围 
[wood:2-3] 
[wood:>=2,<=3] 
这些写法是可以混合使用的 
[wood:0;>=2,grass:1-2] 

事件：
{| class="wikitable"
|-
! Event !! Explanation
|-
| on-break || 破坏方块
|-
| on-destroy-with || 用此物品打破方块
|-
| on-place || 放置方块
|-
| on-use || 使用
|-
| on-interact || 交互，如右键门、拉杆、箱子等
|-
| on-drop || 丢弃特定物品
|-
| on-acquire || 获得物品
|-
| on-dispense || 针对发射器，发射特定物品
|-
|}

操作：
{| class="wikitable"
|-
! Action !! Explanation
|-
| deny || 阻止操作（黑名单模式）
|-
| allow || 允许操作（仅白名单模式）
|-
| notify || 发送通知消息给有worldguard.notify权限的人
|-
| log || 记录日志到终端、日志文件、数据库。
|-
| tell || 给玩家一个提示消息
|-
| kick || 踢出玩家
|-
| ban || 将玩家ban掉（永久性）
|-
|}

选项：
{| class="wikitable"
|-
! Option !! Explanation
|-
| ignore-groups || 忽略特定权限组，多个组用半角逗号分隔
|-
| ignore-perms || 忽略有特定权限的玩家，多个权限同样是用逗号分隔
|-
| comment || 自定义通知消息
|-
| message || 自定义tell的消息，可用%s表示相应物品名
|}

另外一个列子

放置和打破信标时通知在线管理员 
[beacon] 
on-break=notify 
on-place=notify 
阻止用钻石镐和金铲子破坏方块 
[diamond_pickaxe,284] 
on-destroy-with=tell,deny 
阻止使用铁锄、钻石剑耕地和攻击 
[iron_hoe,276] 
on-use=tell,deny 
阻止与箱子、石头按钮交互 
[chest,stone_button] 
on-interact=deny,tell 
阻止丢出命令方块 
[commandblock] 
on-drop=deny,tell 
message=不要乱丢命令方块～ 
除admins组外阻止获得基岩 
[bedrock] 
on-acquire=deny 
ignore-groups=admins 
阻止发射器发射岩浆桶和漏斗矿车 
[lavabucket,hopper_minecart] 
on-dispense=deny,log,notify 
[tnt] 
on-break=deny,notify,kick 
on-use=deny,notify,kick 
on-place=deny,ban 
on-acquire=deny 

日志
日志有三种选择
* 输出到终端（就是服务器后台）
* 记录日志到文件
* 记录到数据库

在worldguard配置文件（plugins\WorldGuard\config.yml）中可以对日志文件和数据库进行具体设置。

blacklist: 
use-as-whitelist: false 
logging: 
console: 
enable: true 
database: 
enable: false 
dsn: jdbc:mysql://localhost:3306/minecraft 
user: root 
pass: '' 
table: blacklist_events 
file: 
enable: false 
path: worldguard/logs/%Y-%m-%d.log 
open-files: 10 

日志文件的路径中可使用以下“变量”： 
%Y 年 (YYYY) 
%m 月 (MM) 
%d 日 (DD) 
%W 周 (00-52) 
%H 小时（24小时） (HH) 
%h 小时（12小时） (HH) 
%i 分 (mm) 
%s 秒 (ss) 
%u 用户名 
%% 表示“%”符号 

数据库 
worldguard可以将日志记录进mysql数据库，但需要先创建数据库和表，你可以使用下面的语句创建专用的表 

CREATE TABLE IF NOT EXISTS `blacklist_events` ( 
`id` int(11) NOT NULL AUTO_INCREMENT, 
`world` varchar(10) NOT NULL, 
`event` varchar(25) NOT NULL, 
`player` varchar(16) NOT NULL, 
`x` int(11) NOT NULL, 
`y` int(11) NOT NULL, 
`z` int(11) NOT NULL, 
`item` int(11) NOT NULL, 
`time` int(11) NOT NULL, 
`comment` varchar(255) DEFAULT NULL, 
PRIMARY KEY (`id`) 
); 

最后说一下，使用时发现，日志文件功能在某些平台下可能无法正常工作，同时会导致黑名单失效，开启此功能时请务必进行测试。
发射器的部分可能会和其他插件的发射器黑名单冲突导致报错。

=箱子保护=
WorldGuard提供基础的箱子保护服务，
玩家可以通过在箱子下方放置特殊字符的牌子来达到保护的目的。
我们不建议新设置的WorldGuard使用本功能因为本功能并不是WorldGuard常用的一部分
除此以外，区域设置是比本功能更好的保护拥有者财产的方法。
因为它不涉及像漏斗一类方块的问题。

提示：如果你是希望保护单块的方块，箱子等，
我们建议使用第三方保护插件。
例如Lockette 或者 LWC.

启用此功能：
首先箱子保护功能必须在配置文件中启用。
如果没有手动启用，箱子保护功能不会自动工作
这时不能使用牌子锁功能。(此项功能也可在配置文件中禁用)

使用方法：
# 必须是一个信息牌
# 必须位于箱子下面(如果是大箱子，只需在其一侧下面)
# 在第一行输入[Lock]
# 在第二行输入玩家的名字
# 在剩余两行写上其他允许使用玩家的名字
注：不可将其他玩家名字放在第二行的位置
提示：WorldGuard功能并不支持UUID功能
警告：由于Minecraft1.8版本的改变
从旧版本升级将会破坏掉所有的保护牌子
实际上它将破坏全部写有[]的牌子

=主机密码（登录密码）=
在过去由于Minecraft的登录代码问题，玩家可以登录到服务器的任何玩家包括拥有者和管理者的账号上，
在2010-2013年间，有五次利用该性质的漏洞经常导致成千上万的服务器被黑客攻击。

这项登录密码功能作为一个额外的登录屏障被添加到WorldGuard中。
其工作原理是作为一项额外的屏障来达到此功能，与Mojang的登录无关。
在登录时必须发送指定信息 (通俗的说就是输入你的密码)才能登录服务器。
即使攻击者有能力破坏Minecraft的登录系统来成为一个管理员。
但因在服务器缺少发送指定的信息，经服务器检测后无法活动。
注：这种登录验证方式的漏洞是很不明显的，很少见的。

启用功能：
当一个玩家通过某一个地址连接服务器时,输入play.example.com
Minecraft将会告诉服务器该玩家通过这个地址登录
管理者可以通过一个特殊的秘密语句来登录，
比如secretmod.play.example.com这个地址
服务器将会检测到该管理者登录使用的这个地址。
也就是一个类似密码的机制，不过密码是地址格式。

主机密码允许特定玩家使用特定地址登录，
如果地址错误，他将立即被踢下线

配置：

host-keys:
your_username: bagels.play.example.com
moderator1_name: manoverboard.play.example.com
提示:主机密码功能暂不支持UUID功能

DNS配置:
为了使此功能工作，你需要bagels.play.example.com 和 manoverboard.play.example.com 指向你的服务
然而不要在您使用的域名中添加域名的记录，因为很容易使得攻击者找出管理员域名从而登录。

相比之下，我们建议您安装通用地址-“wildcard addresses.”。例如设置了play.example.com，
这将意味着任何相同前缀会允许登录。（例如aa.play.example.com，ab.play.example.com，ac.play.example.com，等）。
提示：如果你没有一个域名或不能设置通配符地址，你可以使用xip.io。

=更多帮助=

你需要更多的帮助吗？我建议你 

你可以去[http://skq.me/irc/irc.esper.net/sk-dev/ IRC]提问 
注*IRC聊天频道是维基百科24小时开放的“聊天室” 

你可以在Twitter上联系[https://twitter.com/sk89q sk89q] 
sk89q是Worldguard的作者（也是Worldedit以及其他不少插件的作者） 

你可以查看[https://github.com/sk89q/worldguard/commits Changelog]（全英文，英文不好的直接跳过吧） 
Changelog就是更新信息（每次更新修改/增加/删除等等了什么） 

你如果有什么建议，或者发现了什么Bug可以到[http://youtrack.sk89q.com/issues?q=project%3A+WorldGuard 这里]反馈（全英文，英文不好的直接跳过吧）

WorldGuard

2015-10-12T15:11:36Z

Lichi2050：/* 设定flag */

Mcbbs发布贴http://www.mcbbs.net/thread-505810-1-1.html
='''配设文件'''=
=指令介绍=
==Region指令==
===定义和重定义区域（define和redifine）===

/region define 区域名称 (玩家1) (玩家2) （玩家...） 
/region def 区域名称 (玩家1) (玩家2) （玩家...） 
/region d 区域名称 (玩家1) (玩家2) （玩家...） 
（）内容为可选项，如果没有指定玩家，定义后的区域将会属于输入命令的玩家（可以设定多个拥有者） 

这个指令主要是创造区域，创造后才可以进行更多的设定，这个指令是没有限制区域大小的（根据WorldEdit选择的大小） 
玩家部分也可以设定为权限组，这个指令主要是给管理员使用，玩家会有另外一个指令 /claim 

/region define 区域名称 g:权限组名称玩家1 玩家2 
'''注*整个世界区域叫做 __global__'''

/region redefine 区域名称 
/region update 区域名称 
/region move 区域名称 

这个指令会重定义已定义区域，选择好新区域后，输入指令后就可以重定义指定区域 

===区域圈地（claim）===

/region claim 区域名称 (玩家1) (玩家2) (玩家...) 

'''注意！'''这个指令是在2010年11至12月出现的，是很早期的指令，比Bukkit都早，在不久的将来会受到改善！ 
这个指令和define指令非常相似，但是加入了一些其他设定 

如果配设内有启动claim功能，玩家将会被限制区域数量 
创造新区域时不可以重复区域名称，除非你是拥有者，那么就会重定义该区域 
新区域不可覆盖其他区域 
如果配设内有启动claim功能，重新新区域时可以覆盖玩家拥有的其他区域 
如果配设内有启动claim功能，玩家将会被限制区域大小 

===区域信息（information）===

/region info （-s）（世界名称）（区域名称） 

列出区域的详细信息，内含 

区域名称（区域类型，优先权） 
区域flags 
区域拥有者 
区域成员 
区域边界 

空的信息项不会显示 
在指令内加入-s 会在显示信息的同时选择该区域 
如果没有输入区域名称，插件会自动取读脚下的区域 

'''列子：查看“TownPlot”区域的信息'''
/region info townplot 

'''列子：查看地狱世界“TownPlot”区域的信息'''
/region info world_nether TownPlot 
 

===区域选择（select）===

/region select [区域名称] 
这个指令会选择区域 
如果没有输入区域名称，插件会自动取读脚下的区域 

'''列子：选择“TownPlot”区域'''
/region select townplot 

===区域表列（list）===

区域表列（list） 

/region list （页数）（-w 世界名称）（-p 玩家） 

'''列子：列出第一页区域列表'''
/region list 

'''列子：列出地狱世界第三页区域列表'''
/region list 3 -w world_nether 

同时也可以只显示"玩家"的区域，影藏其他区域，需要在指令内加入-p 玩家 

'''列子：列出玩家1的区域列表'''
/region list -p 玩家1 

===设定flag===

/region flag 区域名称 flag （-g 权限组） [-w 世界名称] （数据值） 
这个指令可以为区域设定flag，如果（数据值）没有填的话，选择的flag就会被清除（还原） 
你们必须明白区域优先权和父子区域的关系才可以正确的设定flag，所以最好去查看flag列表 

'''列子：“TownPlot”区域禁止pvp的flag''' 
/region flag townplot pvp deny 

'''列子：在“duduworld”世界“TownPlot”区域禁止pvp的flag''' 
/region flag townplot pvp -w duduworld deny 

'''列子：“TownPlot”区域设定欢迎信息的flag''' 
/region flag townplot greeting 欢迎你来到这个区域, %name%! 
进入“TownPlot”区域显示：欢迎你来到这个区域, 玩家ID! 

'''列子：“TownPlot”区域清除退出信息的flag''' 
/region flag townplot farewell 
效果：退出“TownPlot”区域时不显示退出信息 

===设定优先权(priority)f===
===设定子区域（parent）===
===删除区域（remove）===
===区域传送（teleport）===
===区域管理（management）===
=权限介绍=
=regions教程=
==基础教程==
==flag列表==
===区域权限组===
==开发者 API==
===取读WorldGuard===
===基础权限===
===区域管理===
====查看Flags====
====取读一个区域====
===Javadocs===

查看[http://docs.sk89q.com/worldguard/apidocs/com/sk89q/worldguard/bukkit/WGBukkit.html Javadocs]

==数据格式==

'''Region数据都保存在regions.txt内. 打开后首先会有:'''

Region ID 
Region 类型(type) 

Worldguard3.0版本以下的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 
Priority 优先权（请勿设定为0） 
List of owners 拥有者列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 

Worldguard3.0版本以上的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 

Priority 优先权（请勿设定为0） 
ID of parent region 父regionID（设置过子region才会显示） 
List of owners 拥有者列表 
List of members 会员列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 
Exit message （退出region提示信息） 

拥有者以及会员数据保存方式: 
u: 玩家名称 
g: region权限组 

例如 
u:sk89q,u:tetsu,g:admins 

意思就是sk89q以及tetsu这两个玩家都在admins组内。

Flags数据保存方式: 
每一个flag都会有一个特殊的字母，例如Build就是b，通过一个+或者-我们能够查看这个flag的状态 
+就是启动 
-就是关闭/禁止 
如果没有+或- 那么代表这个flag默认就是启动的 
例如 
+bpmc-t-l-f-F 

{| class="wikitable"
|-
! Flag 名称 !! 代表字母
|-
| Passthrough || z
|-
| Build || b
|-
| PvP || p
|-
| Mob damage || m
|-
| Creeper explosion || c
|-
| TNT || t
|-
| Flint and steel || l
|-
| Fire spread || f
|-
| Lava fire spread || F
|}

=黑名单(Blacklist)=
worldguard黑名单可以指定玩家进行某些动作时的处理方法

比如：
阻止玩家挖掉金矿石。
当有人挖掘钻石块时通知在线管理员。
当玩家放置附魔台时，向放置者发送一条提示消息。

下面是一个黑名单的例子：

除admins,mods组以外禁止使用岩浆桶并向使用者发送自定义提示消息 
[lavabucket] 
ignore-groups=admins,mods 
on-use=deny,tell 
message=不可以使用岩浆桶呢喵！ 

禁止挖掉铁矿和金矿并提示默认消息同时通知在线管理员 
[goldore,ironore] 
ignore-groups=admins 
on-break=deny,tell,notify 

除admins组外禁止放置tnt 放置时会通知管理员并且踢出去 
[tnt] 
ignore-groups=admins 
on-place=deny,notify,kick 

黑名单配置文件

黑名单的配置文件保存在plugins\WorldGuard\worlds下面，每个世界都有单独的配置文件 
例子：

worlds/world/blacklist.txt 主世界 
worlds/world_the_end/blacklist.txt 末地 
worlds/mining_world/blacklist.txt 资源世界（如果服务器有多世界的话） 

提示
worldguard不支持多个世界共用同一个黑名单配置文件，但是你可以利用文件系统的“链接”实现。 
注意：编辑黑名单后需要用/wg reload重新加载才能生效 

格式： 

[物品或方块列表] 
事件=操作 
选项=值 

匹配规则： 

物品/方块列表可以填写数字id或bukkit的材料名（可参考 https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html） 
多个项目之间用半角逗号分隔 
[wood,brick,glass] 
还可以指定数据值如白桦木： 
[17:1] 
白桦木和丛林木： 
[17:1;3] 
指定数据值范围 
[wood:2-3] 
[wood:>=2,<=3] 
这些写法是可以混合使用的 
[wood:0;>=2,grass:1-2] 

事件：
{| class="wikitable"
|-
! Event !! Explanation
|-
| on-break || 破坏方块
|-
| on-destroy-with || 用此物品打破方块
|-
| on-place || 放置方块
|-
| on-use || 使用
|-
| on-interact || 交互，如右键门、拉杆、箱子等
|-
| on-drop || 丢弃特定物品
|-
| on-acquire || 获得物品
|-
| on-dispense || 针对发射器，发射特定物品
|-
|}

操作：
{| class="wikitable"
|-
! Action !! Explanation
|-
| deny || 阻止操作（黑名单模式）
|-
| allow || 允许操作（仅白名单模式）
|-
| notify || 发送通知消息给有worldguard.notify权限的人
|-
| log || 记录日志到终端、日志文件、数据库。
|-
| tell || 给玩家一个提示消息
|-
| kick || 踢出玩家
|-
| ban || 将玩家ban掉（永久性）
|-
|}

选项：
{| class="wikitable"
|-
! Option !! Explanation
|-
| ignore-groups || 忽略特定权限组，多个组用半角逗号分隔
|-
| ignore-perms || 忽略有特定权限的玩家，多个权限同样是用逗号分隔
|-
| comment || 自定义通知消息
|-
| message || 自定义tell的消息，可用%s表示相应物品名
|}

另外一个列子

放置和打破信标时通知在线管理员 
[beacon] 
on-break=notify 
on-place=notify 
阻止用钻石镐和金铲子破坏方块 
[diamond_pickaxe,284] 
on-destroy-with=tell,deny 
阻止使用铁锄、钻石剑耕地和攻击 
[iron_hoe,276] 
on-use=tell,deny 
阻止与箱子、石头按钮交互 
[chest,stone_button] 
on-interact=deny,tell 
阻止丢出命令方块 
[commandblock] 
on-drop=deny,tell 
message=不要乱丢命令方块～ 
除admins组外阻止获得基岩 
[bedrock] 
on-acquire=deny 
ignore-groups=admins 
阻止发射器发射岩浆桶和漏斗矿车 
[lavabucket,hopper_minecart] 
on-dispense=deny,log,notify 
[tnt] 
on-break=deny,notify,kick 
on-use=deny,notify,kick 
on-place=deny,ban 
on-acquire=deny 

日志
日志有三种选择
* 输出到终端（就是服务器后台）
* 记录日志到文件
* 记录到数据库

在worldguard配置文件（plugins\WorldGuard\config.yml）中可以对日志文件和数据库进行具体设置。

blacklist: 
use-as-whitelist: false 
logging: 
console: 
enable: true 
database: 
enable: false 
dsn: jdbc:mysql://localhost:3306/minecraft 
user: root 
pass: '' 
table: blacklist_events 
file: 
enable: false 
path: worldguard/logs/%Y-%m-%d.log 
open-files: 10 

日志文件的路径中可使用以下“变量”： 
%Y 年 (YYYY) 
%m 月 (MM) 
%d 日 (DD) 
%W 周 (00-52) 
%H 小时（24小时） (HH) 
%h 小时（12小时） (HH) 
%i 分 (mm) 
%s 秒 (ss) 
%u 用户名 
%% 表示“%”符号 

数据库 
worldguard可以将日志记录进mysql数据库，但需要先创建数据库和表，你可以使用下面的语句创建专用的表 

CREATE TABLE IF NOT EXISTS `blacklist_events` ( 
`id` int(11) NOT NULL AUTO_INCREMENT, 
`world` varchar(10) NOT NULL, 
`event` varchar(25) NOT NULL, 
`player` varchar(16) NOT NULL, 
`x` int(11) NOT NULL, 
`y` int(11) NOT NULL, 
`z` int(11) NOT NULL, 
`item` int(11) NOT NULL, 
`time` int(11) NOT NULL, 
`comment` varchar(255) DEFAULT NULL, 
PRIMARY KEY (`id`) 
); 

最后说一下，使用时发现，日志文件功能在某些平台下可能无法正常工作，同时会导致黑名单失效，开启此功能时请务必进行测试。
发射器的部分可能会和其他插件的发射器黑名单冲突导致报错。

=箱子保护=
WorldGuard提供基础的箱子保护服务，
玩家可以通过在箱子下方放置特殊字符的牌子来达到保护的目的。
我们不建议新设置的WorldGuard使用本功能因为本功能并不是WorldGuard常用的一部分
除此以外，区域设置是比本功能更好的保护拥有者财产的方法。
因为它不涉及像漏斗一类方块的问题。

提示：如果你是希望保护单块的方块，箱子等，
我们建议使用第三方保护插件。
例如Lockette 或者 LWC.

启用此功能：
首先箱子保护功能必须在配置文件中启用。
如果没有手动启用，箱子保护功能不会自动工作
这时不能使用牌子锁功能。(此项功能也可在配置文件中禁用)

使用方法：
# 必须是一个信息牌
# 必须位于箱子下面(如果是大箱子，只需在其一侧下面)
# 在第一行输入[Lock]
# 在第二行输入玩家的名字
# 在剩余两行写上其他允许使用玩家的名字
注：不可将其他玩家名字放在第二行的位置
提示：WorldGuard功能并不支持UUID功能
警告：由于Minecraft1.8版本的改变
从旧版本升级将会破坏掉所有的保护牌子
实际上它将破坏全部写有[]的牌子

=主机密码（登录密码）=
在过去由于Minecraft的登录代码问题，玩家可以登录到服务器的任何玩家包括拥有者和管理者的账号上，
在2010-2013年间，有五次利用该性质的漏洞经常导致成千上万的服务器被黑客攻击。

这项登录密码功能作为一个额外的登录屏障被添加到WorldGuard中。
其工作原理是作为一项额外的屏障来达到此功能，与Mojang的登录无关。
在登录时必须发送指定信息 (通俗的说就是输入你的密码)才能登录服务器。
即使攻击者有能力破坏Minecraft的登录系统来成为一个管理员。
但因在服务器缺少发送指定的信息，经服务器检测后无法活动。
注：这种登录验证方式的漏洞是很不明显的，很少见的。

启用功能：
当一个玩家通过某一个地址连接服务器时,输入play.example.com
Minecraft将会告诉服务器该玩家通过这个地址登录
管理者可以通过一个特殊的秘密语句来登录，
比如secretmod.play.example.com这个地址
服务器将会检测到该管理者登录使用的这个地址。
也就是一个类似密码的机制，不过密码是地址格式。

主机密码允许特定玩家使用特定地址登录，
如果地址错误，他将立即被踢下线

配置：

host-keys:
your_username: bagels.play.example.com
moderator1_name: manoverboard.play.example.com
提示:主机密码功能暂不支持UUID功能

DNS配置:
为了使此功能工作，你需要bagels.play.example.com 和 manoverboard.play.example.com 指向你的服务
然而不要在您使用的域名中添加域名的记录，因为很容易使得攻击者找出管理员域名从而登录。

相比之下，我们建议您安装通用地址-“wildcard addresses.”。例如设置了play.example.com，
这将意味着任何相同前缀会允许登录。（例如aa.play.example.com，ab.play.example.com，ac.play.example.com，等）。
提示：如果你没有一个域名或不能设置通配符地址，你可以使用xip.io。

=更多帮助=

你需要更多的帮助吗？我建议你 

你可以去[http://skq.me/irc/irc.esper.net/sk-dev/ IRC]提问 
注*IRC聊天频道是维基百科24小时开放的“聊天室” 

你可以在Twitter上联系[https://twitter.com/sk89q sk89q] 
sk89q是Worldguard的作者（也是Worldedit以及其他不少插件的作者） 

你可以查看[https://github.com/sk89q/worldguard/commits Changelog]（全英文，英文不好的直接跳过吧） 
Changelog就是更新信息（每次更新修改/增加/删除等等了什么） 

你如果有什么建议，或者发现了什么Bug可以到[http://youtrack.sk89q.com/issues?q=project%3A+WorldGuard 这里]反馈（全英文，英文不好的直接跳过吧）

WorldGuard

2015-10-12T15:10:15Z

Lichi2050：/* 区域表列（list） */

Mcbbs发布贴http://www.mcbbs.net/thread-505810-1-1.html
='''配设文件'''=
=指令介绍=
==Region指令==
===定义和重定义区域（define和redifine）===

/region define 区域名称 (玩家1) (玩家2) （玩家...） 
/region def 区域名称 (玩家1) (玩家2) （玩家...） 
/region d 区域名称 (玩家1) (玩家2) （玩家...） 
（）内容为可选项，如果没有指定玩家，定义后的区域将会属于输入命令的玩家（可以设定多个拥有者） 

这个指令主要是创造区域，创造后才可以进行更多的设定，这个指令是没有限制区域大小的（根据WorldEdit选择的大小） 
玩家部分也可以设定为权限组，这个指令主要是给管理员使用，玩家会有另外一个指令 /claim 

/region define 区域名称 g:权限组名称玩家1 玩家2 
'''注*整个世界区域叫做 __global__'''

/region redefine 区域名称 
/region update 区域名称 
/region move 区域名称 

这个指令会重定义已定义区域，选择好新区域后，输入指令后就可以重定义指定区域 

===区域圈地（claim）===

/region claim 区域名称 (玩家1) (玩家2) (玩家...) 

'''注意！'''这个指令是在2010年11至12月出现的，是很早期的指令，比Bukkit都早，在不久的将来会受到改善！ 
这个指令和define指令非常相似，但是加入了一些其他设定 

如果配设内有启动claim功能，玩家将会被限制区域数量 
创造新区域时不可以重复区域名称，除非你是拥有者，那么就会重定义该区域 
新区域不可覆盖其他区域 
如果配设内有启动claim功能，重新新区域时可以覆盖玩家拥有的其他区域 
如果配设内有启动claim功能，玩家将会被限制区域大小 

===区域信息（information）===

/region info （-s）（世界名称）（区域名称） 

列出区域的详细信息，内含 

区域名称（区域类型，优先权） 
区域flags 
区域拥有者 
区域成员 
区域边界 

空的信息项不会显示 
在指令内加入-s 会在显示信息的同时选择该区域 
如果没有输入区域名称，插件会自动取读脚下的区域 

'''列子：查看“TownPlot”区域的信息'''
/region info townplot 

'''列子：查看地狱世界“TownPlot”区域的信息'''
/region info world_nether TownPlot 
 

===区域选择（select）===

/region select [区域名称] 
这个指令会选择区域 
如果没有输入区域名称，插件会自动取读脚下的区域 

'''列子：选择“TownPlot”区域'''
/region select townplot 

===区域表列（list）===

区域表列（list） 

/region list （页数）（-w 世界名称）（-p 玩家） 

'''列子：列出第一页区域列表'''
/region list 

'''列子：列出地狱世界第三页区域列表'''
/region list 3 -w world_nether 

同时也可以只显示"玩家"的区域，影藏其他区域，需要在指令内加入-p 玩家 

'''列子：列出玩家1的区域列表'''
/region list -p 玩家1 

===设定flag===
===设定优先权(priority)f===
===设定子区域（parent）===
===删除区域（remove）===
===区域传送（teleport）===
===区域管理（management）===
=权限介绍=
=regions教程=
==基础教程==
==flag列表==
===区域权限组===
==开发者 API==
===取读WorldGuard===
===基础权限===
===区域管理===
====查看Flags====
====取读一个区域====
===Javadocs===

查看[http://docs.sk89q.com/worldguard/apidocs/com/sk89q/worldguard/bukkit/WGBukkit.html Javadocs]

==数据格式==

'''Region数据都保存在regions.txt内. 打开后首先会有:'''

Region ID 
Region 类型(type) 

Worldguard3.0版本以下的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 
Priority 优先权（请勿设定为0） 
List of owners 拥有者列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 

Worldguard3.0版本以上的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 

Priority 优先权（请勿设定为0） 
ID of parent region 父regionID（设置过子region才会显示） 
List of owners 拥有者列表 
List of members 会员列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 
Exit message （退出region提示信息） 

拥有者以及会员数据保存方式: 
u: 玩家名称 
g: region权限组 

例如 
u:sk89q,u:tetsu,g:admins 

意思就是sk89q以及tetsu这两个玩家都在admins组内。

Flags数据保存方式: 
每一个flag都会有一个特殊的字母，例如Build就是b，通过一个+或者-我们能够查看这个flag的状态 
+就是启动 
-就是关闭/禁止 
如果没有+或- 那么代表这个flag默认就是启动的 
例如 
+bpmc-t-l-f-F 

{| class="wikitable"
|-
! Flag 名称 !! 代表字母
|-
| Passthrough || z
|-
| Build || b
|-
| PvP || p
|-
| Mob damage || m
|-
| Creeper explosion || c
|-
| TNT || t
|-
| Flint and steel || l
|-
| Fire spread || f
|-
| Lava fire spread || F
|}

=黑名单(Blacklist)=
worldguard黑名单可以指定玩家进行某些动作时的处理方法

比如：
阻止玩家挖掉金矿石。
当有人挖掘钻石块时通知在线管理员。
当玩家放置附魔台时，向放置者发送一条提示消息。

下面是一个黑名单的例子：

除admins,mods组以外禁止使用岩浆桶并向使用者发送自定义提示消息 
[lavabucket] 
ignore-groups=admins,mods 
on-use=deny,tell 
message=不可以使用岩浆桶呢喵！ 

禁止挖掉铁矿和金矿并提示默认消息同时通知在线管理员 
[goldore,ironore] 
ignore-groups=admins 
on-break=deny,tell,notify 

除admins组外禁止放置tnt 放置时会通知管理员并且踢出去 
[tnt] 
ignore-groups=admins 
on-place=deny,notify,kick 

黑名单配置文件

黑名单的配置文件保存在plugins\WorldGuard\worlds下面，每个世界都有单独的配置文件 
例子：

worlds/world/blacklist.txt 主世界 
worlds/world_the_end/blacklist.txt 末地 
worlds/mining_world/blacklist.txt 资源世界（如果服务器有多世界的话） 

提示
worldguard不支持多个世界共用同一个黑名单配置文件，但是你可以利用文件系统的“链接”实现。 
注意：编辑黑名单后需要用/wg reload重新加载才能生效 

格式： 

[物品或方块列表] 
事件=操作 
选项=值 

匹配规则： 

物品/方块列表可以填写数字id或bukkit的材料名（可参考 https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html） 
多个项目之间用半角逗号分隔 
[wood,brick,glass] 
还可以指定数据值如白桦木： 
[17:1] 
白桦木和丛林木： 
[17:1;3] 
指定数据值范围 
[wood:2-3] 
[wood:>=2,<=3] 
这些写法是可以混合使用的 
[wood:0;>=2,grass:1-2] 

事件：
{| class="wikitable"
|-
! Event !! Explanation
|-
| on-break || 破坏方块
|-
| on-destroy-with || 用此物品打破方块
|-
| on-place || 放置方块
|-
| on-use || 使用
|-
| on-interact || 交互，如右键门、拉杆、箱子等
|-
| on-drop || 丢弃特定物品
|-
| on-acquire || 获得物品
|-
| on-dispense || 针对发射器，发射特定物品
|-
|}

操作：
{| class="wikitable"
|-
! Action !! Explanation
|-
| deny || 阻止操作（黑名单模式）
|-
| allow || 允许操作（仅白名单模式）
|-
| notify || 发送通知消息给有worldguard.notify权限的人
|-
| log || 记录日志到终端、日志文件、数据库。
|-
| tell || 给玩家一个提示消息
|-
| kick || 踢出玩家
|-
| ban || 将玩家ban掉（永久性）
|-
|}

选项：
{| class="wikitable"
|-
! Option !! Explanation
|-
| ignore-groups || 忽略特定权限组，多个组用半角逗号分隔
|-
| ignore-perms || 忽略有特定权限的玩家，多个权限同样是用逗号分隔
|-
| comment || 自定义通知消息
|-
| message || 自定义tell的消息，可用%s表示相应物品名
|}

另外一个列子

放置和打破信标时通知在线管理员 
[beacon] 
on-break=notify 
on-place=notify 
阻止用钻石镐和金铲子破坏方块 
[diamond_pickaxe,284] 
on-destroy-with=tell,deny 
阻止使用铁锄、钻石剑耕地和攻击 
[iron_hoe,276] 
on-use=tell,deny 
阻止与箱子、石头按钮交互 
[chest,stone_button] 
on-interact=deny,tell 
阻止丢出命令方块 
[commandblock] 
on-drop=deny,tell 
message=不要乱丢命令方块～ 
除admins组外阻止获得基岩 
[bedrock] 
on-acquire=deny 
ignore-groups=admins 
阻止发射器发射岩浆桶和漏斗矿车 
[lavabucket,hopper_minecart] 
on-dispense=deny,log,notify 
[tnt] 
on-break=deny,notify,kick 
on-use=deny,notify,kick 
on-place=deny,ban 
on-acquire=deny 

日志
日志有三种选择
* 输出到终端（就是服务器后台）
* 记录日志到文件
* 记录到数据库

在worldguard配置文件（plugins\WorldGuard\config.yml）中可以对日志文件和数据库进行具体设置。

blacklist: 
use-as-whitelist: false 
logging: 
console: 
enable: true 
database: 
enable: false 
dsn: jdbc:mysql://localhost:3306/minecraft 
user: root 
pass: '' 
table: blacklist_events 
file: 
enable: false 
path: worldguard/logs/%Y-%m-%d.log 
open-files: 10 

日志文件的路径中可使用以下“变量”： 
%Y 年 (YYYY) 
%m 月 (MM) 
%d 日 (DD) 
%W 周 (00-52) 
%H 小时（24小时） (HH) 
%h 小时（12小时） (HH) 
%i 分 (mm) 
%s 秒 (ss) 
%u 用户名 
%% 表示“%”符号 

数据库 
worldguard可以将日志记录进mysql数据库，但需要先创建数据库和表，你可以使用下面的语句创建专用的表 

CREATE TABLE IF NOT EXISTS `blacklist_events` ( 
`id` int(11) NOT NULL AUTO_INCREMENT, 
`world` varchar(10) NOT NULL, 
`event` varchar(25) NOT NULL, 
`player` varchar(16) NOT NULL, 
`x` int(11) NOT NULL, 
`y` int(11) NOT NULL, 
`z` int(11) NOT NULL, 
`item` int(11) NOT NULL, 
`time` int(11) NOT NULL, 
`comment` varchar(255) DEFAULT NULL, 
PRIMARY KEY (`id`) 
); 

最后说一下，使用时发现，日志文件功能在某些平台下可能无法正常工作，同时会导致黑名单失效，开启此功能时请务必进行测试。
发射器的部分可能会和其他插件的发射器黑名单冲突导致报错。

=箱子保护=
WorldGuard提供基础的箱子保护服务，
玩家可以通过在箱子下方放置特殊字符的牌子来达到保护的目的。
我们不建议新设置的WorldGuard使用本功能因为本功能并不是WorldGuard常用的一部分
除此以外，区域设置是比本功能更好的保护拥有者财产的方法。
因为它不涉及像漏斗一类方块的问题。

提示：如果你是希望保护单块的方块，箱子等，
我们建议使用第三方保护插件。
例如Lockette 或者 LWC.

启用此功能：
首先箱子保护功能必须在配置文件中启用。
如果没有手动启用，箱子保护功能不会自动工作
这时不能使用牌子锁功能。(此项功能也可在配置文件中禁用)

使用方法：
# 必须是一个信息牌
# 必须位于箱子下面(如果是大箱子，只需在其一侧下面)
# 在第一行输入[Lock]
# 在第二行输入玩家的名字
# 在剩余两行写上其他允许使用玩家的名字
注：不可将其他玩家名字放在第二行的位置
提示：WorldGuard功能并不支持UUID功能
警告：由于Minecraft1.8版本的改变
从旧版本升级将会破坏掉所有的保护牌子
实际上它将破坏全部写有[]的牌子

=主机密码（登录密码）=
在过去由于Minecraft的登录代码问题，玩家可以登录到服务器的任何玩家包括拥有者和管理者的账号上，
在2010-2013年间，有五次利用该性质的漏洞经常导致成千上万的服务器被黑客攻击。

这项登录密码功能作为一个额外的登录屏障被添加到WorldGuard中。
其工作原理是作为一项额外的屏障来达到此功能，与Mojang的登录无关。
在登录时必须发送指定信息 (通俗的说就是输入你的密码)才能登录服务器。
即使攻击者有能力破坏Minecraft的登录系统来成为一个管理员。
但因在服务器缺少发送指定的信息，经服务器检测后无法活动。
注：这种登录验证方式的漏洞是很不明显的，很少见的。

启用功能：
当一个玩家通过某一个地址连接服务器时,输入play.example.com
Minecraft将会告诉服务器该玩家通过这个地址登录
管理者可以通过一个特殊的秘密语句来登录，
比如secretmod.play.example.com这个地址
服务器将会检测到该管理者登录使用的这个地址。
也就是一个类似密码的机制，不过密码是地址格式。

主机密码允许特定玩家使用特定地址登录，
如果地址错误，他将立即被踢下线

配置：

host-keys:
your_username: bagels.play.example.com
moderator1_name: manoverboard.play.example.com
提示:主机密码功能暂不支持UUID功能

DNS配置:
为了使此功能工作，你需要bagels.play.example.com 和 manoverboard.play.example.com 指向你的服务
然而不要在您使用的域名中添加域名的记录，因为很容易使得攻击者找出管理员域名从而登录。

相比之下，我们建议您安装通用地址-“wildcard addresses.”。例如设置了play.example.com，
这将意味着任何相同前缀会允许登录。（例如aa.play.example.com，ab.play.example.com，ac.play.example.com，等）。
提示：如果你没有一个域名或不能设置通配符地址，你可以使用xip.io。

=更多帮助=

你需要更多的帮助吗？我建议你 

你可以去[http://skq.me/irc/irc.esper.net/sk-dev/ IRC]提问 
注*IRC聊天频道是维基百科24小时开放的“聊天室” 

你可以在Twitter上联系[https://twitter.com/sk89q sk89q] 
sk89q是Worldguard的作者（也是Worldedit以及其他不少插件的作者） 

你可以查看[https://github.com/sk89q/worldguard/commits Changelog]（全英文，英文不好的直接跳过吧） 
Changelog就是更新信息（每次更新修改/增加/删除等等了什么） 

你如果有什么建议，或者发现了什么Bug可以到[http://youtrack.sk89q.com/issues?q=project%3A+WorldGuard 这里]反馈（全英文，英文不好的直接跳过吧）

WorldGuard

2015-10-12T15:09:39Z

Lichi2050：/* 区域选择（select） */

Mcbbs发布贴http://www.mcbbs.net/thread-505810-1-1.html
='''配设文件'''=
=指令介绍=
==Region指令==
===定义和重定义区域（define和redifine）===

/region define 区域名称 (玩家1) (玩家2) （玩家...） 
/region def 区域名称 (玩家1) (玩家2) （玩家...） 
/region d 区域名称 (玩家1) (玩家2) （玩家...） 
（）内容为可选项，如果没有指定玩家，定义后的区域将会属于输入命令的玩家（可以设定多个拥有者） 

这个指令主要是创造区域，创造后才可以进行更多的设定，这个指令是没有限制区域大小的（根据WorldEdit选择的大小） 
玩家部分也可以设定为权限组，这个指令主要是给管理员使用，玩家会有另外一个指令 /claim 

/region define 区域名称 g:权限组名称玩家1 玩家2 
'''注*整个世界区域叫做 __global__'''

/region redefine 区域名称 
/region update 区域名称 
/region move 区域名称 

这个指令会重定义已定义区域，选择好新区域后，输入指令后就可以重定义指定区域 

===区域圈地（claim）===

/region claim 区域名称 (玩家1) (玩家2) (玩家...) 

'''注意！'''这个指令是在2010年11至12月出现的，是很早期的指令，比Bukkit都早，在不久的将来会受到改善！ 
这个指令和define指令非常相似，但是加入了一些其他设定 

如果配设内有启动claim功能，玩家将会被限制区域数量 
创造新区域时不可以重复区域名称，除非你是拥有者，那么就会重定义该区域 
新区域不可覆盖其他区域 
如果配设内有启动claim功能，重新新区域时可以覆盖玩家拥有的其他区域 
如果配设内有启动claim功能，玩家将会被限制区域大小 

===区域信息（information）===

/region info （-s）（世界名称）（区域名称） 

列出区域的详细信息，内含 

区域名称（区域类型，优先权） 
区域flags 
区域拥有者 
区域成员 
区域边界 

空的信息项不会显示 
在指令内加入-s 会在显示信息的同时选择该区域 
如果没有输入区域名称，插件会自动取读脚下的区域 

'''列子：查看“TownPlot”区域的信息'''
/region info townplot 

'''列子：查看地狱世界“TownPlot”区域的信息'''
/region info world_nether TownPlot 
 

===区域选择（select）===

/region select [区域名称] 
这个指令会选择区域 
如果没有输入区域名称，插件会自动取读脚下的区域 

'''列子：选择“TownPlot”区域'''
/region select townplot 

===区域表列（list）===
===设定flag===
===设定优先权(priority)f===
===设定子区域（parent）===
===删除区域（remove）===
===区域传送（teleport）===
===区域管理（management）===
=权限介绍=
=regions教程=
==基础教程==
==flag列表==
===区域权限组===
==开发者 API==
===取读WorldGuard===
===基础权限===
===区域管理===
====查看Flags====
====取读一个区域====
===Javadocs===

查看[http://docs.sk89q.com/worldguard/apidocs/com/sk89q/worldguard/bukkit/WGBukkit.html Javadocs]

==数据格式==

'''Region数据都保存在regions.txt内. 打开后首先会有:'''

Region ID 
Region 类型(type) 

Worldguard3.0版本以下的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 
Priority 优先权（请勿设定为0） 
List of owners 拥有者列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 

Worldguard3.0版本以上的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 

Priority 优先权（请勿设定为0） 
ID of parent region 父regionID（设置过子region才会显示） 
List of owners 拥有者列表 
List of members 会员列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 
Exit message （退出region提示信息） 

拥有者以及会员数据保存方式: 
u: 玩家名称 
g: region权限组 

例如 
u:sk89q,u:tetsu,g:admins 

意思就是sk89q以及tetsu这两个玩家都在admins组内。

Flags数据保存方式: 
每一个flag都会有一个特殊的字母，例如Build就是b，通过一个+或者-我们能够查看这个flag的状态 
+就是启动 
-就是关闭/禁止 
如果没有+或- 那么代表这个flag默认就是启动的 
例如 
+bpmc-t-l-f-F 

{| class="wikitable"
|-
! Flag 名称 !! 代表字母
|-
| Passthrough || z
|-
| Build || b
|-
| PvP || p
|-
| Mob damage || m
|-
| Creeper explosion || c
|-
| TNT || t
|-
| Flint and steel || l
|-
| Fire spread || f
|-
| Lava fire spread || F
|}

=黑名单(Blacklist)=
worldguard黑名单可以指定玩家进行某些动作时的处理方法

比如：
阻止玩家挖掉金矿石。
当有人挖掘钻石块时通知在线管理员。
当玩家放置附魔台时，向放置者发送一条提示消息。

下面是一个黑名单的例子：

除admins,mods组以外禁止使用岩浆桶并向使用者发送自定义提示消息 
[lavabucket] 
ignore-groups=admins,mods 
on-use=deny,tell 
message=不可以使用岩浆桶呢喵！ 

禁止挖掉铁矿和金矿并提示默认消息同时通知在线管理员 
[goldore,ironore] 
ignore-groups=admins 
on-break=deny,tell,notify 

除admins组外禁止放置tnt 放置时会通知管理员并且踢出去 
[tnt] 
ignore-groups=admins 
on-place=deny,notify,kick 

黑名单配置文件

黑名单的配置文件保存在plugins\WorldGuard\worlds下面，每个世界都有单独的配置文件 
例子：

worlds/world/blacklist.txt 主世界 
worlds/world_the_end/blacklist.txt 末地 
worlds/mining_world/blacklist.txt 资源世界（如果服务器有多世界的话） 

提示
worldguard不支持多个世界共用同一个黑名单配置文件，但是你可以利用文件系统的“链接”实现。 
注意：编辑黑名单后需要用/wg reload重新加载才能生效 

格式： 

[物品或方块列表] 
事件=操作 
选项=值 

匹配规则： 

物品/方块列表可以填写数字id或bukkit的材料名（可参考 https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html） 
多个项目之间用半角逗号分隔 
[wood,brick,glass] 
还可以指定数据值如白桦木： 
[17:1] 
白桦木和丛林木： 
[17:1;3] 
指定数据值范围 
[wood:2-3] 
[wood:>=2,<=3] 
这些写法是可以混合使用的 
[wood:0;>=2,grass:1-2] 

事件：
{| class="wikitable"
|-
! Event !! Explanation
|-
| on-break || 破坏方块
|-
| on-destroy-with || 用此物品打破方块
|-
| on-place || 放置方块
|-
| on-use || 使用
|-
| on-interact || 交互，如右键门、拉杆、箱子等
|-
| on-drop || 丢弃特定物品
|-
| on-acquire || 获得物品
|-
| on-dispense || 针对发射器，发射特定物品
|-
|}

操作：
{| class="wikitable"
|-
! Action !! Explanation
|-
| deny || 阻止操作（黑名单模式）
|-
| allow || 允许操作（仅白名单模式）
|-
| notify || 发送通知消息给有worldguard.notify权限的人
|-
| log || 记录日志到终端、日志文件、数据库。
|-
| tell || 给玩家一个提示消息
|-
| kick || 踢出玩家
|-
| ban || 将玩家ban掉（永久性）
|-
|}

选项：
{| class="wikitable"
|-
! Option !! Explanation
|-
| ignore-groups || 忽略特定权限组，多个组用半角逗号分隔
|-
| ignore-perms || 忽略有特定权限的玩家，多个权限同样是用逗号分隔
|-
| comment || 自定义通知消息
|-
| message || 自定义tell的消息，可用%s表示相应物品名
|}

另外一个列子

放置和打破信标时通知在线管理员 
[beacon] 
on-break=notify 
on-place=notify 
阻止用钻石镐和金铲子破坏方块 
[diamond_pickaxe,284] 
on-destroy-with=tell,deny 
阻止使用铁锄、钻石剑耕地和攻击 
[iron_hoe,276] 
on-use=tell,deny 
阻止与箱子、石头按钮交互 
[chest,stone_button] 
on-interact=deny,tell 
阻止丢出命令方块 
[commandblock] 
on-drop=deny,tell 
message=不要乱丢命令方块～ 
除admins组外阻止获得基岩 
[bedrock] 
on-acquire=deny 
ignore-groups=admins 
阻止发射器发射岩浆桶和漏斗矿车 
[lavabucket,hopper_minecart] 
on-dispense=deny,log,notify 
[tnt] 
on-break=deny,notify,kick 
on-use=deny,notify,kick 
on-place=deny,ban 
on-acquire=deny 

日志
日志有三种选择
* 输出到终端（就是服务器后台）
* 记录日志到文件
* 记录到数据库

在worldguard配置文件（plugins\WorldGuard\config.yml）中可以对日志文件和数据库进行具体设置。

blacklist: 
use-as-whitelist: false 
logging: 
console: 
enable: true 
database: 
enable: false 
dsn: jdbc:mysql://localhost:3306/minecraft 
user: root 
pass: '' 
table: blacklist_events 
file: 
enable: false 
path: worldguard/logs/%Y-%m-%d.log 
open-files: 10 

日志文件的路径中可使用以下“变量”： 
%Y 年 (YYYY) 
%m 月 (MM) 
%d 日 (DD) 
%W 周 (00-52) 
%H 小时（24小时） (HH) 
%h 小时（12小时） (HH) 
%i 分 (mm) 
%s 秒 (ss) 
%u 用户名 
%% 表示“%”符号 

数据库 
worldguard可以将日志记录进mysql数据库，但需要先创建数据库和表，你可以使用下面的语句创建专用的表 

CREATE TABLE IF NOT EXISTS `blacklist_events` ( 
`id` int(11) NOT NULL AUTO_INCREMENT, 
`world` varchar(10) NOT NULL, 
`event` varchar(25) NOT NULL, 
`player` varchar(16) NOT NULL, 
`x` int(11) NOT NULL, 
`y` int(11) NOT NULL, 
`z` int(11) NOT NULL, 
`item` int(11) NOT NULL, 
`time` int(11) NOT NULL, 
`comment` varchar(255) DEFAULT NULL, 
PRIMARY KEY (`id`) 
); 

最后说一下，使用时发现，日志文件功能在某些平台下可能无法正常工作，同时会导致黑名单失效，开启此功能时请务必进行测试。
发射器的部分可能会和其他插件的发射器黑名单冲突导致报错。

=箱子保护=
WorldGuard提供基础的箱子保护服务，
玩家可以通过在箱子下方放置特殊字符的牌子来达到保护的目的。
我们不建议新设置的WorldGuard使用本功能因为本功能并不是WorldGuard常用的一部分
除此以外，区域设置是比本功能更好的保护拥有者财产的方法。
因为它不涉及像漏斗一类方块的问题。

提示：如果你是希望保护单块的方块，箱子等，
我们建议使用第三方保护插件。
例如Lockette 或者 LWC.

启用此功能：
首先箱子保护功能必须在配置文件中启用。
如果没有手动启用，箱子保护功能不会自动工作
这时不能使用牌子锁功能。(此项功能也可在配置文件中禁用)

使用方法：
# 必须是一个信息牌
# 必须位于箱子下面(如果是大箱子，只需在其一侧下面)
# 在第一行输入[Lock]
# 在第二行输入玩家的名字
# 在剩余两行写上其他允许使用玩家的名字
注：不可将其他玩家名字放在第二行的位置
提示：WorldGuard功能并不支持UUID功能
警告：由于Minecraft1.8版本的改变
从旧版本升级将会破坏掉所有的保护牌子
实际上它将破坏全部写有[]的牌子

=主机密码（登录密码）=
在过去由于Minecraft的登录代码问题，玩家可以登录到服务器的任何玩家包括拥有者和管理者的账号上，
在2010-2013年间，有五次利用该性质的漏洞经常导致成千上万的服务器被黑客攻击。

这项登录密码功能作为一个额外的登录屏障被添加到WorldGuard中。
其工作原理是作为一项额外的屏障来达到此功能，与Mojang的登录无关。
在登录时必须发送指定信息 (通俗的说就是输入你的密码)才能登录服务器。
即使攻击者有能力破坏Minecraft的登录系统来成为一个管理员。
但因在服务器缺少发送指定的信息，经服务器检测后无法活动。
注：这种登录验证方式的漏洞是很不明显的，很少见的。

启用功能：
当一个玩家通过某一个地址连接服务器时,输入play.example.com
Minecraft将会告诉服务器该玩家通过这个地址登录
管理者可以通过一个特殊的秘密语句来登录，
比如secretmod.play.example.com这个地址
服务器将会检测到该管理者登录使用的这个地址。
也就是一个类似密码的机制，不过密码是地址格式。

主机密码允许特定玩家使用特定地址登录，
如果地址错误，他将立即被踢下线

配置：

host-keys:
your_username: bagels.play.example.com
moderator1_name: manoverboard.play.example.com
提示:主机密码功能暂不支持UUID功能

DNS配置:
为了使此功能工作，你需要bagels.play.example.com 和 manoverboard.play.example.com 指向你的服务
然而不要在您使用的域名中添加域名的记录，因为很容易使得攻击者找出管理员域名从而登录。

相比之下，我们建议您安装通用地址-“wildcard addresses.”。例如设置了play.example.com，
这将意味着任何相同前缀会允许登录。（例如aa.play.example.com，ab.play.example.com，ac.play.example.com，等）。
提示：如果你没有一个域名或不能设置通配符地址，你可以使用xip.io。

=更多帮助=

你需要更多的帮助吗？我建议你 

你可以去[http://skq.me/irc/irc.esper.net/sk-dev/ IRC]提问 
注*IRC聊天频道是维基百科24小时开放的“聊天室” 

你可以在Twitter上联系[https://twitter.com/sk89q sk89q] 
sk89q是Worldguard的作者（也是Worldedit以及其他不少插件的作者） 

你可以查看[https://github.com/sk89q/worldguard/commits Changelog]（全英文，英文不好的直接跳过吧） 
Changelog就是更新信息（每次更新修改/增加/删除等等了什么） 

你如果有什么建议，或者发现了什么Bug可以到[http://youtrack.sk89q.com/issues?q=project%3A+WorldGuard 这里]反馈（全英文，英文不好的直接跳过吧）

WorldGuard

2015-10-12T15:09:12Z

Lichi2050：/* 区域信息（information） */

Mcbbs发布贴http://www.mcbbs.net/thread-505810-1-1.html
='''配设文件'''=
=指令介绍=
==Region指令==
===定义和重定义区域（define和redifine）===

/region define 区域名称 (玩家1) (玩家2) （玩家...） 
/region def 区域名称 (玩家1) (玩家2) （玩家...） 
/region d 区域名称 (玩家1) (玩家2) （玩家...） 
（）内容为可选项，如果没有指定玩家，定义后的区域将会属于输入命令的玩家（可以设定多个拥有者） 

这个指令主要是创造区域，创造后才可以进行更多的设定，这个指令是没有限制区域大小的（根据WorldEdit选择的大小） 
玩家部分也可以设定为权限组，这个指令主要是给管理员使用，玩家会有另外一个指令 /claim 

/region define 区域名称 g:权限组名称玩家1 玩家2 
'''注*整个世界区域叫做 __global__'''

/region redefine 区域名称 
/region update 区域名称 
/region move 区域名称 

这个指令会重定义已定义区域，选择好新区域后，输入指令后就可以重定义指定区域 

===区域圈地（claim）===

/region claim 区域名称 (玩家1) (玩家2) (玩家...) 

'''注意！'''这个指令是在2010年11至12月出现的，是很早期的指令，比Bukkit都早，在不久的将来会受到改善！ 
这个指令和define指令非常相似，但是加入了一些其他设定 

如果配设内有启动claim功能，玩家将会被限制区域数量 
创造新区域时不可以重复区域名称，除非你是拥有者，那么就会重定义该区域 
新区域不可覆盖其他区域 
如果配设内有启动claim功能，重新新区域时可以覆盖玩家拥有的其他区域 
如果配设内有启动claim功能，玩家将会被限制区域大小 

===区域信息（information）===

/region info （-s）（世界名称）（区域名称） 

列出区域的详细信息，内含 

区域名称（区域类型，优先权） 
区域flags 
区域拥有者 
区域成员 
区域边界 

空的信息项不会显示 
在指令内加入-s 会在显示信息的同时选择该区域 
如果没有输入区域名称，插件会自动取读脚下的区域 

'''列子：查看“TownPlot”区域的信息'''
/region info townplot 

'''列子：查看地狱世界“TownPlot”区域的信息'''
/region info world_nether TownPlot 
 

===区域选择（select）===
===区域表列（list）===
===设定flag===
===设定优先权(priority)f===
===设定子区域（parent）===
===删除区域（remove）===
===区域传送（teleport）===
===区域管理（management）===
=权限介绍=
=regions教程=
==基础教程==
==flag列表==
===区域权限组===
==开发者 API==
===取读WorldGuard===
===基础权限===
===区域管理===
====查看Flags====
====取读一个区域====
===Javadocs===

查看[http://docs.sk89q.com/worldguard/apidocs/com/sk89q/worldguard/bukkit/WGBukkit.html Javadocs]

==数据格式==

'''Region数据都保存在regions.txt内. 打开后首先会有:'''

Region ID 
Region 类型(type) 

Worldguard3.0版本以下的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 
Priority 优先权（请勿设定为0） 
List of owners 拥有者列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 

Worldguard3.0版本以上的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 

Priority 优先权（请勿设定为0） 
ID of parent region 父regionID（设置过子region才会显示） 
List of owners 拥有者列表 
List of members 会员列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 
Exit message （退出region提示信息） 

拥有者以及会员数据保存方式: 
u: 玩家名称 
g: region权限组 

例如 
u:sk89q,u:tetsu,g:admins 

意思就是sk89q以及tetsu这两个玩家都在admins组内。

Flags数据保存方式: 
每一个flag都会有一个特殊的字母，例如Build就是b，通过一个+或者-我们能够查看这个flag的状态 
+就是启动 
-就是关闭/禁止 
如果没有+或- 那么代表这个flag默认就是启动的 
例如 
+bpmc-t-l-f-F 

{| class="wikitable"
|-
! Flag 名称 !! 代表字母
|-
| Passthrough || z
|-
| Build || b
|-
| PvP || p
|-
| Mob damage || m
|-
| Creeper explosion || c
|-
| TNT || t
|-
| Flint and steel || l
|-
| Fire spread || f
|-
| Lava fire spread || F
|}

=黑名单(Blacklist)=
worldguard黑名单可以指定玩家进行某些动作时的处理方法

比如：
阻止玩家挖掉金矿石。
当有人挖掘钻石块时通知在线管理员。
当玩家放置附魔台时，向放置者发送一条提示消息。

下面是一个黑名单的例子：

除admins,mods组以外禁止使用岩浆桶并向使用者发送自定义提示消息 
[lavabucket] 
ignore-groups=admins,mods 
on-use=deny,tell 
message=不可以使用岩浆桶呢喵！ 

禁止挖掉铁矿和金矿并提示默认消息同时通知在线管理员 
[goldore,ironore] 
ignore-groups=admins 
on-break=deny,tell,notify 

除admins组外禁止放置tnt 放置时会通知管理员并且踢出去 
[tnt] 
ignore-groups=admins 
on-place=deny,notify,kick 

黑名单配置文件

黑名单的配置文件保存在plugins\WorldGuard\worlds下面，每个世界都有单独的配置文件 
例子：

worlds/world/blacklist.txt 主世界 
worlds/world_the_end/blacklist.txt 末地 
worlds/mining_world/blacklist.txt 资源世界（如果服务器有多世界的话） 

提示
worldguard不支持多个世界共用同一个黑名单配置文件，但是你可以利用文件系统的“链接”实现。 
注意：编辑黑名单后需要用/wg reload重新加载才能生效 

格式： 

[物品或方块列表] 
事件=操作 
选项=值 

匹配规则： 

物品/方块列表可以填写数字id或bukkit的材料名（可参考 https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html） 
多个项目之间用半角逗号分隔 
[wood,brick,glass] 
还可以指定数据值如白桦木： 
[17:1] 
白桦木和丛林木： 
[17:1;3] 
指定数据值范围 
[wood:2-3] 
[wood:>=2,<=3] 
这些写法是可以混合使用的 
[wood:0;>=2,grass:1-2] 

事件：
{| class="wikitable"
|-
! Event !! Explanation
|-
| on-break || 破坏方块
|-
| on-destroy-with || 用此物品打破方块
|-
| on-place || 放置方块
|-
| on-use || 使用
|-
| on-interact || 交互，如右键门、拉杆、箱子等
|-
| on-drop || 丢弃特定物品
|-
| on-acquire || 获得物品
|-
| on-dispense || 针对发射器，发射特定物品
|-
|}

操作：
{| class="wikitable"
|-
! Action !! Explanation
|-
| deny || 阻止操作（黑名单模式）
|-
| allow || 允许操作（仅白名单模式）
|-
| notify || 发送通知消息给有worldguard.notify权限的人
|-
| log || 记录日志到终端、日志文件、数据库。
|-
| tell || 给玩家一个提示消息
|-
| kick || 踢出玩家
|-
| ban || 将玩家ban掉（永久性）
|-
|}

选项：
{| class="wikitable"
|-
! Option !! Explanation
|-
| ignore-groups || 忽略特定权限组，多个组用半角逗号分隔
|-
| ignore-perms || 忽略有特定权限的玩家，多个权限同样是用逗号分隔
|-
| comment || 自定义通知消息
|-
| message || 自定义tell的消息，可用%s表示相应物品名
|}

另外一个列子

放置和打破信标时通知在线管理员 
[beacon] 
on-break=notify 
on-place=notify 
阻止用钻石镐和金铲子破坏方块 
[diamond_pickaxe,284] 
on-destroy-with=tell,deny 
阻止使用铁锄、钻石剑耕地和攻击 
[iron_hoe,276] 
on-use=tell,deny 
阻止与箱子、石头按钮交互 
[chest,stone_button] 
on-interact=deny,tell 
阻止丢出命令方块 
[commandblock] 
on-drop=deny,tell 
message=不要乱丢命令方块～ 
除admins组外阻止获得基岩 
[bedrock] 
on-acquire=deny 
ignore-groups=admins 
阻止发射器发射岩浆桶和漏斗矿车 
[lavabucket,hopper_minecart] 
on-dispense=deny,log,notify 
[tnt] 
on-break=deny,notify,kick 
on-use=deny,notify,kick 
on-place=deny,ban 
on-acquire=deny 

日志
日志有三种选择
* 输出到终端（就是服务器后台）
* 记录日志到文件
* 记录到数据库

在worldguard配置文件（plugins\WorldGuard\config.yml）中可以对日志文件和数据库进行具体设置。

blacklist: 
use-as-whitelist: false 
logging: 
console: 
enable: true 
database: 
enable: false 
dsn: jdbc:mysql://localhost:3306/minecraft 
user: root 
pass: '' 
table: blacklist_events 
file: 
enable: false 
path: worldguard/logs/%Y-%m-%d.log 
open-files: 10 

日志文件的路径中可使用以下“变量”： 
%Y 年 (YYYY) 
%m 月 (MM) 
%d 日 (DD) 
%W 周 (00-52) 
%H 小时（24小时） (HH) 
%h 小时（12小时） (HH) 
%i 分 (mm) 
%s 秒 (ss) 
%u 用户名 
%% 表示“%”符号 

数据库 
worldguard可以将日志记录进mysql数据库，但需要先创建数据库和表，你可以使用下面的语句创建专用的表 

CREATE TABLE IF NOT EXISTS `blacklist_events` ( 
`id` int(11) NOT NULL AUTO_INCREMENT, 
`world` varchar(10) NOT NULL, 
`event` varchar(25) NOT NULL, 
`player` varchar(16) NOT NULL, 
`x` int(11) NOT NULL, 
`y` int(11) NOT NULL, 
`z` int(11) NOT NULL, 
`item` int(11) NOT NULL, 
`time` int(11) NOT NULL, 
`comment` varchar(255) DEFAULT NULL, 
PRIMARY KEY (`id`) 
); 

最后说一下，使用时发现，日志文件功能在某些平台下可能无法正常工作，同时会导致黑名单失效，开启此功能时请务必进行测试。
发射器的部分可能会和其他插件的发射器黑名单冲突导致报错。

=箱子保护=
WorldGuard提供基础的箱子保护服务，
玩家可以通过在箱子下方放置特殊字符的牌子来达到保护的目的。
我们不建议新设置的WorldGuard使用本功能因为本功能并不是WorldGuard常用的一部分
除此以外，区域设置是比本功能更好的保护拥有者财产的方法。
因为它不涉及像漏斗一类方块的问题。

提示：如果你是希望保护单块的方块，箱子等，
我们建议使用第三方保护插件。
例如Lockette 或者 LWC.

启用此功能：
首先箱子保护功能必须在配置文件中启用。
如果没有手动启用，箱子保护功能不会自动工作
这时不能使用牌子锁功能。(此项功能也可在配置文件中禁用)

使用方法：
# 必须是一个信息牌
# 必须位于箱子下面(如果是大箱子，只需在其一侧下面)
# 在第一行输入[Lock]
# 在第二行输入玩家的名字
# 在剩余两行写上其他允许使用玩家的名字
注：不可将其他玩家名字放在第二行的位置
提示：WorldGuard功能并不支持UUID功能
警告：由于Minecraft1.8版本的改变
从旧版本升级将会破坏掉所有的保护牌子
实际上它将破坏全部写有[]的牌子

=主机密码（登录密码）=
在过去由于Minecraft的登录代码问题，玩家可以登录到服务器的任何玩家包括拥有者和管理者的账号上，
在2010-2013年间，有五次利用该性质的漏洞经常导致成千上万的服务器被黑客攻击。

这项登录密码功能作为一个额外的登录屏障被添加到WorldGuard中。
其工作原理是作为一项额外的屏障来达到此功能，与Mojang的登录无关。
在登录时必须发送指定信息 (通俗的说就是输入你的密码)才能登录服务器。
即使攻击者有能力破坏Minecraft的登录系统来成为一个管理员。
但因在服务器缺少发送指定的信息，经服务器检测后无法活动。
注：这种登录验证方式的漏洞是很不明显的，很少见的。

启用功能：
当一个玩家通过某一个地址连接服务器时,输入play.example.com
Minecraft将会告诉服务器该玩家通过这个地址登录
管理者可以通过一个特殊的秘密语句来登录，
比如secretmod.play.example.com这个地址
服务器将会检测到该管理者登录使用的这个地址。
也就是一个类似密码的机制，不过密码是地址格式。

主机密码允许特定玩家使用特定地址登录，
如果地址错误，他将立即被踢下线

配置：

host-keys:
your_username: bagels.play.example.com
moderator1_name: manoverboard.play.example.com
提示:主机密码功能暂不支持UUID功能

DNS配置:
为了使此功能工作，你需要bagels.play.example.com 和 manoverboard.play.example.com 指向你的服务
然而不要在您使用的域名中添加域名的记录，因为很容易使得攻击者找出管理员域名从而登录。

相比之下，我们建议您安装通用地址-“wildcard addresses.”。例如设置了play.example.com，
这将意味着任何相同前缀会允许登录。（例如aa.play.example.com，ab.play.example.com，ac.play.example.com，等）。
提示：如果你没有一个域名或不能设置通配符地址，你可以使用xip.io。

=更多帮助=

你需要更多的帮助吗？我建议你 

你可以去[http://skq.me/irc/irc.esper.net/sk-dev/ IRC]提问 
注*IRC聊天频道是维基百科24小时开放的“聊天室” 

你可以在Twitter上联系[https://twitter.com/sk89q sk89q] 
sk89q是Worldguard的作者（也是Worldedit以及其他不少插件的作者） 

你可以查看[https://github.com/sk89q/worldguard/commits Changelog]（全英文，英文不好的直接跳过吧） 
Changelog就是更新信息（每次更新修改/增加/删除等等了什么） 

你如果有什么建议，或者发现了什么Bug可以到[http://youtrack.sk89q.com/issues?q=project%3A+WorldGuard 这里]反馈（全英文，英文不好的直接跳过吧）

WorldGuard

2015-10-12T15:08:30Z

Lichi2050：/* 区域圈地（claim） */

Mcbbs发布贴http://www.mcbbs.net/thread-505810-1-1.html
='''配设文件'''=
=指令介绍=
==Region指令==
===定义和重定义区域（define和redifine）===

/region define 区域名称 (玩家1) (玩家2) （玩家...） 
/region def 区域名称 (玩家1) (玩家2) （玩家...） 
/region d 区域名称 (玩家1) (玩家2) （玩家...） 
（）内容为可选项，如果没有指定玩家，定义后的区域将会属于输入命令的玩家（可以设定多个拥有者） 

这个指令主要是创造区域，创造后才可以进行更多的设定，这个指令是没有限制区域大小的（根据WorldEdit选择的大小） 
玩家部分也可以设定为权限组，这个指令主要是给管理员使用，玩家会有另外一个指令 /claim 

/region define 区域名称 g:权限组名称玩家1 玩家2 
'''注*整个世界区域叫做 __global__'''

/region redefine 区域名称 
/region update 区域名称 
/region move 区域名称 

这个指令会重定义已定义区域，选择好新区域后，输入指令后就可以重定义指定区域 

===区域圈地（claim）===

/region claim 区域名称 (玩家1) (玩家2) (玩家...) 

'''注意！'''这个指令是在2010年11至12月出现的，是很早期的指令，比Bukkit都早，在不久的将来会受到改善！ 
这个指令和define指令非常相似，但是加入了一些其他设定 

如果配设内有启动claim功能，玩家将会被限制区域数量 
创造新区域时不可以重复区域名称，除非你是拥有者，那么就会重定义该区域 
新区域不可覆盖其他区域 
如果配设内有启动claim功能，重新新区域时可以覆盖玩家拥有的其他区域 
如果配设内有启动claim功能，玩家将会被限制区域大小 

===区域信息（information）===
===区域选择（select）===
===区域表列（list）===
===设定flag===
===设定优先权(priority)f===
===设定子区域（parent）===
===删除区域（remove）===
===区域传送（teleport）===
===区域管理（management）===
=权限介绍=
=regions教程=
==基础教程==
==flag列表==
===区域权限组===
==开发者 API==
===取读WorldGuard===
===基础权限===
===区域管理===
====查看Flags====
====取读一个区域====
===Javadocs===

查看[http://docs.sk89q.com/worldguard/apidocs/com/sk89q/worldguard/bukkit/WGBukkit.html Javadocs]

==数据格式==

'''Region数据都保存在regions.txt内. 打开后首先会有:'''

Region ID 
Region 类型(type) 

Worldguard3.0版本以下的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 
Priority 优先权（请勿设定为0） 
List of owners 拥有者列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 

Worldguard3.0版本以上的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 

Priority 优先权（请勿设定为0） 
ID of parent region 父regionID（设置过子region才会显示） 
List of owners 拥有者列表 
List of members 会员列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 
Exit message （退出region提示信息） 

拥有者以及会员数据保存方式: 
u: 玩家名称 
g: region权限组 

例如 
u:sk89q,u:tetsu,g:admins 

意思就是sk89q以及tetsu这两个玩家都在admins组内。

Flags数据保存方式: 
每一个flag都会有一个特殊的字母，例如Build就是b，通过一个+或者-我们能够查看这个flag的状态 
+就是启动 
-就是关闭/禁止 
如果没有+或- 那么代表这个flag默认就是启动的 
例如 
+bpmc-t-l-f-F 

{| class="wikitable"
|-
! Flag 名称 !! 代表字母
|-
| Passthrough || z
|-
| Build || b
|-
| PvP || p
|-
| Mob damage || m
|-
| Creeper explosion || c
|-
| TNT || t
|-
| Flint and steel || l
|-
| Fire spread || f
|-
| Lava fire spread || F
|}

=黑名单(Blacklist)=
worldguard黑名单可以指定玩家进行某些动作时的处理方法

比如：
阻止玩家挖掉金矿石。
当有人挖掘钻石块时通知在线管理员。
当玩家放置附魔台时，向放置者发送一条提示消息。

下面是一个黑名单的例子：

除admins,mods组以外禁止使用岩浆桶并向使用者发送自定义提示消息 
[lavabucket] 
ignore-groups=admins,mods 
on-use=deny,tell 
message=不可以使用岩浆桶呢喵！ 

禁止挖掉铁矿和金矿并提示默认消息同时通知在线管理员 
[goldore,ironore] 
ignore-groups=admins 
on-break=deny,tell,notify 

除admins组外禁止放置tnt 放置时会通知管理员并且踢出去 
[tnt] 
ignore-groups=admins 
on-place=deny,notify,kick 

黑名单配置文件

黑名单的配置文件保存在plugins\WorldGuard\worlds下面，每个世界都有单独的配置文件 
例子：

worlds/world/blacklist.txt 主世界 
worlds/world_the_end/blacklist.txt 末地 
worlds/mining_world/blacklist.txt 资源世界（如果服务器有多世界的话） 

提示
worldguard不支持多个世界共用同一个黑名单配置文件，但是你可以利用文件系统的“链接”实现。 
注意：编辑黑名单后需要用/wg reload重新加载才能生效 

格式： 

[物品或方块列表] 
事件=操作 
选项=值 

匹配规则： 

物品/方块列表可以填写数字id或bukkit的材料名（可参考 https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html） 
多个项目之间用半角逗号分隔 
[wood,brick,glass] 
还可以指定数据值如白桦木： 
[17:1] 
白桦木和丛林木： 
[17:1;3] 
指定数据值范围 
[wood:2-3] 
[wood:>=2,<=3] 
这些写法是可以混合使用的 
[wood:0;>=2,grass:1-2] 

事件：
{| class="wikitable"
|-
! Event !! Explanation
|-
| on-break || 破坏方块
|-
| on-destroy-with || 用此物品打破方块
|-
| on-place || 放置方块
|-
| on-use || 使用
|-
| on-interact || 交互，如右键门、拉杆、箱子等
|-
| on-drop || 丢弃特定物品
|-
| on-acquire || 获得物品
|-
| on-dispense || 针对发射器，发射特定物品
|-
|}

操作：
{| class="wikitable"
|-
! Action !! Explanation
|-
| deny || 阻止操作（黑名单模式）
|-
| allow || 允许操作（仅白名单模式）
|-
| notify || 发送通知消息给有worldguard.notify权限的人
|-
| log || 记录日志到终端、日志文件、数据库。
|-
| tell || 给玩家一个提示消息
|-
| kick || 踢出玩家
|-
| ban || 将玩家ban掉（永久性）
|-
|}

选项：
{| class="wikitable"
|-
! Option !! Explanation
|-
| ignore-groups || 忽略特定权限组，多个组用半角逗号分隔
|-
| ignore-perms || 忽略有特定权限的玩家，多个权限同样是用逗号分隔
|-
| comment || 自定义通知消息
|-
| message || 自定义tell的消息，可用%s表示相应物品名
|}

另外一个列子

放置和打破信标时通知在线管理员 
[beacon] 
on-break=notify 
on-place=notify 
阻止用钻石镐和金铲子破坏方块 
[diamond_pickaxe,284] 
on-destroy-with=tell,deny 
阻止使用铁锄、钻石剑耕地和攻击 
[iron_hoe,276] 
on-use=tell,deny 
阻止与箱子、石头按钮交互 
[chest,stone_button] 
on-interact=deny,tell 
阻止丢出命令方块 
[commandblock] 
on-drop=deny,tell 
message=不要乱丢命令方块～ 
除admins组外阻止获得基岩 
[bedrock] 
on-acquire=deny 
ignore-groups=admins 
阻止发射器发射岩浆桶和漏斗矿车 
[lavabucket,hopper_minecart] 
on-dispense=deny,log,notify 
[tnt] 
on-break=deny,notify,kick 
on-use=deny,notify,kick 
on-place=deny,ban 
on-acquire=deny 

日志
日志有三种选择
* 输出到终端（就是服务器后台）
* 记录日志到文件
* 记录到数据库

在worldguard配置文件（plugins\WorldGuard\config.yml）中可以对日志文件和数据库进行具体设置。

blacklist: 
use-as-whitelist: false 
logging: 
console: 
enable: true 
database: 
enable: false 
dsn: jdbc:mysql://localhost:3306/minecraft 
user: root 
pass: '' 
table: blacklist_events 
file: 
enable: false 
path: worldguard/logs/%Y-%m-%d.log 
open-files: 10 

日志文件的路径中可使用以下“变量”： 
%Y 年 (YYYY) 
%m 月 (MM) 
%d 日 (DD) 
%W 周 (00-52) 
%H 小时（24小时） (HH) 
%h 小时（12小时） (HH) 
%i 分 (mm) 
%s 秒 (ss) 
%u 用户名 
%% 表示“%”符号 

数据库 
worldguard可以将日志记录进mysql数据库，但需要先创建数据库和表，你可以使用下面的语句创建专用的表 

CREATE TABLE IF NOT EXISTS `blacklist_events` ( 
`id` int(11) NOT NULL AUTO_INCREMENT, 
`world` varchar(10) NOT NULL, 
`event` varchar(25) NOT NULL, 
`player` varchar(16) NOT NULL, 
`x` int(11) NOT NULL, 
`y` int(11) NOT NULL, 
`z` int(11) NOT NULL, 
`item` int(11) NOT NULL, 
`time` int(11) NOT NULL, 
`comment` varchar(255) DEFAULT NULL, 
PRIMARY KEY (`id`) 
); 

最后说一下，使用时发现，日志文件功能在某些平台下可能无法正常工作，同时会导致黑名单失效，开启此功能时请务必进行测试。
发射器的部分可能会和其他插件的发射器黑名单冲突导致报错。

=箱子保护=
WorldGuard提供基础的箱子保护服务，
玩家可以通过在箱子下方放置特殊字符的牌子来达到保护的目的。
我们不建议新设置的WorldGuard使用本功能因为本功能并不是WorldGuard常用的一部分
除此以外，区域设置是比本功能更好的保护拥有者财产的方法。
因为它不涉及像漏斗一类方块的问题。

提示：如果你是希望保护单块的方块，箱子等，
我们建议使用第三方保护插件。
例如Lockette 或者 LWC.

启用此功能：
首先箱子保护功能必须在配置文件中启用。
如果没有手动启用，箱子保护功能不会自动工作
这时不能使用牌子锁功能。(此项功能也可在配置文件中禁用)

使用方法：
# 必须是一个信息牌
# 必须位于箱子下面(如果是大箱子，只需在其一侧下面)
# 在第一行输入[Lock]
# 在第二行输入玩家的名字
# 在剩余两行写上其他允许使用玩家的名字
注：不可将其他玩家名字放在第二行的位置
提示：WorldGuard功能并不支持UUID功能
警告：由于Minecraft1.8版本的改变
从旧版本升级将会破坏掉所有的保护牌子
实际上它将破坏全部写有[]的牌子

=主机密码（登录密码）=
在过去由于Minecraft的登录代码问题，玩家可以登录到服务器的任何玩家包括拥有者和管理者的账号上，
在2010-2013年间，有五次利用该性质的漏洞经常导致成千上万的服务器被黑客攻击。

这项登录密码功能作为一个额外的登录屏障被添加到WorldGuard中。
其工作原理是作为一项额外的屏障来达到此功能，与Mojang的登录无关。
在登录时必须发送指定信息 (通俗的说就是输入你的密码)才能登录服务器。
即使攻击者有能力破坏Minecraft的登录系统来成为一个管理员。
但因在服务器缺少发送指定的信息，经服务器检测后无法活动。
注：这种登录验证方式的漏洞是很不明显的，很少见的。

启用功能：
当一个玩家通过某一个地址连接服务器时,输入play.example.com
Minecraft将会告诉服务器该玩家通过这个地址登录
管理者可以通过一个特殊的秘密语句来登录，
比如secretmod.play.example.com这个地址
服务器将会检测到该管理者登录使用的这个地址。
也就是一个类似密码的机制，不过密码是地址格式。

主机密码允许特定玩家使用特定地址登录，
如果地址错误，他将立即被踢下线

配置：

host-keys:
your_username: bagels.play.example.com
moderator1_name: manoverboard.play.example.com
提示:主机密码功能暂不支持UUID功能

DNS配置:
为了使此功能工作，你需要bagels.play.example.com 和 manoverboard.play.example.com 指向你的服务
然而不要在您使用的域名中添加域名的记录，因为很容易使得攻击者找出管理员域名从而登录。

相比之下，我们建议您安装通用地址-“wildcard addresses.”。例如设置了play.example.com，
这将意味着任何相同前缀会允许登录。（例如aa.play.example.com，ab.play.example.com，ac.play.example.com，等）。
提示：如果你没有一个域名或不能设置通配符地址，你可以使用xip.io。

=更多帮助=

你需要更多的帮助吗？我建议你 

你可以去[http://skq.me/irc/irc.esper.net/sk-dev/ IRC]提问 
注*IRC聊天频道是维基百科24小时开放的“聊天室” 

你可以在Twitter上联系[https://twitter.com/sk89q sk89q] 
sk89q是Worldguard的作者（也是Worldedit以及其他不少插件的作者） 

你可以查看[https://github.com/sk89q/worldguard/commits Changelog]（全英文，英文不好的直接跳过吧） 
Changelog就是更新信息（每次更新修改/增加/删除等等了什么） 

你如果有什么建议，或者发现了什么Bug可以到[http://youtrack.sk89q.com/issues?q=project%3A+WorldGuard 这里]反馈（全英文，英文不好的直接跳过吧）

WorldGuard

2015-10-12T15:07:54Z

Lichi2050：/* 定义和重定义区域（define和redifine） */

Mcbbs发布贴http://www.mcbbs.net/thread-505810-1-1.html
='''配设文件'''=
=指令介绍=
==Region指令==
===定义和重定义区域（define和redifine）===

/region define 区域名称 (玩家1) (玩家2) （玩家...） 
/region def 区域名称 (玩家1) (玩家2) （玩家...） 
/region d 区域名称 (玩家1) (玩家2) （玩家...） 
（）内容为可选项，如果没有指定玩家，定义后的区域将会属于输入命令的玩家（可以设定多个拥有者） 

这个指令主要是创造区域，创造后才可以进行更多的设定，这个指令是没有限制区域大小的（根据WorldEdit选择的大小） 
玩家部分也可以设定为权限组，这个指令主要是给管理员使用，玩家会有另外一个指令 /claim 

/region define 区域名称 g:权限组名称玩家1 玩家2 
'''注*整个世界区域叫做 __global__'''

/region redefine 区域名称 
/region update 区域名称 
/region move 区域名称 

这个指令会重定义已定义区域，选择好新区域后，输入指令后就可以重定义指定区域 

===区域圈地（claim）===
===区域信息（information）===
===区域选择（select）===
===区域表列（list）===
===设定flag===
===设定优先权(priority)f===
===设定子区域（parent）===
===删除区域（remove）===
===区域传送（teleport）===
===区域管理（management）===
=权限介绍=
=regions教程=
==基础教程==
==flag列表==
===区域权限组===
==开发者 API==
===取读WorldGuard===
===基础权限===
===区域管理===
====查看Flags====
====取读一个区域====
===Javadocs===

查看[http://docs.sk89q.com/worldguard/apidocs/com/sk89q/worldguard/bukkit/WGBukkit.html Javadocs]

==数据格式==

'''Region数据都保存在regions.txt内. 打开后首先会有:'''

Region ID 
Region 类型(type) 

Worldguard3.0版本以下的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 
Priority 优先权（请勿设定为0） 
List of owners 拥有者列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 

Worldguard3.0版本以上的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 

Priority 优先权（请勿设定为0） 
ID of parent region 父regionID（设置过子region才会显示） 
List of owners 拥有者列表 
List of members 会员列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 
Exit message （退出region提示信息） 

拥有者以及会员数据保存方式: 
u: 玩家名称 
g: region权限组 

例如 
u:sk89q,u:tetsu,g:admins 

意思就是sk89q以及tetsu这两个玩家都在admins组内。

Flags数据保存方式: 
每一个flag都会有一个特殊的字母，例如Build就是b，通过一个+或者-我们能够查看这个flag的状态 
+就是启动 
-就是关闭/禁止 
如果没有+或- 那么代表这个flag默认就是启动的 
例如 
+bpmc-t-l-f-F 

{| class="wikitable"
|-
! Flag 名称 !! 代表字母
|-
| Passthrough || z
|-
| Build || b
|-
| PvP || p
|-
| Mob damage || m
|-
| Creeper explosion || c
|-
| TNT || t
|-
| Flint and steel || l
|-
| Fire spread || f
|-
| Lava fire spread || F
|}

=黑名单(Blacklist)=
worldguard黑名单可以指定玩家进行某些动作时的处理方法

比如：
阻止玩家挖掉金矿石。
当有人挖掘钻石块时通知在线管理员。
当玩家放置附魔台时，向放置者发送一条提示消息。

下面是一个黑名单的例子：

除admins,mods组以外禁止使用岩浆桶并向使用者发送自定义提示消息 
[lavabucket] 
ignore-groups=admins,mods 
on-use=deny,tell 
message=不可以使用岩浆桶呢喵！ 

禁止挖掉铁矿和金矿并提示默认消息同时通知在线管理员 
[goldore,ironore] 
ignore-groups=admins 
on-break=deny,tell,notify 

除admins组外禁止放置tnt 放置时会通知管理员并且踢出去 
[tnt] 
ignore-groups=admins 
on-place=deny,notify,kick 

黑名单配置文件

黑名单的配置文件保存在plugins\WorldGuard\worlds下面，每个世界都有单独的配置文件 
例子：

worlds/world/blacklist.txt 主世界 
worlds/world_the_end/blacklist.txt 末地 
worlds/mining_world/blacklist.txt 资源世界（如果服务器有多世界的话） 

提示
worldguard不支持多个世界共用同一个黑名单配置文件，但是你可以利用文件系统的“链接”实现。 
注意：编辑黑名单后需要用/wg reload重新加载才能生效 

格式： 

[物品或方块列表] 
事件=操作 
选项=值 

匹配规则： 

物品/方块列表可以填写数字id或bukkit的材料名（可参考 https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html） 
多个项目之间用半角逗号分隔 
[wood,brick,glass] 
还可以指定数据值如白桦木： 
[17:1] 
白桦木和丛林木： 
[17:1;3] 
指定数据值范围 
[wood:2-3] 
[wood:>=2,<=3] 
这些写法是可以混合使用的 
[wood:0;>=2,grass:1-2] 

事件：
{| class="wikitable"
|-
! Event !! Explanation
|-
| on-break || 破坏方块
|-
| on-destroy-with || 用此物品打破方块
|-
| on-place || 放置方块
|-
| on-use || 使用
|-
| on-interact || 交互，如右键门、拉杆、箱子等
|-
| on-drop || 丢弃特定物品
|-
| on-acquire || 获得物品
|-
| on-dispense || 针对发射器，发射特定物品
|-
|}

操作：
{| class="wikitable"
|-
! Action !! Explanation
|-
| deny || 阻止操作（黑名单模式）
|-
| allow || 允许操作（仅白名单模式）
|-
| notify || 发送通知消息给有worldguard.notify权限的人
|-
| log || 记录日志到终端、日志文件、数据库。
|-
| tell || 给玩家一个提示消息
|-
| kick || 踢出玩家
|-
| ban || 将玩家ban掉（永久性）
|-
|}

选项：
{| class="wikitable"
|-
! Option !! Explanation
|-
| ignore-groups || 忽略特定权限组，多个组用半角逗号分隔
|-
| ignore-perms || 忽略有特定权限的玩家，多个权限同样是用逗号分隔
|-
| comment || 自定义通知消息
|-
| message || 自定义tell的消息，可用%s表示相应物品名
|}

另外一个列子

放置和打破信标时通知在线管理员 
[beacon] 
on-break=notify 
on-place=notify 
阻止用钻石镐和金铲子破坏方块 
[diamond_pickaxe,284] 
on-destroy-with=tell,deny 
阻止使用铁锄、钻石剑耕地和攻击 
[iron_hoe,276] 
on-use=tell,deny 
阻止与箱子、石头按钮交互 
[chest,stone_button] 
on-interact=deny,tell 
阻止丢出命令方块 
[commandblock] 
on-drop=deny,tell 
message=不要乱丢命令方块～ 
除admins组外阻止获得基岩 
[bedrock] 
on-acquire=deny 
ignore-groups=admins 
阻止发射器发射岩浆桶和漏斗矿车 
[lavabucket,hopper_minecart] 
on-dispense=deny,log,notify 
[tnt] 
on-break=deny,notify,kick 
on-use=deny,notify,kick 
on-place=deny,ban 
on-acquire=deny 

日志
日志有三种选择
* 输出到终端（就是服务器后台）
* 记录日志到文件
* 记录到数据库

在worldguard配置文件（plugins\WorldGuard\config.yml）中可以对日志文件和数据库进行具体设置。

blacklist: 
use-as-whitelist: false 
logging: 
console: 
enable: true 
database: 
enable: false 
dsn: jdbc:mysql://localhost:3306/minecraft 
user: root 
pass: '' 
table: blacklist_events 
file: 
enable: false 
path: worldguard/logs/%Y-%m-%d.log 
open-files: 10 

日志文件的路径中可使用以下“变量”： 
%Y 年 (YYYY) 
%m 月 (MM) 
%d 日 (DD) 
%W 周 (00-52) 
%H 小时（24小时） (HH) 
%h 小时（12小时） (HH) 
%i 分 (mm) 
%s 秒 (ss) 
%u 用户名 
%% 表示“%”符号 

数据库 
worldguard可以将日志记录进mysql数据库，但需要先创建数据库和表，你可以使用下面的语句创建专用的表 

CREATE TABLE IF NOT EXISTS `blacklist_events` ( 
`id` int(11) NOT NULL AUTO_INCREMENT, 
`world` varchar(10) NOT NULL, 
`event` varchar(25) NOT NULL, 
`player` varchar(16) NOT NULL, 
`x` int(11) NOT NULL, 
`y` int(11) NOT NULL, 
`z` int(11) NOT NULL, 
`item` int(11) NOT NULL, 
`time` int(11) NOT NULL, 
`comment` varchar(255) DEFAULT NULL, 
PRIMARY KEY (`id`) 
); 

最后说一下，使用时发现，日志文件功能在某些平台下可能无法正常工作，同时会导致黑名单失效，开启此功能时请务必进行测试。
发射器的部分可能会和其他插件的发射器黑名单冲突导致报错。

=箱子保护=
WorldGuard提供基础的箱子保护服务，
玩家可以通过在箱子下方放置特殊字符的牌子来达到保护的目的。
我们不建议新设置的WorldGuard使用本功能因为本功能并不是WorldGuard常用的一部分
除此以外，区域设置是比本功能更好的保护拥有者财产的方法。
因为它不涉及像漏斗一类方块的问题。

提示：如果你是希望保护单块的方块，箱子等，
我们建议使用第三方保护插件。
例如Lockette 或者 LWC.

启用此功能：
首先箱子保护功能必须在配置文件中启用。
如果没有手动启用，箱子保护功能不会自动工作
这时不能使用牌子锁功能。(此项功能也可在配置文件中禁用)

使用方法：
# 必须是一个信息牌
# 必须位于箱子下面(如果是大箱子，只需在其一侧下面)
# 在第一行输入[Lock]
# 在第二行输入玩家的名字
# 在剩余两行写上其他允许使用玩家的名字
注：不可将其他玩家名字放在第二行的位置
提示：WorldGuard功能并不支持UUID功能
警告：由于Minecraft1.8版本的改变
从旧版本升级将会破坏掉所有的保护牌子
实际上它将破坏全部写有[]的牌子

=主机密码（登录密码）=
在过去由于Minecraft的登录代码问题，玩家可以登录到服务器的任何玩家包括拥有者和管理者的账号上，
在2010-2013年间，有五次利用该性质的漏洞经常导致成千上万的服务器被黑客攻击。

这项登录密码功能作为一个额外的登录屏障被添加到WorldGuard中。
其工作原理是作为一项额外的屏障来达到此功能，与Mojang的登录无关。
在登录时必须发送指定信息 (通俗的说就是输入你的密码)才能登录服务器。
即使攻击者有能力破坏Minecraft的登录系统来成为一个管理员。
但因在服务器缺少发送指定的信息，经服务器检测后无法活动。
注：这种登录验证方式的漏洞是很不明显的，很少见的。

启用功能：
当一个玩家通过某一个地址连接服务器时,输入play.example.com
Minecraft将会告诉服务器该玩家通过这个地址登录
管理者可以通过一个特殊的秘密语句来登录，
比如secretmod.play.example.com这个地址
服务器将会检测到该管理者登录使用的这个地址。
也就是一个类似密码的机制，不过密码是地址格式。

主机密码允许特定玩家使用特定地址登录，
如果地址错误，他将立即被踢下线

配置：

host-keys:
your_username: bagels.play.example.com
moderator1_name: manoverboard.play.example.com
提示:主机密码功能暂不支持UUID功能

DNS配置:
为了使此功能工作，你需要bagels.play.example.com 和 manoverboard.play.example.com 指向你的服务
然而不要在您使用的域名中添加域名的记录，因为很容易使得攻击者找出管理员域名从而登录。

相比之下，我们建议您安装通用地址-“wildcard addresses.”。例如设置了play.example.com，
这将意味着任何相同前缀会允许登录。（例如aa.play.example.com，ab.play.example.com，ac.play.example.com，等）。
提示：如果你没有一个域名或不能设置通配符地址，你可以使用xip.io。

=更多帮助=

你需要更多的帮助吗？我建议你 

你可以去[http://skq.me/irc/irc.esper.net/sk-dev/ IRC]提问 
注*IRC聊天频道是维基百科24小时开放的“聊天室” 

你可以在Twitter上联系[https://twitter.com/sk89q sk89q] 
sk89q是Worldguard的作者（也是Worldedit以及其他不少插件的作者） 

你可以查看[https://github.com/sk89q/worldguard/commits Changelog]（全英文，英文不好的直接跳过吧） 
Changelog就是更新信息（每次更新修改/增加/删除等等了什么） 

你如果有什么建议，或者发现了什么Bug可以到[http://youtrack.sk89q.com/issues?q=project%3A+WorldGuard 这里]反馈（全英文，英文不好的直接跳过吧）

WorldGuard

2015-10-12T15:06:23Z

Lichi2050：/* Javadocs */

Mcbbs发布贴http://www.mcbbs.net/thread-505810-1-1.html
='''配设文件'''=
=指令介绍=
==Region指令==
===定义和重定义区域（define和redifine）===
===区域圈地（claim）===
===区域信息（information）===
===区域选择（select）===
===区域表列（list）===
===设定flag===
===设定优先权(priority)f===
===设定子区域（parent）===
===删除区域（remove）===
===区域传送（teleport）===
===区域管理（management）===
=权限介绍=
=regions教程=
==基础教程==
==flag列表==
===区域权限组===
==开发者 API==
===取读WorldGuard===
===基础权限===
===区域管理===
====查看Flags====
====取读一个区域====
===Javadocs===

查看[http://docs.sk89q.com/worldguard/apidocs/com/sk89q/worldguard/bukkit/WGBukkit.html Javadocs]

==数据格式==

'''Region数据都保存在regions.txt内. 打开后首先会有:'''

Region ID 
Region 类型(type) 

Worldguard3.0版本以下的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 
Priority 优先权（请勿设定为0） 
List of owners 拥有者列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 

Worldguard3.0版本以上的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 

Priority 优先权（请勿设定为0） 
ID of parent region 父regionID（设置过子region才会显示） 
List of owners 拥有者列表 
List of members 会员列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 
Exit message （退出region提示信息） 

拥有者以及会员数据保存方式: 
u: 玩家名称 
g: region权限组 

例如 
u:sk89q,u:tetsu,g:admins 

意思就是sk89q以及tetsu这两个玩家都在admins组内。

Flags数据保存方式: 
每一个flag都会有一个特殊的字母，例如Build就是b，通过一个+或者-我们能够查看这个flag的状态 
+就是启动 
-就是关闭/禁止 
如果没有+或- 那么代表这个flag默认就是启动的 
例如 
+bpmc-t-l-f-F 

{| class="wikitable"
|-
! Flag 名称 !! 代表字母
|-
| Passthrough || z
|-
| Build || b
|-
| PvP || p
|-
| Mob damage || m
|-
| Creeper explosion || c
|-
| TNT || t
|-
| Flint and steel || l
|-
| Fire spread || f
|-
| Lava fire spread || F
|}

=黑名单(Blacklist)=
worldguard黑名单可以指定玩家进行某些动作时的处理方法

比如：
阻止玩家挖掉金矿石。
当有人挖掘钻石块时通知在线管理员。
当玩家放置附魔台时，向放置者发送一条提示消息。

下面是一个黑名单的例子：

除admins,mods组以外禁止使用岩浆桶并向使用者发送自定义提示消息 
[lavabucket] 
ignore-groups=admins,mods 
on-use=deny,tell 
message=不可以使用岩浆桶呢喵！ 

禁止挖掉铁矿和金矿并提示默认消息同时通知在线管理员 
[goldore,ironore] 
ignore-groups=admins 
on-break=deny,tell,notify 

除admins组外禁止放置tnt 放置时会通知管理员并且踢出去 
[tnt] 
ignore-groups=admins 
on-place=deny,notify,kick 

黑名单配置文件

黑名单的配置文件保存在plugins\WorldGuard\worlds下面，每个世界都有单独的配置文件 
例子：

worlds/world/blacklist.txt 主世界 
worlds/world_the_end/blacklist.txt 末地 
worlds/mining_world/blacklist.txt 资源世界（如果服务器有多世界的话） 

提示
worldguard不支持多个世界共用同一个黑名单配置文件，但是你可以利用文件系统的“链接”实现。 
注意：编辑黑名单后需要用/wg reload重新加载才能生效 

格式： 

[物品或方块列表] 
事件=操作 
选项=值 

匹配规则： 

物品/方块列表可以填写数字id或bukkit的材料名（可参考 https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html） 
多个项目之间用半角逗号分隔 
[wood,brick,glass] 
还可以指定数据值如白桦木： 
[17:1] 
白桦木和丛林木： 
[17:1;3] 
指定数据值范围 
[wood:2-3] 
[wood:>=2,<=3] 
这些写法是可以混合使用的 
[wood:0;>=2,grass:1-2] 

事件：
{| class="wikitable"
|-
! Event !! Explanation
|-
| on-break || 破坏方块
|-
| on-destroy-with || 用此物品打破方块
|-
| on-place || 放置方块
|-
| on-use || 使用
|-
| on-interact || 交互，如右键门、拉杆、箱子等
|-
| on-drop || 丢弃特定物品
|-
| on-acquire || 获得物品
|-
| on-dispense || 针对发射器，发射特定物品
|-
|}

操作：
{| class="wikitable"
|-
! Action !! Explanation
|-
| deny || 阻止操作（黑名单模式）
|-
| allow || 允许操作（仅白名单模式）
|-
| notify || 发送通知消息给有worldguard.notify权限的人
|-
| log || 记录日志到终端、日志文件、数据库。
|-
| tell || 给玩家一个提示消息
|-
| kick || 踢出玩家
|-
| ban || 将玩家ban掉（永久性）
|-
|}

选项：
{| class="wikitable"
|-
! Option !! Explanation
|-
| ignore-groups || 忽略特定权限组，多个组用半角逗号分隔
|-
| ignore-perms || 忽略有特定权限的玩家，多个权限同样是用逗号分隔
|-
| comment || 自定义通知消息
|-
| message || 自定义tell的消息，可用%s表示相应物品名
|}

另外一个列子

放置和打破信标时通知在线管理员 
[beacon] 
on-break=notify 
on-place=notify 
阻止用钻石镐和金铲子破坏方块 
[diamond_pickaxe,284] 
on-destroy-with=tell,deny 
阻止使用铁锄、钻石剑耕地和攻击 
[iron_hoe,276] 
on-use=tell,deny 
阻止与箱子、石头按钮交互 
[chest,stone_button] 
on-interact=deny,tell 
阻止丢出命令方块 
[commandblock] 
on-drop=deny,tell 
message=不要乱丢命令方块～ 
除admins组外阻止获得基岩 
[bedrock] 
on-acquire=deny 
ignore-groups=admins 
阻止发射器发射岩浆桶和漏斗矿车 
[lavabucket,hopper_minecart] 
on-dispense=deny,log,notify 
[tnt] 
on-break=deny,notify,kick 
on-use=deny,notify,kick 
on-place=deny,ban 
on-acquire=deny 

日志
日志有三种选择
* 输出到终端（就是服务器后台）
* 记录日志到文件
* 记录到数据库

在worldguard配置文件（plugins\WorldGuard\config.yml）中可以对日志文件和数据库进行具体设置。

blacklist: 
use-as-whitelist: false 
logging: 
console: 
enable: true 
database: 
enable: false 
dsn: jdbc:mysql://localhost:3306/minecraft 
user: root 
pass: '' 
table: blacklist_events 
file: 
enable: false 
path: worldguard/logs/%Y-%m-%d.log 
open-files: 10 

日志文件的路径中可使用以下“变量”： 
%Y 年 (YYYY) 
%m 月 (MM) 
%d 日 (DD) 
%W 周 (00-52) 
%H 小时（24小时） (HH) 
%h 小时（12小时） (HH) 
%i 分 (mm) 
%s 秒 (ss) 
%u 用户名 
%% 表示“%”符号 

数据库 
worldguard可以将日志记录进mysql数据库，但需要先创建数据库和表，你可以使用下面的语句创建专用的表 

CREATE TABLE IF NOT EXISTS `blacklist_events` ( 
`id` int(11) NOT NULL AUTO_INCREMENT, 
`world` varchar(10) NOT NULL, 
`event` varchar(25) NOT NULL, 
`player` varchar(16) NOT NULL, 
`x` int(11) NOT NULL, 
`y` int(11) NOT NULL, 
`z` int(11) NOT NULL, 
`item` int(11) NOT NULL, 
`time` int(11) NOT NULL, 
`comment` varchar(255) DEFAULT NULL, 
PRIMARY KEY (`id`) 
); 

最后说一下，使用时发现，日志文件功能在某些平台下可能无法正常工作，同时会导致黑名单失效，开启此功能时请务必进行测试。
发射器的部分可能会和其他插件的发射器黑名单冲突导致报错。

=箱子保护=
WorldGuard提供基础的箱子保护服务，
玩家可以通过在箱子下方放置特殊字符的牌子来达到保护的目的。
我们不建议新设置的WorldGuard使用本功能因为本功能并不是WorldGuard常用的一部分
除此以外，区域设置是比本功能更好的保护拥有者财产的方法。
因为它不涉及像漏斗一类方块的问题。

提示：如果你是希望保护单块的方块，箱子等，
我们建议使用第三方保护插件。
例如Lockette 或者 LWC.

启用此功能：
首先箱子保护功能必须在配置文件中启用。
如果没有手动启用，箱子保护功能不会自动工作
这时不能使用牌子锁功能。(此项功能也可在配置文件中禁用)

使用方法：
# 必须是一个信息牌
# 必须位于箱子下面(如果是大箱子，只需在其一侧下面)
# 在第一行输入[Lock]
# 在第二行输入玩家的名字
# 在剩余两行写上其他允许使用玩家的名字
注：不可将其他玩家名字放在第二行的位置
提示：WorldGuard功能并不支持UUID功能
警告：由于Minecraft1.8版本的改变
从旧版本升级将会破坏掉所有的保护牌子
实际上它将破坏全部写有[]的牌子

=主机密码（登录密码）=
在过去由于Minecraft的登录代码问题，玩家可以登录到服务器的任何玩家包括拥有者和管理者的账号上，
在2010-2013年间，有五次利用该性质的漏洞经常导致成千上万的服务器被黑客攻击。

这项登录密码功能作为一个额外的登录屏障被添加到WorldGuard中。
其工作原理是作为一项额外的屏障来达到此功能，与Mojang的登录无关。
在登录时必须发送指定信息 (通俗的说就是输入你的密码)才能登录服务器。
即使攻击者有能力破坏Minecraft的登录系统来成为一个管理员。
但因在服务器缺少发送指定的信息，经服务器检测后无法活动。
注：这种登录验证方式的漏洞是很不明显的，很少见的。

启用功能：
当一个玩家通过某一个地址连接服务器时,输入play.example.com
Minecraft将会告诉服务器该玩家通过这个地址登录
管理者可以通过一个特殊的秘密语句来登录，
比如secretmod.play.example.com这个地址
服务器将会检测到该管理者登录使用的这个地址。
也就是一个类似密码的机制，不过密码是地址格式。

主机密码允许特定玩家使用特定地址登录，
如果地址错误，他将立即被踢下线

配置：

host-keys:
your_username: bagels.play.example.com
moderator1_name: manoverboard.play.example.com
提示:主机密码功能暂不支持UUID功能

DNS配置:
为了使此功能工作，你需要bagels.play.example.com 和 manoverboard.play.example.com 指向你的服务
然而不要在您使用的域名中添加域名的记录，因为很容易使得攻击者找出管理员域名从而登录。

相比之下，我们建议您安装通用地址-“wildcard addresses.”。例如设置了play.example.com，
这将意味着任何相同前缀会允许登录。（例如aa.play.example.com，ab.play.example.com，ac.play.example.com，等）。
提示：如果你没有一个域名或不能设置通配符地址，你可以使用xip.io。

=更多帮助=

你需要更多的帮助吗？我建议你 

你可以去[http://skq.me/irc/irc.esper.net/sk-dev/ IRC]提问 
注*IRC聊天频道是维基百科24小时开放的“聊天室” 

你可以在Twitter上联系[https://twitter.com/sk89q sk89q] 
sk89q是Worldguard的作者（也是Worldedit以及其他不少插件的作者） 

你可以查看[https://github.com/sk89q/worldguard/commits Changelog]（全英文，英文不好的直接跳过吧） 
Changelog就是更新信息（每次更新修改/增加/删除等等了什么） 

你如果有什么建议，或者发现了什么Bug可以到[http://youtrack.sk89q.com/issues?q=project%3A+WorldGuard 这里]反馈（全英文，英文不好的直接跳过吧）

WorldGuard

2015-10-12T15:05:13Z

Lichi2050：/* 主机密码（登录密码） */

Mcbbs发布贴http://www.mcbbs.net/thread-505810-1-1.html
='''配设文件'''=
=指令介绍=
==Region指令==
===定义和重定义区域（define和redifine）===
===区域圈地（claim）===
===区域信息（information）===
===区域选择（select）===
===区域表列（list）===
===设定flag===
===设定优先权(priority)f===
===设定子区域（parent）===
===删除区域（remove）===
===区域传送（teleport）===
===区域管理（management）===
=权限介绍=
=regions教程=
==基础教程==
==flag列表==
===区域权限组===
==开发者 API==
===取读WorldGuard===
===基础权限===
===区域管理===
====查看Flags====
====取读一个区域====
===Javadocs===
==数据格式==

'''Region数据都保存在regions.txt内. 打开后首先会有:'''

Region ID 
Region 类型(type) 

Worldguard3.0版本以下的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 
Priority 优先权（请勿设定为0） 
List of owners 拥有者列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 

Worldguard3.0版本以上的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 

Priority 优先权（请勿设定为0） 
ID of parent region 父regionID（设置过子region才会显示） 
List of owners 拥有者列表 
List of members 会员列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 
Exit message （退出region提示信息） 

拥有者以及会员数据保存方式: 
u: 玩家名称 
g: region权限组 

例如 
u:sk89q,u:tetsu,g:admins 

意思就是sk89q以及tetsu这两个玩家都在admins组内。

Flags数据保存方式: 
每一个flag都会有一个特殊的字母，例如Build就是b，通过一个+或者-我们能够查看这个flag的状态 
+就是启动 
-就是关闭/禁止 
如果没有+或- 那么代表这个flag默认就是启动的 
例如 
+bpmc-t-l-f-F 

{| class="wikitable"
|-
! Flag 名称 !! 代表字母
|-
| Passthrough || z
|-
| Build || b
|-
| PvP || p
|-
| Mob damage || m
|-
| Creeper explosion || c
|-
| TNT || t
|-
| Flint and steel || l
|-
| Fire spread || f
|-
| Lava fire spread || F
|}

=黑名单(Blacklist)=
worldguard黑名单可以指定玩家进行某些动作时的处理方法

比如：
阻止玩家挖掉金矿石。
当有人挖掘钻石块时通知在线管理员。
当玩家放置附魔台时，向放置者发送一条提示消息。

下面是一个黑名单的例子：

除admins,mods组以外禁止使用岩浆桶并向使用者发送自定义提示消息 
[lavabucket] 
ignore-groups=admins,mods 
on-use=deny,tell 
message=不可以使用岩浆桶呢喵！ 

禁止挖掉铁矿和金矿并提示默认消息同时通知在线管理员 
[goldore,ironore] 
ignore-groups=admins 
on-break=deny,tell,notify 

除admins组外禁止放置tnt 放置时会通知管理员并且踢出去 
[tnt] 
ignore-groups=admins 
on-place=deny,notify,kick 

黑名单配置文件

黑名单的配置文件保存在plugins\WorldGuard\worlds下面，每个世界都有单独的配置文件 
例子：

worlds/world/blacklist.txt 主世界 
worlds/world_the_end/blacklist.txt 末地 
worlds/mining_world/blacklist.txt 资源世界（如果服务器有多世界的话） 

提示
worldguard不支持多个世界共用同一个黑名单配置文件，但是你可以利用文件系统的“链接”实现。 
注意：编辑黑名单后需要用/wg reload重新加载才能生效 

格式： 

[物品或方块列表] 
事件=操作 
选项=值 

匹配规则： 

物品/方块列表可以填写数字id或bukkit的材料名（可参考 https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html） 
多个项目之间用半角逗号分隔 
[wood,brick,glass] 
还可以指定数据值如白桦木： 
[17:1] 
白桦木和丛林木： 
[17:1;3] 
指定数据值范围 
[wood:2-3] 
[wood:>=2,<=3] 
这些写法是可以混合使用的 
[wood:0;>=2,grass:1-2] 

事件：
{| class="wikitable"
|-
! Event !! Explanation
|-
| on-break || 破坏方块
|-
| on-destroy-with || 用此物品打破方块
|-
| on-place || 放置方块
|-
| on-use || 使用
|-
| on-interact || 交互，如右键门、拉杆、箱子等
|-
| on-drop || 丢弃特定物品
|-
| on-acquire || 获得物品
|-
| on-dispense || 针对发射器，发射特定物品
|-
|}

操作：
{| class="wikitable"
|-
! Action !! Explanation
|-
| deny || 阻止操作（黑名单模式）
|-
| allow || 允许操作（仅白名单模式）
|-
| notify || 发送通知消息给有worldguard.notify权限的人
|-
| log || 记录日志到终端、日志文件、数据库。
|-
| tell || 给玩家一个提示消息
|-
| kick || 踢出玩家
|-
| ban || 将玩家ban掉（永久性）
|-
|}

选项：
{| class="wikitable"
|-
! Option !! Explanation
|-
| ignore-groups || 忽略特定权限组，多个组用半角逗号分隔
|-
| ignore-perms || 忽略有特定权限的玩家，多个权限同样是用逗号分隔
|-
| comment || 自定义通知消息
|-
| message || 自定义tell的消息，可用%s表示相应物品名
|}

另外一个列子

放置和打破信标时通知在线管理员 
[beacon] 
on-break=notify 
on-place=notify 
阻止用钻石镐和金铲子破坏方块 
[diamond_pickaxe,284] 
on-destroy-with=tell,deny 
阻止使用铁锄、钻石剑耕地和攻击 
[iron_hoe,276] 
on-use=tell,deny 
阻止与箱子、石头按钮交互 
[chest,stone_button] 
on-interact=deny,tell 
阻止丢出命令方块 
[commandblock] 
on-drop=deny,tell 
message=不要乱丢命令方块～ 
除admins组外阻止获得基岩 
[bedrock] 
on-acquire=deny 
ignore-groups=admins 
阻止发射器发射岩浆桶和漏斗矿车 
[lavabucket,hopper_minecart] 
on-dispense=deny,log,notify 
[tnt] 
on-break=deny,notify,kick 
on-use=deny,notify,kick 
on-place=deny,ban 
on-acquire=deny 

日志
日志有三种选择
* 输出到终端（就是服务器后台）
* 记录日志到文件
* 记录到数据库

在worldguard配置文件（plugins\WorldGuard\config.yml）中可以对日志文件和数据库进行具体设置。

blacklist: 
use-as-whitelist: false 
logging: 
console: 
enable: true 
database: 
enable: false 
dsn: jdbc:mysql://localhost:3306/minecraft 
user: root 
pass: '' 
table: blacklist_events 
file: 
enable: false 
path: worldguard/logs/%Y-%m-%d.log 
open-files: 10 

日志文件的路径中可使用以下“变量”： 
%Y 年 (YYYY) 
%m 月 (MM) 
%d 日 (DD) 
%W 周 (00-52) 
%H 小时（24小时） (HH) 
%h 小时（12小时） (HH) 
%i 分 (mm) 
%s 秒 (ss) 
%u 用户名 
%% 表示“%”符号 

数据库 
worldguard可以将日志记录进mysql数据库，但需要先创建数据库和表，你可以使用下面的语句创建专用的表 

CREATE TABLE IF NOT EXISTS `blacklist_events` ( 
`id` int(11) NOT NULL AUTO_INCREMENT, 
`world` varchar(10) NOT NULL, 
`event` varchar(25) NOT NULL, 
`player` varchar(16) NOT NULL, 
`x` int(11) NOT NULL, 
`y` int(11) NOT NULL, 
`z` int(11) NOT NULL, 
`item` int(11) NOT NULL, 
`time` int(11) NOT NULL, 
`comment` varchar(255) DEFAULT NULL, 
PRIMARY KEY (`id`) 
); 

最后说一下，使用时发现，日志文件功能在某些平台下可能无法正常工作，同时会导致黑名单失效，开启此功能时请务必进行测试。
发射器的部分可能会和其他插件的发射器黑名单冲突导致报错。

=箱子保护=
WorldGuard提供基础的箱子保护服务，
玩家可以通过在箱子下方放置特殊字符的牌子来达到保护的目的。
我们不建议新设置的WorldGuard使用本功能因为本功能并不是WorldGuard常用的一部分
除此以外，区域设置是比本功能更好的保护拥有者财产的方法。
因为它不涉及像漏斗一类方块的问题。

提示：如果你是希望保护单块的方块，箱子等，
我们建议使用第三方保护插件。
例如Lockette 或者 LWC.

启用此功能：
首先箱子保护功能必须在配置文件中启用。
如果没有手动启用，箱子保护功能不会自动工作
这时不能使用牌子锁功能。(此项功能也可在配置文件中禁用)

使用方法：
# 必须是一个信息牌
# 必须位于箱子下面(如果是大箱子，只需在其一侧下面)
# 在第一行输入[Lock]
# 在第二行输入玩家的名字
# 在剩余两行写上其他允许使用玩家的名字
注：不可将其他玩家名字放在第二行的位置
提示：WorldGuard功能并不支持UUID功能
警告：由于Minecraft1.8版本的改变
从旧版本升级将会破坏掉所有的保护牌子
实际上它将破坏全部写有[]的牌子

=主机密码（登录密码）=
在过去由于Minecraft的登录代码问题，玩家可以登录到服务器的任何玩家包括拥有者和管理者的账号上，
在2010-2013年间，有五次利用该性质的漏洞经常导致成千上万的服务器被黑客攻击。

这项登录密码功能作为一个额外的登录屏障被添加到WorldGuard中。
其工作原理是作为一项额外的屏障来达到此功能，与Mojang的登录无关。
在登录时必须发送指定信息 (通俗的说就是输入你的密码)才能登录服务器。
即使攻击者有能力破坏Minecraft的登录系统来成为一个管理员。
但因在服务器缺少发送指定的信息，经服务器检测后无法活动。
注：这种登录验证方式的漏洞是很不明显的，很少见的。

启用功能：
当一个玩家通过某一个地址连接服务器时,输入play.example.com
Minecraft将会告诉服务器该玩家通过这个地址登录
管理者可以通过一个特殊的秘密语句来登录，
比如secretmod.play.example.com这个地址
服务器将会检测到该管理者登录使用的这个地址。
也就是一个类似密码的机制，不过密码是地址格式。

主机密码允许特定玩家使用特定地址登录，
如果地址错误，他将立即被踢下线

配置：

host-keys:
your_username: bagels.play.example.com
moderator1_name: manoverboard.play.example.com
提示:主机密码功能暂不支持UUID功能

DNS配置:
为了使此功能工作，你需要bagels.play.example.com 和 manoverboard.play.example.com 指向你的服务
然而不要在您使用的域名中添加域名的记录，因为很容易使得攻击者找出管理员域名从而登录。

相比之下，我们建议您安装通用地址-“wildcard addresses.”。例如设置了play.example.com，
这将意味着任何相同前缀会允许登录。（例如aa.play.example.com，ab.play.example.com，ac.play.example.com，等）。
提示：如果你没有一个域名或不能设置通配符地址，你可以使用xip.io。

=更多帮助=

你需要更多的帮助吗？我建议你 

你可以去[http://skq.me/irc/irc.esper.net/sk-dev/ IRC]提问 
注*IRC聊天频道是维基百科24小时开放的“聊天室” 

你可以在Twitter上联系[https://twitter.com/sk89q sk89q] 
sk89q是Worldguard的作者（也是Worldedit以及其他不少插件的作者） 

你可以查看[https://github.com/sk89q/worldguard/commits Changelog]（全英文，英文不好的直接跳过吧） 
Changelog就是更新信息（每次更新修改/增加/删除等等了什么） 

你如果有什么建议，或者发现了什么Bug可以到[http://youtrack.sk89q.com/issues?q=project%3A+WorldGuard 这里]反馈（全英文，英文不好的直接跳过吧）

WorldGuard

2015-10-12T15:04:41Z

Lichi2050：/* 更多帮助 */

Mcbbs发布贴http://www.mcbbs.net/thread-505810-1-1.html
='''配设文件'''=
=指令介绍=
==Region指令==
===定义和重定义区域（define和redifine）===
===区域圈地（claim）===
===区域信息（information）===
===区域选择（select）===
===区域表列（list）===
===设定flag===
===设定优先权(priority)f===
===设定子区域（parent）===
===删除区域（remove）===
===区域传送（teleport）===
===区域管理（management）===
=权限介绍=
=regions教程=
==基础教程==
==flag列表==
===区域权限组===
==开发者 API==
===取读WorldGuard===
===基础权限===
===区域管理===
====查看Flags====
====取读一个区域====
===Javadocs===
==数据格式==

'''Region数据都保存在regions.txt内. 打开后首先会有:'''

Region ID 
Region 类型(type) 

Worldguard3.0版本以下的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 
Priority 优先权（请勿设定为0） 
List of owners 拥有者列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 

Worldguard3.0版本以上的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 

Priority 优先权（请勿设定为0） 
ID of parent region 父regionID（设置过子region才会显示） 
List of owners 拥有者列表 
List of members 会员列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 
Exit message （退出region提示信息） 

拥有者以及会员数据保存方式: 
u: 玩家名称 
g: region权限组 

例如 
u:sk89q,u:tetsu,g:admins 

意思就是sk89q以及tetsu这两个玩家都在admins组内。

Flags数据保存方式: 
每一个flag都会有一个特殊的字母，例如Build就是b，通过一个+或者-我们能够查看这个flag的状态 
+就是启动 
-就是关闭/禁止 
如果没有+或- 那么代表这个flag默认就是启动的 
例如 
+bpmc-t-l-f-F 

{| class="wikitable"
|-
! Flag 名称 !! 代表字母
|-
| Passthrough || z
|-
| Build || b
|-
| PvP || p
|-
| Mob damage || m
|-
| Creeper explosion || c
|-
| TNT || t
|-
| Flint and steel || l
|-
| Fire spread || f
|-
| Lava fire spread || F
|}

=黑名单(Blacklist)=
worldguard黑名单可以指定玩家进行某些动作时的处理方法

比如：
阻止玩家挖掉金矿石。
当有人挖掘钻石块时通知在线管理员。
当玩家放置附魔台时，向放置者发送一条提示消息。

下面是一个黑名单的例子：

除admins,mods组以外禁止使用岩浆桶并向使用者发送自定义提示消息 
[lavabucket] 
ignore-groups=admins,mods 
on-use=deny,tell 
message=不可以使用岩浆桶呢喵！ 

禁止挖掉铁矿和金矿并提示默认消息同时通知在线管理员 
[goldore,ironore] 
ignore-groups=admins 
on-break=deny,tell,notify 

除admins组外禁止放置tnt 放置时会通知管理员并且踢出去 
[tnt] 
ignore-groups=admins 
on-place=deny,notify,kick 

黑名单配置文件

黑名单的配置文件保存在plugins\WorldGuard\worlds下面，每个世界都有单独的配置文件 
例子：

worlds/world/blacklist.txt 主世界 
worlds/world_the_end/blacklist.txt 末地 
worlds/mining_world/blacklist.txt 资源世界（如果服务器有多世界的话） 

提示
worldguard不支持多个世界共用同一个黑名单配置文件，但是你可以利用文件系统的“链接”实现。 
注意：编辑黑名单后需要用/wg reload重新加载才能生效 

格式： 

[物品或方块列表] 
事件=操作 
选项=值 

匹配规则： 

物品/方块列表可以填写数字id或bukkit的材料名（可参考 https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html） 
多个项目之间用半角逗号分隔 
[wood,brick,glass] 
还可以指定数据值如白桦木： 
[17:1] 
白桦木和丛林木： 
[17:1;3] 
指定数据值范围 
[wood:2-3] 
[wood:>=2,<=3] 
这些写法是可以混合使用的 
[wood:0;>=2,grass:1-2] 

事件：
{| class="wikitable"
|-
! Event !! Explanation
|-
| on-break || 破坏方块
|-
| on-destroy-with || 用此物品打破方块
|-
| on-place || 放置方块
|-
| on-use || 使用
|-
| on-interact || 交互，如右键门、拉杆、箱子等
|-
| on-drop || 丢弃特定物品
|-
| on-acquire || 获得物品
|-
| on-dispense || 针对发射器，发射特定物品
|-
|}

操作：
{| class="wikitable"
|-
! Action !! Explanation
|-
| deny || 阻止操作（黑名单模式）
|-
| allow || 允许操作（仅白名单模式）
|-
| notify || 发送通知消息给有worldguard.notify权限的人
|-
| log || 记录日志到终端、日志文件、数据库。
|-
| tell || 给玩家一个提示消息
|-
| kick || 踢出玩家
|-
| ban || 将玩家ban掉（永久性）
|-
|}

选项：
{| class="wikitable"
|-
! Option !! Explanation
|-
| ignore-groups || 忽略特定权限组，多个组用半角逗号分隔
|-
| ignore-perms || 忽略有特定权限的玩家，多个权限同样是用逗号分隔
|-
| comment || 自定义通知消息
|-
| message || 自定义tell的消息，可用%s表示相应物品名
|}

另外一个列子

放置和打破信标时通知在线管理员 
[beacon] 
on-break=notify 
on-place=notify 
阻止用钻石镐和金铲子破坏方块 
[diamond_pickaxe,284] 
on-destroy-with=tell,deny 
阻止使用铁锄、钻石剑耕地和攻击 
[iron_hoe,276] 
on-use=tell,deny 
阻止与箱子、石头按钮交互 
[chest,stone_button] 
on-interact=deny,tell 
阻止丢出命令方块 
[commandblock] 
on-drop=deny,tell 
message=不要乱丢命令方块～ 
除admins组外阻止获得基岩 
[bedrock] 
on-acquire=deny 
ignore-groups=admins 
阻止发射器发射岩浆桶和漏斗矿车 
[lavabucket,hopper_minecart] 
on-dispense=deny,log,notify 
[tnt] 
on-break=deny,notify,kick 
on-use=deny,notify,kick 
on-place=deny,ban 
on-acquire=deny 

日志
日志有三种选择
* 输出到终端（就是服务器后台）
* 记录日志到文件
* 记录到数据库

在worldguard配置文件（plugins\WorldGuard\config.yml）中可以对日志文件和数据库进行具体设置。

blacklist: 
use-as-whitelist: false 
logging: 
console: 
enable: true 
database: 
enable: false 
dsn: jdbc:mysql://localhost:3306/minecraft 
user: root 
pass: '' 
table: blacklist_events 
file: 
enable: false 
path: worldguard/logs/%Y-%m-%d.log 
open-files: 10 

日志文件的路径中可使用以下“变量”： 
%Y 年 (YYYY) 
%m 月 (MM) 
%d 日 (DD) 
%W 周 (00-52) 
%H 小时（24小时） (HH) 
%h 小时（12小时） (HH) 
%i 分 (mm) 
%s 秒 (ss) 
%u 用户名 
%% 表示“%”符号 

数据库 
worldguard可以将日志记录进mysql数据库，但需要先创建数据库和表，你可以使用下面的语句创建专用的表 

CREATE TABLE IF NOT EXISTS `blacklist_events` ( 
`id` int(11) NOT NULL AUTO_INCREMENT, 
`world` varchar(10) NOT NULL, 
`event` varchar(25) NOT NULL, 
`player` varchar(16) NOT NULL, 
`x` int(11) NOT NULL, 
`y` int(11) NOT NULL, 
`z` int(11) NOT NULL, 
`item` int(11) NOT NULL, 
`time` int(11) NOT NULL, 
`comment` varchar(255) DEFAULT NULL, 
PRIMARY KEY (`id`) 
); 

最后说一下，使用时发现，日志文件功能在某些平台下可能无法正常工作，同时会导致黑名单失效，开启此功能时请务必进行测试。
发射器的部分可能会和其他插件的发射器黑名单冲突导致报错。

=箱子保护=
WorldGuard提供基础的箱子保护服务，
玩家可以通过在箱子下方放置特殊字符的牌子来达到保护的目的。
我们不建议新设置的WorldGuard使用本功能因为本功能并不是WorldGuard常用的一部分
除此以外，区域设置是比本功能更好的保护拥有者财产的方法。
因为它不涉及像漏斗一类方块的问题。

提示：如果你是希望保护单块的方块，箱子等，
我们建议使用第三方保护插件。
例如Lockette 或者 LWC.

启用此功能：
首先箱子保护功能必须在配置文件中启用。
如果没有手动启用，箱子保护功能不会自动工作
这时不能使用牌子锁功能。(此项功能也可在配置文件中禁用)

使用方法：
# 必须是一个信息牌
# 必须位于箱子下面(如果是大箱子，只需在其一侧下面)
# 在第一行输入[Lock]
# 在第二行输入玩家的名字
# 在剩余两行写上其他允许使用玩家的名字
注：不可将其他玩家名字放在第二行的位置
提示：WorldGuard功能并不支持UUID功能
警告：由于Minecraft1.8版本的改变
从旧版本升级将会破坏掉所有的保护牌子
实际上它将破坏全部写有[]的牌子

=主机密码（登录密码）=
在过去由于Minecraft的登录代码问题，玩家可以登录到服务器的任何玩家包括拥有者和管理者的账号上，
在2010-2013年间，有五次利用该性质的漏洞经常导致成千上万的服务器被黑客攻击。

这项登录密码功能作为一个额外的登录屏障被添加到WorldGuard中。
其工作原理是作为一项额外的屏障来达到此功能，与Mojang的登录无关。
在登录时必须发送指定信息 (通俗的说就是输入你的密码)才能登录服务器。
即使攻击者有能力破坏Minecraft的登录系统来成为一个管理员。
但因在服务器缺少发送指定的信息，经服务器检测后无法活动。
注：这种登录验证方式的漏洞是很不明显的，很少见的。

启用功能：
当一个玩家通过某一个地址连接服务器时,输入play.example.com
Minecraft将会告诉服务器该玩家通过这个地址登录
管理者可以通过一个特殊的秘密语句来登录，
比如secretmod.play.example.com这个地址
服务器将会检测到该管理者登录使用的这个地址。
也就是一个类似密码的机制，不过密码是地址格式。

主机密码允许特定玩家使用特定地址登录，
如果地址错误，他将立即被踢下线

配置：

host-keys:
your_username: bagels.play.example.com
moderator1_name: manoverboard.play.example.com
提示:主机密码功能暂不支持UUID功能

DNS配置:
为了使此功能工作，你需要bagels.play.example.com 和 manoverboard.play.example.com 指向你的服务
然而不要在您使用的域名中添加域名的记录，因为很容易使得攻击者找出管理员域名从而登录。

相比之下，我们建议您安装通用地址-“wildcard addresses.”。例如设置了play.example.com，
这将意味着任何相同前缀会允许登录。（例如aa.play.example.com，ab.play.example.com，ac.play.example.com，等）。
提示：如果你没有一个域名或不能设置通配符地址，你可以使用xip.io。
=更多帮助= 

你需要更多的帮助吗？我建议你 

你可以去[http://skq.me/irc/irc.esper.net/sk-dev/ IRC]提问 
注*IRC聊天频道是维基百科24小时开放的“聊天室” 

你可以在Twitter上联系[https://twitter.com/sk89q sk89q] 
sk89q是Worldguard的作者（也是Worldedit以及其他不少插件的作者） 

你可以查看[https://github.com/sk89q/worldguard/commits Changelog]（全英文，英文不好的直接跳过吧） 
Changelog就是更新信息（每次更新修改/增加/删除等等了什么） 

你如果有什么建议，或者发现了什么Bug可以到[http://youtrack.sk89q.com/issues?q=project%3A+WorldGuard 这里]反馈（全英文，英文不好的直接跳过吧）

WorldGuard

2015-10-12T15:03:43Z

Lichi2050：/* 数据格式 */

Mcbbs发布贴http://www.mcbbs.net/thread-505810-1-1.html
='''配设文件'''=
=指令介绍=
==Region指令==
===定义和重定义区域（define和redifine）===
===区域圈地（claim）===
===区域信息（information）===
===区域选择（select）===
===区域表列（list）===
===设定flag===
===设定优先权(priority)f===
===设定子区域（parent）===
===删除区域（remove）===
===区域传送（teleport）===
===区域管理（management）===
=权限介绍=
=regions教程=
==基础教程==
==flag列表==
===区域权限组===
==开发者 API==
===取读WorldGuard===
===基础权限===
===区域管理===
====查看Flags====
====取读一个区域====
===Javadocs===
==数据格式==

'''Region数据都保存在regions.txt内. 打开后首先会有:'''

Region ID 
Region 类型(type) 

Worldguard3.0版本以下的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 
Priority 优先权（请勿设定为0） 
List of owners 拥有者列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 

Worldguard3.0版本以上的保存方式: 
Point 1 X region坐标 
Point 1 Y ↓ 
Point 1 Z ↓ 
Point 2 X ↑ 
Point 2 Y ↑ 
Point 2 Z region坐标 

Priority 优先权（请勿设定为0） 
ID of parent region 父regionID（设置过子region才会显示） 
List of owners 拥有者列表 
List of members 会员列表 
List of flags Flags列表（设置过的） 
Entry message （进入region提示信息/欢迎语） 
Exit message （退出region提示信息） 

拥有者以及会员数据保存方式: 
u: 玩家名称 
g: region权限组 

例如 
u:sk89q,u:tetsu,g:admins 

意思就是sk89q以及tetsu这两个玩家都在admins组内。

Flags数据保存方式: 
每一个flag都会有一个特殊的字母，例如Build就是b，通过一个+或者-我们能够查看这个flag的状态 
+就是启动 
-就是关闭/禁止 
如果没有+或- 那么代表这个flag默认就是启动的 
例如 
+bpmc-t-l-f-F 

{| class="wikitable"
|-
! Flag 名称 !! 代表字母
|-
| Passthrough || z
|-
| Build || b
|-
| PvP || p
|-
| Mob damage || m
|-
| Creeper explosion || c
|-
| TNT || t
|-
| Flint and steel || l
|-
| Fire spread || f
|-
| Lava fire spread || F
|}

=黑名单(Blacklist)=
worldguard黑名单可以指定玩家进行某些动作时的处理方法

比如：
阻止玩家挖掉金矿石。
当有人挖掘钻石块时通知在线管理员。
当玩家放置附魔台时，向放置者发送一条提示消息。

下面是一个黑名单的例子：

除admins,mods组以外禁止使用岩浆桶并向使用者发送自定义提示消息 
[lavabucket] 
ignore-groups=admins,mods 
on-use=deny,tell 
message=不可以使用岩浆桶呢喵！ 

禁止挖掉铁矿和金矿并提示默认消息同时通知在线管理员 
[goldore,ironore] 
ignore-groups=admins 
on-break=deny,tell,notify 

除admins组外禁止放置tnt 放置时会通知管理员并且踢出去 
[tnt] 
ignore-groups=admins 
on-place=deny,notify,kick 

黑名单配置文件

黑名单的配置文件保存在plugins\WorldGuard\worlds下面，每个世界都有单独的配置文件 
例子：

worlds/world/blacklist.txt 主世界 
worlds/world_the_end/blacklist.txt 末地 
worlds/mining_world/blacklist.txt 资源世界（如果服务器有多世界的话） 

提示
worldguard不支持多个世界共用同一个黑名单配置文件，但是你可以利用文件系统的“链接”实现。 
注意：编辑黑名单后需要用/wg reload重新加载才能生效 

格式： 

[物品或方块列表] 
事件=操作 
选项=值 

匹配规则： 

物品/方块列表可以填写数字id或bukkit的材料名（可参考 https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html） 
多个项目之间用半角逗号分隔 
[wood,brick,glass] 
还可以指定数据值如白桦木： 
[17:1] 
白桦木和丛林木： 
[17:1;3] 
指定数据值范围 
[wood:2-3] 
[wood:>=2,<=3] 
这些写法是可以混合使用的 
[wood:0;>=2,grass:1-2] 

事件：
{| class="wikitable"
|-
! Event !! Explanation
|-
| on-break || 破坏方块
|-
| on-destroy-with || 用此物品打破方块
|-
| on-place || 放置方块
|-
| on-use || 使用
|-
| on-interact || 交互，如右键门、拉杆、箱子等
|-
| on-drop || 丢弃特定物品
|-
| on-acquire || 获得物品
|-
| on-dispense || 针对发射器，发射特定物品
|-
|}

操作：
{| class="wikitable"
|-
! Action !! Explanation
|-
| deny || 阻止操作（黑名单模式）
|-
| allow || 允许操作（仅白名单模式）
|-
| notify || 发送通知消息给有worldguard.notify权限的人
|-
| log || 记录日志到终端、日志文件、数据库。
|-
| tell || 给玩家一个提示消息
|-
| kick || 踢出玩家
|-
| ban || 将玩家ban掉（永久性）
|-
|}

选项：
{| class="wikitable"
|-
! Option !! Explanation
|-
| ignore-groups || 忽略特定权限组，多个组用半角逗号分隔
|-
| ignore-perms || 忽略有特定权限的玩家，多个权限同样是用逗号分隔
|-
| comment || 自定义通知消息
|-
| message || 自定义tell的消息，可用%s表示相应物品名
|}

另外一个列子

放置和打破信标时通知在线管理员 
[beacon] 
on-break=notify 
on-place=notify 
阻止用钻石镐和金铲子破坏方块 
[diamond_pickaxe,284] 
on-destroy-with=tell,deny 
阻止使用铁锄、钻石剑耕地和攻击 
[iron_hoe,276] 
on-use=tell,deny 
阻止与箱子、石头按钮交互 
[chest,stone_button] 
on-interact=deny,tell 
阻止丢出命令方块 
[commandblock] 
on-drop=deny,tell 
message=不要乱丢命令方块～ 
除admins组外阻止获得基岩 
[bedrock] 
on-acquire=deny 
ignore-groups=admins 
阻止发射器发射岩浆桶和漏斗矿车 
[lavabucket,hopper_minecart] 
on-dispense=deny,log,notify 
[tnt] 
on-break=deny,notify,kick 
on-use=deny,notify,kick 
on-place=deny,ban 
on-acquire=deny 

日志
日志有三种选择
* 输出到终端（就是服务器后台）
* 记录日志到文件
* 记录到数据库

在worldguard配置文件（plugins\WorldGuard\config.yml）中可以对日志文件和数据库进行具体设置。

blacklist: 
use-as-whitelist: false 
logging: 
console: 
enable: true 
database: 
enable: false 
dsn: jdbc:mysql://localhost:3306/minecraft 
user: root 
pass: '' 
table: blacklist_events 
file: 
enable: false 
path: worldguard/logs/%Y-%m-%d.log 
open-files: 10 

日志文件的路径中可使用以下“变量”： 
%Y 年 (YYYY) 
%m 月 (MM) 
%d 日 (DD) 
%W 周 (00-52) 
%H 小时（24小时） (HH) 
%h 小时（12小时） (HH) 
%i 分 (mm) 
%s 秒 (ss) 
%u 用户名 
%% 表示“%”符号 

数据库 
worldguard可以将日志记录进mysql数据库，但需要先创建数据库和表，你可以使用下面的语句创建专用的表 

CREATE TABLE IF NOT EXISTS `blacklist_events` ( 
`id` int(11) NOT NULL AUTO_INCREMENT, 
`world` varchar(10) NOT NULL, 
`event` varchar(25) NOT NULL, 
`player` varchar(16) NOT NULL, 
`x` int(11) NOT NULL, 
`y` int(11) NOT NULL, 
`z` int(11) NOT NULL, 
`item` int(11) NOT NULL, 
`time` int(11) NOT NULL, 
`comment` varchar(255) DEFAULT NULL, 
PRIMARY KEY (`id`) 
); 

最后说一下，使用时发现，日志文件功能在某些平台下可能无法正常工作，同时会导致黑名单失效，开启此功能时请务必进行测试。
发射器的部分可能会和其他插件的发射器黑名单冲突导致报错。

=箱子保护=
WorldGuard提供基础的箱子保护服务，
玩家可以通过在箱子下方放置特殊字符的牌子来达到保护的目的。
我们不建议新设置的WorldGuard使用本功能因为本功能并不是WorldGuard常用的一部分
除此以外，区域设置是比本功能更好的保护拥有者财产的方法。
因为它不涉及像漏斗一类方块的问题。

提示：如果你是希望保护单块的方块，箱子等，
我们建议使用第三方保护插件。
例如Lockette 或者 LWC.

启用此功能：
首先箱子保护功能必须在配置文件中启用。
如果没有手动启用，箱子保护功能不会自动工作
这时不能使用牌子锁功能。(此项功能也可在配置文件中禁用)

使用方法：
# 必须是一个信息牌
# 必须位于箱子下面(如果是大箱子，只需在其一侧下面)
# 在第一行输入[Lock]
# 在第二行输入玩家的名字
# 在剩余两行写上其他允许使用玩家的名字
注：不可将其他玩家名字放在第二行的位置
提示：WorldGuard功能并不支持UUID功能
警告：由于Minecraft1.8版本的改变
从旧版本升级将会破坏掉所有的保护牌子
实际上它将破坏全部写有[]的牌子

=主机密码（登录密码）=
在过去由于Minecraft的登录代码问题，玩家可以登录到服务器的任何玩家包括拥有者和管理者的账号上，
在2010-2013年间，有五次利用该性质的漏洞经常导致成千上万的服务器被黑客攻击。

这项登录密码功能作为一个额外的登录屏障被添加到WorldGuard中。
其工作原理是作为一项额外的屏障来达到此功能，与Mojang的登录无关。
在登录时必须发送指定信息 (通俗的说就是输入你的密码)才能登录服务器。
即使攻击者有能力破坏Minecraft的登录系统来成为一个管理员。
但因在服务器缺少发送指定的信息，经服务器检测后无法活动。
注：这种登录验证方式的漏洞是很不明显的，很少见的。

启用功能：
当一个玩家通过某一个地址连接服务器时,输入play.example.com
Minecraft将会告诉服务器该玩家通过这个地址登录
管理者可以通过一个特殊的秘密语句来登录，
比如secretmod.play.example.com这个地址
服务器将会检测到该管理者登录使用的这个地址。
也就是一个类似密码的机制，不过密码是地址格式。

主机密码允许特定玩家使用特定地址登录，
如果地址错误，他将立即被踢下线

配置：

host-keys:
your_username: bagels.play.example.com
moderator1_name: manoverboard.play.example.com
提示:主机密码功能暂不支持UUID功能

DNS配置:
为了使此功能工作，你需要bagels.play.example.com 和 manoverboard.play.example.com 指向你的服务
然而不要在您使用的域名中添加域名的记录，因为很容易使得攻击者找出管理员域名从而登录。

相比之下，我们建议您安装通用地址-“wildcard addresses.”。例如设置了play.example.com，
这将意味着任何相同前缀会允许登录。（例如aa.play.example.com，ab.play.example.com，ac.play.example.com，等）。
提示：如果你没有一个域名或不能设置通配符地址，你可以使用xip.io。
=更多帮助=
你需要更多的帮助吗？我建议你
你可以去[http://skq.me/irc/irc.esper.net/sk-dev/ IRC]提问
 
注*IRC聊天频道是维基百科24小时开放的“聊天室”
你可以在Twitter上联系[https://twitter.com/sk89q sk89q]
sk89q是Worldguard的作者（也是Worldedit以及其他不少插件的作者）
 
你可以查看[https://github.com/sk89q/worldguard/commits Changelog]（全英文，英文不好的直接跳过吧）
Changelog就是更新信息（每次更新修改/增加/删除等等了什么）
你如果有什么建议，或者发现了什么Bug可以到[http://youtrack.sk89q.com/issues?q=project%3A+WorldGuard 这里]反馈（全英文，英文不好的直接跳过吧）

WorldGuard

2015-10-11T17:49:35Z

Lichi2050：创建页面，内容为“Mcbbs发布贴http://www.mcbbs.net/thread-505810-1-1.html ='''配设文件'''= =指令介绍= ==Region指令== ===定义和重定义区域（define和redifine）===...”

Mcbbs发布贴http://www.mcbbs.net/thread-505810-1-1.html
='''配设文件'''=
=指令介绍=
==Region指令==
===定义和重定义区域（define和redifine）===
===区域圈地（claim）===
===区域信息（information）===
===区域选择（select）===
===区域表列（list）===
===设定flag===
===设定优先权(priority)f===
===设定子区域（parent）===
===删除区域（remove）===
===区域传送（teleport）===
===区域管理（management）===
=权限介绍=
=regions教程=
==基础教程==
==flag列表==
===区域权限组===
==开发者 API==
===取读WorldGuard===
===基础权限===
===区域管理===
====查看Flags====
====取读一个区域====
===Javadocs===
==数据格式==
=黑名单(Blacklist)=
worldguard黑名单可以指定玩家进行某些动作时的处理方法

比如：
阻止玩家挖掉金矿石。
当有人挖掘钻石块时通知在线管理员。
当玩家放置附魔台时，向放置者发送一条提示消息。

下面是一个黑名单的例子：

除admins,mods组以外禁止使用岩浆桶并向使用者发送自定义提示消息 
[lavabucket] 
ignore-groups=admins,mods 
on-use=deny,tell 
message=不可以使用岩浆桶呢喵！ 

禁止挖掉铁矿和金矿并提示默认消息同时通知在线管理员 
[goldore,ironore] 
ignore-groups=admins 
on-break=deny,tell,notify 

除admins组外禁止放置tnt 放置时会通知管理员并且踢出去 
[tnt] 
ignore-groups=admins 
on-place=deny,notify,kick 

黑名单配置文件

黑名单的配置文件保存在plugins\WorldGuard\worlds下面，每个世界都有单独的配置文件 
例子：

worlds/world/blacklist.txt 主世界 
worlds/world_the_end/blacklist.txt 末地 
worlds/mining_world/blacklist.txt 资源世界（如果服务器有多世界的话） 

提示
worldguard不支持多个世界共用同一个黑名单配置文件，但是你可以利用文件系统的“链接”实现。 
注意：编辑黑名单后需要用/wg reload重新加载才能生效 

格式： 

[物品或方块列表] 
事件=操作 
选项=值 

匹配规则： 

物品/方块列表可以填写数字id或bukkit的材料名（可参考 https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html） 
多个项目之间用半角逗号分隔 
[wood,brick,glass] 
还可以指定数据值如白桦木： 
[17:1] 
白桦木和丛林木： 
[17:1;3] 
指定数据值范围 
[wood:2-3] 
[wood:>=2,<=3] 
这些写法是可以混合使用的 
[wood:0;>=2,grass:1-2] 

事件：
{| class="wikitable"
|-
! Event !! Explanation
|-
| on-break || 破坏方块
|-
| on-destroy-with || 用此物品打破方块
|-
| on-place || 放置方块
|-
| on-use || 使用
|-
| on-interact || 交互，如右键门、拉杆、箱子等
|-
| on-drop || 丢弃特定物品
|-
| on-acquire || 获得物品
|-
| on-dispense || 针对发射器，发射特定物品
|-
|}

操作：
{| class="wikitable"
|-
! Action !! Explanation
|-
| deny || 阻止操作（黑名单模式）
|-
| allow || 允许操作（仅白名单模式）
|-
| notify || 发送通知消息给有worldguard.notify权限的人
|-
| log || 记录日志到终端、日志文件、数据库。
|-
| tell || 给玩家一个提示消息
|-
| kick || 踢出玩家
|-
| ban || 将玩家ban掉（永久性）
|-
|}

选项：
{| class="wikitable"
|-
! Option !! Explanation
|-
| ignore-groups || 忽略特定权限组，多个组用半角逗号分隔
|-
| ignore-perms || 忽略有特定权限的玩家，多个权限同样是用逗号分隔
|-
| comment || 自定义通知消息
|-
| message || 自定义tell的消息，可用%s表示相应物品名
|}

另外一个列子

放置和打破信标时通知在线管理员 
[beacon] 
on-break=notify 
on-place=notify 
阻止用钻石镐和金铲子破坏方块 
[diamond_pickaxe,284] 
on-destroy-with=tell,deny 
阻止使用铁锄、钻石剑耕地和攻击 
[iron_hoe,276] 
on-use=tell,deny 
阻止与箱子、石头按钮交互 
[chest,stone_button] 
on-interact=deny,tell 
阻止丢出命令方块 
[commandblock] 
on-drop=deny,tell 
message=不要乱丢命令方块～ 
除admins组外阻止获得基岩 
[bedrock] 
on-acquire=deny 
ignore-groups=admins 
阻止发射器发射岩浆桶和漏斗矿车 
[lavabucket,hopper_minecart] 
on-dispense=deny,log,notify 
[tnt] 
on-break=deny,notify,kick 
on-use=deny,notify,kick 
on-place=deny,ban 
on-acquire=deny 

日志
日志有三种选择
* 输出到终端（就是服务器后台）
* 记录日志到文件
* 记录到数据库

在worldguard配置文件（plugins\WorldGuard\config.yml）中可以对日志文件和数据库进行具体设置。

blacklist: 
use-as-whitelist: false 
logging: 
console: 
enable: true 
database: 
enable: false 
dsn: jdbc:mysql://localhost:3306/minecraft 
user: root 
pass: '' 
table: blacklist_events 
file: 
enable: false 
path: worldguard/logs/%Y-%m-%d.log 
open-files: 10 

日志文件的路径中可使用以下“变量”： 
%Y 年 (YYYY) 
%m 月 (MM) 
%d 日 (DD) 
%W 周 (00-52) 
%H 小时（24小时） (HH) 
%h 小时（12小时） (HH) 
%i 分 (mm) 
%s 秒 (ss) 
%u 用户名 
%% 表示“%”符号 

数据库 
worldguard可以将日志记录进mysql数据库，但需要先创建数据库和表，你可以使用下面的语句创建专用的表 

CREATE TABLE IF NOT EXISTS `blacklist_events` ( 
`id` int(11) NOT NULL AUTO_INCREMENT, 
`world` varchar(10) NOT NULL, 
`event` varchar(25) NOT NULL, 
`player` varchar(16) NOT NULL, 
`x` int(11) NOT NULL, 
`y` int(11) NOT NULL, 
`z` int(11) NOT NULL, 
`item` int(11) NOT NULL, 
`time` int(11) NOT NULL, 
`comment` varchar(255) DEFAULT NULL, 
PRIMARY KEY (`id`) 
); 

最后说一下，使用时发现，日志文件功能在某些平台下可能无法正常工作，同时会导致黑名单失效，开启此功能时请务必进行测试。
发射器的部分可能会和其他插件的发射器黑名单冲突导致报错。

=箱子保护=
WorldGuard提供基础的箱子保护服务，
玩家可以通过在箱子下方放置特殊字符的牌子来达到保护的目的。
我们不建议新设置的WorldGuard使用本功能因为本功能并不是WorldGuard常用的一部分
除此以外，区域设置是比本功能更好的保护拥有者财产的方法。
因为它不涉及像漏斗一类方块的问题。

提示：如果你是希望保护单块的方块，箱子等，
我们建议使用第三方保护插件。
例如Lockette 或者 LWC.

启用此功能：
首先箱子保护功能必须在配置文件中启用。
如果没有手动启用，箱子保护功能不会自动工作
这时不能使用牌子锁功能。(此项功能也可在配置文件中禁用)

使用方法：
# 必须是一个信息牌
# 必须位于箱子下面(如果是大箱子，只需在其一侧下面)
# 在第一行输入[Lock]
# 在第二行输入玩家的名字
# 在剩余两行写上其他允许使用玩家的名字
注：不可将其他玩家名字放在第二行的位置
提示：WorldGuard功能并不支持UUID功能
警告：由于Minecraft1.8版本的改变
从旧版本升级将会破坏掉所有的保护牌子
实际上它将破坏全部写有[]的牌子

=主机密码（登录密码）=
在过去由于Minecraft的登录代码问题，玩家可以登录到服务器的任何玩家包括拥有者和管理者的账号上，
在2010-2013年间，有五次利用该性质的漏洞经常导致成千上万的服务器被黑客攻击。

这项登录密码功能作为一个额外的登录屏障被添加到WorldGuard中。
其工作原理是作为一项额外的屏障来达到此功能，与Mojang的登录无关。
在登录时必须发送指定信息 (通俗的说就是输入你的密码)才能登录服务器。
即使攻击者有能力破坏Minecraft的登录系统来成为一个管理员。
但因在服务器缺少发送指定的信息，经服务器检测后无法活动。
注：这种登录验证方式的漏洞是很不明显的，很少见的。

启用功能：
当一个玩家通过某一个地址连接服务器时,输入play.example.com
Minecraft将会告诉服务器该玩家通过这个地址登录
管理者可以通过一个特殊的秘密语句来登录，
比如secretmod.play.example.com这个地址
服务器将会检测到该管理者登录使用的这个地址。
也就是一个类似密码的机制，不过密码是地址格式。

主机密码允许特定玩家使用特定地址登录，
如果地址错误，他将立即被踢下线

配置：

host-keys:
your_username: bagels.play.example.com
moderator1_name: manoverboard.play.example.com
提示:主机密码功能暂不支持UUID功能

DNS配置:
为了使此功能工作，你需要bagels.play.example.com 和 manoverboard.play.example.com 指向你的服务
然而不要在您使用的域名中添加域名的记录，因为很容易使得攻击者找出管理员域名从而登录。

相比之下，我们建议您安装通用地址-“wildcard addresses.”。例如设置了play.example.com，
这将意味着任何相同前缀会允许登录。（例如aa.play.example.com，ab.play.example.com，ac.play.example.com，等）。
提示：如果你没有一个域名或不能设置通配符地址，你可以使用xip.io。
=更多帮助=
你需要更多的帮助吗？我建议你
你可以去[http://skq.me/irc/irc.esper.net/sk-dev/ IRC]提问
 
注*IRC聊天频道是维基百科24小时开放的“聊天室”
你可以在Twitter上联系[https://twitter.com/sk89q sk89q]
sk89q是Worldguard的作者（也是Worldedit以及其他不少插件的作者）
 
你可以查看[https://github.com/sk89q/worldguard/commits Changelog]（全英文，英文不好的直接跳过吧）
Changelog就是更新信息（每次更新修改/增加/删除等等了什么）
你如果有什么建议，或者发现了什么Bug可以到[http://youtrack.sk89q.com/issues?q=project%3A+WorldGuard 这里]反馈（全英文，英文不好的直接跳过吧）

NoCheatPlus

2015-10-11T16:49:11Z

Lichi2050：/* 推荐使用 */

{{Bukkit Plugin Infobox
|插件名=NoCheatPlus
|版本=3.12.0-BETA2-sASO-b813
|前置插件=无
|兼容服务端版本=1.8.1
|網址=http://dev.bukkit.org/bukkit-plugins/nocheatplus/
}}
{{待翻译}}
'''Detect and fight the exploitation of various flaws/bugs in Minecraft!'''
[[Category:管理]] [[Category:修正]] [[Category:安全]]
=介绍=

NoCheatPlus试图通过禁止作弊客户端利用Minecraft或是它自身数据传递协议的漏洞, 来使得你的服务器更加安全可靠. 检测范围很广，包括飞行，加速，战斗 hacks, 快速破坏方块和 nukers, 背包 hacks, 聊天 spam and other types of malicious behaviour. For a more complete list have a look at the [https://github.com/asofold/NCPDocs/blob/master/Features.creole Features Page]（内容已搬至本页面，查看最新内容请点击链接）.

NoCheatPlus puts emphasis on configurability and allows you to customize actions that are carried out when a player fails a check (e.g. silent cancelling, executing commands, just logging). Bypass permissions allow to control what check to apply for which players, all checks can be deactivated in the configuration, also having the option for world-specific configuration files. Many checks allow more detailed configuration to adjust sensitivity.

Certainly NoCheatPlus is not a magical bullet, it uses a lot of heuristics and even guessing, so you will encounter false positives here and there and also not catch every single violation. [http://www.youtube.com/watch?v=H8BSpXfrtzI Example video] of how NoCheatPlus blocks cheats (outdated plugin version).

NoCheatPlus was introduced by [http://dev.bukkit.org/profiles/NeatMonster/ NeatMonster], building on the code base of [http://dev.bukkit.org/server-mods/nocheat/ NoCheat] by [http://dev.bukkit.org/profiles/Evenprime85/ Evenprime].
==功能==
* 玩家行动:
** 禁止飞行(生存/冒险模式下) 或是限制飞行速度(创造模式下)
** Enforce the original movement speeds for walking, sprinting, sneaking, swimming, blocking
** 禁止玩家无视掉落伤害
** 禁止玩家进入方块 (穿墙模式)
** 禁止玩家改变服务器时间
** Prevent players from using the "safe-respawn" exploit
** 禁止在水和岩浆顶部行走 [尽管现在的作弊者只是在其上保持跳跃]
** 禁止玩家通过非法移动使服务器崩溃 (CraftBukkit 自身并不包含检测模块,但有时这些移动数据会影响到插件.)
** Prevent players from faking BedLeave packets
** 禁止玩家悬浮在半空中
** 禁止玩家利用 "block jumping"来跳过高墙
** Prevent players from V-Clipping or teleporting
** 禁止玩家滥用钓竿来绕开飞行检测 (这只是一个玩笑...) [未测试! 默认关闭!]
** Prevent players from using their glide cheat 新!
** 禁止玩家滥用末影珍珠穿越墙，屋顶和地板新!
* 方块交互:
** 禁止玩家操作正常接触范围之外的方块
** 强制玩家看着想要操作的方块
** 禁止玩家透过墙对方块进行操作
** Prevent players from spamming interaction on blocks (note-blocks, doors, stone, wood, ...)
* 方块破坏:
** 防止玩家使用 "Survival Nuker", "Smasher", "Click Nuker" 与 "Creative Nuker"
** 防止以快于客户端允许的不正常速度破坏方块, 防止极快的同时破坏过多方块.
** 限制玩家可破坏方块的距离
** 强制玩家看着方块(破坏方块时，鼠标准星需对准方块)
** 防止 "noswing" 作弊 (玩家破坏方块时手臂没有动作)
** 禁止玩家同时破坏两个及以上的方块
** 禁止创造模式下的玩家破坏水或岩浆
* 方块放置:
** 防止玩家使用 "FastPlace" 和 "Build" 类作弊工具
** 限制玩家可放置方块的距离
** 强制对准方块
** 禁止玩家过快地投掷物品
** 禁止玩家在除了水和岩浆上的地方放置船只
** Prevent players from using the AutoSign feature of their client
** 禁止玩家在半空中放置方块.
** 禁止玩家在流体上放置方块
* 玩家聊天:
** 部分功能受Evenprime的插件启发.
** Fast spam check + tool-box for slower paced annoyances (can take into account a players chat history and global chat history).
** Limit the number of players allowed to join within a specific time frame
** 禁止短时间内多次重复登陆.
** Filter colors from player messages
** Supports text and command spam blocking
* 背包:
** Prevent players from dropping too many items within a short time frame and therefore lagging the server
** 禁止玩家过快地填充，发射弓箭
** 禁止玩家过快地进食
** Prevents players from managing there items to fast (inventory, enchantment table, beacon, ...)
** Prevents players from binding illegal enchantments on books (fixed in Minecraft 1.4.3 and higher)
* 战斗:
** 防止玩家同时攻击过多实体(玩家和怪物都算做实体)
** Prevent attacking of enemies that aren't in the line of sight of the player
** Prevent attacking without first swinging your arm
** 防止一秒内对生物攻击多次
** Prevent attacking of targets that are too far away
** Prevent players becoming invulnerable by exploitation of a design flaw of Minecraft
** Prevent players from knocking back other players when it's not technically possible
** Prevent players from exploiting extremely low jumps to get a pseudo criticals cheat going NEW!
** Prevent players from giving critical hits to other players when it's not technically possible
** Prevent players from hit other players while blocking with their sword
** Penalize players that change their direction by a lot (against force fields)
** Prevent players from doing self hits to fly by using the knockback of those
** Feed combined check to find players that try to execute 2 or more cheats at the same time
** 防止玩家过快地回复血量
* Miscellaneous:
** 禁用 Zombe's mod (飞行, noclip, 作弊)
** 禁用e CJB's mod (飞行, 透视, 雷达)
** 禁用 Rei's Minimap (洞穴, 雷达)
** 禁用 Minecraft AutoMap (ores, cave, radar)
** 禁用 Smart Moving (攀爬, 游泳, crawling, 滑行, 跳跃, 飞行)
** Restrict the OP management commands to a console usage only (disabled by default)
** Adapts to server sided lag for less false positives on heavy server load
** Provides a API that allows making other plugins compatible with NoCheatPlus
** Use of BukkitAPI only if the used CraftBukkit version is not supported

==配置==

=Configuration=

==General notes on .yml configuration files==
* Use spaces for indentation.
* Keep the indentation level: Never change the amount of white-spaces in front of options in the config file "config.yml".
* Don't insert special characters such as tabs for indentation. If you plan on complicated text entries, wrap them like '...' or "...".
* Refer to the default config file for reference.
* Use a [[http://yaml-online-parser.appspot.com/|YAML parser]] to make sure your configuration file is formatted properly.
* Inserting unsupported characters or changing indentation levels can break the configuration.
* For those that use Notepad++ to edit their YAML files we recommend to enable "Replace by space" in Settings -> Preferences -> Tab Settings \\
[[https://github.com/asofold/NCPDocs/blob/master/wiki/resources/Configuration/cResources.creole#notepad++|Screenshot of Notepad++ preferences]]

==特定世界的配置==
怎样创建一个特定世界的配置文件呢?（不同世界不同管理）:
#首先创建一个空的yml文件根据你的服务器世界的名称。例如：world_config.yml（_是必需的！一切都是很敏感的！）
# 在你的服务器安装NocheatPlus或运行 /重新安装NocheatPlus /如果已经在你的服务器运行请重载
# NoCheatPlus should now write every setting available for world specific configuration in that/those empty yaml files
# If you rather prefer to use some settings of your global config.yml then set "savebackconfig" to false and remove them from your world specific configuration file

* End result in your [[https://github.com/asofold/NCPDocs/blob/master/wiki/resources/Configuration/cResources.creole#world-specific-configuration|explorer window]] after successfully creating some world specific config.yml files
* Other examples: WorldName_config.yml, world_nether_config.yml, world_the_end_config.yml, HungerGames_config.yml or BackupWorld_config.yml

Notes:
* The world name is case sensitive (MiningWorld, theWorld etc.).
* You can set savebackconfig to false, in order to not have NoCheatPlus add default values to a config file. Thus you can override just the values you are interested in and keep a minimal world-specific configuration file.
* WorldName_config.yml has always higher priority then config.yml. So NoCheatPlus will first apply all settings from config.yml and then override them for a specific world using WorldName_config.yml
* Some settings can only be used in the global config.yml and aren't multiworld compatible (Please don't just copy config.yml and rename it to WorldName_config.yml or similar.)
* World specific files can be created, changed or removed while your server and NoCheatPlus are running. Just use the /ncp reload or /nocheatplus reload command to let NoCheatPlus reread your configuration file.
* If a world gets unloaded, deleted or renamed then NoCheatPlus will automaticly ignore your world specific configuration files you made for it

==Configversion==
Set {{{notify}}} to false to suppress the messages about outdated configurations. Only the main configuration file is checked at present.
\\The other entries are not meant to be changed by hand, they indicate with which version the config was created and last saved back.

==Logging==

Disable all logging with setting {{{active}}} to false.

Individual logging targets can be configured in the sub sections within {{{backends}}}:
* Set {{{active}}} to false to disable the individual backend.
* The {{{prefix}}} parameter allows to create a custom appearance for the log messages.
* File logging allows specifying a file name.
* For {{{ingamechat}}} you can force NoCheatPlus to check permissions subscriptions, if you use plugins that apply this technique to log to IRC and other for instance.

==Miscellaneous==
* Set {{{opinconsoleonly}}} to true to prevent op and deop commands from in-game chat. [Will be changed to a list of commands.]
* Set {{{managelisteners}}} to true to help us testing :) - this feature lets NCP register all its listeners inside of a ListenerManager that allows more intricate registration order than Bukkit. This is a "future feature" and is not needed, not even sure it improves performance.
* Set {{{reporttometrics}}} to false in order to disable reporting usage-stats to [[http://mcstats.org/plugin/NoCheatPlus|mcstats.org]] (PluginMetrics). Setting this to falss also prevents NoCheatplus from creating the PluginMetrics folder, however other plugins or Spigot could still create that folder.

==Data==
The data section allows you to specify an expiration duration for players data in minutes. If set to something greater than 0, this will periodically remove players data if the players have been logged out for longer than the specified amount of minutes. At present this would also delete set-back locations and current violation levels, if activated, so it should not be set to a too short duration.

**expiration**
|**Config**|**Description**|**Default**|
|**duration**|Duration in minutes after logout, after which data gets erased.|0|
|**history**|Should the players violation history also be deleted?|false|

**consistencychecks**
You can suppress consistency check warnings here and alter intervals for periodic checking (usually not needed).

==Protection==
===Plugins===
Features for this and other plugins.
====Hide====
This section contains configuration for hiding (some of) your plugins better. You can prevent help-contents display and command usage by setting permissions with a permissions plugin, if the command has a default permission set, but NoCheatPlus allows to set the permission message of some commands, which would otherwise reveal the presence of the command/plugin. So the permission message for some commands can be changed to the "Unknown command" message to hide the presence. You do need to also set the aliases of the commands, use lower case rather.
\\This feature allows to change command permissions to not be given by default or add a generic filter permission nocheatplus.filter.command.//(commandname)// to a command that does not have one set yet, the following settings allow configuring lists of commands and the message:
\\**"nopermission":**\\
Display the "no permission" message, default to "plugins" and "version" commands, useful for instance if a plugin does not set a permission for a command.
\\**"unknowncommand":**\\
Display the "unknown command" message, empty by default. This can be used to hide a command from users that don't have the default permission (or the filter permission added by NCP if none was set).

\\TODO: Link docs on how to configure help topics and other.
===Clients===
Features that concern client mods.
Set the {{{active}}} flag to false in the {{{motd}}} section to prevent NoCheatPlus sending any "blank lines" messages to clients on login. Otherwise blank lines can result disregarding if all clients are allowed or not, because some clients use a message to enable features, some need a message to disable features.
\\Note that it is 100% up to the client to decide on enabling or disabling features, a modified version of any client may ignore any sent messages, without that being detectable.

==Configuration of checks==
The checks section contains configuration mostly for checks related to players actions, most can generate violation log messages (few exceptions).

===Checks overview===

See: [[checks/checks.creole|Checks Overview]]

Shortcut links:
\\|
[[checks/blockbreak/blockbreak.creole|blockbreak]] |
[[checks/blockinteract/blockinteract.creole|blockinteract]] |
[[checks/blockplace/blockplace.creole|blockplace]] |
[[checks/chat/chat.creole|chat]] |
[[checks/combined/combined.creole|combined]] |
[[checks/fight/fight.creole|fight]] |
[[checks/inventory/inventory.creole|inventory]] |
[[checks/moving/moving.creole|moving]] |

==Strings section==
This is the section that defines various strings for "log" or "cmd" actions. Each has a name (the part in front of ":") and a definition (the part behind the ":"). Whenever you use a "log" or "cmd" action in one of the "actions: " options of this config file, the string will be taken from this section. Arbitrary many additional strings may be defined here, or existing strings may be changed.
\\ \\
Most messages/commands use place-holders in [ ], which will be replaced at runtime with relevant information. Some of these may only be available in certain circumstances, only "[player]" can be used everywhere, especially in "cmd" actions.|
\\

==Compatibility section==
This section allows to configure details for the case of compatibility issues, for instance with other server mods or custom blocks.

[[compatibility/compatibility.creole|compatibility page]]

==Bleeding Edge: Development builds==
To allow you to keep track with the configuration and permission changes in the latest development versions, we have a simple page set up: **[[../development/dev-pinboard.creole|Development Pinboard]]**
\\
For quick overview over recent builds, see: [[../development/build-infos.creole|Important Changes By Build Number]]
==命令==
=Commands=

NoCheatPlus integrates a lightweight command system. It allows you to quickly exempt players from checks or to access and manage check data about a player.

All commands support tab completion and some even allow shortcuts. The root command is named "nocheatplus", however the alias "ncp" should also work and is used for reference here.

NoCheatPlus also supports aliases from Bukkit [[http://wiki.bukkit.org/Bukkit.yml#aliases|BukkitAliases]] if you wish to have another alias command aside form "nocheatplus" and "ncp".

==Permissions==
Root node for commands:
* **NoCheatPlus 3.10.2** and above: {{{nocheatplus.commands}}}
* //NoCheatPlus 3.10.1// and below: {{{nocheatplus.admin}}}

You can give a player access to a specific command by giving them the sub-node with the commands default name, like {{{nocheatplus.admin.info}}}.
For further information about permissions in NoCheatPlus, we recommend looking at the [[../permissions/permissions.creole|Permissions docs]].

==Administrative commands==
Those commands are used to basically manage NoCheatPlus on your server.
**Arguments in () are needed, while arguments in [] are optional.**
|=Commands|=Explanation|
|/ncp reload| Reloads, generates and regenerates the configuration file of NoCheatPlus. Run this in-case you changed something on your configuration file while your server was running.|
|/ncp notify on/off| Toggle all in-game notifications/alerts generated by NoCheatPlus.|
|/ncp info (player)| Display the violation levels of a given player.|
|/ncp lag| Show info about server sided latency. The average lag shows the percentage of the server running too slow (0% = 20 tps, 10% = 18 tps) for the last 1 second, 3.33 and 270 seconds, roughly. Also lag spikes are displayed, tracked over at most 1 hour with a resolution of 20 minutes buckets (i.e. not exact) for spikes > 150 ms (3x to 20x) and spikes > 1000 ms (20x +). Be aware that this information is needed to make most NoCheatPlus checks adapt to server sided lag.|
|/ncp removeplayer (player) [check_type]| Remove all the data collected by NoCheatPlus so far for a given player. You can use the [check_type] option to make NoCheatPlus only remove data from a specific check (Default will clean all data of all checks!). To list all check names execute a command such as this: /ncp removeplayer (PlayerName) list. "*" is supported here.
|/ncp exempt (player) [check_type]| Exempt a player from being checked by NoCheatPlus or by a specific check.|
|/ncp unexempt (player) [check_type]| Remove any exemption you given to a specified player. "*" Is supported here.|
|/ncp exemptions (player)| Gives back a list of all check that a specific player has been exempted from.|
|/ncp commands| List all commands, more than shown here. The other commands are mainly for use with actions, such as delaying other commands, kicking with a message, telling players messages in colour, deny login for a players, allow it again and other.|
|/ncp version| Show version information about the server, plugin, compatibility modules and registered hooks.|

==Auxiliary commands==
Those commands are mainly used by NoCheatPlut itself to execute strings or commands over actions on violating players but you can also make use of them if you wish to do so. Most of them have no difference compared to the vanilla commands apart from the delay otion.
**Arguments in () are needed, while arguments in [] are optional.**
|=Commands|=Explanation|
|/ncp ban [delay=(ticks)] (player) [reason]|Ban a player from your server (banned-players.txt).|
|/ncp kick [delay=(ticks)] (player) [reason]|Kicks a player from your server|
|/ncp unkick (player)|Allows you to remove a tempkick/tempban from a player. "*" is supported here.|
|/ncp kicklist|Lists all players that have been tempkicked/tempbanned on your server by NoCheatPlus actions.|
|/ncp tell [delay=(ticks)] (player) (message)|Send a private message to a specified player.|
|/ncp delay [delay=(ticks)] (command)|Execute a command in delayed time.|
==权限==

**This page describes permissions for NoCheatPlus 3.10.2 and above,**
\\**NoCheatPlus 3.10.2-RC-sMD5NET-b620 adds new permissions for commands and new short-cut permissions, updates following soon.**
\\//For older versions see the [[permissions-3-10-1.creole|permissions page for 3.10.1 and below.]]//

NoCheatPlus supports "SuperPerms", CraftBukkit's official permission framework. You'll need to use a permissions plugin that supports "SuperPerms" to manage all the permissions of NoCheatPlus. Here are some examples:

* PermissionsEx
* bPermissions
* Essentials GroupManager
* Privileges
* zPermissions

By default NoCheatPlus assigns all permissions and gives full rights to players that have been /op-ed on your server. If you don't want to give OPs full access to all NoCheatPlus features then take a look in the configuration of your permissions plugin (Example with PermissionsEx: allowOps: false).\\\\
==Notifications==
|nocheatplus.notify|The player will receive notifications through the in-game chat of players failing NoCheatPlus checks. .|
If you want moderators to be able to toggle notifications, just give the permission nocheatplus.command.notify, which will also give this one then. Mind the ".silent" permission for individual checks permissions (explained on the bottom of this page).

==Administration==
|{{{nocheatplus.admin}}}|Shortcut permission for all administrative commands including ban (do not give lightly). See nocheatplus.shortcut permissions for faster setup for moderators.|
===Debug===
|nocheatplus.admin.debug|Owners of this node will receive debug messages of checks if NoCheatPlus debugging is turned on.|
==命令权限==
|nocheatplus.command.notify|Allow toggling notifications and also to receive them (nocheatplus.notify is included here).|
|nocheatplus.command.info|The player gets access to "/ncp info", which displays all violations that a player has gotten (if any).|
|nocheatplus.command.lag|Gives access to "/ncp lag" which shows informations about your server latency (NoCheatPlus uses this informations to adapt some checks for serversided latency).|
|nocheatplus.command.reload|The player gets access to "/ncp reload", which causes NoCheatPlus to reread its configuration files (This doesn't clear NoCheatPlus data or exemptions!).|
|nocheatplus.command.plugins|Allows the player to execute the "/plugins" or "/pl" command from CraftBukkit (//protectplugins// has be set to true in the configuration file).|
|nocheatplus.command.version|Owners of this node can execute the "/version" or "/ver" command from CraftBukkit (//protectplugins// has be set to true in the configuration file).|
|nocheatplus.command.exemptions|Gives access to execute "/ncp exemptions" which list all exemptions for an specified player (Those exemptions will get reset after every reload/restart! For permanent exemptions use the check permissions!).|
|nocheatplus.command.exempt|Gives access to the "/ncp exempt" command which allows to temporary exempt players for either all (ALL) or specified checks only.|
|nocheatplus.command.unexempt|Allows to unexempt players from checks by using the "/ncp unexempt" command.|
|nocheatplus.command.removeplayer|Gives access to execute "/ncp removeplayer", which causes NoCheatPlus to wipe/clear specified or all collected data from a player including violations and temporary stored check data (This wont wipe exemptions!).|
|nocheatplus.command.commands|Allows the player to use the "/ncp" command which lists all NoCheatPlus commands.|
|nocheatplus.command.ban|Gives permissions to use "/ncp ban" which bans a player on your server.|
|nocheatplus.command.kick|Gives access to "/ncp kick" which kicks a player from your server.|
|nocheatplus.command.tell|Gives access to "/ncp tell" which allows whispering something to a specified player.|
|nocheatplus.command.delay|Gives permissions to use the "/ncp delay" command which has the ability to run a specified command with delayed time execution time.|
|nocheatplus.command.tempkick|Allows the player to tempkick/tempban someone from the server using "/ncp tempkick".|
|nocheatplus.command.kicklist|Gives access to the "/ncp kicklist" command which lists all players that got "tempkicked/tempbanned" from NoCheatplus by either using actions or "/ncp tempkick".|
|nocheatplus.command.unkick|Gives access to remove a tempkick/tempban from a player using "/ncp unkick".|

==Filter permissions (plugin hiding)==
|nocheatplus.filter.command.(commandname)|Allows to use a command protected by command protection, only for the case the command did not have a permission set. Note that (commandname) is just the lower-case command label. In case of incompatibilities of your permission plugin you might have to add nocheatplus.filter.command.nocheatplus to players that are to use /ncp ... commands.|
==Bypass==
Specific bypass permissions.
|nocheatplus.bypass.denylogin|Allows to bypass the login denial, such as exists with the /ncp tempkick command.|
==Checks==
Check permissions, directly related to players actions and associated checks.
|nocheatplus.checks|Parent permission for all checks. TODO: Overview for "full" exemption by permissions (might need few additional permissions?).|
===BlockBreak===
|nocheatplus.checks.blockbreak|Parent permission for the blockbreak checks.|
|nocheatplus.checks.blockbreak.direction|Don't force the player to look at the blocks that he/she wants to break.|
|nocheatplus.checks.blockbreak.fastbreak|Allows the player to break blocks very quickly.|
|nocheatplus.checks.blockbreak.frequency|Allows the player to break 2 or more blocks at the same time.|
|nocheatplus.checks.blockbreak.noswing|Don't force players to swing their arm when breaking blocks.|
|nocheatplus.checks.blockbreak.reach|Allows breaking of blocks that are out of reach distance.|
|nocheatplus.checks.blockbreak.wrongblock|Don't force the player to interact with the block first before he/she is allowed break it (interacting=touching).|
|nocheatplus.checks.blockbreak.break.liquid|Allows the player to break liquids such as water or lava (source blocks) by using a hack in creative gamemode.|
===BlockInteract===
|nocheatplus.checks.blockinteract|Parent permission for this check section.|
|nocheatplus.checks.blockinteract.direction|Don't force the player to look at the blocks that he/she is trying to interact with (levers, doors and other).|
|nocheatplus.checks.blockinteract.reach|Allows the player to interact with blocks that are further away than usual.|
|nocheatplus.checks.blockinteract.speed|Allows the player to spam interaction on blocks such as levers, note blocks, doors and other.|
|nocheatplus.checks.blockinteract.visible|Everyone that owns this node is allowed to interact through walls to open a chest, furnace and other container without actually seeing them (also prevents from entering a minecart, bed or boat through walls).|
===BlockPlace===
|nocheatplus.checks.blockplace|...|
|nocheatplus.checks.blockplace.direction|Don't force the player to look at the block that he/she is trying to place on.|
|nocheatplus.checks.blockplace.boatsanywhere|Allows the player to place boats everywhere and not only in the water.|
|nocheatplus.checks.blockplace.fastplace|Allows the player to place blocks very quickly.|
|nocheatplus.checks.blockplace.noswing|Don't force players to swing their arm when placing a block.|
|nocheatplus.checks.blockplace.reach|Allows the player to place blocks that are too far away.|
|nocheatplus.checks.blockplace.speed|Allows a player to throw projectiles very quickly (snowballs, splash potions and other).|
|nocheatplus.checks.blockplace.against.liquids|Having this permission assigned allows to place block against liquids by using a special hack.|
|nocheatplus.checks.blockplace.against.air|This permission allows a player to place blocks against air.|
===Chat===
|nocheatplus.checks.chat|...|
|nocheatplus.checks.chat.color|Don't filter color codes from messages that get sent by players to allow them using colors in their messages. However nearly every chat plugin will override this.|
|nocheatplus.checks.chat.text|Allows the player to bypass the chat spam check for written text.|
|nocheatplus.checks.chat.commands|Allow players to bypass the command frequency check that protects against command spam.|
|nocheatplus.checks.chat.captcha|Owners of this permission wont be forced to type in a captcha if they fail one of the chat checks (this feature is disabled by default).|
|nocheatplus.checks.chat.relog|Every player that has this permission is allowed to completely bypass the re-log check of NoCheatPlus.|
|nocheatplus.checks.chat.logins|Allows the player to bypass the login check which prevents too many players loging in at the same time.|
===Combined===
|nocheatplus.checks.combined|Parent permission for the combined check group.|
|nocheatplus.checks.combined.improbable|Allows the player to bypass the Combined_Improbable check which fights against kill-auras ,speed hacks and some other combined hacks also. It also prevents the player from using 2 or more hacks at the same time.|
|nocheatplus.checks.combined.bedleave|Allows the player to send bed leave packets from anywhere (can be exploited to confuse some other checks of NoCheatPlus).|
|nocheatplus.checks.combined.munchhausen|Players with this node might be able to use fishing roods for flying (Check is disabled by default in configuration).|
===Fight===
|nocheatplus.checks.fight|Fight check group.|
|nocheatplus.checks.fight.angle|Don't prevent the player from attacking multiple entities at the time.|
|nocheatplus.checks.fight.critical|Don't prevent the player from doing fake critical hits when it's technically not possible to do so.|
|nocheatplus.checks.fight.direction|Don't force the player to look at the targets while fighting them.|
|nocheatplus.checks.fight.godmode|Don't prevent the player from keeping the temporary invulnerability that he/she gets when taking damage.|
|nocheatplus.checks.fight.fastheal|The owner of this node is allowed to regenerate health faster then usually possible.|
|nocheatplus.checks.fight.knockback|Don't prevent the player from doing knockbacks when it's technically not possible to do so.|
|nocheatplus.checks.fight.noswing|Don't force the player to move the arm while fighting against someone or something.|
|nocheatplus.checks.fight.reach|Allows the player to hit players and mobs that are out of allowed distance.|
|nocheatplus.checks.fight.selfhit|Allows the player to do self hits for flying by exploiting the knockback of those hits.|
|nocheatplus.checks.fight.speed|Don't limit the amount of attacks that the player can do per second.|
===Inventory===
|nocheatplus.checks.inventory|Inventory check group.|
|nocheatplus.checks.inventory.drop|Don't limit the amount of items that a player may drop within a short timeframe.|
|nocheatplus.checks.inventory.instantbow|Don't prevent the player from shooting arrows instantly over the bow without taking the usual time to pull the string back.|
|nocheatplus.checks.inventory.instanteat|Don't prevent players from eating their food instantly without taking the usual time to munch on it.|
|nocheatplus.checks.inventory.fastclick|Allows the player to move items around the inventory instantly without using there mouse/keyboard to do so.|
|nocheatplus.checks.inventory.items|Allows the player to use illegal enchantments on signed books (This got fixed now in Minecraft 1.4.3 and higher).|
===Moving===
|nocheatplus.checks.moving|Parent permission for the moving checks group.|
|nocheatplus.checks.moving.creativefly|Allows the player to fly faster in creative mode then usually possible.|
|nocheatplus.checks.moving.morepackets|Allow the player to make a lot more movements than normally possible. Doing more movements will result in faster movement speed and causes the server to spend a lot of additional time for processing these movements.|
|nocheatplus.checks.moving.morepacketsvehicle|Allows players to make a lot more movements in vehicles (boats, minecrats, pigs, ...) than normally possible.|
|nocheatplus.checks.moving.nofall|Allows the player to avoid fall damage by using cheats. Normally NoCheatPlus will keep track of a player's movement and rectify the fall-damage calculations of Minecraft so the player always gets the fall damage he/she is supposed to get.|
|nocheatplus.checks.moving.survivalfly|Allows the player to fly in survival mode. It also treats the player as if he has the ".nofall" permission too.|
|nocheatplus.checks.moving.survivalfly.blocking|Allows the player to block while moving at normal speed.|
|nocheatplus.checks.moving.survivalfly.sneaking|Allows the player to sneak while moving at normal speed.|
|nocheatplus.checks.moving.survivalfly.sprinting|Allows the player to sprint backwards.|
|nocheatplus.checks.moving.survivalfly.speeding|Allows the player to bypass the vanilla walk/run/sprint speed limits.|
|nocheatplus.checks.moving.survivalfly.step|Don't check if the player is using the step hack to get faster over blocks then usually possible.|
==Modifications==
These permissions allow to control which feature/mod a player may use. There is no guarantee that players use the original client and obey the request to turn off/on features, though.
===CJB===
|nocheatplus.mods.cjb|All CJB features.|
|nocheatplus.mods.cjb.fly|Don't prevent the player from using CJB's fly mod on the server.|
|nocheatplus.mods.cjb.radar|Gives access to use CJB's radar mod on the server.|
|nocheatplus.mods.cjb.xray|Don't prevent the player from using CJB's xray mod on the server.|
===MinecraftAutoMap===
|nocheatplus.mods.minecraftautomap|All features for MinecraftAutoMap.|
|nocheatplus.mods.minecraftautomap.ores|Don't prevent the player from using the ore detector from Minecraft AutoMap's.|
|nocheatplus.mods.minecraftautomap.cave|Don't prevent the player from using the cave mode feature of the Minecraft AutoMap's mod.|
|nocheatplus.mods.minecraftautomap.radar|Don't prevent the player from using Minecraft AutoMap's inbuilt radar.|
===Rei===
|nocheatplus.mods.rei.cave|Don't prevent the player from using Rei's Minimap's cave mode.|
|nocheatplus.mods.rei.radar|Don't prevent Rei's Minimap mod users from using all kind of available radar hacks.|
|nocheatplus.mods.rei.radar.player|Allows the player to use the radar from Rei's Minimap to track down other players only.|
|nocheatplus.mods.rei.radar.animal|Allows the player to only use the animal radar from Rei's Minimap mod.|
|nocheatplus.mods.rei.radar.mob|Gives access to use the mob radar feature from Rei's Minimap mod.|
|nocheatplus.mods.rei.radar.slime|Allows the player to track down slimes only by using the radar feature of Rei's Minimap.|
|nocheatplus.mods.rei.radar.squid|Player is allowed to use the Rei's Minimap radar to track down squids only.|
|nocheatplus.mods.rei.radar.other|Allows the player to use all the other features of the Rei's Minimap radar.|
===SmartMoving===
|nocheatplus.mods.smartmoving|All SmartMoving features.|
|nocheatplus.mods.smartmoving.climbing|Don't prevent the player from using Smart Moving's climb feature.|
|nocheatplus.mods.smartmoving.swimming|Don't prevent the player from using Smart Moving's swimming.|
|nocheatplus.mods.smartmoving.crawling|Don't prevent the player from using Smart Moving's crawl.|
|nocheatplus.mods.smartmoving.sliding|Don't prevent the player from using Smart Moving's slide.|
|nocheatplus.mods.smartmoving.jumping|Don't prevent the player from using Smart Moving's jump.|
|nocheatplus.mods.smartmoving.flying|Don't prevent the player from using Smart Moving's fly.|
===Zombe===
|nocheatplus.mods.zombe|All zombe features.|
|nocheatplus.mods.zombe.fly|Don't prevent the player from using Zombe's fly mod.|
|nocheatplus.mods.zombe.noclip|Don't prevent the player from using Zombe's noclip mod on the server.|
|nocheatplus.mods.zombe.cheat|Don't prevent the player from using Zombe's cheat mods.|\\
== Parent Nodes ==
Most permissions have parent nodes, that in fact goes for all check types. Resulting in nocheatplus.admin, nocheatplus.checks.moving, nocheatplus.checks.moving.survivalfly, nocheatplus.checks.fight, etc.
=== Things to know about Permissions ===
You can exclude a specific player from getting logged by appending ".silent" to the relevant permission node of the specific check. E.g.\\

* **nocheatplus.checks.moving.nofall.silent**\\

will prevent NoCheatPlus from recording log messages for that player for the "nofall" check, while still executing all other actions as usual.
==Shortcut permissions==
|nocheatplus.admin| see above (full admin perms except check bypassing).|
|nocheatplus.shortcut.info|info about players|
|nocheatplus.shortcut.monitor|info about players and diagnostic info like version, lag,|
|nocheatplus.shortcut.safeadmin|"Safe" admin perms, no banning or reloading but unkick, exemption, data removal|

More to be added (shortcut.bypass - bypass about everything).

=推荐使用=

以下插件可以配合NCP使用.

[http://dev.bukkit.org/server-mods/compatnocheatplus-cncp/ CompatNoCheatPlus (cncp)]

例如 mcMMO, Citizens, MagicSpells 或 MachinaCraft . 大部分插件还不支持NPC，如果你有任何发现都可以联系我们.

[http://dev.bukkit.org/server-mods/orebfuscator/ Orebfuscator]

Orebfuscator 通过修改从服务器发送到客户端的方块信息文件来实现反矿石射线的作用，简单的说就是防X-ray.

=下载和历史更新=

* 下载正式版本请前往 BukkitDev [http://dev.bukkit.org/server-mods/nocheatplus/files/ Files].
* 下载测试版本请前往 [http://dev.bukkit.org/server-mods/nocheatplus/pages/nocheat-plus-development/jenkins/ Jenkins at EcoCityCraft].
* 不要从任何其他来源下载，不要使用别人给你的插件.
* 前往Jenkins查看所有版本的更新记录[http://dev.bukkit.org/server-mods/nocheatplus/pages/nocheat-plus-development/jenkins/ changes list].
* 前往GitHub查看所有改动 [https://github.com/NoCheatPlus/NoCheatPlus/commits/master commit history].
* <s>插件统计将不会传送至 mcstats.org.</s>

=帮助=

==其他帮助==

* 你可以到: [https://github.com/asofold/NCPDocs/blob/master/FAQ.creole#faq Frequently asked Questions] 以及 [https://github.com/asofold/NCPDocs/blob/master/Known%20Issues.creole#known-issues Known Issues] 提问.
* [https://github.com/asofold/NCPDocs/blob/master/README.creole#ncpdocs Wiki] (配设文件, 权限介绍, 指令介绍)
* 开发者请查看NoCheatPlus的API.

==联系我们==
你有疑问可以到,
IRC联系我们 (IRC地址: irc.spi.gt | 默认Port: 6667 | SSL-Port: 6697 | Channel: #nocheat | Web client: WebIRC)
 
你可以创造一个提问票 [http://dev.bukkit.org/bukkit-plugins/nocheatplus/create-ticket/ new ticket] 或者查看已存在提问票 [http://dev.bukkit.org/server-mods/nocheatplus/tickets/ existing ticket].
 
你可以私聊原作者[http://dev.bukkit.org/home/send-private-message/ @asofold]和[http://dev.bukkit.org/home/send-private-message/ @MyPictures]，@IceAP (IRC: ICE)
 
请勿联系用户 'NoCheatPlus', 它仅用于管理，不会及时回复你的提问. 转移到 BukkitDev 和 GitHub 获取更多的帮助, 请勿相信BukkitDev以外的 NCP 管理人员 .

NoCheatPlus

2015-10-11T16:40:47Z

Lichi2050：/* Support */

{{Bukkit Plugin Infobox
|插件名=NoCheatPlus
|版本=3.12.0-BETA2-sASO-b813
|前置插件=无
|兼容服务端版本=1.8.1
|網址=http://dev.bukkit.org/bukkit-plugins/nocheatplus/
}}
{{待翻译}}
'''Detect and fight the exploitation of various flaws/bugs in Minecraft!'''
[[Category:管理]] [[Category:修正]] [[Category:安全]]
=介绍=

NoCheatPlus试图通过禁止作弊客户端利用Minecraft或是它自身数据传递协议的漏洞, 来使得你的服务器更加安全可靠. 检测范围很广，包括飞行，加速，战斗 hacks, 快速破坏方块和 nukers, 背包 hacks, 聊天 spam and other types of malicious behaviour. For a more complete list have a look at the [https://github.com/asofold/NCPDocs/blob/master/Features.creole Features Page]（内容已搬至本页面，查看最新内容请点击链接）.

NoCheatPlus puts emphasis on configurability and allows you to customize actions that are carried out when a player fails a check (e.g. silent cancelling, executing commands, just logging). Bypass permissions allow to control what check to apply for which players, all checks can be deactivated in the configuration, also having the option for world-specific configuration files. Many checks allow more detailed configuration to adjust sensitivity.

Certainly NoCheatPlus is not a magical bullet, it uses a lot of heuristics and even guessing, so you will encounter false positives here and there and also not catch every single violation. [http://www.youtube.com/watch?v=H8BSpXfrtzI Example video] of how NoCheatPlus blocks cheats (outdated plugin version).

NoCheatPlus was introduced by [http://dev.bukkit.org/profiles/NeatMonster/ NeatMonster], building on the code base of [http://dev.bukkit.org/server-mods/nocheat/ NoCheat] by [http://dev.bukkit.org/profiles/Evenprime85/ Evenprime].
==功能==
* 玩家行动:
** 禁止飞行(生存/冒险模式下) 或是限制飞行速度(创造模式下)
** Enforce the original movement speeds for walking, sprinting, sneaking, swimming, blocking
** 禁止玩家无视掉落伤害
** 禁止玩家进入方块 (穿墙模式)
** 禁止玩家改变服务器时间
** Prevent players from using the "safe-respawn" exploit
** 禁止在水和岩浆顶部行走 [尽管现在的作弊者只是在其上保持跳跃]
** 禁止玩家通过非法移动使服务器崩溃 (CraftBukkit 自身并不包含检测模块,但有时这些移动数据会影响到插件.)
** Prevent players from faking BedLeave packets
** 禁止玩家悬浮在半空中
** 禁止玩家利用 "block jumping"来跳过高墙
** Prevent players from V-Clipping or teleporting
** 禁止玩家滥用钓竿来绕开飞行检测 (这只是一个玩笑...) [未测试! 默认关闭!]
** Prevent players from using their glide cheat 新!
** 禁止玩家滥用末影珍珠穿越墙，屋顶和地板新!
* 方块交互:
** 禁止玩家操作正常接触范围之外的方块
** 强制玩家看着想要操作的方块
** 禁止玩家透过墙对方块进行操作
** Prevent players from spamming interaction on blocks (note-blocks, doors, stone, wood, ...)
* 方块破坏:
** 防止玩家使用 "Survival Nuker", "Smasher", "Click Nuker" 与 "Creative Nuker"
** 防止以快于客户端允许的不正常速度破坏方块, 防止极快的同时破坏过多方块.
** 限制玩家可破坏方块的距离
** 强制玩家看着方块(破坏方块时，鼠标准星需对准方块)
** 防止 "noswing" 作弊 (玩家破坏方块时手臂没有动作)
** 禁止玩家同时破坏两个及以上的方块
** 禁止创造模式下的玩家破坏水或岩浆
* 方块放置:
** 防止玩家使用 "FastPlace" 和 "Build" 类作弊工具
** 限制玩家可放置方块的距离
** 强制对准方块
** 禁止玩家过快地投掷物品
** 禁止玩家在除了水和岩浆上的地方放置船只
** Prevent players from using the AutoSign feature of their client
** 禁止玩家在半空中放置方块.
** 禁止玩家在流体上放置方块
* 玩家聊天:
** 部分功能受Evenprime的插件启发.
** Fast spam check + tool-box for slower paced annoyances (can take into account a players chat history and global chat history).
** Limit the number of players allowed to join within a specific time frame
** 禁止短时间内多次重复登陆.
** Filter colors from player messages
** Supports text and command spam blocking
* 背包:
** Prevent players from dropping too many items within a short time frame and therefore lagging the server
** 禁止玩家过快地填充，发射弓箭
** 禁止玩家过快地进食
** Prevents players from managing there items to fast (inventory, enchantment table, beacon, ...)
** Prevents players from binding illegal enchantments on books (fixed in Minecraft 1.4.3 and higher)
* 战斗:
** 防止玩家同时攻击过多实体(玩家和怪物都算做实体)
** Prevent attacking of enemies that aren't in the line of sight of the player
** Prevent attacking without first swinging your arm
** 防止一秒内对生物攻击多次
** Prevent attacking of targets that are too far away
** Prevent players becoming invulnerable by exploitation of a design flaw of Minecraft
** Prevent players from knocking back other players when it's not technically possible
** Prevent players from exploiting extremely low jumps to get a pseudo criticals cheat going NEW!
** Prevent players from giving critical hits to other players when it's not technically possible
** Prevent players from hit other players while blocking with their sword
** Penalize players that change their direction by a lot (against force fields)
** Prevent players from doing self hits to fly by using the knockback of those
** Feed combined check to find players that try to execute 2 or more cheats at the same time
** 防止玩家过快地回复血量
* Miscellaneous:
** 禁用 Zombe's mod (飞行, noclip, 作弊)
** 禁用e CJB's mod (飞行, 透视, 雷达)
** 禁用 Rei's Minimap (洞穴, 雷达)
** 禁用 Minecraft AutoMap (ores, cave, radar)
** 禁用 Smart Moving (攀爬, 游泳, crawling, 滑行, 跳跃, 飞行)
** Restrict the OP management commands to a console usage only (disabled by default)
** Adapts to server sided lag for less false positives on heavy server load
** Provides a API that allows making other plugins compatible with NoCheatPlus
** Use of BukkitAPI only if the used CraftBukkit version is not supported

==配置==

=Configuration=

==General notes on .yml configuration files==
* Use spaces for indentation.
* Keep the indentation level: Never change the amount of white-spaces in front of options in the config file "config.yml".
* Don't insert special characters such as tabs for indentation. If you plan on complicated text entries, wrap them like '...' or "...".
* Refer to the default config file for reference.
* Use a [[http://yaml-online-parser.appspot.com/|YAML parser]] to make sure your configuration file is formatted properly.
* Inserting unsupported characters or changing indentation levels can break the configuration.
* For those that use Notepad++ to edit their YAML files we recommend to enable "Replace by space" in Settings -> Preferences -> Tab Settings \\
[[https://github.com/asofold/NCPDocs/blob/master/wiki/resources/Configuration/cResources.creole#notepad++|Screenshot of Notepad++ preferences]]

==特定世界的配置==
怎样创建一个特定世界的配置文件呢?（不同世界不同管理）:
#首先创建一个空的yml文件根据你的服务器世界的名称。例如：world_config.yml（_是必需的！一切都是很敏感的！）
# 在你的服务器安装NocheatPlus或运行 /重新安装NocheatPlus /如果已经在你的服务器运行请重载
# NoCheatPlus should now write every setting available for world specific configuration in that/those empty yaml files
# If you rather prefer to use some settings of your global config.yml then set "savebackconfig" to false and remove them from your world specific configuration file

* End result in your [[https://github.com/asofold/NCPDocs/blob/master/wiki/resources/Configuration/cResources.creole#world-specific-configuration|explorer window]] after successfully creating some world specific config.yml files
* Other examples: WorldName_config.yml, world_nether_config.yml, world_the_end_config.yml, HungerGames_config.yml or BackupWorld_config.yml

Notes:
* The world name is case sensitive (MiningWorld, theWorld etc.).
* You can set savebackconfig to false, in order to not have NoCheatPlus add default values to a config file. Thus you can override just the values you are interested in and keep a minimal world-specific configuration file.
* WorldName_config.yml has always higher priority then config.yml. So NoCheatPlus will first apply all settings from config.yml and then override them for a specific world using WorldName_config.yml
* Some settings can only be used in the global config.yml and aren't multiworld compatible (Please don't just copy config.yml and rename it to WorldName_config.yml or similar.)
* World specific files can be created, changed or removed while your server and NoCheatPlus are running. Just use the /ncp reload or /nocheatplus reload command to let NoCheatPlus reread your configuration file.
* If a world gets unloaded, deleted or renamed then NoCheatPlus will automaticly ignore your world specific configuration files you made for it

==Configversion==
Set {{{notify}}} to false to suppress the messages about outdated configurations. Only the main configuration file is checked at present.
\\The other entries are not meant to be changed by hand, they indicate with which version the config was created and last saved back.

==Logging==

Disable all logging with setting {{{active}}} to false.

Individual logging targets can be configured in the sub sections within {{{backends}}}:
* Set {{{active}}} to false to disable the individual backend.
* The {{{prefix}}} parameter allows to create a custom appearance for the log messages.
* File logging allows specifying a file name.
* For {{{ingamechat}}} you can force NoCheatPlus to check permissions subscriptions, if you use plugins that apply this technique to log to IRC and other for instance.

==Miscellaneous==
* Set {{{opinconsoleonly}}} to true to prevent op and deop commands from in-game chat. [Will be changed to a list of commands.]
* Set {{{managelisteners}}} to true to help us testing :) - this feature lets NCP register all its listeners inside of a ListenerManager that allows more intricate registration order than Bukkit. This is a "future feature" and is not needed, not even sure it improves performance.
* Set {{{reporttometrics}}} to false in order to disable reporting usage-stats to [[http://mcstats.org/plugin/NoCheatPlus|mcstats.org]] (PluginMetrics). Setting this to falss also prevents NoCheatplus from creating the PluginMetrics folder, however other plugins or Spigot could still create that folder.

==Data==
The data section allows you to specify an expiration duration for players data in minutes. If set to something greater than 0, this will periodically remove players data if the players have been logged out for longer than the specified amount of minutes. At present this would also delete set-back locations and current violation levels, if activated, so it should not be set to a too short duration.

**expiration**
|**Config**|**Description**|**Default**|
|**duration**|Duration in minutes after logout, after which data gets erased.|0|
|**history**|Should the players violation history also be deleted?|false|

**consistencychecks**
You can suppress consistency check warnings here and alter intervals for periodic checking (usually not needed).

==Protection==
===Plugins===
Features for this and other plugins.
====Hide====
This section contains configuration for hiding (some of) your plugins better. You can prevent help-contents display and command usage by setting permissions with a permissions plugin, if the command has a default permission set, but NoCheatPlus allows to set the permission message of some commands, which would otherwise reveal the presence of the command/plugin. So the permission message for some commands can be changed to the "Unknown command" message to hide the presence. You do need to also set the aliases of the commands, use lower case rather.
\\This feature allows to change command permissions to not be given by default or add a generic filter permission nocheatplus.filter.command.//(commandname)// to a command that does not have one set yet, the following settings allow configuring lists of commands and the message:
\\**"nopermission":**\\
Display the "no permission" message, default to "plugins" and "version" commands, useful for instance if a plugin does not set a permission for a command.
\\**"unknowncommand":**\\
Display the "unknown command" message, empty by default. This can be used to hide a command from users that don't have the default permission (or the filter permission added by NCP if none was set).

\\TODO: Link docs on how to configure help topics and other.
===Clients===
Features that concern client mods.
Set the {{{active}}} flag to false in the {{{motd}}} section to prevent NoCheatPlus sending any "blank lines" messages to clients on login. Otherwise blank lines can result disregarding if all clients are allowed or not, because some clients use a message to enable features, some need a message to disable features.
\\Note that it is 100% up to the client to decide on enabling or disabling features, a modified version of any client may ignore any sent messages, without that being detectable.

==Configuration of checks==
The checks section contains configuration mostly for checks related to players actions, most can generate violation log messages (few exceptions).

===Checks overview===

See: [[checks/checks.creole|Checks Overview]]

Shortcut links:
\\|
[[checks/blockbreak/blockbreak.creole|blockbreak]] |
[[checks/blockinteract/blockinteract.creole|blockinteract]] |
[[checks/blockplace/blockplace.creole|blockplace]] |
[[checks/chat/chat.creole|chat]] |
[[checks/combined/combined.creole|combined]] |
[[checks/fight/fight.creole|fight]] |
[[checks/inventory/inventory.creole|inventory]] |
[[checks/moving/moving.creole|moving]] |

==Strings section==
This is the section that defines various strings for "log" or "cmd" actions. Each has a name (the part in front of ":") and a definition (the part behind the ":"). Whenever you use a "log" or "cmd" action in one of the "actions: " options of this config file, the string will be taken from this section. Arbitrary many additional strings may be defined here, or existing strings may be changed.
\\ \\
Most messages/commands use place-holders in [ ], which will be replaced at runtime with relevant information. Some of these may only be available in certain circumstances, only "[player]" can be used everywhere, especially in "cmd" actions.|
\\

==Compatibility section==
This section allows to configure details for the case of compatibility issues, for instance with other server mods or custom blocks.

[[compatibility/compatibility.creole|compatibility page]]

==Bleeding Edge: Development builds==
To allow you to keep track with the configuration and permission changes in the latest development versions, we have a simple page set up: **[[../development/dev-pinboard.creole|Development Pinboard]]**
\\
For quick overview over recent builds, see: [[../development/build-infos.creole|Important Changes By Build Number]]
==命令==
=Commands=

NoCheatPlus integrates a lightweight command system. It allows you to quickly exempt players from checks or to access and manage check data about a player.

All commands support tab completion and some even allow shortcuts. The root command is named "nocheatplus", however the alias "ncp" should also work and is used for reference here.

NoCheatPlus also supports aliases from Bukkit [[http://wiki.bukkit.org/Bukkit.yml#aliases|BukkitAliases]] if you wish to have another alias command aside form "nocheatplus" and "ncp".

==Permissions==
Root node for commands:
* **NoCheatPlus 3.10.2** and above: {{{nocheatplus.commands}}}
* //NoCheatPlus 3.10.1// and below: {{{nocheatplus.admin}}}

You can give a player access to a specific command by giving them the sub-node with the commands default name, like {{{nocheatplus.admin.info}}}.
For further information about permissions in NoCheatPlus, we recommend looking at the [[../permissions/permissions.creole|Permissions docs]].

==Administrative commands==
Those commands are used to basically manage NoCheatPlus on your server.
**Arguments in () are needed, while arguments in [] are optional.**
|=Commands|=Explanation|
|/ncp reload| Reloads, generates and regenerates the configuration file of NoCheatPlus. Run this in-case you changed something on your configuration file while your server was running.|
|/ncp notify on/off| Toggle all in-game notifications/alerts generated by NoCheatPlus.|
|/ncp info (player)| Display the violation levels of a given player.|
|/ncp lag| Show info about server sided latency. The average lag shows the percentage of the server running too slow (0% = 20 tps, 10% = 18 tps) for the last 1 second, 3.33 and 270 seconds, roughly. Also lag spikes are displayed, tracked over at most 1 hour with a resolution of 20 minutes buckets (i.e. not exact) for spikes > 150 ms (3x to 20x) and spikes > 1000 ms (20x +). Be aware that this information is needed to make most NoCheatPlus checks adapt to server sided lag.|
|/ncp removeplayer (player) [check_type]| Remove all the data collected by NoCheatPlus so far for a given player. You can use the [check_type] option to make NoCheatPlus only remove data from a specific check (Default will clean all data of all checks!). To list all check names execute a command such as this: /ncp removeplayer (PlayerName) list. "*" is supported here.
|/ncp exempt (player) [check_type]| Exempt a player from being checked by NoCheatPlus or by a specific check.|
|/ncp unexempt (player) [check_type]| Remove any exemption you given to a specified player. "*" Is supported here.|
|/ncp exemptions (player)| Gives back a list of all check that a specific player has been exempted from.|
|/ncp commands| List all commands, more than shown here. The other commands are mainly for use with actions, such as delaying other commands, kicking with a message, telling players messages in colour, deny login for a players, allow it again and other.|
|/ncp version| Show version information about the server, plugin, compatibility modules and registered hooks.|

==Auxiliary commands==
Those commands are mainly used by NoCheatPlut itself to execute strings or commands over actions on violating players but you can also make use of them if you wish to do so. Most of them have no difference compared to the vanilla commands apart from the delay otion.
**Arguments in () are needed, while arguments in [] are optional.**
|=Commands|=Explanation|
|/ncp ban [delay=(ticks)] (player) [reason]|Ban a player from your server (banned-players.txt).|
|/ncp kick [delay=(ticks)] (player) [reason]|Kicks a player from your server|
|/ncp unkick (player)|Allows you to remove a tempkick/tempban from a player. "*" is supported here.|
|/ncp kicklist|Lists all players that have been tempkicked/tempbanned on your server by NoCheatPlus actions.|
|/ncp tell [delay=(ticks)] (player) (message)|Send a private message to a specified player.|
|/ncp delay [delay=(ticks)] (command)|Execute a command in delayed time.|
==权限==

**This page describes permissions for NoCheatPlus 3.10.2 and above,**
\\**NoCheatPlus 3.10.2-RC-sMD5NET-b620 adds new permissions for commands and new short-cut permissions, updates following soon.**
\\//For older versions see the [[permissions-3-10-1.creole|permissions page for 3.10.1 and below.]]//

NoCheatPlus supports "SuperPerms", CraftBukkit's official permission framework. You'll need to use a permissions plugin that supports "SuperPerms" to manage all the permissions of NoCheatPlus. Here are some examples:

* PermissionsEx
* bPermissions
* Essentials GroupManager
* Privileges
* zPermissions

By default NoCheatPlus assigns all permissions and gives full rights to players that have been /op-ed on your server. If you don't want to give OPs full access to all NoCheatPlus features then take a look in the configuration of your permissions plugin (Example with PermissionsEx: allowOps: false).\\\\
==Notifications==
|nocheatplus.notify|The player will receive notifications through the in-game chat of players failing NoCheatPlus checks. .|
If you want moderators to be able to toggle notifications, just give the permission nocheatplus.command.notify, which will also give this one then. Mind the ".silent" permission for individual checks permissions (explained on the bottom of this page).

==Administration==
|{{{nocheatplus.admin}}}|Shortcut permission for all administrative commands including ban (do not give lightly). See nocheatplus.shortcut permissions for faster setup for moderators.|
===Debug===
|nocheatplus.admin.debug|Owners of this node will receive debug messages of checks if NoCheatPlus debugging is turned on.|
==命令权限==
|nocheatplus.command.notify|Allow toggling notifications and also to receive them (nocheatplus.notify is included here).|
|nocheatplus.command.info|The player gets access to "/ncp info", which displays all violations that a player has gotten (if any).|
|nocheatplus.command.lag|Gives access to "/ncp lag" which shows informations about your server latency (NoCheatPlus uses this informations to adapt some checks for serversided latency).|
|nocheatplus.command.reload|The player gets access to "/ncp reload", which causes NoCheatPlus to reread its configuration files (This doesn't clear NoCheatPlus data or exemptions!).|
|nocheatplus.command.plugins|Allows the player to execute the "/plugins" or "/pl" command from CraftBukkit (//protectplugins// has be set to true in the configuration file).|
|nocheatplus.command.version|Owners of this node can execute the "/version" or "/ver" command from CraftBukkit (//protectplugins// has be set to true in the configuration file).|
|nocheatplus.command.exemptions|Gives access to execute "/ncp exemptions" which list all exemptions for an specified player (Those exemptions will get reset after every reload/restart! For permanent exemptions use the check permissions!).|
|nocheatplus.command.exempt|Gives access to the "/ncp exempt" command which allows to temporary exempt players for either all (ALL) or specified checks only.|
|nocheatplus.command.unexempt|Allows to unexempt players from checks by using the "/ncp unexempt" command.|
|nocheatplus.command.removeplayer|Gives access to execute "/ncp removeplayer", which causes NoCheatPlus to wipe/clear specified or all collected data from a player including violations and temporary stored check data (This wont wipe exemptions!).|
|nocheatplus.command.commands|Allows the player to use the "/ncp" command which lists all NoCheatPlus commands.|
|nocheatplus.command.ban|Gives permissions to use "/ncp ban" which bans a player on your server.|
|nocheatplus.command.kick|Gives access to "/ncp kick" which kicks a player from your server.|
|nocheatplus.command.tell|Gives access to "/ncp tell" which allows whispering something to a specified player.|
|nocheatplus.command.delay|Gives permissions to use the "/ncp delay" command which has the ability to run a specified command with delayed time execution time.|
|nocheatplus.command.tempkick|Allows the player to tempkick/tempban someone from the server using "/ncp tempkick".|
|nocheatplus.command.kicklist|Gives access to the "/ncp kicklist" command which lists all players that got "tempkicked/tempbanned" from NoCheatplus by either using actions or "/ncp tempkick".|
|nocheatplus.command.unkick|Gives access to remove a tempkick/tempban from a player using "/ncp unkick".|

==Filter permissions (plugin hiding)==
|nocheatplus.filter.command.(commandname)|Allows to use a command protected by command protection, only for the case the command did not have a permission set. Note that (commandname) is just the lower-case command label. In case of incompatibilities of your permission plugin you might have to add nocheatplus.filter.command.nocheatplus to players that are to use /ncp ... commands.|
==Bypass==
Specific bypass permissions.
|nocheatplus.bypass.denylogin|Allows to bypass the login denial, such as exists with the /ncp tempkick command.|
==Checks==
Check permissions, directly related to players actions and associated checks.
|nocheatplus.checks|Parent permission for all checks. TODO: Overview for "full" exemption by permissions (might need few additional permissions?).|
===BlockBreak===
|nocheatplus.checks.blockbreak|Parent permission for the blockbreak checks.|
|nocheatplus.checks.blockbreak.direction|Don't force the player to look at the blocks that he/she wants to break.|
|nocheatplus.checks.blockbreak.fastbreak|Allows the player to break blocks very quickly.|
|nocheatplus.checks.blockbreak.frequency|Allows the player to break 2 or more blocks at the same time.|
|nocheatplus.checks.blockbreak.noswing|Don't force players to swing their arm when breaking blocks.|
|nocheatplus.checks.blockbreak.reach|Allows breaking of blocks that are out of reach distance.|
|nocheatplus.checks.blockbreak.wrongblock|Don't force the player to interact with the block first before he/she is allowed break it (interacting=touching).|
|nocheatplus.checks.blockbreak.break.liquid|Allows the player to break liquids such as water or lava (source blocks) by using a hack in creative gamemode.|
===BlockInteract===
|nocheatplus.checks.blockinteract|Parent permission for this check section.|
|nocheatplus.checks.blockinteract.direction|Don't force the player to look at the blocks that he/she is trying to interact with (levers, doors and other).|
|nocheatplus.checks.blockinteract.reach|Allows the player to interact with blocks that are further away than usual.|
|nocheatplus.checks.blockinteract.speed|Allows the player to spam interaction on blocks such as levers, note blocks, doors and other.|
|nocheatplus.checks.blockinteract.visible|Everyone that owns this node is allowed to interact through walls to open a chest, furnace and other container without actually seeing them (also prevents from entering a minecart, bed or boat through walls).|
===BlockPlace===
|nocheatplus.checks.blockplace|...|
|nocheatplus.checks.blockplace.direction|Don't force the player to look at the block that he/she is trying to place on.|
|nocheatplus.checks.blockplace.boatsanywhere|Allows the player to place boats everywhere and not only in the water.|
|nocheatplus.checks.blockplace.fastplace|Allows the player to place blocks very quickly.|
|nocheatplus.checks.blockplace.noswing|Don't force players to swing their arm when placing a block.|
|nocheatplus.checks.blockplace.reach|Allows the player to place blocks that are too far away.|
|nocheatplus.checks.blockplace.speed|Allows a player to throw projectiles very quickly (snowballs, splash potions and other).|
|nocheatplus.checks.blockplace.against.liquids|Having this permission assigned allows to place block against liquids by using a special hack.|
|nocheatplus.checks.blockplace.against.air|This permission allows a player to place blocks against air.|
===Chat===
|nocheatplus.checks.chat|...|
|nocheatplus.checks.chat.color|Don't filter color codes from messages that get sent by players to allow them using colors in their messages. However nearly every chat plugin will override this.|
|nocheatplus.checks.chat.text|Allows the player to bypass the chat spam check for written text.|
|nocheatplus.checks.chat.commands|Allow players to bypass the command frequency check that protects against command spam.|
|nocheatplus.checks.chat.captcha|Owners of this permission wont be forced to type in a captcha if they fail one of the chat checks (this feature is disabled by default).|
|nocheatplus.checks.chat.relog|Every player that has this permission is allowed to completely bypass the re-log check of NoCheatPlus.|
|nocheatplus.checks.chat.logins|Allows the player to bypass the login check which prevents too many players loging in at the same time.|
===Combined===
|nocheatplus.checks.combined|Parent permission for the combined check group.|
|nocheatplus.checks.combined.improbable|Allows the player to bypass the Combined_Improbable check which fights against kill-auras ,speed hacks and some other combined hacks also. It also prevents the player from using 2 or more hacks at the same time.|
|nocheatplus.checks.combined.bedleave|Allows the player to send bed leave packets from anywhere (can be exploited to confuse some other checks of NoCheatPlus).|
|nocheatplus.checks.combined.munchhausen|Players with this node might be able to use fishing roods for flying (Check is disabled by default in configuration).|
===Fight===
|nocheatplus.checks.fight|Fight check group.|
|nocheatplus.checks.fight.angle|Don't prevent the player from attacking multiple entities at the time.|
|nocheatplus.checks.fight.critical|Don't prevent the player from doing fake critical hits when it's technically not possible to do so.|
|nocheatplus.checks.fight.direction|Don't force the player to look at the targets while fighting them.|
|nocheatplus.checks.fight.godmode|Don't prevent the player from keeping the temporary invulnerability that he/she gets when taking damage.|
|nocheatplus.checks.fight.fastheal|The owner of this node is allowed to regenerate health faster then usually possible.|
|nocheatplus.checks.fight.knockback|Don't prevent the player from doing knockbacks when it's technically not possible to do so.|
|nocheatplus.checks.fight.noswing|Don't force the player to move the arm while fighting against someone or something.|
|nocheatplus.checks.fight.reach|Allows the player to hit players and mobs that are out of allowed distance.|
|nocheatplus.checks.fight.selfhit|Allows the player to do self hits for flying by exploiting the knockback of those hits.|
|nocheatplus.checks.fight.speed|Don't limit the amount of attacks that the player can do per second.|
===Inventory===
|nocheatplus.checks.inventory|Inventory check group.|
|nocheatplus.checks.inventory.drop|Don't limit the amount of items that a player may drop within a short timeframe.|
|nocheatplus.checks.inventory.instantbow|Don't prevent the player from shooting arrows instantly over the bow without taking the usual time to pull the string back.|
|nocheatplus.checks.inventory.instanteat|Don't prevent players from eating their food instantly without taking the usual time to munch on it.|
|nocheatplus.checks.inventory.fastclick|Allows the player to move items around the inventory instantly without using there mouse/keyboard to do so.|
|nocheatplus.checks.inventory.items|Allows the player to use illegal enchantments on signed books (This got fixed now in Minecraft 1.4.3 and higher).|
===Moving===
|nocheatplus.checks.moving|Parent permission for the moving checks group.|
|nocheatplus.checks.moving.creativefly|Allows the player to fly faster in creative mode then usually possible.|
|nocheatplus.checks.moving.morepackets|Allow the player to make a lot more movements than normally possible. Doing more movements will result in faster movement speed and causes the server to spend a lot of additional time for processing these movements.|
|nocheatplus.checks.moving.morepacketsvehicle|Allows players to make a lot more movements in vehicles (boats, minecrats, pigs, ...) than normally possible.|
|nocheatplus.checks.moving.nofall|Allows the player to avoid fall damage by using cheats. Normally NoCheatPlus will keep track of a player's movement and rectify the fall-damage calculations of Minecraft so the player always gets the fall damage he/she is supposed to get.|
|nocheatplus.checks.moving.survivalfly|Allows the player to fly in survival mode. It also treats the player as if he has the ".nofall" permission too.|
|nocheatplus.checks.moving.survivalfly.blocking|Allows the player to block while moving at normal speed.|
|nocheatplus.checks.moving.survivalfly.sneaking|Allows the player to sneak while moving at normal speed.|
|nocheatplus.checks.moving.survivalfly.sprinting|Allows the player to sprint backwards.|
|nocheatplus.checks.moving.survivalfly.speeding|Allows the player to bypass the vanilla walk/run/sprint speed limits.|
|nocheatplus.checks.moving.survivalfly.step|Don't check if the player is using the step hack to get faster over blocks then usually possible.|
==Modifications==
These permissions allow to control which feature/mod a player may use. There is no guarantee that players use the original client and obey the request to turn off/on features, though.
===CJB===
|nocheatplus.mods.cjb|All CJB features.|
|nocheatplus.mods.cjb.fly|Don't prevent the player from using CJB's fly mod on the server.|
|nocheatplus.mods.cjb.radar|Gives access to use CJB's radar mod on the server.|
|nocheatplus.mods.cjb.xray|Don't prevent the player from using CJB's xray mod on the server.|
===MinecraftAutoMap===
|nocheatplus.mods.minecraftautomap|All features for MinecraftAutoMap.|
|nocheatplus.mods.minecraftautomap.ores|Don't prevent the player from using the ore detector from Minecraft AutoMap's.|
|nocheatplus.mods.minecraftautomap.cave|Don't prevent the player from using the cave mode feature of the Minecraft AutoMap's mod.|
|nocheatplus.mods.minecraftautomap.radar|Don't prevent the player from using Minecraft AutoMap's inbuilt radar.|
===Rei===
|nocheatplus.mods.rei.cave|Don't prevent the player from using Rei's Minimap's cave mode.|
|nocheatplus.mods.rei.radar|Don't prevent Rei's Minimap mod users from using all kind of available radar hacks.|
|nocheatplus.mods.rei.radar.player|Allows the player to use the radar from Rei's Minimap to track down other players only.|
|nocheatplus.mods.rei.radar.animal|Allows the player to only use the animal radar from Rei's Minimap mod.|
|nocheatplus.mods.rei.radar.mob|Gives access to use the mob radar feature from Rei's Minimap mod.|
|nocheatplus.mods.rei.radar.slime|Allows the player to track down slimes only by using the radar feature of Rei's Minimap.|
|nocheatplus.mods.rei.radar.squid|Player is allowed to use the Rei's Minimap radar to track down squids only.|
|nocheatplus.mods.rei.radar.other|Allows the player to use all the other features of the Rei's Minimap radar.|
===SmartMoving===
|nocheatplus.mods.smartmoving|All SmartMoving features.|
|nocheatplus.mods.smartmoving.climbing|Don't prevent the player from using Smart Moving's climb feature.|
|nocheatplus.mods.smartmoving.swimming|Don't prevent the player from using Smart Moving's swimming.|
|nocheatplus.mods.smartmoving.crawling|Don't prevent the player from using Smart Moving's crawl.|
|nocheatplus.mods.smartmoving.sliding|Don't prevent the player from using Smart Moving's slide.|
|nocheatplus.mods.smartmoving.jumping|Don't prevent the player from using Smart Moving's jump.|
|nocheatplus.mods.smartmoving.flying|Don't prevent the player from using Smart Moving's fly.|
===Zombe===
|nocheatplus.mods.zombe|All zombe features.|
|nocheatplus.mods.zombe.fly|Don't prevent the player from using Zombe's fly mod.|
|nocheatplus.mods.zombe.noclip|Don't prevent the player from using Zombe's noclip mod on the server.|
|nocheatplus.mods.zombe.cheat|Don't prevent the player from using Zombe's cheat mods.|\\
== Parent Nodes ==
Most permissions have parent nodes, that in fact goes for all check types. Resulting in nocheatplus.admin, nocheatplus.checks.moving, nocheatplus.checks.moving.survivalfly, nocheatplus.checks.fight, etc.
=== Things to know about Permissions ===
You can exclude a specific player from getting logged by appending ".silent" to the relevant permission node of the specific check. E.g.\\

* **nocheatplus.checks.moving.nofall.silent**\\

will prevent NoCheatPlus from recording log messages for that player for the "nofall" check, while still executing all other actions as usual.
==Shortcut permissions==
|nocheatplus.admin| see above (full admin perms except check bypassing).|
|nocheatplus.shortcut.info|info about players|
|nocheatplus.shortcut.monitor|info about players and diagnostic info like version, lag,|
|nocheatplus.shortcut.safeadmin|"Safe" admin perms, no banning or reloading but unkick, exemption, data removal|

More to be added (shortcut.bypass - bypass about everything).

=Recommended=

The following plugins might be useful to have a look at.

CompatNoCheatPlus (cncp)

Make plugins like mcMMO, Citizens, MagicSpells or MachinaCraft more compatbile with NoCheatPlus. Not all existing plugins are covered (yet), but you can leave a note or ticket request for cncp.

Orebfuscator

Orebfuscator fights all sorts of X-ray-hacks by altering the map information that is sent to the players, such that they have to mine blocks to actually reveal what is behind. Virtually a "must have".

=下载和历史更新=

* 下载正式版本请前往 BukkitDev [http://dev.bukkit.org/server-mods/nocheatplus/files/ Files].
* 下载测试版本请前往 [http://dev.bukkit.org/server-mods/nocheatplus/pages/nocheat-plus-development/jenkins/ Jenkins at EcoCityCraft].
* 不要从任何其他来源下载，不要使用别人给你的插件.
* 前往Jenkins查看所有版本的更新记录[http://dev.bukkit.org/server-mods/nocheatplus/pages/nocheat-plus-development/jenkins/ changes list].
* 前往GitHub查看所有改动 [https://github.com/NoCheatPlus/NoCheatPlus/commits/master commit history].
* <s>插件统计将不会传送至 mcstats.org.</s>

=帮助=

==其他帮助==

* 你可以到: [https://github.com/asofold/NCPDocs/blob/master/FAQ.creole#faq Frequently asked Questions] 以及 [https://github.com/asofold/NCPDocs/blob/master/Known%20Issues.creole#known-issues Known Issues] 提问.
* [https://github.com/asofold/NCPDocs/blob/master/README.creole#ncpdocs Wiki] (配设文件, 权限介绍, 指令介绍)
* 开发者请查看NoCheatPlus的API.

==联系我们==
你有疑问可以到,
IRC联系我们 (IRC地址: irc.spi.gt | 默认Port: 6667 | SSL-Port: 6697 | Channel: #nocheat | Web client: WebIRC)
 
你可以创造一个提问票 [http://dev.bukkit.org/bukkit-plugins/nocheatplus/create-ticket/ new ticket] 或者查看已存在提问票 [http://dev.bukkit.org/server-mods/nocheatplus/tickets/ existing ticket].
 
你可以私聊原作者[http://dev.bukkit.org/home/send-private-message/ @asofold]和[http://dev.bukkit.org/home/send-private-message/ @MyPictures]，@IceAP (IRC: ICE)
 
请勿联系用户 'NoCheatPlus', 它仅用于管理，不会及时回复你的提问. 转移到 BukkitDev 和 GitHub 获取更多的帮助, 请勿相信BukkitDev以外的 NCP 管理人员 .

NoCheatPlus

2015-10-11T16:39:10Z

Lichi2050：/* 下载和历史更新 */

{{Bukkit Plugin Infobox
|插件名=NoCheatPlus
|版本=3.12.0-BETA2-sASO-b813
|前置插件=无
|兼容服务端版本=1.8.1
|網址=http://dev.bukkit.org/bukkit-plugins/nocheatplus/
}}
{{待翻译}}
'''Detect and fight the exploitation of various flaws/bugs in Minecraft!'''
[[Category:管理]] [[Category:修正]] [[Category:安全]]
=介绍=

NoCheatPlus试图通过禁止作弊客户端利用Minecraft或是它自身数据传递协议的漏洞, 来使得你的服务器更加安全可靠. 检测范围很广，包括飞行，加速，战斗 hacks, 快速破坏方块和 nukers, 背包 hacks, 聊天 spam and other types of malicious behaviour. For a more complete list have a look at the [https://github.com/asofold/NCPDocs/blob/master/Features.creole Features Page]（内容已搬至本页面，查看最新内容请点击链接）.

NoCheatPlus puts emphasis on configurability and allows you to customize actions that are carried out when a player fails a check (e.g. silent cancelling, executing commands, just logging). Bypass permissions allow to control what check to apply for which players, all checks can be deactivated in the configuration, also having the option for world-specific configuration files. Many checks allow more detailed configuration to adjust sensitivity.

Certainly NoCheatPlus is not a magical bullet, it uses a lot of heuristics and even guessing, so you will encounter false positives here and there and also not catch every single violation. [http://www.youtube.com/watch?v=H8BSpXfrtzI Example video] of how NoCheatPlus blocks cheats (outdated plugin version).

NoCheatPlus was introduced by [http://dev.bukkit.org/profiles/NeatMonster/ NeatMonster], building on the code base of [http://dev.bukkit.org/server-mods/nocheat/ NoCheat] by [http://dev.bukkit.org/profiles/Evenprime85/ Evenprime].
==功能==
* 玩家行动:
** 禁止飞行(生存/冒险模式下) 或是限制飞行速度(创造模式下)
** Enforce the original movement speeds for walking, sprinting, sneaking, swimming, blocking
** 禁止玩家无视掉落伤害
** 禁止玩家进入方块 (穿墙模式)
** 禁止玩家改变服务器时间
** Prevent players from using the "safe-respawn" exploit
** 禁止在水和岩浆顶部行走 [尽管现在的作弊者只是在其上保持跳跃]
** 禁止玩家通过非法移动使服务器崩溃 (CraftBukkit 自身并不包含检测模块,但有时这些移动数据会影响到插件.)
** Prevent players from faking BedLeave packets
** 禁止玩家悬浮在半空中
** 禁止玩家利用 "block jumping"来跳过高墙
** Prevent players from V-Clipping or teleporting
** 禁止玩家滥用钓竿来绕开飞行检测 (这只是一个玩笑...) [未测试! 默认关闭!]
** Prevent players from using their glide cheat 新!
** 禁止玩家滥用末影珍珠穿越墙，屋顶和地板新!
* 方块交互:
** 禁止玩家操作正常接触范围之外的方块
** 强制玩家看着想要操作的方块
** 禁止玩家透过墙对方块进行操作
** Prevent players from spamming interaction on blocks (note-blocks, doors, stone, wood, ...)
* 方块破坏:
** 防止玩家使用 "Survival Nuker", "Smasher", "Click Nuker" 与 "Creative Nuker"
** 防止以快于客户端允许的不正常速度破坏方块, 防止极快的同时破坏过多方块.
** 限制玩家可破坏方块的距离
** 强制玩家看着方块(破坏方块时，鼠标准星需对准方块)
** 防止 "noswing" 作弊 (玩家破坏方块时手臂没有动作)
** 禁止玩家同时破坏两个及以上的方块
** 禁止创造模式下的玩家破坏水或岩浆
* 方块放置:
** 防止玩家使用 "FastPlace" 和 "Build" 类作弊工具
** 限制玩家可放置方块的距离
** 强制对准方块
** 禁止玩家过快地投掷物品
** 禁止玩家在除了水和岩浆上的地方放置船只
** Prevent players from using the AutoSign feature of their client
** 禁止玩家在半空中放置方块.
** 禁止玩家在流体上放置方块
* 玩家聊天:
** 部分功能受Evenprime的插件启发.
** Fast spam check + tool-box for slower paced annoyances (can take into account a players chat history and global chat history).
** Limit the number of players allowed to join within a specific time frame
** 禁止短时间内多次重复登陆.
** Filter colors from player messages
** Supports text and command spam blocking
* 背包:
** Prevent players from dropping too many items within a short time frame and therefore lagging the server
** 禁止玩家过快地填充，发射弓箭
** 禁止玩家过快地进食
** Prevents players from managing there items to fast (inventory, enchantment table, beacon, ...)
** Prevents players from binding illegal enchantments on books (fixed in Minecraft 1.4.3 and higher)
* 战斗:
** 防止玩家同时攻击过多实体(玩家和怪物都算做实体)
** Prevent attacking of enemies that aren't in the line of sight of the player
** Prevent attacking without first swinging your arm
** 防止一秒内对生物攻击多次
** Prevent attacking of targets that are too far away
** Prevent players becoming invulnerable by exploitation of a design flaw of Minecraft
** Prevent players from knocking back other players when it's not technically possible
** Prevent players from exploiting extremely low jumps to get a pseudo criticals cheat going NEW!
** Prevent players from giving critical hits to other players when it's not technically possible
** Prevent players from hit other players while blocking with their sword
** Penalize players that change their direction by a lot (against force fields)
** Prevent players from doing self hits to fly by using the knockback of those
** Feed combined check to find players that try to execute 2 or more cheats at the same time
** 防止玩家过快地回复血量
* Miscellaneous:
** 禁用 Zombe's mod (飞行, noclip, 作弊)
** 禁用e CJB's mod (飞行, 透视, 雷达)
** 禁用 Rei's Minimap (洞穴, 雷达)
** 禁用 Minecraft AutoMap (ores, cave, radar)
** 禁用 Smart Moving (攀爬, 游泳, crawling, 滑行, 跳跃, 飞行)
** Restrict the OP management commands to a console usage only (disabled by default)
** Adapts to server sided lag for less false positives on heavy server load
** Provides a API that allows making other plugins compatible with NoCheatPlus
** Use of BukkitAPI only if the used CraftBukkit version is not supported

==配置==

=Configuration=

==General notes on .yml configuration files==
* Use spaces for indentation.
* Keep the indentation level: Never change the amount of white-spaces in front of options in the config file "config.yml".
* Don't insert special characters such as tabs for indentation. If you plan on complicated text entries, wrap them like '...' or "...".
* Refer to the default config file for reference.
* Use a [[http://yaml-online-parser.appspot.com/|YAML parser]] to make sure your configuration file is formatted properly.
* Inserting unsupported characters or changing indentation levels can break the configuration.
* For those that use Notepad++ to edit their YAML files we recommend to enable "Replace by space" in Settings -> Preferences -> Tab Settings \\
[[https://github.com/asofold/NCPDocs/blob/master/wiki/resources/Configuration/cResources.creole#notepad++|Screenshot of Notepad++ preferences]]

==特定世界的配置==
怎样创建一个特定世界的配置文件呢?（不同世界不同管理）:
#首先创建一个空的yml文件根据你的服务器世界的名称。例如：world_config.yml（_是必需的！一切都是很敏感的！）
# 在你的服务器安装NocheatPlus或运行 /重新安装NocheatPlus /如果已经在你的服务器运行请重载
# NoCheatPlus should now write every setting available for world specific configuration in that/those empty yaml files
# If you rather prefer to use some settings of your global config.yml then set "savebackconfig" to false and remove them from your world specific configuration file

* End result in your [[https://github.com/asofold/NCPDocs/blob/master/wiki/resources/Configuration/cResources.creole#world-specific-configuration|explorer window]] after successfully creating some world specific config.yml files
* Other examples: WorldName_config.yml, world_nether_config.yml, world_the_end_config.yml, HungerGames_config.yml or BackupWorld_config.yml

Notes:
* The world name is case sensitive (MiningWorld, theWorld etc.).
* You can set savebackconfig to false, in order to not have NoCheatPlus add default values to a config file. Thus you can override just the values you are interested in and keep a minimal world-specific configuration file.
* WorldName_config.yml has always higher priority then config.yml. So NoCheatPlus will first apply all settings from config.yml and then override them for a specific world using WorldName_config.yml
* Some settings can only be used in the global config.yml and aren't multiworld compatible (Please don't just copy config.yml and rename it to WorldName_config.yml or similar.)
* World specific files can be created, changed or removed while your server and NoCheatPlus are running. Just use the /ncp reload or /nocheatplus reload command to let NoCheatPlus reread your configuration file.
* If a world gets unloaded, deleted or renamed then NoCheatPlus will automaticly ignore your world specific configuration files you made for it

==Configversion==
Set {{{notify}}} to false to suppress the messages about outdated configurations. Only the main configuration file is checked at present.
\\The other entries are not meant to be changed by hand, they indicate with which version the config was created and last saved back.

==Logging==

Disable all logging with setting {{{active}}} to false.

Individual logging targets can be configured in the sub sections within {{{backends}}}:
* Set {{{active}}} to false to disable the individual backend.
* The {{{prefix}}} parameter allows to create a custom appearance for the log messages.
* File logging allows specifying a file name.
* For {{{ingamechat}}} you can force NoCheatPlus to check permissions subscriptions, if you use plugins that apply this technique to log to IRC and other for instance.

==Miscellaneous==
* Set {{{opinconsoleonly}}} to true to prevent op and deop commands from in-game chat. [Will be changed to a list of commands.]
* Set {{{managelisteners}}} to true to help us testing :) - this feature lets NCP register all its listeners inside of a ListenerManager that allows more intricate registration order than Bukkit. This is a "future feature" and is not needed, not even sure it improves performance.
* Set {{{reporttometrics}}} to false in order to disable reporting usage-stats to [[http://mcstats.org/plugin/NoCheatPlus|mcstats.org]] (PluginMetrics). Setting this to falss also prevents NoCheatplus from creating the PluginMetrics folder, however other plugins or Spigot could still create that folder.

==Data==
The data section allows you to specify an expiration duration for players data in minutes. If set to something greater than 0, this will periodically remove players data if the players have been logged out for longer than the specified amount of minutes. At present this would also delete set-back locations and current violation levels, if activated, so it should not be set to a too short duration.

**expiration**
|**Config**|**Description**|**Default**|
|**duration**|Duration in minutes after logout, after which data gets erased.|0|
|**history**|Should the players violation history also be deleted?|false|

**consistencychecks**
You can suppress consistency check warnings here and alter intervals for periodic checking (usually not needed).

==Protection==
===Plugins===
Features for this and other plugins.
====Hide====
This section contains configuration for hiding (some of) your plugins better. You can prevent help-contents display and command usage by setting permissions with a permissions plugin, if the command has a default permission set, but NoCheatPlus allows to set the permission message of some commands, which would otherwise reveal the presence of the command/plugin. So the permission message for some commands can be changed to the "Unknown command" message to hide the presence. You do need to also set the aliases of the commands, use lower case rather.
\\This feature allows to change command permissions to not be given by default or add a generic filter permission nocheatplus.filter.command.//(commandname)// to a command that does not have one set yet, the following settings allow configuring lists of commands and the message:
\\**"nopermission":**\\
Display the "no permission" message, default to "plugins" and "version" commands, useful for instance if a plugin does not set a permission for a command.
\\**"unknowncommand":**\\
Display the "unknown command" message, empty by default. This can be used to hide a command from users that don't have the default permission (or the filter permission added by NCP if none was set).

\\TODO: Link docs on how to configure help topics and other.
===Clients===
Features that concern client mods.
Set the {{{active}}} flag to false in the {{{motd}}} section to prevent NoCheatPlus sending any "blank lines" messages to clients on login. Otherwise blank lines can result disregarding if all clients are allowed or not, because some clients use a message to enable features, some need a message to disable features.
\\Note that it is 100% up to the client to decide on enabling or disabling features, a modified version of any client may ignore any sent messages, without that being detectable.

==Configuration of checks==
The checks section contains configuration mostly for checks related to players actions, most can generate violation log messages (few exceptions).

===Checks overview===

See: [[checks/checks.creole|Checks Overview]]

Shortcut links:
\\|
[[checks/blockbreak/blockbreak.creole|blockbreak]] |
[[checks/blockinteract/blockinteract.creole|blockinteract]] |
[[checks/blockplace/blockplace.creole|blockplace]] |
[[checks/chat/chat.creole|chat]] |
[[checks/combined/combined.creole|combined]] |
[[checks/fight/fight.creole|fight]] |
[[checks/inventory/inventory.creole|inventory]] |
[[checks/moving/moving.creole|moving]] |

==Strings section==
This is the section that defines various strings for "log" or "cmd" actions. Each has a name (the part in front of ":") and a definition (the part behind the ":"). Whenever you use a "log" or "cmd" action in one of the "actions: " options of this config file, the string will be taken from this section. Arbitrary many additional strings may be defined here, or existing strings may be changed.
\\ \\
Most messages/commands use place-holders in [ ], which will be replaced at runtime with relevant information. Some of these may only be available in certain circumstances, only "[player]" can be used everywhere, especially in "cmd" actions.|
\\

==Compatibility section==
This section allows to configure details for the case of compatibility issues, for instance with other server mods or custom blocks.

[[compatibility/compatibility.creole|compatibility page]]

==Bleeding Edge: Development builds==
To allow you to keep track with the configuration and permission changes in the latest development versions, we have a simple page set up: **[[../development/dev-pinboard.creole|Development Pinboard]]**
\\
For quick overview over recent builds, see: [[../development/build-infos.creole|Important Changes By Build Number]]
==命令==
=Commands=

NoCheatPlus integrates a lightweight command system. It allows you to quickly exempt players from checks or to access and manage check data about a player.

All commands support tab completion and some even allow shortcuts. The root command is named "nocheatplus", however the alias "ncp" should also work and is used for reference here.

NoCheatPlus also supports aliases from Bukkit [[http://wiki.bukkit.org/Bukkit.yml#aliases|BukkitAliases]] if you wish to have another alias command aside form "nocheatplus" and "ncp".

==Permissions==
Root node for commands:
* **NoCheatPlus 3.10.2** and above: {{{nocheatplus.commands}}}
* //NoCheatPlus 3.10.1// and below: {{{nocheatplus.admin}}}

You can give a player access to a specific command by giving them the sub-node with the commands default name, like {{{nocheatplus.admin.info}}}.
For further information about permissions in NoCheatPlus, we recommend looking at the [[../permissions/permissions.creole|Permissions docs]].

==Administrative commands==
Those commands are used to basically manage NoCheatPlus on your server.
**Arguments in () are needed, while arguments in [] are optional.**
|=Commands|=Explanation|
|/ncp reload| Reloads, generates and regenerates the configuration file of NoCheatPlus. Run this in-case you changed something on your configuration file while your server was running.|
|/ncp notify on/off| Toggle all in-game notifications/alerts generated by NoCheatPlus.|
|/ncp info (player)| Display the violation levels of a given player.|
|/ncp lag| Show info about server sided latency. The average lag shows the percentage of the server running too slow (0% = 20 tps, 10% = 18 tps) for the last 1 second, 3.33 and 270 seconds, roughly. Also lag spikes are displayed, tracked over at most 1 hour with a resolution of 20 minutes buckets (i.e. not exact) for spikes > 150 ms (3x to 20x) and spikes > 1000 ms (20x +). Be aware that this information is needed to make most NoCheatPlus checks adapt to server sided lag.|
|/ncp removeplayer (player) [check_type]| Remove all the data collected by NoCheatPlus so far for a given player. You can use the [check_type] option to make NoCheatPlus only remove data from a specific check (Default will clean all data of all checks!). To list all check names execute a command such as this: /ncp removeplayer (PlayerName) list. "*" is supported here.
|/ncp exempt (player) [check_type]| Exempt a player from being checked by NoCheatPlus or by a specific check.|
|/ncp unexempt (player) [check_type]| Remove any exemption you given to a specified player. "*" Is supported here.|
|/ncp exemptions (player)| Gives back a list of all check that a specific player has been exempted from.|
|/ncp commands| List all commands, more than shown here. The other commands are mainly for use with actions, such as delaying other commands, kicking with a message, telling players messages in colour, deny login for a players, allow it again and other.|
|/ncp version| Show version information about the server, plugin, compatibility modules and registered hooks.|

==Auxiliary commands==
Those commands are mainly used by NoCheatPlut itself to execute strings or commands over actions on violating players but you can also make use of them if you wish to do so. Most of them have no difference compared to the vanilla commands apart from the delay otion.
**Arguments in () are needed, while arguments in [] are optional.**
|=Commands|=Explanation|
|/ncp ban [delay=(ticks)] (player) [reason]|Ban a player from your server (banned-players.txt).|
|/ncp kick [delay=(ticks)] (player) [reason]|Kicks a player from your server|
|/ncp unkick (player)|Allows you to remove a tempkick/tempban from a player. "*" is supported here.|
|/ncp kicklist|Lists all players that have been tempkicked/tempbanned on your server by NoCheatPlus actions.|
|/ncp tell [delay=(ticks)] (player) (message)|Send a private message to a specified player.|
|/ncp delay [delay=(ticks)] (command)|Execute a command in delayed time.|
==权限==

**This page describes permissions for NoCheatPlus 3.10.2 and above,**
\\**NoCheatPlus 3.10.2-RC-sMD5NET-b620 adds new permissions for commands and new short-cut permissions, updates following soon.**
\\//For older versions see the [[permissions-3-10-1.creole|permissions page for 3.10.1 and below.]]//

NoCheatPlus supports "SuperPerms", CraftBukkit's official permission framework. You'll need to use a permissions plugin that supports "SuperPerms" to manage all the permissions of NoCheatPlus. Here are some examples:

* PermissionsEx
* bPermissions
* Essentials GroupManager
* Privileges
* zPermissions

By default NoCheatPlus assigns all permissions and gives full rights to players that have been /op-ed on your server. If you don't want to give OPs full access to all NoCheatPlus features then take a look in the configuration of your permissions plugin (Example with PermissionsEx: allowOps: false).\\\\
==Notifications==
|nocheatplus.notify|The player will receive notifications through the in-game chat of players failing NoCheatPlus checks. .|
If you want moderators to be able to toggle notifications, just give the permission nocheatplus.command.notify, which will also give this one then. Mind the ".silent" permission for individual checks permissions (explained on the bottom of this page).

==Administration==
|{{{nocheatplus.admin}}}|Shortcut permission for all administrative commands including ban (do not give lightly). See nocheatplus.shortcut permissions for faster setup for moderators.|
===Debug===
|nocheatplus.admin.debug|Owners of this node will receive debug messages of checks if NoCheatPlus debugging is turned on.|
==命令权限==
|nocheatplus.command.notify|Allow toggling notifications and also to receive them (nocheatplus.notify is included here).|
|nocheatplus.command.info|The player gets access to "/ncp info", which displays all violations that a player has gotten (if any).|
|nocheatplus.command.lag|Gives access to "/ncp lag" which shows informations about your server latency (NoCheatPlus uses this informations to adapt some checks for serversided latency).|
|nocheatplus.command.reload|The player gets access to "/ncp reload", which causes NoCheatPlus to reread its configuration files (This doesn't clear NoCheatPlus data or exemptions!).|
|nocheatplus.command.plugins|Allows the player to execute the "/plugins" or "/pl" command from CraftBukkit (//protectplugins// has be set to true in the configuration file).|
|nocheatplus.command.version|Owners of this node can execute the "/version" or "/ver" command from CraftBukkit (//protectplugins// has be set to true in the configuration file).|
|nocheatplus.command.exemptions|Gives access to execute "/ncp exemptions" which list all exemptions for an specified player (Those exemptions will get reset after every reload/restart! For permanent exemptions use the check permissions!).|
|nocheatplus.command.exempt|Gives access to the "/ncp exempt" command which allows to temporary exempt players for either all (ALL) or specified checks only.|
|nocheatplus.command.unexempt|Allows to unexempt players from checks by using the "/ncp unexempt" command.|
|nocheatplus.command.removeplayer|Gives access to execute "/ncp removeplayer", which causes NoCheatPlus to wipe/clear specified or all collected data from a player including violations and temporary stored check data (This wont wipe exemptions!).|
|nocheatplus.command.commands|Allows the player to use the "/ncp" command which lists all NoCheatPlus commands.|
|nocheatplus.command.ban|Gives permissions to use "/ncp ban" which bans a player on your server.|
|nocheatplus.command.kick|Gives access to "/ncp kick" which kicks a player from your server.|
|nocheatplus.command.tell|Gives access to "/ncp tell" which allows whispering something to a specified player.|
|nocheatplus.command.delay|Gives permissions to use the "/ncp delay" command which has the ability to run a specified command with delayed time execution time.|
|nocheatplus.command.tempkick|Allows the player to tempkick/tempban someone from the server using "/ncp tempkick".|
|nocheatplus.command.kicklist|Gives access to the "/ncp kicklist" command which lists all players that got "tempkicked/tempbanned" from NoCheatplus by either using actions or "/ncp tempkick".|
|nocheatplus.command.unkick|Gives access to remove a tempkick/tempban from a player using "/ncp unkick".|

==Filter permissions (plugin hiding)==
|nocheatplus.filter.command.(commandname)|Allows to use a command protected by command protection, only for the case the command did not have a permission set. Note that (commandname) is just the lower-case command label. In case of incompatibilities of your permission plugin you might have to add nocheatplus.filter.command.nocheatplus to players that are to use /ncp ... commands.|
==Bypass==
Specific bypass permissions.
|nocheatplus.bypass.denylogin|Allows to bypass the login denial, such as exists with the /ncp tempkick command.|
==Checks==
Check permissions, directly related to players actions and associated checks.
|nocheatplus.checks|Parent permission for all checks. TODO: Overview for "full" exemption by permissions (might need few additional permissions?).|
===BlockBreak===
|nocheatplus.checks.blockbreak|Parent permission for the blockbreak checks.|
|nocheatplus.checks.blockbreak.direction|Don't force the player to look at the blocks that he/she wants to break.|
|nocheatplus.checks.blockbreak.fastbreak|Allows the player to break blocks very quickly.|
|nocheatplus.checks.blockbreak.frequency|Allows the player to break 2 or more blocks at the same time.|
|nocheatplus.checks.blockbreak.noswing|Don't force players to swing their arm when breaking blocks.|
|nocheatplus.checks.blockbreak.reach|Allows breaking of blocks that are out of reach distance.|
|nocheatplus.checks.blockbreak.wrongblock|Don't force the player to interact with the block first before he/she is allowed break it (interacting=touching).|
|nocheatplus.checks.blockbreak.break.liquid|Allows the player to break liquids such as water or lava (source blocks) by using a hack in creative gamemode.|
===BlockInteract===
|nocheatplus.checks.blockinteract|Parent permission for this check section.|
|nocheatplus.checks.blockinteract.direction|Don't force the player to look at the blocks that he/she is trying to interact with (levers, doors and other).|
|nocheatplus.checks.blockinteract.reach|Allows the player to interact with blocks that are further away than usual.|
|nocheatplus.checks.blockinteract.speed|Allows the player to spam interaction on blocks such as levers, note blocks, doors and other.|
|nocheatplus.checks.blockinteract.visible|Everyone that owns this node is allowed to interact through walls to open a chest, furnace and other container without actually seeing them (also prevents from entering a minecart, bed or boat through walls).|
===BlockPlace===
|nocheatplus.checks.blockplace|...|
|nocheatplus.checks.blockplace.direction|Don't force the player to look at the block that he/she is trying to place on.|
|nocheatplus.checks.blockplace.boatsanywhere|Allows the player to place boats everywhere and not only in the water.|
|nocheatplus.checks.blockplace.fastplace|Allows the player to place blocks very quickly.|
|nocheatplus.checks.blockplace.noswing|Don't force players to swing their arm when placing a block.|
|nocheatplus.checks.blockplace.reach|Allows the player to place blocks that are too far away.|
|nocheatplus.checks.blockplace.speed|Allows a player to throw projectiles very quickly (snowballs, splash potions and other).|
|nocheatplus.checks.blockplace.against.liquids|Having this permission assigned allows to place block against liquids by using a special hack.|
|nocheatplus.checks.blockplace.against.air|This permission allows a player to place blocks against air.|
===Chat===
|nocheatplus.checks.chat|...|
|nocheatplus.checks.chat.color|Don't filter color codes from messages that get sent by players to allow them using colors in their messages. However nearly every chat plugin will override this.|
|nocheatplus.checks.chat.text|Allows the player to bypass the chat spam check for written text.|
|nocheatplus.checks.chat.commands|Allow players to bypass the command frequency check that protects against command spam.|
|nocheatplus.checks.chat.captcha|Owners of this permission wont be forced to type in a captcha if they fail one of the chat checks (this feature is disabled by default).|
|nocheatplus.checks.chat.relog|Every player that has this permission is allowed to completely bypass the re-log check of NoCheatPlus.|
|nocheatplus.checks.chat.logins|Allows the player to bypass the login check which prevents too many players loging in at the same time.|
===Combined===
|nocheatplus.checks.combined|Parent permission for the combined check group.|
|nocheatplus.checks.combined.improbable|Allows the player to bypass the Combined_Improbable check which fights against kill-auras ,speed hacks and some other combined hacks also. It also prevents the player from using 2 or more hacks at the same time.|
|nocheatplus.checks.combined.bedleave|Allows the player to send bed leave packets from anywhere (can be exploited to confuse some other checks of NoCheatPlus).|
|nocheatplus.checks.combined.munchhausen|Players with this node might be able to use fishing roods for flying (Check is disabled by default in configuration).|
===Fight===
|nocheatplus.checks.fight|Fight check group.|
|nocheatplus.checks.fight.angle|Don't prevent the player from attacking multiple entities at the time.|
|nocheatplus.checks.fight.critical|Don't prevent the player from doing fake critical hits when it's technically not possible to do so.|
|nocheatplus.checks.fight.direction|Don't force the player to look at the targets while fighting them.|
|nocheatplus.checks.fight.godmode|Don't prevent the player from keeping the temporary invulnerability that he/she gets when taking damage.|
|nocheatplus.checks.fight.fastheal|The owner of this node is allowed to regenerate health faster then usually possible.|
|nocheatplus.checks.fight.knockback|Don't prevent the player from doing knockbacks when it's technically not possible to do so.|
|nocheatplus.checks.fight.noswing|Don't force the player to move the arm while fighting against someone or something.|
|nocheatplus.checks.fight.reach|Allows the player to hit players and mobs that are out of allowed distance.|
|nocheatplus.checks.fight.selfhit|Allows the player to do self hits for flying by exploiting the knockback of those hits.|
|nocheatplus.checks.fight.speed|Don't limit the amount of attacks that the player can do per second.|
===Inventory===
|nocheatplus.checks.inventory|Inventory check group.|
|nocheatplus.checks.inventory.drop|Don't limit the amount of items that a player may drop within a short timeframe.|
|nocheatplus.checks.inventory.instantbow|Don't prevent the player from shooting arrows instantly over the bow without taking the usual time to pull the string back.|
|nocheatplus.checks.inventory.instanteat|Don't prevent players from eating their food instantly without taking the usual time to munch on it.|
|nocheatplus.checks.inventory.fastclick|Allows the player to move items around the inventory instantly without using there mouse/keyboard to do so.|
|nocheatplus.checks.inventory.items|Allows the player to use illegal enchantments on signed books (This got fixed now in Minecraft 1.4.3 and higher).|
===Moving===
|nocheatplus.checks.moving|Parent permission for the moving checks group.|
|nocheatplus.checks.moving.creativefly|Allows the player to fly faster in creative mode then usually possible.|
|nocheatplus.checks.moving.morepackets|Allow the player to make a lot more movements than normally possible. Doing more movements will result in faster movement speed and causes the server to spend a lot of additional time for processing these movements.|
|nocheatplus.checks.moving.morepacketsvehicle|Allows players to make a lot more movements in vehicles (boats, minecrats, pigs, ...) than normally possible.|
|nocheatplus.checks.moving.nofall|Allows the player to avoid fall damage by using cheats. Normally NoCheatPlus will keep track of a player's movement and rectify the fall-damage calculations of Minecraft so the player always gets the fall damage he/she is supposed to get.|
|nocheatplus.checks.moving.survivalfly|Allows the player to fly in survival mode. It also treats the player as if he has the ".nofall" permission too.|
|nocheatplus.checks.moving.survivalfly.blocking|Allows the player to block while moving at normal speed.|
|nocheatplus.checks.moving.survivalfly.sneaking|Allows the player to sneak while moving at normal speed.|
|nocheatplus.checks.moving.survivalfly.sprinting|Allows the player to sprint backwards.|
|nocheatplus.checks.moving.survivalfly.speeding|Allows the player to bypass the vanilla walk/run/sprint speed limits.|
|nocheatplus.checks.moving.survivalfly.step|Don't check if the player is using the step hack to get faster over blocks then usually possible.|
==Modifications==
These permissions allow to control which feature/mod a player may use. There is no guarantee that players use the original client and obey the request to turn off/on features, though.
===CJB===
|nocheatplus.mods.cjb|All CJB features.|
|nocheatplus.mods.cjb.fly|Don't prevent the player from using CJB's fly mod on the server.|
|nocheatplus.mods.cjb.radar|Gives access to use CJB's radar mod on the server.|
|nocheatplus.mods.cjb.xray|Don't prevent the player from using CJB's xray mod on the server.|
===MinecraftAutoMap===
|nocheatplus.mods.minecraftautomap|All features for MinecraftAutoMap.|
|nocheatplus.mods.minecraftautomap.ores|Don't prevent the player from using the ore detector from Minecraft AutoMap's.|
|nocheatplus.mods.minecraftautomap.cave|Don't prevent the player from using the cave mode feature of the Minecraft AutoMap's mod.|
|nocheatplus.mods.minecraftautomap.radar|Don't prevent the player from using Minecraft AutoMap's inbuilt radar.|
===Rei===
|nocheatplus.mods.rei.cave|Don't prevent the player from using Rei's Minimap's cave mode.|
|nocheatplus.mods.rei.radar|Don't prevent Rei's Minimap mod users from using all kind of available radar hacks.|
|nocheatplus.mods.rei.radar.player|Allows the player to use the radar from Rei's Minimap to track down other players only.|
|nocheatplus.mods.rei.radar.animal|Allows the player to only use the animal radar from Rei's Minimap mod.|
|nocheatplus.mods.rei.radar.mob|Gives access to use the mob radar feature from Rei's Minimap mod.|
|nocheatplus.mods.rei.radar.slime|Allows the player to track down slimes only by using the radar feature of Rei's Minimap.|
|nocheatplus.mods.rei.radar.squid|Player is allowed to use the Rei's Minimap radar to track down squids only.|
|nocheatplus.mods.rei.radar.other|Allows the player to use all the other features of the Rei's Minimap radar.|
===SmartMoving===
|nocheatplus.mods.smartmoving|All SmartMoving features.|
|nocheatplus.mods.smartmoving.climbing|Don't prevent the player from using Smart Moving's climb feature.|
|nocheatplus.mods.smartmoving.swimming|Don't prevent the player from using Smart Moving's swimming.|
|nocheatplus.mods.smartmoving.crawling|Don't prevent the player from using Smart Moving's crawl.|
|nocheatplus.mods.smartmoving.sliding|Don't prevent the player from using Smart Moving's slide.|
|nocheatplus.mods.smartmoving.jumping|Don't prevent the player from using Smart Moving's jump.|
|nocheatplus.mods.smartmoving.flying|Don't prevent the player from using Smart Moving's fly.|
===Zombe===
|nocheatplus.mods.zombe|All zombe features.|
|nocheatplus.mods.zombe.fly|Don't prevent the player from using Zombe's fly mod.|
|nocheatplus.mods.zombe.noclip|Don't prevent the player from using Zombe's noclip mod on the server.|
|nocheatplus.mods.zombe.cheat|Don't prevent the player from using Zombe's cheat mods.|\\
== Parent Nodes ==
Most permissions have parent nodes, that in fact goes for all check types. Resulting in nocheatplus.admin, nocheatplus.checks.moving, nocheatplus.checks.moving.survivalfly, nocheatplus.checks.fight, etc.
=== Things to know about Permissions ===
You can exclude a specific player from getting logged by appending ".silent" to the relevant permission node of the specific check. E.g.\\

* **nocheatplus.checks.moving.nofall.silent**\\

will prevent NoCheatPlus from recording log messages for that player for the "nofall" check, while still executing all other actions as usual.
==Shortcut permissions==
|nocheatplus.admin| see above (full admin perms except check bypassing).|
|nocheatplus.shortcut.info|info about players|
|nocheatplus.shortcut.monitor|info about players and diagnostic info like version, lag,|
|nocheatplus.shortcut.safeadmin|"Safe" admin perms, no banning or reloading but unkick, exemption, data removal|

More to be added (shortcut.bypass - bypass about everything).

=Recommended=

The following plugins might be useful to have a look at.

CompatNoCheatPlus (cncp)

Make plugins like mcMMO, Citizens, MagicSpells or MachinaCraft more compatbile with NoCheatPlus. Not all existing plugins are covered (yet), but you can leave a note or ticket request for cncp.

Orebfuscator

Orebfuscator fights all sorts of X-ray-hacks by altering the map information that is sent to the players, such that they have to mine blocks to actually reveal what is behind. Virtually a "must have".

=下载和历史更新=

* 下载正式版本请前往 BukkitDev [http://dev.bukkit.org/server-mods/nocheatplus/files/ Files].
* 下载测试版本请前往 [http://dev.bukkit.org/server-mods/nocheatplus/pages/nocheat-plus-development/jenkins/ Jenkins at EcoCityCraft].
* 不要从任何其他来源下载，不要使用别人给你的插件.
* 前往Jenkins查看所有版本的更新记录[http://dev.bukkit.org/server-mods/nocheatplus/pages/nocheat-plus-development/jenkins/ changes list].
* 前往GitHub查看所有改动 [https://github.com/NoCheatPlus/NoCheatPlus/commits/master commit history].
* <s>插件统计将不会传送至 mcstats.org.</s>

=Support=

==其他帮助==

* 你可以到: [https://github.com/asofold/NCPDocs/blob/master/FAQ.creole#faq Frequently asked Questions] 以及 [https://github.com/asofold/NCPDocs/blob/master/Known%20Issues.creole#known-issues Known Issues] 提问.
* [https://github.com/asofold/NCPDocs/blob/master/README.creole#ncpdocs Wiki] (配设文件, 权限介绍, 指令介绍)
* 开发者请查看NoCheatPlus的API.

==联系我们==
你有疑问可以到,
IRC联系我们 (IRC地址: irc.spi.gt | 默认Port: 6667 | SSL-Port: 6697 | Channel: #nocheat | Web client: WebIRC)
 
你可以创造一个提问票 [http://dev.bukkit.org/bukkit-plugins/nocheatplus/create-ticket/ new ticket] 或者查看已存在提问票 [http://dev.bukkit.org/server-mods/nocheatplus/tickets/ existing ticket].
 
你可以私聊原作者[http://dev.bukkit.org/home/send-private-message/ @asofold]和[http://dev.bukkit.org/home/send-private-message/ @MyPictures]，@IceAP (IRC: ICE)
 
请勿联系用户 'NoCheatPlus', 它仅用于管理，不会及时回复你的提问. 转移到 BukkitDev 和 GitHub 获取更多的帮助, 请勿相信BukkitDev以外的 NCP 管理人员 .

NoCheatPlus

2015-10-11T16:32:56Z

Lichi2050：/* 联系我们 */

{{Bukkit Plugin Infobox
|插件名=NoCheatPlus
|版本=3.12.0-BETA2-sASO-b813
|前置插件=无
|兼容服务端版本=1.8.1
|網址=http://dev.bukkit.org/bukkit-plugins/nocheatplus/
}}
{{待翻译}}
'''Detect and fight the exploitation of various flaws/bugs in Minecraft!'''
[[Category:管理]] [[Category:修正]] [[Category:安全]]
=介绍=

NoCheatPlus试图通过禁止作弊客户端利用Minecraft或是它自身数据传递协议的漏洞, 来使得你的服务器更加安全可靠. 检测范围很广，包括飞行，加速，战斗 hacks, 快速破坏方块和 nukers, 背包 hacks, 聊天 spam and other types of malicious behaviour. For a more complete list have a look at the [https://github.com/asofold/NCPDocs/blob/master/Features.creole Features Page]（内容已搬至本页面，查看最新内容请点击链接）.

NoCheatPlus puts emphasis on configurability and allows you to customize actions that are carried out when a player fails a check (e.g. silent cancelling, executing commands, just logging). Bypass permissions allow to control what check to apply for which players, all checks can be deactivated in the configuration, also having the option for world-specific configuration files. Many checks allow more detailed configuration to adjust sensitivity.

Certainly NoCheatPlus is not a magical bullet, it uses a lot of heuristics and even guessing, so you will encounter false positives here and there and also not catch every single violation. [http://www.youtube.com/watch?v=H8BSpXfrtzI Example video] of how NoCheatPlus blocks cheats (outdated plugin version).

NoCheatPlus was introduced by [http://dev.bukkit.org/profiles/NeatMonster/ NeatMonster], building on the code base of [http://dev.bukkit.org/server-mods/nocheat/ NoCheat] by [http://dev.bukkit.org/profiles/Evenprime85/ Evenprime].
==功能==
* 玩家行动:
** 禁止飞行(生存/冒险模式下) 或是限制飞行速度(创造模式下)
** Enforce the original movement speeds for walking, sprinting, sneaking, swimming, blocking
** 禁止玩家无视掉落伤害
** 禁止玩家进入方块 (穿墙模式)
** 禁止玩家改变服务器时间
** Prevent players from using the "safe-respawn" exploit
** 禁止在水和岩浆顶部行走 [尽管现在的作弊者只是在其上保持跳跃]
** 禁止玩家通过非法移动使服务器崩溃 (CraftBukkit 自身并不包含检测模块,但有时这些移动数据会影响到插件.)
** Prevent players from faking BedLeave packets
** 禁止玩家悬浮在半空中
** 禁止玩家利用 "block jumping"来跳过高墙
** Prevent players from V-Clipping or teleporting
** 禁止玩家滥用钓竿来绕开飞行检测 (这只是一个玩笑...) [未测试! 默认关闭!]
** Prevent players from using their glide cheat 新!
** 禁止玩家滥用末影珍珠穿越墙，屋顶和地板新!
* 方块交互:
** 禁止玩家操作正常接触范围之外的方块
** 强制玩家看着想要操作的方块
** 禁止玩家透过墙对方块进行操作
** Prevent players from spamming interaction on blocks (note-blocks, doors, stone, wood, ...)
* 方块破坏:
** 防止玩家使用 "Survival Nuker", "Smasher", "Click Nuker" 与 "Creative Nuker"
** 防止以快于客户端允许的不正常速度破坏方块, 防止极快的同时破坏过多方块.
** 限制玩家可破坏方块的距离
** 强制玩家看着方块(破坏方块时，鼠标准星需对准方块)
** 防止 "noswing" 作弊 (玩家破坏方块时手臂没有动作)
** 禁止玩家同时破坏两个及以上的方块
** 禁止创造模式下的玩家破坏水或岩浆
* 方块放置:
** 防止玩家使用 "FastPlace" 和 "Build" 类作弊工具
** 限制玩家可放置方块的距离
** 强制对准方块
** 禁止玩家过快地投掷物品
** 禁止玩家在除了水和岩浆上的地方放置船只
** Prevent players from using the AutoSign feature of their client
** 禁止玩家在半空中放置方块.
** 禁止玩家在流体上放置方块
* 玩家聊天:
** 部分功能受Evenprime的插件启发.
** Fast spam check + tool-box for slower paced annoyances (can take into account a players chat history and global chat history).
** Limit the number of players allowed to join within a specific time frame
** 禁止短时间内多次重复登陆.
** Filter colors from player messages
** Supports text and command spam blocking
* 背包:
** Prevent players from dropping too many items within a short time frame and therefore lagging the server
** 禁止玩家过快地填充，发射弓箭
** 禁止玩家过快地进食
** Prevents players from managing there items to fast (inventory, enchantment table, beacon, ...)
** Prevents players from binding illegal enchantments on books (fixed in Minecraft 1.4.3 and higher)
* 战斗:
** 防止玩家同时攻击过多实体(玩家和怪物都算做实体)
** Prevent attacking of enemies that aren't in the line of sight of the player
** Prevent attacking without first swinging your arm
** 防止一秒内对生物攻击多次
** Prevent attacking of targets that are too far away
** Prevent players becoming invulnerable by exploitation of a design flaw of Minecraft
** Prevent players from knocking back other players when it's not technically possible
** Prevent players from exploiting extremely low jumps to get a pseudo criticals cheat going NEW!
** Prevent players from giving critical hits to other players when it's not technically possible
** Prevent players from hit other players while blocking with their sword
** Penalize players that change their direction by a lot (against force fields)
** Prevent players from doing self hits to fly by using the knockback of those
** Feed combined check to find players that try to execute 2 or more cheats at the same time
** 防止玩家过快地回复血量
* Miscellaneous:
** 禁用 Zombe's mod (飞行, noclip, 作弊)
** 禁用e CJB's mod (飞行, 透视, 雷达)
** 禁用 Rei's Minimap (洞穴, 雷达)
** 禁用 Minecraft AutoMap (ores, cave, radar)
** 禁用 Smart Moving (攀爬, 游泳, crawling, 滑行, 跳跃, 飞行)
** Restrict the OP management commands to a console usage only (disabled by default)
** Adapts to server sided lag for less false positives on heavy server load
** Provides a API that allows making other plugins compatible with NoCheatPlus
** Use of BukkitAPI only if the used CraftBukkit version is not supported

==配置==

=Configuration=

==General notes on .yml configuration files==
* Use spaces for indentation.
* Keep the indentation level: Never change the amount of white-spaces in front of options in the config file "config.yml".
* Don't insert special characters such as tabs for indentation. If you plan on complicated text entries, wrap them like '...' or "...".
* Refer to the default config file for reference.
* Use a [[http://yaml-online-parser.appspot.com/|YAML parser]] to make sure your configuration file is formatted properly.
* Inserting unsupported characters or changing indentation levels can break the configuration.
* For those that use Notepad++ to edit their YAML files we recommend to enable "Replace by space" in Settings -> Preferences -> Tab Settings \\
[[https://github.com/asofold/NCPDocs/blob/master/wiki/resources/Configuration/cResources.creole#notepad++|Screenshot of Notepad++ preferences]]

==特定世界的配置==
怎样创建一个特定世界的配置文件呢?（不同世界不同管理）:
#首先创建一个空的yml文件根据你的服务器世界的名称。例如：world_config.yml（_是必需的！一切都是很敏感的！）
# 在你的服务器安装NocheatPlus或运行 /重新安装NocheatPlus /如果已经在你的服务器运行请重载
# NoCheatPlus should now write every setting available for world specific configuration in that/those empty yaml files
# If you rather prefer to use some settings of your global config.yml then set "savebackconfig" to false and remove them from your world specific configuration file

* End result in your [[https://github.com/asofold/NCPDocs/blob/master/wiki/resources/Configuration/cResources.creole#world-specific-configuration|explorer window]] after successfully creating some world specific config.yml files
* Other examples: WorldName_config.yml, world_nether_config.yml, world_the_end_config.yml, HungerGames_config.yml or BackupWorld_config.yml

Notes:
* The world name is case sensitive (MiningWorld, theWorld etc.).
* You can set savebackconfig to false, in order to not have NoCheatPlus add default values to a config file. Thus you can override just the values you are interested in and keep a minimal world-specific configuration file.
* WorldName_config.yml has always higher priority then config.yml. So NoCheatPlus will first apply all settings from config.yml and then override them for a specific world using WorldName_config.yml
* Some settings can only be used in the global config.yml and aren't multiworld compatible (Please don't just copy config.yml and rename it to WorldName_config.yml or similar.)
* World specific files can be created, changed or removed while your server and NoCheatPlus are running. Just use the /ncp reload or /nocheatplus reload command to let NoCheatPlus reread your configuration file.
* If a world gets unloaded, deleted or renamed then NoCheatPlus will automaticly ignore your world specific configuration files you made for it

==Configversion==
Set {{{notify}}} to false to suppress the messages about outdated configurations. Only the main configuration file is checked at present.
\\The other entries are not meant to be changed by hand, they indicate with which version the config was created and last saved back.

==Logging==

Disable all logging with setting {{{active}}} to false.

Individual logging targets can be configured in the sub sections within {{{backends}}}:
* Set {{{active}}} to false to disable the individual backend.
* The {{{prefix}}} parameter allows to create a custom appearance for the log messages.
* File logging allows specifying a file name.
* For {{{ingamechat}}} you can force NoCheatPlus to check permissions subscriptions, if you use plugins that apply this technique to log to IRC and other for instance.

==Miscellaneous==
* Set {{{opinconsoleonly}}} to true to prevent op and deop commands from in-game chat. [Will be changed to a list of commands.]
* Set {{{managelisteners}}} to true to help us testing :) - this feature lets NCP register all its listeners inside of a ListenerManager that allows more intricate registration order than Bukkit. This is a "future feature" and is not needed, not even sure it improves performance.
* Set {{{reporttometrics}}} to false in order to disable reporting usage-stats to [[http://mcstats.org/plugin/NoCheatPlus|mcstats.org]] (PluginMetrics). Setting this to falss also prevents NoCheatplus from creating the PluginMetrics folder, however other plugins or Spigot could still create that folder.

==Data==
The data section allows you to specify an expiration duration for players data in minutes. If set to something greater than 0, this will periodically remove players data if the players have been logged out for longer than the specified amount of minutes. At present this would also delete set-back locations and current violation levels, if activated, so it should not be set to a too short duration.

**expiration**
|**Config**|**Description**|**Default**|
|**duration**|Duration in minutes after logout, after which data gets erased.|0|
|**history**|Should the players violation history also be deleted?|false|

**consistencychecks**
You can suppress consistency check warnings here and alter intervals for periodic checking (usually not needed).

==Protection==
===Plugins===
Features for this and other plugins.
====Hide====
This section contains configuration for hiding (some of) your plugins better. You can prevent help-contents display and command usage by setting permissions with a permissions plugin, if the command has a default permission set, but NoCheatPlus allows to set the permission message of some commands, which would otherwise reveal the presence of the command/plugin. So the permission message for some commands can be changed to the "Unknown command" message to hide the presence. You do need to also set the aliases of the commands, use lower case rather.
\\This feature allows to change command permissions to not be given by default or add a generic filter permission nocheatplus.filter.command.//(commandname)// to a command that does not have one set yet, the following settings allow configuring lists of commands and the message:
\\**"nopermission":**\\
Display the "no permission" message, default to "plugins" and "version" commands, useful for instance if a plugin does not set a permission for a command.
\\**"unknowncommand":**\\
Display the "unknown command" message, empty by default. This can be used to hide a command from users that don't have the default permission (or the filter permission added by NCP if none was set).

\\TODO: Link docs on how to configure help topics and other.
===Clients===
Features that concern client mods.
Set the {{{active}}} flag to false in the {{{motd}}} section to prevent NoCheatPlus sending any "blank lines" messages to clients on login. Otherwise blank lines can result disregarding if all clients are allowed or not, because some clients use a message to enable features, some need a message to disable features.
\\Note that it is 100% up to the client to decide on enabling or disabling features, a modified version of any client may ignore any sent messages, without that being detectable.

==Configuration of checks==
The checks section contains configuration mostly for checks related to players actions, most can generate violation log messages (few exceptions).

===Checks overview===

See: [[checks/checks.creole|Checks Overview]]

Shortcut links:
\\|
[[checks/blockbreak/blockbreak.creole|blockbreak]] |
[[checks/blockinteract/blockinteract.creole|blockinteract]] |
[[checks/blockplace/blockplace.creole|blockplace]] |
[[checks/chat/chat.creole|chat]] |
[[checks/combined/combined.creole|combined]] |
[[checks/fight/fight.creole|fight]] |
[[checks/inventory/inventory.creole|inventory]] |
[[checks/moving/moving.creole|moving]] |

==Strings section==
This is the section that defines various strings for "log" or "cmd" actions. Each has a name (the part in front of ":") and a definition (the part behind the ":"). Whenever you use a "log" or "cmd" action in one of the "actions: " options of this config file, the string will be taken from this section. Arbitrary many additional strings may be defined here, or existing strings may be changed.
\\ \\
Most messages/commands use place-holders in [ ], which will be replaced at runtime with relevant information. Some of these may only be available in certain circumstances, only "[player]" can be used everywhere, especially in "cmd" actions.|
\\

==Compatibility section==
This section allows to configure details for the case of compatibility issues, for instance with other server mods or custom blocks.

[[compatibility/compatibility.creole|compatibility page]]

==Bleeding Edge: Development builds==
To allow you to keep track with the configuration and permission changes in the latest development versions, we have a simple page set up: **[[../development/dev-pinboard.creole|Development Pinboard]]**
\\
For quick overview over recent builds, see: [[../development/build-infos.creole|Important Changes By Build Number]]
==命令==
=Commands=

NoCheatPlus integrates a lightweight command system. It allows you to quickly exempt players from checks or to access and manage check data about a player.

All commands support tab completion and some even allow shortcuts. The root command is named "nocheatplus", however the alias "ncp" should also work and is used for reference here.

NoCheatPlus also supports aliases from Bukkit [[http://wiki.bukkit.org/Bukkit.yml#aliases|BukkitAliases]] if you wish to have another alias command aside form "nocheatplus" and "ncp".

==Permissions==
Root node for commands:
* **NoCheatPlus 3.10.2** and above: {{{nocheatplus.commands}}}
* //NoCheatPlus 3.10.1// and below: {{{nocheatplus.admin}}}

You can give a player access to a specific command by giving them the sub-node with the commands default name, like {{{nocheatplus.admin.info}}}.
For further information about permissions in NoCheatPlus, we recommend looking at the [[../permissions/permissions.creole|Permissions docs]].

==Administrative commands==
Those commands are used to basically manage NoCheatPlus on your server.
**Arguments in () are needed, while arguments in [] are optional.**
|=Commands|=Explanation|
|/ncp reload| Reloads, generates and regenerates the configuration file of NoCheatPlus. Run this in-case you changed something on your configuration file while your server was running.|
|/ncp notify on/off| Toggle all in-game notifications/alerts generated by NoCheatPlus.|
|/ncp info (player)| Display the violation levels of a given player.|
|/ncp lag| Show info about server sided latency. The average lag shows the percentage of the server running too slow (0% = 20 tps, 10% = 18 tps) for the last 1 second, 3.33 and 270 seconds, roughly. Also lag spikes are displayed, tracked over at most 1 hour with a resolution of 20 minutes buckets (i.e. not exact) for spikes > 150 ms (3x to 20x) and spikes > 1000 ms (20x +). Be aware that this information is needed to make most NoCheatPlus checks adapt to server sided lag.|
|/ncp removeplayer (player) [check_type]| Remove all the data collected by NoCheatPlus so far for a given player. You can use the [check_type] option to make NoCheatPlus only remove data from a specific check (Default will clean all data of all checks!). To list all check names execute a command such as this: /ncp removeplayer (PlayerName) list. "*" is supported here.
|/ncp exempt (player) [check_type]| Exempt a player from being checked by NoCheatPlus or by a specific check.|
|/ncp unexempt (player) [check_type]| Remove any exemption you given to a specified player. "*" Is supported here.|
|/ncp exemptions (player)| Gives back a list of all check that a specific player has been exempted from.|
|/ncp commands| List all commands, more than shown here. The other commands are mainly for use with actions, such as delaying other commands, kicking with a message, telling players messages in colour, deny login for a players, allow it again and other.|
|/ncp version| Show version information about the server, plugin, compatibility modules and registered hooks.|

==Auxiliary commands==
Those commands are mainly used by NoCheatPlut itself to execute strings or commands over actions on violating players but you can also make use of them if you wish to do so. Most of them have no difference compared to the vanilla commands apart from the delay otion.
**Arguments in () are needed, while arguments in [] are optional.**
|=Commands|=Explanation|
|/ncp ban [delay=(ticks)] (player) [reason]|Ban a player from your server (banned-players.txt).|
|/ncp kick [delay=(ticks)] (player) [reason]|Kicks a player from your server|
|/ncp unkick (player)|Allows you to remove a tempkick/tempban from a player. "*" is supported here.|
|/ncp kicklist|Lists all players that have been tempkicked/tempbanned on your server by NoCheatPlus actions.|
|/ncp tell [delay=(ticks)] (player) (message)|Send a private message to a specified player.|
|/ncp delay [delay=(ticks)] (command)|Execute a command in delayed time.|
==权限==

**This page describes permissions for NoCheatPlus 3.10.2 and above,**
\\**NoCheatPlus 3.10.2-RC-sMD5NET-b620 adds new permissions for commands and new short-cut permissions, updates following soon.**
\\//For older versions see the [[permissions-3-10-1.creole|permissions page for 3.10.1 and below.]]//

NoCheatPlus supports "SuperPerms", CraftBukkit's official permission framework. You'll need to use a permissions plugin that supports "SuperPerms" to manage all the permissions of NoCheatPlus. Here are some examples:

* PermissionsEx
* bPermissions
* Essentials GroupManager
* Privileges
* zPermissions

By default NoCheatPlus assigns all permissions and gives full rights to players that have been /op-ed on your server. If you don't want to give OPs full access to all NoCheatPlus features then take a look in the configuration of your permissions plugin (Example with PermissionsEx: allowOps: false).\\\\
==Notifications==
|nocheatplus.notify|The player will receive notifications through the in-game chat of players failing NoCheatPlus checks. .|
If you want moderators to be able to toggle notifications, just give the permission nocheatplus.command.notify, which will also give this one then. Mind the ".silent" permission for individual checks permissions (explained on the bottom of this page).

==Administration==
|{{{nocheatplus.admin}}}|Shortcut permission for all administrative commands including ban (do not give lightly). See nocheatplus.shortcut permissions for faster setup for moderators.|
===Debug===
|nocheatplus.admin.debug|Owners of this node will receive debug messages of checks if NoCheatPlus debugging is turned on.|
==命令权限==
|nocheatplus.command.notify|Allow toggling notifications and also to receive them (nocheatplus.notify is included here).|
|nocheatplus.command.info|The player gets access to "/ncp info", which displays all violations that a player has gotten (if any).|
|nocheatplus.command.lag|Gives access to "/ncp lag" which shows informations about your server latency (NoCheatPlus uses this informations to adapt some checks for serversided latency).|
|nocheatplus.command.reload|The player gets access to "/ncp reload", which causes NoCheatPlus to reread its configuration files (This doesn't clear NoCheatPlus data or exemptions!).|
|nocheatplus.command.plugins|Allows the player to execute the "/plugins" or "/pl" command from CraftBukkit (//protectplugins// has be set to true in the configuration file).|
|nocheatplus.command.version|Owners of this node can execute the "/version" or "/ver" command from CraftBukkit (//protectplugins// has be set to true in the configuration file).|
|nocheatplus.command.exemptions|Gives access to execute "/ncp exemptions" which list all exemptions for an specified player (Those exemptions will get reset after every reload/restart! For permanent exemptions use the check permissions!).|
|nocheatplus.command.exempt|Gives access to the "/ncp exempt" command which allows to temporary exempt players for either all (ALL) or specified checks only.|
|nocheatplus.command.unexempt|Allows to unexempt players from checks by using the "/ncp unexempt" command.|
|nocheatplus.command.removeplayer|Gives access to execute "/ncp removeplayer", which causes NoCheatPlus to wipe/clear specified or all collected data from a player including violations and temporary stored check data (This wont wipe exemptions!).|
|nocheatplus.command.commands|Allows the player to use the "/ncp" command which lists all NoCheatPlus commands.|
|nocheatplus.command.ban|Gives permissions to use "/ncp ban" which bans a player on your server.|
|nocheatplus.command.kick|Gives access to "/ncp kick" which kicks a player from your server.|
|nocheatplus.command.tell|Gives access to "/ncp tell" which allows whispering something to a specified player.|
|nocheatplus.command.delay|Gives permissions to use the "/ncp delay" command which has the ability to run a specified command with delayed time execution time.|
|nocheatplus.command.tempkick|Allows the player to tempkick/tempban someone from the server using "/ncp tempkick".|
|nocheatplus.command.kicklist|Gives access to the "/ncp kicklist" command which lists all players that got "tempkicked/tempbanned" from NoCheatplus by either using actions or "/ncp tempkick".|
|nocheatplus.command.unkick|Gives access to remove a tempkick/tempban from a player using "/ncp unkick".|

==Filter permissions (plugin hiding)==
|nocheatplus.filter.command.(commandname)|Allows to use a command protected by command protection, only for the case the command did not have a permission set. Note that (commandname) is just the lower-case command label. In case of incompatibilities of your permission plugin you might have to add nocheatplus.filter.command.nocheatplus to players that are to use /ncp ... commands.|
==Bypass==
Specific bypass permissions.
|nocheatplus.bypass.denylogin|Allows to bypass the login denial, such as exists with the /ncp tempkick command.|
==Checks==
Check permissions, directly related to players actions and associated checks.
|nocheatplus.checks|Parent permission for all checks. TODO: Overview for "full" exemption by permissions (might need few additional permissions?).|
===BlockBreak===
|nocheatplus.checks.blockbreak|Parent permission for the blockbreak checks.|
|nocheatplus.checks.blockbreak.direction|Don't force the player to look at the blocks that he/she wants to break.|
|nocheatplus.checks.blockbreak.fastbreak|Allows the player to break blocks very quickly.|
|nocheatplus.checks.blockbreak.frequency|Allows the player to break 2 or more blocks at the same time.|
|nocheatplus.checks.blockbreak.noswing|Don't force players to swing their arm when breaking blocks.|
|nocheatplus.checks.blockbreak.reach|Allows breaking of blocks that are out of reach distance.|
|nocheatplus.checks.blockbreak.wrongblock|Don't force the player to interact with the block first before he/she is allowed break it (interacting=touching).|
|nocheatplus.checks.blockbreak.break.liquid|Allows the player to break liquids such as water or lava (source blocks) by using a hack in creative gamemode.|
===BlockInteract===
|nocheatplus.checks.blockinteract|Parent permission for this check section.|
|nocheatplus.checks.blockinteract.direction|Don't force the player to look at the blocks that he/she is trying to interact with (levers, doors and other).|
|nocheatplus.checks.blockinteract.reach|Allows the player to interact with blocks that are further away than usual.|
|nocheatplus.checks.blockinteract.speed|Allows the player to spam interaction on blocks such as levers, note blocks, doors and other.|
|nocheatplus.checks.blockinteract.visible|Everyone that owns this node is allowed to interact through walls to open a chest, furnace and other container without actually seeing them (also prevents from entering a minecart, bed or boat through walls).|
===BlockPlace===
|nocheatplus.checks.blockplace|...|
|nocheatplus.checks.blockplace.direction|Don't force the player to look at the block that he/she is trying to place on.|
|nocheatplus.checks.blockplace.boatsanywhere|Allows the player to place boats everywhere and not only in the water.|
|nocheatplus.checks.blockplace.fastplace|Allows the player to place blocks very quickly.|
|nocheatplus.checks.blockplace.noswing|Don't force players to swing their arm when placing a block.|
|nocheatplus.checks.blockplace.reach|Allows the player to place blocks that are too far away.|
|nocheatplus.checks.blockplace.speed|Allows a player to throw projectiles very quickly (snowballs, splash potions and other).|
|nocheatplus.checks.blockplace.against.liquids|Having this permission assigned allows to place block against liquids by using a special hack.|
|nocheatplus.checks.blockplace.against.air|This permission allows a player to place blocks against air.|
===Chat===
|nocheatplus.checks.chat|...|
|nocheatplus.checks.chat.color|Don't filter color codes from messages that get sent by players to allow them using colors in their messages. However nearly every chat plugin will override this.|
|nocheatplus.checks.chat.text|Allows the player to bypass the chat spam check for written text.|
|nocheatplus.checks.chat.commands|Allow players to bypass the command frequency check that protects against command spam.|
|nocheatplus.checks.chat.captcha|Owners of this permission wont be forced to type in a captcha if they fail one of the chat checks (this feature is disabled by default).|
|nocheatplus.checks.chat.relog|Every player that has this permission is allowed to completely bypass the re-log check of NoCheatPlus.|
|nocheatplus.checks.chat.logins|Allows the player to bypass the login check which prevents too many players loging in at the same time.|
===Combined===
|nocheatplus.checks.combined|Parent permission for the combined check group.|
|nocheatplus.checks.combined.improbable|Allows the player to bypass the Combined_Improbable check which fights against kill-auras ,speed hacks and some other combined hacks also. It also prevents the player from using 2 or more hacks at the same time.|
|nocheatplus.checks.combined.bedleave|Allows the player to send bed leave packets from anywhere (can be exploited to confuse some other checks of NoCheatPlus).|
|nocheatplus.checks.combined.munchhausen|Players with this node might be able to use fishing roods for flying (Check is disabled by default in configuration).|
===Fight===
|nocheatplus.checks.fight|Fight check group.|
|nocheatplus.checks.fight.angle|Don't prevent the player from attacking multiple entities at the time.|
|nocheatplus.checks.fight.critical|Don't prevent the player from doing fake critical hits when it's technically not possible to do so.|
|nocheatplus.checks.fight.direction|Don't force the player to look at the targets while fighting them.|
|nocheatplus.checks.fight.godmode|Don't prevent the player from keeping the temporary invulnerability that he/she gets when taking damage.|
|nocheatplus.checks.fight.fastheal|The owner of this node is allowed to regenerate health faster then usually possible.|
|nocheatplus.checks.fight.knockback|Don't prevent the player from doing knockbacks when it's technically not possible to do so.|
|nocheatplus.checks.fight.noswing|Don't force the player to move the arm while fighting against someone or something.|
|nocheatplus.checks.fight.reach|Allows the player to hit players and mobs that are out of allowed distance.|
|nocheatplus.checks.fight.selfhit|Allows the player to do self hits for flying by exploiting the knockback of those hits.|
|nocheatplus.checks.fight.speed|Don't limit the amount of attacks that the player can do per second.|
===Inventory===
|nocheatplus.checks.inventory|Inventory check group.|
|nocheatplus.checks.inventory.drop|Don't limit the amount of items that a player may drop within a short timeframe.|
|nocheatplus.checks.inventory.instantbow|Don't prevent the player from shooting arrows instantly over the bow without taking the usual time to pull the string back.|
|nocheatplus.checks.inventory.instanteat|Don't prevent players from eating their food instantly without taking the usual time to munch on it.|
|nocheatplus.checks.inventory.fastclick|Allows the player to move items around the inventory instantly without using there mouse/keyboard to do so.|
|nocheatplus.checks.inventory.items|Allows the player to use illegal enchantments on signed books (This got fixed now in Minecraft 1.4.3 and higher).|
===Moving===
|nocheatplus.checks.moving|Parent permission for the moving checks group.|
|nocheatplus.checks.moving.creativefly|Allows the player to fly faster in creative mode then usually possible.|
|nocheatplus.checks.moving.morepackets|Allow the player to make a lot more movements than normally possible. Doing more movements will result in faster movement speed and causes the server to spend a lot of additional time for processing these movements.|
|nocheatplus.checks.moving.morepacketsvehicle|Allows players to make a lot more movements in vehicles (boats, minecrats, pigs, ...) than normally possible.|
|nocheatplus.checks.moving.nofall|Allows the player to avoid fall damage by using cheats. Normally NoCheatPlus will keep track of a player's movement and rectify the fall-damage calculations of Minecraft so the player always gets the fall damage he/she is supposed to get.|
|nocheatplus.checks.moving.survivalfly|Allows the player to fly in survival mode. It also treats the player as if he has the ".nofall" permission too.|
|nocheatplus.checks.moving.survivalfly.blocking|Allows the player to block while moving at normal speed.|
|nocheatplus.checks.moving.survivalfly.sneaking|Allows the player to sneak while moving at normal speed.|
|nocheatplus.checks.moving.survivalfly.sprinting|Allows the player to sprint backwards.|
|nocheatplus.checks.moving.survivalfly.speeding|Allows the player to bypass the vanilla walk/run/sprint speed limits.|
|nocheatplus.checks.moving.survivalfly.step|Don't check if the player is using the step hack to get faster over blocks then usually possible.|
==Modifications==
These permissions allow to control which feature/mod a player may use. There is no guarantee that players use the original client and obey the request to turn off/on features, though.
===CJB===
|nocheatplus.mods.cjb|All CJB features.|
|nocheatplus.mods.cjb.fly|Don't prevent the player from using CJB's fly mod on the server.|
|nocheatplus.mods.cjb.radar|Gives access to use CJB's radar mod on the server.|
|nocheatplus.mods.cjb.xray|Don't prevent the player from using CJB's xray mod on the server.|
===MinecraftAutoMap===
|nocheatplus.mods.minecraftautomap|All features for MinecraftAutoMap.|
|nocheatplus.mods.minecraftautomap.ores|Don't prevent the player from using the ore detector from Minecraft AutoMap's.|
|nocheatplus.mods.minecraftautomap.cave|Don't prevent the player from using the cave mode feature of the Minecraft AutoMap's mod.|
|nocheatplus.mods.minecraftautomap.radar|Don't prevent the player from using Minecraft AutoMap's inbuilt radar.|
===Rei===
|nocheatplus.mods.rei.cave|Don't prevent the player from using Rei's Minimap's cave mode.|
|nocheatplus.mods.rei.radar|Don't prevent Rei's Minimap mod users from using all kind of available radar hacks.|
|nocheatplus.mods.rei.radar.player|Allows the player to use the radar from Rei's Minimap to track down other players only.|
|nocheatplus.mods.rei.radar.animal|Allows the player to only use the animal radar from Rei's Minimap mod.|
|nocheatplus.mods.rei.radar.mob|Gives access to use the mob radar feature from Rei's Minimap mod.|
|nocheatplus.mods.rei.radar.slime|Allows the player to track down slimes only by using the radar feature of Rei's Minimap.|
|nocheatplus.mods.rei.radar.squid|Player is allowed to use the Rei's Minimap radar to track down squids only.|
|nocheatplus.mods.rei.radar.other|Allows the player to use all the other features of the Rei's Minimap radar.|
===SmartMoving===
|nocheatplus.mods.smartmoving|All SmartMoving features.|
|nocheatplus.mods.smartmoving.climbing|Don't prevent the player from using Smart Moving's climb feature.|
|nocheatplus.mods.smartmoving.swimming|Don't prevent the player from using Smart Moving's swimming.|
|nocheatplus.mods.smartmoving.crawling|Don't prevent the player from using Smart Moving's crawl.|
|nocheatplus.mods.smartmoving.sliding|Don't prevent the player from using Smart Moving's slide.|
|nocheatplus.mods.smartmoving.jumping|Don't prevent the player from using Smart Moving's jump.|
|nocheatplus.mods.smartmoving.flying|Don't prevent the player from using Smart Moving's fly.|
===Zombe===
|nocheatplus.mods.zombe|All zombe features.|
|nocheatplus.mods.zombe.fly|Don't prevent the player from using Zombe's fly mod.|
|nocheatplus.mods.zombe.noclip|Don't prevent the player from using Zombe's noclip mod on the server.|
|nocheatplus.mods.zombe.cheat|Don't prevent the player from using Zombe's cheat mods.|\\
== Parent Nodes ==
Most permissions have parent nodes, that in fact goes for all check types. Resulting in nocheatplus.admin, nocheatplus.checks.moving, nocheatplus.checks.moving.survivalfly, nocheatplus.checks.fight, etc.
=== Things to know about Permissions ===
You can exclude a specific player from getting logged by appending ".silent" to the relevant permission node of the specific check. E.g.\\

* **nocheatplus.checks.moving.nofall.silent**\\

will prevent NoCheatPlus from recording log messages for that player for the "nofall" check, while still executing all other actions as usual.
==Shortcut permissions==
|nocheatplus.admin| see above (full admin perms except check bypassing).|
|nocheatplus.shortcut.info|info about players|
|nocheatplus.shortcut.monitor|info about players and diagnostic info like version, lag,|
|nocheatplus.shortcut.safeadmin|"Safe" admin perms, no banning or reloading but unkick, exemption, data removal|

More to be added (shortcut.bypass - bypass about everything).

=Recommended=

The following plugins might be useful to have a look at.

CompatNoCheatPlus (cncp)

Make plugins like mcMMO, Citizens, MagicSpells or MachinaCraft more compatbile with NoCheatPlus. Not all existing plugins are covered (yet), but you can leave a note or ticket request for cncp.

Orebfuscator

Orebfuscator fights all sorts of X-ray-hacks by altering the map information that is sent to the players, such that they have to mine blocks to actually reveal what is behind. Virtually a "must have".

=下载和历史更新=

* 下载正式版本请前往 BukkitDev.
* Development builds have been moved over to the Jenkins at EcoCityCraft.
* 不要从任何其他来源下载，不要使用别人送你的插件.
* Changes by build number can be examined in the Jenkins changes list.
* All commits can be seen in the GitHub commit history.
* <s>Plugin statistics are no longer reported to mcstats.org.</s>

=Support=

==其他帮助==

* 你可以到: [https://github.com/asofold/NCPDocs/blob/master/FAQ.creole#faq Frequently asked Questions] 以及 [https://github.com/asofold/NCPDocs/blob/master/Known%20Issues.creole#known-issues Known Issues] 提问.
* [https://github.com/asofold/NCPDocs/blob/master/README.creole#ncpdocs Wiki] (配设文件, 权限介绍, 指令介绍)
* 开发者请查看NoCheatPlus的API.

==联系我们==
你有疑问可以到,
IRC联系我们 (IRC地址: irc.spi.gt | 默认Port: 6667 | SSL-Port: 6697 | Channel: #nocheat | Web client: WebIRC)
 
你可以创造一个提问票 [http://dev.bukkit.org/bukkit-plugins/nocheatplus/create-ticket/ new ticket] 或者查看已存在提问票 [http://dev.bukkit.org/server-mods/nocheatplus/tickets/ existing ticket].
 
你可以私聊原作者[http://dev.bukkit.org/home/send-private-message/ @asofold]和[http://dev.bukkit.org/home/send-private-message/ @MyPictures]，@IceAP (IRC: ICE)
 
请勿联系用户 'NoCheatPlus', 它仅用于管理，不会及时回复你的提问. 转移到 BukkitDev 和 GitHub 获取更多的帮助, 请勿相信BukkitDev以外的 NCP 管理人员 .

NoCheatPlus

2015-10-11T16:02:47Z

Lichi2050：/* Documentation Resources */

{{Bukkit Plugin Infobox
|插件名=NoCheatPlus
|版本=3.12.0-BETA2-sASO-b813
|前置插件=无
|兼容服务端版本=1.8.1
|網址=http://dev.bukkit.org/bukkit-plugins/nocheatplus/
}}
{{待翻译}}
'''Detect and fight the exploitation of various flaws/bugs in Minecraft!'''
[[Category:管理]] [[Category:修正]] [[Category:安全]]
=介绍=

NoCheatPlus试图通过禁止作弊客户端利用Minecraft或是它自身数据传递协议的漏洞, 来使得你的服务器更加安全可靠. 检测范围很广，包括飞行，加速，战斗 hacks, 快速破坏方块和 nukers, 背包 hacks, 聊天 spam and other types of malicious behaviour. For a more complete list have a look at the [https://github.com/asofold/NCPDocs/blob/master/Features.creole Features Page]（内容已搬至本页面，查看最新内容请点击链接）.

NoCheatPlus puts emphasis on configurability and allows you to customize actions that are carried out when a player fails a check (e.g. silent cancelling, executing commands, just logging). Bypass permissions allow to control what check to apply for which players, all checks can be deactivated in the configuration, also having the option for world-specific configuration files. Many checks allow more detailed configuration to adjust sensitivity.

Certainly NoCheatPlus is not a magical bullet, it uses a lot of heuristics and even guessing, so you will encounter false positives here and there and also not catch every single violation. [http://www.youtube.com/watch?v=H8BSpXfrtzI Example video] of how NoCheatPlus blocks cheats (outdated plugin version).

NoCheatPlus was introduced by [http://dev.bukkit.org/profiles/NeatMonster/ NeatMonster], building on the code base of [http://dev.bukkit.org/server-mods/nocheat/ NoCheat] by [http://dev.bukkit.org/profiles/Evenprime85/ Evenprime].
==功能==
* 玩家行动:
** 禁止飞行(生存/冒险模式下) 或是限制飞行速度(创造模式下)
** Enforce the original movement speeds for walking, sprinting, sneaking, swimming, blocking
** 禁止玩家无视掉落伤害
** 禁止玩家进入方块 (穿墙模式)
** 禁止玩家改变服务器时间
** Prevent players from using the "safe-respawn" exploit
** 禁止在水和岩浆顶部行走 [尽管现在的作弊者只是在其上保持跳跃]
** 禁止玩家通过非法移动使服务器崩溃 (CraftBukkit 自身并不包含检测模块,但有时这些移动数据会影响到插件.)
** Prevent players from faking BedLeave packets
** 禁止玩家悬浮在半空中
** 禁止玩家利用 "block jumping"来跳过高墙
** Prevent players from V-Clipping or teleporting
** 禁止玩家滥用钓竿来绕开飞行检测 (这只是一个玩笑...) [未测试! 默认关闭!]
** Prevent players from using their glide cheat 新!
** 禁止玩家滥用末影珍珠穿越墙，屋顶和地板新!
* 方块交互:
** 禁止玩家操作正常接触范围之外的方块
** 强制玩家看着想要操作的方块
** 禁止玩家透过墙对方块进行操作
** Prevent players from spamming interaction on blocks (note-blocks, doors, stone, wood, ...)
* 方块破坏:
** 防止玩家使用 "Survival Nuker", "Smasher", "Click Nuker" 与 "Creative Nuker"
** 防止以快于客户端允许的不正常速度破坏方块, 防止极快的同时破坏过多方块.
** 限制玩家可破坏方块的距离
** 强制玩家看着方块(破坏方块时，鼠标准星需对准方块)
** 防止 "noswing" 作弊 (玩家破坏方块时手臂没有动作)
** 禁止玩家同时破坏两个及以上的方块
** 禁止创造模式下的玩家破坏水或岩浆
* 方块放置:
** 防止玩家使用 "FastPlace" 和 "Build" 类作弊工具
** 限制玩家可放置方块的距离
** 强制对准方块
** 禁止玩家过快地投掷物品
** 禁止玩家在除了水和岩浆上的地方放置船只
** Prevent players from using the AutoSign feature of their client
** 禁止玩家在半空中放置方块.
** 禁止玩家在流体上放置方块
* 玩家聊天:
** 部分功能受Evenprime的插件启发.
** Fast spam check + tool-box for slower paced annoyances (can take into account a players chat history and global chat history).
** Limit the number of players allowed to join within a specific time frame
** 禁止短时间内多次重复登陆.
** Filter colors from player messages
** Supports text and command spam blocking
* 背包:
** Prevent players from dropping too many items within a short time frame and therefore lagging the server
** 禁止玩家过快地填充，发射弓箭
** 禁止玩家过快地进食
** Prevents players from managing there items to fast (inventory, enchantment table, beacon, ...)
** Prevents players from binding illegal enchantments on books (fixed in Minecraft 1.4.3 and higher)
* 战斗:
** 防止玩家同时攻击过多实体(玩家和怪物都算做实体)
** Prevent attacking of enemies that aren't in the line of sight of the player
** Prevent attacking without first swinging your arm
** 防止一秒内对生物攻击多次
** Prevent attacking of targets that are too far away
** Prevent players becoming invulnerable by exploitation of a design flaw of Minecraft
** Prevent players from knocking back other players when it's not technically possible
** Prevent players from exploiting extremely low jumps to get a pseudo criticals cheat going NEW!
** Prevent players from giving critical hits to other players when it's not technically possible
** Prevent players from hit other players while blocking with their sword
** Penalize players that change their direction by a lot (against force fields)
** Prevent players from doing self hits to fly by using the knockback of those
** Feed combined check to find players that try to execute 2 or more cheats at the same time
** 防止玩家过快地回复血量
* Miscellaneous:
** 禁用 Zombe's mod (飞行, noclip, 作弊)
** 禁用e CJB's mod (飞行, 透视, 雷达)
** 禁用 Rei's Minimap (洞穴, 雷达)
** 禁用 Minecraft AutoMap (ores, cave, radar)
** 禁用 Smart Moving (攀爬, 游泳, crawling, 滑行, 跳跃, 飞行)
** Restrict the OP management commands to a console usage only (disabled by default)
** Adapts to server sided lag for less false positives on heavy server load
** Provides a API that allows making other plugins compatible with NoCheatPlus
** Use of BukkitAPI only if the used CraftBukkit version is not supported

==配置==

=Configuration=

==General notes on .yml configuration files==
* Use spaces for indentation.
* Keep the indentation level: Never change the amount of white-spaces in front of options in the config file "config.yml".
* Don't insert special characters such as tabs for indentation. If you plan on complicated text entries, wrap them like '...' or "...".
* Refer to the default config file for reference.
* Use a [[http://yaml-online-parser.appspot.com/|YAML parser]] to make sure your configuration file is formatted properly.
* Inserting unsupported characters or changing indentation levels can break the configuration.
* For those that use Notepad++ to edit their YAML files we recommend to enable "Replace by space" in Settings -> Preferences -> Tab Settings \\
[[https://github.com/asofold/NCPDocs/blob/master/wiki/resources/Configuration/cResources.creole#notepad++|Screenshot of Notepad++ preferences]]

==特定世界的配置==
怎样创建一个特定世界的配置文件呢?（不同世界不同管理）:
#首先创建一个空的yml文件根据你的服务器世界的名称。例如：world_config.yml（_是必需的！一切都是很敏感的！）
# 在你的服务器安装NocheatPlus或运行 /重新安装NocheatPlus /如果已经在你的服务器运行请重载
# NoCheatPlus should now write every setting available for world specific configuration in that/those empty yaml files
# If you rather prefer to use some settings of your global config.yml then set "savebackconfig" to false and remove them from your world specific configuration file

* End result in your [[https://github.com/asofold/NCPDocs/blob/master/wiki/resources/Configuration/cResources.creole#world-specific-configuration|explorer window]] after successfully creating some world specific config.yml files
* Other examples: WorldName_config.yml, world_nether_config.yml, world_the_end_config.yml, HungerGames_config.yml or BackupWorld_config.yml

Notes:
* The world name is case sensitive (MiningWorld, theWorld etc.).
* You can set savebackconfig to false, in order to not have NoCheatPlus add default values to a config file. Thus you can override just the values you are interested in and keep a minimal world-specific configuration file.
* WorldName_config.yml has always higher priority then config.yml. So NoCheatPlus will first apply all settings from config.yml and then override them for a specific world using WorldName_config.yml
* Some settings can only be used in the global config.yml and aren't multiworld compatible (Please don't just copy config.yml and rename it to WorldName_config.yml or similar.)
* World specific files can be created, changed or removed while your server and NoCheatPlus are running. Just use the /ncp reload or /nocheatplus reload command to let NoCheatPlus reread your configuration file.
* If a world gets unloaded, deleted or renamed then NoCheatPlus will automaticly ignore your world specific configuration files you made for it

==Configversion==
Set {{{notify}}} to false to suppress the messages about outdated configurations. Only the main configuration file is checked at present.
\\The other entries are not meant to be changed by hand, they indicate with which version the config was created and last saved back.

==Logging==

Disable all logging with setting {{{active}}} to false.

Individual logging targets can be configured in the sub sections within {{{backends}}}:
* Set {{{active}}} to false to disable the individual backend.
* The {{{prefix}}} parameter allows to create a custom appearance for the log messages.
* File logging allows specifying a file name.
* For {{{ingamechat}}} you can force NoCheatPlus to check permissions subscriptions, if you use plugins that apply this technique to log to IRC and other for instance.

==Miscellaneous==
* Set {{{opinconsoleonly}}} to true to prevent op and deop commands from in-game chat. [Will be changed to a list of commands.]
* Set {{{managelisteners}}} to true to help us testing :) - this feature lets NCP register all its listeners inside of a ListenerManager that allows more intricate registration order than Bukkit. This is a "future feature" and is not needed, not even sure it improves performance.
* Set {{{reporttometrics}}} to false in order to disable reporting usage-stats to [[http://mcstats.org/plugin/NoCheatPlus|mcstats.org]] (PluginMetrics). Setting this to falss also prevents NoCheatplus from creating the PluginMetrics folder, however other plugins or Spigot could still create that folder.

==Data==
The data section allows you to specify an expiration duration for players data in minutes. If set to something greater than 0, this will periodically remove players data if the players have been logged out for longer than the specified amount of minutes. At present this would also delete set-back locations and current violation levels, if activated, so it should not be set to a too short duration.

**expiration**
|**Config**|**Description**|**Default**|
|**duration**|Duration in minutes after logout, after which data gets erased.|0|
|**history**|Should the players violation history also be deleted?|false|

**consistencychecks**
You can suppress consistency check warnings here and alter intervals for periodic checking (usually not needed).

==Protection==
===Plugins===
Features for this and other plugins.
====Hide====
This section contains configuration for hiding (some of) your plugins better. You can prevent help-contents display and command usage by setting permissions with a permissions plugin, if the command has a default permission set, but NoCheatPlus allows to set the permission message of some commands, which would otherwise reveal the presence of the command/plugin. So the permission message for some commands can be changed to the "Unknown command" message to hide the presence. You do need to also set the aliases of the commands, use lower case rather.
\\This feature allows to change command permissions to not be given by default or add a generic filter permission nocheatplus.filter.command.//(commandname)// to a command that does not have one set yet, the following settings allow configuring lists of commands and the message:
\\**"nopermission":**\\
Display the "no permission" message, default to "plugins" and "version" commands, useful for instance if a plugin does not set a permission for a command.
\\**"unknowncommand":**\\
Display the "unknown command" message, empty by default. This can be used to hide a command from users that don't have the default permission (or the filter permission added by NCP if none was set).

\\TODO: Link docs on how to configure help topics and other.
===Clients===
Features that concern client mods.
Set the {{{active}}} flag to false in the {{{motd}}} section to prevent NoCheatPlus sending any "blank lines" messages to clients on login. Otherwise blank lines can result disregarding if all clients are allowed or not, because some clients use a message to enable features, some need a message to disable features.
\\Note that it is 100% up to the client to decide on enabling or disabling features, a modified version of any client may ignore any sent messages, without that being detectable.

==Configuration of checks==
The checks section contains configuration mostly for checks related to players actions, most can generate violation log messages (few exceptions).

===Checks overview===

See: [[checks/checks.creole|Checks Overview]]

Shortcut links:
\\|
[[checks/blockbreak/blockbreak.creole|blockbreak]] |
[[checks/blockinteract/blockinteract.creole|blockinteract]] |
[[checks/blockplace/blockplace.creole|blockplace]] |
[[checks/chat/chat.creole|chat]] |
[[checks/combined/combined.creole|combined]] |
[[checks/fight/fight.creole|fight]] |
[[checks/inventory/inventory.creole|inventory]] |
[[checks/moving/moving.creole|moving]] |

==Strings section==
This is the section that defines various strings for "log" or "cmd" actions. Each has a name (the part in front of ":") and a definition (the part behind the ":"). Whenever you use a "log" or "cmd" action in one of the "actions: " options of this config file, the string will be taken from this section. Arbitrary many additional strings may be defined here, or existing strings may be changed.
\\ \\
Most messages/commands use place-holders in [ ], which will be replaced at runtime with relevant information. Some of these may only be available in certain circumstances, only "[player]" can be used everywhere, especially in "cmd" actions.|
\\

==Compatibility section==
This section allows to configure details for the case of compatibility issues, for instance with other server mods or custom blocks.

[[compatibility/compatibility.creole|compatibility page]]

==Bleeding Edge: Development builds==
To allow you to keep track with the configuration and permission changes in the latest development versions, we have a simple page set up: **[[../development/dev-pinboard.creole|Development Pinboard]]**
\\
For quick overview over recent builds, see: [[../development/build-infos.creole|Important Changes By Build Number]]
==命令==
=Commands=

NoCheatPlus integrates a lightweight command system. It allows you to quickly exempt players from checks or to access and manage check data about a player.

All commands support tab completion and some even allow shortcuts. The root command is named "nocheatplus", however the alias "ncp" should also work and is used for reference here.

NoCheatPlus also supports aliases from Bukkit [[http://wiki.bukkit.org/Bukkit.yml#aliases|BukkitAliases]] if you wish to have another alias command aside form "nocheatplus" and "ncp".

==Permissions==
Root node for commands:
* **NoCheatPlus 3.10.2** and above: {{{nocheatplus.commands}}}
* //NoCheatPlus 3.10.1// and below: {{{nocheatplus.admin}}}

You can give a player access to a specific command by giving them the sub-node with the commands default name, like {{{nocheatplus.admin.info}}}.
For further information about permissions in NoCheatPlus, we recommend looking at the [[../permissions/permissions.creole|Permissions docs]].

==Administrative commands==
Those commands are used to basically manage NoCheatPlus on your server.
**Arguments in () are needed, while arguments in [] are optional.**
|=Commands|=Explanation|
|/ncp reload| Reloads, generates and regenerates the configuration file of NoCheatPlus. Run this in-case you changed something on your configuration file while your server was running.|
|/ncp notify on/off| Toggle all in-game notifications/alerts generated by NoCheatPlus.|
|/ncp info (player)| Display the violation levels of a given player.|
|/ncp lag| Show info about server sided latency. The average lag shows the percentage of the server running too slow (0% = 20 tps, 10% = 18 tps) for the last 1 second, 3.33 and 270 seconds, roughly. Also lag spikes are displayed, tracked over at most 1 hour with a resolution of 20 minutes buckets (i.e. not exact) for spikes > 150 ms (3x to 20x) and spikes > 1000 ms (20x +). Be aware that this information is needed to make most NoCheatPlus checks adapt to server sided lag.|
|/ncp removeplayer (player) [check_type]| Remove all the data collected by NoCheatPlus so far for a given player. You can use the [check_type] option to make NoCheatPlus only remove data from a specific check (Default will clean all data of all checks!). To list all check names execute a command such as this: /ncp removeplayer (PlayerName) list. "*" is supported here.
|/ncp exempt (player) [check_type]| Exempt a player from being checked by NoCheatPlus or by a specific check.|
|/ncp unexempt (player) [check_type]| Remove any exemption you given to a specified player. "*" Is supported here.|
|/ncp exemptions (player)| Gives back a list of all check that a specific player has been exempted from.|
|/ncp commands| List all commands, more than shown here. The other commands are mainly for use with actions, such as delaying other commands, kicking with a message, telling players messages in colour, deny login for a players, allow it again and other.|
|/ncp version| Show version information about the server, plugin, compatibility modules and registered hooks.|

==Auxiliary commands==
Those commands are mainly used by NoCheatPlut itself to execute strings or commands over actions on violating players but you can also make use of them if you wish to do so. Most of them have no difference compared to the vanilla commands apart from the delay otion.
**Arguments in () are needed, while arguments in [] are optional.**
|=Commands|=Explanation|
|/ncp ban [delay=(ticks)] (player) [reason]|Ban a player from your server (banned-players.txt).|
|/ncp kick [delay=(ticks)] (player) [reason]|Kicks a player from your server|
|/ncp unkick (player)|Allows you to remove a tempkick/tempban from a player. "*" is supported here.|
|/ncp kicklist|Lists all players that have been tempkicked/tempbanned on your server by NoCheatPlus actions.|
|/ncp tell [delay=(ticks)] (player) (message)|Send a private message to a specified player.|
|/ncp delay [delay=(ticks)] (command)|Execute a command in delayed time.|
==权限==

**This page describes permissions for NoCheatPlus 3.10.2 and above,**
\\**NoCheatPlus 3.10.2-RC-sMD5NET-b620 adds new permissions for commands and new short-cut permissions, updates following soon.**
\\//For older versions see the [[permissions-3-10-1.creole|permissions page for 3.10.1 and below.]]//

NoCheatPlus supports "SuperPerms", CraftBukkit's official permission framework. You'll need to use a permissions plugin that supports "SuperPerms" to manage all the permissions of NoCheatPlus. Here are some examples:

* PermissionsEx
* bPermissions
* Essentials GroupManager
* Privileges
* zPermissions

By default NoCheatPlus assigns all permissions and gives full rights to players that have been /op-ed on your server. If you don't want to give OPs full access to all NoCheatPlus features then take a look in the configuration of your permissions plugin (Example with PermissionsEx: allowOps: false).\\\\
==Notifications==
|nocheatplus.notify|The player will receive notifications through the in-game chat of players failing NoCheatPlus checks. .|
If you want moderators to be able to toggle notifications, just give the permission nocheatplus.command.notify, which will also give this one then. Mind the ".silent" permission for individual checks permissions (explained on the bottom of this page).

==Administration==
|{{{nocheatplus.admin}}}|Shortcut permission for all administrative commands including ban (do not give lightly). See nocheatplus.shortcut permissions for faster setup for moderators.|
===Debug===
|nocheatplus.admin.debug|Owners of this node will receive debug messages of checks if NoCheatPlus debugging is turned on.|
==命令权限==
|nocheatplus.command.notify|Allow toggling notifications and also to receive them (nocheatplus.notify is included here).|
|nocheatplus.command.info|The player gets access to "/ncp info", which displays all violations that a player has gotten (if any).|
|nocheatplus.command.lag|Gives access to "/ncp lag" which shows informations about your server latency (NoCheatPlus uses this informations to adapt some checks for serversided latency).|
|nocheatplus.command.reload|The player gets access to "/ncp reload", which causes NoCheatPlus to reread its configuration files (This doesn't clear NoCheatPlus data or exemptions!).|
|nocheatplus.command.plugins|Allows the player to execute the "/plugins" or "/pl" command from CraftBukkit (//protectplugins// has be set to true in the configuration file).|
|nocheatplus.command.version|Owners of this node can execute the "/version" or "/ver" command from CraftBukkit (//protectplugins// has be set to true in the configuration file).|
|nocheatplus.command.exemptions|Gives access to execute "/ncp exemptions" which list all exemptions for an specified player (Those exemptions will get reset after every reload/restart! For permanent exemptions use the check permissions!).|
|nocheatplus.command.exempt|Gives access to the "/ncp exempt" command which allows to temporary exempt players for either all (ALL) or specified checks only.|
|nocheatplus.command.unexempt|Allows to unexempt players from checks by using the "/ncp unexempt" command.|
|nocheatplus.command.removeplayer|Gives access to execute "/ncp removeplayer", which causes NoCheatPlus to wipe/clear specified or all collected data from a player including violations and temporary stored check data (This wont wipe exemptions!).|
|nocheatplus.command.commands|Allows the player to use the "/ncp" command which lists all NoCheatPlus commands.|
|nocheatplus.command.ban|Gives permissions to use "/ncp ban" which bans a player on your server.|
|nocheatplus.command.kick|Gives access to "/ncp kick" which kicks a player from your server.|
|nocheatplus.command.tell|Gives access to "/ncp tell" which allows whispering something to a specified player.|
|nocheatplus.command.delay|Gives permissions to use the "/ncp delay" command which has the ability to run a specified command with delayed time execution time.|
|nocheatplus.command.tempkick|Allows the player to tempkick/tempban someone from the server using "/ncp tempkick".|
|nocheatplus.command.kicklist|Gives access to the "/ncp kicklist" command which lists all players that got "tempkicked/tempbanned" from NoCheatplus by either using actions or "/ncp tempkick".|
|nocheatplus.command.unkick|Gives access to remove a tempkick/tempban from a player using "/ncp unkick".|

==Filter permissions (plugin hiding)==
|nocheatplus.filter.command.(commandname)|Allows to use a command protected by command protection, only for the case the command did not have a permission set. Note that (commandname) is just the lower-case command label. In case of incompatibilities of your permission plugin you might have to add nocheatplus.filter.command.nocheatplus to players that are to use /ncp ... commands.|
==Bypass==
Specific bypass permissions.
|nocheatplus.bypass.denylogin|Allows to bypass the login denial, such as exists with the /ncp tempkick command.|
==Checks==
Check permissions, directly related to players actions and associated checks.
|nocheatplus.checks|Parent permission for all checks. TODO: Overview for "full" exemption by permissions (might need few additional permissions?).|
===BlockBreak===
|nocheatplus.checks.blockbreak|Parent permission for the blockbreak checks.|
|nocheatplus.checks.blockbreak.direction|Don't force the player to look at the blocks that he/she wants to break.|
|nocheatplus.checks.blockbreak.fastbreak|Allows the player to break blocks very quickly.|
|nocheatplus.checks.blockbreak.frequency|Allows the player to break 2 or more blocks at the same time.|
|nocheatplus.checks.blockbreak.noswing|Don't force players to swing their arm when breaking blocks.|
|nocheatplus.checks.blockbreak.reach|Allows breaking of blocks that are out of reach distance.|
|nocheatplus.checks.blockbreak.wrongblock|Don't force the player to interact with the block first before he/she is allowed break it (interacting=touching).|
|nocheatplus.checks.blockbreak.break.liquid|Allows the player to break liquids such as water or lava (source blocks) by using a hack in creative gamemode.|
===BlockInteract===
|nocheatplus.checks.blockinteract|Parent permission for this check section.|
|nocheatplus.checks.blockinteract.direction|Don't force the player to look at the blocks that he/she is trying to interact with (levers, doors and other).|
|nocheatplus.checks.blockinteract.reach|Allows the player to interact with blocks that are further away than usual.|
|nocheatplus.checks.blockinteract.speed|Allows the player to spam interaction on blocks such as levers, note blocks, doors and other.|
|nocheatplus.checks.blockinteract.visible|Everyone that owns this node is allowed to interact through walls to open a chest, furnace and other container without actually seeing them (also prevents from entering a minecart, bed or boat through walls).|
===BlockPlace===
|nocheatplus.checks.blockplace|...|
|nocheatplus.checks.blockplace.direction|Don't force the player to look at the block that he/she is trying to place on.|
|nocheatplus.checks.blockplace.boatsanywhere|Allows the player to place boats everywhere and not only in the water.|
|nocheatplus.checks.blockplace.fastplace|Allows the player to place blocks very quickly.|
|nocheatplus.checks.blockplace.noswing|Don't force players to swing their arm when placing a block.|
|nocheatplus.checks.blockplace.reach|Allows the player to place blocks that are too far away.|
|nocheatplus.checks.blockplace.speed|Allows a player to throw projectiles very quickly (snowballs, splash potions and other).|
|nocheatplus.checks.blockplace.against.liquids|Having this permission assigned allows to place block against liquids by using a special hack.|
|nocheatplus.checks.blockplace.against.air|This permission allows a player to place blocks against air.|
===Chat===
|nocheatplus.checks.chat|...|
|nocheatplus.checks.chat.color|Don't filter color codes from messages that get sent by players to allow them using colors in their messages. However nearly every chat plugin will override this.|
|nocheatplus.checks.chat.text|Allows the player to bypass the chat spam check for written text.|
|nocheatplus.checks.chat.commands|Allow players to bypass the command frequency check that protects against command spam.|
|nocheatplus.checks.chat.captcha|Owners of this permission wont be forced to type in a captcha if they fail one of the chat checks (this feature is disabled by default).|
|nocheatplus.checks.chat.relog|Every player that has this permission is allowed to completely bypass the re-log check of NoCheatPlus.|
|nocheatplus.checks.chat.logins|Allows the player to bypass the login check which prevents too many players loging in at the same time.|
===Combined===
|nocheatplus.checks.combined|Parent permission for the combined check group.|
|nocheatplus.checks.combined.improbable|Allows the player to bypass the Combined_Improbable check which fights against kill-auras ,speed hacks and some other combined hacks also. It also prevents the player from using 2 or more hacks at the same time.|
|nocheatplus.checks.combined.bedleave|Allows the player to send bed leave packets from anywhere (can be exploited to confuse some other checks of NoCheatPlus).|
|nocheatplus.checks.combined.munchhausen|Players with this node might be able to use fishing roods for flying (Check is disabled by default in configuration).|
===Fight===
|nocheatplus.checks.fight|Fight check group.|
|nocheatplus.checks.fight.angle|Don't prevent the player from attacking multiple entities at the time.|
|nocheatplus.checks.fight.critical|Don't prevent the player from doing fake critical hits when it's technically not possible to do so.|
|nocheatplus.checks.fight.direction|Don't force the player to look at the targets while fighting them.|
|nocheatplus.checks.fight.godmode|Don't prevent the player from keeping the temporary invulnerability that he/she gets when taking damage.|
|nocheatplus.checks.fight.fastheal|The owner of this node is allowed to regenerate health faster then usually possible.|
|nocheatplus.checks.fight.knockback|Don't prevent the player from doing knockbacks when it's technically not possible to do so.|
|nocheatplus.checks.fight.noswing|Don't force the player to move the arm while fighting against someone or something.|
|nocheatplus.checks.fight.reach|Allows the player to hit players and mobs that are out of allowed distance.|
|nocheatplus.checks.fight.selfhit|Allows the player to do self hits for flying by exploiting the knockback of those hits.|
|nocheatplus.checks.fight.speed|Don't limit the amount of attacks that the player can do per second.|
===Inventory===
|nocheatplus.checks.inventory|Inventory check group.|
|nocheatplus.checks.inventory.drop|Don't limit the amount of items that a player may drop within a short timeframe.|
|nocheatplus.checks.inventory.instantbow|Don't prevent the player from shooting arrows instantly over the bow without taking the usual time to pull the string back.|
|nocheatplus.checks.inventory.instanteat|Don't prevent players from eating their food instantly without taking the usual time to munch on it.|
|nocheatplus.checks.inventory.fastclick|Allows the player to move items around the inventory instantly without using there mouse/keyboard to do so.|
|nocheatplus.checks.inventory.items|Allows the player to use illegal enchantments on signed books (This got fixed now in Minecraft 1.4.3 and higher).|
===Moving===
|nocheatplus.checks.moving|Parent permission for the moving checks group.|
|nocheatplus.checks.moving.creativefly|Allows the player to fly faster in creative mode then usually possible.|
|nocheatplus.checks.moving.morepackets|Allow the player to make a lot more movements than normally possible. Doing more movements will result in faster movement speed and causes the server to spend a lot of additional time for processing these movements.|
|nocheatplus.checks.moving.morepacketsvehicle|Allows players to make a lot more movements in vehicles (boats, minecrats, pigs, ...) than normally possible.|
|nocheatplus.checks.moving.nofall|Allows the player to avoid fall damage by using cheats. Normally NoCheatPlus will keep track of a player's movement and rectify the fall-damage calculations of Minecraft so the player always gets the fall damage he/she is supposed to get.|
|nocheatplus.checks.moving.survivalfly|Allows the player to fly in survival mode. It also treats the player as if he has the ".nofall" permission too.|
|nocheatplus.checks.moving.survivalfly.blocking|Allows the player to block while moving at normal speed.|
|nocheatplus.checks.moving.survivalfly.sneaking|Allows the player to sneak while moving at normal speed.|
|nocheatplus.checks.moving.survivalfly.sprinting|Allows the player to sprint backwards.|
|nocheatplus.checks.moving.survivalfly.speeding|Allows the player to bypass the vanilla walk/run/sprint speed limits.|
|nocheatplus.checks.moving.survivalfly.step|Don't check if the player is using the step hack to get faster over blocks then usually possible.|
==Modifications==
These permissions allow to control which feature/mod a player may use. There is no guarantee that players use the original client and obey the request to turn off/on features, though.
===CJB===
|nocheatplus.mods.cjb|All CJB features.|
|nocheatplus.mods.cjb.fly|Don't prevent the player from using CJB's fly mod on the server.|
|nocheatplus.mods.cjb.radar|Gives access to use CJB's radar mod on the server.|
|nocheatplus.mods.cjb.xray|Don't prevent the player from using CJB's xray mod on the server.|
===MinecraftAutoMap===
|nocheatplus.mods.minecraftautomap|All features for MinecraftAutoMap.|
|nocheatplus.mods.minecraftautomap.ores|Don't prevent the player from using the ore detector from Minecraft AutoMap's.|
|nocheatplus.mods.minecraftautomap.cave|Don't prevent the player from using the cave mode feature of the Minecraft AutoMap's mod.|
|nocheatplus.mods.minecraftautomap.radar|Don't prevent the player from using Minecraft AutoMap's inbuilt radar.|
===Rei===
|nocheatplus.mods.rei.cave|Don't prevent the player from using Rei's Minimap's cave mode.|
|nocheatplus.mods.rei.radar|Don't prevent Rei's Minimap mod users from using all kind of available radar hacks.|
|nocheatplus.mods.rei.radar.player|Allows the player to use the radar from Rei's Minimap to track down other players only.|
|nocheatplus.mods.rei.radar.animal|Allows the player to only use the animal radar from Rei's Minimap mod.|
|nocheatplus.mods.rei.radar.mob|Gives access to use the mob radar feature from Rei's Minimap mod.|
|nocheatplus.mods.rei.radar.slime|Allows the player to track down slimes only by using the radar feature of Rei's Minimap.|
|nocheatplus.mods.rei.radar.squid|Player is allowed to use the Rei's Minimap radar to track down squids only.|
|nocheatplus.mods.rei.radar.other|Allows the player to use all the other features of the Rei's Minimap radar.|
===SmartMoving===
|nocheatplus.mods.smartmoving|All SmartMoving features.|
|nocheatplus.mods.smartmoving.climbing|Don't prevent the player from using Smart Moving's climb feature.|
|nocheatplus.mods.smartmoving.swimming|Don't prevent the player from using Smart Moving's swimming.|
|nocheatplus.mods.smartmoving.crawling|Don't prevent the player from using Smart Moving's crawl.|
|nocheatplus.mods.smartmoving.sliding|Don't prevent the player from using Smart Moving's slide.|
|nocheatplus.mods.smartmoving.jumping|Don't prevent the player from using Smart Moving's jump.|
|nocheatplus.mods.smartmoving.flying|Don't prevent the player from using Smart Moving's fly.|
===Zombe===
|nocheatplus.mods.zombe|All zombe features.|
|nocheatplus.mods.zombe.fly|Don't prevent the player from using Zombe's fly mod.|
|nocheatplus.mods.zombe.noclip|Don't prevent the player from using Zombe's noclip mod on the server.|
|nocheatplus.mods.zombe.cheat|Don't prevent the player from using Zombe's cheat mods.|\\
== Parent Nodes ==
Most permissions have parent nodes, that in fact goes for all check types. Resulting in nocheatplus.admin, nocheatplus.checks.moving, nocheatplus.checks.moving.survivalfly, nocheatplus.checks.fight, etc.
=== Things to know about Permissions ===
You can exclude a specific player from getting logged by appending ".silent" to the relevant permission node of the specific check. E.g.\\

* **nocheatplus.checks.moving.nofall.silent**\\

will prevent NoCheatPlus from recording log messages for that player for the "nofall" check, while still executing all other actions as usual.
==Shortcut permissions==
|nocheatplus.admin| see above (full admin perms except check bypassing).|
|nocheatplus.shortcut.info|info about players|
|nocheatplus.shortcut.monitor|info about players and diagnostic info like version, lag,|
|nocheatplus.shortcut.safeadmin|"Safe" admin perms, no banning or reloading but unkick, exemption, data removal|

More to be added (shortcut.bypass - bypass about everything).

=Recommended=

The following plugins might be useful to have a look at.

CompatNoCheatPlus (cncp)

Make plugins like mcMMO, Citizens, MagicSpells or MachinaCraft more compatbile with NoCheatPlus. Not all existing plugins are covered (yet), but you can leave a note or ticket request for cncp.

Orebfuscator

Orebfuscator fights all sorts of X-ray-hacks by altering the map information that is sent to the players, such that they have to mine blocks to actually reveal what is behind. Virtually a "must have".

=下载和历史更新=

* 下载正式版本请前往 BukkitDev.
* Development builds have been moved over to the Jenkins at EcoCityCraft.
* 不要从任何其他来源下载，不要使用别人送你的插件.
* Changes by build number can be examined in the Jenkins changes list.
* All commits can be seen in the GitHub commit history.
* <s>Plugin statistics are no longer reported to mcstats.org.</s>

=Support=

==其他帮助==

* 你可以到: [https://github.com/asofold/NCPDocs/blob/master/FAQ.creole#faq Frequently asked Questions] 以及 [https://github.com/asofold/NCPDocs/blob/master/Known%20Issues.creole#known-issues Known Issues] 提问.
* [https://github.com/asofold/NCPDocs/blob/master/README.creole#ncpdocs Wiki] (配设文件, 权限介绍, 指令介绍)
* 开发者请查看NoCheatPlus的API.

==Contact us==

AutoMessage

2015-10-10T18:08:09Z

Lichi2050：/* Extra */

[[Category:聊天]]
[[Category:信息]]
==综述==
===介绍===
AutoMessage是一个易于使用的聊天栏公告插件。
这个插件非常适合那些想要将一些设定的信息以广播形式发布的服务器管理员们。
这个插件的特性在于，你可以在游戏中使用命令编辑一切可以在配置文件中修改的配置项。
这是一个轻量级的插件，并不会影响服务器的性能。
AutoMessages会自动检测更新以确保插件处于最新版本。

===特性===
完全可自定义的配置系统!
游戏中功能多样的配置编辑器!
快速无损的重载机制.
可选的随机公告.
支持颜色代码.
在信息中运行命令.

===安装===
将jar文件拖入plugins文件夹并重启服务端即可.

==常见问题及解答==
Q:为什么我使用"/am add 公告"添加了一个叫"公告"的组后，显示的信息十分杂乱？

A:新的分组后会内置一些默认的公告内容，只需连续执行命令"/am remove 公告 0"删除公告组内序号为0的公告内容连续5次即可删除默认信息。

Q：为什么玩家看不见公告？

A：你需要把权限节点：automessage.receive.default添加进玩家组里面，default为默认组，详细请看下面的权限一栏。

==权限==
AutoMessage uses permissions to allow selective users or groups access to specific commands. The permissions are compatible with any permissions plugin that implements Bukkit's SuperPerms such as PermissionsEx or bPermissions. Below you will find a list of all available permissions.

automessage.commands.reload:

Reload the configuration from the disk. ；重载配置权限

automessage.commands.update:

Update to the latest version if the plugin is out of date.；升级插件

automessage.commands.add:

Create a new message list or add message to an existing message list.；添加新的公告

automessage.commands.edit:

Edit a message in a message list. ；更改公告

automessage.commands.remove:

Remove a message list or remove a single message from a specific message list.；移除公告

automessage.commands.enabled:

Toggle broadcasting for a specific message list. The message list can still be edited; however, it
will not broadcast.；开关公告

automessage.commands.interval:

Set the interval at which messages are broadcasted from the message-list. ；设置公告间隔

automessage.commands.random:

Set a lists broadcast method. Random randomly selects a message on broadcasts whereas non-random
simply loops through all the messages.；设置公告方式

automessage.commands.prefix:

Set a message lists prefix for all broadcasts. ；设置公告前缀

automessage.commands.suffix:

Set a message lists suffix for all broadcasts. ；设置公告后缀

automessage.commands.broadcast:

Broadcast a message from a specific list. ；公告列表里的一条消息

automessage.commands.list:

List all message lists or all messages in a specific list. ；查看所有公告

automessage.receive.message-list:

Receive broadcasts from a list. Replace message-list with the name of the message list in your config. ；接收来自某列表的公告

==命令==
==配置==
Config:
settings:
enabled: true ；是否启用 true为是，false为否(下面也是这样)
min-players: 5 ；最小听见广播的玩家数量？我的理解应该是当有这个数值的玩家或以上在线时才开始播放这个公告
log-to-console: true ；是否显示在控制台
message-lists: ；公告列表
regular: ；公告列表的名字
enabled: true ；是否启用
random: false ；是否随机
interval: 45 ；间隔时间
expiry: -1 ；到期时间(-1为不会到期
messages: ；公告内容
- '&1First&r message \nin the default list!'
- '&2Second&r message \nin the default list!'
- '&3Third&r message \nin the default list!'
- 'These messages will be displayed to users with \nautomessage.receive.default!'
json: ；又是一个公告列表的名字下面的内容和上面的一样
enabled: true
random: false
interval: 45
expiry: -1
messages:
- '{text:"Hover over me!",hoverEvent:{action:show_text,value:[{text:"Woah, you just hovered over me!",color:blue}]}}'
- '{text:"Click me to run a command!",clickEvent:{action:run_command,value:"/say Clicked."}}'
- '{text:"Click me to open Google!",clickEvent:{action:open_url,value:"http://google.com"}}'

==其他==
'''代码:''' 
配设文件内可以添加变量，颜色以及指令等. 如果你的信息前面加入 / 系统会默认为是一条指令. 如果你编辑时想换行请输入 \n. 颜色代码可以随时加入. 同时也可以添加变量. 这些设定会美化你的信息/公告。 
 

'''变量列表'''
{| class="wikitable"
|-
! 变量 !! 列子 !! 效果
|-
| {NAME} || Hey {NAME} || Hey ELCHILEN0!
ELCHILEN0是原作者ID
|-
| {DISPLAYNAME} || Hey {DISPLAYNAME}! || Hey ELCHILEN0!
|-
| {WORLD} || 你在{WORLD}! || 你在XX世界!
|-
| {BIOME} || 你在{BIOME}生物群系! || 你在XX生物群系!
|-
| {ONLINE} || 目前有{ONLINE}玩家在线! || 目前有XX玩家在线!
|-
| {MAX_ONLINE} || 服务器最大人数{MAX_ONLINE}! || 服务器最大人数XX!
|-
| {YEAR} || 今年是{YEAR}年! || 今年是XX年!
|-
| {MONTH} || 现在是{MONTH}月! || 现在是XX月!
|-
| {WEEK_OF_MONTH} || 本月第{WEEK_OF_MONTH}个星期! || 本月第XX个星期!
|-
| {WEEK_OF_YEAR} || 今年第{WEEK_OF_YEAR}个星期! || 今年第XX个星期!
|-
| {DAY_OF_WEEK} || 这个星期已经过了{DAY_OF_WEEK}天! || 这个星期已经过了XX天!
|-
| {DAY_OF_MONTH} || 这个月已经过了{DAY_OF_MONTH}天! || 这个月已经过了XX天!
|-
| {DAY_OF_YEAR} || 今年已经过了{DAY_OF_MONTH}天! || 今年已经过了XX天!
|-
| {HOUR} || 现在是{HOUR}点 || 现在是XX点
|-
| {HOUR_OF_DAY} || It is {HOUR_OF_DAY} hundred hours! || It is XX hundred hours!
|-
| {MINUTE} || 已经过了{MINUTE}分钟! || 已经过了XX分钟!
|-
| {SECOND} || 已经过了{MINUTE}秒! || 已经过了XX秒!
|-
|}
 
'''颜色代码''' 

==GitHub Repo==
==Scheduled Messages Ideas==

Multiworld

2015-10-10T17:30:20Z

Lichi2050：

{{待翻译}}
{{Bukkit Plugin Infobox
|插件名=Multiworld
|版本=v5.2.5
|前置插件=无
|兼容服务端版本=1.7.9 r0.2
|網址=http://dev.bukkit.org/bukkit-plugins/multiworld-v-2-0/
}}

=概述=
使用Multiworld插件，可以很容易地自定义每个世界对应的末地与下界，你可以随意配置。(受限于插件可实现的功能范围)
==历史==
我制作这个插件是因为该插件的原作者"Baummann"，现在不再活跃。之前，这个插件非常简易，只有两个命令: /goto and /newworld. 于是我接过这个项目并且开发出更好的版本。现在Multiworld已经更新到v5.2.5。
==特性==
自定义世界类型，例如沙子世界
支持修改玩家进入世界时的游戏模式
支持使用/mw move以及/mw goto指令于指定地点之间传送，就像在minecraft服务器使用/teleport指令一样
支持独立世界聊天频道

=命令与权限=
请求:本条目需要创建表格，成员请帮助编辑排版。

世界命令
命令描述权限
====世界====
/mw create <世界名称> [世界类型] [世界种子] 在数据库中创建一个新的世界.
注意: 你也可以使用这个命令来添加已存在的世界.
警告: 不要给你不信任的人这个权限，如果拥有这个权限，他将可以无限地创建世界! multiworld.command.create
/mw load <世界名称> 加载数据库中的世界 multiworld.command.load
/mw unload <世界名称> 卸载数据库中的世界(并非删除)，其他插件将无法查看到该世界 multiworld.command.unload
/mw delete <世界名称> 删除数据库中的世界.
警告: 这个功能是移除multiworld设置里面已经定义的一个世界! multiworld.command.delete
/mw list 列出服务器中已经生成地形的世界. multiworld.command.list
/mw info 显示当前世界的信息 multiworld.command.info
/mw listgens 列出可用的世界地形类型，辅助使用/mw create. multiworld.command.listgens
====规则====
/mw listflagsList 列出所有可能使用于标记值的选项在/mw setflag 指令内. commands.multiworld.command.flags
/mw setflag <世界名称> <标记值> <变量> 于指定世界内设置一个标记值或选项. multiworld.command.setflag
/mw getflag <世界名称> <标记值> 获取标记值在指定世界, 世界名称填写 * 则可以获取全部世界 flags.multiworld.command.getflag
====传送门====
/mw link <源世界> <目标世界> 连接 <源世界> 世界的地狱门到 <目标世界> 世界的地狱门.
提示，使用这个功能需要开启地狱门连接权限! multiworld.command.link.nether
/mw link-end <源世界> <目标世界> 连接全部未界传送门由 <源世界> 至 <目标世界>.
提示，使用这个功能需要开启未地传送门连接权限! multiworld.command.link.end
====传送====
/mw goto <世界名称> 将你自己传送到此世界, 这个指令也能够使用简写/goto <世界名称> multiworld.command.goto
/mw move <玩家名称> <世界名称> 移动指定玩家至一个世界 multiworld.command.move
====出生点====
/mw spawn传送到所在世界的出生点, 移动其他人需要用 /mw move.multiworld.command.spawn
/mw setspawn设置所在世界的出生点, 你可以使用这个命令来修正出生点。 pointmultiworld.command.setspawn
====插件基础命令====
/mw save保存插件数据multiworld.command.save
/mw reload重新加载插件数据multiworld.command.reload
/mw debug显示调试信息，这些将会在你碰到插件错误（报告）时非常有用multiworld.command.debug
/mw help显示帮助，这样你就不用每次来看这个网页了multiworld.command.help
/mw eastereggNot a real command, but there is a easter egg hidden in multiworld-（这个命令比较有趣和无用，故不作翻译。你可以尝试下提示：复活节彩蛋）

====其他====
-如果想要使他人在进入一个世界后转为创造模式. 建议给所有人这个权限.multiworld.creativemode
-Gives access to the basic Multiworld moderator controll, this permission won't allow users to modefy settings of existing world, it only allows them to view the settings / teleport to worldsmultiworld.basic
-你可以使用这个权限来给予一个人关于这个插件的所有权限.Multiworld.admin

=可选的特性=
特性 NameDescriptionConfiguration 的位置
给予 worldoptions.useEndPortalHandler 权限，未地传送门管理器则允许你自定义一个未地传送门
下界传送门管理器，这个管理器可能使下界传送门重新定义到一个自定义的地狱世界，这个配置在 worldoptions.usePortalHandler
WorldChatSeperatorThis allows you to use the RecieveChat and the SendChat flags on a worldoptions.useWorldChatSeperator
GamemodeChangerThis allows you to use the flag CreativeWorld to turn on creative mode for a world, to use this you need to give you users the following permissions on all worlds: multiworld.creativemode
This module also comes with a other configuration settings, when you turn off usecreativemodeinv, it ONLY handles the gamemode part, it won't change the inventory contents, this can be used if you have a custom plugin for per world inventories.options.usecreativemode
EnderBlockPrevents the use of ender chests in creative mode, this can be used to prevent people from cheating stuff by storing it inside a ender chest in a creative world, and then removing it in a survival world.options.blockEnderChestInCrea
WorldSpawnHandlerThis allows you to have custom respawn worlds per world group, this can be setup by turning this part on to generate the configuration needed for this.options.useWorldSpawnHandler
CraftbukkitHooksAllows multiworld to hook into craftbukkit to display information that the bukit api won't provide. This feature will try to turn itself off when there are any errors.options.craftbukkitHooks

=Multiworld数据格式=
Multiworld是使用statistcs代码，以便统计使用数据，想要进一步了解请查看:
Usage statistics at v3.5.0

=向您的服务器推荐其他插件=
[[LocationTeleport]] - 在自定义区域内创造传送点 

[[hothgenerator]] - 生成一个满是冰雪的世界。
/mw create WorldName plugin:HothGenerator 

[[multiinv]] - 控制多世界背包，分隔每个世界的物品栏。

Multiworld

2015-10-10T17:22:51Z

Lichi2050：小修改

{{待翻译}}
{{Bukkit Plugin Infobox
|插件名=Multiworld
|版本=v5.2.5
|前置插件=无
|兼容服务端版本=1.7.9 r0.2
|網址=http://dev.bukkit.org/bukkit-plugins/multiworld-v-2-0/
}}

=概述=
使用Multiworld插件，可以很容易地自定义每个世界对应的末地与下界，你可以随意配置。(受限于插件可实现的功能范围)
==历史==
我制作这个插件是因为该插件的原作者"Baummann"，现在不再活跃。之前，这个插件非常简易，只有两个命令: /goto and /newworld. 于是我接过这个项目并且开发出更好的版本。现在Multiworld已经更新到v5.2.5。
==特性==
自定义世界类型，例如沙子世界
支持修改玩家进入世界时的游戏模式
支持使用/mw move以及/mw goto指令于指定地点之间传送，就像在minecraft服务器使用/teleport指令一样
支持独立世界聊天频道

=命令与权限=
请求:本条目需要创建表格，成员请帮助编辑排版。

世界命令
命令描述权限
====世界====
/mw create <世界名称> [世界类型] [世界种子] 在数据库中创建一个新的世界.
注意: 你也可以使用这个命令来添加已存在的世界.
警告: 不要给你不信任的人这个权限，如果拥有这个权限，他将可以无限地创建世界! multiworld.command.create
/mw load <世界名称> 加载数据库中的世界 multiworld.command.load
/mw unload <世界名称> 卸载数据库中的世界(并非删除)，其他插件将无法查看到该世界 multiworld.command.unload
/mw delete <世界名称> 删除数据库中的世界.
警告: 这个功能是移除multiworld设置里面已经定义的一个世界! multiworld.command.delete
/mw list 列出服务器中已经生成地形的世界. multiworld.command.list
/mw info 显示当前世界的信息 multiworld.command.info
/mw listgens 列出可用的世界地形类型，辅助使用/mw create. multiworld.command.listgens
====规则====
/mw listflagsList 列出所有可能使用于标记值的选项在/mw setflag 指令内. commands.multiworld.command.flags
/mw setflag <世界名称> <标记值> <变量> 于指定世界内设置一个标记值或选项. multiworld.command.setflag
/mw getflag <世界名称> <标记值> 获取标记值在指定世界, 世界名称填写 * 则可以获取全部世界 flags.multiworld.command.getflag
====传送门====
/mw link <源世界> <目标世界> 连接 <源世界> 世界的地狱门到 <目标世界> 世界的地狱门.
提示，使用这个功能需要开启地狱门连接权限! multiworld.command.link.nether
/mw link-end <源世界> <目标世界> 连接全部未界传送门由 <源世界> 至 <目标世界>.
提示，使用这个功能需要开启未地传送门连接权限! multiworld.command.link.end
====传送====
/mw goto <世界名称> 将你自己传送到此世界, 这个指令也能够使用简写/goto <世界名称> multiworld.command.goto
/mw move <玩家名称> <世界名称> 移动指定玩家至一个世界 multiworld.command.move
====出生点====
/mw spawn传送到所在世界的出生点, 移动其他人需要用 /mw move.multiworld.command.spawn
/mw setspawn设置所在世界的出生点, 你可以使用这个命令来修正出生点。 pointmultiworld.command.setspawn
====插件基础命令====
/mw save保存插件数据multiworld.command.save
/mw reload重新加载插件数据multiworld.command.reload
/mw debug显示调试信息，这些将会在你碰到插件错误（报告）时非常有用multiworld.command.debug
/mw help显示帮助，这样你就不用每次来看这个网页了multiworld.command.help
/mw eastereggNot a real command, but there is a easter egg hidden in multiworld-（这个命令比较有趣和无用，故不作翻译。你可以尝试下提示：复活节彩蛋）

====其他====
-如果想要使他人在进入一个世界后转为创造模式. 建议给所有人这个权限.multiworld.creativemode
-Gives access to the basic Multiworld moderator controll, this permission won't allow users to modefy settings of existing world, it only allows them to view the settings / teleport to worldsmultiworld.basic
-你可以使用这个权限来给予一个人关于这个插件的所有权限.Multiworld.admin

=可选的特性=
特性 NameDescriptionConfiguration 的位置
给予 worldoptions.useEndPortalHandler 权限，未地传送门管理器则允许你自定义一个未地传送门
下界传送门管理器，这个管理器可能使下界传送门重新定义到一个自定义的地狱世界，这个配置在 worldoptions.usePortalHandler
WorldChatSeperatorThis allows you to use the RecieveChat and the SendChat flags on a worldoptions.useWorldChatSeperator
GamemodeChangerThis allows you to use the flag CreativeWorld to turn on creative mode for a world, to use this you need to give you users the following permissions on all worlds: multiworld.creativemode
This module also comes with a other configuration settings, when you turn off usecreativemodeinv, it ONLY handles the gamemode part, it won't change the inventory contents, this can be used if you have a custom plugin for per world inventories.options.usecreativemode
EnderBlockPrevents the use of ender chests in creative mode, this can be used to prevent people from cheating stuff by storing it inside a ender chest in a creative world, and then removing it in a survival world.options.blockEnderChestInCrea
WorldSpawnHandlerThis allows you to have custom respawn worlds per world group, this can be setup by turning this part on to generate the configuration needed for this.options.useWorldSpawnHandler
CraftbukkitHooksAllows multiworld to hook into craftbukkit to display information that the bukit api won't provide. This feature will try to turn itself off when there are any errors.options.craftbukkitHooks

=Multiworld and Data=
Multiworld is using a statistcs tracking code so useage statistics wil be logged, for more information what is logged see:
Usage statistics at v3.5.0
=向您的服务器推荐其他插件=
[[LocationTeleport]] - 在自定义区域内创造传送点 

[[hothgenerator]] - 生成一个满是冰雪的世界。
/mw create WorldName plugin:HothGenerator 

[[multiinv]] - 控制多世界背包，分隔每个世界的物品栏。