CrafEngine 仍处于 Beta 测试阶段。如有任何错误，请通过 Discord 报告，我们将尽快修复。

文档 Discord

关于 CraftEngine​

CraftEngine 重新定义了插件架构，使其成为实现自定义内容的下一代解决方案。其 JVM 级注入技术带来了前所未有的性能、稳定性和可扩展性。该框架提供代码优先 API，用于注册原生集成的块行为和项目交互逻辑。

技术概述​

区块​

该插件采用运行时字节码生成技术，在服务器原生级别注册自定义块，并结合客户端数据包修改实现视觉同步。该架构提供：

原生块定制

• 动态注册块并完全控制
• 物理学：硬度、可燃性、发光等。
• 自定义行为：树苗、农作物、掉落的方块等，通过 API 实现
• 香草兼容性：完全保留香草方块机制（例如，音符盒，绊线）

数据包集成

• 定义自定义矿脉
• 生成自定义树
• 配置自定义地形生成

性能优势

• 比传统的 Bukkit 事件监听器更快、更稳定
• 策略性代码注入以实现最小开销

食谱​

CraftEngine 通过底层注入实现了完全可定制的合成系统。与因 NBT 修改而失效的传统插件不同，它能够灵活处理物品元数据——合成结果始终与唯一的物品标识符绑定。

家具​

该插件利用核心实体存储家具元数据，并将碰撞实体和模块化组件作为客户端绑定数据包进行传输。该架构显著优化了服务器端性能，同时通过多部件集成支持复合家具的组装。

模板​

鉴于插件配置的广泛性和复杂性，我们实现了模块化模板系统来划分关键设置。这不仅支持用户自定义配置格式，还能显著减少冗余的 YAML 定义。

模型​

该插件可通过配置实现模型继承和纹理覆盖，同时支持 1.21.4 及以上版本的所有物品模型 。它集成了版本迁移系统，可自动将 1.21.4 及以上版本的物品模型降级为旧格式，并最大程度地实现向后兼容性。