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

2026-09-07T11:16:11Z

整理当前服务端 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;">好友与师徒：43 个接口，43 个调用名称。</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接口/服务端/LuaAddPrenticeProExp|LuaAddPrenticeProExp]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaAddPrenticeProExp(sceneId, selfId, guidPrentice, nExp)</code> 增加师傅可领取的徒弟贡献储备经验。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnAgreeSwear|LuaFnAgreeSwear]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnAgreeSwear(sceneId, selfId, targetId)</code> 记录指定队友同意结拜。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnAllTeamSwear|LuaFnAllTeamSwear]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnAllTeamSwear(sceneId, selfId)</code> 为当前队伍执行结拜。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnAprentice|LuaFnAprentice]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnAprentice(sceneId, selfId, targetId)</code> selfId 拜 targetId 为师
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnBetrayMaster|LuaFnBetrayMaster]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnBetrayMaster(sceneId, selfId)</code> 叛师
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnChangeJieBaiName|LuaFnChangeJieBaiName]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnChangeJieBaiName(sceneId, selfId)</code> // 打开客户端结拜称号修改界面并返回现有称号。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnChuShiMail|LuaFnChuShiMail]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnChuShiMail(sceneId, selfId)</code> 向当前人物的师傅发送出师通知邮件。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnDivorce|LuaFnDivorce]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnDivorce(sceneId, selfId)</code> 单方面离婚
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnDrawJieBaiName|LuaFnDrawJieBaiName]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnDrawJieBaiName(sceneId, selfId, nTeamCount)</code> // 打开客户端结拜名称抽取界面，并告知当前队伍人数。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnExpAssign|LuaFnExpAssign]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnExpAssign(sceneId, selfId, nOpType)</code> 向客户端发送师徒储备经验领取界面的当前数据。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnExpelPrentice|LuaFnExpelPrentice]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnExpelPrentice(sceneId, selfId, PrenticeGUID)</code> 开除某个徒弟
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnFinishAprentice|LuaFnFinishAprentice]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnFinishAprentice(sceneId, selfId, targetId)</code> selfId 离开 targetId 师们，正式出师
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetBrotherGuid|LuaFnGetBrotherGuid]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetBrotherGuid(sceneId, selfId, nIndex)</code> 按索引取得结拜兄弟的 GUID。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetFriendName|LuaFnGetFriendName]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetFriendName(sceneId, selfId, friendGUID)</code> 得到 GUID 为 friendGUID 的好友的名字
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetFriendPoint|LuaFnGetFriendPoint]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetFriendPoint(sceneId, selfId, friendID)</code> 得到和 ID 为 friendID 的好友的友好度
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetFriendPointByGUID|LuaFnGetFriendPointByGUID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetFriendPointByGUID(sceneId, selfId, friendGUID)</code> 按好友 GUID 取得友好度。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetJieBaiName|LuaFnGetJieBaiName]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetJieBaiName(sceneId, selfId)</code> // 返回当前结拜称号；没有结拜称号时不压入返回值。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetMasterGUID|LuaFnGetMasterGUID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetMasterGUID(sceneId, selfId)</code> 得到师傅的 GUID
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetmasterLevel|LuaFnGetmasterLevel]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetmasterLevel(sceneId, selfId)</code> 取得当前角色的师傅等级。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPrenticeBetrayTime|LuaFnGetPrenticeBetrayTime]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetPrenticeBetrayTime(sceneId, selfId)</code> 得到最后一次徒弟叛师的时间
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPrenticeCount|LuaFnGetPrenticeCount]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetPrenticeCount(sceneId, selfId)</code> 得要徒弟数量
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetPrenticeGUID|LuaFnGetPrenticeGUID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetPrenticeGUID(sceneId, selfId, nIndex)</code> 按索引读取玩家徒弟的角色 GUID。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetSpouseGUID|LuaFnGetSpouseGUID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetSpouseGUID(sceneId, selfId)</code> 得到配偶的 GUID
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnHaveMaster|LuaFnHaveMaster]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnHaveMaster(sceneId, selfId)</code> 判断 selfId 是否有师傅
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnIfAllTeamAgreeSwear|LuaFnIfAllTeamAgreeSwear]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnIfAllTeamAgreeSwear(sceneId, selfId)</code> 判断当前队伍成员是否已经全部同意结拜。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnIsBrother|LuaFnIsBrother]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnIsBrother(sceneId, selfId, targetId)</code> 判断 targetId 是否是 selfId 的结拜兄弟
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnIsFriend|LuaFnIsFriend]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnIsFriend(sceneId, selfId, friendID)</code> 判断 selfId 和 friendID 是否为好友
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnIsMarried|LuaFnIsMarried]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnIsMarried(sceneId, selfId)</code> 判断调用者是否已婚
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnIsMaster|LuaFnIsMaster]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnIsMaster(sceneId, selfId, targetId)</code> 判断 targetId 是否是 selfId 的师傅
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnIsMasterEver|LuaFnIsMasterEver]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnIsMasterEver(sceneId, selfId, targetId)</code> 判断目标是否曾作为当前人物的师傅，不受出师任务标志影响。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnIsPrentice|LuaFnIsPrentice]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnIsPrentice(sceneId, selfId, targetId)</code> 判断 targetId 是否是 selfId 的徒弟
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnIsSpouses|LuaFnIsSpouses]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnIsSpouses(sceneId, selfId, targetId)</code> 判断 selfId 和 targetId 是否是夫妻
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnIsSweared|LuaFnIsSweared]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnIsSweared(sceneId, selfId)</code> 判断当前人物是否已经结拜。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnMarry|LuaFnMarry]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnMarry(sceneId, selfId, spouseId, nWeddingType)</code> sceneId 和 spouseId 结为夫妻
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSetFriendPoint|LuaFnSetFriendPoint]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSetFriendPoint(sceneId, selfId, friendID, nFriendPoint)</code> 设置 selfId 与 friendID 的友好度为 friendPoint
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSetFriendPointByGUID|LuaFnSetFriendPointByGUID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSetFriendPointByGUID(sceneId, selfId, friendGUID, nFriendPoint)</code> 设置 selfId 与 friendGUID 的友好度为 friendPoint
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSetmasterLevel|LuaFnSetmasterLevel]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSetmasterLevel(sceneId, selfId, nMasterLevel)</code> 设置当前角色的师傅等级并标记关系数据为脏。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnTeamSnapshort|LuaFnTeamSnapshort]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnTeamSnapshort(sceneId, selfId)</code> // 保存队伍成员快照，供结拜确认阶段校验队伍是否发生变化。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnUnMarry|LuaFnUnMarry]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnUnMarry(sceneId, selfId, spouseId)</code> sceneId 和 spouseId 离婚
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnUnswear|LuaFnUnswear]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnUnswear(sceneId, selfId, guid)</code> 解除与指定 GUID 的结拜关系。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnVerifyTeamWithSnapshort|LuaFnVerifyTeamWithSnapshort]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnVerifyTeamWithSnapshort(sceneId, selfId)</code> // 核对当前队伍与之前保存的结拜队伍快照。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaGetPrenticeSupplyExp|LuaGetPrenticeSupplyExp]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaGetPrenticeSupplyExp(sceneId, selfId)</code> 取得师傅当前可领取的徒弟贡献储备经验。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaGetProfMasterExp|LuaGetProfMasterExp]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaGetProfMasterExp(sceneId, selfId)</code> 取得徒弟尚未结算给师傅的职业师傅经验。
|}
</div>

Lua接口/服务端函数索引/好友与师徒 - 版本历史

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

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