Vision
What a Token can see, and what it carries to see by.
Vision has three independent parts. enabled decides whether the token sees at all — a
token without it contributes nothing to what the players are shown. light is a light source
the token carries, illuminating the map for everyone. dark is darkvision: the ability to
see without light, which reveals the map to this token alone.
The distinction matters on a dark map — a dwarf with darkvision sees the corridor, but the human beside them sees only as far as their own torch reaches.
- SeeAlso:
Token,Light,Map/lineOfSight
| Property | Type | Required | Description |
|---|---|---|---|
id |
string |
Yes | The unique identifier for this vision configuration. A UUID string generated when the object is created. Embedded objects have no primary key, so this is indexed instead. |
enabled |
boolean |
Yes | Whether the token sees at all. With this off the token is blind for line-of-sight purposes and reveals nothing. |
light |
boolean |
Yes | Whether the token carries a light source. SeeAlso: Light |
lightRadiusMin |
number |
Yes | The radius of bright light the token emits, in grid units. |
lightRadiusMax |
number |
Yes | The radius of dim light the token emits, in grid units. |
lightColor |
string |
Yes | The color of the light the token emits, as an RGB string. Examples: "#ffffff" |
lightOpacity |
number |
Yes | How strongly the emitted light tints the map, from 0 to 1. |
dark |
boolean |
Yes | Whether the token can see without light. Darkvision reveals the map to this token only, rather than illuminating it for everyone. |
darkRadiusMin |
number |
Yes | The inner radius of darkvision, in grid units. |
darkRadiusMax |
number |
Yes | The outer radius of darkvision, in grid units. Examples: 60 — the usual darkvision range in feet |
sight |
any |
Yes |