EngineReplaceCOL

This function replaces the collision file of the given model id to the collision file passed. Use engineLoadCOL to load the collision file first.

Note: collision libraries (.col files containing multiple collision models) are not supported at the moment. Also, collision files have to be version 3 (COL3).

Syntax

bool engineReplaceCOL ( col theCol, int modelID )

Required Arguments

theCol: The collision file to replace with
modelID: The model ID whose collision file you want to replace

Returns

Returns true if the collision was successfully replaced, false or nil if the collision could not be replaced for a reason.

Example

Click to collapse [-]

Client

Client-Side example for replacing object collision with custom one.

function ReplaceCollision ( )
outputChatBox ( "> Replacing Collision Data." )
col = engineLoadCOL( "myColFile.col" )
engineReplaceCOL( col, 3356 )
end

addEvent ( "collisionReplace", true )
addEventHandler ( "collisionReplace", getRootElement(), ReplaceCollision )

Click to collapse [-]

Server

Server-side example function for triggering the replace.

function ReplaceCols ( )
triggerClientEvent ( "collisionReplace", getRootElement(), collisionReplace )
end
addCommandHandler("replacecol", ReplaceCols)