Function: SetEquippedItem(entity, slot, item)
Description: For a connected Player in a zone, requests an exact transfer of that Player's original inventory item into an empty equipment slot. The allocation is not cloned. Items owned by another Player, already equipped items and unsupported item provenance return false unchanged. This trusted setup path preserves attunement flags and does not run gameplay equip hooks or automatic consumption. It still requires a valid native equipment graph and slot.
For an NPC, returns false and leaves both the item and equipment unchanged. Item userdata is an observation of its original allocation and does not carry the sole construction owner's permission to transfer that allocation, even when it is unpublished. Use SetEquippedItemByID for a fresh owned NPC grant. The binding neither adopts the observed pointer nor silently clones the item.
Parameters:
entity: Player or NPC Entity spawn. slot: integer native equipment slot from
0 through 24. item: Item userdata for the original allocation.
Returns: Boolean admission result. For a Player, true acknowledges owned in-memory work; the exact transfer may defer or cancel if its original intent becomes stale. It is not a durable-save receipt. A Player without a current original connection and zone returns false unchanged. Invalid entity/item or an invalid, fractional, negative or out-of-range slot returns no value (nil).