Regenerator 2000

Un moderno disassemblatore 6502 interattivo per macchine Commodore a 8 bit. Una rivisitazione moderna di Regenerator.

• 🕹️ Analisi manuale — Una TUI veloce e incentrata sulla tastiera per l'esplorazione pratica: naviga il codice, definisci i dati, etichetta le subroutine, aggiungi commenti e perfeziona iterativamente il disassemblato.
• 🤖 Analisi automatizzata — Un server MCP integrato permette agli assistenti AI di guidare il disassemblatore in modo programmatico. Abbinato a competenze appositamente create, può analizzare interi programmi — classificando blocchi, tracciando routine e nominando simboli — con un intervento umano minimo.

Usa uno dei due flussi di lavoro da solo, o combinali: lascia che l'AI faccia un primo passaggio, poi perfeziona i risultati in modo interattivo.

Dai un'occhiata agli Esempi per vedere cosa si può ottenere, con giochi pre-disassemblati su diverse piattaforme Commodore!

Caratteristiche

Regenerator 2000 porta comodità moderne al disassemblaggio 6502:

• Disassemblaggio: Supporto completo 6502 inclusi opcode non documentati.
• Hex Dump:
  • Vista affiancata con il disassemblato.
  • Navigazione sincronizzata o indipendente.
  • Charset PETSCII e Screencode non shiftato e shiftato.
• Sprite:
  • Vista affiancata con il disassemblato.
  • Multicolore o Monocromatico.
• Bitmap:
  • Vista affiancata con il disassemblato.
  • Alta risoluzione (320x200) e Multicolore (160x200).
  • Utilizza il rendering a blocchi di quadranti per la piena risoluzione nella TUI.
• Charset:
  • Vista affiancata con il disassemblato.
  • Multicolore o Monocromatico.
• Blocchi:
  • Vista affiancata con il disassemblato.
• Debugger: Connettiti a VICE per disassemblaggio in tempo reale, breakpoint, esecuzione/passo (F2–F9); pannello Debugger nel pannello destro.
• Mappa minima: Mappa in miniatura del file analizzato.
• Sistemi: Supporta macchine Commodore a 8 bit: C64, C128, VIC-20, Plus/4, PET 4.0, PET 2.0 e 1541.
• Importa: Carica i seguenti formati di file:
  • PRG: file PRG
  • CRT: immagini di cartuccia con supporto selezione bancale
  • D64: immagini disco 35/40/42 tracce
  • D71: immagini disco 70/80 tracce fronte-retro
  • D81: immagini disco 80 tracce
  • T64: immagini nastro
  • VSF: file sessione VICE
  • RAW / BIN: file binari grezzi
  • DIS65: file progetto 6502bench
  • REGEN2000PROJ: file progetto Regenerator 2000
• Spacchettatore binario: Emula un sandbox 6502 ciclicamente accurato per decomprimere automaticamente programmi C64 compressi.
• Esporta in .asm o HTML. Assembler supportati:
  • 64tass
  • ACME
  • Kick Assembler
  • ca65
• Gestione progetti: Salva e carica il tuo lavoro.
• Analisi: Analisi automatica per identificare aree di codice e dati.
• Modifica:
  • Etichette: Aggiungi, modifica e rimuovi etichette locali e globali.

Requisiti

Terminali consigliati

Per garantire la migliore esperienza, specialmente per quanto riguarda scorciatoie da tastiera e rendering, consigliamo di utilizzare un terminale moderno.

Installazione

Da Crates.io

cargo install regenerator2000

Dal codice sorgente

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

Avvio rapido con agenti AI

Per iniziare rapidamente ad analizzare binari utilizzando un agente AI (come Antigravity o Claude Code), puoi utilizzare il repository regenerator2000-template. È preconfigurato con tutte le competenze e le autorizzazioni dell'agente necessarie, così puoi iniziare immediatamente ad analizzare e fare reverse engineering dei binari.

Utilizzo

Avvia l'applicazione con un file opzionale da caricare:

regenerator2000 [OPZIONI] [percorso/del/file.prg]

Opzioni CLI

• --help: Mostra il messaggio di aiuto
• --version: Mostra le informazioni sulla versione
• --import_lbl <PERCORSO>: Importa etichette VICE dal file specificato
• --export_lbl <PERCORSO>: Esporta le etichette nel file specificato (dopo analisi/importazione)
• --export_asm <PERCORSO>: Esporta l'assembly nel file specificato (dopo analisi/importazione)
• --export_html <PERCORSO>: Esporta HTML nel file specificato (dopo analisi/importazione)
• --assembler <NOME>: Sostituisce il formato assembler per l'esportazione. Valori validi: 64tass, acme, ca65, kick
• --headless: Esegue in modalità headless (nessuna TUI), utile per elaborazione batch

Formati di file supportati: .prg, .crt, .d64, .d71, .d81, .t64, .vsf, 6502bench (.dis65), .bin, .raw e .regen2000proj.

Scorciatoie da tastiera

Tutte le scorciatoie da tastiera sono documentate qui: scorciatoie da tastiera

Supporto e Documentazione

• Documentazione
• Esempi: Giochi e software Commodore disassemblati, dimostrando cosa si può ottenere con Regenerator 2000 su varie piattaforme supportate.
• Supporto su Discord (unisciti al canale #regenerator2000, nella sezione "Misc Projects")

Contributi

I contributi sono benvenuti! Sentiti libero di inviare una Pull Request.

Ringraziamenti

• Regenerator: L'originale disassemblatore 6502 per Windows.
• unp64: Lo spacchettatore binario C64 di iAN CooG, su cui si basa il modulo spacchettatore.
• 64tass, ACME, Kick Assembler, ca65: Assembler supportati.

Licenza

Doppia licenza: MIT e Apache 2