SetNpcWeapon

setNpcWeapon

Changes the authoritative weapon of a resource-owned scripted NPC.

Syntax

bool setNpcWeapon(int npcId, string itemKey)

Parameters

Name	Type	Required	Description
npcId	int	yes	The server-assigned NPC identifier returned by spawnNpc or getNpcs.
itemKey	string	yes	A validated key returned by getPlayerWeaponNames; armor and weapon accept none to clear the slot.

Returns

Returns true when the validated change is accepted and replicated; otherwise returns false.

Examples

Change an NPC's weapon:

setNpcWeapon(npcId, "none")

Notes

• Available only in server-side resource scripts.
• The state is sent reliably to current viewers and replayed on relevance entry and late join.
• Raw Unreal object paths are never accepted from Lua.
• Use getPlayerWeaponNames to enumerate supported keys.