Lua接口/服务端/LuaFnUnlockAndChangeExterior

首页 · 服务端接口 · 外观与时装 · 调用约定

解锁并更换外观（类型 + 编号 + 确认）。

Lua 调用

LuaFnUnlockAndChangeExterior(sceneId, selfId, kind, id, confirm)

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

实现位于 LuaFnTbl_Exterior.h。

参数

序号	参数 / 类型	说明
1	sceneId number	当前调用所在的场景 ID。 脚本中的实参：sceneId（3 处）
2	selfId number	当前场景内的对象 ID；必须是本场景线程中的有效玩家，不是角色 GUID。 脚本中的实参：selfId（3 处）
3	kind number	外观类型，取值 0–2。 脚本中的实参：0、1、2
4	id number	外观编号。 脚本中的实参：exteriorId（3 处）
5	confirm number	确认标志，取值 0 或 1。 脚本中的实参：yuanbaoPay（3 处）

返回值

无返回值，结果通过服务端下发。

脚本中的调用

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

-- event/xunhuan/changefacestyle.lua
LuaFnUnlockAndChangeExterior(sceneId, selfId, 0, exteriorId, yuanbaoPay)

-- event/xunhuan/changehairstyle.lua
LuaFnUnlockAndChangeExterior(sceneId, selfId, 1, exteriorId, yuanbaoPay)

-- event/xunhuan/changeheadstyle.lua
LuaFnUnlockAndChangeExterior(sceneId, selfId, 2, exteriorId, yuanbaoPay)

注意事项

• 实现体要求实参恰好 5 个（含 sceneId、selfId），多传或少传都直接返回失败值。
• 必须在外观 NPC 会话有效时调用。
• 网络请求走带版本号的 CGExteriorRequest 路径；脚本接口保留旧签名。