EssentialsX 服务器基础插件

EssentialsX 服务器基础插件套件

> Paper 与 Spigot 服务器的必备插件套件，包含 130+ 命令与无数功能，涵盖传送、经济、家园、地标、聊天、管理、社交等服务器所需的全部基础能力。
基本信息

| 项目 | 信息 |
| --- | --- |
| 插件名称 | EssentialsX |
| 开发者 | mdcfe（Owner）、JRoy / pop4959（Maintainer）及社区贡献者 |
| 最新稳定版 | 2.22.0（2026-05-31，The Tiny Copper Mayhem Update）|
| 开发构建 | 2.22.1-dev+21-d5dc7e3（build 1825）|
| 许可协议 | GPL-3.0-only（GPLv3）|
| 兼容版本 | 1.8.8–26.2（26.2 为主动开发与支持版本；1.8.8–26.1.2 仍支持但非优先）|
| 运行平台 | Paper（推荐）、Spigot、Bukkit；Folia 暂不支持 |
| 项目地址 | https://modrinth.com/plugin/essentialsx |
| 官方文档 | https://essentialsx.net/ |
简介

EssentialsX 是经典 Essentials 插件套件（2014 年停止维护）的现代化延续，专为现代 Minecraft 版本重构，是 Spigot/Paper 服务器的事实上标准插件。它将服务器运行所需的传送、经济、家园、地标、聊天格式化、管理指令、社交系统等全部整合到一个模块化套件中，绝大多数 Bukkit/Spigot/Paper 服务器都会在安装首日就部署它——同时它也是大量第三方插件依赖的基础组件。

EssentialsX 在原版 Essentials 的基础上修复了大量问题、做了性能优化，并新增了许多实用特性。它采用模块化设计：核心功能打包在主 jar 中，聊天、重生、防破坏、Discord 集成等功能拆分为独立可选模块，服务器只需加载自己需要的部分。配置与数据文件与旧版 Essentials 兼容，升级时替换 jar 即可，旧配置会在首次运行时自动迁移。

项目完全免费、开源（GPLv3），通过 bStats 收集匿名服务器统计数据（可在 plugins/bStats/config.yml 中关闭），翻译由社区在 Crowdin 上协作完成。
核心特性
模块化架构
套件拆分为多个独立 jar，按需加载：
EssentialsX（核心，必装）：传送、私信、家园、地标、经济、Kits、AFK、背包、附魔、刷怪蛋等 130+ 命令
EssentialsX Chat（推荐）：聊天格式化，支持前缀、后缀、颜色与分组格式，需配合 Vault + LuckPerms
EssentialsX Spawn（推荐）：出生点设置、首次加入位置、死亡重生位置，支持分组出生点
EssentialsX AntiBuild（可选）：基于权限的建造/交互/合成精细控制，配合 LuckPerms 使用
EssentialsX Protect（可选）：基础世界保护（防苦力怕炸房、防火蔓延、限制刷怪等）
EssentialsX Discord（可选）：轻量 MC ↔ Discord 双向桥接，支持频道聊天同步、事件监控、控制台转发、斜杠命令
EssentialsX DiscordLink（可选）：需 Discord 模块，允许玩家绑定 MC 与 Discord 账号
EssentialsX GeoIP（可选）：基于 IP 的玩家地理位置近似查询，登录时或 /whois 中显示
EssentialsX XMPP（遗留，可选）：XMPP/Jabber 聊天集成

> 官方建议：大多数服务器用「Core + Spawn + Chat + Economy」组合即可；区域保护类需求推荐 WorldGuard 而非 AntiBuild/Protect。升级时所有模块必须保持同一版本，否则会出现版本不匹配错误。
传送与移动
提供 /home、/warp、/tpa、/tpahere、/tpaccept、/tpdeny、/tp、/tppos、/tpaall、/back、/spawn、/warp 等完整传送体系，支持传送冷却、延迟（移动取消）、安全落地、跨世界处理、死亡点返回。支持按权限组设置家园数量上限。
内置经济系统
自带轻量经济（Vault 经济提供者），支持 /bal、/pay、/eco、/balancetop、银行、负数余额（贷款）、出售倍率，以及 [Buy]/[Sell]/[Trade]/[Free]/[Disposal]/[Heal]/[Mail]/[Warp] 等牌子商店。配合 Vault 后自动注册为经济提供者，可被 Shop 类插件调用。中小服务器开箱即用，大型服建议外接 MySQL 或专业经济插件。
家园、地标与 Kits
玩家可设置个人家园，管理员可设置全局地标；Kits（礼包）在 kits.yml 中定义物品组合，支持一次性/按冷却（如每日）发放，配合权限节点按组别发放新手包、VIP 包等。
聊天管理
支持全局/本地聊天半径、分组格式、前缀后缀、颜色，2.21.0 起重构为 Adventure/MiniMessage 富文本组件，默认使用 Paper 的现代 AsyncChatEvent。提供 SocialSpy（私信监控）、聊天忽略、本地聊天等功能。
管理指令全家桶
涵盖封禁（/ban、/banip、/unban、/unbanip、/kick）、静音、监狱（/jail、/togglejail）、隐身（/vanish）、飞行（/fly）、上帝模式（/god）、治愈/喂食、物品/经验/刷怪蛋赠送、附魔、刷怪笼、世界规则、天气时间、玩家信息查询（/whois、/seen、/getpos、/gc、/list）等。
国际化与消息自定义
2.21.0 起翻译系统全面重构，新增 per-player-locale（按玩家客户端语言发消息）与 message-colors（主色/辅色，无需改消息文件即可换肤）；消息文件从 plugins/Essentials/ 迁移至 plugins/Essentials/messages/，升级时自动转换。翻译由 Crowdin 众包。
环境要求

| 项目 | 要求 |
| --- | --- |
| 服务端 | Paper（强烈推荐，享受异步区块加载等优化）、Spigot、CraftBukkit |
| Minecraft | 1.8.8 – 26.2（26.2 为主动支持；1.8.8–26.1.2 仍兼容但可能未来弃用）|
| Java | 8 及以上（推荐 Java 17+）|
| 前置依赖 | Vault（经济/聊天/前缀需要）+ 权限插件（推荐 LuckPerms）|
| 不支持 | Folia 及其分支（会丢失用户数据，正在重做中）、Mohist、Akarin/Yatopia 等非常规 Paper 分支、1.7.10 及以下（请用原版 Essentials）、Forge/Fabric 混合端（建议用 FTB Essentials）|

> 升级提醒：从旧版升级时保留 config.yml 即可，但新版本常新增配置项，建议对照最新 config 补全；消息文件在 2.21.0+ 会自动迁移到 plugins/Essentials/messages/；所有模块 jar 务必统一版本号。
安装方法
访问 https://essentialsx.net/downloads 或 Modrinth/GitHub Releases，下载所需模块（至少下载核心 EssentialsX-2.22.0.jar，推荐补 Chat 与 Spawn）
将 jar 放入服务端 plugins/ 目录
启动服务器，自动生成 plugins/Essentials/config.yml 等配置文件
按需编辑 config.yml（经济、传送、家园、聊天等）与 kits.yml
通过 /plugins 确认 Essentials 正常加载（显示绿色）

> 提示：Economy 功能需同时安装 Vault 并搭配 LuckPerms，EssentialsX 会自动注册为 Vault 经济提供者；经济数据默认内存存储 + 文件备份，规模较大时建议外接 MySQL。
使用场景
开服基础套件：新服首日部署，一次性解决传送、经济、家园、地标、聊天、管理指令
生存/SMP 服务器：家园、地标、Kits、经济、传送请求构成玩家日常体验骨架
管理后台：封禁、静音、监狱、隐身、查询等指令覆盖日常运维
社交与社区：聊天格式化 + Discord 桥接 + GeoIP，支撑社群运营
作为依赖底座：大量第三方插件（商店、任务、保护等）依赖 EssentialsX 的经济与 API
近期更新
2.22.0（2026-05-31，The Tiny Copper Mayhem Update）：同步兼容最新 Minecraft 内容
2.21.2（2025-08-03，The Chase the Skies Update）：1.21.8 支持
2.21.1（2025-05-26，The Spring to Life Update）：1.21.5 支持与问题修复
2.21.0（2025-03-22，The Adventure Awakening Update）：1.21.4 + Garden Awakens 内容支持；Adventure/MiniMessage 翻译重构；per-player-locale、message-colors、出售倍率；消息文件迁移；默认改用 Paper AsyncChatEvent（可用 chat.paper-chat-events: false 回退旧事件）
2.20.1（2023-08-05，The Trails and Tales Update）：1.20.x 支持

> 完整更新记录见 https://github.com/EssentialsX/Essentials/releases 。
已知问题
Spigot 上：即使 EssentialsX Spawn 覆盖了重生点，重生锚充能仍会被消耗（CraftBukkit 未修复，Paper 已补丁）；1.17.1+ 跨世界传送时飞行模式会被重置（Paper 已修复）
Folia 暂不支持：当前版本在 Folia 上可能丢失用户数据，官方正在重做
区域保护局限：AntiBuild/Protect 不做区域级保护，领地需求请改用 WorldGuard
相关链接
官方网站与下载：https://essentialsx.net/
Modrinth：https://modrinth.com/plugin/essentialsx
GitHub 仓库：https://github.com/EssentialsX/Essentials
命令列表：https://essinfo.xeya.me/commands.php
权限列表：https://essinfo.xeya.me/permissions.php
官方 Wiki：https://essentialsx.net/wiki/
社区支持（MOSS）与 Bug 反馈：Discord / GitHub Discussions
捐赠支持：Patreon、GitHub Sponsors、Ko-fi
许可

EssentialsX 是基于 GPL-3.0-only（GNU GPL v3） 开源的项目，欢迎在 GitHub 提交代码贡献，翻译可在 Crowdin 参与。项目完全免费，如愿意可通过 Patreon、GitHub Sponsors（ recurring）或 Ko-fi（one-off）赞助，或在 GitHub 上 Star 支持。
套件

> Paper 与 Spigot 服务器的必备插件套件，包含 130+ 命令与无数功能，涵盖传送、经济、家园、地标、聊天、管理、社交等服务器所需的全部基础能力。
基本信息

| 项目 | 信息 |
| --- | --- |
| 插件名称 | EssentialsX |
| 开发者 | mdcfe（Owner）、JRoy / pop4959（Maintainer）及社区贡献者 |
| 最新稳定版 | 2.22.0（2026-05-31，The Tiny Copper Mayhem Update）|
| 开发构建 | 2.22.1-dev+21-d5dc7e3（build 1825）|
| 许可协议 | GPL-3.0-only（GPLv3）|
| 兼容版本 | 1.8.8–26.2（26.2 为主动开发与支持版本；1.8.8–26.1.2 仍支持但非优先）|
| 运行平台 | Paper（推荐）、Spigot、Bukkit；Folia 暂不支持 |
| 项目地址 | https://modrinth.com/plugin/essentialsx |
| 官方文档 | https://essentialsx.net/ |
简介

EssentialsX 是经典 Essentials 插件套件（2014 年停止维护）的现代化延续，专为现代 Minecraft 版本重构，是 Spigot/Paper 服务器的事实上标准插件。它将服务器运行所需的传送、经济、家园、地标、聊天格式化、管理指令、社交系统等全部整合到一个模块化套件中，绝大多数 Bukkit/Spigot/Paper 服务器都会在安装首日就部署它——同时它也是大量第三方插件依赖的基础组件。

EssentialsX 在原版 Essentials 的基础上修复了大量问题、做了性能优化，并新增了许多实用特性。它采用模块化设计：核心功能打包在主 jar 中，聊天、重生、防破坏、Discord 集成等功能拆分为独立可选模块，服务器只需加载自己需要的部分。配置与数据文件与旧版 Essentials 兼容，升级时替换 jar 即可，旧配置会在首次运行时自动迁移。

项目完全免费、开源（GPLv3），通过 bStats 收集匿名服务器统计数据（可在 plugins/bStats/config.yml 中关闭），翻译由社区在 Crowdin 上协作完成。
核心特性
模块化架构
套件拆分为多个独立 jar，按需加载：
EssentialsX（核心，必装）：传送、私信、家园、地标、经济、Kits、AFK、背包、附魔、刷怪蛋等 130+ 命令
EssentialsX Chat（推荐）：聊天格式化，支持前缀、后缀、颜色与分组格式，需配合 Vault + LuckPerms
EssentialsX Spawn（推荐）：出生点设置、首次加入位置、死亡重生位置，支持分组出生点
EssentialsX AntiBuild（可选）：基于权限的建造/交互/合成精细控制，配合 LuckPerms 使用
EssentialsX Protect（可选）：基础世界保护（防苦力怕炸房、防火蔓延、限制刷怪等）
EssentialsX Discord（可选）：轻量 MC ↔ Discord 双向桥接，支持频道聊天同步、事件监控、控制台转发、斜杠命令
EssentialsX DiscordLink（可选）：需 Discord 模块，允许玩家绑定 MC 与 Discord 账号
EssentialsX GeoIP（可选）：基于 IP 的玩家地理位置近似查询，登录时或 /whois 中显示
EssentialsX XMPP（遗留，可选）：XMPP/Jabber 聊天集成

> 官方建议：大多数服务器用「Core + Spawn + Chat + Economy」组合即可；区域保护类需求推荐 WorldGuard 而非 AntiBuild/Protect。升级时所有模块必须保持同一版本，否则会出现版本不匹配错误。
传送与移动
提供 /home、/warp、/tpa、/tpahere、/tpaccept、/tpdeny、/tp、/tppos、/tpaall、/back、/spawn、/warp 等完整传送体系，支持传送冷却、延迟（移动取消）、安全落地、跨世界处理、死亡点返回。支持按权限组设置家园数量上限。
内置经济系统
自带轻量经济（Vault 经济提供者），支持 /bal、/pay、/eco、/balancetop、银行、负数余额（贷款）、出售倍率，以及 [Buy]/[Sell]/[Trade]/[Free]/[Disposal]/[Heal]/[Mail]/[Warp] 等牌子商店。配合 Vault 后自动注册为经济提供者，可被 Shop 类插件调用。中小服务器开箱即用，大型服建议外接 MySQL 或专业经济插件。
家园、地标与 Kits
玩家可设置个人家园，管理员可设置全局地标；Kits（礼包）在 kits.yml 中定义物品组合，支持一次性/按冷却（如每日）发放，配合权限节点按组别发放新手包、VIP 包等。
聊天管理
支持全局/本地聊天半径、分组格式、前缀后缀、颜色，2.21.0 起重构为 Adventure/MiniMessage 富文本组件，默认使用 Paper 的现代 AsyncChatEvent。提供 SocialSpy（私信监控）、聊天忽略、本地聊天等功能。
管理指令全家桶
涵盖封禁（/ban、/banip、/unban、/unbanip、/kick）、静音、监狱（/jail、/togglejail）、隐身（/vanish）、飞行（/fly）、上帝模式（/god）、治愈/喂食、物品/经验/刷怪蛋赠送、附魔、刷怪笼、世界规则、天气时间、玩家信息查询（/whois、/seen、/getpos、/gc、/list）等。
国际化与消息自定义
2.21.0 起翻译系统全面重构，新增 per-player-locale（按玩家客户端语言发消息）与 message-colors（主色/辅色，无需改消息文件即可换肤）；消息文件从 plugins/Essentials/ 迁移至 plugins/Essentials/messages/，升级时自动转换。翻译由 Crowdin 众包。
环境要求

| 项目 | 要求 |
| --- | --- |
| 服务端 | Paper（强烈推荐，享受异步区块加载等优化）、Spigot、CraftBukkit |
| Minecraft | 1.8.8 – 26.2（26.2 为主动支持；1.8.8–26.1.2 仍兼容但可能未来弃用）|
| Java | 8 及以上（推荐 Java 17+）|
| 前置依赖 | Vault（经济/聊天/前缀需要）+ 权限插件（推荐 LuckPerms）|
| 不支持 | Folia 及其分支（会丢失用户数据，正在重做中）、Mohist、Akarin/Yatopia 等非常规 Paper 分支、1.7.10 及以下（请用原版 Essentials）、Forge/Fabric 混合端（建议用 FTB Essentials）|

> 升级提醒：从旧版升级时保留 config.yml 即可，但新版本常新增配置项，建议对照最新 config 补全；消息文件在 2.21.0+ 会自动迁移到 plugins/Essentials/messages/；所有模块 jar 务必统一版本号。
安装方法
访问 https://essentialsx.net/downloads 或 Modrinth/GitHub Releases，下载所需模块（至少下载核心 EssentialsX-2.22.0.jar，推荐补 Chat 与 Spawn）
将 jar 放入服务端 plugins/ 目录
启动服务器，自动生成 plugins/Essentials/config.yml 等配置文件
按需编辑 config.yml（经济、传送、家园、聊天等）与 kits.yml
通过 /plugins 确认 Essentials 正常加载（显示绿色）

> 提示：Economy 功能需同时安装 Vault 并搭配 LuckPerms，EssentialsX 会自动注册为 Vault 经济提供者；经济数据默认内存存储 + 文件备份，规模较大时建议外接 MySQL。
使用场景
开服基础套件：新服首日部署，一次性解决传送、经济、家园、地标、聊天、管理指令
生存/SMP 服务器：家园、地标、Kits、经济、传送请求构成玩家日常体验骨架
管理后台：封禁、静音、监狱、隐身、查询等指令覆盖日常运维
社交与社区：聊天格式化 + Discord 桥接 + GeoIP，支撑社群运营
作为依赖底座：大量第三方插件（商店、任务、保护等）依赖 EssentialsX 的经济与 API
近期更新
2.22.0（2026-05-31，The Tiny Copper Mayhem Update）：同步兼容最新 Minecraft 内容
2.21.2（2025-08-03，The Chase the Skies Update）：1.21.8 支持
2.21.1（2025-05-26，The Spring to Life Update）：1.21.5 支持与问题修复
2.21.0（2025-03-22，The Adventure Awakening Update）：1.21.4 + Garden Awakens 内容支持；Adventure/MiniMessage 翻译重构；per-player-locale、message-colors、出售倍率；消息文件迁移；默认改用 Paper AsyncChatEvent（可用 chat.paper-chat-events: false 回退旧事件）
2.20.1（2023-08-05，The Trails and Tales Update）：1.20.x 支持

> 完整更新记录见 https://github.com/EssentialsX/Essentials/releases 。
已知问题
Spigot 上：即使 EssentialsX Spawn 覆盖了重生点，重生锚充能仍会被消耗（CraftBukkit 未修复，Paper 已补丁）；1.17.1+ 跨世界传送时飞行模式会被重置（Paper 已修复）
Folia 暂不支持：当前版本在 Folia 上可能丢失用户数据，官方正在重做
区域保护局限：AntiBuild/Protect 不做区域级保护，领地需求请改用 WorldGuard
相关链接
官方网站与下载：https://essentialsx.net/
Modrinth：https://modrinth.com/plugin/essentialsx
GitHub 仓库：https://github.com/EssentialsX/Essentials
命令列表：https://essinfo.xeya.me/commands.php
权限列表：https://essinfo.xeya.me/permissions.php
官方 Wiki：https://essentialsx.net/wiki/
社区支持（MOSS）与 Bug 反馈：Discord / GitHub Discussions
捐赠支持：Patreon、GitHub Sponsors、Ko-fi
许可

EssentialsX 是基于 GPL-3.0-only（GNU GPL v3） 开源的项目，欢迎在 GitHub 提交代码贡献，翻译可在 Crowdin 参与。项目完全免费，如愿意可通过 Patreon、GitHub Sponsors（ recurring）或 Ko-fi（one-off）赞助，或在 GitHub 上 Star 支持。