Regenerator 2000

Um desmontador 6502 moderno e interativo para máquinas Commodore de 8 bits. Uma versão moderna do Regenerator.

• 🕹️ Análise Manual — Uma TUI rápida e centrada no teclado para exploração prática: navegue pelo código, defina dados, rotule sub-rotinas, adicione comentários e refine iterativamente sua desmontagem.
• 🤖 Análise Automatizada — Um servidor MCP integrado permite que assistentes de IA conduzam o desmontador programaticamente. Combinado com habilidades específicas, pode analisar programas inteiros — classificando blocos, rastreando rotinas e nomeando símbolos — com intervenção humana mínima.

Use qualquer fluxo de trabalho individualmente, ou combine-os: deixe a IA fazer uma primeira passagem e depois refine os resultados interativamente.

Confira os Exemplos para ver o que pode ser alcançado, com jogos pré-desmontados em diferentes plataformas Commodore!

Features

O Regenerator 2000 traz conveniências modernas para a desmontagem 6502:

• Desmontagem: Suporte completo para 6502, incluindo opcodes não documentados.
• Dump Hex:
  • Visualização lado a lado com a desmontagem.
  • Navegação sincronizada ou independente.
  • Charset PETSCII e Screencode sem deslocamento ou com deslocamento.
• Sprites:
  • Visualização lado a lado com a desmontagem.
  • Multicolor ou Cor Única
• Bitmap:
  • Visualização lado a lado com a desmontagem.
  • Alta Resolução (320×200) e Multicolor (160×200).
  • Usa renderização por blocos de quadrantes para resolução total na TUI.
• Charset:
  • Visualização lado a lado com a desmontagem.
  • Multicolor ou Cor Única
• Blocos:
  • Visualização lado a lado com a desmontagem.
• Depurador: Conecte-se ao VICE para desmontagem ao vivo, pontos de interrupção, executar/passo a passo (F2–F9); painel do depurador no painel direito.
• Minimapa: Minimapa do arquivo sendo analisado.
• Sistemas: Suporta máquinas Commodore de 8 bits: C64, C128, VIC-20, Plus/4, PET 4.0, PET 2.0 e 1541.
• Importar: Carregar os seguintes formatos de arquivo
  • PRG: Arquivos PRG
  • CRT: Imagens de cartucho com suporte a seleção de bancos
  • D64: Imagens de disco de 35/40/42 trilhas
  • D71: Imagens de disco dupla-face de 70/80 trilhas
  • D81: Imagens de disco de 80 trilhas
  • T64: Imagens de fita
  • VSF: Arquivos de sessão do VICE
  • RAW / BIN: Arquivos binários brutos
  • DIS65: Arquivos de projeto 6502bench
  • REGEN2000PROJ: Arquivos de projeto do Regenerator 2000
• Descompactador Binário: Emula uma sandbox 6502 de fundo com precisão de ciclo para descomprimir automaticamente programas C64 compactados.
• Exportar para .asm ou HTML. Montadores suportados:
  • 64tass
  • ACME
  • Kick Assembler
  • ca65
• Gerenciamento de Projetos: Salve e carregue seu trabalho
• Análise: Análise automática para identificar regiões de código e dados.
• Edição:
  • Rótulos: Adicionar, editar e remover rótulos locais e globais.
  • Enums: Defina e aplique mapeamentos de valor para nome em três níveis (Sistema, Global, Específico do Projeto) para substituir números mágicos na desmontagem e dados por nomes semânticos.
  • Comentários: Adicionar comentários laterais e comentários de linha.
  • Origem: Alterar o endereço de carga/origem do binário.
  • Tipos de Dados: Converter regiões para Código, Byte, Palavra, Endereço, Endereço Baixo/Alto, Endereço Alto/Baixo, Palavra Baixa/Alta, Palavra Alta/Baixa, Texto PETSCII, Texto Screencode, Arquivo Externo ou Indefinido.
  • Desfazer/Refazer: Suporte completo a histórico para todas as ações.
• Navegação:
  • Ir para: Ir para endereços específicos, números de linha específicos ou seguir operandos.
  • X-Ref: Inspecionar referências cruzadas para rótulos/endereços.
  • Histórico: Navegar de volta para locais anteriores.
• Personalização:
  • Configurar configurações do documento (máx. de referências cruzadas, sistema, montador).
  • Opções de exibição personalizáveis (mostrar/ocultar todos os rótulos, etc.).
• TUI:
  • Interface de Usuário de Texto
  • Tudo pode ser feito pelo teclado
  • Modo Visual: Seleção semelhante ao Vim para operações em lote.
• Servidor MCP:
  • Suporte a servidor Model Context Protocol (MCP) para acesso programático
  • Modos de transporte HTTP e stdio
  • Ferramentas para manipulação de desmontagem, pesquisa de memória, operações de bloco
  • Recursos para acessar dados binários e visualizações
  • Habilidades de análise integradas que automatizam classificação de blocos, rastreamento de rotinas e nomeação de símbolos
• Rápido:
  • Extremamente rápido

Requirements

Recommended Terminals

Para garantir a melhor experiência, especialmente em relação a atalhos de teclado e renderização, recomendamos o uso de um terminal moderno.

Plataforma	Terminais Recomendados
Windows	Windows Terminal, Alacritty, WezTerm
macOS	iTerm2, Ghostty, Alacritty, kitty, WezTerm
Linux	Ghostty, Alacritty, kitty, WezTerm, GNOME Terminal

Installation

From Crates.io

cargo install regenerator2000

From Source

git clone https://github.com/ricardoquesada/regenerator2000.git
cd regenerator2000
cargo install --path .

Quick Start with AI Agents

Para começar rapidamente a analisar binários usando um agente de IA (como Antigravity ou Claude Code), você pode usar o repositório regenerator2000-template. Ele vem pré-configurado com todas as habilidades e permissões de agente necessárias para que você possa começar a analisar e fazer engenharia reversa de binários imediatamente.

Usage

Inicie o aplicativo com um arquivo opcional para carregar:

regenerator2000 [OPTIONS] [path/to/file.prg]

CLI Options