EssentialsX
EssentialsX 是面向 Spigot 和 Paper 服务器的必备插件套件,包含超过 130 条命令以及适用于各种规模服务器的无数功能!
EssentialsX 是原版 Bukkit Essentials 套件的现代延续,支持最新的 Minecraft 版本。 EssentialsX 还在原版 Essentials 的基础上包含多项性能增强和修复,以及大量全新且实用的服务器功能。 你可以在 EssentialsX 网站上查看主要差异并了解如何配置 EssentialsX。
要求
- EssentialsX 设计为使用现代权限插件——我们强烈推荐 LuckPerms。你还需要 Vault 来支持前缀/后缀。
- EssentialsX 目前支持 CraftBukkit、Spigot 和 Paper(推荐)。其他服务器实现或许可用,但我们不推荐,因为它们可能导致兼容性问题。
- EssentialsX 官方支持 Minecraft 1.19.4 和 1.18.2,并且也能在低至 1.8.8 的旧版本上运行。
支持
需要 EssentialsX 的帮助?你可以加入 Discord 上的 MOSS 服务器,获得社区支持。你也可以在 GitHub 上发起讨论或报告缺陷。
捐赠
EssentialsX 完全免费提供。如果你想支持 EssentialsX 项目,可以在 Patreon 或 GitHub Sponsors 上进行定期捐赠,或在 Ko-fi 上进行一次性捐赠。
如果你无法捐赠,我们非常希望你能在 GitHub 上给我们点个 star。你也可以加入 MOSS 来帮助其他 EssentialsX 用户。
数据收集
EssentialsX 通过 bStats 收集匿名服务器统计数据,这是一个面向 Minecraft 软件的开源统计服务。你可以在 plugins/bStats/config.yml 中选择退出。
参与贡献
EssentialsX 是一个在 GPLv3 许可证下发布的开源项目,我们欢迎在我们的 GitHub 上贡献代码。 我们的翻译也是众包的,因此如果你想帮助将 EssentialsX 带到你的语言,可以在 Crowdin 上参与。 最后,如果你想帮助其他用户配置和使用 EssentialsX,可以加入我们的 MOSS 和 GitHub Discussions。
EssentialsX
EssentialsX is the essential plugin suite for Spigot and Paper servers, including over 130 commands and countless features for servers of any scale!
EssentialsX is a modern continuation of the original Essentials suite for Bukkit, with support for the latest Minecraft versions.
EssentialsX also includes several performance enhancements and fixes on top of the original Essentials, as well as plenty of new useful features for servers.
You can view major differences and learn how to set EssentialsX up over at the EssentialsX website.
Requirements
- EssentialsX is designed to use modern permissions plugins - we strongly recommend LuckPerms. You also need Vault for prefix/suffix support.
- EssentialsX currently supports CraftBukkit, Spigot and Paper (recommended). Other server implementations may work, but we don’t recommend them as they may cause compatibility issues.
- EssentialsX officially supports Minecraft 1.19.4 and 1.18.2, and also runs on older versions dating back to 1.8.8.
Support
Looking for help with EssentialsX? You can join the MOSS server on Discord for community-powered support. You can also start a discussion or report bugs on GitHub.
Donate
EssentialsX is provided completely free-of-charge. If you’d like to support the EssentialsX project, you can make a recurring donation on Patreon or GitHub Sponsors, or make a one-off donation on Ko-fi.
If you’re not able to donate, we’d really appreciate if you could give us a star on GitHub. You can also join MOSS to help out other EssentialsX users.
Metrics collection
EssentialsX collects anonymous server statistics through bStats, an open-source statistics service for Minecraft software. You can opt out in plugins/bStats/config.yml.
Contributing
EssentialsX is an open source project released under the GPLv3 license, and we welcome code contributions on our GitHub.
Our translations are also crowd-sourced, so if you’d like to help bring EssentialsX to your language, you can do so on Crowdin.
Finally, if you want to help other users out with setting up and using EssentialsX, you can join us on MOSS and GitHub Discussions.
下载 EssentialsX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EssentialsX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EssentialsX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EssentialsX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EssentialsX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EssentialsX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EssentialsX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EssentialsX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
? 千呼万唤始出来,EssentialsX 2.22.0 正式发布!此版本为运行 Minecraft 26.1.2 和 1.21.11 的服务器带来了对 The Copper Age、Mounts of Mayhem 和 Tiny Takeover 更新内容的支持,同时还包含大量新功能、错误修复以及面向开发者的全新 API!
EssentialsX 2.22.0 修复了若干物品复制和服务器崩溃漏洞。 所有用户都应升级到此版本。
感谢所有为本版本贡献代码的人(其中许多人在本发布说明底部列出),也感谢所有在 Crowdin 上贡献翻译的人!
此外,特别感谢我们的社区成员,他们在 GitHub 和 MOSS 上帮助了无数用户,包括 @Evidentsinger14、@JasonHorkles、@Chew 以及许多其他人。
EssentialsX 项目由社区驱动。如果你想帮助我们,可以通过以下方式做出贡献:
最后,向我们在 Patreon 和 GitHub Sponsors 上的支持者致敬!
特别感谢我们的 Hero 级支持者:
- 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 引入的复制漏洞。 - 相比 CraftBukkit 和 Spigot,Paper 包含大量整体性能优化。
EssentialsX 不支持以下 Minecraft 版本或服务端软件:
- ℹ️ 暂不支持 Folia。 我们正在开发对 Folia 的正式支持。 请勿尝试在 Folia 或 Folia 的衍生版本上使用当前版本的 EssentialsX——你可能会丢失用户数据。
- ? 包括 Akarin、Yatopia 及类似项目的“超高性能”Paper 衍生版本。
这些版本通常会执行非标准行为,可能破坏你的世界和已安装的插件。 - ? Mohist 及其相关项目——Mohist 项目已知存在欺诈行为,过去曾诱骗用户删除官方 EssentialsX jar 并安装非官方构建。
我们无法保证 EssentialsX 非官方构建的安全性或功能;应尽可能避免使用 Mohist。 - ? 其他 Forge/Bukkit 混合服务端,包括 Cauldron、Thermos、Magma、CatServer、Arclight——EssentialsX 基于 Bukkit API 构建,而 Bukkit API 无法正确支持模组。
对于运行 Minecraft Forge、NeoForge 或 Fabric 的模组服务器,应使用 FTB Essentials。 - ?
1.7.10或更低版本。
升级到 2.22.0
如果你从 2.21.1 或 2.21.2 升级,可以保留当前的 EssentialsX 配置文件。不过,2.22.0 新增了一些你可能需要配置的选项。你可以将这些选项添加到现有配置文件中,或者重命名当前配置文件以生成全新配置。继续阅读以了解新配置选项的详情。
从 2.21.0 或更早版本的 EssentialsX 升级?请参阅之前的更新日志。
已知问题
在 Spigot 上,即使 EssentialsX Spawn 覆盖了出生点位置,锚点充能仍会消耗
在 CraftBukkit 和 Spigot 上,由于 CraftBukkit 中未修复的错误,无论 respawn-at-anchor 如何设置,锚点充能都会消耗。此错误已在 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 配置选项。
# After this timeout in seconds, the player will either be kicked from
# the server or commands in 'afk-timeout-commands' will be executed.
# The 'essentials.afk.kickexempt' permission overrides this feature.
# Set to -1 for no timeout.
auto-afk-timeout: -1
# A list of commands to be executed instead of kicking the player once the
# threshold defined above in 'afk-auto-timeout' is reached. If this list is empty
# and 'afk-auto-timeout' is not set to -1, Essentials will default to
# kicking the player once they reach the timeout threshold.
#
# WARNING: You must include a command here that either removes the player from the server
# or stops them from being AFK. Otherwise, these commands will run every second
# until the player is no longer AFK!
#
# Available placeholders:
# {USERNAME} - The player's username.
# {KICKTIME} - The time, in minutes, the player has been AFK for.
afk-timeout-commands:
- eco take {USERNAME} 10
- kick {USERNAME} You have been kicked for being inactive for {KICKTIME} minutes! You lost $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 是否在玩家飞行时从可飞行游戏模式(旁观或创造)切换到不可飞行游戏模式(生存或冒险)时保留玩家的飞行状态。
# Should Essentials preserve a player's flight status when they change game modes?
# When enabled, if a player is flying when switching game modes, their flight will be maintained.
# This will only work if the player has the 'essentials.fly' permission.
gamemode-change-preserve-flying: false
新增 config.yml 选项:baltop-entry-limit(#6300、#6306)
你现在可以限制 /balancetop 存储的条目数量,以减少历史玩家数量较多的服务器的内存占用。
# Limit the number of cached balance top entries.
# Recommended for servers with a large number of players, as it reduces memory usage.
# Set to -1 to disable the limit.
baltop-entry-limit: -1
礼包现支持将物品放置在特定槽位(#5794)
你现在可以在礼包中物品定义的开头添加 slot:<id>,以将物品放入特定的物品栏槽位。
无论使用 NBT 序列化还是经典的 ItemMeta 语法,在使用 /createkit 时都可以生效。你也可以将其添加到现有的礼包中。
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 用户名后登录时,服务器上的昵称被重置。
# When this option is enabled, any nickname set by a player will be reset when their Minecraft account name changes.
# This prevents old nicknames (including RGB-formatted ones) from persisting after a name change.
reset-nick-on-name-change: false
其他新增内容
/potion命令现在允许将药水效果施加到药箭上。(#6191)/heal命令现在会恢复你的氧气水平。(#6201)economy-log-uuids设置现在允许你将 UUID 而非用户名打印到trade.log文件中。(#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配置选项来阻止挂机玩家钓鱼。(#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 来禁用风 charge 的击退效果。(#6183)
问题修复
从 2.21.2 及更早版本修复的问题
- 当其他插件已取消死亡事件时,用于
/back的死亡位置不再被覆盖。(#6179) - 玩家在使用
/invsee时无法再通过点击拖拽来移动物品,从而防止潜在的物品丢失。(#5902) - EssentialsX 现在可以解析快照版本的 Minecraft 版本名称,以及 Mojang 和 Paper 的新版本命名方案。(#6265、#6473、#6480、#6483、#6501)
- 只读的
/invsee访问权限在经历大量垃圾回收后,不再会降级为完整的修改权限。(#6241、#6247) /potion命令现在能正确地将-1解析为药水效果的无限持续时间。(#6236)- 命令参数中的模糊/部分名称解析现在更加可靠。(#6263)
/tpr命令现在在/settpr运行并更改/tpr设置后,能正确地重置其缓存的位置列表。(#6305)- 当未设置自定义消息时,EssentialsX 不再替换原版加入消息,从而让原版翻译后的消息正确显示。(#6312)
- Configurate 重构中的若干问题已解决。(#6266)
- UUID 缓存现在会缓冲磁盘读写。(#6338)
/heal命令在对自己执行时不再发送重复消息。(#6347)- 在 Spigot 上检查服务器状态不再失败。(#6377)
/helpop命令现在从控制台运行时能正确显示消息。(#6342)/balance不再泄露玩家是否处于隐身状态。(#6085)- 获取权限处理器不再抛出 NullPointerException。(#6398)
- 获取离线玩家的语言区域不再抛出 NullPointerException。(#6435)
/nick命令现在在玩家昵称被移除时能正确显示相应的消息。(#6442)/give命令不再能被用于使服务器卡死。(#6449)/burn和/more命令现在更能抵御整数溢出漏洞利用。(#6452)/thunder命令现在能正确在其输出中显示 MiniMessage。(#6454)- 玩家睡眠时不能再使用
/recipe命令来刷出无限钻石。(#6455) /setwarp命令不再允许玩家通过尝试将传送点坐标打印到连接服务器主机的打印机上,来使运行在 Windows 上的服务器卡死或崩溃。(#6487)/walkspeed和/flyspeed(以及类似的别名)现在总是专门修改行走或飞行速度。(#6485)/eco命令现在遵循特定语言区域的小数分隔符,包括按玩家语言区域设置(若启用)。(#6511)/time命令不再覆盖玩家自己的/ptime设置。(#6509)- 命令描述现在在
/help和使用说明消息中按玩家的语言区域打印。(#6508) - 在 SocialSpy 中打印本地聊天时,玩家的显示名称格式不再溢出到玩家名称之外。(#6507)
- 礼包中的命令在关键词替换期间不再错误地将下划线转换为空格。(#6514)
- 控制台名称现在能从
consoleName翻译键正确读取。(#6506) - 运行
/home bed现在会正确地确保玩家拥有essentials.home.bed权限后再传送玩家。(#6516) - 当玩家余额低于最低限额时,经济存款(余额增加)不再被拒绝。(#6515)
- 已从不存在的
plugin.yml中移除essentials.jail权限。(#6539) - AntiBuild:剪刀交互现在能正确处理。(#6262)
- Chat:
%符号不再导致聊天处理抛出异常。(#6452) - Discord:如果
announceAdvancements游戏规则设为 false,进度消息不再发送到 Discord。(#6195) - Discord:从 Discord 向 Minecraft 发送私信时不再包含空的识别码标签。(#6383)
- Discord:Webhook 现在触发 Discord 速率限制(HTTP 错误 429)的可能性大大降低。(#6461)
- Discord:由于历史参数混淆,虚假的加入和退出消息不再抛出 NullPointerException。(#6510)
- Discord Link:角色同步现在触发 Discord 速率限制(HTTP 错误 429)的可能性大大降低。(#6461)
- Discord Link:角色同步在插件关闭时不再留下后台运行的线程。(#6512)
- Spawn:在 Minecraft 1.16.x-1.20.3 上获取玩家的重生位置不再抛出异常。(#6460)
从 2.22.0 开发构建中修复的回归问题
以下来自 2.22.0 开发构建的 bug 已修复:
afk-timeout-commands中列出的命令不再被强制转为小写。(#6255)essentials.powertoollist不再从plugin.yml中遗漏。(#6250)- 玩家登出时现在从在线用户缓存中移除,而不是从持久化的 UUID 映射中移除。(#6284、#6286)
- EssentialsX 在玩家首次加入时不再抛出异常。(#6327)
TeleportWarmupCancelledEvent现在会跟踪调用它的线程,以防止每次触发时抛出异常。(#6371)- 即使服务器未满,没有
essentials.joinfullserver权限的玩家也不再被踢出。(#6426) /ess reload命令再次可用。(#6444)- Bukkit 级别的插件重载更不容易破坏
/essentials命令。(#6445) - 当玩家在水中登录时,飞行不再被重新启用。(#6490)
- EssentialsX 不再在点击处理器中双重包裹 URL,否则会在 Paper 上记录错误。(#6492)
/list命令现在能解析玩家显示名称中的 MiniMessage 标签。(#6505)- Discord:
emoji-java库现已再次正确包含在插件中。(#6467)
面向开发者的更改
新 API:自定义物品转换器(#4871)
终于,你现在可以从外部插件注册自定义物品元数据类型。这些元数据类型将在 /give、/item 和礼包中被识别。更多信息请参阅 MetaItemStack#registerItemTransformer。
EssentialsX 延迟捕获 PlayerDeathEvent 并忽略已取消的事件 (#6179)
EssentialsX 现在以 EventPriority.HIGH 监听 PlayerDeathEvent 并忽略已取消的事件。这意味着它不再为已取消的死亡事件设置死亡消息。
你仍然可以使用 EventPriority.HIGHEST 在 EssentialsX 修改事件之后取消或修改这些事件。
新事件:TeleportWarmupCancelledEvent (#6351, #6371)
新的 TeleportWarmupCancelledEvent 在传送预热被取消时触发(例如玩家在预热期间移动)。
新事件:PreTransactionEvent (#6370)
新的 PreTransactionEvent 在玩家之间进行交易之前触发。你可以使用该事件修改交易金额或取消事件以阻止交易。有关如何使用此事件的示例,请参阅原始拉取请求。
注意:VanishStatusChangeEvent 中的参数错误 (#6510)
VanishStatusChangeEvent#getController 和 VanishStatusChangeEvent#getAffected 的值一直是错误地对调的。
为了保持与使用这些函数的现有插件的兼容性,我们没有更改它们的返回值。相反,这一错误行为现已在类本身上记录以供参考。
由于纠正此错误将是一项破坏性变更,因此只有在 API 主版本递增后才会进行纠正。
完整的提交日志,请点击此处。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
使床在所有维度中爆炸的模组
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
评论 0
登录后参与评分
还没有评论,来抢沙发吧