Skip to content
battlemap-mcp docs
You're reading the docs for battlemap-mcp v1.2.0, an earlier release. See this page in the latest docs.

Install from Claude

Use this instead of the companion download and its Connect files, not as well. You still need the mod in Dungeondraft. From the release, download only the mod ZIP (and the .mcpb for the desktop app).

From the same release, download battlemap-mcp-<version>.mcpb and open it. Claude shows it under Settings → Extensions; approve the install. The extension gives Claude the map tools; it does not include the map-making skills.

Run /plugin marketplace add thekannen/battlemap-mcp, then /plugin install battlemap-mcp@battlemap-mcp, and restart Claude Code. The plugin brings the map tools and the map-making skills.

  1. Install the mod as in Install on Windows (or macOS, Linux), or ask your assistant to install the Dungeondraft bridge. It shows you what it will change and asks first, and if you already have a bridge it keeps a backup of the old one.

  2. Fully quit and reopen Dungeondraft, and open a map.

  3. There is no Check connection file. Instead, start a new conversation and ask:

    Check the Dungeondraft connection and tell me the open map’s dimensions. Don’t change anything yet.

Your assistant tells you when a new version is out. Update the plugin with /plugin, or download and open the new .mcpb, then ask your assistant to install the bridge again and restart Dungeondraft. See Update, move or remove.