GroupManager

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

欢迎参与本条目的完善工作。

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

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

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的安装非常容易:

1. 安全地关闭服务器。
2. 将Group Manager插件放入plugins文件夹。 （EssentialsGroupManager.jar/GroupManager.jar）
3. 启动然后关闭服务器。
4. 修改初始的config.yml文件(可修改可不修改）。
5. 重启服务器（在游戏中应用更新的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是一个比较容易的事情。请先尝试下面的步骤，但是如果无法运行，手动地构建用户组也是比较容易的。

1. 移动EssentialsGroupManager.jar或GroupManager.jar到你的plugins目录里。
2. 从你的plugins目录移除先前的权限插件的jar文件。
3. 复制先前的用户组文件。
4. 打开Group Manager文件夹然后定位到世界文件夹（plugins/worlds/<你的世界名称>）。
5. 将两个权限配置文件粘贴到此处。
6. 将一个重命名为users.yml，另一个重命名为groups.yml，覆盖所有存在的文件。
7. 重启服务器。

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的继承列表里移除。

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

/<命令> <组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的字母，具体见右图格式。

字体颜色及其他标注格式

权限节点：groupmanager.mangaddv