SetWorldDoorKey

From Wiki G1R-MP G1 Remake Multiplayer
Revision as of 13:29, 20 October 2026 by QCherry (talk | contribs) (Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

setWorldDoorKey

Available from 0.1.9. Use matching updated server and clients.

Server Lua. Part of custom keys and shared placed doors.

Syntax

ok, error = setWorldDoorKey(id, item)

Parameters and behavior

id identifies an owned placed door. item is an active canonical custom key from this or another resource. Assigns the key and enables its lock. One key type can open multiple doors; at least one authoritative copy is required and is not consumed.

Returns

true, empty error on success; false, error string otherwise. Locking does not close an open door. An actual rule change queues onWorldDoorLockChange.

Examples and security

See Custom keys for complete registration, copy issuance, placement, persistence and callback examples. These are server functions, not client RPC endpoints. Do not forward untrusted client arguments without gameplay authorization.