create_actor
Add a new character to RPG Maker MZ/MV projects by defining name, appearance, stats, and abilities for game development.
Instructions
Create a new actor
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| nickname | No | ||
| profile | No | ||
| classId | No | ||
| initialLevel | No | ||
| maxLevel | No | ||
| characterName | No | ||
| characterIndex | No | ||
| faceName | No | ||
| faceIndex | No | ||
| battlerName | No | ||
| traits | No | ||
| equips | No | ||
| note | No |
Implementation Reference
- src/tools/actorTools.ts:46-68 (handler)The createActor handler function that creates a new actor and saves it to Actors.json.
export async function createActor( projectPath: string, actorData: Omit<Actor, 'id'> ): Promise<Actor> { const actors = await getActors(projectPath); // Find the next available ID const maxId = actors.reduce((max, actor) => { return actor && actor.id > max ? actor.id : max; }, 0); const newActor: Actor = { id: maxId + 1, ...actorData }; actors.push(newActor); const actorsPath = getDataPath(projectPath, 'Actors.json'); await writeJsonFile(actorsPath, actors); return newActor; } - src/index.ts:140-157 (schema)The MCP tool schema definition for create_actor.
name: 'create_actor', description: 'Create a new actor', inputSchema: { type: 'object', properties: { name: { type: 'string' }, nickname: { type: 'string' }, profile: { type: 'string' }, classId: { type: 'number' }, initialLevel: { type: 'number' }, maxLevel: { type: 'number' }, characterName: { type: 'string' }, characterIndex: { type: 'number' }, faceName: { type: 'string' }, faceIndex: { type: 'number' }, battlerName: { type: 'string' }, traits: { type: 'array' }, equips: { type: 'array' }, - src/index.ts:664-665 (registration)The registration/dispatching logic that calls the createActor handler.
case 'create_actor': return await actorTools.createActor(this.projectPath, args);