Get all actors from the RPG Maker MV project. Returns the full Actors.json data (excluding null entries).

Get a single actor by ID from the RPG Maker MV project.

Create a new actor in the RPG Maker MV project with the specified properties.

Update an existing actor's properties (partial update). Only the fields provided will be changed.

Search actors by name or nickname (case-insensitive).

Get all items from the RPG Maker MV project.

Get all weapons from the RPG Maker MV project.

Get all armors from the RPG Maker MV project.

Get all skills from the RPG Maker MV project.

Create a new item (consumable: potions, scrolls, etc.). Generates a complete RPG Maker MV item object.

Create a new weapon. Generates a complete RPG Maker MV weapon object.

Create a new armor. Generates a complete RPG Maker MV armor object.

Update an existing item, weapon, or armor by ID (partial update).

Search items, weapons, or armors by name or description (case-insensitive).

Get a single skill by ID.

Get all skills from the RPG Maker MV project.

Create a new skill with full control over all properties including damage, effects, etc.

Create a damage-dealing skill (simplified). Sets damage type to HP damage automatically.

Create a healing skill (simplified). Sets damage type to HP recover automatically.

Create a buff skill (simplified). Adds a buff effect to a parameter for a number of turns.

Create a state-inflicting skill (simplified). Adds a state effect like poison, sleep, etc.

Update an existing skill's properties (partial update).

Search skills by name or description (case-insensitive).

Get information about all maps in the project (MapInfos.json). Returns the map tree structure.

Get full map data by ID including events, tiles, and settings.

Get all events from a specific map.

Get a specific event from a map by event ID.

Create a new map with specified dimensions and properties. Optionally generates a tile layout by theme. When a tilesetId is provided with a theme, uses the enhanced V2 generator that reads actual tileset tile IDs for coherent, beautiful maps with proper shadow/region layers.

Fill an entire tile layer of a map with a specific tile ID. Useful for setting base terrain.

Create a new event on a map with specified position, name, trigger, and optional pages.

Generate a new map using the V3 procedural generator with Perlin noise, BSP dungeon, cellular automata caves. Supports 21 themes: forest, town, village, castle, dungeon, cave, beach, desert, swamp, ruins, interior, snow, harbor, volcano, sewer, fortress, magic_forest, magic_interior, space_interior, space_exterior, world. Generates events automatically (NPCs, chests, bosses, transfers). Returns mapId and seed used.

Generate multiple maps in a single call. Each entry specifies theme, size, tilesetId, name. Returns all mapIds for interconnection.

Create bidirectional transfer events between two maps. Player touch events at specified positions.

Add multiple events of a type (npc, chest, boss) to an existing map at random positions.

Set display names for multiple maps at once. Display name is shown to the player during gameplay.

Organize maps into folders by setting parentId. Creates a hierarchy in the RPG Maker editor map tree.

Update an existing map event's properties (partial update).

Add an event command to a specific page of an event. Command is inserted before the page terminator (code 0).

HIGH LEVEL: Create an NPC with dialogue on a map. Produces a 2-page event: Page 1 has dialogue triggered by Action Button, Page 2 shows "already talked" when Self Switch A is ON.

HIGH LEVEL: Create a chest event on a map. Produces a 2-page event: Page 1 gives items and activates Self Switch A, Page 2 shows "already opened" when Self Switch A is ON.

HIGH LEVEL: Create a teleport event that transfers the player to another map position.

Search map events by name (case-insensitive).

Get the full system data from System.json (game title, switches, variables, starting position, etc.).

Get all game switch names from the project.

Get all game variable names from the project.

Set a switch name by ID.

Set a variable name by ID.

Get the game title.

Update the game title.

Update the player starting position (map ID and coordinates).

Get all classes from the RPG Maker MV project. Returns all non-null entries from Classes.json.

Get a single class by ID.

Create a new class with the specified properties. Classes define skill learning, parameters, and traits for actors.

Update an existing class (partial update).

Search classes by name (case-insensitive).

Delete a class by ID (sets entry to null).

Get all enemies from the RPG Maker MV project.

Get a single enemy by ID.

Create a new enemy with the specified properties.

Create a boss enemy with higher stats and special attack pattern. Simplified helper.

Update an existing enemy (partial update).

Search enemies by name (case-insensitive).

Delete an enemy by ID.

Get all states from the RPG Maker MV project (poison, sleep, confusion, etc.).

Get a single state by ID.

Create a new state (poison, sleep, confusion, buff, etc.).

Update an existing state (partial update).

Search states by name (case-insensitive).

Delete a state by ID.

Get all tilesets from the RPG Maker MV project.

Get a single tileset by ID.

Update a tileset (partial update).

Get all common events from the RPG Maker MV project.

Create a new common event. Trigger types: 0=none, 1=autorun, 2=parallel.

Update an existing common event (partial update).

Add an event command to a common event's command list.

Get all troops (enemy groups) from the RPG Maker MV project.

Get a single troop by ID.

Create a new troop (enemy group for battle encounters).

Add an enemy to an existing troop at auto-generated battle position.

Create a troop with specified enemies at auto-generated battle positions. Simplified helper for random encounters.

Get all animations from the RPG Maker MV project.

Get a single animation by ID.

Delete an actor by ID (sets entry to null in Actors.json).

Delete an item, weapon, or armor by ID and type.

Delete a skill by ID (sets entry to null in Skills.json).

Delete an event from a map by event ID.

Duplicate an existing map to create a new one with the same tiles and events.

Create a shop event on a map. Uses Shop Processing event commands with a list of goods.

Create an inn event on a map. Shows a choice (Yes/No), checks gold, and recovers all if the player can pay.

Create a boss battle event on a map. 2-page event: page 1 triggers battle, page 2 (self-switch A) for post-battle. On lose: game over.

Create a puzzle switch and door pair on a map. The switch activates a game switch; the door opens when that switch is ON. Creates 2 events.

Get a summary of the current RPG Maker MV project (counts of actors, items, maps, etc.).

Get a complete pre-digested context of the project. Call this FIRST before creating maps, events, or database entries. Returns: tilesets with available tile categories, maps list, actors, items/weapons/armors IDs, switches, variables, and available sprites.

Validate a map for common errors: invalid tile IDs, wrong layer usage, broken event commands, invalid references to switches/variables/items/troops, missing page terminators. Returns a list of issues found.

Switch the server to a different RPG Maker MV project at runtime. Validates the new path.

Analyze a tileset image (base64 PNG) to determine grid dimensions, tile count, rows and columns. Assumes standard RPG Maker MV 48x48 tile size.

Analyze a screenshot (base64 PNG) by splitting into 4 quadrants and returning the dominant color (average RGB) of each. Useful for visual reasoning about what's on screen.

Scan the project's img/ folder and Tilesets.json to build a complete asset index. Returns tileset sheet metadata (dimensions, tile counts, autotile kinds) and categorized available tiles (ground, water, wallSide, wallTop, roof, decoration) for each tileset. Also lists all PNG files in each img/ subdirectory. Use this before creating maps to get tilesetConfig for better tile layouts.

Get categorized tile IDs for a specific tileset. Returns tile IDs organized by category: ground, water, wallSide, wallTop, roof, decoration. Each entry includes the tileId, kind index, and description. Use this to pick specific tiles for manual map editing or to understand what tiles a tileset provides.