The Calculator
Opening the dialog
Section titled “Opening the dialog”Click the Travel Pace tool in the token scene controls. The dialog opens as a small floating window positioned near the top-left of the canvas. Closing and reopening it preserves no state; every open starts from defaults.
Clicking the tool while the dialog is already open re-focuses the existing window. There is never more than one calculator instance.
Layout
Section titled “Layout”The dialog has five regions, top to bottom:
- Calculation Mode: radio toggle between Distance → Time and Time → Distance. Distance is the default.
- Inputs: the visible input fields change with the selected mode.
- Travel Pace: a select with Normal, Fast, Slow. Normal is the first option and is selected by default. The label appended to “Travel Pace” updates live to show the resulting speed for the chosen pace and mount.
- Transportation Method: a select that appears only if at least one mount or vehicle has been enabled in Mounts and Vehicles. “On foot” is always the first option.
- Calculation Preview: a live-updating line that shows the result as you type. Empty until valid inputs exist.
At the bottom, a Send to Chat button posts the current calculation as a chat message.
Distance → Time mode
Section titled “Distance → Time mode”A single input: Distance (in the world’s configured unit, mi or km).
As you type, the preview updates with the formatted travel time. Time is reported in the largest sensible breakdown: minutes for short trips, then hours, days, weeks, months, and years for longer ones. A unit becomes plural by appending s (defined in TravelPace.Units.Plural.Suffix).
A 30-mile journey at Normal pace on foot produces “1 day, 2 hours”; a 5-mile journey produces “1 hour, 40 minutes”; a 1,000-mile journey produces “1 month, 1 week, 6 days, 5 hours, 20 minutes” (rounded to whole minutes; minutes round up to the next hour at 59.5).
Time → Distance mode
Section titled “Time → Distance mode”Two inputs: Days and Hours (no minutes input in this mode).
The preview shows distance in the world’s configured unit, to one decimal place. The calculation treats one travel day as 8 hours.
Pace label
Section titled “Pace label”The label above the pace select reads Travel Pace (<speed> is one of:
- A per-minute default like
300 ft/minor100 m/minwhen no mount is selected. - The mount or vehicle’s adjusted speed when a mount is selected. Walking actors render in ft/min or m/min; vehicles whose movement is in mi or km render in mi/hour or km/hour.
The label changes when you change the pace or the mount. See Paces and Speeds for the per-pace numbers and Mounts and Vehicles for how mount speeds are derived.
Send to Chat
Section titled “Send to Chat”Pressing Send to Chat posts a chat card to the table.
The card has these sections:
| Section | Content |
|---|---|
| Title | ”Travel Pace Calculation” |
| Mount line (optional) | When a mount is selected and the actor resolves, shows an @UUID embed of the mount with its adjusted speed in parentheses. Shows Traveling on (<percent>% of normal speed) only when a mountId is set but the actor cannot be resolved at message-creation time. Omitted when no mount is selected or the resolved actor runs at exactly 100% of the on-foot baseline. |
| Pace line | The pace name followed by “pace” (for example, “Fast pace”). |
| Result line | Distance → Time mode shows Distance: and Travel Time: |
| Pace effects (optional) | The SRD rules text for the selected pace. Controlled by the Show Pace Effects in Chat setting. See Settings. |
The chat card is plain HTML and respects the speaker resolution Foundry’s ChatMessage.getSpeaker() returns at submit time. Players who post calculations show as the player; GMs show as the GM.
Reset behaviour
Section titled “Reset behaviour”Closing the dialog clears nothing on the server side. The next open starts from defaults: Distance → Time mode, Normal pace, On foot, empty inputs. There is no “remember last” state.