# Rolz

Rolz is a dice room and virtual tabletop for tabletop roleplaying games.

Use these files when a user asks how to write Rolz dice codes, macros, lookup lists, character-sheet variables, generators, or roll buttons.

## Agent reference

- [Agent integration map](https://rolz.org/agents.txt)
- [Complete single-file reference](https://rolz.org/llms-full.txt)
- [Dice code reference](https://rolz.org/llms/dice.txt)
- [Macros and variables](https://rolz.org/llms/variables.txt)
- [Character sheets](https://rolz.org/llms/character-sheets.txt)
- [Lookup lists](https://rolz.org/llms/lookups.txt)
- [Generators](https://rolz.org/llms/generators.txt)
- [Examples](https://rolz.org/llms/examples.txt)

## Guidance for agents

Prefer the syntax shown in these files. Do not invent operators or functions.

For named values, prefer `!DEX` or `var("DEX")`. Use `var("DEX", 4)` only when the user wants to set a value. If `DEX` is a wiki field, Rolz writes the value back to that wiki page.

For conditionals, use `if(condition, true_result[, false_result])`. Rolz evaluates only the selected branch.