raaviarda / foundryvtt-betterrollssw5e

A module for modifying certain sheet functions on Foundry VTT Character sheets for D&D 5th Edition.

FoundryVTT - Better Rolls for 5e

A module for modifying certain sheet functions on Foundry VTT Character sheets for D&D 5th Edition. It allows for quick, compounded rolls for items, ability checks saving throws, and just about any roll you might want in 5th Edition D&D.

Though initially a fork of Hooking's Item Sheet Buttons module, it now includes several roll templates designed for Foundry's 5e sheets to increase speed of play.

Felix's Chat Damage Buttons module has been implemented into core Better Rolls.

If you are feeling generous, and would like to support my work, you can do so through this Paypal link. Thank you!

Installation

Method 1

• Start up Foundry and click "Install Module" in the "Add-On Modules" tab.
• Search for "Better Rolls" in the pop up window.
• Click "Install" and it should appear in your modules list.
• Enjoy!

Method 2

• Start up Foundry and click "Install Module" in the "Add-On Modules" tab.
• Paste the link: https://raw.githubusercontent.com/RedReign/FoundryVTT-BetterRolls5e/master/betterrollssw5e/module.json
• Click "Install" and it should appear in your modules list.
• Enjoy!

Method 3

• Download the .zip file in this repository.
• Extract the contents of the zip in \resources\app\public\modules\
• Restart Foundry.
• Enjoy!

Implemented Features

• New! Implemented d20 roll modes for Single, Dual, and Triple rolls. Single mode will roll double in the case of advantage and disadvantage.
• New! Rolls with advantage or disadvantage highlight the correct roll, indicating which roll is used.
• Improved roll outputs into chat for efficiency. Pretentiously dubbed "Better Rolls", these compounded rolls can include dual d20 rolls for attack rolls, ability checks, and saving throws, but also damage rolls and automatic critical damage calculation.
• Added sheet buttons when expanding an item's summary in the sheet, allowing the sheet to quickly output whatever is needed (Attack & damage rolls combined, attack & alternate damage, just attack, just damage...)
• Clicking an item/feat/spell's icon will give a quick roll, based on the fields present in the item clicked.

Clicking with/without the Alt key:

• Alt Quick Rolls, which can be used by holding Alt when clicking the item's icon in the character sheet. These can be configured separately from normal Quick Rolls.
• Need for clicking through prompts in order to get a single roll is removed, allowing for ease of use.
• Per-item options for showing the item's description on a quick roll.
• Per-item critical threshold.
• Supports sw5e's additional damage rolls, which are fully configurable for appearing on Quick Rolls!

• Natively supports the Better NPC Sheet

• Configurable options for disabling better rolls, changing sheet outputs, and labels for both roll sets and damage type.

• Localization support - now comes with full Japanese and Korean translations!

• Macro support! Try dragging and dropping an item, spell, or feat from your character sheet onto the macro hotbar!

• Script macros are also intuitive enough to be entered manually.

• Try BetterRolls.quickRoll("Shortbow"); on a creature with an item named "Shortbow", or BetterRolls.quickRollByName("Sharon", "Shortbow"); to fire Sharon's shortbow.

• Custom damage labels. Add written context to damage rolls to convey what the damage comes from, or when it occurs.

Planned Features

• Additional macro support

Known Issues

• Consumable logic is currently not working. Sit tight as the sw5e system improves!
• Blind rolls do not work with Better Rolls. This is due to the way that blind roll message logic is implemented in Foundry.
• Chat Damage Buttons may not work for your players if you use Combat Utility Belt and have its "Hide NPC Names" feature enabled. This is because that feature overwrites click events in the messages. Make sure to disable the CUB feature if you wish to continue using Better Rolls's chat damage buttons.

Acknowledgements

• Big thanks to Atropos for making a wonderful VTT that's worth making modules for!
• Thanks are also due to Hooking for the initial Item Sheet Buttons module, without which this project would not exist.
• Thank you, Felix#6196 for making a wonderful extension of Chat Damage Buttons reconfigured for this module.
• Thank you, Brother Sharp#6921 for providing the Japanese localization for this module.
• Thank you, KLO#1490 for providing the Korean localization for this module.
• Thank you, Cosmo Corban#4840 for providing the Spanish localization for this module.
• Thank you, Olirin#0350 for providing the French localization for this module.
• Additional thanks go to KaKaRoTo, tposney, and Giddy of the Foundry discord for advice and assistance while developing and maintaining this module.
• My gratitude extends also to all the folks of the Foundry VTT community for their endless wisdom and insight.

License

The source code is licensed under GPL-3.0.