A system-agnostic FoundryVTT module for modifying and extending the standard Combat Tracker.

Adds features to the standard Combat Tracker like name hiding, hide/obscure initiative/combatant based on type/disposition/visibility/ownership, reverse initiative order, groups, group initiative, custom combat phases, multiple combatants for the same token, display token dispositions and many more.

• All features optional, configurable and works together

• Combatant Groups

  • With or without Shared Initiative(Group Initiative)
  • Quick shortcuts for creating groups
  • Selectable group leader
  • Shows combatant group/shared initiative by color indication

• Custom defined combat phases

  • Allow players to change phase for owned tokens

• Custom defined round set

• Reverse initiative order

• Multiple combatants for the same token

• Obscure(hide) combatant information/entry for non-GMs in/on:

  • Combat Tracker

    • Combatant and/or combatant initiative value based on

      • Module current settings
      • NPC/Player token
      • Token disposition
      • Token current visibility for current player
      • Token ownership

    • Combatant name

      • Combatant name masking - hides token name in Combat Tracker from non-GMs
      • Option to automatically set added combatants to name masked

    • Combatant visibility(not to be confused with token visibility)

      • Option to automatically set added combatants to hidden

    • Combatants Active Effects for tokens on the Combat Tracker

  • Canvas(scene)

    • Token Active Effects
    • Token Borders

• Show information in Combat Tracker(for GMs and/or Players)

  • Combatant disposition by color indication
  • Show token actor portrait instead of token portrait

• Change token disposition/visibility from Combat Tracker

• Quick input field to modify current initiative value

• Pan to token in Combat Tracker for players

• Select, pan and zoom to type/group combatants for GMs

• Add tokens from scene based on token type and/or disposition

Ramses800(Ramses800#8517)@Foundry Discord Server

Discussion on GitHub

Depending on current module setting, various interface elements are added/displayed.

In the screenshot below, a scenario with all module options enabled, to the left is the GMs screen, to the right is the Alban´s player screen. Alban´s player can not see Orc Shaman(invisible) or Orc Archer 2(blocked line of sight), he can not see any other tokens/combatants active effects or the name of masked combatants. The token Eva has disposition of SECRET and therefore her initiative is hidden from Alban. Alban has also been granted a second action(duplicated combatant).

In this scenario, Alban´s player can only see other players that has a FRIENDLY disposition

Same scenario as demo 2 but with phases disabled

All menus available content is controlled by the module current settings

If any options are enabled, a command button is added to the Encounter Controls

• Add - for adding tokens on the canvas matching selection type to the current encounter. If the token is already in the encounter as a combatant, its current state(visibility, initiative,phase etc) is kept as is(it will not be added again).

• Reveal - will make combatants visible in players Combat Tracker(if not hidden by other settings)
• Hide - will make combatants hidden in players Combat Tracker
• Remove - will remove combatants from encounter
• Select - will select combatants tokens on the canvas and pan and zoom to fit them on screen
• Unmask - will make combatants name show in players Combat Tracker
• Mask - will hide combatants name in players Combat Tracker
• To Unset - will move combatants to the Unset phase

For each command, a sub dropdown menu will open with the following selections possible

• All - the command will affect all combatants in the current encounter
• All players - the command will only affect player combatants in the current encounter
• All NPCs - the command will only affect all NPCs combatants in the current encounter
• All Friendly NPCs - the command will only affect NPCs combatants with a Friendly disposition in the current encounter
• All Neutral NPCs - the command will only affect NPCs combatants with a Neutral disposition in the current encounter
• All Hostile NPCs - the command will only affect NPCs combatants with a Hostile disposition in the current encounter
• All Secret NPCs - the command will only affect NPCs combatants with a Secret disposition in the current encounter
• If Groups is used, any groups will also added.

Create a new group with no members

Creates a group based on all combatants of that type. If group already exist, it will be updated

• Players
• NPCs
• Friendly NPCs
• Neutral NPCs
• Hostile NPCs
• Secret NPCs

This will remove all members from all existing groups without deleting any groups.

This will remove all members from all existing groups and delete all groups.

Opens the group editor form for selected group

See sections on Groups for more information

The Encounter Control Dropdown also have shortcuts to

• Module settings
• If Round Set is enabled, the Round Set Editor can be opened from here
• If Phases is enabled, the Phases Editor can be opened from here

Creates group from selected token and joins all combatants with this token to the created group. The combatant that triggered the group creation will be added first to the group and designated group leader. If the group already exist, it will be updated.

Creates group from selected actor and joins all combatants with this actor to the created group. The combatant that triggered the group creation will be added first to the group and designated group leader. If the group already exist, it will be updated.

Creates group from selected actor folder and joins all combatants with actors in the same folder to the created group. The combatant that triggered the group creation will be added first to the group and designated group leader. If the folder has a color, the group will use that color. If the group already exist, it will be updated.

Joins the selected combatant to the group

Opens the group editor form for selected group

Make selected combatant group leader

This will set the combatant to ungrouped.

Each phase has a command control that can assign(move) a selection of combatants to it.

This will take a random combatant from the Unset phase.

Combatants in a group that shares the initiative and option for Phase sharing enabled, will be handled as a single combatant and if selected by the random dice, all members of that group will be assigned to the same phase.

If a combatant has more active effects than can be displayed in the combat tracker, all effects will be replaced by a summary icon. This icon has a tooltip that displays all effects.

Foundry version 10, 11

This module uses two definitions that can be confusing, Round Set and Phases. The actual label for these functionalities differs between RPG systems but for the module functionality these are the definitions used. Round Set and Phases can be enabled at the same time.

A Round Set is a set of Foundry rounds, meaning you can define phases, segments or whatever your system call them and have the combat tracker go from one round to another and start again with the first round.

Use the Round Set Editor found in the module´s Configure Game Settings or, when Round Set is enabled, the Encounter Control Dropdown, to define custom rounds.

A Phase is a part of a Foundry round. This feature divides the Foundry round into phases which each has its own initiative order. Combatants is assigned to a phase. You can use any naming for phases, it could be like in the example below or just "Players", "Enemies", "Allies" etc.

A "Unset" phase is always added to the defined phases and will be the default phase a combatant is assigned to when added to an encounter. The name displayed for the Unset phase can be changed in settings.

Use the Phase Editor found in the module´s Configure Game Settings or, when Phases is enabled, the Encounter Control Dropdown, to define custom phases.

Groups comes in two major flavors, groups that shares initiative and groups that does not share initiatives.

The first combatant added to a group will be designated the default group leader, this can be changed later with the combatant dropdown menu command Set as group leader.

Groups are only visible to GMs.

Indicated by a dashed left border.

Combatants in a non-sharing group are treated as any other combatant. The grouping is merely a logical extension to be used for helping the GM to keep gangs/bands/strike teams etc. together and use overall commands like Mask/Unmask/Reveal/Select etc.

Indicated by a solid left border

Combatants in a sharing group is handles as a single combatant, if initiative (or phase if option is checked) is changed for one combatant in the group, the others are updated to match.

The group leader´s initiative will be used for Roll All/Roll NPC commands and also the sorting in Combat Tracker and Group Editor