← Back to Documentation Hosting Guide →

User Guide

This guide covers everything you need to know to use Roll Sheet effectively.

Table of Contents

Getting Started

When you first open Roll Sheet, you’ll see a three-column layout:

  1. Sheet Sidebar (left) - Icons for each character sheet
  2. Character Sheet (center) - A unified list of sheet items (attributes, roll templates, resources, headings)
  3. History (right) - Roll results

Click the + button in the sidebar to create your first character sheet.

Character Sheets

Creating a Sheet

Click the + icon at the bottom of the sheet sidebar. A new sheet will be created empty, ready for you to add attributes. New sheets open in edit mode so you can start building immediately.

Switching Sheets

Click any sheet icon in the sidebar to switch to that character. Sheets open in read-only mode by default.

Renaming a Sheet

Hover over the sheet name at the top and click the pencil icon. You can change:

If you don’t set custom initials, they’re automatically generated from the sheet name.

Copying a Sheet

Click Copy Sheet at the bottom of the character sheet to duplicate it. Useful for creating similar characters or NPCs.

Deleting a Sheet

Click Delete Sheet and confirm the deletion. This cannot be undone.

Read-Only Mode

The lock icon in the top-right corner toggles read-only mode. This is a client-side preference that isn’t synced to other users.

When Locked (Read-Only)

When Unlocked (Edit Mode)

Click the lock icon to toggle between modes at any time.

Attributes

Attributes store your character’s stats and information. They appear inside the unified Sheet Items list alongside roll templates, resources, and headings.

Unified Sheet Items List

Attributes come in four types:

String Attributes

For text values like character name, class, or notes.

Integer Attributes

For numeric values like ability scores, level, or hit points. These can be referenced in roll formulas using @code.

Derived Attributes

Computed values based on other attributes. For example, a modifier might be:

floor((@strength - 10) / 2)

Supported operations: +, -, *, /, (), ceil(), floor()

Derived attributes can only reference integer attributes, not other derived attributes.

Headings

Section dividers to organize your attributes. Click the chevron to collapse/expand sections.

Working with Attributes

Note: In read-only mode, attribute codes are hidden for a cleaner display.

Attribute Codes

Each attribute has a unique code used for references:

Resources

Resources track expendable items like spell slots, hit dice, or ability uses with visual pip displays.

Creating a Resource

  1. Click + Resource at the bottom of the Sheet Items list
  2. Enter a name (e.g., “Spell Slots”)
  3. Set the maximum value
  4. Choose a pip shape and color
  5. Press Enter or click the checkmark to save

Maximum Value Formulas

The maximum field can be a simple number or a formula referencing attributes:

This lets resources scale automatically as your character levels up.

Using Resources

Click any pip to toggle it filled or empty. The current count updates automatically and syncs to all connected clients.

Pip Shapes

Choose from various shapes to match your resource type:

Roll Templates

Roll templates let you save and reuse dice formulas.

Creating a Template

  1. Click + Roll Template at the bottom of the Sheet Items list
  2. Enter a name (e.g., “Attack Roll”)
  3. Add formula variants with titles (e.g., “Normal”, “With Advantage”)
  4. Set the display format
  5. Press Enter or click the checkmark to save

Formula Variants

Each template can have multiple formula variants. For example, an attack roll might have:

When rolling, click the main button for the first variant, or use the dropdown for others.

Multi-Result Formulas

Sometimes you want to roll multiple things at once, like an attack roll and damage roll together. Use square brackets to create multiple results:

[1d20+@attack][1d8+@str]

This rolls the attack and damage separately. In your display format, access each result with numbered placeholders:

{name} attacks: {result} to hit, {result2} damage

Without brackets, the entire formula is treated as a single result.

Display Format

Customize how roll results appear in history:

{name} attacks for {result} damage!

Available placeholders:

Using the Variant Tag

When you have multiple formula variants (like Normal, Advantage, Disadvantage), use {variant} to show which one was rolled:

{name} rolls {variant}: {result}

This might display as “Gandalf rolls Advantage: 18” when rolling with advantage.

Super Conditions

Trigger dramatic effects for special rolls (like critical hits):

{result} >= 20

Available placeholders:

Dice Notation

Roll Sheet supports comprehensive dice notation:

Basic Rolls

Attribute References

Keep/Drop Modifiers

Modifiers can stack: 4d6dl1dh1 drops both lowest and highest.

Arithmetic

Roll History

All rolls are saved to the history panel and synced to all connected clients.

Viewing Results

Each entry shows the display format with resolved values. Click the chevron to expand details:

Clearing History

Click the trash icon next to the “History” heading to clear all entries. This affects all connected clients.

Ad Hoc Rolls

Sometimes you need to make a quick roll without creating a template. On desktop, use the ad hoc roll field at the bottom of the history panel.

Making an Ad Hoc Roll

Type your message with dice formulas in square brackets:

I attack the goblin [1d20+@str] and deal [1d8+@str] damage

Press Enter or click the play button to roll. The formulas are replaced with results:

I attack the goblin 17 and deal 6 damage

What You Can Do

Notes

← Back to Documentation Hosting Guide →