https://g1r-mp.com/wiki/index.php?action=history&feed=atom&title=OnNpcAppearanceChange
OnNpcAppearanceChange - Revision history
2026-09-19T07:27:02Z
Revision history for this page on the wiki
MediaWiki 1.46.0
https://g1r-mp.com/wiki/index.php?title=OnNpcAppearanceChange&diff=366&oldid=prev
QCherry: Update Lua event reference
2026-08-15T09:49:12Z
<p>Update Lua event reference</p>
<p><b>New page</b></p><div><!-- This page is generated from the verified Lua event definition: onNpcAppearanceChange. --><br />
= onNpcAppearanceChange =<br />
Triggered after a scripted NPC's skin or armor changes.<br />
<br />
== Availability ==<br />
This event is available in '''server-side''' scripts.<br />
<br />
== Callback signature ==<br />
<syntaxhighlight lang="lua"><br />
onNpcAppearanceChange(npcId, field, previousValue, newValue, sourceResource)<br />
</syntaxhighlight><br />
<br />
== Parameters ==<br />
{| class="wikitable"<br />
! Name !! Type !! Description<br />
|-<br />
| <code>npcId</code> || <code>int</code> || The affected NPC identifier.<br />
|-<br />
| <code>field</code> || <code>string</code> || Either skin or armor.<br />
|-<br />
| <code>previousValue</code> || <code>string</code> || The previous stable catalog key.<br />
|-<br />
| <code>newValue</code> || <code>string</code> || The new stable catalog key.<br />
|-<br />
| <code>sourceResource</code> || <code>string</code> || The resource that requested the change.<br />
|}<br />
<br />
== Examples ==<br />
Handle the event:<br />
<syntaxhighlight lang="lua" line><br />
addEventHandler("onNpcAppearanceChange", root, function(npcId, field, previousValue, newValue, sourceResource)<br />
outputDebugString("NPC " .. npcId .. " " .. field .. ": " .. previousValue .. " -> " .. newValue)<br />
end)<br />
</syntaxhighlight><br />
<br />
== Notes ==<br />
* This is an observation event; the authoritative state has already changed.<br />
<br />
[[Category:Lua Events]]<br />
[[Category:Server Events]]<br />
[[Category:NPC Events]]</div>
QCherry