Description
# ⚠️ READ BEFORE DOWNLOADING / NÃO INSTALE ANTES DE LER ⚠️
**[EN]**
**IF YOU JUST DOWNLOAD THIS MOD AND OPEN THE GAME, IT WILL NOT WORK. YOU WILL HEAR NOTHING.**
This mod requires an external Local AI Server to process the voice and the text. You must download the server files from our GitHub and run them on your PC before playing.
**[PT-BR]**
**SE VOCÊ APENAS BAIXAR ESTE MOD E ABRIR O JOGO, ELE NÃO VAI FUNCIONAR. VOCÊ NÃO OUVIRÁ NADA.**
Este mod exige um Servidor de IA Local externo para processar a voz e o texto. Você precisa baixar os arquivos do servidor no nosso GitHub e rodá-los no seu PC antes de jogar.
---
## 🇺🇸 ENGLISH DESCRIPTION
**Narrador IA (AI Narrator)** is a chaotic mod that brings a fully local AI to watch your gameplay and brutally roast you for your actions in Minecraft.
Meet **Edson Calotas**, an aggressive, sarcastic, and street-smart virtual character from Brazil who will judge everything you do—from breaking dirt with your bare hands to taking damage from a zombie.
### ⚙️ How it Works & Installation
This mod works by sending your in-game actions (JSON) to a Python server running locally on your machine. This server uses Ollama (to generate the sarcastic text) and Kokoro (to generate the TTS audio) with zero delay.
**To play, you MUST follow these steps:**
1. Download this mod here on CurseForge.
2. Go to the project's GitHub Repository (Link below).
3. Download the Server Files (`.bat` and Python scripts).
4. Run `1_PRIMEIRA_VEZ.bat` to install Python and Ollama automatically.
5. Every time you want to play, start the server using `2_Iniciar_PC...bat`.
6. Wait for the green "Application startup complete" message in the terminal, open Minecraft, and enjoy the roasting!
*Everything is 100% Local. No internet connection needed for the AI, and no API keys required.*
**GitHub Repository & Server Files:** [https://github.com/Gabigoubi/Narrator.IA]
### 💡 Credits & Inspiration
This project and its architecture were heavily inspired by the amazing work done in:
**[minecraft-narrator by parmenashp](https://github.com/parmenashp/minecraft-narrator/tree/main)**. Huge thanks to the creator for the foundational idea!
---
## 🇧🇷 DESCRIÇÃO EM PORTUGUÊS (Atualização v1.1)
**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 sua no Minecraft.
Conheça o **Edson Calotas**, um parceiro virtual folgado, sarcástico e imaturo da Zona Leste de São Paulo, que vai julgar tudo o que você faz — desde quebrar terra com a mão até apanhar de zumbi lerdão.
### 🖥️ Requisitos de Hardware (LEIA ATENTAMENTE)
Como o "cérebro" da IA roda diretamente no seu computador, o mod exige hardware específico para processar a voz e o texto simultaneamente com o Minecraft sem travar o seu jogo.
* **Processador:** Intel Core i5 (8ª Geração ou superior) / AMD Ryzen 5
* **Memória RAM do Sistema:** 16 GB (Para rodar o Windows, dar 4GB pro Minecraft e sobrar folga).
* **Placa de Vídeo (GPU):** Essencial ter uma placa de vídeo dedicada com no mínimo **6 GB ou 8 GB de VRAM** (ex: RTX 3060, RTX 4060, RX 6600).
* **Armazenamento:** Instalação em SSD NVMe obrigatória.
### ⚙️ Como Funciona e Instalação
O mod captura suas ações no jogo e envia (via JSON) para um servidor Python rodando no seu próprio PC. Esse servidor usa o Ollama (para gerar o texto) e o Kokoro (para gerar a voz) de forma independente.
**Para jogar, você OBRIGATORIAMENTE precisa seguir estes passos:**
1. Baixe este mod aqui no CurseForge.
2. Acesse o nosso repositório no GitHub (Link abaixo).
3. Baixe os arquivos do Servidor (os scripts em Python e os arquivos `.bat`).
4. Dê dois cliques em `1_PRIMEIRA_VEZ.bat` para instalar o Python e o Ollama.
5. Sempre que for jogar, ligue o servidor clicando em `2_Iniciar_PC...bat`.
6. Espere a mensagem verde "Application startup complete" no terminal, abra o Minecraft e se prepare para ser zoado!
*Tudo roda 100% na sua máquina. Zero necessidade de internet para a IA, zero chaves de API.*
**Arquivos do Servidor e Código Aberto:** [https://github.com/Gabigoubi/Narrator.IA]
### 💡 Créditos e Inspiração
A arquitetura e a ideia deste projeto foram fortemente inspiradas no excelente trabalho feito em:
**[minecraft-narrator por parmenashp](https://github.com/parmenashp/minecraft-narrator/tree/main)**. Muito obrigado ao criador pela ideia que serviu de base para esta loucura!