User Tools

Site Tools


actions

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

actions [2013/12/16 23:17]
l
actions [2017/10/09 20:39]
Line 1: Line 1:
-===== <<​actions>>​ ===== 
- 
-The <<​actions>>​ macro presents the player with a set of passage links, presented in a bullet-point list, that can only be clicked once per game. 
- 
-====Usage==== 
- 
->​%%<<​%%actions //"​string"//​ ... %%>>​%% 
- 
-An unlimited number of strings can be provided to <<​actions>>​. Each string is interpreted as a passage title, and produces a link to that passage using the title as the link text. 
- 
-==== Motivating example === 
- 
-Suppose you're writing a passage like this: 
- 
-> The door opens into a narrow sloping corridor which leads into another chamber. The walls are covered with hieroglyphics,​ and there are three clay pots standing on top of a stone table. Will you: 
- 
-> Lift the lid of the white pot? Turn to **14** 
-> Lift the lid of the black pot? Turn to **156** 
-> Lift the lid of the red pot? Turn to **183** 
-> Walk through the chamber to the archway in the far wall? Turn to **20** 
- 
-(Ian Livingstone,​ //Temple of Terror//) 
- 
-Lifting the lid of one pot shouldn'​t preclude the protagonist from lifting the lid of another afterwards — assuming, of course, that the pots don't kill the protagonist (which, unfortunately,​ they often do in these kinds of gamebooks). The ''<<​actions>>''​ macro shows the reader a list of choices, excluding any he has already seen. You can combine this with the ''<<​display>>''​ macro to implement the passage above: 
- 
-<​code>​ 
-:: Pot Chamber 
-The door opens into a narrow sloping corridor which leads into another chamber. 
-The walls are covered with hieroglyphics,​ and there are three clay pots 
-standing on top of a stone table. 
-<<​display "Pot actions">>​ 
- 
-:: Pot actions 
-<<​actions "Lift the lid of the white pot" "Lift the lid of the black pot" 
-          "Lift the lid of the red pot" "Walk to the archway">>​ 
- 
-:: Lift the lid of the white pot 
-There are chocolates inside! And they'​re delicious. 
-<<​display "Pot actions">>​ 
- 
-:: Lift the lid of the black pot 
-There'​s licorice inside. You've never been that much of a fan, but maybe 
-someone you encounter on your quest will like them. 
-<<​display "Pot actions">>​ 
- 
-:: Lift the lid of the red pot 
-It's empty! Looks like someone got here before you did. 
-<<​display "Pot actions">>​ 
- 
-:: Walk to the archway 
-You continue on your brave quest... 
-</​code>​ 
- 
-The reader can open one, none, or several pots in the room before proceeding onward. 
  
actions.txt · Last modified: 2017/10/09 20:39 (external edit)