查看“GroupManager”的源代码

{{待完善}}
{{Plugin
|version=v2.1
|URL=http://dev.bukkit.org/bukkit-plugins/essentials/
}}
'''Group Manager（简称GM）'''是一款用于控制权限的插件。它允许你为用户组设立权限，并将玩家添加到这些用户组，便可以有拥有允许使用特定权限的多个等级。创建一个自定义的等级系统，对于大部分Minecraft服务器来说是非常有用的。没有它，设置服务器限制玩家的程度是比较困难的。
Group Manager作为一个独立的组件提供，并且当前不是可用的BukkitDev批准项目。
请参见:Group Manager/配置，GroupManager/命令和Group Manager/开发者 条目。
视频教学涉及这一页的一小部分。-其中有一些次要的、过时的、不准确的内容。所以当此页和视频不符时，请使用这一页内容。

==基本思路==
Group Manager允许通过尽可能多地创建需要的用户组和副用户组，有效地管理用户的权限。配置可以非常简单，或是如需要的那样复杂。
最传统的权限系统（如下）使用了组继承，从最上方的新人(Newbie)用户组开始，一直到最下方的服主(Owner)。在小型服务器上可以合并协管员／主持人(Moderator)和管理员用户组，但大多数人会在管理员获得的权限和协管员／主持人获得的权限上有不同的想法。
;Newbie(新人)
:Newbie用户组包括最基础的权限节点，应该给予所有新加入玩家在注册时保证安全的权限。
;Player(玩家)
:Player用户组包括了所有玩家可以使用的权限。一般包含经济、基础传送，和其他的基础指令。
;Moderator(协管员/主持人)
:接下来的两个用户组可以基于你的喜好合并或更深入地分开。典型地，最低级的协管员／主持人等级拥有踢出玩家、监禁玩家的权限，高级的协管员／主持人可以取得并封禁玩家IP地址、隐身、也能够切换为创造模式。
;Admin(管理员)
;Owner(服主)
:服主用户组一般允许使用所有权限/命令，且通常是唯一一个拥有控制插件、规定用户组、关闭/重启服务器命令的用户组。
[[File:截图20.png|frame|自涂商标，无版权]]

==初始安装==
Group Manager的安装非常容易:
#安全地关闭服务器。
#将Group Manager插件放入plugins文件夹。 （EssentialsGroupManager.jar/GroupManager.jar）
#启动然后关闭服务器。
#修改初始的config.yml文件(可修改可不修改）。
#重启服务器（在游戏中应用更新的Group Manager配置时，输入/manload）。

===配置文件===
请参见:Group Manager/配置
第一次下载Group Manager时，一般只有.jar文件。在第一次运行Group Manager时，它会生成可以编辑的配置文件。
标准的配置和范例里详细的布局很相似，但在使用之前至少需要更改一点，需要将自己加入管理员。<br />
第一次生成的配置文件时的文件目录结构会看起来像这样:

GroupManger/
: backup/
: worlds/
:: world/
::: groups.yml （组权限文件）
::: users.yml （用户单独权限文件）
: config.yml
: globalgroups.yml (单一权限分配到继承组的文件)

配置文件的细节可以在配置页面找到。

==权限==
Group Manager配置的核心是权限节点，能够准确地控制一个玩家能干什么、不能干什么，是Group Manager的重点所在。每一个插件都有各自的权限节点，关联于具体插件的命令。
Essentials插件在它的命令参考里有一个关于权限完整的列表。至于其他的插件，需要查看和它们有关的文档帮助。

===权限节点===
每一个支持权限的插件，都会有他们各自的权限节点。
;权限节点大致语法:<插件名>.<命令名>
:语法范例： essentials.tp （允许一个玩家通过使用Essentials的/tp 命令进行传送）
:Essentials是插件名称，命令是/tp
:父节点（权限节点前半部分）不一定总是插件的名称，所以请在构建用户组之前先检查。这个特性允许不同的插件拥有相同的指令，但是在指明选定哪个插件的指令为默认后不会互相起冲突。
范例：essentials.god和worldguard.god

===摘要节点（通配符“*”）===
Group Manager支持摘要权限，使用通配符允许所有注册的附属的权限
*essentials.*：允许使用所有的essentials命令
*essentials.kits.*：允许使用所有的kit工具包
也可以不用指明插件，直接使用“*”通配符自己。这个使指明的用户组拥有权限使用所有插件的所有命令。注意：有冲突的命令会变得不稳定，除非使用否定节点否认。请自行承担风险，也不是所有的插件都正确地注册了它们的权限。

===否定节点===
Group Manager支持否定节点，允许收回使用命令的权限。和继承配合是非常有用的。
*essentials.kits.*：所有/kit的权限
*-essentials.kits.admin：仅移除/kit admin的权限
在使用大型通配符权限（摘要节点）的时候，这个是非常有用的，例如给予一个管理员所有的指令，但移除Group Manager命令的权限部分。将摘要节点和否定节点组合在一起，可以轻松地移除许多的附属命令。
*-essentials.kits.*：移除所有/kit的权限

===例外节点===
Group Manager支持可以覆盖否定节点的例外节点，允许你轻易地恢复命令的权限。这在移除所有命令的权限，并把每个单独地加回来时是有用的。
*-essentials.signs.create.*：移除创建所有Essentials牌子的权限
*+essentials.signs.create.trade：覆盖并给予创建交易牌子的权限

===权限范例===
这里有大量的Group Manager可用的权限文件范例：
Group 用户组：：Group Manager全体组

==变量==
Group Manager允许像规定权限一样规定变量。每一个用户组的变量都可以有不同的取值。它们往往在基于用户组的插件（如VIP插件等）使用。这里有两个主要的范例："prefix"（前缀）“suffix”（后缀），和“build”开关。

===聊天插件===
大部分聊天插件，会为了基于用户组给予玩家自定义名称，而读取prefix（前缀）和suffix（后缀）取值。
EssentialsChat会将前缀和后缀添加到个人的用户名，以给用户的名称增加标签和颜色。
如果想制作更长的聊天前缀，建议查看我们的聊天格式向导，它展示了如何在聊天中使用长的前缀，但在玩家名的名称里使用短的前缀。
在这里可以找到一个关于颜色代码的列表。
;一些范例：
:prefix: '[A]' : 制作一个简单的<[A]User>
:prefix: '&e' : 制作一个上色的<User> 

===保护插件（AntiGrief）===
一些插件支持基于“AntiGrief”的保护。就像聊天颜色一样，GroupManager并不提供这项功能。像EssentialsProtect这样的插件提供。
;build状态往往像这样：
:build: false禁用方块的建筑／破坏。
:build: true启用方块的建筑／破坏。 

==插件更换==
一般地从大部分权限插件转换到Group Manager是一个比较容易的事情。请先尝试下面的步骤，但是如果无法运行，手动地构建用户组也是比较容易的。
#移动EssentialsGroupManager.jar或GroupManager.jar到你的plugins目录里。
#从你的plugins目录移除先前的权限插件的jar文件。
#复制先前的用户组文件。
#打开Group Manager文件夹然后定位到世界文件夹（plugins/worlds/<你的世界名称>）。
#将两个权限配置文件粘贴到此处。
#将一个重命名为users.yml，另一个重命名为groups.yml，覆盖所有存在的文件。
#重启服务器。

==Group Manager命令==
有大量和Group Manager插件有关的命令，可以用于在游戏中和控制台上为玩家修改和分配用户组。
请参见：Group Manager/命令

===基础用户命令===
这些命令在已经建立好一个用户组，且仅想将用户分配到用户组时十分有用。
;/manuadd: 移动用户到希望的用户组。（如果不存在的话会添加用户组到文件） 
:/<命令> <玩家> <用户组>                  [[File:截图18.png|frame|right|添加一个已有玩家ton_进入homland世界的default组]]  
:权限节点：groupmanager.manuadd    

;/manudel: 移除所有此用户特定的配置。使他进入默认用户组。 
:/<命令> <玩家>
:权限节点：groupmanager.manudel      

;/manpromote: 允许在继承树中向上提升一个玩家。这个命令只会允许用户在相互继承的用户组之间移动。 
:/<命令> <玩家> <用户组>
:权限节点：groupmanager.manpromote      

;/mandemote: 允许在继承树中向下降级一个玩家。这个命令只会允许用户在相互继承的用户组之间移动。 
:/<命令> <玩家> <用户组>
:权限节点：groupmanager.mandemote      

;/manwhois: 获得用户处在的用户组。 
:/<命令> <玩家>                     [[File:截图17.png|frame|right|查看一个名叫Lushie的玩家的权限组信息]]  
:权限节点：groupmanager.manwhois

;/manclear: 清空所选世界的所有权限组，默认主世界。  ''慎重使用''
:/<命令> <世界名>
:权限节点：groupmanager.manclear

===管理组命令===
这些命令应该由服务器管理人员编辑。
;/mangadd :创建一个新的组，以供分配玩家进入（基础组插件自带，不能创建与基础组重名的组名，例如你不能创建一个叫做default的组，因为它是插件自带组。
:/<命令> <组名>
: 权限节点：groupmanager.mangadd

;/mangdel:删除一个组。这个指令不会导致你删掉的这个组的继承组的已继承指令。被删掉的这个组里的玩家会进入默认组。
:/<命令> <组名>
:权限节点：groupmanager.mangdel

;/mangaddi:添加组A到组B的继承列表中。继承后，A组会拥有组B的所有权限，改动组A的权限会影响组B的权限，但修改组B的权限不会影响组A的权限。
‘’注：A,B可以为任意组的名字。’’
:/<命令> <组A> <组B>
:权限节点：groupmanager.mangaddi

;/mangdeli:把组A从组B的继承列表里移除。
’’注意：移除后继承组仍然拥有被继承组的权限。请慎重使用此条命令及上条命令。’’
:/<命令> <组A> <组B>
:权限节点：groupmanager.mangdeli

;/mangaddp:为所选组添加权限。
:/<命令> <组名> <权限节点>
:权限节点：groupmanager.mangaddp

;/manglistp:列出所选组的所有权限以及继承对象。
:/<命令> <组名>
:权限节点：groupmanager.manglistp

;/manglistv:列出所选组的前后缀，如果没有则会在prefix和suffix后面显示空的’’号。
:/<命令> <组名>
:权限节点：groupmanager.manglistv

;/mangcheckp:检查权限组是否具有权限并查看来源。
:/<命令> <组名>
:权限节点：groupmanager.mangcheckp

;/mancheckw: 查找权限文件保存路径，默认为主世界。 
:/<命令> <世界名>
:权限节点：groupmanager.mancheckw

;/manselect:选择一个世界以进行后续编辑指令（用于多世界，因为如果你没有使用多世界插件，即使你不使用这个指令，默认也是编辑当前主世界。比如你选择一个叫做haha的世界进行编辑，则输入/manselect haha，然后就可以进行编辑了。当你要编辑其他世界的时候，再输入另外一个世界的名字/manselect <另一世界名>以切换到另一世界的编辑。
:/<命令> <世界名>
:权限节点：groupmanager.manselect

;/manworld:查看你当前正在编辑的世界名，与上面的指令一样应用于多世界插件，如果只有一个世界，即没有使用多世界插件，这条指令对你帮助不大。
:/<命令> <世界名>
:权限节点：groupmanager.manworld

;/mangaddv:为所选组添加前后缀，一次只能添加一种缀。前缀在玩家名前面，后缀在后面。
:/<命令> <组名> <prefix/suffix> <你想要的缀名>    
缀名可用颜色字符,在字词前加&后面跟1-9的数字或a-e的字母，具体见右图格式。
[[File:yanse.png|frame|right|字体颜色及其他标注格式]]  
:权限节点：groupmanager.mangaddv

[[Category:管理]][[Category:聊天]][[Category:经济]][[Category:综合]]