NeoEssentials
NeoEssentials 是一款全面、配置驱动的 Minecraft NeoForge 1.21.1 - 1.21.11 服务器基础功能模组。它提供 50 多种命令、图形界面工具、高级管理功能以及实时 Web 仪表盘——所有功能均由模块化 JSON 配置文件和标准化文档进行管理。
? 概述
NeoEssentials 为 NeoForge 服务器带来了必要的服务器管理、玩家实用工具和高级管理员功能。所有功能均经过严格文档化,并由配置文件驱动,以确保可靠性和透明度。
仅服务端:无需客户端安装——可与原版客户端配合使用。 50+ 命令:涵盖所有主要的服务器功能、实用程序和 Moderation(管理)。 现代 UI:支持 GUI 命令、颜色代码支持和 Web 仪表盘。
✨ 核心系统与特性
- 经济系统:玩家余额、支付、套件(Kits)和商店支持。
- 聊天与消息:私聊、邮件、忽略/社交间谍、AFK 系统。
- Moderation(管理):封禁、踢出、静音、监禁、隐身、冻结、sudo(强制执行)、玩家数据。
- 传送系统:家园、传送点、出生点、传送请求、返回系统。
- 套件管理:可配置的道具套件,支持冷却时间和预览。
- Web 仪表盘:实时服务器监控、配置编辑、API 端点。
- 权限系统:支持 LuckPerms、FTB Ranks 及内置支持。
- 物品管理:生成物品、修复、附魔、clearinventory(清空背包)、powertool(右键触发命令)。
- 实用系统:昵称、MOTD(每日公告)、near(附近)、ping、depth(深度)、helpop(紧急求助)、规则、自杀等。
- API 与占位符系统:PlaceholderAPI 集成、自定义占位符、REST API 端点。
? 文档
从 Home 开始,获取完整的、由配置驱动的文档中心。所有主要系统均已文档化并标准化,以匹配代码库和配置文件:
- EconomySystem
- ChatSystem
- ModerationSystem
- TeleportationSystem
- KitManagement
- WebDashboard
- PermissionSystem
- ItemManagement
- UtilitySystems
- APISystem
- AFKSystem
查看 APISystem 以获取 API 与占位符系统的详细信息,包括:
- 用于动态文本的 PlaceholderAPI 集成
- 自定义和扩展占位符
- 用于服务器状态、玩家信息、日志、配置、事件和统计信息的 Web 仪表盘 REST API 端点
- API 功能的权限和配置选项
? 快速入门
安装
- 下载最新版本
- 将 JAR 文件放入服务器的
mods文件夹中 - 启动服务器以在
config/neoessentials/中生成配置文件 - 根据需要配置权限和功能
- 重启服务器以应用更改
基本配置文件
config/neoessentials/
├── config.json # 主配置设置
├── permissions.json # 权限系统设置
├── language/ # 语言文件目录
├── shops.json # 商店系统配置
└── settings.json # 其他模组设置
快速权限设置
对于 LuckPerms 用户:
/lp group admin permission set neoessentials.admin true
/lp group moderator permission set neoessentials.moderator true
/lp group default permission set neoessentials.player true
? 命令参考
请参阅 Home 和上述各个系统文档,以获取完整的命令列表和配置选项。
? 配置示例
所有功能均由模块化 JSON 配置文件管理。有关详细信息,请参阅 Home 和上述系统文档。
? Modder API 集成
请参阅 APISystem 以获取完整的 API 和 PlaceholderAPI 文档,包括:
- 注册自定义占位符
- 使用 REST API 端点获取服务器数据
- 用于模组集成的经济 API
? 集成与兼容性
- 支持 LuckPerms 和 FTB Ranks
- 仅服务端(无需客户端模组)
- 支持原版客户端
- 性能优化
?️ 开发
IDE 设置
本项目使用带有 Gradle 的 IntelliJ IDEA Community Edition。
设置说明:
- 克隆仓库
- 在 IntelliJ IDEA 中打开项目
- 作为 Gradle 项目导入
- 等待 Gradle 同步并下载依赖项
- IDE 已配置为自动下载源代码和 Javadoc
运行模组:
- 使用 NeoForge ModDev 提供的 Gradle 运行配置
runClient- 以客户端模式测试runServer- 以服务器模式测试runData- 生成数据资源
构建:
./gradlew build
输出 JAR 包:build/libs/neoessentials-VERSION+build.XXX.jar
项目结构
- Java 21 - 目标 JDK 版本
- Gradle - 具有自动递增构建编号的构建系统
- NeoForge ModDev 2.0.107 - 现代模组开发插件
- Parchment Mappings - 更好的参数名称和 Javadoc
? 支持与社区
- Discord: 加入我们的 Discord 服务器 获取支持和参与社区讨论
- Bug 报告: 通过 GitHub 或 Discord 报告问题和 Bug
- 功能请求: 建议新功能和改进
- 文档: 请参阅 Home 以及上方的系统文档
? 许可证
NeoEssentials 根据 MIT 许可证授权。详细信息请参阅 LICENSE 文件。
? 准备提升您的服务器?下载 NeoEssentials,为您的玩家提供他们所需的必备工具!
用 ❤️ 为 Minecraft 社区制作
NeoEssentials
NeoEssentials is a comprehensive, config-driven essentials mod for Minecraft NeoForge 1.21.1 - 1.21.11 servers. It provides 50+ commands, GUI tools, advanced administration, and a real-time web dashboard—all managed by modular JSON config files and standardized documentation.
? Overview
NeoEssentials brings essential server management, player utilities, and advanced admin features to NeoForge servers. All features are strictly documented and driven by config files for reliability and transparency.
Server-Side Only: No client install required—works with vanilla clients. 50+ Commands: Covers all major server functions, utilities, and moderation. Modern UI: GUI commands, color code support, and web dashboard.
✨ Core Systems & Features
- Economy System: Player balances, payments, kits, and shop support.
- Chat & Messaging: Private messages, mail, ignore/socialspy, AFK system.
- Moderation: Ban, kick, mute, jail, vanish, freeze, sudo, player data.
- Teleportation: Homes, warps, spawn, teleport requests, back system.
- Kit Management: Configurable item kits with cooldowns and preview.
- Web Dashboard: Real-time server monitoring, config editing, API endpoints.
- Permission System: LuckPerms, FTB Ranks, and built-in support.
- Item Management: Item spawning, repair, enchant, clearinventory, powertool.
- Utility Systems: Nicknames, MOTD, near, ping, depth, helpop, rules, suicide, etc.
- API & Placeholder System: PlaceholderAPI integration, custom placeholders, REST API endpoints.
? Documentation
Start at Home for a complete, config-driven documentation hub. All major systems are documented and standardized to match the codebase and config files:
- EconomySystem
- ChatSystem
- ModerationSystem
- TeleportationSystem
- KitManagement
- WebDashboard
- PermissionSystem
- ItemManagement
- UtilitySystems
- APISystem
- AFKSystem
See APISystem for API & Placeholder System details, including:
- PlaceholderAPI integration for dynamic text
- Custom and expansion placeholders
- Web Dashboard REST API endpoints for server status, player info, logs, config, events, and statistics
- Permissions and config options for API features
? Quick Start
Installation
- Download the latest release
- Place the JAR file in your server's
modsfolder - Start your server to generate configuration files in
config/neoessentials/ - Configure permissions and features as needed
- Restart the server to apply changes
Essential Configuration Files
config/neoessentials/
├── config.json # Main configuration settings
├── permissions.json # Permission system setup
├── language/ # Language files directory
├── shops.json # Shop system configuration
└── settings.json # Additional mod settings
Quick Permission Setup
For LuckPerms users:
/lp group admin permission set neoessentials.admin true
/lp group moderator permission set neoessentials.moderator true
/lp group default permission set neoessentials.player true
? Command Reference
See Home and individual system docs above for full command lists and config options.
? Configuration Examples
All features are managed by modular JSON config files. See Home and system docs above for details.
? API Integration for Modders
See APISystem for full API and PlaceholderAPI documentation, including:
- Registering custom placeholders
- Using REST API endpoints for server data
- Economy API for mod integration
? Integration & Compatibility
- LuckPerms and FTB Ranks supported
- Server-Side Only (no client mods required)
- Vanilla Client Support
- Performance Optimized
?️ Development
IDE Setup
This project uses IntelliJ IDEA Community Edition with Gradle.
Setup Instructions:
- Clone the repository
- Open the project in IntelliJ IDEA
- Import as a Gradle project
- Wait for Gradle to sync and download dependencies
- The IDE is configured to automatically download sources and javadocs
Running the Mod:
- Use Gradle run configurations provided by NeoForge ModDev
runClient- Test in client moderunServer- Test in server moderunData- Generate data resources
Building:
./gradlew build
Output JAR: build/libs/neoessentials-VERSION+build.XXX.jar
Project Structure
- Java 21 - Target JDK version
- Gradle - Build system with auto-incrementing build numbers
- NeoForge ModDev 2.0.107 - Modern mod development plugin
- Parchment Mappings - Better parameter names and javadocs
? Support & Community
- Discord: Join our Discord server for support and community discussion
- Bug Reports: Report issues and bugs through GitHub or Discord
- Feature Requests: Suggest new features and improvements
- Documentation: See Home and system docs above
? License
NeoEssentials is licensed under the MIT License. See the LICENSE file for details.
? Ready to enhance your server? Download NeoEssentials and give your players the essential tools they need!
Made with ❤️ for the Minecraft community
下载 NeoEssentials
下载 NeoEssentials
下载 NeoEssentials
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 NeoEssentials
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 NeoEssentials
下载 NeoEssentials
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 NeoEssentials
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 NeoEssentials
下载 NeoEssentials
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 NeoEssentials
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
NeoEssentials — 更新日志(26.3.x 分支)
Minecraft 26.3 · NeoForge 26.3.0.101+
本分支的所有重要更改均记录于此,从 v1.0.6 开始——更早的历史(v1.0.5.x 及之前,包括移植自身迁移历史)未包含在内。
[1.0.7] — 2026-10-16
新增
- 2026-10-17 — Build 9 (
4aa84bd9) —/chestshop hologram move现在也支持无参数调用(将全息图移动到你站立的位置),并新增/chestshop hologram movepos <signX> <signY> <signZ>命令,无需注视告示牌即可执行相同操作。距告示牌的最大偏移量从 ±4.5 提升至 ±16 格。 - 2026-10-24 — Build 14 (
116a6a58) — 当配置了外部仪表板时,/dashboardregister现在会显示指向该配对的外部仪表板自身的/register页面的可点击链接,而不仅仅是游戏内令牌流程。仅限内部使用的服务器不受影响。相关议题:#75。 - 2026-10-30 — Build 15 (
0afa8273) — 模组现在可以通过其自身的 Cloudflare Tunnel 运行内置仪表板,镜像了外部仪表板现有的 Docker 设置。新增/dashboard tunnel enable <token>|disable|status命令以及webDashboard.tunnel.*配置项,以启动和监管已安装的cloudflared连接器作为子进程,并将其与仪表板的启动/停止生命周期绑定。同时支持内部和外部仪表板。 - 2026-11-02 — Build 16 (
668bfb0b) — 按组划分的仪表板权限 —— 现在可以为游戏内的权限组授予细粒度的仪表板访问权限,而不仅仅是固定的四种角色。新的webDashboard.groupPermissions配置项可将一个组映射到一组{tab, access}授权(每个标签页的读/写权限);玩家的角色会根据其主要的游戏内组自动同步。同时支持内部和外部仪表板。
修复
-
2026-10-17 — 构建 9 (
4aa84bd9) —/tp命令现在静默要求真实的原版 OP 权限,而非任何 NeoEssentials 权限(即使是完全通配的管理员也会收到“未知或不完整的命令”)——这与原版的/tp发生了冲突,原版命令的权限检查由 Brigadier 的命令合并机制保留,而非我们的逻辑。 -
2026-10-18 — 构建 10 (
bce90de2) — 减少了全息图调度器的开销,行为无变化——维度查找在每个周期中仅缓存一次,而不是对每个全息图重新扫描;静态(非动画)行不再在每次动画刻时重新运行字符串搜索。 -
2026-10-20 — 构建 11 (
d18e49df) — 仪表盘的“重置密码”功能现在会在其提示框中实际显示生成的临时密码,而不是显示通用的“已为 X 重置密码。”消息。修复了 #75。 -
2026-10-24 — 构建 12 (
f00a89a5) —/dashboardregister complete不再接受密码参数(它像其他命令一样泄露到了服务器控制台日志中)——现在它会生成一次性临时密码并在聊天中显示。修复了 #75。 -
2026-10-30 — 构建 15 (
595cb7b3) — 美化了内部仪表盘的登录页面以匹配外部仪表盘的设计更新——登录卡片现在使用共享的dash-card面板样式和hover-lift交互效果,而不是普通的带边框方框。 -
2026-10-30 — 构建 15 (
983ad29c) — “配置拆分可用”的通知可能在每次服务器重启时在加入的管理员聊天中重复显示,而不是一次性显示。现在仅限控制台输出——无条件控制台日志行已经在每次启动时涵盖了相同的信息,消除了这种脆弱性。 -
2026-11-02 — 构建 16 (
c76b1dc2) — 修复了RandomTeleportManager/MiscTeleportManager中剩余 6 个调用点的未加载区块边界传送错误(问题 #72)——将原始(int)强制转换切换为Math.floor()。 -
2026-11-02 — 构建 16 (
48ea547f) — 修复了服务器启动时因套件加载在原版的物品组件系统就绪之前运行而导致的错误——现在仅在服务器完全启动后才加载。 -
2026-11-02 — 构建 16 (
2299c881) — 发送到 Discord 的静音/AFK/进度消息可能跳过了聊天已经获得的提及清理和截断处理,因为每个桥接适配器都单独构建了其自己的消息字符串。现在这些消息都通过共享的、始终经过清理的辅助函数处理。 -
2026-11-03 — 构建 19 (
37d00ec1) — 安全修复:GET /api/auth/discord?username=和旧版 minecraft 类型登录凭据从裸用户名生成了真实的仪表盘会话,没有任何所有权证明——导致最多可完全冒充管理员。替换为游戏内确认流程(/dashboardlogin <code>);直到真实玩家确认之前,不会生成任何会话。 -
2026-11-03 — 构建 19 (
bf05c263) — 在全息图可见时编辑其行/帧可能会抛出错误或短暂显示乱码文本——底层列表在命令线程和动画调度器之间没有同步。已切换为CopyOnWriteArrayList。 -
2026-11-03 — 构建 19 (
3af22576) — 约 16 个管理器单例在并发访问仪表盘/主线程时可能会无声地构造两个独立的实例。所有管理器现在对其getInstance()进行同步。 -
2026-11-03 — 构建 19 (
fac57cdd) — 在封禁、静音、余额更改或权限编辑期间,失败的存储写入被无声吞没,报告成功而更改仅存在于内存中。每个持久化调用现在都会检查并暴露真实结果。 -
2026-11-03 — 构建 20 (
7c508355) — 安全修复:被授予“users”或“apikeys”标签页写入权限的 CUSTOM 角色仪表盘用户,可以通过过时的仅管理员路径列表自我提升为完整管理员或生成持久的不失效 API 密钥。无论标签页授予如何,这两个路径现在始终受管理员权限保护。 -
2026-11-03 — 构建 20 (
7f4d1437) — 仪表盘的运行命令端点及其统计采样器/玩家统计端点在仪表盘 HTTP 线程上读取并修改实时世界状态,与主刻循环发生竞争——现在正确地将操作编组到主线程。还修复了目录删除声称创建了备份但实际并未创建的问题。 -
2026-11-03 — Build 20 (
e1c44450) — Config 保存(包括 crates、排行榜、记分板、传送/锚点、云存储)静默吞掉了写入失败,其处理方式与 Build 19 之前的存储写入相同;“已保存”响应现在会检查实际结果。 -
2026-11-03 (Build 21,
76bf0d34): 冻结/解冻、命令自动补全和服务器统计信息是最后几个仍在仪表盘自身的 HTTP 线程之外直接读写服务器/玩家状态的仪表盘处理程序,这与 Build 20 中修复的同类处理程序面临的隐患相同。它们现在能正确地编组到主线程执行。 -
2026-11-04 (Build 25,
a8f8f5b9):/effect使用未注册的持有者构建药水效果,导致该玩家的存档数据在每次自动保存/登出时静默损坏(直到效果被清除才会恢复),并回滚期间所做的进度。现在改为使用已注册的持有者来应用效果。同时修复了/effect忽略自身配置开关的问题。 -
2026-11-04 (
debb9c8d):/ptime、/pweather、/spawnmob和/unlimited各自拥有配置开关但均被忽略,与上述/effect的 bug 相同。现在这四个命令都会尊重其配置开关。 -
2026-11-04 (
47f58292): 另外 24 个命令也存在相同的未使用开关 bug(fireball、tree、break、ice、bottom、tpaall、broadcastworld、firework、nuke、antioch、kittycannon、beezooka、itemdb、potion、info、rest、backup、broadcast、time、weather、kill、gamemode、tpo、tpoffline、condense、showkit、powertoollist、customtext、payconfirmtoggle、ciconfirmtoggle、item、rtoggle、me、tptoggle、gc、lightning、skull、itemname、itemlore、remove、loom、cartography)。现在它们都会尊重各自的配置开关。 -
2026-11-04 (
79cd739a):/world、/spawner、/recipe存在相同的 bug,而/warpinfo的情况更糟(直接从模组的引导阶段注册,完全绕过了配置开关和传送模块切换)。现在它们都会尊重各自的配置开关。 -
2026-11-04 (
8418149f): 安全 - 仪表盘数据库浏览器 REST API(包括原始 SQL/query端点)完全没有身份验证,且从未连接到仪表盘的 HTTP 服务器,因此实际上无法访问——但如果此前未被发现漏洞就直接注册,任何人都无需登录即可对所有插件数据库执行任意 SQL 操作。现已添加与其他仪表盘端点相同的仅管理员检查,关闭了表名 SQL 注入路径,拒绝了堆叠 SQL 语句,并通过正常的认证中间件进行注册,使其成为真正具备安全保护的功能。 -
2026-11-04 (
4b4626ad): 安全 - 另外五个仪表盘处理程序存在相同的 bug:无身份验证、未注册,涉及资源包上传/删除、计划任务 CRUD/执行、服务器日志访问以及带有宽泛 CORS 策略的完整原始玩家数据导出。现在它们都已具备正确的身份验证并完成注册。此外,将已废弃的重复封禁管理处理程序中唯一的一个功能(白名单)拆分至独立的WhitelistHandler,并修复了其会话查找逻辑,后者之前无论实际登录的是谁,都会在审计轨迹用户名中记录为 "admin"。 -
2026-11-04 (
5f411fee): 另外 17 个管理器单例(包括ModerationManager和DatabaseManager)存在与 Build 19 中已修复的约 16 个单例相同的getInstance()竞态条件问题(未同步)。现在所有管理器都对其getInstance()进行了同步处理。 -
2026-11-04 (
2d69f311): 安全 - Votifier V2 的投票签名校验使用了普通字符串比较,泄露了一个时序侧信道,攻击者可借此在不获取真实共享令牌的情况下暴力破解签名。现已切换为常量时间比较。 -
2026-11-04 (
10ae5333):/effect从未像其他可针对目标的管理员命令那样获得“自身 vs 他人”的权限分离,因此任何拥有基础权限的玩家都可以对任何人施加或清除效果。已添加neoessentials.effect.others权限。同时补充记录了ptime/pweather/spawnmob/unlimited已有的.others权限层级,此前这些在权限参考文档中缺失。 -
2026-11-04 (
a0df2fc5): 为资源包、服务器日志、计划任务和白名单管理添加了仪表盘标签页权限,以便管理员可以在不授予完整 Admin 权限的情况下向员工开放这些功能的访问权限。数据库浏览器和原始玩家数据导出仍仅限管理员使用。 -
2026-11-04 (
b5b42feb): 为/spawnmob添加了可选黑名单和按实体类型的权限系统,以镜像/item现有的基于权限的物品生成机制。两者默认均为关闭状态,因此除非服务器主动启用,否则行为不会发生变化。 -
2026-11-04 (
17b53a7f): 为/crate open添加了可选的单 crate 权限,允许管理员即使玩家持有钥匙,也能将特定箱子限制给特定权限组。默认关闭。同时注册并记录了此前未注册的基座 crate 权限。 -
2026-11-04 (
e5d4c52e): 为/enchant命令添加了可选的按附魔类型划分的权限,允许管理员将如经验修补(Mending)等附魔保留给 VIP 等级。默认关闭。 -
2026-11-04 (
611032f8):/item和/give命令此前一直静默地不执行物品生成黑名单/权限系统,尽管文档中已说明该功能用于阻止任何命令生成危险物品。现在两者均会强制执行。/give还新增了neoessentials.give.others权限。 -
2026-11-04 (
eef95f65): 箱子奖励存在与上述/item//give相同的绕过黑名单漏洞——被禁止的奖励物品此前会被无条件发放,现在改为在聊天中提示并记录服务器日志警告,从而不予发放。 -
2026-11-04 (
7efbc963): 管理面板中的“给予物品”玩家操作存在与上述/item//give相同的绕过黑名单漏洞——现在改为返回错误,而不是静默发放被禁止的物品。 -
2026-11-04 (
26c90a6f): 管理面板中的“生成生物”玩家操作也存在类似的绕过黑名单漏洞,此次针对的是spawnmobSettings.mob-spawn-blacklist和基于权限的生物生成控制——现在改为返回错误,而不是静默生成被禁止的生物类型。 -
2026-11-04 (
8395ca0d):/tp <player> <target>(强制传送另一名玩家)存在与/effect//give之前已修复的“自身 vs 他人”权限漏洞相同的问题——现已添加neoessentials.teleport.tp.others权限。 -
2026-11-04 (
9bdfc414): 为/potion add命令添加了可选的按效果类型划分的权限,以镜像/enchant已有的按附魔类型划分的权限——允许管理员将如瞬间伤害等效果保留给工作人员。默认关闭。 -
2026-11-05 (
d94dac58): 为/effect命令添加了同样的可选按效果类型划分的权限,叠加在其原有的“自身 vs 他人”权限划分之上。默认关闭。 -
2026-11-05 (
7ef331c6): 管理面板中的“施加效果”玩家操作存在与上述管理面板给予物品/生成生物操作相同的绕过黑名单漏洞——由于管理面板没有游戏内的发送者,因此改为检查目标玩家。 -
2026-11-05 (
12cd9120):/unlimited命令此前可以无检查地将任何被列入黑名单的物品(如基岩、TNT 等)设为无限数量——为此目的而存在的辅助功能代码实际上是死代码。现已将其正确接入。 -
2026-11-05 (
b940b465): 安全 —— 管理面板中按玩家分发的 NBT 转储端点直接使用 URL 段构建文件路径,未进行 UUID 验证,从而导致路径遍历漏洞,可读取玩家数据目录之外的任意.dat文件。现已在使用前进行验证。 -
2026-11-05 (
ab679f21):/nick命令此前使用&#RRGGBB十六进制颜色代码时,会因长度检查计算的是原始标记而非可见字符,导致拒绝有效的昵称并提示“无效的昵称格式”。修复了 #77。 -
2026-11-05 (
1f0d57f2): 继 #77 之后的后续修复——成功设置带有十六进制颜色的昵称后,在聊天栏中显示为空(但在标签页列表中正常)。多处提前进行的&到§转换破坏了下游的十六进制颜色解析器。已在所有发生处修复。
[1.0.6] — 2026-08-27
新增
-
2026-10-09 — Build 87 (
41c8f805) — NPC 商店窗口现在会在金锭(右下角槽位)上显示你的实时余额,每次购买/出售后会刷新——此前仅显示在标题中,而窗口打开时无法更新。 -
2026-10-09 — Build 86 (
c82a9111) — 修复了/npcshop additem和 NPC 商店列表未识别没有worth.yml条目的模组物品的问题(例如mekanism:osmium_ingot)——现在回退到使用物品注册表。 -
2026-10-09 — Build 85 (
277ee52f) — 模组 ID 可在/npcshop additem、addcommand和entitytype中使用;entitytype的<ai>参数现在是可选的。 -
2026-10-08 — Build 84 (
1a3920ca) — 更简单的商店:/npcshop接受商店名称或this,新增additemhand和editlisting ... price,支持基于 1 的槽位,NPC 商店窗口中支持 Shift+点击堆叠和余额,在shop.confirmAbove之上进行二次点击确认,以及为命令方块提供更完整的/chestshop info。 -
2026-10-07 — Build 83 (
0596bf64) — 命令商店:从 NPC 商店(/npcshop addcommand、/npcshop editlisting)或[Command]管理员商店告示牌(/chestshop command ...)出售命令。以控制台或买家身份运行,支持{player}/{uuid}占位符,可选权限节点,且如果命令无法执行,则不会对买家收费。 -
2026-10-06 — Build 82 (
caf1ee68) —[NE]消息前缀现在可通过general.messagePrefix配置(设为""可移除它)。 -
2026-09-16 — Build 77 (
e5758be3) — 带值的权限节点 —— 群组现在可以持有"meta"映射(节点 -> 值),用于那些期望数字/字符串而非简单授予的权限系统,已接入 NeoForge 的 Permission API 以支持INTEGER/STRING节点类型。用于为等级阶梯提供逐步递增的 FTB Chunks (ftbchunks.max_claimed/max_force_loaded) 领地限制——仅当模组通过 NeoForge 的 Permission API 而非其独立的配置文件查询限制时才生效。 -
2026-09-16 — Build 76 (
d63a704f) — 添加了guest -> member -> vip -> vip+ -> mod -> admin -> owner权限组阶梯,具有逐步递增的/home限制,以及基于在线时长的自动晋升(guest 在 24 小时后升级为 member,可配置)。permissions.json不再是一次性种子文件 —— 它定义的每个群组现在都会在每次重载/重启时重新应用,因此编辑文件并重载后实际生效。 -
2026-09-16 — Build 75 (
2d53fc9d) — 第三方命令权限门控 —— 通过command_permissions.json将来自其他模组的任意命令路径(包括特定子命令)或原版命令映射到 NeoEssentials 权限节点。最深层的配置路径优先;拒绝时使用与 NeoEssentials 自身命令相同的消息;已通过/neoe reload对已覆盖的命令实时应用权限节点更改,无需重启。 -
2026-09-16 — Build 74 (
923ef4bb) —/back现在是一个有界内存撤销栈(默认 10,teleportation.backSettings.maxBackHistory),而不仅仅是记住最近一次死亡/传送的位置 —— 链式使用/tpa、/spawn、/home可以让/back依次回溯每一步。纯内存存储,断开连接/重启时清除(不再有磁盘持久化)。 -
2026-09-15 — Build 70 (
bbe8d6f7) — 修复了 /spawn 和 /home 在区块边界附近的不稳定性问题(issue #72)—— 传送预加载在负侧边界处静默加载了错误的区块,导致出现虚假的“不安全位置”。还添加了一个 PvP 系统 ——/pvp on|off|toggle,服务器全局开关加上玩家间的相互退出选项,新手保护,以及安全区集成。 -
2026-09-09 — Build 69 (
d0939a1f) — NPC 商店现在可以使用任何已注册的实体类型(原版或模组)并带有 AI 开/关切换 ——/npcshop entitytype <id> <type> <ai>就地转换现有商店。启用 AI 的生物保持正常动画但被拴系在出生点;禁用 AI 的生物像经典的盔甲架一样冻结。 -
2026-09-08 — Build 68 (
0e8cbb26) — 修复了 Discord 中的双重排名前缀问题 —— NeoEssentials 自身的 Discord 消息(聊天/加入/离开/静音/AFK/进度/PMS,所有三个适配器)现在直接从权限系统解析前缀,而不是原版记分板团队,因此无论桥接模组自身的原生中继如何,都不会出现双重前缀。已在真实 Discord 服务器上验证。 -
2026-09-07 — Build 67 (
66e96854) — 更广泛的 Discord 事件覆盖:Mc2Discord 现在转发 AFK/私信,并从配置中读取头像 URL 而非硬编码;DCIntegration 在路由到指定 Discord 频道时转发进度/禁言/AFK(均为仅添加操作,已确认与 DCIntegration 自身的原生进度转发通过字节码实现兼容且安全)。 -
2026-09-07 — Build 66 (
c2d141c3) — SDLink/Mc2Discord 的原生转发冲突警告(此前仅在控制台显示)现在也通过仪表板的 Discord 状态 API 暴露,以便管理员通过该界面进行集成配置。 -
2026-09-07 — Build 65 (
b14cb394) — SDLink 的加入/离开/禁言/AFK/进度事件在路由到指定 Discord 频道时支持富嵌入(Rich Embeds)——每个事件现在都有独立的discordEmbedTemplate.<event>覆盖项并设有合理默认值,与聊天消息已有的功能保持一致。将某事件的enabled设置为false可仅对该事件保持纯文本显示。 -
2026-09-07 — Build 64 (
b048521e) — SDLink 的原生转发冲突检测现使用真正的 TOML 解析器来解析simple-discord-link.toml,而非基于最佳努力的文本扫描;发送往 Discord 的长聊天/私信/禁言/AFK/进度文本在所有三个桥接模组适配器中发送前均会被截断。 -
2026-09-07 — Build 63 (
aaace896) — Discord 角色 → 权限组同步 —— 新增discordrolesync.json用于映射 Discord 角色 ID 到权限组,通过 DCIntegration 进行同步(多个匹配时取最高优先级组,按计时器和玩家加入时重新检查,仅授予/升级权限,从不降级,仅限内部权限管理器使用)。 -
2026-09-07 — Build 62 (
7fdacaa6) — Mc2Discord 原生转发冲突检测 —— NeoEssentials 启动时读取config/mc2discord.toml,并检查 Mc2Discord 自身是否已通过原生方式订阅了聊天/加入/离开/进度等事件的转发,从而抑制其自身对默认路由的事件发送以避免重复发帖。显式的单频道覆盖设置仍会始终发送。 -
2026-09-07 — Build 61 (
5f0ac1bb) — 通用 Discord Webhook 转发 —— 新增webhookUrl字段配合channelId,使 NeoEssentials 可通过纯 HTTPS 直接向 Discord Webhook 发布事件,无需安装任何桥接模组。聊天/进度消息将模拟发送者的身份。执行/neoe reload后立即生效,无需重启。 -
2026-09-07 — Build 60 (
8398265d) — 针对加入/离开/禁言/AFK/进度/私信事件的单频道 Discord 路由(新增discordEventChannels配置部分)—— 此前仅聊天可路由至特定 Discord 频道。此功能适用于 SDLink、Mc2Discord 和 DCIntegration(后者首次获得加入/离开的路由支持)。 -
侧边栏计分板系统 ——
/scoreboard,支持配置驱动的计分板、条件、动画、组/玩家覆盖、切换命令以及仪表板端点。 -
通用排行榜系统 ——
/leaderboard(/lb),提供money/kills/mob_kills/playtime排行榜,并支持{leaderboard_<board>:<rank>:name|value}占位符。 -
排行榜现在由配置文件驱动(
leaderboard.json)—— 可通过配置注册任意原版玩家统计数据(如挖掘方块数、击杀生物数、移动距离等)作为排行榜,同时支持“自定义”总分排行榜(通过/leaderboard admin set|add|reset|create|delete命令),并提供LeaderboardAPI供其他模组注册自己的排行榜。 -
/leaderboard hologram create <board> <id> [lines]—— 一条命令即可生成排名列表全息图;这些行会自动实时更新。 -
排行榜现在可以对非玩家进行排名 —— 新增
shop_sales排行榜,根据总收入对告示牌箱子商店和 NPC 商店进行排名,显示的是商店名称而非玩家名称。 -
leaderboard.json中支持每排行榜设置refreshInterval(此前所有排行榜固定为 60 秒)。 -
排行榜样式:自动化的每排名奖牌/颜色占位符(
:medal/:rankcolor),每排行榜的entryFormat/headerFormat聊天模板,以及新的分页 GUI 查看器(/leaderboard <board> gui),支持真实玩家头像和每排行榜图标。 -
/tpr//rtp可以打开一个生物群系选择 chests GUI 而不是瞬间传送 —— 通过randomTeleportSettings.mode: "gui"启用(默认值不变)。列出维度可生成的所有生物群系(自动包含模组生物群系),并提供“随机 —— 任意生物群系”按钮;在该生物群系内选择一个真实位置,若在服务器边界内找不到则显示清晰错误。图标默认使用该生物群系的树苗/专用方块;管理员可将生物群系固定到特定槽位并通过biomeMenuItems覆盖图标。 -
Votifier 投票监听器 —— 独立 TCP 端口,自动检测 V1 (RSA) 和 V2 (NuVotifier 兼容) 协议,支持按站点配置奖励(命令/宝箱钥匙)、离线投票队列、投票派对,以及
/vote//votes//voteparty命令。 -
宝箱 —— 具有权重奖励池的宝箱,支持钥匙余额系统,通过
/crate open或物理方块开启,提供三种开启动画(轮盘/顺序/即时),并提供完整的管理命令在游戏中定义宝箱和奖励。Votifier 可按投票站点发放宝箱钥匙。 -
/crate admin setblock现在会在方块上方自动创建全息图(命名为crate_<crateId>,可通过 Tab 补全找到),并且可以通过任何/hologram子命令进行完全自定义。 -
左击物理 crate 方块现在会打开无需花费的奖励概率预览(Shift+左击仍可破坏它)。
-
/crate key giveitem <player> <crate> <amount>会给予真实、可交易的物理 crate 钥匙物品——兑换时无需虚拟余额。 -
玩家列表(Tablist)的
header/footer帧现在可以写成独立的 JSON 行数组,而不是在一个长字符串中手动转义\n——例如["Line 1", "Line 2"]作为一个帧。 -
Crate 钥匙物品名称现在支持
{animation:NAME}/渐变/彩虹效果,而不仅仅是&代码——这与 crate 全息图文本中已有的功能一致(由于手持物品无法像全息图那样实时重绘,因此每个物品仅显示一个快照帧)。 -
Crates 现在支持为聊天和钥匙物品分别设置显示名称——
chatDisplayName/crateKeyDisplayName(在crates.json中),以及/crate admin setchatname/setkeyname,如果未设置则回退到displayName。此前,动画化的displayName会在每条聊天消息中闪烁不同的随机快照帧,且无法专门让聊天退出此动画效果。 -
/crate keys [player]现在会在单独的行上列出所有已注册的 crate,包括你持有零把钥匙的那些,而不再仅以逗号连接你实际持有钥匙的 crate。 -
修复了在使用不支持前缀/后缀的外部权限适配器(如 FTB Ranks)的服务器上,控制台被大量
PermissionManager is null警告刷屏的问题——这是该情况下的预期状态,并非故障,且不再记录警告日志。 -
全息图的刷新/动画 tick 率之前是硬编码的——现在可通过
config.json中的hologram.refreshInterval/animationInterval进行配置,与标签页/记分板的refreshInterval惯例相同。通过/neoe reload生效。 -
scoreboard.json中新增每记分板专用的refreshMultiplier(默认值为 1),允许某个记分板在不更改全局刷新率的情况下,使其动画帧循环速度比其他记分板更慢。标签页/记分板/全息图的默认refreshInterval从 20 tick 收紧至 10 tick(开箱即用更平滑)——仅影响全新安装,现有配置文件不受影响。
修复
- 2026-10-07 — Build 83 (
de40fe22) — 配置文件升级备份现在保存在config/neoessentials/backups/目录中(每个文件保留最新的 5 个),而不再堆积在配置文件旁边。 - 2026-10-06 — Build 81 (
78ae1e4d) — 全息图不再强制加载周围没有玩家的区块;未加载区块中的动画全息图此前每 tick 都会重新加载其所在区块并重建实体,导致严重卡顿。 - 2026-10-06 — Build 80 (
f975babe) — 自定义加入/离开消息(customJoinMessage/customQuitMessage)现在会替换原版“X 加入了/离开了游戏”的消息,而不是与其并列显示。将其设置为"none"可保留原版消息。 - 2026-10-05 — Build 78 (
429576f9) — 修复了登出/登录后 [AFK] 标签残留的问题(问题 #73):登录时 AFK 状态会重置,且/tellraw中的@s名称不再保留过时的 [AFK] 标签。 - 2026-09-06 — (
04d20d5b, 仅文档更新) — 在tablist.json中记录了将nametagSettings.enabled: false作为解决 Discord 聊天桥接模组(例如 SimpleDiscordLink)重复显示排名前缀的方法。游戏内聊天不受影响;无需代码更改。 - 2026-09-06 — Build 59 (
7a158686) — 修复了当聊天格式模板使用<gradient:...>/<rainbow>包裹{neoessentials_username}(这是为 FTB Ranks/LuckPerms 排名赋予彩色名字的常见方式)时,玩家名字在聊天中显示为字面量HNAME<name>/HNAME而非干净的可点击名字的问题。修复了 #70。 - 启动时的管理员通知聊天块(包含错误报告链接、配置拆分可用信息等)现在受专用的
neoessentials.admin.notice权限节点控制,而不再是硬编码的 OP/通配符检查,并且所有待处理的通知会渲染为一个组合块。此外,完全移除了“LEGACY DATA FILE(S) NO LONGER READ”通知。 - FTB Ranks 服务器现在可以使用
"group:<rank>"聊天格式键以及{ftbranks_prefix}/{ftbranks_suffix}/{ftbranks_rank}/{ftbranks_group}占位符——这些之前在 FTB Ranks 上从未真正生效过(仅对 LuckPerms 有效)。Group 现在从玩家最高权限排名的组解析;前缀/后缀来自该排名的ftbranks.name_format值。还修复了"group:<name>"键对已解析组名(始终为小写)的大小写敏感问题,这影响了所有权限后端,而不仅仅是 FTB Ranks。 - 当内部权限管理器未激活时(例如使用了外部权限插件如 LuckPerms),
/permissions group <group> setprefix|setsuffix不再显示原始的“意外错误”,而是解释原因。 - 当 LuckPerms/FTB Ranks 实际处于活动状态时,
{luckperms_group}/{luckperms_primary_group}/{ftbranks_rank}/{ftbranks_group}占位符不再解析为空字符串——prefix/suffix/displayname变体未受影响。 - 拥有昵称的玩家(
/nick)在标签页列表中保留其权限组的前缀/后缀——以前一旦设置昵称,无论属于哪个组,都会静默丢弃前缀/后缀。 PermissionAPI.getPrefix()/getSuffix()现在在 LuckPerms/FTB Ranks 无意见时回退到内部权限系统,这与getGroupWeight()/getPrimaryGroup()的现有行为一致。FTB Ranks 服务器此前通过此模组根本无法获得任何前缀/后缀;LuckPerms 中未设置prefix/suffixmeta 的组现在也会回退到内部值,而不是显示为空。- 另外五个位置存在相同的仅限内部管理器的 bug(通过对每个剩余调用点的审计发现):公共
NeoEssentialsAPI组查找、{group}占位符、按组的标签页列分桶、聊天徽章组门控以及玩家标签,在 LuckPerms/FTB Ranks 下都静默回退到""/"default"——现已以相同方式修复。 - 配置版本升级(更新时将新默认键/板合并到现有配置的操作)在 Windows 上静默失败——已修复。同时修复了新默认板(如
shop_sales)即使在修复后也无法应用到已升级安装的问题。 /tpr//rtp可能导致服务器卡顿或崩溃,特别是在地形未预生成的情况下——它每次传送时强制生成的区块数量远超必要(RTP 特有的无需的 9 区块安全网格,以及每次传送后立即进行的 10 区块突发刷新以回填后台缓存)。两者均已修复;新的prewarmBatchSize配置限制了回填突发量,降低默认范围和尝试次数可减少全新服务器上的最坏情况开销。/tpr现在还会宣布其预热延迟以及移动会取消预热——该功能原本就已存在,只是不可见。- 拆分配置文件(
/neoe config split)会静默丢失 Web 仪表板设置和存储后端选择——这两者从未在拆分配置部分列表中进行注册,因此拆分后两者总是回退到默认值(仪表板设置,以及即使配置了 SQLite/MySQL,存储也恢复为"json")。两者均已修复——webDashboard现在拥有自己的dashboard.json,storage现在位于main.json中。如果你已经遇到此问题,请参阅拆分配置 wiki 页面——你的原始值可以从config.json.backup中恢复。 - 右键点击物理箱子方块会导致整个打开流程每点击一次运行两次(重复的“没有钥匙”消息,可能双重消耗钥匙)——已修复。
- 尚未配置奖励的箱子会静默消耗一把钥匙并报告误导性“没有
键”错误,而非“未配置奖励”——已修复;现在仅在存在实际奖励时才会消耗该键。
- 在涉及 16 个文件中的约 25 个命令参数(如箱子/全息投影/家/公告板/群组名称、物品 ID、玩家目标等)处,Tab 补全功能静默缺失——经过全面审计,已全部修复。
- 箱子的
&编码显示名称在聊天、GUI 标题和钥匙物品名称中显示为纯文本(例如`&7Common Crate`),而未进行着色——已在模组范围内修复(所有通过MessageUtil构建的命令回复均受影响,而不仅仅是箱子相关部分)。 {server_name}现在是一个独立配置的普通名称(general.serverName),不再与任何 MOTD 绑定——新增的{server_motd}占位符用于处理“显示实际配置的 MOTD”的情况。/neoe reload对记分牌系统静默无效(此前仅修复了标签页列表的相关问题)——现在修改scoreboard.json后重新加载即可生效。- 某些库存工具客户端模组的“从打开的 GUI 中提取物品”按钮可能会窃取(并复制)直接来自
/crate preview/ 开箱揭示 GUI 的物品——初始修复未能覆盖这些模组使用的确切方法;现在容器上的每个变更路径均已锁定,无论哪个模组执行提取操作都会关闭 GUI。经确认(通过 Quark),有些模组甚至不需要变更方法——它们只是读取并复制物品——因此两个箱子 GUI 现在也会标记每个显示的物品,如果它最终出现在你的真实背包中,会将其清除,无论它是如何到达那里的。预览界面的关闭/上一页/下一页按钮以及填充面板在第一轮标记中被遗漏;现已一并修复。 - 实体箱子钥匙物品从未真正可给予,且即使通过其他方式获得的钥匙物品仍需虚拟余额才能兑换——两者均已修复(见上文
/crate key giveitem)。 - 格式错误的配置文件(例如手动编辑时留下的多余大括号)可能导致服务器反复崩溃——现在 JSON 解析错误将回退到默认值,而不是导致服务器宕机。
- 拥有昵称的玩家在设置昵称后加入服务器时,其真实游戏 ID (IGN) 仍会显示在标签页中——现在每次加入都会同步所有玩家的昵称覆盖信息,而不仅仅是加入玩家自己的信息。
/neoe reload(及/scoreboard reload)会导致所有查看侧边栏记分牌的玩家因致命的“网络协议错误”被踢出——已修复。- 权限系统在启动初始化失败后无法恢复(整个会话期间持续记录
PermissionManager is null)——发生这种情况时,/neoe reload现在会从头重新初始化它,而不是永远以相同方式失败。 - “可用配置拆分”/“旧版数据文件”的管理员通知在每次重启时都会永久打扰——现在每个安装周期仅显示一次,而非每次会话显示一次。
- 在使用提取模组的提取按钮后立即关闭箱子 GUI,仍可能赢得竞争并保留物品——现在关闭操作会在接下来的约 4 秒内多次扫描,而不是仅执行一次,从而完全消除时间窗口。
/crate admin create没有说明新箱子放置的位置——现在指向config/neoessentials/crates.json。/scoreboard reload从未刷新animations.json——只有/tablist reload做到了这一点。编辑动画并通过记分牌命令重新加载后,旧帧仍会显示(原始的{animation:...}/ 渐变文本,未格式化),直到也运行了/tablist reload。/eco give|set|take//pay从未使排行榜“金钱”记分牌失效(仅/baltop自身的缓存),因此余额更改可能导致记分牌上“最富有的玩家”行停滞长达 60 秒——已修复。/baltop和/leaderboard <board>在首次调用时也错误地报告“无数据”,即使存在真实数据——已修复。- 经济系统在启动时从未完成初始化的情况下没有任何恢复机制(静默停止在该会话剩余时间内持久化余额)——
/neoe reload现在会重试此过程,与权限系统的现有自愈机制相同。 - 当
security.enableInputValidation被关闭时,/pay和/eco give|take在每次使用时都会崩溃——在该绕过路径中,验证器返回了错误的类型——已修复。 {animation:NAME}/ 渐变 / 彩虹标签在聊天中从未解析——所有命令回复都使用仅支持颜色代码的解析器,不知道这些标签的存在,因此它们显示为原始纯文本(据报道,打开箱子时箱子的名称显示未解析的{animation:animation})。已在共享的消息构建代码中在模组范围内修复,而不仅仅是箱子部分。注意:发送的聊天消息是发送瞬间当前动画帧的永久快照——聊天没有像标签页列表/记分牌/全息投影那样的实时更新通道,因此没有对应的intervalMs/refreshInterval。- 箱子 GUI 标题和箱子钥匙的lore/hover文本现在也解析动画/渐变标签,与钥匙名称(之前已修复)一致——具有相同的单次快照行为。
- 已确认,非 Bug:箱子钥匙(
/crate admin setkey)已经支持任何原版或模组物品,包括完整的 NBT/数据——没有固定的物品列表。 - 除非单独开启
chat.richText.enabled(默认关闭),否则动画帧的渐变/彩虹标签在聊天中会被静默剥离——标签页列表/全息投影始终渲染它们,不受该设置影响。已修复——动画渐变/彩虹现在也在聊天中始终渲染;配置仍然限制玩家自行输入原始渐变标签。 /neoe reload从未真正重新加载leaderboard.json(仅专用的/leaderboard reload能做到)——除了此项外,其他兄弟系统的刷新间隔已通过/neoe reload正常工作。已修复。{animation:NAME}在任何禁用了标签页列表模块的服务器上,在所有地方(全息投影、记分牌、聊天、箱子钥匙)的第一帧永远冻结——唯一能推进
动画时钟是 Tablist 自身的刻处理程序,在 Tablist 关闭时从未运行。任何全息图/记分牌间隔设置都无法修复此问题,因为时钟本身从未移动。已修复——无论 Tablist 是否启用,动画现在每刻都会推进。
- 将
hologram.refreshInterval(config.json)重命名为hologram.pollIntervalTicks——它很容易与每个全息图各自独立的、基于秒的refreshInterval(/hologram setrefresh)混淆,后者才是真正控制占位符刷新频率的设置。将旧键的值降低到该值以下不会有任何可见效果。升级时现有值会自动迁移。 - 无论动画自身的
frameDuration设置得多低,全息图动画始终以可见的“跳跃”/缓慢方式推进,尽管相同的更改在 tablist/记分牌中会立即且平滑地应用——全息图刷新和动画计时共享一个后台线程,因此缓慢的刷新周期会导致下一次动画计时被延迟。已修复——它们现在运行在独立的线程上。此外,将一个静默吞没的全息图渲染错误提升为可见警告。 - 具有保存的物品组件(自定义名称、描述、附魔)的箱子奖励/钥匙可能因两个独立监听器之间的启动顺序竞争而在服务器启动时静默丢失这些数据。已修复——箱子加载现在总是在绑定其所需注册表访问权限的修复之后发生。
- 在上述线程分离后,全息图动画在负载下仍可能出现突发——调度器通过连续触发而非跳过来追赶延迟的周期。通过将调度改为从上一个周期完成时开始等待来解决此问题,这样它永远不会积压以进行突发。
- 纯颜色的
{animation:NAME}(一种渐变循环十六进制停止在相同字面上的动画——最常见的动画形状)可能会在全息图中永远冻结在第一帧,即使有上述修复也是如此。变更检测比较的是纯文本,而纯颜色更改永远不会影响它,因此它从未看到需要反应的变更。已修复。
NeoEssentials — 更新日志(26.2.x 分支)
Minecraft 26.2 · NeoForge 26.2.0.63+
本分支的所有重要更改均记录于此,从 v1.0.6 开始——更早的历史(v1.0.5.x 及之前,包括移植自身的迁移历史)未予保留。
[1.0.6] — 2026-08-27
新增
-
2026-10-09 — Build 87 (
41c8f805) — NPC 商店窗口现在会在金锭(右下角槽位)上显示你的实时余额,并在每次买卖后刷新——此前仅在标题中显示,而窗口打开时标题无法更新。 -
2026-10-09 — Build 86 (
c82a9111) — 修复了/npcshop additem和 NPC 商店列表无法识别没有worth.yml条目的模组物品(例如mekanism:osmium_ingot)的问题——现已回退至物品注册表。 -
2026-10-09 — Build 85 (
277ee52f) — 模组 ID 可在/npcshop additem、addcommand和entitytype中使用;entitytype的<ai>参数现在是可选的。 -
2026-10-08 — Build 84 (
1a3920ca) — 更简便的商店:/npcshop接受商店名称或this,新增additemhand和editlisting ... price,NPC 商店窗口支持从 1 开始的槽位、点击堆叠及余额,在shop.confirmAbove之上启用二次点击确认,以及为命令方块提供更完整的/chestshop info信息。 -
2026-10-07 — Build 83 (
0596bf64) — 命令商店:从 NPC 商店(/npcshop addcommand、/npcshop editlisting)或[Command]管理员商店告示牌(/chestshop command ...)出售命令。以控制台或购买者身份运行,支持{player}/{uuid}占位符,可选权限节点,且对于无法执行的命令,不会向购买者收费。 -
2026-10-06 — Build 82 (
caf1ee68) —[NE]消息前缀现可通过general.messagePrefix配置(设为""可移除)。 -
2026-09-16 — Build 77 (
e5758be3) — 带值的权限节点 —— 群组现在可以持有"meta"映射(节点 -> 值),用于那些期望数字/字符串而非简单授予的权限系统,并接入 NeoForge 的 Permission API 以支持INTEGER/STRING节点类型。用于按层级给予 FTB Chunks (ftbchunks.max_claimed/max_force_loaded) 逐渐增加的领地限制——仅当模组通过 NeoForge 的 Permission API 而非其独立配置查询限制时才生效。 -
2026-09-16 — Build 76 (
d63a704f) — 添加了guest -> member -> vip -> vip+ -> mod -> admin -> owner权限等级阶梯,提供逐步递增的/home限制,以及基于在线时长的自动晋升(guest 在 24 小时后升级为 member,可配置)。permissions.json不再是一次性种子文件——其中定义的每个群组现在都会在每次重载/重启时重新应用,因此编辑文件并重载后确实会生效。 -
2026-09-16 — Build 75 (
2d53fc9d) — 第三方命令权限门控 —— 通过command_permissions.json将来自其他模组或原版命令的任意命令路径(包括特定子命令)映射到 NeoEssentials 权限节点。最深配置的路径优先;拒绝访问时使用与 NeoEssentials 自身命令相同的消息;已覆盖的命令的权限节点变更会通过/neoe reload实时生效,无需重启。 -
2026-09-16 — Build 74 (
923ef4bb) —/back现在是有限的内存内撤销栈(默认 10,teleportation.backSettings.maxBackHistory),而不仅仅是记住最近的一次死亡/传送位置——连续使用/tpa、/spawn、/home可以让/back依次回溯每一步。纯内存存储,断开连接/重启时清除(不再有磁盘持久化)。 -
2026-09-15 — Build 70 (
bbe8d6f7) — 修复了 /spawn 和 /home 在区块边界附近的不稳定性(问题 #72)—— 传送预加载在负侧边界处静默加载了错误的区块,导致出现虚假的“不安全位置”。同时添加了 PvP 系统 ——/pvp on|off|toggle,全局开关加上玩家互斥的个人退出选项,新手保护以及安全区集成。 -
2026-09-09 — Build 69 (
d0939a1f) — NPC 商店现在可以使用任何注册的实体类型(原版或模组),并带有 AI 开/关切换 ——/npcshop entitytype <id> <type> <ai>就地转换现有商店。启用 AI 的生物保持正常动画但被拴绳固定在生成点;禁用 AI 的生物像经典的盔甲架一样冻结。 -
2026-09-08 — Build 68 (
0e8cbb26) — 修复了 Discord 中重复的等级前缀 —— NeoEssentials 自身的 Discord 消息(聊天/加入/离开/静音/AFK/进度/PMS,所有三种适配器)现在直接从权限系统解析前缀,而不是原版计分板队伍,因此无论桥接模组自身的原生中继如何,都不会重复。已在真实 Discord 服务器上验证。 -
2026-09-07 — 构建 67 (
66e96854) — 更广泛的 Discord 事件覆盖:Mc2Discord 现在会转发空闲(AFK)/私聊消息,并从配置中读取其头像 URL 而非硬编码;DCIntegration 现在会在路由到指定 Discord 频道时转发进度/静音/空闲状态(均为仅添加操作,已确认与 DCIntegration 自身通过字节码实现的进度转发互不冲突)。 -
2026-09-07 — 构建 66 (
c2d141c3) — SDLink/Mc2Discord 的原生转发冲突警告(此前仅在控制台显示)现在也通过管理面板的 Discord 状态 API 暴露出来,方便通过该面板进行集成配置的管理员查看。 -
2026-09-07 — 构建 65 (
b14cb394) — SDLink 的加入/离开/静音/空闲/进度事件在路由到指定 Discord 频道时支持富嵌入(Rich Embeds)——每个事件现在都有独立的discordEmbedTemplate.<event>覆盖选项并提供合理的默认值,与聊天消息已有的功能保持一致。将某事件的enabled设置为false可仅对该事件保持纯文本格式。 -
2026-09-07 — 构建 64 (
b048521e) — SDLink 的原生转发冲突检测现在使用真实的 TOML 解析器来解析simple-discord-link.toml,而非之前的尽力而为的文本扫描;发送到 Discord 的长聊天/私聊/静音/空闲/进度文本现在会通过所有三个桥接模组适配器在发送前进行截断处理。 -
2026-09-07 — 构建 63 (
aaace896) — Discord 角色 → 权限组同步 —— 新增discordrolesync.json用于将 Discord 角色 ID 映射到权限组,并通过 DCIntegration 进行同步(多个匹配时取最高优先级的组,按计时器和玩家加入时重新检查,仅授予或升级权限,从不降级,仅限内部权限管理器使用)。 -
2026-09-07 — 构建 62 (
7fdacaa6) — Mc2Discord 原生转发冲突检测 —— NeoEssentials 现在在启动时读取config/mc2discord.toml,并检查 Mc2Discord 自身的频道订阅是否已通过原生方式转发聊天/加入/离开/进度事件,从而抑制其对默认路由的发送以避免重复发布。显式的单频道覆盖设置仍会始终发送。 -
2026-09-07 — 构建 61 (
5f0ac1bb) — 通用 Discord Webhook 转发 —— 新增的webhookUrl字段与channelId并列,允许 NeoEssentials 直接通过纯 HTTPS 向 Discord Webhook 发布事件,无需安装任何桥接模组。聊天/进度消息将模拟发送者的身份。执行/neoe reload后立即生效,无需重启服务器。 -
2026-09-07 — 构建 60 (
8398265d) — 针对加入/离开/静音/空闲/进度/私聊事件的每事件 Discord 频道路由(新增discordEventChannels配置部分)—— 此前只有聊天可以路由到特定的 Discord 频道。此功能可与 SDLink、Mc2Discord 和 DCIntegration 配合使用(后者首次获得了加入/离开的路由功能)。 -
侧边栏计分板系统 ——
/scoreboard命令,支持基于配置的计分板、条件、动画、组/玩家覆盖、切换命令以及管理面板端点。 -
通用排行榜系统 ——
/leaderboard(/lb),提供money(金钱)/kills(击杀数)/mob_kills(生物击杀数)/playtime(游戏时间)计分板,并支持{leaderboard_<board>:<rank>:name|value}占位符。 -
排行榜计分表现在由配置文件驱动(
leaderboard.json)—— 可通过配置注册任何原版玩家统计数据(如挖掘方块数、击杀生物数、移动距离等)作为计分板,此外还有“自定义”总分计分板(/leaderboard admin set|add|reset|create|delete)以及供其他模组使用的LeaderboardAPI以注册自定义计分板。 -
/leaderboard hologram create <board> <id> [lines]—— 一条命令即可生成排名列表全息图;行数会自动实时更新。 -
排行榜现在可以对非玩家进行排名 —— 新增
shop_sales计分板根据总收入对告示牌/箱子商店和 NPC 商店进行排名,显示的是商店名称而非玩家名称。 -
leaderboard.json中的每计分板refreshInterval(此前所有计分板的刷新间隔固定为 60 秒)。 -
排行榜样式:自动生成的每排名奖牌/颜色占位符(
:medal/:rankcolor),每计分板的entryFormat/headerFormat聊天模板,以及全新的分页 GUI 查看器(/leaderboard <board> gui),支持真实玩家头像和每计分板图标。 -
/tpr//rtp可以打开一个生物群系选择 chests GUI 而不是立即传送 —— 通过randomTeleportSettings.mode: "gui"启用(默认行为不变)。列出维度可以生成的所有生物群系(包括自动包含的模组生物群系),以及一个“随机 —— 任意生物群系”按钮;在该生物群系内选择一个真实位置,如果在服务器边界内找不到合适位置则显示清晰的错误提示。图标默认使用该生物群系的树苗/专用方块;管理员可以通过biomeMenuItems将生物群系固定到特定槽位和/或覆盖图标。 -
Votifier 投票监听器 —— 独立 TCP 端口,自动检测 V1 (RSA) 和 V2 (NuVotifier 兼容) 协议,支持按站点配置奖励(命令/宝箱钥匙)、离线投票排队、投票派对,以及
/vote//votes//voteparty命令。 -
宝箱 —— 带有权重奖励池和钥匙余额系统的宝箱,可通过
/crate open命令或实体方块开启,提供三种开箱动画(轮盘/顺序/即时),并支持完整的在线管理命令来定义宝箱和奖励。Votifier 可按投票站点发放宝箱钥匙。 -
/crate admin setblock现在会在方块上方自动创建全息投影(命名为crate_<crateId>,可通过 Tab 补全找到),并且可以通过任意/hologram子命令进行完全自定义。 -
左击实体 crate 方块现在会打开无需花费的奖励概率预览(Shift+点击仍可破坏它)。
-
/crate key giveitem <player> <crate> <amount>会给予真实、可交易的实体 crate 钥匙物品——兑换时无需虚拟余额。 -
Tab 列表的
header/footer框架现在可以写成独立的 JSON 行数组,而不是在一长串字符串中手动转义\n——例如将["Line 1", "Line 2"]作为一个框架。 -
Crate 钥匙物品的名称现在支持
{animation:NAME}/ 渐变 / 彩虹效果,而不仅仅是&代码——这与 crate 全息投影文本中已支持的功能一致(由于手持物品无法像全息投影那样实时重绘,因此每个物品仅显示一帧快照)。 -
Crates 现在支持为聊天和钥匙物品分别设置显示名称——
chatDisplayName/crateKeyDisplayName(在crates.json中),以及/crate admin setchatname/setkeyname命令;如果未设置,则回退到displayName。之前动画化的displayName会在每条包含它的聊天消息中闪烁不同的随机帧快照,且没有专门针对聊天关闭该功能的方法。 -
/crate keys [player]现在会在单独的行上列出所有已注册的 crate,包括你持有零把钥匙的那些,而不再仅用逗号连接你实际持有钥匙的 crate。 -
修复了在服务器上使用不支持前缀/后缀的外部权限适配器(如 FTB Ranks)时控制台被大量
PermissionManager is null警告刷屏的问题——在那种情况下这是预期状态而非故障,现已不再记录警告。 -
全息投影刷新/动画的 tick 率此前是硬编码的——现在可通过
config.json中的hologram.refreshInterval/animationInterval进行配置,与 tablist/scoreboard 的refreshInterval约定相同。通过/neoe reload生效。 -
scoreboard.json中新增加了每块记分板的refreshMultiplier(默认为 1),允许某一块记分板比其他记分板更慢地循环其动画帧,而无需调整全局刷新率。Tab 列表/记分板/全息投影的默认refreshInterval已从 20 tick 收紧至 10 tick(开箱即用更平滑)——仅影响全新安装,现有配置文件保持不变。
已修复
- 2026-10-07 — Build 83 (
de40fe22) — 配置升级备份现在保存在config/neoessentials/backups/(每个文件保留最新的 5 个),而不是堆积在配置文件旁边。 - 2026-10-06 — Build 81 (
78ae1e4d) — 全息图不再强制加载玩家未附近的区块;卸载区块中的动画全息图之前会每刻重新加载其区块并重新创建实体,导致严重卡顿。 - 2026-10-06 — Build 80 (
f975babe) — 自定义加入/离开消息(customJoinMessage/customQuitMessage)现在替代原版的“X 加入了/离开了游戏”消息,而不再是与之并列显示。将其设置为"none"可保留原版消息。 - 2026-10-05 — Build 78 (
429576f9) — 修复了登出/重新登录后 [AFK] 标签残留的问题(issue #73):登录时重置 AFK 状态,且/tellraw中的@s名称不再保留过时的 [AFK] 标签。 - 2026-09-06 — (
04d20d5b, 仅文档) — 记录了tablist.json中nametagSettings.enabled: false作为修复 Discord 聊天桥接模组(例如 SimpleDiscordLink)重复显示等级前缀的解决方案。游戏内聊天不受影响;无需代码更改。 - 2026-09-06 — Build 59 (
7a158686) — 修复了当聊天格式模板将{neoessentials_username}包裹在<gradient:...>/<rainbow>中时(这是为 FTB Ranks/LuckPerms 等级赋予彩色名字的常见方式),玩家在聊天中的名字显示为字面量HNAME<name>/HNAME而非干净的可点击名字的问题。修复了 #70。 - 启动时的管理员通知聊天模块(包含错误报告链接、配置拆分可用等信息)现在由专用的
neoessentials.admin.notice权限节点控制,而不是硬编码的 OP/通配符检查,并且所有待处理的通知渲染为一个合并的模块。同时完全移除了“LEGACY DATA FILE(S) NO LONGER READ”通知。 - FTB Ranks 服务器现在可以使用
"group:<rank>"聊天格式键以及{ftbranks_prefix}/{ftbranks_suffix}/{ftbranks_rank}/{ftbranks_group}占位符——这些在 FTB Ranks 上之前从未真正起作用过(仅限 LuckPerms)。等级现在从玩家最高权力的等级解析;前缀/后缀来自该等级的ftbranks.name_format值。此外,修复了"group:<name>"键对(始终小写的)解析后的等级名区分大小写的问题,这影响了所有权限后端,而不仅仅是 FTB Ranks。 - 当内部权限管理器未激活时(例如使用了外部权限插件如 LuckPerms),
/permissions group <group> setprefix|setsuffix不再显示原始的“意外错误”,而是解释原因。 - 当 LuckPerms/FTB Ranks 实际处于激活状态时,
{luckperms_group}/{luckperms_primary_group}/{ftbranks_rank}/{ftbranks_group}占位符不再解析为空字符串——prefix/suffix/displayname变体不受影响。 - 使用昵称的玩家(
/nick)现在在标签列表中保留其权限组的前缀/后缀——以前一旦设置昵称,任何组的昵称都会立即无声地丢弃它。 PermissionAPI.getPrefix()/getSuffix()现在在 LuckPerms/FTB Ranks 没有意见时回退到内部权限系统,这与getGroupWeight()/getPrimaryGroup()的现有行为相匹配。FTB Ranks 服务器之前通过此模组根本无法获得任何前缀/后缀;LuckPerms 中未设置prefix/suffix元数据的组现在也回退到内部数据,而不是显示为空。- 另外五个地方存在相同的仅限内部管理器的 bug(通过审计所有剩余调用站点发现):公共
NeoEssentialsAPI等级查找、{group}占位符、按组的标签列表列分组、聊天徽章等级门控以及玩家标签,在 LuckPerms/FTB Ranks 下都无声地回退到""/"default"——现在以相同方式修复。 - 配置版本升级(更新时将新默认键/面板合并到现有配置中)在 Windows 上静默失败——已修复。此外,即使在此修复之后,新的默认面板(如
shop_sales)也无法到达已经升级的安装包——也已修复。 /tpr//rtp可能导致服务器卡顿或崩溃,特别是在没有预生成地形时——它在每次传送时强制生成的区块数量远超必要(RTP 特定情况下有一个不必要的 9 区块安全网格,并且在每次传送后立即刷新背景缓存时产生 10 区块的突发)。两者均已修复;新的prewarmBatchSize配置限制了刷新的突发量,较低的默认范围/尝试次数降低了全新服务器的最坏情况开销。/tpr现在还会宣布其预热延迟以及移动会取消预热——这之前就已经生效,只是不可见。- 拆分你的配置(
/neoe config split)会完全静默丢失 Web 仪表板设置和你的存储后端选择——这两者在拆分配置部分列表中从未注册过,因此在拆分后总是回退到默认值(仪表板设置,以及存储即使配置了 SQLite/MySQL 也会回退到"json")。两者均已修复——webDashboard现在拥有自己的dashboard.json,storage现在位于main.json中。如果你已经遇到这个问题,请参阅拆分配置 wiki 页面——你的原始值可以从config.json.backup中恢复。 - 右键点击物理箱子块会导致整个打开流程每点击一次运行两次(重复的“没有钥匙”消息,可能会双重消耗钥匙)——已修复。
- 尚未配置奖励的箱子会无声地消耗一把钥匙并报告误导性
“keys”错误,而非“未配置奖励”——已修复;除非实际存在奖励,否则密钥不再被消耗。
- 在 16 个文件中的约 25 个命令参数上静默缺失了 Tab 补全功能(包括 crate/hologram/home/board/group 名称、物品 ID、玩家目标等)——已完成全面审计,全部修复。
- 箱子的
&编码显示名称在聊天、GUI 标题和密钥物品名称中显示为纯文本(例如&7Common Crate),而非彩色显示——已在整个模组范围内修复(所有通过MessageUtil构建的命令回复,而不仅仅是箱子)。 {server_name}现在是一个独立配置的普通名称(general.serverName),不再与任何 MOTD 绑定——新增的{server_motd}占位符用于处理“显示实际配置的 MOTD”的情况。/neoe reload对记分板系统静默无效(此前仅对此进行了 tablist 修复)——现在编辑 scoreboard.json 后重新加载会真正生效。- 某些库存辅助客户端模组的“从打开的 GUI 中提取物品”按钮可能会直接从
/crate preview/打开揭示 GUI 中窃取(并复制)物品——初始修复未能遗漏这些模组使用的确切方法;现在容器上的每个变异路径都已锁定,无论哪个模组在进行提取都会关闭它。经确认(通过 Quark),有些模组甚至根本不需要变异方法——它们只是读取并复制物品——因此两个箱子 GUI 现在也会标记每个显示的物品,如果该物品最终出现在你的真实库存中,则将其清除,无论其如何到达那里。预览的关闭/上一个/下一个按钮和填充面板在第一轮标记中被遗漏;也已修复。 - 物理箱子密钥物品从未真正可给予,即使以其他方式获得的密钥物品仍需虚拟余额来兑换——两者均已修复(见上面的
/crate key giveitem)。 - 格式错误的配置文件(例如手动编辑留下的多余花括号)可能导致服务器反复崩溃——JSON 解析错误现在回退到默认值,针对该文件驱动的配置,而不是导致服务器宕机。
- 拥有昵称的玩家在设置昵称后加入服务器的任何人眼中,标签页仍显示其真实 IGN——每次加入现在都会同步所有人的昵称覆盖,而不仅仅是加入玩家自己的。
/neoe reload(以及/scoreboard reload)可能会因致命的“网络协议错误”踢出每个查看侧边栏记分板的玩家——已修复。- 权限系统在启动初始化失败后无法恢复,除非完全重启(整个会话期间持续记录
PermissionManager is null)——当发生这种情况时,/neoe reload现在从头重新初始化它,而不是一直以相同方式失败。 - “可用配置拆分”/“旧版数据文件”的管理员通知在每次重启时永远打扰——每个通知现在在安装期间只显示一次,而不是每次会话显示一次。
- 在使用提取模组的提取按钮后立即关闭箱子 GUI 可能仍然赢得竞争并保持物品——现在关闭会在接下来的 ~4 秒内多次扫描,而不仅仅是一次,从而完全关闭时间窗口。
/crate admin create没有说明新箱子去了哪里——现在指向config/neoessentials/crates.json。/scoreboard reload从未刷新animations.json——只有/tablist reload做到了这一点。编辑动画并通过记分板命令重新加载会保留旧帧(原始{animation:...}/渐变文本,未格式化),直到也运行了/tablist reload。/eco give|set|take//pay从未使排行榜“金钱”板失效(仅/baltop自己的缓存),因此余额变化可能导致记分板“最富有的玩家”行停滞长达 60 秒——已修复。/baltop和/leaderboard <board>也在第一次调用时错误报告“无数据”,即使存在真实数据——已修复。- 经济系统在启动时若从未完成初始化,则没有任何恢复方法(静默停止在该会话剩余时间内持久化余额)——
/neoe reload现在重试它,与权限系统的现有自愈机制相同。 - 每当
security.enableInputValidation被关闭时,/pay和/eco give|take在每次使用时都会崩溃——在该绕过路径中,验证器返回了错误的类型——已修复。 {animation:NAME}/渐变/彩虹标签在聊天中从未解析——每个命令回复都使用仅知道颜色代码的解析器,不知道这些标签的存在,因此它们显示为原始纯文本(据报道,当箱子打开时,箱子名称显示未解析的{animation:animation})。在共享消息构建代码处在整个模组范围内修复,而不仅仅是箱子。注意:发送的聊天消息是发送瞬间当前动画帧的永久快照——聊天没有像标签页/记分板/全息图那样的实时更新通道,因此没有等效的intervalMs/refreshInterval。- 箱子 GUI 标题和箱子密钥的lore/悬停文本现在也解析动画/渐变标签,与密钥名称匹配(之前已修复)——相同的单次快照行为。
- 已确认,不是错误:箱子密钥(
/crate admin setkey)已经支持任何原版或模组物品,包含完整的 NBT/数据——没有固定的物品列表。 - 动画帧的渐变/彩虹标签在聊天中除非单独开启
chat.richText.enabled(默认关闭)才会被静默剥离——标签页/全息图始终渲染它们,无论该设置如何。已修复——动画渐变/彩虹现在也在聊天中始终渲染;配置仍然限制玩家自己键入原始渐变标签。 /neoe reload从未真正重新加载leaderboard.json(只有专用的/leaderboard reload做到了)——除了这个之外,每个兄弟系统的刷新间隔已通过/neoe reload正常工作。已修复。{animation:NAME}在其第一帧上永久冻结,在整个模组范围内(全息图、记分板、聊天、箱子密钥),在任何禁用标签页模块的服务器上——唯一 ever 推进
动画时钟是 Tablist 自身的刻处理程序,当 Tablist 关闭时它从未运行。任何全息图/记分板间隔设置都无法修复此问题,因为时钟本身从未移动。已修复——无论是否启用 Tablist,动画现在每刻都会推进。
-
将
hologram.refreshInterval(位于config.json)重命名为hologram.pollIntervalTicks—— 此前容易与每个全息图各自独立的、基于秒的refreshInterval(/hologram setrefresh)混淆,后者才是真正控制占位符刷新频率的配置项。将旧配置键的值调低至该值以下不会产生任何可见效果。升级时现有值会自动迁移保留。 -
无论动画自身的
frameDuration设置得多低,全息图动画始终会出现可见的突发式更新(“跳跃”/缓慢),尽管相同的设置在 Tablist/记分板中却能即时平滑应用——这是因为全息图刷新和动画刻共享同一个后台线程,导致缓慢的刷新周期延迟了下一次动画刻。已修复——它们现在运行在独立的线程上。此外,还将之前被静默吞掉的全息图渲染错误提升为可见警告。 -
带有保存的物品组件(自定义名称、描述、附魔)的箱子奖励/钥匙可能因两个独立监听器之间的启动顺序竞争而在服务器启动时静默丢失这些数据。已修复——箱子加载现在始终发生在绑定其所需注册表访问权限的修复之后执行。
-
在上述线程分离后,高负载下全息图动画仍可能出现突发式更新——调度器在延迟周期后通过连续触发来追赶进度,而非跳过。已通过改用从上一周期结束时刻开始等待的调度策略进行修复,从而确保永远不会积压任务以爆发式执行。
-
仅含颜色的
{animation:NAME}(渐变循环十六进制色在同一组文字上切换——最常见的动画形态)在全息图中可能会永远冻结在第一帧,即使上述修复已生效。原因在于变更检测比较的是纯文本内容,而仅颜色变化不会影响纯文本,因此系统从未检测到需要响应的变更。已修复。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
AE2:一款流行的自动化与存储模组
模组
添加区块认领和玩家组队功能,并与 Xaero's Minimap 和 World Map 集成
评论 0
登录后参与评分
还没有评论,来抢沙发吧