Lua接口/服务端函数索引/帮会城市:修订间差异
来自天龙知识库
跳到导航跳到搜索
维护服务端 Lua 接口:核对参数、返回值、边界条件与调用示例 |
维护服务端 Lua 接口:核对参数、返回值、边界条件与调用示例 |
||
| (未显示同一用户的1个中间版本) | |||
| 第1行: | 第1行: | ||
__NOTOC__ | __NOTOC__ | ||
<div class="lua-reference | <div class="lua-reference"> | ||
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端调用约定|调用约定]] | [[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端调用约定|调用约定]] | ||
<div | <div class="lua-lead">帮会城市:38 个接口,38 个调用名称,其中 27 个在当前脚本中有调用。</div> | ||
{| class="wikitable | {| class="wikitable" | ||
! scope="col" | ! scope="col" class="lua-w36" | 函数 / 别名 | ||
! scope="col | ! scope="col" | 调用与用途 | ||
|- | |- | ||
| [[Lua接口/服务端/CanCitySetAttr|CanCitySetAttr]] | |||
| <code>CanCitySetAttr(sceneId, selfId, attrType)</code><br />判断工资次数属性当前是否允许发起异步修改。<br /><span class="lua-muted">脚本中 3 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/ChangeCityMissonValue|ChangeCityMissonValue]] | |||
| <code>ChangeCityMissonValue(sceneId, selfId, valueType, value)</code><br />请求 WorldServer 修改所属城市任务管理器的剩余额度。<br /><span class="lua-warn">脚本中未见调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/CheckPlayerCanApplyCity|CheckPlayerCanApplyCity]] | |||
| <code>CheckPlayerCanApplyCity(sceneId, selfId)</code><br />检查玩家是否满足申请城市的职位和资产条件。<br /><span class="lua-muted">脚本中 1 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/CityApply|CityApply]] | |||
| <code>CityApply(sceneId, selfId)</code><br />向 World 请求当前可申请的城市入口组及其序号。<br /><span class="lua-muted">脚本中 3 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/CityBeginLevelUpBuilding|CityBeginLevelUpBuilding]] | |||
| <code>CityBeginLevelUpBuilding(sceneId, selfId, citySceneId)</code><br />让指定城市进入建筑升级状态。<br /><span class="lua-warn">脚本中未见调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/CityBuildingChange|CityBuildingChange]] | |||
| <code>CityBuildingChange(sceneId, selfId, BuildingID, BuildingLevel)</code><br />当前不允许通过此接口直接修改城市建筑等级,只记录错误。<br /><span class="lua-muted">脚本中 25 处调用</span><br />'''不执行修改''' | |||
|- | |- | ||
| [[Lua接口/服务端/CityCancelLevelUpBuilding|CityCancelLevelUpBuilding]] | |||
| <code>CityCancelLevelUpBuilding(sceneId, selfId, citySceneId)</code><br />当前只查询城市对象,不执行取消建筑升级操作。<br /><span class="lua-warn">脚本中未见调用</span><br />'''无实际取消操作''' | |||
|- | |- | ||
| [[Lua接口/服务端/CityChangeAttr|CityChangeAttr]] | |||
| <code>CityChangeAttr(sceneId, selfId, attrType, attrChangedValue)</code><br />增减城市或帮会属性,帮贡修改返回 1、-1 或无返回值。<br /><span class="lua-muted">脚本中 43 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/CityCreate|CityCreate]] | |||
| <code>CityCreate(sceneId, selfId, citySceneId)</code><br />建立基于入口在本场景的城市<br /><span class="lua-warn">脚本中未见调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/CityDelete|CityDelete]] | |||
| <code>CityDelete(sceneId, selfId, citySceneId)</code><br />删除此城市<br /><span class="lua-muted">脚本中 1 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/CityExistByIndex|CityExistByIndex]] | |||
| <code>CityExistByIndex(sceneId, selfId, portSceneId, cityIndex)</code><br />判断入口场景指定序号的城市是否存在。<br /><span class="lua-warn">脚本中未见调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/CityGetAttr|CityGetAttr]] | |||
| <code>CityGetAttr(sceneId, selfId, attrType)</code><br />返回城市脚本属性。0-5 为六项帮会发展度,6 为个人帮贡,7 为帮会资金,<br /><span class="lua-muted">脚本中 27 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/CityGetBuildingLevel|CityGetBuildingLevel]] | |||
| <code>CityGetBuildingLevel(sceneId, selfId, citySceneId, buildingType)</code><br />返回指定城市建筑的当前等级。<br /><span class="lua-muted">脚本中 8 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/CityGetCityName|CityGetCityName]] | |||
| <code>CityGetCityName(sceneId, selfId, citySceneId)</code><br />根据城市场景编号返回当前入口场景缓存的城市名称。<br /><span class="lua-muted">脚本中 216 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/CityGetMaintainStatus|CityGetMaintainStatus]] | |||
| <code>CityGetMaintainStatus(sceneId, selfId, citySceneId)</code><br />返回指定城市当前维护状态。<br /><span class="lua-muted">脚本中 6 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/CityGetNameByIndex|CityGetNameByIndex]] | |||
| <code>CityGetNameByIndex(sceneId, selfId, portSceneId, cityIndex)</code><br />返回入口场景指定序号的城市占位名称。<br /><span class="lua-warn">脚本中未见调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/CityGetProgress|CityGetProgress]] | |||
| <code>CityGetProgress(sceneId, selfId, citySceneId, progressType)</code><br />返回指定城市对应类型的当前建设进度。<br /><span class="lua-warn">脚本中未见调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/CityGetSelfCityID|CityGetSelfCityID]] | |||
| <code>CityGetSelfCityID(sceneId, selfId)</code><br />返回玩家所属城市场景编号。<br /><span class="lua-muted">脚本中 10 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/CityInBuildingLevelUp|CityInBuildingLevelUp]] | |||
| <code>CityInBuildingLevelUp(sceneId, selfId, citySceneId)</code><br />判断指定城市是否正在升级建筑。<br /><span class="lua-muted">脚本中 1 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/CityInBuildingResearch|CityInBuildingResearch]] | |||
| <code>CityInBuildingResearch(sceneId, selfId, citySceneId)</code><br />判断指定城市是否正在研究建筑技术。<br /><span class="lua-muted">脚本中 1 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/CityIncProgress|CityIncProgress]] | |||
| <code>CityIncProgress(sceneId, selfId, citySceneId, progressType)</code><br />通知 World 将指定城市进度增加一次。<br /><span class="lua-muted">脚本中 4 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/CityMoveTo|CityMoveTo]] | |||
| <code>CityMoveTo(sceneId, selfId)</code><br />更改城市中建筑属性<br /><span class="lua-muted">脚本中 2 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/CityMoveToPort|CityMoveToPort]] | |||
| <code>CityMoveToPort(sceneId, selfId)</code><br />将玩家传送到当前城市场景对应的入口。<br /><span class="lua-muted">脚本中 1 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/CityMoveToScene|CityMoveToScene]] | |||
| <code>CityMoveToScene(sceneId, selfId, targetSceneId, posX, posZ)</code><br />请求 World 将玩家传送到指定城市场景坐标。<br /><span class="lua-muted">脚本中 216 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/CitySetAttr|CitySetAttr]] | |||
| <code>CitySetAttr(sceneId, selfId, attrType, attrValue)</code><br />设置城市或帮会属性,实际修改由 WorldServer 完成。<br /><span class="lua-muted">脚本中 3 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/CitySetLevel|CitySetLevel]] | |||
| <code>CitySetLevel(sceneId, selfId, citySceneId, arg4)</code><br />当前不允许通过此接口直接修改城市等级,只记录错误。<br /><span class="lua-muted">脚本中 5 处调用</span><br />'''不执行修改''' | |||
|- | |- | ||
| [[Lua接口/服务端/CitySuccessLevelUpBuilding|CitySuccessLevelUpBuilding]] | |||
| <code>CitySuccessLevelUpBuilding(sceneId, selfId, citySceneId, buildingIndex, buildingLevel)</code><br />通知 World 指定城市建筑升级成功。<br /><span class="lua-warn">脚本中未见调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetCityMissonValue|GetCityMissonValue]] | |||
| <code>GetCityMissonValue(sceneId, selfId, missType, valueType)</code><br />读取所属城市任务管理器中的控制值或剩余额度。<br /><span class="lua-warn">脚本中未见调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetFactionJoinTime|GetFactionJoinTime]] | |||
| <code>GetFactionJoinTime(sceneId, selfId)</code><br />返回玩家加入当前帮会时刻对应的 ANSI 时间。<br /><span class="lua-muted">脚本中 1 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetGuildPos|GetGuildPos]] | |||
| <code>GetGuildPos(sceneId, selfId)</code><br />返回玩家当前帮会职位。<br /><span class="lua-muted">脚本中 12 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/IsLocked|IsLocked]] | |||
| <code>IsLocked(sceneId, selfId, lockType)</code><br />查询玩家 64 位脚本锁中的指定标志。<br /><span class="lua-muted">脚本中 2 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/Lock|Lock]] | |||
| <code>Lock(sceneId, selfId, lockType, iValue)</code><br />设置或清除玩家 64 位脚本锁中的指定标志。<br /><span class="lua-warn">脚本中未见调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/LuaFnAddGuildCollectNum|LuaFnAddGuildCollectNum]] | |||
| <code>LuaFnAddGuildCollectNum(sceneId, selfId, nValue)</code><br />增加所属城市的帮会采集数量,实际修改由 WorldServer 完成。<br /><span class="lua-muted">脚本中 1 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/LuaFnCityGetDefaultNameBySceneId|LuaFnCityGetDefaultNameBySceneId]] | |||
| <code>LuaFnCityGetDefaultNameBySceneId(citySceneId)</code><br />按城市场景编号返回配置表中的默认城市名称。<br /><span class="lua-muted">脚本中 1 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/LuaFnCityGetNameBySceneId|LuaFnCityGetNameBySceneId]] | |||
| <code>LuaFnCityGetNameBySceneId(citySceneId)</code><br />按城市场景编号返回城市名称。<br /><span class="lua-muted">脚本中 4 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/LuaFnClearGuildCollectNum|LuaFnClearGuildCollectNum]] | |||
| <code>LuaFnClearGuildCollectNum(arg1)</code><br />请求 WorldServer 清空帮会采集数量。<br /><span class="lua-muted">脚本中 1 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/LuaFnSortGuildCollectNum|LuaFnSortGuildCollectNum]] | |||
| <code>LuaFnSortGuildCollectNum(arg1)</code><br />请求 WorldServer 对帮会采集数量进行排序。<br /><span class="lua-muted">脚本中 1 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/OpenCityMissonMgr|OpenCityMissonMgr]] | |||
| <code>OpenCityMissonMgr(sceneId, selfId)</code><br />将所属城市的任务管理数据及版本发送给客户端。<br /><span class="lua-warn">脚本中未见调用</span> | |||
|} | |} | ||
</div> | </div> | ||
2026年9月19日 (六) 23:59的最新版本
帮会城市:38 个接口,38 个调用名称,其中 27 个在当前脚本中有调用。
| 函数 / 别名 | 调用与用途 |
|---|---|
| CanCitySetAttr | CanCitySetAttr(sceneId, selfId, attrType)判断工资次数属性当前是否允许发起异步修改。 脚本中 3 处调用 |
| ChangeCityMissonValue | ChangeCityMissonValue(sceneId, selfId, valueType, value)请求 WorldServer 修改所属城市任务管理器的剩余额度。 脚本中未见调用 |
| CheckPlayerCanApplyCity | CheckPlayerCanApplyCity(sceneId, selfId)检查玩家是否满足申请城市的职位和资产条件。 脚本中 1 处调用 |
| CityApply | CityApply(sceneId, selfId)向 World 请求当前可申请的城市入口组及其序号。 脚本中 3 处调用 |
| CityBeginLevelUpBuilding | CityBeginLevelUpBuilding(sceneId, selfId, citySceneId)让指定城市进入建筑升级状态。 脚本中未见调用 |
| CityBuildingChange | CityBuildingChange(sceneId, selfId, BuildingID, BuildingLevel)当前不允许通过此接口直接修改城市建筑等级,只记录错误。 脚本中 25 处调用 不执行修改 |
| CityCancelLevelUpBuilding | CityCancelLevelUpBuilding(sceneId, selfId, citySceneId)当前只查询城市对象,不执行取消建筑升级操作。 脚本中未见调用 无实际取消操作 |
| CityChangeAttr | CityChangeAttr(sceneId, selfId, attrType, attrChangedValue)增减城市或帮会属性,帮贡修改返回 1、-1 或无返回值。 脚本中 43 处调用 |
| CityCreate | CityCreate(sceneId, selfId, citySceneId)建立基于入口在本场景的城市 脚本中未见调用 |
| CityDelete | CityDelete(sceneId, selfId, citySceneId)删除此城市 脚本中 1 处调用 |
| CityExistByIndex | CityExistByIndex(sceneId, selfId, portSceneId, cityIndex)判断入口场景指定序号的城市是否存在。 脚本中未见调用 |
| CityGetAttr | CityGetAttr(sceneId, selfId, attrType)返回城市脚本属性。0-5 为六项帮会发展度,6 为个人帮贡,7 为帮会资金, 脚本中 27 处调用 |
| CityGetBuildingLevel | CityGetBuildingLevel(sceneId, selfId, citySceneId, buildingType)返回指定城市建筑的当前等级。 脚本中 8 处调用 |
| CityGetCityName | CityGetCityName(sceneId, selfId, citySceneId)根据城市场景编号返回当前入口场景缓存的城市名称。 脚本中 216 处调用 |
| CityGetMaintainStatus | CityGetMaintainStatus(sceneId, selfId, citySceneId)返回指定城市当前维护状态。 脚本中 6 处调用 |
| CityGetNameByIndex | CityGetNameByIndex(sceneId, selfId, portSceneId, cityIndex)返回入口场景指定序号的城市占位名称。 脚本中未见调用 |
| CityGetProgress | CityGetProgress(sceneId, selfId, citySceneId, progressType)返回指定城市对应类型的当前建设进度。 脚本中未见调用 |
| CityGetSelfCityID | CityGetSelfCityID(sceneId, selfId)返回玩家所属城市场景编号。 脚本中 10 处调用 |
| CityInBuildingLevelUp | CityInBuildingLevelUp(sceneId, selfId, citySceneId)判断指定城市是否正在升级建筑。 脚本中 1 处调用 |
| CityInBuildingResearch | CityInBuildingResearch(sceneId, selfId, citySceneId)判断指定城市是否正在研究建筑技术。 脚本中 1 处调用 |
| CityIncProgress | CityIncProgress(sceneId, selfId, citySceneId, progressType)通知 World 将指定城市进度增加一次。 脚本中 4 处调用 |
| CityMoveTo | CityMoveTo(sceneId, selfId)更改城市中建筑属性 脚本中 2 处调用 |
| CityMoveToPort | CityMoveToPort(sceneId, selfId)将玩家传送到当前城市场景对应的入口。 脚本中 1 处调用 |
| CityMoveToScene | CityMoveToScene(sceneId, selfId, targetSceneId, posX, posZ)请求 World 将玩家传送到指定城市场景坐标。 脚本中 216 处调用 |
| CitySetAttr | CitySetAttr(sceneId, selfId, attrType, attrValue)设置城市或帮会属性,实际修改由 WorldServer 完成。 脚本中 3 处调用 |
| CitySetLevel | CitySetLevel(sceneId, selfId, citySceneId, arg4)当前不允许通过此接口直接修改城市等级,只记录错误。 脚本中 5 处调用 不执行修改 |
| CitySuccessLevelUpBuilding | CitySuccessLevelUpBuilding(sceneId, selfId, citySceneId, buildingIndex, buildingLevel)通知 World 指定城市建筑升级成功。 脚本中未见调用 |
| GetCityMissonValue | GetCityMissonValue(sceneId, selfId, missType, valueType)读取所属城市任务管理器中的控制值或剩余额度。 脚本中未见调用 |
| GetFactionJoinTime | GetFactionJoinTime(sceneId, selfId)返回玩家加入当前帮会时刻对应的 ANSI 时间。 脚本中 1 处调用 |
| GetGuildPos | GetGuildPos(sceneId, selfId)返回玩家当前帮会职位。 脚本中 12 处调用 |
| IsLocked | IsLocked(sceneId, selfId, lockType)查询玩家 64 位脚本锁中的指定标志。 脚本中 2 处调用 |
| Lock | Lock(sceneId, selfId, lockType, iValue)设置或清除玩家 64 位脚本锁中的指定标志。 脚本中未见调用 |
| LuaFnAddGuildCollectNum | LuaFnAddGuildCollectNum(sceneId, selfId, nValue)增加所属城市的帮会采集数量,实际修改由 WorldServer 完成。 脚本中 1 处调用 |
| LuaFnCityGetDefaultNameBySceneId | LuaFnCityGetDefaultNameBySceneId(citySceneId)按城市场景编号返回配置表中的默认城市名称。 脚本中 1 处调用 |
| LuaFnCityGetNameBySceneId | LuaFnCityGetNameBySceneId(citySceneId)按城市场景编号返回城市名称。 脚本中 4 处调用 |
| LuaFnClearGuildCollectNum | LuaFnClearGuildCollectNum(arg1)请求 WorldServer 清空帮会采集数量。 脚本中 1 处调用 |
| LuaFnSortGuildCollectNum | LuaFnSortGuildCollectNum(arg1)请求 WorldServer 对帮会采集数量进行排序。 脚本中 1 处调用 |
| OpenCityMissonMgr | OpenCityMissonMgr(sceneId, selfId)将所属城市的任务管理数据及版本发送给客户端。 脚本中未见调用 |