Skip to content

Settings Reference

Every system setting, what it does, and who it affects. Open them in Foundry under Game Settings → Configure Settings → Nimble. For suggested combinations, see Settings.

General

SettingWhat it doesDefaultWho it affects
Auto-Expand RollsWhen enabled, dice roll details are shown inline below each roll in chat messages, without needing to hover.OffEach player individually
Hide Rolls by DefaultWhen enabled, skill check and weapon roll dialogs will default to hiding the roll from other players.OffEach player individually
Auto-Add Character To Combat On Initiative RollWhen enabled, rolling initiative from a character sheet adds that character to the current scene combat before rolling, if they are not already in combat.OffWhole table (GM sets it)
Auto-Apply Conditions from RulesAutomatically apply conditions from feature rules when their trigger fires. When off, rules still surface on the chat card for manual GM application.OffWhole table (GM sets it)
Debug ModeEnables developer tools like the dice testbench. Changes take effect immediately.OffEach player individually

Token Adjacency

SettingWhat it doesDefaultWho it affects
Auto-Track Token AdjacencyWhen enabled, the system automatically tracks the adjacency status of combatants.OffWhole table (GM sets it)
Adjacency Includes DiagonalsWhen enabled, tokens that share only a corner are considered adjacent (diagonal adjacency). When disabled, only tokens sharing a full edge are adjacent (orthogonal only).OnWhole table (GM sets it)

Combat Tracker

Some of these settings are managed from their own dialog rather than the Foundry settings window.

SettingWhat it doesDefaultWho it affects
Combat Tracker Monster Card VisibilityAllow players to view individual monster and minion cards when the GM expands themOffWhole table (GM sets it)
Combat Tracker Resource Drawer HoverWhen enabled, player resource drawers open only on hoverOnEach player individually
Combat Tracker Player HP Bar Center TextChoose whether player HP bars show nothing, health state, or HP percentageNoneEach player individually
Combat Tracker Non-Player HP BarShow a hit point bar below individual non-player combatant cardsOffWhole table (GM sets it)
Combat Tracker Non-Player HP Bar Center TextChoose whether centered text in the non-player HP bar shows nothing, health state, or HP percentageNoneWhole table (GM sets it)
Enable Combat TrackerShow the Combat Tracker at the top of the screenOnEach player individually
Combat Tracker Width LevelControls how wide Combat Tracker can be in the top tracker5Each player individually
Combat Tracker Card Size LevelControls how large Combat Tracker combatant cards appear5Each player individually
Combat Tracker Action ColorChoose your personal action color for Combat Tracker#ffffffEach player individually
Combat Tracker Reaction ColorChoose your personal reaction color for Combat Tracker#4fc3f7Each player individually
Combat Tracker Hover ColorChoose your personal token hover highlight color#33bc4eEach player individually
Combat Tracker Left-to-Right OrderingDisplay combatants in fixed left-to-right order instead of centering the active combatantOffWhole table (GM sets it)
Combat Tracker Current Turn Color (Legacy)Legacy current turn color setting used before per-animation colors#FFFFFFWhole table (GM sets it)
Combat Tracker Current Turn Pulse AnimationEnable pulse animation for the active combatant cardOnWhole table (GM sets it)
Combat Tracker Current Turn Pulse SpeedAdjust pulse animation speed for the active combatant card50Whole table (GM sets it)
Combat Tracker Current Turn Border GlowEnable border glow for the active combatant cardOnWhole table (GM sets it)
Combat Tracker Border Glow ColorColor used by the border glow for the active combatant card#FFFFFFWhole table (GM sets it)
Combat Tracker Border Glow SizeAdjust the glow size for the active combatant card border50Whole table (GM sets it)
Combat Tracker Current Turn Edge CrawlerEnable edge crawler effect for the active combatant cardOnWhole table (GM sets it)
Combat Tracker Edge Crawler ColorColor used by the edge crawler for the active combatant card#FFFFFFWhole table (GM sets it)
Combat Tracker Edge Crawler SizeAdjust capsule size for the active combatant edge crawler effect50Whole table (GM sets it)

Nimble Character Widget

Some of these settings are managed from their own dialog rather than the Foundry settings window.

SettingWhat it doesDefaultWho it affects
NCSW Sidebar View ModePersists whether the NCSW or the combat tracker is currently shown.ncsEach player individually
Enable Combat SystemShow the Combat System panel during combat. Helps GMs quickly target heroes and roll attacks for minions, monsters, and legendary monsters.OnEach player individually

Released under the MIT License.