Wynncraft Item Resource

Database


Category Searching

GET https://api.wynncraft.com/public_api.php?action=itemDB&category={category}

Returns a list of Wynncraft items matching the search category. Categories include: all, helmet, chestplate, leggings, boots, ring, necklace, bracelet, dagger, spear, bow, and wand.

Name Searching

GET https://api.wynncraft.com/public_api.php?action=itemDB&search={name}

Returns a list of Wynncraft items matching the search name. The name is case insensitive and can be partial.

Item Object

Field Type Description Options/Details
name String Item Name
displayName String (Optional) Display Name
tier String Item Tier Normal, Unique, Rare, Set, Legendary, Mythic, unique, rare, legendary
set String or null The name of the set this item is part of null if not part of a set
sockets Number Number of powder slots this item has
type String (Optional) This item's type Chestplate, Leggings, Wand, Dagger, Spear, Boots, Helmet, Bow, bow, wand, dagger, spear, boots, helmet, leggings, or chestplate
armorType String (Optional) This piece of armor's type Diamond, Iron, Leather, Chain, Golden, diamond, golden, iron, or chain
armorColor String (Optional) This piece of armor's color Format: "(red,green,blue)"
addedLore String or null This item's lore null if this item has no lore
material String (Optional) This item's material Minecraft block/item ID + optional data value, pre-flattening. Format: "ID:DV"
dropType String (Optional) This item's drop location/type never, lootchest, or dungeon
restrictions String (Optional) Restrictions on this items use Untradeable, untradeable, or Quest Item
damage String (Optional) Amount of neutral damage this weapon deals Format: "Minimum-Maximum"
fireDamage String (Optional) Amount of fire damage this weapon deals Format: "Minimum-Maximum"
waterDamage String (Optional) Amount of water damage this weapon deals Format: "Minimum-Maximum"
airDamage String (Optional) Amount of air damage this weapon deals Format: "Minimum-Maximum"
thunderDamage String (Optional) Amount of thunder damage this weapon deals Format: "Minimum-Maximum"
earthDamage String (Optional) Amount of earth damage this weapon deals Format: "Minimum-Maximum"
attackSpeed String (Optional) Attack speed of this weapon SUPER_SLOW, VERY_SLOW, SLOW, NORMAL, FAST, VERY_FAST, or SUPER_FAST
health Number (Optional) Set amount of health this armor provides
fireDefense Number (Optional) Set amount of fire defense this armor provides
waterDefense Number (Optional) Set amount of water defense this armor provides
airDefense Number (Optional) Set amount of air defense this armor provides
thunderDefense Number (Optional) Set amount of thunder defense this armor provides
earthDefense Number (Optional) Set amount of earth defense this armor provides
level Number Minimum level required to use this item
quest String or null The quest that must have been completed in order for this item to be used null if no quest is required
classRequirement String or null The class that is required for this item to be used Assassin, Archer, Warrior, Mage, or null if no class is required
strength Number The amount of strength points that is required for this item to be used
dexterity Number The amount of dexterity points that is required for this item to be used
intelligence Number The amount of intelligence points that is required for this item to be used
agility Number The amount of agility points that is required for this item to be used
defense Number The amount of defense points that is required for this item to be used
healthRegen Number (Identification) Percentage health regeneration modifier
manaRegen Number (Identification) Mana regeneration bonus per 4 seconds
spellDamage Number (Identification) Percentage spell damage modifier
damageBonus Number (Identification) Percentage melee damage modifier
lifeSteal Number (Identification) Amount of life
manaSteal Number (Identification) Amount of mana
xpBonus Number (Identification) Percentage XP bonus
lootBonus Number (Identification) Percentage loot bonus
reflection Number (Identification) Percentage reflection modifier
strengthPoints Number (Identification) Strength points provided by this item
dexterityPoints Number (Identification) Dexterity points provided by this item
intelligencePoints Number (Identification) Intelligence points provided by this item
agilityPoints Number (Identification) Agility points provided by this item
defensePoints Number (Identification) Defense points provided by this item
thorns Number (Identification) Percentage thorns modifier
exploding Number (Identification) Percentage exploding modifier
speed Number (Identification) Percentage walk speed modifier
attackSpeedBonus Number (Identification) Tier modifier to attack speed
poison Number (Identification) Percentage poison modifier
healthBonus Number (Identification) Health modifier Unlike health, this is a identification, rather than being set
soulPoints Number (Identification) Percentage chance to regenerate an additional soul point
emeraldStealing Number (Identification) Percentage bonus chance to steal an emerald on hit
healthRegenRaw Number (Identification) Bonus to health regeneration
spellDamageRaw Number (Identification) Bonus to spell damage
damageBonusRaw Number (Identification) Bonus to melee damage
bonusFireDamage Number (Identification) Percentage bonus to fire damage
bonusWaterDamage Number (Identification) Percentage bonus to water damage
bonusAirDamage Number (Identification) Percentage bonus to air damage
bonusThunderDamage Number (Identification) Percentage bonus to thunder damage
bonusEarthDamage Number (Identification) Percentage bonus to earth damage
bonusFireDefense Number (Identification) Percentage bonus to fire defense
bonusWaterDefense Number (Identification) Percentage bonus to water defense
bonusAirDefense Number (Identification) Percentage bonus to air defense
bonusThunderDefense Number (Identification) Percentage bonus to thunder defense
bonusEarthDefense Number (Identification) Percentage bonus to earth defense
accessoryType String (Optional) This accessory's type Ring, Bracelet, Necklace, necklace, ring
identified Boolean (Optional) If this item is pre-identified when obtained Assume false if this field is missing
skin String Base-64 encoded Json object containing the skin of the skull used by this item See details below
category String This item's category armor, weapon, or accessory

Identifications

All fields in the item object marked with '(Identification)' are identifications that are revealed when an item is identified. The values given by the API represent the 'base value' of that identification, when an item is actually identified a random number is generated for each non-zero identification and is then multiplied by that identification's base value. For identifications that have a positive base value, the random number can be between 0.3 and 1.3. For identifications that have a negative base value, the random number can be between 0.7 and 1.3. The result after multiplication is then rounded to the nearest integer, with a maximum value of -1 for negative identifications and a minimum value of 1 for positive identifications.

Response

{
    "items": ["name": String,
            "displayName": String,
            "tier": String,
            "set": String || null,
            "sockets": Number,
            "type": String,
            "armorType": String,
            "armorColor": String,
            "addedLore": String || null,
            "material": String,
            "dropType": String,
            "restrictions": String,
            "damage": String,
            "fireDamage": String,
            "waterDamage": String,
            "airDamage": String,
            "thunderDamage": String,
            "earthDamage": String,
            "attackSpeed": String,
            "health": Number,
            "fireDefense": Number,
            "waterDefense": Number,
            "airDefense": Number,
            "thunderDefense": Number,
            "earthDefense": Number,
            "level": Number,
            "quest": String || null,
            "classRequirement": String || null,
            "strength": Number,
            "dexterity": Number,
            "intelligence": Number,
            "agility": Number,
            "defense": Number,
            "healthRegen": Number,
            "manaRegen": Number,
            "spellDamage": Number,
            "damageBonus": Number,
            "lifeSteal": Number,
            "manaSteal": Number,
            "xpBonus": Number,
            "lootBonus": Number,
            "reflection": Number,
            "strengthPoints": Number,
            "dexterityPoints": Number,
            "intelligencePoints": Number,
            "agilityPoints": Number,
            "defensePoints": Number,
            "thorns": Number,
            "exploding": Number,
            "speed": Number,
            "attackSpeedBonus": Number,
            "poison": Number,
            "healthBonus": Number,
            "soulPoints": Number,
            "emeraldStealing": Number,
            "healthRegenRaw": Number,
            "spellDamageRaw": Number,
            "damageBonusRaw": Number,
            "bonusFireDamage": Number,
            "bonusWaterDamage": Number,
            "bonusAirDamage": Number,
            "bonusThunderDamage": Number,
            "bonusEarthDamage": Number,
            "bonusFireDefense": Number,
            "bonusWaterDefense": Number,
            "bonusAirDefense": Number,
            "bonusThunderDefense": Number,
            "bonusEarthDefense": Number,
            "accessoryType": String,
            "identified": Boolean,
            "skin": String,
            "category": String
        }],
    "request": {
        "timestamp": Number,
        "version": Number
    }
}

Skin Object

The skin field given in the item object is a base-64 encoded representation of a Json object; once decoded it follows the format of a response from Mojang's API. See the details here. Note that some decoded object's will be missing the timestamp, profileId, and profileName fields, so you should not rely on these fields being present.

{
    "timestamp": 1409195281585,
    "profileId": "5da801c1790c47378c8b396236d9a796",
    "profileName": "Chumbledore",
    "isPublic": true,
    "textures": {
        "SKIN": {
            "url": "http://textures.minecraft.net/texture/695bbf9f175b1e76a61b4cd0ba183b18c9467017f41ed1046abf65a4a63c4a0"
        }
    }
}