Cromatica

🃏 Cromatica

English

Cromatica is a collectible card mod for NeoForge 1.21.1 that lets server owners and content creators build fully customizable card collections directly inside Minecraft.

Create your own card series, organize them into categories, assign rarities, use custom backgrounds, and display Minecraft entities, items, or blocks as the featured subject of each card. Players can collect cards through gameplay and track their progress in an interactive in-game album.

✨ Features

• Create unlimited custom card series.
• Organize cards into categories.
• Multiple rarity levels.
• Custom card backgrounds.
• Display Minecraft entities, items, or blocks on cards.
• Interactive in-game collection album.
• Client-server synchronization.
• Hot reload support for newly created cards.
• Command autocomplete for series, categories, backgrounds, rarities, entities, items, and blocks.

---

📖 Album Command

Players can open their collection album using:

/cromatica album
/cromatica album <series>

• /cromatica album opens the first available series.
• /cromatica album <series> opens the selected series directly.

The server sends the player’s collection progress to the client, allowing the album to display every collected card.

---

🛠️ Administration Commands

Requires permission level 2.

Create a Series

/card series create <name>

Creates a new card series.

Add a Category

/card category add <series> <category>

Registers a category inside an existing series.

Create a Card

Basic card:

/card new <series> <card_id> <name> <description> <rarity> <category>

Advanced card:

/card new <series> <card_id> <name> <description> <rarity> <category> <background> <type> <id>

Where:

• background: PNG filename located in config/cromatica/backgrounds/ (without extension)
• type: entity, item, or block
• id: Minecraft resource location (for example minecraft:zombie)

Available rarities:

common
uncommon
rare
mythic
legendary
secret
event

---

📦 Installation

1. Install NeoForge for Minecraft 1.21.1.
2. Place the Cromatica .jar file inside the mods folder.
3. (Servers) Use /card series create to start building your first collection.

---

💬 Support

If you have questions, found a bug, or have suggestions, join the Discord server:

https://discord.gg/krAeCzEjvT

---

🃏 Cromatica

Español

Cromatica es un mod de cartas coleccionables para NeoForge 1.21.1 que permite a administradores de servidores y creadores de contenido diseñar colecciones de cartas totalmente personalizables dentro de Minecraft.

Crea tus propias series de cartas, organízalas por categorías, asigna rarezas, utiliza fondos personalizados y muestra entidades, bloques o ítems de Minecraft como elemento principal de cada carta. Los jugadores podrán coleccionarlas y seguir su progreso mediante un álbum interactivo integrado en el juego.

✨ Características

• Crea series de cartas ilimitadas.
• Organiza las cartas por categorías.
• Múltiples niveles de rareza.
• Fondos personalizados para las cartas.
• Representación de entidades, bloques o ítems de Minecraft.
• Álbum de colección interactivo dentro del juego.
• Sincronización cliente-servidor.
• Recarga en caliente de cartas nuevas.
• Autocompletado para series, categorías, fondos, rarezas, entidades, ítems y bloques.

---

📖 Comando del Álbum

Los jugadores pueden abrir su álbum mediante:

/cromatica album
/cromatica album <serie>

• /cromatica album abre la primera serie disponible.
• /cromatica album <serie> abre directamente la serie indicada.

El servidor envía el progreso de la colección al cliente para mostrar todas las cartas obtenidas.

---

🛠️ Comandos de Administración

Requiere nivel de permiso 2.

Crear una serie

/card series create <nombre>

Crea una nueva serie de cartas.

Añadir una categoría

/card category add <serie> <categoria>

Registra una categoría dentro de una serie existente.

Crear una carta

Carta básica:

/card new <serie> <card_id> <nombre> <descripcion> <rareza> <categoria>

Carta avanzada:

/card new <serie> <card_id> <nombre> <descripcion> <rareza> <categoria> <fondo> <tipo> <id>

Donde:

• fondo: nombre del archivo PNG ubicado en config/cromatica/fondos/ (sin extensión).
• tipo: entity, item o block.
• id: Resource Location de Minecraft (por ejemplo minecraft:zombie).

Rarezas disponibles:

common
uncommon
rare
mythic
legendary
secret
event

---

📦 Instalación

1. Instala NeoForge para Minecraft 1.21.1.
2. Coloca el archivo .jar de Cromatica en la carpeta mods.
3. (Servidores) Usa /card series create para comenzar tu primera colección.

---

💬 Soporte

¿Encontraste un error, tienes dudas o sugerencias?

Únete al servidor de Discord:

https://discord.gg/krAeCzEjvT