lawless-design/docs

洪荒大陆 · 挂机手游 · 文档中心

游戏名（暂定）：洪荒大陆 类型：文字战斗 / 挂机 / 修仙 RPG 平台：Android、iOS、鸿蒙 NEXT 当前阶段：客户端实现阶段（设计阶段已于 2026-07-06 结束） 最后更新：2026-07-06

阶段说明：用户已于 2026-07-06 明确宣布进入下一阶段，正式启动客户端开发。此前"设计文档定稿期不做技术实现"的冻结解除。当前聚焦：Cocos Creator 3.8.8 客户端启动/注册/登录/选择角色四个场景的实现，本地 Android 模拟器验证。已生成的代码骨架（server/、client/、api/、database/、configs/、docker-compose.yml 等）从"仅保留的设计产物"转为"可继续开发的基线"。

---

文档目录

设计文档（GDD）

📌 决策编号已归一：所有决策以 GDD-00 决策总索引 为单一事实源。核心决策 ✅1–99（GDD-02 权威）；地图域 ✅D/✅Q（GDD-08）；各文档本地 ✅N 跨文档引用须带前缀（如 GDD-05 ✅8）。

🤝 多智能体协作：并行编辑前必读 协作约定（CONTRIBUTING）——文档归属软锁、开工前读最新、决策只追加不重排、合并裁决以 GDD-00 为权威。

编号	文档	状态	最后更新
GDD-00	决策总索引	✅ v2.3（全量梳理：新增✅158-✅163，能量吸收内力/世界命名统一/附录B合并等；标注GDD-02本地编号与本表✅100+区间冲突的遗留结构性问题）	2026-07-06
GDD-01	种族系统设计	✅ v2.14（修复人族学习效率数值矛盾15%/25%；补全混沌裔/深潜裔T7-T9境界名；修复版本号重复）	2026-07-06
GDD-02	底层核心机制设计	✅ v4.5（反转✅6，取消独立"内力"资源并入能量上限值；新增能量当前值/上限值双轨增长+顿悟触发模型✅158；同步四档恢复梯度）	2026-07-06
GDD-03	战斗系统设计	✅ v2.4（HP系数/防御常数补齐大乘渡劫飞升三档；层级命名统一为出生地/洪荒边境/太古秘境/混沌之渊/界域）	2026-07-06
GDD-04	功法系统设计	✅ v1.14（修复槽位数量限制自相矛盾；新增功法品阶双重影响✅158：涨得快但目标阈值也高）	2026-07-06
GDD-05	职业与生活技能设计	✅ v1.19（修复T1-T6能量命名表标题与九大境界范围不符；章节编号冲突修复）	2026-07-06
GDD-06	经济系统设计	✅ v1.16（术语微调：主动打坐→主动闭关）	2026-07-06
GDD-07	帮派 / 门派 / 社交系统设计	✅ v2.7（术语澄清：无独立经验系统，"经验加成"改为"修炼加成"）	2026-07-06
GDD-08	大陆地图与区域开放系统	✅ v1.12（层级命名统一为大陆纵深区域式命名，废弃"凡界/灵界/道界/圣界/神域"；修复天启机制"发现新世界"内部矛盾）	2026-07-06
GDD-08-附录A	各层地图挂机资源	✅ v1.5（新增合体/大乘/渡劫/飞升挂机资源章节，此前完全空白；修复层级境界归属错标）	2026-07-06
GDD-08-附录B	各种族境界名称总表	✅ v3.0（与"扩展版"合并为单一权威文件；修复19种族T6/T7小境界系统性生成缺陷；"扩展版"降级为指向本文件的说明性桩文件）	2026-07-06
GDD-09	种族出生地与新手区域设计	✅ v1.8（补全此前完全缺失的人族出生地"洛书原"；补充天使裔总览表遗漏）	2026-07-06
GDD-10	隐藏天赋完整表	✅ v1.5（修复种族计数表述与实际条目数不符）	2026-07-06
GDD-11	种族转生与转化系统	✅ v1.7（修复✅87决策编号与GDD-00核心✅87撞号，血脉试炼期改用正确编号✅151）	2026-07-06
GDD-12	渡劫、破镜与境界掉落系统	✅ v1.9（新增第八章补齐此前完全空白的L7-L9大乘/渡劫/飞升三重天劫；成功率与境界系数表延伸至L9）	2026-07-06
GDD-13	佣兵大厅与悬赏系统	✅ v1.8（术语澄清：情报委托奖励"经验值"改为"能量/修炼进度"）	2026-07-06
GDD-14	稀有宝物流转与拍卖系统	✅ v1.6（本轮审查确认无问题，未变更）	2026-07-03
GDD-15	个性化成长与玩家驱动经济	✅ v1.9（大境界区域框架从6个补齐为9个，新增大乘/渡劫/飞升区域；金丹期激活善恶值对齐GDD-08）	2026-07-06
GDD-16	社交系统与玩法扩展	✅ v1.7（本轮审查确认无问题，未变更）	2026-07-03
GDD-17	技能总库	✅ v2.5（修复§五重号与§八跳号两处章节编号冲突；本地决策范围扩展至✅K01-K21）	2026-07-06
GDD-18	世界·地图·副本·遗迹生成引擎	✅ v2.4（修复决策表✅W01-W05重复条目；世界内容映射从六级改为五层）	2026-07-06
GDD-19	怪物图鉴与生成引擎	✅ v1.6（区域分布权重从六级改为五层，对齐✅136）	2026-07-06
GDD-20	武器装备与打造系统	✅ v1.6（修复品质字段5档/6档不符；修复对GDD-17已过期的章节引用）	2026-07-06
GDD-21	数值平衡与联调参数总表	✅ v1.8（新增§15.1背包容量与空间装备数值；同步能量恢复四档梯度与Nacos键）	2026-07-06
GDD-22	开放世界随机事件与玩家可交互内容层	✅ v1.2（本轮审查确认无问题，未变更）	2026-07-03
GDD-23	能量体系与功法相性设计	✅ v1.8（反转✅6取消独立内力资源；新增§2.3.2能量上限增长速度公式与顿悟触发桥接；恢复速度重排为四档）	2026-07-06
GDD-24	种族传承大师与稀有生活职业	✅ v1.3（修复品质轴与装备无法穿戴等表述；新增本地决策登记✅RM01-✅RM05，首次纳入GDD-00）	2026-07-06
GDD-25	洪荒大陆世界观设定	✅ v1.5（补全10个种族缺失的飞升境界叙事、8个未展开的势力详情、6个种族的神话体系归属）	2026-07-06
GDD-26	功法心法技能详细设计	✅ v1.3（修复"人族九道"与心法命名表与GDD-15权威定义不一致；补全飞升期数值行）	2026-07-06
GDD-27	修仙小说经典元素设计	✅ v1.4（修复"凤族"应为妖族分支"凤妖"的种族归属错误）	2026-07-06
GDD-28	神话体系与旧日邪神设计	✅ v2.4（修复4处错误的GDD-01种族章节引用；新增奥林匹斯/圣殿/堕落之地三个此前未展开的区域详情）	2026-07-06
GDD-29	聊天与信息传递系统设计	✅ v1.0（本轮审查确认无问题，未变更）	2026-07-02
GDD-30	成就里程碑与图鉴系统设计	✅ v1.1（本轮审查确认无问题，未变更）	2026-07-03
GDD-31	洞府与个人空间系统设计	✅ v1.4（修复第九境界名称误标"天启"应为"飞升"；术语引用修正）	2026-07-06
GDD-32	NPC与势力关系系统设计	✅ v1.1（本轮审查确认无问题，未变更）	2026-07-03
GDD-33	世界Boss与大型PVE协作机制	✅ v1.1（本轮审查确认无问题，未变更）	2026-07-03
GDD-34	好友与组队系统设计	✅ v1.3（修复第九境界名称误标；术语澄清"经验加成"改为"修炼加成"）	2026-07-06
GDD-35	新手引导系统设计	✅ v1.3（原编号GDD-29与聊天系统冲突，归一至GDD-35；天启引导时机修正；术语澄清"经验保护"改为"修炼进度保护"）	2026-07-06

需求文档（PRD）

编号	文档	状态	最后更新
PRD-01	核心玩法与系统需求	✅ v1.1（术语对齐：六级世界→五层世界、六大境界→九大境界、破界→天启、体力→能量，约15处）	2026-07-06
PRD-02	境界隔离系统需求	✅ v1.1（破界→天启29处；realm_tier范围1~6→1~9）	2026-07-06
PRD-03	热更新与活动系统需求	✅ v1.1（破界→天启术语对齐）	2026-07-06

技术文档（TDD）

编号	文档	状态	最后更新
TDD-00	整体技术栈方案	✅ 已完成 v1.2	2026-06-29
TDD-01	境界隔离系统技术设计	✅ 含于 TDD-00 第五章	2026-06-29
TDD-02	客户端热更新技术方案	✅ v1.0	2026-06-30
TDD-03	服务端开服自动化方案	✅ 含于 TDD-00 第四章	2026-06-29
TDD-04	数据库表结构设计	✅ v1.5（修复与并行任务的世界层级命名冲突，统一为GDD-08权威命名；characters表level/exp改为energy_current/energy_cap/energy_cap_ceiling）	2026-07-06
TDD-05	API 接口设计	✅ v1.2（同步✅158能量模型，响应示例移除level/exp字段）	2026-07-06
TDD-11	城镇野外实时位置同步与多人可见性设计	✅ v1.0（Nakama Realtime Match + 九宫格AOI + 150ms心跳 + 防作弊校验）	2026-07-06

⚠️ 本表 TDD 部分存在长期结构性滞后：docs/技术文档/ 目录下实际已有 TDD-01/03/06~10 共 10 份完整技术文档，但本表历史上一直只登记 TDD-00/02/04/05 四项（TDD-01/03 被标注为"含于 TDD-00"，与实际独立成文的状态不符）。本轮审查未对此结构性缺口做处理（超出本轮"发现问题即修复"范围，建议作为专项任务补齐 TDD-01/03/06~10 的 README 登记）。

实现骨架

目录	说明	状态
server/	Go + Nakama 服务端模块、配置、数据库连接、Makefile（可 go build -buildmode=plugin）	✅ 骨架已完成
client/assets/scripts/	Cocos Creator 3.x TypeScript 脚本骨架（登录/大厅/战斗/地图/背包/社交/设置 + 信息流/遭遇 UI）	✅ 骨架已完成
api/proto/	gRPC/Protobuf 协议定义	✅ honghuang.proto 已完成
api/openapi.yaml	RESTful OpenAPI 3.0 接口规范	✅ 已完成
database/migrations/	PostgreSQL 迁移脚本（up/down + seed）	✅ 001_init_schema 已完成
configs/nacos/	Nacos 配置模板（global/combat/economy/map/event/cultivation）	✅ 已完成

本地运行（开发环境）

# 1. 准备环境变量
cp .env.example .env
# 编辑 .env，确认 DATABASE_URL 等默认值即可用于 docker compose

# 2. 启动依赖服务（PG + Nakama + Valkey + Nacos）
docker compose up -d

# 3. 数据库迁移与 seed（等服务健康后）
make migrate
make seed

# 4. 构建并运行服务端（Nakama 插件模式）
cd server && make build
# Nakama 容器会自动加载 server/honghuang-server.so

# 5. 运行测试
cd server && go test ./...

说明：docker compose config 已校验通过；实际拉起需要本地安装 Docker。脚本已做 30 秒等待与幂等 seed。

---

核心设定速查

设定项	内容
世界观	洪荒大陆，融合中国上古神话 + 北欧/西方奇幻 + 克苏鲁域外邪神轴
战斗类型	文字战报 + ATB 行动速度制，速度差可导致 2-3 倍出手频率差
服务架构	感官单服，境界隔离（9大境界×大陆5层区域竞争池：出生地/洪荒边境/太古秘境/混沌之渊/界域，见 GDD-08 ✅136）
种族数量	19 种族（含转化/重生获得：人族、龙族、混沌裔、巨人族、堕天使裔；天使裔可创角）
时间流速	游戏内时间 = 现实 3 倍（默认时间口径为游戏时间）
成长哲学	大多数稀有资源/隐藏天赋靠机遇获取；创角不发天赋；无体力，靠能量/时间/风险/概率驱动
能量体系	移除体力；不存在独立"经验值/内力"，能量本身兼具成长进度（上限值持续增长）与主动资源（当前值可消耗）双重角色，受功法/状态/纯净度/丹毒影响；各族/职业有独立能量命名（"内力"仅为炼气期附近的展示名）
传承大师	每个种族有一个无法战斗的稀有生活大师职业；奇遇获取传承物品后专职；玩家可委托大师加工/布阵/炼丹
死亡惩罚	高惩罚基调（损失进度/纯度/产出/耐久 + 道伤）
充值	引入鸿蒙紫气充值（6档）；人族修真可做"偷渡"经纪；只加速不专属，不可买进度/解锁种族
平台	Android / iOS / 鸿蒙 NEXT
客户端引擎	Cocos Creator 3.x（Asset Bundle 热更）
服务端	Go + Nakama + PostgreSQL + Valkey

---

种族速查

阵营	种族
天道	人族（重生）、神族、精灵族（光明）、天使裔
洪荒	妖族（狐/蛇/虎/凤/猴）、龙族、巫族（12常规+2特殊传承）、兽人族、巨人族（矮人转化）
幽冥	鬼族、魔族、冥族、吸血鬼族、堕天使裔、精灵族（暗影）、深潜裔（克苏鲁）
混沌中立	地精族、矮人族、混沌裔

不可创角（转化/重生获得）：人族、龙族、混沌裔、巨人族、堕天使裔。