search_actors
Find RPG Maker actors by name or nickname to manage game character data in MZ/MV projects.
Instructions
Search actors by name or nickname
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"searchTerm": "<searchTerm>"
},
"name": "search_actors"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| searchTerm | Yes | The search term to find actors |
Implementation Reference
- src/tools/actorTools.ts:92-102 (handler)The handler function that performs the actor search logic by filtering based on name or nickname.
export async function searchActors(projectPath: string, searchTerm: string): Promise<Actor[]> { const actors = await getActors(projectPath); const lowerSearchTerm = searchTerm.toLowerCase(); return actors.filter(actor => actor && ( actor.name.toLowerCase().includes(lowerSearchTerm) || actor.nickname.toLowerCase().includes(lowerSearchTerm) ) ); } - src/index.ts:164-176 (registration)The tool definition for 'search_actors' registered in the MCP server.
name: 'search_actors', description: 'Search actors by name or nickname', inputSchema: { type: 'object', properties: { searchTerm: { type: 'string', description: 'The search term to find actors', }, }, required: ['searchTerm'], }, }, - src/index.ts:666-667 (registration)The tool dispatch logic in the MCP server that routes 'search_actors' to the appropriate handler.
case 'search_actors': return await actorTools.searchActors(this.projectPath, args.searchTerm);