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:
  • Labels: Hinzufügen, Bearbeiten und Entfernen lokaler und globaler Labels.
  • Enums: Definieren und anwenden von dreistufigen Wert-zu-Name-Zuordnungen (System, Global, Projektspezifisch), um magische Zahlen in Disassemblierung und Daten durch semantische Namen zu ersetzen.
  • Kommentare: Seitenkommentare und Zeilenkommentare hinzufügen.
  • Ursprung: Ladeadresse/Ursprung der Binärdatei ändern.
  • Datentypen: Bereiche konvertieren in Code, Byte, Word, Adresse, Low/High-Adresse, High/Low-Adresse, Low/High-Word, High/Low-Word, PETSCII-Text, Screencode-Text, Externe Datei oder Undefiniert.
  • Rückgängig/Wiederholen: Vollständige Versionsgeschichte für alle Aktionen.
• Navigation:
  • Springen: Zu bestimmten Adressen, bestimmten Zeilennummern oder Operanden folgen.
  • X-Ref: Querverweise für Labels/Adressen überprüfen.
  • Verlauf: Zurück zu vorherigen Positionen navigieren.
• Anpassung:
  • Dokumenteinstellungen konfigurieren (max. Querverweise, System, Assembler).
  • Anpassbare Anzeigeoptionen (alle Labels ein-/ausblenden usw.).
• TUI:
  • Textbasierte Benutzeroberfläche
  • Alles kann über die Tastatur erledigt werden
  • Visueller Modus: Vim-ähnliche Auswahl für Batch-Operationen.
• MCP-Server:
  • Unterstützung für Model Context Protocol (MCP)-Server für programmatischen Zugriff
  • HTTP- und stdio-Transportmodi
  • Werkzeuge zur Disassemblierungsmanipulation, Speichersuche, Blockoperationen
  • Ressourcen zum Zugriff auf Binärdaten und Ansichten
  • Gebündelte Analyse-Skills, die Blockklassifizierung, Routinenverfolgung und Symbolbenennung automatisieren
• Schnell:
  • Extrem schnell

Voraussetzungen

Empfohlene Terminals

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

Plattform	Empfohlene Terminals
Windows	Windows Terminal, Alacritty, WezTerm
macOS	iTerm2, Ghostty, Alacritty, kitty, WezTerm
Linux	Ghostty, Alacritty, kitty, WezTerm, GNOME Terminal

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