ResetPlayerTattoo

resetPlayerTattoo

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 tattoo override and restores native tattoo defaults while preserving the skin-color override.

Syntax

bool resetPlayerTattoo(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 tattoos without clearing a skin tint:

-- The resource must authorize this change first.
resetPlayerTattoo(playerId)

Notes

• Available only in server-side resource scripts.
• Alias: ResetPlayerTattoo.
• Cosmetic state only: this does not change identity, equipped armor, inventory, HP or other progression statistics.
• Native defaults may already contain tattoos. This differs from setPlayerTattoo(playerId, "none"), which explicitly removes them.
• After a successful reset, getPlayerTattoo returns false; after explicit removal it returns "none". The RGB skin-color override is unchanged.
• 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.