GetItemStats

getItemStats

AVAILABLE FROM UPDATE 0.1.9

Available from 0.1.9. See the scope and validation notes below.

Reads the current item-type profile and its effective numeric values.

Syntax

stats = getItemStats(item)

Parameters

Name	Type	Required	Description
item	string	yes	Known canonical item key or recognized alias; this is not an inventory-instance ID.

Returns

nil for an unknown type; otherwise a table with item, owner, revision, registryRevision, defaults, nativeDefaults, overrides and effective. Both revisions are decimal strings; owner is empty when unowned. defaults is the multiplayer baseline, nativeDefaults contains observed native values, overrides contains explicit changes, and effective contains resolved values. Unknown/absent values are omitted, not zero. Damage-channel totals and periodic durations are resolved in effective.

Examples

local stats = getItemStats("mercenary")
if stats then
    outputDebugString(tostring(stats.effective.resistanceEdge))
end

Notes

• Available from G1R:MP 0.1.9. This documents the implemented API and its current limits. See Item type stats for scope and remaining in-game validation.
• Server-side only. Profiles affect every copy of the same type on this server, across dimensions; not individual item instances.
• Use matching supported client and server builds. Server acceptance and a client application report do not prove the native gameplay effect.
• The multiplayer baseline and native observed values may differ. Reading a profile does not grant ownership or change the item.