{"id":13455452,"url":"https://github.com/o3de/o3de","last_synced_at":"2025-05-13T00:27:15.699Z","repository":{"id":36958892,"uuid":"354743391","full_name":"o3de/o3de","owner":"o3de","description":"Open 3D Engine (O3DE) is an Apache 2.0-licensed multi-platform 3D engine that enables developers and content creators to build AAA games, cinema-quality 3D worlds, and high-fidelity simulations without any fees or commercial obligations.","archived":false,"fork":false,"pushed_at":"2025-04-18T00:33:15.000Z","size":216843,"stargazers_count":8185,"open_issues_count":3508,"forks_count":2273,"subscribers_count":141,"default_branch":"development","last_synced_at":"2025-04-18T06:19:28.755Z","etag":null,"topics":["3d-graphics","3d-graphics-engine","animation","game-development","game-engine","gamedev"],"latest_commit_sha":null,"homepage":"https://o3de.org","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/o3de.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.MD","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-04-05T06:38:18.000Z","updated_at":"2025-04-18T00:33:22.000Z","dependencies_parsed_at":"2023-01-17T08:31:26.066Z","dependency_job_id":"59ce2d20-8ea3-40b3-b63b-40f4a55875bf","html_url":"https://github.com/o3de/o3de","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/o3de%2Fo3de","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/o3de%2Fo3de/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/o3de%2Fo3de/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/o3de%2Fo3de/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/o3de","download_url":"https://codeload.github.com/o3de/o3de/tar.gz/refs/heads/development","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250495339,"owners_count":21440155,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d-graphics","3d-graphics-engine","animation","game-development","game-engine","gamedev"],"created_at":"2024-07-31T08:01:05.641Z","updated_at":"2025-04-23T18:46:12.116Z","avatar_url":"https://github.com/o3de.png","language":"C++","readme":"# O3DE (Open 3D Engine)\n\nO3DE (Open 3D Engine) is an open-source, real-time, multi-platform 3D engine that enables developers and content creators to build AAA games, cinema-quality 3D worlds, and high-fidelity simulations without any fees or commercial obligations.\n\n## Contribute\nFor information about contributing to Open 3D Engine, visit [https://o3de.org/docs/contributing/](https://o3de.org/docs/contributing/).\n\n## Roadmap\nFor information about upcoming work and features, please visit [https://o3de.org/roadmap](https://o3de.org/roadmap). Progress against the roadmap is tracked [here](https://github.com/orgs/o3de/projects/56/views/2).\n\n## Download and Install\n\nThis repository uses Git LFS for storing large binary files.  \n\nVerify you have Git LFS installed by running the following command to print the version number.\n```\ngit lfs --version \n```\n\nIf Git LFS is not installed, download and run the installer from: [https://git-lfs.github.com/](https://git-lfs.github.com/).\n\n### Install Git LFS hooks \n```\ngit lfs install\n```\n\n\n### Clone the repository \n\n```shell\ngit clone https://github.com/o3de/o3de.git\n```\n\n## Building the Engine\n\n### Build requirements and redistributables\n\nFor the latest details and system requirements, refer to [System Requirements](https://o3de.org/docs/welcome-guide/requirements/) in the documentation.\n\n#### Windows\n\n*   Visual Studio 2019 16.9.2 minimum (All editions supported, including Community): [https://visualstudio.microsoft.com/downloads/](https://visualstudio.microsoft.com/downloads/)\n    *   Check [System Requirements](https://o3de.org/docs/welcome-guide/requirements/) for other supported versions.\n    *   Install the following workloads:\n        *   Game Development with C++\n        *   MSVC v142 - VS 2019 C++ x64/x86\n        *   C++ 2019 redistributable update\n*   CMake 3.22.0 minimum: [https://cmake.org/download/#latest](https://cmake.org/download/#latest) (Release Candidate versions are not supported)\n\n#### Optional\n\n*   Wwise audio SDK\n    *   For the latest version requirements and setup instructions, refer to the [Wwise Audio Engine Gem](https://o3de.org/docs/user-guide/gems/reference/audio/wwise/audio-engine-wwise/) reference in the documentation.\n\n### Quick start engine setup\n\nTo set up a project-centric source engine, complete the following steps. For other build options, refer to [Setting up O3DE from GitHub](https://o3de.org/docs/welcome-guide/setup/setup-from-github/) in the documentation.\n\n1.  Create a writable folder to cache downloadable third-party packages. You can also use this to store other redistributable SDKs.\n    \n1.  Install the following redistributables:\n    - Visual Studio and VC++ redistributable can be installed to any location.\n    - CMake can be installed to any location, as long as it's available in the system path.\n\n1.  Configure the engine source into a solution using this command line, replacing `\u003cyour build path\u003e`, `\u003cyour source path\u003e`, and `\u003c3rdParty package path\u003e` with the paths you've created:\n    ```\n    cmake -B \u003cyour build path\u003e -S \u003cyour source path\u003e -G \"Visual Studio 16\" -DLY_3RDPARTY_PATH=\u003c3rdParty package path\u003e\n    ```\n    \n    Example:\n    ```\n    cmake -B C:\\o3de\\build\\windows -S C:\\o3de -G \"Visual Studio 16\" -DLY_3RDPARTY_PATH=C:\\o3de-packages\n    ```\n    \n    \u003e Note:  Do not use trailing slashes for the \u003c3rdParty package path\u003e.\n\n1.  Alternatively, you can do this through the CMake GUI:\n    \n    1.  Start `cmake-gui.exe`.\n    1.  Select the local path of the repo under \"Where is the source code\".\n    1.  Select a path where to build binaries under \"Where to build the binaries\".\n    1.  Click **Add Entry** and add a cache entry for the \u003c3rdParty package path\u003e folder you created, using the following values:\n        1.  **Name:** LY_3RDPARTY_PATH\n        1.  **Type:** STRING\n        1.  **Value:** `\u003c3rdParty package path\u003e`\n    1.  Click **Configure**.\n    1.  Wait for the key values to populate. Update or add any additional fields that are needed for your project.\n    1.  Click **Generate**.\n    \n1.  Register the engine with this command:\n    ```\n    scripts\\o3de.bat register --this-engine\n    ```\n\n1.  The configuration of the solution is complete. You are now ready to create a project and build the engine.\n\nFor more details on the steps above, refer to [Setting up O3DE from GitHub](https://o3de.org/docs/welcome-guide/setup/setup-from-github/) in the documentation.\n\n### Setting up new projects and building the engine\n\n1. From the O3DE repo folder, set up a new project using the `o3de create-project` command.\n    ```\n    scripts\\o3de.bat create-project --project-path \u003cyour new project path\u003e\n    ```\n\n1. Configure a solution for your project.\n    ```\n    cmake -B \u003cyour project build path\u003e -S \u003cyour new project source path\u003e -G \"Visual Studio 16\"\n    ```\n\n    Example:\n    ```\n    cmake -B C:\\my-project\\build\\windows -S C:\\my-project -G \"Visual Studio 16\"\n    ```\n    \n    \u003e Note:  Do not use trailing slashes for the \u003c3rdParty cache path\u003e.\n\n1. Build the project, Asset Processor, and Editor to binaries by running this command inside your project:\n    ```\n    cmake --build \u003cyour project build path\u003e --target \u003cNew Project Name\u003e.GameLauncher Editor --config profile -- /m\n    ```\n    \n    \u003e Note: Your project name used in the build target is the same as the directory name of your project.\n\nThis will compile after some time and binaries will be available in the project build path you've specified, under `bin/profile`.\n\nFor a complete tutorial on project configuration, see [Creating Projects Using the Command Line Interface](https://o3de.org/docs/welcome-guide/create/creating-projects-using-cli/) in the documentation.\n\n## Code Contributors\n\nThis project exists thanks to all the people who contribute. [[Contribute](CONTRIBUTING.md)].\n\n\u003ca href=\"https://github.com/o3de/o3de/graphs/contributors\"\u003e\u003cimg src=\"https://contrib.rocks/image?repo=o3de/o3de\u0026max=200\u0026columns=24\" width=850px /\u003e\u003c/a\u003e\n\n## License\n\nFor terms please see the LICENSE*.TXT files at the root of this distribution.\n","funding_links":[],"categories":["Simulators","Game Engine","C++","Game Engines","游戏","Repos"],"sub_categories":["ML \u0026 Vision","Data Management","资源传输下载"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fo3de%2Fo3de","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fo3de%2Fo3de","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fo3de%2Fo3de/lists"}