OnNpcNameChange

From Wiki G1R-MP G1 Remake Multiplayer
Revision as of 11:32, 15 August 2026 by QCherry (talk | contribs) (Document NPC naming event)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

onNpcNameChange

Triggered after a resource changes a scripted NPC's validated display name.

Availability

This event is available in server-side scripts.

Callback signature

onNpcNameChange(npcId, previousName, newName, sourceResource)

Parameters

Name Type Description
npcId int The affected NPC identifier.
previousName string The previous validated display name.
newName string The new validated display name.
sourceResource string The resource that requested the change.

Examples

Handle the event:

addEventHandler("onNpcNameChange", root, function(npcId, previousName, newName, sourceResource)
    outputDebugString("NPC " .. npcId .. ": " .. previousName .. " -> " .. newName)
end)

Notes

  • The updated name is replicated to current viewers and replayed during relevance entry and late join.