目录
简介
前置与支持核心
常用配置修改
权限节点
常用指令
一、 简介
EssentialsX 是著名的 Minecraft 服务器插件 Essentials 的一个现代化分支和性能优化版本。它是 Bukkit, Spigot, Paper 等服务器核心上最基础、最核心的插件之一，几乎成为了大部分服务器的标配。
它提供了一套极其丰富的功能，包括但不限于：
玩家基础功能：设置家、传送、传送点、复活点。
经济系统：与 Vault 插件配合，为服务器经济系统提供基础支持。
物品管理：虚拟物品、修理、物品生成器。
聊天与互动：彩色昵称、邮件系统、广播。
管理员工具：禁言、踢出、封禁、隐身。
世界管理：防止恶意的破坏（防岩浆、防流水等）。
二、 前置与支持核心
必需前置
Vault：如果您的服务器需要 经济系统 或需要与权限管理插件（如 LuckPerms）配合，则必须安装 Vault。EssentialsX 的经济和部分权限功能依赖于此插件。
支持的核心
EssentialsX 支持所有基于 Bukkit 的服务器核心，推荐使用以下核心：
Paper (推荐)
Spigot
Bukkit (不推荐用于开设多人服务器)
其他 Paper 的分支核心，如 Purpur
注意：EssentialsX 不支持 Forge、Fabric 等mod核心和反向代理（velocity，BungeeCord），除非使用 Mohist 等混合核心。
三、 下载链接
官方下载地址：
https://essentialsx.net/downloads.html
注意：请点击Stable release下载正式版，进入界面默认下载开发版本
在这个页面，您可以看到多个版本：
| EssentialsX | 核心模块，提供了绝大多数基础功能，如传送、家、经济、物品管理等
| EssentialsXAntiBuild | 防破坏建造。允许你通过权限控制玩家能否放置或破坏特定方块，并设有使用特定物品时的警报系统
| EssentialsXChat | 聊天管理。用于定制聊天格式、设置昵称颜色、分组区别等
| EssentialsXDiscord | Discord桥梁。在 Discord 和 Minecraft 游戏之间建立连接，实现聊天同步、事件通知和执行命令等功能
| EssentialsXGeoIP | 地理IP显示。在玩家加入服务器时或使用 /whois 指令时显示其国家或地区信息
| EssentialsXProtect | 世界保护。提供基础的世界保护功能，如禁用苦力怕破坏、防止火焰蔓延、禁止特定生物生成等
| EssentialsXSpawn | 出生点管理。允许你设置多世界出生点，控制玩家首次加入或死亡后的出生位置
| EssentialsXXMPP | XMPP桥梁。连接 Jabber/XMPP 聊天网络与服务器，允许通过 XMPP 远程监控控制台和聊天
四、 安装方法
将下载好的 EssentialsX.jar（以及其他可选模块，如 EssentialsXChat.jar）放入服务器的 plugins 文件夹。
重启服务器（restart）或重载插件（reload - 不推荐，会出现难以预料的灾难性bug）。
服务器启动后，插件会自动生成配置文件夹 plugins/Essentials/其他模块并不会产生文件夹，所有ess配置都在该文件夹内
五、 常用功能配置修改
配置文件位于 plugins/Essentials/config.yml。修改后需使用 /essentials reload 重载配置。这里只列举出常用的，直接ctrl+F搜索即可
1.修改服务器货币名称
currency-symbol: '$'
将 `$` 修改为任意你想要的货币单位，如 “元”、“G”、“§a⛃” (彩色游戏内货币符号)。2. 启用/禁用特定功能
配置文件中有大量 enable: true/false(布尔值true为是，false为否) 选项，可以控制功能的开关。
# 是否允许设置多个家
homes:
enabled: true
max: 5 # 默认玩家可设置家的最大数量
# 是否允许使用 /workbench 指令（便携工作台）
workbench: true
# 是否允许使用 /condense 指令（自动压缩物品）
condense: true
# 是否启用防岩浆流动
prevent-lava-flow: true
# 是否允许玩家使用 /tpa 传送
teleportation:
tpa-enabled: true
tpa-cooldown: 0 # TPA 冷却时间
3. 经济系统设置
economy:
enabled: true
starting-balance: 100.0 # 玩家首次进入服务器获得的初始资金
min-pay-amount: 1.0 # 最小支付金额
max-money: 1000000.0 # 最大允许拥有的钱数（防止溢出）
六、 权限节点
EssentialsX 的权限节点非常多，以下列出最常用的部分。完整的权限列表在https://essinfo.xeya.me/permissions.html /help
* `essentials.list` - 使用 /list
* `essentials.msg` - 使用 /msg 和 /r
* `essentials.mail` - 使用 /mail
* `essentials.me` - 使用 /me
* `essentials.nick` - 使用 /nick 设置昵称 (需要 EssentialsXChat)
* `essentials.nick.color` - 允许在昵称中使用颜色代码
* `essentials.afk` - 使用 /afk
传送与移动权限
* `essentials.home` - 使用 /home
* `essentials.sethome` - 使用 /sethome
* `essentials.delhome` - 使用 /delhome
* `essentials.homes.<数量>` - 允许玩家设置指定数量的家 (例如 `essentials.homes.10`)
* `essentials.warp` - 使用 /warp (访问所有 warp)
* `essentials.warp.<传送点名称>` - 允许访问特定传送点
* `essentials.setwarp` - 使用 /setwarp
* `essentials.delwarp` - 使用 /delwarp
* `essentials.back` - 使用 /back 回到死亡点或上次传送点
* `essentials.tpa` - 使用 /tpa 请求传送
* `essentials.tpaccept` - 使用 /tpaccept 接受传送请求
* `essentials.tpahere` - 使用 /tpahere 请求对方传送到自己身边
* `essentials.spawn` - 使用 /spawn 传送到主出生点
物品与功能权限
* `essentials.hat` - 使用 /hat 将手中的物品戴在头上
* `essentials.workbench` - 使用 /workbench 打开便携工作台
* `essentials.enderchest` - 使用 /enderchest 打开便携末影箱
* `essentials.repair` - 使用 /repair
* `essentials.repair.all` - 使用 /repair all 修理手中所有物品
经济权限
* `essentials.balance` - 使用 /bal 查看余额
* `essentials.balance.others` - 查看他人余额
* `essentials.pay` - 使用 /pay 给他人钱
* `essentials.eco` - 使用 /eco 管理经济 (管理员)
管理员权限
* `essentials.gamemode` - 使用 /gamemode
* `essentials.god` - 使用 /god 启用上帝模式
* `essentials.fly` - 使用 /fly 飞行
* `essentials.speed` - 使用 /speed 调整移动速度
* `essentials.invsee` - 使用 /invsee 查看玩家背包
* `essentials.seeinventory` - 防止被他人用 /invsee 查看
* `essentials.vanish` - 使用 /vanish 隐身
* `essentials.socialspy` - 使用 /socialspy 监听玩家私聊
* `essentials.mute` - 使用 /mute 禁言玩家
* `essentials.kick` - 使用 /kick 踢出玩家
* `essentials.ban` - 使用 /ban 封禁玩家
* `essentials.tempban` - 使用 /tempban 临时封禁玩家
* `essentials.banip` - 使用 /banip IP封禁
* `essentials.unban` - 使用 /unban 解封
* `essentials.clear` - 使用 /clear 清空玩家背包
* `essentials.*` - **通配符，授予所有 EssentialsX 权限（慎用！）**
七、 常用指令大全
全部指令请前往https://essinfo.xeya.me/commands.html
玩家指令
| 指令 | 别名 | 功能描述 |
| `/home [家名称]` | | 传送到你的家 |
| `/sethome [家名称]` | | 设置你的家 |
| `/delhome [家名称]` | | 删除你的家 |
| `/warp [传送点名称]` | | 传送到公共传送点 |
| `/tpa <玩家名>` | | 请求传送到某玩家 |
| `/tpahere <玩家名>` | | 请求某玩家传送到你 |
| `/tpaccept` | `/tpac` | 接受传送请求 |
| `/tpdeny` | `/tpno` | 拒绝传送请求 |
| `/spawn` | | 传送到主城出生点 |
| `/back` | | 回到上一次死亡地点或传送地点 |
| `/bal [玩家名]` | `/balance`, `/money` | 查看余额 |
| `/pay <玩家名> <金额>` | | 向玩家支付金额 |
| `/msg <玩家名> <信息>` | `/m`, `/tell`, `/whisper` | 私聊某玩家 |
| `/r <信息>` | `/reply` | 回复最后私聊你的人 |
| `/mail read` | | 查看邮件 |
| `/mail send <玩家名> <信息>` | | 发送邮件 |
| `/afk` | | 标记自己为挂机状态 |
| `/nick <昵称>` | | 设置你的昵称 |
| `/hat` | | 将手中的物品戴在头上 |
管理员/OP指令
| 指令 | 别名 | 功能描述 |
| `/setwarp <名称>` | | 设置一个公共传送点 |
| `/delwarp <名称>` | | 删除一个公共传送点 |
| `/warp <名称>` | | 传送到指定传送点 |
| `/gamemode <模式> [玩家]` | `/gm` | 更改游戏模式 (survival, creative, etc.) |
| `/god [玩家]` | | 切换上帝模式 |
| `/fly [玩家]` | | 切换飞行模式 |
| `/speed <速度> [玩家]` | | 设置行走/飞行速度 (1-10) |
| `/vanish` | `/v` | 切换隐身模式 |
| `/invsee <玩家>` | | 查看并编辑玩家的背包 |
| `/mute <玩家> [时间]` | | 禁言某玩家 |
| `/kick <玩家> [原因]` | | 踢出某玩家 |
| `/ban <玩家> [原因]` | | 封禁某玩家 |
| `/tempban <玩家> <时间> [原因]` | | 临时封禁某玩家 (如 `7d` 表示7天) |
| `/unban <玩家>` | | 解封某玩家 |
| `/clear <玩家>` | | 清空玩家背包 |
| `/eco give <玩家> <金额>` | | 给玩家钱 |
| `/eco take <玩家> <金额>` | | 拿走玩家的钱 |
| `/eco set <玩家> <金额>` | | 设置玩家的余额 |
| `/essentials reload` | `/ess reload` | 重载EssentialsX的配置文件和语言文件 |
1. 权限管理：强烈建议使用 LuckPerms 权限管理插件来管理这些权限节点，而不是直接给玩家 OP 权限。
2. 备份配置：在修改任何配置文件之前，请先进行备份。
3. 查阅官方Wiki：本教程涵盖了大部分常用内容，但遇到更复杂的问题时，最好的方法是直接查阅官方 Wiki：https://essentialsx.net/wiki/Home.html
希望这份详细的教程能帮助您更好地使用和管理 EssentialsX 插件！
一个开服网站 https://www.rainyun.com/hanxing_
便宜，方便，安全，注册并绑定微信即可免费开服
新人注册还可以五折优惠！
一个开服网站 https://www.rainyun.com/hanxing_
便宜，方便，安全，注册并绑定微信即可免费开服
新人注册还可以五折优惠！
UP的爱发电ifdian.net/a/hanxing0729
提供多种服务器帮助
交流群980977178
欢迎各路我的世界萌新，大佬
进群交流，也可以互相答疑，寻找搭子
