Getting Started
1. Run !bscry in Discord during combat
2. Click the BattleScry link — or paste the data string here and click Load
3. Make your changes — move tokens, draw walls, edit overlays
4. Copy the command at the bottom 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 1400+ 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 — Options
• Background image — paste a URL or Upload Image directly
• Grid size, cell size, dark mode, grid color, and transparency controls
• Import string at the bottom — paste and Load data strings here too
• Update with Current State keeps your !bscry link current after edits
Map Tab — Walls & Doors
• Add New Wall — click grid intersections to draw wall segments
• Hold Shift while clicking to chain consecutive segments
• Click a wall on the map to select — change type (Wall, Open/Closed/Secret/Double Door) and color
• Escape or click outside the map to stop drawing
• Wall colors and door types export correctly to OTFBM
Map Tab — Fog of War
• Add New Fog of War Area — click two grid cells to define a revealed rectangle
• Fog covers the entire map; regions create transparent holes for players
• Adjust fog transparency with the slider
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