SetElementCollidableWith: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
(add Weapon to supported element types)
 
(12 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{Client function}}  
{{Client function}}
__NOTOC__  
__NOTOC__  
'''NOTE: This function does not work correctly in 1.0.1 - Only use in 1.0.2'''
This function can be used to set an element to collide with another element. An element with collisions disabled does not interact physically with the other element.<br>
This function can be used to set an element to collide with another element. An element with collisions disabled does not interact physically with the other element.<br>
'''Note:''' You can only use this function with the element types listed below.
'''Note:''' You can only use this function with the element types listed below.
Line 9: Line 7:
*[[Vehicle]]
*[[Vehicle]]
*[[Object]]
*[[Object]]
{{Added feature/item|1.5.9|1.5.8|21348|
* [[Element/Weapon|Weapon]]
}}


==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool setElementCollidableWith ( element theElement, element withElement, bool enabled )  
bool setElementCollidableWith ( element theElement, element withElement, bool enabled )  
</syntaxhighlight>  
</syntaxhighlight>
{{OOP||[[element]]:setCollidableWith||isElementCollidableWith}}


===Required Arguments===  
===Required Arguments===  
Line 26: Line 28:
<section name="Client" class="client" show="true">
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
-- TODO
function ghostmode_on()
local playerVehicle = getPedOccupiedVehicle(localPlayer) -- Get the players vehicle
if(playerVehicle) then -- Check the return value.
for i,v in pairs(getElementsByType("vehicle")) do --LOOP through all vehicles
setElementCollidableWith(v, playerVehicle, false) -- Set the collison off with the other vehicles.
end
outputChatBox("You are now a Ghost")
end
end
addCommandHandler("ghostmode", ghostmode_on) -- Add the /ghostmode Command.
</syntaxhighlight>
</syntaxhighlight>
</section>
</section>
Line 32: Line 43:
==See Also==
==See Also==
{{Client element functions}}
{{Client element functions}}
[[Category:Needs_Example]]

Latest revision as of 21:31, 7 October 2022

This function can be used to set an element to collide with another element. An element with collisions disabled does not interact physically with the other element.
Note: You can only use this function with the element types listed below.

Syntax

bool setElementCollidableWith ( element theElement, element withElement, bool enabled ) 

OOP Syntax Help! I don't understand this!

Method: element:setCollidableWith(...)
Counterpart: isElementCollidableWith


Required Arguments

  • theElement: The element which colliding you want to change
  • withElement: The other element you wish the first entity to collide with
  • enabled: A boolean to indicate whether elements should be able to collide with eachother (true) or not (false)

Returns

Returns true if the collisions were set succesfully, false otherwise.

Example

Click to collapse [-]
Client
function ghostmode_on()
	local playerVehicle = getPedOccupiedVehicle(localPlayer) -- Get the players vehicle
	if(playerVehicle) then -- Check the return value.
		for i,v in pairs(getElementsByType("vehicle")) do --LOOP through all vehicles
			setElementCollidableWith(v, playerVehicle, false) -- Set the collison off with the other vehicles.
		end
		outputChatBox("You are now a Ghost")
	end
end
addCommandHandler("ghostmode", ghostmode_on) -- Add the /ghostmode Command.

See Also