Wynncraft Player Resource

Rate-Limit

The Rate Limit for the Player Resource is 750 requests per 30 minutes per IP.

Statistics


GET /player/{username or UUID}/stats

Returns a Player Object, which details public statistical information about the player.

Note: Requests by UUID must be in dashed form (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)

Response

{
    "kind": "wynncraft/player/stats",
    "code": Number,
    "message": String,
    "timestamp": Number,
    "version": String,
    "data": [Player Object]
    // ...
}

Player Object

Field Type Description Options
username String Minecraft Username
uuid String Minecraft UUID
rank String Wynncraft Rank Administrator, Moderator, Builder, Item, Game Master, CMD, Music, Hybrid, Media. Default: Player
meta Object General Information
classes Array of Objects Holds all Classes
guild Object General Guild Information Returns an object containing name and rank
global Object Cumulative Class Information
ranking Object Ranking Information  

Meta Object

Field Type Description Options
firstJoin Date Date of First Join
lastJoin Date Date of Last Join
location Object General Location Information
playtime Number Player's total playtime in minutes
tag Object General Tag Information
veteran Boolean Is the player a veteran  

Location Object

Field Type Description Options
online Boolean Is the player online or not True if online
server String or null If online, on what server If offline, value will be null

Tag Object

Note: The descriptor "tag" means, if enabled, that a player has purchased a donation rank.

Field Type Description Options
display Boolean Is the tag displayed
value String The player's tag HERO, VIP+, VIP

Global Object

Field Type Description Options
chestsFound Number Total Chest Found
blocksWalked Number Total Blocks Walked
itemsIdentified Number Total Items Identified
mobsKilled Number Total mobs killed
totalLevel Object Total Level Values Returns an object containing combat, profession, and overall level totals
pvp Object Global PvP Information Returns an object containing kills and deaths
logins Number Number of Logins
deaths Number Number of Deaths
discoveries Number Total Number of Discoveries
eventsWon Number Total Number of Swarms Won  

Ranking Object

Field Type Description Options
guild null Waiting on v2 Guild Leaderboard
player Object Player Rankings Contains a "solo" object which lists solo rankings and an "overall" object which lists overall rankings
pvp null Waiting on v2 PvP Leaderboard
// Player Object
{
    "username": String,
    "uuid": String,
    "rank": String,
    "meta": {
        "firstJoin": Date,
        "lastJoin": Date,
        "location": {
            "online": Boolean,
            "server": String || null
        },
        "playtime": Number,
        "tag": {
            "display": Boolean,
            "value": String
        },
        "veteran": Boolean
    },
    "classes": [Object],
    "guild": {
        "name": String,
        "rank": String
    },
    "global": {
        "chestsFound": Number,
        "blocksWalked": Number,
        "itemsIdentified": Number,
        "mobsKilled": Number,
        "totalLevel": {
            "combat": Number,
            "profession": Number,
            "combined": Number
        },
        "pvp": {
            "kills": Number,
            "deaths": Number
        },
        "logins": Number,
        "deaths": Number,
        "discoveries": Number,
        "eventsWon": Number
    },
    "ranking": {
        "guild": null,
        "player": {
            "solo": {  
                "combat": Number || null,
                "woodcutting": Number || null,
                "mining": Number || null,
                "fishing": Number || null,
                "farming": Number || null,
                "alchemism": Number || null,
                "armouring": Number || null,
                "cooking": Number || null,
                "jeweling": Number || null,
                "scribing": Number || null,
                "tailoring": Number || null,
                "weaponsmithing": Number || null,
                "woodworking": Number || null,
                "profession": Number || null,
                "overall": Number || null
            },
            "overall":{  
                "all": Number || null,
                "combat": Number || null,
                "profession": Number || null
            }
        },
        "pvp": null
    }
}

Class Object

Field Type Description Options
name String Class Name
level Number Total Class Level
dungeons Object Class-Specific Dungeon Information
quests Object Class-Specific Quest Information
itemsIdentified Number Items Identified on Class
mobsKilled Number Mobs killed on Class
pvp Object Class PvP Information
chestsFound Number Chests Found on Class
blocksWalked Number Blocks Walked on Class
logins Number Number of Logins on Class
deaths Number Number of Deaths on Class
playtime Number Minutes played on Class
gamemode Object The challenge gamemodes that are enabled on this class
skills Object Class Skills Information
professions Object Class Professions Information The object has a field for each profession, (including combat). Each profession field is an object with the level and xp information
discoveries Number Discoveries discovered on Class
eventsWon Number Swarms beaten
preEconomy-Update Boolean Class was created before 1.18  

Dungeons Object

Field Type Description Options
completed Number Total Number of Dungeons Completed
list Array of Objects How many of which dungeon completed Includes dungeon name and number completed

Quests Object

Field Type Description Options
completed Number Total Number of Quests Completed
list Array of String Quests Completed  

PvP Object

Field Type Description Options
kills Number Number of PvP Kills on Class
deaths Number Number of PvP Deaths on Class  

Gamemode Object

Field Type Description Notes
craftsman Boolean Does this class have the craftsman challenge enabled
hardcore Boolean Does this class have the hardcode challenge enabled True when turned on at creation regardless of if the challenge is failed or not
ironman Boolean Does this class have the ironman challenge enabled

Skills Object

Field Type Description Options
strength Number Number of Strength Skill Points on Class
dexterity Number Number of Dexterity Skill Points on Class
intelligence Number Number of Intelligence Skill Points on Class
defense Number Number of Defense Skill Points on Class
agility Number Number of Agility Skill Points on Class  
// Class Object
{
    "name": String,
    "level": Number,
    "dungeons": {
        "completed": Number,
        "list": [
            {
                "name": String,
                "completed": Number
            },
            // ...
        ]
    },
    "quests": {
        "completed": Number,
        "list": [String]
    },
    "itemsIdentified": Number,
    "mobsKilled": Number,
    "pvp": {
        "kills": Number,
        "deaths": Number
    },
    "chestsFound": Number,
    "blocksWalked": Number,
    "logins": Number,
    "deaths": Number,
    "playtimes": Number,
    "gamemode": {
        "craftsman": Boolean,
        "hardcore": Boolean,
        "ironman": Boolean
    },
    "skills": {
        "strength": Number,
        "dexterity": Number,
        "intelligence": Number,
        "defense": Number,
        "agility": Number
    },
    "professions": {
        "alchemism":{  
            "level": Number,
            "xp": Number
        },
        "armouring":{  
            "level": Number,
            "xp": Number
        },
        "combat":{  
            "level": Number,
            "xp": Number
        },
        "cooking":{  
            "level": Number,
            "xp": Number
        },
        "farming":{  
            "level": Number,
            "xp": Number
        },
        "fishing":{  
            "level": Number,
            "xp": Number
        },
        "jeweling":{  
            "level": Number,
            "xp": Number
        },
        "mining":{  
            "level": Number,
            "xp": Number
        },
        "scribing":{  
            "level": Number,
            "xp": Number
        },
        "tailoring":{  
            "level": Number,
            "xp": Number
        },
        "weaponsmithing":{  
            "level": Number,
            "xp": Number
        },
        "woodcutting":{  
            "level": Number,
            "xp": Number
        },
        "woodworking":{  
            "level": Number,
            "xp": Number
        }
    },
    "discoveries": Number,
    "eventsWon": Number,
    "preEconomyUpdate": Number
}

UUID


GET /player/{username}/uuid

Returns the uuid for a given username (this should not be used in place of the mojang api, and your IP will be blocked if you do so).

Field Type Description Options
name String Username of Player
uuid String Uuid of Player

Response

{
    "kind": "wynncraft/player/stats",
    "code": Number,
    "message": String,
    "timestamp": Number,
    "version": String,
    "data": [{
        "name": String,
        "uuid": String
    }]
    // ...
}