🃏 CardEngine

The easiest way to create and render interactive RPG upgrade cards in Minecraft!

💡 Check out the Wiki for full integration details and advanced custom logic binding!

CardEngine is a lightweight, high-performance framework library designed for mod developers to implement card-based upgrade systems effortlessly. It handles all the heavy lifting—from capability storage, client-server packet synchronization, and smooth render overlays, to interactive card drafting interfaces.

⚡ Why Choose CardEngine?

🛠️ 2-Line Setup

Register cards and bind upgrade mechanisms with just 2 lines of code! CardEngine automatically handles rendering, capability tracking, and networking under the hood.

⚙️ Auto-Generated Templates & @CardParam

Save time by skipping manual JSON generation. Simply register cards programmatically in Java, and CardEngine will automatically write clean, editable JSON configuration files to the config folder on the first startup.

• Smart Parameter Exporting: Use the @CardParam annotation on your fields! CardEngine will automatically detect them and export these values as configurable parameters inside the card's JSON file.

• Dynamic UI Syncing: Once the JSON is generated, any manual tweaks you make to the values will be dynamically reloaded and reflected directly on the framework's UI overlays without rewriting a single line of Java code.

🎮 Built-in Interfaces

Comes out-of-the-box with a premium card drafting select screen (featuring smooth fade-in transitions) and a scrollable overlay showing consolidated player stats (toggled using the [ L ] key).

🚀 Quick Example

// Line 1: Register upgrade mechanism (Binds to Minecraft Attributes or custom logic)
CardRegistry.registerCard("my_mod:attack_damage", Attributes.ATTACK_DAMAGE);

// Line 2: Register a card and add it to the selection pool
CardRegistry.register("my_mod:ad_common", "my_mod:attack_damage");