How do I include actor attributes in a roll formula?

Use the @ syntax within the formula string (e.g., '@abilities.str.mod') and provide the actor's getRollData() object as the second argument to the Roll constructor.

Is it safe to use raw user input in Roll formulas?

It is best practice to validate user-provided formulas using Roll.validate(userInput) before attempting to construct or evaluate a Roll object to prevent errors.

How do I respect the user's current roll mode (Public, GM, Blind)?

You should pass game.settings.get('core', 'rollMode') into the options object of the roll.toMessage() method to ensure privacy settings are honored.

Can I create custom dice types for unique game systems?

Yes, you can extend the Die class to define custom logic and register your new term in CONFIG.Dice.terms, allowing for new denominations like '1ds'.

Why do I need to await roll.evaluate() in Foundry VTT?

Foundry VTT's Roll.evaluate() is an asynchronous operation. The roll.total and roll.result properties remain undefined until the evaluation is complete and awaited.

Foundry VTT Dice & Rolls

Name: Foundry VTT Dice & Rolls
Author: ImproperSubset

byImproperSubset

0•

Desarrollo de Videojuegos

Implements and manages complex dice rolling mechanics, formulas, and chat integration for Foundry VTT system and module development.

The fvtt-dice-rolls skill provides expert guidance on the Foundry VTT Roll API, enabling developers to build robust game mechanics within the VTT environment. It covers the entire lifecycle of a roll—from constructing complex formulas with variable substitution to asynchronous evaluation and rendering results in chat. The skill includes best practices for actor/item data preparation via getRollData(), handling advanced modifiers like advantage/disadvantage, and implementing custom dice types to support diverse tabletop RPG systems.

Características Principales

01Integration with ChatMessage and Roll Modes (GM, Blind, Self)

02Implementation of custom Die and Roll classes

03Advanced dice modifiers like keep/drop, exploding, and rerolling

04Dynamic formula construction with @variable substitution

050 GitHub stars

06Asynchronous roll evaluation and result handling

Casos de Uso

01Adding rollable buttons to actor and item sheets with proper data context

02Implementing specialized dice mechanics like stress dice or success-counting systems

03Creating an automated attack and damage system for a custom TTRPG

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add impropersubset/hh-agentics fvtt-dice-rolls

For use in Claude.ai and ChatGPT

Download Skill