Learning ChoiceScript: Part 1: Playing “My First ChoiceScript Game”

Learning ChoiceScript

ChoiceScript is a scripting language from Choice of Games LLC for creating choose-you-own-adventure games.


Many games created in ChoiceScript can be played on their site. However, while these are hosted, the example “My First ChoiceScript Game” is not and needs to be downloaded before it can be played.

Downloading “My First ChoiceScript Game”

The example can be found through this direct link or on the GitHub page.

Once downloaded, extract the archive and open the folder.

Screenshot 2018-08-19 11.09.59

In the web sub-folder, open “index.html” in Firefox or another browser. (The example WILL NOT work in Chrome.)

Screenshot 2018-08-19 11.11.46

Playing “My First ChoiceScript Game”

Screenshot 2018-08-19 11.14.52

Once opened, the example can be played in the browser, making choices and clicking “Next” to progress through the scenes.

During playing, clicking “Restart” will restart the game. Clicking “Show Stats” will show the current statistics. Clicking “Settings” will show the options for changing the background or different font choices.


Editing “My First ChoiceScript Game”

Screenshot 2018-08-19 11.18.08

Within the web folder is a “mygame” sub-folder containing the files for the game. To play the game, open the “index.html” file. To change its contents, open the text files in the folder “scenes” starting with “startup.txt”.

Screenshot 2018-08-19 11.20.21

Changing lines 18 and 19 allows for updating the title and author of the game.

Screenshot 2018-08-19 11.23.01

Both are examples of commands, keywords used in ChoiceScript for programming purposes.

Screenshot 2018-08-19 11.27.32

After saving the changes and refreshing the file in the browser, the updates will show up in the example game.