“Nothing happens”
Follow the lines from Start or Trigger. The step must be connected to the start, and the If answer must lead to it. A disabled step is skipped: the rule moves on without doing what it would do.
In rules with a Trigger, check that it is the right trigger. On a card, the rule must be in the right moment (use, equip or roll). For On roll, the rolls selected on the card must include the one you are making.
- With the test on (it is already on when the editor opens), see which step was highlighted last. Follow the lines from the start to find where the path stopped.
- Click the step that should run and check that it is enabled and connected to the right path. If the rule begins at Trigger, check there which use or roll should start it.
“It always gives 0 or always goes to No”
The most common cause is a wrong variable name: a name that does not exist counts as 0. Pick the editor's suggested name again. When comparing text, use quotes and the field's internal name, which may differ from what the sheet displays (for example, agilidade rather than Agility). The visual builder picks the right name for you.
To ask whether two values are equal, use two signs: ==. A single sign (=) does not work. In text or dice fields, the calculation must go between {{ and }}.
- Click the If or Bonus step and look at the value it received in the test. If it uses a variable, pick the editor's suggested name again.
- Check whether the field is in Fixed or Expression mode. Then test one value that should go to Yes and one that should go to No.
“I cannot find the step I need”
Each part of the sheet offers only the steps that make sense there. For example: Roll dice does not appear in a bonus calculation, and Add to roll and Replace roll only appear in a card's On roll.
This guide covers character sheets. Steps such as Change door and Token light belong to VTT scene automations (the game map), which have their own list.
- Go back to the part of the sheet where you opened the automation and check that it matches what you want to do.
- To spend points or make a new roll, open an action (a button or On use). To change a roll that is about to happen, open the card's On roll. To calculate a bonus, open the bonus calculation.
“Change value did not change the field”
Pick the field by clicking it with Pick on the sheet instead of typing its name. For Health, Mana and other vitals, check whether you picked the current value or the maximum.
If the field comes from a Choose step, connect the change to the Chosen output (not Cancel) and use $("Choose").targets.misc as the target, as in the skill example.
- Click Change value and pick the field again with Pick on the sheet. Check whether it is the current value or the maximum.
- Open What the test would do and look for the change and any warnings. If the field depends on a player's choice, test that choice for real on a test sheet.
“Add to roll did not apply the bonus”
Add to roll happens before the dice are rolled. That is why it cannot depend on the result of the same roll: $event.total and $event.dice do not exist yet at that moment.
Between the Trigger and Add to roll, use only decision and calculation steps, such as If, Switch, Store value and lists. Ask, Choose, Change value or another Roll dice on that path stop the bonus from being added in time. If you need to ask something before rolling, create an action that asks and then makes its own roll with Roll dice.
- Check that the card responds to the right roll and that the path reaches Add to roll before any question or field change.
- Test the simplest path first, Trigger → If → Add to roll. Then add one step at a time and test again.
“The effect happens twice” or “I cannot save”
If two paths reach the same step, it runs twice. In Switch, the All cases option runs every case that is yes; First case runs only the first one.
To save, every step needs a different name, lines cannot go back to an earlier step and required fields must be filled in. Review issues shows what is missing.
If an item's bonus should disappear when you unequip it, do not use Change value: it changes the field once and does not undo it later. Use a While equipped rule.
- If the effect happens twice, follow each line and see whether two paths reach the same action. Delete the extra line.
- If you cannot save, click Review issues and fix the item shown: repeated name, empty field, broken formula or a line going back to an earlier step.