O CodexMaster é um software desktop local projetado exclusivamente para Mestres de RPG (Dungeon Masters). Ao contrário de Virtual TableTops (VTTs) convencionais, este não é um aplicativo para os jogadores. É um painel de controle privado, rápido e totalmente offline, criado para otimizar a preparação e a condução de sessões de D&D 5e.
Com foco absoluto em agilidade e imersão narrativa, o CodexMaster substitui seus milhares de cadernos, anotações perdidas e abas do navegador por uma interface unificada, imersiva e com uma identidade visual dark-mode medieval nativa.
Seus dados pertencem a você. O sistema usa um banco de dados local (db.json) não destrutivo e totalmente offline. Sem nuvens, sem latência e sem contas premium.
Pesquise, filtre e consulte magias, itens e equipamentos em tempo real na mesa sem interromper a narrativa.
Monte seus encontros puxando monstros do banco de dados e jogue-os diretamente na arena. O sistema lida com as rolagens de iniciativa automatizadas para você focar apenas em rolar o dano.
Uma wiki estilo Obsidian integrada ao app. Crie documentos Markdown ilimitados, organize o mundo em pastas (com suporte nativo a Drag & Drop), copie e cole imagens e crie Links Internos ([[Nome da Nota]]) para interconectar NPCs, cidades e eventos.
Nunca mais esqueça em qual cidade os heróis pararam. Mantenha uma linha do tempo elegante com os resumos das sessões em Markdown e gerencie os "Ganchos de Aventura" (Plots pendentes) em um checklist lateral de acesso rápido.
O grupo fez algo inesperado? Sem problema. Crie as suas próprias Tabelas de Saque ou Encontros com rolagens animadas de dados. Utilize também os nossos 5 geradores estáticos de emergência (Boatos de Taverna, Clima, Nomes de PNJs, Mercador e Ganchos).
O projeto foi construído sobre uma base moderna, garantindo segurança e escalabilidade:
- Electron: Motor Desktop (Main e Renderer isolados via
contextBridgepara máxima segurança). - React + Vite: Renderização de UI reativa e ultra-rápida.
- TypeScript: Tipagem estática severa por toda a base de código (Interfaces compartilhadas).
- Tailwind CSS: Estilização flexível mantendo nossa rigorosa paleta de cores medievais.
- React Image Crop: Edição e recorte nativo de avatares/capas das notas.
Certifique-se de ter o Node.js instalado na sua máquina e siga estes passos:
-
Clone o repositório:
git clone https://github.com/seu-usuario/codex-master.git cd codex-master -
Instale as dependências:
npm install
-
Inicie o servidor de desenvolvimento:
npm run dev
Este comando inicia simultaneamente o servidor do Vite (Hot Reload para o React) e o wrapper do Electron.
Para empacotar a aplicação em um executável autônomo (Release) para Windows com instalador profissional e versão portátil embutida:
-
Rode o empacotador (Electron Builder):
npm run package
-
Acesse a compilação: Os arquivos compilados estarão localizados na pasta
release/na raiz do projeto, incluindo os instaladores e os executáveis independentes.
Já estamos de olho nas melhorias sugeridas pela comunidade:
- Painel Expandido de Mapas: Customização avançada de pinos de mapa (cor/escala) e integração direta com o módulo de Lore.
- Fichas e Atributos Homebrew: Adição de barras numéricas voláteis extras (ex: Mana, Ki) e tags customizadas.
- Rastreador de Efeitos de Combate: Registro de contadores de turnos para magias de Buff/Debuff e Condições diretamente no Combat Tracker.
- Módulo Soundpad Embutido: Criação de atalhos e crossfades suaves para gerenciar arquivos de áudio locais (MP3/WAV) do seu computador.
Criado e idealizado por Rainan de Oliveira Reis.
Distribuído sob a licença MIT. Sinta-se livre para modificar, distribuir e adaptar este software para as suas campanhas de RPG.