udx/AIGame
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add prototype gameplay loop with character/battlefield assets and server game APIs.

Browse Source 
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
udx
2026-10-20 18:50:00 +08:00
co-authored by Cursor
parent 79369e4473
commit 6c64210331
833 changed files with 998079 additions and 1042 deletions
Download Patch File Download Diff File Expand all files Collapse all files
GameDesign.md
+439 -310
View File
@@ -1,372 +1,501 @@
# AIGame 游戏设计文档
# AIGame 基础游戏设计
> 品类：**3D 竖屏肉鸽塔防**（微信小游戏）
> 玩法参考：《永远的蔚蓝星球》—— 局内召唤 / 合成升星 / 随机构筑；局外科技 / 单位 / 装备养成
> 世界观：科幻未来 · 异星入侵 · 人类防线
> 工程约束：见 [`ProjectDesign.md`](ProjectDesign.md)（竖屏 URP / YooAsset / HybridCLR）
版本：v0.1；更新日期：2026-10-14；用途：产品、策划、美术、客户端与服务端的基础开发依据。
---
AIGame 采用**伙伴收集养成、弹珠资源玩法、布阵塔防与营地生活**相互衔接的结构，功能参考《塔塔冒险队》。玩家在营地收取资源、打弹珠获得成长材料和捕捉机会，培养伙伴并调整阵容，完成冒险后解锁新的伙伴、建筑和玩法。
## 1. 一句话定位
当前方向沿用已制作的营地主界面与 Candy 糖果风，仅保留这一套 UI 主题。原科幻肉鸽塔防方案保存在[历史设计稿](Doc/Design/Archive/GameDesign_SciFi_20261014.md)，不再作为当前玩法依据。平台、热更和资源管理继续遵循[项目架构](ProjectDesign.md)。
玩家作为前线指挥官，在异星虫潮进攻路线上部署 3D 战斗单位，通过**召唤 → 合成升星 → 随机技能/装备构筑**守住核心反应堆；局外用资源推进**科技树、兵种解锁升级、装备强化**，解锁更强单位与防线模块。
本文确定本项目的功能规则与分期范围；所有标为“测试基线”的数量、时长、概率和数值均为本项目初始配置，不代表参考游戏的真实参数。
---
实现进度（2026-10-16）：已接入本地 AIServer 的权威钱包与活动恢复，配置驱动首章前5关、选关、逐关首通和元素差异；现有5只伙伴及带概率/保底的捕捉池。营地、每日任务与七日登录第一版已接通；背包现可查看捕捉券、碎片、装饰的数量/来源/用途，补给商店支持每日免费、金币限购和建造台入口，均支持旧存档迁移与断线重试。详见 [实现记录](Doc/Design/G0_Implementation.md) 与 [玩法协议](Doc/NetProtocol.md)。当前仍为单路线前后两槽，完整20关、多路线、10种伙伴及其余系统仍是目标设计。
## 2. 核心体验目标
实现更新（2026-10-20）：内容量已扩到10只伙伴与20关（绿野初程1-1～1-10、溪谷守望2-1～2-10），服务端存档schema9。设置面板已接通音乐/音效/画质/振动与账号信息（本机偏好）；此前宝箱、邮件、三路线与T2技能已接通。当前阶段仍是G2，正式美术、正式战场与G3验收待补齐。
| 目标 | 说明 |
## 1 产品定位
| 项目 | 基础设计 |
| --- | --- |
| 爽感 | 3D 弹幕与技能特效可见、可感；升星与关键技能带来清晰质变 |
| 策略 | 每局随机池强制换思路；路线、职业羁绊、机关搭配决定通关 |
| 成长 | 局外科技 / 兵种 / 装备持续变强，推图与刷资源形成闭环 |
| 碎片化 | 单局约 **2.5～4 分钟**，适配微信竖屏短时游玩 |
| 轻量 3D | 透视相机 + 低模单位；单体面数与同屏数量受小游戏性能约束 |
| 品类 | 轻策略伙伴养成与竖屏塔防，包含弹珠与营地玩法 |
| 平台 | Unity 微信竖屏小游戏，设计分辨率 1080×1920 |
| 世界与身份 | 温暖的小镇及周边原野；玩家是营地探险家，伙伴协助抵御入侵的小怪 |
| 美术 | 圆润卡通角色、轻量 3D 场景、奶油色容器与绿色主操作 |
| 主要体验 | 收到新伙伴、组合克制阵容、完成一次进化、看见营地变化 |
| 游玩节奏 | 战斗约 90～180 秒；弹珠按单次发射结算；一次回访约 5～15 分钟，均为测试目标 |
| 首期范围 | 单人核心循环、基础营地、日常与持久化，不依赖多人或付费才能完成 |
**非目标（首期不做）**：重度沙盒建造、自由造塔网格、大型开放地图、复杂操作 RTS、跨服竞技匹配。
伙伴、怪物、建筑和活动使用本项目自己的名称与素材。参考游戏的角色名、专有道具名与角色造型不作为本项目资产命名。
---
## 2 参考功能与项目取舍
## 3. 世界观与剧情框架
官方商店介绍确认了伙伴收集、弹珠产出成长材料、营地布置、属性与阵型战斗、好友合作及营地突袭。[《塔塔冒险队》官方商店介绍](https://play.google.com/store/apps/details?hl=zh-TW&id=com.farlightgames.pgame.gp)
### 3.1 背景
官方发布记录还包含多阶进化、首领挑战、合作防守、海岛夺金、钓鱼活动、卡片画册、伙伴研究、日夜变化和温泉互访等功能。[莉莉丝发布的游戏介绍与更新记录](https://www.taptap.cn/app/866257/all-info)
公元 22XX，人类殖民带「蔚蓝环」遭遇名为 **裂隙虫族（Rift Swarm）** 的异维生物入侵。虫族沿「裂隙通道」涌入殖民星球，目标是吞噬行星核心能量。
玩家攻略将常驻玩法概括为主线、道馆、首领与合作防守，并介绍了弹珠与成长材料之间的循环。它用于补充功能分类，不用于确定本项目的倍率、概率或强度表。[TataDex 授权玩家攻略](https://tatadex.org/zh/guides/a-bottle-of-mineral-water-beginner-guide-s1/)
玩家所属 **联合防线司令部（UDF）**，驻守边境前哨 **「锚点-07」**。每场战斗即一次「锚点防卫战」：守住 **核心反应堆**，拖延虫潮直至裂隙暂时闭合。
### 2.1 功能分期
### 3.2 叙事节奏（主线章节）
P0 为可上线的基础单人版本；P1 为核心循环稳定后的扩展；P2 为依赖多人、运营或长期养成的版本。分期只控制开发次序，下表所有功能均纳入后续设计。
| 章节 | 主题 | 敌人侧重 | 解锁导向 |
| 功能组 | 本项目功能 | 分期 | 基础交付边界 |
| --- | --- | --- | --- |
| Ch1 坠落信号 | 教学：召唤、合成、守核 | 基础虫兵 | 步兵系、基础城墙机关 |
| Ch2 锈蚀矿带 | 资源线、多路压力 | 装甲虫、分裂虫 | 工程/资源科技 |
| Ch3 离子风暴 | 飞行单位、范围控场 | 飞行群、电磁干扰 | 防空单位、电网类机关 |
| Ch4 裂隙前哨 | 精英波、Boss 压迫 | 精英 + 早期 Boss | 输出职业质变技能 |
| Ch5 深蓝母巢 | 高密度弹幕构筑检验 | 混合潮 + 终局 Boss | 高阶科技、粉/红品质装备 |
| 营地主界面 | 档案、资源、目标、入口、冒险与底部导航 | P0 | 复用当前布局，替换示例数据 |
| 弹珠 | 瞄准发射、碰撞反馈、奖励、捕捉进度 | P0 | 一张台面、单次发射，无高倍率与自动连射 |
| 伙伴收集 | 捕捉、重复转碎片、图鉴 | P0 | 10 种基础伙伴，开放池随进度扩大 |
| 伙伴成长 | 共享训练等级、个体进化、技能 | P0 | 两阶段进化；三、四阶段为 P2 |
| 主线 | 章节、布阵、自动战斗、首通与战报 | P0 | 2 章共 20 关，3 条进攻路线 |
| 营地 | 建筑解锁、生产领取、伙伴闲逛互动 | P0 | 固定建筑槽位；自由摆放扩建为 P1 |
| 日常系统 | 目标、签到、背包、宝箱、邮件、设置 | P0 | 接入真实进度与领取状态 |
| 商店 | 免费日补给、金币兑换、限量商品 | P0 | 游戏内货币兑换，真实付费为 P2 |
| 属性挑战 | 单元素挑战与徽章奖励 | P1 | 首期使用已有战斗规则与属性条件 |
| 首领挑战 | 限时伤害挑战与个人纪录 | P1 | 单人；服务器排行另行接入 |
| 排行 | 主线进度与挑战榜 | P1 | 只收服务端确认成绩 |
| 好友 | 查找、互访、点赞、定额赠礼 | P1 | 无实时聊天；加入好友权限与上限 |
| 营地寻宝与突袭 | 异步拜访事件与额外奖励 | P1 | 奖励来自事件池，不扣对方实际库存 |
| 钓鱼与派对 | 短时操作活动及积分奖励 | P1 | 首次只做一种活动模板 |
| 合作防守 | 双人共同抵挡怪潮 | P2 | 共享战场，需组队、同步与重连能力 |
| 海岛争夺 | 异步 PvP、据点与赛季奖励 | P2 | 独立匹配池与赛季资源，不改主线账本 |
| 卡片画册 | 集册、重复卡、交换与赠送 | P2 | 先做收集，交换依赖好友与交易事务 |
| 伙伴研究 | 收集标签、表情、装扮与研究进度 | P2 | 外观收集优先，属性成长有上限 |
| 营地扩展 | 日夜行为、温泉增益、好友访客 | P2 | 建筑互动与临时增益，不能替代基础养成 |
| 长期运营 | 赛季通行证、外观、主题活动 | P2 | 奖励与付费定义单独配置 |
章节间穿插短剧情（立绘 + 旁白即可），不阻塞战斗循环。
### 2.2 当前已实现与待开发（2026-10-18）
### 3.3 阵营对立
| 阵营 | 定位 | 视觉关键词 |
| 内容 | 当前项目状态 | 接入要求 |
| --- | --- | --- |
| UDF（玩家） | 科技军事、模块化装甲、能量武器 | 冷蓝、金属、全息蓝光 |
| 裂隙虫族 | 有机甲壳、异维能量、集群 | 紫黑、生物发光、裂隙裂缝 |
| 启动、游客账号、WebSocket、维护与重连 | 已有基础实现 | 复用，不重写登录流程 |
| Candy 主界面及确认弹窗 | 已有 JSON 与 Prefab | 保留组件与事件，绑定服务端快照 |
| 主界面的等级、资源、任务和奖励 | 已绑定服务端钱包、训练、关卡和每日进度 | 继续复用同一账本，首通和领取不重复发奖 |
| 主界面功能入口 | 弹珠、伙伴、冒险、营地、任务、签到、背包、商店、邮件、宝箱和设置已接通 | P1活动和排行尚未开放 |
| 营地画面 | 主界面为静态插画；另有小镇和角色资源 | 静态图可保留为背景，互动营地需要真实对象与配置 |
| 战斗、弹珠、伙伴、经济与玩法存档 | G0/G1已实现，G2目前5关/5伙伴/单路线两槽，实时存档schema7 | 三路线、20关/10伙伴、T2技能和其余P0内容待补齐；详见实现记录 |
---
## 3 核心循环与玩家目标
## 4. 玩法总览（双层循环）
```text
┌─ 局内（Run / 肉鸽塔防）──────────────────────────────┐
│ 召唤单位 → 摆位 → 合成升星 → 选技能/装备/羁绊 │
│ → 守核清波 → 结算奖励（资源 / 碎片 / 图腾点） │
└────────────────────────────┬─────────────────────────┘
│ 产出
▼
┌─ 局外（Meta / 养成）─────────────────────────────────┐
│ 科技研究 · 战斗单位解锁/升级 · 装备强化 · 城墙机关 │
│ · 图腾/全局加成 · 关卡推进 · 日常/周常资源获取 │
└────────────────────────────┬─────────────────────────┘
│ 增强下一局起始战力与卡池
└──────────────────────────┘
```mermaid
flowchart LR
Camp[营地领取与日常目标] --> Balls[获得弹珠]
Balls --> Pinball[发射弹珠]
Pinball --> Materials[糖果 金币 捕捉机会]
Materials --> Growth[收集 训练 进化伙伴]
Growth --> Formation[调整属性与站位]
Formation --> Adventure[冒险闯关]
Adventure --> Unlock[新伙伴池 建筑 玩法]
Unlock --> Camp
```
---
短期目标是打赢下一关或获得一个新伙伴；中期目标是补齐属性、完成关键伙伴进化并建设营地；长期目标是组合不同阵容、完成图鉴与挑战纪录、参加合作和活动。
## 5. 局内战斗设计（3D 塔防核心）
主线失败后允许直接重试。没有弹珠时仍可调整阵容、重试已解锁关卡、查看图鉴与布置营地；弹珠控制资源获取节奏，不同时再设置主线体力门槛。
### 5.1 战场结构（竖屏 3D）
### 3.1 新手前十五分钟
```text
┌──────── 顶部 UI（波次 / 金币 / 技能栏）────────┐
│ │
│ [虫潮出生点 / 裂隙门] │
│ ↓ 多条进攻路线（地面 + 空中） │
│ ········· 可部署格 / 站位槽 ········· │
│ ↓ │
│ [城墙防线 + 可装配机关] │
│ ↓ │
│ [核心反应堆 HP] │
│ │
└──────── 底部 UI（召唤 / 合成提示 / 加速）──────┘
```
- **相机**：固定俯斜透视（约 45°～55°），竖屏构图；可轻微震动反馈，不可自由运镜（首期）。
- **部署**：离散 **站位槽**（参考蔚蓝星球式槽位），不做完全自由网格，降低操作与寻路成本。
- **路径**：敌人沿预置样条路径前进；部分关卡 2～3 路分岔；飞行单位走空中层路径。
- **失败条件**：核心 HP ≤ 0。
- **胜利条件**：撑过规定波次并击杀终波 Boss / 裂隙闭合。
### 5.2 单局流程（约 3 分钟）
| 时段 | 时间感 | 玩家行为 |
| 步骤 | 玩家行为 | 系统保证 |
| --- | --- | --- |
| 开局 | 0～15s | 免费/低价首抽，摆下 1～2 个单位；熟悉本关路线 |
| 发育期 | 15～90s | 持续召唤、合成升星、选三选一技能/装备；形成主 C |
| Boss 压迫 | 90～150s | 精英/Boss 进场；检验构筑与城墙机关 |
| 收束 | 150～180s+ | 清残波 / 斩杀 Boss；结算 |
| 进入营地 | 认识探险家、伙伴、弹珠库存 | 发放 20 枚教学弹珠；三只起始伙伴按引导逐步到账 |
| 首次发射 | 观察瞄准、碰撞与奖励 | 固定教学配置，展示糖果并给予一次捕捉券 |
| 首次捕捉 | 获得第三只起始伙伴 | 教学池保证新伙伴，领取与图鉴点亮同步 |
| 首次训练 | 使用糖果提升共享等级 | 足量教学材料；数值变化立即可见 |
| 首次布阵 | 在开放路线放置伙伴 | 第一关只开放一条路线，再逐步开放三条 |
| 首次战斗 | 自动攻击，观察怪物接近防线 | 第一关低难度，胜利结算只发放一次首通奖 |
| 返回营地 | 领取目标，查看伙伴与新入口 | 引导奖励到账后再推进下一步 |
节奏刻意让玩家在「尚未完全成型」时遭遇压力（参考蔚蓝星球：发育期遇 Boss），逼出技能选择与合成优先级决策。
新手步骤支持跳过说明与恢复进度。教学奖励使用固定任务 ID 领取，重启、切后台或断线不能再次获得。
### 5.3 召唤与合成升星
## 4 弹珠与伙伴捕捉
- **召唤**：消耗局内货币（**能量晶币**），从当前**解锁兵种池**中随机抽出单位，放入空槽或指定槽。
- **合成规则**：同 ID、同星级的 **2 个合成 1 个高一星**（1★+1★→2★，最高 **3★**）。
- **升星收益**：基础属性大幅提升 + 解锁/强化专属技能；3★ 为局内质变点。
- **摆位**：拖拽调整站位；近战靠前、远程靠后、辅助居中；部分羁绊要求特定站位形状。
### 4.1 弹珠规则
### 5.4 随机构筑三件套（每局）
一次发射消耗 1 枚弹珠。玩家调整允许范围内的方向，发射后弹珠经过碰撞物与奖励区，展示命中反馈，结束时统一结算糖果、金币及捕捉进度。方向决定路径；奖励由确定的台面规则计算，不能仅播放与结果无关的动画。
每局开局或关键波次触发，形成差异化 Run：
P0 每次只允许一枚在途弹珠。操作流程为“选择方向→确认发射→扣除弹珠并建立记录→碰撞表现→结算→展示库存”。余额不足时引导至生产、任务、签到和免费补给来源；不自动购买。
| 随机层 | 内容 | 作用 |
| 参数 | 测试基线 | 用途 |
| --- | --- | --- |
| 技能池 | 弹幕分裂、穿透、连锁闪电、攻速爆发、护盾脉冲等 | 决定输出形态（量变弹幕 vs 质变技能） |
| 装备词条 | 暴击、溅射、对精英伤害、击退、吸能回币等 | 补短板或放大主 C |
| 职业羁绊 | 同时场上 N 个同职业触发加成 | 引导合成方向与海抽策略 |
| 台面数量 | 1 | 先验证发射和奖励手感 |
| 单发耗时 | 5～8 秒，超时 10 秒结束 | 防止卡球阻塞流程 |
| 糖果产出 | 均值目标 20，单发范围 10～40 | 台面调试与经济测算，非独立随机抽奖表 |
| 金币产出 | 均值目标 40，单发范围 20～80 | 基础兑换与进化材料消耗 |
| 捕捉进度 | 每完成 10 次有效发射获得 1 张捕捉券 | 给收集提供稳定入口，教学发射另外配置 |
| 自然恢复 | 每 10 分钟 1 枚，上限 30 枚 | 限制离线自然累计；活动发奖允许超上限 |
玩家在「随机给出的选项」中做取舍，而不是每局固定最优解。
自然恢复与营地弹珠建筑为**同一个产出来源**，不是两次独立领取。库存低于 30 才自然增长；任务等发奖可使库存超过 30，此时停止自然增长直到库存回落。库存从满额或超额降到 30 以下时，以该次扣费的服务器时间重新开始恢复，不补计暂停期间的产出；未满额时保留不足十分钟的进度。P1 再开放倍率和连射，消耗、产出、捕捉进度须同步按倍率计算。
### 5.5 单位职业（首期 6～7 职）
### 4.2 发射状态与异常
| 职业 | 职责 | 量变倾向 | 质变倾向 |
每次发射有唯一 `shotId`，依次经过已创建、已扣费、运行中、已结算或已取消状态。发射开始前的取消不扣费；一旦扣费，退出不产生新结果，重新进入恢复同一记录或直接展示其结算。服务器保证扣费与记录创建原子完成。
台面版本、方向、随机种子和奖励规则与记录绑定。服务端运行可复核的离散碰撞规则，客户端按同一规则表现；实现前先以固定台面验证方向、路径和结算一致性。不能把客户端上报的命中数当作奖励依据。
### 4.3 捕捉与重复伙伴
P0 使用捕捉券获得一个伙伴，并播放短捕捉表现，不再增加一层捕捉失败。抽取范围由章节解锁；池内容、单项概率和保底进度在捕捉页面显示。
- 第一章开放 5 种基础伙伴，第二章开放另 5 种；同池初始权重一致。
- 新伙伴解锁物种与图鉴，并可加入队伍；同一物种只保留一份成长记录。
- 重复伙伴转为该物种的 20 个进化碎片，不挤占背包空间。
- 连续 4 次获得重复物种后，下一次在当前池中保证获得未拥有物种；获得新物种后清零。池已集齐时继续按普通池发放碎片，并明确提示保底暂停。
- 教学固定结果与普通捕捉池分开计数；所有抽取、保底推进和碎片发放在服务端同一事务中执行。
## 5 伙伴与养成
### 5.1 伙伴定义
每个物种有名称、元素、定位、攻击方式、技能与进化形态。P0 不设置天然压倒其他伙伴的稀有度层级，获得难度与定位不直接等同战斗强度。阵容选择主要取决于路线、克制和技能配合。
| 定位 | 主要职责 | 设计约束 |
| --- | --- | --- |
| 守护 | 承伤、阻挡、保护同路后排 | 输出较低，不能同时具备最高伤害与最高生存 |
| 输出 | 单体或范围攻击 | 至少区分清群与打首领两种能力 |
| 支援 | 治疗、护盾、增益 | 治疗目标与范围明确，不无限循环治疗 |
| 控制 | 减速、短时眩晕、削弱 | 首领控制效果衰减，无法永久锁住敌人 |
P0 内容目标为 10 种基础物种，每元素 2 种，整体覆盖以上四种定位；每种开放 T1、T2 两个阶段。原型先做守护、输出、支援各一只，不等待全部角色资源完成。
### 5.2 元素克制
本项目采用五元素单向环：**火→草→岩→电→水→火**。箭头表示克制；克制伤害系数为 1.25，被克制为 0.80，其余为 1.00，均为测试基线。界面必须显示关系，不能只靠玩家记忆。
克制只改变伤害，不产生完全免疫。范围伤害对每个目标分别计算；治疗、护盾不套用攻击克制系数。敌人的元素和主要机制在布阵前可见。
### 5.3 共享训练与个体进化
糖果提升营地的共享训练等级，所有已获得伙伴使用同一等级，新伙伴无需重新练级。玩家确认升级时才扣糖果；不能默认自动花完库存。个体差异来自进化阶段、技能和定位。
| 成长项 | 测试基线 | 规则 |
| --- | --- | --- |
| 共享训练等级 | P0 1～20 级 | 从 L 到 L+1 消耗 30×L 糖果 |
| 训练属性 | 基础生命和攻击每级增加基础值的 5% | 加法累计，不逐级复利；速度与控制时长不随等级无限增长 |
| T1 到 T2 | 共享等级 5、物种碎片 40、金币 500 | 固定成功，确认后同时扣除资源 |
| T2 收益 | 生命与攻击乘 1.25，并升级物种技能 | 外观须能看出阶段变化；不同定位允许单独配置 |
| T3、T4 | P2 | 新材料与高级形态，先验证两阶段循环再扩展 |
阶段与等级必须分开显示。P0 不增加装备强化、独立科技树、洗练和随机资质；这些系统不作为首期养成缺口的默认补丁。
### 5.4 技能与外观
每个伙伴具备普通攻击和一个自动触发技能，T2 提升技能效果或触发方式。技能配置至少定义目标、范围、冷却、系数、状态与持续时间；数值描述必须由配置生成。P1 可增加少量手动队伍技能。
闪光形态、装扮和表情安排在 P2，初始只影响展示，不把闪光作为通关必需属性。图鉴区分已拥有物种、已达到的进化阶段和已收藏外观。
## 6 布阵与主线战斗
### 6.1 战场与部署
P0 采用三条纵向路线，每条有前、后两个伙伴槽，共 6 槽。敌人从屏幕上方沿路线向下移动；守护伙伴优先放前排，远程或支援放后排。使用已有伙伴预先布阵，不沿用旧方案的局内随机召唤、同卡合成和三选一构筑。
每种物种最多上阵一次。玩家拖动伙伴到空槽部署，拖到占用槽交换站位，拖回列表撤下；开始前保存阵容。教学按一、二、三条路线递增开放，正常关卡不要求未开放路线防守。
### 6.2 胜负与节奏
战斗自动执行普通攻击和技能。伙伴死亡后本局无法继续攻击；敌人突破底部防线时扣营地耐久并离场。伙伴不产生永久损失，结算后恢复，不消耗复活道具。
营地耐久初始 10，普通敌人突破扣 1，精英扣 2，首领扣 5，为测试基线。清除最后一波所有敌人且耐久大于 0 为胜利；耐久归零或超过本关时间上限为失败，双方同一逻辑时刻满足条件时失败优先。
| 战斗阶段 | 规则 |
| --- | --- |
| 准备 | 展示路线、敌人元素、奖励与推荐战力，允许改阵容 |
| 进行 | 显示波次、耐久、剩余敌人、暂停和 1x/2x 速度 |
| 收束 | 禁止再次开始、锁定胜负，等待服务端确认 |
| 结算 | 展示奖励、首次通过标记、伤害/承伤/治疗统计 |
| 后续 | 胜利可下一关或回营地；失败可查看建议、调阵与重试 |
2x 只缩短表现与等待时间，不增加战斗奖励、改变随机种子或漏算冷却。战斗中暂停不允许改阵容；退出按放弃处理，不发通关奖。
### 6.3 怪物与技能规则
P0 包含普通、快速、护甲、精英及首领五类敌人。普通检验基础输出，快速迫使及时挡线，护甲提示元素与持续伤害搭配，精英制造阶段压力，首领检验集中伤害与续航。前五关每次只引入一个新机制。
普通攻击优先选择同路线最接近防线且在射程内的敌人；相同距离按稳定实体 ID 排序。支援默认作用同路线或技能指定相邻路线；首期不设置未说明的跨全图攻击。伤害测试公式为：
`单次伤害 = max(1, floor(攻击 × 技能系数 × 元素系数 × 状态系数 - 防御))`
暴击、闪避、装备词条和复杂技能相互触发后置。状态需定义叠加、刷新与上限，避免减速、治疗与护盾无限累积。
### 6.4 关卡与收益
P0 为两章，每章 10 关；第 5、10 关为首领关。第一章教会路线、元素和前后排，第二章加入混合敌人、护甲和支援技能配合。章节名称暂用“绿野初程”“溪谷守望”。
主线不消耗体力。每关的首通奖励只发一次，测试默认是金币 80、糖果 40、弹珠 3；首领另有配置奖励。重复通关保留战报但不再发经济奖励，页面明确显示“首通奖励已领取”，避免无限刷主线冲击经济。
推荐战力只作参考，不是进入门槛。失败提示须来自战报，例如某路被突破、守护过早死亡或面对被克制元素；不要仅提示购买或提升总战力。
## 7 营地建设与生活
P0 营地是功能入口与伙伴生活空间，使用固定建筑槽位减少编辑和寻路成本。当前插画只作为营地背景，不能把画上的房屋视为已可交互建筑。
| 建筑 | 解锁 | 基础用途 | 升级方向 |
| --- | --- | --- | --- |
| 突击步兵 | 近战挡线、稳定输出 | 多数量围殴 | 单体处决技 |
| 动能射手 | 远程单体 / 弹道 | 弹幕密度 | 穿透 / 弱点狙击 |
| 等离子法师 | 范围法术 | 多段 AoE | 大招清屏 |
| 电磁控制 | 减速、眩晕、聚怪 | 控场链 | 全域干扰 |
| 工程支援 | 回能、加攻、修墙 | 光环叠层 | 全队爆发窗口 |
| 防空无人机 | 对空特化 | 对空网 | 导弹齐射 |
| （可选）重装卫士 | 承伤、嘲讽 | 肉墙 | 城墙联动护盾 |
| 主营帐 | 初始 | 档案、系统说明、营地入口 | P0 不提供额外战力 |
| 弹珠树 | 教学完成 | 展示自然恢复产出，读取同一弹珠库存 | P0 不升级产量，P1 再开放上限成长 |
| 训练屋 | 教学开启 | 共享训练、进化入口 | 章节解锁等级上限，不再收一套独立材料 |
| 建造台 | 1-5 | 建筑和装饰列表 | 解锁额外固定槽位 |
| 伙伴休息区 | 1-3 | 展示选择的伙伴，点击获得动作反馈 | P0 最多展示 5 只，无刷资源奖励 |
| 活动设施 | P1/P2 | 钓鱼、研究、温泉、互访入口 | 按对应玩法开放 |
每个输出职建议拆 **量变构筑** 与 **质变构筑** 两条成长线，避免只有一条毕业套路。
金币购买和放置装饰。P0 放置到指定空槽，支持预览、确认、撤回预览；只有确认时扣费。已拥有装饰再次移动不收费，拆下放回仓库，不销毁。生产计时使用服务器时间，重启不刷新，改本机时钟不额外产出。
### 5.6 城墙与机关（防线模块）
当前营地实现基线：点击首页底部“营地”打开设施与休息区面板；训练屋完成首次发射开放，弹珠树通过1-1开放展示/入口，休息区通过1-3开放，建造台通过1-5开放。弹珠恢复本身仍沿用原钱包规则，不要求先解锁建筑、不增加第二份领取。三处装饰槽位采用独立看板，提供迎风小旗/花叶盆栽/暖光路灯，测试价120/180/240金币，每种最多一件；已有装饰放置或移动免费，占用位置需先收回。伙伴互动保存选择和累计次数，仅提供肖像动作反馈。主营帐复用探险家档案。首页营地插画保持背景展示，尚未实现其中房屋点击、3D营地行走或自由摆放。
核心前方有 **城墙 HP**；可装配 **机关模块**（局外解锁与升级，局内带入有限槽位）：
P1 扩建土地与自由摆放：定义网格、占地、旋转、遮挡和不可通行区；提交完整布局时检查重叠与拥有关系。P2 日夜只影响伙伴表现，不缩短玩家领取窗口；温泉提供有时限的配置增益，显示剩余时间、作用对象和上限。
| 机关示例 | 功能 | 设计意图 |
## 8 资源与经济
### 8.1 资源用途
| 资源 | 主要来源 | 主要消耗 | 边界 |
| --- | --- | --- | --- |
| 弹珠 | 同一套自然恢复、主线首通、签到、任务、免费补给 | 发射弹珠 | 主线不再额外消耗体力 |
| 糖果 | 弹珠、首通、日常 | 共享训练 | 不兼作货币兑换，避免经验倒流 |
| 金币 | 弹珠、首通、日常 | 进化、装饰、定额商品 | 不用于重复抽取付费级奖励 |
| 捕捉券 | 发射累计、教学及阶段任务 | 捕捉伙伴 | 扣券、结果、保底原子结算 |
| 物种碎片 | 重复伙伴、定向任务 | 对应物种进化 | 不能转回捕捉券，避免资源循环套利 |
| 钻石 | P0 仅阶段任务奖励，P2 预留付费来源 | P0 少量确定性外观兑换 | 不影响主线准入；无现金支付接入 |
| 建筑与装饰 | 商店、章节、活动 | 放置到营地 | 作为拥有记录与库存管理 |
| 活动代币 | 对应活动 | 对应兑换或报名 | 显示有效期，规则见活动系统 |
顶部保留金币、钻石和第三种资源布局，但第三种资源的目标定义改为**弹珠库存**，相应图标、标签、恢复提示也要更新。当前 UI 的绿色体力图标、“20/30”、金币、钻石、等级和关卡奖励均为示例，不能直接推导或沿用为经济规则；现有奖励栏的钻石示例亦以关卡表为准。
### 8.2 首日测试样例
测试初始弹珠 20；七日签到第 1 天奖励 10；每日三个任务各奖励 5；每日免费补给 5；完成前五关首通共奖励 15。忽略自然恢复时，合计可获得 **65 枚弹珠**；该数值是获取上限样例，不是要求玩家当日全部消耗的任务目标。
按普通弹珠均值计算，花费 10 枚预计产出糖果 200、金币 400 和 1 张捕捉券。实际单次产出受台面路径影响；首通、教学和任务另外记账。训练、进化、捕捉三个目标均应能在免费来源中看到可达路径。
经济验收至少覆盖首日、七日和卡关三种玩家轨迹，记录每种资源的净产入、缺口与库存。P0 不开放金币与钻石无限互换、重复首通奖励或可套取更多弹珠的无限商店交易。
## 9 日常与支撑系统
### 9.1 任务与签到
主线任务负责教学和长期目标，每日任务负责短回访，成就累计收藏与挑战。P0 每日三个目标为完成 3 次发射、完成 1 场冒险、与伙伴互动 1 次；主线重复战斗可计每日目标，但不增加主线首通奖。
任务依据已确认的业务事件更新，不通过打开页面或客户端自报数量完成。状态为未完成、可领取、已领取；红点只指向可领取奖励。P0 七日签到采用个人累计登录日，漏一天不重置、不补签、不自动扣钻石。
当前实现基线：每日任务按服务器UTC+8零点重置，每项奖励5弹珠，未领取的每日奖励重置后失效；教学首通目标长期保留。发射在落区结算时计入当日；冒险正常结束无论胜负计入，主动离开不计入，重复挑战可计入但不重复发首通奖；伙伴打招呼结算时计入，休息区仍需通过1-3。进度封顶3/1/1，重试不重复计数。
七日奖励按当天首次进入玩法计一个登录日，跳过多个日历日后再登录也只增加一天；测试奖励依次为弹珠10/5/5/10/5/10/20。已解锁但未领取的签到奖励长期保留，可领取任意已解锁项；没有付费补签，累计到七日后不循环开启。领取可令弹珠超过自然恢复上限，超过后仍暂停自然恢复。任务页与签到页分别列出状态和奖励，首页仅对可领的教学/每日任务及签到奖励显示红点。
### 9.2 背包与宝箱
背包分类为消耗品、伙伴材料、建筑装饰和活动道具；显示数量、来源、用途、使用批量与有效期。钱包数值单独管理，不复制一份到背包。P0 道具无格数上限，单堆叠上限及溢出规则由配置定义。
当前背包第一版直接展示已有记录：捕捉券使用`tickets`、五伙伴碎片使用`shards`、三件装饰使用`decorations/campLayout`，不建立第二份余额。捕捉券可前往捕捉，材料可定位到对应伙伴培养，装饰可前往建造台；以上物品永久有效。活动道具暂无内容，显示空状态。通用道具表、批量使用与堆叠/溢出仍待后续接入；宝箱库存由宝箱页独立管理。
宝箱页展示已拥有奖励箱，打开前显示内容或概率；P0 只做固定内容和自选箱。开启、扣箱和发奖同一事务完成；已过期箱按其定义转材料或失效，不能在领取后再次打开。
当前实现基线：每日宝箱每天领取1个、只入库不直接发奖；1-1、1-3、1-5首通各掉落一个固定/自选箱，重复挑战不再掉落；自选箱五个选项各对应一种伙伴碎片×10。箱子永久有效，暂不实现过期转材料。
### 9.3 邮件
系统邮件用于公告、补偿、活动补发和奖励投递。区分未读、已读、附件未领取、已领取、到期。奖励附件按 `mailId` 唯一领取；批量领取逐条返回结果，一条过期不阻塞其余邮件。P0 有效期测试基线 7 天，活动补发按活动配置覆盖。
### 9.4 商店与设置
P0 商店分免费补给、金币商品、装饰三个页签。商品定义价格、资源类型、解锁条件、限购周期与库存；购买确认页显示将花费与剩余余额。每日限购按服务器日重置，不因重启或换设备增加。
当前商店测试基线：每日免费5弹珠（初始开放，每日1次）；糖果20花费100金币（通过1-1，每日3次）；捕捉券1张花费300金币（通过1-3，每日1次）。免费直接领取，金币商品先显示内容、花费、购买后余额与剩余次数，确认时扣费/到账。商品按UTC+8零点刷新限购，不积攒未用次数；旧请求跨日重试只恢复原结果，不占用新日库存。装饰页连接现有建造台，仍先预览位置再确认。当前只支持一次领取/购买一份，没有现金支付或钻石兑换。
设置提供音乐、音效、画质、振动开关与账号信息；微信平台不支持的选项隐藏或禁用并说明。更换设备后拉取账号存档，退出账号不删除云端进度；删除账号属于单独的用户操作流程。
## 10 扩展挑战 社交与活动
### 10.1 属性挑战与首领挑战
属性挑战限制某一元素伙伴入场，按阶段给予徽章与定向碎片；首次通过奖励只领一次，重复挑战保留个人纪录。若该元素可用伙伴不足，显示获取途径，不强制付费进入。挑战复用战斗引擎，规则和奖励使用独立配置。
首领挑战采用限时伤害分档与每日奖励次数。最高成绩用于排行；重试次数与领取次数分开，重复试阵不能重复领取同一档。排行排序依次为已确认成绩、达成时间、稳定玩家 ID；并列成绩规则在榜页说明。
### 10.2 好友与营地事件
P1 好友支持 ID 查找、申请、接受、删除、屏蔽、查看阵容和营地互访。每日互访赠礼有发送和领取上限，服务器防止自己或同一对账号反复循环领取。互动留言和实时聊天不纳入第一版好友系统。
营地寻宝根据来访者进度生成短事件，消耗事件次数并从独立池发奖。突袭采用异步娱乐事件，可选择目标、展示阵容、播放战斗并领取事件奖励；不破坏对方永久建筑、不减少其钱包、不对不在线玩家施加必须修复的损失。
### 10.3 合作防守
P2 两人组队共同防守怪潮，每人带独立阵容并获得独立结算。需要房间创建、邀请、准备、超时、断线托管、恢复与共同胜负状态；一名玩家退出不抹除另一名玩家已完成的结算。
复用伙伴配置与基础战斗规则，新增共享战场和服务器同步。只有登录、战斗和结算稳定后才进入合作开发；不把主线通关强制绑定好友在线。
### 10.4 争夺与赛季
海岛争夺采用异步阵容快照对战：选择可匹配目标、消费赛季行动次数、模拟战斗、获得据点积分。防守阵容在提交时生成版本，不能在对方战斗期间实时变更结果。赛季有开始、报名、进行、锁榜、结算和领奖阶段。
赛季通货与永久钱包分开。赛季结束的积分重置、代币兑换或清理规则在入口预先显示，未领取永久奖励经邮件补发。付费与广告来源另案定义，不在基础设计中默认接入。
### 10.5 操作活动与收藏活动
钓鱼、寻宝或派对首版共用一套“开放→进入→操作→结算积分→分档领奖”模板。每个模板明确单局时限、失败重试、消耗、积分验证和奖励上限；一次运营版本先做一种玩法，不把不同小游戏都塞进首期。
画册包含套组、卡片、重复数量和整册奖励。先开放个人收藏，交换与赠送随后接入：双方资产、次数、同意状态和过期撤回须在一个交易流程里处理。所有收藏卡都能查看来源，外观卡不提供主线必需的战力。
伙伴研究分研究进度、标签、表情和装扮解锁；定向研究让喜欢某个伙伴的玩家有长期目标。温泉建筑提供限时伙伴增益和互访表现，增益上限、叠加规则、归属对象与到期时间明确显示。高级形态、昼夜生态和这些长期收藏系统同属 P2，分别验收，不能作为一个未定义的“大养成模块”。
## 11 界面与操作设计
### 11.1 现有入口与目标页面
| 主界面事件 | 目标页面或行为 | 分期 |
| --- | --- | --- |
| 光棱塔 | 高额对地激光 | 主力输出机关 |
| 电网 | 挂持续负面 / 增伤 | 后期乘法增伤核心 |
| 地震波 | 范围击晕 / 打断 | 保命控制 |
| 磁力阱 | 聚怪 | 方便 AoE |
| 离子护盾 | 短时无敌 / 减伤 | 翻盘手段 |
| 防空炮台 | 对空补充 | 飞虫关卡刚需 |
| `Profile` | 档案与成就概览 | P0 |
| `Coin` / `Diamond` / `Energy` | 对应资源详情；`Energy` 为当前旧事件名，业务接入时统一改为弹珠 | P0 |
| `Tasks` | 主线、每日与成就 | P0 |
| `Events` | 当前开放活动与下一期时间 | P1；P0 可不显示该入口 |
| `Daily` | 七日累计签到 | P0 |
| `Rank` | 主线和挑战榜 | P1 |
| `Mail` | 系统邮件 | P0 |
| `Rewards` | 已拥有宝箱 | P0 |
| `Bag` | 背包 | P0 |
| `Settings` | 音画和账号设置 | P0 |
| `Shop` | 游戏货币商品与装饰 | P0 |
| `Pets` | 伙伴列表、详情、图鉴、进化和编队 | P0 |
| `Home` | 返回营地；营地中点击建筑进入对应功能 | P0 |
| `Adventure` / `Battle` | 章节与当前关卡，进入布阵 | P0 |
| `Pinball` | 弹珠台与捕捉入口 | P0 |
机关升级有明显 **性价比拐点**（如 5/10 级解锁关键效果），引导资源分配而非无无限堆级。
首期未开发的入口隐藏或显示明确解锁说明，不长期用可点击空页面占位。底部五导航保持“商店、伙伴、营地、冒险、弹珠”，当前页有选中状态；返回优先退到上级页面，战斗或已付费发射退出需要确认。
### 5.7 敌人类型
### 11.2 目标面板与操作
| 类型 | 行为 | 对策提示 |
以下为目标逻辑名；当前首版采用`UI_Prototype*`实现，其中弹珠/捕捉、伙伴、选关/布阵/战斗、营地/建造、任务/签到、背包、商店、邮件、宝箱和设置已有JSON与Prefab。已实现页面仍须随正式美术与G3验收继续扩展。
| 面板逻辑名 | 主要内容 | 关键行为 |
| --- | --- | --- |
| 虫兵 | 直线冲核 | 基础火力 |
| 甲壳虫 | 高防低速 | 破甲 / 持续伤害 |
| 分裂虫 | 死亡分裂 | 溅射 / 范围 |
| 飞膜虫 | 空中路径 | 防空单位 / 防空炮 |
| 干扰虫 | 沉默或降低攻速 | 优先击杀 |
| 精英 | 高血 + 特殊技能 | 爆发窗口 / 控制 |
| Boss | 阶段机制（召唤、冲锋、护盾） | 完整构筑检验 |
| `UI_Adventure` / `UI_Formation` | 章节、敌人情报、首通奖与站位 | 选关、保存、开始 |
| `UI_BattleHUD` / `UI_BattleResult` | 波次、耐久、速度、统计、奖励 | 暂停、放弃、重试、下一关 |
| `UI_Pinball` / `UI_Capture` | 台面、方向、库存、捕捉池与结果 | 发射、捕捉、查看规则 |
| `UI_PetList` / `UI_PetDetail` | 拥有与未拥有伙伴、技能、成长条件 | 训练、进化、编队 |
| `UI_CampBuild` | 建筑、装饰、槽位与拥有记录 | 预览、购买、放置、撤回 |
| `UI_Tasks` / `UI_CheckIn` | 进度与可领取状态 | 单次/批量领取 |
| `UI_Bag` / `UI_RewardBox` | 道具、数量、用途和箱内容 | 使用、开启、自选 |
| `UI_Mail` / `UI_Shop` / `UI_Settings` | 系统支撑信息 | 领取、购买、设置 |
### 5.8 操作与 UI（竖屏）
所有业务骨架使用 `Doc/UIPrefabCreater/` JSON→Prefab；不通过运行时代码临时拼面板。标准底图使用有效非零 Border 的 Full Rect Sprite，JSON 为 `Sliced`；图标和插画保持原比例，文字统一 TMP。遵循[UI 生成规范](Doc/UI_AutoGen_Overview.md)和[当前 Candy 说明](Doc/Design/UI/UI_Themes.md)。
- 主要操作：点击召唤、拖拽合成/换位、点击三选一、点击释放主动技（若有）。
- 支持 **1.5x / 2x** 加速；失败可看战报（输出占比、承伤、合成次数）。
- UI 走项目 JSON→Prefab 管线；设计分辨率 `[1080, 1920]`。
交互统一包含加载、空列表、未解锁、余额不足、成功、失败和断线状态。发射、捕捉、进化、购买和领奖请求在等待时禁用重复点击，失败恢复按钮。红点只提示可领取奖励、未读邮件或已可完成的成长动作，不把单纯新内容永久挂红点。
---
## 12 数据与结算约束
## 6. 局外养成系统
### 12.1 存档领域
### 6.1 科技研究树
| 数据 | 最小内容 |
| --- | --- |
| 玩家 | 玩家 ID、昵称、共享训练等级、教学步骤、配置版本 |
| 钱包 | 各资源余额、自然恢复基准时间、修订号 |
| 伙伴 | 物种 ID、进化阶段、碎片、已解锁外观 |
| 阵容 | 模式 ID、槽位、物种 ID、版本 |
| 关卡 | 最高开放关、已首通关、首通奖励状态 |
| 营地 | 建筑与装饰拥有记录、等级、槽位或布局、展示伙伴 |
| 日常 | 服务端日标识、任务进度、领取状态、签到累计日 |
| 背包与邮件 | 道具数量、实例与有效期、附件领取记录 |
| 操作记录 | 发射、捕捉、购买、进化、战斗、领奖的唯一 ID 与状态 |
独立 **科技面板**，消耗研究资源解锁节点，影响全局或某职业：
“已拥有”与“已展示”分开存储，界面排序和特效不能改变实际库存。货币使用整数，存档按玩家隔离，备份和恢复必须保留操作记录。
| 科技分支 | 示例节点 | 效果类型 |
### 12.2 配置表
| 配置 | 核心字段 |
| --- | --- |
| `PetConfig` / `PetStageConfig` | 元素、定位、基础属性、形态资源、成长系数与进化成本 |
| `SkillConfig` / `EnemyConfig` | 目标与状态规则；敌人属性、速度、路线和突破伤害 |
| `StageConfig` / `WaveConfig` | 章节、开放条件、路线、敌人序列、时间上限、奖励 ID |
| `PinballBoardConfig` | 台面碰撞、方向范围、奖励区、轨迹规则版本 |
| `CapturePoolConfig` | 开放物种、权重、重复转换与新物种保底 |
| `LevelConfig` / `RewardConfig` | 训练成本、资源奖励、固定箱与自选箱内容 |
| `BuildingConfig` / `ItemConfig` | 建筑槽位、解锁、生产；道具用途与到期策略 |
| `TaskConfig` / `ShopConfig` | 业务事件目标、奖励、价格、解锁与限购 |
| `FeatureUnlockConfig` / `ActivityConfig` | 页面解锁、活动时间、积分、奖励与期末处理 |
每次操作锁定配置版本。修改配置不改变进行中的发射、战斗或已创建领奖记录，防止同一操作因热更产生两套成本与收益。
### 12.3 服务端职责
现有服务端只提供账号、握手、心跳与维护等基础能力，[现有协议](Doc/NetProtocol.md)没有经济和玩法接口。以下是待新增业务，不是已实现接口：
| 业务操作 | 服务端校验与返回 |
| --- | --- |
| 玩家快照 | 返回钱包、伙伴、开放功能、任务、进行中操作及存档修订号 |
| 弹珠开始与结果查询 | 余额、方向、台面版本、唯一记录；权威路径结果与奖励 |
| 捕捉 | 消耗券、选择池、推进保底、发放伙伴或碎片 |
| 训练与进化 | 等级/阶段条件、成本、一次扣款、更新成长 |
| 阵容保存与战斗 | 拥有关系、槽位、规则版本、权威模拟与首通结算 |
| 营地修改与领取 | 建筑/装饰拥有、槽位、计时、一次领取 |
| 任务签到邮件商店 | 解锁、服务器时间、领奖/限购状态与资产变更 |
消耗、结果、发奖和操作完成记录必须在同一事务中提交。客户端携带唯一请求 ID，超时后重发相同 ID 或查询原记录；相同请求只能产生一次变更。请求内容与既有 ID 不一致时拒绝，不能覆盖原结果。
服务端负责随机结果、钱包、进化与最终奖励，客户端负责输入和表现。单人战斗使用可复核的逻辑模拟；原型先验证同配置、种子与固定步长得到相同结果，不接受客户端直接上传“胜利”发奖。维护时禁止新消耗请求，对已经创建的操作提供可查询的完成结果。
每日重置统一为服务器 Asia/Shanghai 00:00，与现行任务/商店配置一致；活动按配置时间执行。客户端时钟不参与产出和限购判断。P0 不提供断网发射或离线领奖；断线显示可查看的旧数据并恢复原操作，不能重新开始一次扣费。
## 13 资源与性能目标
P0 资源清单为 10 种伙伴的 T1/T2 形态、5 类敌人、1 个战斗场景、1 张弹珠台、5 类营地设施，以及技能、胜负、发射、捕捉和 UI 音效。伙伴升级与进化的外观变化必须可见；不能仅靠更改文字声明已进化。
既有 LmCat、小镇、房屋等资产先按画风、尺寸、动画与交互用途评估，满足规格后再复用。当前营地插画不拆作自动生成的 3D 场景，也不自动代表建筑碰撞与导航已完成。
| 项目 | 测试目标 |
| --- | --- |
| 帧率 | 目标设备持续 30 FPS；更高档位再开放 60 FPS |
| 战斗显示 | 伙伴最多 6；敌人可见数量目标不超过 40，关卡波次控制峰值 |
| 营地展示 | P0 最多 5 只伙伴，未展示伙伴不加载模型 |
| 渲染 | URP 一主光，低档减少实时阴影与粒子；对象池管理弹道与怪物 |
| 加载 | 异步加载当前页面与场景，按功能释放句柄，不首屏加载全部伙伴 |
| 资源规格 | 模型 Y-up、底面中心原点、局部 -Z 为正面；制作与导入按现有流程 |
测试目标需要在实际微信设备上测量后锁定。[资源生产流程](GameResourceProduct.md)与[Unity 操作规范](UNITY-GUIDE.md)继续适用；新增图、模型、动画、音效、特效完成后登记到相应 `Doc/ResDesc_*.md`。
## 14 开发顺序与验收
### 14.1 交付阶段
| 阶段 | 交付 | 完成条件 |
| --- | --- | --- |
| 能源基建 | 开局晶币 +N、召唤折扣 | 发育加速 |
| 武器协议 | 全队攻击%、暴击 | 数值底盘 |
| 城防工程 | 城墙 HP、机关伤害/冷却 | 续航与保命 |
| 战术编成 | 某职业槽位上限、羁绊门槛 -1 | 构筑自由度 |
| 裂隙对抗 | 对精英/Boss 伤害、抗控制 | 推图关键节点 |
| 后勤回收 | 结算奖励%、日常次数 | 资源循环 |
| G0 核心原型 | 3 只伙伴、1 个教学关、1 张弹珠台、模拟配置 | 可以发射、获得材料、训练、布阵、胜负结算 |
| G1 可靠存档 | 钱包与操作记录、捕捉/重复、训练/进化、快照 | 断线、重启、重试均不重复扣款或发奖 |
| G2 P0 内容 | 10 种伙伴、20 关、固定营地建筑、所有 P0 支撑面板 | 所有 P0 入口有实际业务，示例数值全部移除 |
| G3 体验与性能 | 引导、经济样例、失败建议、设备验证 | 新用户独立走完首日循环，关键设备达到性能目标 |
| G4 P1 扩展 | 挑战、排行、好友与首个活动模板 | 无须多人实时同步即可完整参与并领奖 |
| G5 P2 扩展 | 合作、争夺、高阶成长与长期收藏 | 独立通过同步、赛季、交易和长期经济验收 |
研究有前置依赖；中后期开放「协防能力 / 续航」向节点（对齐参考作科技树定位：强化防线与持久，而非替代兵种成长）。
先建立领域存档与奖励事务，再给已有入口接业务；首期原型允许本地模拟数据，但正式 P0 的经济结果必须由服务器确认。多个系统复用已定义的资源与战斗规则，避免每个活动另造一套常驻货币与成长体系。
### 6.2 战斗单位研究与升级
### 14.2 P0 验收清单
- **解锁**：主线进度 + 科技前置 + 消耗兵种芯片 → 加入召唤池。
- **升级**：消耗重复碎片 / 通用零件提升等级（基础 ATK/HP/技能系数）。
- **星级突破（局外）**：与局内临时升星区分；局外突破提高该单位**进入局内的初始品质上限或基础星级权重**。
- **研发分支**：同一单位可点「弹幕强化」或「大招强化」，服务量变/质变流派。
- 首次进入到第一场通关可独立完成，新手奖励不会因重启重发。
- 每次发射正确扣 1 枚弹珠，结果与方向/台面规则一致，10 次有效发射生成 1 张券。
- 新伙伴点亮图鉴，重复伙伴准确转碎片，保底边界和已集齐池正确显示。
- 共享训练影响所有伙伴；进化条件、扣费、外观和技能一起更新。
- 每个关卡有明确胜负，失败可调阵重试，重复胜利不重发首通奖励。
- 弹珠自然恢复只有一个账本；超上限库存停止自然恢复，改本机时间不增产。
- 建筑购买与确认放置才扣费；移动已拥有装饰不收费。
- 任务、签到、邮件、宝箱与购买支持重复请求，资产结果只发生一次。
- 当前 Candy 主界面数据来自存档，顶部第三资源统一为弹珠，所有奖励显示来自配置。
- 三种断线位置均可恢复：扣费前、扣费后结果前、结果后展示前。
- 不显示 Studio/Mint 或主题切换入口；页面骨架由 JSON→Prefab 生成。
- 无伙伴模型或功能资源泄漏，真机性能符合选定档位。
### 6.3 装备系统
### 14.3 基础数据观察
| 层级 | 说明 |
记录引导步骤完成、弹珠开始/结算、捕捉新旧结果、训练/进化、战斗胜负与首次通过、任务领取、建筑修改和断线恢复。经济日志保留资源变化前后、来源、操作 ID 与配置版本。
首轮重点观察首战完成率、再次尝试比例、每日弹珠净产入、捕捉新物种速度和首次进化时间。指标用于判断卡点与重复操作问题；此阶段不把付费转化率作为核心循环通过标准。
## 15 后续细化与关联文档
本版固定了核心循环、功能边界、入口关系、资源用途和结算原则。下一轮按以下顺序细化：伙伴技能与基础属性表；20 关敌人波次；弹珠台碰撞与奖励配置；七日资源曲线；各面板交互稿；服务端协议字段及错误码；设备性能预算。
对主线是否取消体力、共享训练、三路线六槽和稳定捕捉券等规则的后续调整，应同时修改本稿、数值表、UI 标签与相关存档迁移策略，不能只改某一个页面。当前数值都是测试基线，上线前以完整循环测算和设备验证结果更新。
| 文档 | 内容 |
| --- | --- |
| 装备获取 | 关卡掉落、制造、活动、商店 |
| 品质 | 白 / 绿 / 蓝 / 紫 / 粉 / 红 |
| 强化 | 消耗矿锭提升基础属性 |
| 精炼/词条 | 锁定或重铸副属性（后期） |
| 穿戴 | 英雄个人装 + 可带入局内的「指挥官套件」（影响随机装备池权重） |
装备升级与科技、兵种形成三条平行成长线，避免单点付费墙感知过强（数值可后续调）。
### 6.4 图腾 / 全局加成（轻量）
类似参考作的图腾位：少量可装备的全局被动（开局护盾、首次召唤必出某职业、Boss 战回能等）。用于 Build 个性化和中后期深度，不作为新手必懂系统。
---
## 7. 资源与获取
### 7.1 资源一览
| 资源 | 用途 | 主要获取 |
| --- | --- | --- |
| 能量晶币 | **仅局内**召唤/刷新 | 杀敌、波次奖励、支援科技 |
| 信用点 | 通用软货币：强化、部分研究 | 关卡结算、日常、广告/分享（若接） |
| 异星矿锭 | 装备强化、制造 | 推图、挂机矿场、周常 |
| 研究数据 | 科技树 | 主线、研究副本、分解多余碎片 |
| 兵种芯片/碎片 | 解锁与升级单位 | 关卡首通、招募、分解 |
| 机关零件 | 城墙机关升级 | 特定关卡、活动 |
| 高级通货（可选） | 商城 / 便利养成 | 付费或高难首通（商业化另案） |
### 7.2 资源循环原则
1. **局内货币与局外货币严格分离**，防止刷局通胀冲击养成。
2. 每日：主线体力（或无体力无限但收益递减）+ 一次「矿带扫荡」+ 研究数据本。
3. 卡关时提供明确缺口提示（缺防空 / 缺破甲 / 科技节点未点），引导养成而非纯肝。
4. 首期可做 **离线挂机矿场**（短时累计矿锭），增强回流。
---
## 8. 模式规划
| 模式 | 优先级 | 说明 |
| --- | --- | --- |
| 主线战役 | P0 | 章节推图 + 剧情 + 解锁 |
| 无尽裂隙 | P1 | 波次越高奖励越好，检验构筑 |
| 日常资源本 | P1 | 定向产出矿锭 / 数据 / 碎片 |
| 双人协防 | P2 | 参考作合作向；共享战场分工（输出/控场） |
| 周常 Boss | P2 | 机制关，掉落粉红装备材料 |
| 竞技/排行 | P3 | 非首期 |
---
## 9. 3D 表现与性能预算（小游戏）
| 项 | 约束建议 |
| --- | --- |
| 单位模型 | 流水线：图 → 混元 GLB → 减面烘焙；角色目标约 **3k～8k 三角** |
| 同屏单位 | 软上限建议 ≤ 40（含敌我）；超出用简化表现或合并弹幕 |
| 特效 | 关键技能用预制拖尾/粒子；低端机降级为闪白 + 简环 |
| 光照 | URP 1 主光 + 少量烘培/假光照；忌多实时阴影 |
| 地图 | 模块化地表 + 少量破损科幻道具；一关一预制场景 |
资源生产与登记遵循 `ResourceCreate.md` / `Doc/ResDesc_*.md`。
---
## 10. 系统界面地图（与 UI 管线）
| 界面 | 功能 | 备注 |
| --- | --- | --- |
| 登录 / 热更 | 壳层已有 | 见 ProjectDesign |
| 主基地大厅 | 入口枢纽：出征、科技、兵营、兵装、城防、商店 | 竖屏单页+侧栏或底部 Tab |
| 关卡选择 | 章节地图节点 | 显示推荐战力/缺失提示 |
| 战斗 HUD | 波次、核芯、货币、技能、加速 | 战斗中 |
| 三选一弹窗 | 技能/装备/事件 | 暂停或慢动作 |
| 结算 | 胜负、奖励、输出统计 | |
| 科技树 | 节点研究 | |
| 兵营 | 单位图鉴、升级、解锁 | |
| 兵装工坊 | 装备强化、穿戴 | |
| 城防车间 | 机关装配与升级 | |
| 设置 | 音画、账号 | |
业务 Prefab 必须走 `Doc/UI_AutoGen_Overview.md`，禁止运行时临时代码拼业务 UI。
---
## 11. 数值与难度哲学（设计原则）
1. **合成与技能选择的决策密度 > 纯数值碾压**；但中后期允许「全队攻击阈值」形成通关阈值（参考作商业化与难度结构）。
2. Boss 出现在发育中段，迫使玩家在发育与保命间平衡。
3. 银币/晶币曲线：中期若只海抽不合成会乏力，引导「主 C 升星」。
4. 机关与单位伤害尽量用可配置表（便于热更调参）。
5. 首期关卡表控制在可手调范围，再上自动化难度曲线。
---
## 12. 商业化预留（不绑定首期必做）
- 战斗通行证（赛季）：信用点 + 碎片 + 外观。
- 兵种/皮肤外观（不影响或微影响手感特效）。
- 月卡：日常次数、挂机上限、小额信用点。
- 避免：无蓝抽永久战力断层；付费项优先「速度」与「外观」而非唯一强度。
具体付费档位另立商业文档，本文只留系统钩子。
---
## 13. 音效与音乐方向
| 类型 | 方向 |
| --- | --- |
| BGM | 科幻紧张电子 + 少量管弦；章节主题可替换 |
| 战斗 SFX | 能量枪、合成成功提示音、核芯告警、Boss 吼叫 |
| UI SFX | 轻点击、研究完成、升级成功 |
制作节点可参考 `Doc/TempDesign.md` 中的音频工具方向；完成后登记 `Doc/ResDesc_Sound.md`。
---
## 14. 里程碑（玩法侧，对齐工程 M 阶段）
| 阶段 | 玩法交付 |
| --- | --- |
| G0 | 单关 3D 战场：路径怪 + 核芯 + 2 种单位召唤/合成 + 胜负 |
| G1 | 三选一技能、城墙 HP、1～2 个机关、加速与结算奖励 |
| G2 | 主线 5 关、兵营升级、科技树第一分支、资源本雏形 |
| G3 | 装备强化、完整职业池、无尽模式、关卡推荐缺失提示 |
| G4 | 剧情演出、挂机矿场、双人协防原型、商业化钩子 |
| G5 | 性能档、数值打磨、提审内容冻结 |
工程侧 M0～M5 见 `ProjectDesign.md`；玩法 G 与工程 M 可并行，依赖热更与资源流水线就绪。
---
## 15. 命名与暂定 IP
| 项 | 暂定 |
| --- | --- |
| 工作标题 | **裂隙防线** / **锚点防卫战**（可改） |
| 玩家组织 | UDF 联合防线司令部 |
| 敌人 | 裂隙虫族 |
| 局内货币 | 能量晶币 |
| 核心物件 | 核心反应堆 |
正式商品名、包名与提审名后续统一。
---
## 16. 决策摘要
- **品类**：3D 竖屏肉鸽塔防，核心循环对齐《永远的蔚蓝星球》（召唤、合成升星、随机构筑、城墙机关），表现升级为 3D。
- **世界观**：科幻未来、异星（裂隙虫族）入侵、人类科技防线。
- **局外**：科技研究、战斗单位解锁升级、装备强化、资源获取闭环。
- **平台**：微信竖屏小游戏；单局短、操作轻、表驱动可热更。
- **首期边界**：主线 + 基础养成 + 单人战斗；合作与重度商业化后置。
---
## 17. 相关文档
| 文档 | 关系 |
| --- | --- |
| [`ProjectDesign.md`](ProjectDesign.md) | 技术架构与热更 |
| [`ResourceCreate.md`](ResourceCreate.md) | 3D/图/音频生产 |
| [`Doc/UI_AutoGen_Overview.md`](Doc/UI_AutoGen_Overview.md) | UI 生成管线 |
| [`Doc/ResDesc.md`](Doc/ResDesc.md) | 资源登记索引 |
| [ProjectDesign.md](ProjectDesign.md) | 平台、程序集、YooAsset、HybridCLR 与工程里程碑 |
| [Doc/NetProtocol.md](Doc/NetProtocol.md) | 账号、连接、G1 教学玩法接口与幂等恢复协议 |
| [Doc/UI_AutoGen_Overview.md](Doc/UI_AutoGen_Overview.md) | UI JSON→Prefab 管线 |
| [Doc/Design/UI/UI_Themes.md](Doc/Design/UI/UI_Themes.md) | 当前仅 Candy 的界面风格与资源 |
| [GameResourceProduct.md](GameResourceProduct.md) | 资源制作、导入、验收流程 |
| [Doc/ResDesc.md](Doc/ResDesc.md) | 资源登记 |
| [历史科幻方案](Doc/Design/Archive/GameDesign_SciFi_20261014.md) | 保留原设计方向与规则，不进入当前开发范围 |