QCherry: Document skin color and tattoos available from 0.1.3; identity/armor improvements

2026-09-09T02:32:35Z

Document skin color and tattoos available from 0.1.3; identity/armor improvements

New page

{{DISPLAYTITLE:Player tattoo catalog}}
<div style="background:#fff5f5; border:1px solid #d13b3b; border-left:5px solid #d13b3b; color:#111; padding:0.85rem 1rem; margin:0.75rem 0 1rem;">
'''AVAILABLE FROM UPDATE 0.1.3'''

These tattoo presets are available through [[setPlayerTattoo]] in G1R:MP 0.1.3 and later.
</div>

Use [[getPlayerTattooNames]]() for the keys supported by the running server. The current catalog contains '''12 keys''': 11 tattoo presets and the explicit removal key <code>none</code>. This is separate from the older [[Player skin catalog]].

== Presets and authored regions ==
The following regions have verified tattoo mask assets. A dash means that the preset has no authored tattoo mask for that region; it does not borrow a different preset's texture. Armor may cover an otherwise supported region.

{| class="wikitable sortable"
! Key !! Head !! Torso !! Legs !! Meaning
|-
| <code>none</code> || — || — || — || Explicitly remove tattoos.
|-
| <code>novice1</code> || — || Yes || Yes || Novice 1.
|-
| <code>novice2</code> || Yes || Yes || — || Novice 2.
|-
| <code>novice3</code> || Yes || Yes || — || Novice 3.
|-
| <code>novice4</code> || Yes || Yes || — || Novice 4.
|-
| <code>lester</code> || Yes || Yes || — || Lester.
|-
| <code>templar1</code> || Yes || Yes || — || Templar 1.
|-
| <code>templar2</code> || Yes || Yes || — || Templar 2.
|-
| <code>templar3</code> || Yes || Yes || — || Templar 3.
|-
| <code>guru</code> || Yes || Yes || — || Guru.
|-
| <code>yberion</code> || Yes || — || — || Y'Berion.
|-
| <code>corkalom</code> || Yes || — || — || Cor Kalom.
|}

== Usage ==
<syntaxhighlight lang="lua">
for _, key in ipairs(getPlayerTattooNames()) do
outputDebugString(key)
end

-- Use a validated playerId in an authorized server handler:
setPlayerTattoo(playerId, "lester")
setPlayerTattoo(playerId, "none") -- explicit removal
resetPlayerTattoo(playerId) -- restore native defaults instead
</syntaxhighlight>

Keys are case-insensitive; getters return lowercase. Unknown keys, extra whitespace and arbitrary texture paths are not accepted. <code>reset</code> is a bundled chat-command argument, '''not''' a tattoo catalog key. Use [[resetPlayerTattoo]] in Lua.

After explicit <code>none</code>, [[getPlayerTattoo]] returns <code>"none"</code>. After reset, it returns <code>false</code>; native defaults may still include tattoos. Both operations preserve identity, armor, skin-color override and statistics.

See [[Player customization]] for the seven functions, aliases, RGB controls, synchronization, persistence and GothicRP commands.

[[Category:Lua Data Types]]
[[Category:Appearance Functions]]

Player tattoo catalog - Revision history

QCherry: Document skin color and tattoos available from 0.1.3; identity/armor improvements