RPG Maker JS Analyzer

Doel en gebruik: De RPG Maker JS Analyzer is bedoeld voor game-ontwikkelaars die RPG Maker MV/MZ gebruiken met JavaScript; het lost problemen op rond versie-compatibiliteit, plugin-integratie en codekwaliteit. Typische use cases zijn migratie-audits, plugin-compatibiliteitschecks en scaffolding van nieuwe plugins. De kernwaarde ligt in vroege probleemdetectie, gestandaardiseerde plugin-templates en verkorte debug-cycli.
Kernlogica & functies: De tool voert statische analyse uit van JavaScript-broncode en project-manifests, identificeert verouderde API's, MV/MZ-verschillen en conflicten met derdepartij-plugins. Vereiste functies zijn een AST-gebaseerde parser, deltamapping tussen engine-versies, een compatibiliteits-score en een scaffolding-templategenerator. Optionele/gevorderde functies omvatten een sandbox-waardering, exporteerbare rapporten, code-transformatie-adviezen en kant-en-klare template-code afgestemd op MV/MZ-conventies.
Inputs & Outputs: Invoer omvatten project_version, target_version, source_code (string of bestand), plugin_list (array strings) en analysis_mode (enum: compatibility, scaffolding, metrics). Uitvoer omvatten een gestructureerd compatibility_report (JSON), issues (array met velden: id, severity, description, location), generated_scaffold (code-snippet) en summary_score (0–100). Validatie: versies moeten MV of MZ zijn; source_code mag niet leeg zijn; externe delta-data wordt bij gebrek aan data op fallback gebruikt.
Algorithm & Berekeningen: Een AST-parser analyseert syntaxisbomen om API-gebruik en compatibiliteit te detecteren. Een delta-tabel koppelt MV→MZ-wijzigingen voor kern-API's en plugin-hooks. De compatibiliteitsscore = max(0, 100 - som(weight) van issues). Scaffolding generatie gebruikt templating met header metadata en plugin-entrypoints. Resultaten zijn reproduceerbaar bij dezelfde inputs.
Fouten & Randgevallen: Ontbrekende inputs geven schema-fouten; onbekende versies gebruiken een best-effort delta. Grote projecten kunnen langere analyse-tijden hebben; timeouts worden als deelresultaten weergegeven. Circuitaire plugin-afhankelijkheden worden gemarkeerd.
Industrie/Regio & Lokalisatie: Sluit aan bij RPG Maker MV/MZ-conventies, plugin-headers en locale-onafhankelijke identifiers. Ondersteunt ECMAScript-functies uit MV/MZ; lokalisatie wordt uitbesteed aan door de gebruiker aangeleverde bronnen.
Aannames & Uitsluitingen: Er wordt uitgegaan van JavaScript-broncode binnen RPG Maker-projecten; geen runtime-instrumentatie of volledige migratie-automatisering; sluit niet-JS-assets en UI/UX-zaken uit.