O3DE 入门:从安装到第一个实时场景
完成 O3DE 的安装、项目创建与基础场景搭建,并使用实体组件、脚本和材质灯光,制作可运行的首个实时场景。
- 1
下载并安装引擎
访问官网进入下载页,选择与操作系统匹配的正式版本并解压;首次启动时按提示选择工作区、缓存和配置目录,等待组件初始化完成。
- 2
创建项目
启动 Project Manager,点击 Create Project,填写项目名与项目路径,选择预制模板并确认创建;随后进入编辑器的 Level Editor 场景。
- 3
搭建基础场景
在左侧实体树选中 Level,添加静态模型实体并指定网格;调整 Transform 的位置、旋转和缩放,再复制若干实体组成地面与简单物体。
- 4
配置材质灯光
打开材质编辑器,为模型创建或指定材质并保存;回到场景添加 Directional Light,设置旋转、颜色和强度,运行后检查画面与阴影效果。
- 5
编写交互脚本
在脚本工作区新建 Python 脚本并绑定到实体,在 On Activate 事件中修改实体位置或属性;保存脚本后确认实体已添加对应事件处理器。
- 6
运行并调试项目
点击 Play 启动游戏,在运行窗口触发交互并观察结果;使用控制台、实体树和 Debugger 排查问题,修正后保存项目并记录运行方式。
💡 实用技巧
- 先使用预制模板,避免手动补齐项目结构
- 定期保存并备份场景、脚本与材质
- 复杂效果优先拆成多个独立实体
- 用性能检查器定位渲染和脚本开销
⚠️ 常见坑
- 脚本文件存在不代表事件已正确绑定
- 灯光方向或强度设置不当会导致场景发黑
常见问题
Q:首次启动时工作区和缓存应该怎么选?
首次启动 O3DE 时,按提示分别选择工作区、缓存和配置目录,并等待组件初始化完成。建议为项目和缓存预留足够磁盘空间,避免安装到需要额外权限的目录。
Q:添加的静态模型没有显示,该先检查什么?
先确认静态模型实体已指定有效网格,再检查 Transform 的位置、旋转和缩放是否正常。可复制该实体搭建地面和简单物体,并用 Directional Light 调整方向、颜色与强度排除场景发黑。
Q:Python 脚本写好了却触发不了交互怎么办?
检查脚本是否已保存并绑定到目标实体,同时确认实体的 On Activate 事件中已经添加对应处理器。脚本文件存在并不代表绑定成功,修改后应点击 Play 再次验证。