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

【进阶实战】在线奖励:限时在线时长的阶梯奖励封装

2026-09-24 16:50 作者:996 技术组 0 阅读 996引擎Lua教程传奇脚本进阶实战996引擎Lua在线奖励阶梯奖励

业务场景

在线时长奖励的痛点:玩家不知道"还要在线多久才能领下一档",奖励到账无声无息。阶梯奖励封装:按累计在线分钟数设四档奖励(10/30/60/120 分钟),每档到点自动推送提醒并标记可领,玩家手动领取——自动提醒拉回注意力,手动领取给成就感。

核心实现

在线计时与阶梯判定:登录时记开始戳,每次心跳累计分钟数,过档推送。示例代码如下:

lua
local THRESHOLDS = { 10, 30, 60, 120 }
local REWARDS = { { item = "金创药", num = 3 }, { item = "祝福油", num = 1 },
    { item = "强化石", num = 2 }, { item = "金条", num = 1 } }
local function checkOnlineReward(actor)
    actor = getplayerbyname(actor)
    local loginAt = tonumber(getplayvar(actor, "HUMAN", "LoginAt")) or os.time()
    local onlineMin = math.floor((os.time() - loginAt) / 60)
    for i, threshold in ipairs(THRESHOLDS) do
        local key = "OnlineRw_" .. i .. "_" .. os.date("%Y%m%d")
        if onlineMin >= threshold and getplayvar(actor, "HUMAN", key) ~= 1 then
            setplayvar(actor, "HUMAN", key, 1, 1)
            local rw = REWARDS[i]
            giveitem(actor, rw.item, rw.num, 1)
            sendmsg(actor, 1, "在线 " .. threshold .. " 分钟奖励:" .. rw.item .. " x" .. rw.num)
        end
    end
end

防重复:每档每天限领 1 次,日期键自然隔离。示例代码如下:

lua
local function getClaimStatus(actor)
    actor = getplayerbyname(actor)
    local today = os.date("%Y%m%d")
    local claimed = 0
    for i = 1, #THRESHOLDS do
        if getplayvar(actor, "HUMAN", "OnlineRw_" .. i .. "_" .. today) == 1 then
            claimed = claimed + 1
        end
    end
    sendmsg(actor, 1, "今日已领 " .. claimed .. "/" .. #THRESHOLDS .. " 档。")
end

接口拆解

THRESHOLDS 与 REWARDS 数组下标一一对应,新增档位同时扩展两个数组。getplayvar/setplayvar 第五参 1 落库——领取标记与在线时长都是跨重启资产。giveitem(actor, itemname, num, bind):第四参 bind 传 1,在线奖励绑定防交易套利。os.date("%Y%m%d") 嵌入键名实现按日隔离,跨日自动重置无需清理钩子。

踩坑记录

在线奖励踩过三个坑:一是 loginAt 在每次重连时被覆盖,玩家断线重连后在线时长归零重新计算,登录戳只在每日首次登录时写入,重连不覆盖;二是四档奖励用四条 if 逐一判断,新增档位要改四个地方,改为数组驱动后加档只需在 THRESHOLDS 和 REWARDS 各加一行;三是奖励发放没有绑定标记,玩家把在线奖励的强化石挂到交易行卖,bind=1 一加上就堵住了套利口。

作者履历与出处

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

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

最新技术文章 · 实战干货

LATEST ARTICLES

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

策划架构996引擎

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2026-09-25 17:48 996 技术组 · 0 阅读