OnColShapeLeave: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
Line 20: Line 20:


-- call 'jailZoneLeave' whenever a player leaves the collision shape:
-- call 'jailZoneLeave' whenever a player leaves the collision shape:
addEventHandler ( "onColShapeLeave", jailZone, jailZoneLeave )
function jailZoneLeave ( thePlayer )
function jailZoneLeave ( thePlayer )
   if getElementType ( thePlayer ) == "player" then -- if the element that left was player
   if getElementType ( thePlayer ) == "player" then -- if the element that left was player
Line 27: Line 26:
   end
   end
end
end
addEventHandler ( "onColShapeLeave", jailZone, jailZoneLeave )
</syntaxhighlight>
</syntaxhighlight>


{{See also/Server event|Colshape events}}
{{See also/Server event|Colshape events}}

Revision as of 12:10, 31 March 2013

This event is triggered when a player or a vehicle leaves a collision shape.

Parameters

element leaveElement, bool matchingDimension
  • leaveElement: The element that who exited the col shape. This can be a player or a vehicle.
  • matchingDimension: a boolean referring to whether the collision shape was in the same dimension as the element.

Source

The source of this event is the colshape that the element no longer is in contact with.

Example

This example kills the player whenever they leave a certain collision shape:

local jailZone = createColCircle ( 1024, 1024, 15 ) -- create a collision shape

-- call 'jailZoneLeave' whenever a player leaves the collision shape:
function jailZoneLeave ( thePlayer )
   if getElementType ( thePlayer ) == "player" then -- if the element that left was player
      killPlayer ( thePlayer ) -- kill the player
      outputChatBox ( "You are not allowed to leave the jail!", thePlayer )
   end
end
addEventHandler ( "onColShapeLeave", jailZone, jailZoneLeave )

See Also

Colshape events


Event functions