Lua接口/服务端函数索引/任务与对话:修订间差异
来自天龙知识库
跳到导航跳到搜索
维护服务端 Lua 接口:核对参数、返回值、边界条件与调用示例 |
维护服务端 Lua 接口:核对参数、返回值、边界条件与调用示例 |
||
| 第1行: | 第1行: | ||
__NOTOC__ | __NOTOC__ | ||
<div class="lua-reference | <div class="lua-reference"> | ||
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端调用约定|调用约定]] | [[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端调用约定|调用约定]] | ||
<div | <div class="lua-lead">任务与对话:92 个接口,98 个调用名称,其中 82 个在当前脚本中有调用。</div> | ||
{| class="wikitable | {| class="wikitable" | ||
! scope="col" | ! scope="col" class="lua-w36" | 函数 / 别名 | ||
! scope="col | ! scope="col" | 调用与用途 | ||
|- | |- | ||
| [[Lua接口/服务端/AddItem|AddItem]]<br /><small>[[Lua接口/服务端/LuaFnAddItem|LuaFnAddItem]]</small> | |||
| <code>AddItem(sceneId, itemTypeSn, count)</code><br />将指定种类和数量的物品加入待发列表;本次调用不会直接把物品放入玩家背包。<br /><span class="lua-muted">脚本中 318 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/AddItemBonus|AddItemBonus]] | |||
| <code>AddItemBonus(sceneId, itemTypeSn, count)</code><br />添加count个编号为itemType道具<br /><span class="lua-muted">脚本中 68 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/AddItemDemand|AddItemDemand]] | |||
| <code>AddItemDemand(sceneId, itemTypeSn, count)</code><br />需求count个编号为itemType道具<br /><span class="lua-muted">脚本中 8 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/AddItemListToHuman|AddItemListToHuman]]<br /><small>[[Lua接口/服务端/LuaFnAddItemListToHuman|LuaFnAddItemListToHuman]]</small> | |||
| <code>AddItemListToHuman(sceneId, selfId)</code><br />把当前待发列表中的物品实际发给玩家;需先构造列表并检查可接收状态。<br /><span class="lua-muted">脚本中 227 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/AddItemWithQuality|AddItemWithQuality]] | |||
| <code>AddItemWithQuality(sceneId, itemSerial, count, reason)</code><br />将物品种类、数量和生成原因加入待发列表;本次调用不会直接发放物品。<br /><span class="lua-warn">脚本中未见调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/AddMission|AddMission]] | |||
| <code>AddMission(sceneId, selfId, misId, scriptId, killObjEvent, enterAreaEvent, itemChangedEvent)</code><br />在玩家身上添加misId编号的任务<br /><span class="lua-muted">脚本中 334 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/AddMissionEx|AddMissionEx]] | |||
| <code>AddMissionEx(sceneId, selfId, misId, scriptId)</code><br />在玩家身上添加misId编号的任务<br /><span class="lua-muted">脚本中 1 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/AddMoneyBonus|AddMoneyBonus]] | |||
| <code>AddMoneyBonus(sceneId, count)</code><br />添加Money<br /><span class="lua-muted">脚本中 302 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/AddMonsterDropItem|AddMonsterDropItem]] | |||
| <code>AddMonsterDropItem(sceneId, MonsterID, HumanID, ItemIndex)</code><br />在怪物身上添加一个掉落任务物品,并表明所有者<br /><span class="lua-muted">脚本中 25 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/AddNumber|AddNumber]] | |||
| <code>AddNumber(sceneId, id)</code><br />添加数目提示<br /><span class="lua-warn">脚本中未见调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/AddNumText|AddNumText]]<br /><small>[[Lua接口/服务端/AddEventList|AddEventList]]</small> | |||
| <code>AddNumText(sceneId, id, msg, state, index, issueScript)</code><br />向当前对话中追加带编号的文字选项,可指定任务状态、业务索引和关联脚本。<br /><span class="lua-muted">脚本中 3070 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/AddRadioItemBonus|AddRadioItemBonus]] | |||
| <code>AddRadioItemBonus(sceneId, itemTypeSn, count)</code><br />添加多选一道具<br /><span class="lua-muted">脚本中 84 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/AddRandItemBonus|AddRandItemBonus]] | |||
| <code>AddRandItemBonus(sceneId)</code><br />提示奖励随机道具<br /><span class="lua-muted">脚本中 3 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/AddText|AddText]] | |||
| <code>AddText(sceneId, msg)</code><br />向当前对话中追加一段文字。<br /><span class="lua-muted">脚本中 8256 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/BeginAddItem|BeginAddItem]]<br /><small>[[Lua接口/服务端/LuaFnBeginAddItem|LuaFnBeginAddItem]]</small> | |||
| <code>BeginAddItem(sceneId)</code><br />清空当前场景的待发物品列表,开始构造一批奖励物品。<br /><span class="lua-muted">脚本中 291 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/BeginEvent|BeginEvent]] | |||
| <code>BeginEvent(sceneId)</code><br />清空当前场景的对话内容,开始构造一组新的 NPC 对话。<br /><span class="lua-muted">脚本中 6540 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/BeginUICommand|BeginUICommand]] | |||
| <code>BeginUICommand(sceneId)</code><br />开始构造UICommand数据体<br /><span class="lua-muted">脚本中 431 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/CheckItemAvailable|CheckItemAvailable]] | |||
| <code>CheckItemAvailable(arg1, arg2, nItemId)</code><br />查询任务配置表中是否存在指定物品。<br /><span class="lua-muted">脚本中 1 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/CheckNpcAvailable|CheckNpcAvailable]] | |||
| <code>CheckNpcAvailable(arg1, arg2, nNpcId)</code><br />查询任务配置表中是否存在指定 NPC。<br /><span class="lua-muted">脚本中 4 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/DelAllMission|DelAllMission]] | |||
| <code>DelAllMission(sceneId, selfId)</code><br />删除玩家当前任务列表中的全部任务。<br /><span class="lua-muted">脚本中 1 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/DelMission|DelMission]] | |||
| <code>DelMission(sceneId, selfId, misId)</code><br />删除任务<br /><span class="lua-muted">脚本中 646 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/DispatchEventList|DispatchEventList]] | |||
| <code>DispatchEventList(sceneId, selfId, targetId)</code><br />把当前场景中已构造的对话内容发送给指定玩家,并指定对话 NPC。<br /><span class="lua-muted">脚本中 3324 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/DispatchMissionContinueInfo|DispatchMissionContinueInfo]] | |||
| <code>DispatchMissionContinueInfo(sceneId, selfId, targetId, scriptId, misId, nIssueScript)</code><br />向客户端返回任务继续处理<br /><span class="lua-muted">脚本中 266 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/DispatchMissionDemandInfo|DispatchMissionDemandInfo]] | |||
| <code>DispatchMissionDemandInfo(sceneId, selfId, targetId, scriptId, misId, done, nIssueScript)</code><br />向客户端返回任务需求处理<br /><span class="lua-muted">脚本中 187 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/DispatchMissionInfo|DispatchMissionInfo]] | |||
| <code>DispatchMissionInfo(sceneId, selfId, targetId, scriptId, misId)</code><br />向客户端返回任务信息处理<br /><span class="lua-muted">脚本中 209 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/DispatchMissionResult|DispatchMissionResult]] | |||
| <code>DispatchMissionResult(sceneId, selfId, IsFinished)</code><br />向客户端返回任务验证结果<br /><span class="lua-warn">脚本中未见调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/DispatchMissionTips|DispatchMissionTips]] | |||
| <code>DispatchMissionTips(sceneId, selfId)</code><br />向客户端返回任务相关提示信息<br /><span class="lua-muted">脚本中 2585 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/DispatchRegieEventList|DispatchRegieEventList]] | |||
| <code>DispatchRegieEventList(sceneId, selfId, targetId)</code><br />向客户端返回该Npc可触发事件列表<br /><span class="lua-warn">脚本中未见调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/DispatchUICommand|DispatchUICommand]] | |||
| <code>DispatchUICommand(sceneId, selfId, nUIIndex)</code><br />结束构造UICommand数据体<br /><span class="lua-muted">脚本中 436 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/EndAddItem|EndAddItem]]<br /><small>[[Lua接口/服务端/LuaFnEndAddItem|LuaFnEndAddItem]]</small> | |||
| <code>EndAddItem(sceneId, selfId)</code><br />检查玩家能否接收当前待发物品列表;本次调用不会发放物品。<br /><span class="lua-muted">脚本中 255 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/EndEvent|EndEvent]] | |||
| <code>EndEvent()</code><br />结束对话构造的配对入口;当前不执行额外操作,仍需调用派发接口显示对话。<br /><span class="lua-muted">脚本中 6549 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/EndUICommand|EndUICommand]] | |||
| <code>EndUICommand(sceneId)</code><br />结束构造UICommand数据体<br /><span class="lua-muted">脚本中 431 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetExpBonusByLevel|GetExpBonusByLevel]] | |||
| <code>GetExpBonusByLevel(nLevel)</code><br />按等级查询师门任务经验奖励基础值。<br /><span class="lua-muted">脚本中 1 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetExpMultipleByRound|GetExpMultipleByRound]] | |||
| <code>GetExpMultipleByRound(nRound)</code><br />按师门任务轮次查询经验奖励倍率。<br /><span class="lua-muted">脚本中 2 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetHighWord|GetHighWord]] | |||
| <code>GetHighWord(data)</code><br />返回 32 位整数的高 16 位无符号值。<br /><span class="lua-muted">脚本中 6 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetItemInfoByItemId|GetItemInfoByItemId]] | |||
| <code>GetItemInfoByItemId(nItemId)</code><br />通过任务物品编号返回物品名称和任务描述。<br /><span class="lua-muted">脚本中 92 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetItemSnByDropRateOfItemTable|GetItemSnByDropRateOfItemTable]] | |||
| <code>GetItemSnByDropRateOfItemTable()</code><br />根据物品掉落权重表抽取物品,并返回名称和广播标志。<br /><span class="lua-muted">脚本中 1 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetItemTransfer|GetItemTransfer]] | |||
| <code>GetItemTransfer(sceneId, selfId, nListIndex)</code><br />返回当前场景玩家物品列表中指定索引的转移描述。<br /><span class="lua-muted">脚本中 68 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetLowWord|GetLowWord]] | |||
| <code>GetLowWord(data)</code><br />返回 32 位整数的低 16 位无符号值。<br /><span class="lua-muted">脚本中 6 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetMission|GetMission]] | |||
| <code>GetMission(sceneId, selfId, misId)</code><br />获得当前玩家某一任务号的值 //做过,正在做,未做<br /><span class="lua-warn">脚本中未见调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetMissionCacheData|GetMissionCacheData]] | |||
| <code>GetMissionCacheData(sceneId, selfId, nIndex)</code><br />读取当前玩家任务临时缓存中的一个整数。<br /><span class="lua-muted">脚本中 26 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetMissionCount|GetMissionCount]] | |||
| <code>GetMissionCount(sceneId, selfId)</code><br />得到已接任务的数量<br /><span class="lua-muted">脚本中 31 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetMissionData|GetMissionData]] | |||
| <code>GetMissionData(sceneId, selfId, nIndex)</code><br />读取角色任务数据的条目数值。<br /><span class="lua-muted">脚本中 499 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetMissionDataEx|GetMissionDataEx]] | |||
| <code>GetMissionDataEx(sceneId, selfId, nIndex)</code><br />读取角色任务数据的条目数值。<br /><span class="lua-warn">脚本中未见调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetMissionFlag|GetMissionFlag]] | |||
| <code>GetMissionFlag(sceneId, selfId, bitIndex)</code><br />读取角色任务数据的标志位数值。<br /><span class="lua-muted">脚本中 87 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetMissionFlagEx|GetMissionFlagEx]] | |||
| <code>GetMissionFlagEx(sceneId, selfId, bitIndex)</code><br />读取角色任务数据的标志位数值。<br /><span class="lua-warn">脚本中未见调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetMissionGroupCount|GetMissionGroupCount]] | |||
| <code>GetMissionGroupCount(sceneId, nMissionIndex)</code><br />读取指定任务物品配置中的分组数。<br /><span class="lua-muted">脚本中 1 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetMissionGroupItemID|GetMissionGroupItemID]] | |||
| <code>GetMissionGroupItemID(sceneId, nMissionIndex, nGroupIndex, nGroupItemIndex)</code><br />读取任务物品分组中指定位置的物品编号。<br /><span class="lua-muted">脚本中 4 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetMissionIndexByID|GetMissionIndexByID]] | |||
| <code>GetMissionIndexByID(sceneId, selfId, misId)</code><br />设置当前玩家某一任务号的值<br /><span class="lua-muted">脚本中 1208 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetMissionItemCount|GetMissionItemCount]] | |||
| <code>GetMissionItemCount(sceneId, nMissionIndex, nGroupIndex)</code><br />统计任务物品配置中指定分组的条目数量。<br /><span class="lua-muted">脚本中 1 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetMissionParam|GetMissionParam]] | |||
| <code>GetMissionParam(sceneId, selfId, misIndex, paramIndex)</code><br />取任务参数<br /><span class="lua-muted">脚本中 1197 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetMissionParamEx|GetMissionParamEx]] | |||
| <code>GetMissionParamEx(sceneId, selfId, missionIndex, paramIndex, byteIndex)</code><br />返回任务参数中指定的字节。<br /><span class="lua-muted">脚本中 20 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetMoneyBonusByLevel|GetMoneyBonusByLevel]] | |||
| <code>GetMoneyBonusByLevel(nLevel)</code><br />按等级查询师门任务金钱奖励基础值。<br /><span class="lua-muted">脚本中 1 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetMoneyMultipleByRound|GetMoneyMultipleByRound]] | |||
| <code>GetMoneyMultipleByRound(nRound)</code><br />按师门任务轮次查询金钱奖励倍率。<br /><span class="lua-muted">脚本中 2 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetMonsterOwnerCount|GetMonsterOwnerCount]] | |||
| <code>GetMonsterOwnerCount(sceneId, MonsterID)</code><br />获取怪物所有者数量<br /><span class="lua-muted">脚本中 56 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetMonsterOwnerID|GetMonsterOwnerID]] | |||
| <code>GetMonsterOwnerID(sceneId, MonsterID, OwnerOffSet)</code><br />获取怪物所有者编号<br /><span class="lua-muted">脚本中 56 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetNpcInfoByNpcId|GetNpcInfoByNpcId]] | |||
| <code>GetNpcInfoByNpcId(sceneId, nNpcId)</code><br />通过任务 NPC 编号返回完整的任务 NPC 配置。<br /><span class="lua-muted">脚本中 60 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetNumText|GetNumText]]<br /><small>[[Lua接口/服务端/GetEventList|GetEventList]]</small> | |||
| <code>GetNumText(number)</code><br />取出脚本交换用数据<br /><span class="lua-muted">脚本中 1417 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetOneMissionBonusItem|GetOneMissionBonusItem]] | |||
| <code>GetOneMissionBonusItem(nMissionIndex)</code><br />从任务配置中取得一个奖励物品,返回物品编号、名称、说明和广播类型。<br /><span class="lua-muted">脚本中 15 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetOneMissionItem|GetOneMissionItem]] | |||
| <code>GetOneMissionItem(nMissionIndex)</code><br />从任务配置中取得一个任务物品,返回物品编号、名称、说明和广播类型。<br /><span class="lua-muted">脚本中 26 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetOneMissionNpc|GetOneMissionNpc]] | |||
| <code>GetOneMissionNpc(nMissionIndex)</code><br />从任务配置中取得一个 NPC,返回编号、名称、场景、坐标等信息。<br /><span class="lua-muted">脚本中 38 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetOneMissionPet|GetOneMissionPet]] | |||
| <code>GetOneMissionPet(nMissionIndex)</code><br />从任务配置中取得一个珍兽,返回编号、名称和说明。<br /><span class="lua-muted">脚本中 10 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetQuestionsRecord|GetQuestionsRecord]] | |||
| <code>GetQuestionsRecord(nIndex)</code><br />读取题库信息<br /><span class="lua-muted">脚本中 14 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetRandomQuestionsIndex|GetRandomQuestionsIndex]] | |||
| <code>GetRandomQuestionsIndex(nType)</code><br />从指定类型的题库中随机选择题目编号。<br /><span class="lua-muted">脚本中 12 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetRenwulianMissionBonusItemByLevel|GetRenwulianMissionBonusItemByLevel]] | |||
| <code>GetRenwulianMissionBonusItemByLevel(nMissionIndex, nPlayerLevel)</code><br />按玩家等级段从任务链奖励配置中选取材料类奖励物品。<br /><span class="lua-muted">脚本中 1 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/GetScriptIDByMissionID|GetScriptIDByMissionID]] | |||
| <code>GetScriptIDByMissionID(sceneId, selfId, missionId)</code><br />返回玩家指定任务绑定的脚本编号。<br /><span class="lua-muted">脚本中 23 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/IsHaveMission|IsHaveMission]] | |||
| <code>IsHaveMission(sceneId, selfId, misId)</code><br />玩家是否正在做此任务<br /><span class="lua-muted">脚本中 1409 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/IsMissionFull|IsMissionFull]] | |||
| <code>IsMissionFull(sceneId, selfId)</code><br />返回当前任务列表是否已满。<br /><span class="lua-muted">脚本中 43 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/IsMissionHaveDone|IsMissionHaveDone]] | |||
| <code>IsMissionHaveDone(sceneId, selfId, misId)</code><br />是否做过此任务<br /><span class="lua-muted">脚本中 463 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/LuaFnAddItemListToHumanIgnoreFatigueState|LuaFnAddItemListToHumanIgnoreFatigueState]] | |||
| <code>LuaFnAddItemListToHumanIgnoreFatigueState(sceneId, selfId)</code><br />将奖励物品列表直接放入玩家背包,不触发疲劳消耗。<br /><span class="lua-muted">脚本中 38 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/LuaFnEndAddItemIgnoreFatigueState|LuaFnEndAddItemIgnoreFatigueState]] | |||
| <code>LuaFnEndAddItemIgnoreFatigueState(sceneId, selfId)</code><br />结束忽略疲劳的奖励物品列表操作,并返回背包是否有空间。<br /><span class="lua-muted">脚本中 38 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/LuaFnGetHumanShimenRandom|LuaFnGetHumanShimenRandom]] | |||
| <code>LuaFnGetHumanShimenRandom(sceneId, selfId)</code><br />返回玩家门派任务脚本使用的随机数。<br /><span class="lua-muted">脚本中 9 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/LuaFnGetLevelMatchingMonster|LuaFnGetLevelMatchingMonster]] | |||
| <code>LuaFnGetLevelMatchingMonster(nMissionIndex, nLevel)</code><br />返回与指定等级相差不超过 1 级的随机任务怪物信息。<br /><span class="lua-muted">脚本中 5 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/LuaFnSetNumText|LuaFnSetNumText]] | |||
| <code>LuaFnSetNumText(value)</code><br />设置脚本之间交换使用的 global_numtext 值。<br /><span class="lua-warn">脚本中未见调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/MissionCom|MissionCom]] | |||
| <code>MissionCom(sceneId, selfId, misId)</code><br />任务完成<br /><span class="lua-muted">脚本中 158 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/MissionLog|MissionLog]] | |||
| <code>MissionLog(sceneId, msg)</code><br />将任务脚本文本直接写入 Mission 日志文件。<br /><span class="lua-muted">脚本中 95 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/ResetMissionCacheData|ResetMissionCacheData]] | |||
| <code>ResetMissionCacheData(sceneId, selfId)</code><br />清空当前玩家的任务临时缓存。<br /><span class="lua-muted">脚本中 2 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/ResetMissionEvent|ResetMissionEvent]] | |||
| <code>ResetMissionEvent(sceneId, selfId, missionId, eventId)</code><br />清除指定任务事件标志。<br /><span class="lua-muted">脚本中 120 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/SetHighWord|SetHighWord]] | |||
| <code>SetHighWord(data, highWord)</code><br />替换 32 位整数的高 16 位并返回合成结果。<br /><span class="lua-muted">脚本中 7 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/SetLowWord|SetLowWord]] | |||
| <code>SetLowWord(data, lowWord)</code><br />替换 32 位整数的低 16 位并返回合成结果。<br /><span class="lua-muted">脚本中 7 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/SetMissionByIndex|SetMissionByIndex]] | |||
| <code>SetMissionByIndex(sceneId, selfId, misIndex, paramIndex, value)</code><br />设置任务参数<br /><span class="lua-muted">脚本中 1764 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/SetMissionCacheData|SetMissionCacheData]] | |||
| <code>SetMissionCacheData(sceneId, selfId, nIndex, nData)</code><br />设置当前玩家任务临时缓存中的一个整数。<br /><span class="lua-muted">脚本中 7 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/SetMissionData|SetMissionData]] | |||
| <code>SetMissionData(sceneId, selfId, nIndex, value)</code><br />写入角色任务数据的条目数值。<br /><span class="lua-muted">脚本中 425 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/SetMissionDataEx|SetMissionDataEx]] | |||
| <code>SetMissionDataEx(sceneId, selfId, nIndex, value)</code><br />写入角色任务数据的条目数值。<br /><span class="lua-warn">脚本中未见调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/SetMissionEvent|SetMissionEvent]] | |||
| <code>SetMissionEvent(sceneId, selfId, misId, eventId)</code><br />修改玩家身上misId编号的任务相应事件<br /><span class="lua-muted">脚本中 89 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/SetMissionFlag|SetMissionFlag]] | |||
| <code>SetMissionFlag(sceneId, selfId, bitIndex, value)</code><br />写入角色任务数据的标志位数值。<br /><span class="lua-muted">脚本中 100 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/SetMissionFlagEx|SetMissionFlagEx]] | |||
| <code>SetMissionFlagEx(sceneId, selfId, bitIndex, value)</code><br />写入角色任务数据的标志位数值。<br /><span class="lua-warn">脚本中未见调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/SetMissionParamByIndexEx|SetMissionParamByIndexEx]] | |||
| <code>SetMissionParamByIndexEx(sceneId, selfId, missionIndex, paramIndex, byteIndex, value)</code><br />修改任务参数中指定的字节。<br /><span class="lua-muted">脚本中 31 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/StartMissionTimer|StartMissionTimer]] | |||
| <code>StartMissionTimer(sceneId, selfId, missionId)</code><br />开启任务定时器事件标志。<br /><span class="lua-muted">脚本中 9 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/StopMissionTimer|StopMissionTimer]] | |||
| <code>StopMissionTimer(sceneId, selfId, missionId)</code><br />关闭任务定时器事件标志。<br /><span class="lua-muted">脚本中 17 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/UICommand_AddInt|UICommand_AddInt]] | |||
| <code>UICommand_AddInt(sceneId, nValue)</code><br />结束构造UICommand数据体<br /><span class="lua-muted">脚本中 580 处调用</span> | |||
|- | |- | ||
| [[Lua接口/服务端/UICommand_AddString|UICommand_AddString]] | |||
| <code>UICommand_AddString(sceneId, szValue)</code><br />结束构造UICommand数据体<br /><span class="lua-muted">脚本中 192 处调用</span> | |||
|} | |} | ||
</div> | </div> | ||
2026年9月19日 (六) 16:59的版本
任务与对话:92 个接口,98 个调用名称,其中 82 个在当前脚本中有调用。
| 函数 / 别名 | 调用与用途 |
|---|---|
| AddItem LuaFnAddItem |
AddItem(sceneId, itemTypeSn, count)将指定种类和数量的物品加入待发列表;本次调用不会直接把物品放入玩家背包。 脚本中 318 处调用 |
| AddItemBonus | AddItemBonus(sceneId, itemTypeSn, count)添加count个编号为itemType道具 脚本中 68 处调用 |
| AddItemDemand | AddItemDemand(sceneId, itemTypeSn, count)需求count个编号为itemType道具 脚本中 8 处调用 |
| AddItemListToHuman LuaFnAddItemListToHuman |
AddItemListToHuman(sceneId, selfId)把当前待发列表中的物品实际发给玩家;需先构造列表并检查可接收状态。 脚本中 227 处调用 |
| AddItemWithQuality | AddItemWithQuality(sceneId, itemSerial, count, reason)将物品种类、数量和生成原因加入待发列表;本次调用不会直接发放物品。 脚本中未见调用 |
| AddMission | AddMission(sceneId, selfId, misId, scriptId, killObjEvent, enterAreaEvent, itemChangedEvent)在玩家身上添加misId编号的任务 脚本中 334 处调用 |
| AddMissionEx | AddMissionEx(sceneId, selfId, misId, scriptId)在玩家身上添加misId编号的任务 脚本中 1 处调用 |
| AddMoneyBonus | AddMoneyBonus(sceneId, count)添加Money 脚本中 302 处调用 |
| AddMonsterDropItem | AddMonsterDropItem(sceneId, MonsterID, HumanID, ItemIndex)在怪物身上添加一个掉落任务物品,并表明所有者 脚本中 25 处调用 |
| AddNumber | AddNumber(sceneId, id)添加数目提示 脚本中未见调用 |
| AddNumText AddEventList |
AddNumText(sceneId, id, msg, state, index, issueScript)向当前对话中追加带编号的文字选项,可指定任务状态、业务索引和关联脚本。 脚本中 3070 处调用 |
| AddRadioItemBonus | AddRadioItemBonus(sceneId, itemTypeSn, count)添加多选一道具 脚本中 84 处调用 |
| AddRandItemBonus | AddRandItemBonus(sceneId)提示奖励随机道具 脚本中 3 处调用 |
| AddText | AddText(sceneId, msg)向当前对话中追加一段文字。 脚本中 8256 处调用 |
| BeginAddItem LuaFnBeginAddItem |
BeginAddItem(sceneId)清空当前场景的待发物品列表,开始构造一批奖励物品。 脚本中 291 处调用 |
| BeginEvent | BeginEvent(sceneId)清空当前场景的对话内容,开始构造一组新的 NPC 对话。 脚本中 6540 处调用 |
| BeginUICommand | BeginUICommand(sceneId)开始构造UICommand数据体 脚本中 431 处调用 |
| CheckItemAvailable | CheckItemAvailable(arg1, arg2, nItemId)查询任务配置表中是否存在指定物品。 脚本中 1 处调用 |
| CheckNpcAvailable | CheckNpcAvailable(arg1, arg2, nNpcId)查询任务配置表中是否存在指定 NPC。 脚本中 4 处调用 |
| DelAllMission | DelAllMission(sceneId, selfId)删除玩家当前任务列表中的全部任务。 脚本中 1 处调用 |
| DelMission | DelMission(sceneId, selfId, misId)删除任务 脚本中 646 处调用 |
| DispatchEventList | DispatchEventList(sceneId, selfId, targetId)把当前场景中已构造的对话内容发送给指定玩家,并指定对话 NPC。 脚本中 3324 处调用 |
| DispatchMissionContinueInfo | DispatchMissionContinueInfo(sceneId, selfId, targetId, scriptId, misId, nIssueScript)向客户端返回任务继续处理 脚本中 266 处调用 |
| DispatchMissionDemandInfo | DispatchMissionDemandInfo(sceneId, selfId, targetId, scriptId, misId, done, nIssueScript)向客户端返回任务需求处理 脚本中 187 处调用 |
| DispatchMissionInfo | DispatchMissionInfo(sceneId, selfId, targetId, scriptId, misId)向客户端返回任务信息处理 脚本中 209 处调用 |
| DispatchMissionResult | DispatchMissionResult(sceneId, selfId, IsFinished)向客户端返回任务验证结果 脚本中未见调用 |
| DispatchMissionTips | DispatchMissionTips(sceneId, selfId)向客户端返回任务相关提示信息 脚本中 2585 处调用 |
| DispatchRegieEventList | DispatchRegieEventList(sceneId, selfId, targetId)向客户端返回该Npc可触发事件列表 脚本中未见调用 |
| DispatchUICommand | DispatchUICommand(sceneId, selfId, nUIIndex)结束构造UICommand数据体 脚本中 436 处调用 |
| EndAddItem LuaFnEndAddItem |
EndAddItem(sceneId, selfId)检查玩家能否接收当前待发物品列表;本次调用不会发放物品。 脚本中 255 处调用 |
| EndEvent | EndEvent()结束对话构造的配对入口;当前不执行额外操作,仍需调用派发接口显示对话。 脚本中 6549 处调用 |
| EndUICommand | EndUICommand(sceneId)结束构造UICommand数据体 脚本中 431 处调用 |
| GetExpBonusByLevel | GetExpBonusByLevel(nLevel)按等级查询师门任务经验奖励基础值。 脚本中 1 处调用 |
| GetExpMultipleByRound | GetExpMultipleByRound(nRound)按师门任务轮次查询经验奖励倍率。 脚本中 2 处调用 |
| GetHighWord | GetHighWord(data)返回 32 位整数的高 16 位无符号值。 脚本中 6 处调用 |
| GetItemInfoByItemId | GetItemInfoByItemId(nItemId)通过任务物品编号返回物品名称和任务描述。 脚本中 92 处调用 |
| GetItemSnByDropRateOfItemTable | GetItemSnByDropRateOfItemTable()根据物品掉落权重表抽取物品,并返回名称和广播标志。 脚本中 1 处调用 |
| GetItemTransfer | GetItemTransfer(sceneId, selfId, nListIndex)返回当前场景玩家物品列表中指定索引的转移描述。 脚本中 68 处调用 |
| GetLowWord | GetLowWord(data)返回 32 位整数的低 16 位无符号值。 脚本中 6 处调用 |
| GetMission | GetMission(sceneId, selfId, misId)获得当前玩家某一任务号的值 //做过,正在做,未做 脚本中未见调用 |
| GetMissionCacheData | GetMissionCacheData(sceneId, selfId, nIndex)读取当前玩家任务临时缓存中的一个整数。 脚本中 26 处调用 |
| GetMissionCount | GetMissionCount(sceneId, selfId)得到已接任务的数量 脚本中 31 处调用 |
| GetMissionData | GetMissionData(sceneId, selfId, nIndex)读取角色任务数据的条目数值。 脚本中 499 处调用 |
| GetMissionDataEx | GetMissionDataEx(sceneId, selfId, nIndex)读取角色任务数据的条目数值。 脚本中未见调用 |
| GetMissionFlag | GetMissionFlag(sceneId, selfId, bitIndex)读取角色任务数据的标志位数值。 脚本中 87 处调用 |
| GetMissionFlagEx | GetMissionFlagEx(sceneId, selfId, bitIndex)读取角色任务数据的标志位数值。 脚本中未见调用 |
| GetMissionGroupCount | GetMissionGroupCount(sceneId, nMissionIndex)读取指定任务物品配置中的分组数。 脚本中 1 处调用 |
| GetMissionGroupItemID | GetMissionGroupItemID(sceneId, nMissionIndex, nGroupIndex, nGroupItemIndex)读取任务物品分组中指定位置的物品编号。 脚本中 4 处调用 |
| GetMissionIndexByID | GetMissionIndexByID(sceneId, selfId, misId)设置当前玩家某一任务号的值 脚本中 1208 处调用 |
| GetMissionItemCount | GetMissionItemCount(sceneId, nMissionIndex, nGroupIndex)统计任务物品配置中指定分组的条目数量。 脚本中 1 处调用 |
| GetMissionParam | GetMissionParam(sceneId, selfId, misIndex, paramIndex)取任务参数 脚本中 1197 处调用 |
| GetMissionParamEx | GetMissionParamEx(sceneId, selfId, missionIndex, paramIndex, byteIndex)返回任务参数中指定的字节。 脚本中 20 处调用 |
| GetMoneyBonusByLevel | GetMoneyBonusByLevel(nLevel)按等级查询师门任务金钱奖励基础值。 脚本中 1 处调用 |
| GetMoneyMultipleByRound | GetMoneyMultipleByRound(nRound)按师门任务轮次查询金钱奖励倍率。 脚本中 2 处调用 |
| GetMonsterOwnerCount | GetMonsterOwnerCount(sceneId, MonsterID)获取怪物所有者数量 脚本中 56 处调用 |
| GetMonsterOwnerID | GetMonsterOwnerID(sceneId, MonsterID, OwnerOffSet)获取怪物所有者编号 脚本中 56 处调用 |
| GetNpcInfoByNpcId | GetNpcInfoByNpcId(sceneId, nNpcId)通过任务 NPC 编号返回完整的任务 NPC 配置。 脚本中 60 处调用 |
| GetNumText GetEventList |
GetNumText(number)取出脚本交换用数据 脚本中 1417 处调用 |
| GetOneMissionBonusItem | GetOneMissionBonusItem(nMissionIndex)从任务配置中取得一个奖励物品,返回物品编号、名称、说明和广播类型。 脚本中 15 处调用 |
| GetOneMissionItem | GetOneMissionItem(nMissionIndex)从任务配置中取得一个任务物品,返回物品编号、名称、说明和广播类型。 脚本中 26 处调用 |
| GetOneMissionNpc | GetOneMissionNpc(nMissionIndex)从任务配置中取得一个 NPC,返回编号、名称、场景、坐标等信息。 脚本中 38 处调用 |
| GetOneMissionPet | GetOneMissionPet(nMissionIndex)从任务配置中取得一个珍兽,返回编号、名称和说明。 脚本中 10 处调用 |
| GetQuestionsRecord | GetQuestionsRecord(nIndex)读取题库信息 脚本中 14 处调用 |
| GetRandomQuestionsIndex | GetRandomQuestionsIndex(nType)从指定类型的题库中随机选择题目编号。 脚本中 12 处调用 |
| GetRenwulianMissionBonusItemByLevel | GetRenwulianMissionBonusItemByLevel(nMissionIndex, nPlayerLevel)按玩家等级段从任务链奖励配置中选取材料类奖励物品。 脚本中 1 处调用 |
| GetScriptIDByMissionID | GetScriptIDByMissionID(sceneId, selfId, missionId)返回玩家指定任务绑定的脚本编号。 脚本中 23 处调用 |
| IsHaveMission | IsHaveMission(sceneId, selfId, misId)玩家是否正在做此任务 脚本中 1409 处调用 |
| IsMissionFull | IsMissionFull(sceneId, selfId)返回当前任务列表是否已满。 脚本中 43 处调用 |
| IsMissionHaveDone | IsMissionHaveDone(sceneId, selfId, misId)是否做过此任务 脚本中 463 处调用 |
| LuaFnAddItemListToHumanIgnoreFatigueState | LuaFnAddItemListToHumanIgnoreFatigueState(sceneId, selfId)将奖励物品列表直接放入玩家背包,不触发疲劳消耗。 脚本中 38 处调用 |
| LuaFnEndAddItemIgnoreFatigueState | LuaFnEndAddItemIgnoreFatigueState(sceneId, selfId)结束忽略疲劳的奖励物品列表操作,并返回背包是否有空间。 脚本中 38 处调用 |
| LuaFnGetHumanShimenRandom | LuaFnGetHumanShimenRandom(sceneId, selfId)返回玩家门派任务脚本使用的随机数。 脚本中 9 处调用 |
| LuaFnGetLevelMatchingMonster | LuaFnGetLevelMatchingMonster(nMissionIndex, nLevel)返回与指定等级相差不超过 1 级的随机任务怪物信息。 脚本中 5 处调用 |
| LuaFnSetNumText | LuaFnSetNumText(value)设置脚本之间交换使用的 global_numtext 值。 脚本中未见调用 |
| MissionCom | MissionCom(sceneId, selfId, misId)任务完成 脚本中 158 处调用 |
| MissionLog | MissionLog(sceneId, msg)将任务脚本文本直接写入 Mission 日志文件。 脚本中 95 处调用 |
| ResetMissionCacheData | ResetMissionCacheData(sceneId, selfId)清空当前玩家的任务临时缓存。 脚本中 2 处调用 |
| ResetMissionEvent | ResetMissionEvent(sceneId, selfId, missionId, eventId)清除指定任务事件标志。 脚本中 120 处调用 |
| SetHighWord | SetHighWord(data, highWord)替换 32 位整数的高 16 位并返回合成结果。 脚本中 7 处调用 |
| SetLowWord | SetLowWord(data, lowWord)替换 32 位整数的低 16 位并返回合成结果。 脚本中 7 处调用 |
| SetMissionByIndex | SetMissionByIndex(sceneId, selfId, misIndex, paramIndex, value)设置任务参数 脚本中 1764 处调用 |
| SetMissionCacheData | SetMissionCacheData(sceneId, selfId, nIndex, nData)设置当前玩家任务临时缓存中的一个整数。 脚本中 7 处调用 |
| SetMissionData | SetMissionData(sceneId, selfId, nIndex, value)写入角色任务数据的条目数值。 脚本中 425 处调用 |
| SetMissionDataEx | SetMissionDataEx(sceneId, selfId, nIndex, value)写入角色任务数据的条目数值。 脚本中未见调用 |
| SetMissionEvent | SetMissionEvent(sceneId, selfId, misId, eventId)修改玩家身上misId编号的任务相应事件 脚本中 89 处调用 |
| SetMissionFlag | SetMissionFlag(sceneId, selfId, bitIndex, value)写入角色任务数据的标志位数值。 脚本中 100 处调用 |
| SetMissionFlagEx | SetMissionFlagEx(sceneId, selfId, bitIndex, value)写入角色任务数据的标志位数值。 脚本中未见调用 |
| SetMissionParamByIndexEx | SetMissionParamByIndexEx(sceneId, selfId, missionIndex, paramIndex, byteIndex, value)修改任务参数中指定的字节。 脚本中 31 处调用 |
| StartMissionTimer | StartMissionTimer(sceneId, selfId, missionId)开启任务定时器事件标志。 脚本中 9 处调用 |
| StopMissionTimer | StopMissionTimer(sceneId, selfId, missionId)关闭任务定时器事件标志。 脚本中 17 处调用 |
| UICommand_AddInt | UICommand_AddInt(sceneId, nValue)结束构造UICommand数据体 脚本中 580 处调用 |
| UICommand_AddString | UICommand_AddString(sceneId, szValue)结束构造UICommand数据体 脚本中 192 处调用 |