雪舞：整理当前服务端 Lua 接口：注册名称、参数、返回值与调用说明

2026-09-07T11:16:10Z

整理当前服务端 Lua 接口：注册名称、参数、返回值与调用说明

新页面

__NOTOC__
<div class="lua-reference" style="max-width:1200px;margin:0 auto;line-height:1.8;color:#29343a;font-family:Arial,'Microsoft YaHei',sans-serif;letter-spacing:0;overflow-wrap:anywhere;">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端调用约定|调用约定]]

<div style="padding:14px 0;border-top:3px solid #287568;">商店与交易：36 个接口，36 个调用名称。</div>
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;width:36%;" | 函数 / 别名
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 调用与用途
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/ApplyPlayerShop|ApplyPlayerShop]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">ApplyPlayerShop(sceneId, selfId, targetId)</code> 通知客户端弹开申请开店
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/BuyYuanBaoCount|BuyYuanBaoCount]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">BuyYuanBaoCount(sceneId, selfId, targetId, OptType, Param)</code> 记录角色累计购买元宝数量。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CanErasePlayerShop|CanErasePlayerShop]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">CanErasePlayerShop(sceneId, selfId)</code> 检查角色店铺中是否仍有商品、宠物或求购项目。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CommisionShopBuy|CommisionShopBuy]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">CommisionShopBuy(sceneId, selfId, targetId, grade, serialNumber)</code> 购买寄售商品，完成货币交换、邮件结算和审计。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CommisionShopSell|CommisionShopSell]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">CommisionShopSell(sceneId, selfId, targetId, grade, price)</code> 向寄售商店挂牌，扣除本金和手续费并记录元宝流水。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CSAddBankMoney|CSAddBankMoney]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">CSAddBankMoney(sceneId, selfId, amount, szCSOPType)</code> 寄售商店通过邮件脚本退还或结算银行金币。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CSAddYuanbao|CSAddYuanbao]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">CSAddYuanbao(sceneId, selfId, amount, szCSOPType)</code> 寄售商店通过邮件脚本退还或结算元宝。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/DecCommisionNum|DecCommisionNum]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">DecCommisionNum(sceneId, selfId)</code> 寄售成功后扣减角色当日可提交次数，最小保持为零。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/DispatchAbilityInfo|DispatchAbilityInfo]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">DispatchAbilityInfo(sceneId, selfId, targetId, scriptId, AbilityId, nNeedMoney, nNeedExp, nNeedSkillExp, nLevelLimit)</code> 向玩家发送生活技能老师的学习费用、经验和等级限制信息。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/DispatchMenpaiInfo|DispatchMenpaiInfo]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">DispatchMenpaiInfo(sceneId, selfId, targetId, MenpaiId)</code> 门派导师使用
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/DispatchNoNpcShopItem|DispatchNoNpcShopItem]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">DispatchNoNpcShopItem(sceneId, selfId, ShopId)</code> 无 NPC 商店。UniqueID 的低 16 位固定为 0xFFFF，购买时不校验 NPC 距离。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/DispatchNpcYuanbaoShopItem|DispatchNpcYuanbaoShopItem]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">DispatchNpcYuanbaoShopItem(sceneId, selfId, targetId, ShopId)</code> 有 NPC 的元宝商店。优先使用 NPC 挂载的动态商店，再回退到静态商店。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/DispatchPlayerShopList|DispatchPlayerShopList]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">DispatchPlayerShopList(sceneId, selfId, targetId)</code> 发送此场景中的商店列表
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/DispatchPlayerShopSaleOutList|DispatchPlayerShopSaleOutList]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">DispatchPlayerShopSaleOutList(sceneId, selfId, targetId)</code> 发送此场景中的盘出的商店列表
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/DispatchShopItem|DispatchShopItem]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">DispatchShopItem(sceneId, selfId, targetId, ShopId)</code> 向玩家发送指定 NPC 的商店商品信息。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/DispatchXinfaLevelInfo|DispatchXinfaLevelInfo]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">DispatchXinfaLevelInfo(sceneId, selfId, targetId, MenpaiId)</code> 门派心法导师使用
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/DispatchYuanbaoShopItem|DispatchYuanbaoShopItem]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">DispatchYuanbaoShopItem(sceneId, selfId, ShopId)</code> 无 NPC 元宝商店。商店类型置为 1，货币单位仍由 ShopTable.txt 决定。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/DoHighRepair|DoHighRepair]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">DoHighRepair(sceneId, selfId, bagPos, price)</code> 扣除脚本指定费用后执行高级修理，并同步金币、交子统计。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/DoRepair|DoRepair]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">DoRepair(sceneId, selfId, bagPos, platformType)</code> 使用生活技能修理背包装备，失败累计修理次数，成功扣除活力。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/ErasePlayerShop|ErasePlayerShop]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">ErasePlayerShop(sceneId, selfId)</code> 删除角色名下的物品店和宠物店，并退还符合上限的店铺本金。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetCommisionShop|GetCommisionShop]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetCommisionShop(sceneId, selfId, targetId, grade)</code> 打开 NPC 绑定的寄售商店并下发指定档位商品。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetCommisionShopItem|GetCommisionShopItem]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetCommisionShopItem(sceneId, shopId, serialNumber)</code> 查询指定寄售商店中的一条商品记录。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetHighRepairPrice|GetHighRepairPrice]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetHighRepairPrice(sceneId, selfId, bagPos)</code> 计算背包装备的高级修理价格。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetPlayerShopFrezeType|GetPlayerShopFrezeType]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetPlayerShopFrezeType(sceneId, selfId, shopIndex)</code> 返回角色指定玩家商店的冻结类型。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/IsActiveRichesCard|IsActiveRichesCard]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">IsActiveRichesCard()</code> 返回财富卡功能开关。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/IsActiveRichesCard666|IsActiveRichesCard666]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">IsActiveRichesCard666()</code> 返回财富卡 666 功能开关。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/IsEnableYuanBaoPiao|IsEnableYuanBaoPiao]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">IsEnableYuanBaoPiao()</code> 返回元宝票功能开关。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetShiTuTitle|LuaFnGetShiTuTitle]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetShiTuTitle(sceneId, selfId)</code> 返回角色当前保存的师徒称号字符串。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetShopName|LuaFnGetShopName]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetShopName(sceneId, selfId, iShopType)</code> 获得指定人身上的玩家商店名
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetSpouseTitle|LuaFnGetSpouseTitle]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetSpouseTitle(sceneId, selfId)</code> 返回角色当前保存的配偶称号字符串。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnIsStalling|LuaFnIsStalling]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnIsStalling(sceneId, selfId)</code> 判断角色当前是否已经打开个人摊位。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnJoinMenpai|LuaFnJoinMenpai]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnJoinMenpai(sceneId, selfId, targetId, MenpaiId)</code> 为玩家变更门派，并刷新相关心法、技能和属性点。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnOpenPlayerShop|LuaFnOpenPlayerShop]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnOpenPlayerShop(sceneId, selfId, npcObjId, iShopType)</code> 获得指定人身上的玩家商店名
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnOpenPWBox|LuaFnOpenPWBox]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnOpenPWBox(sceneId, selfId)</code> 已设置但尚未解锁二级密码时，通知客户端打开解锁界面。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/YuanBao|YuanBao]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">YuanBao(sceneId, selfId, targetId, opttype, Param)</code> 查询或修改角色元宝。修改成功后通过 World 统计全服增加、消耗总量，
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/ZengDian|ZengDian]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">ZengDian(sceneId, selfId, targetId, opttype, Param)</code> 查询或修改角色赠点，并在增加时同步世界服统计。
|}
</div>

Lua接口/服务端函数索引/商店与交易 - 版本历史

雪舞：​整理当前服务端 Lua 接口：注册名称、参数、返回值与调用说明

雪舞：整理当前服务端 Lua 接口：注册名称、参数、返回值与调用说明