API:2/skills
This resource returns information about skills usable by players in the game.
Содержание
Parameters[править]
-
lang
– Request localized information.
Response[править]
If the root endpoint (/v2/skills
) is accessed without specifying an id, a list of all ids is returned. When multiple ids are requested using the ids
parameter, a list of response objects is returned.
For each requested skill id, an object with the following properties is returned:
-
id
(number) – The skill id. -
name
(string) – The skill name. -
description
(string, optional) – The skill description. -
icon
(string) – A URL to an icon of the skill. -
chat_link
(string) – The chat link. -
type
(string, optional) – The skill type (see below). Possible values:-
Bundle
– Used for Engineer kits or weapons picked up in-world. -
Elite
– Elite skill. -
Heal
– Heal skill. -
Monster
– Used for some NPC skills. -
Pet
– Used for Ranger pet skills. -
Profession
– Profession-specific skill, such as Elementalist attunements or Engineer toolbelt skills. -
Toolbelt
– Used for some Engineer toolbelt skills. -
Transform
– Placeholder skill used to indicate a locked slot. -
Utility
– Utility skill. -
Weapon
– Weapon skill or downed skill. - Note this value is inconsistently set on certain skills triggered by traits, and may be unset..
-
-
weapon_type
(string, optional) – Indicates what weapon the skill is on. Can also beNone
if not applicable. -
professions
(array) – An array of strings indicating which profession(s) can use this skill. -
slot
(string, optional) – A string indicating where this skill fits into. Possible values:-
Downed_[1-4]
– Downed skills 1-4. -
Pet
- Used for Ranger pet skills. -
Profession_[1-5]
– Profession skills 1-5. -
Utility
– Utility skill. -
Weapon_[1-5]
– Weapon skills 1-5.
-
-
facts
(array, optional) – An array of skill fact objects describing the skill's effect. (See below.) -
traited_facts
(array, optional) – An array of skill fact objects that may apply to the skill, dependent on the player's trait choices. -
categories
(array, optional) – An array of categories the skill falls under. Mostly used for organizational purposes, with some exceptions:-
DualWield
– Indicates the skill is a dual-wield skill for thieves. The necessary off-hand weapon is indicated indual_wield
. -
StealthAttack
– Indicates the skill can only be used by a thief in stealth. - All other values of this field simply indicate which group of skills it belongs to. (i.e.
Signet
,Cantrip
, etc.)
-
-
attunement
(string, optional) – Used for Elementalist weapon skills, indicates what attunement this skill falls under. One of:Fire
,Water
,Air
,Earth
. -
cost
(number, optional) – Used for Revenant, Warrior, and Druid skills to indicate their energy cost. -
dual_wield
(string, optional) – Indicates what off-hand must be equipped for this dual-wield skill to appear. -
flip_skill
(number, optional) – Used for skills that "flip over" into a new skill in the same slot to indicate what skill they flip to, such as Engineer toolkits or Herald facets. -
initiative
(number, optional) – Indicates the Initiative cost for thief skills. -
next_chain
(number, optional) – Indicates the next skill in the chain, if applicable. -
prev_chain
(number, optional) – Indicates the previous skill in the chain, if applicable. -
transform_skills
(array, optional) – Used to indicate that the skill will transform the player, replacing their skills with the skills listed in the array. -
bundle_skills
(array, optional) – Used to indicate that the skill will replace the player's skills with the skills listed in the array. -
toolbelt_skill
(number, optional) – Used for Engineer utility skills to indicate their associated toolbelt skill. -
flags
(array, optional) – Used to indicate usage limitations, more than one value can be set. One of:GroundTargeted
,NoUnderwater
.
Traited Facts[править]
All objects returned within a traited_facts
array contain the same properties as a facts
object, but they additionally have the following properties:
-
requires_trait
(number) – Specifies which trait has to be selected in order for this fact to take effect. -
overrides
(number, optional) – This specifies the array index of thefacts
object it will override, if the trait specified inrequires_trait
is selected. If this field is omitted, then the fact contained within this object is to be appended to the existingfacts
array.
Facts[править]
All objects returned within a facts
array contain the following properties:
-
text
(string) – An arbitrary localized string describing the fact. -
icon
(string, optional) – A URL to the icon shown with the fact. Not included with all facts. -
type
(string) – Defines what additional fields the object will contain, and what type of fact it is. Can be one of the following:-
AttributeAdjust
-
Buff
-
ComboField
-
ComboFinisher
-
Damage
-
Distance
-
Duration
-
Heal
-
HealingAdjust
-
NoData
-
Number
-
Percent
-
PrefixedBuff
-
Radius
-
Range
-
Recharge
-
StunBreak
-
Time
-
Unblockable
-
AttributeAdjust[править]
{ text: "Attribute Adjust", type: "AttributeAdjust", icon: "url", value: 150, target: "CritDamage" }
-
value
(number) – The amounttarget
gets adjusted, based on a level 80 character at base stats. -
target
(string) – The attribute this fact adjusts. Note that a value ofHealing
indicates the fact is a heal, and Ferocity is encoded atCritDamage
.
Buff[править]
{ text: "Apply Buff/Condition", type: "Buff", icon: "url", duration: 5, status: "Vulnerability", description: "Damage and condition damage taken are increased; stacks intensity.", apply_count: 1 }
-
status
(string) – The boon, condition, or effect referred to by the fact. -
description
(string, optional) – The description of the status effect. -
apply_count
(number, optional) – The number of stacks applied. -
duration
(number, optional) – The duration of the effect in seconds. Note that some facts of this type are just used to display the buff icon with text; in this case,duration
is usually0
, or omitted entirely.
ComboField[править]
{ text: "Combo Field", type: "ComboField", field_type: "Ethereal" }
-
field_type
(string) – The type of field. One of:Air
,Dark
,Fire
,Ice
,Light
,Lightning
,Poison
,Smoke
,Ethereal
,Water
.
ComboFinisher[править]
{ text: "Combo Finisher", type: "ComboFinisher", percent: 100, finisher_type: "Blast" }
-
finisher_type
(string) – The type of finisher. One of:Blast
,Leap
,Projectile
,Whirl
. -
percent
(number) – The percent chance that the finisher will trigger.
Damage[править]
{ text: "Damage", type: "Damage", icon: "url", hit_count: 1, dmg_multiplier: 0.6 }
-
hit_count
(number) – The amount of times the damage hits. -
dmg_multiplier
(number) - Indicates the damage multiplier value of that skill.
Distance[править]
{ text: "Radius", type: "Distance", icon: "url", distance: 180 }
-
distance
(number) – The distance value.
Duration[править]
{ "text": "Venom Duration", "type": "Duration", "icon": "url", "duration": 30 }
-
duration
(number) - The duration in seconds.
Heal[править]
{ "text": "Healing", "type": "Heal", "icon": "url", "hit_count": 1 }
-
hit_count
(number) - The number of times the heal is applied.
HealingAdjust[править]
{ "text": "Healing", "type": "HealingAdjust", "icon": "url", "hit_count": 1 }
NoData[править]
{ text: "Combat Only", type: "NoData", icon: "url" }
This fact is usually used to display the Combat Only
fact, but it can be used elsewhere.
Number[править]
{ text: "Conditions Removed", type: "Number", icon: "url", value: 3 }
-
value
(number) – The number value as referenced bytext
.
Percent[править]
{ text: "Health Threshold", type: "Percent", icon: "url", percent: 25 }
-
percent
(number) – The percentage value as referenced bytext
.
PrefixedBuff[править]
{ text: "Apply Buff/Condition", type: "PrefixedBuff", icon: "url", duration: 20, status: "Might", description: "Increased outgoing damage; stacks intensity.", apply_count: 1, prefix: { text: "Apply Buff/Condition", icon: "url", status: "Fire Attunement", description: "Cast fire spells." } }
This fact contains the same info as the buff fact, but includes an additional prefix
object that describes the icon to show before the fact.
Radius[править]
{ text: "Radius", type: "Radius", icon: "url", distance: 180 }
-
distance
(number) – The radius value.
Range[править]
{ text: "Range", type: "Range", value: 150 }
-
value
(number) – The range of the trait/skill.
Recharge[править]
{ text: "Recharge", type: "Recharge", value: 40 }
-
value
(number) – The recharge time in seconds.
StunBreak[править]
{ "text": "StunBreak", "type": "StunBreak", "icon": "https://render.guildwars2.com/file/DCF0719729165FD8910E034CA4E0780F90582D15/156654.png", "value": true },
-
value
(boolean) – Always true.
Time[править]
{ text: "Duration Increase", type: "Time", icon: "url", duration: 2 }
-
duration
(number) – The time value in seconds.
Unblockable[править]
{ text: "Unblockable", type: "Unblockable", value: true }
-
value
(boolean) – Always true.
Example[править]
https://api.guildwars2.com/v2/skills/14375
{ "name": "Arcing Slice", "facts": [ { "text": "Range", "type": "Range", "value": 150 }, { "text": "Recharge", "type": "Recharge", "value": 8 }, { "text": "Damage", "type": "Damage", "icon": "...", "hit_count": 1 }, { "text": "Damage against Foes under 50% Health", "type": "Damage", "icon": "...", "hit_count": 1 }, { "text": "Apply Buff/Condition", "type": "Buff", "icon": "...", "duration": 5, "status": "Fury", "description": "Critical Chance increased by 20%; stacks duration.", "apply_count": 1 }, { "text": "Number of Targets", "type": "Number", "icon": "...", "value": 5 }, ... ], "description": "Burst. Deliver a circular attack to foes around you, and gain fury. Deal more damage to foes with low health.", "type": "Profession", "weapon_type": "None", "professions": [ "Warrior" ], "slot": "Profession_1", "cost": 30, "flip_skill": 14545, "categories": [ "Burst" ], "traited_facts": [ { "text": "Damage", "type": "Damage", "icon": "...", "requires_trait": 1657, "hit_count": 1, "overrides": 2 }, { "text": "Damage against Foes under 50% Health", "type": "Damage", "icon": "...", "requires_trait": 1657, "hit_count": 1, "overrides": 3 } ], "icon": "...", "id": 14375, "chat_link": "[&Byc4AAA=]" }
https://api.guildwars2.com/v2/skills?ids=5516,5517
[ { name: "Conjure Fiery Greatsword", description: "Conjure. Manifest a fiery greatsword in your hands and at the target location. When it lands, it damages and burns foes. Wielders of this weapon gain increased power and condition damage.", type: "Elite", weapon_type: "None", professions: [ "Elementalist" ], slot: "Elite", categories: [ "Conjure" ], bundle_skills: [ 5532, 5533, 5697, 5517, 5531 ], icon: "..", id: 5516 }, { name: "Fiery Rush", description: "Charge at your foe, leaving a line of fire behind you.", type: "Bundle", weapon_type: "None", professions: [ "Thief", "Mesmer", "Warrior", "Elementalist", "Necromancer", "Guardian", "Ranger", "Engineer", "Revenant" ], slot: "Weapon_4", icon: "...", id: 5517 } ]