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
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
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
    }]
    // ...
}