DE/engineReplaceModel

From Multi Theft Auto: Wiki

[[{{{image}}}|link=]] Note: Please note the loading order that is used in the examples as other orders can cause textures, collisions or the DFF not to load due to technical limitations

Diese Funktion ersetz ein vorhandes Model mit einer neuen DFF Datei. Es werden momentan Fahrzeuge und Objekte unterstütz.

Seit 1.1.1 unterstütz diese Funktion Peds und Waffenmodelle. Um Waffenmodelle ersetzen zu können, kannst du nicht die Waffen ID's benutzen, sondern die Objekt ID's. Alle Waffenmodelle sind hier zu sehen: Weapons.

Achtung: Wenn man ein Objekt mit einer eingebauten Collision (Fahrzeuge) ersetz, kann es vorkommen dass die Collision nicht richtig ersetz wurde. Man arbeitet daran die DFF Datei noch einmal zu laden und sie kurz danach zu ersetzen.

Syntax

bool engineReplaceModel ( dff theModel, int modelID [, bool alphaTransparency = false ] )

Required Arguments

  • theModel: Das neue Model, welches ein Anderes ersetzen soll.
  • modelID: Die Model ID welche ersetz werden soll

Optional Arguments

  • alphaTransparency: Set to true to enable special thing

Returns

Returns true if the model was successfully replaced, false if it failed for some reason, ie. the DFF or the model ID is not valid.

Example

Example 1:

Click to collapse [-]
Client

Client-Side example for replacing vehicle model and texture with custom ones.

function ReplaceVehicle ( )
outputChatBox ( "> replacing the euros vehicle" )

txd = engineLoadTXD ( "data/euros.txd" )
engineImportTXD ( txd, 587 )
dff = engineLoadDFF ( "data/euros.dff", 587 )
engineReplaceModel ( dff, 587 )
end

addEvent ( "replaceVeh", true )
addEventHandler ( "replaceVeh", getRootElement(), ReplaceVehicle )
Click to collapse [-]
Server

Server-side example function for triggering the replace.

function ReplaceCommand ( )
triggerClientEvent( "replaceVeh", getRootElement(), replaceVeh )
end
addCommandHandler( "replace", ReplaceCommand )

Example 2:

Click to collapse [-]
Client

Client-Side example for replacing object model, collision and texture with custom ones.

function ReplaceObject ( )

txd = engineLoadTXD( "MyModel.txd" )
col = engineLoadCOL( "MyModel.col" )
dff = engineLoadDFF( "MyModel.dff", 0 ) --modelid is everytime 0, when you replace no vehicle

engineImportTXD( txd, 1234 )
engineReplaceCOL( col, 1234 )
engineReplaceModel( dff, 1234 )-- replace the model at least

end

addEvent ( "replaceObj", true )
addEventHandler ( "replaceObj", getRootElement(), ReplaceObject )
Click to collapse [-]
Server

Server-side example function for triggering the replace.

function ReplaceCommand ( )
triggerClientEvent( "replaceObj", getRootElement(), replaceObj )
end
addCommandHandler( "replace", ReplaceCommand )

See Also

BETA: FROM VERSION 1.5.7 r19626 ONWARDS
BETA: FROM VERSION 1.5.7 r20147 ONWARDS
BETA: FROM VERSION 1.5.7 r20416 ONWARDS
BETA: FROM VERSION 1.5.7 r20383 ONWARDS
BETA: FROM VERSION 1.5.7 r20477 ONWARDS