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