卡片引擎

卡片引擎

一个轻量级框架，为自定义玩家升级和RPG机制添加了交互式卡牌抽取系统。

卡片引擎预览查看大图

🃏 CardEngine

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

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

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

⚡ 为什么选择 CardEngine？

  • 🛠️ 两行代码设置

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

  • ⚙️ 自动生成模板 & @CardParam

    无需手动生成 JSON 文件，节省时间。只需在 Java 中以编程方式注册卡牌，CardEngine 就会在首次启动时自动将清晰、可编辑的 JSON 配置文件写入 config 文件夹。

    • 智能参数导出： 在字段上使用 @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");