Inspect the BLACK SOULS MCP edition and live RGSS3 bridge status.

Launch the independent BLACK SOULS MCP edition and wait for its in-game bridge. The window is minimized after launch by default so real keyboard input cannot leak into the game; inputs keep working through the background wake path.

Read current scene, player, party, message, windows, and battle state directly from RGSS3.

Read the current nearby map tiles, passability, and events directly from RGSS3.

Inject one allowlisted virtual RPG Maker input into the normal game input loop.

Inject up to 200 allowlisted inputs and frame waits as one ordered sequence.

List independent MCP-edition save slots and metadata without modifying them.

Forcefully terminate the running BLACK SOULS process. Safe to call when game is not running.

Trigger an in-game save to a specific slot (0-indexed) by injecting menu navigation inputs. Only works from Scene_Map.

Load a save slot from the title screen or the in-game menu and return the resulting state.

Get a concise snapshot of the current game situation, contextual action suggestions, and warnings.

Read RPG Maker game variable values by ID. Request up to 64 IDs per call.

Read RPG Maker boolean switches by ID. Request up to 64 IDs per call.

Read the party's current inventory: consumable items, weapons, and armors with counts.

Read detailed party stats, equipment, and learned skills.

Read the AI agent's current session scratchpad.

Update notes, flags, or recent actions in the session scratchpad.

Read long-term game knowledge, optionally filtered by category.

Store or update one long-term game knowledge entry.

Delete one long-term memory entry.

Read the persistent objective hierarchy and active goal.

Create or update a persistent gameplay goal.

Choose the gameplay goal currently being pursued, or clear it.

Move to a target tile using automatic pathfinding over current passability data.

Walk up to and interact with a nearby event, optionally selected by ID.

Execute one battle turn in a single call: pick the command (attack / skill(特技) / magic(魔法) / guard / item / flee), the list index, and the enemy target; menu navigation is closed-loop against the real cursor. Indices come from black_souls_battle_options; a choice the battler cannot afford is refused before any input is spent. Returns resulting party (including MP/TP) and enemy state.

List everything the acting battler can do this turn: top-level commands, the full contents of every skill and magic submenu (name, MP/TP cost, whether it is usable right now, description), usable battle items with counts, and living enemy targets. Every entry carries the exact index to pass to black_souls_battle_action, so call this before choosing a battle action instead of guessing.

Advance active dialogue until it ends or a choice appears, optionally selecting a choice.

Request map tiles, passability, regions, terrain tags, and events up to radius 20. The scan runs inside one game frame: radius 6 is cheap, radius 20 freezes the game for about a second, so prefer 12 or less.

Inspect an event's pages, trigger conditions, active page, and self-switches.

Read deeper state for the active map, battle, or menu scene.

Comprehensive bridge health check with diagnosis and recommended recovery action.

Wait until a game condition becomes true before proceeding.

Append a significant gameplay event to the persistent session log.

Read the most recent persistent session log entries.

Check scenario completion conditions against live game state. Used by the eval runner; returns pass/fail per condition.