Merge remote-tracking branch 'public/release_candidate' into release
[CRYENGINE.git] / README.md
blobb9b16037dc302a0a36d53d7f412bdeeacf29d920
1 # CRYENGINE
2 This repository houses the source code for CRYENGINE.
4 Instructions on getting started with git can be found [here](http://docs.cryengine.com/display/CEPROG/Getting+Started+with+git), along with details on working with launcher projects and git source code.
7 ## Building
9 In order to compile, you will need to install:
10 * A Visual Studio 2015, 2017 or 2019
11 * [FBX SDK (2016.1)](http://images.autodesk.com/adsk/files/fbx20161_fbxsdk_vs2015_win0.exe)
13 Steps:
14 1. Download the SDKs zip from the [releases page](https://github.com/CRYTEK/CRYENGINE/releases).
15 2. Extract the SDKs zip to `Code/SDKs`
16 3. Copy `C:\Program Files\Autodesk\FBX\FBX SDK\2016.1` to `Code/SDKs` and rename to `FbxSdk`.
17 4. Download [szip.tar.gz](https://support.hdfgroup.org/ftp/lib-external/szip/2.1.1/src/szip-2.1.1.tar.gz) and extract it's contents to `Code/SDKs/szip`.
18 5. If the CRYENGINE Launcher is installed, right click `cryengine.cryengine` and select "Generate Engine Solution". Otherwise, run `Tools/CMake/cmake_create_win64_solution.bat`.
20 CMake must be used to compile the engine, see [here](http://docs.cryengine.com/display/CEPROG/CMake) for more information.
22 ## Branches
23 The `release` branch provides stable snapshots of the engine. Most of the commits to this branch are [tagged](https://github.com/CRYTEK/CRYENGINE/releases).
25 The `stabilisation` branch is used for fixing bugs in the run-up to release. This branch is created by branching from `main` or the previous release, depending if it's a major (feature) or minor (stability) release.
27 A `release_candidate` branch may be created for a few days before a release, if we need some critical fixes before release.
29 Development takes place primarily in the `main` branch. This branch is not currently available for the general public.
31 ## Pull Requests
32 Pull requests are currently on hold, while we fix all the workflow issues the current process had.
33 For more details, see this [announcement post](https://www.cryengine.com/news/cryengine-on-github-live-updates-to-main-will-go-on-hiatus). Sorry for the inconvenience.
36 ## License
37 The source code in this repository is governed by the CRYENGINE license agreement, which is contained in [LICENSE.md](LICENSE.md), adjacent to this file. See also the FAQ [here](FAQ.md)
39 ```diff
40 + Please note: from March 20th 2018, the new CRYENGINE business model is in effect. 
41 + That means 5% royalties apply to projects developed and published on CRYENGINE 5.0 and beyond. 
42 + Check our new FAQ.md for all facts and exemptions.
43 ```