OnWorldItemDropCancelled: Difference between revisions
Document upcoming 0.1.9 custom native keys, shared doors, server Lua callbacks and persistence; not a release |
Release 0.1.9 / BUILD264 / Protocol42: availability and download setup; preserve experimental limits |
||
| Line 1: | Line 1: | ||
= onWorldItemDropCancelled = | = onWorldItemDropCancelled = | ||
'''Available from 0.1.9 | '''Available from 0.1.9. Use matching updated server and clients.''' | ||
Server-side event, handled on root. Captured persistence owner only. Deferred notification after cancellation of a pending drop. The core handles live rollback for a still-connected player; your gamemode owns durable inventory recovery. Do not grant the quantity again. Timestamp is the original drop creation time. | Server-side event, handled on root. Captured persistence owner only. Deferred notification after cancellation of a pending drop. The core handles live rollback for a still-connected player; your gamemode owns durable inventory recovery. Do not grant the quantity again. Timestamp is the original drop creation time. | ||
Latest revision as of 13:28, 20 October 2026
onWorldItemDropCancelled
Available from 0.1.9. Use matching updated server and clients.
Server-side event, handled on root. Captured persistence owner only. Deferred notification after cancellation of a pending drop. The core handles live rollback for a still-connected player; your gamemode owns durable inventory recovery. Do not grant the quantity again. Timestamp is the original drop creation time.
Callback
addEventHandler("onWorldItemDropCancelled", root, function(objectId, playerId, item, quantity, serverTimeMs)
-- Add server-side handling here; see the Custom keys guide.
end)
Contract
Door id is resource-local; playerId is a numeric server player ID; item is the canonical item string. Only parameters shown in this event's signature are passed. eventOrigin is "server"; sourceResource is a table with name="server". No addEvent declaration is needed. This name cannot be opted into remote calls or forged by Lua triggerEvent.
See callback delivery and limits. Notifications are not cancellable hooks or durable transaction logs; readiness reports do not grant entitlement. See drop/pickup persistence before changing inventory in a handler.