How do I access the actual Token instance from a Combatant?

Use canvas.tokens.get(combatant.tokenId) since combatant.token refers to the TokenDocument data rather than the rendered instance.

How can I skip defeated combatants in the turn order?

You can override the nextTurn() method in a custom Combat class to iterate through combatants and skip those with the defeated status.

How do I implement a custom initiative formula?

You can override the _getInitiativeFormula() method in your system's Combatant class and register it via CONFIG.Combatant.documentClass.

What is the difference between _onStartTurn and the combatTurn hook?

_onStartTurn is a workflow method that runs only for the GM after a turn change, while the combatTurn hook runs on all clients.

Foundry VTT Combat Development

Name: Foundry VTT Combat Development
Author: ImproperSubset

byImproperSubset

Game Development

Manages turn-based encounters, initiative systems, and combat lifecycles within Foundry Virtual Tabletop.

About

The fvtt-combat skill provides comprehensive guidance and implementation patterns for the Foundry VTT combat system. It enables developers to efficiently handle Combat and Combatant documents, implement custom initiative formulas, manage turn order, and hook into lifecycle events like combatStart and combatTurn. Whether building a custom game system or a complex automation module, this skill ensures best practices for round progression, tie-breaking logic, and multi-GM synchronization, helping developers avoid common pitfalls like empty combat errors or token data mismatches.

Key Features

Automated combatant management and defeated unit logic
Guidance on extending core Combat and Combatant classes
0 GitHub stars
Custom initiative rolling formulas and tie-breaker logic implementation
Hook integration for combatStart, combatTurn, and combatRound events
Advanced combat lifecycle management including turn and round progression

Use Cases

Creating UI enhancements for the Foundry VTT Combat Tracker
Developing automation modules that trigger effects at the start or end of a turn
Implementing a unique initiative system for a new Foundry VTT game system

About

Key Features

Automated combatant management and defeated unit logic
Guidance on extending core Combat and Combatant classes
0 GitHub stars
Custom initiative rolling formulas and tie-breaker logic implementation
Hook integration for combatStart, combatTurn, and combatRound events
Advanced combat lifecycle management including turn and round progression

Use Cases

Creating UI enhancements for the Foundry VTT Combat Tracker
Developing automation modules that trigger effects at the start or end of a turn
Implementing a unique initiative system for a new Foundry VTT game system