rpgmaker-mz-mcp 1.0.0

package/dist/utils/types.d.ts

@@ -0,0 +1,465 @@
+/**
+ * Type definitions for RPG Maker MZ data structures
+ */
+export interface Actor {
+    id: number;
+    name: string;
+    nickname: string;
+    profile: string;
+    classId: number;
+    initialLevel: number;
+    maxLevel: number;
+    characterName: string;
+    characterIndex: number;
+    faceName: string;
+    faceIndex: number;
+    battlerName: string;
+    traits: Trait[];
+    equips: number[];
+    note: string;
+}
+export interface Item {
+    id: number;
+    name: string;
+    description: string;
+    iconIndex: number;
+    itypeId: number;
+    scope: number;
+    occasion: number;
+    speed: number;
+    successRate: number;
+    repeats: number;
+    tpGain: number;
+    hitType: number;
+    animationId: number;
+    price: number;
+    consumable: boolean;
+    damage: Damage;
+    effects: Effect[];
+    note: string;
+}
+export interface Skill {
+    id: number;
+    name: string;
+    description: string;
+    iconIndex: number;
+    stypeId: number;
+    mpCost: number;
+    tpCost: number;
+    scope: number;
+    occasion: number;
+    speed: number;
+    successRate: number;
+    repeats: number;
+    tpGain: number;
+    hitType: number;
+    animationId: number;
+    damage: Damage;
+    effects: Effect[];
+    note: string;
+    message1: string;
+    message2: string;
+    requiredWtypeId1: number;
+    requiredWtypeId2: number;
+    messageType: number;
+    traits: Trait[];
+}
+export interface Weapon {
+    id: number;
+    name: string;
+    description: string;
+    iconIndex: number;
+    wtypeId: number;
+    price: number;
+    params: number[];
+    traits: Trait[];
+    etypeId: number;
+    animationId: number;
+    note: string;
+}
+export interface Armor {
+    id: number;
+    name: string;
+    description: string;
+    iconIndex: number;
+    atypeId: number;
+    price: number;
+    params: number[];
+    traits: Trait[];
+    etypeId: number;
+    note: string;
+}
+export interface Enemy {
+    id: number;
+    name: string;
+    battlerName: string;
+    battlerHue: number;
+    params: number[];
+    exp: number;
+    gold: number;
+    dropItems: DropItem[];
+    actions: EnemyAction[];
+    traits: Trait[];
+    note: string;
+}
+/**
+ * A character class (`data/Classes.json`): the param growth curves, learnable
+ * skills, and traits that back an actor. The file is a 1-indexed array (slot 0
+ * null, index === id).
+ */
+export interface GameClass {
+    id: number;
+    name: string;
+    /** EXP curve settings: [basis, extra, accelerationA, accelerationB]. */
+    expParams: number[];
+    /**
+     * Parameter growth: 8 rows (`[maxHP, maxMP, atk, def, mat, mdf, agi, luk]`),
+     * each a `maxLevel + 1`-length curve indexed by level (index 0 is an unused
+     * level-0 placeholder; the engine only reads level ≥ 1).
+     */
+    params: number[][];
+    learnings: Learning[];
+    traits: Trait[];
+    note: string;
+}
+/** One "learn skill at level" entry in a class's `learnings` list. */
+export interface Learning {
+    level: number;
+    skillId: number;
+    note: string;
+}
+/**
+ * A common event (`data/CommonEvents.json`): a named, reusable event-command
+ * `list` that any map/battle event can invoke (command code 117) or that the
+ * engine runs on its own via `trigger`. The file is a 1-indexed array (slot 0
+ * null, index === id).
+ */
+export interface CommonEvent {
+    id: number;
+    name: string;
+    /** The command list, same `EventCommand` format map events use; ends with code 0. */
+    list: EventCommand[];
+    /** Switch that gates an Autorun/Parallel common event (ignored when trigger is 0). */
+    switchId: number;
+    /** When it runs on its own: 0 None (call-only), 1 Autorun, 2 Parallel. */
+    trigger: number;
+}
+/**
+ * A state (`data/States.json`): a status condition (Poison, Sleep, Dead, …) that
+ * can be applied to a battler by skills/items/traits. The file is a 1-indexed
+ * array (slot 0 null, index === id). States are referenced by skill/item effects
+ * (e.g. `create_state_skill`) and by traits, so an id must exist to be usable.
+ */
+export interface State {
+    id: number;
+    name: string;
+    /** Behavior restriction: 0 none, 1 attack enemy, 2 attack anyone, 3 attack ally, 4 cannot move. */
+    restriction: number;
+    /** Display priority when several states share an icon slot (higher wins), 0-100. */
+    priority: number;
+    /** SV-actor motion played while afflicted (0 normal, 1 abnormal, 2 sleep, 3 dead, …). */
+    motion: number;
+    /** Overlay animation index drawn over the battler (0 = none). */
+    overlay: number;
+    /** Remove automatically when the battle ends. */
+    removeAtBattleEnd: boolean;
+    /** Remove when the battler's restriction changes. */
+    removeByRestriction: boolean;
+    /** Auto-removal timing: 0 none, 1 at action end, 2 at turn end. */
+    autoRemovalTiming: number;
+    /** Minimum duration in turns when auto-removed. */
+    minTurns: number;
+    /** Maximum duration in turns when auto-removed. */
+    maxTurns: number;
+    /** Remove when the battler takes damage. */
+    removeByDamage: boolean;
+    /** Chance (%) of removal per damage instance when `removeByDamage`. */
+    chanceByDamage: number;
+    /** Remove after walking a number of steps (on the map). */
+    removeByWalking: boolean;
+    /** Steps to walk off the state when `removeByWalking`. */
+    stepsToRemove: number;
+    /** Whether damage can release the state (MZ addition alongside removeByDamage). */
+    releaseByDamage: boolean;
+    /** Icon shown on the battler/status (0 = none). */
+    iconIndex: number;
+    /** Message when an actor gains the state. */
+    message1: string;
+    /** Message when an enemy gains the state. */
+    message2: string;
+    /** Message when the state persists. */
+    message3: string;
+    /** Message when the state is removed. */
+    message4: string;
+    /** Which battler's message form to use (engine's message routing). */
+    messageType: number;
+    traits: Trait[];
+    note: string;
+}
+export interface Trait {
+    code: number;
+    dataId: number;
+    value: number;
+}
+export interface Effect {
+    code: number;
+    dataId: number;
+    value1: number;
+    value2: number;
+}
+export interface Damage {
+    type: number;
+    elementId: number;
+    formula: string;
+    variance: number;
+    critical: boolean;
+}
+export interface DropItem {
+    kind: number;
+    dataId: number;
+    denominator: number;
+}
+export interface EnemyAction {
+    skillId: number;
+    conditionType: number;
+    conditionParam1: number;
+    conditionParam2: number;
+    rating: number;
+}
+/**
+ * A troop (`data/Troops.json`): a battle group of enemy `members` plus optional
+ * battle-event `pages`. The file is a 1-indexed array (slot 0 null, index === id).
+ */
+export interface Troop {
+    id: number;
+    name: string;
+    members: TroopMember[];
+    pages: TroopPage[];
+}
+/** One placed enemy in a troop; `enemyId` references `data/Enemies.json`. */
+export interface TroopMember {
+    enemyId: number;
+    x: number;
+    y: number;
+    hidden: boolean;
+}
+/**
+ * A troop battle-event page: the same event-command `list` format map events use,
+ * gated by battle-specific `conditions` and repeated per `span` (0 battle / 1 turn
+ * / 2 moment). Note the conditions carry `enemyIndex` (troop slot), not an id.
+ */
+export interface TroopPage {
+    conditions: TroopPageConditions;
+    list: EventCommand[];
+    span: number;
+}
+export interface TroopPageConditions {
+    actorHp: number;
+    actorId: number;
+    actorValid: boolean;
+    enemyHp: number;
+    enemyIndex: number;
+    enemyValid: boolean;
+    switchId: number;
+    switchValid: boolean;
+    turnA: number;
+    turnB: number;
+    turnEnding: boolean;
+    turnValid: boolean;
+}
+export interface MapData {
+    autoplayBgm: boolean;
+    autoplayBgs: boolean;
+    battleback1Name: string;
+    battleback2Name: string;
+    bgm: AudioFile;
+    bgs: AudioFile;
+    disableDashing: boolean;
+    displayName: string;
+    encounterList: Encounter[];
+    encounterStep: number;
+    height: number;
+    width: number;
+    parallaxLoopX: boolean;
+    parallaxLoopY: boolean;
+    parallaxName: string;
+    parallaxShow: boolean;
+    parallaxSx: number;
+    parallaxSy: number;
+    scrollType: number;
+    specifyBattleback: boolean;
+    tilesetId: number;
+    note: string;
+    data: number[];
+    events: (MapEvent | null)[];
+}
+/**
+ * An entry in `data/MapInfos.json` — the map tree the editor displays. The file
+ * is a 1-indexed array (slot 0 is `null`) whose index matches the map's `id`.
+ * `parentId` 0 means a top-level map; `order` sequences siblings in the tree;
+ * `scrollX`/`scrollY` are the editor's remembered scroll position (cosmetic).
+ */
+export interface MapInfo {
+    id: number;
+    name: string;
+    parentId: number;
+    order: number;
+    expanded: boolean;
+    scrollX: number;
+    scrollY: number;
+}
+export interface MapEvent {
+    id: number;
+    name: string;
+    note: string;
+    pages: EventPage[];
+    x: number;
+    y: number;
+}
+export interface EventPage {
+    conditions: EventConditions;
+    directionFix: boolean;
+    image: EventImage;
+    list: EventCommand[];
+    moveFrequency: number;
+    moveRoute: MoveRoute;
+    moveSpeed: number;
+    moveType: number;
+    priorityType: number;
+    stepAnime: boolean;
+    through: boolean;
+    trigger: number;
+    walkAnime: boolean;
+}
+export interface EventConditions {
+    actorId: number;
+    actorValid: boolean;
+    itemId: number;
+    itemValid: boolean;
+    selfSwitchCh: string;
+    selfSwitchValid: boolean;
+    switch1Id: number;
+    switch1Valid: boolean;
+    switch2Id: number;
+    switch2Valid: boolean;
+    variableId: number;
+    variableValid: boolean;
+    variableValue: number;
+}
+export interface EventImage {
+    characterIndex: number;
+    characterName: string;
+    direction: number;
+    pattern: number;
+    tileId: number;
+}
+export interface EventCommand {
+    code: number;
+    indent: number;
+    parameters: any[];
+}
+export interface MoveRoute {
+    list: MoveCommand[];
+    repeat: boolean;
+    skippable: boolean;
+    wait: boolean;
+}
+export interface MoveCommand {
+    code: number;
+    parameters: any[];
+}
+export interface AudioFile {
+    name: string;
+    pan: number;
+    pitch: number;
+    volume: number;
+}
+export interface Encounter {
+    regionSet: number[];
+    troopId: number;
+    weight: number;
+}
+export interface SystemData {
+    airship: Vehicle;
+    armorTypes: string[];
+    attackMotions: AttackMotion[];
+    battleBgm: AudioFile;
+    battleback1Name: string;
+    battleback2Name: string;
+    battlerHue: number;
+    battlerName: string;
+    boat: Vehicle;
+    currencyUnit: string;
+    defeatMe: AudioFile;
+    editMapId: number;
+    elements: string[];
+    equipTypes: string[];
+    gameTitle: string;
+    gameoverMe: AudioFile;
+    locale: string;
+    magicSkills: number[];
+    menuCommands: boolean[];
+    optDisplayTp: boolean;
+    optDrawTitle: boolean;
+    optExtraExp: boolean;
+    optFloorDeath: boolean;
+    optFollowers: boolean;
+    optSideView: boolean;
+    optSlipDeath: boolean;
+    optTransparent: boolean;
+    partyMembers: number[];
+    ship: Vehicle;
+    skillTypes: string[];
+    sounds: AudioFile[];
+    startMapId: number;
+    startX: number;
+    startY: number;
+    switches: string[];
+    terms: Terms;
+    testBattlers: TestBattler[];
+    testTroopId: number;
+    title1Name: string;
+    title2Name: string;
+    titleBgm: AudioFile;
+    variables: string[];
+    versionId: number;
+    victoryMe: AudioFile;
+    weaponTypes: string[];
+    windowTone: number[];
+}
+export interface Vehicle {
+    bgm: AudioFile;
+    characterIndex: number;
+    characterName: string;
+    startMapId: number;
+    startX: number;
+    startY: number;
+}
+export interface AttackMotion {
+    type: number;
+    weaponImageId: number;
+}
+export interface Terms {
+    basic: string[];
+    commands: string[];
+    params: string[];
+    messages: {
+        [key: string]: string;
+    };
+}
+export interface TestBattler {
+    actorId: number;
+    equips: number[];
+    level: number;
+}
+export interface Tileset {
+    id: number;
+    name: string;
+    mode: number;
+    note: string;
+    /** The 9 image sheet filenames, positional: [A1,A2,A3,A4,A5,B,C,D,E]; '' = unused. */
+    tilesetNames: string[];
+    /** One bit-packed flag word per tile id (index === tile id, length 8192). */
+    flags: number[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/utils/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":"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"}

package/dist/utils/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for RPG Maker MZ data structures
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/utils/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/validation/assets.d.ts

@@ -0,0 +1,53 @@
+import { Actor, Enemy, Tileset, Troop, CommonEvent, MapData, SystemData } from '../utils/types.js';
+/**
+ * A single asset-filename-integrity finding. Warn-by-default (like {@link
+ * ReferenceWarning}): it never blocks a write, it tells the caller that a record
+ * points at an image/audio file that isn't present in the project — a dangling
+ * *filename* the engine only discovers at runtime, throwing e.g.
+ * "Failed to load img/enemies/Mudcrab.png" when the asset is first used.
+ * `category` groups findings by the kind of field; `path` locates it.
+ */
+export interface AssetWarning {
+    category: string;
+    path: string;
+    message: string;
+}
+/**
+ * The available asset basenames per asset type (extension-stripped, exactly as
+ * the engine references them). Built from `list_assets` — a type that's absent
+ * or maps to an empty set is treated as "can't verify" (its whole directory is
+ * empty or missing), so references against it are skipped rather than flagged
+ * (matching the per-record warn-by-default convention that never false-positives
+ * on an unused asset kind). Keyed by the same `AssetType` strings `list_assets`
+ * uses.
+ */
+export type AvailableAssets = Partial<Record<string, Set<string>>>;
+/**
+ * The loaded project data the asset linter scans. `maps` carries the full {@link
+ * MapData} (needed for the map-level bgm/bgs/parallax/battleback fields *and* the
+ * event command lists). Kept as plain data so {@link checkAssets} stays pure and
+ * unit-testable without file I/O.
+ */
+export interface AssetProjectData {
+    actors: (Actor | null)[];
+    enemies: (Enemy | null)[];
+    tilesets: (Tileset | null)[];
+    maps: Array<{
+        id: number;
+        map: MapData;
+    }>;
+    troops: (Troop | null)[];
+    commonEvents: (CommonEvent | null)[];
+    system: SystemData | null;
+}
+/**
+ * Audit every asset-*filename* reference across the project against the files
+ * actually present (see {@link AvailableAssets}). Pure and warn-by-default:
+ * returns a list of dangling filename references (a `battlerName`/`characterName`/
+ * `faceName`, a map bgm/bgs/parallax/battleback, a tileset sheet, an event Play
+ * Audio / Show Picture / Show Text face, a system title/battleback/sound, …) that
+ * point at a missing file — empty when everything resolves. The *id*-integrity
+ * sibling is {@link checkReferences}.
+ */
+export declare function checkAssets(data: AssetProjectData, assets: AvailableAssets): AssetWarning[];
+//# sourceMappingURL=assets.d.ts.map

package/dist/validation/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/validation/assets.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,KAAK,EACL,OAAO,EACP,KAAK,EACL,WAAW,EACX,OAAO,EAEP,UAAU,EAIX,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC;IACzB,OAAO,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC;IAC1B,QAAQ,EAAE,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC;IAC7B,IAAI,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC1C,MAAM,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC;IACzB,YAAY,EAAE,CAAC,WAAW,GAAG,IAAI,CAAC,EAAE,CAAC;IACrC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;CAC3B;AA0OD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,eAAe,GAAG,YAAY,EAAE,CAS3F"}