★ FEATURED ARTICLE 10 分钟跑起来 EssentialsX从零到稳定运行的 Minecraft 服务器管理完整教程【免费下载链接】EssentialsThe modern Essentials suite for Spigot and Paper.项目地址: https://gitcode.com/GitHub_Trending/es/EssentialsEssentialsX 是面向 Spigot 和 Paper 服务器的现代化 Essentials 插件套件支持 Minecraft 1.8.8 到 1.21.x 版本。家园、传送、经济、权限、管理命令一个插件包揽 Minecraft 服务器管理的日常工作。上手之前EssentialsX 版本选择与最低要求做完这一节你手上有一套不会踩兼容性坑的服务器环境。最低环境要求服务器软件用 CraftBukkit、Spigot 或 Paper官方只测试过这三家其余软件不保证可用。Java 8 起步直接装你服务器软件支持的最新 Java。小服内存至少留 1GB。版本兼容速查最新正式版 EssentialsX2.22.0覆盖 Minecraft 1.8.8 至 1.21.11 及之后的版本。选 Paper 版本时按下表对应Minecraft 版本推荐服务器软件1.8.8 – 1.12.2Spigot / Paper 1.12.21.13.2 – 1.16.5Paper 1.16.51.17.1 – 1.20.6Paper 1.20.61.21.x 及以上Paper 1.21.11原则挑一个你熟悉的 Paper 版本EssentialsX 用最新正式版即可。配套插件Vault 与 LuckPerms再装两个插件。Vault 是聊天前后缀和权限组功能的前置权限管理官方推荐 LuckPerms。EssentialsX 安装位置与启动命令做完这一节服务器日志里会看到 Essentials 加载成功游戏里 /ess 能正常响应。安装预编译 JAR从官网下载最新正式版 JARREADME.md 里有官方下载地址放入服务器plugins/目录然后启动cp EssentialsX-2.22.0.jar /path/to/server/plugins/ java -Xms2G -Xmx4G -jar paper-1.21.11.jar nogui源码构建要改代码或跟开发版就走这条线。克隆仓库后执行./gradlew buildWindows 用gradlew.bat build产物统一落在jars/目录每个模块一个 JARgit clone https://gitcode.com/GitHub_Trending/es/Essentials cd Essentials ./gradlew build启动验证进游戏执行/essentials version能看到版本信息即成功。之后/ess等缩写命令也都能用。EssentialsX 首次启动配置最先要改的三处做完这一节配置有了中文界面、权限后端和经济参数可以交给玩家使用了。自动生成的配置文件首次启动会在plugins/Essentials/下生成一批文件config.yml是主配置items.json是物品数据库worth.yml管物品价值kits.yml是礼包模板motd.txt、rules.txt是公告和规则文本userdata/存玩家数据。默认值都带注释边看边改。中文与权限后端打开config.yml先确认这两项locale: zh # 中文消息 use-bukkit-permissions: true # 使用服务器权限系统use-bukkit-permissions默认就是 true别手滑关掉否则 EssentialsX 会退回自带的配置式权限LuckPerms 的通配符节点会全部失效。经济与传送参数挑最常用的几个键改掉然后执行/essentials reload生效starting-balance: 100.0 # 起始余额 currency-symbol: ¥ # 货币符号 max-money: 100000000 # 余额上限 economy-log-enabled: true # 经济流水写入日志 teleport-cooldown: 10 # /home、/tp 等命令冷却秒完整键表见源码里的 config.yml注释齐全。按场景挑模块聊天、多世界与保护做完这一节你的服务器在核心功能之外还能按需叠加聊天格式化、多世界重生和保护规则。EssentialsChat 聊天格式化核心模块只管前后缀聊天格式、分组格式这些规则在 EssentialsChat 的config.yml里。要精细控制聊天就装不折腾聊天就别装。EssentialsSpawn 多世界重生/setspawn给每个世界定一个重生点/spawn传送过去。单世界服务器用不上多世界服必装模块代码在 EssentialsSpawn/。EssentialsProtect 与 EssentialsAntiBuild两层防线。Protect 管什么不能动方块、实体、天气类保护规则AntiBuild 管玩家能建什么比如限制创造模式破坏、禁止刷物品。生存服建议两个都装配置键各自独立按注释开关即可。其余模块一瞥EssentialsGeoIP 提供玩家地区信息EssentialsDiscord 把游戏内聊天和 Discord 打通EssentialsXMPP 面向企业 IM 场景。按需安装不用的模块别放插件目录。进阶玩法命令别名、权限组与 API 集成做完这一节你有更短的自定义命令、清晰的分组权限边界自己的插件也能读玩家数据。自定义命令别名内置别名已经够用比如/eco自带eeco、economy缩写。想全局加别名在服务器软件的server.yml里声明aliases: myhome: [home]重启服务器生效不用改插件本身。LuckPerms 权限组按组发权限别逐个玩家发。家园数量尤其值得留意先在config.yml里定义 home rank再给对应权限节点# LuckPerms 权限组示例permissions.yml groups: vip: permissions: essentials.home: true essentials.sethome.multiple.vip: true # vip 家园档位自己的插件接入 EssentialsX API构建系统里加依赖坐标是 groupnet.essentialsx、artifactEssentialsX、版本2.22.02.19.0 之前 group 是net.ess3升级时别抄错。之后就能在代码里读玩家数据Essentials ess (Essentials) Bukkit.getPluginManager().getPlugin(Essentials); User user ess.getUser(player.getUniqueId()); BigDecimal balance user.getMoney(); // 查询余额 user.sendTl(welcomeMessage); // 发送可翻译消息 user.getAsyncTeleport().teleport(location, null, TeleportCause.COMMAND); // 异步传送高频 EssentialsX 问题与解法做完这一节四种最常见的故障你都能对号入座。现象启动后插件没加载原因Java 版本过老或服务器软件不是 Spigot/Paper 系。解法确认 Java 8 以上建议最新换 Paper 验证再检查日志里有没有旧插件的版本冲突报错。现象经济系统不工作原因没装 VaultEssentialsX 是通过 Vault 对接经济后端的。解法装上 Vault 和经济后端插件重启服务器。现象聊天前后缀不显示原因缺 Vault或change-displayname被关掉了。解法装好 Vault确认config.yml里change-displayname: true改完执行/essentials reload。现象通配符权限不生效原因权限没走 Bukkit 通道。解法确认use-bukkit-permissions: true否则 EssentialsX 只认自带的配置式权限LuckPerms 发的节点全部被忽略。长期稳定运行备份、监控与安全做完这一节你有备份预案、监控基线和安全底线服务器能安稳跑几个月。玩家数据备份策略每次大更新前整目录备份plugins/Essentials/userdata/里的玩家数据是核心一行tar -czf essentials-backup.tar.gz plugins/Essentials就够。多服架构下数据库与权限中心可以共享但 EssentialsX 本身每个服独立装。监控关键指标盯三个数TPS低于 18 就要查原因、服务器内存长期超 85% 就该加-Xmx、命令响应时间。经济流水日志开一段时间方便追查余额异常。安全要点最小权限给玩家只发需要的节点别图省事发essentials.*仅限最高管理组。/tempban、/nuke这类敏感命令只给管理组经济上把min-money和max-money设成合理值堵住刷钱漏洞。版本升级步骤先备份再替换新 JAR重启即可。EssentialsX 启动时会自动迁移旧配置跨度大的版本升级动手前看一眼官方更新说明确认没有配置项变更。【免费下载链接】EssentialsThe modern Essentials suite for Spigot and Paper.项目地址: https://gitcode.com/GitHub_Trending/es/Essentials创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
