RPG Maker JS Analyzer

Formål og bruk: Verktøyet er rettet mot spillutviklere som bruker RPG Maker MV/MZ og JavaScript; det løser problemer knyttet til versjonskompatibilitet, plugin-integrasjon og kodekvalitet. Bruksområder inkluderer migrasjonsrevisjoner, plugin-kompatibilitetskontroller og scaffolding av nye plugins. Verktøyets verdi ligger i tidlig feilfangst, standardiserte plugin-maler og forkortede debugging-sykluser.
Kjernelogikk & funksjoner: Verktøyet utfører statisk analyse av JavaScript-kildekode og prosjekt-manifester for å identifisere foreldede API-er, MV/MZ-forskjeller og konflikter med tredjeparts-plugins. Nødvendige funksjoner inkluderer en AST-basert parser, delta-mapping mellom motorversjoner, en kompatibilitetspoeng og en scaffolding-template-generator. Valgfrie/avanserte funksjoner inkluderer en sandbox-vurdering, eksportable rapporter, kode-transformasjonsanbefalinger og ferdige templates tilpasset MV/MZ.
Inndata & Utdata: Inndata — project_version, target_version, source_code (streng eller fil), plugin_list (array av strenger) og analysis_mode (enum: compatibility, scaffolding, metrics). Utdata — compatibility_report (JSON), issues (array med felt: id, severity, description, location), generated_scaffold (kodeutdrag) og summary_score (0–100). Validering: versjoner må være MV eller MZ; source_code må ikke være tomt.
Algoritmer & Beregninger: En AST-parser analyserer syntaks-trær for API-bruk og kompatibilitet. Delta-tabell kartlegger MV→MZ-endringer for kjerne-API-er og plugin-hooks. Kompatibilitetspoeng = max(0, 100 - sum(weight) av issues). Scaffold-generering bruker templates med metadata og plugin-entrypoints. Resultater er reproducerbare med samme input.
Feil & Kanttilfeller: Manglende inndata gir skjema-feil; ukjente versjoner bruker default delta. Store prosjekter kan ta lengre tid; tidsavbrudd vises som delresultater. Sirkulære plugin-avhengigheter markeres.
Næringsliv/Region & Lokalisering: Tilpasses MV/MZ-konvensjoner, plugin-headere og locale-uavhengige identifikatorer. Understøtter ECMAScript-funksjoner i MV/MZ; lokalisering håndteres av brukerens kilder.
Antagelser & Eksklusjoner: Forutsetter JavaScript-kilder i RPG Maker-prosjekter; ingen kjøring i sanntid eller full migrasjonsautomatisering; ekskluderer ikke-JS-aktiva og UI/UX-aspekter.