Register

Build-a-Bonus

An Add-on Module for Foundry Virtual Tabletop

Author: Zhell Project Source: Project URL Versions 12 - 12 (Verified 12) Last Updated 1 month ago

Build-a-Bonus

2022 Package Jam winner of the 'Most Polished' category and runner-up for 'Best Package'

A module for the Foundry dnd5e system. After installing this module, you can find a 'Build-a-Bonus' application in any actor, item, or effect, as well as scene regions. This gives you the ability to apply a bonus to any attack roll, damage roll, saving throw DC, saving throw, ability check, or hit die roll, for bonuses that should apply only under specific circumstances.

Interested in following along with development of any of my modules? Join the Discord server.

Any bonuses you create will automatically be calculated and applied when you perform a relevant roll. The module uses filters to determine when and if a bonus should be applied. For example:

The Build-a-Bonus has countless options for how or what to apply and when. Scroll down to the bottom for the full list.

How to Use

Open any actor's sheet, any item sheet, or any effect config, then click the otter icon in the header. Choose the type of bonus you want to create, then fill out the name, description, and the bonus. Then start narrowing down when and how the bonus should apply, using the available filters.

As of foundry version 12, Build-a-Bonus also supports adding bonuses to Scene Regions. A button for this can be found in the region's sheet.

Below is an example using the artificer's Alchemical Savant feature.

The Build-a-Bonus Sheet

Description Tab

This simple tab allows you to edit the displayed image and description of the bonus.

Bonuses Tab

This tab allows for configuring the bonus that should be applying, assuming all filters are matched. Some babonus types also support dice modifiers.

Depending on the type you choose, Build-a-Bonus can add on top of the value or roll, or even several kinds at once. For example, for attack rolls, you can add bonuses on top of the roll itself, but also increase the critical range and the fumble range. This can be roll data and scale values, such as @abilities.int.mod, or just integers or dice expressions.

For damage rolls and hit dice rolls, you can also affect die modifiers. The supported modifiers are minimum and maximum values, rerolling, and explosive dice, as well as the quantity of the dice, and the size of dice.

The 'minimum' modifier will be forced to be no higher than the size of the die. E.g., if you input '99', then a d8 will still roll no higher than 8. You can maximize dice by inputting '-1'.

Configuration and Filters Tabs

These tabs are for configuring the filters on the babonus. The full list of filters can be found below.

For any fields that support roll data (such as bonuses or comparison fields detailed below), you can use the roll data of the target as well as your own; use roll data as you normally would, and for targets simply prefix with @target.

In addition, when a bonus is 'transferred' either via an effect being copied through a template aura or regular aura, the roll data used will be source's roll data, if any. This means that your paladin player can have their Aura of Protection set up using @abilties.cha.mod and all allies within the aura will receive a bonus equal to the paladin's Charisma modifier, not their own Charisma modifier.

One thing to keep in mind is that bonuses use the source's roll data, while the filters use the recipient's roll data.

Advanced Tab

This tab allows for toggling the bonus, making it exclusive to its parent item, making it opt-in, or configuring consumption or an aura.

You can set the bonus to act as an aura within a set range or within a template created by an item, and define if the aura should apply to allied targets, enemy targets, or all within range or within the template, and whether it applies to the owner or not. The bonus is applied when another token actor makes a relevant roll. The module never makes use of token movement to calculate ranges, so the usage of auras and templates is incredibly lightweight.

You can configure a list of effect statuses that prevent the aura from affecting targets and the owner (such as if the source of the aura is dead or unconscious). The Keys button on the sheet will help you pick out statuses from those that exist on the token HUD. The field itself is not validated; if you are able to give an effect a status of your own choosing, that is respected as well; simply write the status in the field.

Lastly, you can configure a non-template aura to require direct line of sight from the source token to the rolling token's actor, or to require an unobstructed path of movement.

A bonus can be toggled as optional if it affects an attack or damage roll, saving throw, or ability check. The actor will then have the choice when adding the bonus, which is shown in the roll configuration dialog when making the roll.

If the bonus is optional as described above, the bonus can also be configured to consume limited uses, item quantity, spell slots, hit points, currencies, the active effect on which it is created, or even the inspiration granted to the character from the GM. You can configure the minimum required consumption, as well as the maximum if the bonus should scale. For example, if you create an item with 10 limited uses, a bonus of "1d6", configure that the bonus is optional, and consumes between 2 and 6 uses when opted into, the actor making the roll can easily add between 2d6 and 6d6 in the roll configuration dialog, and the expended uses are automatically subtracted. This works similarly for spell slots, instead using 1 slot and scaling with spell level. A bonus consuming its effect or GM inspiration cannot scale.

Lastly, you can toggle 'Optional' on regardless for a bonus that grants no properties or dice modifiers. This will give you the ability to toggle it as a 'Reminder', causing its text to display in the roll configuration dialog.

Available Filters

See the github repository for the list of filters.

API

An API can be accessed at game.modules.get("babonus").api or through the global namespace babonus. Please see the github readme for the complete list of functions, instance methods, and hooks available.

Supported Game Systems

  1. Dungeons & Dragons Fifth Edition

    Latest Version: Version 4.1.2 Last Updated 6 days, 19 hours ago

Categories

Available Versions

  1. Version 12.5.8

    1 month ago
    Foundry Version 12 - 12 (Verified 12) Manifest URL Read Notes
  2. Version 12.5.7

    1 month, 2 weeks ago
    Foundry Version 12 - 12 (Verified 12) Manifest URL Read Notes
  3. Version 12.5.6

    1 month, 2 weeks ago
    Foundry Version 12 - 12 (Verified 12) Manifest URL Read Notes
  4. Version 12.5.5

    1 month, 2 weeks ago
    Foundry Version 12 - 12 (Verified 12) Manifest URL Read Notes
  5. Version 12.5.4

    1 month, 3 weeks ago
    Foundry Version 12 - 12 (Verified 12) Manifest URL Read Notes
  6. Version 12.5.3

    2 months ago
    Foundry Version 12 - 12 (Verified 12) Manifest URL Read Notes
  7. Version 12.5.2

    2 months ago
    Foundry Version 12 - 12 (Verified 12) Manifest URL Read Notes
  8. Version 12.5.1

    2 months ago
    Foundry Version 12 - 12 (Verified 12) Manifest URL Read Notes
  9. Version 12.5.0

    2 months ago
    Foundry Version 12 - 12 (Verified 12) Manifest URL Read Notes
  10. Version 12.4.3

    2 months ago
    Foundry Version 12 - 12 (Verified 12) Manifest URL Read Notes
  11. Version 12.4.2

    2 months ago
    Foundry Version 12 - 12 (Verified 12) Manifest URL Read Notes
  12. Version 12.4.1

    2 months ago
    Foundry Version 12 - 12 (Verified 12) Manifest URL Read Notes
  13. Version 12.4.0

    2 months ago
    Foundry Version 12 - 12 (Verified 12) Manifest URL Read Notes
  14. Version 12.3.3

    2 months, 1 week ago
    Foundry Version 12 - 12 (Verified 12) Manifest URL Read Notes
  15. Version 12.3.2

    2 months, 1 week ago
    Foundry Version 12 - 12 (Verified 12) Manifest URL Read Notes
  16. Version 12.3.1

    2 months, 1 week ago
    Foundry Version 12 - 12 (Verified 12) Manifest URL Read Notes
  17. Version 12.3.0

    2 months, 1 week ago
    Foundry Version 12 - 12 (Verified 12) Manifest URL Read Notes
  18. Version 12.2.0

    2 months, 2 weeks ago
    Foundry Version 12 - 12 (Verified 12) Manifest URL Read Notes
  19. Version 12.1.4

    3 months, 1 week ago
    Foundry Version 12 - 12 (Verified 12) Manifest URL Read Notes
  20. Version 12.1.3

    3 months, 3 weeks ago
    Foundry Version 12 - 12 (Verified 12) Manifest URL Read Notes
  21. Version 12.1.2

    4 months, 2 weeks ago
    Foundry Version 12 - 12 (Verified 12) Manifest URL Read Notes
  22. Version 12.1.1

    4 months, 2 weeks ago
    Foundry Version 12 - 12 (Verified 12) Manifest URL Read Notes
  23. Version 12.1.0

    5 months ago
    Foundry Version 12 - 12 (Verified 12) Manifest URL Read Notes
  24. Version 11.11.1

    6 months, 1 week ago
    Foundry Version 11.315 - 11.315 (Verified 11.315) Manifest URL Read Notes
  25. Version 10.5.4

    1 year, 6 months ago
    Foundry Version 10 - 10 (Verified 10.291) Manifest URL Read Notes