QCherry: Document Protocol 23 voice and player presentation APIs

2026-08-24T06:14:55Z

Document Protocol 23 voice and player presentation APIs

← Older revision		Revision as of 06:14, 24 August 2026
Line 1:		Line 1:
	<!-- This page is generated from the verified Lua event definition: onPlayerBodyChange. -->		<!-- This page is generated from the verified Lua event definition: onPlayerBodyChange. -->
	= onPlayerBodyChange =		= onPlayerBodyChange =
	Triggered after ~~a validated~~ authoritative ~~full-~~body ~~identity preset~~ has changed.		Triggered after the legacy authoritative body/face profile has changed.

	== Availability ==		== Availability ==
Line 33:		Line 33:

	== Notes ==		== Notes ==
	* ~~Named body presets are complete prebaked G1R body-and-head meshes~~.		* This compatibility event mirrors <code>onPlayerFaceChange</code>.
	* 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:30Z

Document player appearance change events

New page

= onPlayerBodyChange =
Triggered after a validated authoritative full-body identity preset has changed.

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

== Callback signature ==
<syntaxhighlight lang="lua">
onPlayerBodyChange(playerId, previousBody, newBody, sourceResource)
</syntaxhighlight>

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

== Examples ==
Handle the event:
<syntaxhighlight lang="lua" line>
addEventHandler("onPlayerBodyChange", root, function(playerId, previousBody, newBody, sourceResource)
outputDebugString(getPlayerName(playerId) .. " body: " .. previousBody .. " -> " .. newBody)
end)
</syntaxhighlight>

== Notes ==
* Named body presets are complete prebaked G1R body-and-head meshes.
* The corresponding reliable visual state is replayed during relevance entry and late join.

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

OnPlayerBodyChange - Revision history

QCherry: Document Protocol 23 voice and player presentation APIs

QCherry: Document player appearance change events