Discord bot guide
Command reference for the ScryRPG Discord bot. Manage characters, inventory, shops, loot, lore, spells, and encounters from your game chat.
Last updated: October 25, 2026
Overview
The ScryRPG Discord bot brings your campaign into your game server. Add items, check inventory, trade with shops, claim loot, roll dice, and ask your familiar from the same party record the web app uses.
Session audio starts in the web app
The Discord bot does not record voice sessions. Upload a recording from the web app, review the transcript, and send the approved transcript through Import.
Getting Started
- Visit the Discord Bot page to add the bot to your server.
- Select your server and authorize the requested permissions.
- Run
/helpfor an overview or/inventoryto open your inventory.
The bot creates a Discord-only account the first time you use an account-backed command, such as /inventory. A Discord-only account cannot access the web app until you add and verify a real email. To connect an existing web account, open Settings > Connected in the web app and choose Connect Discord.
Reading the Reference
Type a command in Discord and fill in its named options. In the tables below, <value> is a placeholder and [option:<value>] is optional. Do not type the brackets. Discord’s option picker supplies supported choices and validates lengths and numeric limits.
/party and /character use an action: option. Their actions are not slash-command subcommands. Commands such as /show, /loot, /library, and /encounter require one of the subcommands listed below. /campaign-log appears in the picker but isn’t available yet.
Command views are snapshots. Reopen a command or refresh its panel to fetch current campaign state; messages do not continuously mirror the web app.
Common Workflows
Starting or Joining a Campaign
- Create a party:
/party action:create name:Dragon Slayers - Join with an invite code:
/party action:join code:<invite code> - Open the party overview:
/party - Switch parties:
/party action:switch party:<party>, then choose which of your characters to play when prompted. - Create a character:
/character action:createopens the creation flow. - Switch characters:
/character action:switch character:<character>
Running a Session
- Add gear:
/add item:Longsword - Use a consumable:
/remove item:Arrow - Give an item:
/give item:Healing Potion user:@Rogue - Visit a shop:
/shop - Claim treasure:
/loot browse - Look up a spell:
/spell query:Light - Check the fight:
/encounter show - Share a character card:
/show character
Inventory & Containers
| Command | Description |
|---|---|
/inventory [container:<name>] | Open your inventory or a specific container |
/item name:<name> | Open an item’s details and available actions |
/add item:<search> [quantity:<amount>] [system:<system>] | Search the marketplace and add an item |
/remove item:<item> [quantity:<amount>] | Remove an item from your inventory |
/encumbrance [character:<character>] | Check a character’s carried load and capacity; defaults to your active character |
container:, /item’s name:, /remove’s item:, and /encumbrance’s character: support autocomplete. Open an item and choose its quantity control to set a new total or enter a relative change such as +5 or -2. A zero total deletes the item. If Discord reports that an update could not be confirmed, check /item before trying again. Use the inventory panel’s controls to manage containers. Your party’s encumbrance settings determine the capacity display and enforcement.
/add searches marketplace templates and offers quick-add choices. Its optional quantity: adds that many. The results also include a custom-item option, so you can create an item by hand. You can also set item quantities from the item controls; items do not have to come from shops or loot.
For /add, system: accepts dnd5e, pathfinder2e, drawsteel, daggerheart, or all.
Characters
| Command | Description |
|---|---|
/character [character:<character>] [action:<action>] | Open a character view or an action |
character: supports autocomplete. The registered action: choices are view, switch, create, and list. Omitting action: opens the view. Use the character panel’s controls for editing and party assignment.
/character
/character action:list
/character action:create
/character action:switch character:<character>
/character action:view character:<character>Party Management
| Command | Description |
|---|---|
/party [party:<party>] [action:<action>] [code:<invite code>] [name:<name>] | Open the party overview or a party entry action |
party: accepts a name or ID and supports autocomplete. The registered action: choices are view, create, join, and switch. Use name: with action:create and code: with action:join. Omitting action: opens the overview.
The party panel provides collaboration controls appropriate to your role. If a joined or selected party needs a character assignment, Discord prompts you to choose which character to play there. Party inventory, invitations, settings, and membership actions are panel workflows, not additional registered slash subcommands.
Shops & Trading
| Command | Description |
|---|---|
/shop [shop:<shop ID>] | Browse party shops or open a shop using its panel ID |
Players can browse and trade with revealed shops. Choose items and follow the panel’s buying or selling controls, including any confirmation shown before a purchase. GMs and managers can prepare shops in the web app and use the shop panel to manage visibility. Confirm the prompt before revealing or hiding a shop. Hidden shops remain hidden to players until a GM or manager reveals them.
Loot
| Command | Description |
|---|---|
/loot browse [loot:<loot>] [scope:<destination>] [query:<search>] | Browse and claim deployed loot |
/loot need-greed start loot:<loot> [duration:<choice>] | Start a Need or Greed vote |
/loot need-greed status loot:<loot> | Check a vote |
/loot need-greed resolve loot:<loot> | Resolve remaining items |
/loot need-greed cancel loot:<loot> | Cancel a vote before any item resolves |
loot: supports autocomplete. For browsing, scope: accepts character or party as the claim destination. Choose a voting duration from Discord’s registered duration choices. Management actions depend on your party permissions. Players only see loot revealed to them. Hidden loot stays hidden until a GM or manager reveals it. Need or Greed pauses while the pile is hidden, then can continue after it is revealed.
Prepare loot in the web app, then use the Discord panel to browse, claim, and manage it. See the Loot Guide for distribution methods.
Giving & Sharing
| Command | Description |
|---|---|
/give item:<item> [quantity:<amount>] [user:<user>] | Give an item; omit user: to choose a recipient in the panel |
/show character [character:<character>] | Share a character card publicly |
/show party | Share party information publicly |
/show item name:<name> | Share an item publicly |
/show lore search:<search> | Share a lore card publicly |
/share | Generate a shareable web link to your inventory |
/give item:, /show character character:, /show item name:, and /show lore search: support autocomplete. Public cards respect the backend’s sharing permissions. Use /inventory for your own inventory and /share for its web link.
Discovery & Your Familiar
Items and Spells
| Command | Description |
|---|---|
/find search:<search> [system:<system>] | Search marketplace item templates |
/spell query:<spell> [system:<system>] [level:<level or rank>] | Search compendium spells; query: supports autocomplete |
/generate description:<description> [system:<system>] [system_name:<name>] | Generate a custom item from a description |
For /find, system: accepts dnd5e, pathfinder2e, drawsteel, daggerheart, or all.
For /spell, the registered choices are dnd5e, pathfinder2e, drawsteel, and all. The picker does not offer Daggerheart. Search results depend on the compendium’s available records. The optional integer level: filters by spell level or rank.
For /generate, system: accepts dnd5e, pathfinder2e, drawsteel, daggerheart, or other. Use system_name: with system:other. Generation counts toward your monthly AI usage. See the Subscription Guide for allowances.
/find search:cloak
/spell query:Light
/generate description:a cloak that turns invisible in moonlight
/generate description:a plasma rifle system:other system_name:StarfinderLore and the Table Library
| Command | Description |
|---|---|
/lore [search:<search>] | Browse campaign lore or search by name; supports autocomplete |
/library show | View the table’s content shelf and rules mode |
/library check type:<type> name:<name> | Check whether an item, spell, or creature is on the shelf |
For /library check, type: accepts item, spell, or creature. Library curation happens in the web app.
Your Familiar
| Command | Description |
|---|---|
/ask message:<request> | Ask your familiar a question or request a campaign action |
Ask about the party’s inventory or lore, or describe a change you want. Free rein is on by default. Your familiar asks before deleting or revealing something, changing permissions or membership, changing another player’s character or inventory, using another player’s monthly usage, or making a large change. Follow the confirmation controls in its reply. If a change fails, it rolls back completely. The familiar’s work counts toward your monthly AI usage, shown in /usage as a percentage used and reset monthly. In a server channel, /ask replies are private to you. In a direct message with the bot, replies stay in that DM. In a private Familiar thread, replies are visible in that thread. A party-scoped question can use the optional party: picker where available.
/ask message:What potions does the party have?
/ask message:What do we know about the Ashen Chancellor?Encounters
| Command | Description |
|---|---|
/encounter show | View the active encounter’s initiative order |
/encounter hp combatant:<combatant> value:<current HP> | Set current HP, as GM or manager |
/encounter reveal | Reveal the encounter, as GM or manager |
/encounter hide | Hide the encounter, as GM or manager |
/encounter end [summary:<outcome>] | Finish the encounter, as GM or manager |
/encounter cancel | Discard the encounter without loot or a timeline entry, as GM or manager |
/encounter join initiative:<roll> | Add your character to initiative |
/encounter deploy template:<template> [reveal:<boolean>] [name:<name>] | Deploy an encounter template, as GM or manager |
/encounter start name:<name> [reveal:<boolean>] | Start an ad hoc encounter, as GM or manager |
/encounter add creature [creature:<creature>] [name:<name>] [count:<amount>] | Add reinforcements, as GM or manager |
combatant:, template:, and creature: support autocomplete. value:, initiative:, and count: take integers. reveal: takes true or false. For reinforcements, choose a bestiary creature or provide an inline name.
For /encounter hp, choose a combatant and enter its new current HP in value:. Players receive health bands for revealed encounters; GMs and managers receive HP details. Reveal, end, and cancel actions present confirmation controls. Hidden encounters stay hidden from players until revealed.
GM Setup Guide
Open /party to configure the party through its panel. Set the game system and encumbrance behavior for your table, share an invitation, and prepare shops and loot in the web app. Open /character to manage characters and /encounter show to inspect the active fight.
Campaign Log
Campaign log is unavailable
The campaign log isn’t available yet. The /campaign-log commands reply that it isn’t available, and connected channels don’t receive announcements.
Utilities
Help and Preferences
| Command | Description |
|---|---|
/help [topic:<topic>] | Open the command overview or a topic guide |
/preferences | Open your preference settings |
/usage | Check subscription usage and limits |
The registered help topics are getting-started, party, gm-setup, inventory, shops, loot, characters, trading, and dice.
Dice Rolling
| Command | Description |
|---|---|
/roll [dice:<expression>] [label:<text>] | Roll dice, optionally with a label |
Omit dice: for the default roll or use dice:stats for ability scores. Use /help topic:dice for supported dice notation. The result includes a reroll control.
Troubleshooting
- Wrong character or party: use
/character action:switchor/party action:switchand choose the intended record. - Item not found: try a partial name with
/item name:healor search templates with/find search:potion. - Overloaded: inspect
/encumbrance, manage containers through/inventory, or ask your GM to review the party’s settings. - Missing shop, loot, or encounter: check your active party and ask the GM whether the record is revealed.
- Bot not responding: check its channel permissions, try another channel, and check the community server for outage announcements.
What’s Next?
- Inventory Guide: Containers and encumbrance
- Shops Guide: Prepare shops for your party
- Subscription Guide: Usage and plan allowances