Overview

The ScryMarket Discord bot brings full inventory management to your game server. Add items, check inventory, trade with shops, and claim loot directly from Discord without switching apps mid-session.

Getting Started

Add the Bot to Your Server

1. Visit the Discord Bot page to add the bot to your server
2. Select your server from the dropdown
3. Authorize the requested permissions
4. Start using commands immediately

Link to Web Account (Optional)

If you already have a web account and want to link your Discord:

1. Log in at scrymarket.com/app
2. Go to Profile > Preferences
3. Click Connect Discord

Common Workflows

Starting a Campaign (GM)

1. Create the party: /party create Dragon Slayers
2. Share the join code with your players (shown after creation), or use /party invite to post a formatted invite in the channel
3. Configure settings: Run /party info to set game system, encumbrance mode, and enforcement
4. Deploy shops (optional): Visit scrymarket.com/app to create and deploy shops
5. Create loot (optional): Prepare loot drops on the web dashboard for the first session

Joining a Campaign (Player)

1. Get the join code from your GM
2. Join: /party join ABC123
3. Select or create a character when prompted
4. Check your inventory: /inventory
5. Set your game system: /preferences (used for item searches)

Running a Session

• Add items on the fly: /add Longsword searches the marketplace (use system: to filter by game system)
• Track consumables: /remove Arrow after each shot
• Share loot: /give Healing Potion @Rogue
• Shop at NPCs: /shop to browse deployed shops
• Claim treasure: /loot when the GM reveals drops
• Roll dice: /roll d20+5 for quick checks
• Show off: /show inventory to share publicly in the channel

Between Sessions

• Review inventory: /inventory to plan upgrades
• AI-create custom items: /generate a cloak that turns invisible in moonlight
• Share with others: /share generates a web link to your inventory
• Switch parties: /party switch if you play in multiple campaigns

Inventory & Containers

Viewing Inventory

Command	Description
/inventory	View all items across all containers
/inventory container:<name>	View a specific container
/item <name>	View, edit quantity, move, or delete an item

Adding & Removing Items

Command	Description
/add <item> [qty] [system]	Search marketplace and add items (optional game system filter)
/remove <item> [qty]	Remove items from inventory

Many inventory commands support autocomplete — start typing an item or container name and suggestions will appear. Autocomplete is available for /item, /remove, /inventory container, /show item, /party item, and /party take.

Examples:

/inventory
/inventory container:Backpack
/add Longsword
/add Healing Potion quantity:5
/add Rope system:pathfinder2e
/remove Arrow quantity:10
/item Healing Potion

Containers

Your inventory is organized into containers — bags, pouches, packs, and more.

• Use the dropdown in /inventory to switch between containers or create new ones
• 🎒 Carried containers add to your encumbrance
• 📦 Dropped containers don’t count toward weight/bulk
• Select a container to edit, carry/drop, or delete it

Encumbrance

Your party’s settings determine what’s tracked. The capacity bar shows your current load:

• Yellow — Warning threshold reached (default 75%)
• Red — Overloaded (default 100%)
• If enforcement is ON, you cannot exceed the cap

See GM Setup Guide for encumbrance configuration.

Characters

Creating Characters

Command	Description
/character create <name>	Create a new character

Switching Characters

Command	Description
/character switch	Change your active character

Each character has its own inventory, containers, and encumbrance tracking. Switching characters changes which inventory you see and interact with. Character names support autocomplete — start typing and your characters will appear as suggestions.

Viewing & Editing

Command	Description
/character list	View all your characters
/character view	View character details, stats, and capacity
/character rename <name>	Rename your active character

Party Assignment

Command	Description
/character assign	Assign your active character to a party

• Characters must be assigned to a party to use party features (shops, loot, party inventory)
• You can have different characters in different parties
• When joining a party, you’re prompted to select or create a character

Examples:

/character create Thorin Oakenshield
/character list
/character switch
/character view
/character rename Elara the Bold
/character assign

Party Management

Creating a Party

Command	Description
/party create <name>	Create a new party (you become GM)

After creating a party, you’ll see a setup checklist with your join code and configuration steps.

Joining & Leaving

Command	Description
/party join <code>	Join a party with an invite code
/party leave	Leave your current party

When joining, you’ll be prompted to select an existing character or create a new one for the party.

Switching Parties

Command	Description
/party switch	Switch your active party
/party list	View all parties you’re in

Your active party sets the context for all commands. If you’re in multiple parties, use /party switch to change which one is active.

Party Info & Inventory

Command	Description
/party info	View party details and GM settings
/party inventory	View shared party items
/party item <name>	View a specific party item in detail
/party take <item> [qty]	Take an item from party inventory

GM Commands

Command	Description
/party invite	Post a public join invite in the channel with the join code and a web link
/party kick @user	Remove a player from the party (with option to block from rejoining)
/party disband	Delete the party permanently

All GM commands require confirmation before executing. After kicking a player, you are prompted to block them from rejoining — this prevents the kicked player from using the join code to get back in.

Examples:

/party create Dragon Slayers
/party join ABC123
/party info
/party inventory
/party item Healing Potion
/party take Healing Potion quantity:2
/party switch
/party list
/party invite
/party leave
/party kick @troublemaker
/party disband

Shops & Trading

Browsing Shops (Player)

Command	Description
/shop	View all shops in your party

Select a shop from the dropdown to see its inventory, prices, and available actions.

Buying & Selling

• Buying: Select an item from the shop dropdown, confirm quantity and price
• Selling: Click “Sell My Items” to sell gear from your inventory
• Shops have buy prices (what you pay) and sell prices (what you receive, usually less)
• Your gold is tracked automatically

Deploying Shops (GM)

Shops are created and deployed from the web dashboard:

1. Visit scrymarket.com/app
2. Create a shop template
3. Stock it with items and set pricing
4. Deploy it to your party

Visibility Controls (GM)

• Use /shop in Discord to see all shops (including hidden ones)
• Toggle shops between Revealed (visible to players) and Hidden
• Players can only see and trade with revealed shops
• Reveal shops during sessions for dramatic effect

Loot

Viewing Loot (Player)

Command	Description
/loot	View all loot drops in your party

Select a loot drop to see available items.

Claiming Items

Choose an item from the dropdown to claim it. Claimed items go directly to your inventory.

Creating Loot (GM)

Loot drops are created from the web dashboard:

1. Visit scrymarket.com/app
2. Create a loot instance for your party
3. Add items to the loot drop
4. Reveal it to players during the session

Reveal/Hide Controls (GM)

• Use /loot in Discord to see all loot (including hidden)
• Toggle between Revealed (players can see and claim) and Hidden
• Players can only see and claim from revealed loot drops
• Reveal loot at the right moment for dramatic treasure discovery

Giving & Sharing

Giving Items

Command	Description
/give <item> [qty] @user	Give items directly to another player
/give <item> [qty]	Give items to party inventory (no @user)

• Quantity of -1 gives all of that item
• You can give to players or to the shared party inventory

Showing Off (Public)

Command	Description
/show inventory	Display your inventory publicly in the channel
/show character	Display your character publicly
/show party	Display party info publicly
/show item <name>	Display a specific item publicly

All /show commands post a public message visible to everyone in the channel — use them to share accomplishments, compare gear, or show off rare finds.

Sharing a Link

Command	Description
/share	Generate a shareable web link to your inventory

Anyone with the link can view your inventory in a browser. Useful for sharing outside Discord.

Discovery & AI

Finding Items

Command	Description
/find <search> [system]	Browse item templates from the marketplace

• Results show item details with a dropdown to view or add
• System filter defaults to your party’s game system or your preference
• Available systems: D&D 5e, Pathfinder 2e, Draw Steel, All

AI Item Generation

Command	Description
/generate <description> [system]	AI-create a custom item from a text description

Describe any item in natural language, and AI will generate a fully-statted item template with appropriate weight, value, and properties.

• System defaults to your party’s game system or your preference
• Available systems: D&D 5e, Pathfinder 2e, Draw Steel
• Use system:other with system_name:<name> for unlisted systems

Examples:

/generate a flaming sword that whispers dark secrets
/generate an elven cloak of concealment system:dnd5e
/generate a clockwork puzzle box that opens with the right sequence
/generate a plasma rifle system:other system_name:Starfinder

Preferences

Command	Description
/preferences	Set your default game system for searches

Your preferred system is used as the default filter when searching with /find or /generate.

GM Setup Guide

Game System Selection

Set your party’s game system via /party info. This affects item searches and encumbrance behavior:

System	Description
D&D 5e	Weight + slots encumbrance
Pathfinder 2e	Native Bulk system
Draw Steel	Encumbrance optional

Encumbrance Mode Comparison

Mode	Tracks	Best For
Weight	Pounds (lbs)	D&D 5e traditional
Slots	Inventory slot count	OSR, Knave, slot-based
Both	Weight AND slots	Rich optimization gameplay
Bulk	PF2e Bulk (L + B)	Pathfinder 2e
None	Nothing	Narrative games (Fate, etc.)

Change encumbrance mode via the dropdown in /party info.

Enforce Limits & Thresholds

Configure these via /party info:

Setting	Default	Description
Enforce Limits	OFF	When ON, prevents exceeding capacity
Warning Threshold	75%	Capacity bar turns yellow
Overloaded Threshold	100%	Capacity bar turns red

Click the Thresholds button to customize percentages, and toggle Limits: ON/OFF to enable enforcement.

Session Zero Checklist

• Create the party and share the join code
• Have all players run /inventory to create accounts
• Set game system and encumbrance mode
• Toggle enforce limits if desired
• Deploy starting shops from the web dashboard (optional)
• Prepare loot drops for the first session (optional)

Shop & Loot Deployment

1. Visit scrymarket.com/app and navigate to your party
2. Shops: Create a shop template → stock with items → set buy/sell modifiers → deploy to party
3. Loot: Create a loot instance → add treasure items → reveal during the session
4. Control visibility from Discord using /shop and /loot commands

Utilities

Help System

Command	Description
/help	Overview of all commands with topic pointers
/help topic:getting-started	Onboarding walkthrough
/help topic:party	Party creation and management
/help topic:gm-setup	GM settings walkthrough
/help topic:inventory	Items, containers, encumbrance
/help topic:shops	Shopping and selling flow
/help topic:loot	Loot claiming flow
/help topic:characters	Character management
/help topic:trading	Giving items and sharing
/help topic:dice	Dice roller notation and features

Dice Rolling

Command	Description
/roll	Roll d20 (default)
/roll <expression>	Roll any dice expression
/roll <expression> label:<text>	Roll with a description label

Supported notation:

/roll d20               → Single d20
/roll 3d6+2             → Three d6 plus 2
/roll 2d20kh            → Roll 2d20, keep highest (advantage)
/roll 2d20kl            → Roll 2d20, keep lowest (disadvantage)
/roll 4d6kh3            → Roll 4d6, keep highest 3 (ability scores)
/roll 8d6+2d4+5         → Multiple dice types in one roll
/roll 2d6+3*2           → Multiply total (great for crits)
/roll stats             → Roll 4d6 drop lowest, 6 times
/roll 1d20+7 label:Attack Roll    → Label your roll
/roll 2d6+4 label:Longsword Dmg   → Label shows in the result

Features:

• Natural 20s glow green, natural 1s glow red
• Dropped dice are shown with strikethrough
• Every roll result includes a Reroll button so you can re-roll the same expression instantly
• Labels appear in the roll title so everyone in the channel knows what the roll was for

Other Utilities

Command	Description
/share	Get a shareable web link to your inventory
/usage	Check subscription limits, usage, and remaining actions

Troubleshooting

”Character not found”

Your active character may not be set. Run /character switch to select one, or /inventory to auto-create your first character.

”Not in a party”

Party commands require you to be in a party. Either:

• Join an existing party: /party join ABC123
• Create a new party: /party create My Party

”Item not found”

• Check spelling — partial names work: /item heal finds “Healing Potion”
• Try searching the marketplace: /find potion
• Use /generate to AI-create custom items not in the marketplace

Bot Not Responding

1. Check if the bot is online (green status dot)
2. Verify the bot has permissions in the channel
3. Try in a different channel
4. Check our Discord for outage announcements

Encumbrance / Overloaded

• Check your capacity: /inventory shows the capacity bar
• Drop items: /remove to discard, or /give to transfer to party
• Ask your GM to adjust thresholds or disable enforcement via /party info
• Switch encumbrance mode if it doesn’t suit your game

Shop or Loot Not Showing

• Players: The GM may not have opened shops/loot yet. Ask your GM.
• GMs: Make sure shops/loot are deployed to this party from the web dashboard, then use /shop or /loot to toggle visibility.

What’s Next?

• Inventory Guide — Deep dive into containers and encumbrance
• Shops Guide — Deploy automated shops for your party
• Subscription Guide — Understand limits and special programs