Lua接口/服务端/LuaFnChangeVisual

首页 · 服务端接口 · 生活技能与装备 · 调用约定

按物品外观表替换装备外观。

Lua 调用

LuaFnChangeVisual(sceneId, selfId, equipBagIndex, materialBagIndex, visualIndex)

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

实现位于 LuaFnTbl_Ability.h。

参数

序号	参数 / 类型	说明
1	sceneId number	当前调用所在的场景 ID。 脚本中的实参：sceneId
2	selfId number	当前场景内的对象 ID。玩家接口需传入有效玩家对象；不是角色 GUID。 脚本中的实参：selfId
3	equipBagIndex number	待改变外观的装备背包格，须为有效且未加交易锁/密码锁的装备。 脚本中的实参：nItemIndex1
4	materialBagIndex number	材料背包格。本接口仅检查存在、非空及未加锁，不检查材料模板、不扣除材料；应由调用业务完成材料规则。 脚本中的实参：nItemIndex2
5	visualIndex number	候选位置序号 0..9，对应 EquipVisual.txt 第 2..11 列；不是外观资源号或本表第一列。 脚本中的实参：nVisualIndex

返回值

返回一个 number：0 外观写入并发送同步；-1 参数范围、模板/外观列表缺失、写入或通用失败；-2 装备无效或被锁定；-3 材料格无效或被锁定；-4 与现有外观相同；-5 所选列为 -1。

脚本中的调用

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

-- event/equip/equip_changevisual.lua
LuaFnChangeVisual(sceneId, selfId, nItemIndex1, nItemIndex2, nVisualIndex)

注意事项

• 调用对象必须是当前场景中的有效玩家。
• 按装备基础模板的 Visual 字段查 EquipVisual.txt。选择值大于 1000 时反复减 1000，1000 本身保留；0 和除 -1 外的负数没有同样的禁用检查，不要用这些值创建候选。
• 本接口不按末列 Item_ID 核对材料，不扣钱、不删除材料格。现有脚本 809264 才固定检查变形符 30900004，并在本函数返回 0 后扣款和删除材料格。不要把它直接当作完整收费操作。
• 成功为数值 0，必须显式比较。变更、扣款与材料删除不能整体回滚，异常时不可自动重试。