* Option

Collection of player selectable options

Another essential element for games with story branching is asking the player what they want to do or say in a specific situation. This is expressed in Quillscript as an Options collection.

An Option statement starts with an * (asterisk), immediately followed by a whitespace.

Highlighted

Source

- Innkeeper
  Do you want to rent a room?

* Yes, please.
* No, thank-you.

You can sequence as many options as you want; just remember to design your Selection Box widget accordingly.

---

Multiline Text Option

Options' texts can also come in multiple lines, using a second asterisk, and adding the option text in the following line.

Highlighted

Source

- Innkeeper
  Do you want to rent a room?

* *
  Yes, please.
  With a big bed and view.

* No, thank-you.

Navigation

As you can see, the above options do nothing after being chosen. You can use an option to move to a desired point of the story by concatenating a Router as instruction.

Highlighted

Source

- Jack
  Where should we go?

* New York city. | -> NewYork
* Los Angeles.   | -> LosAngeles
* Home.          | $ End

@ NewYork
- Jack
  New York! New York!
$ End

@ LosAngeles
- Jack
  All right let's go meet some celebrities.
$ End

Execute Commands

Another common use is executing a Command as instruction within an option, like handling a variable or calling a function.

Highlighted

Source

- Alice
  What is your name?

* Jack    | name = Jack
* Richard | name = Richard
* Tom     | name = Tom

- {name}
  My name is {name}