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

【后端接口】装备图鉴:收集进度与图鉴奖励

2026-09-21 12:45 作者:996 技术组 0 阅读 后端接口

实战应用:用在哪里

装备图鉴让收集装备变成有回报的长期目标:每收集一件图鉴中的装备,图鉴进度推进,收集到指定数量触发图鉴奖励。图鉴的设计核心是收集目标的梯度化——从 5 件的小目标到全集的大目标,每个阶段都有奖励维持动力。

图鉴的收集

lua

local CODEX_REWARDS = { [5] = { item = "强化石礼包", n = 3 }, [15] = { item = "坐骑缰绳", n = 1 }, [30] = { item = "称号:收藏家", n = 1 } }
function Codex.onObtain(actor, itemId)
    if not CODEX_ITEMS[itemId] then return end
    local key = "codex_" .. itemId
    if getplayvar(actor, "HUMAN", key) == 1 then return end
    setplayvar(actor, "HUMAN", key, 1, 1)
    actor.codexCount = (actor.codexCount or 0) + 1
    local reward = CODEX_REWARDS[actor.codexCount]
    if reward then
        giveitem(actor, reward.item, reward.n, 1, "图鉴收集奖励")
        sendcentermsg(actor, 249, 0, "图鉴收集达到 " .. actor.codexCount .. " 件!", 0, 5, "")
    end
end

每件图鉴装备首次获取时标记,重复获取不重复计数。图鉴的收集进度在面板实时展示,进度条的节拍让玩家对差距一目了然。奖励的梯度化设计让短期与长期都有目标可追。

图鉴的查询

lua

function Codex.query(actor)
    local total = 0
    for itemId, _ in pairs(CODEX_ITEMS) do total = total + 1 end
    local collected = 0
    for itemId, _ in pairs(CODEX_ITEMS) do
        local key = "codex_" .. itemId
        if getplayvar(actor, "HUMAN", key) == 1 then collected = collected + 1 end
    end
    return { total = total, collected = collected }
end

图鉴的查询返回总数与已收集数,进度百分比驱动收集的动力。未收集的条目显示获取途径(哪只 BOSS、哪个副本),信息的透明让收集有方向。图鉴的界面按装备的部位分组展示,武器组、防具组、饰品组的进度条独立计算,分类的进度让玩家找到最容易突破的组别。

验证与监控

图鉴的收集率按服务器的开服天数分层统计,收集率的增长曲线反映运营活动的拉动力。

踩坑记录

图鉴的标记曾经在装备交易后未转移,卖掉装备后图鉴进度倒退,图鉴的标记改为按首次获取锁定后不回退。图鉴奖励的重复发放曾经因为变量键冲突,键的命名加入物品 ID 后唯一。

上线要点

图鉴的展示按装备的部位分组,武器/防具/饰品三组的进度条独立,收集的目标感分类清晰。图鉴的奖励进成就系统的联动,集齐全套图鉴触发全服播报与限定称号。

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

作者履历与出处

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

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

最新技术文章 · 实战干货

LATEST ARTICLES

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

玩法策划远征编制

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2026-09-22 21:15 996 技术组 · 0 阅读