Discord Bot Guide

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.

Getting Started

1. Visit the Discord Bot page to add the bot to your server.
2. Select your server and authorize the requested permissions.
3. Run /help for an overview or /inventory to open your inventory.

Your account is created when you start using the bot. To connect an existing web account, open Settings > Connected Accounts 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, /campaign-log, and /encounter require one of the subcommands listed below.

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>
• Create a character: /character action:create opens 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. Use the inventory panel’s controls to manage containers. Your party’s encumbrance settings determine the capacity display and enforcement.

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. 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. GMs and managers can prepare shops in the web app and use the shop panel to manage visibility.

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.

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:Starfinder

Lore 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. Follow any confirmation controls in the reply. Your familiar’s work counts toward your monthly AI usage. Server-channel /ask replies are private to you and do not automatically create a thread.

/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.

Players receive health bands for revealed encounters; GMs and managers receive HP details. Reveal, end, and cancel actions present confirmation controls.

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 Controls

Command	Description
/campaign-log start party:<party>	Bind a managed party’s log to this server channel
/campaign-log move party:<party>	Move the channel binding
/campaign-log stop party:<party>	Disconnect the party’s log
/campaign-log status party:<party>	Inspect the binding and delivery status
/campaign-log events party:<party>	View event settings
/campaign-log event party:<party> type:<event> state:<state>	Change an event preference
/campaign-log quiet state:<state>	Change your global familiar quiet setting
/campaign-log retry party:<party> announcement:<ID>	Request a retry of an exhausted announcement

party: supports autocomplete. The registered type: choice is encounter_revealed (Encounter reveals). Both state: options accept on or off. Start and move run in the server channel that should hold the log.

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:switch or /party action:switch and choose the intended record.
• Item not found: try a partial name with /item name:heal or 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