GetItemStats: Difference between revisions
Jump to navigation
Jump to search
Document planned 0.1.9 item stats, armor, runes and experimental map-editor seats/lights; not a release |
Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits |
||
| Line 2: | Line 2: | ||
<div style="background:#fff5f5; border:1px solid #d13b3b; border-left:5px solid #d13b3b; color:#111111; padding:0.85rem 1rem; margin:0.75rem 0 1rem;"> | <div style="background:#fff5f5; border:1px solid #d13b3b; border-left:5px solid #d13b3b; color:#111111; padding:0.85rem 1rem; margin:0.75rem 0 1rem;"> | ||
<div style="color:#111111; font-weight:bold; letter-spacing:0.04em;">AVAILABLE FROM UPDATE 0.1.9</div> | <div style="color:#111111; font-weight:bold; letter-spacing:0.04em;">AVAILABLE FROM UPDATE 0.1.9</div> | ||
<div style="color:#111111; margin-top:0.25rem;"> | <div style="color:#111111; margin-top:0.25rem;">Available from 0.1.9. See the scope and validation notes below.</div> | ||
</div> | </div> | ||
| Line 31: | Line 31: | ||
== Notes == | == 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. | * 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. | * Use matching supported client and server builds. Server acceptance and a client application report do not prove the native gameplay effect. | ||
Latest revision as of 13:27, 20 October 2026
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.