ROLZ

Character Sheet

Your Character
Before you start:
  • Click on the settings icon (which looks like a cog wheel) and set "My Character" to your character name.
  • Go to the room's wiki and create a new page with the same name as your character.
Basic Character Sheet
You can then use the wiki page you created as your character sheet. Besides putting all kinds of text information onto that page, you can also use it to track your character's stats and you can set up buttons which you can click during play in order to trigger dice rolls.
Stats
Editable Fields
To add stat fields to your character sheet, you can use the [field NAME] code, where NAME is the name of the field.
  • For example, the code [field STR] would track your STR attribute.
    It would be an input field that looks like this:
  • If you want your field to carry an informative label, add it in quotes before the field name: [field "Smash!" STR]
    Smash!
  • You can declare a default value for a field: [field "Smash!" STR default=3]
    Smash!
Do this for all important stats. After you save the wiki page, the input fields will be empty initially. You can then fill in the actual values for these attributes.
Some field types have extra controls for common systems:
  • [field "Strength" STR t=5e] stores a D&D 5e ability score and shows its modifier.
  • [field "Weapon Skill" WS t=wh] stores a WFRP-style starting value and advances, and exposes the current percentile value.
  • [field "Advantage" Adv t=adv] shows +/- controls and defaults to the variable name Adv if no name is given.
You can then refer to the field from a [button] element like this:
  • [button #d20+!STR] which looks like this:
Static Fields
If you don't want a stat field to be editable, you can use the const code to define a value that can only be edited by changing the wiki page itself.
  • For example:
    [const STR +3] will be shown as
    STR: +3
Pool Fields
Some roleplaying systems use dice pools, meaning every character has properties that can be used up over time and then replenished. A pool field stores three variables: NAME_full for the full pool, NAME_cur for currently available points, and NAME for points currently in use. Use the ! prefix to reference them in dice codes, for example !ini_cur or !STR_cur.
  • For example, you can define an initiative pool like this:
    [poolfield "Initiative" ini]
    Initiative
  • If you define [poolfield "Strength" STR], the available/current value is referenced as !STR_cur. The full value is !STR_full, and the in-use value is !STR.
Skill Lists
You can add a skill list to your character sheet by using the code [skills], it will look like this:
Several "skill lists" per character sheet are possible if you name them differently. For example, you can use [skills myskills] and [skills myattacks] to have two different lists for skills and attacks.
To give your skill list a custom title, use quotes to declare the title in the code: [skills "My Skills" myskills]
Skill rows are displayed alphabetically by row name. New blank rows stay at the bottom until you name them.
In a skill row's roll-code column, placeholders are replaced before the roll is sent: @0 is the row name, @1 is the visible Value/Bonus column, @2 is the Roll column, and @3 is Notes. For example, D20+!STR+@1 adds your STR field and that row's bonus.
Referencing Stats from Dice Rolls
Use the ! prefix to read character-sheet fields in dice codes. If your character page has [field STR], then !STR reads that field.
  • Example:
Your current character page comes from your room settings. In the table UI, choose it in My Settings. In chat, /char can set your current character name.
When Rolz resolves !STR, it checks personal macros first. If you have a personal macro named STR, it wins over the character-sheet field. Avoid personal macro names that match your stat names.
After personal macros and built-in roll references, Rolz checks room data in this order:
  • a field or const on the current wiki page, when the roll comes from a wiki page
  • a lookup list named STR
  • a page.field value from a specific wiki page
  • a field or const on your current character page
  • a field or const on the dicebar page
  • a field or const on the room start page
  • a matching field or const on another room wiki page
Use page.field to read from a specific wiki page. For example, !goblin.HP reads HP from the goblin page if that page exists.
A missing value returns 0 and adds a not found tag to the roll output.
var("STR") reads the same value as !STR. var("!STR") also works. If STR is a field on your character page, var("STR", 7) writes 7 back to that field. The roll shows an orange write tag with the source page.
If STR is not a wiki field or const, var("STR", 7) creates a command-local value instead. A personal macro named STR still wins over the character field.
Defining Command Buttons
By adding command buttons to your character sheet, you can trigger your most used rolls just by clicking on them. Use the [button #CODE] code to define a button that triggers a dice code CODE. For example:
  • [button #d20] looks like this:
    and triggers a D20
  • [button #d20+5 #axe attack] looks like this:
    and triggers a D20+5
  • [button #d20+!STR #strength check] looks like this:
    and triggers a D20+!STR roll using the STR stat defined on your character sheet.
  • by default, buttons have the same label as the comment they contain. If you want to show a different label, put a quoted text in front of the dice code like this:
    [button "this is my label" #d20 #roll d20]