[![Join the chat at https://discord.gg/f6aerfE](https://img.shields.io/discord/500285081265635328.svg?style=flat&logo=discord&label=discord&logoColor=f2f2f2)](https://discord.gg/f6aerfE) [![All Contributors](https://img.shields.io/github/all-contributors/stride3d/stride?color=ee8449)](#contributors) [![Financial sponsors](https://img.shields.io/opencollective/all/stride3d?logo=opencollective)](https://opencollective.com/stride3d) [![License](https://img.shields.io/badge/license-MIT-blue)](https://github.com/stride3d/stride/blob/master/LICENSE.md) Welcome to the Stride source code repository! Stride is an open-source C# game engine for realistic rendering and VR. The engine is highly modular and aims at giving game makers more flexibility in their development. Stride comes with an editor that allows you to create and manage the content of your games or applications visually and intuitively. ![Stride Editor](https://stride3d.net/images/external/script-editor.png) To learn more about Stride, visit [stride3d.net](https://stride3d.net/). ## Earn money by contributing If you are a developer with solid experience in C#, rendering techniques, or game development, we want to hire you! We have allocated funds from supporters on [OpenCollective](https://opencollective.com/stride3d) and can pay for work on certain projects. [More info about this here](https://doc.stride3d.net/latest/en/contributors/engine/bug-bounties.html). ## License and governance ### .NET Foundation This project is supported by the [.NET Foundation](https://dotnetfoundation.org). ### License Stride is covered by the [MIT License](LICENSE.md) unless stated otherwise (i.e. for some files that are copied from other projects). You can find the list of third-party projects [here](THIRD%20PARTY.md). Contributors need to sign the following [Contribution License Agreement](https://github.com/dotnet-foundation/.github/blob/main/CLA/dotnetfoundation.yml). ### Code of conduct Stride being a [.NET Foundation](https://www.dotnetfoundation.org/) project, it has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. For more information see the [.NET Foundation Code of Conduct](https://dotnetfoundation.org/code-of-conduct). ## Documentation Find explanations and information about Stride: * [Stride Manual](https://doc.stride3d.net/latest/manual/index.html) * [Tutorials](https://doc.stride3d.net/latest/en/tutorials/) * [API Reference](https://doc.stride3d.net/latest/api/index.html) * [Release Notes](https://doc.stride3d.net/latest/ReleaseNotes/index.html) ## Community Ask for help or report issues: * [Chat with the community on Discord](https://discord.gg/f6aerfE) * [Discuss topics on GitHub discussions](https://github.com/stride3d/stride/discussions) * [Report engine issues](https://github.com/stride3d/stride/issues) * [Donate to support the project](https://opencollective.com/stride3d/) * [List of Projects made by users](https://github.com/stride3d/stride/wiki/Community-Projects) * [Awesome Stride - Huge List of Stride Resources](https://github.com/Doprez/Awesome-Stride) * [Localization](https://doc.stride3d.net/latest/en/contributors/engine/localization.html) ## Building from source ### Prerequisites 1. **Latest** [Git](https://git-scm.com/downloads) **with Large File Support** selected in the setup on the components dialog and for convenience a git UI client like [GitExtensions](https://gitextensions.github.io/). 2. [.NET 8.0 SDK](https://dotnet.microsoft.com/en-us/download/dotnet/8.0) - Run `dotnet --info` in a console or powershell window to see which versions you have installed 3. [Visual Studio 2022](https://www.visualstudio.com/downloads/) with the following workloads: - `.NET desktop development` with `.NET Framework 4.7.2 targeting pack` (should be enabled by default) - `Desktop development with C++` with - `Windows 10 SDK (10.0.18362.0)` or later version (should be enabled by default) - `MSVC v143 - VS2022 C++ x64/x86 build tools (Latest)` (should be enabled by default) - `C++/CLI support for v143 build tools (Latest)` **(not enabled by default)** - Optional (to target iOS/Android): `.NET Multi-paltform App UI development` and `Android SDK setup` individual component (enabled by default), then in Visual Studio go to `Tools > Android > Android SDK Manager` and install `NDK` (version 20.1+) from `Tools` tab. - Optional (to build VSIX package): `Visual Studio extension development` ### Build Stride 1. Clone the repo with a git UI or open a command prompt, point it to a directory and clone Stride to it: `git lfs clone https://github.com/stride3d/stride.git` - **Do NOT use GitHub -> Code -> Download ZIP**, this won't include the ```lfs``` files. 2. Open `