前言¶
在 Godot 4 里做 3D，常见问题往往不是「会不会写 GDScript」，而是整条链路没串起来：第一人称或第三人称控制器和相机怎么接、glb 导进来不显示、场景发暗或掉帧、敌人不会绕障碍。翻文档能查到单点 API，但 Agent 容易只改脚本、不动导入设置、导航网格或导出选项。
下面介绍 SkillHub 上的社区 Skill「3D 游戏开发（Godot 4）」。它把脚手架、角色控制、资产、灯光、寻路、验收和导出写成一套可跟做的流程，适合在 Cursor、Claude Code 等支持 Skills 的环境里，用自然语言触发后按步骤落地。
这是什么¶
3D 游戏开发（Godot 4） 是 SkillHub 社区来源（community）的编程类 Skill，坐标 @user_51ab3167/3d-game-dev，当前版本 1.0.0，标签标明 requires_api_key=false（不依赖额外 API Key）。
定位一句话：用 Godot 4 + GDScript 做 3D 游戏的端到端工作流 Skill；只做 3D，2D 项目应使用 2d-game-dev skill。
官方入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_51ab3167/3d-game-dev
- API 地址：https://api.skillhub.cn/user_51ab3167/3d-game-dev
核心功能¶
以下能力均来自 Skill 官方简介，按开发顺序归纳。
项目与角色控制¶
- 项目脚手架搭建。
- CharacterBody3D 第一/第三人称控制器。
- 相机：鼠标视角、SpringArm3D 等常见 3D 相机方案。
资产与画面¶
- glTF 导入管线；提及免费 CC0 资产来源 KayKit、Poly Haven。
- StandardMaterial3D 材质与贴图。
- WorldEnvironment 灯光与氛围。
玩法与 UI¶
- NavigationAgent3D 敌人寻路。
- 动画播放、HUD。
质量与发布¶
- 无头验证与截图验收。
- 性能优化、项目导出。
典型触发说法¶
Skill 说明中列出的触发场景包括（中英文均可）：「做一个 3D 游戏」「第一人称/第三人称/FPS/TPS/3D 平台跳跃」「用 Godot 做 3D」「加个 3D 角色控制器/相机/敌人寻路/关卡」「导入 glb 模型不显示」「3D 场景太暗/太卡」「make a 3D game」「first-person controller in Godot」等。
安装与启用¶
Skill 基于通用 SKILL.md 格式。在 SkillHub 页面上，官方给出的安装方式是：让 AI 根据安装文档安装指定坐标。
方式一：提示词安装（页面推荐）¶
将下面提示发给当前 Agent：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_51ab3167/3d-game-dev`。
方式二：SkillHub CLI¶
先确认本机是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装（含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装 Skill 时，文档要求必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。常用路径示例：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装命令形式（将 <skills 目录> 换成上表对应路径）：
skillhub install user_51ab3167/3d-game-dev --dir <skills 目录>
也可先搜索再安装：
skillhub search 3d-game-dev
skillhub install user_51ab3167/3d-game-dev --dir <skills 目录>
文档说明：安装到正确目录后，部分环境仍需重启或刷新 Agent 才能加载新 Skill。
典型用法¶
安装并启用后，用 Skill 简介中的场景描述问题即可，例如：
- 「用 Godot 4 做一个第三人称 3D 平台跳跃，需要角色控制器和 SpringArm3D 相机。」
- 「glb 模型导入后不显示，帮我按 glTF 管线检查。」
- 「场景太暗，用 WorldEnvironment 调灯光氛围。」
- 「给敌人加 NavigationAgent3D 寻路。」
- 「做无头验证和截图验收，再优化性能并导出。」
Agent 应按 Skill 内工作流引导：从脚手架到控制器、资产、灯光、AI、HUD，再到验证与导出，而不是只零散改单个脚本。
适用场景与注意¶
适合谁
- 已在用或打算用 Godot 4 做 3D，希望 Agent 按固定流程推进的开发者。
- 需要 FPS/TPS、平台跳跃、基础敌人 AI、导入与性能、导出一条龙的人。
限制与注意
- 仅覆盖 3D；2D 请用 2d-game-dev skill。
- 来源为 community，技能质量依赖发布者维护，升级前可用
skillhub查看版本（当前页面为 v1.0.0）。 - SkillHub 页面统计（以抓取资料为准）：评分 100000，下载 2918，安装 0；数据会随平台更新变化。
- 本地仍需安装 Godot 4 编辑器；Skill 指导工程结构与 GDScript，不能替代引擎本身。
- CLI 安装脚本需联网；受限网络环境需按文档在可访问外网的环境执行。
结尾¶
3D 游戏开发（Godot 4） 把 Godot 4 三维项目从控制器、glTF 资产、灯光氛围、导航 AI 到验收与导出串成一条可复现路径，适合作为 Agent 侧的 3D 专项 playbook。需要安装或查看详情时，打开 SkillHub 官方页面：https://www.skillhub.cn/skills/user_51ab3167/3d-game-dev 。
