8 min read

Your Familiar: The ScryRPG AI Assistant

Your familiar is the ScryRPG AI assistant for your party. Ask it to manage characters, run shops, spawn loot, import content, or search lore, all in natural language.

Last updated: October 21, 2026

What is your familiar?

Your familiar is the AI assistant built into ScryRPG, and it 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 usage rules apply no matter what you call it or how you tune its voice.

The assistant follows the same permissions you 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 have access to. Game Masters and managers can use party tools allowed by their role; ownership-only actions remain restricted. Nothing about the permissions model changes, your familiar just gives you a faster way to drive it.

Your familiar in one sentence

Your familiar works the way you want it to. Keep it as an advisor that answers questions about your campaign, make it a copilot that drafts changes for you to approve, or hand it the books as a co-manager that makes everyday changes for you and checks with you before anything big. You can change its role any time.Every plan includes monthly AI usage for your familiar, imports and art. Paid plans include more, and it resets each month.

Where to find your familiar

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

LocationWhen to Use
Floating widgetA 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” boxA 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 tabA 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 on an assistant page. You do not need two chat panels fighting for the same screen.

Your familiar is also available on Discord. Use /ask message:<request>. Server-channel replies are visible only to you, with conversation context reused for your follow-ups in that channel. The command does not automatically create a thread. Replies in an existing bot-owned private familiar thread stay in that thread; direct messages stay in the DM. See the Discord Bot Guide for the full bot reference.

Personal vs Party Conversations

The shared streaming views below are in the web app. Discord delivery follows the reply rules above.

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.

PersonalParty
Who can see itOnly youEvery party member
Live streamingNo, just youYes, via WebSocket
WhereFloating widget, /assistant pageThe party familiar tab, party home prompt
Best forPrivate planning, solo workLive sessions, shared table talk

Use Both

Most players end up using both. A quick “what’s in my backpack?” goes in the widget. A group decision like “split this loot four ways” goes in the party familiar tab so the whole table sees the math.

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. Conversations without operation records are deleted. Conversations with operation records are archived and removed from the active list, with history retained for billing integrity. Neither outcome reverses changes your familiar made to your campaign.

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

AreaWhat You Can Ask
Your characterRead 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 inventoryAdd items from the marketplace, move items between your containers, give items to other characters, create new containers, and organize gear.
Search and shoppingSearch 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.
IdentificationAsk what the party has learned about an identified item, and check on any mystery items still waiting for identification.
Lore and notesLook up NPCs, locations, factions, and quests the party has encountered, and write new journal entries or session notes. See the Lore Guide.
Activity logAsk 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:

AreaWhat You Can Ask
Spawn loot and currencyDrop 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.
ShopsCreate 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 dropsBuild loot templates, AI-populate them, deploy them to the party as loot piles, set claiming modes, and run Need/Greed voting.
Party managementCreate, rename, and configure parties. Update member roles, remove members, block troublemakers, regenerate join codes, and transfer ownership. See the Party Management Guide.
Item identificationReveal a mystery item to the whole party (with a dramatic animation), or mark an identified item as mysterious again.
Bulk importsKick 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 generationGenerate 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 show how much you have used this month.

Pasting Session Notes

Paste a long block of session notes or a recap into a party conversation and your familiar recognises source material rather than a question. Instead of answering, it shows a handoff card that summarises what it saw and offers Start import, which opens the importer in recap mode with your text in place. Plain prose counts: notes without headings or links are handed off as long as they read like a session recap. See Sessions And Recaps for what happens next.

Choosing how your familiar helps

You pick your familiar’s role in Settings, and you can change it any time. As an advisor, it answers questions about your campaign and changes nothing. As a copilot, it drafts changes and waits for your approval. As a co-manager, it makes everyday changes when you ask and checks with you before anything big.

Usage Limits

Everything AI counts toward your monthly AI usage, including questions you ask your familiar, imports, session audio transcription and generation.

Your familiar’s settings show how much of your monthly allowance you have used, as a percentage. When it runs out, AI features pause until it resets, and every manual tool keeps working.

Higher plans include more monthly AI usage. Patrons can sponsor one party and share their AI usage with its members. Part of it is always kept for the Patron. For current plans and how to upgrade, see the Subscription Guide.

A few things that do not count toward your AI usage:

  • Viewing existing conversations and their history
  • Opening the widget or the Assistant page
  • Declining a pending action

Note

If you hit your limit mid-session and need to keep going, a one-tier upgrade applies immediately. You do not have to wait for the next billing period.

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 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 we do not sell it or use it to train our own AI models. The outside AI providers that power your familiar receive only what a request needs; our privacy policy lists them and what each one does with your content.

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? If an approval card is showing, decline it; otherwise, ask your familiar to fix the change. Then 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 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?