Repository navigation
Releases: K-ame/rpgmaker-mv-ai-bridge
Release list
v0.1.1 — token required on /game, safer checkpoints
Security fix and a stricter checkpoint.
What changed
/gamenow requires the token. Any page the user visits can open a WebSocket to127.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-runinstall.- Plugin
Tokenparameter. 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. checkpointsave 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
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 pluginmv-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 inplugins.jsserve.bat— start the bridgeQUICKSTART.txt,README.md,LICENSE
Quick start
- Drag your game folder onto
install.bat(macOS/Linux:./install.sh /path/to/Game). - Run
serve.bat(ornode mv-ai-bridge.cjs serve). - Start the game, then point your MCP client at
http://127.0.0.1:7321/mcpwith 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.