Template:Spell: Difference between revisions
(More detailed documentation, especially on duration parameters. Revised definition of "Interval" to only show for damage/effect-over-time spells.) |
No edit summary |
||
(17 intermediate revisions by 3 users not shown) | |||
Line 2: | Line 2: | ||
|- |
|- |
||
| |
| |
||
{| style="width: 100%; font-size: 95%; text-align: left; background: #{{# |
{| style="width: 100%; font-size: 95%; text-align: left; background: #{{#switch:{{{type}}} | Defensive=FCFFF8 | Offensive=FFFFF8 | Attack=FFF8F8 | Healing=FFFCEF | Utility=F8FCFF | F9F9F9}}; margin: 0; border: 1px #aaa solid;" |
||
! colspan=2 style="background:#{{ |
! colspan=2 style="background:#{{#switch:{{{type}}} | Defensive=CF9 | Offensive=FF9 | Attack=F99 | Healing=FC9 | Utility=9CF | DDD}}; font-size: larger; text-align: center;" | '''{{PAGENAME}}''' |
||
|- |
|- |
||
! Mnemonic |
! Mnemonic |
||
Line 21: | Line 21: | ||
! Span |
! Span |
||
{{!}} valign="top" style="white-space: nowrap; text-align: right;" {{!}} {{{span}}} |
{{!}} valign="top" style="white-space: nowrap; text-align: right;" {{!}} {{{span}}} |
||
{{!}}- |
{{!}}- |
||
}}} }} |
|||
{{#if: {{{cast_rt|}}} | |
|||
! Cast Time |
|||
{{!}} valign="top" style="white-space: nowrap; text-align: right;" {{!}} {{{cast_rt}}} |
|||
{{!}}- |
|||
|}} |
|||
{{#if: {{{mana_cost|}}} | |
|||
! Mana Cost |
|||
{{!}} valign="top" style="white-space: nowrap; text-align: right;" {{!}} {{{mana_cost}}} |
|||
{{!}}- |
|||
|}} |
|||
{{ #ifeq: {{{type}}} | Attack | | |
{{ #ifeq: {{{type}}} | Attack | | |
||
{{ #ifeq: {{{type}}} | Defensive | | |
{{ #ifeq: {{{type}}} | Defensive | | |
||
{{ #ifeq: {{{type}}} | Offensive | | |
{{ #ifeq: {{{type}}} | Offensive | | |
||
{{ #ifeq: {{{type}}} | Healing | | |
|||
{{ #ifeq: {{{type}}} | Utility | | ! Type |
{{ #ifeq: {{{type}}} | Utility | | ! Type |
||
{{!}} valign="top" style="white-space: nowrap; text-align: right;" {{!}} {{{type}}} }}}}}}}} |
{{!}} valign="top" style="white-space: nowrap; text-align: right;" {{!}} {{{type}}} }}}}}}}}}} |
||
|- |
|- |
||
{{ #ifeq: {{{type|}}} | Attack | !colspan=2 align=center style="background:#F99;"{{!}}Attack Magic{{ #ifeq: {{{dtype|None}}}| None | |<nowiki></nowiki> - Damage}}{{ #ifeq: {{{status|None}}} | None | |<nowiki></nowiki> - Disabling}} | {{ #ifeq: {{{type|}}} | Offensive | !colspan=2 align=center style="background:#FF9;"{{!}}Offensive Magic{{ #ifeq: {{{weapon|None}}} | None | |<nowiki></nowiki> - Weapon Enhancement | }}{{ #ifeq: {{{enhancement|None}}} | None | |<nowiki></nowiki> - Enhancement | }} | {{ #ifeq: {{{type|}}} | Defensive | !colspan=2 align=center style="background:#CF9;"{{!}}Defensive Magic | {{ #ifeq: {{{type|}}} | Utility | !colspan=2 align=center style="background:#9CF;"{{!}}Utility Magic{{ #ifeq: {{{skill|None}}} | None | |<nowiki></nowiki> - Skill Enhancement | }} | }}}}}}}} <!-- If it is an attack spell, then -->{{ #ifeq: {{{type}}} | Attack | {{ #ifeq: {{{subtype}}} | None | | |
{{ #ifeq: {{{type|}}} | Attack | !colspan=2 align=center style="background:#F99;"{{!}}Attack Magic{{ #ifeq: {{{dtype|None}}}| None | |<nowiki></nowiki> - Damage}}{{ #ifeq: {{{status|None}}} | None | |<nowiki></nowiki> - Disabling}} | {{ #ifeq: {{{type|}}} | Offensive | !colspan=2 align=center style="background:#FF9;"{{!}}Offensive Magic{{ #ifeq: {{{weapon|None}}} | None | |<nowiki></nowiki> - Weapon Enhancement | }}{{ #ifeq: {{{enhancement|None}}} | None | |<nowiki></nowiki> - Enhancement | }} | {{ #ifeq: {{{type|}}} | Defensive | !colspan=2 align=center style="background:#CF9;"{{!}}Defensive Magic | {{ #ifeq: {{{type|}}} | Healing | !colspan=2 align=center style="background:#FC9;"{{!}}Healing Magic |{{ #ifeq: {{{type|}}} | Utility | !colspan=2 align=center style="background:#9CF;"{{!}}Utility Magic{{ #ifeq: {{{skill|None}}} | None | |<nowiki></nowiki> - Skill Enhancement | }} | }}}}}}}}}} <!-- If it is an attack spell, then -->{{ #ifeq: {{{type}}} | Attack | {{ #ifeq: {{{subtype}}} | None | | |
||
{{!}}- |
{{!}}- |
||
! Subtype |
! Subtype |
||
Line 68: | Line 81: | ||
! [[Enhancement]] |
! [[Enhancement]] |
||
{{!}} valign="top" style="white-space: nowrap; text-align: right;" {{!}} {{{enhancement}}} |
{{!}} valign="top" style="white-space: nowrap; text-align: right;" {{!}} {{{enhancement}}} |
||
}}{{ #ifeq: {{{ |
}}{{ #ifeq: {{{availability}}} | None | | |
||
{{!}}- |
{{!}}- |
||
! Availability |
! Availability |
||
Line 89: | Line 102: | ||
{{!}} valign="top" style="white-space: nowrap; text-align: right;" {{!}} {{{requirements}}} |
{{!}} valign="top" style="white-space: nowrap; text-align: right;" {{!}} {{{requirements}}} |
||
}}{{ #ifeq: {{{enhancement}}} | None | | |
}}{{ #ifeq: {{{enhancement}}} | None | | |
||
{{!}}- |
|||
! Availability |
|||
{{!}} valign="top" style="white-space: nowrap; text-align: right;" {{!}} {{{availability}}} }} |
|||
| <!-- If it is a healing spell, then --> {{ #ifeq: {{{type}}} | Healing| {{ #ifeq: {{{subtype}}} | None | | |
|||
{{!}}- |
|||
! Subtype |
|||
{{!}} valign="top" style="white-space: nowrap; text-align: right;" {{!}} {{{subtype}}} |
|||
}}{{ #ifeq: {{{availability}}} | None | | |
|||
{{!}}- |
{{!}}- |
||
! Availability |
! Availability |
||
Line 108: | Line 129: | ||
! Availability |
! Availability |
||
{{!}} valign="top" style="white-space: nowrap; text-align: right;" {{!}} {{{availability}}} }} |
{{!}} valign="top" style="white-space: nowrap; text-align: right;" {{!}} {{{availability}}} }} |
||
| }}}}}}}} |
| }}}}}}}}}} |
||
|} |
|} |
||
|- align=center |
|- align=center |
||
Line 114: | Line 135: | ||
{{{navigation|}}} |
{{{navigation|}}} |
||
|}<includeonly> |
|}<includeonly> |
||
{{#switch: {{{type}}} | Attack=[[Category:Attack Spells]] | Defensive=[[Category:Defensive Spells]] | Offensive=[[Category:Offensive Spells]] | Healing=[[Category:Healing Spells]] | Utility=[[Category:Utility Spells]]}} {{#switch: {{{target}}} | [[Multi-target]]=[[Category:Multi-target Spells]] }} [[Category:Spells]] |
|||
{{ #ifeq: {{{type}}} | Attack | [[Category:Attack Spells]] | |
|||
{{ #ifeq: {{{type}}} | Defensive | [[Category:Defensive Spells]] | |
|||
{{ #ifeq: {{{type}}} | Offensive | [[Category:Offensive Spells]] | |
|||
{{ #ifeq: {{{type}}} | Utility | [[Category:Utility Spells]] | [[Category:Spells Needing Updating]] |
|||
}}}}}}}}[[Category:Spells]] |
|||
</includeonly><noinclude> |
</includeonly><noinclude> |
||
{{Documentation}} |
|||
The article changes colors based on the definition of the {{{type}}} parameter. The colors are according to the following table: |
|||
{| {{prettytable}} |
|||
|style="background:#FF9"|Offensive is FF9||style="background:#CF9"|Defensive is CF9||style="background:#9CF"|Utility is 9CF||style="background:#F99"|Attack is F99||style="background:#DDD"|Undefined is DDD |
|||
|- |
|||
|style="background:#FFFFF8"|Offensive is FFFFF8||style="background:#FCFFF8"|Defensive is FCFFF8||style="background:#F8FCFF"|Utility is F8FCFF||style="background:#FFF8F8"|Attack is FFF8F8||style="background:#F9F9F9"|Undefined is F9F9F9 |
|||
|} |
|||
The example to the right is an undefined table. |
|||
== Duration == |
|||
The standard duration parameter are {{{base_dur}}} (base duration) and {{{add_dur}}} (added duration per spell circle rank or lore rank). |
|||
If the parameter {{{duration}}} is defined, it automatically replaces the shown duration fields. This is to ensure backwards compatibility with the old spell template. Additionally, if the parameter {{{custdur}}} is defined, it also replaces the shown fields and allows one to use the custom duration templates from the spellbox series of templates. These are [[Template:Spellbox instant]], [[Template:Spellbox block]], and [[Template:Spellbox duration]], although the Spellbox duration template would be exactly the same as the default. |
|||
For example, the following template can be used to specify that a spell has a refreshable duration of 60 seconds: |
|||
<pre> |
|||
custdur = {{Spellbox block | duration = 60 sec. | span = [[Refreshable]]}} |
|||
</pre> |
|||
=== Span === |
|||
The parameter {{{span}}} refers to the spell's ability to be extended. Possible values include [[Stackable]], [[Refreshable]], and [[Solid block]]. This field only appears when using the standard duration parameters (base_dur + add_dur), but can be added as an optional parameter when using <nowiki>"custdur = {{Spellbox block | ...}}"</nowiki>. |
|||
== Types == |
|||
The template changes drastically based on what type is chosen for the template. The preview, to the right, is what the template will look like with no type defined. Undefined, the template will be gray. However, the colors and parameters change when defined, and the type line will vanish so long as it meets one of four types: Attack, Defensive, Offensive, and Utility. It is case sensitive. Any unwanted line can be removed by defining the associated parameter as "None". This is case sensitive. |
|||
=== Attack === |
|||
This type changes the template to have a pale red background in addition to adding lines for '''Subtype''', '''Target(s)''', '''Interval''', '''Damage Type''', '''Critical Type''', and '''State(s) Inflicted'''. |
|||
*Subtype defines if the attack is a warding, maneuver, or bolt attack, or a combination thereof. |
|||
*Target(s) is used to define who is targeted by the attack. Some spells affect everyone (room), everyone not in the group (ungrouped), all critters (creatures), or only a single individual. Some spells are limited in number and will chose targets randomly from an above list. If such is the case, put the list that the spell chooses from, and go into more detail in the spell description within the article itself. |
|||
*Interval indicates the frequency of damage over time effects if the spell has such a component. For spells without any time interval component, set this parameter to "None" to hide the line. |
|||
*Damage Type is what sort of damage is inflicted. Usually, this'll be health point damage, but it could be mana damage as well, or others. |
|||
**Critical Type line will show if the parameter {{{dtype}}} is defined, and lists the [[critical table]](s) used by the spell. |
|||
*State(s) Inflicted displays the type of [[status]] ailment inflicted on the target. If this parameter is set, the spell will be designated as "Disabling" in the header. |
|||
=== Defensive === |
|||
This type changes the template to have a pale green background in addition to adding lines for '''Subtype''', '''Defensive Strength''', '''Target Defense''', '''Enhancement''', and '''Availability'''. |
|||
*Subtypes for defensive spells would define which sort of defensive capabilities the spell offers, such as increases to DS, TD, and skills. |
|||
*Defensive Strength should be listed as the type of DS it provides, such as [[melee]] or [[bolt]]. |
|||
*Target Defense should be labelled by the type of TD it provides, like DS. Options are: Spiritual, Elemental, Mental, and Generic (or All). |
|||
*Enhancement would be used for spells such as [[Mass Blur]] which increase defensive capabilities by granting phantom ranks in the skill, [[Dodge]]; though, some spells increase ranks in Stalking and Hiding in addition to increasing defensive capabilities; such would go here. |
|||
*Availability defines who the spell can be cast on, such as [[self-cast]], group (like [[Mass Blur]]), and all (such as [[Elemental Defense I]]). |
|||
=== Offensive === |
|||
This type changes the template to have a light yellow background in addition to adding lines for '''Subtype''', '''Weapon Enhancement''', '''Enhancement''', and '''Availability''' or '''Weapon Requirements'''. |
|||
*"Subtype" defines what sort of enhancement that this spell provides. Generally, weapon enhancements, attack strength enhancements, or more. |
|||
*"Enhancement" is split into two categories, defined by which parameter is used -- {{{weapon}}} or {{{enhancement}}}. |
|||
**{{{weapon}}} - defines the template as a weapon enhancement, and this field is used to define what sort of enhancement the spell provides to the weapon. There are currently three weapon enhancement spells, [[Bless Item]], [[Minor Elemental Edge]], and [[Elemental Blade]]. Bless Item grants a weapon the Blessed status, and thus would be simply labeled, "Bless". Minor Elemental Edge and Elemental Blade both grant enchantment bonuses (labeled, "Enchantment"), though, Elemental Blade also adds flares (and thus would be labeled "Enchantment, Flares"). Using this parameter replaces Availability with Requirements. Note that the spell, [[Enchant Item]], is not considered an offensive spell due to the ability to enchant shields and armor, in addition to weaponry. |
|||
**{{{enhancement}}} - defines the template as a general enhancement spell. This would be used where the spell provides an enhancement to an offensive skill, such as [[Patron's Blessing]], which increases ranks in the skill, [[Combat Maneuvers]]. Also, if the spell provides an increase to Attack Strength, it would be listed here. |
|||
*"Availability" is similar to the use with defensive spells as above, although, if this spell is labeled as a weapon enhancement by using the {{{weapon}}} parameter, this line is replaced by the Requirements line. |
|||
*"Weapon Requirements" is used with weapon enhancements, and this line defines the requirements that are placed on the weapon to cast this spell. For example, to cast Bless Item on a weapon, it cannot have flares or weighting. Additionally, to cast Minor Elemental Edge or Elemental Blade on a weapon, it cannot be magical in any way whatsoever. This includes weighting and flares. |
|||
=== Utility === |
|||
This type changes the template to have a light blue background in addition to adding lines for '''Subtype''', '''Skill Enhancement''', '''Components''', and '''Availability'''. |
|||
*"Subtype" is often defined as either being Combat, Enhancement, or None, although other subtypes may be defined. |
|||
*"Skill Enhancement" is used to list whatever skills might be enhanced by this spell. Increases to skills that are not directly offensive or defensive in nature, such as [[Stalking and Hiding]], [[Skinning]], and [[Foraging]], will be listed as utility. If the spell does not enhance a skill, enter "None". |
|||
*"Components" lists the various components the spell may require. Listing the components as "None" will remove this line. |
|||
*"Availability" is used for enhancement utility spells, such as [[Sneaking]] or [[Whispering Willow]]. It is defined much like the Availability line in defensive spells. |
|||
== Navigation == |
|||
The parameter {{{navigation}}} allows the use of any of the navigational templates available from the Spellbox series of templates. All of the navigational templates are listed below. |
|||
*[[Template:Minor spiritual navigation]] |
|||
*[[Template:Major spiritual navigation]] |
|||
*[[Template:Cleric base navigation]] |
|||
*[[Template:Minor elemental navigation]] |
|||
*[[Template:Major elemental navigation]] |
|||
*[[Template:Ranger base navigation]] |
|||
*[[Template:Sorcerer base navigation]] |
|||
*[[Template:Wizard base navigation]] |
|||
*[[Template:Bard base navigation]] |
|||
*[[Template:Empath base navigation]] |
|||
*[[Template:Minor mental navigation]] |
|||
*[[Template:Paladin base navigation]] |
|||
== Other Examples == |
|||
Current examples of this template in use include [[401]], [[601]], [[603]], [[606]], and [[619]]. |
|||
== Notes == |
|||
This template makes extensive use of the ParserFunctions extension. Many of these functions are severely nested and nested again and I admit the coding was rather confusing. I expect there to be bugs due to my inexperience with ParserFunctions and the complex structure of the template. |
|||
This article is still subject to change. |
|||
[[Category:Spell Templates|{{PAGENAME}}]] |
|||
</noinclude> |
</noinclude> |
Latest revision as of 15:03, 17 January 2024
| ||||||||||||
The article changes colors based on the definition of the {{{type}}} parameter. The colors are according to the following table:
Offensive is FF9 | Defensive is CF9 | Utility is 9CF | Attack is F99 | Healing is FC9 | Undefined is DDD |
Offensive is FFFFF8 | Defensive is FCFFF8 | Utility is F8FCFF | Attack is FFF8F8 | Healing is FFFCEF | Undefined is F9F9F9 |
The example to the right is an undefined table.
Duration
The standard duration parameter are {{{base_dur}}} (base duration) and {{{add_dur}}} (added duration per spell circle rank or lore rank).
If the parameter {{{duration}}} is defined, it automatically replaces the shown duration fields. This is to ensure backwards compatibility with the old spell template. Additionally, if the parameter {{{custdur}}} is defined, it also replaces the shown fields and allows one to use the custom duration templates from the spellbox series of templates. These are Template:Spellbox instant, Template:Spellbox block, and Template:Spellbox duration, although the Spellbox duration template would be exactly the same as the default.
For example, the following template can be used to specify that a spell has a refreshable duration of 60 seconds:
custdur = {{Spellbox block | duration = 60 sec. | span = [[Refreshable]]}}
Span
The parameter {{{span}}} refers to the spell's ability to be extended. Possible values include Stackable, Refreshable, and Solid block. This field only appears when using the standard duration parameters (base_dur + add_dur), but can be added as an optional parameter when using "custdur = {{Spellbox block | ...}}".
Types
The template changes drastically based on what type is chosen for the template. The preview, to the right, is what the template will look like with no type defined. Undefined, the template will be gray. However, the colors and parameters change when defined, and the type line will vanish so long as it meets one of four types: Attack, Defensive, Offensive, and Utility. It is case sensitive. Any unwanted line can be removed by defining the associated parameter as "None". This is case sensitive.
Attack
This type changes the template to have a pale red background in addition to adding lines for Subtype, Target(s), Interval, Damage Type, Critical Type, and State(s) Inflicted.
- Subtype defines if the attack is a warding, maneuver, or bolt attack, or a combination thereof.
- Target(s) is used to define who is targeted by the attack. Some spells affect everyone (room), everyone not in the group (ungrouped), all critters (creatures), or only a single individual. Some spells are limited in number and will chose targets randomly from an above list. If such is the case, put the list that the spell chooses from, and go into more detail in the spell description within the article itself.
- Interval indicates the frequency of damage over time effects if the spell has such a component. For spells without any time interval component, set this parameter to "None" to hide the line.
- Damage Type is what sort of damage is inflicted. Usually, this'll be health point damage, but it could be mana damage as well, or others.
- Critical Type line will show if the parameter {{{dtype}}} is defined, and lists the critical table(s) used by the spell.
- State(s) Inflicted displays the type of status ailment inflicted on the target. If this parameter is set, the spell will be designated as "Disabling" in the header.
Defensive
This type changes the template to have a pale green background in addition to adding lines for Subtype, Defensive Strength, Target Defense, Enhancement, and Availability.
- Subtypes for defensive spells would define which sort of defensive capabilities the spell offers, such as increases to DS, TD, and skills.
- Defensive Strength should be listed as the type of DS it provides, such as melee or bolt.
- Target Defense should be labelled by the type of TD it provides, like DS. Options are: Spiritual, Elemental, Mental, and Generic (or All).
- Enhancement would be used for spells such as Mass Blur which increase defensive capabilities by granting phantom ranks in the skill, Dodge; though, some spells increase ranks in Stalking and Hiding in addition to increasing defensive capabilities; such would go here.
- Availability defines who the spell can be cast on, such as self-cast, group (like Mass Blur), and all (such as Elemental Defense I).
Offensive
This type changes the template to have a light yellow background in addition to adding lines for Subtype, Weapon Enhancement, Enhancement, and Availability or Weapon Requirements.
- "Subtype" defines what sort of enhancement that this spell provides. Generally, weapon enhancements, attack strength enhancements, or more.
- "Enhancement" is split into two categories, defined by which parameter is used -- {{{weapon}}} or {{{enhancement}}}.
- {{{weapon}}} - defines the template as a weapon enhancement, and this field is used to define what sort of enhancement the spell provides to the weapon. There are currently three weapon enhancement spells, Bless Item, Minor Elemental Edge, and Elemental Blade. Bless Item grants a weapon the Blessed status, and thus would be simply labeled, "Bless". Minor Elemental Edge and Elemental Blade both grant enchantment bonuses (labeled, "Enchantment"), though, Elemental Blade also adds flares (and thus would be labeled "Enchantment, Flares"). Using this parameter replaces Availability with Requirements. Note that the spell, Enchant, is not considered an offensive spell due to the ability to enchant shields and armor, in addition to weaponry.
- {{{enhancement}}} - defines the template as a general enhancement spell. This would be used where the spell provides an enhancement to an offensive skill, such as Patron's Blessing, which increases ranks in the skill, Combat Maneuvers. Also, if the spell provides an increase to Attack Strength, it would be listed here.
- "Availability" is similar to the use with defensive spells as above, although, if this spell is labeled as a weapon enhancement by using the {{{weapon}}} parameter, this line is replaced by the Requirements line.
- "Weapon Requirements" is used with weapon enhancements, and this line defines the requirements that are placed on the weapon to cast this spell. For example, to cast Bless Item on a weapon, it cannot have flares or weighting. Additionally, to cast Minor Elemental Edge or Elemental Blade on a weapon, it cannot be magical in any way whatsoever. This includes weighting and flares.
Healing
This type changes the template to an orange background. It is used on Empath Base and Former Empath Base (herb) healing spells.
Utility
This type changes the template to have a light blue background in addition to adding lines for Subtype, Skill Enhancement, Components, and Availability.
- "Subtype" is often defined as either being Combat, Enhancement, or None, although other subtypes may be defined.
- "Skill Enhancement" is used to list whatever skills might be enhanced by this spell. Increases to skills that are not directly offensive or defensive in nature, such as Stalking and Hiding, Skinning, and Foraging, will be listed as utility. If the spell does not enhance a skill, enter "None".
- "Components" lists the various components the spell may require. Listing the components as "None" will remove this line.
- "Availability" is used for enhancement utility spells, such as Sneaking or Whispering Willow. It is defined much like the Availability line in defensive spells.
The parameter {{{navigation}}} allows the use of any of the navigational templates available from the Spellbox series of templates. All of the navigational templates are listed below.
- Template:Minor spiritual navigation
- Template:Major spiritual navigation
- Template:Cleric base navigation
- Template:Minor elemental navigation
- Template:Major elemental navigation
- Template:Ranger base navigation
- Template:Sorcerer base navigation
- Template:Wizard base navigation
- Template:Bard base navigation
- Template:Empath base navigation
- Template:Minor mental navigation
- Template:Paladin base navigation
- Template:Lost arts navigation
Other Examples
Current examples of this template in use include 401, 601, 603, 606, and 619.
Notes
This template makes extensive use of the ParserFunctions extension. Many of these functions are severely nested and nested again and I admit the coding was rather confusing. I expect there to be bugs due to my inexperience with ParserFunctions and the complex structure of the template.
This article is subject to change.