- Knownframe
- battlemap-mcp
- Docs
- v1.2.0
- Update, move or remove battlemap-mcp
Update, move or remove battlemap-mcp
Your assistant tells you when a new version is out, with direct links to the
companion for your computer, the mod ZIP and SHA256SUMS.
Update the plugin or extension
Section titled “Update the plugin or extension”Update the plugin with /plugin in Claude Code, or download the new
battlemap-mcp-<version>.mcpb and open it in the Claude desktop app. Then ask
your assistant to install the bridge again (it backs up the old one), and fully
quit and reopen Dungeondraft.
Update the companion download
Section titled “Update the companion download”- Save your map and quit Dungeondraft and the AI client.
- Download both packages from the same release.
- Move the old bridge outside all active mods folders and replace it with the new one.
- Replace the entire companion folder; do not mix a new executable with an
old
battlemap-mcp.pkgor old_internalfiles. Keeping the same permanent path means the existing registration still works. - Run the Connect file again, reopen Dungeondraft and a map, and run Check connection.
On Windows the executable is a small launcher that runs battlemap-mcp.pkg from the
same folder, so if it reports that it cannot load that file, the folder is
incomplete: extract the whole ZIP again.
Replace skills
Section titled “Replace skills”Connect preserves existing skills and lists any that differ from this version. To replace locally edited or older skills too, open a terminal in the companion folder and run:
.\battlemap-mcp.exe setup --force --client codexOn Mac or Linux use ./battlemap-mcp; for Claude Code or OpenCode use
--client claude-code or --client opencode.
Replaced skills are backed up outside the client’s active skills folder.
--force applies to skills, not an existing Claude registration.
After moving the whole companion folder, run Connect from the new
location. For Claude Code, Connect stops while an entry for the old path is
registered; remove it first with claude mcp remove --scope user battlemap (see Other AI clients).
Keep the old copy until the new connection works.
Roll back
Section titled “Roll back”Restore the mod and complete companion from the same older release, reconnect, and restart Dungeondraft. There is no background updater.
Remove
Section titled “Remove”- Quit the editor and disconnect the server: remove the
battlemapentry in your AI client’s MCP settings. - Remove the mod and companion folders you installed. For the plugin, run
/pluginand uninstall battlemap-mcp; for the desktop extension, remove it under Settings → Extensions. - Bundled
battlemap-*skills and battlemap-mcp’s runtime state can be removed separately; retain wanted captures.