ResetItemStats
resetItemStats
AVAILABLE FROM UPDATE 0.1.9
Planned for 0.1.9; not yet publicly released. Not included in public 0.1.8. See the scope and validation notes below.
Removes one property override or all overrides of one item type owned by this resource.
Syntax
accepted, error, revision = resetItemStats(item [, property])
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
item |
string |
yes | Known canonical item key or recognized alias; this is not an inventory-instance ID. |
property |
string |
no | Exact property name to reset. Omit to reset the whole type. |
Returns
Three values: accepted (boolean), error (string; empty on success), revision (decimal string). Check accepted before using the revision. Success means server acceptance, not visual/client completion. A no-op may return the unchanged revision.
Examples
local ok, why = resetItemStats("mercenary", "resistanceEdge")
assert(ok, why)
-- To reset every override of this armor instead:
-- local ok, why = resetItemStats("mercenary")
Notes
- Planned for G1R:MP 0.1.9; not yet publicly released and not included in public 0.1.8. This documents the implemented development API, not a release announcement. 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.
- Active overrides are owned per item type by the calling resource. Another resource cannot change that owned type. Resource stop removes its overrides.
- Validation is atomic for the submitted transaction. Unsupported fields, wrong families, invalid/non-finite values, duplicate item/property aliases or ownership conflicts reject it.
- A numeric 0 is an explicit value where allowed, not reset. Use resetItemStats to remove an override. Profiles are not automatically persisted.
- Do not expose this setter directly to untrusted remote events. See getItemStatDefinitions and Item stat properties.
- Restores the multiplayer baseline for server-controlled values and the captured originals for applicable native edits. It does not heal, revive or erase equipment.