Ability & Aspects module

This module manages:

• GET Ability tree
• GET Ability map
• GET Aspects list

It is located at https://api.wynncraft.com/v3/ability

TIP

Ability & Aspects uses the API Markup parser.

TIP

Combining ability tree, ability map and player character abilities will give you enough data to render a player's ability tree like in game, example of that are on wynncraft official stat page

Ability tree

GET .../ 1 hour TTL

{
    "archetypes": {
        "archetypeName": {
            "name": str,
            "description": str,
            "shortDescription": str, # Description shown on the AT Gui in game
            "icon": {
                "value": dict({
                    "id": str,
                    "name": str,
                    "customModelData": str
                }) or str,
                "format": str
            },
            "slot": int
        },
        # [...]
    },
    "pages": {
        "pageNumber": {
            "abilityId": {
                "name": str,
                "icon": {
                    "value": dict({
                        "id": str,
                        "name": str,
                        "customModelData": str
                    }) or str,
                    "format": str
                },
                "slot": int,
                "coordinates": {
                    "x": int,
                    "y": int
                },
                "description": [
                    "line1",
                    "line2",
                    # [...]
                ],
                "requirements": {
                    "ABILITY_POINTS": int,
                    "NODE": str, # Ability ID of the required node
                    "ARCHETYPE": {
                        "name": str,
                        "amount": int # Number of abilities required in the said archetype
                    },
                },
                "links": [ # List of linked abilities, in map this is referred as "family"
                    "abilityId",
                    # [...]
                ],
                "locks": [ # List of abilities locking unlock of this one
                    "abilityId",
                    # [...]
                ],
                "page": int
            },
            # [...]
        },
        # [...]
    }
}

Request Playground

Ability map

GET .../ 1 hour TTL

{
    "1": {
        {
            "type": "ability",
            "coordinates": {
                "x": int,
                "y": int
            },
            "meta": {
                "icon": {
                    "value": dict({
                        "id": str,
                        "name": str,
                        "customModelData": str
                    }) or str,
                    "format": str
                },
                "page": int,
                "id": str
            },
            "family": [
                str,
                # [...]
            ]
        },
        {
            "type": "connector",
            "coordinates": {
                "x": int,
                "y": int
            },
            "meta": {
                "icon": "connector_up_down", # Connector icon syntax is both direction clockwise like right_left or right_down_left
                "page": int
            },
            "family": [
                str,
                # [...]
            ]
        },
    },
    "2": {
        # [...]
    },
    # [...]
}

[
    {
        "type": "ability",
        "coordinates": {
            "x": int,
            "y": int
        },
        "meta": {
            "icon": {
                "value": dict({
                    "id": str,
                    "name": str,
                    "customModelData": str
                }) or str,
                "format": str
            },
            "page": int,
            "id": str  # Internal id of the ability, abilities in AT response are refered by the same id
        },
        "familiy": [  # Ability ids listed here are abilities connected to the current one
            "ability1"
            # [...]
        ]
    },
    {
        "type": "connector",
        "coordinates": {
            "x": int,
            "y": int
        },
        "meta": {
            "icon": "connector_up_down",
            # Connector icon syntax is both direction clockwise like right_left or right_down_left
            "page": int
        },
        "family": [  # Ability ids listed here are abilities assiciated to this connector
            "ability1",
            # [...]
        ]
    },
    # [...]
]

Request Playground

Map structure shared with player character abilities

Aspects list

GET .../ 1 hour TTL

{
    "aspectName": {
        "name": str,
        "icon": {
            "value": dict({
                "id": str,
                "name": str,
                "customModelData": str
            }) or str,
            "format": str
        },
        "rarity": str,
        "requiredClass": str,
        "tiers": {
            "1": {
                "threshold": int, # Number of aspects needed to unlock the tier
                "description": [
                    str, # Each entry = one line
                    str
                ]
            },
            # [...]
        }
    },
    # [...]
}

Request Playground