ResetPlayerSkinColor
resetPlayerSkinColor
AVAILABLE FROM UPDATE 0.1.3
This function is available in G1R:MP 0.1.3 and later. The contract below includes the compatibility guarantees introduced in that update.
Disables the player's skin-color override and restores native material defaults without resetting tattoos.
Syntax
bool resetPlayerSkinColor(int playerId)
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
playerId |
int |
yes | The connected player identifier. |
Returns
Returns true when the server accepts the reset; returns false when the player is unavailable or the change is rejected.
Examples
Restore native skin color while retaining the tattoo override:
-- The resource must authorize this change first.
resetPlayerSkinColor(playerId)
Notes
- Available only in server-side resource scripts.
- Alias:
ResetPlayerSkinColor. - Cosmetic state only: this does not change identity, equipped armor, inventory, HP or other progression statistics.
- This disables the override instead of setting RGB to white. After a successful reset,
getPlayerSkinColorreturnsfalse. - The tattoo override remains enabled or disabled exactly as before. Native defaults depend on the current appearance and material; reset does not select another identity.
- The server owns the reliable state and replays it on late join and relevance entry; the native client reapplies it after supported visual rebuilds. Acceptance is not confirmation that a client has already rendered the change.
- Resources must implement their own authorization before allowing a player request to call a setter. There is no client mutation packet or arbitrary texture upload API.
- See Player customization and Player tattoo catalog.