CardEngine

🃏 CardEngine

在 Minecraft 中创建和渲染交互式 RPG 升级卡片的最简单方法！

💡 查看 Wiki 获取完整的集成细节和高级自定义逻辑绑定！

CardEngine 是一个轻量级、高性能的框架库，专为模组开发者设计，可轻松实现基于卡片的升级系统。它处理了所有繁重的工作——从能力存储、客户端-服务器数据包同步、流畅的渲染覆盖层，到交互式卡片选择界面。

⚡ 为什么选择 CardEngine？

🛠️ 两行代码设置

只需两行代码即可注册卡片并绑定升级机制！CardEngine 会在幕后自动处理渲染、能力跟踪和网络通信。

⚙️ 自动生成的模板与 @CardParam

通过跳过手动 JSON 生成来节省时间。只需在 Java 中以编程方式注册卡片，CardEngine 会在首次启动时自动将干净、可编辑的 JSON 配置文件写入配置文件夹。

• 智能参数导出：在字段上使用 @CardParam 注解！CardEngine 会自动检测它们，并将这些值导出为卡片 JSON 文件中的可配置参数。

• 动态 UI 同步：生成 JSON 后，你对值进行的任何手动调整都会动态重新加载，并直接反映在框架的 UI 覆盖层上，无需重写任何 Java 代码。

🎮 内置界面

开箱即用，提供高级卡片选择界面（带有流畅的淡入过渡效果）和可滚动的覆盖层，显示整合的玩家统计数据（使用 [ L ] 键切换）。

🚀 快速示例

// 第1行：注册升级机制（绑定到 Minecraft 属性或自定义逻辑）
CardRegistry.registerCard("my_mod:attack_damage", Attributes.ATTACK_DAMAGE);

// 第2行：注册卡片并添加到选择池
CardRegistry.register("my_mod:ad_common", "my_mod:attack_damage");