AddCharModel
From SA-MP Wiki
(Difference between revisions)
Revision as of 09:44, 31 December 2018 RoboN1X (Talk | contribs) ← Previous diff |
Current revision RoboN1X (Talk | contribs) |
||
Line 6: | Line 6: | ||
{{Parameters|baseid, newid, dffname[], txdname[]}} | {{Parameters|baseid, newid, dffname[], txdname[]}} | ||
- | {{Param|baseid|The base [[Skins:All|skin model ID]] to use (behavior of the character.)}} | + | {{Param|baseid|The base [[Skins:All|skin model ID]] to use (behavior of the character & original character to use when download is failed).}} |
{{Param|newid|The new skin model ID ranged from 20000 to 30000 (10000 slots) to be used later with [[SetPlayerSkin]]}} | {{Param|newid|The new skin model ID ranged from 20000 to 30000 (10000 slots) to be used later with [[SetPlayerSkin]]}} | ||
{{Param|dffname|Name of the '''.dff''' model collision file located in <tt>models</tt> server folder by default ([[Server.cfg#Custom_models|artpath setting]]).}} | {{Param|dffname|Name of the '''.dff''' model collision file located in <tt>models</tt> server folder by default ([[Server.cfg#Custom_models|artpath setting]]).}} |
Current revision
Description:
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 file name.
(baseid, newid, dffname[], txdname[])
baseid | The base skin model ID to use (behavior of the character & original character to use when download is failed). |
newid | The new skin model ID ranged from 20000 to 30000 (10000 slots) to be used later with SetPlayerSkin |
dffname | Name of the .dff model collision file located in models server folder by default (artpath setting). |
txdname | Name of the .txd model texture file located in models server folder by default (artpath setting). |
Return Values:
- 1: The function executed successfully.
- 0: The function failed to execute.
Note | useartwork must be enabled first in server settings in order for this to work |
Example Usage: Using artconfig.txt
AddCharModel(305, 20001, "lvpdpc2.dff", "lvpdpc2.txd"); AddCharModel(305, 20002, "lapdpd2.dff", "lapdpd2.txd");
Example Usage: Pawn Script
public OnGameModeInit() { AddCharModel(305, 20001, "lvpdpc2.dff", "lvpdpc2.txd"); AddCharModel(305, 20002, "lapdpd2.dff", "lapdpd2.txd"); return 1; }
Warning | 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. |
[edit]
Related Functions
The following functions may be useful, as they are related to this function in one way or another.
- SetPlayerSkin: Set a player's skin.