GetPlayerHeadNames: Difference between revisions

From Wiki G1R-MP G1 Remake Multiplayer
Jump to navigation Jump to search
Document player skin, body and head appearance API
 
Document Protocol 23 voice and player presentation APIs
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
<!-- This page is generated automatically from the function definition: getPlayerHeadNames. -->
<!-- This page is generated automatically from the function definition: getPlayerHeadNames. -->
= getPlayerHeadNames =
= getPlayerHeadNames =
Returns every independently selectable Nameless Hero head option.
Deprecated compatibility API that returns every validated legacy head-layer option.


== Syntax ==
== Syntax ==
Line 12: Line 12:


== Returns ==
== Returns ==
Returns <code>default</code>, <code>head_01</code> and <code>head_02</code> in a one-based array.
Returns a one-based array containing native Mutable options and named character identity layers. The first entry is <code>default</code>.


== Examples ==
== Examples ==
Line 24: Line 24:
== Notes ==
== Notes ==
* Available only in server-side resource scripts.
* Available only in server-side resource scripts.
* The G1R <code>MO_Player</code> Mutable exposes only <code>Head_01</code> and <code>Head_02</code> as independent head choices.
* Deprecated: use <code>getPlayerIdentityNames</code> for complete character identities.
* These choices are compatible only with the <code>default</code> body.
* The <code>head_01</code> and <code>head_02</code> entries use native Mutable geometry.
* Named entries copy compatible face, eye and skin materials to the Mutable character and render only validated hair or beard sections on the common human skeleton.
* No named entry includes the source character's armor.
* See [[Player head catalog]] for the complete list.


[[Category:Lua Functions]]
[[Category:Lua Functions]]
Line 31: Line 34:
[[Category:Player Functions]]
[[Category:Player Functions]]
[[Category:Appearance Functions]]
[[Category:Appearance Functions]]
[[Category:Deprecated Lua API]]

Latest revision as of 06:12, 24 August 2026

getPlayerHeadNames

Deprecated compatibility API that returns every validated legacy head-layer option.

Syntax

table getPlayerHeadNames()

Parameters

This function does not accept parameters.

Returns

Returns a one-based array containing native Mutable options and named character identity layers. The first entry is default.

Examples

List the available independent heads:

for _, headKey in ipairs(getPlayerHeadNames()) do
    outputDebugString(headKey)
end

Notes

  • Available only in server-side resource scripts.
  • Deprecated: use getPlayerIdentityNames for complete character identities.
  • The head_01 and head_02 entries use native Mutable geometry.
  • Named entries copy compatible face, eye and skin materials to the Mutable character and render only validated hair or beard sections on the common human skeleton.
  • No named entry includes the source character's armor.
  • See Player head catalog for the complete list.