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

【进阶实战】赠礼代收:离线礼物的代收与转交通知

2026-09-24 11:14 作者:996 技术组 0 阅读 996引擎Lua教程传奇脚本进阶实战996引擎Lua赠礼代收

业务场景

好友送礼时对方不在线,散装做法是让礼物凭空消失或要求"等他上线再送"。代收箱模式:离线好友的礼物进入其代收箱(上限 10 份),上线时逐份转交并通知;箱满时代替好友婉收并回执告知赠送方——礼物不丢、上限明确、双方都有知情权。

核心实现

赠送与代收:在线好友直赠,离线好友进代收箱(全局台账以收件人名为键,上限 10 份)。示例代码如下:

lua
local function giftToBox(actor, friendName, itemName)
    actor = getplayerbyname(actor)
    local t = getplayerbyname(friendName)
    if t ~= nil and t ~= "" then
        giveitem(t, itemName, 1, 1)
        sendmsg(t, 1, "好友 " .. tostring(actor) .. " 赠送了 " .. itemName .. "。")
        return
    end
    local boxKey = "GiftBox_" .. friendName
    local box = tostring(getsysvar(boxKey) or "")
    local cnt = 0
    for _ in string.gmatch(box, "[^|]+") do
        cnt = cnt + 1
    end
    if cnt >= 10 then
        sendmsg(actor, 1, friendName .. " 的代收箱已满(10 份),礼物未送出。")
        return
    end
    local entry = itemName .. ":" .. tostring(actor)
    setsysvarex(boxKey, box == "" and entry or (box .. "|" .. entry), 1)
    sendmsg(actor, 1, friendName .. " 不在线,礼物已入代收箱(" .. (cnt + 1) .. "/10)。")
end

本篇的新技术点是"离线代收挂全局台账":离线好友没有玩家对象,个人变量写不了,台账以收件人名为键挂在全局区,好友上线后凭自己的名字领走整箱。
上线领取:按玩家名键拉取代收箱,逐份转交并清空。示例代码如下:

lua
local function claimGiftBox(actor)
    actor = getplayerbyname(actor)
    local boxKey = "GiftBox_" .. tostring(actor)
    local box = tostring(getsysvar(boxKey) or "")
    if box == "" or box == "0" then
        sendmsg(actor, 1, "代收箱是空的。")
        return
    end
    for e in string.gmatch(box, "[^|]+") do
        local item, from = string.match(e, "([^:]+):(.+)")
        giveitem(actor, item, 1, 1)
        sendmsg(actor, 1, "收到 " .. from .. " 赠送的 " .. item .. "。")
    end
    setsysvarex(boxKey, "", 1)
end

接口拆解

getplayerbyname 只对在线玩家返回对象——离线判定天然由它完成。getsysvar/setsysvarex 以 GiftBox_玩家名 为键的全局台账是离线礼物的唯一栖身处,isSave 传 1 落库。string.gmatch 加 [^|]+ 拆条目、string.match 解析"物品:赠送人"两段。giveitem(actor, itemname, num, bind):转交的礼物保持绑定,代收不通融为流通。

踩坑记录

代收箱踩过三个坑:一是台账键拼了玩家名字符串但没做唯一性处理,玩家改名后代收箱变成无人认领的孤儿账,键要用唯一 ID 或改名时同步迁移台账;二是转交循环里没有对 giveitem 的背包满做前置校验,背包满的玩家礼物堆进邮箱反而更稳妥,转交前查一次剩余格位;三是代收箱没有过期机制,退游玩家的 10 份礼物永久占着全局变量,90 天未领取统一清空并回执赠送人。

作者履历与出处

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

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

最新技术文章 · 实战干货

LATEST ARTICLES

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

策划架构996引擎

【策划架构】玩法日历:活动排期的疲劳度预算设计

设计初衷 活动排期凭感觉:周末连开三个重头活动,玩家疲于奔命参与率反跌;工作日大空窗,在线曲线断崖。玩法日历设计:以周为单位…

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

【策划架构】掉线补偿:分级处置与申诉留痕设计

设计初衷 网络波动掉线让玩家损失战斗进度:世界BOSS打到一半掉线,回来残局已清;副本中掉线,门票作废。掉线补偿设计把掉线当…

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

【高级技巧】圆周等距布点:环绕阵列的坐标生成封装

底层原理 祭坛围一圈火把、世界BOSS周身一圈水晶,这类环绕阵列需要等角度分布坐标:圆心 (cx, cy)、半径 r、数量 …

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

【策划架构】影子榜:追赶目标的邻座排名设计

设计初衷 排行榜只有顶端可见:进不了前一百的玩家在榜上查无此人,名次没有参照,追赶没有对象。影子榜设计:为每名玩家生成以自己…

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

【进阶实战】副本重置投票:队伍表决的过半重置封装

业务场景 打错路线或主力减员后想重来,队长单方面重置常引发队内矛盾,误触重置的投诉也不少。投票重置封装:重置需全队表决、同意…

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

【高级技巧】校验和:存档完整性的算术校验封装

底层原理 存档在写入与传输中可能因意外损坏,读档前需要一道完整性判定。校验和的思路:把数据逐字节累加压缩成一个整数指纹,读档…

2026-09-25 11:34 996 技术组 · 0 阅读