Player Choices

Player choices are the main way to interact with the user, by presenting them with a list of [TEXT] choices, and executing a list of instructions associated to the choice they have made.

CHOICE OPTION

(option [TEXT]
   [I0 = INSTRUCTION]
   ...
   [IN = INSTRUCTION]
)

Adds a choice showing [TEXT] to the user, and executing [I0] … [IN] if chosen.

CHOICE PROMPT

(player_choice!
   [C0 = CHOICE]
   ...
   [C1 = CHOICE]
)

Prompts the user to choose between C0 … C1. [CHOICE]. [CHOICE] is either an option as shown above, a conditional, or a for_each (see loops) with [CHOICE] instead of [INSTRUCTION]. A special version of the for loop is also possible, as described below:

USER CHOICE - FOR

TODO

COMMAND PROMPT

(prompt_command! [(STRING LIST) REFERENCE] [MIN = INT] [MAX = INT] [TEXT])

Prompts the user for a list of strings separated by spaces. [MIN] and [MAX] indicate the total number of characters (spaces included) allowed as input. The [TEXT] message is prompted to the user. The result is stored in [(STRING LIST) REFERENCE].

FLOAT PROMPT

(prompt_float! [FLOAT REFERENCE] [MIN = FLOAT] [MAX = FLOAT] [TEXT])

Prompts the user for a float between [MIN] and [MAX] by displaying the message [TEXT]. The result is stored in [FLOAT REFERENCE].

INTEGER PROMPT

(prompt_integer! [INT REFERENCE] [MIN = INT] [MAX = INT] [TEXT])

Prompts the user for an integer between [MIN] and [MAX] by displaying the message [TEXT]. The result is stored in [INT REFERENCE].

STRING PROMPT

(prompt_string! [STRING REFERENCE] [MIN = INT] [MAX = INT] [TEXT])

Prompts the user for a string of size between [MIN] and [MAX] by displaying the message [TEXT]. The result is stored in [STRING REFERENCE].