SetNpcArmorUpgrades

setNpcArmorUpgrades

AVAILABLE FROM UPDATE 0.1.9

Available from 0.1.9.

Replaces all three selected armor-upgrade slots for a resource-owned NPC.

Syntax

accepted = setNpcArmorUpgrades(npcId, parts)

Parameters

Name	Type	Required	Description
npcId	number	yes	Existing scripted human NPC ID: finite integer 1..4294967295, not a numeric string.
parts	table	yes	String keys top/mid/bottom only, with compatible part-key string values. Omitted slots, empty strings or none clear a slot. {} clears all parts.

Returns

Boolean: true when accepted; false for invalid arguments/selection, unavailable character, wrong family/slot, or failed ownership/requirements. Invalid selections are rejected before equipment mutation.

Examples

-- NPC already wears mercenary and belongs to this resource.
local presets = getArmorUpgradePresets("mercenary")
if presets and presets.heavy_2 then
    assert(setNpcArmorUpgrades(npcId, presets.heavy_2))
end

Notes

• Server-side only; available from 0.1.9.
• See Armor upgrades, Armor catalog and Armor upgrade catalog.
• Only the resource owning the NPC may change its parts. No player-inventory or player-requirement check is applied to NPCs.
• Uses the already equipped base; never selects a different base. The part must match its family and slot.
• true confirms server acceptance, not completed native rendering. No automatic healing/refill or database save.
• Treat remote requests as untrusted; authorize the action in your server resource.
• This is replacement, NOT a partial patch. Read the current table and modify one field to preserve the other slots. Values are keys, not item IDs; unknown table fields and non-string values reject the request.
• Equivalent alias: SetNpcArmorUpgrades.