Skip to content
Familiar
Install
DiscordManage subscriptionStart your free trialInstall in Foundry

Capabilities

Everything the AI you connect can do in Foundry

220 tools across 25 domains, all on the DM's side of the table: the rules, the dice, the monsters, every NPC. You bring the adventure; Familiar runs it.

Your AI never spends its context on all 220 descriptions. Most clients read a tool's full description only the first time it is called; the rest start with a curated set. The built-in chat loads a domain's tools when the conversation reaches for them.

The rules engine is D&D 5e (2024) only: the Combat AI card below, the initiative roll, the party rest, the XP award, levelling a character up, and spell resolution. Everything else on this page runs on the system your world already uses. See what runs on your system

Combat & rules

Initiative, attacks, spells, damage, conditions. The mechanics that have to be exact, handled by Foundry's own dice and rules instead of an AI guessing. The engine behind them is D&D 5e (2024).

Combat & initiative

Run the whole encounter from the chat box. Roll initiative, take turns, apply damage and conditions, rest the party, and hand out XP, all without reaching for the tracker by hand. Click past a turn by accident and it steps the tracker back.

  • Start combat, roll initiative for everyone, and play battle music.
  • The fireball catches the three goblins on the left. Roll their saves and apply the damage.
  • Give the party a long rest and split 450 XP between them.
All 20 tools
  • Start an encounter · every token on the scene joins the tracker
  • Start the encounter with initiative rolled
  • End the encounter and clear the tracker
  • Check the tracker · whose turn it is, initiative, HP, and who is down
  • Roll initiative and sort the turn order
  • Roll initiative for the monsters only · players still roll their own
  • Advance to the next turn
  • Move to the next round
  • Step back to the previous turn · inside the round, and nothing that turn resolved is undone
  • Jump the tracker to a combatant's turn · within the current round, skipping the turns between
  • Drop reinforcements into a live fight
  • Pull a combatant out · fled, banished, or gone
  • Set or clear the defeated marker · up to 50 at once, no HP or conditions touched
  • Set or clear a condition on a token · prone, poisoned, blinded
  • Apply one condition to a whole group at once
  • List the conditions your system supports
  • Apply damage to a group · temporary HP absorbed automatically
  • Heal the party or one character · capped at max HP
  • Run a short or long rest · HP, slots, and resources restored
  • Award XP, split evenly across the party
Running combat with AI

Combat AI

Hand the monsters' turns to the AI when you want a break from running them. It reads the battlefield and resolves the attack under real 5e (2024) rules. Reactions like Shield and Counterspell fire on their own. You stay the DM.

  • Run the ogre's turn: pick the best target and attack.
  • It's the lich's turn. Play it tactically.
  • Roll a death save for the downed fighter.
All 16 tools
  • Read the battlefield for a turn · who is up, everyone's HP and position, what they can do
  • Rank where a creature could move · cover and opportunity-attack risk weighed
  • Check who is caught in an area of effect · cone, line, circle, cube, ray, or cylinder, before it fires
  • List the recent combat actions · newest first, the last one is undoable
  • Resolve a creature's weapon attack · rolls against AC, doubles the crit dice, applies damage
  • Cast a creature's spell · spends the slot, rolls saves, tracks concentration
  • Resolve a full multiattack · every swing in one step
  • Resolve a grapple or shove · STR or DEX save, then Grappled or Prone
  • Activate a class feature or feat by name · Rage, Action Surge, Wild Shape
  • Move a creature on its turn · walk speed enforced
  • Take the Dash, Dodge, or Disengage action
  • Spend a legendary action between turns · charges tracked and recharged
  • Force a saving throw against a DC
  • Roll an ability or skill check against a DC
  • Roll a death save for a downed creature · the running count carries between rolls
  • Undo the last combat action · HP, slots, and effects rolled back
Running combat with AI

Active effects

Buffs, curses, and conditions that keep track of themselves. Add an effect with a timer and it ticks down on its own, so nobody forgets the blessing wore off three rounds ago.

  • Bless the front line for the next minute.
  • Give the boss resistance to fire until the end of the fight.
All 5 tools
  • List the effects on a character · buffs, debuffs, and spell effects
  • Look up one effect in full · what it changes and how long it lasts
  • Add a custom effect to a character · with an optional timer
  • Change an effect or toggle it on and off
  • Remove an effect from a character

Dice

One tool, every roll. Familiar parses any dice expression through Foundry, so the result is real and the maths is always right. No AI inventing a number.

  • Roll 4d6 keep highest three, six times, for stats.
  • Roll a d20 with advantage plus 7.
The tool
  • Roll any dice expression and post it to chat · advantage, keep-highest, and modifiers parsed

Characters & the party

Familiar brings no content of its own here. It works from what is installed in your world, so a book counts only once its compendium pack is in Foundry, not once it is on your shelf.

Characters & actors

Create, inspect, and update every PC and NPC at the table. Every edit writes to the real Foundry actor, not to a note in the chat log. Next session it is still there.

  • Make an NPC blacksmith and give the rogue access to him.
  • Level up Mira's wizard to 5 and add the new spell slots.
  • Show me the fighter's sheet.
All 17 tools
  • Pull up a full character sheet · abilities, HP, AC, items, spells, effects; more on request
  • List the world's actors · filtered to the PCs or the NPCs
  • List the player characters · in summary or in full detail
  • Create a blank character or NPC from scratch
  • Clone a character · items, spells, and features come with it
  • Delete a character and its items for good
  • Update a character's sheet · its HP, ability scores, spell slots, and more
  • Rename a character · its token name changes to match
  • Level up a class · HP and slots updated; locked while Advancement is open
  • Search a character's sheet · inventory, spells, and features
  • Look up one entry on a character in full · an item, a spell, or a feature
  • Update an item on a character · its level or whether it is equipped
  • Import an item or spell from a compendium · onto the sheet; refused while its Advancement window is open
  • Remove items from a character for good · spells and features too
  • Give a player access to a character
  • Take a player's access to a character away
  • Pin an NPC to keep it answering in table chat · when Any NPC is off; pin a PC and it answers to its name too
Writing characters the AI can play

Items & loot

The loot and gear that lives in your world, not on a sheet yet. Hand a piece to a character and it becomes part of that sheet, where the character tools take over.

  • Create a flame tongue longsword for the hoard.
  • Find every potion in the world.
All 6 tools
  • List the loose items in your world · filter by type or folder
  • Search loose world items · by name or description text
  • Look up a world item in full · type, description, and properties
  • Create a world item · a weapon, a spell, gear, or a consumable
  • Update a world item · its name, art, or properties
  • Delete a world item for good

Compendium & rules

Reach into the books you already own, or build a pack of your own. Ask for a stat block and it comes back as plain text, so you get the numbers you need without breaking the scene to dig through packs. Push a finished NPC into that pack and it is there the next time you need it.

  • Spawn two wolves from the monster compendium near the forest edge.
  • Look up the stat block for an owlbear.
  • Make a homebrew pack and export my custom items into it.
All 7 tools
  • Search your compendia · monsters, items, spells, journal entries
  • Pull a full stat block from a compendium · spells and items too, all as plain text
  • List every compendium pack · with its type and which system it came from
  • Spawn a monster or NPC from a compendium · it arrives in the world with its full stat block
  • Create a world compendium pack · it holds one document type
  • Copy a world document into a pack · exporting it again replaces the earlier copy
  • Update an entry in an unlocked pack · the packs your system ships stay locked

Card decks

Cards, if your table runs on them: tarokka, initiative, loot. A dealt card moves out of the deck rather than copying, so what is left in the deck is really what is left.

  • Draw three tarokka cards for the reading.
  • Shuffle the loot deck and deal each player one card.
All 9 tools
  • List every card stack · decks, hands, and piles, with card counts
  • Search card stacks by stack name or card name
  • Look inside a stack · every card and whether it has been drawn
  • Create a new card stack · as a deck, a hand, or a pile
  • Rename a stack or edit its description
  • Delete a stack and all its cards
  • Draw or deal cards from one stack to another
  • Shuffle a deck to randomise the order
  • Recall every dealt card back into the deck

Scenes, canvas & atmosphere

Almost every tool here acts on the scene that is currently active, so the map has to be open first. Walls, lights, sound and trigger zones are Foundry's own layers, and they behave exactly as they would if you had placed them by hand.

Scenes & tokens

Tokens come from the actors already in your world, so a whole ambush goes down in one batch. Delete a scene, though, and its tokens, walls and lights go with it.

  • Switch to the throne room and pull everyone there.
  • Place the four bandits behind the crates and hide them.
  • Drop the darkness to twilight and start light rain.
All 20 tools
  • Look at the active scene · size, grid, darkness, every token's position and HP
  • Look up any scene by name · size, grid, weather, background, and tokens
  • List your scenes · the active one is marked, and which show in the nav
  • Search your scenes by name
  • Create a blank scene
  • Change a scene · grid, size, background, or navigation
  • Delete a scene and everything on it
  • Switch the active scene · every player is pulled to it
  • Pull named players to another scene · the rest stay put; needs Foundry 13.338 or newer
  • Place tokens from your actors · a whole encounter in one batch
  • Move a token on the map outside combat
  • Change a token · hide, lock, resize, rotate, set disposition
  • Change several tokens at once
  • Remove tokens without deleting the actor
  • Set the scene darkness · daylight, twilight, or pitch black
  • Reset fog of war · the explored map goes dark again
  • List the weather effects you can use
  • Set or clear the weather on the scene · rain, fog, or snow
  • Grab an annotated snapshot of your canvas · with a numbered token legend
  • Pan and zoom the camera to a spot on the map

Canvas environment

Walls, doors, light, and sound: the atmosphere layer that makes a battlemap feel like a place. Map pins live here too, each one linked to the journal entry behind it.

  • Light the braziers along the hall and lock the far door.
  • Add a waterfall sound by the river that gets louder up close.
All 18 tools
  • List the walls on the scene · with what each one blocks
  • Build walls · blocking sight, movement, light, or sound
  • Change a wall or turn it into a door · what it blocks, where its ends sit
  • Remove walls · vision and movement update instantly
  • Open, close, or lock a door
  • Slam every door on the scene shut at once
  • List the lights on the scene · with their colour and radius
  • Place a light · a torch, a lantern, a magical glow, or a patch of darkness
  • Change a light · colour, radius, animation, or position
  • Remove lights
  • List the ambient sounds placed on the scene
  • Drop a positional sound · a waterfall or tavern din that grows as you near it
  • Move a sound or change its volume and reach
  • Remove ambient sounds
  • List the map pins and what they link to
  • Pin a note on the map · linked to a journal entry
  • Move a map pin · change its label or relink it to another entry
  • Remove map pins

Canvas drawing

A tile can sit above the tokens, which is what keeps a roof over a building until you lift it. Drawings do less. They mark the map and leave the rules alone.

  • Circle the 20-foot blast where the fireball lands.
  • Lay a roof tile over the cabin so the inside stays hidden.
All 8 tools
  • List the tiles on the scene
  • Drop a tile image · decoration, an overlay, or a roof over the room
  • Move or resize a tile · restyle it or swap its image
  • Remove tiles from the scene
  • List the drawings on the scene
  • Draw a shape to mark the map · a rectangle or an ellipse
  • Move or resize a drawing · recolour it or change its text
  • Remove drawings

Trigger regions

You draw the zone once and Foundry keeps watch from then on, firing the behaviour whenever a token trips it. Nobody has to remember it mid-fight. A zone can stay hidden or show on the map, so the players can see what they are walking into.

  • Make the lava floor deal damage to anything standing in it.
  • Set a zone by the door that starts combat when the party steps through.
All 5 tools
  • List the trigger zones on the scene
  • Look up a zone · its shape and what it does
  • Draw a trigger zone · it fires when a token enters, leaves, or moves inside
  • Change a zone · its shape, what it triggers, or whether players see it
  • Remove trigger zones

Sound, voice & images

The voices and the art run on your own provider keys, one for text-to-speech and one for images. The music needs neither. It runs the playlists in your Foundry world.

Audio & playlists

Run the soundtrack without touching the sidebar. Volume, crossfade, playback order, and a single stop that catches every sound at once.

  • Cue the tavern playlist and fade a soft lute track underneath.
  • Cut all the music. The scene just went silent.
  • Move the music to the forest at night; we just left the tavern.
All 16 tools
  • List your playlists · with their tracks and what's playing now
  • Search playlists by name or track
  • Look inside a playlist · every track, its volume, and its fade
  • Create a playlist · set to play in order, shuffled, or all at once
  • Rename a playlist or change how it plays
  • Delete a playlist and its tracks
  • Start a playlist
  • Stop a playlist
  • Cut every playing sound at once
  • Play a single track
  • Stop one track and leave the rest playing
  • Add a track to a playlist · from your Foundry files or a URL
  • Change a track's volume · or its loop and fade settings
  • Remove a track from a playlist
  • Find a mood in your own playlists · Tavern or Forest Night, from your world's own tracks
  • Crossfade to a mood and bind it to the scene · Foundry re-cues it; on Automatic, one switch a minute
Music and ambience

Voice generation

Give every NPC its own voice. Familiar speaks their lines aloud through your text-to-speech provider and remembers who sounds like whom, so the innkeeper always sounds like the innkeeper. A generated sound effect bills your voice key, or your image key alone.

  • Have the innkeeper warn the party about the road, in his voice.
  • Read this tavern scene aloud, a different voice for each speaker.
  • Cast a gruff older Scotsman for Angus.
All 8 tools
  • Speak a line aloud in a character's voice · pick the voice model per take; long text plays as one clip
  • Voice a whole back-and-forth scene · a voice per character, one AI Voice card for the whole take
  • Give a character or NPC a fixed voice
  • Check which voice a character is using
  • Search the voice catalogue to cast from · by gender, language, or a word in the name
  • Play a sound effect the narration named · your SFX playlist first, generated only when nothing matches
  • Play a narration you held for your go · GM and players start together if broadcast was on at hold
  • Drop a held narration without playing it · held clips also expire after ten minutes
Voice and sound

Image generation

Portraits, items, and concept art, generated inline in chat mid-session.

  • Make a portrait for the hooded stranger at the bar.
  • Draw the cursed amulet they just found.
All 3 tools
  • Generate an image in chat · portraits, items, concept art; edits where your provider can
  • Generate an actor's portrait or token art · written straight onto the character, background cut out where your provider supports it, and tokens already on the scene follow
  • Generate an item's icon · written straight onto the item

Scene generator

Describe the place and get a battlemap for it. Familiar generates the background art from a prompt, image only, so you still own the walls and tokens. Ask for a few options and the built-in chat lays them out to pick from.

  • Generate a foggy graveyard battlemap, give me three options.
  • Use the second one as the scene background.
All 2 tools
  • Generate a battlemap background image · from a text prompt
  • Set one of the generated maps as the scene

Story, memory & your table

Everything here runs on the world you already built, with two exceptions. Ember events need the Ember module, and the vault tools need Obsidian running with its Local REST API plugin installed.

Journals & notes

The campaign's written record, searchable and editable from chat. Pull up the quest the duke gave you, jot down what the party promised, or read the lore page back before the reveal.

  • What did the party promise the duke last session?
  • Add a journal page with the riddle carved on the vault door.
All 10 tools
  • List your journals · with their page names and folder paths
  • Search journal titles and page text · each hit comes back with a snippet
  • Read a whole journal entry as plain text
  • Read a single journal page
  • Create a journal entry · starting pages are optional
  • Add a page to a journal · text, image, video, or PDF
  • Rename a journal entry
  • Rewrite a journal page
  • Delete a journal and all its pages
  • Delete one page from a journal
Prepping a published adventure for AI

Knowledge & memory

A memory that carries the campaign between sessions. It reads and runs the story you bring; it doesn't invent one.

  • Remember that the party still owes the blacksmith for the armour.
  • What do we know about the Ashen Crown so far?
All 6 tools
  • Search the whole campaign by keyword · journals, characters, scenes, items, and transcripts
  • Pull up what Familiar remembers · the campaign facts that survive between sessions
  • Save a story fact to memory · it comes back in later sessions on its own
  • Save a whole session of facts at once · up to 20 in one call
  • Correct a remembered fact
  • Retire a fact you no longer need · kept in history rather than erased
Staying consistent across sessions

Notes vault

Your Obsidian notes, readable from the table. Familiar opens the vault through Obsidian's Local REST API plugin and never writes back. An optional folder allowlist narrows what it can reach.

  • Read my prep notes for tonight and remind me where we stopped.
  • Search my vault for everything I wrote about the smuggler ring.
All 4 tools
  • List the notes in your vault · one folder, or the whole tree beneath it
  • Read one note as raw markdown · tags and wikilinks come back exactly as you wrote them
  • Search the whole vault for a phrase · each hit comes back with the lines around it
  • List your vault tags by usage · unavailable once you set a folder allowlist
Keeping your prep in Obsidian

Rollable tables

Random encounters, loot drops, wild magic, anything you roll on a table. Familiar builds the table, rolls it, and reads the result back.

  • Roll on the random encounter table for the swamp.
  • Build a loot table for the bandit camp and roll it twice.
All 7 tools
  • List your rollable tables · dice formula and how many results each one holds
  • Search rollable tables by name or text
  • Look up a table in full · its dice formula and every result on it
  • Roll on a table and post the result
  • Build a table with weighted or ranged results
  • Change a table · its name, formula, or draw mode
  • Delete a rollable table

Macros

The shortcuts you already built, run by name. Familiar writes new chat macros too, though script macros stay yours to write.

  • Run my 'roll group stealth' macro.
  • Make a chat macro that posts the tavern menu.
All 7 tools
  • List your macros · with a preview of the command each one runs
  • Read a macro in full
  • Search macros by name or command
  • Run a macro by name
  • Create a chat macro
  • Change a macro · its name, command, or icon
  • Delete a macro

Folders

Campaigns outgrow their first layout. Keep yours tidy without dragging things around the sidebar by hand.

  • Make a 'Chapter 3' folder and move every Stormpoint scene into it.
  • Colour all the boss-fight folders red.
All 5 tools
  • Show your folder layout at a glance
  • Look inside a folder and everything it holds
  • Create a folder for any document type · scenes, actors, journals, and the rest
  • Change a folder · its name, colour, or where it sits
  • Remove a folder without deleting its contents · everything inside moves up to the parent folder

Ember events

Familiar fires whole scene beats on cue. Begin an event and it switches the scene, spawns the NPCs, cues the music, and opens the journal in one step. Needs the Ember module.

  • Begin the 'Ambush at the bridge' event.
  • Where is the party on the hex map right now?
All 6 tools
  • List your Ember quest events and their status
  • Check an Ember event's status · its step, whether it is running, and its outcomes
  • Begin an Ember event and fire the whole beat
  • Wrap up an Ember event and fire what follows
  • Record the party's choices on an Ember event · for branching storylines
  • Read the party's spot on the Ember hex map · and every hex next to them

World & system

The table's housekeeping. Pause the game, move the in-game clock forward for a long rest, see who's online, or set up an account for the friend joining this week. Familiar's own settings are read and changed from here too.

  • Advance time eight hours for the long rest.
  • Pause the game.
  • Which voice model am I on?
All 10 tools
  • Read your world's basics · game system, Foundry version, and your sound preferences
  • Pause or unpause the game
  • Check the in-game time · counted as elapsed days and hours, not a calendar
  • Advance the in-game clock · for a rest, travel, or a narrative time skip
  • List your players · their roles and who is online
  • Look up one player · and the characters they own
  • Create a new player account
  • List the modules installed in your world · read-only, it cannot install or toggle them
  • Read Familiar's own settings · value, choices, and who may change it; keys as set or not
  • Change one Familiar setting · widening spend or player reach is the GM's call

Chat messages

Speak into the table chat directly. Drop a description, whisper a clue to one player, or read back what was said a few messages ago. It can also hand a check to the player who has to make it. Table Chat is on from the first load, so your players can write to Familiar in that same chat too; switch it off on the Chat tab whenever a name or an answer could give the game away.

  • Whisper to the rogue that she spots a tripwire.
  • Post the tavern menu to the chat.
  • Ask the party for a Perception check and keep the DC to yourself.
All 4 tools
  • Post a chat message · as a whisper, an emote, or formatted text
  • Read back the recent chat log · dice rolls too, with the formula, the dice, and the total
  • Ask a player to make the roll themselves · modifiers applied on D&D 5e; named bare dice elsewhere
  • Read the questions players left for Familiar · the ones Table Chat could not answer on its own

Looking for the method? Read the guides.

Bring your own AI and start playing

Connect the AI you already use, install Familiar from Foundry's package browser, and these tools are live at your table.

Install in FoundryJoin the Discord