lawless/docs/设计文档/GDD-30-成就里程碑与图鉴系统设计.md

33 KiB

GDD-30 成就、里程碑与图鉴系统设计

文档类型游戏设计文档Game Design Document 版本1.1 日期2026-07-02 关联文档GDD-01 种族系统、GDD-02 底层核心机制、GDD-03 战斗系统、GDD-04 功法系统、GDD-05 职业与生活技能、GDD-06 经济系统、GDD-08 大陆地图与区域开放、GDD-11 种族转生与转化系统、GDD-12 渡劫破镜与境界掉落、GDD-13 佣兵大厅与悬赏系统、GDD-17 技能总库、GDD-19 怪物图鉴与生成引擎、GDD-20 武器装备与打造系统、GDD-22 开放世界随机事件

定位:成就/里程碑/图鉴/称号是洪荒大陆的记录与展示层——不产出战力、不决定成长,但为玩家的修真旅程提供可追溯的叙事锚点与社交资本。所有系统遵循"概率/机遇驱动"核心哲学GDD-02 37,不存在"保证完成"的线性路径。


一、设计原则

# 原则 说明
1 记录而非引导 成就/图鉴是行为的"影子",不是行为的"指南针"。不做任务面板、不做进度条提示、不做"下一步推荐"
2 概率驱动 隐藏成就不展示条件;图鉴解锁依赖探索发现;里程碑触发依赖机遇概率
3 无赛季重置 所有成就/里程碑/图鉴数据永久保留,不做赛季清零(对齐项目无赛季设计)
4 社交资本优先 称号/里程碑是社交展示的核心载体,奖励侧重外观/称号/微量属性而非硬通货
5 接入现有系统 不自建独立引擎,复用 GDD-19 怪物数据、GDD-04 功法数据、GDD-20 装备数据、GDD-08 地图数据等已有数据源

二、成就系统

2.1 成就分类

成就按行为领域分为 7 大类,每类下设子类:

大类 子类示例 说明
修炼 境界突破、功法升层、内力纯度、顿悟次数、加持等级 与 GDD-02 内力/境界系统、GDD-04 功法系统挂钩
战斗 击杀统计、PVP 胜场、渡劫成功、Boss 击杀、暴击/闪避累计 与 GDD-03 战斗系统、GDD-12 渡劫系统挂钩
探索 地图点亮、秘境发现、奇遇触发、天启首发、区域全收集 与 GDD-08 地图系统、GDD-22 随机事件挂钩
制造 锻造/炼器/裁缝/炼丹等生活技能里程碑、极品产出、配方发现 与 GDD-05 生活技能、GDD-20 装备打造挂钩
社交 帮派/门派/家族活动、道侣/结义、师徒传承、佣兵信用 与 GDD-07 社交系统、GDD-13 佣兵系统挂钩
收集 图鉴完成度、功法收藏数、装备图鉴数、怪物图鉴数 与本章图鉴系统挂钩
特殊 隐藏成就、种族专属成就、阵营成就、跨种族事件成就 不展示条件,探索发现

2.2 成就层级

成就按难度与稀有度分为 4 个层级:

层级 名称 解锁条件难度 数量占比 代表性成就
初窥 低,自然游玩可完成 ~50% 首次突破炼气、首次锻造成功、首次击杀灵兽
登堂 中,需专项投入 ~30% 金丹期达成、功法升至第 5 层、信用评级 A 级
入室 高,需长期积累或稀有机遇 ~15% 元婴期达成、首杀凶兽级 Boss、功法收藏 50 门
传说 通玄 极高,全服稀缺 ~5% 飞升达成、首杀神兽、全种族图鉴完成、首个域主

2.3 成就奖励

成就奖励不以硬通货为主,侧重展示与微量增益:

奖励类型 铜层级 银层级 金层级 传说层级
称号 通用前缀称号 类别专属称号 稀有称号 全服唯一/限量称号
外观 类别边框/头像 特殊特效/光环 限定外观/坐骑装饰
属性微增 对应类别属性 +0.5%~1% 对应类别属性 +1%~2%
稀有道具 稀有材料/功法残卷 传说材料/专属功法原本
图鉴解锁 隐藏图鉴条目解锁

属性微增上限:成就提供的属性微增合计上限 +5%,防止成就成为硬性战力来源。数值待平衡测试。

2.4 隐藏成就

隐藏成就是成就系统的核心差异化设计:

维度 规则
条件隐藏 隐藏成就不在成就列表中显示条件,仅显示「???」与层级标识
发现机制 玩家完成隐藏条件后弹出「成就发现」动画,同时解锁该成就的名称与描述
不可查询 未发现的隐藏成就不计入完成率统计,不参与排行榜
触发来源 稀有奇遇、概率事件、极端行为组合、跨系统联动(如同时满足特定种族+特定境界+特定行为)
全服广播 传说级隐藏成就发现时触发全服广播
数量 隐藏成就约占总成就数的 20%~25%,分布在所有 7 个大类中

隐藏成就示例

成就名 层级 隐藏条件(示例) 奖励
「命运的齿轮」 传说 时间漫游者创角 + 首次天启 专属称号「旅者」+ 全属性 +1%
「不悔之心」 完成不悔卧底三段事件链回归人族 称号「赤心不悔」+ 功法收藏栏 +3
「四凶之殇」 传说 击杀全部四凶(饕餮/穷奇/梼杌/混沌) 称号「四凶克星」+ 凶兽材料掉落 +5%
「万族之眼」 传说 在不转生的情况下通过"洪荒史书"查看全部 19 种族信息 称号「史官」+ 种族图鉴全解锁
「第一滴血」 首次在 PVP 中击杀其他玩家 称号「开刃」
「不死不休」 同一场战斗中触发巫族「回光返照」3 次 称号「不死战魂」

2.5 成就数据模式

{
  "achievement_id": "ach_kill_first_beast",
  "name": "初猎",
  "description": "首次击杀灵兽级怪物",
  "category": "combat",           // 7 大类
  "tier": "bronze",               // bronze/silver/gold/legendary
  "is_hidden": false,
  "conditions": [
    {"type": "monster_kill", "beast_tier_min": "ling", "count": 1}
  ],
  "rewards": {
    "title": null,
    "attribute_bonus": null,
    "item": null,
    "cosmetic": null
  },
  "server_broadcast": false
}

2.6 成就与无任务系统的对齐

本项目无任务系统GDD-02 核心原则),成就系统严格区别于任务:

维度 任务(本项目不存在) 成就(本项目)
引导性 告诉玩家"下一步做什么" 仅记录"玩家做了什么"
奖励预期 明确预告奖励内容 奖励在完成后揭示(隐藏成就)或层级公示
完成路径 线性/可规划 概率驱动,部分依赖机遇
进度展示 进度条/步骤提示 仅"已完成/未完成"二态,不做进度百分比

三、里程碑系统

3.1 里程碑定义

里程碑是全服范围内不可重复的单次事件,记录服务器历史上的"第一次"。与成就的区别:

维度 成就 里程碑
可重复性 每个玩家均可独立完成 全服仅第一次触发者获得
触发条件 累计进度型 单次事件型
数量 海量(数百条) 极少(数十条)
广播 仅传说级成就广播 所有里程碑均全服广播
奖励 称号/外观/微量属性 稀有称号 + 全服广播 + 独占奖励

3.2 里程碑事件清单

# 里程碑名称 触发条件 奖励 广播范围
M01 天启首发 某层世界首位触发天启的玩家 称号「{层名}先驱」+ 该层专属材料礼包 全服
M02 首渡雷劫 服务器首位渡劫成功的玩家 称号「渡劫第一人」+ 稀有渡劫护符 全服
M03 首转人族 服务器首位通过转生成为人族的玩家 称号「万法归宗」+ 人族祖地声望 +500 全服
M04 首杀神兽 服务器首次击杀/驯化某只神兽(按 GDD-19 M06,全服仅 1 只) 称号「{神兽名}猎手/驯者」+ 神兽核心材料 + 全服经验雨 全服
M05 全种族相遇 首位在图鉴中记录全部 19 个种族信息的玩家 称号「万族之眼」+ 种族图鉴全解锁特权 全服
M06 首个唯一技能 服务器首位通过自创获得专属技能GDD-04 6.6.2,不入全球池)的玩家 称号「开宗者」+ 技能图鉴铭刻 全服
M07 首个域主 服务器首位成为界域域主GDD-08 146的玩家 称号「{界域名}域主」+ 域主专属外观 + 界域税收特权 全服
M08 首个飞升 服务器首位达到飞升境界的玩家 称号「飞升者」+ 飞升专属外观 + 神域创建资格 全服
M09 首屠四凶 服务器首次击杀全部四凶的队伍/个人 称号「四凶终结者」+ 四凶材料礼包 全服
M10 首建帮派 服务器首个创建帮派的玩家 称号「开帮元老」+ 帮派创建资源返还 全服
M11 首对道侣 服务器首对结为道侣的玩家 称号「{角色名}之道侣」+ 道侣专属外观 全服
M12 首发现克苏鲁 服务器首位在混沌之渊触发旧日注视事件的玩家 称号「窥视者」+ SAN 上限 +5 全服
M13 佣兵之王 服务器首位信用评级达到 S 级的玩家 称号「佣兵之王」+ 佣兵接单上限 +3 全服
M14 天工匠师 服务器首位矮人族达到「天工匠师」传承大师的玩家 称号「天工」+ 锻造品质永久 +5% 全服

里程碑扩展:里程碑清单随版本迭代扩展,新增里程碑需经 GDD-00 决策登记。每个里程碑全服仅一人/一队获得,永久记录于服务器编年史。

3.3 里程碑奖励与全服广播

全服广播格式

【里程碑】{玩家名}{种族})达成全服首次「{里程碑名}」!

广播渠道

  • 系统公告栏全服推送,3 秒自动消失或手动关闭)
  • 世界频道置顶消息(保留 5 分钟)
  • 服务器编年史(永久记录,可查询)

里程碑奖励特点

  • 称号为全服唯一,不可转让、不可重复获得
  • 奖励偏向社交资本(称号、外观、广播)而非硬通货
  • 部分里程碑附带永久微增属性(上限 +3%,防止里程碑成为硬性门槛)

3.4 服务器编年史

所有里程碑事件自动汇入服务器编年史——一个按时间线排列的全服大事记:

时间 事件 玩家 详情
游戏历 1 天 天启首发·灵界 {玩家A} 首位触发灵界天启
游戏历 3 天 首渡雷劫 {玩家B} 筑基期渡劫成功
游戏历 15 天 首杀神兽·青龙 {帮派X} 全服首杀青龙
... ... ... ...

编年史可通过 NPC「史官」或 UI 面板查询,是服务器的集体记忆。


四、图鉴系统

4.1 图鉴总览

图鉴系统是玩家的修真百科全书,记录玩家在洪荒大陆中接触过的一切事物。图鉴不提供硬性引导,仅作为信息存储与展示。

图鉴类型 数据来源 解锁方式 完成奖励
怪物图鉴 GDD-19 怪物数据 击杀/遭遇解锁 怪物信息展示 + 掉落预览
功法图鉴 GDD-04 功法数据 接触/学习/遗忘记录 功法信息展示 + 收藏加成
种族图鉴 GDD-01 种族数据 首次相遇/洪荒史书 种族信息展示
装备图鉴 GDD-20 装备数据 见过/打造记录 装备信息展示
地图探索图鉴 GDD-08 地图数据 迷雾点亮(W02 区域信息展示 + 探索进度

4.2 怪物图鉴

接入 GDD-19 怪物数据,怪物图鉴是战斗玩家的核心收集目标。

4.2.1 解锁机制

解锁条件 解锁内容 说明
首次击杀 怪物基础信息(名称/兽阶/神话体系/形态) 最基本的解锁方式
击杀 N 次10/50/100 怪物详细信息(属性范围/技能组/弱点) 逐步解锁,鼓励反复狩猎
击杀稀有/首领级 掉落表预览(不显示概率) 高兽阶怪物信息更珍贵
驯化成功 驯化信息(成功率/驯化后能力) 驭兽生活技能专属解锁

4.2.2 信息展示层级

层级 信息内容 解锁条件
初见 名称、兽阶、神话体系、外观剪影 首次遭遇(含被攻击)
交手 属性范围、元素类型、1-2 个技能名 首次击杀
熟知 完整技能组、弱点、掉落表(品类,不含概率) 击杀 50 次或击杀首领级
通晓 变体信息、词缀组合、驯化条件 击杀 100 次或驯化成功

4.2.3 怪物图鉴与 GDD-19 的接口

怪物图鉴条目 = GDD-19 怪物 Schematemplate_id/name/tier_beast/mythos/...
             + 玩家解锁状态unlock_level: 0-4
             + 玩家击杀统计kill_count/tame_success_count
             + 掉落预览drop_table 可见条目,概率隐藏)
  • 生成引擎怪物程序化生成的怪物变体GDD-19 §4共享同一 template_id 的图鉴条目,击杀任意变体均计入该条目进度。
  • 签名怪物:手工精修的命名 BossGDD-19 §8拥有独立图鉴条目,信息更丰富。

4.2.4 怪物图鉴奖励

完成度 奖励
某兽阶全解锁(如凡兽全收集) 该兽阶材料掉落 +2%(永久)
某神话体系全解锁(如洪荒体系全收集) 该体系怪物伤害 +1%(永久)
全兽阶全体系全解锁 称号「万物之鉴」+ 全怪物伤害 +1%(永久)

属性加成上限:怪物图鉴提供的属性加成合计上限 +3%,防止图鉴成为硬性战力来源。

4.3 功法图鉴

接入 GDD-04 功法数据,功法图鉴记录玩家接触过的所有功法。

4.3.1 记录状态

状态 含义 触发条件
已接触 玩家通过情报/交易/残卷等途径知晓该功法存在,但未学习 获得功法碎片/残卷/残页/原本;NPC 讲述;情报购买
已学习 玩家当前正在修炼或曾经修炼过该功法 装备到主修/副修槽
已遗忘 玩家曾经学习过但已放弃/融合/传承的功法 功法被融合GDD-04 6.4.3或传承GDD-04 6.4.4

4.3.2 信息展示

信息类型 已接触 已学习 已遗忘
功法名称
品阶
体系
功能类型
当前层数/最高层数 ✓(遗忘时层数)
战技解锁列表 ✓(已解锁的战技)
功法相性信息 ✓(已发现的相性)

4.3.3 功法图鉴与 GDD-04 的接口

  • 功法图鉴复用 GDD-04 §6.1 功法获取途径数据与 §6.2 战技解锁规则。
  • 功法相性信息GDD-04 §7.3)在图鉴中展示已发现的相性效果,未发现的显示「???」。
  • 功法图鉴不展示数值加成的具体百分比(符合"概率驱动、信息不对称"原则),仅展示功法名称/品阶/体系/战技名称等定性信息。

4.3.4 功法图鉴奖励

完成度 奖励
每收藏 10 个不同功法 能量上限 +0.5%永久,GDD-04 6.4.5 已定)
每收藏 1 个同类型功法 该类型技能伤害 +0.3%(永久)
集齐某功法全部战技 该功法内力加成 +2%(永久)

4.4 种族图鉴

接入 GDD-01 种族数据。种族图鉴的特殊之处在于:种族出生地隔离GDD-02 45、GDD-08 D03导致玩家在炼气期无法直接接触其他种族。

4.4.1 解锁机制

解锁方式 解锁条件 解锁内容
首次相遇 在层级 2+(灵界)首次遇到其他种族玩家 该种族基础信息(名称/阵营/外观)
洪荒史书 在任意层级城镇的「史官」NPC 处阅读洪荒史书 未直接遇到的种族的基础信息(名称/阵营/背景故事)
深入交互 与该种族玩家组队/交易/PVP/结义/道侣 该种族详细信息(天赋方向/能量命名/境界名称)
转生/转化 转生或转化为该种族 该种族全部信息(含隐藏天赋方向,不展示具体效果)

4.4.2 洪荒史书机制

由于种族出生地隔离(45,玩家在炼气期无法直接看到其他种族。洪荒史书是种族图鉴的主要补充来源

维度 规则
位置 各层级城镇的「史官」NPC
内容 记载洪荒大陆各种族的历史、文化、阵营归属、外貌描述
限制 仅展示基础信息,不展示天赋效果/能量命名/境界名称等需深入交互才能获得的信息
费用 阅读免费,但每次阅读有 3 游戏天冷却(防止一口气全解锁)
设计意图 让玩家在出生地就能"听说"其他种族的存在,激发探索欲望,但不破坏首次相遇的仪式感

4.4.3 种族图鉴奖励

完成度 奖励
首次记录任意种族 称号「初识万族」
记录同阵营全部种族 该阵营 NPC 亲善度 +50
记录全部 19 个种族 称号「万族之眼」+ 全种族 NPC 亲善度 +30
全种族满信息(深入交互级) 称号「知万族者」+ 种族图鉴全解锁外观

4.5 装备图鉴

接入 GDD-20 装备数据,装备图鉴记录玩家见过和打造过的装备。

4.5.1 记录状态

状态 含义 触发条件
已见 玩家在交易行/他人身上/掉落中看到过该装备 浏览交易行、查看他人装备、拾取掉落
已打造 玩家亲手打造过该装备 生活技能打造成功
已穿戴 玩家曾穿戴过该装备 装备到角色身上

4.5.2 信息展示

信息类型 已见 已打造 已穿戴
装备名称
品阶/品质
打造路径
主材料
词条范围 ✓(实际 roll 值)
特效/特技 ✓(已触发的)

4.5.3 装备图鉴奖励

完成度 奖励
某打造路径全品阶记录 该路径打造成功率 +1%(永久)
全打造路径全品阶记录 称号「百器通晓」+ 全路径打造成功率 +1%(永久)
极品装备已打造记录 10 件 称号「匠之心」

4.6 地图探索图鉴

接入 GDD-08 地图数据与 GDD-18 地图生成引擎,地图探索图鉴记录玩家的探索进度。

4.6.1 迷雾点亮机制(W02

维度 规则
初始状态 除玩家出生地外,所有区域默认覆盖「迷雾」
点亮方式 玩家进入该区域时自动点亮(即时);通过「洪荒史书」/情报购买可部分点亮(仅显示区域名称与大致位置)
点亮内容 区域名称、地形类型、资源分布概览、已发现的怪物/奇遇/秘境标记
迷雾残留 即使点亮后,该区域的隐藏要素(稀有矿脉/隐藏副本入口/秘密 NPC仍需玩家实际探索才能标记

4.6.2 探索进度统计

统计维度 说明
区域点亮率 已点亮区域数 / 当前境界可及区域总数
秘境发现率 已发现秘境数 / 该层已生成秘境总数
奇遇触发数 已触发奇遇事件总数(不展示类型,防止逆向推导概率)
突破记录 已触发的境界突破行为列表(注意:此处「突破记录」指玩家自身的境界突破历程,与 GDD-08 中的「天启事件」——新世界发现全服事件——含义不同)

4.6.3 地图探索图鉴奖励

完成度 奖励
某层世界区域点亮 50% 该层探索效率 +2%(永久)
某层世界区域点亮 100% 称号「{层名}通晓者」+ 该层隐藏要素发现率 +5%
全层世界区域点亮 100% 称号「洪荒通晓者」+ 全层探索效率 +2%(永久)

五、称号系统

5.1 称号来源

称号来自多个系统,是玩家身份与成就的综合展示:

来源 称号类型 示例 获取方式
成就系统 成就称号 「初猎」「四凶克星」「万物之鉴」 完成对应成就
里程碑系统 里程碑称号 「天启先驱」「飞升者」「域主」 全服首次达成(唯一)
祖地荣誉62 祖地称号 「不周山守护者」「辉光圣林之友」 祖地荣誉系统 5 级
佣兵信用GDD-13 B07 佣兵称号 「佣兵之王」「信用 S」 信用评级达到对应等级
界域域主146 域主称号 「{界域名}域主」 成为界域域主
种族/阵营 身份称号 「龙族真血」「混沌裔」「叛族者」 种族身份/阵营归属/转生标记
社交关系 关系称号 「{角色名}之道侣」「{帮派名}长老」 道侣/结义/帮派职位
隐藏事件 隐藏称号 「赤心不悔」「时间漫游者」 隐藏成就/稀有事件

5.2 称号效果

称号按效果分为三个等级:

效果等级 说明 示例
纯展示 仅显示在角色名前/后,无任何属性加成 「初猎」「开刃」「{帮派名}长老」
属性微增 提供微量永久属性加成 「四凶克星」(全怪物伤害 +1%)、「佣兵之王」(接单上限 +3
特殊功能 解锁特殊功能或交互 「域主」(界域税收特权)、「史官」(服务器编年史编辑权)

属性微增规则

  • 所有称号提供的属性微增合计上限 +5%(与成就系统共享上限)。
  • 同时只能装备 1 个称号生效(属性加成),但可展示多个称号(仅外观)。
  • 切换称号有 1 游戏天冷却(防止频繁切换套属性)。

5.3 称号切换与展示

维度 规则
装备槽 1 个装备槽(属性生效)+ 3 个展示槽(仅外观)
切换冷却 装备槽切换1 游戏天冷却;展示槽切换:无冷却
展示位置 角色名片、聊天频道、排行榜、组队界面、PVP 战报
隐藏选项 玩家可选择隐藏称号(不显示任何称号)

5.4 称号数据模式

{
  "title_id": "title_beast_slayer",
  "name": "四凶克星",
  "description": "击杀全部四凶的勇者",
  "source": "achievement",        // achievement/milestone/honor/mercenary/domain/race/social/hidden
  "source_id": "ach_kill_four_xiong",
  "effect_type": "attribute",     // display/attribute/special
  "effects": [
    {"type": "monster_damage_bonus", "value": 0.01}
  ],
  "rarity": "legendary",          // common/uncommon/rare/legendary/unique
  "is_unique": false,             // 全服唯一
  "display_slots": 1              // 占用展示槽数
}

六、系统间接口

系统 接口点
GDD-02 底层核心 成就/里程碑遵循概率驱动原则(37;无任务系统对齐;高死亡惩罚下成就不减免死亡损失
GDD-01 种族系统 种族图鉴数据源;种族专属成就;称号中的种族身份标记;出生地隔离下的洪荒史书机制(45
GDD-03 战斗系统 战斗类成就数据源(击杀/暴击/闪避统计);战报中展示称号
GDD-04 功法系统 功法图鉴数据源;功法收藏加成6.4.5;自创技能里程碑6.6.2
GDD-05 生活技能 制造类成就数据源;装备图鉴中的打造路径数据
GDD-08 地图系统 地图探索图鉴数据源;天启里程碑(D11;迷雾点亮机制W02
GDD-11 转生系统 转生相关成就;种族图鉴中的转生解锁
GDD-12 渡劫系统 渡劫成就与里程碑;三系修炼代价成就
GDD-13 佣兵系统 佣兵信用称号(B07;佣兵相关成就
GDD-17 技能总库 技能收藏图鉴;自创技能里程碑
GDD-19 怪物图鉴 怪物图鉴数据源(M01-M08;击杀统计;掉落预览
GDD-20 装备系统 装备图鉴数据源(E01-E10;打造统计
GDD-22 随机事件 奇遇类成就数据源;探索类成就

七、技术实现要点

7.1 数据存储

数据类型 存储位置 说明
成就/里程碑定义 Nacos 配置表 支持热更新,新成就可不发版上线
玩家成就状态 PostgreSQLplayer_achievements player_id + achievement_id + unlocked_at + progress
图鉴解锁状态 PostgreSQLplayer_codex player_id + codex_type + entry_id + unlock_level + stats
称号数据 PostgreSQLplayer_titles player_id + title_id + equipped_slot + obtained_at
里程碑记录 PostgreSQLserver_milestones server_id + milestone_id + player_id + achieved_at
服务器编年史 PostgreSQLserver_chronicle server_id + event_type + player_id + event_data + created_at

7.2 缓存策略

数据 缓存位置 说明
玩家已装备称号 Valkey 高频读取(每次战斗/交互展示)
里程碑达成状态 Valkey 全服共享,防止重复触发
图鉴解锁状态 ValkeyLRU 按需加载,减少 DB 查询

7.3 性能考量

场景 策略
成就条件判定 事件驱动:各系统在关键行为发生时主动推送事件到成就服务,成就服务异步判定,不轮询
图鉴解锁 延迟写入:图鉴解锁状态在战斗/交互结束后批量写入 DB,不阻塞主流程
全服广播 通过 Nakama 实时消息推送,里程碑/传说成就广播走独立频道,不污染普通聊天
服务器编年史 异步写入,允许延迟 1~5 秒

7.4 Go 插件接口Nakama 3.x

// 成就服务接口Go 插件)
type AchievementService interface {
    // 检查并解锁成就
    CheckAndUnlock(ctx context.Context, playerID string, eventType string, eventData map[string]interface{}) ([]string, error)
    // 获取玩家成就列表
    GetPlayerAchievements(ctx context.Context, playerID string) ([]PlayerAchievement, error)
    // 获取玩家成就统计
    GetAchievementStats(ctx context.Context, playerID string) (AchievementStats, error)
}

// 图鉴服务接口
type CodexService interface {
    // 更新图鉴条目
    UpdateEntry(ctx context.Context, playerID string, codexType string, entryID string, unlockLevel int) error
    // 获取图鉴数据
    GetCodex(ctx context.Context, playerID string, codexType string) ([]CodexEntry, error)
}

// 里程碑服务接口
type MilestoneService interface {
    // 尝试达成里程碑(原子操作,防并发)
    TryAchieve(ctx context.Context, playerID string, milestoneID string) (bool, error)
    // 获取服务器里程碑列表
    GetServerMilestones(ctx context.Context, serverID string) ([]Milestone, error)
}

// 称号服务接口
type TitleService interface {
    // 授予称号
    GrantTitle(ctx context.Context, playerID string, titleID string) error
    // 装备称号
    EquipTitle(ctx context.Context, playerID string, titleID string, slot int) error
    // 获取玩家称号列表
    GetPlayerTitles(ctx context.Context, playerID string) ([]PlayerTitle, error)
}

八、已确认决策记录表

# 决策 来源
A01 成就不引导行为:成就仅记录已完成行为,不做进度条/推荐/提示,对齐无任务系统 本章 §一
A02 隐藏成就占比 20%~25%:条件隐藏、不可查询、发现时弹出动画 本章 §2.4
A03 成就属性微增上限 +5%:与称号系统共享上限,防止成就成为硬性战力来源 本章 §2.3
A04 里程碑全服唯一:每个里程碑仅第一次触发者获得,永久记录于服务器编年史 本章 §3.1
A05 里程碑奖励侧重社交资本:称号/外观/广播为主,附带属性微增上限 +3% 本章 §3.3
A06 怪物图鉴四层解锁:初见/交手/熟知/通晓,逐步展示更多信息 本章 §4.2.2
A07 怪物图鉴属性加成上限 +3%:兽阶全收集/体系全收集/全收集分别给加成 本章 §4.2.4
A08 功法图鉴三态记录:已接触/已学习/已遗忘,不同状态展示不同信息 本章 §4.3.1
A09 种族图鉴通过洪荒史书补充:出生地隔离下,史官 NPC 提供基础种族信息,3 游戏天冷却 本章 §4.4.2
A10 装备图鉴三态记录:已见/已打造/已穿戴,不同状态展示不同信息 本章 §4.5.1
A11 地图探索图鉴接入迷雾点亮:初始覆盖迷雾,进入点亮,隐藏要素需实际探索 本章 §4.6.1
A12 称号同时装备 1 个+展示 3 个:装备槽属性生效,展示槽仅外观 本章 §5.3
A13 称号属性微增上限 +5%:与成就系统共享上限 本章 §5.2
A14 称号切换冷却 1 游戏天:装备槽切换有冷却,展示槽无冷却 本章 §5.3
A15 成就/图鉴数据永久保留:不做赛季清零,对齐项目无赛季设计 本章 §一
A16 成就系统事件驱动判定:各系统主动推送事件到成就服务,异步判定,不轮询 本章 §7.3
A17 图鉴不展示具体概率/数值百分比:符合概率驱动与信息不对称原则 本章 §4.3.3
A18 里程碑全服广播:所有里程碑均全服广播,格式统一 本章 §3.3

九、验收标准

# 验收项 验收标准
V01 成就分类覆盖 7 大类(修炼/战斗/探索/制造/社交/收集/特殊)各有 ≥10 条成就
V02 成就层级分布 铜 ~50% / 银 ~30% / 金 ~15% / 传说 ~5%,隐藏成就占比 20%~25%
V03 隐藏成就发现 隐藏成就条件完全隐藏,发现时弹出动画,未发现的不计入统计
V04 成就属性上限 成就+称号属性微增合计 ≤ +5%
V05 里程碑唯一性 每个里程碑全服仅一人/一队获得,数据库层面原子操作防并发
V06 里程碑广播 所有里程碑触发时全服广播,格式正确
V07 服务器编年史 所有里程碑事件永久记录,可查询
V08 怪物图鉴四层解锁 初见/交手/熟知/通晓四层信息逐步展示
V09 怪物图鉴与 GDD-19 对接 生成引擎怪物共享 template_id 图鉴条目,签名怪物独立条目
V10 功法图鉴三态 已接触/已学习/已遗忘三态正确切换,信息展示差异化
V11 种族图鉴洪荒史书 出生地隔离下可通过史官 NPC 查看未遇到种族的基础信息,3 游戏天冷却
V12 装备图鉴三态 已见/已打造/已穿戴三态正确切换,信息展示差异化
V13 地图探索迷雾点亮 初始覆盖迷雾,进入点亮,隐藏要素需实际探索
V14 称号装备/展示 1 装备槽(属性)+ 3 展示槽(外观),切换冷却正确
V15 称号属性上限 称号属性微增合计 ≤ +5%(与成就共享上限)
V16 数据持久化 成就/图鉴/称号/里程碑数据永久保留,重启不丢失
V17 事件驱动判定 成就判定为异步事件驱动,不阻塞战斗/交互主流程
V18 Nacos 热更新 成就/里程碑定义可通过 Nacos 热更新,无需发版
V19 全服广播性能 里程碑/传说成就广播不造成消息队列积压
V20 图鉴数值隐藏 图鉴不展示具体概率/数值百分比,仅展示定性信息

十、待设计内容

  • 各大类成就完整清单(每类 ≥10 条,含隐藏成就)
  • 里程碑扩展清单(随版本迭代)
  • 怪物图鉴与 GDD-19 生成引擎的具体接口协议
  • 功法图鉴与 GDD-04 功法相性系统的展示细节
  • 装备图鉴与 GDD-20 装备生成引擎的具体接口协议
  • 称号美术规范(字体/颜色/特效/位置)
  • 图鉴 UI 交互设计稿
  • 成就/图鉴奖励的具体数值平衡(待 GDD-21 联调)

GDD-30 v1.1 | 2026-07-02 | 术语消歧§4.6.2 中「天启记录」改为「突破记录」,避免与 GDD-08「天启事件」新世界发现全服事件混淆;补充括注说明两者区别 | 前序v1.0

GDD-30 v1.0 | 2026-07-02 | 初版:成就/里程碑/图鉴/称号四大系统完整设计,含 18 条本地决策(A01-A18、20 条验收标准、技术实现要点