5.4 小游戏复盘下：玩法闭环与打磨定稿
5.4 小游戏复盘下：玩法闭环与打磨定稿
本节摘要：复盘下半场完成三件事：挖矿与收集的信号链路（矿石进背包、背包进界面）、反馈与打磨（音效、粒子、屏幕震动）、存档与定稿（配置式序列化、完成度检查单）。走完本节，"深井矿工"达到可以交给朋友试玩的版本——一个结构清晰、可扩展、可导出的完整小游戏。
上一节结束时留下三件悬案：挖掘未接、反馈全无、进度不存。本节逐一收网。开发节奏与上节一致：每个功能点先接通最小链路，再加打磨层——"先能用再好用"的顺序贯穿始终。
挖掘链路：从射线到背包
挖掘的判定用上节挂好的采样射线：玩家朝面朝方向挖，射线命中瓦片层，命中格即被挖除。关键设计是瓦片数据与游戏状态分离——瓦片地图存"这里是铜矿"，挖掘行为触发信号，矿石价值与背包逻辑都住在信号链下游。
# 挖掘控制器：挂在角色上 extends Node signal tile_dug(cell: Vector2i, ore_type: StringName) @export var dig_range := 40.0 func try_dig() -> void: var from := %Player.global_position var to := from + Vector2(%Player.face_dir * dig_range, 0.0) var hit := %Player.get_world_2d().direct_space_state.intersect_point( to, 1, [%Player.get_rid()]) if hit.is_empty(): return var col := hit[0].collider as TileMapLayer if col == null: return var cell := col.local_to_map(col.to_local(to)) var ore: StringName = col.get_cell_data(cell).get_custom_data(&"ore") if ore == &"": return col.erase_cell(cell) # 挖除 tile_dug.emit(cell, ore) # 宣告事实，不管谁来处理
这段代码刻意遵守第 3 章的纪律：挖掘控制器只宣告"某格被挖"，不关心背包满不满、界面要不要闪、音效放哪首。下游三个订阅者各自处理，互不认识。
收集与计分：一条信号流的完整走线
背包与计分是玩法的账房。数据结构从简：矿石按类型计数，字典即可。账房挂在全局层（跨场景存活），界面订阅它刷新显示——第 3 章信号总线模式的标准应用。
# 注册为全局的 Inventory extends Node signal ore_changed(ore_type: StringName, count: int) signal money_changed(total: int) var _ores: Dictionary = {} var money := 0 func add_ore(ore_type: StringName, value: int) -> void: _ores[ore_type] = _ores.get(ore_type, 0) + 1 money += value ore_changed.emit(ore_type, _ores[ore_type]) money_changed.emit(money)
界面的矿石计数与金币数各自订阅对应信号，回调里只改一个标签的文本。卖矿则是反向流程：回地面找商人交互，交互区域发信号，背包清点折现，钱进升级面板。到这里，玩法的核心闭环成形——挖矿赚矿、卖矿得钱、钱换装备、装备挖更深。一个能自我循环的目标系统，是一款游戏成为游戏的标志。
反馈层：三件便宜的魔法
闭环通了，但"挖到矿石"这件事在感官上是静默的。三个低成本反馈把它变得可感：音效（挖除瞬间短促咔哒）、粒子（碎屑按矿石颜色飞溅）、震动（镜头微抖半秒）。三者都是一次性投入，全期受益。
# 反馈三连：挂在挖掘控制器里，宣告之后立即演奏 func _play_feedback(ore: StringName) -> void: %DigSound.pitch_scale = randf_range(0.9, 1.1) # 音调微随机去机械感 %DigSound.play() %Debris.color = ORE_COLORS.get(ore, Color.GRAY) %Debris.emitting = true %Camera.apply_shake(2.0, 0.12)
打磨的通用心法藏在两行细节里：音调随机浮动让重复音效不显机械；震动有幅度与时长两个参数，宁可小到"说不出"，不可大到"晃眼睛"。反馈的量感是主观的，参数全部导出到面板，试玩的人说"舒服"就是终点。
⚠️ 常见坑：反馈只在"正向事件"上做。负向事件（背包满、挖到硬岩失败）同样需要反馈，否则玩家把沉默误解为"按键没生效"。失败也要有声有光，只是换成闷响与暗闪。
存档：配置式的最小可靠实现
存档需求先列清单：金币、矿石库存、已挖深度、升级等级。四样全是简单数据，用引擎内建的配置文件格式最省事——键值分节存取，人类可读，调试友好。
# 注册为全局的 SaveManager extends Node const SAVE_SECTION := "progress" func save_game() -> void: var cfg := ConfigFile.new() cfg.set_value(SAVE_SECTION, "money", Inventory.money) cfg.set_value(SAVE_SECTION, "ores", Inventory._ores) cfg.set_value(SAVE_SECTION, "depth", GameState.max_depth) cfg.save_to_user_path("deep_mine.cfg") func load_game() -> bool: var cfg := ConfigFile.new() if cfg.load_from_user_path("deep_mine.cfg") != OK: return false Inventory.money = cfg.get_value(SAVE_SECTION, "money", 0) Inventory._ores = cfg.get_value(SAVE_SECTION, "ores", {}) GameState.max_depth = cfg.get_value(SAVE_SECTION, "depth", 0) return true
两个工程决策需要说明。其一，何时存：挖到矿石立即存（增量小、频率可接受），比"只在回地面时存"更抗玩家流失——毕竟没人想重挖半小时的矿。其二，地图不存：挖掉的瓦片要不要恢复？第一版选择不存（每次下井地形重生成），换来存档永远轻量；这是设计取舍，不是偷懒——深度与资产都在，地形是可再生资源。
定稿检查单与变式扩展
交朋友试玩前过一遍检查单：暂停菜单能暂停且自身可操作（第 3 章故障五的预防）；返回主菜单后再进一局，无幽灵崩溃（信号断开检查）；存档损坏时能以新档进入（容错默认值）；窗口缩放后界面不错位（第 7 章适配）；音量总控有效；帧率在目标平台稳定（第 9 章）。
变式扩展给有余力的读者：矿石按深度分层分布（瓦片自定义数据加深度的生成规则）；每日随机矿脉（随机种子加存档记录）；装备系统从导出变量升级为资源对象（第 8 章数据驱动）；联机比拼深度（第 9 章高层网络接口恰好够用）。这款小游戏的骨架经过这四节的建设，已经能承接这些方向的任意一个。
图 1 定稿版信号流全景
全程复盘的最终清单
四节总复盘，一份可复用的开发次序表：目录与输入立规 → 测试关卡与角色骨架 → 手感三版迭代 → 镜头方案 → 核心玩法信号链 → 反馈层 → 存档层 → 定稿检查单。这份次序表的每一步都只依赖前面的步骤，没有回头路——这不是运气，是"先用能再好用、先闭环再打磨"的策略使然。换一款玩法不同的游戏，表里的"挖掘"换成"射击"或"解谜"，次序依然成立。
💡 复盘最重要的一条：整个开发过程没有一步是"先把工具全学完再动手"。每一项工具（射线、信号、配置存档）都是在具体需求出现的那一刻才引入的。带着问题学工具，是这套教程与"按手册顺序刷文档"最大的分野。
本节要点回顾
- 宣告者不管下游：挖掘只发信号，背包界面反馈存档四个订阅者各司其职
- 闭环是游戏的标志：挖矿卖钱换装备挖更深，目标系统自我循环
- 反馈三件套：音效随机音调、粒子按色飞溅、震动小量多次；负向事件同样要有反馈
- 存档用配置格式：键值可读好调试；挖到即存抗流失；地形不存是设计取舍
- 定稿检查单：暂停、切换卫生、存档容错、界面适配、音量、帧率六项过堂
- 开发次序表可复用：先用能再好用，先闭环再打磨，带着问题学工具
一款完整的游戏立住了。第 6 章升维进入 3D 世界，第 10 章将把这款游戏真正导出到各平台。