Regenerator 2000

Ein moderner, interaktiver 6502-Disassembler für Commodore-8-Bit-Rechner. Eine moderne Interpretation von Regenerator.

• 🕹️ Manuelle Analyse — Ein schnelles, tastaturzentriertes TUI für praktische Erkundung: Code navigieren, Daten definieren, Subroutinen beschriften, Kommentare hinzufügen und die Disassemblierung iterativ verfeinern.
• 🤖 Automatisierte Analyse — Ein integrierter MCP-Server ermöglicht es KI-Assistenten, den Disassembler programmatisch zu steuern. In Kombination mit speziell entwickelten Skills kann er ganze Programme analysieren – Blöcke klassifizieren, Routinen verfolgen und Symbole benennen – mit minimalem menschlichen Eingriff.

Verwenden Sie jeden Arbeitsablauf einzeln oder kombinieren Sie sie: Lassen Sie die KI einen ersten Durchlauf machen und verfeinern Sie dann die Ergebnisse interaktiv.

Schauen Sie sich die Beispiele an, um zu sehen, was erreicht werden kann, mit vor-disassemblierten Spielen auf verschiedenen Commodore-Plattformen!

Funktionen

Regenerator 2000 bringt moderne Annehmlichkeiten in die 6502-Disassemblierung:

• Disassemblierung: Volle 6502-Unterstützung inklusive undokumentierter Opcodes.
• Hex-Dump:
  • Seitenansicht zusammen mit der Disassemblierung.
  • Synchronisierte oder unabhängige Navigation.
  • Unshifted oder Shifted PETSCII- und Screencode-Zeichensatz.
• Sprites:
  • Seitenansicht zusammen mit der Disassemblierung.
  • Multicolor oder Single Color
• Bitmap:
  • Seitenansicht zusammen mit der Disassemblierung.
  • Hochauflösend (320x200) und Multicolor (160x200).
  • Verwendet Quadrantenblock-Rendering für volle Auflösung im TUI.
• Zeichensatz:
  • Seitenansicht zusammen mit der Disassemblierung.
  • Multicolor oder Single Color
• Blöcke:
  • Seitenansicht zusammen mit der Disassemblierung.
• Debugger: Verbindung zu VICE für Live-Disassemblierung, Haltepunkte, Ausführen/Schritt (F2–F9); Debugger-Panel im rechten Bereich.
• Minimap: Minimap der analysierten Datei.
• Systeme: Unterstützt Commodore-8-Bit-Rechner: C64, C128, VIC-20, Plus/4, PET 4.0, PET 2.0 und 1541.
• Import: Folgende Dateiformate laden
  • PRG: PRG-Dateien
  • CRT: Cartridge-Images mit Bankauswahlunterstützung
  • D64: 35/40/42-Spur-Diskettenimages
  • D71: 70/80-Spur-doppelseitige Diskettenimages
  • D81: 80-Spur-Diskettenimages
  • T64: Bandimages
  • VSF: VICE-Sitzungsdateien
  • RAW / BIN: Rohe Binärdateien
  • DIS65: 6502bench-Projektdateien
  • REGEN2000PROJ: Regenerator-2000-Projektdateien
• Binär-Entpacker: Emuliert eine zyklenakkurate 6502-Hintergrund-Sandbox, um gepackte C64-Programme automatisch zu dekomprimieren.
• Export nach .asm oder HTML. Unterstützte Assembler:
  • 64tass
  • ACME
  • Kick Assembler
  • ca65
• Projektverwaltung: Speichern und Laden Ihrer Arbeit
• Analyse: Auto-Analyse zur Identifizierung von Code- und Datenbereichen.
• Bearbeiten:

Voraussetzungen

Empfohlene Terminals

Um die beste Erfahrung zu gewährleisten, insbesondere bezüglich Tastaturkürzel und Darstellung, empfehlen wir die Verwendung eines modernen Terminals.

Installation

Von Crates.io

cargo install regenerator2000

Aus dem Quellcode

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

Schnellstart mit KI-Agenten

Um schnell mit der Analyse von Binärdateien mit einem KI-Agenten (wie Antigravity oder Claude Code) zu beginnen, können Sie das Repository regenerator2000-template verwenden. Es ist bereits mit allen erforderlichen Skills und Agentenberechtigungen vorkonfiguriert, sodass Sie sofort mit der Analyse und dem Reverse-Engineering von Binärdateien beginnen können.

Verwendung

Starten Sie die Anwendung optional mit einer zu ladenden Datei:

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

CLI-Optionen

• --help: Hilfe anzeigen
• --version: Versionsinformationen anzeigen
• --import_lbl <PATH>: VICE-Labels aus der angegebenen Datei importieren
• --export_lbl <PATH>: Labels in die angegebene Datei exportieren (nach Analyse/Import)
• --export_asm <PATH>: Assembly in die angegebene Datei exportieren (nach Analyse/Import)
• --export_html <PATH>: HTML in die angegebene Datei exportieren (nach Analyse/Import)
• --assembler <NAME>: Assembler-Format für den Export überschreiben. Gültige Werte: 64tass, acme, ca65, kick
• --headless: Im headless-Modus ausführen (kein TUI), nützlich für Batch-Verarbeitung
• --verify: Export-Roundtrip überprüfen (exportieren → assemblieren → diff) für alle Assembler. Setzt voraus

Unterstützte Dateiformate: .prg, .crt, .d64, .d71, .d81, .t64, .vsf, 6502bench (.dis65), .bin, .raw und .regen2000proj.

Tastaturkürzel

Alle Tastaturkürzel sind hier dokumentiert: keyboard_shortcuts

Support und Dokumentation

• Dokumentation
• Beispiele: Disassemble Commodorespiele und Software-Demonstrationen, die zeigen, was mit Regenerator 2000 auf verschiedenen unterstützten Plattformen erreicht werden kann.
• Support auf Discord (treten Sie dem #regenerator2000-Kanal bei, unter „Misc Projects")

Mitwirken

Beiträge sind willkommen! Bitte zögern Sie nicht, einen Pull Request einzureichen.

Danksagungen

• Regenerator: Der ursprüngliche 6502-Disassembler für Windows.
• unp64: Der C64-Binär-Entpacker von iAN CooG, auf dem das Entpacker-Modul basiert.
• 64tass, ACME, Kick Assembler, ca65: Unterstützte Assembler.

Lizenz

Duale Lizenz: MIT und Apache 2