Field interaction is the system that connects the Foundry VTT canvas (tokens, tiles, regions) to VN interactions. Players trigger interactions by approaching NPCs, clicking tiles, or entering map regions.
There are four ways to start an interaction from the canvas:
When an NPC token has a linked interaction journal (set via Portrait Config or Token HUD), players can interact with it by pressing F while their token is nearby.
The system finds the nearest NPC token or tile within the configured range and shows a prompt bubble above it. Press F again to dismiss the bubble.
The interaction range is set in Module Settings under "NPC Interaction Range" (default: 2 grid squares, 0 = unlimited).
Right-click an NPC token to open the Token HUD. Two VN-related buttons appear on the left column:
| Button | Icon | Description |
|---|---|---|
| Set Interaction | Book icon | Opens a dialog to link a journal entry and set the interaction mode for this specific token |
| Start Interaction | Speech bubble icon | Immediately starts the linked interaction (only appears if a journal is linked) |
The "Set Interaction" dialog shows:
Token-level journal links override the actor-level link set in Portrait Config. Select "Use Actor Default" to fall back to the actor's configured journal.
Tiles can also trigger interactions. Right-click a tile to open the Tile HUD. Two buttons appear:
| Button | Icon | Description |
|---|---|---|
| Toggle Background Tile | Panorama icon | Marks this tile as a VN background tile |
| Set Interaction | Book icon | Links a journal entry to this tile |
| Start Interaction | Magnifying glass icon | Starts the linked interaction (only appears if a journal is linked) |
Tile interactions work the same way as token interactions. The F keybind also detects nearby interactive tiles.