Mounts and Vehicles

The Configure dialog

Open Configure Settings → Travel Pace → Configure Mounts & Vehicles. The dialog is GM-only (the menu is registered with restricted: true).

The dialog scans for candidates in three places:

Section	Source	Filter
Mounts (World)	game.actors	type is npc
Vehicles (World)	game.actors	type is vehicle
Vehicles (Compendiums)	every Actor-typed compendium	entry type is vehicle

World NPCs and vehicles are listed by name with their portrait. Compendium vehicles are suffixed with the compendium title in parentheses so duplicates across packs are distinguishable.

Check the actors you want available in the calculator and click Save Configuration. Selections are stored in the hidden enabledMounts world setting as an { id: true|false } map. Compendium vehicles are stored by UUID; world actors are stored by id.

If there are no candidate actors at all — no world NPCs, no world vehicles, and no compendium vehicles — a warning is shown. Because compendium vehicles are included in the same actors array that gates the warning, their presence suppresses it.

The calculator dropdown

Once at least one actor is enabled, the calculator dialog shows a Transportation Method select with “On foot” first, then every enabled actor by name. Disabled actors drop out of the dropdown on the next dialog open.

Selecting a mount does three things:

1. Updates the Travel Pace label to show that mount’s adjusted speed for the selected pace.
2. Feeds the calculation: the resulting time or distance uses the mount’s speed instead of the on-foot baseline.
3. Adds a mount line to the chat card when Send to Chat is pressed.

How walking actors are handled

For actors whose type is npc (or vehicles whose movement is in ft or m), the calculator reads actor.system.attributes.movement.walk and applies a || 30 fallback when the value is missing or zero. It then divides by 30 to produce a pace modifier ratio. A horse with 60 ft walking speed runs at 2.0× the on-foot baseline.

The pace label shows the per-minute speed adjusted by both the mount ratio and the pace multiplier:

• 60 ft walk, Normal pace, imperial: 60 ft/min (60 × 1.0)
• 60 ft walk, Fast pace, imperial: 80 ft/min (60 × 1.33, rounded)

When walk is zero or absent, the label shows 30 ft/min (or the metric equivalent), derived from the || 30 fallback. The static default speed strings (300 ft/min / 100 m/min) only appear when no mount is selected at all.

How vehicles are handled

For actors whose type is vehicle AND whose movement unit is mi or km, the calculator reads the largest numeric value in actor.system.attributes.movement (ignoring the units key itself) and treats that as the vehicle’s hourly speed. A sailing ship with movement: { walk: 4, fly: 0, units: 'mi' } runs at 4 mi/hour.

Vehicle speeds use a different math path than walking actors:

• Pace label shows mi/hour or km/hour (not the per-minute form).
• The calculation multiplies the hourly speed by the pace multiplier and applies it directly to the input time or distance.
• The chat card shows Traveling on: @UUID[...] (<adjusted speed>).

A vehicle whose movement unit is ft or m is treated as a walking actor (the same walk field path), so a flying mount whose speed is in feet still feeds the per-minute path.

Cross-unit handling

The world’s Use Metric System setting and the vehicle’s own movement unit can disagree. The calculator converts:

World unit	Vehicle unit	Conversion
Imperial	mi	none
Imperial	km	km → mi
Metric	km	none
Metric	mi	mi → km

Walking actors are stored in ft on D&D 5e, so the world’s metric setting drives the conversion (ft → m).

Hidden enabledMounts setting

The list of enabled actors lives in the world setting enabledMounts, registered as a hidden Object. It is not editable from the settings panel directly. Only the Configure dialog writes to it.

To clear all mount selections, open the Configure dialog, uncheck everything, and save.