Settings

A few client-scoped settings live under Configure Settings → Bondsmith. Everything else lives in the in-app Bondsmith Settings window, opened from the settings menu button or the GM-only configuration panel. The in-app window groups settings under Display, Gameplay, Tiers & Scales, Advanced, and Data tabs.

Configure Settings

These appear in Foundry’s core Configure Settings list. All are client-scoped and apply only to the machine that sets them.

Setting	Default	Description
Canvas Badge Scale	1.0	Multiplier for the canvas reputation badge size. Range 0.5 to 2.0.
Color-Blind Friendly Palette	Off	Use a high-contrast palette for tiers and graphs.
Show Reputation Toasts	On	Pop a brief on-screen toast when reputation changes.
Manage Dragged Journals	Ask each time	What happens when you drop a journal entry onto a Bondsmith entity. Options: Ask each time, Always move, Never move.

The same list also holds three menu buttons: Open Bondsmith, Open Graph Dashboard, and Open Bondsmith Settings.

Display

World-scoped unless noted. Found on the Display tab of the in-app window.

Setting	Default	Description
Theme	Parchment	Color preset for Bondsmith windows and widgets. Options: Parchment, Dark Parchment, Stone, Velvet, Sync with Calendaria.
Color-Blind Palette	Off	Use an alternative orange, blue, and teal palette for badges and lines. Client-scoped.
Show Token Badges	On	Show a reputation tier badge on tracked actors’ tokens.
Badge Position	Top-right	Which corner of the token the badge anchors to. Options: top-left, top, top-right, bottom-left, bottom, bottom-right.
Hide Numbers from Players	Off	Players see only the tier name on rep bars and relation rows. GMs always see both.
Badge Visibility	Always	When badges show. Options: Always, On Hover, On Select.
Badge Perspective on Token Select	Off	Selecting a token switches every other badge to show how the selected actor views that token.
Badge Scale	1	Multiplier applied to badge size on this client only. Range 0.25 to 4. Client-scoped.
Line Style	Solid	Stroke style for relationship lines when a token is selected. Options: Solid, Dashed, Dotted.
Default Shape Fill Opacity	0.3	Fill opacity used for newly drawn shapes on map graphs. Range 0 to 1.
Default Shape Stroke Color	#000000	Stroke color used for newly drawn shapes on map graphs.

Gameplay

World-scoped. Found on the Gameplay tab.

Setting	Default	Description
Chat Notifications	None	Who sees chat messages when reputation or relations change. Options: None, GM Only, All Players. Hidden relations are always suppressed.
Enable Reputation Decay	Off	Reputation walks toward neutral on the configured period.
Decay Rate	-1	Amount to step rep toward 0 per period. Shown only when decay is enabled.
Decay Period	Monthly	How often the decay tick fires. Options: Daily, Weekly, Monthly. Shown only when decay is enabled.
Default Starting Value	Neutral	Initial reputation assigned to newly created factions and tracked actors. Options: Neutral, Minimum, Preset Default.
Per-Player Faction Rep by Default	Off	Newly created factions default to per-player reputation mode rather than global.
Context Note Prompt	Off	When to prompt for a free-text note after a change. Options: Off, Always, Threshold.
Context Note Threshold	5	Minimum absolute delta required to trigger the prompt in Threshold mode.
Changelog Sort Order	Newest First	Order of entries in actor and faction changelogs. Options: Newest First, Oldest First.
Auto-track New Actors of Types	None selected	Actors of a checked type get added to the tracked list when created or imported. Group actors are skipped. GM-only.

Tiers & Scales

World-scoped. Found on the Tiers & Scales tab.

Setting	Default	Description
Reputation Range (Min)	-100	Minimum reputation value. All sliders and clamps use this bound.
Reputation Range (Max)	100	Maximum reputation value. Factions with an applied preset override these bounds locally.

The same tab edits tier presets. Global Defaults applies to every entity unless a faction picks a custom scale. Custom scales are reusable templates you assign per faction.

Advanced

World-scoped, GM-only. Found on the Advanced tab.

Setting	Default	Description
Follow System Primary Party	Off	Active party follows the system’s primary party actor. Needs a faction linked to that actor.
Use Calendaria Time on Timeline	On	Changelog timeline shows Calendaria in-world dates instead of real-world timestamps. Shown only when Calendaria is active.
Group Actor Drops	Prompt	What happens when a group-type actor is dropped onto Bondsmith. Options: Prompt, Skip.
Default Zoom	1	Initial zoom level for new map graphs. Range 0.1 to 10.
Default Grid	Square	Grid type overlaid on new map graphs. Options: Square, Hex, None.
Graph Link Label Defaults	Inherit	Default visibility for link labels in graphs, by link type. Per-graph and per-link overrides take priority.

The Advanced tab also holds the automation rule editor.

Data

The Data tab exports all Bondsmith data as a JSON backup, imports from a previous export, and scans compendiums for untracked actors. Its Danger Zone resets selected subsystems to factory defaults and cannot be undone. It registers no persistent settings.

Keybindings

Configured under Configure Controls.

Action	Default	Description
Toggle Token Badges	Shift+B	Show or hide reputation badges on all tokens.
Open Reputation Dialog	R	Open the reputation slider for the selected token.
Increase Reputation (+10)	=	Increase the selected token’s reputation by 10. GM-only.
Decrease Reputation (-10)	-	Decrease the selected token’s reputation by 10. GM-only.
Cycle Badge Position	Ctrl+B	Cycle the badge position around the token.
Undo	Ctrl+Z	Undo the last reputation data change. GM-only.