本帖最后由 tony990412 于 2019-12-4 08:45 编辑

EssentialsX Wiki [索引] [通过 Git 阅读Wiki]

---

EssentialsX 是一个基于 Spigot 服务端的基础插件，为从大到小的服务器提供核心功能。这些功能包括：

• 玩家可以自由设置家
• 服务器 传送 或给玩家提供 物品套组 ，可以设置跨世界或单独世界。
• 玩家与玩家间的私有消息，传送，发送传送请求
• 玩家自定义昵称
• 很多的管理员工具包括 踢出服务器，临时禁止登陆服务器、禁言与监禁
• 内建经济系统，包括木牌商店、付费执行命令和完全的 Vault 支持
  

EssentialsX的附属插件提供进一步的功能：

• 建筑控制：为 建筑 / 交互 / 合成  添加权限控制，并且在玩家进行上述操作时，提醒有权限的管理员。更多的内容在Essential Wiki
• 聊天：为整个服务器或某个组、某个人自定义聊天格式
• 物理IP：当玩家登入服务器和使用 /whois 时，显示玩家的IP
• 保护：设置规则保护你的世界，譬如关闭爆炸和火焰传播。
• 设置重生点：为不同的权限组设置不同的出生点，并且为不同的玩家展示不同的欢迎信息，为新玩家设置不同的出生点。
• XMPP：透过兼容XMPP协议的聊天系统，监控你的服务器并收私有消息。
  

---

页面

• BannerMeta
• 命令冷却
• 颜色权限
• 命令列表 (社区维护) （待翻译）
• 权限列表 (社区维护) （待翻译）
  

      注：当你更新EssentialX时，你需要更新所有模块以避免插件与附属插件不兼容的问题。事实上，你有时候会想更新你的config文件 —— 最新的文件在这里。

---

原先的Essentials插件
      EssentialsX 是原先 Essentials 的分支，Essentials 已于2014年停止更新。EssentialsX 相比 Essentials 和 Spigot 上的 Essentials 分支添加了一些新特性。查看更新记录与改进内容获得更多信息。
      从Essentials 2.14.x或更早版本升级，先关闭你的服务端，更换你的Essentials Jar为相应的EssentialsX Jar。当你第一次运行时，EssentialsX会读取并转换你的Essentials数据。
来自群组: Minecraft插件百科

命令冷却
这个特性在build 369 (09acbcd)中被加入（Issue #110 中被提及）在PR #692 中被实现。

---

本特性引用了将命令进行延时的功能。如果你想限制玩家不要高强度使用 /feed 或者 /home ，你所需做的一切只是在配置文件中加上几行:
高级用户可以使用通配符进行命令匹配，通配符通常是星号"*"。例如，要匹配所有带有potato的命令，只需如下更改配置文件即可：
注：因YAML的设计,任何以星号开头的命令，必须使用引号（'单引号'或"双引号"）将字符串包括起来。对于了解正则表达式的用户来说，这个特性同样兼容正则表达式。如果你想在EssentialsX中使用正则表达式，必须以 '^' 开头，其次才是显式正则表达式。
注：先导符号 '^' 不计算在正则表达式内，在解析正则表达式时会将其自动删除。  所以 '^ban([^ip])?( .*)?' 最终解析成了 'ban([^ip])?( .*)?'.
注2：如果插件命令以 '^' 例如 ^mycommand ,那么需要使用双引号才能使EssentialsX不将其误解为正则表达式（譬如"^mycommand"）

---

仅在服务器启动时记录冷却时间
默认情况下，EssentialsX 只会在服务器启动的状态时内记录冷却时间。这意味着玩家的命令冷却时间在关服时会被存储，启动时会被读取。这对于冷却时间较长的命令特别有效。
不管怎样，这个功能可以被关闭，使EssentialsX的冷却时间只记录到服务器关闭时。当服务器启动时重置所有冷却时间。
要禁用此功能，只需对配置文件进行如下更改：
注：若您的配置文件里没有 command-cooldown-persistence 这一条，可以在您的配置文件的任意位置中任意位置增加本条配置项。

---

无视冷却
这个特性是在构建 #377 中被增加的。
当用户有 essentials.commandcooldowns.bypass 权限时，将会无视所有权限的冷却时间。

本帖最后由 tony990412 于 2019-11-30 14:43 编辑

颜色权限

---

EssentialsX 包含下列权限，可以使玩家在使用某些命令时可以加入某些颜色代码。
目前可以使用的命令如下：

• 发送私信（/msg）: essentials.msg.<颜色前缀>
• 发送邮件（/mail）: essentials.mail.<颜色前缀>
• 设置自己的昵称（/nick）: essentials.nick.<颜色前缀>
• 发送消息 （需要 EssentialsX Chat 组件）: essentials.chat.<颜色前缀>
• 告示牌 （需要启用告示牌颜色的功能）: essentials.signs.<颜色前缀>
  

下列是可用的颜色前缀权限节点（与权限节点组）（请注意 部分前缀仅有 EssentialsX 2.16.1.169 以及更高版本支持）

前缀	可用的颜色代码	EssentialsX 版本
color(权限节点组)	&0 &1 &2 &3 &4 &5 &6 &7 &8 &9 &a &b &c &d &e &f &0 &1 &2 &3 &4 &5 &6 &7 &8 &9 &a &b &c &d &e &f	全版本
format(权限节点组)	&l &m &n &o &r（清除格式） &l &m &n &o &r	全版本
magic(权限节点组)	&k（随机生成）	全版本
黑色	&0	2.16.1.169+
深蓝色	&1	2.16.1.169+
深绿色	&2	2.16.1.169+
深天蓝色	&3	2.16.1.169+
深红色	&4	2.16.1.169+
深紫色	&5	2.16.1.169+
金色	&6	2.16.1.169+
灰色	&7	2.16.1.169+
深灰色	&8	2.16.1.169+
蓝色	&9	2.16.1.169+
绿色	&a	2.16.1.169+
天蓝色	&b	2.16.1.169+
红色	&c	2.16.1.169+
亮紫色	&d	2.16.1.169+
黄色	&e	2.16.1.169+
白色	&f	2.16.1.169+
加粗	&l	2.16.1.169+
删除线	&m	2.16.1.169+
下划线	&n	2.16.1.169+
斜体	&o	2.16.1.169+
重置格式	&r	2.16.1.169+

权限节点的优先级是大于权限节点组的，譬如，你给予玩家 essentials.nick.color 的权限，同时给了 -essentials.nick.black 权限，那么玩家将可以把自己的昵称改为除了黑色以外其他任何颜色。

---

昵称颜色
如果你只想让你的玩家修改昵称的颜色，但是不能修改文字，你可以给予 eessentials.nick.changecolors 权限。这可以让他们修改名字的颜色，但是昵称的文字还是无法修改的。