游戏引擎 / 系统课时
创建 3D 项目并整理目录
创建 3D 项目并整理目录
这节课把一个空白 Godot 4 工程整理成后续制作 3D 游戏的起点。你将选定渲染方式、确认项目根目录,再按场景、脚本和美术资源划分文件夹。完成后,工程能被重新打开,新增文件也有明确的存放位置。
学习目标
- 在 Godot 4 项目管理器中新建工程并选择合适的渲染器。
- 识别
project.godot和res://所代表的项目边界。 - 建立可扩展的目录与命名规范,验证工程能正常重新打开。
在项目管理器里创建工程
启动 Godot 4.x,进入项目管理器并选择 创建(Create)。把项目名称填为 first_3d,用浏览按钮选定一个空目录;如果选择的是父目录,则勾选自动创建项目子文件夹的选项,避免把项目文件散落在其他工程中。
渲染器按最终运行设备选择:桌面 3D 项目可先用 Forward+;主要面向手机可选 Mobile;需要照顾较旧显卡或较广兼容性时选 Compatibility。三者会影响渲染能力与性能取舍,而不是决定项目能否使用 3D 节点。确认路径后创建并打开工程。
首次进入编辑器时,左侧是场景树,中间是工作区,底部通常有文件系统面板,右侧是检查器。此时没有游戏场景是正常现象,不必为了测试项目而急着按运行按钮。
规划资源目录
在 文件系统(FileSystem) 面板中右键 res://,新建 scenes、scripts 和 assets 文件夹;再在 assets 下创建 models、textures、audio。也可以用操作系统的文件管理器建目录,再回到编辑器检查是否识别。
res://scenes/:保存可复用的场景文件,例如main.tscn、player.tscn。res://scripts/:保存 GDScript,例如main.gd、player_controller.gd。res://assets/models/:放置外部导入的模型文件。res://assets/textures/:放置贴图与材质使用的图片。res://assets/audio/:放置音乐与音效。
res:// 不是需要创建的实体文件夹,而是 Godot 对项目根目录的路径表示。比如 res://scenes/main.tscn 表示当前项目中 scenes 文件夹下的场景文件,不依赖你在电脑上的安装盘符。以后代码与资源引用优先使用这种路径。
文件夹和文件建议使用小写 snake_case,节点名称则用易读的 PascalCase。在 Windows 上能引用成功的大小写不一致路径,迁移到大小写敏感的系统后可能失效;统一命名能提前排除这类问题。
辨认项目配置文件
新工程的根目录中应有 project.godot。它记录项目设置,是 Godot 识别工程的关键文件;.godot 则主要存放编辑器生成的数据,不是保存业务场景与脚本的位置。不要为了整理目录而移动或删除 project.godot。
下面是 project.godot 中项目名称设置的片段示例,不是完整文件,不能直接用它覆盖已有配置:
[application]
config/name="first_3d"通常通过 项目 > 项目设置(Project Settings) 的应用配置修改名称更稳妥。保存设置后,再查看对应配置项或重新打开项目管理器,应该能看到工程名称为 first_3d;若自行编辑文件,应先关闭编辑器,避免与编辑器保存操作互相覆盖。
验证目录与修正常见问题
先在文件系统面板确认上述目录均位于预期位置,再关闭编辑器,从项目管理器重新打开该工程。只要能够正常加载、看到相同目录,并且项目根部保留 project.godot,基础工程就已就绪。
若项目管理器找不到工程,使用 导入(Import) 指向包含 project.godot 的目录,而不是指向 scenes 或 assets。若目录层级出现 first_3d/first_3d,应检查创建时是否重复勾选了子文件夹选项;不要直接在编辑器外大规模移动已有被引用的资源。