https://www.waylee.net/index.php?action=history&feed=atom&title=Lua%E6%8E%A5%E5%8F%A3%2F%E6%9C%8D%E5%8A%A1%E7%AB%AF%E5%87%BD%E6%95%B0%E7%B4%A2%E5%BC%95%2F%E5%A4%96%E8%A7%82%E4%B8%8E%E6%97%B6%E8%A3%85 Lua接口/服务端函数索引/外观与时装 - 版本历史 2026-10-24T08:16:34Z 本wiki上该页面的版本历史 MediaWiki 1.46.0 https://www.waylee.net/index.php?title=Lua%E6%8E%A5%E5%8F%A3/%E6%9C%8D%E5%8A%A1%E7%AB%AF%E5%87%BD%E6%95%B0%E7%B4%A2%E5%BC%95/%E5%A4%96%E8%A7%82%E4%B8%8E%E6%97%B6%E8%A3%85&diff=13219&oldid=prev Waylee：​维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例 2026-10-24T04:29:59Z <p>维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例</p> <p><b>新页面</b></p><div>__NOTOC__<br /> &lt;div class=&quot;lua-reference&quot;&gt;<br /> [[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端调用约定|调用约定]]<br /> <br /> &lt;div class=&quot;lua-lead&quot;&gt;外观与时装：20 个接口，20 个调用名称，其中 14 个在当前脚本中有调用。&lt;/div&gt;<br /> {| class=&quot;wikitable&quot;<br /> ! scope=&quot;col&quot; class=&quot;lua-w36&quot; | 函数 / 别名<br /> ! scope=&quot;col&quot; | 调用与用途<br /> |-<br /> | [[Lua接口/服务端/LuaFnActiveExterior|LuaFnActiveExterior]]<br /> | &lt;code&gt;LuaFnActiveExterior(sceneId, selfId, kind, id, hours)&lt;/code&gt;&lt;br /&gt;按类型、编号与时长发放（激活）外观。&lt;br /&gt;&lt;span class=&quot;lua-warn&quot;&gt;脚本中未见调用&lt;/span&gt;<br /> |-<br /> | [[Lua接口/服务端/LuaFnActiveExteriorWeapon|LuaFnActiveExteriorWeapon]]<br /> | &lt;code&gt;LuaFnActiveExteriorWeapon(sceneId, selfId, bag, item, token)&lt;/code&gt;&lt;br /&gt;用背包中的道具激活幻饰武器。&lt;br /&gt;&lt;span class=&quot;lua-muted&quot;&gt;脚本中 1 处调用&lt;/span&gt;<br /> |-<br /> | [[Lua接口/服务端/LuaFnExteriorChangeHairColorByIndex|LuaFnExteriorChangeHairColorByIndex]]<br /> | &lt;code&gt;LuaFnExteriorChangeHairColorByIndex(sceneId, selfId, index)&lt;/code&gt;&lt;br /&gt;按配色索引切换发色（需要发色 NPC 会话）。&lt;br /&gt;&lt;span class=&quot;lua-muted&quot;&gt;脚本中 1 处调用&lt;/span&gt;<br /> |-<br /> | [[Lua接口/服务端/LuaFnExteriorNpcContext|LuaFnExteriorNpcContext]]<br /> | &lt;code&gt;LuaFnExteriorNpcContext(sceneId, selfId, npc, kind)&lt;/code&gt;&lt;br /&gt;建立外观业务 NPC 会话，记录 NPC 与业务类型。&lt;br /&gt;&lt;span class=&quot;lua-muted&quot;&gt;脚本中 5 处调用&lt;/span&gt;<br /> |-<br /> | [[Lua接口/服务端/LuaFnExteriorSaveHairColor|LuaFnExteriorSaveHairColor]]<br /> | &lt;code&gt;LuaFnExteriorSaveHairColor(sceneId, selfId, color, confirm, replace)&lt;/code&gt;&lt;br /&gt;保存发色：写入颜色值，可选替换已有配色槽。&lt;br /&gt;&lt;span class=&quot;lua-muted&quot;&gt;脚本中 1 处调用&lt;/span&gt;<br /> |-<br /> | [[Lua接口/服务端/LuaFnExteriorUseRideEquip|LuaFnExteriorUseRideEquip]]<br /> | &lt;code&gt;LuaFnExteriorUseRideEquip(sceneId, selfId, bag, item, token)&lt;/code&gt;&lt;br /&gt;用背包中的坐骑道具激活坐骑外观，成功标记与失败文案一起返回。&lt;br /&gt;&lt;span class=&quot;lua-muted&quot;&gt;脚本中 1 处调用&lt;/span&gt;<br /> |-<br /> | [[Lua接口/服务端/LuaFnExteriorWeaponLevelUp|LuaFnExteriorWeaponLevelUp]]<br /> | &lt;code&gt;LuaFnExteriorWeaponLevelUp(sceneId, selfId, id)&lt;/code&gt;&lt;br /&gt;升级幻饰武器（需要有效的外观 NPC 会话）。&lt;br /&gt;&lt;span class=&quot;lua-muted&quot;&gt;脚本中 1 处调用&lt;/span&gt;<br /> |-<br /> | [[Lua接口/服务端/LuaFnGetEquipedItemTableIndex|LuaFnGetEquipedItemTableIndex]]<br /> | &lt;code&gt;LuaFnGetEquipedItemTableIndex(sceneId, selfId, slot)&lt;/code&gt;&lt;br /&gt;读取指定装备位上装备的物品表编号。&lt;br /&gt;&lt;span class=&quot;lua-muted&quot;&gt;脚本中 1 处调用&lt;/span&gt;<br /> |-<br /> | [[Lua接口/服务端/LuaFnGetExteriorRideInfoByExteriorID|LuaFnGetExteriorRideInfoByExteriorID]]<br /> | &lt;code&gt;LuaFnGetExteriorRideInfoByExteriorID(exteriorId)&lt;/code&gt;&lt;br /&gt;按外观编号读取坐骑外观的名称与回收道具编号。&lt;br /&gt;&lt;span class=&quot;lua-muted&quot;&gt;脚本中 1 处调用&lt;/span&gt;<br /> |-<br /> | [[Lua接口/服务端/LuaFnGetExteriorWeaponInfo|LuaFnGetExteriorWeaponInfo]]<br /> | &lt;code&gt;LuaFnGetExteriorWeaponInfo(weaponId)&lt;/code&gt;&lt;br /&gt;按编号读取幻饰武器的编号与名称。&lt;br /&gt;&lt;span class=&quot;lua-muted&quot;&gt;脚本中 1 处调用&lt;/span&gt;<br /> |-<br /> | [[Lua接口/服务端/LuaFnGetExteriorWeaponLeftTime|LuaFnGetExteriorWeaponLeftTime]]<br /> | &lt;code&gt;LuaFnGetExteriorWeaponLeftTime(sceneId, selfId, id)&lt;/code&gt;&lt;br /&gt;读取指定幻饰武器的剩余时长。&lt;br /&gt;&lt;span class=&quot;lua-warn&quot;&gt;脚本中未见调用&lt;/span&gt;<br /> |-<br /> | [[Lua接口/服务端/LuaFnGetExteriorWeaponLevelData|LuaFnGetExteriorWeaponLevelData]]<br /> | &lt;code&gt;LuaFnGetExteriorWeaponLevelData(sceneId, selfId, id)&lt;/code&gt;&lt;br /&gt;读取幻饰武器的当前等级与下一级升级消耗。&lt;br /&gt;&lt;span class=&quot;lua-muted&quot;&gt;脚本中 1 处调用&lt;/span&gt;<br /> |-<br /> | [[Lua接口/服务端/LuaFnGetItemName|LuaFnGetItemName]]<br /> | &lt;code&gt;LuaFnGetItemName(itemTableIndex)&lt;/code&gt;&lt;br /&gt;按物品表编号读取物品名称（单参数，没有场景上下文）。&lt;br /&gt;&lt;span class=&quot;lua-muted&quot;&gt;脚本中 1 处调用&lt;/span&gt;<br /> |-<br /> | [[Lua接口/服务端/LuaFnGetNumberingFashionCode|LuaFnGetNumberingFashionCode]]<br /> | &lt;code&gt;LuaFnGetNumberingFashionCode(itemTableIndex)&lt;/code&gt;&lt;br /&gt;把编号时装的物品表编号换算成 1–300 的时装编号。&lt;br /&gt;&lt;span class=&quot;lua-warn&quot;&gt;脚本中未见调用&lt;/span&gt;<br /> |-<br /> | [[Lua接口/服务端/LuaFnGrantExteriorWeapon|LuaFnGrantExteriorWeapon]]<br /> | &lt;code&gt;LuaFnGrantExteriorWeapon(sceneId, selfId, id, hours)&lt;/code&gt;&lt;br /&gt;直接发放限时幻饰武器（服务端接口）。&lt;br /&gt;&lt;span class=&quot;lua-warn&quot;&gt;脚本中未见调用&lt;/span&gt;<br /> |-<br /> | [[Lua接口/服务端/LuaFnIsHaveExteriorWeapon|LuaFnIsHaveExteriorWeapon]]<br /> | &lt;code&gt;LuaFnIsHaveExteriorWeapon(sceneId, selfId, id)&lt;/code&gt;&lt;br /&gt;判断玩家是否持有指定幻饰武器。&lt;br /&gt;&lt;span class=&quot;lua-warn&quot;&gt;脚本中未见调用&lt;/span&gt;<br /> |-<br /> | [[Lua接口/服务端/LuaFnPrepareExteriorWeaponActivation|LuaFnPrepareExteriorWeaponActivation]]<br /> | &lt;code&gt;LuaFnPrepareExteriorWeaponActivation(sceneId, selfId)&lt;/code&gt;&lt;br /&gt;准备幻饰武器激活：读取本次消耗的物品快照并计算 7 项结果。&lt;br /&gt;&lt;span class=&quot;lua-muted&quot;&gt;脚本中 1 处调用&lt;/span&gt;<br /> |-<br /> | [[Lua接口/服务端/LuaFnReverseExteriorRide|LuaFnReverseExteriorRide]]<br /> | &lt;code&gt;LuaFnReverseExteriorRide(sceneId, selfId, id)&lt;/code&gt;&lt;br /&gt;回收（卸下）指定坐骑外观。&lt;br /&gt;&lt;span class=&quot;lua-muted&quot;&gt;脚本中 1 处调用&lt;/span&gt;<br /> |-<br /> | [[Lua接口/服务端/LuaFnUnlockAndChangeExterior|LuaFnUnlockAndChangeExterior]]<br /> | &lt;code&gt;LuaFnUnlockAndChangeExterior(sceneId, selfId, kind, id, confirm)&lt;/code&gt;&lt;br /&gt;解锁并更换外观（类型 + 编号 + 确认）。&lt;br /&gt;&lt;span class=&quot;lua-muted&quot;&gt;脚本中 3 处调用&lt;/span&gt;<br /> |-<br /> | [[Lua接口/服务端/LuaFnUpdateExteriorToClient|LuaFnUpdateExteriorToClient]]<br /> | &lt;code&gt;LuaFnUpdateExteriorToClient(sceneId, selfId)&lt;/code&gt;&lt;br /&gt;把玩家当前的外观状态重新下发给客户端。&lt;br /&gt;&lt;span class=&quot;lua-warn&quot;&gt;脚本中未见调用&lt;/span&gt;<br /> |}<br /> &lt;/div&gt;</div> Waylee