Token Locking - GM-Approved Player Movement

Token Locking - GM-Approved Player Movement

Token Locking is a feature that allows the GM to lock tokens in place and force all movement to be displayed as planned pathways. The GM can then approve or reject movement on a per token basis, or all movement simultaneously. Once enabled on a map, any attempted movement by players will need to be confirmed by the GM. GMs can continue to move NPC or Player tokens without token locking, or they can use the same feature by holding [ALT] when they start their move.

Enable Token Locking for a Map

Starting with a campaign map, unlock the map to expose the Image Data Control panel. Once there, verify that you are on the Play tab, and Default Play sub-section. The Play tab is denoted by the d20 icon. Below that, the finger icon denotes the Default Play sub-section.

image-20250424-205540.png
0qyydQjCkX-20250424-204920.gif

 

Snap To Grid

Optionally, you can also turn on Snap to Grid. This will snap all movement to edges, corners or mid-points of grids for all planned movement unless you are holding down CTRL.

GM Movement

GM movement won’t appear to change if you use arrow keys for movement or drag tokens around. This is because GM’s are not restricted by token locking by default. To restrict movement for the GM, just like it is for players, hold down [ALT] when performing your move.

  • [ALT] + arrow keys

  • [ALT] + drag (release after starting the drag if you also have Snap To Grid enabled)

Here is planned movement for the "Bill” token. Release the mouse to make a waypoint and drag again from the waypoint to start a new movement segment.

vk3SyjCYSK-20250424-210515.gif
CnZ2CWxcEr-20250424-210626.gif

Moving Waypoints

  • Waypoints can be dragged to update the overall movement distance.

    FantasyGrounds_VPR2VeoopU-20250424-214726.gif
  • Waypoints can be dragged over top of another waypoint to collapse them into a single waypoint.

    xRZ50pWjlc-20250424-215812.gif
  • Arrow key movement will create a new waypoint every time you change direction.

    ppGypQQOac-20250424-215910.gif
  • If you want to adjust the placement of the endpoint without creating more waypoints or having to cancel the entire movement, hold down [ALT] while dragging the token.

    FantasyGrounds_8TbFhmlsbM-20250424-220758.gif

Moving Several Tokens At Once

By clicking on the Selection Mode button at the top of the map, the GM can select all tokens simultaneously within a selected area by dragging the Selection Tool box over them, then holding down [ALT] to show the movement and waypoints.

mlI5xNjIbq-20250424-221535.gif

Movement Approval or Cancellation

image-20250424-211333.png

The GM can click on the green checkmark to approve movement, either above the token’s movement endpoint on the map, or on the icon in the Token Movement Approval Panel on the right of the map window.

Conversely, the GM can also cancel movement for one or many tokens the same way by clicking on the red X above the individual icons on the map, or in the Token Movement Approval Panel on the right.

Accept All or Cancel All

The Accept All and Cancel All icons at the top of the Token Movement Approval Panel allows the GM to either grant all movement, which will cause all tokens with movement queued to move to their final destinations simultaneously.

FantasyGrounds_TtcbJAvcWp-20250424-211833.gif

Undoing Movement

If the GM accidentally approves movement, whether individually or via Accept All in the Token Movement Approval Panel, [CTRL]-Z can be used to undo the movement. The GM will want to do this as soon as possible after the movement as possible so other actions aren’t taken between the approval and undoing it.

Player Movement

Players can show planned movement for any token they own. The movement path shown will begin with their player color. GM’s can see this and approve or cancel the movement.

  • Players can move into any area they have previously revealed.

  • Players can propose movement into areas they have not previously revealed. GM’s can approve this movement or edit it. If approved, the player will move as far as they can until they hit a wall or other obstruction (if using a map with Line of Sight defined).

  • [SHIFT] + arrow key rotates the selected token in the direction of the arrow

In the screenshot below, Bill would like to move behind the tent, even though Bill cannot see what is there yet. Since the GM can see what is behind the tent on their map, and if they have placed a creature or obstruction there, they can decline to allow the movement. Otherwise, the movement can be approved.

image-20250424-213750.png

The Moving Waypoints section above also applies to Player Movement, not just GM Movement.

Movement Cancellation

Players have the option to cancel their proposed movement, either via the red X next to their token’s movement endpoint, or via the Token Movement Approval Panel on the upper-right side of the map.

Calculating Diagonal Movement Distance

You may notice that total movement distance is calculated differently from ruleset to ruleset. The D&D 5E ruleset has a Standard movement setting that counts every diagonal square as five feet (5') of movement. This can be adjusted in the Campaign Options to use either Variant to show 5' followed by 10' for the 2nd diagonal movement (i.e. 5, 15, 20, 30) or Raw movement which shows decimal points and a true distance traveled.

Video

Token movement was revamped and improved considerably in Fantasy Grounds VTT v4.7.0. Below is a short video demonstrating how the updated token movement system look and functions, as well as a couple other UI improvements.