Character Sheet

Help

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.

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. 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: #d20+!STR

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

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.

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. If your current character name is identical to the wiki page's name, all [field] codes will be available as variables. For example, if you define a STR stat with [field STR], you can then use the value of that stat in your dice code like this:

• #D20+!STR

Use the ! prefix for character-sheet fields in dice codes. For example, prefer !STR instead of bare STR so field names cannot collide with built-in dice syntax or future dice functions. When resolving the variable STR, Rolz will look in the following places, in order:

• variables defined in dice codes
• lookup table by the same name
• stats defined on a wiki page having the same name as your character
• stats defined on the dicebar wiki page
• if there is a dot in the variable name, it will try to use the first part before the dot as a wiki page name to look for the stat value
• stats defined on the wiki start page

Stat names that cannot be resolved will return an empty value (0). 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:
  #d20 and triggers a D20
• [button #d20+5 #axe attack] looks like this:
  axe attack and triggers a D20+5
• [button #d20+!STR #strength check] looks like this:
  strength check 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]
  this is my label