<p>Friends &amp; Fables is the world's first Generative Text RPG platform. Play through user-created worlds with Franz, our AI Game Master, or build your own with our robust world building tools.</p><p class="nx-mt-6 nx-leading-7 first:nx-mt-0">This is our documentation site! If you're looking to <a target="_blank" rel="noreferrer" class="nx-text-primary-600 nx-underline nx-decoration-from-font [text-underline-position:from-font] link" href="https://www.fables.gg/">play Friends &amp; Fables, you can find the app here<span>(opens in a new tab)</span></a>.</p><p class="nx-mt-6 nx-leading-7 first:nx-mt-0">If you are new to Friends &amp; Fables and looking for some help, you're in the right place! Our <a target="_blank" rel="noopener noreferrer nofollow" class="nx-text-primary-600 nx-underline nx-decoration-from-font [text-underline-position:from-font] link" href="https://help.fables.gg/getting-started">getting started</a> guide is a great place to start.</p><p><span data-name="bulb" data-type="emoji">💡</span></p>

Introduction

Feedback

Roadmap

Changelog

Friends & Fables Home

Calvin (F&F Support)

Will (F&F Dev)

David (F&F Dev)

Campaigns

Campaign Settings

<p>From campaign settings, you can just the language used by the GM in their responses.</p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0193b82d-b330-7964-9b7f-4e1dea3c14c4.png" data-width="100%" data-align="left"><p>Keep in mind that languages other than English have not been fully tested by the developers, so their performance is not ensured.</p>

Language

<h1 id="liym223d1bi" data-toc-id="liym223d1bi">What is a custom instruction?</h1><p>Custom instructions are instructions that you provide to direct the GM to behave differently than the defaults. They are generally used for controlling the way the GM narrates or talks to the party.</p><blockquote><p>For those more technical, custom instructions are a way to provide your own prompt to the messages in the <strong>narration</strong> module.</p></blockquote><callout-component color="Accent"><p>Custom instructions should be used mostly to influence the style of narration. They are not designed to be used to interact with game state or to input lore/knowledge of the world.</p></callout-component><h2 id="ct2etoqcxqt" data-toc-id="ct2etoqcxqt">Custom Instruction GM Modes</h2><p>When creating a custom instruction, you can set which GM mode it’s used in. This allows you to ‘hook’ into a certain GM mode and ensure that the custom instruction will be used when the GM is in that mode. Read our article on ACE-1 to learn more about GM modes.</p><p>For example, if you made a custom instruction with the GM Mode “NPC Dialog”, that custom instruction will be visible to the GM when they’re in a mode focused for NPC dialog.</p><p>If the custom instruction is set to ‘Always’, then the instruction will always be provided to the GM no matter which mode they’re in.</p><h2 id="73eck7alayt" data-toc-id="73eck7alayt">Examples</h2><h3 id="fcmta1z5fmf" data-toc-id="fcmta1z5fmf">Good Examples</h3><p>Good examples are generally focused on one topic and tend to focus on how the GM should respond, narrate, act, or describe things.</p><p>The examples below are exaggerated to show the range of different outputs you can get with differently focused instructions and how you may use them.</p><ol><li><p><strong>[Always]</strong>: This is a pirate themed world, always talk like you’re a pirate in your responses and make liberal use of the phrases “Arrrggghhhh” and “Matey”.</p><p></p><p>Effect:</p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0193bd9f-5a71-72a8-ad7d-1bdb00874bfc.png" data-width="100%" data-align="left"></li><li><p><strong>[Always]</strong>: This is a gritty world, you should swear a lot and so should all the NPCs when players talk with them.</p><p></p><p>Effect:</p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0193bda5-e542-7085-b02d-dc9991a1e4f6.png" data-width="100%" data-align="left"></li><li><p><strong>[Always]</strong>: Begin each message with [location, fantasy date and time] followed by a new line.</p><p></p><p>Effect:</p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0193bdc7-f2b4-7a1c-966e-bd3562df0cef.png" data-width="100%" data-align="center"></li></ol><blockquote><p>Note: This instruction will not actually keep accurate track of the date or time. State like this may be tracked through the <em>chat history</em>, but will not be persisted and has no accuracy guarantees with other mechanics. These types of instructions are more of thematic purposes and an example of how you can modify the <em>aesthetics</em> or <em>syntax</em> of each response from the GM.</p></blockquote><ol start="4"><li><p><strong>[NPC Dialog]</strong>: Dialog should be very conversational and NPCs should be very humorous and tell jokes often. </p><p></p><p>Effect:</p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0193be08-22be-7fb4-ad72-e73df3a33c7e.png" data-width="100%" data-align="left"></li></ol><h3 id="6or30lda642" data-toc-id="6or30lda642">Bad Examples</h3><p>In general, bad examples are ones that try to impose <strong>game mechanics</strong> or instructions to interact with <strong>game state</strong>. Custom instructions are just text that can impact the output or flavour of the <em>narration.</em> They do not have any impact on what the system can look up or interact with.</p><ol><li><p>Look up existing NPCs in the database before creating new ones. If an existing one is found then do not generate it.</p><blockquote><p>Why is it bad?: Telling the model to look something up will not give it the ability to do so. This will have no effect and ACE-1 automatically does this for you.</p></blockquote></li><li><p>Do not include ANY tropes, if you detect tropes such as “hooden figures”, “wooden boxes”, stop generating and replace the tropes with an equivalent.</p><blockquote><p>Why is it bad? The model can not rewrite or replace its response in the middle of generation. Telling the AI to <strong>not</strong> do something is generally ineffective; positive instructions</p><p>describing what you <strong>want</strong> to happen are generally better.</p></blockquote><p></p></li></ol><p>These examples do not cover <em>every</em> possible use case for custom instructions, and are guidelines so you can understand what affects they will actually have in your campaigns. We encourage you to experiment and share in the Discord custom instructions you find useful!</p><h1 id="6k2so4ecy6f" data-toc-id="6k2so4ecy6f">Custom Instructions for Generations</h1><p>Additionally, you can provide one custom instruction for the generators of new entities. These custom instructions will <strong>ONLY</strong> be used when <strong>creating</strong> a <strong>new entity</strong> such as a Character, Area, POI, Item, etc.</p><p>It’s best to place custom instructions in here that will affect the details on the generated entity. For example, you can add a custom instruction that all new characters should have a certain trait in their personality or backstory. Or that all new items should have a minimum cost or be of a certain shape.</p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0193bd84-ddf3-71c6-9106-7d817ace42ef.png" data-width="100%" data-align="left"><h1 id="7pdk14mzyst" data-toc-id="7pdk14mzyst">What are custom instructions NOT used for?</h1><p>Custom instructions are only able to affect the behaviour of the <strong>output</strong> of <strong>narration</strong> responses. They can <strong>NOT</strong> be used for controlling <strong>game mechanics</strong> such as dice rolls, XP, item bonuses, etc. Nor will they have an affect of how ACE-1 can look up or update game state variables.</p><blockquote><p>In the future this <em>may</em> change as we give you more ability to hook into and affect different parts of ACE-1.</p></blockquote><p></p><p></p>

Learn how to effectively use Custom Instructions in Friends & Fables.

Custom Instructions

<h1 id="6b1zaztdcos" data-toc-id="6b1zaztdcos">What is Pick Your Path (PYP) Mode?</h1><p>In Pick Your Path mode, Franz will occasionally present you 3 paths with how he’ll respond to your latest action. This gives you as the player much more control over where the story goes, as you can control not only your own actions but also how the GM responds to those actions.</p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0193b7aa-0be0-7ab0-bac5-1b38e03cacdb.png" data-width="100%" data-align="right"><p>For the most control, you can select “I have a better idea” to make your own suggested path for how the GM should respond. Selecting “Surprise Me” will randomly choose one of the paths the GM has come up with. </p><h2 id="tpitw1rq2i6" data-toc-id="tpitw1rq2i6">How do I enable Pick Your Path Mode?</h2><p>From the campaign settings, you can toggle Pick Your Path mode on and off at any time during your campaign.</p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0193b7ab-0360-72c8-a253-0ebdad0f25d7.png" data-width="75%" data-align="center"><p></p><p></p><p></p><p></p><p></p>

Pick Your Path Mode

<p>From the settings you can adjust the pacing of your campaign and the GM responses. By default you’ll be in Adventure mode where the GM will actively encourage questing and exploration. You can switch to Downtime mode to have the GM be less focused on questing and have a more relaxed slice-of-life experience.</p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0193b832-4242-77fe-96da-72a7dbd4d1a4.png" data-width="100%" data-align="left"><p>You can also quickly see and adjust the pacing mode by clicking on the mode in the most recent GM response in your campaign play screen.</p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0193b833-b17c-76c4-b970-3c8fabb07e53.png" data-width="100%" data-align="left"><p></p>

Pacing Mode

<p>By default, entities that you haven’t seen or met will be unknown. In the world tab, they will be displayed as Unknown and their images will not be visible. </p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0193b84c-bf98-7d48-a6e3-5a3953acc7cd.png" data-width="100%" data-align="left"><p>When you visit a Point of Interest (POI) or an Area, you will learn that location and it will become known to you. When visiting a POI, any characters at that POI will become visible and you’ll be able to see their avatar. When you learn their name, they’ll become known. </p><p>You can turn this mechanic off in the campaign settings, at which point every entity will become visible with their image and name. </p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0193b84d-5cc3-78c7-9f91-e17b41ee4066.png" data-width="100%" data-align="left"><p></p>

Hide Unknown Entities

<p>In Campaign settings, you can find Gamemaster Settings to tune how the GM behaves to your liking. Additionally, World builders can set certain GM settings and custom instructions in the Gamemaster tab of the world which will apply to all campaigns started from that world.</p><h2 id="8bryqy57sy7" data-toc-id="8bryqy57sy7">Include 5e Defaults</h2><p>By default, campaigns will include the races, classes, spells, and items from D&amp;D 5e as available options for you and the GM to use. Toggle this setting off if you don’t want D&amp;D 5e material to be available, which is useful for homebrew campaigns in non-fantasy worlds. </p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0193b8a7-b60a-7a4d-8d4f-018d90ca2ac6.png" data-width="100%" data-align="left"><h2 id="546xylklzke" data-toc-id="546xylklzke">Include Combat Encounters</h2><p>By default, combat encounters are off while we work on revamping and fixing the issues in the current combat system. You can enable combat encounters if you wish to play with the current combat system. When enabled, Franz will prompt you to roll for initiative which starts the combat encounter flow. </p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0193b8a7-a8c3-71fd-ade7-9ec0c8db8ba6.png" data-width="100%" data-align="left"><h2 id="mokwb4r3ys3" data-toc-id="mokwb4r3ys3">Generation Settings</h2><blockquote><p>Note: If you haven’t yet tried ACE-1, we recommend that you keep these settings on as the timing of generations has improved significantly.</p></blockquote><p>You can control whether or not the GM will generate new characters, Areas, POIs, classes, races, items, and spells in your campaigns. If you toggle off a generation, then the GM will no longer generate that entity.</p><p>Each generation can also have one optional custom instruction which will be included when generating that entity. For example, you can use it to include an instruction on the types of items characters should be generated with or what they should look like.</p><p><a target="" rel="noopener noreferrer nofollow" class="link" href="https://help.fables.gg/en/help/articles/8680638-custom-instructions">Read the article on Custom Instructions</a> to learn more about how to effectively use them.</p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0193b8a0-2010-7e08-a0ed-7cf6f3f01a4a.png" data-width="100%" data-align="left"><h2 id="1do24omlei3" data-toc-id="1do24omlei3">Custom Instructions</h2><p>Custom instructions let you influence how the GM should behave in their responses. For example you can have a custom instruction to have the GM always talk like a pirate or like an old timey story teller. </p><p><a target="" rel="noopener noreferrer nofollow" class="link" href="https://help.fables.gg/en/help/articles/8680638-custom-instructions">Read the article on Custom Instructions</a> to learn more about how to effectively use them.</p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0193b8a5-1f5d-7c7e-b3ea-9c28208c06bb.png" data-width="100%" data-align="left"><p></p>

Gamemaster Settings

<p>AI has come a long way, but it still isn't perfect. For our use case, it may never be. Our game works by converting your natural text into game state. Natural text is not exact, and the outputs from AI are not either. On top of that, your expectations of what Franz should do might be different from someone else. We will continue to work hard towards making the experience as immersive and magical as we can, but you may still run into situations where Franz does not do what you expect. This guide will take you through some tips and tricks to make Franz work for you.</p><h2 style="text-align: start" id="l36e6z50a4t" data-toc-id="l36e6z50a4t"><strong>1. Be Specific</strong></h2><p class="nx-mt-6 nx-leading-7 first:nx-mt-0" style="text-align: start">When talking about NPCs, POIs, and other things, be specific! If you're meaning to go to Grimelda's Potion Shop, Franz will have a much easier time retrieving information about Grimelda's Potion Shop if you say "Grimelda's Potion Shop" instead of "the shop". The latter may work if there is enough context in the recent chat history, but you'll have better results if you are specific.</p><p class="nx-mt-6 nx-leading-7 first:nx-mt-0" style="text-align: start">Things you should always try to be specific about:</p><ul><li><p>The names of locations, NPCs, and items</p></li><li><p>The quantity of items you are purchasing or consuming</p></li><li><p>The name of a location you are traveling to, or amount of time + direction you are traveling in</p></li></ul><h2 style="text-align: start" id="0s7tpbeqolr" data-toc-id="0s7tpbeqolr"><strong>2. Custom Instructions</strong></h2><p class="nx-mt-6 nx-leading-7 first:nx-mt-0" style="text-align: start">If you want Franz to act in a particular way, you can use custom instructions. For example, if you want Franz to talk like a pirate, you can add an instruction "Always talk like a pirate". Custom instructions are set within your <strong>campaign</strong> settings.</p><h2 style="text-align: start" id="w63xii4pycw" data-toc-id="w63xii4pycw"><strong>3. Making sure Game State is accurate</strong></h2><p class="nx-mt-6 nx-leading-7 first:nx-mt-0" style="text-align: start">Franz does his best to get game state updated correctly, but he might get confused occasionally and get something wrong. In situations like that, you should try to correct the game state, because it affects the context we give to Franz. For example, if he puts you at the wrong location, he may see a different set of NPCs than the ones that are at the location you should actually be at.</p><p class="nx-mt-6 nx-leading-7 first:nx-mt-0" style="text-align: start">You can update game state</p><ul><li><p>When an update happens and we surface it in chat, there is an update button</p></li><li><p>The info panel will allow you to update things on the fly, such as your location or stats</p></li><li><p>There are specific pages for game state that you can use to modify your campaign in the lefthand sidebar</p></li></ul><p></p>

How to get the most out of Franz

<h2 id="41mb1xo60ef" data-toc-id="41mb1xo60ef">Mention Usage</h2><p>Similar to discord or slack, you can <code>@</code> mention any entity within the campaign to specifically mention it and ensure its details are pulled into context for that message.</p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/019314c9-1ebf-783f-9e2c-6e23f14ecc6f.png" data-width="100%" data-align="left"><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/019314c9-02f9-74a0-80ee-7be4e7f3e4d8.png" data-width="100%" data-align="left"><h2 id="lwt4sli03x5" data-toc-id="lwt4sli03x5">Mention Limits</h2><p>Each subscription tier has a specific number of mentions it include in a single mention:</p><ul><li><p>Free: 1 mention</p></li><li><p>Starter: 2 mentions</p></li><li><p>Pro: 3 mentions</p></li><li><p>Legend: 5 mentions</p></li></ul><p></p>

Mentions

Memory

<p>Whenever your GM sends a message, we run a process to extract memories from the most recent messages. Those memories might be important plot developments, world lore that you learned, or objectives that were given to your party. These memories will be automatically added to the Memories page as you play.</p><h2 id="eyy4ztyx2w7" data-toc-id="eyy4ztyx2w7">Limits</h2><p>You can store an unlimited amount of memories as you play, but each plan is limited to a certain number of memories that are included in context. For example, you might accumulate 1000+ memories in your campaign, but when you send your next message, ACE will only use the 100 highest priority memories.</p><p>Each subscription tier has the following amount of memories:</p><ul><li><p>Free - 30</p></li><li><p>Starter - 50</p></li><li><p>Pro - 70</p></li><li><p>Legend - 100</p></li></ul><h2 id="5pyrqw27ocz" data-toc-id="5pyrqw27ocz">How does ACE choose which memories to use?</h2><p>ACE dynamically chooses memories by using recency, memory type, and whether or not a memory is locked to create an overall priority score.</p><h3 id="s847wma2xs0" data-toc-id="s847wma2xs0">Recency</h3><p>More recent memories have higher priority than older ones.</p><h3 id="pc7cse8s5yx" data-toc-id="pc7cse8s5yx">Priority Score</h3><p>When your GM creates a memory, it will also assign a priority score. You can change this in the memories tab.</p><h3 id="deyq8rmbt6f" data-toc-id="deyq8rmbt6f">Memory Type</h3><p>Some types of memories are more important than others. For campaign cohesion, plot developments are generally more important than world lore. We rank memory types in this order (highest priority to lowest priority)</p><ul><li><p>Quest Given / Accepted (This should stay in context until a quest has been completed)</p></li><li><p>Plot Developments</p></li><li><p>NPC Lore</p></li><li><p>World Lore</p></li><li><p>Story Beats</p></li></ul><p>You can change the memory type by clicking the type on the memory card.</p><h3 id="l8bdb80mlmk" data-toc-id="l8bdb80mlmk">Locked Messages</h3><p>You can lock messages by clicking the lock icon. When you lock a memory, that means it will always stay in context. If your campaign or ongoing quest would not make sense without a key detail, it is a good candidate to lock. For example, if you learned that the tomb is booby trapped, you may want to keep that one locked so when you get to the tomb, your GM will remember that it is booby trapped.</p><p>Locked messages still count towards your in-context memory limit. Don’t lock too many memories, otherwise you won’t leave enough room for new memories to form.</p><p></p>

Memories

Rests

<h1 id="ki4wtkbzili" data-toc-id="ki4wtkbzili">Short Rests</h1><p>To take a short rest, simply tell Franz, “I take a short rest”, or something to that effect. He will ask you to roll hit dice. </p><p>After rolling, you should automatically have some health restored. </p><p>You must have hit dice remaining in order to successfully perform a short rest.</p><p>To regain hit dice, you will need to take a long rest.</p><h1 id="f00485ys44m" data-toc-id="f00485ys44m">Long Rests</h1><p>To take a long rest, tell Franz that you wish to take a long rest. You usually need to be in a situation where a long rest makes sense, such as staying the night at an inn.</p><p></p><callout-component color="Accent"><p>It definitely helps to include the keywords “long rest” or “short rest” in your message.</p></callout-component><p></p><p></p>

Long/Short Rests

Getting Started

<p>Friends &amp; Fables is the world's first Generative Text RPG platform. Play through user-created worlds with Franz, our AI Game Master, or build your own with our robust world building tools.</p><p class="nx-mt-6 nx-leading-7 first:nx-mt-0" style="text-align: start">This is our documentation site! If you're looking to <a target="_blank" rel="noreferrer" class="nx-text-primary-600 nx-underline nx-decoration-from-font [text-underline-position:from-font] link" href="https://www.fables.gg/">play Friends &amp; Fables, you can find the app here<span>(opens in a new tab)</span></a>.</p><p class="nx-mt-6 nx-leading-7 first:nx-mt-0" style="text-align: start">If you are new to Friends &amp; Fables and looking for some help, you're in the right place! Our <a target="_blank" rel="noopener noreferrer nofollow" class="nx-text-primary-600 nx-underline nx-decoration-from-font [text-underline-position:from-font] link" href="https://fables-docs-git-main-friends-and-fables.vercel.app/getting-started">getting started</a> guide is a great place to start.</p>

What is Friends & Fables?

<h1 id="rfioyqkrfmw" data-toc-id="rfioyqkrfmw">Starting your first campaign</h1><ol><li><p>We recommend picking a featured world to get started. You'll find these on the home page! These are some of the best worlds that we, or our players have created.</p></li><li><p>You can pick one of our existing characters, or create your own!</p></li><li><p>Choose your inventory</p></li><li><p>Invite your friends! If you want to invite a friend to join you in your adventures, you can do so on this campaign lobby page.</p></li><li><p>Once you've started the campaign, you just talk to Franz to begin the game! You can update your world, character sheet, and everything from the sidebar. Franz can tell when you're talking "in game" first "out of game".</p></li><li><p>Franz may get things wrong, or sometimes get caught up in loops! This is just a problem with the current state of AI, and we're working on addressing it. For now you can use the feedback buttons on the right side of the message to have Franz re-write the message, or you can edit his message yourself.</p></li><li><p>Have any other questions? <a target="_blank" rel="noreferrer" class="nx-text-primary-600 nx-underline nx-decoration-from-font [text-underline-position:from-font] link" href="https://discord.gg/jjRfsUNsHH">Join our Discord(opens in a new tab)</a> and ask away!</p></li></ol><h2 id="d14185s5714" data-toc-id="d14185s5714">Customizing your experience</h2><p class="nx-mt-6 nx-leading-7 first:nx-mt-0" style="text-align: start">If you've played for a bit and want Franz to act differently, visit the settings tab in your campaign to make some adjustments! You can give him custom instructions to vary response lengths, speak like a pirate, or whatever else you can think of. You can also change his language setting here.</p><h2 id="wzlprxfeyd0" data-toc-id="wzlprxfeyd0">Building your first world</h2><p class="nx-mt-6 nx-leading-7 first:nx-mt-0" style="text-align: start">Now that you've played in a featured world, maybe you'd like to create your own! Head over to our <a target="_blank" rel="noopener noreferrer nofollow" class="nx-text-primary-600 nx-underline nx-decoration-from-font [text-underline-position:from-font] link" href="https://fables-docs-git-main-friends-and-fables.vercel.app/features/worlds/introduction">Worlds</a> guide to learn more.</p>

Spells

<p>F&amp;F comes loaded with all of the spells found on <a target="_blank" rel="noreferrer" class="nx-text-primary-600 nx-underline nx-decoration-from-font [text-underline-position:from-font] link" href="https://open5e.com/spells">Open5e</a>. For anything not in the D&amp;D SRD, you can add custom spells in your Workshop, Worlds, and Campaigns.</p><h2 id="1axk3fyks1r" data-toc-id="1axk3fyks1r">Campaigns</h2><p>You can access your spellbook by either clicking the wand icon next to the chat input, or the spellbook tab in your character sheet.</p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0193b85c-af22-75a7-a358-f2dfdb1dfe3d.png" data-width="100%" data-align="center"><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0193b85e-0ec3-7790-8f50-8b2c2eecbb8b.png" data-width="75%" data-align="center"><h2 id="xb0kw3xzs30" data-toc-id="xb0kw3xzs30">Workshop</h2><p>From the workshop, you can create custom spells which can be imported into all of your worlds. </p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0193b867-daf6-77a6-9c8d-5ac64247ee13.png" data-width="100%" data-align="left"><h2 id="7liycya4wsy" data-toc-id="7liycya4wsy">Worlds</h2><p>From the Spells tab of your World, you can see and create custom spells. These spells will also be present in the world tab for any campaign played from your world. </p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0193b86d-1637-7fe5-9147-8cf68e4cbc23.png" data-width="100%" data-align="left"><p></p>

Introduction to Spells

Items

<p>Franz will automatically track your inventory for you.</p><h2 style="text-align: start" id="2dysr01fomw" data-toc-id="2dysr01fomw"><strong>Tracking Inventory</strong></h2><p class="nx-mt-6 nx-leading-7 first:nx-mt-0" style="text-align: start">When an item is mentioned in game, Franz will update your inventory automatically. The following examples are likely to trigger inventory updates:</p><ul><li><p>"I pick up the mystiq staff"</p></li><li><p>"I drink a health potion"</p></li><li><p>Franz: "The blacksmith says he will give you the dagger for 20 gold", You: "I say, "That sounds fair. Here's the gold".</p></li></ul><h2 style="text-align: start" id="3blyokp783k" data-toc-id="3blyokp783k"><strong>SRD Items</strong></h2><p class="nx-mt-6 nx-leading-7 first:nx-mt-0" style="text-align: start">Each campaign comes prepopulated with SRD items and items found in open source 5e content.</p><h2 style="text-align: start" id="tilfx2a6fa2" data-toc-id="tilfx2a6fa2"><strong>New Items</strong></h2><p class="nx-mt-6 nx-leading-7 first:nx-mt-0" style="text-align: start">As you play through a campaign, Franz will generate new items if they don't already exist in the database.</p><h2 style="text-align: start" id="exi8db1zlbb" data-toc-id="exi8db1zlbb"><strong>Not Enough</strong></h2><p class="nx-mt-6 nx-leading-7 first:nx-mt-0" style="text-align: start">If you try to make a trade or consume something that is not in your inventory, we flag that to Franz and tell him that you don't have enough of something.</p><p class="nx-mt-6 nx-leading-7 first:nx-mt-0" style="text-align: start">He will usually let you know that you don't have enough of an item and steer you in another direction.</p>

Learn more about the backbone of F&F: Worlds

Worlds

Classes

<h2 id="4qe8olom5o5" data-toc-id="4qe8olom5o5">Add Classes to your Workshop</h2><p>Visit the classes tab in the workshop to create a class. As you create worlds, you’ll be able to add this class to them. This means you can re-use a custom class across multiple worlds!</p><h2 id="adezdr63dyk" data-toc-id="adezdr63dyk">Add Classes to a World</h2><p>If you have edit access to a world, you should be able to add a class by clicking this button within the classes tab of your world.</p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0191c393-c5d8-75bb-a965-e0119baf39aa.png" data-width="100%" data-align="left"><p>You then can specify the hit die and the spell casting mechanics around this class.</p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0191c3bf-0825-752e-9557-007ca52e7ea1.png" data-width="100%" data-align="left"><p></p>

Adding Homebrew Classes

<p>Worlds are the backbone of Friends &amp; Fables. When you RP with AI, you'll often find it going in very similar circles. Worlds change the experience by pre-populating enough information for an AI game master to expand upon. The result is a much more immersive experience.</p>

<p>F&amp;F worlds are a grid where each unit represents 100 meters or approximately 1 minute of travel. If two POIs are 10 units apart, they are 1 KM or about a 10 minute walk apart.</p>

Coordinate System

<p>To go somewhere in F&amp;F, you just describe to Franz something along the lines of:</p><ul><li><p>"I walk 15 minutes North" (Mentioning a specific amount of time and direction)</p></li><li><p>"I walk all the way to Ezra's Tavern" (Mentioning a specific POI)</p></li></ul><p class="nx-mt-6 nx-leading-7 first:nx-mt-0" style="text-align: start">Franz will automatically update your coordinates based on what you wrote. Since he is processing only your text, the more specific you are, the more accurate he will be at updating your coordinates. If you mention a specific POI, he will update your coordinates to the coordinates of that POI. If you use time + direction, he will use that.</p><p class="nx-mt-6 nx-leading-7 first:nx-mt-0" style="text-align: start">Converting natural language into coordinate updates may not always be 100% accurate. There might be conflicting information or Franz might interpret something slightly differently than you. This is why we provide an easy way to correct any automatic updates.</p>

How to Travel

<p>You can access the map builder to visually build your world! Just click the map icon when editing a world.</p>

Map Builder

<p>As a world builder, can differentiate to your players which characters are meant to be player characters. To do this, you can mark a character as featured when editing a character.</p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0190e2a6-dfb3-7814-b37c-9073854936db.png" data-width="100%" data-align="left"><p>When your character is marked as featured, it will be shown at the top of the character select screen.</p>

How to mark a character as featured

Encounters

<p>To start an encounter, you’ll first want to get to a point in the story where an encounter makes sense narratively. You’ll want to be in a situation where the GM should ask you to roll initiative.</p><p>Some examples include:</p><ul><li><p>Get in an argument with an NPC</p></li><li><p>Failing a stealth check while sneaking about some guards</p></li><li><p>Drunkenly stumbling through a goblin encampment</p></li></ul><p><strong>An encounter begins once you roll initiative.</strong></p><h2 id="6228ow5sfdd" data-toc-id="6228ow5sfdd">Rolling Initiative</h2><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0190a9a3-942a-780f-a88d-eccc90671036.png" data-width="100%" data-align="left"><p>In a multiplayer game, only one person needs to roll initiative.</p><p>You’ll know you are in the encounter mode when your screen looks like this:</p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0190a9aa-7658-79b9-ac45-d028fdf3c123.png" data-width="100%" data-align="left"><p>Initiative will be automatically rolled for all parties in combat. Your other party members will not need to press the button.</p><h2 id="ope6a121k8w" data-toc-id="ope6a121k8w">Manually Triggering Initiative</h2><p>You can also click the Dice icon next to the chat input to open the roll menu. Inside of this menu, you can click to roll Initiative, which will start an encounter!</p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0190a9a9-54c0-7326-a19d-82653ab3fde8.png" data-width="100%" data-align="left"><h2 id="xf30p6e5ktf" data-toc-id="xf30p6e5ktf">What can you fight?</h2><ul><li><p>Monsters that have been planted in the world</p></li><li><p>Monsters that Franz generated on the fly</p></li><li><p>NPCs that have been planted on the world</p></li><li><p>NPCs that have been generated on the fly</p></li></ul><h2 id="82llbytcw2e" data-toc-id="82llbytcw2e">What can’t you fight?</h2><ul><li><p>NPCs that are in your party. If an NPC is in your party, they will be automatically assigned to your side if they are determined to be in combat.</p></li></ul><h1 id="ltc42w4d6ts" data-toc-id="ltc42w4d6ts">FAQ</h1><details class="details"><summary>Can friendly NPCs join?</summary><div data-type="detailsContent"><p>Yes. If you’ve added an NPC to your party and it makes sense for them to join the combat based on the chat history, then they should be automatically included in combat. If they are not, you should be able to Edit the Encounter, and add them.</p></div></details><p></p>

How to Start an Encounter

<h1 id="21kez81eyya" data-toc-id="21kez81eyya">Player Turns</h1><h2 id="868xiww8a6m" data-toc-id="868xiww8a6m">Making an Attack</h2><p>On player turns, you can make an attack one of two ways.</p><ol><li><p>You can talk to Franz and dictate your attack “I attack [target(s)] with [weapon or spell]”. Franz will detect your weapon / spell, as well as the targets, and ask you to confirm your attack. Franz may not be completely accurate if the text does not contain enough information. You can edit the attack before confirming.</p></li></ol><callout-component color="Accent"><p>If you are attacking with a specific spell or weapon, make sure you have it equipped or prepared. On your turn, Franz reads your equipped items and learned/prepared spells. <strong>Franz does NOT have access to your entire inventory / spell book</strong>.</p></callout-component><ol start="2"><li><p>Click the Crossing Sword Icon to open up the Attack Panel. From there, you can choose your attack.</p><p></p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0190ccfe-dc41-7cb1-88f1-d37364b00c7c.png" data-width="100%" data-align="left"><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0190ccff-46b8-74ad-81f8-a28d177f4c7a.png" data-width="100%" data-align="left"><p></p></li></ol><p>The system will automatically handle your attack roll, and the subsequent damage roll if you hit. Saving throws from spell attacks will automatically be handled as well.</p><h2 id="edb1x7o3f4a" data-toc-id="edb1x7o3f4a">Custom Attacks</h2><p></p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0190cd02-1c93-7cc3-947a-2640ff338e95.png" data-width="100%" data-align="left"><p>Custom attacks are great for Homebrew campaigns. Playing a ninja? Add a jutsu!</p><p class="p1">Custom Attacks are also great for saving modifications to existing attacks, such as updating the modifier or attack type.</p><h2 id="a8zsp0q7rso" data-toc-id="a8zsp0q7rso">Favorite / Saved Attacks</h2><p>You can favorite a custom attack, or edit an existing attack and save your modifications. To favorite an attack, go to the Custom Tab or Edit an existing attack.</p><p class="p1">At the bottom, just click Favorite Attack and then you’ll be able to find that attack in the Favorites Tab.</p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0190cd02-a859-7ce6-b686-e646d3f59c51.png" data-width="100%" data-align="left"><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0190cd04-3507-7f1c-b911-076bd73d5fb4.png" data-width="100%" data-align="left"><h1 id="bk0pmzx8fo2" data-toc-id="bk0pmzx8fo2">NPC/Monster Turns</h1><p>NPC turns run similarly to player turns, but must be triggered by a player. NPCs will automatically handle attacks.</p><p></p>

Get a glimpse at the inner workings of our AI powered combat system

How Our Combat System Works - Attacks & Turns

<p>Combat rules in F&amp;F is very similar to D&amp;D 5e. To learn more, check out this <a target="_blank" rel="noopener noreferrer nofollow" class="link" href="https://roll20.net/compendium/dnd5e/Combat#content">awesome guide by Roll20</a>.</p><h1 id="mdrbmicx747" data-toc-id="mdrbmicx747">The key differences between F&amp;F and 5e combat</h1><ul><li><p>Monsters do not have legendary actions (yet)</p></li><li><p>There are no death saving throws (yet)</p></li><li><p>There are no reactions and class features (yet)</p></li><li><p>Conditions aren’t implemented (yet)</p><p></p></li></ul><p></p>

Combat - Basic Rules

<p>To edit an encounter, look at the encounter module in the right-hand sidebar. If you’re on mobile, you will need to click the Book icon in the top right hand corner.</p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0190bca7-26e0-7bfb-ac7c-dd850b3daa20.png" data-width="100%" data-align="left"><p>From there, you will be able to edit the turn order by dragging characters, change teams of NPCs/Monsters, and delete entities from the encounter.</p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0190bca7-fb1a-78a8-8a4f-f5768c28979e.png" data-width="100%" data-align="left"><callout-component color="Accent"><p>You can end the encounter by clicking “End Encounter” at the bottom of this modal</p></callout-component><p></p>

Editing an Encounter

<h1 id="ezmzf1805oi" data-toc-id="ezmzf1805oi">Chat based Flee</h1><p>To flee an encounter, simply mention to Franz that you’d like to flee. He’ll ask you for a dexterity roll. He will set a DC and if your roll beats the DC, you flee successfully. </p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0190bc5a-3db2-7d86-b563-866009b7fbb7.png" data-width="100%" data-align="left"><h1 id="q38d6658l41" data-toc-id="q38d6658l41">Manual Flee</h1><p>To flee manually, click the Dice icon and click “Flee”.</p><p></p>

Flee an Encounter

<p>At time of writing, healing during combat is not implemented. </p><p>To heal <em>after</em> combat, check out the <a target="_blank" rel="noopener noreferrer nofollow" class="link" href="https://help.fables.gg/articles/8990275" data-organization-id="65d934de33acd44570a49610" data-help-center-id="gggjnopp9yymwd02" data-slug="8990275" data-article-id="8990275" data-locale="en" data-hash="">long/short rest guide</a>.</p>

Healing

<callout-component color="Accent"><p>Both forms of combat are experimental and have a variety of known issues. We have upgrades coming, which should hopefully be finished sometime in January 2025.</p></callout-component><p>You can run combat in Friends &amp; Fables in one of two ways, narrative combat and turn based combat.</p><p>Narrative combat goes through the same systems that normal messages do. The downside to this is that enemies and their stats may not be tracked accurately.</p><p>Turn based combat is an experimental option that can be turned on in your campaign settings. </p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0193bdba-991d-712e-a6c0-fa65801368e7.png" data-width="100%" data-align="left"><p>The downside to turn based combat is that the GM will lose a lot of narrative abilities / memory. Stat tracking will be much more accurate, though this system is still buggy. </p><p>We are aware and will be doing a complete rework of combat soon. Thank you for your understanding!</p>

Narrative vs Turn Based Combat

Miscellaneous

<h1 id="kdk00pp106b" data-toc-id="kdk00pp106b">One bug for each report</h1><p>Creating a separate report for each bug helps us track and notify you better when a particular bug is fixed. </p><h1 id="r5p6wy8tqxq" data-toc-id="r5p6wy8tqxq">Include Steps to Reproduce</h1><p>How can we reproduce the bug or error on our end? Trace your steps and let us know what you were doing when you encountered the issue.</p><h1 id="o3tyqpl1s6l" data-toc-id="o3tyqpl1s6l">Include IDs</h1><h2 id="0oylttfwcls" data-toc-id="0oylttfwcls">URL</h2><p>Submit the URL of the page you are having an issue on. This URL contains IDs that are helpful when debugging issues.</p><h2 id="wzc54x1f383" data-toc-id="wzc54x1f383">Event ID</h2><p>If you are in a campaign and there was something wrong with a specific message, click the 3 dots and then click “Copy Event ID”</p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0190cb63-8b05-7989-8854-d9e9c7ca430e.png" data-width="100%" data-align="left"><h1 id="3a7dxs2kslf" data-toc-id="3a7dxs2kslf">Include Screenshots or Videos</h1><p>If you can include screenshots or videos, they can definitely help us get an idea of what’s happening on your end. Not always necessary, but they help!</p><h1 id="qswtp3zt2ir" data-toc-id="qswtp3zt2ir">Use a Descriptive Title</h1><p>Titles are how we quickly find relevant reports and provide you updates. The title “Combat” is much less useful than “Error when selecting weapon during combat”</p><p></p><p></p>

Learn how to submit a bug report that helps us fix something in Friends & Fables faster. Good bug reports helps us diagnose and fix the issue faster, making the F&F experience better everyone!

How to Submit A Good Bug Report

<p>Click the 3 dots in the top right corner and then click delete</p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0190db2b-000e-71da-978a-a8eee5160a46.png" data-width="100%" data-align="left"><p></p>

How do I delete a campaign?

<h1 id="57tam0xz8bi" data-toc-id="57tam0xz8bi">Introduction</h1><p class="whitespace-pre-wrap break-words">Welcome to Friends and Fables! Our platform is designed to allow anyone to build and share worlds brought to life by AI game masters. These guidelines aim to create a safe, enjoyable space for all users to explore, build, and share their creations.</p><p class="whitespace-pre-wrap break-words">We may revise these Community Guidelines with or without notice at any time to maintain the quality and safety of our platform. If you have any questions or need clarification, please reach out to us at <a target="_blank" rel="noopener noreferrer nofollow" class="link" href="mailto:support@fables.gg">support@fables.gg</a>.</p><h2 id="b2lwopzekri" data-toc-id="b2lwopzekri">Chat vs Content</h2><p><strong>Content: </strong>Defined as data in our platform, such as characters, locations, items, etc.</p><p><strong>AI Chat: </strong>Text you submit to AI / Text you receive back</p><h1 id="oqcokyr2dmf" data-toc-id="oqcokyr2dmf">Content Moderation</h1><h2 id="m8mq80slpmf" data-toc-id="m8mq80slpmf">Content Visibility</h2><p>On Friends &amp; Fables, you can choose to mark your content as Private, Unlisted, or Public.</p><ul><li><p><strong>Private Content</strong>: Private content is visible only to the player who created it. We do not moderate private content.</p></li><li><p><strong>Unlisted Content</strong>: Unlisted content is only visible to players who have the link. It is not published or shared on the Friends &amp; Fables Discover page. We may moderate this content.</p></li><li><p><strong>Public Content: </strong>Public content will be published to the Friends &amp; Fables Discover page so it is visible and shared with everyone in the community. It must adhere to the Community Guidelines to ensure a positive experience for all users.</p></li></ul><h2 id="trscrx71xwd" data-toc-id="trscrx71xwd">Content Guidelines for Public Content</h2><p><strong>Content should be in the Spirit of the Platform</strong></p><p>Friends &amp; Fables is a generative tabletop gaming experience, and as such, our users expect content that is in the spirit of TTRPG experiences.</p><p>This does NOT mean that mature themes are prohibited. For example, Game of Thrones or Baldur’s Gate are both fantasy experiences that contain mature themes such as violence and sex, but they are both in the spirit of their respective mediums. If your published world contains some content that has mature themes, that is okay, as long as that’s not the whole point of the content. If that’s the sort of thing you are after, you are free to do so in your own private campaigns, which are not moderated.</p><h2 id="ly5eesw7sao" data-toc-id="ly5eesw7sao">Prohibited Public Content</h2><p class="whitespace-pre-wrap break-words">The following content is not allowed in any published content:</p><ol><li><p><strong>Explicit Sexual Images</strong>: Any graphic sexual imagery or depictions of sexual acts in uploaded images.</p></li><li><p><strong>Hate Speech</strong>: Content that discriminates against or promotes hatred towards individuals or groups based on attributes such as race, ethnicity, national origin, gender, sexual orientation, religious affiliation, or disabilities.</p></li><li><p><strong>Extreme Violence</strong>: Graphic depictions of gore or extreme violence.</p></li><li><p><strong>Self-Harm</strong>: Content that glorifies or promotes self-harm or suicide.</p></li></ol><h2 id="k38er2ymx3w" data-toc-id="k38er2ymx3w">Public Content Enforcement</h2><p class="whitespace-pre-wrap break-words">Depending on the nature and severity of the violation, we may take the following actions:</p><ul><li><p>Removing public content that violates the Community Guidelines.</p></li><li><p>Temporarily or permanently restricting a user's ability to publish content.</p></li></ul><p class="whitespace-pre-wrap break-words">Users may appeal restrictions by contacting the support team at <a target="_blank" rel="noopener noreferrer nofollow" class="link" href="mailto:support@fables.gg">support@fables.gg</a>.</p><h1 id="fwxzf7672d0" data-toc-id="fwxzf7672d0">AI Chat Moderation</h1><p>AI Chat moderation is something we cannot control fully, as some things are baked into the language models directly. Specific language models may refuse to engage in certain topics. This is, for the most part, out of our control and the type of content that is refused is specific to each model. It is mostly up to the language model to decide what it can / cannot say.</p><p>However, we do have a layer of automated moderation built in as well. While we try to allow for mature topics to be part of the game, we have automated systems to detect misuse. For example, we allow violence and sexual themes, but we use automated systems to refuse content that is sexual/includes minors.</p><h1 id="4tq1imdabox" data-toc-id="4tq1imdabox">Conclusion</h1><p class="whitespace-pre-wrap break-words">These guidelines are designed to create a welcoming and creative environment for all Friends and Fables users. If you have any questions or need clarification, please contact our support team at <a target="_blank" rel="noopener noreferrer nofollow" class="link" href="mailto:support@fables.gg">support@fables.gg</a>.</p>

Community & Content Guidelines

<h2 id="3ikfx63rxl3" data-toc-id="3ikfx63rxl3">How It Works</h2><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0192a0d2-28c6-7f01-8cba-f1c621075e8b.png" data-width="100%" data-align="left"><ol><li><p>Earn 100 credits when a new player signs up after clicking a world you've shared or joins a campaign you've invited them to.</p></li><li><p>Earn an additional 1000 credits if they later subscribe.</p></li></ol><h2 id="cezwm6t6sf7" data-toc-id="cezwm6t6sf7">Sharing a Link</h2><h3 id="6qwfd5ps7ly" data-toc-id="6qwfd5ps7ly">Campaigns</h3><p>Invite a player to join your party in campaigns and share the invite link. You can either click the add to party button in the top right, or the invite button in the left sidebar. </p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0192a60d-bfb8-732c-b3ba-136d130fe061.png" data-width="100%" data-align="center"><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0192a614-7294-793f-a329-ae07fc2c3dcf.png" data-width="75%" data-align="center"><h3 id="bl6sp3rwwl7" data-toc-id="bl6sp3rwwl7">Worlds</h3><p>Mark a world you own as public and share the world link. </p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0192a612-c1a2-7f1b-a857-549caffa1e5f.png" data-width="100%" data-align="center"><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0192a613-57be-77f3-a2be-58ae8d2475e8.png" data-width="75%" data-align="center"><h2 id="x5ir4aafb7b" data-toc-id="x5ir4aafb7b">Spending Your Credits</h2><p>Currently, only non-subscribers can spend credits on campaign turns (1 credit = 1 turn in a campaign).</p><p>We want subscribers to have a reason to earn credits as well, so we have future plans to let you use credits for more things like premium text or image generation, cosmetics, and other upgrades.</p><h2 id="xeeyrcsxmax" data-toc-id="xeeyrcsxmax">Program Conditions</h2><ul><li><p>The referred player must click on one of your campaign invite or world share links first. Direct visits to our site won't count.</p></li><li><p>Only new players count as referrals. Inviting existing users won't earn credits.</p></li><li><p>We reserve the right to revoke credits if we detect abuse or misuse.</p></li></ul><p>If you believe you've referred someone but didn't receive credit, please email us at <a target="_blank" rel="noopener noreferrer nofollow" class="link" href="mailto:support@fables.gg">support@fables.gg</a> with your email + the email of the person you referred.</p>

Earn credits by sharing your worlds and inviting friends to join campaigns on Friends & Fables!

Referral Program

<h2 id="0o58xpke1b6" data-toc-id="0o58xpke1b6">LLM Context &amp; Memory 101</h2><p>In order to understand why we manage game state and context the way we do, we should have a general sense of how language models work.</p><p>This is massively oversimplifying it, but you can think of an LLM as autocomplete on steroids. The way it works is it takes a big block of text (in the form of prompts / context) and then spits out some more text.</p><p>One misconception is that language models have memory. This is not true! Language models are stateless and forget everything as soon as they are done with their response. It’s the apps around the language models that handle the memory. So GPT-4 (LLM) does not have memory, but ChatGPT (the app) does have memory. ChatGPT gives GPT-4 the memories anytime you interact with it.</p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/01935062-6b80-7b94-947f-1356dc899814.png" data-width="100%" data-align="left"><p>The diagram above is a simplified explanation of what it looks like when you talk to an AI game master in Friends &amp; Fables. Meanwhile, the diagram below zooms in on the F&amp;F Builds Context step.</p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/0193506e-7734-7943-942b-0a9eca62a9a2.png" data-width="100%" data-align="left"><p>A lot of our players are building MASSIVE worlds, with hundreds of locations, NPCs, and items. In addition to things from the SRD, sometimes we’re looking at over a thousand entities, each of which have paragraphs of descriptions, appearances, and other data. If we sent all of that data to a language model every time you sent a message, it would be massively expensive, and we’d be bankrupt! </p><p>Not only is it expensive, but it’s also confusing to both humans and to LLMs if there’s a lot of unrelated information to parse through for your task! It’s much easier and faster for the LLM to complete the task when it only has the relevant information it needs and doesn’t need to parse through and throw out irrelevant information.</p><p>This is why we do our best to pick the most relevant context whenever you send a message. We do this by creating relationships between entities, using character locations, `@mentions` and more.</p><h1 id="taxyx0xr1a3" data-toc-id="taxyx0xr1a3">So, what game state can ACE (Agentic Campaign Engine) actually see?</h1><p>Depending on the situation, ACE will get a different set of context. For example, ACE gets different information in a narration context “I do the thing… what happens next?” vs state update context “Can you update my HP to 20?”. In the former, we’ll want to include more world information, memories, etc. In the latter, we’d want to include your character’s stats.</p><p>For most of your interactions, ACE will see:</p><ul><li><p>Basic world/theme information</p></li><li><p>The last 5-8 messages in the chat history</p></li><li><p>The campaign summary (memories)</p></li><li><p>Basic character information of in-party characters, nearby NPCs, and any mentioned NPCs.</p></li><li><p>Basic information about the current location and area</p></li></ul><h1 id="kq5w301bmkq" data-toc-id="kq5w301bmkq">Can I see what ACE sees?</h1><p>Yes! If you click on a message from the GM, click the 3 dots and then click “View Context”.</p><p>We built this feature so you can examine the memory being used for each message. If you think something should be in there that we’re not currently using, please let us know!</p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/01935077-4a5a-70f7-8768-d6bcc2e6eb19.png" data-width="100%" data-align="left"><h1 id="kkcclrew37r" data-toc-id="kkcclrew37r">Why can’t you just add more context?</h1><p>There are two main reasons we don’t throw your entire chat history into context:</p><h3 id="4li8o001a6f" data-toc-id="4li8o001a6f">1) More context is not always better! It can confuse the LLM</h3><p>Your intuition might be that shoving more context into each request will make the LLM smarter, but that isn’t always the case. Sometimes having too much information can actually be a bad thing. Imagine you have a description on one thing that has conflicting information with another. By pulling them both into context, we’d actually be making the lore of the world <em>more</em> confusing to the LLM.</p><p>Our goal is to give the LLM everything that it needs to create an immersive and cohesive experience. While we’re not going to throw the kitchen sink at it, we will be adding in more context as we find reasons to give it more information. By keeping the context limited only to what is necessary, we’re creating a more immersive and intelligent experience.</p><h3 id="droeoqb6p5b" data-toc-id="droeoqb6p5b">2) Cost</h3><p>Across all of our users, we’re handling A LOT of messages. Every word that we send to an LLM costs money. The more we send, the more it costs us. To keep Friends &amp; Fables online, we need it to be a sustainable business. In the future, we’ll open up more subscription options for users who do want to inject more context into each message.</p><p></p>

What game state can ACE see / update?

<p>The AI engine that powers Franz is a mixture of many models depending on the task. These models are primarily composed of <a target="" rel="noopener noreferrer nofollow" class="link" href="https://llama.meta.com/llama3/">Llama3 </a>models, as well as our own custom fine tuned models and other provider models depending on the task.</p>

What models do you use?

<p>Unfortunately, no. Friends &amp; Fables has a cloud architecture that is not compatible to be run locally. </p><p>Additionally, we have a lot of interdependent functions which use various LLMs, service providers, and our own custom models. This makes bringing your own API key impossible and difficult to manage. </p>

Can I bring my own API key or run Friends & Fables locally?

<p class="whitespace-pre-wrap break-words">We use <a target="" rel="noopener noreferrer nofollow" class="link" href="https://stripe.com/">Stripe</a>, a trusted third-party payment processor, to handle all transactions in Friends &amp; Fables. This means that the actual processing of your payment is not directly managed by us.</p><p class="whitespace-pre-wrap break-words">If your payment card was declined, the most effective steps you can take are:</p><ol><li><p class="whitespace-pre-wrap break-words">Verify your payment information details. The most common reasons for a payment being declined is an incorrect card number, CVV, postal code, billing address, or insufficient funds.</p></li><li><p class="whitespace-pre-wrap break-words">Contact your bank: Your card issuer can provide specific details about why the transaction was declined. Common reasons include insufficient funds, expired cards, or suspicious activity flags.</p></li></ol><p class="whitespace-pre-wrap break-words">If you continue to experience issues after contacting your bank, please email us at support@fables.gg, and we'll do our best to assist you further.</p>

Why was my payment method declined?

<p>We use <a target="" rel="noopener noreferrer nofollow" class="link" href="https://stripe.com/">Stripe</a>, a trusted third-party payment processor, to handle all transactions in Friends &amp; Fables. This means our available payment methods are limited to what they offer, which includes:</p><ul><li><p>All major credit cards</p></li><li><p>Link</p></li><li><p>Apple Pay for Apple devices.</p></li><li><p>Cash App for US based customers.</p></li><li><p>Amazon Pay for US based customers.</p></li></ul><p>If paying internationally, the most reliable form of payment is through a credit card. </p><h2 id="e0yfdcdq5wo" data-toc-id="e0yfdcdq5wo">Will you add PayPal?</h2><p>Stripe does not currently offer PayPal as a payment method for non-EU businesses. If they allow PayPal as a payment method for businesses outside the EU then we will consider it then, but there are no plans for a separate PayPal integration. </p><p></p>

What payment methods do you support?

<p>The AI system behind Franz costs a lot of money to run, and unlike traditional games the cost increases the more users play. To grow Friends &amp; Fables sustainably without compromising on service quality, we need to cover our costs. Without subscriptions, the service would not be possible and be shut down for everyone.</p><p>That being said, we want to make TTRPGs more accessible to everyone. A refreshable free tier is planned for the end of 2024 / start of 2025. </p>

Why isn't Friends & Fables completely free?

<p>We are always evaluating new language models as they come out so that we can deliver the best experience to you.</p><p>Here’s how we think about adding new models: </p><ul><li><p>Is the model fast enough?</p></li><li><p>Is the model cheap enough?</p></li><li><p>Does the model pass our tests?</p></li></ul><p>We run a TON of tokens through each message in Friends &amp; Fables. When you send a message, the tokens are not just the length of the message you send, but a ton of context that we send with it (game state, world context, character sheets, etc). For this reason, we have to choose models that work in both speed and cost. </p><p>Many of the latest and greatest frontier models are expensive and slow. While they are smarter, they won’t always be the best choice because they are too slow and will be too expensive. These models are generally more suited for low volume + high value tasks, such as business reporting or document generation, but are not as suited for our use case which is high volume.</p>

How do you decide which new language models to add?

How can we help you?

Help Center

Improved

Fixed

friendsfables

In Review

Planned

Completed

Rejected

Unlikely

On Hold

Planned (Next 1-3 months)

Planned (Next 3-6 months)

Needs More Information

Planned (6+ months)

Closed

Staged

In Progress

In Progress (Roadmap)

High Priority

Low Priority

Combat

Campaign

User Interface

Workshop

World

Mobile

Inventory/Equipment

Service Disruption

Relationships

Tropes

Entity Generation

Travel System

World Building

<p>This is our high level plan for the first half of 2025 - subject to change! In the first half of 2025, our main focus will be on improving the quality of our app. This mean reducing bugs, making the UX better, and adding new features to improve your experience.</p><p></p><img src="https://fb-usercontent.fra1.cdn.digitaloceanspaces.com/019405df-6ae7-7d8e-9d06-a37154a67d2c.png" data-width="100%" data-align="left"><p></p><p>The board below shows more detailed items. If you want something done sooner, upvote it and tell other people to upvote it as well! The more upvotes the more likely we are to bump it in priority.</p>

2025 Roadmap

<p>Let us know if you have any feedback, feature requests, or bug reports! We encourage you to upvote posts here as they will help us decide what to prioritize.</p>