RPG Maker JS Analyzer

Syfte & Användning: Verktyget riktar sig till spelutvecklare som använder RPG Maker MV/MZ och arbetar med JavaScript; det löser tvärversionskompatibilitetsproblem, plugin-Integration och kodkvalitet. Användningsfall inkluderar migrationsgranskningar, plugin-kompatibilitet och scaffolding av nya plugins. Värdet ligger i tidig felupptäckt, standardiserade plugin-mallar och minskade debugging-cykler.
Kärnloggik & Funktioner: Verktyget gör statisk analys av JavaScript-källkod och projektmanifest för att hitta föråldrade API:er, MV/MZ-skillnader och konflikter med tredjeparts-plugins. Kräver funktioner inkluderar en AST-baserad parser, delta-mappning mellan motorversioner, en kompatibilitetspoäng och scaffold-/mallgenerator. Valfria/avancerade funktioner inkluderar sandbox-motor, exportbara rapporter, kodtransformationsrekommendationer och färdiga mallar anpassade efter MV/MZ.
Indata & Utdata: Inkluderar project_version, target_version, source_code (sträng eller fil), plugin_list (array av strängar) och analysis_mode (enum: compatibility, scaffolding, metrics). Utdata inkluderar en strukturerad compatibility_report (JSON), issues (array med fält: id, severity, description, location), generated_scaffold (kodsnutt) och summary_score (0–100). Validering: versioner måste vara MV eller MZ; source_code får inte vara tom.
Algoritmer & Beräkningar: En AST-parser analyserar syntaktiska träd för API-användning och kompatibilitetskanter. Delta-tabell kartlägger MV→MZ-ändringar för kärn-API:er och plugin-hooks. compatibility_score = max(0, 100 - sum(issue.weight for issue in issues)). Scaffold-generering använder en mallmotor med rätt metadata och plugin-entrypoints. Resultaten är reproducerbara med samma indata.
Felsökning & Kantfall: Saknade indata ger schemafel; okända versioner använder ett bäst-effort-delta. Stora projekt kan ta längre tid; tidsgränser visas som partiella resultat. Cirkulära pluginberoenden markeras.
Bransch/Region & Lokalisering: Stöder MV/MZ-konventioner, plugin-huvuden och lokaloberoende identifierare. Understöd ECMAScript-funktioner i MV/MZ; lokalisering överlåts till användarens källor.
Antaganden & Utflyttningar: Förutsätter JavaScript-källor i RPG Maker-projekt; ingen runtime-instrumentering eller fullständig migreringsautomation; exkluderar icke-JS-aktiviteter och UI/UX-aspekter.