Lua接口/服务端/LuaFnChangeVisual
来自天龙知识库
按物品外观表替换装备外观。
Lua 调用
LuaFnChangeVisual(sceneId, selfId, equipBagIndex, materialBagIndex, visualIndex)
参数
| 序号 | 参数 / 类型 | 说明 |
|---|---|---|
| 1 | sceneIdnumber
|
当前调用所在的场景 ID。 |
| 2 | selfIdnumber
|
当前场景内的对象 ID。玩家接口需传入有效玩家对象；不是角色 GUID。 |
| 3 | equipBagIndexnumber
|
待改变外观的装备背包格，须为有效且未加交易锁/密码锁的装备。 |
| 4 | materialBagIndexnumber
|
材料背包格。本接口仅检查存在、非空及未加锁，不检查材料模板、不扣除材料；应由调用业务完成材料规则。 |
| 5 | visualIndexnumber
|
候选位置序号 0..9，对应 EquipVisual.txt 第 2..11 列；不是外观资源号或本表第一列。 |
返回值
返回一个 number：0 外观写入并发送同步；-1 参数范围、模板/外观列表缺失、写入或通用失败；-2 装备无效或被锁定；-3 材料格无效或被锁定；-4 与现有外观相同；-5 所选列为 -1。
注意事项
- 调用对象必须是当前场景中的有效玩家。
- 按装备基础模板的 Visual 字段查 EquipVisual.txt。选择值大于 1000 时反复减 1000，1000 本身保留；0 和除 -1 外的负数没有同样的禁用检查，不要用这些值创建候选。
- 本接口不按末列 Item_ID 核对材料，不扣钱、不删除材料格。现有脚本 809264 才固定检查变形符 30900004，并在本函数返回 0 后扣款和删除材料格。不要把它直接当作完整收费操作。
- 成功为数值 0，必须显式比较。变更、扣款与材料删除不能整体回滚，异常时不可自动重试。
核对依据：
LuaFnTbl_Ability.h 第 4109 行，服务端注册表第 1126 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。