get_actor
Retrieve a specific actor by ID from RPG Maker MZ/MV projects to access character data for game development and management.
Instructions
Get a specific actor by ID
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| actorId | Yes | The ID of the actor to retrieve |
Implementation Reference
- src/tools/actorTools.ts:15-18 (handler)The handler function that retrieves a specific actor by ID from the list of actors.
export async function getActor(projectPath: string, actorId: number): Promise<Actor | null> { const actors = await getActors(projectPath); return actors.find(actor => actor && actor.id === actorId) || null; } - src/index.ts:108-117 (schema)The MCP tool definition and input schema for 'get_actor'.
name: 'get_actor', description: 'Get a specific actor by ID', inputSchema: { type: 'object', properties: { actorId: { type: 'number', description: 'The ID of the actor to retrieve', }, }, - src/index.ts:660-661 (registration)The tool handler registration/dispatch logic in the main MCP request handler.
case 'get_actor': return await actorTools.getActor(this.projectPath, args.actorId);