AddCharModel

AddCharModel

Description:

Function AddCharModel adds a new custom character model for download. The model files will be stored in player's Documents\GTA San Andreas User Files\SAMP\cache under the Server IP and Port folder in a CRC-form (https://en.wikipedia.org/wiki/Cyclic_redundancy_check) file name.

There are currently no restrictions on when you can call this function, but be aware that if you do not call them inside OnFilterScriptInit/OnGameModeInit, you run the risk that some players, who are already on the server, may not have downloaded the models.

Function AddCharModel was added in 0.3.DL R1 and will not work in earlier versions!

useartwork must be enabled first in server settings in order for this to work

Parameters:

(baseid, newid, dffname[], txdname[])

int

baseid

The base skin model ID to use (behavior of the character & original character to use when download is failed).

int

newid

The new skin model ID ranged from 20000 to 30000 (10000 slots) to be used later with SetPlayerSkin.

string

dffname

Name of the .dff model collision file located in models server folder by default (artpath setting).

string

txdname

Name of the .txd model texture file located in models server folder by default (artpath setting).

Return Values:

• 1: The function was executed successfully.
• 0: The function failed to execute.

Examples:

Example 1Example 2

// Using artconfig.txt
AddCharModel(305, 20001, "lvpdpc2.dff", "lvpdpc2.txd");
AddCharModel(305, 20002, "lapdpd2.dff", "lapdpd2.txd");

// Pawn Script
public OnGameModeInit()
{
	AddCharModel(305, 20001, "lvpdpc2.dff", "lvpdpc2.txd");
	AddCharModel(305, 20002, "lapdpd2.dff", "lapdpd2.txd");
	return 1;
}

Related Functions

The following functions may be useful, as they are related to this function in one way or another.

• GetPlayerSkin: Get a player's current skin.
• SetPlayerSkin: Set a player's skin.
• GetPlayerCustomSkin: Returns the class of the players custom skin downloaded from the server.