GetNpcSkinColor

From Wiki G1R-MP G1 Remake Multiplayer
Jump to navigation Jump to search

getNpcSkinColor

AVAILABLE FROM UPDATE 0.1.5
This function is available in G1R:MP 0.1.5 and later. The contract below includes the compatibility guarantees introduced in that update.

Reads the NPC skin-color override.

Syntax

getNpcSkinColor(npcId)

Parameters

Name Type Required Description
npcId int yes NPC ID returned by spawnNpc; not a player ID.

Returns

Table {r, g, b} with integer channels, or false when disabled/unavailable.

Examples

local color = getNpcSkinColor(npcId)
if color then outputDebugString(tostring(color.r)) end

Notes

  • Server-side only. Mutations require the resource that owns this NPC; getters do not grant control.
  • Available from update 0.1.5. See NPC scripting#NPC appearance since 0.1.5.
  • The authoritative state is replayed for relevance entry/late join. Rendering is asynchronous; acceptance does not mean the mesh has finished rebuilding.
  • Does not change authoritative HP, weapons, armor, routes or combat configuration. No automatic persistent database storage.
  • Upper-initial alias GetNpcSkinColor is also supported.
  • This does not sample the rendered material or return the inherited identity color.