Skip to content

Releases: K-ame/rpgmaker-mv-ai-bridge

v0.1.1 — token required on /game, safer checkpoints

Choose a tag to compare

@K-ame K-ame released this 28 Oct 05:35

Security fix and a stricter checkpoint.

What changed

  • /game now requires the token. Any page the user visits can open a WebSocket to 127.0.0.1, and a new /game
    connection replaces the live one. Without this check such a page could kick the real game out and feed the agent
    fabricated state and dialogue. Connections without a valid token get a 401 and a hint to re-run install.
  • Plugin Token parameter. For games that cannot read ~/.mv-ai-bridge (a different user, or
    MV_AI_BRIDGE_HOME). Leave it empty in the normal case; the plugin reads the bridge's token file.
  • checkpoint save refuses to fire mid-scene. It now requires a settled map: saving during a message, event,
    choice or battle produced a snapshot that could not be restored.

Download

rpgmaker-mv-ai-bridge-v0.1.1.zip — no build step, no npm install. Node.js 20+ is the only requirement.

If you already installed the plugin, run install.bat / install.sh again (or copy the new
MV_AI_Bridge.js over the old one). Plugins from before this release carry no token and will be rejected.

Notes

24 protocol and plugin tests pass (npm test). The battle tools are still protocol-tested only.

v0.1.0 — first usable build

Choose a tag to compare

@K-ame K-ame released this 27 Oct 18:09

First usable build.

Download

rpgmaker-mv-ai-bridge-v0.1.0.zip — no build step, no npm install.

  • MV_AI_Bridge.js — the in-game plugin
  • mv-ai-bridge.cjs — the whole bridge bundled into one file (Node 20+)
  • install.bat / install.sh — copy the plugin into a game and register it in plugins.js
  • serve.bat — start the bridge
  • QUICKSTART.txt, README.md, LICENSE

Quick start

  1. Drag your game folder onto install.bat (macOS/Linux: ./install.sh /path/to/Game).
  2. Run serve.bat (or node mv-ai-bridge.cjs serve).
  3. Start the game, then point your MCP client at http://127.0.0.1:7321/mcp with the bearer token from ~/.mv-ai-bridge/token.

From source instead: git clone, npm install, npm run build, then node dist/cli/index.js install "<game>".

Status

Map movement, pathfinding, dialogue, choices, menus, shops and the event log are play-tested on two MV 1.6.1 titles.
The battle tools are protocol-tested only — a live battle is still pending.