×

Roller Functionality Tutorial

Core Concept: The CVN

The heart of the Roller system is the Current Variable Number (CVN). This number represents the "weight" or probability of an item being selected when you roll. You can edit it directly to influence the outcome. The entire system is designed to automatically adjust this number based on rules you set.

The Editor Columns Explained

• Item Title: The name of the item.
• Redirect Target: (Optional) Link this item to a Card or Cube. When the item is rolled, you'll get a button to jump directly to it.
• CVN: The item's current weight. This is the only number that changes automatically. A higher CVN means a higher chance of being rolled.
• Initial: The number the CVN will start at and what it will reset to after hitting the 'Revert At' value.
• Revert At: The threshold that triggers a reset. If the CVN reaches or passes this number, it will revert to the 'Initial' value on the *next* roll that wins.
• Step: This compound control determines how the CVN changes after a successful roll.
  • Value: The amount to change by.
  • Direction (+/-): Whether to add or subtract the step value from the CVN.
  • Type (Fixed/%): 'Fixed' changes the CVN by the exact step value. '%' changes it by a percentage of the total range between 'Initial' and 'Revert', rounded up.
• Static: A fixed bonus number that is added to the CVN *only* for calculating the roll probability. It does not affect the CVN's value directly and is ignored by the Revert logic. Think of it as a "thumb on the scale."

How a Roll Works

1. For each item, its probability is calculated as CVN + Static.
2. A "pool" is created where each item is added a number of times equal to its calculated probability. (e.g., an item with a probability of 10 is added 10 times).
3. A single winner is randomly chosen from this pool.

After the Roll: Updating the Winner's CVN

1. The system first checks if the winning item's CVN has reached its Revert At value. If it has, the CVN is reset to its Initial value.
2. If it has *not* reached the revert value, the Step logic is applied to update the CVN for the next roll.

A Concrete Example

Imagine an item with these settings:

Setting	Value
Initial	10
Revert At	50
Step	5, +, Fixed
Static	0

- 1st Roll (Win): The item wins. Its CVN is 10, which is less than 50, so it doesn't revert. The step is applied: 10 + 5 = 15. The new CVN is 15.
- 2nd Roll (Win): The item wins again. Its CVN is 15. It doesn't revert. The step is applied: 15 + 5 = 20. The new CVN is 20.
- ... Many Rolls Later ... The CVN is now 50.
- Next Roll (Win): The item wins. Its CVN is 50, which is equal to the 'Revert At' value. The CVN is reset to the 'Initial' value. The new CVN is 10.

Validation Rules

To prevent impossible logic, the system requires:

• If Step Direction is +, the Initial value must be less than the Revert At value.
• If Step Direction is -, the Initial value must be greater than the Revert At value.

×

Card Tutorial

What is a Card?

A Card is the most basic item on your board. Think of it like a sticky note or an index card. It's perfect for representing a single task, a scene in your story, a quick idea, or a to-do item that needs to get done.

Key Features

• Content: The main text area for your card's details. You can load a Text Template into this area. It also supports automatic linking of URLs. You can use the "Fullscreen" button for a focused writing experience.
• Image: You can add a visual reference to your card by pasting an image URL or uploading a local file. This image will show up on the main board view.
• Cube Link: This is a powerful feature that lets you connect a simple Card to a much more detailed Cube. If an idea on a card grows too big, you can create a Cube for it and link it here for quick access to the deep-dive information.
• Embedded Rollers: You can add any Roller you've created directly to a card. This is useful for things like random encounter tables on a location card or loot drops on an enemy card.
• Checklists: Cards support multiple, sortable checklists. Use them to break down a task into smaller steps. You can name each list, reorder them, and save any checklist as a reusable template.
• Actions (Sidebar):
  • Duplicate Card: Creates an exact copy of the current card in the same column.
  • Convert to Cube: "Promotes" this card into a full Cube, moving all its content into a new entry in the Cube Writer. The original card is deleted. This is the primary way to expand a simple idea into a detailed wiki-like entry.
  • Copy to Project: If you have a local directory loaded, you can copy this card to another project.
• Comments: A simple, timestamped log for leaving notes or tracking progress.

×

Cube Writer Tutorial

What is a Cube?

A Cube is a container for detailed information, like a personal wiki page for your project. The most powerful feature of Cubes is that they can be nested inside each other, allowing you to create a structured hierarchy of information.

For example, you could have a "World" Cube that contains "Continent" Cubes. Each "Continent" Cube could contain "Country" Cubes, which in turn contain "City" Cubes. This helps you organize complex information in an intuitive way.

Navigating the Cube Writer

• Main View: This shows all the Cubes at your current level. You can click the ➔ button on a Cube to "enter" it and see the Cubes it contains.
• Breadcrumb Trail: The title at the top of the Cube Writer shows your current path in the hierarchy (e.g., "My Project > World > Continent").
• Back Button: Use the ← button in the controls to go up one level in the hierarchy.

Key Features

• Title & Type: Every Cube has a title and a Type (e.g., Character, Location, Note). You can create your own custom types by selecting "Add new type..." from the dropdown. The Type helps you organize your content and can be linked to a default Text Template or Checklist Template.
• Content, Image, Rollers, Checklists: These features work exactly the same as they do on Cards, giving you a rich set of tools for every entry.
• Actions (Sidebar):
  • Duplicate Cube: Creates an exact copy of the current Cube, including all its nested content, at the same level.
  • Convert to Card: "Demotes" this Cube into a simple Card on the main board, placing it in an "Imports" column. This is useful if a detailed entry is no longer needed and you just want a quick reference on the board.
  • Copy to Project: If you have a local directory loaded, you can copy this Cube (and all its nested content) to another project.

×

Checklist Template Tutorial

What is a Checklist Template?

A Checklist Template is a reusable master list that you can create once and use anywhere in your project. This is perfect for standard procedures or recurring tasks, such as "New Character Setup," "Episode Pre-Production," or "Location Scouting Steps."

Creating & Editing Templates

• From the "My Checklists" View: You can create a new, blank template from scratch by clicking the "+ Create New Checklist" button on the main checklist page.
• From a Card or Cube: If you've created a checklist inside a Card or Cube that you'd like to reuse, simply click the Save as Template button in that checklist's header.
• Editing: In this editor, you can change the template's title and manage its items. Use the "+ Add Item" button to add new lines, and the "X" button on each line to delete it. You can edit an item's text by clicking the pencil icon (✏️), typing your changes, and clicking the save icon (💾).

Using Your Templates

• Loading Manually: Inside any Card or Cube, you will find a dropdown menu to select one of your saved templates. Click the "Load as New Checklist" button to add a copy of that template to your item.
• Setting Defaults: In this editor, you can set this checklist to be the default for all new Cards created in a specific column, or all new Cubes of a specific type. When you create a new Card or Cube that matches the rule, this checklist will be added automatically.
• Important: Loading a template (manually or by default) always adds a *complete copy*. Changes you make to this new checklist will not affect the original master template. It's a one-way copy, giving you a fresh start every time.

×

Text Template Tutorial

What is a Text Template?

A Text Template is a reusable block of text that you can quickly load into the "Content" section of any Card or Cube. This is extremely useful for maintaining a consistent structure for things like character sheets, location descriptions, or meeting notes.

Creating & Editing Templates

• You can create, edit, and delete templates from the "Text Templates" view, accessible from the main navigation bar (📄 icon).
• Each template has a title (for easy identification) and the main content body.

Using Your Templates

• Loading Manually: Inside any Card or Cube, you will find a "Load Template" dropdown above the main content area. Select a template and click the button to replace the current content with your template.
• Setting Defaults: In this editor, you can set a Text Template as the default for new items. For example, you can make your "Character Sheet" template the default for all new Cubes with the "Character" type. When you create a new Card or Cube that matches the rule, its content area will be pre-filled with your template.
• Note: Loading a template will overwrite any existing text in the content area, so be careful!