Regenerator 2000

Un desensamblador 6502 moderno e interactivo para máquinas Commodore de 8 bits. Una versión moderna de Regenerator.

• 🕹️ Análisis manual — Una TUI rápida y centrada en el teclado para exploración práctica: navega por el código, define datos, etiqueta subrutinas, añade comentarios y refina iterativamente tu desensamblado.
• 🤖 Análisis automatizado — Un servidor MCP incorporado permite que los asistentes de IA manejen el desensamblador de forma programática. Combinado con habilidades diseñadas específicamente, puede analizar programas completos — clasificando bloques, rastreando rutinas y nombrando símbolos — con una intervención humana mínima.

Usa cualquiera de los flujos de trabajo por separado, o combínalos: deja que la IA realice un primer pase y luego refina los resultados interactivamente.

Échale un vistazo a los Ejemplos para ver lo que se puede lograr, con juegos pre-desensamblados de diferentes plataformas Commodore.

Características

Regenerator 2000 incorpora comodidades modernas al desensamblado 6502:

• Desensamblado: Soporte completo para 6502, incluyendo opcodes no documentados.
• Volcado hexadecimal:
  • Vista lado a lado con el desensamblado.
  • Navegación sincronizada o independiente.
  • Conjunto de caracteres PETSCII sin desplazar o desplazado y Screencode.
• Sprites:
  • Vista lado a lado con el desensamblado.
  • Multicolor o un solo color.
• Bitmap:
  • Vista lado a lado con el desensamblado.
  • Alta resolución (320x200) y multicolor (160x200).
  • Utiliza renderizado de bloques en cuadrantes para resolución completa en la TUI.
• Conjunto de caracteres:
  • Vista lado a lado con el desensamblado.
  • Multicolor o un solo color.
• Bloques:
  • Vista lado a lado con el desensamblado.
• Depurador: Conéctate a VICE para desensamblado en vivo, puntos de interrupción, ejecutar/paso a paso (F2–F9); panel del depurador en el panel derecho.
• Minimapa: Minimapa del archivo que se está analizando.
• Sistemas: Soporta máquinas Commodore de 8 bits: C64, C128, VIC-20, Plus/4, PET 4.0, PET 2.0 y 1541.
• Importar: Carga los siguientes formatos de archivo
  • PRG: Archivos PRG
  • CRT: Imágenes de cartucho con soporte de selección de banco
  • D64: Imágenes de disco de 35/40/42 pistas
  • D71: Imágenes de disco de doble cara de 70/80 pistas
  • D81: Imágenes de disco de 80 pistas
  • T64: Imágenes de cinta
  • VSF: Archivos de sesión VICE
  • RAW / BIN: Archivos binarios sin formato
  • DIS65: Archivos de proyecto 6502bench
  • REGEN2000PROJ: Archivos de proyecto Regenerator 2000
• Desempaquetador binario: Emula un sandbox de fondo 6502 de ciclo exacto para descomprimir automáticamente programas C64 empaquetados.
• Exportar a .asm o HTML. Ensambladores compatibles:
  • 64tass
  • ACME
  • Kick Assembler
  • ca65
• Gestión de proyectos: Guarda y carga tu trabajo.
• Análisis: Autoanálisis para identificar regiones de código y datos.

Requisitos

Terminales recomendadas

Para garantizar la mejor experiencia, especialmente en lo que respecta a los atajos de teclado y la representación, recomendamos usar una terminal moderna.

Instalación

Desde Crates.io

cargo install regenerator2000

Desde el código fuente

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

Inicio rápido con Agentes de IA

Para comenzar rápidamente a analizar binarios usando un agente de IA (como Antigravity o Claude Code), puedes usar el repositorio regenerator2000-template. Viene preconfigurado con todas las habilidades y permisos de agente necesarios para que puedas empezar a analizar y aplicar ingeniería inversa a binarios de inmediato.

Uso

Inicia la aplicación con un archivo opcional para cargar:

regenerator2000 [OPCIONES] [ruta/al/archivo.prg]

Opciones de línea de comandos

• --help: Muestra el mensaje de ayuda
• --version: Muestra la información de la versión
• --import_lbl <RUTA>: Importa etiquetas de VICE desde el archivo especificado
• --export_lbl <RUTA>: Exporta etiquetas al archivo especificado (después del análisis/importación)
• --export_asm <RUTA>: Exporta el ensamblado al archivo especificado (después del análisis/importación)
• --export_html <RUTA>: Exporta HTML al archivo especificado (después del análisis/importación)
• --assembler <NOMBRE>: Sobrescribe el formato del ensamblador para la exportación. Valores válidos: 64tass, acme, ca65, kick
• --headless: Ejecuta en modo sin cabeza (sin TUI), útil para procesamiento por lotes

Formatos de archivo compatibles: .prg, .crt, .d64, .d71, .d81, .t64, .vsf, 6502bench (.dis65), .bin, .raw y .regen2000proj.

Atajos de teclado

Todos los atajos de teclado están documentados aquí: atajos de teclado

Soporte y documentación

• Documentación
• Ejemplos: Juegos y software Commodore desensamblados que muestran lo que se puede lograr con Regenerator 2000 en varias plataformas compatibles.
• Soporte en Discord (únete al canal #regenerator2000, en "Misc Projects")

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una Pull Request.

Agradecimientos

• Regenerator: El desensamblador 6502 original para Windows.
• unp64: El desempaquetador binario C64 de iAN CooG, en el que se basa el módulo de desempaquetado.
• 64tass, ACME, Kick Assembler, ca65: Ensambladores compatibles.

Licencia

Doble licencia: MIT y Apache 2.