雪舞：维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

2026-09-12T05:54:26Z

维护服务端 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接口/服务端调用约定|调用约定]]

查询帮会信息、帮会操作、帮战与帮会城市。帮会用帮会编号（guildID）标识，帮会城市用城市场景编号（citySceneId）标识。

== 帮会查询 ==
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 接口
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 参数与返回
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetHumanGuildID|GetHumanGuildID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId</code> → 所属帮会编号；失败 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetGuildLevel|GetGuildLevel]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId</code> → 帮会等级缓存；失败 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetGuildPos|GetGuildPos]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId</code> → 当前帮会职位；0 或 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetGuildAppointTime|LuaFnGetGuildAppointTime]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId</code> → 就任当前职位经过的分钟数；失败 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/IsGuildPosLongEnough|IsGuildPosLongEnough]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId</code> → 任职是否满七天；失败 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetFactionJoinTime|GetFactionJoinTime]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId</code> → 加入帮会时刻的 ANSI 时间；0 或 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetHumanGuildLeagueID|LuaFnGetHumanGuildLeagueID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId</code> → 帮会联赛编号；失败 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnGetHumanGuildLeagueName|LuaFnGetHumanGuildLeagueName]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId</code> → 帮会联赛名称；失败 -1。
|}
[[Lua接口/服务端/GetGuildPos|GetGuildPos]] 返回 0 表示无职位（合法值），失败才是 -1。

== 荣誉 ==
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 接口
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 参数与返回
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetHonour|GetHonour]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId</code> → 帮会荣誉值（任务数据 263 号槽）；失败 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/SetHonour|SetHonour]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, honour</code> → 1 / -1。设置并刷新玩家详细属性。
|}
帮会荣誉值存放在任务数据 263 号槽，[[Lua接口/服务端/SetHonour|SetHonour]] 会刷新玩家详细属性。

== 帮会操作 ==
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 接口
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 参数与返回
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GuildCreate|GuildCreate]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, targetId</code>；无返回值。显示创建帮会界面。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GuildList|GuildList]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, targetId</code>；无返回值。请求帮会列表。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GuildPromoteToChief|GuildPromoteToChief]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId</code>；无返回值。副帮主发起帮主推举。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnDrawGuildPositionName|LuaFnDrawGuildPositionName]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, arg3</code>；无返回值。请求 World 发放职位称号。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnComMissComplete|LuaFnComMissComplete]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId</code> → 返回值；失败 -1。通知 World 完成商业任务。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetCityGuildID|GetCityGuildID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, citySceneId</code> → 城市场景所属帮会编号；失败 -1。
|}
这几个帮会操作接口都**无返回值**（除 [[Lua接口/服务端/LuaFnComMissComplete|LuaFnComMissComplete]]）。

== 帮战 ==
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 接口
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 参数与返回
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetGuildWarPoint|GetGuildWarPoint]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, pointIndex</code> → 帮战积分；失败 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetGuildBattleValue|GetGuildBattleValue]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, battleFlag</code> → 帮战统计值；失败 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/SetGuildBattleValue|SetGuildBattleValue]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, battleFlag, battleValue</code>；无返回值。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetHumanGuildInt|GetHumanGuildInt]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, arrayIndex</code> → 临时整数数组值；失败 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/SetHumanGuildInt|SetHumanGuildInt]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, arrayIndex, value</code> → 1 / -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetGuildIntNum|GetGuildIntNum]] / [[Lua接口/服务端/SetGuildIntNum|SetGuildIntNum]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">arg1, guildID, arrayIndex[, num]</code> → 帮战记录整数参数；部分分支无返回值。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/NotifyGuildBattle|NotifyGuildBattle]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, flagGuild, guildIDAttack, guildIDDefence</code>；无返回值。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/NotifyBattleScore|NotifyBattleScore]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId</code>；无返回值。
|}
[[Lua接口/服务端/GetGuildIntNum|GetGuildIntNum]]、[[Lua接口/服务端/SetGuildIntNum|SetGuildIntNum]] 的第一个参数不是 sceneId，按实际用途传入。

== 帮会城市 ==
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 接口
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 参数与返回
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CityApply|CityApply]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId</code>；无返回值。请求可申请的城市入口组。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CityCreate|CityCreate]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, citySceneId</code>；无返回值。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CityDelete|CityDelete]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, citySceneId</code>；无返回值。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CheckPlayerCanApplyCity|CheckPlayerCanApplyCity]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId</code> → 1 / 0 / -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CityGetSelfCityID|CityGetSelfCityID]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId</code> → 所属城市场景编号；失败 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CityGetBuildingLevel|CityGetBuildingLevel]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, citySceneId, buildingType</code> → 建筑等级；0 或 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CityGetProgress|CityGetProgress]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, citySceneId, progressType</code> → 建设进度；0 或 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CityIncProgress|CityIncProgress]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, citySceneId, progressType</code>；无返回值。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CityGetMaintainStatus|CityGetMaintainStatus]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, citySceneId</code> → 维护状态；0 或 -1。
|}
城市创建、删除、进度增加都通过 WorldServer 异步完成，接口本身无返回值。

== 城市属性 ==
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 接口
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 参数与返回
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CityGetAttr|CityGetAttr]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, attrType</code> → 城市脚本属性；0 或 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CitySetAttr|CitySetAttr]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, attrType, attrValue</code>；无返回值。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CityChangeAttr|CityChangeAttr]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, attrType, attrChangedValue</code> → 帮贡修改返回 1、-1 或无返回值。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CanCitySetAttr|CanCitySetAttr]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, attrType</code> → 是否允许异步修改；0 或 -1。
|}
[[Lua接口/服务端/CityGetAttr|CityGetAttr]] 的 attrType：0-5 为六项帮会发展度、6 为个人帮贡、7 为帮会资金。[[Lua接口/服务端/CityChangeAttr|CityChangeAttr]] 的返回值因属性类型而异。

== 城市升级与传送 ==
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 接口
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 参数与返回
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CityBeginLevelUpBuilding|CityBeginLevelUpBuilding]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, citySceneId</code> → 部分分支无返回值。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CitySuccessLevelUpBuilding|CitySuccessLevelUpBuilding]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, citySceneId, buildingIndex, buildingLevel</code>；无返回值。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CityInBuildingLevelUp|CityInBuildingLevelUp]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, citySceneId</code> → 0 或 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CityMoveToPort|CityMoveToPort]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId</code>；无返回值。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CityMoveToScene|CityMoveToScene]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, targetSceneId, posX, posZ</code>；无返回值。
|}
[[Lua接口/服务端/CitySuccessLevelUpBuilding|CitySuccessLevelUpBuilding]] 需要 5 个参数，通知 World 升级成功。

== 城市名称与查询 ==
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 接口
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 参数与返回
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnCityGetNameBySceneId|LuaFnCityGetNameBySceneId]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">citySceneId</code> → 城市名称；失败 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnCityGetDefaultNameBySceneId|LuaFnCityGetDefaultNameBySceneId]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">citySceneId</code> → 配置表默认名称；失败 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CityGetCityName|CityGetCityName]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, citySceneId</code> → 入口场景缓存的城市名称；失败空串或 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CityExistByIndex|CityExistByIndex]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, portSceneId, cityIndex</code> → 城市是否存在；0 或 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CityGetNameByIndex|CityGetNameByIndex]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, portSceneId, cityIndex</code> → 城市占位名称；空串或 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnAddGuildCollectNum|LuaFnAddGuildCollectNum]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, nValue</code> → 1 / -1。
|}
[[Lua接口/服务端/LuaFnCityGetNameBySceneId|LuaFnCityGetNameBySceneId]] 与 [[Lua接口/服务端/LuaFnCityGetDefaultNameBySceneId|LuaFnCityGetDefaultNameBySceneId]] 只传城市场景编号。

== 脚本锁与任务管理 ==
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 接口
! scope="col" style="text-align:left;background:#edf3f2;padding:8px;" | 参数与返回
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/IsLocked|IsLocked]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, lockType</code> → 64 位脚本锁标志；0 或 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/Lock|Lock]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, lockType, iValue</code>；无返回值。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/OpenCityMissonMgr|OpenCityMissonMgr]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId</code>；无返回值。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/GetCityMissonValue|GetCityMissonValue]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, missType, valueType</code> → 控制值或剩余额度；-99 或 -1。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/ChangeCityMissonValue|ChangeCityMissonValue]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">sceneId, selfId, valueType, value</code> → 0 或 -1。
|}
[[Lua接口/服务端/GetCityMissonValue|GetCityMissonValue]] 失败返回 **-99 或 -1**（-99 是特殊哨兵）。

== 检查帮会并申请城市 ==
<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">local guildId = GetHumanGuildID(sceneId, selfId)
if type(guildId) == "number" and guildId ~= -1 then
local canApply = CheckPlayerCanApplyCity(sceneId, selfId)
if type(canApply) == "number" and canApply == 1 then
CityApply(sceneId, selfId)
end
end</pre>
[[Lua接口/服务端/CheckPlayerCanApplyCity|CheckPlayerCanApplyCity]] 返回 1 表示满足条件，用 <code style="white-space:normal;overflow-wrap:anywhere;">== 1</code> 判断。

== 读取帮会等级与职位 ==
<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">local level = GetGuildLevel(sceneId, selfId)
if type(level) == "number" and level ~= -1 then
local pos = GetGuildPos(sceneId, selfId)
-- pos 为 0 表示无职位（合法值）
end</pre>
[[Lua接口/服务端/GetGuildPos|GetGuildPos]] 返回 0 是无职位的合法值，只有 -1 才是失败。

== 相关主题 ==
* [[Lua接口/角色信息|角色信息]]
* [[Lua接口/属性读取与修改|属性读取与修改]]
* [[Lua接口/等级与经验|等级与经验]]
* [[Lua接口/货币相关|货币相关]]
* [[Lua接口/物品查询|物品查询]]
* [[Lua接口/物品发放与扣除|物品发放与扣除]]
* [[Lua接口/背包空间|背包空间]]
* [[Lua接口/装备操作|装备操作]]
* [[Lua接口/任务状态|任务状态]]
* [[Lua接口/任务变量|任务变量]]
* [[Lua接口/NPC对话|NPC 对话]]
* [[Lua接口/对话选项|对话选项]]
* [[Lua接口/技能相关|技能相关]]
* [[Lua接口/心法相关|心法相关]]
* [[Lua接口/状态效果|状态效果]]
* [[Lua接口/生活技能|生活技能]]
* [[Lua接口/珍兽查询|珍兽查询]]
* [[Lua接口/珍兽操作|珍兽操作]]
* [[Lua接口/场景查询|场景查询]]
* [[Lua接口/坐标与传送|坐标与传送]]
* [[Lua接口/副本相关|副本相关]]
* [[Lua接口/活动相关|活动相关]]
* [[Lua接口/时间与计时|时间与计时]]
* [[Lua接口/怪物相关|怪物相关]]
* [[Lua接口/队伍相关|队伍相关]]
* [[Lua接口/帮会相关|帮会相关]]
* [[Lua接口/消息与提示|消息与提示]]
* [[Lua接口/聊天与公告|聊天与公告]]

[[Lua接口/服务端调用约定|服务端调用约定]] · [[Lua接口/服务端调用示例|服务端调用示例]] · [[Lua接口/服务端函数索引|服务端函数索引]]

[[Lua接口/函数不存在|函数不存在或提示 nil]] · [[Lua接口/参数类型与顺序|参数类型与顺序]] · [[Lua接口/返回值判断|返回值判断]] · [[Lua接口/对象ID与GUID|对象 ID 与 GUID]]

<div style="margin-top:20px;padding-top:10px;border-top:1px solid #dbe3e6;color:#657078;font-size:12px;">本页函数签名与返回约定依据当前服务端注册表整理；sceneId、selfId 由实际回调提供，业务枚举、属性类型编号与运行效果需要实测。</div>

</div>

Lua接口/帮会相关 - 版本历史

雪舞：​维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

雪舞：维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例