An AI collaborator for your Dungeondraft maps: a local bridge that lets your AI assistant (Claude Desktop, Claude Code, Codex, OpenCode, or any other MCP client) build, inspect, and refine the map you have open, using assets you already own.
Documentation: knownframe.com/battlemap-mcp/docs · Setup video: install it in five minutes (YouTube)
Sped up 11×; the full build took about five minutes. Watch the narrated build (YouTube).
This is a local automation layer for your own Dungeondraft map-making session. It does not generate original assets or art for you; it drives what you already own in Dungeondraft. Please buy and support Dungeondraft, and support the artists whose asset packs you use.
battlemap-mcp notices these Dungeondraft mods when they are loaded and works with them. Without them, nothing changes.
| Mod | What your assistant does with it |
|---|---|
| Unofficial Patch by Moulk | Resizes maps up to 200 tiles a side and uses the Above Lights layer. Keeps your Free Transform shapes and groups when it moves or copies objects, and leaves the patch's extra terrain slots alone. |
| Custom Snap Mod by Lievven | Reads your square, hex or custom grid and, when you ask, places things on it, as your cursor would. It never changes your snap settings. |
| Soft Shadows by Moulk | Adds, adjusts and removes soft shadows on objects, walls and paths, and keeps your own shadows when it moves, edits, deletes, undoes or copies them. Roof and pattern shadows are left as you set them. |
| Sketch Tool by Moulk | Keeps your sketch notes out of the map images it exports, as Dungeondraft's own Export does. |
Some steps depend on a mod's version, and run only on the versions they were checked against. Details: Using other mods.
Build a whole map from a brief, plan an encounter together, furnish one room, export to or rebuild from a Universal VTT file, or hand off tedious placement. See example prompts.
You need Dungeondraft 1.2.0.1 and an AI app that can run local MCP servers, on the same computer. Follow Get started, then the Windows, macOS or Linux guide. Downloads are on the Releases page. Prefer to watch? The setup video installs everything with the Claude desktop app, start to finish.
Use the Claude desktop extension or the Claude Code plugin: see Install from Claude.
See Platform limits.
See Troubleshooting.
- Example prompts
- Tool reference: every tool, generated from the server
- Technical reference · Known limitations
- Privacy · Legal and attribution
For contributors: Bridge protocol, Developer installation, Building releases, Contributing, Changelog.
battlemap-mcp is an independent, unofficial project and is not sponsored, operated, or endorsed by Megasploot or Tailwind Games, LLC. It does not include or redistribute Dungeondraft software, maps, or art assets. See Legal and attribution.