Skip to content

flippelt/Immersive-Terminal-for-RPGs

Repository files navigation

Terminal Imersivo para RPG

English · Português

LIVE DEMO

Um site que simula um terminal de console retrô (estilo cool-retro-term) para usar como prop em mesas de RPG. Troque de "sistema" e o visual, os textos e o conteúdo mudam por completo. O Mestre cria cenários editando só arquivos JSON.

Sistemas incluídos: Alien (MU/TH/UR), Lancer (COMP/CON), Blade Runner (Esper), Warhammer 40K (Cogitator e Dataslate Imperial), Fallout (RobCo Termlink), Cyberpunk RED (NetWatch) e IBM 5151 (PC-DOS, fósforo verde — skin neutra/retrô pra cenários próprios).

Stack: React + Vite, 100% estático, sem backend. Áudio sintetizado no navegador (sem assets), fontes self-hosted (sem Google Fonts).


Recursos

  • CRT em CSS puro — scanlines, glow de fósforo, flicker, sweep, curvatura e vinheta. Respeita prefers-reduced-motion.
  • Terminal híbrido — boot animado por typewriter + prompt interativo com cursor inline que segue a digitação e as setas ←/→.
  • Bilíngue (EN / PT-BR) — interface e cenários em inglês e português; alterne pelo controle no canto inferior esquerdo. Os comandos não mudam de idioma. Autores podem traduzir seus próprios cenários (veja o CONTRIBUTING).
  • Arquivos trancadoscrack (força bruta animada), decrypt (minigame de cifra estilo Wordle) e unlock (senha conhecida), com barra de progresso configurável, teste de dificuldade opcional e cadeias de desbloqueio. Ler um arquivo (cat) abre um popup cinematográfico com rolagem.
  • Cinematografia do Mestre — eventos ao destrancar, popup de autodestruição com OVERRIDE e o rastreador estilo Cyberpunk.
  • Modo Mestre (escondido) — revela senhas e conteúdo trancado sem destrancar pros jogadores.
  • Som sintetizado — clique de tecla, beep de sucesso/erro, whoosh de boot e hum ambiente opcional, com volume controlável.
  • Temas + cenários — skin reutilizável separada do conteúdo da campanha; um tema pode hospedar várias campanhas.

Rodando localmente

npm install
npm run dev      # http://localhost:5173

Build de produção:

npm run build        # app completo → dist/
npm run lint         # ESLint
npm test             # Vitest (engine: parser, filesystem, autocomplete, locks)

Deploy

A cada push em main, .github/workflows/deploy.yml publica o app completo no GitHub Pages, na raiz do repositório — essa é a página pública oficial (a demo, com todos os sistemas e funções).


Documentação (Wiki)

A referência detalhada vive na Wiki:

  • Comandos — todos os comandos, atalhos, Modo Mestre, carregar campanha pela URL.
  • Autoria: Temas — o JSON da skin (paleta, fonte, CRT, sons, banner, boot).
  • Autoria: Cenários — pasta do cenário, scenario.json, árvore files/, markdown, login.
  • Arquivos Trancados — front-matter, crack vs decrypt, teste de dificuldade, cadeias.
  • Cinematografia — eventos, contagens, autodestruição, o rastreador.
  • Arquitetura — layout do código e as fontes.

Resumo rápido: navegue com ls/cd/cat, abra arquivos trancados com crack/ decrypt, troque de sistema com theme e de campanha com scenario. Ligue o Modo Mestre com Ctrl+Shift+G. Carregue uma campanha direto pela URL: .../?theme=cprd&scenario=heimdall.

🛠 Editor visual: prefere não editar JSON na mão? O scenario-forge (app desktop Win/Mac/Linux) monta o cenário por formulário — árvore de arquivos, flags (crack/tracer/lock), diálogo (query/ask), eventos — e testa neste terminal ao vivo, exportando a pasta versionável, o bundle JSON ou um link.


Contribuindo

Quer adicionar um tema novo? Veja o guia de contribuição. Todo PR passa pelo CI e precisa de aprovação da manutenção antes do merge.


Licença

Código sob MIT © 2026 Felipe Lippelt.

Conteúdo de fã, não-oficial. Os temas referenciam universos de terceiros (Alien, Lancer, Blade Runner, Warhammer 40,000, Fallout, Cyberpunk) apenas para uso em mesas de RPG. Este projeto não é afiliado nem endossado pelos detentores dessas marcas, que permanecem propriedade de seus respectivos donos. A licença MIT cobre apenas o código-fonte original deste repositório.

About

📟 Retro CRT terminal prop for tabletop RPGs (React + Vite) — swappable systems & GM-authored scenarios. Try the live demo →

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors