Repository navigation
Player View Setup
The Player View is the player-facing window used on a TV, monitor, or projector. It shows a filtered version of the active scene so players see the map, visible tokens, fog of war, effects, drawings, templates, dice results, turn indicators, pings, and laser pointer activity that the GM chooses to share.
The GM View remains private and contains the controls, layer lists, hidden content, and preparation tools.
[insert image]
The Player View shows the player-safe version of a scene.
Depending on the scene and visibility settings, players may see:
- The active map.
- The grid, if visible to players.
- Revealed areas of fog of war.
- Player-visible tokens.
- Player-visible drawings and templates.
- Weather and animated effects.
- Table pings and laser pointer trails.
- Dice results, if dice display settings allow them.
- Turn order indicators, if enabled.
The Player View does not show GM-only controls, private layer lists, hidden tokens, hidden fog tools, or GM-only preparation content.
To open the Player View:
- Open a campaign.
- Open the Player View menu.
- Choose Open Player View.
- Move the Player View window to the player-facing screen if needed.
- Use fullscreen when you are ready for players to see it.
You can open the Player View before or after choosing a scene.
[insert image]
If you use the same screen setup often, configure the preferred Player View display.
To choose a display:
- Open Player View Setup.
- Review the detected displays.
- Select the display you want players to use.
- Save the setting.
- Open or move the Player View to that display.
If the preferred display is disconnected later, Local VTT opens the Player View normally so you can drag it to the correct screen manually.
[insert image]
Fullscreen is useful when using a TV, monitor, or projector as a battle map.
To use fullscreen:
- Open the Player View.
- Move it to the player-facing display.
- Choose the fullscreen option from the Player View controls.
Local VTT preserves Player View fullscreen behavior during scene changes where possible.
If you need to adjust windows or displays during a session, exit fullscreen, move or resize the Player View, then enter fullscreen again.
Opening or editing a scene in the GM View does not always mean it is shown to players immediately.
To show a scene to players:
- Select the scene in the GM View.
- Open the Player View controls.
- Choose the option to send or show the scene to Player View.
This gives the GM control over when players see a scene.
For example, you can prepare or adjust a scene privately before revealing it on the Player View.
[insert image]
If the Player View is open but no scene is currently being shown, players see a waiting screen.
The waiting screen may appear when:
- Player View has been opened before a scene is sent.
- The shown scene was deleted.
- The shown scene is unavailable.
- The GM intentionally clears or holds the player display.
This keeps the Player View open instead of closing or exposing private GM content.
[insert image]
Local VTT includes player display modes for controlling what players see between scenes or during table moments.
Use Hold when you want to keep players from seeing scene changes while you prepare.
Use Blackout when you want the player-facing display to go dark.
These modes are useful when:
- Switching to a new scene.
- Preparing an encounter.
- Hiding a reveal until the right moment.
- Pausing visible table information during a break.
[insert image]
Player View Setup includes display scale calibration for physical table displays.
Use display scale calibration when the size of grid squares on the screen matters, such as when:
- Using minis directly on a horizontal TV.
- Matching digital grid squares to physical tokens.
- Calibrating a projector or table display.
The exact physical size depends on the display and setup, so confirm the result visually before play.
[insert image]
Player View visibility is controlled by scene content and layer settings.
Common visibility rules include:
- GM-only content stays private.
- Hidden tokens do not appear to players.
- Player-hidden drawings, templates, effects, or layers do not appear to players.
- Fog of war can hide parts of the map.
- In hidden or partially hidden fog modes, player-visible tokens only appear where reveal shapes overlap them.
- Dice results appear only when dice display settings allow Player View output.
- Turn order indicators appear only when enabled and configured.
If something does not appear in Player View, check the relevant layer and item visibility settings first.
A common session flow looks like this:
- Open the campaign.
- Open Player View.
- Move Player View to the TV, monitor, or projector.
- Enter fullscreen.
- Select the first scene privately in GM View.
- Confirm fog, tokens, and visibility settings.
- Send the scene to Player View.
- Use pings, laser pointer, dice, turn order, and token movement during play.
- Use Hold or Blackout when preparing the next reveal.
If Player View opens on the wrong display:
- Move it manually to the correct screen.
- Reopen Player View Setup.
- Confirm the preferred display.
- Save the setting again if needed.
If Player View does not show the expected scene:
- Confirm that the scene was sent to Player View.
- Check whether Hold, Blackout, or waiting screen mode is active.
- Confirm the scene still exists.
- Check item and layer visibility settings.
If tokens are missing from Player View:
- Confirm the token is player-visible.
- Check fog of war.
- Check whether the token is inside a revealed area.
- Confirm the Tokens layer is visible to players.
If dice or turn order are missing from Player View:
- Check dice display settings.
- Check turn order Player View settings.
- Confirm the relevant modal or tracker is active.