RPG Maker JS Analyzer

Zweck & Benutzerabsicht: Das RPG Maker JS Analyzer richtet sich an Spieleentwickler, die RPG Maker MV/MZ verwenden und JavaScript einsetzen; es löst Probleme bei Versionskompatibilität, Plugin-Integration und Code-Qualität. Anwendungsfälle umfassen Migrationsprüfungen, Plugin-Kompatibilitätschecks und Scaffoldings für neue Plugins. Kernwert liegt in frühzeitiger Fehlererkennung, standardisierten Plugin-Vorlagen und reduzierten Debugging-Zyklen.
Kernlogik & Funktionen: Das Tool führt eine statische Analyse von JavaScript-Quellcode und Projekt-Manifests durch, identifiziert veraltete APIs, MV/MZ-Unterschiede und Konflikte mit Drittanbieter-Plugins. Erforderliche Features umfassen einen AST-basierten Parser, ein Delta-Mapping zwischen Engine-Versionen, einen Kompatibilitäts-Score und einen Scaffold-/Template-Generator für Plugins. Optional/fortgeschrittene Features umfassen eine sandboxed Evaluation, exportierbare Berichte, Code-Transformations-Empfehlungen und sofort nutzbares Template-Code, angepasst an MV/MZ-Konventionen.
Inputs & Outputs: Eingaben umfassen project_version (String), target_version (String), source_code (String oder Dateianhänge), plugin_list (Array von Strings) und analysis_mode (Enum: compatibility, scaffolding, metrics). Ausgaben umfassen einen strukturierten compatibility_report (JSON), issues (Array mit Feldern: id, severity, description, location), generated_scaffold (Code-Snippet) und summary_score (0–100). Validierung stellt sicher, dass Versionswerte MV oder MZ sind und source_code nicht leer ist; externe Delta-Daten verbleiben im Fehlerfall optional.
Algorithmen & Berechnungen: Ein AST-Parser analysiert Syntaxbäume, um API-Nutzung und API-Kompatibilitätskanten zu erkennen. Eine Delta-Tabelle kartiert MV→MZ-Änderungen für Kern-APIs und Plugin-Hooks. compatibility_score = max(0, 100 - sum(issue.weight for issue in issues)); jede Issue trägt Schweregrad-Gewichte. Scaffold-Generierung nutzt eine Template-Engine mit passenden Header-Metadaten und Plugin-Eintrittspunkten. Ergebnisse sind reproduzierbar bei gleichen Eingaben.
Fehler & Randfälle: Fehlende Eingaben lösen Schema-Fehler aus; unbekannte Versionen nutzen eine Best-Effort-Default-Delta. Wenn Änderungsprotokolle fehlen, greift das Tool auf interne Heuristiken zurück. Große Projekte können längere Analysezeiten verursachen; Timeouts erscheinen als teilweisige Ergebnisse. Zirkuläre Plugin-Abhängigkeiten werden gemeldet.
Branchen-/Region & Lokalisierung: Orientiert sich an RPG Maker MV/MZ-Konventionen, Plugin-Headern und plattformunabhängigen Identifikatoren. Unterstützt ECMAScript-Funktionen von MV/MZ; Lokalisierung wird durch vom Benutzer bereitgestellte Quellen geliefert.
Annahmen & Ausschlüsse: Erwartet JavaScript-Quellen innerhalb von RPG Maker-Projekten; führt keine Laufzeitinstrumentierung oder vollständige Migrationsautomatisierung durch; schließt nicht-JS-Assets und UI/UX-Basics aus.