Guild Wars 2 Wiki:Skill formatting

From Guild Wars 2 Wiki
Jump to: navigation, search

This article will explain the formatting practices and processes with regards to the documentation of skills.

Skill infobox[edit]

Primary article: Template:Skill infobox

Skills are described using the {{Skill infobox}}. Basic parameters are outlined below; please refer to the template for a more detailed guide.

{{Skill infobox
| name =           <!-- Optional. Name of the skill. Only include if the name differs from the article name. Defaults to {{PAGENAME}}. -->
| icon =           <!-- Optional. Icon of the skill. Only include if the icon differs from the article name. Defaults to File:{{PAGENAME}}.png -->
| description =    <!-- Skill description, copied verbatim from the game, including errors. Do not include skill type, as this has its own parameter. -->
| variables =      <!-- Use {{skill fact}} for each variable. See "Skill facts" documentation below for details on how to use this. -->
| profession =     <!-- Profession that uses this skill. Mandatory if specialization is also set. -->
| specialization = <!-- Specialization that uses this skill, if applicable. -->
| type =           <!-- Skill type, e.g., signet, cantrip, etc. -->
| activation =     <!-- Activation time. Enter as a decimal, e.g. 1.25 -->
| activ-type =     <!-- Use for skills with a special activation type: Chain, Channeled, or Charge. -->
| ground-target =  <!-- Type of ground targeting, if applicable. -->
| initiative =     <!-- Initiative cost, if applicable. -->
| energy =         <!-- Energy cost, if applicable. -->
| upkeep =         <!-- Energy upkeep cost, if applicable. -->
| recharge =       <!-- Recharge time. If there is no recharge, define the value as 0. -->
| slot =           <!-- Slot in the skill bar that this skill belongs in, e.g., weapon, heal, utility, etc. -->
| weapon-slot =    <!-- Weapon skills only. Slot number. -->
| mainhand =       <!-- Weapon type (for mainhand weapon skills only). -->
| offhand =        <!-- Weapon type (for offhand weapon skills only). -->
| twohand =        <!-- Weapon type (for two-handed weapon skills only). If the skill is from a bundle, write the name of the bundle here instead. -->
| tool belt =      <!-- Associated tool belt skill, if applicable. -->
| attunement =     <!-- Associated attunement, if applicable. -->
| kit =            <!-- Associated kit, if applicable. -->
| activity =       <!-- Activity skills only. Name of activity. -->
| pet =            <!-- Pet skills only. Add the pet's species here. Do not include "Juvenile". -->
| pet-family =     <!-- Pet skills only. Add the pet's family here. -->
| monster =        <!-- NPC skills only. Add the NPC's name here. -->
| uw-replaced-by = <!-- Non-underwater skills only. Write the name of the underwater skill that replaces it; "none" if it has no replacement. -->
| uw-replaces =    <!-- Underwater skills that replace a terrestrial skill only. Write the name of the terrestrial skill being replaced here. -->
| parent =         <!-- Name of skill that gives access to this skill, if applicable. -->
| chain1 =         <!-- Chain skills only. Name of first skill in chain. -->
| chain2 =         <!-- Chain skills only. Name of second skill in chain. -->
| chain3 =         <!-- Chain skills only. Name of third skill in chain. -->
| hero points =    <!-- Slot skills only. Used to indicate how many hero points are required to unlock the skill. -->
| id =             <!-- The skill's internal ID. Generates a game link in the infobox. -->
| release =        <!-- Optional. Used to mark if a skill is from a specific release. -->
| status =         <!-- Optional. Used to mark if a skill is temporary or historical and does not exist in the current state of the game. -->
}}

Skill facts[edit]

Primary article: Template:Skill fact

The "variables" parameter is filled in using the {{Skill fact}} template, calling the template once for each variable. Please refer to the template documentation for details on using it for standard facts, as well as how to document non-standard facts.

  • Whenever possible, use the standard options provided by the fact template. Avoid cluttering skill facts with non-standard formatting.
  • Facts should reflect the default PvE state of the skill with base attributes. Damage and healing facts scale with the character's level and attributes, thus these variables need to be standardized for consistency between skills. The (current) baseline criteria are:
    • Level 80 character (base value for primary attributes is 1000)
    • No active effects that modify attributes
    • No traits that increase damage/healing, affect condition duration/damage, or otherwise modify skill facts. Traits that simply add facts are fine, since the new facts can be identified by their blue text and ignored.
      • In the current trait system, you always have 3 specializations equipped, and the minor traits in those specs are automatically selected, thus this may be difficult for some professions.
    • No armor, trinkets, or back items equipped
    • Weapons are necessary for weapon skills, but should be unequipped otherwise
      • Level 80 exotic
      • No sigils that affect damage, conditions, or healing
      • Ideally, the prefix should have no attributes that affect skill facts, i.e. no Power, Healing Power, Boon Duration, or Condition Duration. Thus, Dire and Rabid prefixes should be used, since they are the only two of the available triple-attribute prefixes with none of those attributes.
    • If a skill can only be accessed in a way that forces an attribute modification (e.g. Banner bundle skills can only be accessed by holding that bundle, which gives attribute bonuses), then that modification becomes the default for that skill.
  • The sPvP or WvW version of the skill may have differences to the PvE version. These are documented on their own pages, typically titled <Skill name> (PvP).

Other templates[edit]

Copy-paste layout[edit]

This is a suggested layout for a skill page, based on current conventions; editors should feel free to alter it as they see fit.

{{Game mode version|<game mode this skill is used in>}} <!-- Optional. Only used if PvE and PvP modes have different versions of this skill. -->

{{Skill infobox
| name = 
| icon = 
| description = 
| variables = 
| profession = 
| specialization = 
| type = 
| activation = 
| activ-type = 
| ground-target = 
| recharge = 
| slot = 
| weapon-slot = 
| mainhand = 
| offhand = 
| twohand = 
| chain1 = 
| chain2 = 
| chain3 = 
| hero points = 
| id = 
| release = 
}}

== Related traits ==
<!-- Optional section. List any traits which affect this skill, organized by trait line. -->
=== {{trait icon|<!--Trait line-->|size=35}}===
* {{trait icon|<!--Trait 1-->}} — {{trait description|<!--Trait 1-->}}
* {{trait icon|<!--Trait 2-->}} — {{trait description|<!--Trait 2-->}}

== Notes ==
<!-- Optional section. Any relevant notes can go here. -->
*...

== Version history ==
<!-- Required for profession skills. Leave blank if unsure. -->
{{Version history table header|<!--Profession-->}}
{{Version history table row|<!--yyyy-mm-dd-->|<!--Profession--> }}
* <!--Description of changes, copied from the official patch notes.-->
{{Version history table row|release|r=y}} <!-- Change "release" to a date if skill was not introduced with the release of Guild Wars 2 on 2012-8-28. -->
|}

== Trivia ==
<!-- Optional section. Any trivial information can go here. -->
*...