For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Create tokenDev Discord
  • Get started
    • Introduction
    • Authentication
    • API Privacy
    • Exceptions
    • Dev Discord
  • Modules
      • GETList online players
      • GETWho Am I
      • GETGet player profile
      • GETList a player's characters
      • GETGet detailed character data
      • GETGet character ability map
  • Changelog
    • v3.7.2 - OAuth2
    • v3.7.1
    • v3.7
    • v3.6 - Fruma Expansion
    • v3.5.2
    • v3.5.1
    • v3.5 - User System
    • v3.4
    • v3.3.4
    • v3.3.3
    • v3.3.2
    • v3.3.1
    • v3.3 - Rekindled World
    • v3.2.5
    • v3.2.4
    • v3.2.3
    • v3.2.2
    • v3.2.1
    • v3.2
    • v3.1
    • v3.0
LogoLogoWynncraft API - Documentation
Create tokenDev Discord
ModulesPlayer

Get character ability map

GET
https://api.wynncraft.com/v3/player/:username/characters/:uuid/abilities
GET
/v3/player/:username/characters/:uuid/abilities
$curl https://api.wynncraft.com/v3/player/username/characters/uuid/abilities
1{
2  "1": [
3    {
4      "type": "ability",
5      "coordinates": {
6        "x": 5,
7        "y": 1
8      },
9      "meta": {
10        "page": 1,
11        "icon": {
12          "value": {
13            "id": "minecraft:potion",
14            "name": "abilityTree.exampleStarter",
15            "customModelData": {
16              "rangeDispatch": [
17                178
18              ]
19            }
20          },
21          "format": "attribute"
22        },
23        "id": "exampleStarter"
24      },
25      "family": [
26        "exampleStarter"
27      ]
28    },
29    {
30      "type": "connector",
31      "coordinates": {
32        "x": 5,
33        "y": 2
34      },
35      "meta": {
36        "page": 1,
37        "icon": "connector_up_down"
38      },
39      "family": [
40        "exampleStarter",
41        "exampleMiddle"
42      ]
43    },
44    {
45      "type": "ability",
46      "coordinates": {
47        "x": 5,
48        "y": 3
49      },
50      "meta": {
51        "page": 1,
52        "icon": {
53          "value": {
54            "id": "minecraft:potion",
55            "name": "abilityTree.exampleMiddle",
56            "customModelData": {
57              "rangeDispatch": [
58                162
59              ]
60            }
61          },
62          "format": "attribute"
63        },
64        "id": "exampleMiddle"
65      },
66      "family": [
67        "exampleMiddle"
68      ]
69    },
70    {
71      "type": "connector",
72      "coordinates": {
73        "x": 5,
74        "y": 4
75      },
76      "meta": {
77        "page": 1,
78        "icon": "connector_up_down"
79      },
80      "family": [
81        "exampleMiddle",
82        "exampleFinisher"
83      ]
84    },
85    {
86      "type": "ability",
87      "coordinates": {
88        "x": 5,
89        "y": 5
90      },
91      "meta": {
92        "page": 1,
93        "icon": {
94          "value": {
95            "id": "minecraft:potion",
96            "name": "abilityTree.exampleFinisher",
97            "customModelData": {
98              "rangeDispatch": [
99                166
100              ]
101            }
102          },
103          "format": "attribute"
104        },
105        "id": "exampleFinisher"
106      },
107      "family": [
108        "exampleFinisher"
109      ]
110    }
111  ]
112}
<Note> This endpoint is cached for <Badge intent="warning" minimal>10 minutes</Badge> in the <Badge intent="warning" minimal>USER</Badge> cache source. See [Caching](/welcome#caching). <Indent></Indent> This endpoint belongs to the <Badge intent="warning" minimal>PLAYER</Badge> rate-limit bucket. See [Throttling and Rate Limits](/welcome#throttling-and-rate-limits). </Note> <Warning> Ability Tree is subject to [Access Rules](/privacy), which can make it unavailable. </Warning> <Info> It is recommended to request players by UUID. Username lookups can return `300 MultipleObjectsReturned` with a multi-selector response when more than one player matches the query. </Info> This endpoint only lists abilities the player has enabled and performs pathfinding on the fly. To render a full in-game style ability tree, combine this response with: - [GET /ability/tree/{tree}](api:GET/ability/tree/{tree}) - [GET /ability/map/{tree}](api:GET/ability/map/{tree})
Was this page helpful?
Previous

Get detailed character data

Next

Get OAuth2 identity

Built with

This endpoint is cached for 10 minutes in the USER cache source. See Caching.

This endpoint belongs to the PLAYER rate-limit bucket. See Throttling and Rate Limits.

Ability Tree is subject to Access Rules, which can make it unavailable.

It is recommended to request players by UUID. Username lookups can return 300 MultipleObjectsReturned with a multi-selector response when more than one player matches the query.

This endpoint only lists abilities the player has enabled and performs pathfinding on the fly.

To render a full in-game style ability tree, combine this response with:

  • GET /ability/tree/{tree}
  • GET /ability/map/{tree}

Path parameters

usernamestringRequired
Username or UUID accepted by the player route.
uuidstringRequiredformat: "uuid"

Response

Ability tree nodes grouped by page.
typeenum
Allowed values:
coordinatesobject
metaobject
familylist of strings

Errors

400
Bad Request Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error