-ED8B00?style=for-the-badge){kind=icon}
Bem-vindo ao projeto! O Narrador IA evoluiu. O que começou como uma zoeira para me humilhar enquanto jogo, tornou-se um sistema de direção narrativa que assiste sua gameplay, interpreta e te esculacha em tempo real.
Conheça o Edson Calotas, nosso parceiro virtual da Zona Leste. Ele não é mais um bot que lê logs do sistema; ele é um ator que recebe direção de cena e interpreta sua mediocridade no jogo com sarcasmo, deboche e ameaças veladas.
Esta versão coroa o projeto com uma arquitetura de alta performance, cruzamento de dados em tempo real e proteção anti-crash.
- Motor Multicontexto (Rules Engine): O cérebro do Edson deixou de ser linear. Agora ele percebe múltiplas ações simultâneas. Se você tomar dano de um monstro, minerar pedra e falar no chat na mesma janela de tempo, a IA integrará os três cenários em uma única fala orgânica e debochada.
- Buffer Inteligente (Early Flush): Falar no chat agora gera uma resposta quase instantânea. Um gatilho isolado detecta quando você digita, concatena suas mensagens por 10 segundos e força o disparo imediato da telemetria, zerando a latência sem perder as ações do ambiente.
- Handshake Defensivo (Graceful Degradation): Chega de telas de erro! O mod agora verifica automaticamente a compatibilidade de versão no momento do boot. Se você esquecer de atualizar o servidor Python, o jogo inicia normalmente, desativa a telemetria com segurança e emite um alerta elegante no seu chat.
O pipeline utiliza uma "Fronteira Seca" rigorosa para separar a coleta de dados da tomada de decisão:
- Sensor Java (Client-Side): Captura telemetria bruta via Mixins e Event Listeners sem vazar memória. Despacha Raw Data (JSON puro, coordenadas inteiras e flags) via HTTP Assíncrono utilizando
ConcurrentHashMappara evitar thread-blocking. - Regente Python (Backend): Motor lógico guiado a dados. Pesa o perigo, tédio e progresso, injeta a tradução semântica do ambiente e gera metadados estritos (
scene_type,focus_target,response_density). - Ator LLM (Inferência): Guiado por Few-Shot Prompting e limites seguros de tokens, a IA recebe uma descrição situacional do absurdo ocorrido e gera a resposta operando com uma janela estreita de contexto, erradicando alucinações narrativas.
O sistema possui um Dev Mode que permite rodar a inteligência via Cloud (Groq), reduzindo drasticamente o consumo de RAM local.
- Memória RAM: Mínimo de 12GB (Lock de segurança imposto para evitar BSoD).
- GPU: Dedicada com 6GB+ VRAM.
- Memória RAM: 4GB+ (O processamento pesado ocorre na nuvem).
- Necessário: API Key do Groq configurada no arquivo
.env.
Como o projeto é um ecossistema de duas partes, você precisa rodar o servidor Python e o Mod Java simultaneamente.
- Baixe o Mod: Instale o arquivo
.jarpela página oficial no CurseForge e coloque na pastamodsdo seu Minecraft 1.21.1 (Fabric). - Baixe o Servidor IA: Baixe o código deste repositório (botão
Code > Download ZIP) e extraia a pasta no seu PC. - Instalação Inicial: Execute o arquivo
1_PRIMEIRA_VEZ.bat. (Lembre-se de marcar "Add Python 3.11 to PATH" durante a instalação do Python!). - Ligar e Jogar: Sempre que for jogar, execute o arquivo
2_INICIAR_IA.bat. Deixe a tela aberta em segundo plano e abra o Minecraft.
⚠️ AVISO IMPORTANTE: A versão do arquivo.jardeve casar exatamente com a versão da pasta Python baixada. O nosso sistema de Handshake bloqueará a execução se as versões divergirem.
- Foco na Gameplay: O Edson Calotas zomba apenas de decisões lógicas dentro do jogo.
- Segurança: A IA possui travas comportamentais severas e está proibida de ofender o usuário pessoalmente.
- Blindagem Passiva: O sistema envelopa qualquer texto do chat em uma "jaula semântica", permitindo ler o que você escreve sem correr o risco de que o motor seja manipulado por comandos no jogo.
Inspirado no excelente trabalho estrutural de parmenashp: minecraft-narrator.