Skip to main content
Documentation

Rulesets & Hosted Rules Docs

A ruleset is a hosted, versioned rules document your organization owns — think of it as a rulebook with numbered chapters. Instead of pasting a Google Doc link into every competition and hoping it never changes underneath you, you publish a specific version and pin competitions to it. Once published, a version is locked forever, so players and Teo (the AI assistant) always see the exact rules that governed an event.

This is a standalone feature — a ruleset doesn't need to be attached to a template, and any competition can pin one directly.

The lifecycle: draft → publish → pin

| Stage | What it means | | ------------- | ------------------------------------------------------------------------------------------------------- | | Draft | Freely editable. Write and revise the content as much as you need. | | Published | Locked. The text and version label can never change again — a correction becomes a new version instead. | | Pinned | A specific published version is attached to a competition. New versions never move an existing pin. |

Create a ruleset

  1. Go to your organization's Rulesets page (linked from your organization's page, or from the Templates page).
  2. Click New ruleset.
  3. Give it a name, a slug (used in its public URL), and an optional description and game system.
  4. Click Create ruleset — you land on its detail page, ready to add your first version.

Write and publish a version

  1. On the ruleset's detail page, click Add version.
  2. Give it a version label (e.g. 1.0 or 2026 Winter), an optional changelog note, and paste your rules text as markdown — this isn't a collaborative editor, so write it wherever you're comfortable (Google Docs, etc.) and paste the final text in.
  3. Click Create draft. You can keep editing a draft — fix typos, rewrite sections — for as long as it stays a draft.
  4. When it's ready, click Publish. Read the confirmation carefully: publishing is one-way. Once published:
    • The content and version label are frozen.
    • The version becomes searchable by Teo, so players can ask rules questions in chat and get an answer sourced from this exact text.
    • It becomes eligible to be pinned to a competition.
  5. Made a mistake after publishing? Don't try to fix it — add a new version instead and note what changed in its changelog.

Pin a ruleset to a competition

  1. Open the competition and go to Manage → Settings.
  2. In the Rules section, choose a published version from the dropdown (only your organization's published versions are offered).
  3. Click Save.

Publishing a newer version later does not move the pin automatically — you decide when to update it, the same way. This keeps a running event stable even while you're drafting the next revision.

Where players see it

  • Every ruleset has a public page at /o/your-org/rules/your-ruleset-slug, showing the latest published version with a version-history switcher for older ones.
  • A competition with a pinned ruleset shows a View Rules link (from its overview page) that opens the exact pinned version at /o/your-org/your-competition/rules.
  • If nothing is pinned, that page falls back to the competition's plain Rules URL (an external link), if one is set.

Related