Tutorial: Random Generators (Prelude)
This tutorial takes you from creating a simple generator that outputs one of several names each time you click it to (eventually) a full character article generator with a name, some sidebar information, and a background description. This tutorial is intended to teach you how to create the generators, routers, and templates and then combine them to achieve a simple random generator. This tutorial is NOT intended to teach you how to design random generators or how to collect data to feed them with. Each tutorial step introduces one or two new concepts. At the end of each tutorial is a finished and usable random generator. The public page for that result is linked at the top of each article.
WORK IN PROGRESSThe goal of this tutorial is to give users a document to follow along and eventually create a simple character generator. Each article will detail one step and build on previous lessons. In most cases, it makes sense to read and follow them in order.
GlossarySome important terms used in this tutorial:
- Random Generator: This is the name for the feature as a whole. In some contexts, this is shortened to generators, but should not be confused with the generator.
- Generator: A resource which takes a list of something and returns a random item from that list each time you roll it. One of the three basic building blocks for Random Generators.
- Router: Takes the output from a generator and translates that result to something else depending on what the output of the generator is. The second basic building block for Random Generators.
- Template: Combines generators, routers and other templates to create a result. This result is either displayed or can be copied as BBCode. Each template has a public page that can be shared with other people. This is the third building block of Random Generators.
- Resource: A term used in this tutorial to refer to all three building blocks at the same time.
- Generator Variables: The output of generator, router and templates is stored in a generator variable. This value can be reused in other parts of the template and are the input for routers.
- Public Page: This refers to the page where the random generator can be used. This page can be shared with others as well.
- JSON Payload: The content of generators and routers. In this tutorial, the JSON Payload will always be provided for each step. To create your own use a copy of this google sheet template. The sheet is created and maintained by Vertixico. In general, try to avoid editing JSON by hand as it is error-prone!