QCherry: Document Protocol 23 voice and player presentation APIs

2026-08-24T06:15:00Z

Document Protocol 23 voice and player presentation APIs

← Older revision		Revision as of 06:15, 24 August 2026
Line 33:		Line 33:

	== Notes ==		== Notes ==
	* ~~Independent~~ head ~~options are available only~~ with ~~the default editable player~~ body.		* The selected head is composed with any validated body identity and authoritative armor.
	* The corresponding reliable visual state is replayed during relevance entry and late join.		* The corresponding reliable visual state is replayed during relevance entry and late join.

QCherry: Document player appearance change events

2026-08-15T18:58:31Z

Document player appearance change events

New page

= onPlayerHeadChange =
Triggered after a validated independent Nameless Hero head option has changed.

== Availability ==
This event is available in '''server-side''' scripts.

== Callback signature ==
<syntaxhighlight lang="lua">
onPlayerHeadChange(playerId, previousHead, newHead, sourceResource)
</syntaxhighlight>

== Parameters ==
{| class="wikitable"
! Name !! Type !! Description
|-
| <code>playerId</code> || <code>int</code> || The affected connected player ID.
|-
| <code>previousHead</code> || <code>string</code> || The previous stable head key.
|-
| <code>newHead</code> || <code>string</code> || The new stable head key.
|-
| <code>sourceResource</code> || <code>string</code> || The resource that requested the change.
|}

== Examples ==
Handle the event:
<syntaxhighlight lang="lua" line>
addEventHandler("onPlayerHeadChange", root, function(playerId, previousHead, newHead, sourceResource)
outputDebugString(getPlayerName(playerId) .. " head: " .. previousHead .. " -> " .. newHead)
end)
</syntaxhighlight>

== Notes ==
* Independent head options are available only with the default editable player body.
* The corresponding reliable visual state is replayed during relevance entry and late join.

[[Category:Lua Events]]
[[Category:Server Events]]
[[Category:Player Events]]

OnPlayerHeadChange - Revision history

QCherry: Document Protocol 23 voice and player presentation APIs

QCherry: Document player appearance change events