Template:Gain

Template documentation (for the above template, sometimes hidden or invisible)

This template is used for Effects that increase qualities and items. It replaces the old system, and fully supports both item gains (formerly {{Item Gain}}), and pyramidal qualities (formerly {{Increase}}).

Usage: {{Gain|A|B|<params>}}

• The first parameter is the name of the item or quality.
• The second parameter is the amount gained. Standard formatting is "#" for discrete qualities, "# x" for items, and "+# CP" for pyramidal qualities.

Parameter list

• image, this parameter is used to set a custom image. Its value is the image name to be used, including the .png postfix but without the File: prefix. Please note that this should be the small version of the file (so ending in small.png). Also note that this will now only apply to the image at the front; changing the image of later {{IL}}'s is no longer supported. Set this to "none" to not display an image.
• {{{1}}}, ie the first unnamed parameter defines the quality or item that is being increased, with its value being the full pagename of this quality.
• {{{2}}}, ie the second unnamed parameter defines the amount by which the first unnamed parameter. Its value is the numerical increase, including either the x or the CP postfix. Do not use this parameter if one of the following two parameters are used.
• Appearance, this parameter overwrites how the selected quality or item is displayed. Can be use to add italics or change the text entirely.
• occurrence, this parameter is used when the quality change starts with An occurrence. Its value is the new numerical value of the quality. Note that some of the templates allowed the use of |occurrence=yes with the |now parameter having the numerical value, but that this behavior is now deprecated.
• to, this parameter is used when the quality change looks like x has increased to y. Its value is the new numerical value of the quality.
• message, this parameter is used to define a custom message for the quality/item increase. Note that this will not work if either |occurrence or to are set.
• now, this parameter is used to when the action sets a quality/item to a specific level, but doesn't use either |occurrence or to. Note that {{{2}}} and {{{message}}} do work with this one, and for pyramidal qualities {{{message}}} is required.
  • This parameter is not used for "You now have <number> x <item>" messages used when a player previously had none of the item gained, which should be represented by the basic {{Gain|A|B}} format.
• twist, this parameter is used when the quality change looks like A twist in your tale! You are now x. Its value is either no (default) or yes.
• hidden, this parameter is used to define whether the change is hidden or not. If the change is hidden set this to yes, otherwise don't include it.
• Cap, if a action can only raise a quality/item to a specified amount set this parameter to that value.

Note: global caps (such as 15 on notability) are automatically included by the template.

• suppress properties, when set to yes the template will not add the Gain categories or properties to the page.

No description.

Template parameters

This template prefers inline formatting of parameters.

Parameter		Description	Type	Status
Name	1	The name of the quality/item being gained.	Page	required
Quantity	2	The amount gained by this action, which should either be count of levels for items and Discrete qualities, or number of Change Points for Pyramidal. Pyramidal qualities require the ' CP' or ' x' postfix. Example 5 x, or +2 CP	Line	suggested
Image filename	image	Changes the image link displayed before the text. Set this to "none" to not display an image. Default The default image for a quality is stored in Property:Has icon.	File	optional
Custom appearance	Appearance	If the increased quality should have custom formatting like italics, this property can be used to overwrite the displayed text.	String	optional
Occurrence!	occurrence	If the game text for the action result begins with "An occurrence!", then set this parameter to the new value of the quality.	Line	optional
Set to	to	If the result of the action sets this quality to a specific level, instead of increasing it, then set this parameter to the new level (including level description) unless "occurrence" is more appropriate.	Line	optional
Custom Message	message	If the quality increase include a custom message set this parameter to that message	String	optional
Now	now	If the result of the action sets this quality to a specific level, instead of increasing it, then set this parameter to the new level. Unlike Set to and Occurrence this one will work with 2 and Message, and it is required when using Now for a pyramidal quality. Note that this parameter is not used for the "You now have <number> x <item>" message from gaining items for the first time.	Unknown	optional
Twist	twist	If the game text for the action result begins with "A twist in your tale", then set this parameter to the name of the quality/item being gained. Disables all other parameters	String	optional
Increase Cap	cap	If there is a limit on how much the action can increase the quality set this to that value.	Number	optional
Hidden Gain	hidden	If the action result is hidden ingame set this parameter to yes.	Boolean	optional
Suppress properties	suppress properties	When "yes", displays the template without adding the corresponding categories and properties to the page.	String	optional

Visit Template:Gain/doc to edit this text! (How does this work?)