{"type":"doc","content":[{"type":"expand","attrs":{"title":"Click here to show Table of Contents"},"content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"016ab985-76e1-4583-a757-d0bf268843c0"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"fa03e67d-3bd7-4a91-97c2-c902d40085c3"}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Introduction","type":"text"}]},{"type":"paragraph","content":[{"text":"A Story template is a special kind of record that can generate new story records from other information in the same campaign. They can be used for any number of purposes to generate descriptions of places, npcs, items or indeed anything pertinent to the campaign.","type":"text"}]},{"type":"paragraph","content":[{"text":"To access the list of Templates in the campaign click on the \"Templates\" button in the Story records campaign list. New story records can be generated from the template by clicking on the \"Generate\" button at the bottom of the story template record window.","type":"text"}]},{"type":"paragraph","content":[{"text":"As part of the generation of the new story record, the template will look for special text information that it will generate replacements for. The new story record will be placed into the current campaign story listing, and the story record will be displayed.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Template Example","type":"text"}]},{"type":"paragraph","content":[{"text":"To illustrate the potential of this new feature let us walk through an example. We'll create a Template which we can use any number of times to generate a general store that the PCs might visit during their travels. We want it to have a name, a brief description of the proprietor and the building and also we want a list of goods that are for sale. We could also place a limit on the number of gold pieces that the store might have available to buy surplus gear from the party and also work out how expensive the goods are in the shop.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Preparation","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":727,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":727,"alt":"image-20240502-231107.png","id":"1d2c93b8-6822-4f09-80fd-e9a9ef4d11b9","collection":"contentId-996640973","type":"file","height":434}}]},{"type":"paragraph","content":[{"text":"In order to achieve all of this we are going to need a large number of tables that our template will use to generate our story entry. We want a table for the first and last name of the business and one each for the exterior and interior description. We'll also need some tables to describe the proprietor and a few more tables from which we can generate stock. The graphic on the right shows some of the tables that I created for this example.","type":"text"}]},{"type":"paragraph","content":[{"text":"As you can see most of them are straightforward and very simple tables. Note, however he Magic Item Stock table. This one rolls a random number of times on a table from the Dungeon Master's Guide. In order for the Template to work this module will need to be open in the Library. For more information on creating tables see the ","type":"text"},{"text":"tables","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/FGCP/pages/996640986"}}]},{"text":" article.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Getting Started","type":"text"}]},{"type":"paragraph","content":[{"text":"Once you have all of your resources in place you can start building your template. Click on Story from the menu down the right hand side and then on the 'Templates' button on the top of the window that opens to create a new, blank, template.","type":"text"}]},{"type":"paragraph","content":[{"text":"A Template is very like a normal story entry in many respects and so it will accept formatted text including headings, bold, italic, tables, lists and speech bubbles. So let's give the Template a name 'The Village Store'.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":697,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":697,"alt":"image-20240502-231124.png","id":"e3e8dab5-4be4-4c96-b750-19d241394af4","collection":"contentId-996640973","type":"file","height":545}}]},{"type":"paragraph","content":[{"text":"First up we want to give the store a description including a name. So we can create a new heading 'Building' and under that we can start creating the template. Type in 'Name:' and then after it put the name of the tables we will be using for the shop's name; so we end up with:","type":"text"}]},{"type":"codeBlock","content":[{"text":"Name: [Name One] [Name Two]","type":"text"}]},{"type":"paragraph","content":[{"text":"When you generate the story from this template it will print out '","type":"text"},{"text":"Name:","type":"text","marks":[{"type":"code"}]},{"text":"' onto the story and it will then call the table ","type":"text"},{"text":"[Name One]","type":"text","marks":[{"type":"code"}]},{"text":" where it will roll a random entry from that table and place it in the story replacing ","type":"text"},{"text":"[Name One]","type":"text","marks":[{"type":"code"}]},{"text":". It will then do the same for","type":"text"},{"text":" [Name Two]","type":"text","marks":[{"type":"code"}]},{"text":". What you end up with then is something like 'Name: Bob's Shop'. Anywhere that you want the template to access a table and get a result from that table you enclose the table name in the template with square brackets ","type":"text"},{"text":"[ ]","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"So go ahead and fill out the first part of the Template with the description of the building and the proprietor. If you then click on the 'Generate' button at the bottom of your template a new story will be created and, if all has gone well, it will have filled in the table names with the results of rolling on those tables. You should end up with something approaching the graphic ion the right.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"More Complex","type":"text"}]},{"type":"paragraph","content":[{"text":"Next up we'll tackle the store's inventory. For the purpose of this example the store will contain a bit of everything, some gear, weapons, armor and a magic item or two. If you look at the graphic on the right you'll see all the possibilities for calling a table from a template. Not only can we simply add the table name but we can also call the table a number of times including a random number of times.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":727,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":727,"alt":"image-20240502-231147.png","id":"fbdbf3d2-9db0-4943-9f71-03f15ab8a5c7","collection":"contentId-996640973","type":"file","height":462}}]},{"type":"paragraph","content":[{"text":"For the weapons we have decided to roll 1d6 times on our weapons table so the syntax for that is ","type":"text"},{"text":"[1d6x][Weapons Stock]","type":"text","marks":[{"type":"code"}]},{"text":". This is exactly the same syntax that you would use in a table to call another table a random number of times. For Gear we want a certain minimum number so we have used","type":"text"},{"text":" [1d10+4] ","type":"text","marks":[{"type":"code"}]},{"text":"which will give us between 5 and 14 items of gear. For Armor we just want two items so we have just called the armor table we created twice in two separate lines. The Magic Items we have done a slightly different way by creating a table which calls another table from the Dungeon Master's Guide a random number of times.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that we have linked the items in the tables we are calling so the template recreates those links in the story entry and those can then be dragged to a parcel or to a player or the whole story can be shared with a player or the entire group.","type":"text"}]},{"type":"paragraph","content":[{"text":"The graphic above shows how we've built the template to include the stock items and the resulting story entry.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Numbers only","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":633,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":521,"alt":"image-20240502-231158.png","id":"b84351c6-49ff-4a65-b88e-d57f62d67555","collection":"contentId-996640973","type":"file","height":76}}]},{"type":"paragraph","content":[{"text":"We don't need to call tables in the template, we can also use random numbers to generate information. In our case we want to have a limit to the number of gold pieces that the shop has available and also to have a number we can refer to when calculating how much more expensive the items for sale are compared to the normal prices. To do this we once again need square brackets but this time we just put in a dice function. So if we want a random number between 1 and 5 we need ","type":"text"},{"text":"[1d6]","type":"text","marks":[{"type":"code"}]},{"text":". The graphic on the right shows the two functions we need to create the gold prices and the percentage price increase.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"A Chat Bubble","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":727,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":727,"alt":"image-20240502-231213.png","id":"552e7b37-9e44-41ff-b0ee-3607da872781","collection":"contentId-996640973","type":"file","height":121}}]},{"type":"paragraph","content":[{"text":"Story Templates have one last thing that we can do; we can create a speech bubble which can include some of the information that we have randomly generated. To do this we create a sentence or two of text and where we want to insert one of the randomly generated items in our template we insert the same name as the table we called but this time we use ","type":"text"},{"text":"<>","type":"text","marks":[{"type":"code"}]},{"text":" instead of square brackets. For example the name of our store is [Name One][Name Two]; to include this in a sentence we would write something like:","type":"text"}]},{"type":"codeBlock","content":[{"text":"The name of the store is < Name Two>.","type":"text"}]},{"type":"paragraph","content":[{"text":" When the story is generated from the template whatever is in the brackets is replaced with the results that were previously rolled up on the tables.","type":"text"}]},{"type":"paragraph","content":[{"text":"The graphic above shows the template structure and the final text after the story has been generated.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Technical Stuff","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Bracketed Text []","type":"text"}]},{"type":"paragraph","content":[{"text":"The story generation feature will attempt to resolve bracketed text in the following order:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Evaluate dice strings","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Only if bracketed text is a valid dice string","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Ex: ","type":"text"},{"text":"[1d4+10]","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Evaluate table multipliers","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Only if bracketed text is a valid dice string ending with a 'x'","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Ex:","type":"text"},{"text":" [1d6x]","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Evaluate table lookups","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Only if bracketed text is the name of a table in the current campaign","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The bracketed text may be following by a pipe symbol '|' and a number to denote a single column lookup on a multi-column table","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Ex: ","type":"text"},{"text":"[250 gp Art Objects]","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"[Slashing Criticals|2]","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the table contains multiple columns, then each lookup result will be combined for the final result.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If preceded by a table multiplier tag, multiple table lookups will be done, and combined.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Any table non-link result text will be saved for tagged text replacement (see below).","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Do nothing, but remove brackets.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"When each bracketed text entry is evaluated, the results are used to replace the bracketed text.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Tagged Text <>","type":"text"}]},{"type":"paragraph","content":[{"text":"The story generation feature will attempt to replace any tagged text with the results generated from a table with a name matching the tagged text. (see bracketed text table lookups above) If the tagged text refers to a table that does not exist, or which was not used in the story template, it will be ignored.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Even More Complex","type":"text"}]},{"type":"paragraph","content":[{"text":"The integration of Story Template Pro has furthered templates to include a few new functions. These functions will be laid out below, but lessons learned earlier will be needed to take full advantage of this new functionality.","type":"text"}]},{"type":"paragraph","content":[{"text":"You can see a breakdown of these elements as well from the code’s creator here:","type":"text"}]},{"type":"blockCard","attrs":{"url":"https://www.youtube.com/watch?v=FKI3e6mHG3I"}},{"type":"heading","attrs":{"level":4},"content":[{"text":"Column Referencing #a|3#","type":"text"}]},{"type":"paragraph","content":[{"text":"Reference single columns of previously rolled table results. These results are stored when rolled and can be referenced multiple times without re-rolling the table that produced said result.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"none"},"content":[{"text":"Table ‘a’:\ncol1: Gnome\ncol2: female\ncol3: Gribbles\ncol4: she","type":"text"}]},{"type":"paragraph","content":[{"text":"Template:","type":"text"},{"type":"hardBreak"},{"text":"The silhouette of a #a|1# appeared in the tavern doorway, ringed in the moonlight from outside. #a|4# strides in and takes a seat next to you. ","type":"text"}]},{"type":"codeBlock","content":[{"text":"The name’s #a|3#” #a|4# says as #a|4# motions for the bartender.","type":"text"}]},{"type":"paragraph","content":[{"text":"Output:","type":"text"},{"type":"hardBreak"},{"text":"The silhouette of a Gnome appeared in the tavern doorway, ringed in the moonlight from outside. She strides in and takes a seat next to you. “The name’s Gribbles” she says as she motions for the bartender.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Callout Custom Naming [:a:b]","type":"text"}]},{"type":"paragraph","content":[{"text":"Create custom reference names for table results you generate. This helps further help reference results of previous tables, by placing them in a variable like name that can be referenced. This name then can be called upon when the template is generated and helps organize output within the template.","type":"text"}]},{"type":"codeBlock","content":[{"text":"[:Color:eyes] > Blue\n[:Color:teeth] > Yellow\n > Blue","type":"text"}]},{"type":"paragraph","content":[{"text":"Rolled on the NPC table four times and stored results within each new name.","type":"text"}]},{"type":"codeBlock","content":[{"text":"[:NPC:Spy]\n[:NPC:Bartender]\n[:NPC:Jester]\n[:NPC:Vagrant]\n\n[:?NPC:Badguy]\n#Badguy|2# > Jimmy","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Callout Internal Rolling [:[a] [b]:c]","type":"text"}]},{"type":"paragraph","content":[{"text":"Roll on tables within tables. This sets up a roll on nested tables and keeps the contents of that roll to be referenced later in the generated story.","type":"text"}]},{"type":"codeBlock","content":[{"text":"[:[race] [gender] name:Bartender]","type":"text"}]},{"type":"paragraph","content":[{"text":"Now you can not only reference each column of the result individually with ","type":"text"},{"text":"#Bartender|1#","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"#Bartender|2#","type":"text","marks":[{"type":"code"}]},{"text":", but also works to deliver ","type":"text"},{"text":"[race] [gender]","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Callout Internal Referencing []","type":"text"}]},{"type":"paragraph","content":[{"text":"Use table references to determine which tables to roll on. You can further use the reference to further use it to roll on tables with the same name or nested tables.","type":"text"}]},{"type":"codeBlock","content":[{"text":"You stumble upon a [race] settlement.\nThe mayor, an old named [ name] greets you.","type":"text"}]},{"type":"paragraph","content":[{"text":"If the race table originally rolled “Dwarf”, then it will get inserted into the Callout Internal Reference and the resulting","type":"text"},{"text":" [Dwarf name] ","type":"text","marks":[{"type":"code"}]},{"text":"table will be rolled upon.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Callout Internal Column Referencing [#a|3#]","type":"text"}]},{"type":"paragraph","content":[{"text":"Use internal column references to determine which table to roll on.","type":"text"}]},{"type":"paragraph","content":[{"text":"[#NPC|7# name]","type":"text","marks":[{"type":"code"}]},{"text":" might roll on ","type":"text"},{"text":"[Elf name]","type":"text","marks":[{"type":"code"}]},{"text":", if the 7th column of the NPC table was race.","type":"text"}]},{"type":"paragraph","content":[{"text":"[ #NPC|2# name]","type":"text","marks":[{"type":"code"}]},{"text":" might roll on ","type":"text"},{"text":"[Human Female name]","type":"text","marks":[{"type":"code"}]},{"text":" if you wish to further use a combination of the results","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Hidden rolls (using “?”)","type":"text"}]},{"type":"paragraph","content":[{"text":"Hide rolled table results in the generated story. This will roll on said table, but won’t show the results within the story template. This result however can be referenced and keep output text cleaner.","type":"text"}]},{"type":"paragraph","content":[{"text":"Works with many callouts:","type":"text"},{"type":"hardBreak"},{"text":"Regular Callouts: ","type":"text"},{"text":"[?a]","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Callout Custom Naming: ","type":"text"},{"text":"[:?a:b]","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Callout Internal Rolling: ","type":"text"},{"text":"[:?[a][b]:c]","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Cross-Template Reference: ","type":"text"},{"text":"{:?a:b}","type":"text","marks":[{"type":"code"}]}]},{"type":"codeBlock","content":[{"text":"[?NPC]\n#NPC|1# went home. #NPC|7# #NPC|3# pulled #NPC|16# coat off and #NPC|1# reached for the shades.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Date Calls with formatting [Date:FORMAT] and [FGDate:FORMAT]","type":"text"}]},{"type":"paragraph","content":[{"text":"Insert dates into your stories based on either the computer clock or FGU calendar. Date calls the date from your computer clock and FGDate from the Fantasy Grounds calendar. You will need to load the calendar first before working with this template function.","type":"text"}]},{"type":"paragraph","content":[{"text":"You can enter the below strings in any way or order you wish within the callout, and it will work.","type":"text"},{"type":"hardBreak"},{"text":"You can make up your own formats like [Date:The ddd of month, in the year yyyy] or [FGDate:dd/mm: yy] as examples. Fantasy calendars are now supported for [FGDate:FORMAT] callouts.","type":"text"}]},{"type":"codeBlock","content":[{"text":"For these examples, assume the date is November 2 1984\n\"yyyy\" = 1984\n\"yy\" = 84\n\"month\" = November\n\"mm\" = 11\n\"mmm\" = Nov (only works with Gregorian Calendar. Fantasy Calendars don't have abbreviations stored anywhere to use for this)\n\"day\" = Friday\n\"dd\" = 2\n\"ddd\" = 2nd (adds a numerical suffix ie: 1st, 2nd, 3rd, 4th etc.)\n\"epoch\" = AD\n\"oldschool\" = Friday, the 2nd of November, in the year of our Lord: Nineteen Hundred and Eighty Four (Still only works with the system calendar/[Date:FORMAT], not a fantasy calendar/[FGDate:FORMAT].)","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Cross-Template Referencing!!! (aka \"passing parameters in\") {:a:b} to call/store, {b}, and {#b|3#} to reference/retrieve","type":"text"}]},{"type":"paragraph","content":[{"text":"Use rolled results from one template, within other templates!","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Table ‘a’ has 4 columns of data","type":"text"},{"type":"hardBreak"},{"text":"Story Template 1","type":"text"},{"type":"hardBreak"},{"text":"{:a:b} = Prints col1 col2 col3 col4","type":"text"}]}]},{"type":"paragraph","content":[{"text":"This stores the output for later use.","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Story Template 2","type":"text"},{"type":"hardBreak"},{"text":"{b} = Prints table a’s output as it retrieves the rolled result and prints col1 col2 col3 col4","type":"text"},{"type":"hardBreak"},{"text":"{#b|4#} = Prints only the table result of ‘a’ that is col4","type":"text"}]}]},{"type":"paragraph","content":[{"text":"This will persist while the campaign is running, but will not be available on a reload of the campaign.","type":"text"}]}],"version":1}