Core Workflows

This page attempts to cover the usage of all the tabs and menu in the app.

Navigation And Quick Access Tabs

• Default pinned tab starts with Core Stats.
• Maximum pinned tabs: 4.
• When at max, add actions switch to edit behavior.

To add or remove:

1. Open the quick tab dialog.
2. Press a tab from the top list to pin it.
3. Press a tab from the pinned list to unpin it.

Health, Temp HP, And Rest

Click on the health bar to open health controls and apply damage, healing, temporary HP, and max HP modifier.

• Damage subtracts temporary HP first, then current HP.
• Healing cannot exceed current max HP.
• Active temporary HP locks input until reset.
• Max HP modifier are shown in details in the health controls (e.g. "35 / 40 (35+5)") but only final result is displayed in the health bar (e.g. "35 / 40").
• Max HP modifiers stack on top of each other, you can reset them all at once with the "Reset" button.

Short And Long Rest

1. Open short or long rest dialog from the side panel.
2. Choose options (New Day, Auto-Hit Dice, etc.).
3. Confirm rest action.

Mode Note:

• The app relies on the server to apply rest mechanics, recover resources, etc. In restricted modes, local data won't change.

Core Stats

The "Core Stats" tab displays a few fundamental attributes of your character.

• AC, Initiative and Proficiency bonus, and Passive Perception.
• Currently applied conditions.
• Exhaustion and Death Saving Throws trackers.
• Speeds.
• Hit Dice amount and denomination.

Condition Interaction

1. Tap a condition badge..
2. Condition dialog opens with name and description.
3. In the condition dialog, select "Remove Condition" to remove it.

Mode Note:

• If server update is not possible, condition removal will only be applied locally.

Hit Dice Dialog

You can press and the Hit Dice section to open the dialog and manage your hit dice and healing.

Character Details

The "Character" tab contains various character information and traits.

• Classes, Subclasses, race, Background, Alignment.
• Languages, Senses, Armor/Weapon Proficiencies.
• Resistances, Immunities, and Vulnerabilities.
• Personality Traits, Ideals, Bonds, and Flaws.

Skills, Saves, Abilities and Tools

Skills, saves, abilities and tools are visible in the "Skills" tab.

• You can roll any of them just by clicking on the respective entry.
• For the skills, the first number represents the skill modifier (e.g. +2), and the second number represents the passive score (e.g. 12).
• Proficiency is reflected in this way:
  • No proficiency: Empty circle.
  • Proficient: Filled circle.
  • Expertise: Double circle.
  • Half proficiency: Half-filled circle.
• Contextual options (advantage, disadvantage, bonus, changing ability, etc.) are a WIP.

Search And Filters

Search bars are tab-local and filter rows in real time.

• Type in a tab search bar to hide non-matching rows.
• Focusing a search bar clears text and resets visibility.

Filter dialogs support 3-state options:

• Neutral
• Include
• Exclude

Workflow:

1. Open a filter dialog for spells or inventory.
2. Toggle options until desired state.
3. Apply to close and run filtering.
4. Reset to clear selected criteria.

Spellbook: Cast, Slots, Preparation

Spells are grouped by level and can be searched and filtered as explained in the Search and Filters section.

Cast A Spell

1. Open a spell row.
2. Select Cast.
3. Cast button only appears for prepared spells.
4. Contextual menu appears with options.
5. Choosen options are transmitted to the server, rolling attack and/or damage rolls as needed.
6. Eventual resources consumption is updated by the server then sent to the app.

Contextual Options:

• Consuming spell slot and/or other resources (when applicable).
• Using a higher level slot if available.
• Creating a template on the map.
• Updating concentration status when applicable.
• Other options such as (dis)advantage, roll bonus, damage bonus, etc. are a WIP :).

Toggle Spell Slot Directly

1. In a spell-level group, tap full / empty slot circles.
2. Confirm Use / Regain prompt.

Prepare Or Unprepare A Spell

1. Select Prepare on a spell row.
2. Confirm override prompt if class preparation limit is reached.

Inline Rolls

Whenever you see a colored, bolded roll formula (e.g., 3d6), you can tap it to roll it and view the results in Foundry.

Mode Note:

• If you are connected to a server with the premium module, the updates are sent to the server.
• Slot/preparation edits are still reflected locally in local modes.

Features

Features are displayed in the "Features" tab and can be used just like spells. They are grouped by source (e.g. class, race, background, etc.). You can also search and filter them as explained in the Search and Filters section.

Inline Rolls

Whenever you see a colored, bolded roll formula (e.g., 3d6), you can tap it to roll it and view the results in Foundry.

Inventory And Containers

Items are grouped by category (e.g. weapons, armor, consumables, etc.). You can also search and filter them as explained in the Search and Filters section.

Item Details

1. Tap an inventory row to expand details.
2. Read description and tags.
3. Items that can be "used" (e.g. weapons, consumables, etc.) have an additional "Use" button available.
4. Similar to casting spells, using items will prompt for resource consumption options.
5. Items can also be (Un)Equipped.
6. Use / Equip actions are transmitted to the server and processed accordingly (rolling attacks, damage, displaying item card, etc.).

Inline Rolls

Whenever you see a colored, bolded roll formula (e.g., 3d6), you can tap it to roll it and view the results in Foundry.

Open A Container

1. Expand a container row.
2. Select Open Container.
3. Review nested item list under Contents.
4. Select Back to Info to return.

Note:

• Containers in containers are unnested for easier navigation.

Journal

Journal entries are stored per actor and only locally.

Create and edit:

1. Open Journal tab.
2. Select New Note.
3. Enter title and note text.

Additional behavior:

• Input updates are persisted as you type.
• Entries can be expanded/collapsed.

Note:

• Journal entries are local to the actor AND stored in the app cache. They are not sent to Foundry and do not appear in the Foundry Journal tab. We are working on better ways to manage and sync journal content with Foundry in the future.

Favorites

Favorites let you pin frequently used items/spells/features.

To toggle a favorite:

1. Open any row with a favorite icon.
2. Select the bookmark button.

Expected behavior:

• Favorite state updates both in source list and Favorites tab.
• Favorites are actor-specific and synced with the server.

Mode note:

• In local modes, favorite changes can still be saved locally.