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

【进阶实战】图鉴点亮:一次性成就的判定与去重封装

2026-09-24 09:14 作者:996 技术组 0 阅读 996引擎Lua教程传奇脚本进阶实战996引擎Lua图鉴一次性成就

业务场景

祖玛套装图鉴 6 件集齐点亮:奖励 1 根金条与集藏家称号。图鉴系统的三个语义必须同时成立:收集无序(先捐哪件都算)、点亮只发一次(重复集齐不重发)、进度随时可查(已集几件、缺哪件)。散装实现最常见的翻车是断线时序:清单写完了、点亮奖励没发,玩家集齐却领不到,客诉与补偿双输。

核心实现

捐献登记:去重、扣物、写清单、计进度,满额触发点亮判定。示例代码如下:

lua
local SET = { "祖玛头盔", "祖玛项链", "祖玛手镯", "祖玛戒指", "祖玛护身符", "祖玛头像" }
local function donatePiece(actor, piece)
    actor = getplayerbyname(actor)
    local owned = getplayvar(actor, "HUMAN", "TuJian") or ""
    if string.find(owned, piece, 1, true) then
        sendmsg(actor, 1, "该件已在图鉴中。")
        return
    end
    if not takeitem(actor, piece, 1) then
        sendmsg(actor, 1, "背包里没有" .. piece .. "。")
        return
    end
    owned = owned == "" and piece or (owned .. "|" .. piece)
    setplayvar(actor, "HUMAN", "TuJian", owned, 1)
    local cnt = 0
    for _ in string.gmatch(owned, "[^|]+") do
        cnt = cnt + 1
    end
    sendmsg(actor, 1, "图鉴进度 " .. cnt .. "/" .. #SET)
    if cnt >= #SET then
        completeAlbum(actor)
    end
end

点亮侧幂等戳:AlbumLit 落库,第二次进入直接短路,奖励永无第二次。示例代码如下:

lua
local function completeAlbum(actor)
    actor = getplayerbyname(actor)
    if getplayvar(actor, "HUMAN", "AlbumLit") == 1 then
        return
    end
    setplayvar(actor, "HUMAN", "AlbumLit", 1, 1)
    giveitem(actor, "金条", 1)
    sendmsg(actor, 1, "祖玛图鉴点亮!金条与集藏家称号已发放。")
end

接口拆解

string.find 第四参 true 关闭模式匹配:物品名当纯文本查找,去重零误伤。takeitem(actor, itemname, qty) 布尔闸门:先扣后记,捐献失败清单不动。string.gmatch 配 [^|]+ 计数进度,与 #SET 比对触发完成。两个独立变量各司其职:TuJian 是收集清单、AlbumLit 是点亮幂等戳,后者是奖励只发一次的唯一依据。

踩坑记录

图鉴系统踩过三个坑:一是完成判定写的是"捐献第 6 件时触发",玩家把第 6 件重复捐献被去重跳过,进度满了却没触发完成判定,触发条件必须基于计数而不是基于动作次序;二是点亮奖励发放与幂等戳写入之间断线,奖励发出戳没落,重登再触发重发一次,正确顺序是先落戳后发奖,宁漏勿重,漏发靠戳比对补发;三是清单变量超长,重复捐献的提示文案写进了清单,find 计数错乱,清单里只允许出现登记条目本身。

作者履历与出处

本文由 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 阅读