《魔法植物》玩家操作手册（user_manual）

适用：preview 版（magic-plant-demo，Godot 4.7.2 · Compatibility 渲染 · 桌面 + 移动端）。 状态标注：【可玩】当前已实现并可用；【占位】已配置 / 已解锁但尚未接入玩法，进后续里程碑。 本文只讲操作、界面与玩家向流程；系统与内容设计见 dev_manual.md 与 content_manual.md，地图设计专篇见 dev_review/m6_map_design.md。

1. 一句话玩法

你是魔法少女，去一片沿东北↔西南延伸的魔法大陆采集发光蘑菇，带回温暖小镇（基地）种植，靠睡觉推进天数让作物按天成熟；蘑菇既是补给，也是能力、法术升级原料与门钥匙的材料。这片大陆按危险程度被水与石墙隔成五段：林缘 → 中环 → 洞窟 →（魔王预留），越往西南越深越危险，需要逐段解锁门才能通行。白天和黑夜是两套环境——夜里更危险，但也只有夜里才采得到某些蘑菇；T3 洞窟必须穿戴光明晶石才能看清。

preview 当前已跑通：移动 → 采集 → 回基地种 → 睡觉推进天 → 收获 → 解锁能力 → 战斗打怪掉材料 → 合成台开门 → 法术升级 → 穿光明晶石进黑暗洞窟 → 死一次捡尸。

2. 世界与区域（一张 45° 菱形大陆）

地图是沿东北↔西南主轴旋了 45° 的大块菱形大陆（世界约 6400×5120px），水做整图外缘，河流/石墙做区域交界。从东北到西南依次：

区域 方位 说明
基地 T0 居中 家 / 作物田 / 床 / 合成台 / 魔药祭坛（魔法书），无怪
T1 林缘 围绕基地四周 教学与首战；青露伞 / 晶铠蕈 / 晶座蕈 / 风耳蕈
T2 中环 东北 · 跨河 银芒菇 / 灼心芝 / 虹髓芝 / 流光茸；夜行兽 / 腐根虫
T3 洞窟 西南 · 无光 须戴光明晶石；月纹伞 / 绯泪茸；洞窟守望者
Boss 地牢 最西南 预留占位，靠最终道路进入
  • 野生蘑菇按区域分散、稀疏；怪物成群 3–5 只出现，且都在该区。
  • 区域内容规则：怪物与蘑菇都只刷在所属 zone，基地安全半径内不刷。

3. 界面（HUD）说明

左上角（状态条 + 快捷栏，紧贴左上角）：

组件 说明
红色条 红心 HP（生命；被打会掉，睡觉少量回复）
蓝色条 蓝 MP（施法/闪避耗；随时间缓慢回复，睡觉回满）
橙色条 饱食度（随时间缓慢降，睡觉额外扣；吃作物/食物回）
快捷栏三格 当前选中的物品（中间高亮）+ 左右各一格；Q/E 循环切换，R 或点中间格食用/使用当前选中；旁注 Q/E 切换 · R 食用

右上角：

组件 说明
第 N 天 当前游戏天数（睡觉推进）
hh:mm · 昼/夜 当前时刻与昼夜；白天/黑夜是两套环境

顶部中央：一次性 toast 提示（采集 / 种植 / 解锁能力 / 开门等）。

常用到的还有背包（B 开合）：列出已获得材料与数量，内含 6 格便捷物品栏，点 EQUIP 类物品可穿/脱（绿框 = 已穿戴）。

4. 操作

桌面端按键如下（移动端见 §5）。

操作 按键 说明 状态
移动 W A S D 或 方向键 上下左右 【可玩】
交互 F 采集野生蘑菇 / 播种 / 收获 / 睡觉 / 站到合成台开面板 / 站到祭坛开魔法书 / 站到门交钥匙 / 捡遗物包 【可玩】
攻击 空格 Space 自动瞄准（有敌人时：近距＝绽华AoE，远距＝星刺弹道；耗蓝/冷却） 【可玩】
施法 C 触发首个已解锁的治疗/增益能力（如青露伞→息壤）；无则提示 【可玩·限已解锁】
快捷栏切换 Q / E 上一格 / 下一格循环切换（跳过空格） 【可玩】
使用/食用 R 食用或使用当前选中的快捷格物品 【可玩】
背包 B 显示/隐藏背包（看材料 + 6 格便捷栏 + 穿/脱装备） 【可玩】
闪避 Shift 朝移动方向短冲刺（耗蓝 + 短暂无敌帧） 【可玩】
睡觉 回车 Enter 快速跳天（当前站床上按 F 即触发；Enter 为预留快捷） 【可玩·交互】
移动端测试模式 F3 在桌面打开虚拟摇杆，模拟移动端手感 【可玩】
返回/菜单 Esc 返回 / 呼出菜单 【占位】

注：【占位】的操作已在代码/输入层配置好，但目前没有对应玩法逻辑接入，按下不产生效果或仅留待后续里程碑（当前仅 Esc 返回/菜单，属 M7 后的菜单/结算部分）。

5. 移动端

  • 虚拟摇杆（左下）：拖动控制移动，手感与桌面一致。
  • 在手机/平板上自动显示；在桌面按 F3 可开启「移动端测试模式」显示摇杆，便于开发时验证。
  • 快捷栏：点两端格切换上一格/下一格，点中间格食用。
  • 动作按钮（攻击/施法/交互、≥44px 触控目标）为 M8 打磨项，当前移动端仅摇杆可移动。

6. 上手流程（30 秒）

  1. WASD / 摇杆 走出基地，往四周森林（T1）移动。
  2. 在林地看到发光蘑菇，走近按 F 采集（夜里才能采到夜生蘑菇——蓝色那批）。
  3. 第一次采到某种蘑菇会解锁对应能力，屏幕上方提示（现在是同一条文案：采集了「X」，解锁能力：Y）。
  4. 回基地，走到作物格（田里的方形），按 F 把你数量最多的可种植蘑菇种下去。
  5. 走到床上按 F 睡觉 → 进入下一天：作物按天成熟一阶段，同时扣一点饱食度、蓝回满、少量回血。
  6. 重复采集 + 种植 + 睡觉，直到作物成熟；站上去按 F 收获，进背包。
  7. 出基地会碰上该区机制的怪物（成群 3–5 只：夜行兽冲撞 / 孢子巫远程 / 腐根虫毒沼 / 洞窟守望者…）：用 空格 自动瞄准攻击、Shift 闪避；打掉会掉落材料（按 F 或走近自动拾取）。
  8. 带着「蘑菇 + 怪掉」回基地走到合成台按 F 打开面板，点「制造」合成门钥匙。
  9. 走到对应的门按 F 交钥匙 → 门开启、通往更深处（见 §7 进度链）。
  10. 死了会掉包：材料掉在死亡点的「遗物包」，你在基地复活；走回死亡点按 F 拾回。若在捡回前再死一次，旧遗物包会丢失。
  11. 按 B 随时查看背包；按 C 施放已解锁的治疗/增益法术。

7. 进度链（开锁无环）

蘑菇 / 能力 / 门按区域递进，每个开锁物的材料都来自该门之前已可达的区域，不会卡死：

基地(T0) 种田/采集/睡觉
   │ 靠「T1 蘑菇 + 林缘怪掉」合成 桥钥（8×晶铠蕈 + 1×孢子巫孢粹）
   ▼
过河「水域·装置」──► T2 中环 采蘑菇/打怪
   │ 靠「T2 蘑菇 + 中环怪掉」合成 魔钥（8×银芒菇 + 1×夜行兽魔牙）；
   │   夜间采 灼心芝 → 光明晶石（8×灼心芝 + 1×腐根虫腐脂，为 EQUIP）
   ▼
「魔法门」──► T3 洞窟（须穿戴光明晶石才看得清）
   │ 靠「T3 蘑菇 + 洞窟怪掉」合成 终钥（8×绯泪茸 + 1×洞窟之核）
   ▼
「最终·道路」──► 魔王地牢（预留占位）
  • 种田 = 变强：合成/升级所需蘑菇数已大幅上调（单把钥匙就要 8 朵对应蘑菇 + 1 怪掉），采集几下不够，必须回家种。
  • 昼夜驱动：灼心芝（光明晶石原料）只在 T2 夜间可采 → 强迫「挑时段出门」。
  • 法术升级：回基地站到魔药祭坛（紫色魔法书台座）按 F 打开魔法书，列出带 upgrade_cost 的蘑菇法术，显示 升阶效果/消耗，点升级扣对应蘑菇素材升阶（越升越贵）。
  • 穿戴光明晶石：在背包里点它穿/脱（绿框 = 已穿戴）。戴上才能看清 T3，脱下或不戴则洞窟近乎全黑。

8. 必须知道的三件事

  • 昼夜是两套环境，不是时间压力：白天/黑夜的可采蘑菇、可遇敌人、可用事件不同。想拿夜生蘑菇就挑晚上出门。
  • 蘑菇 = 一个功能多标签的素材：同一朵既可能是补给（回血/回蓝），也是合成、升级材料。合成台 / 魔法书把它 + 怪掉 变成门钥匙（如 8×银芒菇+1×魔牙→魔钥），或升阶法术。
  • 变强来自机制与积累，不靠等级墙：没有数值等级墙，靠解锁更多能力 + 升级法术 + 看懂怪物机制（谁冲撞、谁远程、谁铺毒沼）+ 正确的区域/昼夜规划。
  • 死了别慌：材料掉在原地可走回捡，但别在没捡回前再死——旧遗物包会被新的替代而丢失。

9. 快速排障

现象 处理
看不到虚拟摇杆 手机/平板会自动显示；桌面按 F3 切换移动端测试模式
采不到某种蘑菇 它可能是夜生蘑菇（白天不出现），夜里再去；或属于其它区域（蘑菇按 zone 分布），往对应区域找
作物格按 F 没反应 若已种下去，需等它成熟才能收获；未成熟按 F 会提示剩余天数
想重开一局 preview 为一次性、无存档，关闭重开即从第 1 天开始
门开不了 需先在合成台用对应「蘑菇 + 怪掉」合成门钥匙（每种 8 朵 + 1 怪掉），回到该门按 F 交纳；材料不足时「制造」按钮是灰的
/攻击/施法 不动 空格 需附近有敌人才瞄准出手；C 需已解锁治疗/增益（青露伞→息壤 等）才有效
R 食用没反应 当前选中格若不能食用（无回血/回蓝/回饱食）会提示；先用 Q/E 切到可食用物品
洞窟一片黑 那是 T3 无光洞窟，需在背包穿戴光明晶石（先到 T2 夜间采 灼心芝 合成）
死后找不到包 preview 不做死亡点标记；记一下死去位置，走回原地按 F 拾取

更多设计意图（为何 24 分钟一天、为何蘑菇驱动能力、为何 45° 菱形地图等）见 doc/dev_manual.md 与 doc/dev_review/m6_map_design.md。