fvtt-combat

Extend Foundry VTT Combat with custom initiative formulas and hooks.

1|Updated Jan 4, 2026
One-click install
npx skills add https://github.com/ImproperSubset/hh-agentics --skill fvtt-combat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fvtt-combat
Source: https://github.com/ImproperSubset/hh-agentics/tree/main/fvtt-dev/skills/fvtt-combat
Command: npx skills add https://github.com/ImproperSubset/hh-agentics --skill fvtt-combat

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides structured patterns for building and extending Foundry VTT's Combat system, including Combat, Combatant documents, initiative handling, and combat hooks such as combatStart, combatTurn, and combatRound.

Core Features & Use Cases

  • Combat lifecycle automation: tailor turn order, rounds, and initiative through custom formulas and sorting.
  • Hook-driven behavior: attach logic to combatStart, combatTurn, and combatRound to automate per-turn effects and UI updates.
  • Extensibility for systems/modules: provide a clean extension path by subclassing Foundry's Combat and Combatant, enabling consistent behavior across scenes and encounters.

Quick Start

  • Extend Foundry's Combat and Combatant classes to customize initiative and order.
  • Register hooks for combatStart, combatTurn, and combatRound to observe and influence the flow.
  • Enable the changes by configuring CONFIG.Combat.documentClass to your custom class (e.g., class MyCombat extends Combat { ... }).

Frequently Asked Questions about fvtt-combat

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I customize Foundry VTT combat initiative formulas and turn order?

Foundry VTT combat hooks like combatStart, combatTurn, and combatRound trigger at specific lifecycle stages of an encounter. You register listeners for these hooks to automate per-turn effects, update the UI, or execute event-driven behavior whenever a round or turn advances.

How do I add per-turn effects to Foundry VTT combat?

You add per-turn effects by registering a hook listener for combatTurn within your Foundry module or system. This allows your code to execute automated logic and apply specific status effects precisely when each combatant's turn begins during the active encounter.

Can I extend Foundry VTT Combatant documents for custom combat behavior?

Yes, you can extend Foundry VTT Combatant documents by subclassing the base Combatant class. This provides a clean extension path to implement consistent, custom combat behavior and state tracking for individual actors across multiple scenes and encounters.

Do I need prior Foundry API experience to use combat system extensions?

Yes, extending the Foundry combat system requires familiarity with Foundry's Combat APIs and document structure. You need to understand JavaScript class inheritance to subclass Combat and configure CONFIG.Combat.documentClass correctly.

Why override _getInitiativeFormula() in a Foundry VTT combat system?

Overriding _getInitiativeFormula() in a Foundry VTT combat system allows you to replace the default dice roll calculation with custom logic. This is necessary when your system requires specialized initiative rules based on specific actor attributes or game mechanics.