GetPlayerIdentityNames - Revision history

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

2026-09-09T02:32:32Z

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

← Older revision		Revision as of 02:32, 9 September 2026
Line 1:		Line 1:
	= getPlayerIdentityNames =		= getPlayerIdentityNames =
	Returns ~~every complete armor-free character~~ identity ~~supported~~ by ~~the server~~.		<div style="background:#fff5f5; border:1px solid #d13b3b; border-left:5px solid #d13b3b; color:#111111; padding:0.85rem 1rem; margin:0.75rem 0 1rem;">
			<div style="color:#111111; font-weight:bold; letter-spacing:0.04em;">IMPROVED FROM UPDATE 0.1.3</div>
			<div style="color:#111111; margin-top:0.25rem;">This function is available in earlier releases and has corrected or expanded behavior in G1R:MP 0.1.3 and later. The contract below describes the updated behavior.</div>
			</div>

			Returns the supported head/face identity keys accepted by setPlayerIdentity.

	== Syntax ==		== Syntax ==
Line 14:		Line 19:

	== Examples ==		== Examples ==
	List ~~all complete character~~ identities:		List the supported named head/face identities:
	<syntaxhighlight lang="lua" line>		<syntaxhighlight lang="lua" line>
	for _, identityKey in ipairs(getPlayerIdentityNames()) do		for _, identityKey in ipairs(getPlayerIdentityNames()) do
Line 23:		Line 28:
	== Notes ==		== Notes ==
	* Available only in server-side resource scripts.		* Available only in server-side resource scripts.
	* This is ~~the supported catalog for complete character appearance selection~~ in ~~G1R:MP~~ 0.1.		* This existing catalog API is marked improved in 0.1.3, not introduced in that release. It is read-only and requires no player identifier.
	* ~~Each identity combines~~ the ~~matching GTO face profile~~ with ~~validated~~ face ~~materials~~ and hair geometry; selecting it does not ~~equip~~ armor.		* In the updated renderer, <code>setPlayerIdentity</code> selects a head-only layer with the named face presentation and supported hair/beard geometry. The existing game body and equipped armor remain in place; selecting a key does not require equipping that NPC's armor or replacing the full body.
	* ~~Gothic Remake character models~~ and ~~variants are~~ authored ~~together with particular armor sets~~. ~~Armor compatibility therefore varies by identity~~, and ~~some identity/armor combinations do not exist~~ or ~~do not render correctly~~.		* Identity selection preserves the independent skin-color and tattoo overrides. It does not copy the NPC's complete body mesh, texture set, shape or authored body skin tone.
	* Test ~~every identity~~ and ~~armor combination~~ used by a resource.		* The list describes supported server keys, not a promise that every combination of materials, armor and LODs renders identically or instantly. Test the local and remote appearances used by your resource.
	* See [[Player identity catalog]] for the complete list.		* Use <code>getPlayerIdentity</code> to read the current canonical key. See [[Player customization]] and [[Player identity catalog]] for the layer contract and complete list.

	[[Category:Lua Functions]]		[[Category:Lua Functions]]

QCherry: Document 0.1a Lua API, identities, moderation and synchronized spells

2026-08-27T11:36:33Z

Document 0.1a Lua API, identities, moderation and synchronized spells

← Older revision		Revision as of 11:36, 27 August 2026
Line 1:		Line 1:
	~~<!-- This page is generated automatically from the function definition: getPlayerIdentityNames. -->~~
	= getPlayerIdentityNames =		= getPlayerIdentityNames =
	Returns every complete armor-free character identity supported by the server.		Returns every complete armor-free character identity supported by the server.
Line 24:		Line 23:
	== Notes ==		== Notes ==
	* Available only in server-side resource scripts.		* Available only in server-side resource scripts.
	* This is the ~~recommended~~ catalog for ~~ordinary~~ character appearance selection.		* This is the supported catalog for complete character appearance selection in G1R:MP 0.1.
	* Each identity combines the matching GTO face profile with validated face materials and hair geometry~~, but never includes~~ armor.		* Each identity combines the matching GTO face profile with validated face materials and hair geometry; selecting it does not equip armor.
	* ~~Some~~ identity ~~profiles still have compatibility issues with specific~~ armor ~~assets~~. Test every identity and armor combination used by a resource.		* Gothic Remake character models and variants are authored together with particular armor sets. Armor compatibility therefore varies by identity, and some identity/armor combinations do not exist or do not render correctly.
			* Test every identity and armor combination used by a resource.
	* See [[Player identity catalog]] for the complete list.		* See [[Player identity catalog]] for the complete list.

QCherry: Document Protocol 23 voice and player presentation APIs

2026-08-24T06:12:19Z

Document Protocol 23 voice and player presentation APIs

New page

= getPlayerIdentityNames =
Returns every complete armor-free character identity supported by the server.

== Syntax ==
<syntaxhighlight lang="lua">
table getPlayerIdentityNames()
</syntaxhighlight>

== Parameters ==
This function does not accept parameters.

== Returns ==
Returns a one-based array of stable identity keys. The first entry is <code>default</code>.

== Examples ==
List all complete character identities:
<syntaxhighlight lang="lua" line>
for _, identityKey in ipairs(getPlayerIdentityNames()) do
outputDebugString(identityKey)
end
</syntaxhighlight>

== Notes ==
* Available only in server-side resource scripts.
* This is the recommended catalog for ordinary character appearance selection.
* Each identity combines the matching GTO face profile with validated face materials and hair geometry, but never includes armor.
* Some identity profiles still have compatibility issues with specific armor assets. Test every identity and armor combination used by a resource.
* See [[Player identity catalog]] for the complete list.

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