o3de/o3de

# O3DE (Open 3D Engine) O3DE (Open 3D Engine) 是一个开源、实时、多平台的 3D 引擎，让开发者和内容创作者能够在无需支付任何费用或承担商业义务的情况下，构建 AAA 级游戏、电影级质量的 3D 世界和高保真模拟。 ## 贡献 有关为 Open 3D Engine 做贡献的信息，请访问 [https://o3de.org/docs/contributing/](https://o3de.org/docs/contributing/)。 ## 路线图 有关即将进行的工作和功能的信息，请访问 [https://o3de.org/roadmap](https://o3de.org/roadmap)。路线图的进度跟踪可在 [此处](https://github.com/orgs/o3de/projects/56/views/2) 查看。 ## 下载并安装 此仓库使用 Git LFS 来存储大型二进制文件。 通过运行以下命令打印版本号，验证您已安装 Git LFS。 ``` git lfs --version ``` 如果未安装 Git LFS，请从 [https://git-lfs.github.com/](https://git-lfs.github.com/) 下载并运行安装程序。 ### 安装 Git LFS 钩子 ``` git lfs install ``` ### 克隆仓库 ``` git clone https://github.com/o3de/o3de.git ``` ## 构建引擎 ### 构建要求和可再发行组件 有关最新的详细信息和系统要求，请参阅文档中的 [系统要求](https://o3de.org/docs/welcome-guide/requirements/)。 #### Windows * Visual Studio 2019 16.9.2 最低版本（支持所有版本，包括 Community 版）：[https://visualstudio.microsoft.com/downloads/](https://visualstudio.microsoft.com/downloads/) * 请查看 [系统要求](https://o3de.org/docs/welcome-guide/requirements/) 了解其他支持的版本。 * 安装以下工作负载： * 使用 C++ 的游戏开发 * MSVC v142 - VS 2019 C++ x64/x86 * C++ 2019 可再发行组件更新 * CMake 3.24.0 最低版本：[https://cmake.org/download/#latest](https://cmake.org/download/#latest)（不支持候选发布版本） #### 可选 * Wwise 音频 SDK * 有关最新版本要求和设置说明，请参阅文档中的 [Wwise Audio Engine Gem](https://o3de.org/docs/user-guide/gems/reference/audio/wwise/audio-engine-wwise/) 参考。 ### 快速开始引擎设置 要设置以项目为中心的源引擎，请完成以下步骤。有关其他构建选项，请参阅文档中的 [从 GitHub 设置 O3DE](https://o3de.org/docs/welcome-guide/setup/setup-from-github/)。 1. 创建一个可写文件夹来缓存可下载的第三方包。您也可以使用它来存储其他可再发行的 SDK。 2. 安装以下可再发行组件： - Visual Studio 和 VC++ 可再发行组件可以安装到任何位置。 - CMake 可以安装到任何位置，只要它在系统路径中可用即可。 3. 使用以下命令行将引擎源代码配置为解决方案，将 ``、`` 和 `<3rdParty package path>` 替换为您创建的路径： cmake -B -S -G "Visual Studio 16" -DLY_3RDPARTY_PATH=<3rdParty package path> 示例： cmake -B C:\o3de\build\windows -S C:\o3de -G "Visual Studio 16" -DLY_3RDPARTY_PATH=C:\o3de-packages 4. 或者，您可以通过 CMake GUI 执行此操作： 1. 启动 `cmake-gui.exe`。 2. 在 "Where is the source code" 下选择仓库的本地路径。 3. 在 "Where to build the binaries" 下选择构建二进制文件的路径。 4. 点击 **Add Entry** 并为您创建的 <3rdParty package path> 文件夹添加一个缓存条目，使用以下值： 1. **Name:** LY_3RDPARTY_PATH 2. **Type:** STRING 3. **Value:** `<3rdParty package path>` 5. 点击 **Configure**。 6. 等待键值填充。更新或添加您的项目所需的任何其他字段。 7. 点击 **Generate**。 5. 使用以下命令注册引擎： scripts\o3de.bat register --this-engine 6. 解决方案配置完成。您现在可以创建项目并构建引擎了。 有关上述步骤的更多详细信息，请参阅文档中的 [从 GitHub 设置 O3DE](https://o3de.org/docs/welcome-guide/setup/setup-from-github/)。 ### 设置新项目并构建引擎 1. 从 O3DE 仓库文件夹中，使用 `o3de create-project` 命令设置一个新项目。 scripts\o3de.bat create-project --project-path 2. 为您的项目配置一个解决方案。 cmake -B -S -G "Visual Studio 16" 示例： cmake -B C:\my-project\build\windows -S C:\my-project -G "Visual Studio 16" 3. 在您的项目内运行以下命令，将项目、Asset Processor 和 Editor 构建为二进制文件： cmake --build --target .GameLauncher Editor --config profile -- /m 这将在一段时间后完成编译，二进制文件将位于您指定的项目构建路径下的 `bin/profile` 中。 有关项目配置的完整教程，请参阅文档中的 [使用命令行界面创建项目](https://o3de.org/docs/welcome-guide/create/creating-projects-using-cli/)。 ## 代码贡献者 这个项目的存在要感谢所有贡献的人。[[贡献](CONTRIBUTING.md)]。 ## 许可证 有关条款，请参阅此分发版根目录下的 LICENSE*.TXT 文件。

标签：3D世界构建, AAA游戏, Apache 2.0, Bash脚本, C++, CMake, Git LFS, O3DE, Open 3D Engine, Visual Studio, Windows开发, Wwise音频, 内容创作工具, 实时3D, 实时渲染, 开源3D引擎, 数字孪生, 数据擦除, 模拟仿真, 游戏开发, 游戏引擎, 电影级画质, 逆向工具, 高保真模拟