Save Maker

Editor e conversor universal de saves para jogos de RPG Maker e correlatos com GUI e TUI interativa.

Português  •  English

📖 Sobre

O Save Maker é um editor e conversor universal, moderno e de alto desempenho para arquivos de save de jogos desenvolvidos em RPG Maker e motores correlatos. Ele foi projetado para permitir a visualização, modificação e recuperação de saves tanto através de uma Interface Gráfica Moderna (GUI) construída com CustomTkinter quanto por uma Interface Interativa no Terminal (TUI) desenvolvida com Rich, além de utilitários de linha de comando para exportação e importação direta.

Recursos Principais

• Suporte Universal a Motores de Jogos:
  • RPG Maker MV (.rpgsave — compressões None, Zlib, Gzip e LZString)
  • RPG Maker MZ (.rmmzsave — formato LZString moderno)
  • RPG Maker VX Ace (.rvdata2 — serialização Ruby Marshal)
  • RPG Maker VX (.rvdata — Ruby Marshal)
  • RPG Maker XP (.rxdata — Ruby Marshal)
  • RPG Maker 2000 / 2003 (.lsd — formato binário LcfSaveData)
  • Wolf RPG Editor / ウディタ (.sav — decodificação e edição)
  • Saves em JSON e Web (.json, .sav, .dat, .txt)
• Autodescoberta Inteligente de Banco de Dados:
  • Identifica automaticamente pastas de dados do jogo (data/, Data/, www/data/) e correlaciona IDs numéricos com os nomes reais de itens, armas, armaduras, heróis, switches e variáveis.
• Múltiplas Formas de Utilização:
  • GUI Moderna: Drag & Drop nativo de arquivos, alternância entre temas Dark e Light, abas para Visão Geral, Inventário, Grupo, Switches & Variáveis, Cheats Rápidos e Árvore JSON Raw.
  • CLI / TUI Interativa: Menus visuais e coloridos diretamente no terminal via Rich, com fallback automático para conexões SSH e ambientes headless.
  • Linha de Comando: Conversão direta ou em lote entre arquivos de save de RPG Maker e JSON legível.
• Integração Nativa com o Desktop Linux:
  • Menus de contexto no botão direito para gerenciadores de arquivos (Nautilus, Nemo, Dolphin) e atalhos de terminal globais (save-maker, savemaker, rse, etc.).

📋 Motivo

Apenas uma ferramenta para editar saves quando jogos bugam.

💻 Como iniciar

Requisitos

• Python 3.10+
• Git
• Tkinter / python3-tk (necessário para execução da GUI no Linux: sudo apt install python3-tk ou equivalente da sua distribuição)
• GNU Make (opcional, para execução simplificada dos comandos via Makefile)

Instalação

1. Clone o repositório do projeto:

git clone https://github.com/bgluis/save-maker.git

2. Navegue até o diretório do projeto:

cd save-maker

3. Configure o ambiente virtual e instale as dependências através de um dos métodos abaixo:

Método 1: Automático via Makefile (Recomendado)

make venv

Método 2: Manual via Python venv

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Como Usar

• Interface Gráfica Moderna (GUI):

  # Iniciar a GUI padrão
  make gui
  # Ou diretamente via Python:
  ./.venv/bin/python main.py
  
  # Abrir diretamente um arquivo de save na GUI:
  ./.venv/bin/python main.py /caminho/para/o/save/file1.rpgsave

• Interface Interativa no Terminal (CLI / TUI):

  # Iniciar no modo interativo
  make run
  # Ou diretamente via Python:
  ./.venv/bin/python main.py --interactive

• Exportação e Importação Direta (Linha de Comando):

  # Exportar save suportado para JSON legível
  ./.venv/bin/python main.py export save/file1.rpgsave save1.json
  
  # Importar JSON de volta para o formato de save do jogo
  ./.venv/bin/python main.py import save1.json save/file1_editado.rpgsave

• Integração Global no Desktop Linux (Atalhos & Botão Direito):

  # Instala atalhos de terminal e ações de contexto no Nautilus, Nemo e Dolphin
  make install

• Executar Testes Automatizados:

  make test

💻 Como iniciar no Windows

Requisitos

• Python 3.10+ — marque "Add Python to PATH" durante a instalação
• Git

Instalação

1. Clone o repositório:

git clone https://github.com/bgluis/save-maker.git
cd save-maker

2. Crie o ambiente virtual e instale as dependências:

python -m venv .venv
.\.venv\Scripts\activate
pip install -r requirements.txt

3. (Opcional) Instalação global com atalhos no terminal:

powershell -ExecutionPolicy Bypass -File scripts\install_windows.ps1

Como Usar no Windows

• Interface Gráfica Moderna (GUI):

  .\.venv\Scripts\python.exe main.py

• Interface Interativa no Terminal (CLI / TUI):

  .\.venv\Scripts\python.exe main.py --interactive

• Exportação e Importação Direta:

  .\.venv\Scripts\python.exe main.py export save\file1.rpgsave save1.json
  .\.venv\Scripts\python.exe main.py import save1.json save\file1_editado.rpgsave

Nota sobre terminal: Para melhor experiência com a CLI/TUI (cores e Unicode), use o Windows Terminal ou PowerShell 7+. No CMD legado, execute chcp 65001 antes de iniciar.

🤝 Contribuidores