游戏玩法 PRD 总览
文档编号：PRD-000
版本：v1.0
状态：已通过
适用端：策划 / 服务端 / 客户端 / 测试
本分类存放 Zebra 服务端各玩法系统的产品需求文档（PRD）。每份 PRD 都包含规则设计、服务端设计、客户端设计、配置结构、异常边界、验收标准，目标是让策划、服务端、客户端、测试可以基于同一份文档并行工作。
一、文档规范
| 项目 | 规范 |
|---|---|
| 文件名 | YYYYMMDD-NN.md，日期为立项日期，NN 为顺序号 |
| 标题 | 只写在正文第一行 H1，不使用 frontmatter title |
| 排序 | 总览置顶，PRD 编号从大到小展示（74 → 01） |
| 编号 | PRD-NNN，与文件名顺序号一致，共 73 份玩法 PRD |
| 状态 | 草稿 → 评审中 → 已通过 → 开发中 → 已上线 → 已废弃 |
| 关联模块 | 必须写明服务端模块、协议头文件、配置表 |
二、PRD 固定结构
- 背景与目标：为什么做、解决什么问题、不做什么。
- 核心规则：玩家可感知的完整规则，含数值公式与优先级。
- 服务端设计：模块职责、数据结构、协议、流程、持久化、并发。
- 客户端设计：交互流程、UI 结构、协议处理、表现、断线重连。
- 配置与数值：表结构、字段、示例、热更方式。
- 边界与异常：重复请求、越权、掉线、满包、跨天、回档。
- 埋点与运营：关键漏斗、日志字段、后台可配置项。
- 验收标准：可执行的功能/性能/安全验收项。
三、服务端与客户端职责边界
| 职责 | 服务端 | 客户端 |
|---|---|---|
| 数值结算 | 唯一权威，所有结果以服务端为准 | 只做表现与预判 |
| 状态变更 | 校验前置条件、扣费、写库 | 发请求、锁按钮、展示结果 |
| 随机 | 服务端随机并记录种子/日志 | 不参与随机 |
| 时间 | 服务端时间，处理跨天/时区 | 只做倒计时显示 |
| 防作弊 | 校验距离、CD、背包、货币、权限 | 不做安全假设 |
| 断线重连 | 保留会话/快照，补发关键状态 | 重连后拉全量状态 |
四、PRD 清单
| 编号 | 玩法 | 服务端重点 | 客户端重点 |
|---|---|---|---|
| PRD-031 | 战斗与伤害结算 | 命中/暴击/减伤/结算顺序 | 飘字、受击、死亡表现 |
| PRD-030 | 技能系统 | 学习、冷却、消耗、打断 | 技能栏、CD、目标选择 |
| PRD-029 | Buff/Debuff 状态 | 叠加、刷新、驱散、免疫 | 图标、层数、剩余时间 |
| PRD-028 | 怪物 AI 与刷新 | 仇恨、巡逻、回归、掉落归属 | 血条、警戒、刷新表现 |
| PRD-027 | 任务系统 | 接取、进度、提交、链式 | 任务追踪、寻路、对话 |
| PRD-026 | 副本系统 | 创建、进度、结算、次数 | 副本面板、倒计时、结算 |
| PRD-025 | 装备系统 | 穿戴、属性、绑定、耐久 | 背包对比、预览、替换 |
| PRD-024 | 强化与升星 | 成功率、保底、材料、降级 | 强化动画、预览、连点 |
| PRD-023 | 宝石镶嵌 | 孔位、拆卸、合成、属性 | 镶嵌面板、孔位提示 |
| PRD-022 | 背包与仓库 | 格子、堆叠、整理、扩容 | 拖拽、排序、批量使用 |
| PRD-021 | 掉落与拾取 | 归属、保护、Roll、自动拾取 | 地面物品、拾取提示 |
| PRD-020 | 商店与商城 | 货币、限购、折扣、发货 | 分类、购买确认、红点 |
| PRD-019 | 拍卖行 | 挂单、竞价、手续费、过期 | 搜索、排序、出价 |
| PRD-018 | 面对面交易 | 锁定、校验、防骗、日志 | 交易框、二次确认 |
| PRD-017 | 邮件系统 | 附件、过期、批量领取 | 邮件列表、附件展示 |
| PRD-016 | 组队系统 | 分配、跟随、踢人、跨图 | 队伍面板、标记 |
| PRD-015 | 好友与黑名单 | 关系链、在线状态、私聊 | 好友列表、快捷聊天 |
| PRD-014 | 帮会系统 | 创建、职位、建设、俸禄 | 帮会大厅、申请、任务 |
| PRD-013 | 排行榜 | 榜单、刷新、并列、赛季 | 榜单页、自己的排名 |
| PRD-012 | 签到与在线奖励 | 跨天、补签、在线计时 | 日历、红点、领取 |
| PRD-011 | 七日目标 | 阶段、任务、领取、过期 | 进度条、奖励预览 |
| PRD-010 | 抽奖/寻宝 | 概率、保底、十连、公示 | 抽奖动画、结果、记录 |
| PRD-009 | 坐骑系统 | 获取、培养、骑乘、属性 | 坐骑栏、骑乘切换 |
| PRD-008 | 宠物系统 | 捕捉、培养、出战、技能 | 宠物栏、出战设置 |
| PRD-007 | 翅膀/外观 | 升阶、幻化、属性、预览 | 外观页、幻化切换 |
| PRD-006 | 称号与成就 | 条件、属性、佩戴、解锁 | 称号列表、成就进度 |
| PRD-005 | 师徒系统 | 拜师、出师、任务、奖励 | 师徒面板、推荐 |
| PRD-004 | 情缘/结婚 | 求婚、婚礼、技能、离婚 | 求婚、婚礼场景、夫妻信息 |
| PRD-003 | PK/红名/监狱 | PK 值、爆装、惩罚、洗红 | 名字颜色、PK 提示 |
| PRD-002 | 竞技场/天梯 | 匹配、赛季、积分、结算 | 匹配、对战、赛季奖励 |
| PRD-001 | 国战/攻城战 | 报名、城门、大将军、结算 | 战场地图、阵营、进度 |
家庭与子嗣（PRD-073 ～ PRD-074）
| 编号 | 玩法 | 服务端重点 | 客户端重点 |
|---|---|---|---|
| PRD-074 | 子女养育与成长 | 阶段、互动、职业、家庭加成 | 子女房间、成长线 |
| PRD-073 | 子嗣生育 | 求子、怀孕、资质继承 | 怀孕进度、接生 |
数值竞技玩法（PRD-053 ～ PRD-072）
| 编号 | 玩法 | 服务端重点 | 客户端重点 |
|---|---|---|---|
| PRD-072 | 跨服公会联赛 | 报名、分组、赛程、晋级 | 赛程图、战场 HUD |
| PRD-071 | 生存竞技 | 缩圈、物资、淘汰排名 | 安全区、存活人数 |
| PRD-070 | 5v5 夺旗战场 | 旗子状态、得分、复活 | 旗子标记、比分 |
| PRD-069 | 3v3 精英赛 | 组队匹配、积分、赛季 | 队伍大厅、比分 |
| PRD-068 | 1v1 擂台切磋 | 连胜、让分、判定 | 擂台、连胜展示 |
| PRD-067 | 副本竞速榜 | 计时、罚时、有效性 | 计时器、榜单 |
| PRD-066 | 伤害挑战与木桩 | DPS 统计、职业榜 | 实时 DPS、占比 |
| PRD-065 | 无尽爬塔 | 层数、增益、排名 | 三选一、层数 |
| PRD-064 | 元素克制与抗性 | 克制、抗性、穿透 | 元素提示、弱点 |
| PRD-063 | 修炼与心法 | 修炼位、突破、羁绊 | 修为、突破、羁绊 |
| PRD-062 | 转生与轮回 | 重置、保留、转生点 | 转生预览、加点 |
| PRD-061 | 等级封印与世界等级 | 封印、解锁、追赶 | 封印经验、公告 |
| PRD-060 | 图鉴收集与属性 | 解锁、里程碑、属性 | 收集度、图鉴 |
| PRD-059 | 战魂与星魂 | 槽位、套装、星图 | 战魂、星图 |
| PRD-058 | 神器系统 | 升级、觉醒、共鸣 | 槽位、主动技能 |
| PRD-057 | 附魔与铭文 | 卷轴、成功率、套装 | 附魔槽、套装 |
| PRD-056 | 洗练与词条重铸 | 词条池、锁定、保底 | 新旧对比、锁定 |
| PRD-055 | 转职与职业进阶 | 分支、技能/装备映射 | 转职预览、回退 |
| PRD-054 | 天赋树与属性点 | 节点、前置、重置 | 天赋树、预设 |
| PRD-053 | 属性与战力系统 | 属性汇总、战力公式 | 属性分项、战力 |
Lua 扩展玩法（PRD-033 ～ PRD-052）
| 编号 | 玩法 | 服务端重点 | 客户端重点 |
|---|---|---|---|
| PRD-052 | 限时增益活动 | 倍率时段、同类取最高、上限裁剪 | 增益图标、倒计时 |
| PRD-051 | 资源点争夺 | 占领、保护期、产出、帮会分红 | 资源点归属、进度 |
| PRD-050 | 帮会竞拍分红 | 竞拍、冻结、流拍、分红 | 竞拍页、分红明细 |
| PRD-049 | 好友召回 | 邀请码、回流判定、里程碑 | 邀请码、任务进度 |
| PRD-048 | 许愿池 | 免费次数、许愿值、保底 | 许愿动画、心愿墙 |
| PRD-047 | 世界随机事件 | 随机触发、事件实体、奖励 | 地图事件图标、选项 |
| PRD-046 | 赛马竞速 | 检查点、加速带、排名 | 赛道 HUD、观战 |
| PRD-045 | 怪物攻城 | 波次、城门、贡献 | 波次 HUD、城门血量 |
| PRD-044 | 阵营刺探 | 情报点、伪装、追杀 | 伪装状态、情报品质 |
| PRD-043 | 帮会篝火宴会 | 开启、燃料、经验、结算 | 篝火场景、互动 |
| PRD-042 | 节日活动框架 | 阶段、子脚本、兑换 | 活动主面板、子玩法 |
| PRD-041 | 藏宝图寻宝 | 坐标、挖宝、随机事件 | 罗盘、挖掘表现 |
| PRD-040 | 跑环任务 | 任务池、轮次、星级 | 跑环面板、寻路 |
| PRD-039 | 每日答题 | 题库、场次、计分 | 答题面板、排名 |
| PRD-038 | 烹饪与制药 | 配方、成功率、品质 | 配方列表、制作 |
| PRD-037 | 采集与生活技能 | 节点、体力、刷新 | 资源点高亮、读条 |
| PRD-036 | 钓鱼玩法 | 鱼点、咬钩、鱼种 | 浮漂、张力条 |
| PRD-035 | 温泉泡点 | 区域、定时经验、挂机衰减 | 温泉 HUD、经验飘字 |
| PRD-034 | 运镖与劫镖 | 镖车、路线、劫镖 | 镖车血条、路线 |
| PRD-033 | 世界 BOSS 定时活动 | 定时刷新、阶段、伤害排行 | BOSS 血条、排行 |
注：PRD 文件名统一为
20261020-NN.md，编号与文件名顺序号一致。
五、Lua 扩展约定
数值类脚本只做配置加载/公式计算/校验，不进入每次伤害热路径；竞技类脚本负责赛程、匹配、积分与结算。
PRD-033 ～ PRD-074 的服务端主流程保持稳定，玩法逻辑优先放 Lua：
- 脚本路径：
lua/activity/、lua/world/、lua/guild/、lua/life/、lua/quest/、lua/numeric/、lua/arena/、lua/family/。 - 统一入口：
OnStart、OnStop、OnPlayerEvent、OnTimer、OnPhase，由LuaActivityMgr注册。 - 只通过
ctx接口操作实体、发奖、扣物品，禁止直接访问 DB。 - 每个回调 50ms 超时；连续 3 次异常自动停用脚本并告警。
- 状态写
ctx.state，由RecordServer快照，重启后按快照恢复。 - 热更：
//reloadlua <name>，进行中的实例保留旧版本。 - GM：
//lua start|stop|status|reload <name>。
六、通用约定
- 服务端权威：客户端发起的任何操作都必须由服务端校验；客户端预表现不能作为结算依据。
- 失败要可解释：所有失败返回错误码 + 可展示文案，禁止客户端只收到“操作失败”。
- 配置热更：玩法参数优先放 XML/Lua，支持
//loadtbl、//loadquest等 GM 命令重载。 - 日志可追溯：涉及货币、物品、抽奖、交易的请求必须记录
role_id、request_id、变更前后值。 - 兼容旧存档：新增字段必须给默认值；旧客户端/旧存档不得导致登录失败。
七、评审流程
- 策划提交 PRD，状态改为「评审中」。
- 服务端评审：协议、数据结构、并发、回档方案。
- 客户端评审：交互、UI 资源、协议时序。
- 测试评审：验收项、异常场景、埋点。
- 评审通过后状态改为「已通过」，进入排期。