Your First Sheet

Sheets are the data backbone of your project. Every field you add to a sheet can become a variable that your flows read and modify at runtime.

Create the sheet

Open your project and select Sheets in the sidebar. Click the New Sheet button at the top of the sheet tree.

A new sheet is created with a default name. Click on the title to rename it – for example, “Jaime”. The shortcut (shown below the name) auto-generates from the sheet name. You can edit it manually – for a character, something like mc.jaime works well because it creates a readable namespace for all variables on this sheet.

Add blocks

Click the + button at the bottom of the sheet to open the block menu. Blocks are organized into two categories:

Basic Blocks – Text, Rich Text, Number, Select, Multi Select, Date, Boolean, Reference

Structured Data – Table, Gallery

Try adding these blocks to your character sheet:

1. Choose Number and label it “Health”. Set the default value to 100. This creates the variable mc.jaime.health.

2. Choose Select and label it “Class”. Add options like Warrior, Mage, and Rogue using the block’s config popover. This creates mc.jaime.class.

3. Choose Boolean and label it “Is Alive”. Toggle it on. This creates mc.jaime.is_alive.

Constants vs. variables

By default, every block becomes a variable – except for Reference and Gallery blocks, which never expose variables.

If you want a block to hold display-only data that flows cannot read, mark it as a constant in the block’s config popover. Constants are useful for labels, descriptions, or lore text that does not need to participate in game logic.

How variables work

Every non-constant block becomes a variable with the format {sheet_shortcut}.{variable_name}:

The variable name auto-generates from the block label (lowercased, spaces become underscores). You can customize it in the block’s advanced config.

In the next guide, you will use mc.jaime.health to create branching dialogue in a flow.