Player skin catalog - Revision history

QCherry: Update G1R:MP 0.1.2 API documentation

2026-09-03T18:42:07Z

Update G1R:MP 0.1.2 API documentation

← Older revision		Revision as of 18:42, 3 September 2026
Line 1:		Line 1:
	{{DISPLAYTITLE:Player skin catalog}}		{{DISPLAYTITLE:Player skin catalog}}
	The '''player skin catalog''' lists every stable legacy visual preset accepted by [[setPlayerSkin]] and [[setNpcSkin]]. For players this compatibility channel supplies Mutable skin-surface features such as tattoos and scars; ~~full~~-~~body identity and independent heads~~ use [[~~setPlayerBody]] and [[setPlayerHead~~]]. NPCs continue to use the catalog as their validated model preset. Raw Unreal object paths are not accepted from Lua.		The '''player skin catalog''' lists every stable legacy visual preset accepted by [[setPlayerSkin]] and [[setNpcSkin]]. For players this compatibility channel supplies Mutable skin-surface features such as tattoos and scars; complete armor-free character identities use [[setPlayerIdentity]]. NPCs continue to use the catalog as their validated model preset. Raw Unreal object paths are not accepted from Lua.

	== Usage ==		== Usage ==
Line 11:		Line 11:
	</syntaxhighlight>		</syntaxhighlight>

	The skin state is authoritative and is replayed during relevance entry and late join. ~~A named body preset takes visual precedence over independent head and~~ armor ~~appearance until the body returns to <code>default</code>~~.		The skin state is authoritative and is replayed during relevance entry and late join. It does not select or replace authoritative armor.

	== Available skins ==		== Available skins ==

QCherry: Clarify player appearance catalog behavior

2026-08-15T21:44:24Z

Clarify player appearance catalog behavior

← Older revision		Revision as of 21:44, 15 August 2026
Line 11:		Line 11:
	</syntaxhighlight>		</syntaxhighlight>

	The skin state is authoritative and is replayed during relevance entry and late join. A named ~~full-~~body ~~player~~ preset takes visual precedence until the body returns to <code>default</code>~~. Armor remains an independent equipment layer controlled with [[setPlayerArmor]]~~.		The skin state is authoritative and is replayed during relevance entry and late join. A named body preset takes visual precedence over independent head and armor appearance until the body returns to <code>default</code>.

	== Available skins ==		== Available skins ==

QCherry: Clarify player skin surface presets

2026-08-15T18:58:35Z

Clarify player skin surface presets

← Older revision		Revision as of 18:58, 15 August 2026
Line 1:		Line 1:
	{{DISPLAYTITLE:Player skin catalog}}		{{DISPLAYTITLE:Player skin catalog}}
	The '''player skin catalog''' lists every stable ~~body-and-face appearance key~~ accepted by [[setPlayerSkin]] and [[setNpcSkin]]. ~~Keys are validated by the server~~ and ~~map~~ to ~~compatible G1R <code>CharacterDefinition</code> presets~~. Raw Unreal object paths are not accepted from Lua.		The '''player skin catalog''' lists every stable legacy visual preset accepted by [[setPlayerSkin]] and [[setNpcSkin]]. For players this compatibility channel supplies Mutable skin-surface features such as tattoos and scars; full-body identity and independent heads use [[setPlayerBody]] and [[setPlayerHead]]. NPCs continue to use the catalog as their validated model preset. Raw Unreal object paths are not accepted from Lua.

	== Usage ==		== Usage ==
Line 8:		Line 8:
	end		end

	setPlayerSkin(playerId, "~~milten~~")		setPlayerSkin(playerId, "cor_kalom")
	</syntaxhighlight>		</syntaxhighlight>

	The ~~appearance~~ state is authoritative and is replayed during relevance entry and late join. Armor remains an independent equipment layer controlled with [[setPlayerArmor]].		The skin state is authoritative and is replayed during relevance entry and late join. A named full-body player preset takes visual precedence until the body returns to <code>default</code>. Armor remains an independent equipment layer controlled with [[setPlayerArmor]].

	== Available skins ==		== Available skins ==

QCherry: Update Lua API navigation and catalogs

2026-08-15T09:49:35Z

Update Lua API navigation and catalogs

New page

{{DISPLAYTITLE:Player skin catalog}}
The '''player skin catalog''' lists every stable body-and-face appearance key accepted by [[setPlayerSkin]] and [[setNpcSkin]]. Keys are validated by the server and map to compatible G1R <code>CharacterDefinition</code> presets. Raw Unreal object paths are not accepted from Lua.

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

setPlayerSkin(playerId, "milten")
</syntaxhighlight>

The appearance state is authoritative and is replayed during relevance entry and late join. Armor remains an independent equipment layer controlled with [[setPlayerArmor]].

== Available skins ==
{| class="wikitable sortable"
! Key !! CharacterDefinition preset
|-
| <code>default</code> || Nameless Hero default CharacterDefinition
|-
| <code>saturas</code> || <code>CharacterDefinition_Human_NC_KDW_Saturas_600</code>
|-
| <code>myxir</code> || <code>CharacterDefinition_Human_NC_KDW_Myxir_601</code>
|-
| <code>merdarion</code> || <code>CharacterDefinition_Human_NC_KDW_Merdarion_602</code>
|-
| <code>nefarius</code> || <code>CharacterDefinition_Human_NC_KDW_Nefarius_603</code>
|-
| <code>cronos</code> || <code>CharacterDefinition_Human_NC_KDW_Cronos_604</code>
|-
| <code>riordian</code> || <code>CharacterDefinition_Human_NC_KDW_Riordian_605</code>
|-
| <code>gomez</code> || <code>CharacterDefinition_Human_OC_EBR_Gomez_100</code>
|-
| <code>scar</code> || <code>CharacterDefinition_Human_OC_EBR_Scar_101</code>
|-
| <code>arto</code> || <code>CharacterDefinition_Human_OC_EBR_Arto_102</code>
|-
| <code>raven</code> || <code>CharacterDefinition_Human_OC_EBR_Raven_105</code>
|-
| <code>bartholo</code> || <code>CharacterDefinition_Human_OC_EBR_Bartholo_106</code>
|-
| <code>thorus</code> || <code>CharacterDefinition_Human_OC_GRD_Thorus_200</code>
|-
| <code>jackal</code> || <code>CharacterDefinition_Human_OC_GRD_Jackal_201</code>
|-
| <code>scorpio</code> || <code>CharacterDefinition_Human_OC_GRD_Scorpio_205</code>
|-
| <code>fletcher</code> || <code>CharacterDefinition_Human_OC_GRD_Fletcher_255</code>
|-
| <code>guard_01</code> || <code>CharacterDefinition_Human_OC_GRD_Guard01_204</code>
|-
| <code>guard_02</code> || <code>CharacterDefinition_Human_OC_GRD_Guard02_206</code>
|-
| <code>guard_03</code> || <code>CharacterDefinition_Human_OC_GRD_Guard03_209</code>
|-
| <code>milten</code> || <code>CharacterDefinition_Human_OC_KDF_Milten</code>
|-
| <code>fisk</code> || <code>CharacterDefinition_Human_OC_STT_Fisk_311</code>
|-
| <code>shadow_11</code> || <code>CharacterDefinition_Human_OC_STT_Shadow11_330</code>
|-
| <code>digger_11</code> || <code>CharacterDefinition_Human_OC_VLK_Digger11_512</code>
|-
| <code>mud</code> || <code>CharacterDefinition_Human_OC_VLK_Mud_574</code>
|-
| <code>bloodwyn</code> || <code>CharacterDefinition_Human_OCR_GRD_Bloodwyn_233</code>
|-
| <code>bullit</code> || <code>CharacterDefinition_Human_OCR_GRD_Bullit_203</code>
|-
| <code>stone</code> || <code>CharacterDefinition_Human_OCR_GRD_Stone_219</code>
|-
| <code>yberion</code> || <code>CharacterDefinition_Human_SC_GUR_YBerion_1200</code>
|-
| <code>cor_kalom</code> || <code>CharacterDefinition_Human_SC_GUR_CorKalom_1201</code>
|-
| <code>lester</code> || <code>CharacterDefinition_Human_SC_NOV_Lester</code>
|-
| <code>templar_24</code> || <code>CharacterDefinition_Human_SC_TPL_Templar24_1441</code>
|-
| <code>mercenary_09</code> || <code>CharacterDefinition_Human_NC_SLD_Mercenary09_723</code>
|-
| <code>xardas</code> || <code>CharacterDefinition_Human_XT_DMB_Xardas_404_Sleeper</code>
|}

== Related functions ==
* [[getPlayerSkinNames]]
* [[getPlayerSkin]]
* [[setPlayerSkin]]
* [[setNpcSkin]]
* [[setPlayerArmor]]

[[Category:Lua API]]
[[Category:Lua Catalogs]]
[[Category:Appearance Functions]]