Difference between revisions of "Tag Reference"

From Wildermyth Wiki
Line 14: Line 14:
! tag !! example !! might render as !! explanation
! tag !! example !! might render as !! explanation
|-
|-
| Town || <town> || Ninesprings || Finds either the nearest town, or the origin town for the heroes.
| Town || &lt;town&gt; || Ninesprings || Finds either the nearest town, or the origin town for the heroes.
|-
|-
| Company || <company> || The Fellowship of the Eagle || Gives the name of the player's company, which they get a chance to choose at the end of the introduction.
| Company || &lt;company&gt; || The Fellowship of the Eagle || Gives the name of the player's company, which they get a chance to choose at the end of the introduction.
|-
|-
| Site || <site> || Moosetunnel || Finds the relevant site in a situation, if there is one, or falls back to the nearest interesting site.
| Site || &lt;site&gt; || Moosetunnel || Finds the relevant site in a situation, if there is one, or falls back to the nearest interesting site.
|-
|-
| Tower|| <tower> || Cranespire || Finds the name of the Heroes' main base, their home tower, which they gain control of during the introduction.
| Tower|| &lt;tower&gt; || Cranespire || Finds the name of the Heroes' main base, their home tower, which they gain control of during the introduction.
|}
|}


Line 32: Line 32:
Use these tags to insert names.
Use these tags to insert names.


singular plural
.
firstname
shortName
firstName
name
lastname
lastname
shortname
fullname
fullname
singular
plural


{| class="wikitable"
|-
! tag !! example !! might render as !! explanation
|-
|  || &lt;leader&gt; || Barlox || Use a plain role tag to show the short name, which, for heroes, is always their first name.
|-
| shortName || &lt;leader.shortName&gt; || Barlox || Short name. Same as unadorned role.
|-
| firstName|| &lt;leader.firstName&gt;|| Barlox || First name. Same as short name.
|-
| name || &lt;leader.name&gt;|| Barlox || Same as short name and first name.
|-
| lastName || &lt;leader.lastName&gt; || Spidermusk || If the entity has a two-part name, return the last part.
|-
| fullName || &lt;leader.fullName&gt; || Barlox Spidermusk || The whole name. Very formal.
|-
| singular || &lt;foes.singular&gt; || Gorgon || Useful for monsters, if you want the singular version of the monster group name.
|-
| plural || &lt;foes.plural&gt; || Gorgons || Gives the plural version of the name of a group of monsters.
|}


==Selectors==
==Selectors==

Revision as of 10:50, 9 February 2018

Wildermyth accomplished Dynamic Writing by using Tags to control what text is inserted into a passage.

Tags use <angle brackets> and allow a fairly wide variety of functionality.

Note: mostly case insensitive Note: comma and slash as separators, most of the time!


Top-Level Tags

These are simple tags that work in any context and insert names of interesting things.

tag example might render as explanation
Town <town> Ninesprings Finds either the nearest town, or the origin town for the heroes.
Company <company> The Fellowship of the Eagle Gives the name of the player's company, which they get a chance to choose at the end of the introduction.
Site <site> Moosetunnel Finds the relevant site in a situation, if there is one, or falls back to the nearest interesting site.
Tower <tower> Cranespire Finds the name of the Heroes' main base, their home tower, which they gain control of during the introduction.

Role Tags

Most tags and the most useful tags rely on Story Roles. A role is used to refer to a particular target, usually a hero, and then select text depending on properties of the target.

Note: role, or role plus number.


Names

Use these tags to insert names.

. shortName firstName name lastname fullname singular plural


tag example might render as explanation
<leader> Barlox Use a plain role tag to show the short name, which, for heroes, is always their first name.
shortName <leader.shortName> Barlox Short name. Same as unadorned role.
firstName <leader.firstName> Barlox First name. Same as short name.
name <leader.name> Barlox Same as short name and first name.
lastName <leader.lastName> Spidermusk If the entity has a two-part name, return the last part.
fullName <leader.fullName> Barlox Spidermusk The whole name. Very formal.
singular <foes.singular> Gorgon Useful for monsters, if you want the singular version of the monster group name.
plural <foes.plural> Gorgons Gives the plural version of the name of a group of monsters.

Selectors

Selector tags select between alternatives, depending on some aspect or stat of the target.


exists sp others....