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

2026-09-07T11:16:12Z

整理当前服务端 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;">帮会城市：38 个接口，38 个调用名称。</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接口/服务端/CanCitySetAttr|CanCitySetAttr]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">CanCitySetAttr(sceneId, selfId, attrType)</code> 判断工资次数属性当前是否允许发起异步修改。
|-
| 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;">ChangeCityMissonValue(sceneId, selfId, valueType, value)</code> 请求 WorldServer 修改所属城市任务管理器的剩余额度。
|-
| 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;">CheckPlayerCanApplyCity(sceneId, selfId)</code> 检查玩家是否满足申请城市的职位和资产条件。
|-
| 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;">CityApply(sceneId, selfId)</code> 向 World 请求当前可申请的城市入口组及其序号。
|-
| 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;">CityBeginLevelUpBuilding(sceneId, selfId, citySceneId)</code> 让指定城市进入建筑升级状态。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CityBuildingChange|CityBuildingChange]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">CityBuildingChange(sceneId, selfId, BuildingID, BuildingLevel)</code> 当前不允许通过此接口直接修改城市建筑等级，只记录错误。 '''不执行修改'''
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CityCancelLevelUpBuilding|CityCancelLevelUpBuilding]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">CityCancelLevelUpBuilding(sceneId, selfId, citySceneId)</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;">CityChangeAttr(sceneId, selfId, attrType, attrChangedValue)</code> 增减城市或帮会属性，帮贡修改返回 1、-1 或无返回值。
|-
| 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;">CityCreate(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;">CityDelete(sceneId, selfId, citySceneId)</code> 删除此城市
|-
| 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;">CityExistByIndex(sceneId, selfId, portSceneId, cityIndex)</code> 判断入口场景指定序号的城市是否存在。
|-
| 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;">CityGetAttr(sceneId, selfId, attrType)</code> 返回城市脚本属性。0-5 为六项帮会发展度，6 为个人帮贡，7 为帮会资金，
|-
| 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;">CityGetBuildingLevel(sceneId, selfId, citySceneId, buildingType)</code> 返回指定城市建筑的当前等级。
|-
| 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;">CityGetCityName(sceneId, selfId, citySceneId)</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;">CityGetMaintainStatus(sceneId, selfId, citySceneId)</code> 返回指定城市当前维护状态。
|-
| 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;">CityGetNameByIndex(sceneId, selfId, portSceneId, cityIndex)</code> 返回入口场景指定序号的城市占位名称。
|-
| 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;">CityGetProgress(sceneId, selfId, citySceneId, progressType)</code> 返回指定城市对应类型的当前建设进度。
|-
| 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;">CityGetSelfCityID(sceneId, selfId)</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;">CityInBuildingLevelUp(sceneId, selfId, citySceneId)</code> 判断指定城市是否正在升级建筑。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CityInBuildingResearch|CityInBuildingResearch]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">CityInBuildingResearch(sceneId, selfId, citySceneId)</code> 判断指定城市是否正在研究建筑技术。
|-
| 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;">CityIncProgress(sceneId, selfId, citySceneId, progressType)</code> 通知 World 将指定城市进度增加一次。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CityMoveTo|CityMoveTo]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">CityMoveTo(sceneId, selfId)</code> 更改城市中建筑属性
|-
| 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;">CityMoveToPort(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;">CityMoveToScene(sceneId, selfId, targetSceneId, posX, posZ)</code> 请求 World 将玩家传送到指定城市场景坐标。
|-
| 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;">CitySetAttr(sceneId, selfId, attrType, attrValue)</code> 设置城市或帮会属性，实际修改由 WorldServer 完成。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/CitySetLevel|CitySetLevel]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">CitySetLevel(sceneId, selfId, citySceneId, arg4)</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;">CitySuccessLevelUpBuilding(sceneId, selfId, citySceneId, buildingIndex, buildingLevel)</code> 通知 World 指定城市建筑升级成功。
|-
| 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;">GetCityMissonValue(sceneId, selfId, missType, valueType)</code> 读取所属城市任务管理器中的控制值或剩余额度。
|-
| 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;">GetFactionJoinTime(sceneId, selfId)</code> 返回玩家加入当前帮会时刻对应的 ANSI 时间。
|-
| 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;">GetGuildPos(sceneId, selfId)</code> 返回玩家当前帮会职位。
|-
| 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;">IsLocked(sceneId, selfId, lockType)</code> 查询玩家 64 位脚本锁中的指定标志。
|-
| 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;">Lock(sceneId, selfId, lockType, iValue)</code> 设置或清除玩家 64 位脚本锁中的指定标志。
|-
| 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;">LuaFnAddGuildCollectNum(sceneId, selfId, nValue)</code> 增加所属城市的帮会采集数量，实际修改由 WorldServer 完成。
|-
| 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;">LuaFnCityGetDefaultNameBySceneId(citySceneId)</code> 按城市场景编号返回配置表中的默认城市名称。
|-
| 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;">LuaFnCityGetNameBySceneId(citySceneId)</code> 按城市场景编号返回城市名称。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnClearGuildCollectNum|LuaFnClearGuildCollectNum]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnClearGuildCollectNum(arg1)</code> 请求 WorldServer 清空帮会采集数量。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | [[Lua接口/服务端/LuaFnSortGuildCollectNum|LuaFnSortGuildCollectNum]]
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">LuaFnSortGuildCollectNum(arg1)</code> 请求 WorldServer 对帮会采集数量进行排序。
|-
| 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;">OpenCityMissonMgr(sceneId, selfId)</code> 将所属城市的任务管理数据及版本发送给客户端。
|}
</div>

Lua接口/服务端函数索引/帮会城市 - 版本历史

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

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