GetPlayerSkinNames: Difference between revisions

From Wiki G1R-MP G1 Remake Multiplayer
Jump to navigation Jump to search
Update Lua API reference
 
Document Protocol 23 voice and player presentation APIs
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
<!-- This page is generated automatically from the function definition: getPlayerSkinNames. -->
<!-- This page is generated automatically from the function definition: getPlayerSkinNames. -->
= getPlayerSkinNames =
= getPlayerSkinNames =
Returns every validated player appearance preset exposed by the server.
Returns every validated legacy skin-surface preset exposed by the server.


== Syntax ==
== Syntax ==
Line 24: Line 24:
== Notes ==
== Notes ==
* Available only in server-side resource scripts.
* Available only in server-side resource scripts.
* A skin is an atomic, catalog-backed CharacterDefinition preset containing the compatible body and face setup.
* For players this compatibility channel supplies Mutable visual features such as skin, tattoos and scars; it is not the recommended character identity selector.
* Armor is an independent equipment layer and is controlled with <code>setPlayerArmor</code>.
* Use <code>setPlayerIdentity</code> to select a complete recognizable character appearance while keeping armor independent.
* Armor is authoritative equipment state controlled with <code>setPlayerArmor</code> and is never selected by this function.
* See [[Player skin catalog]] for every currently supported key.
* See [[Player skin catalog]] for every currently supported key.


[[Category:Lua Functions]]
[[Category:Server Functions]]
[[Category:Server Functions]]
[[Category:Player Functions]]
[[Category:Player Functions]]
[[Category:Appearance Functions]]
[[Category:Appearance Functions]]

Latest revision as of 06:12, 24 August 2026

getPlayerSkinNames

Returns every validated legacy skin-surface preset exposed by the server.

Syntax

table getPlayerSkinNames()

Parameters

This function does not accept parameters.

Returns

Returns a one-based array of stable skin keys. The first entry is default.

Examples

List the available appearance presets:

for _, skinKey in ipairs(getPlayerSkinNames()) do
    outputDebugString(skinKey)
end

Notes

  • Available only in server-side resource scripts.
  • For players this compatibility channel supplies Mutable visual features such as skin, tattoos and scars; it is not the recommended character identity selector.
  • Use setPlayerIdentity to select a complete recognizable character appearance while keeping armor independent.
  • Armor is authoritative equipment state controlled with setPlayerArmor and is never selected by this function.
  • See Player skin catalog for every currently supported key.