CHUAN2 DEV ENGINE
996 正版授权研发中心 · 360 授权合作教学中心 · 抖音传奇直播合作授权 · 快手推广运营商授权
OFFICIAL LICENSED ACADEMY 查验官方授权证书 →
// 威海旷世互娱教学基地 · 技术文章
进阶实战996引擎出战轮换宠物

【进阶实战】出战轮换:宠物出战位的定时轮换封装

2026-09-24 14:47 作者:996 技术组 996引擎Lua教程传奇脚本进阶实战996引擎Lua出战轮换宠物

业务场景

玩家养了三只圣兽白虎,长期只用出战位上的那只,另两只纯摆设——亲密度差距越拉越大。出战轮换:按轮换表每次战斗自动切换出战宠物(三只循环),让三只的亲密度均衡成长;轮换表可配置顺序与开关,玩家手动锁定某只时轮换暂停。

核心实现

轮换推进与锁定:轮换指针按列表循环推进,锁定时跳过轮换。示例代码如下:

lua
local function rotatePet(actor)
    actor = getplayerbyname(actor)
    if getplayvar(actor, "HUMAN", "RotateLock") == 1 then
        sendmsg(actor, 1, "出战锁定中,本次不轮换。")
        return
    end
    local roster = getplayvar(actor, "HUMAN", "PetRoster") or ""
    if roster == "" then
        sendmsg(actor, 1, "请先配置轮换名单。")
        return
    end
    local pets = {}
    for id in string.gmatch(roster, "[^|]+") do
        pets[#pets + 1] = id
    end
    local ptr = (tonumber(getplayvar(actor, "HUMAN", "RotatePtr")) or 0) % #pets
    setplayvar(actor, "HUMAN", "RotatePtr", ptr + 1, 1)
    sendmsg(actor, 1, "出战切换为第 " .. (ptr + 1) .. " 只:" .. pets[ptr + 1])
end

名单配置:三只宠物的 ID 按顺序写入轮换名单,重复 ID 自动去重。示例代码如下:

lua
local function setRoster(actor, idList)
    actor = getplayerbyname(actor)
    local seen, cleaned = {}, {}
    for id in string.gmatch(idList, "[^|]+") do
        if seen[id] == nil then
            seen[id] = true
            cleaned[#cleaned + 1] = id
        end
    end
    setplayvar(actor, "HUMAN", "PetRoster", table.concat(cleaned, "|"), 1)
    setplayvar(actor, "HUMAN", "RotatePtr", 0, 1)
    sendmsg(actor, 1, "轮换名单已配置 " .. #cleaned .. " 只。")
end

接口拆解

RotatePtr 是轮转指针:取模 #pets 定位当前出战,加一推进,落库保证跨重启连续。getplayvar/setplayvar 第五参 1:名单与指针都持久化。string.gmatch 加 [^|]+ 拆名单,重复 ID 用 seen 表去重——名单脏数据在入口清理,不流入轮换逻辑。锁定开关 RotateLock 独立于名单,玩家锁定后轮换静默跳过。

踩坑记录

出战轮换踩过三个坑:一是轮换指针在名单缩短后越界(3 只删到 2 只,指针指向第 3 位),取模运算必须在每次推进时基于当前名单长度重算;二是锁定状态下轮换指针照常推进,解锁后直接跳过了若干只,锁定时指针冻结不动才是正确语义;三是名单里写了未获得的宠物 ID,轮换切到它时报错中断,名单配置时逐 ID 校验持有状态,未持有的拒绝入名单。

作者履历与出处

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

← 返回文章地图返回研学路径

幂尔框架 · 实战干货 · 接口调用

LATEST ARTICLES

全站技术干货持续更新:996 引擎 / Lua 实战帖,语法、参数与示例一篇讲透。进入文章地图 · 查看全部 →

策划架构996引擎

【策划架构】负重系统:携带上限与移速的联动设计

设计初衷 背包无限装:药水带一百瓶、材料囤到爆——负重没有成本,背包管理沦为无脑囤积。负重系统设计:每件物品带重量,总负重超…

2026-09-25 17:48 996 技术组
策划架构996引擎

【策划架构】副手装备:主副手位的定位与收益设计

设计初衷 装备栏有武器位没有副手位:副手要么没用、要么变成第二武器直接双倍攻击——副手的定位从来没人讲清。副手装备设计:主手…

2026-09-25 17:48 996 技术组
高级技巧996引擎

【高级技巧】访问者模式:异构节点的分派处理封装

底层原理 对不同类型的节点执行不同操作(战绩流水里的击杀、阵亡、助攻各有统计口径),把操作散在类型判断里,每加一种操作就要改…

2026-09-25 17:48 996 技术组
高级技巧996引擎

【高级技巧】组合模式:整体与部分的同一接口设计

底层原理 行会的战力由成员战力组成、成员战力由装备组成——"整体"与"部分"要能用同一个接口对待:问行会战力与问成员战力是同…

2026-09-25 17:48 996 技术组
策划架构996引擎

【策划架构】增伤属性:技能增伤的乘区设计

设计初衷 输出成长只有堆攻击一条路:攻击加成稀释严重(基础 2000 再加 200 体感无几),成长反馈越来越钝。增伤属性设…

2026-09-25 17:48 996 技术组
进阶实战996引擎

【进阶实战】箭塔守御:固定炮台的索敌与开火封装

业务场景 驻地守御靠玩家人肉站桩:离线时段防务真空。箭塔守御封装:驻地点位部署箭塔(帮会资金建造),箭塔自动索敌(优先最近、…

2026-09-25 17:48 996 技术组