Package Description

Combat Numbers is a FoundryVTT module which showcases bouncing combat text on tokens, similar to old-school JRPGs. There's still work to do, but it allows for fine-grained control on what is broadcast to other players when an actor's HP changes.

Downloads Forge Installs Issues MIT License



What Does This Look Like?

Damage example:

Healing example:


Supported Systems

If you have a system you would like to use but it is not in the list above, it may just work out of the box! If you're finding that it is not or misbehaving, read the section entitled "Advanced Customization for Unsupported Systems".


Canvas Layer Controls

Combat Numbers Canvas Layer Controls

Combat Numbers includes an additional Canvas Layer Control button in the toolbar, seen as "#". Currently, this is only available for GMs. When clicked, you are presented with two toggleable options:



Adjust Combat Numbers settings within your macros! You can access the API via window.combatNumbers, and have access to these methods which affect the canvas layer controls:

For example, to stop broadcasting HP changes as a GM, you could run:




Advanced Customization for Unsupported Systems

Currently, it's tough to support every popular system out there for Foundry. In the module settings, you can specify "HP Object Path" and "Temporary HP Object Path". Some Foundry VTT systems support HP in a slightly different object structure. If you know how Actor and Token entities structure their data for the HP and temp HP attributes, you can specify this here.

For example, the default HP Object Path for the DnD5e system is attributes.hp.value. For the Old-School Essentials system, it is hp.value.

Please see our Wiki for details on already documented systems.


Language Support



Please see the Changelog for all changes between updates


Future Planned Features

Tagged Categories

  1. Combat Enhancements
  2. Visual Effects

Available Versions

  1. Version 0.1.3

  2. Version 0.1.4

  3. Version 0.2.0

  4. Version 0.2.1

  5. Version 0.3.0

  6. Version 0.3.1

  7. Version 0.3.2

  8. Version 1.0.0

  9. Version 1.1.0

  10. Version 1.1.1

  11. Version 1.1.2

  12. Version 1.1.3

  13. Version 1.1.4

  14. Version 1.1.5