Expansion tokens are embedded sequences of characters that are replaced with the information that it describes. For example
Expansion Tokens[ | ]
The following table describes the expansions that are available
Expansion Token | Definition |
---|---|
X.name | The person’s street name. |
X.honorific | The person’s honorific (depending on gender, etc). E.g. “Mr.” |
X.his | “his” or “hers” depending on gender |
X.him | “him” or “her” depending on gender |
X.he | “he” or “she” depending on gender |
X.man | “man” or “woman” depending on gender |
X.guy | “guy” or “lady” depending on gender (more informal version of X.man). |
X.race | the person’s race (e.g. “troll”) |
X.race_plural | the person’s race pluralized (e.g. “trolls”). |
X.sir | “sir” or “madam” depending on gender |
X.freund | “mein Freund” or “meine Freundin” depending on gender |
X.firstname | (Hong Kong only) The person's first name. |
X.lastname | (Hong Kong only) The person's last name. |
X Prefix[ | ]
The X prefix must be replaced with one of the following:
Prefix | Definition |
---|---|
s | Speaker |
l | Listener |
story | Story (global) variable |
scene | Scene variable |
Modifiers[ | ]
There are also modifiers that can be applied by embedding a code between the $ and the ( in the expansion:
- $-(...) -- Cause the expanded text to be all lowercase
- $++(...) -- Cause the expanded text to be all uppercase
- $+(...) -- Cause the first letter to be uppercase, and the rest remain untouched
Examples[ | ]
“Hello, $(s.name)!” would be replaced with the speaker’s name(e.g. “Hello, Maclusky!”). If an expansion cannot be found or inferred, the raw text should come through so it is immediately visible as an error in the final text.(e.g “Hello, $(unknownexpansion).” would result in the same string unmodified.)
- “Kill $(l.him)!”
- “I wouldn't expect a $(l.race) like you to understand."
- "We $(s.race_plural) are far superior intellectually.”
- “Look $(l.guy), I don’t have time for this!”
- “You have killed $(scene.NumRatsKilled) of 10 rats.”