GroupManager：修订间差异

2016年2月14日 (日) 14:12的版本

本条目已有一定量的内容，但仍需完善

你可以从以下几个方面入手

参阅格式化手册，并对该页面进行相应格式排版工作；
日常检查是否内容有更新版本并更新该页面；
修复该页面中已出现/潜在的问题

GroupManager

外文名	GroupManager
最新版本	v2.1
源地址	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(服主): 服主用户组一般允许使用所有权限/命令，且通常是唯一一个拥有控制插件、规定用户组、关闭/重启服务器命令的用户组。

初始安装

Group Manager的安装非常容易:

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

配置文件

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

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: 移动用户到希望的用户组。（如果不存在的话会添加用户组到文件）; /<命令> <玩家> <用户组>
添加一个已有玩家ton_进入homland世界的default组; 权限节点：groupmanager.manuadd

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

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

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

/manwhois: 获得用户处在的用户组。; /<命令> <玩家>
查看一个名叫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的继承列表里移除。

’’注意：移除后继承组仍然拥有被继承组的权限。请慎重使用此条命令及上条命令。’’