🎮 RPG Maker Translator

Uma ferramenta de linha de comando (CLI) em Python para traduzir automaticamente jogos criados com a engine RPG Maker VX Ace. Utiliza modelos de tradução automática offline para processar os ficheiros de dados do jogo (.rvdata2), aplicando formatação inteligente para garantir que o texto traduzido se ajuste corretamente às caixas de diálogo.

📖 Sobre o Projeto

Este tradutor foi criado para automatizar o demorado processo de tradução de jogos de RPG Maker. Ele lê os ficheiros de dados do jogo, extrai todos os textos (diálogos, menus, itens, etc.), traduz utilizando um modelo de machine learning e reescreve os ficheiros de dados com o conteúdo traduzido, preservando a estrutura original.

O objetivo é fornecer uma tradução inicial de alta qualidade que pode então ser revisada por um tradutor humano, acelerando o processo de localização de jogos.

✨ Funcionalidades

🔄 Tradução Automática Offline: Utiliza a biblioteca argostranslate para realizar traduções sem depender de internet ou APIs pagas.
🗨️ Formatação Inteligente de Diálogos: Quebra o texto traduzido dinamicamente para não ultrapassar os limites das caixas de diálogo.
🧩 Estrutura Modular: Código organizado em módulos (config, file_handler, text_processor, user_interface) para fácil manutenção.
🎨 Interface Amigável: Usa a biblioteca rich para uma CLI moderna, com tabelas, barras de progresso e feedback visual.
🛡️ Aplicação Automática com Backup: Modo --auto-apply cria backup seguro da pasta original e aplica a tradução diretamente.

⚠️ Aviso: Precisão da Tradução

Esta ferramenta utiliza tradução automática. Embora forneça uma base sólida, não substitui um tradutor humano profissional. As traduções podem conter erros de contexto, gramaticais ou frases pouco naturais. Recomenda-se revisão por um falante fluente da língua de destino.

🛠️ Tecnologias Utilizadas

🚀 Como Usar

Pré-requisitos

Python 3.9 ou superior Verifique com:
```
python --version
```
Git (para clonar o repositório)
Um jogo criado com RPG Maker VX Ace

Instalação

git clone https://github.com/SophiaFrassetto/RPGMakerTranslator.git
cd RPGMakerTranslator

# (Recomendado) Crie e ative um ambiente virtual:
python -m venv .venv

# No Windows
.venv\Scripts\activate

# No macOS/Linux
source .venv/bin/activate

# Instale as dependências:
pip install -r requirements.txt

# Se não houver requirements.txt:
pip install rich rubymarshal argostranslate

Execução

A ferramenta é executada via main.py no terminal.

Uso Básico (configuração padrão)

python main.py

Especificando Parâmetros

python main.py --path "C:\Caminho\Para\SeuJogo\Data" --from-code "en" --to-code "es"

Aplicação Automática (com Backup)

python main.py --auto-apply

Ver Todas as Opções

python main.py --help

🗺️ Roadmap

Adicionar suporte para RPG Maker VX Ace (.rvdata2)
Adicionar suporte para RPG Maker VX (.rvdata)
Adicionar suporte para RPG Maker XP (.rxdata)
Criar testes automatizados para garantir a integridade dos ficheiros
Melhorar a lógica de detecção de texto para encontrar ainda mais textos traduzíveis

💬 Contribua

Sugestões, melhorias e correções são bem-vindas! Abra uma issue ou envie um pull request.

📄 Licença

Distribuído sob a licença MIT. Veja LICENSE para mais