【后端接口】recallmob：召唤物接口与主人绑定的生命周期

实战应用：用在哪里

recallmob 是召唤物的生成接口：道士的骷髅神兽、活动的护送 NPC、演练用的木桩怪都从这出。召唤物的生命周期（生成、跟随、死亡、回收）在接口参数与配套接口里自成回路，主人绑定是这套系统的灵魂。

接口签名与召唤

---召唤怪物 actor:主人 monName:怪物名 level:等级 time:存活秒
function recallmob(actor, monName, level, time, param1, param2, param3) end

-- 召唤一只跟随主人的骷髅战士，存活 3600 秒
recallmob(actor, "骷髅战士", 3, 3600)

召唤物生成即绑定主人：跟随主人的移动、协助主人的战斗、主人下线随之回收，绑定的语义内嵌在接口里。level 参数直接决定召唤物的强度档位，怪物表里同名怪的不同等级就是不同的属性模板。time 是存活秒数，到期自动消散，永久的召唤物传大数值而不传 0，0 的语义在文档里要核对清楚。

召唤物的操控

-- 召唤物指令：休息与攻击模式
function petCommand(actor, mode)
    local pet = getslavebyindex(actor, 1)
    if not pet then return false end
    setpetmode(actor, mode)
    sendmsg(actor, 1, "召唤物已" .. (mode == 0 and "休息" or "进入战斗"))
    return true
end

getslavebyindex 按序号取召唤物对象，setpetmode 切换休息与攻击模式，召唤物的操控接口与生成接口配套。召唤物的死亡触发走 selfkillslave 触发，主人收到通知与重生冷却，召唤物的生死也是主人游戏体验的一部分。多召唤物的管理：同一个主人可以有多个召唤物时用序号区分，序号的重排在召唤物死亡后会发生，按序号持有的引用要及时刷新。

验证与监控

召唤物的存活时长分布与设定值的偏差监控，提前消散的排查指向引擎的清理事件。

踩坑记录

召唤物的等级参数曾经直接透传玩家等级，等级压制让高等级道士的骷髅无敌，档位封顶的钳制加进接口封装。time 到期的消散没有表现，召唤物凭空消失被玩家报 Bug，消散前的动画提示是表现层的补课。

上线要点

召唤物的掉落与经验归属默认归主人，群体召唤玩法的归属规则要在接口参数外单独设计。召唤物与主人的距离 leash：脱缰的召唤物追怪追出两屏的体验事故，距离上限是召回机制的触发条件。召唤物的数量上限按主人属性计算，上限的校验在召唤前完成，超限召唤静默失败是排障的痛苦来源，失败要有消息。

本文由 996 技术组基于 996 引擎官方知识库与浮生梦老师课程体系整理。团队长期从事传奇类引擎 Lua 后端逻辑、客户端界面与商业版本交付，内容以官方知识库与真实项目为出处，按版本持续修订。