-- added support for custom lists to the game! Much like the arrays of Telepath Tactics, these lists will take any sort of string as an entry (but entries from these lists can often be used as integers, since all integers used in the dialogue system are converted to ints from strings at runtime anyway).
-- new action:
SetList. This creates a new, empty list variable (or clears an existing list variable of entries). One parameter: list name.
This, for instance, will create a new, empty list called Names:
SetList/Names-- new action:
AddToList. This adds a new entry to a list variable. (If the named list doesn't exist, the game will create it before adding the new entry). Three parameters: list name, the entry to be added, and (optionally) a boolean stating whether to add it to the beginning of the list. (If the last parameter is left blank, the entry will be added to the end of the list.)
These will add the values "Bertha" and "Ned" to the end of the Names list. Lists always count upwards from zero--thus, Bertha will end up at position 0 and Ned at position 1:
AddToList/Names,Bertha
AddToList/Names,Ned
-- new action:
RemoveFromList. This removes one or more entries from a list variable. Two parameters: list name, and either (a) the integer position of a single entry to remove, or (b) a string value to cull from the list wherever it appears.
-- new action:
ShuffleList. This reorders all of the entries within a list variable at random. One parameter: list name.
-- new special character
LIST{}, which takes two parameters--the name of the list and the position in the list to display, like so:
You want to talk to LIST{Names,0}, eh?
If we don't remove from or shuffle the example list above, this will end up displaying "You want to talk to Bertha, eh?"
-- new special character
LASTINLIST[], which the game automatically replaces with the number of the last position in the list containing an entry. (If there are no entries in the list, this will display as -1.) Takes one variable: the name of the list.
If we don't remove anything from the example list above, this will be replaced with a 1:
LASTINLIST[Names]This can be used in a SetVal action to obtain a random position in a given list, like so...
SetVal/RandomPosition,r:LASTINLIST[Names]...and then the val can be used as part of a LIST{} special character to display the randomly chosen entry!
LIST{Names,-VAL:RandomPosition-}(See the image attached to this post for a more full-featured example.)
-- the
r operation now produces an integer number between 0 and the chosen number (before, it produced an integer between 1 and the chosen number).
-- added a new, optional third parameter to the
Teach action; a boolean variable which, if set to
true, causes the game to pop up the leveling screen with a summary of what the learning character just learned. (If not used or set to
false, the game will stay quiet about the event.)
While not trivial, this was easier to implement than I had feared (albeit almost entirely so because of some smart changes I made to how I save and track data in the new engine).