基本信息
我的世界Java版本
平台
运行环境
搬运团队
搬运资源声明
对于可进行 JAR 文件搬运的许可证,我们提供站内下载服务;其他资源会跳转到原帖下载。资源更新可能不及时,建议前往资源内提供的原帖链接下载最新版本。
详情信息
更新日志
🎉 万众期待,EssentialsX 2.22.0 正式发布!本次更新为运行 Minecraft 26.1.2 和 1.21.11 的服务器带来了对 铜器时代、疯狂坐骑 以及 微缩入侵 等内容的支持,并新增了大量功能、修复了诸多漏洞,同时为开发者提供了全新的 API!
EssentialsX 2.22.0 修复了多个物品复制及服务器崩溃漏洞。 所有用户均应升级至本版本。
衷心感谢所有为本次发布贡献代码的开发者(其中许多人在本公告末尾列出),以及所有在 Crowdin 上参与翻译工作的志愿者!
此外,特别感谢 GitHub 和 MOSS 社区中长期协助无数用户使用 EssentialsX 的社区成员,包括 @Evidentsinger14、@JasonHorkles、@Chew 及众多其他热心人士。
EssentialsX 项目由整个社区共同驱动。若您希望支持我们,可通过以下方式贡献力量:
最后,向我们的 Patreon 与 GitHub Sponsors 支持者致以诚挚谢意!
特别鸣谢“英雄”等级支持者:
- AKP
- @aternosorg
- @pebblehost
- 以及一位匿名支持者!
您的支持让我们得以持续投入大量业余时间,不断优化与完善 EssentialsX,惠及每一位玩家。若您手头尚有余力,欢迎点击下方任一按钮,通过一次性或按月捐赠的方式支持 EssentialsX 项目:
支持的服务器版本
EssentialsX 官方支持 Paper 服务端软件。具体而言,EssentialsX 针以下 Minecraft 版本进行了适配与优化:
- ✅
26.1.2— EssentialsX 当前正积极开发并全面支持该版本。 - ⚠️
1.8.8、1.9.4、1.10.2、1.11.2、1.12.2、1.13.2、1.14.4、1.15.2、1.16.5、1.17.1、1.18.2、1.19.4、1.20.6与1.21.11— 这些版本仍受支持,但非当前开发重点,未来版本中可能被移除。 - ⚠️ Spigot 仍受支持,但优先级较低,未来版本中亦可能被移除。
我们强烈推荐使用最新版 Paper。 EssentialsX 包含多项关键改进,仅在 Paper 上可用,包括:
- Paper 的异步区块加载可显著降低玩家传送时的卡顿;CraftBukkit 与 Spigot 不支持插件调用异步区块加载。
/anvil、/grindstone、/cartographytable、/loom、/smithingtable与/stonecutter命令仅在 Paper 上受支持;CraftBukkit 与 Spigot 缺少实现这些命令所需的 API。- 1.12+ 版本中的
/recipe命令需依赖 Paper,以规避 CraftBukkit 与 Spigot 引入的物品复制漏洞。 - Paper 相较 CraftBukkit 与 Spigot,在整体性能上拥有大量优化。
EssentialsX 不支持以下 Minecraft 版本或服务端软件:
- ℹ️ Folia 尚未支持。 我们正在积极推进 Folia 兼容性工作。
请勿尝试在 Folia 或其衍生版本上运行当前 EssentialsX,否则可能导致用户数据丢失。 - 🛑 Akarin、Yatopia 等标榜“超高性能”的 Paper 衍生版本;
此类项目常存在非标准行为,可能损坏世界存档及已安装插件。 - 🛑 Mohist 及其相关项目 — Mohist 项目已被证实存在风险,过去曾诱导用户删除官方 EssentialsX JAR 文件并安装非官方构建版本。
我们无法保证非官方 EssentialsX 构建版本的安全性与功能性,请尽可能避免使用 Mohist。 - 🛑 Cauldron、Thermos、Magma、CatServer、Arclight 等 Forge/Bukkit 混合服务端 — EssentialsX 基于 Bukkit API 构建,而该 API 无法正确支持模组;
对于运行 Minecraft Forge、NeoForge 或 Fabric 的模组化服务器,请使用 FTB Essentials。 - 🛑
1.7.10及更早版本。
升级至 2.22.0
若您从 2.21.1 或 2.22.1 升级,可继续沿用当前 EssentialsX 配置文件。不过,2.22.0 新增了若干可选配置项,您可能希望进行自定义。您可将这些选项手动添加至现有配置文件中,或重命名当前配置文件以生成全新默认配置。下文将详细介绍新增配置项。
若您是从 2.21.0 或更早版本升级,请参阅 历史更新日志。
已知问题
末地重生锚充能会在 Spigot 上耗尽,即使 EssentialsX 已覆盖出生点
在 CraftBukkit 与 Spigot 上,无论是否启用 respawn-at-anchor,末地重生锚充能均会耗尽,这是由于 CraftBukkit 中一个尚未修复的漏洞 所致。该漏洞已在 Paper 中修复。
Spigot 上跨维度传送时飞行状态会被重置
在 Spigot 1.17.1 及更高版本中,玩家飞行状态将无视 world-change-fly-reset 设置而被强制重置,此为原版行为变更所致。该问题已在 Paper 服务端中修复。(#6012)
新增功能
EssentialsX 现已支持 26.1.2 与 1.21.11(#6299、#6364、#6473、#6534)
EssentialsX 现已正式支持 Paper 26.1.2 与 1.21.11,涵盖 Minecraft 最新特性更新中新增的所有方块、物品、生物与附魔。
新增 config.yml 选项:afk-timeout-command(#6169)
您现在可指定一个或多个命令,在 AFK 超时后自动执行,取代旧版 auto-afk-kick 配置项。
# 此超时(单位:秒)到期后,玩家将被踢出服务器,
# 或执行 'afk-timeout-commands' 中定义的命令。
# 'essentials.afk.kickexempt' 权限可覆盖此功能。
# 设为 -1 表示禁用超时。
auto-afk-timeout: -1
# 当上述 'afk-auto-timeout' 设定的阈值达到时,将执行此处列出的命令,
# 替代直接踢出玩家。若该列表为空且 'afk-auto-timeout' 未设为 -1,
# Essentials 将默认踢出玩家。
#
# 警告:此处必须包含一条可将玩家移出服务器或终止其 AFK 状态的命令。
# 否则,这些命令将持续每秒执行,直至玩家结束 AFK 状态!
#
# 可用占位符:
# {USERNAME} — 玩家用户名。
# {KICKTIME} — 玩家处于 AFK 状态的时间(单位:分钟)。
afk-timeout-commands:
- eco take {USERNAME} 10
- kick {USERNAME} 您因连续 {KICKTIME} 分钟未操作已被踢出!已扣除 $10。
若您希望维持经典行为(即以标准消息踢出玩家),可继续在 auto-afk-timeout 下设置超时时间,同时保持 afk-timeout-commands 列表为空。
新增命令:/powertoollist(#6096)
您现在可通过 /powertoollist 命令列出所有通过 /powertool 绑定至工具的命令:
新增权限:essentials.whitelist.bypass(#6232)
您现在可授予 essentials.whitelist.bypass 权限,使玩家在白名单启用时绕过白名单限制。即使该玩家未被列入白名单,此权限依然生效。
新增 config.yml 选项:gamemode-change-preserve-flying
您现在可选择当玩家在飞行状态下由飞行模式(旁观者或创造模式)切换至非飞行模式(生存或冒险模式)时,EssentialsX 是否保留其飞行状态。
# EssentialsX 在玩家切换游戏模式时是否保留其飞行状态?
# 启用后,若玩家在切换模式时处于飞行状态,则其飞行状态将被保留。
# 此功能仅在玩家拥有 'essentials.fly' 权限时生效。
gamemode-change-preserve-flying: false
新增 config.yml 选项:baltop-entry-limit(#6300、#6306)
您现在可通过 /balancetop 限制缓存条目数量,从而降低高活跃玩家数服务器的内存占用。
# 限制 /balancetop 缓存的排行榜条目数量。
# 推荐用于玩家数量庞大的服务器,以降低内存占用。
# 设为 -1 表示禁用限制。
baltop-entry-limit: -1
套装现支持将物品放置至特定槽位(#5794)
您现在可在套装物品定义开头添加 slot:<id>,以将物品放入指定物品栏槽位。
此功能适用于 /createkit,无论采用 NBT 序列化还是传统 ItemMeta 语法均可使用,亦可为已有套装添加。
kits:
meleeminer:
delay: 10
items:
- slot:0 diamond_sword 1
- slot:1 netherite_spear 1
- slot:2 torch 64
- slot:3 cooked_beef 12
- slot:6 golden_pickaxe 1
- slot:7 cobblestone 32
- slot:8 white_wool 32
新增命令:/unmute(#6491)
此前,解除玩家禁言需再次执行 /mute <player>,这在脚本调用中易导致误操作(如意外重新禁言)。
现在您可直接执行 /unmute <player>,确保绝不会误禁言。
新增命令:/jailedplayers(#6517)
全新 /jailedplayers 命令可完整列出当前所有被监禁的玩家。
新增配置项:reset-nick-on-name-change(#6470)
您现在可启用此选项,使玩家在更改 Minecraft 用户名并重新登录后,其服务器昵称自动重置。
# 启用此选项后,玩家所设置的昵称将在其 Minecraft 账户名称变更时被重置。
# 此举可防止旧昵称(包括 RGB 格式昵称)在改名后继续残留。
reset-nick-on-name-change: false
其他新增内容
/potion命令现支持为药水箭附加药水效果。(#6191)/heal命令现可恢复玩家氧气值。(#6201)economy-log-uuids设置现允许在trade.log文件中输出 UUID 而非用户名。(#6252)essentials.seen.firstlogin权限现允许/seen命令显示玩家首次加入服务器的日期。(#6258)- EssentialsX 现在直接通过 LuckPerms 的 API 读取群组名称(而非依赖 LuckPerms 的 Vault 集成)。旧群组名称仍保留在列表中以确保向后兼容。(#6229)
- 您现在可在 EssentialsX 命令中使用
@s与@p选择器,指代当前执行命令的玩家。(#6110) /give、/item与套装元数据现已支持护甲夹板图案。(#6155)- EssentialsX 现利用 Paper 的配置阶段 API,在玩家进入世界前异步加载用户数据。(#6248)
/recipe命令现可显示crafting_transmute类配方(例如使用染料重染捆包)。(#6302)- 您现在可通过
log-console-commands配置项,屏蔽控制台与 RCON 发出命令时的标准提示 “CONSOLE issued server command: ...”。(#6337) - 当用户在临时 IP 封禁期结束后尝试加入时,封禁信息中将显示确切过期时间。(#6407)
/essentials命令已大幅重构,以提升代码质量。(#6230、#6481)/gc命令在 Paper 服务器上调用速度更快。(#6439)- EssentialsX 现在在可用时直接调用 Paper 原生 Adventure API 函数。(#6220)
- 您现在可通过
cancel-afk-on-fish配置项禁止玩家在 AFK 状态下钓鱼。(#6465) - EssentialsX 现可在玩家退出后重新加入服务器时,恢复其自定义飞行状态。(#6403)
- 默认昵称长度限制已从 15 提升至 16,以匹配 Minecraft 用户名长度上限。(#6484)
- 您现在可通过在 语言文件 中设置
socialSpyCmdFormat键,自定义 SocialSpy 中玩家命令的显示格式。(#6489) - 您现在可通过授予
essentials.vanish.pickup权限,在/vanish模式下禁用拾取物品功能。(#6488) - 当玩家传送目标位置不安全时,默认提示消息已优化。您仍可照常在 语言文件 中修改该提示。(#6486)
- 隐身玩家将不再广播进度成就消息。此功能需运行 Paper 的服务器支持。(#6513)
- Discord: 您现在可在
avatar-url配置项中使用 PlaceholderAPI 占位符。(#6189) - Discord: 您现在可通过
http-proxy-server配置项,为插件连接 Discord 设置 HTTP 代理。(#6275) - Discord: 插件现会在 Discord 机器人缺失必要权限时发出警告。(#6228)
- Discord: 控制台中继过滤器现同样应用于日志器名称。(#6383)
- Geo: 加入消息现将同时输出至控制台与管理员,而不仅限于管理员。(#6523)
- Protect: 您现在可通过将
protect.prevent.windcharge-explosion设为false,禁用风弹的击退效果。(#6183)
漏洞修复
自 2.21.2 及更早版本修复的漏洞
/back的死亡地点不再因其他插件取消死亡事件而被覆盖。(#6179)- 玩家在
/invsee模式下无法再通过点击拖拽移动物品,避免潜在物品丢失。(#5902) - EssentialsX 现可正确解析快照版本号,以及 Mojang 与 Paper 的新版命名方案。(#6265、#6473、#6480、#6483、#6501)
- 只读模式
/invsee访问权限不再因频繁垃圾回收而降级为完全编辑权限。(#
... [内容过长已截断]





