How fog of war works
This page walks through what actually happens when a token moves on a fogged scene, what role walls play, and how the edge of a reveal is shaped.
The reveal flow
Section titled “The reveal flow”When a token moves on a scene with fog of war:
- The engine computes the token’s visibility polygon — the shape of the area it can see, which is a circle (or cone) clipped by any walls in the way.
- That polygon is stamped into the fog texture, erasing fog inside it.
- The newly-revealed area stays revealed, even after the token moves away.
So as a token walks down a corridor, the fog peels back wherever it can see — not just where it currently is.
Walls clip the reveal
Section titled “Walls clip the reveal”If there’s a wall between the token and what it would otherwise see, the wall stops the reveal. The wall casts a shadow into the fog and the area beyond stays black.
This is what creates the “exploring a dungeon” feel — the player can see into the room they enter, but not through the wall to the room beyond.
The polygon is computed live: every frame the engine runs ray-casts from the token’s position out to its vision range, and any wall they hit truncates the ray. The resulting closed polygon is the shape that gets revealed.
Soft vs hard reveal edges
Section titled “Soft vs hard reveal edges”The shape of the revealed area’s edge depends on the token’s Edge softness setting (Vision section of the token’s Settings dialog):
- Edge softness 1 (default) — soft radial fade at the edge. The reveal looks natural, with fog gradually returning at the rim.
- Edge softness 0 — hard cut at the edge. The reveal is a crisp boundary, like a paper cut-out.
- Intermediate — partial fade band near the rim.
Use a hard edge when you want the boundary to feel definite (an arcane sphere of vision). Use soft for naturalistic exploration.
The same edge softness drives light-driven fog reveals — see Light-driven reveal.
The fog tool — manual paint, erase, reveal-all
Section titled “The fog tool — manual paint, erase, reveal-all”Sometimes you want to reveal or hide fog by hand as the GM. The fog key on the dock (shortcut F) has a face for each table:
| At the table | The key | What its panel does |
|---|---|---|
| Build | Fog of War | A Brush switch — Pan, Paint (put fog back) or Erase (clear it) — and a Brush size; Show fog layer hides the fog on your screen while you set up (players are unaffected); with a space selected, Reveal space or Fog space. Reveal all and Reset fog sit at the foot. |
| Play | Reveal | The brush only reveals: pick a size and drag over the map. Reveal all and Hide all sit at the foot. |
In a scene with levels the panel works on the level you’re seeing from, with Reveal this level beside the whole-map buttons (which then read Reveal every level).
These overlap with movement-driven reveal — manually revealing a room before the players arrive lets you skip the “exploration” beat for areas that don’t need it.
Persistence
Section titled “Persistence”Fog state saves with the scene. Closing and reopening the scene restores the explored areas. If you want to “reset” exploration:
- Open the fog tool.
- Press Reset fog (Hide all at the Play table), or use the slash command for full re-fog.
Or pick Paint and brush fog back over only certain rooms.
Multiplayer / players seeing fog
Section titled “Multiplayer / players seeing fog”By default every player sees the shared scene fog: when one player’s token reveals an area, every player sees it as revealed. To give each player their own exploration instead, turn on per-player fog.
The GM sees the map through the fog. Places nobody has explored are dimmed rather than black, so you can still read the map and prepare ahead of the party; with per-player fog, the places no token can see right now are dimmer again. Players see unexplored places as black. To check exactly what a player sees, use View as.
Related
Section titled “Related”- Light-driven reveal — make a scene light contribute to fog reveal even without a token.
- Fog memory — keep explored-but-unlit areas dimly visible.
- Detection modes — which token senses bypass walls (and reveal through them).