Lua接口/服务端函数索引/外观与时装

来自天龙知识库
Waylee​(留言 | 贡献)2026年10月24日 (六) 12:29的版本 (维护服务端 Lua 接口:核对参数、返回值、边界条件与调用示例)
(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)
跳到导航跳到搜索

首页 · 服务端接口 · 调用约定

外观与时装:20 个接口,20 个调用名称,其中 14 个在当前脚本中有调用。
函数 / 别名 调用与用途
LuaFnActiveExterior LuaFnActiveExterior(sceneId, selfId, kind, id, hours)
按类型、编号与时长发放(激活)外观。
脚本中未见调用
LuaFnActiveExteriorWeapon LuaFnActiveExteriorWeapon(sceneId, selfId, bag, item, token)
用背包中的道具激活幻饰武器。
脚本中 1 处调用
LuaFnExteriorChangeHairColorByIndex LuaFnExteriorChangeHairColorByIndex(sceneId, selfId, index)
按配色索引切换发色(需要发色 NPC 会话)。
脚本中 1 处调用
LuaFnExteriorNpcContext LuaFnExteriorNpcContext(sceneId, selfId, npc, kind)
建立外观业务 NPC 会话,记录 NPC 与业务类型。
脚本中 5 处调用
LuaFnExteriorSaveHairColor LuaFnExteriorSaveHairColor(sceneId, selfId, color, confirm, replace)
保存发色:写入颜色值,可选替换已有配色槽。
脚本中 1 处调用
LuaFnExteriorUseRideEquip LuaFnExteriorUseRideEquip(sceneId, selfId, bag, item, token)
用背包中的坐骑道具激活坐骑外观,成功标记与失败文案一起返回。
脚本中 1 处调用
LuaFnExteriorWeaponLevelUp LuaFnExteriorWeaponLevelUp(sceneId, selfId, id)
升级幻饰武器(需要有效的外观 NPC 会话)。
脚本中 1 处调用
LuaFnGetEquipedItemTableIndex LuaFnGetEquipedItemTableIndex(sceneId, selfId, slot)
读取指定装备位上装备的物品表编号。
脚本中 1 处调用
LuaFnGetExteriorRideInfoByExteriorID LuaFnGetExteriorRideInfoByExteriorID(exteriorId)
按外观编号读取坐骑外观的名称与回收道具编号。
脚本中 1 处调用
LuaFnGetExteriorWeaponInfo LuaFnGetExteriorWeaponInfo(weaponId)
按编号读取幻饰武器的编号与名称。
脚本中 1 处调用
LuaFnGetExteriorWeaponLeftTime LuaFnGetExteriorWeaponLeftTime(sceneId, selfId, id)
读取指定幻饰武器的剩余时长。
脚本中未见调用
LuaFnGetExteriorWeaponLevelData LuaFnGetExteriorWeaponLevelData(sceneId, selfId, id)
读取幻饰武器的当前等级与下一级升级消耗。
脚本中 1 处调用
LuaFnGetItemName LuaFnGetItemName(itemTableIndex)
按物品表编号读取物品名称(单参数,没有场景上下文)。
脚本中 1 处调用
LuaFnGetNumberingFashionCode LuaFnGetNumberingFashionCode(itemTableIndex)
把编号时装的物品表编号换算成 1–300 的时装编号。
脚本中未见调用
LuaFnGrantExteriorWeapon LuaFnGrantExteriorWeapon(sceneId, selfId, id, hours)
直接发放限时幻饰武器(服务端接口)。
脚本中未见调用
LuaFnIsHaveExteriorWeapon LuaFnIsHaveExteriorWeapon(sceneId, selfId, id)
判断玩家是否持有指定幻饰武器。
脚本中未见调用
LuaFnPrepareExteriorWeaponActivation LuaFnPrepareExteriorWeaponActivation(sceneId, selfId)
准备幻饰武器激活:读取本次消耗的物品快照并计算 7 项结果。
脚本中 1 处调用
LuaFnReverseExteriorRide LuaFnReverseExteriorRide(sceneId, selfId, id)
回收(卸下)指定坐骑外观。
脚本中 1 处调用
LuaFnUnlockAndChangeExterior LuaFnUnlockAndChangeExterior(sceneId, selfId, kind, id, confirm)
解锁并更换外观(类型 + 编号 + 确认)。
脚本中 3 处调用
LuaFnUpdateExteriorToClient LuaFnUpdateExteriorToClient(sceneId, selfId)
把玩家当前的外观状态重新下发给客户端。
脚本中未见调用