PEX
声明：本PEXWiKi是我(JACV)对EN版PermissionsEXWiKi的翻译&搬运。
原因：个人认为MineCraft插件百科上的PermissionsEX百科搬运得非常糟糕，格式紊乱、翻译不全。在此提供方便阅读、翻译完全的PermissionsEX百科。
介绍
首先，欢迎来到PermissionsEX百科！
这一份关于Permissions1.x/2.x百科的建立过程非常艰辛！因为两个版本的PEX拥有着完全不同的文件和设置（具体查看）
PermissionEX是Bukkit目前最古老、高效的权限管理插件，从2011年PermissionEX2.x版本研发开始，PEX的开发者一直坚持不懈地对这款插件进行完善和升级。直至今日，它依然在MineCraft服务器中发挥着至关重要的作用！
PEX之所以能成为大家的首选，原因就在于它拥有无比优越的插件功能。它不仅支持多种不同类型的服务端/数据库，同时，也能清晰明确地为MineCraft世界提供各类权限，甚至可以为每个世界设置单独的权限！（具体参考 Modifyworld ）
这一份WiKi理论上已经能够协助你完全掌控PEX。如果你仍有任何问题，欢迎加入我们翻译团队IRC channel或者直接访问PermissionsEX论坛提问！
特性
PEX1.15版本及以后版本的特性：
- 原生超级权限，无需任何前置！
- 支持多种数据库,例如：YAML、SQL（MySQL, SQLite），甚至可能支持你自己制作的！
- 如果使用YAML数据库，那么所有的玩家权限、组权限都会统一于一个文件当中：permission.yml。这个文件的名字还可以自定义！（具体查看）
- 如果使用SQL数据库，那么更加有趣了！现在MySQL和SQLite数据库均支持PEX。但是其它的DB数据库服务端也可以支持。PEX拥有自动化适应、生成DB菜单和配置文件的功能。
- 也就是说，只要你能够保证PEX能与数据库进行连线，那么其他完全不在话下。
- 灵活多样的设置方式：你完全可以按照自己的喜好设置权限（具体查看）
- 和Yeti's Permissions v2.7.4版本完全兼容，同时，PEX还兼容市面上2/3的权限插件。当你同时安装多个权限插件时，PEX会将自己与它们区分开来（具体查看）
- 拥有多样化的聊天窗/控制台命令。使用PEX，你几乎可以在游戏或者后台做出任何事情！
- 拥有一种名字叫做“ModifyWorld”的防御机制。这个机制就像是完全独立的插件一样，能够完全操作玩家的行为、模式和效果。例如破坏/建造方块，骑马/乘船、受不受怪物的攻击等等，功能根本无法一言带尽！
- 你甚至完全可以把它当做Residence或者WorldGuard使用（具体查看）
- 拥有非常方便的组继承功能！玩家可以继承于（例如）系统默认组，拥有其中所有权限；同时，还可以设置前缀/后缀（具体查看）
- 支持大权限输入！所谓大权限，即集中一系列小权限的命令，你可以直接将大权限放入玩家设置中，以节省空间，方便管理！（具体查看）
- 多世界权限管理。你可以设置统一权限管理（Global），亦可以设置单独世界的权限管理。（具体查看）
- 升级为PEX2.x版本时，原有的设置可以直接应用！（如果你使用PEX3.0而想换回PEX2.0，你需要将配置文件先整理成PEX2.0的格式！）
- PEX2.0甚至内嵌YAML/SQL数据库
- 权限高度兼容。你可以访问来查看介绍
- 表现优异！即使你的服务器拥有100+的玩家，PEX也保证不会出现任何一点差错！
- 升级/降级系统。你可以设置出好玩的RPG服务器了！
- 更多特性，敬请期待……
基础
PemissionsEX，是从各种前辈权限插件中寻找灵感、不断完善的最终产物！它使用你不陌生的通用设置风格。
各类插件、PEX、Bukkit原生权限统统集中于一个文件之中。这个文档叫做permission nodes，里面包含了各种命令、特色权限，甚至是对事件的管理。
内容
- 权限术语
- 权限配置格式
- PEX文件格式（YAML）
PEX和服务器的权限术语（置项）
PS:这里我全部采用官方术语（EN），方便后面的阅读翻译；当后面出现这些术语时我将直接写EN
- Server Console (AKA Console)（控制台）：即控制台，服务器启动时需要的命令面板，后台记录日志、输入执行命令的地方
- Global Permissions（总权限）：应用于所有世界的权限设置
- World Specific Permissions（分世界权限）:单独应用于一个世界的权限设置
- Users（用户）: 权限应用者
- Group（组）: 权限应用组，这里，权限应用组也可以设置为所有世界的通用组或单独世界的权限组，具体看需求
- Node（权限语句）: 象征命令的语句，例如Bukkit端的bukkit.command.give即是象征/give 命令的语句
- Negation（否定）: 标记一条Node，设定它在什么情况下生效/失效
- Inheritance（继承）: 是一种让一个组去继承另一个组权限的功能。PEX支持组继承/世界继承
- Metadata（元数据）: (即小ID）元数据为各种各样的物品提供ID定义，例如同一块木头拥有不同颜色，不同形状的同一件物品，区分门到底是开的还是关的。这个功能主要用于Modifyworld
权限配置格式
PEX支持文件通用格式和SQL的格式编译，为了更好更生动地体现格式要点，下面举出一个文件通用格式的例子：
| 权限格式
|
users: <- 用户部分
t3hk0d3: <- 玩家名称
group: <- 玩家所隶属的组
- default <- 隶属组名称
permissions: <- 玩家特制权限部分
- permissions.* <- Node
worlds: <- 玩家世界设置
world: <- 指代独立世界world
permissions: <- 在这个world中拥有的权限
- test.* <- Node
group: <- 在这个world中隶属的组
- testers <- 组名称
prefix: '&5[YARR]&f' <- 在这个world中的名称前缀
groups: <- 组部分
default: <- 表示默认组
default: true <- 是否应用默认设置
permissions: <- 添加组权限
- -modifyworld.blocks.interact.23 <- 否定这条Node
- modifyworld.* <- Node
admins:
inheritance: <- 组继承设置
- default <- 继承的组名称
permissions:
- example.permission
- -punish.noobs
options: <- 组设置（数据库方面）
test.test: '100500' <- 额外数据
rank: '1' <- 排位等级
worlds:
nether:
permissions:
- nocheat.fly
prefix: '&7[ADMIN FROM HELL]'
testers:
inheritance:
- admins
options:
test.test: '9000'
worlds: <- 世界部分
nether: <- 世界名
inheritance: <- 继承设置
- world <- 继承于World
|
PEX文件格式（YAML）
众所周知，PEX采用和其他插件同样的YAML文本格式进行设置。（YAML是一种编译格式，访问 http://yaml.org/ 了解更多）YAML可不是简单的TXT文档，它非常注重格式的准确！
一旦出错，就算是PEX这么AI的插件都会无法运行（甚至蹦服），所以，请严格根据规定进行编译：
- 注意YAML的保留字，有 ' - : # %，如果你想使用这些保留字作为自定义数据，那么你就需要按以下方法定义：
%prefix%player%suffix> &e%message