CHUAN2 DEV ENGINE
996 正版授权研发中心 · 360 授权合作教学中心 · 抖音传奇直播合作授权 · 快手推广运营商授权
OFFICIAL LICENSED ACADEMY 查验官方授权证书 →
// 威海旷世互娱教学基地 · 技术文章
后端接口

【后端接口】宠物探险:离线探险时长与收益结算

2026-09-21 12:14 作者:996 技术组 后端接口

实战应用:用在哪里

宠物探险是宠物系统的离线收益模块:玩家派遣宠物外出探险,设定探险时长(2/8/24 小时三档),到期后宠物带着材料与经验归来。离线收益的设计让宠物在玩家不在线时也有存在感,探险时长的三档选择让玩家按自己的上线节奏规划。

探险的启动与结算

lua

local EXPEDITION_TIERS = { { h = 2, mult = 1.0 }, { h = 8, mult = 1.5 }, { h = 24, mult = 2.0 } }
function Expedition.start(actor, petIdx, tier)
    local pet = actor:GetPet(petIdx)
    if not pet then return false, "宠物不存在" end
    if pet:IsFighting() then return false, "战斗中不可派遣" end
    local tierCfg = EXPEDITION_TIERS[tier]
    if not tierCfg then return false, "无效档位" end
    setplayvar(actor, "HUMAN", "exp_start_" .. petIdx, os.time(), 1)
    setplayvar(actor, "HUMAN", "exp_tier_" .. petIdx, tier, 1)
    setplayvar(actor, "HUMAN", "exp_dur_" .. petIdx, tierCfg.h * 3600, 1)
    sendmsg(actor, 1, pet.name .. " 出发探险,时长 " .. tierCfg.h .. " 小时")
    return true
end

function Expedition.claim(actor, petIdx)
    local startAt = tonumber(getplayvar(actor, "HUMAN", "exp_start_" .. petIdx)) or 0
    local tier = tonumber(getplayvar(actor, "HUMAN", "exp_tier_" .. petIdx)) or 1
    local dur = tonumber(getplayvar(actor, "HUMAN", "exp_dur_" .. petIdx)) or 0
    local elapsed = os.time() - startAt
    if elapsed < dur then return false, "探险尚未完成" end
    local tierCfg = EXPEDITION_TIERS[tier]
    local materials = math.floor(dur / 3600 * tierCfg.mult * 10)
    giveitem(actor, "探险材料", materials, 1, "宠物探险收益")
    setplayvar(actor, "HUMAN", "exp_start_" .. petIdx, 0, 1)
    return true
end

启动时记录开始时间戳与档位参数,结算时按时长折算收益。探险的收益按小时乘以档位倍率:2 小时档倍率 1.0、8 小时档 1.5、24 小时档 2.0,长档位的效率优势鼓励玩家选择长探险。探险的完成推送在到期时通知玩家领取。

收益的防刷

lua

function Expedition.antiCheat(actor, petIdx)
    local startAt = tonumber(getplayvar(actor, "HUMAN", "exp_start_" .. petIdx)) or 0
    if startAt == 0 then return false end
    local elapsed = os.time() - startAt
    if elapsed > 48 * 3600 then
        sendmsg(actor, 1, "探险超时,收益按上限 24 小时结算")
        return false
    end
    return true
end

超时 48 小时的探险收益按上限 24 小时封顶,防止长期不上线的玩家积累超额收益。探险的收益与宠物的等级联动,高级宠物的探险收益系数加二成,宠物的养成投入在探险的收益中回本。

验证与监控

探险的启动与结算流水成对审计,收益的按小时产出与设计值的偏差周报复盘。

踩坑记录

探险的开始时间曾经存为格式化文本,跨时区玩家的时差让收益翻倍,时间戳的统一存储修复。探险的完成推送曾经不及时,到期后延迟半小时才收到通知,推送的定时器与到期时间严格对齐。

上线要点

探险的收益进宠物的养成经济模型,材料与经验的产出比与打怪的收益曲线对齐。探险的档位选择界面显示各档的预计收益,玩家的决策有数据支撑。

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

作者履历与出处

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

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

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

LATEST ARTICLES

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

玩法策划远征编制

【玩法策划】跨服远征编制:借鉴MMO远征的分层推进方案

实战应用:用在哪里 跨服远征分先锋、主力、后勤三队独立推进,三线全通合围BOSS。不同战力成员都有参与感。 策划要点与配置 …

2026-09-22 21:15 996 技术组
案例复盘副本难度

【案例复盘】副本超时惩罚倍率复盘

实战应用:用在哪里 副本限时挑战加入超时血量惩罚:超时后BOSS攻击递增。上线后BOSS攻击叠到十倍秒杀全队。 事故还原与补…

2026-09-22 21:15 996 技术组
界面UI神兽特效

【界面UI】混沌麒麟入场特效:神兽召唤的三段演出设计

实战应用:用在哪里 混沌麒麟召唤是全服高光时刻:暗幕聚合、裂缝展开、麒麟着陆三段演出各1.3秒。 三段式入场演出编排 围观镜…

2026-09-22 21:15 996 技术组
前端接口任务回看

【前端接口】任务对话历史回看:对话记录的界面查询实现

实战应用:用在哪里 任务对话一闪而过玩家想回顾。回看接口把对话按节点存档,面板翻阅全部对话记录。 对话存档与查询渲染 当前章…

2026-09-22 21:15 996 技术组
引擎触发懒加载地图

【引擎触发】挂机地图按需激活:地图实例懒加载设计

实战应用:用在哪里 服务器承载六十张地图,空闲地图白耗资源。按需激活,末人离开后六十秒休眠。 激活与休眠触发 休眠回收 验证…

2026-09-22 21:15 996 技术组
Lua实战坐骑洗炼

【Lua实战】坐骑资质洗炼与锁定:资质系统的Lua实现

实战应用:用在哪里 坐骑资质洗炼随机重滚五条属性,锁定满意的条目不再重滚,锁定越多消耗越大。 洗炼与锁定 锁定消耗递增 验证…

2026-09-22 21:15 996 技术组