Cardinal RPG

Cardinal RPG is a modular, lightweight RPG framework designed for modern Minecraft (Fabric). It introduces a classic D&D-inspired attribute system, combat mechanics, and magic integration into the game, designed to be unobtrusive yet deeply customizable.

⚔️ Modules

The project is split into two main modules to allow for modpack flexibility:

• Cardinal Core: The heart of the mod. Handles player data, the 6 core attributes (STR, DEX, CON, INT, WIS, CHA), networking, and the persistence system. Can be installed alone if you just want the attribute API for other mods.
• Cardinal Combat: The action module. Implements damage scaling, critical hits, mana systems, spell casting, and floating damage indicators based on the Core attributes.

📊 Features

The 6 Core Attributes

Customize your character build using Stat Points gained from leveling up.

• Strength: Increases physical melee damage.
• Dexterity: Increases attack speed and movement speed.
• Constitution: Increases Max Health (HP).
• Intelligence: Increases Max Mana.
• Wisdom: Increases Mana Regeneration rate.
• Charisma: Affects social interactions and trading (Work in Progress).

Combat & Magic

• Dynamic Damage: Your damage isn't just about your sword; it's about how strong you are.
• Critical Hits: Luck and stats play a role in landing devastating critical strikes.
• Floating Damage Indicators: See exactly how much damage you deal in real-time.
• Mana System: A lightweight HUD displays your current Mana, regenerated over time based on Wisdom.
• Spells: Cast spells like Fireball (more coming soon) using mana.

GUI

• Press K (default) to open the RPG Stats Book.
• View your level, XP, and available points.
• Spend points to upgrade your attributes instantly.

💻 Commands

• /rpg getstats [player] - View a player's RPG stats.
• /rpg setstat <stat> <value> [player] - (Admin) Force set a specific stat.
• /rpg addxp <amount> [player] - (Admin) Give XP to a player.
• /rpg spendpoint <stat> <amount> - Manually spend points (alternative to GUI).

📥 Installation

1. Download and install Fabric Loader.
2. Download Fabric API.
3. Drop cardinal-core-x.x.x.jar AND cardinal-combat-x.x.x.jar into your mods folder.
   • Note: Both files are required for the full experience.

---

Cardinal RPG (Português)

Cardinal RPG é um framework RPG modular e leve para Minecraft (Fabric). Ele introduz um sistema de atributos inspirado em D&D clássico, mecânicas de combate e integração de magia ao jogo.

⚔️ Módulos

• Cardinal Core: O coração do mod. Gerencia dados do jogador e os 6 atributos principais.
• Cardinal Combat: O módulo de ação. Implementa escala de dano, críticos, sistema de mana, feitiços e indicadores de dano flutuantes.

📊 Funcionalidades

Os 6 Atributos Principais

• Força: Aumenta o dano físico corpo-a-corpo.
• Destreza: Aumenta a velocidade de ataque e movimento.
• Constituição: Aumenta a Vida Máxima (HP).
• Inteligência: Aumenta a Mana Máxima.
• Sabedoria: Aumenta a regeneração de Mana.
• Carisma: Afeta interações sociais e trocas.

Combate e Magia

• Dano Dinâmico: Seu dano escala com seus atributos.
• Indicadores de Dano: Veja o dano causado em tempo real com números flutuantes.
• Sistema de Mana: HUD leve que mostra sua Mana atual.

GUI

• Pressione K (padrão) para abrir o Livro de Atributos.
• Veja seu nível, XP e pontos disponíveis.

📥 Instalação

Coloque os arquivos cardinal-core e cardinal-combat na sua pasta mods. O Fabric API é obrigatório.