🜏 Um RPG de terminal que une Programação Orientada a Objetos, narrativa procedural e Inteligência Artificial para criar um mundo vivo e imprevisível.
Euchronia é um RPG de terminal em Python que combina:
- ⚙️ POO estruturada para um núcleo limpo e expansível.
- ⚔️ Combate estratégico por turnos com Action Time e precisão probabilística.
- 💎 Buffs, debuffs, controle e habilidades configuráveis via JSON.
- 🧠 Integração com IA (OpenAI) para narrativa adaptativa e geração procedural.
O resultado é uma engine narrativa de RPG que reage às ações do jogador — cada escolha molda o mundo.
EUCHRONIA/
│
├── euchronia/
│ ├── models.py # Classes: Player, Enemy, AliveModel
│ ├── combat_logic.py # Sistema de combate e skills
│ ├── game_logic.py # HUD, menus e exploração
│ └── ai_services.py # (futuro) integração com IA
│
├── data/
│ ├── classes.json # Classes jogáveis
│ ├── skills.json # Habilidades e efeitos
│ ├── itens.json # Armas, poções e equipamentos
│ ├── enemy.json # Inimigos e loot tables
│ └── mapconfig/
│ ├── gps_map.json # Conexões entre regiões
│ ├── map.txt
│ └── atlas.json # Locais do mundo
│
├── saves/ # Dados persistentes do jogador
├── docs/ # GDD e documentação
│ └── RPG - EUCHRONIA.pdf
├── main.py
├── requirements.txt
└── README.md
Action Time: a velocidade define a ordem de ataque, com variação aleatória a cada rodada.
Precisão probabilística:
MISS (erro total)
SCRATCH (dano reduzido)
HIT (dano completo)
Fórmula balanceada de dano:
defense_reduction = defense / (defense + 100)
damage_final = damage * (1 - defense_reduction)
Tipo Exemplo Efeito ATTACK Golpe Pesado Dano físico direto BUFF Grito de Batalha Aumenta força ou defesa DEBUFF Adagas Envenenadas Reduz defesa ou aplica veneno CONTROL Prisão de Gelo Paralisa o inimigo
Todas configuradas em skills.json — expansíveis sem alterar o código.
──────────────────────────────────────────────────────────────
👤 Herói (Lv 3) ❤️ HP: 78/100 ⚔️ STR: 12 🛡 DEF: 9
vs
🐀 Rato Gigante ❤️ HP: 0/25 ☠️ DERROTADO
──────────────────────────────────────────────────────────────
💥 Golpe Pesado causa 23 de dano crítico!
🧪 Efeito “Sangramento” aplicado por 3 turnos!
🩸 O inimigo sofre 4 de dano residual.
──────────────────────────────────────────────────────────────
🏆 Vitória! +15 XP | Loot: Pele de Rato (x1)
──────────────────────────────────────────────────────────────
Interface otimizada para cores com rich e termcolor, incluindo HUD dinâmica com Live() e logs coloridos.
Classe Função Destaque
AliveModel Entidades vivas HP, força, defesa, efeitos
PlayerModel Jogador Inventário, XP, level, equips
EnemyModel Inimigos Dados carregados de enemy.json
CombatManager (planejado) Controla rodada e ordem de turnos
Cada entidade pode aplicar, atualizar e remover efeitos temporários de combate (buffs, debuffs, status).
-
Baseado em grafo de conexões (gps_map.json), cada nó é uma região explorável.
-
O atlas contém lore, bioma e inimigos locais.
-
O jogador pode viajar, explorar e enfrentar batalhas aleatórias em cada zona.
O progresso do jogador é salvo em saves/, incluindo:
* Status e nível atual
* Inventário e equipamentos
* Efeitos ativos e buffs
* Localização no mapa
* player.save("saves/slot_1.json") / player.load("saves/slot_1.json")
1️⃣ Clonar o repositório
git clone https://github.com/TheTekig/EUCHORNIA.git
cd EUCHORNIA
2️⃣ Criar ambiente virtual
python -m venv venv
source venv/bin/activate # Linux/Mac
venv\Scripts\activate # Windows
3️⃣ Instalar dependências
pip install -r requirements.txt
4️⃣ Executar o jogo
python main.py
Abaixo, a evolução do desenvolvimento do Euchronia, desde a concepção da engine até o lançamento planejado.
| Versão | Status | 🚩 Título da Atualização | 🛠️ Principais Implementações |
|---|---|---|---|
| v0.1.0 | ✅ | The Genesis (Out/2025) |
• Estrutura POO Core (AliveModel, Player)• Arquitetura Data-Driven (JSON) • Menu Principal via Terminal |
| v0.2.0 | ✅ | Tactical Update (Nov/2025) |
• Combate "Action Time" (Velocidade dinâmica) • Skills com tipos (Buff/Debuff/Control) • Sistema de Mapas em Grafo ( gps_map) |
| v0.3.0 | ✅ | AI Dungeon Master (Dez/2025) |
• Integração OpenAI API (ai_services)• Geração Procedural (Inimigos/Itens) • Sistema de Resumo de Lore (Memória) |
| v0.4.0 | 🚀 Atual | The Explorer's Journal (Dez/2025) |
• Sistema de Save/Load robusto • Mapas Visuais (PNG) e ASCII • Inventário e Equipamentos funcionais |
| v0.5.0 | 🔄 | Society & Economy (Em Breve) |
• Sistema de Mercantes (market.py)• NPCs Interativos e Diálogos • Quest Log ( campaign.json) |
| v0.6.0 | 🔜 | The Strategist (Planejado) |
• Menu de "Grimório" (Gerenciar Skills) • Balanceamento de Combate • Limite de slots de habilidades |
| v1.0.0 | 🏁 | Euchronia Awakening (Lançamento) |
• Tratamento de erros de API (Fallback) • Documentação Final • Release Oficial |
🎮 Desenvolvedor & Criador do universo Euchronia
📦 GitHub: @TheTekig
💬 “A fronteira entre o código e o imaginário é o que dá vida a Euchronia.”
📜 Licença
Distribuído sob MIT License — sinta-se livre para modificar, estudar e expandir o projeto.
🌒 “Cada bug conta uma história. Cada linha, uma nova era de Euchronia.” 🌘