Rows¶

The basic building block of Interactive CYOAs made with this creator is the Row. Rows are not only the sections that divide the CYOA up, but it is only attached to a Row where Choices can exist. In that way, Rows can be seen as groups of Choices.

Creating Rows¶

Create a Row by opening up the sidebar and pressing Create New Row.

Cloning Rows¶

Deleting Rows¶

Editing Rows¶

Row Title¶

By default, the row title will be Row.

As Rows are generally sections (such as Powers, Perks, Drawbacks, etc), you should name your Row after what the Objects represent.

To edit the Row Title, simply edit the text in the Row Title section.

Row Text¶

Row Text can be used to provide a description of the section.

You can also use it to provide notes specific to the section in particular, such as informing the players that they can select only 1 option.

To edit the row text, simply edit the text in the Row Text section.

Allowed Choices¶

The Allowed Choices options allows you to restrict the amount of choices a player can pick in that row. It takes a non-negative integer (anything above zero).

If you want ANY number of options with no limits, simply put 0 into the field.

This is used for sections where you might say "You may only take X options".

There will be a way to dynamically change this amount, but we’ll come back to that later (to skip ahead, see here).

Selected Choices (Input)¶

The Selected Choices field will show how many choices are currently selected, and should normally be 0. An exception would be choices that are selected by default.

If it is something other than 0 and no choices are selected, then something has gone wrong. You can fix this by changing the value to 0.

Objects Per Row¶

The Objects Per Row option allows you to specify how many Objects should be present within an Object row.

'Row' Objects per Row¶

Most Objects per Row options seem pretty straightforward, but this one in particular might get confusing. It is in fact not used by a Row (though the option is bafflingly there), but is instead used for individual Objects' Object Width.

To give context, individual Objects of a specific Object row (not referring to the Row object, but an actual row—as opposed to column—of Objects) can set a custom Object Width, allowing further customization and deviance from a Row's Object per Row setting.

• For example, you can have one row have two Objects take up an entire row by setting both of their Object Widths to 2 per Row, and the next row could have five Objects take up the entire row by setting their Object Widths to 5 per Row.

Objects have an Object Width of Row by default, and that means that their width is equal to whatever is set by the Objects per Row setting. This is convenient in that you don't need to go into each and every choice width and update it, instead only updating the Objects per Row once.

If you have changed an individual Object's Object Width, then setting back to Row resets it back to the default width.

Non-Activatable?¶

This option makes it so Objects are unable to be chosen.

This can be used when you just want to supply information using Objects.

Objects are great for this because they allow you to split information into chunks, each with an image able to be attached, as well as any Addons that might be attached to said Objects.

Selected Choices? (Switch)¶

The Selected Choices? switch enables a whole host of other options that have to do with the Objects in the Row.

Options here can do two things:

1. They display choices you've already selected, and
2. They can change something about all Objects in the Row

By default a Row with this on will collect all choices that are selected. You can use the below switch to filter this into only the Objects from the Row you want Alternatively, if you don't make a group by Row, and instead Add To Group on Objects manually, you can further refine your selection.

Selected Choices from Group Id¶

The Selected Choices from Group Id switch displays selected choices, but only if they are a part of the same Group.

Although the Process tab shows how to set up a Group for this demonstration, it is not fully detailed. In-depth detail on Groups is provided here.

Choices will all be 'Template Top' and Row Width¶

This will set it so that each choice that appears in a Selected Choices Row will be normalized. Every image will be at the very top, and it will have Row Width by default (see here for an in-depth discussion on that).

Remove the text of the choices¶

This will, as it explains, remove the body text/description from choices, leaving only the title and images.

Show the title of the row in the choice.¶

Another self-explanatory one, it will display the title of the Row above the choice's title. This is quite useful in cases where you have a list of choices that occur from more than one section, so that you can tell choices apart.

Half of the Screen?¶

This switch will allow you to have two Rows, each on one half of the screen. This option can be quite useful.

Deselect choices when Row lacks requirements?¶

This switch deselects all the selected choices if the Row itself lacks requirements (and thus is most likely invisible).

If this option is off, then selected choices are preserved.

Row List (Side Menu)¶

See here.

Change Image¶

This button allows you to upload an image to the Row. See more at Images.

Row Settings¶

The Row Settings menu is a menu accessed from any Row.

To access it, press the button at the very top right inside of the Edit Row menu.

This will open up the Row Settings menu:

Sort The Choices In The Row¶

This option allows you to change the order of the choices within the Row. This can be quite a useful option. It is found within the Row's settings.

To access it, open Row Settings → Choose an option for sorting → Press Sort.

The options are:

• Object Width - Biggest to Smallest.
• Object Width - Smallest to Biggest.
• Text Length - Longest to Shortest.
• Text Length - Shortest to Longest.

Object Width sorts by how much space in a row Objects take, whereas Text Length sorts by how much text is within the Object Text field.

Copy Choices Into Another Row¶

This option allows you to copy all the Choices of one row into another Row.

Copy this row's objects into...¶

This is a dropdown menu which lists all of the Rows in your project by their title.

Copy¶

This button copies all of the Choices of the Row whose settings you are in, into the Row you've selected in the dropdown list.

Copy and Delete¶

The same as copy, except it deletes the original Row where it came from.

Why use this instead of cloning the entire Row? Well, let's say we have three Rows:

1. Male Companions
2. Female Companions
3. AI Companions

And you had already configured Scores and Requirements, and didn't want to redo it all. You could clone them separately, but they would not combine into one.

With this method, you can create a new Row named Companions, and go to each of the Rows and Copy and Delete the Choices in each of their Rows, effectively combining their Choices, including all of the Scores and Requirements therein.

Group Membership¶

This option allows you to add all Choices in the Row to any Groups you have set up.

See Groups.

Reference¶

(EX TODO) Make a Row invisible¶

If you want to make a Row invisible, simply add a Selected Choice requirement, but simply don't put any ID in its place. This will permanently collapse the Row.

Alternatively, put an ID in there that is guaranteed not to get picked, such as MAKE_ME_INVISIBLE.

Hide a Row until a Choice is pressed¶

Rows can be hidden by using the Add Selected Choice requirement. In order to open a Row, you would need to select a choice.

Now, of course, you do not need to use Selected Choice to hide rows, and can use any number of requirements. It is, however, the most common requirement to use.

Nested Rows¶

While nested Rows can be useful, especially for long ICYOAs which require a lot of scrolling, there can be a couple of downsides.

1. Nesting more than 2 down levels can lead users to be confused and annoyed as to where certain sections are.
2. If Nested Rows are not set up properly, they can leave Orphaned Rows.

Orphaned Rows occur when a chain of Nested Rows aren't set up so that closing the topmost parent Row closes not just any Rows that depend on it, but also Rows that depend on the topmost Row's dependent, and so on and so forth.

To do this, use Selected Choice requirements for each nesting level.

u/Traveller-81 goes into more detail here:

(EX TODO) Combining Multiple Requirements¶

Chaining multiple requirements onto one object means that you require all of those requirements in order to allow the object to be chosen or shown.

(WIP) Nesting Multiple Requirements¶

Nesting multiple requirements means to apply requirements onto requirements themselves. This type of advanced behaviour can get quite unwieldy.

Comments