Skip to main content

Scripts

qbscript

Scripts in Quest Bound are written in QBScript, a light-weight language custom built for TTRPG mechanics that lets you automate rules, compute attribute values, and react to player actions.

You can attach scripts to:

  • Attributes — to compute values from other attributes (e.g. Attack Bonus from Strength and Proficiency)
  • Actions — to run logic when the player uses an action (e.g. attack, cast spell, rest)
  • Items — to run logic when items are equipped, unequipped, or consumed
  • Archetypes — to run logic when an archetype is added or removed from a character (on_add, on_remove)
  • Global — to define shared helper functions used by other scripts
  • Character Loader — runs once per character at creation, before attribute scripts and archetype on_add; one per ruleset (see QBScript Reference)

For full syntax, built-in functions, and how to access character data (Owner, Target, charts, attributes, items), see the QBScript Reference.