DropPlayerCarryItem

Makes a player let go of what he carries - at once, where the mode says.

The item leaves his hands on every screen at once (no put-down animation) and lies at x, y, z - or, without a place, a step in front of him (at his feet when a wall is there). OnPlayerPutDownCarryItem follows with the reason "mode". false when he carries nothing.

Syntax

DropPlayerCarryItem(pid [, x, y, z])

Parameter	Type
pid	number	the carrier
x	number	metres - where it lies; all three or none (optional)
y	number	metres (optional)
z	number	metres (optional)

Returns

boolean - true when he let go of something

Example

-- nobody carries a sack into the church
function OnPlayerEnterZone(pid, zone)
  if zone == churchZone and GetPlayerCarryItem(pid) then
    DropPlayerCarryItem(pid)
    SendClientMessage(pid, COLOR_SERVER, "Leave that outside.")
  end
end

See also

TakePlayerCarryItem · OnPlayerPutDownCarryItem · PickUpCarryItem · the Carry items group of the index