Pending changes:

What is this?

BattleScry is a free interactive battlemap tool for D&D, designed to work seamlessly with Discord, Avrae, and OTFBM.

How do I use it?

In Discord, run !bscry during an active combat. Click the link generated to load the current map into BattleScry. Edit tokens, map settings, overlays and other objects as much as you like, and click Export Updated Map when finished.

Paste the command back into Discord, and your map will be updated with all your changes! If someone else updated the map in Discord while you were editing, don't worry... BattleScry will apply a smart merge of all changes and flag any conflicts. The most recent changes to the Avrae map will take precedence.

How do I learn more?

Click the ? Help button in the top right for more detailed instructions. Visit avrae.io to learn more about the D&D bot for Discord, and visit otfbm.io for more information about the awesome On The Fly Battle Maps tool.

This is cool! How can I support you?

This tool is offered free to the D&D community to make it easier for players and DMs to play this game we all love. If you want to throw me a few gold pieces, feel free to buy me a healing potion and enjoy your free Heroic Inspiration for doing a kind deed. 💖

If you want to help me improve BattleScry, check out the open source code on GitHub.

Credits

Default monster token art is from game-icons.net, used under the CC BY 3.0 license, by Lorc, Delapouite, Skoll, Cathelineau, Caro Asercion, Carl Olsen, and Faithtoken. Icons were exported to PNG for use as tokens. See the full per-icon credits for details.

Made with care for the D&D community. Check out the Avalor server on Discord!

Getting Started

1. Run !bscry in Discord during combat

2. Click the 🗺️ Click here to open current map in BattleScry link in the response to auto-load your map

3. Make your changes - move tokens, draw walls, edit overlays

4. Click the glowing Export Updated Map button in the top toolbar and paste it back in Discord

Map Navigation

• Drag tokens to move them on the grid

• Scroll wheel to zoom in/out

• Hold Space + drag to pan around the map

• Ctrl+Z to undo, Ctrl+Shift+Z to redo

• Ctrl+Click (Cmd on Mac) to multi-select any objects - tokens, overlays, walls, FOW regions

• Delete key to remove selected walls, overlays, or FOW regions

Tokens Tab

• Click a token on the map or in the list to select and edit properties

• Customize Token Image - browse 334 SRD monsters, enter shortcodes, or upload custom images

• Upload images directly - hosted permanently on imgbb.com

• Three crop previews: Default, Zoomed (1.7×), and Face AI (AWS Rekognition)

• Click a non-default crop → Use this crop re-uploads it as the token's default

• Save tokens by name for reuse across sessions

Overlays Tab

• Add New Overlay - choose type (circle, cone, line, arrow, square), size, and color

• Attach to (-t) makes overlays persist on a combatant

• {targ} makes origin follow the attached token dynamically

• Aim at (-aim) makes end follow another token

• Drag overlay handles on the map to reposition

• Click coordinates fields then click the map for precise placement

Map Tab

• Background image - paste a URL or Upload Image directly

• Grid size, cell size, dark mode, grid color, and transparency controls

• Fog of War - click Add New Revealed Region then drag-select grid cells

• Save / Load Battlemap (background + grid + walls + FOW + objects) and Save / Load Battle (everything plus tokens + initiative)

• Advanced - Manual Import section (collapsed) for pasting data strings directly

Structures Tab

• Walls subtab - click Add New Wall then click grid intersections to draw wall segments

• Hold Shift while clicking to chain consecutive wall segments

• Click a wall on the map to select - change type (Wall, Open/Closed/Secret/Double Door) and color

• Map Objects subtab - place icons (chests, traps, fire, stairs, columns, etc.) on the grid

• Use the 👁 toggles to hide walls or objects from the BS preview (doesn't affect the exported map)

Saved Tokens, Maps, and Battles

• Saved Tokens store token image shortcodes by name - reuse across all campaigns

• Saved Maps store background + grid + walls + FOW - load any time

• Saved Battles store the complete combat state (map + combatants + initiative)

• All three persist in your Avrae user variables across sessions

• Only names are loaded in your !bscry link - the full data is fetched on demand when you click Load

• This keeps URLs short and BattleScry fast even with dozens of saved items

• To save: type a name in the input field and click Save (queued - applies when you paste the !bscry apply command)

• To load: click Load next to a name (generates an !map -loadbattle command to paste back)

• To delete: click ✕ next to a name (queued for removal)

Round-Trip with Avrae

• All changes go through !bscry apply - one paste does everything

• Token moves, overlay changes, wall edits, and map settings in a single command

• The alias reads walls, FOW, overlays, and saved tokens/maps/battles from Avrae

• Run !bscry again anytime to refresh