Changes to the Gain and Loss templates

From Fallen London Wiki

Hi all, The latest improvements to {{Gain}} and {{Loss}} (see discussion here) are now live.

These templates have come a long way in usability since the early days of separate templates for every message. The big remaining source of awkwardness was the multitude of message and amount parameters (nine total across Gain and Loss). For editors this meant remembering many use cases and different behavior. Internally, having many separate parameters made supporting new messages increasingly difficult.

I've simplified the parameters into two pairs with separate functions. Only one of each pair can be used at a time.

  • Value parameters indicate the numerical component of a change.
    • {{{2}}} (the second unnamed parameter) indicates a relative change, i.e. +1 to your number of Cryptic Clues. It is unchanged from before.
    • now indicates the result of a change, i.e. you now have exactly 1 Cryptic Clue regardless of how many you had before. This is now used for all such changes, where previously some values were given to the now-deprecated occurrence and to parameters.
  • Message parameters provide alternate text to display for the change message.
    • message replaces the change message with italicized custom text. Use {{UnI}} for non-italicized text if it's not a supported special message. It is unchanged from before.
    • special message, or the shorthand sm, is a new parameter consolidating the previous special message parameters.
      • This parameter takes a keyword for the message to display, with the old special message parameters becoming keywords. The old parameters which took value input should now use the appropriate value parameter, typically now.
      • Some keywords are only usable for one of Gain or Loss, or behave differently between them.
      • Some keywords require a specific value parameter. Some allow both, or neither. Some allow a value but do not require one.
      • So far there are three newly-supported messages:
        • venture for "Begun a new venture! <name>", used in old content
        • wqnow for "<name> is now (new value).", used by world qualities
        • wqcontributed for "You have contributed to <name>.", used by world qualities

I'll update the template documentation for the new parameters and with detailed explanations of each keyword within the next couple days.