Carousel Combat Tracker

A video game style combat tracker, inspired by games such as Solasta and Baldur's Gate 3. During combat, the portraits of all combatants line up at the top of the screen in turn order, so everyone can see whose turn it is and who comes next. It is the spiritual successor of Combat Carousel and works with every system.

Getting Started

Carousel

There is nothing to set up: create a combat as usual (select the tokens and toggle their combat state). The Carousel appears at the top of the screen as soon as there is a combat, and disappears when the combat ends.

• The combatant whose turn it is has the largest portrait. When the turn passes, the portraits slide along.
• The round number sits between the last combatant of this round and the first of the next one.
• Each portrait shows the initiative in the top-left corner, the tracked resource (for example hit points) as text and a bar, and the active effects.

While the Carousel is open, the scene navigation at the top is hidden to make room for it.

Combat Controls

Hover the Carousel to show the combat controls on its left and right sides (GM only). They are the same as in the regular Combat Tracker:

• Left: Roll All, Roll NPCs, Reset Initiative, Previous Turn, Previous Round.
• Right: Add Event (the globe, see Events), Start Combat, End Combat, Combat Tracker Settings (the cog), Next Turn, Next Round.

You can also change turn with the keyboard: Shift + N for the previous turn and Shift + M for the next turn. Players can use them too, but only during the turn of a combatant they own, to end their own turn.

Portraits

Portrait Tooltip

Hover a portrait to see a tooltip with the combatant's details: name, initiative, hit points, armor class, speed and the active effects. Players see the full details only for the combatants they own (or can observe); for the others they see the name, initiative and effects.

Hovering a portrait also shows its buttons at the bottom: Toggle Hidden and Toggle Defeated (GM only), and Ping, which pings the combatant's token on the scene.

• Click a portrait to select its token and move the view to it. Double-click to open the character sheet.
• Right-click a portrait (GM) for the combatant options: Set as current combatant, Update Combatant, Clear Initiative, Re-roll Initiative, Remove Combatant.
• Drag a portrait (GM) to move the combatant in the turn order: its initiative is changed to fit the new position.
• A combatant that hasn't rolled initiative shows a die on its portrait: click it to roll.
• Players see a "pass turn" arrow on their own portrait during their turn: click it to end the turn.
• Right-click an effect icon on a portrait you own to delete that effect.

Tracked Resources

Combat Tracker Settings

Choose which values the portraits show in the Combat Tracker Settings window: open it with the cog in the Carousel controls, or from the Combat Tracker tab.

• Tracked Resource: the main value, shown as text and as a bar on each portrait (green by default). Usually hit points, for example attributes.hp.value in D&D 5e.
• Tracked Resource 2: a second value, shown as a second bar (yellow by default).
• Portrait Bar: a value shown as a coloured overlay over the whole portrait, which fills the image as the value goes down. Set it to None to turn it off.

Configure Carousel at the bottom opens the module's settings.

Events

Events are "fake" combatants that take a place in the turn order, to remind you of something that happens on a given initiative: a collapsing ceiling, a lair action, a spell that ends.

1. Click the globe (Add Event) in the Carousel controls.
2. Type a Name, the initiative value and an Image.
3. Optionally, set Event Duration (Rounds): the portrait shows the rounds left as a bar, and the event is removed when they run out. Check Hidden to hide the event from players.
4. Click Add Event.

The event appears in the Carousel like any other combatant. The window also lists your recent events: click one to fill in the form with it.

Settings

The most useful settings, in Game Settings -> Configure Settings -> Carousel Combat Tracker:

• Position: Horizontal (Docked) (the default, at the top of the screen), Horizontal (Floating) or Vertical (Floating). The floating modes are a window you can move anywhere; Floating Size sets their size.
• Carousel Size: how big the portraits are, from Tiny to XXX-Large. Each user chooses their own.
• Carousel Style: Carousel - Centered (the current combatant stays in the middle and the others turn around it), Carousel - Left (the current combatant is on the left), or No Carousel (the portraits stay in initiative order and the highlight moves).
• Hide Until First Turn: enemies appear only once they have taken their first turn, so players don't know what's coming. Friendly tokens and the ones players own are always shown.
• Hide Enemy Initiative: players don't see the initiative of combatants they don't own.
• Hide Defeated: remove defeated combatants from the Carousel (they stay in the normal Combat Tracker).
• Hide Conflicting UIs: hide the scene navigation and other bars at the top of the screen while the Carousel is open. On by default.
• Display Name: who sees combatant names in the tooltip: Always, Based on Token (only if the token's name is visible) or Based on Ownership. Hidden names show as ???.

See All Settings for the full list.

System Support

Carousel Combat Tracker works with every system. For some systems it also shows extra details, such as the creature type and level in the tooltip, the default tooltip attributes, or system icons (Show System Icons). Without explicit support, some values may look odd (for example, in SWADE cards would not be shown as the initiative value).

If you wish to contribute to the system support, send a PR for the System Configuration (opens in a new tab) script.

FAQ

• Can I move the Carousel? Set Position to Horizontal (Floating) or Vertical (Floating): the Carousel becomes a window you can drag anywhere. In the default Horizontal (Docked) mode it is always at the top of the screen.
• I don't see the resource bar on the portraits, why? The bars show only when a Tracked Resource is set. Open the Combat Tracker Settings with the cog and choose one.
• Can you add explicit support for X system? I'm not knowledgeable enough about all the systems to add explicit support for them, but if you send me a PR for the System Configuration (opens in a new tab) file I'll gladly add it to the module. If you are not familiar with coding, your best bet is to ask community developers in your system channel!

Troubleshooting

Lag in the Foundry UI when the Carousel is open

The Carousel uses the actor images as portraits. If your actors use very high-resolution images, this can cause noticeable lag in the Foundry UI while the Carousel is open.

The only effective solution is to use lower-resolution images for your actors (re-upload smaller versions of them). You can confirm that this is the cause by opening the Actors tab and checking whether the lag also happens while the actor thumbnails are visible. Images around 512px are usually more than enough, since Foundry shows them small.

Glitchy animation

The Carousel animation is complex: clicking next or previous many times in quick succession can make it glitch. Even when you see this, the Carousel still works as intended and shows the correct order.

Advanced

All Settings

Appearance:

• Position, Floating Size: see Settings.
• Carousel Size (per user): maximum portrait size; portraits shrink if there are too many combatants to fit.
• Overflow Style (per user): what happens when the combatants don't fit: Shrink Portraits (default), Scroll or Hidden.
• Less Buttons (per user): hide Reset Initiative, Combat Tracker Settings, Previous Round and Next Round from the controls.
• Carousel Style, Alignment (Left, Center, Right).
• Portrait Aspect Ratio: Square, Portrait (default) or Long. Images are cropped to fit.
• Roundness: Sharp, Soft or Round corners for portraits and tooltips.
• Portrait Image: use the Actor image (default) or the Token image.
• Portrait Background: image behind transparent portraits.
• Player Border: frame image shown around player characters; leave it blank to disable.
• Show Disposition Color: colour the bottom border of each portrait by token disposition.
• Show Initiative on Portrait: show the initiative in the top-left corner.

Tracked attributes:

• Attribute Color, Secondary Attribute Color, Portrait Attribute Color: colours of the main bar, second bar and portrait overlay (any CSS colour).
• Bars Placement: Left, Right or Twinned.
• Attribute Visibility: Text Only, Bars Only or Text & Bars.
• Secondary Resource, Portrait Resource: the same as Tracked Resource 2 and Portrait Bar in the Combat Tracker Settings; set them there.

Information for players:

• Tooltip Attributes (Configure Attributes): the list of attributes shown in the tooltip, each with an Icon and Units. Leave the Attribute field blank to remove one; Reset Defaults restores the system's list.
• Always Show Player Info: let all players see the tracked attributes, tooltip details and system icons of the other players' characters.
• Show Descriptions: show the descriptions of active effects in the tooltip to None, Owner/Observer (default) or Everyone.
• Show System Icons: where to show system-specific icons: None, Tooltip (default), Portrait or Both.
• Display Name, Hide Until First Turn (hides the combatants from the normal Combat Tracker too when libWrapper is active), Hide Enemy Initiative, Hide Defeated, Hide Conflicting UIs: see Settings.

Keybindings, in Configure Controls: Previous Turn (Shift + N) and Next Turn (Shift + M).