Battle Maps, Tokens & AoE Shapes

Uploading Battle Maps

Upload a battle map image when launching combat. The map renders on an interactive canvas with pan/zoom controls and grid alignment.

Draggable Tokens & Condition Rings

• Token Markers — Blue (PCs), Red (Monsters), Green (NPCs).
• HP Indicator Rings — Green (above 50%), Yellow (25-50%), Red (under 25%), Faded (0 HP/unconscious).
• Interactive Dragging — DMs can drag any token; players can drag their own character token (marked with a gold border). Position updates sync live to all connected screens.

Tactical AoE Shape Templates

DMs can place persistent spell/hazard overlays on the map:

• Circle (e.g., Fireball, Moonbeam) — Set radius in feet and click center point.
• Cone (e.g., Burning Hands, Cone of Cold) — Set length, origin point, and direction.
• Line (e.g., Lightning Bolt, Wall of Fire) — Set width, start point, and end point.
• Cube (e.g., Thunderwave, Spirit Guardians) — Set size, center point, and rotation handle.

All placed AoE shapes include interactive drag handles, customize colors, persist to the database (combats.aoe_shapes), and broadcast instantly to players via WebSockets.

Real-Time Sync

Everything on the battle map is synchronized in real time via WebSockets:

• Token positions update instantly for all connected users
• AoE shapes appear on player screens as soon as the DM places them
• No manual refresh required