Documentation

Saga Command Reference

Everything Saga can do, plainly stated. Commands marked with / are slash commands — type / in any Discord channel to see them. Prefix commands use !.

Introduction

Saga is a Discord bot built for play-by-post roleplay servers. Instead of giving every location its own channel, Saga organises your world into zones and locations. Each zone is a single Discord channel. Locations live inside Saga — and every scene gets its own thread inside that zone channel.

The result: a clean channel list, a deep world, and a live board in every zone that tells your players exactly where the action is.

Core Concepts

Zones

A zone is a broad area of your world — a district, a quarter, a region. Each zone is linked to one Discord channel. That channel holds the zone board (a pinned list of active scenes) and all scene threads for that zone.

Locations

Locations are the specific places within a zone — the tavern, the market stall, the alley behind the smithy. They don't get their own channels; they exist inside Saga and are chosen when starting a scene.

Scenes

A scene is a roleplay session at a specific location. When a player starts one, Saga opens a Discord thread inside the zone channel, logs the scene, and pins it to the zone board. When it ends, /scene close archives it cleanly.

Tip: Players can be in multiple scenes at once across different zones. Use /scene my_scenes to track them all.

First-time Setup

After inviting Saga to your server, run the setup wizard to get started:

Permissions needed: Saga requires permission to create and manage threads, read message history, and send messages in your RP channels.

Player Commands

/view Player
Browse the world — every zone and all their locations. Shows which zones have active scenes and how many players are currently engaged. Read-only, no permissions required.

Scene Commands

All scene commands are subcommands of /scene. They must be run inside a zone channel or an active scene thread.

/scene start Player
Start a new scene at a location. Saga opens a thread in the current zone channel, logs the scene to the database, and updates the zone board automatically.
location — The location to set the scene in (chosen from a list of locations in this zone)
name — A title for the scene thread
players — Optional. Mention one or more players to add immediately
nsfw — Optional. Mark the scene as 18+ (thread will be age-restricted)
/scene join Player
Join the active scene in the thread you're currently in. Adds you to the scene's player list and the thread. Must be run inside a scene thread.
/scene add Player
Add one or more players to the scene in the current thread. They'll be added to both the thread and the scene's player list.
players — Mention the players to add
/scene close Player
Close and archive the current scene thread. Marks the scene as inactive, removes it from the zone board, and locks the thread. Must be run inside a scene thread.
/scene my_scenes Player
List every active scene you're currently part of, sorted by zone and location. Returns a private reply only you can see.

Admin Commands

/manage Admin Mod
The main control panel. Add and remove zones and locations, adjust server settings, and manage the world — all from one command. Admins see everything; mods can manage locations only.
section — Optional. Jump straight to zones, locations, settings, or documentation
/setup rp_category Admin
Toggle a Discord category as an RP area. Saga uses this to know which channels are valid zone channels. Run the command again on the same category to remove it. You can have multiple RP categories.
/setup thread_notices Admin
Toggle whether Saga automatically deletes Discord's "started a thread" system messages that appear in zone channels when a scene is created. Keeps your zone channels tidy.
/setup moderators Admin
Set the role that has moderator access to Saga's management commands. Moderators can add and remove locations but cannot manage zones or server-wide settings.
/documentation Player
Show the command reference as a private reply — tailored to your permissions. Admins and mods see admin commands; regular players see player commands only.
/ping Player
Check that Saga is online and responding. Returns current gateway latency as a private reply.

Prefix Commands

!setup wizard Admin
Run the first-time setup wizard. Walks you through configuring your RP category, moderator role, documentation channel, and other preferences step by step. Only needs to be run once — settings can be changed later through /manage.