SetPlayerDirt

Sets a player’s dirt - on their skin, their clothes or one piece.

In the player’s game, through the game’s own setter; their game then shows it to everyone and reports it back (the readers show it within a second). 0 is clean, 1 as dirty as the game gets, in steps of 1/255. A piece put on within ten seconds takes it too.

Syntax

SetPlayerDirt(pid, value [, part])

Parameter	Type
pid	number	the player
value	number	0 .. 1
part	string	"all" (the default: the skin and every piece worn), "skin", "clothes", or an item’s class GUID or name (the worn pieces of it) (optional)

Returns

boolean | false, string - true when the change went to the player’s game; false and why: "not connected", "not in the world", "unknown part", "not a number", "their game cannot"

Example

-- a day's work in the fields leaves its mark
SetPlayerDirt(pid, 0.7, "clothes")
SetPlayerDirt(pid, 0.4, "skin")

See also

SetPlayerBlood · WashPlayer · GetPlayerDirt · the Dirt and blood group of the index