Lua接口/服务端/SetCharacterName

首页 · 服务端接口 · 怪物与掉落 · 调用约定

设置角色名称，固定返回 -1。

Lua 调用

SetCharacterName(sceneId, selfId, name)

服务端脚本中共出现 83 处调用，实参个数出现过：3 个（83 处）。

实现位于 LuaFnTbl_Monster.h 第 1440 行，注册表第 1226 行。

参数

序号	参数 / 类型	说明
1	sceneId number	当前调用所在的场景 ID。 脚本中的实参：sceneId（83 处）
2	selfId number	当前场景内的对象 ID。玩家接口需传入有效玩家对象；不是角色 GUID。 脚本中的实参：nNpcId（20 处）、nNpc1（18 处）、monsterID（13 处）
3	name string	名称字符串。 脚本中的实参："江湖侠士"（11 处）、strName（4 处）、"萧峰"（3 处）

返回值

返回 1 个值。返回类型包括 number。明确的固定返回组合包括 -1。

脚本中的调用

以下是服务端脚本里的真实调用点，按实参形态去重后列出 8 条。这些调用取自随包发布的脚本，可用于确认参数顺序与实际传入的值；它们不代表该写法在当前版本仍然有效。

-- event/caoyun/ecaoyun.lua
SetCharacterName(sceneId, MonsterId, str)

-- event/city/ecity_0202convoypet.lua
SetCharacterName(sceneId, monsterId, x600009_g_StrList[girlFamilyNameIndex] .. x60000)

-- event/city/ecity_0602military.lua
SetCharacterName(sceneId, nMonsterId, x600032_g_StrList[nXing] .. x600032_g_StrList[nM)

-- event/city/ecity_0604military.lua
SetCharacterName(sceneId, nMonsterId, x600034_g_StrList[nXing] .. x600034_g_StrList[nM)

-- event/city/ecity_0703killruffian.lua
SetCharacterName(sceneId, monsterId, x600039_g_StrList[BossIndex])

-- event/city/ecity_0802findcompound.lua
SetCharacterName(sceneId, monsterId, BossName)

-- event/fuben/efuben_cuju.lua
SetCharacterName(sceneId, nMiddleMonster, "满天星")

-- event/fuben/efuben_cuju.lua
SetCharacterName(sceneId, nNpc1, szName)