2026-07-02 16:55:34 +08:00
|
|
|
|
# 洪荒大陆 · 挂机手游 · 文档中心
|
|
|
|
|
|
|
|
|
|
|
|
> 游戏名（暂定）：洪荒大陆
|
|
|
|
|
|
> 类型：文字战斗 / 挂机 / 修仙 RPG
|
|
|
|
|
|
> 平台：Android、iOS、鸿蒙 NEXT
|
|
|
|
|
|
> 当前阶段：**游戏设计阶段 — 暂停技术实现**
|
2026-07-03 21:34:51 +08:00
|
|
|
|
> 最后更新：2026-07-06
|
2026-07-02 16:55:34 +08:00
|
|
|
|
>
|
|
|
|
|
|
> **阶段说明**：本项目当前处于设计文档定稿期。用户已明确要求，在宣布进入下一阶段前**不做技术实现**。已生成的代码骨架（`server/`、`client/`、`api/`、`database/`、`configs/`、`docker-compose.yml` 等）仅作为设计阶段产物保留，不继续开发、不新增业务逻辑、不提交生产代码。
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## 文档目录
|
|
|
|
|
|
|
|
|
|
|
|
### 设计文档（GDD）
|
|
|
|
|
|
|
|
|
|
|
|
> 📌 **决策编号已归一**：所有决策以 [GDD-00 决策总索引](设计文档/GDD-00-决策总索引.md) 为单一事实源。核心决策 `✅1–99`（GDD-02 权威）；地图域 `✅D/✅Q`（GDD-08）；各文档本地 `✅N` 跨文档引用须带前缀（如 `GDD-05 ✅8`）。
|
|
|
|
|
|
>
|
|
|
|
|
|
> 🤝 **多智能体协作**：并行编辑前必读 [协作约定（CONTRIBUTING）](协作约定.md)——文档归属软锁、开工前读最新、决策只追加不重排、合并裁决以 GDD-00 为权威。
|
|
|
|
|
|
|
|
|
|
|
|
| 编号 | 文档 | 状态 | 最后更新 |
|
|
|
|
|
|
|------|------|------|----------|
|
2026-07-03 21:34:51 +08:00
|
|
|
|
| GDD-00 | [决策总索引](设计文档/GDD-00-决策总索引.md) | ✅ v2.3（全量梳理：新增✅158-✅163，能量吸收内力/世界命名统一/附录B合并等；标注GDD-02本地编号与本表✅100+区间冲突的遗留结构性问题） | 2026-07-06 |
|
|
|
|
|
|
| GDD-01 | [种族系统设计](设计文档/GDD-01-种族系统设计.md) | ✅ v2.14（修复人族学习效率数值矛盾15%/25%；补全混沌裔/深潜裔T7-T9境界名；修复版本号重复） | 2026-07-06 |
|
|
|
|
|
|
| GDD-02 | [底层核心机制设计](设计文档/GDD-02-底层核心机制.md) | ✅ v4.5（反转✅6，取消独立"内力"资源并入能量上限值；新增能量当前值/上限值双轨增长+顿悟触发模型✅158；同步四档恢复梯度） | 2026-07-06 |
|
|
|
|
|
|
| GDD-03 | [战斗系统设计](设计文档/GDD-03-战斗系统设计.md) | ✅ v2.4（HP系数/防御常数补齐大乘渡劫飞升三档；层级命名统一为出生地/洪荒边境/太古秘境/混沌之渊/界域） | 2026-07-06 |
|
|
|
|
|
|
| GDD-04 | [功法系统设计](设计文档/GDD-04-功法系统设计.md) | ✅ v1.14（修复槽位数量限制自相矛盾；新增功法品阶双重影响✅158：涨得快但目标阈值也高） | 2026-07-06 |
|
|
|
|
|
|
| GDD-05 | [职业与生活技能设计](设计文档/GDD-05-职业与生活技能设计.md) | ✅ v1.19（修复T1-T6能量命名表标题与九大境界范围不符；章节编号冲突修复） | 2026-07-06 |
|
|
|
|
|
|
| GDD-06 | [经济系统设计](设计文档/GDD-06-经济系统设计.md) | ✅ v1.16（术语微调：主动打坐→主动闭关） | 2026-07-06 |
|
|
|
|
|
|
| GDD-07 | [帮派 / 门派 / 社交系统设计](设计文档/GDD-07-帮派门派社交系统设计.md) | ✅ v2.7（术语澄清：无独立经验系统，"经验加成"改为"修炼加成"） | 2026-07-06 |
|
|
|
|
|
|
| GDD-08 | [大陆地图与区域开放系统](设计文档/GDD-08-大陆地图与区域开放系统.md) | ✅ v1.12（层级命名统一为大陆纵深区域式命名，废弃"凡界/灵界/道界/圣界/神域"；修复天启机制"发现新世界"内部矛盾） | 2026-07-06 |
|
|
|
|
|
|
| GDD-08-附录A | [各层地图挂机资源](设计文档/GDD-08-附录A-各层地图挂机资源.md) | ✅ v1.5（新增合体/大乘/渡劫/飞升挂机资源章节，此前完全空白；修复层级境界归属错标） | 2026-07-06 |
|
|
|
|
|
|
| GDD-08-附录B | [各种族境界名称总表](设计文档/GDD-08-附录B-各种族境界名称.md) | ✅ v3.0（与"扩展版"合并为单一权威文件；修复19种族T6/T7小境界系统性生成缺陷；"扩展版"降级为指向本文件的说明性桩文件） | 2026-07-06 |
|
|
|
|
|
|
| GDD-09 | [种族出生地与新手区域设计](设计文档/GDD-09-种族出生地与新手区域设计.md) | ✅ v1.8（补全此前完全缺失的人族出生地"洛书原"；补充天使裔总览表遗漏） | 2026-07-06 |
|
|
|
|
|
|
| GDD-10 | [隐藏天赋完整表](设计文档/GDD-10-隐藏天赋完整表.md) | ✅ v1.5（修复种族计数表述与实际条目数不符） | 2026-07-06 |
|
|
|
|
|
|
| GDD-11 | [种族转生与转化系统](设计文档/GDD-11-种族转生与转化系统.md) | ✅ v1.7（修复✅87决策编号与GDD-00核心✅87撞号，血脉试炼期改用正确编号✅151） | 2026-07-06 |
|
|
|
|
|
|
| GDD-12 | [渡劫、破镜与境界掉落系统](设计文档/GDD-12-渡劫破镜与境界掉落系统.md) | ✅ v1.9（新增第八章补齐此前完全空白的L7-L9大乘/渡劫/飞升三重天劫；成功率与境界系数表延伸至L9） | 2026-07-06 |
|
|
|
|
|
|
| GDD-13 | [佣兵大厅与悬赏系统](设计文档/GDD-13-佣兵大厅与悬赏系统.md) | ✅ v1.8（术语澄清：情报委托奖励"经验值"改为"能量/修炼进度"） | 2026-07-06 |
|
|
|
|
|
|
| GDD-14 | [稀有宝物流转与拍卖系统](设计文档/GDD-14-稀有宝物流转与拍卖系统.md) | ✅ v1.6（本轮审查确认无问题，未变更） | 2026-07-03 |
|
|
|
|
|
|
| GDD-15 | [个性化成长与玩家驱动经济](设计文档/GDD-15-个性化成长与玩家驱动经济.md) | ✅ v1.9（大境界区域框架从6个补齐为9个，新增大乘/渡劫/飞升区域；金丹期激活善恶值对齐GDD-08） | 2026-07-06 |
|
|
|
|
|
|
| GDD-16 | [社交系统与玩法扩展](设计文档/GDD-16-社交系统与玩法扩展.md) | ✅ v1.7（本轮审查确认无问题，未变更） | 2026-07-03 |
|
|
|
|
|
|
| GDD-17 | [技能总库](设计文档/GDD-17-技能总库.md) | ✅ v2.5（修复§五重号与§八跳号两处章节编号冲突；本地决策范围扩展至✅K01-K21） | 2026-07-06 |
|
|
|
|
|
|
| GDD-18 | [世界·地图·副本·遗迹生成引擎](设计文档/GDD-18-世界地图副本遗迹生成引擎.md) | ✅ v2.4（修复决策表✅W01-W05重复条目；世界内容映射从六级改为五层） | 2026-07-06 |
|
|
|
|
|
|
| GDD-19 | [怪物图鉴与生成引擎](设计文档/GDD-19-怪物图鉴与生成引擎.md) | ✅ v1.6（区域分布权重从六级改为五层，对齐✅136） | 2026-07-06 |
|
|
|
|
|
|
| GDD-20 | [武器装备与打造系统](设计文档/GDD-20-武器装备与打造系统.md) | ✅ v1.6（修复品质字段5档/6档不符；修复对GDD-17已过期的章节引用） | 2026-07-06 |
|
|
|
|
|
|
| GDD-21 | [数值平衡与联调参数总表](设计文档/GDD-21-数值平衡与联调参数总表.md) | ✅ v1.8（新增§15.1背包容量与空间装备数值；同步能量恢复四档梯度与Nacos键） | 2026-07-06 |
|
|
|
|
|
|
| GDD-22 | [开放世界随机事件与玩家可交互内容层](设计文档/GDD-22-开放世界随机事件与玩家可交互内容层.md) | ✅ v1.2（本轮审查确认无问题，未变更） | 2026-07-03 |
|
|
|
|
|
|
| GDD-23 | [能量体系与功法相性设计](设计文档/GDD-23-能量体系与功法相性设计.md) | ✅ v1.8（反转✅6取消独立内力资源；新增§2.3.2能量上限增长速度公式与顿悟触发桥接；恢复速度重排为四档） | 2026-07-06 |
|
|
|
|
|
|
| GDD-24 | [种族传承大师与稀有生活职业](设计文档/GDD-24-种族传承大师与稀有生活职业.md) | ✅ v1.3（修复品质轴与装备无法穿戴等表述；新增本地决策登记✅RM01-✅RM05，首次纳入GDD-00） | 2026-07-06 |
|
|
|
|
|
|
| GDD-25 | [洪荒大陆世界观设定](设计文档/GDD-25-洪荒大陆世界观设定.md) | ✅ v1.5（补全10个种族缺失的飞升境界叙事、8个未展开的势力详情、6个种族的神话体系归属） | 2026-07-06 |
|
|
|
|
|
|
| GDD-26 | [功法心法技能详细设计](设计文档/GDD-26-功法心法技能详细设计.md) | ✅ v1.3（修复"人族九道"与心法命名表与GDD-15权威定义不一致；补全飞升期数值行） | 2026-07-06 |
|
|
|
|
|
|
| GDD-27 | [修仙小说经典元素设计](设计文档/GDD-27-修仙小说经典元素设计.md) | ✅ v1.4（修复"凤族"应为妖族分支"凤妖"的种族归属错误） | 2026-07-06 |
|
|
|
|
|
|
| GDD-28 | [神话体系与旧日邪神设计](设计文档/GDD-28-神话体系与旧日邪神设计.md) | ✅ v2.4（修复4处错误的GDD-01种族章节引用；新增奥林匹斯/圣殿/堕落之地三个此前未展开的区域详情） | 2026-07-06 |
|
|
|
|
|
|
| GDD-29 | [聊天与信息传递系统设计](设计文档/GDD-29-聊天与信息传递系统设计.md) | ✅ v1.0（本轮审查确认无问题，未变更） | 2026-07-02 |
|
|
|
|
|
|
| GDD-30 | [成就里程碑与图鉴系统设计](设计文档/GDD-30-成就里程碑与图鉴系统设计.md) | ✅ v1.1（本轮审查确认无问题，未变更） | 2026-07-03 |
|
|
|
|
|
|
| GDD-31 | [洞府与个人空间系统设计](设计文档/GDD-31-洞府与个人空间系统设计.md) | ✅ v1.4（修复第九境界名称误标"天启"应为"飞升"；术语引用修正） | 2026-07-06 |
|
|
|
|
|
|
| GDD-32 | [NPC与势力关系系统设计](设计文档/GDD-32-NPC与势力关系系统设计.md) | ✅ v1.1（本轮审查确认无问题，未变更） | 2026-07-03 |
|
|
|
|
|
|
| GDD-33 | [世界Boss与大型PVE协作机制](设计文档/GDD-33-世界Boss与大型PVE协作机制.md) | ✅ v1.1（本轮审查确认无问题，未变更） | 2026-07-03 |
|
|
|
|
|
|
| GDD-34 | [好友与组队系统设计](设计文档/GDD-34-好友与组队系统设计.md) | ✅ v1.3（修复第九境界名称误标；术语澄清"经验加成"改为"修炼加成"） | 2026-07-06 |
|
|
|
|
|
|
| GDD-35 | [新手引导系统设计](设计文档/GDD-35-新手引导系统设计.md) | ✅ v1.3（原编号GDD-29与聊天系统冲突，归一至GDD-35；天启引导时机修正；术语澄清"经验保护"改为"修炼进度保护"） | 2026-07-06 |
|
2026-07-02 16:55:34 +08:00
|
|
|
|
|
|
|
|
|
|
### 需求文档（PRD）
|
|
|
|
|
|
|
|
|
|
|
|
| 编号 | 文档 | 状态 | 最后更新 |
|
|
|
|
|
|
|------|------|------|----------|
|
|
|
|
|
|
| PRD-01 | [核心玩法与系统需求](需求文档/PRD-01-核心玩法与系统需求文档.md) | ✅ v1.0 | 2026-06-30 |
|
|
|
|
|
|
| PRD-02 | [境界隔离系统需求](需求文档/PRD-02-境界隔离系统需求文档.md) | ✅ v1.0 | 2026-06-30 |
|
|
|
|
|
|
| PRD-03 | [热更新与活动系统需求](需求文档/PRD-03-热更新与活动系统需求文档.md) | ✅ v1.0 | 2026-06-30 |
|
|
|
|
|
|
|
|
|
|
|
|
### 技术文档（TDD）
|
|
|
|
|
|
|
|
|
|
|
|
| 编号 | 文档 | 状态 | 最后更新 |
|
|
|
|
|
|
|------|------|------|----------|
|
|
|
|
|
|
| TDD-00 | [整体技术栈方案](../挂机手游技术栈方案.md) | ✅ 已完成 v1.2 | 2026-06-29 |
|
|
|
|
|
|
| TDD-01 | 境界隔离系统技术设计 | ✅ 含于 TDD-00 第五章 | 2026-06-29 |
|
|
|
|
|
|
| TDD-02 | [客户端热更新技术方案](技术文档/TDD-02-客户端热更新技术方案.md) | ✅ v1.0 | 2026-06-30 |
|
|
|
|
|
|
| TDD-03 | 服务端开服自动化方案 | ✅ 含于 TDD-00 第四章 | 2026-06-29 |
|
|
|
|
|
|
| TDD-04 | [数据库表结构设计](技术文档/TDD-04-数据库表结构设计.md) | ✅ v1.1 | 2026-06-30 |
|
|
|
|
|
|
| TDD-05 | [API 接口设计](技术文档/TDD-05-API接口设计.md) | ✅ v1.0 | 2026-06-30 |
|
|
|
|
|
|
|
|
|
|
|
|
### 实现骨架
|
|
|
|
|
|
|
|
|
|
|
|
| 目录 | 说明 | 状态 |
|
|
|
|
|
|
|------|------|------|
|
|
|
|
|
|
| `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） | ✅ 已完成 |
|
|
|
|
|
|
|
|
|
|
|
|
### 本地运行（开发环境）
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
# 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 倍出手频率差 |
|
|
|
|
|
|
| 服务架构 | 感官单服，境界隔离（六大境界×层级0-5 竞争池，见 GDD-08） |
|
|
|
|
|
|
| 种族数量 | 19 种族（含转化/重生获得：人族、龙族、混沌裔、巨人族、堕天使裔；天使裔可创角） |
|
|
|
|
|
|
| 时间流速 | 游戏内时间 = 现实 3 倍（默认时间口径为游戏时间） |
|
|
|
|
|
|
| 成长哲学 | 大多数稀有资源/隐藏天赋靠机遇获取；创角不发天赋；无体力，靠能量/时间/风险/概率驱动 |
|
|
|
|
|
|
| 能量体系 | 移除体力；以内力/能量为核心，受功法/状态/纯净度/丹毒影响；各族/职业有独立能量命名 |
|
|
|
|
|
|
| 传承大师 | 每个种族有一个无法战斗的稀有生活大师职业；奇遇获取传承物品后专职；玩家可委托大师加工/布阵/炼丹 |
|
|
|
|
|
|
| 死亡惩罚 | 高惩罚基调（损失进度/纯度/产出/耐久 + 道伤） |
|
|
|
|
|
|
| 充值 | 引入鸿蒙紫气充值（6档）；人族修真可做"偷渡"经纪；只加速不专属，不可买进度/解锁种族 |
|
|
|
|
|
|
| 平台 | Android / iOS / 鸿蒙 NEXT |
|
|
|
|
|
|
| 客户端引擎 | Cocos Creator 3.x（Asset Bundle 热更） |
|
|
|
|
|
|
| 服务端 | Go + Nakama + PostgreSQL + Valkey |
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
## 种族速查
|
|
|
|
|
|
|
|
|
|
|
|
| 阵营 | 种族 |
|
|
|
|
|
|
|------|------|
|
|
|
|
|
|
| 天道 | 人族（重生）、神族、精灵族（光明）、天使裔 |
|
|
|
|
|
|
| 洪荒 | 妖族（狐/蛇/虎/凤/猿）、龙族、巫族（4传承）、兽人族、巨人族（矮人转化） |
|
|
|
|
|
|
| 幽冥 | 鬼族、魔族、冥族、吸血鬼族、堕天使裔、精灵族（暗影）、深潜裔（克苏鲁） |
|
|
|
|
|
|
| 混沌中立 | 地精族、矮人族、混沌裔 |
|
|
|
|
|
|
|
|
|
|
|
|
> 不可创角（转化/重生获得）：人族、龙族、混沌裔、巨人族、堕天使裔。
|
鲁公网安备37132902372882号
|
鲁ICP备20018775号-1