Huntera's item catalogue as the game publishes it, priced as Huntera
prices it. slot is given in Tibia's vocabulary rather than the game's —
the two name the same ten slots and four of them differently, amulet
against necklace among them — so a client can cross the two APIs on one
word.
category is the shelf the game files the item under, as a {slug, name} pair.
The slug is the value ?filter[category]=helmets takes — unchanged, and a slug
outside the 24 shelves is a 400 rather than an empty page — and the name is what
the game's own legend prints for it, Wands & Rods for wands-rods. There are
24 shelves and the capture uses 22 of them.
It was the bare code two releases ago and the bare slug until now. The
legend turned out to ship with the data all along, so the number went and the
name arrived: one shelf, one value to filter on, and the words the game itself
uses for it beside them.
tibia_item_type beside it is a different thing and still a derivation — this
API's reading of that shelf as a tibia.dev item type, not anything the game
published. It carries its own confidence: 1 on eleven of the 22 codes in use
and 0.33 to 0.98 on the other eleven, so read the figure before you trust the
type. A row carrying it always names the field in fallbacks too.
weight is in ounces. It read hundredths of an ounce until the unit was
measured against the wiki's own rendering and against tibia.dev's figure for
the same object, so a weight that answered 8,500 answers 85 now, and
filter[min_weight] and filter[max_weight] take ounces with it.
filter[resists] and filter[weak_to] take an element rather than a
column — physical, energy, earth, fire, lifedrain, ice,
holy, death, manadrain — and answer with the items whose
resistance to it falls on one side of zero. Only 26 of the 837 items
carry a negative figure, terra mantle among them at earth 8 and fire
−8, so the weakness half is a narrow answer by nature.
Where an item comes from and what it is good for — which creatures drop it,
which bosses do, which hunts list it, which quests award it, which
imbuements it feeds — is left out until you ask: name those relations in
include, or read a single item, which answers all five at once.
dropped_by_bosses names the boss doors whose drop strip lists the item, with
the rarity the strip grades it at and never a rate — the game publishes none
for a boss drop. It is a list of its own rather than more entries in
dropped_by because the two carry different figures. 22 of the 43 items a
boss strip resolves to have no creature loot line at all, so for those it is
the only answer to what drops them, and filter[dropped_by] reads both lists:
jaul finds what Jaul drops.
dropped_by is a list of drops rather than of creatures, so a creature can
appear in it more than once and a client keying it on the creature would
lose rows. The gold coin is the extreme: 114 entries over 94 creatures. That
is the game rolling twice for the same item rather than a duplicate — 18
creature-and-item pairs repeat across the catalogue, three of them with every
published field identical, so nothing in the payload could tell those two
entries apart and collapsing them would assert which roll was the real one.
Fifteen fields moved into four objects and category became a pair, which is a
breaking change on this endpoint. Nothing was renamed beyond the moves, no value
changed and no field was dropped:
required_levelisrequirements.level,vocationsisrequirements.vocationsattack,defense,armor,range,two_handed,attack_skill,elemental_type
andelemental_damageare the same names undercombatspeed_bonusisbonuses.speed,magic_level_bonusisbonuses.magic_level,
skill_bonusesisbonuses.skillsnpc_buyandnpc_sellare the same names undertradecategorywas the shelf's slug and is{slug, name}now, the slug unchanged
slot, weight, imbuement_slots, resistances and tibia_item_type did not move,
and neither did any filter or sort — ?filter[min_required_level]=, ?sort=armor and
?filter[category]=helmets all read columns and take exactly what they took before.
The groups are four questions rather than a tidying: whether a character can equip it,
what it does in a fight, what it adds while worn, and what it costs. They are typed
numbers throughout — this is deliberately not Tibia's attributes map, which is a
pivot of free-text wiki values and publishes "armor":"17" as a string.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||