A character sheet is a wiki page that Rolz uses as your current character. The selection is saved separately for each room.

• Open My Settings and use the My Character menu to select a wiki page.
• In Table mode, use the Create button beside the menu to create and select a new page.
• You can also create a page in the room wiki. Edit the page and set its page type to Character to identify its purpose.

The page does not have to match your nickname or character name. The selected page controls which fields Rolz reads for your dice codes. The Character page type is descriptive. The My Character selection activates the page as your character sheet. Use [field NAME] to add an editable field. NAME is also the variable name for dice codes.

• [field STR] creates a field named STR:
  
• [field "Strength" STR] adds a visible label:
  
  Strength
• [field "Strength" STR default=3] sets an initial value:
  
  Strength

Rolz saves a field when you change it. A basic field is empty until you enter a value, unless it has a default. Use [text] for longer text such as feats, equipment, or notes. Rolz renders the saved text as safe Markdown.

• [text "Feats" feat1] creates a multiline field named feat1:
  
  Feats

  Save feat1

Some field types add controls or calculations.

• [field "Strength" STR t=5e] stores a D&D 5e ability score and a miscellaneous modifier. STR contains the calculated ability modifier.
• [field "Weapon Skill" WS t=wh] stores a WFRP starting value and modifier. WS contains their total.
• [field "Advantage" Adv t=adv] adds plus and minus controls.

Use [const NAME VALUE] for a value that users can change only by editing the page source.

• [const STR +3] appears as:
  
  STR: +3

Read a const with the same syntax as an editable field, such as !STR or var("STR"). Use [poolfield] for a resource that characters can spend and restore.

• [poolfield "Initiative" ini] appears as:
  
  Initiative

A pool named ini stores these values:

• !ini_full is the full pool.
• !ini_cur is the available amount.
• !ini is the amount currently in use.

The controls can reset the available amount, spend one point, spend all points with Shift, and clear the in-use amount. Use [skills] to add an editable skill list. Name each list if the page has more than one:

• [skills myskills]
• [skills myattacks]
• [skills "My Skills" myskills] adds a visible title.

Rolz sorts named rows alphabetically. New blank rows stay at the bottom until you name them. A skill row can use these placeholders in its roll-code column:

• @0 is the row name.
• @1 is the visible value or bonus.
• @2 is the roll code.
• @3 is the notes field.

For example, D20+!STR+@1 adds the selected character page STR value and the skill-row bonus. Use !NAME or var("NAME") to read a field from your selected character page.

• strength check
• strength check

Use page.field to read a value from a specific room wiki page. Page names and field names ignore case. Use the page's actual name, not its URL encoding. A plus sign in a URL can represent a space. Check the page name before copying a URL slug into a reference.

• var("goblin.HP") reads HP from a page named goblin.
• Read Goblin HP

Use a read-only button when you want to display a value on demand. Use var("PAGE.FIELD") when a page name contains spaces. For example, var("Goblin King.STR") reads STR from Goblin King. Use !PAGE.FIELD only for names made of letters, digits, and underscores. A plus or minus sign is an arithmetic operator in that shorthand, not part of the page name. Use the quoted var() form for other names. To read values from several pages with one click, separate complete expressions with semicolons. This button returns each original value separately:

• Read both HP values

Do not add a die or another number to display a value. That would change the value. A missing value returns 0. The roll output also shows a not-found tag. Personal macros take precedence over character fields. Avoid macro names that match field names. When a roll comes from a wiki page, fields on that page take precedence over fields on the selected character page. Lookup lists also resolve before selected-character fields. Use page.field when you need an exact page. The /char command sets the older character-name preference. A page selected in My Character takes precedence over that name. Use var("NAME", VALUE) to update an existing field or const.

• var("HP", 12) updates HP on the current or selected character page.
• var("goblin.HP", 0) updates HP on the goblin page.
• var("Adv", var("Adv") + 1) adds one to Adv.

Rolz writes the value only when the field exists and you can edit its page. Otherwise, Rolz creates a value that lasts only for the current command. The roll output identifies field reads and writes. Move the pointer over a tag to see the source page. Use [button] to add common rolls or commands to a character sheet.

• [button #d20] creates:
  #d20
• [button #d20+5 #axe attack] creates:
  axe attack
• [button #d20+!STR #strength check] uses the selected character page STR field:
  strength check

By default, a roll comment supplies the button label. Put a quoted label before the dice code to set a different label.

• [button "Roll strength" #d20+!STR #strength check] creates:
  Roll strength