NARRADOR.IA

⚠️ CRITICAL UPDATE: READ BEFORE DOWNLOADING / ATENÇÃO: LEIA ANTES DE BAIXAR ⚠️

< 🚨 CLICK HERE TO JOIN OUR OFFICIAL DISCORD 🚨

< 🚨 CLIQUE AQUI PARA ENTRAR NO NOSSO DISCORD OFICIAL 🚨

[EN] IF YOU ARE UPGRADING FROM A PREVIOUS VERSION (v1.0, v1.1, v1.2, v1.3, v1.3.1, or v1.4), YOU MUST DELETE YOUR OLD SERVER FOLDER ENTIRELY. The v1.5 update completely changed the underlying brain and startup logic of the AI. Using old files will cause errors. Download the new files from our GitHub and start fresh.

[PT-BR] SE VOCÊ ESTÁ ATUALIZANDO DE UMA VERSÃO ANTERIOR (v1.0, v1.1, v1.2, v1.3, v1.3.1 ou v1.4), VOCÊ DEVE APAGAR TODA A SUA PASTA DO SERVIDOR ANTIGO. A v1.5 traz lógicas de inicialização e um cérebro completamente novo para a IA. Usar arquivos antigos causará erros no sistema. Baixe os arquivos novos do nosso GitHub e faça uma instalação limpa.

🇺🇸 ENGLISH DESCRIPTION (Update v1.5)

Narrador IA (AI Narrator) is a chaotic mod that brings a fully integrated AI to watch your gameplay and brutally roast you for your actions in Minecraft.

Meet Edson Calotas, a sarcastic, sharp-tongued, and street-smart virtual character from São Paulo, Brazil, who will judge everything you do—from breaking dirt with your bare hands, hoarding useless garbage in your inventory, to taking damage from a zombie because you used the wrong tool.

🚀 What's New in v1.5 (The Intelligent Favela Update):

• Laser Focus (Memory Clear): Edson now starts with a completely fresh mind every time you join the world! We cleared his "brain fog", so he won't bring up random things you did 10 minutes ago.
• Smarter Observations: Breaking 13 blocks of stone isn't 13 separate actions anymore. He now seamlessly groups repetitive tasks together, making his commentary much more natural.
• More Direct, Less Philosophy: We taught Edson to stop using weird analogies. Now, he drops the brutal truth straight to your face without holding back.
• Combat Fixes: Slapping passive mobs like chickens or squids won't trigger an epic battle reaction anymore. He saves his combat insults for when you take damage from real threats!
• The "Bouncer" (Pre-Flight Check): The Python server now has a strict startup scanner. If you forget to open Ollama, lack 12GB of RAM, or have a weak CPU, the server explicitly tells you what's wrong and refuses to start, preventing random crashes and BSoDs.
• Audio & QoL: We increased his speech time limits so sentences are never cut off, and the secret Easter Egg song now plays at a much more comfortable volume every 30 minutes!

💻 Hardware Requirements (STRICTLY ENFORCED)

Since the AI "brain" runs directly on your machine, specific hardware is strictly required to process voice and text alongside Minecraft. The new built-in scanner will check these before starting:

• Processor (CPU): Minimum of 6 Threads strictly required to run the local AI smoothly.
• System RAM: 12 GB Minimum (Hard Locked: The server will refuse to start and shut itself down with less than 12GB to protect your OS from freezing BSoD) / 16 GB Recommended.
• Graphics Card (GPU): Dedicated GPU with at least 6GB of VRAM (e.g., GTX 1660 Ti, RTX 2060, RX 5600 XT). 8GB+ VRAM recommended.
• Storage: SSD NVMe installation is mandatory.

⚙️ How it Works & Installation

The mod captures your in-game conditional events (now including inventory actions) and sends them to a Python server running locally on your machine. Everything runs locally on your hardware.

To play, you MUST follow these steps:

1. Download this mod here on CurseForge and place it in your mods folder.
2. Go to the project's GitHub Repository (Link below).
3. DELETE ANY PREVIOUS SERVER FOLDER YOU HAVE.
4. Download the new Server Files (.zip) and extract them to a folder on your PC.
5. Run 1_PRIMEIRA_VEZ.bat to install Python 3.11 and Ollama automatically. (Crucial: Check the "Add Python to PATH" box during Python installation!)
6. Always start the server before opening the game by running: 2_INICIAR_IA.bat.

[First Time Run Note]: On the first launch, the server will automatically download the AI model (~4.1 GB). Please wait patiently. Once you see the green success message, launch Minecraft and enjoy the roasting! Everything is 100% Local. No internet connection needed for the AI, and no API keys required.

🛡️ Safety, Ethics & Anti-Prompt Injection Policy

• Targeted Mockery: The narrator is programmed to mock in-game logic, survival struggles, and player choices. It is an intelligent, gameplay-focused roast.
• Zero Offense Policy: The AI is strictly forbidden from attacking the player's real-life identity, race, gender, religion, sexual orientation, or background.
• Quarantine Zone: Any attempt by the player to command, hijack, or rewrite the AI's behavior through the in-game chat will be caught by a quarantine filter, completely ignored, and ruthlessly mocked by the system.

GitHub Repository & Server Files: https://github.com/Gabigoubi/Narrator.IA

🇧🇷 DESCRIÇÃO EM PORTUGUÊS (Atualização v1.5)

Narrador IA é um mod caótico que traz uma Inteligência Artificial rodando 100% localmente no seu PC para assistir a sua gameplay e te esculachar por cada ação ou decisão burra sua no Minecraft.

Conheça o Edson Calotas, um parceiro virtual folgado, sarcástico e debochado da Zona Leste de São Paulo, que vai julgar tudo o que você faz — desde quebrar terra com a mão, acumular lixo no inventário, até apanhar de zumbi lerdão no escuro.

🚀 Novidades da v1.5 (Atualização Favela Inteligente):

• Foco Total (Memória Melhorada): O Edson agora zera a memória e acorda com a mente limpa toda vez que você entra no mundo! Limpamos a mente dele para que não alucine mais falando de coisas que você fez há 10 minutos.
• Observações Agrupadas: Se você quebrar 13 blocos de pedra, ele não vai mais ler isso como 13 ações separadas. Agora ele agrupa tarefas repetitivas perfeitamente, deixando a narração muito mais natural.
• Mais Direto, Menos Filósofo: Ensinamos o Edson a parar de usar aquelas analogias estranhas. Agora a ofensa é reta, direta e sem rodeios.
• Correções de Combate: Bater em galinhas ou lulas não vai mais fazer o Edson achar que você está numa batalha épica. Ele vai guardar o desespero e as ofensas para inimigos de verdade!
• O "Leão de Chácara" (Novo Sistema de Segurança): O servidor agora tem um segurança na porta. Se você esquecer de abrir o Ollama, tiver menos de 12GB de RAM ou um processador muito fraco, ele barra a inicialização e te avisa exatamente o motivo no terminal, evitando telas azuis no seu PC.
• Áudio e QoL: Aumentamos o limite de fala para que ele nunca mais seja cortado no meio da frase, e a musiquinha do Easter Egg agora toca a cada 30 minutos em um volume muito mais agradável.

🖥️ Requisitos de Hardware (LEIA ATENTAMENTE)

Como o "cérebro" da IA roda diretamente no seu computador, o mod exige hardware específico. O novo sistema "Leão de Chácara" fará uma varredura na sua máquina antes de ligar:

• Processador: Mínimo de 6 Threads exigidos pelo sistema para a IA conseguir raciocinar a tempo.
• Memória RAM: 12 GB Mínimo (Trava de Segurança: O programa fecha automaticamente se detectar menos de 12GB para proteger o seu Windows de travamentos severos) / 16 GB Recomendado.
• Placa de Vídeo (GPU): Placa dedicada com no mínimo 6 GB de VRAM (ex: GTX 1660 Ti, RTX 2060, RX 5600 XT). Recomendado 8GB+ de VRAM.
• Armazenamento: Instalação em SSD NVMe obrigatória.

⚙️ Como Funciona e Instalação

O mod captura suas ações no jogo de forma inteligente (agora incluindo o inventário) e envia para um servidor Python. Esse servidor usa o Ollama para gerar as respostas e o Kokoro para a síntese de voz em tempo real.

Para jogar, você OBRIGATORIAMENTE precisa seguir estes passos:

1. Baixe este mod aqui no CurseForge e coloque na sua pasta mods.
2. Acesse o nosso Repositório no GitHub (Link abaixo).
3. APAGUE QUALQUER PASTA ANTIGA DO SERVIDOR QUE VOCÊ TENHA.
4. Baixe os arquivos novos do Servidor (clicando em Code > Download ZIP) e extraia em uma pasta nova no seu PC.
5. Dê dois cliques em 1_PRIMEIRA_VEZ.bat e siga as instruções para instalar o Python 3.11 e o Ollama. (Regra de Ouro: Marque a caixa "Add Python 3.11 to PATH" na tela de instalação do Python!)
6. Sempre que for jogar, ligue o servidor clicando no arquivo: 2_INICIAR_IA.bat.

[Aviso de Primeiro Uso]: Na primeira vez, o terminal vai baixar o arquivo do modelo sozinho (~4.1 GB). Apenas espere pacientemente. Quando a mensagem verde de sucesso aparecer, abra o jogo e prepare-se para ser humilhado! Tudo roda 100% na sua máquina. Zero necessidade de internet para a IA, zero chaves de API.

🛡️ Diretrizes Éticas, de Humor e Segurança

• Foco na Gameplay: O objetivo do mod é o entretenimento através do humor ácido. O Edson Calotas vai zombar estritamente das suas decisões lógicas dentro do jogo, falta de habilidade e itens inúteis acumulados.
• Política de Respeito Absoluto: A IA possui travas comportamentais severas e está terminantemente proibida de ofender o jogador no âmbito pessoal, racial, religioso ou de gênero.
• Zona de Quarentena (Anti-Injeção de Prompt): O sistema foi blindado contra invasões. Se o jogador tentar enviar comandos no chat para "hackear" ou mudar a personalidade da IA, o sistema ignorará a ordem completamente e o Edson vai te esculachar por tentar dar uma de hacker.

Arquivos do Servidor e Código Aberto: https://github.com/Gabigoubi/Narrator.IA

💡 Créditos e Inspiração

A arquitetura e a ideia original deste projeto foram fortemente inspiradas no excelente trabalho de código aberto feito em: minecraft-narrator por parmenashp. Muito obrigado ao criador original por abrir as portas para essa comunidade!