What is your familiar?

Your familiar is the AI assistant built into ScryRPG, and it actually does the work for you. It is not a chatbot that answers questions and points you at the right page. It takes plain-English requests and carries them out. Tell it to heal your character, give a longsword to another player, spawn a loot pile, or deploy a shop, and it does exactly that.

You can name your familiar and choose its personality and temperament, so it feels like part of your table. That personalization is expression only: it changes how your familiar reads, not what it is allowed to do. The same permissions, confirmations, and AI credit costs apply no matter what you call it or how you tune its voice.

The assistant follows the same permissions you already use from the web and Discord. Anything you are allowed to do yourself, your familiar can do on your behalf. Anything you are not allowed to do, it refuses. Players can only manage their own characters and the containers they already have access to. Game Masters get the full GM toolkit. Nothing about the permissions model changes, your familiar just gives you a faster way to drive it.

Where to find your familiar

Your familiar shows up in four places across the web app. Use whichever is closest to what you are already doing.

Location	When to Use
Floating widget	A sparkle button in the lower-right corner of most pages. Click to open a compact chat panel. Best for quick requests while you are working inside another page.
Full Assistant page (/assistant)	A dedicated page with a conversation sidebar, chat area, and action history. Best for longer sessions or for managing your private conversations.
Party home “Ask your familiar” box	A small prompt input on your party home. Type a question or use a quick prompt (“Recap last session”, “Active quests”) and it jumps you straight into the party familiar tab with your prompt ready to send.
The party familiar tab	A full assistant page scoped to a single party, shared with all members of that party. Accessible from the party sidebar.

The floating widget hides itself whenever you are already on an assistant page. You do not need two chat panels fighting for the same screen.

Your familiar is also available on Discord. Run /ask in any server where the ScryRPG bot is installed and your familiar responds directly in the channel. If you are in a guild channel, the bot automatically spins up a thread so follow-up questions stay organized. See the Discord Bot Guide for the full bot reference.

Personal vs Party Conversations

Your familiar has two flavors of conversation, and the distinction matters.

Personal conversations are private to you. Nobody else (not your GM, not your party members) can see them. Use these for anything you want help with on your own time: planning a build, updating your character sheet between sessions, browsing the marketplace, or asking “what does this item do?” questions. Personal conversations live in the floating widget and on the /assistant page.

Party conversations are shared with everyone in the party and stream live over WebSocket. What one player asks, the whole party sees. Messages appear on every member’s screen in real time, along with your familiar’s response. This is the tool you reach for during a live session. The GM can narrate an encounter while the whole table watches your familiar resolve the bookkeeping.

	Personal	Party
Who can see it	Only you	Every party member
Live streaming	No, just you	Yes, via WebSocket
Where	Floating widget, /assistant page	The party familiar tab, party home prompt
Best for	Private planning, solo work	Live sessions, shared table talk

Conversation Management

Your familiar keeps full conversation history so you can pick up where you left off. Every message it sends and every tool it runs is saved under the conversation that produced it.

• New conversation: Click the “New conversation” button to start a fresh thread. Good for switching topics so your familiar does not get confused between “help me build a character” and “spawn loot for tonight’s encounter”.
• Rename: Conversations get auto-titled from the first message, but you can rename them to anything that makes sense to you.
• Switch: Click any conversation in the sidebar to load it. Your messages, your familiar’s responses, and the full action history all come back exactly as they were.
• Delete: Remove a conversation you are finished with. Deletion is permanent and does not remove the actual changes your familiar made (your inventory, characters, and party are untouched); it only removes the chat log.

Party conversations are shared across all members, so any party member can start a new one, and the whole party gets the list. Personal conversations stay with you.

What your familiar can do

Your familiar covers almost every routine action in ScryRPG. Rather than enumerate every tool (there are nearly thirty of them), here is the grouped breakdown.

For Players

Area	What You Can Ask
Your character	Read or update stats, HP, AC, ability scores, spells, and skills, all validated per game system. Keep character notes for features, invocations, and session events. See the Characters Guide.
Your inventory	Add items from the marketplace, move items between your containers, give items to other characters, create new containers, and organize gear.
Search and shopping	Search the marketplace for items, shops, and loot templates. Browse by category, rarity, tags, or value. Generate custom items with AI. Buy from any shop your GM has deployed.
Identification	Ask what the party has learned about an identified item, and check on any mystery items still waiting for identification.
Lore and notes	Look up NPCs, locations, factions, and quests the party has encountered, and write new journal entries or session notes. See the Lore Guide.
Activity log	Ask who gave what to whom, what was purchased last session, or when an item was claimed. Your familiar reads the same transaction history the app exposes on the activity page.

For Game Masters

Everything players can do, plus:

Area	What You Can Ask
Spawn loot and currency	Drop items or gold directly into any container, any character’s inventory, or every party member at once. Use this for encounter rewards, quest payouts, or correcting bookkeeping mid-session.
Shops	Create shop templates, AI-populate their inventory, fork existing marketplace shops, and deploy shops to the party. Restock, close, hide, or reveal a live shop at any time.
Loot drops	Build loot templates, AI-populate them, deploy them to the party as loot piles, set claiming modes, and run Need/Greed voting.
Party management	Create, rename, and configure parties. Update member roles, remove members, block troublemakers, regenerate join codes, and transfer ownership. See the Party Management Guide.
Item identification	Reveal a mystery item to the whole party (with a dramatic animation), or mark an already-identified item as mysterious again.
Bulk imports	Kick off the import pipeline on a PDF, homebrew bundle, campaign document, or reviewed session transcript and let your familiar drive the extraction and review workflow. See the Import Guide.
AI generation	Generate a custom item from a description, generate art for an item, shop, or loot template, and AI-curate a shop or loot template’s contents.

Your familiar can also check your subscription’s current usage at any time. Just ask “how much AI usage do I have left this month?” and it will pull the real numbers.

Confirmation & Safety

Your familiar never silently changes important data. Before it runs any action that creates, modifies, transfers, or deletes something, it shows a confirmation card with:

• A plain-English description of exactly what it is about to do
• A clear “Confirm” button to proceed
• A “Cancel” button to back out
• A distinct red border and “This action cannot be undone” warning on destructive operations (deletes, unrecoverable transfers)

You can take as long as you want to decide. Your familiar will wait. If you cancel, nothing happens and you can keep chatting. On Discord, the confirmation shows up as Confirm and Cancel buttons on the bot’s reply.

Read-only actions (searching the marketplace, checking character stats, listing party inventories, looking up lore) do not require confirmation. Your familiar runs those immediately and shows you the results.

Usage Limits

Working with your familiar splits into two kinds of help:

• Read-only help covers questions, prep, and campaign reasoning, such as “what’s in my backpack?”, “recap last session”, or “what do we know about the Ashen Chancellor?”. This is included across plans with fair-use protection.
• Heavier work covers approved changes to your campaign (inventory, characters, lore), imports, session audio transcription, and generation. This draws from your monthly AI credit pool.

The usage meter shows your current AI credit balance for the billing period. When you run low, your familiar will tell you. When the pool is empty, heavier work waits until your allowance resets or your plan changes; read-only help remains available under fair-use protections.

Higher subscription tiers get larger monthly AI credit pools. Patron also includes One for All sponsorship, which lets eligible members of one sponsored party draw AI credit usage from the Patron pool. For the current numbers and how to upgrade, see the Subscription Guide.

A few things that do not count against your AI credit allowance:

• Viewing existing conversations and their history
• Opening the widget or the Assistant page
• Clicking Confirm or Cancel on a pending action (the underlying tool call is part of the request that created it)

Example Prompts

The best way to learn your familiar is to watch what other people ask it. Here are prompts that work well, grouped by role.

Player Prompts

I just took 12 damage, update my HP

Give my spare longsword to Kaelen

What potions does the party currently have?

Remind me what we know about the Ashen Chancellor

Add a Cloak of Elvenkind to my backpack

Who's carrying the rope of climbing right now?

Game Master Prompts

Spawn a loot pile of mid-tier magic items for 5 players

Create a blacksmith shop with standard PHB gear and deploy it to the party

Who's closest to carrying capacity?

Import this homebrew PDF I just uploaded

Give every party member 150 gold for the quest reward

Reveal the mysterious amulet to the party with the dramatic animation

Your familiar handles ambiguity gracefully. If you ask for “a sword” and there are five possible matches, it will show you the options and ask which one you meant. If you ask for something it cannot do (edit another user’s private content, peek at a party you are not in), it will explain why and stop.

Privacy & Data Scope

Your familiar only sees what you already have access to:

• Your account: username, subscription tier, preferences
• Your characters: stats, notes, and inventories for characters you own
• Your parties: every party you are a member of, its members, shared containers, shops, loot, and lore
• The marketplace: public item, shop, and loot templates available to everyone
• Your private content: your item templates, collections, and personal notes

Your familiar cannot see other parties you are not in, other users’ private templates or characters, anyone’s billing information, or any data outside ScryRPG. In a party conversation, its context is scoped to that party. In a personal conversation, it is scoped to your own content plus any parties you belong to.

Chat history is stored on ScryRPG’s servers so you can come back to it later. It is not shared outside your party conversations and is not used to train any AI models.

Common Questions

Does my familiar replace the normal UI? No. Every action it takes corresponds to something you can still do by hand through the web app or Discord bot. Your familiar is a faster path, not the only path.

Can I undo something my familiar did? Most actions can be reversed by asking it to do the opposite (“move that sword back to Kaelen’s backpack”). Destructive actions (deletes, claimed loot, purchases) are not always reversible, which is why your familiar flags them with a red border before running.

What if my familiar misunderstands what I asked? Cancel the confirmation, rephrase, and try again. Your familiar takes context from the conversation, so clarifying in a follow-up usually works. If it still gets it wrong, starting a new conversation gives it a clean slate.

Can players use their familiar to cheat? No. Your familiar respects the same permissions as the rest of the app. A player cannot use it to spawn items, give themselves gold, or edit another player’s character.

Does the GM see what players ask in personal conversations? No. Personal conversations are private. Only party conversations are visible to the whole party, and those are clearly marked in the UI.

What happens if my familiar is offline or slow? The rest of ScryRPG keeps working. Inventory, shops, loot, and party management are unaffected. Your familiar is an additional way to drive the app, not a dependency.

Can I see a log of what my familiar has actually done? Yes. The Assistant page shows an action history alongside each conversation, and all inventory and party changes also appear in the usual transaction log on the party’s activity page.

What’s Next?

• Characters Guide: Character fields, stats, and party assignment
• Party Management Guide: Roles, invites, and shared inventory
• Lore Guide: NPCs, locations, factions, and the party wiki
• Import Guide: Bulk importing homebrew and campaign documents
• Subscription Guide: Usage allowances and tier upgrades
• Discord Bot Guide: Command reference including /ask