From a85a7b4d0e0c0406df6d65ef78fbe07a0a72016c Mon Sep 17 00:00:00 2001 From: moyin <2443444649@qq.com> Date: Wed, 31 Dec 2025 18:17:58 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=AE=8C=E5=96=84=E9=A1=B9=E7=9B=AE?= =?UTF-8?q?=E5=85=A5=E9=97=A8README=EF=BC=8C=E5=BC=BA=E8=B0=83=E8=BE=93?= =?UTF-8?q?=E5=85=A5=E6=98=A0=E5=B0=84=E9=85=8D=E7=BD=AE=E7=9A=84=E9=87=8D?= =?UTF-8?q?=E8=A6=81=E6=80=A7?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 发现的关键问题: - 项目代码中使用了输入映射，但project.godot中未配置 - 缺少输入映射会导致游戏无法正常运行 主要改进: - 强调输入映射配置为必需步骤 - 添加重要提醒和警告标识 - 新增常见启动问题排查指南 - 明确列出必需的6个输入动作 - 完善完成检查清单 问题排查: - 游戏无法响应输入 输入映射未配置 - Invalid action错误 缺少必需输入动作 - AutoLoad单例报错 配置验证问题 确保新人成功: - 明确标注必需步骤的优先级 - 提供具体的错误解决方案 - 强调验证配置的重要性 --- docs/01-项目入门/README.md | 27 ++++++++++++++++++++++++--- 1 file changed, 24 insertions(+), 3 deletions(-) diff --git a/docs/01-项目入门/README.md b/docs/01-项目入门/README.md index 5f937ed..49faaaf 100644 --- a/docs/01-项目入门/README.md +++ b/docs/01-项目入门/README.md @@ -20,19 +20,38 @@ - AutoLoad单例设置 - 开发环境验证 -### 第三步：设置控制 🎮 +### 第三步：设置控制 🎮 **[必需]** **[输入映射配置.md](输入映射配置.md)** - 游戏输入控制配置 - 键盘和手柄映射 - 输入系统测试 +⚠️ **重要提醒**: 输入映射配置是必需的！项目代码中使用了 `move_left`、`move_right`、`move_up`、`move_down`、`interact`、`pause` 等输入动作，必须在Godot编辑器中正确配置，否则游戏无法正常运行。 + ## ✅ 完成检查 阅读完本目录的文档后，你应该能够： - [ ] 理解项目的整体架构 - [ ] 成功配置Godot开发环境 -- [ ] 正确设置游戏输入映射 +- [ ] **正确设置游戏输入映射** ⚠️ 必需 - [ ] 运行项目并进行基本测试 +- [ ] 验证所有AutoLoad单例正常工作 + +## 🚨 常见启动问题 + +### 问题1: 游戏无法响应输入 +**原因**: 输入映射未配置 +**解决**: 必须完成 [输入映射配置.md](输入映射配置.md) 中的所有步骤 + +### 问题2: 控制台出现"Invalid action"错误 +**原因**: 缺少必需的输入动作 +**解决**: 确保配置了以下6个输入动作： +- `move_left`, `move_right`, `move_up`, `move_down` +- `interact`, `pause` + +### 问题3: AutoLoad单例报错 +**原因**: AutoLoad配置不正确 +**解决**: 参考 [项目设置指南.md](项目设置指南.md) 验证配置 ## 🔗 下一步 @@ -42,6 +61,8 @@ ## 💡 小贴士 +- **输入映射是第一优先级** - 不配置输入映射，游戏无法正常运行 - 遇到问题时，先查看对应文档的"常见问题"部分 - 建议在实际操作中边读边做，加深理解 -- 可以将重要的配置信息做笔记备用 \ No newline at end of file +- 可以将重要的配置信息做笔记备用 +- 完成每个步骤后，建议运行项目验证配置是否正确 \ No newline at end of file