Node Types

Every node in the Logic Editor belongs to a category. You can find them in the sidebar panel on the left side of the canvas. Drag any node from the sidebar onto the canvas to add it to your graph.

Each node has inputs (on the left side) and outputs (on the right side). You connect an output from one node to an input on another to pass data between them.

Variables

Variable nodes are your starting points. They provide data to the rest of your graph — either by reading values from the character sheet or by supplying a fixed number or text value.

Attributes correspond to the fields you have placed in the Layout Editor. The Attribute node gives you a dropdown of all available attribute names, so you don't have to remember them.

Interaction

Interaction nodes connect your logic to things the player does — clicking buttons and rolling dice.

The Roll / Message node is where your logic meets the dice. You write a message template using Roll20's syntax — for example, &{template:default} {{name=Attack}} {{roll=[[1d20+@{attack_bonus}]]}}. Each {{field}} you reference in the template automatically creates an input on the node that you can connect to other nodes.

Math

Math nodes perform arithmetic. If you have ever written a formula in a spreadsheet, these will feel familiar.

Logic

Logic nodes let you make decisions — comparing values and choosing different paths based on conditions.

If / Else Node

The If / Else node is a conditional switch that routes data based on one or more conditions. It replaces the need to chain multiple simple if/then nodes together.

Structure:

Each If / Else node starts with one case and a default. Each case has:

• A When input (left side) — connect a boolean condition here (typically from a Compare or Logic Gate node).
• One or more Then slots — connect the value(s) you want to pass through when this case matches. Each Then slot has a corresponding output handle on the right side.

Below all cases is a Default section with its own value slots and outputs. Default activates when no case condition is truthy.

Adding and managing cases:

• Click Add Case to add more conditions. Cases are evaluated top to bottom — the first truthy condition wins.
• Use the arrow buttons to reorder cases (move up/down).
• Click the × button to remove a case.
• When you have 4 or more cases, a Collapse button appears to hide the case details and save space on the canvas.

Dynamic slots:

Each case (and the default) supports multiple value slots. When you connect to the last empty slot, a new one appears automatically. When you disconnect, trailing empty slots collapse. This lets you route multiple related values through the same conditional — for example, passing both a damage value and a label through the same case.

Inactive case filtering:

Only the matched case's outputs produce values. Outputs from unmatched cases are marked inactive and are automatically filtered out by downstream nodes. This means you can safely connect outputs from multiple cases to the same multi-input node (like Add or Multiply) without getting unwanted values mixed in. Only the winning case's values flow through.

Example: Conditional Proficiency Bonus

Here is a common pattern for applying a proficiency bonus only when a skill is marked as proficient:

1. Use a Compare node to check if athletics_proficiency equals 1.
2. Connect the result to the If / Else node's first When input.
3. On the first case's Then slot, connect your proficiency bonus value.
4. On the Default slot, connect a Number node set to 0.
5. Connect the matching output to the rest of your skill bonus calculation.

The result: proficient characters get the bonus, non-proficient characters get zero.

Example: Multi-Case Damage Type

For a weapon that deals different damage based on a damage type selector:

1. Add three cases to the If / Else node.
2. Connect a Compare node to each When input, checking damage_type against "slashing", "piercing", and "bludgeoning".
3. Connect different damage formulas to each case's Then slot.
4. Connect a default fallback value to the Default slot.
5. Connect the outputs to your damage total calculation — inactive cases are automatically filtered, so only the matching damage formula contributes.

Data

Data nodes handle text manipulation and type conversion.

Groups

Group nodes help you organize complex graphs and handle repetitive patterns efficiently.

Custom

For advanced users who need capabilities beyond the built-in nodes.