5.0.0
2025/08/06
重大改动
在更新到 5.0.0 版本之前,请务必备份您的插件目录和数据库。
本次更新对插件的核心架构进行了彻底重构,包括全新的数据库框架和 API。因此,旧版本的数据迁移是必需的,且操作可能存在风险。
请仔细阅读以下变更日志,以了解所有新功能和兼容性改动。
重构与优化
数据库框架升级
- 引入 Exposed ORM 框架: 数据库后端已从旧的数据层重构为更现代、更强大的 JetBrains Exposed ORM。这极大地提升了数据库操作的稳定性和性能,并为未来功能的扩展奠定了基础。
- 数据迁移工具: 插件现在内置了数据迁移工具,帮助您将旧版本的 MySQL 数据迁移到新版本。
API 全面重构
- 模块化设计: 插件 API 已进行全面重构,拆分为多个独立且清晰的模块,例如
QuestAPI、NavigationAPI、ConversationAPI等。这种设计极大地提高了开发者集成的便利性和代码的解耦性。 - 新接口与命名规范: 所有公共接口的名称和方法签名都已更新,以遵循更现代的 Kotlin 编程规范。旧版本 API 已全部移除,请开发者参考新的API 文档。
- 事件条目注册优化: ObjectiveEntity 代替了原有 QuestContext,简化了事件条目的管理流程
新增功能
- 重新设计导航系统:
- 重新设计的导航渲染器,开发者可以自定义导航的显示方式,例如粒子路径、行动条(ActionBar)消息提示、指南针等。
- 自定义标签系统:
- 新增
TagAPI,允许开发者为玩家添加、移除和检查自定义标签。这为任务、对话或其他逻辑判断提供了灵活的标记机制。
- 新增
- 取消追踪的命令:命令添加了手动取消追踪任务或事件条目功能。
修复与改进
- 优化了内存使用,减少了插件在服务器上的资源占用。