rpgmaker-mz-mcp 1.0.0

package/dist/tools/skillTools.js

@@ -0,0 +1,369 @@
+import { z } from 'zod';
+import { readJsonFile, readJsonArraySoft, getDataPath } from '../utils/fileHandler.js';
+import { commitChange } from '../utils/commit.js';
+import { firstMissingEffectRef } from '../validation/createRefs.js';
+/**
+ * Get all skills from the project
+ */
+export async function getSkills(projectPath) {
+    const skillsPath = getDataPath(projectPath, 'Skills.json');
+    return await readJsonFile(skillsPath);
+}
+/**
+ * Build one new skill record against the current array — the shared per-record
+ * source of truth for both `create_skill` and `batch_create`. Pure: allocates the
+ * next unused id (max existing + 1) and fills every unsupplied field with the
+ * new-skill default. Does not push or commit, and does not run the effect
+ * reference check (that needs cross-file reads) — the caller owns both.
+ */
+export function buildSkillRecord(existing, input) {
+    const maxId = existing.reduce((max, skill) => (skill && skill.id > max ? skill.id : max), 0);
+    return {
+        id: maxId + 1,
+        name: input.name,
+        description: input.description || '',
+        iconIndex: input.iconIndex || 64,
+        mpCost: input.mpCost || 0,
+        tpCost: input.tpCost || 0,
+        tpGain: 0,
+        scope: input.scope || 1, // Default: enemy single
+        occasion: 1, // Battle only
+        speed: 0,
+        successRate: 100,
+        repeats: 1,
+        hitType: input.damage?.type === 1 || input.damage?.type === 5 ? 1 : 2,
+        animationId: input.animationId || 0,
+        damage: {
+            type: input.damage?.type || 0,
+            elementId: input.damage?.elementId || 0,
+            formula: input.damage?.formula || '0',
+            variance: input.damage?.variance !== undefined ? input.damage.variance : 20,
+            critical: input.damage?.critical !== undefined ? input.damage.critical : false,
+        },
+        effects: input.effects || [],
+        message1: input.message1 || '',
+        message2: '',
+        note: '',
+        stypeId: input.stypeId || 1, // Default: Magic
+        requiredWtypeId1: 0,
+        requiredWtypeId2: 0,
+        messageType: 1,
+        traits: [],
+    };
+}
+/**
+ * Reject a skill/item whose effects point at a non-existent state / skill /
+ * common event (P2-3: throw at author time, like add_class_learning /
+ * create_troop). Shared by `create_skill` and `batch_create`.
+ */
+export async function assertSkillEffectRefs(projectPath, skill, skills) {
+    const [states, commonEvents] = await Promise.all([
+        readJsonArraySoft(getDataPath(projectPath, 'States.json')),
+        readJsonArraySoft(getDataPath(projectPath, 'CommonEvents.json')),
+    ]);
+    const missing = firstMissingEffectRef(skill.effects, { states, skills, commonEvents });
+    if (missing) {
+        throw new Error(`Cannot create skill "${skill.name}": ${missing}`);
+    }
+}
+/**
+ * Create a new skill
+ */
+export async function createSkill(projectPath, skillData) {
+    const skills = await getSkills(projectPath);
+    const newSkill = buildSkillRecord(skills, skillData);
+    await assertSkillEffectRefs(projectPath, newSkill, skills);
+    skills.push(newSkill);
+    const skillsPath = getDataPath(projectPath, 'Skills.json');
+    await commitChange(skillsPath, skills);
+    return newSkill;
+}
+/**
+ * Update a skill's data
+ */
+export async function updateSkill(projectPath, skillId, updates) {
+    const skills = await getSkills(projectPath);
+    const skillIndex = skills.findIndex((skill) => skill && skill.id === skillId);
+    if (skillIndex === -1) {
+        throw new Error(`Skill with ID ${skillId} not found`);
+    }
+    skills[skillIndex] = { ...skills[skillIndex], ...updates, id: skillId };
+    const skillsPath = getDataPath(projectPath, 'Skills.json');
+    await commitChange(skillsPath, skills);
+    return skills[skillIndex];
+}
+/**
+ * Delete a skill
+ */
+export async function deleteSkill(projectPath, skillId) {
+    const skills = await getSkills(projectPath);
+    const skillIndex = skills.findIndex((skill) => skill && skill.id === skillId);
+    if (skillIndex === -1) {
+        return false;
+    }
+    // Don't delete core skills (1, 2)
+    if (skillId === 1 || skillId === 2) {
+        throw new Error('Cannot delete core skills (Attack/Guard)');
+    }
+    skills[skillIndex] = null;
+    const skillsPath = getDataPath(projectPath, 'Skills.json');
+    await commitChange(skillsPath, skills);
+    return true;
+}
+/**
+ * Search skills by name
+ */
+export async function searchSkills(projectPath, searchTerm) {
+    const skills = await getSkills(projectPath);
+    const lowerSearchTerm = searchTerm.toLowerCase();
+    return skills.filter((skill) => !!skill &&
+        (skill.name.toLowerCase().includes(lowerSearchTerm) ||
+            skill.description.toLowerCase().includes(lowerSearchTerm)));
+}
+/**
+ * Create a damage skill (attack spell or physical skill)
+ */
+export async function createDamageSkill(projectPath, name, damageFormula, mpCost, scope, elementId, description) {
+    return await createSkill(projectPath, {
+        name,
+        description: description || `Deals damage with ${name}.`,
+        mpCost,
+        scope,
+        damage: {
+            type: 1, // HP damage
+            elementId: elementId || 0,
+            formula: damageFormula,
+            variance: 20,
+            critical: true,
+        },
+        animationId: 1,
+        message1: '%1 casts %2!', // %1 = subject name, %2 = skill name
+        stypeId: 1, // Magic
+    });
+}
+/**
+ * Create a healing skill
+ */
+export async function createHealingSkill(projectPath, name, healFormula, mpCost, scope, description) {
+    return await createSkill(projectPath, {
+        name,
+        description: description || `Restores HP with ${name}.`,
+        mpCost,
+        scope,
+        damage: {
+            type: 3, // HP recovery
+            elementId: 0,
+            formula: healFormula,
+            variance: 20,
+            critical: false,
+        },
+        animationId: 47,
+        message1: '%1 casts %2!', // %1 = subject name, %2 = skill name
+        stypeId: 1,
+        iconIndex: 72,
+    });
+}
+/**
+ * Create a buff skill
+ */
+export async function createBuffSkill(projectPath, name, buffType, turns, mpCost, scope, description) {
+    return await createSkill(projectPath, {
+        name,
+        description: description || `Strengthens allies with ${name}.`,
+        mpCost,
+        scope,
+        effects: [
+            {
+                code: 31, // Add buff
+                dataId: buffType,
+                value1: turns,
+                value2: 0,
+            },
+        ],
+        animationId: 52,
+        message1: '%1 uses %2!', // %1 = subject name, %2 = skill name
+        stypeId: 1,
+        iconIndex: 73,
+    });
+}
+/**
+ * Create a debuff skill
+ */
+export async function createDebuffSkill(projectPath, name, debuffType, turns, mpCost, scope, description) {
+    return await createSkill(projectPath, {
+        name,
+        description: description || `Weakens enemies with ${name}.`,
+        mpCost,
+        scope,
+        effects: [
+            {
+                code: 32, // Add debuff
+                dataId: debuffType,
+                value1: turns,
+                value2: 0,
+            },
+        ],
+        animationId: 40,
+        message1: '%1 uses %2!', // %1 = subject name, %2 = skill name
+        stypeId: 1,
+        iconIndex: 74,
+    });
+}
+/**
+ * Create a state-inflicting skill
+ */
+export async function createStateSkill(projectPath, name, stateId, chance, mpCost, scope, description) {
+    return await createSkill(projectPath, {
+        name,
+        description: description || `Inflicts a status ailment with ${name}.`,
+        mpCost,
+        scope,
+        effects: [
+            {
+                code: 21, // Add state
+                dataId: stateId,
+                value1: chance,
+                value2: 0,
+            },
+        ],
+        damage: {
+            type: 0,
+            elementId: 0,
+            formula: '0',
+            variance: 20,
+            critical: false,
+        },
+        animationId: 1,
+        message1: '%1 uses %2!', // %1 = subject name, %2 = skill name
+        stypeId: 1,
+    });
+}
+export const skillToolDefinitions = [
+    {
+        name: 'create_skill',
+        mutates: true,
+        description: 'Create a new skill with custom properties. An effect referencing a missing record throws: Add/Remove State (code 21/22) → state, Learn Skill (43) → skill, Common Event (44) → common event.',
+        inputSchema: {
+            name: z.string().describe('Skill name'),
+            description: z.string().optional().describe('Skill description'),
+            iconIndex: z.number().int().min(0).optional().describe('Icon index (0-1000+)'),
+            mpCost: z.number().optional().describe('MP cost'),
+            tpCost: z.number().optional().describe('TP cost'),
+            scope: z
+                .number()
+                .int()
+                .min(0)
+                .optional()
+                .describe('Target scope (1=enemy single, 2=enemy all, 7=ally all, etc.)'),
+            damage: z
+                .object({
+                type: z
+                    .number()
+                    .int()
+                    .min(0)
+                    .optional()
+                    .describe('Damage type (0=none, 1=HP damage, 3=HP recover, etc.)'),
+                elementId: z
+                    .number()
+                    .int()
+                    .min(0)
+                    .optional()
+                    .describe('Element ID (0=none, 2=fire, 3=ice, etc.)'),
+                formula: z.string().optional().describe('Damage formula (e.g., "a.mat * 4 - b.mdf * 2")'),
+                variance: z.number().optional(),
+                critical: z.boolean().optional(),
+            })
+                .optional()
+                .describe('Damage configuration'),
+            effects: z
+                .array(z.unknown())
+                .optional()
+                .describe('Skill effects (buffs, debuffs, states, etc.)'),
+            animationId: z.number().int().min(0).optional().describe('Animation ID'),
+            message1: z.string().optional().describe('Battle message'),
+            stypeId: z.number().int().min(0).optional().describe('Skill type (1=magic, 2=special, etc.)'),
+        },
+        handler: (ctx, args) => createSkill(ctx.projectPath, args),
+    },
+    {
+        name: 'create_damage_skill',
+        mutates: true,
+        description: 'Create a damage-dealing skill (simplified)',
+        inputSchema: {
+            name: z.string().describe('Skill name'),
+            damageFormula: z.string().describe('Damage formula (e.g., "a.mat * 4")'),
+            mpCost: z.number().describe('MP cost'),
+            scope: z.number().int().min(0).describe('Target scope (1=enemy single, 2=enemy all)'),
+            elementId: z
+                .number()
+                .int()
+                .min(0)
+                .optional()
+                .describe('Element ID (0=none, 2=fire, 3=ice, 4=thunder)'),
+            description: z.string().optional().describe('Skill description'),
+        },
+        handler: (ctx, args) => createDamageSkill(ctx.projectPath, args.name, args.damageFormula, args.mpCost, args.scope, args.elementId, args.description),
+    },
+    {
+        name: 'create_healing_skill',
+        mutates: true,
+        description: 'Create a healing skill (simplified)',
+        inputSchema: {
+            name: z.string().describe('Skill name'),
+            healFormula: z.string().describe('Heal formula (e.g., "a.mat * 3 + 100")'),
+            mpCost: z.number().describe('MP cost'),
+            scope: z.number().int().min(0).describe('Target scope (7=ally all, 11=user)'),
+            description: z.string().optional().describe('Skill description'),
+        },
+        handler: (ctx, args) => createHealingSkill(ctx.projectPath, args.name, args.healFormula, args.mpCost, args.scope, args.description),
+    },
+    {
+        name: 'create_buff_skill',
+        mutates: true,
+        description: 'Create a buff skill (simplified)',
+        inputSchema: {
+            name: z.string().describe('Skill name'),
+            buffType: z.number().int().min(0).describe('Buff type (2=ATK, 3=DEF, 4=MAT, 5=MDF, 6=AGI)'),
+            turns: z.number().describe('Number of turns the buff lasts'),
+            mpCost: z.number().describe('MP cost'),
+            scope: z.number().int().min(0).describe('Target scope (7=ally all, 11=user)'),
+            description: z.string().optional().describe('Skill description'),
+        },
+        handler: (ctx, args) => createBuffSkill(ctx.projectPath, args.name, args.buffType, args.turns, args.mpCost, args.scope, args.description),
+    },
+    {
+        name: 'create_state_skill',
+        mutates: true,
+        description: 'Create a state-inflicting skill (poison, sleep, etc.). Throws if `stateId` does not exist in States.json (create the state first with create_state).',
+        inputSchema: {
+            name: z.string().describe('Skill name'),
+            stateId: z
+                .number()
+                .int()
+                .positive()
+                .describe('State ID (4=poison, 5=blind, 6=silence, 8=confusion, etc.)'),
+            chance: z.number().describe('Success chance (0.0-1.0)'),
+            mpCost: z.number().describe('MP cost'),
+            scope: z.number().int().min(0).describe('Target scope (1=enemy single, 2=enemy all)'),
+            description: z.string().optional().describe('Skill description'),
+        },
+        handler: (ctx, args) => createStateSkill(ctx.projectPath, args.name, args.stateId, args.chance, args.mpCost, args.scope, args.description),
+    },
+    {
+        name: 'update_skill',
+        mutates: true,
+        description: "Update a skill's properties",
+        inputSchema: {
+            skillId: z.number().int().positive().describe('The skill ID to update'),
+            updates: z.record(z.string(), z.unknown()).describe('Properties to update'),
+        },
+        handler: (ctx, args) => updateSkill(ctx.projectPath, args.skillId, args.updates),
+    },
+    {
+        name: 'search_skills',
+        description: 'Search skills by name or description',
+        inputSchema: { searchTerm: z.string().describe('Search term') },
+        handler: (ctx, args) => searchSkills(ctx.projectPath, args.searchTerm),
+    },
+];
+//# sourceMappingURL=skillTools.js.map

package/dist/tools/skillTools.js.map

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

package/dist/tools/stateTools.d.ts

@@ -0,0 +1,28 @@
+import { State } from '../utils/types.js';
+import { ToolDefinition } from '../registry.js';
+/**
+ * Blank state mirroring what the RPG Maker MZ editor writes for a freshly-created
+ * state: no restriction, priority 50, no auto-removal, 1-turn min/max, no
+ * messages/icon/traits. Pure so the template shape can be unit-tested. There is no
+ * canonical "blank" state in the editor's newdata template (all 30 samples are
+ * hand-tuned), so this reproduces the editor's "New State" default field values.
+ */
+export declare function defaultState(): Omit<State, 'id'>;
+/** Get all states from the project. */
+export declare function getStates(projectPath: string): Promise<(State | null)[]>;
+/**
+ * Create a new state. Only `name` is required; any omitted field falls back to
+ * the editor's new-state default (see {@link defaultState}). Allocates the next
+ * unused id (max existing + 1) and writes through the commit choke point.
+ */
+/**
+ * Build one new state record against the current array — the shared per-record
+ * source of truth for both `create_state` and `batch_create`. Pure: template
+ * first, caller's defined fields next, computed id last so it always wins.
+ */
+export declare function buildStateRecord(existing: (State | null)[], input: Partial<Omit<State, 'id'>>): State;
+export declare function createState(projectPath: string, overrides: Partial<Omit<State, 'id'>>): Promise<State>;
+/** Update an existing state's properties (shallow merge). */
+export declare function updateState(projectPath: string, stateId: number, updates: Partial<State>): Promise<State>;
+export declare const stateToolDefinitions: ToolDefinition[];
+//# sourceMappingURL=stateTools.d.ts.map

package/dist/tools/stateTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateTools.d.ts","sourceRoot":"","sources":["../../src/tools/stateTools.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD;;;;;;GAMG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CA0BhD;AAED,uCAAuC;AACvC,wBAAsB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,CAE9E;AAED;;;;GAIG;AACH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,EAC1B,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,GAChC,KAAK,CAOP;AAED,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,GACpC,OAAO,CAAC,KAAK,CAAC,CAMhB;AAED,6DAA6D;AAC7D,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,GACtB,OAAO,CAAC,KAAK,CAAC,CAUhB;AAED,eAAO,MAAM,oBAAoB,EAAE,cAAc,EAoFhD,CAAC"}

package/dist/tools/stateTools.js

@@ -0,0 +1,161 @@
+import { z } from 'zod';
+import { readJsonFile, getDataPath } from '../utils/fileHandler.js';
+import { commitChange } from '../utils/commit.js';
+import { definedOnly } from '../utils/records.js';
+/**
+ * Blank state mirroring what the RPG Maker MZ editor writes for a freshly-created
+ * state: no restriction, priority 50, no auto-removal, 1-turn min/max, no
+ * messages/icon/traits. Pure so the template shape can be unit-tested. There is no
+ * canonical "blank" state in the editor's newdata template (all 30 samples are
+ * hand-tuned), so this reproduces the editor's "New State" default field values.
+ */
+export function defaultState() {
+    return {
+        name: '',
+        restriction: 0,
+        priority: 50,
+        motion: 0,
+        overlay: 0,
+        removeAtBattleEnd: false,
+        removeByRestriction: false,
+        autoRemovalTiming: 0,
+        minTurns: 1,
+        maxTurns: 1,
+        removeByDamage: false,
+        chanceByDamage: 100,
+        removeByWalking: false,
+        stepsToRemove: 100,
+        releaseByDamage: false,
+        iconIndex: 0,
+        message1: '',
+        message2: '',
+        message3: '',
+        message4: '',
+        messageType: 1,
+        traits: [],
+        note: '',
+    };
+}
+/** Get all states from the project. */
+export async function getStates(projectPath) {
+    return await readJsonFile(getDataPath(projectPath, 'States.json'));
+}
+/**
+ * Create a new state. Only `name` is required; any omitted field falls back to
+ * the editor's new-state default (see {@link defaultState}). Allocates the next
+ * unused id (max existing + 1) and writes through the commit choke point.
+ */
+/**
+ * Build one new state record against the current array — the shared per-record
+ * source of truth for both `create_state` and `batch_create`. Pure: template
+ * first, caller's defined fields next, computed id last so it always wins.
+ */
+export function buildStateRecord(existing, input) {
+    const maxId = existing.reduce((max, s) => (s && s.id > max ? s.id : max), 0);
+    return {
+        ...defaultState(),
+        ...definedOnly(input),
+        id: maxId + 1,
+    };
+}
+export async function createState(projectPath, overrides) {
+    const states = await getStates(projectPath);
+    const state = buildStateRecord(states, overrides);
+    states.push(state);
+    await commitChange(getDataPath(projectPath, 'States.json'), states);
+    return state;
+}
+/** Update an existing state's properties (shallow merge). */
+export async function updateState(projectPath, stateId, updates) {
+    const states = await getStates(projectPath);
+    const index = states.findIndex((s) => s && s.id === stateId);
+    if (index === -1) {
+        throw new Error(`State with ID ${stateId} not found`);
+    }
+    states[index] = { ...states[index], ...updates, id: stateId };
+    await commitChange(getDataPath(projectPath, 'States.json'), states);
+    return states[index];
+}
+export const stateToolDefinitions = [
+    {
+        name: 'create_state',
+        mutates: true,
+        description: "Create a new state (status condition like Poison/Sleep) in data/States.json. Only `name` is required; omitted fields use the editor's new-state defaults (no restriction, priority 50, no auto-removal, 1-turn duration). Allocates and returns the next unused state id.",
+        inputSchema: {
+            name: z.string().describe('State name shown in the database and battle messages'),
+            restriction: z
+                .number()
+                .int()
+                .optional()
+                .describe('Behavior restriction: 0 none, 1 attack enemy, 2 attack anyone, 3 attack ally, 4 cannot move'),
+            priority: z
+                .number()
+                .int()
+                .optional()
+                .describe('Icon-slot display priority 0-100 (default 50)'),
+            motion: z
+                .number()
+                .int()
+                .optional()
+                .describe('SV-actor motion (0 normal, 2 sleep, 3 dead, …)'),
+            overlay: z.number().int().optional().describe('Overlay animation index (0 = none)'),
+            removeAtBattleEnd: z
+                .boolean()
+                .optional()
+                .describe('Remove automatically when the battle ends'),
+            removeByRestriction: z
+                .boolean()
+                .optional()
+                .describe("Remove when the battler's restriction changes"),
+            autoRemovalTiming: z
+                .number()
+                .int()
+                .optional()
+                .describe('Auto-removal timing: 0 none, 1 at action end, 2 at turn end'),
+            minTurns: z.number().int().optional().describe('Minimum duration in turns when auto-removed'),
+            maxTurns: z.number().int().optional().describe('Maximum duration in turns when auto-removed'),
+            removeByDamage: z.boolean().optional().describe('Remove when the battler takes damage'),
+            chanceByDamage: z
+                .number()
+                .int()
+                .optional()
+                .describe('Chance (%) of removal per damage instance when removeByDamage'),
+            removeByWalking: z.boolean().optional().describe('Remove after walking a number of steps'),
+            stepsToRemove: z
+                .number()
+                .int()
+                .optional()
+                .describe('Steps to walk off the state when removeByWalking'),
+            releaseByDamage: z.boolean().optional().describe('Whether damage can release the state'),
+            iconIndex: z
+                .number()
+                .int()
+                .optional()
+                .describe('Icon shown on the battler/status (0 = none)'),
+            message1: z.string().optional().describe('Message when an actor gains the state'),
+            message2: z.string().optional().describe('Message when an enemy gains the state'),
+            message3: z.string().optional().describe('Message when the state persists'),
+            message4: z.string().optional().describe('Message when the state is removed'),
+            messageType: z.number().int().optional().describe("Engine's message routing form"),
+            traits: z.array(z.unknown()).optional().describe('Trait objects { code, dataId, value }'),
+            note: z.string().optional().describe('Note field'),
+        },
+        handler: (ctx, args) => {
+            const { dryRun: _dryRun, ...overrides } = args;
+            return createState(ctx.projectPath, overrides);
+        },
+    },
+    {
+        name: 'update_state',
+        mutates: true,
+        description: "Update a state's properties (shallow merge into the existing record)",
+        inputSchema: {
+            stateId: z.number().int().positive().describe('The ID of the state to update'),
+            updates: z
+                .record(z.string(), z.unknown())
+                .describe('Object containing state properties to update'),
+        },
+        handler: (ctx, args) => updateState(ctx.projectPath, args.stateId, args.updates),
+    },
+];
+//# sourceMappingURL=stateTools.js.map

package/dist/tools/stateTools.js.map

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