These are the setup instructions for working with and compiling Thrive.
Important Note: If you run into any trouble with the setup process, please bring them up on the forums, or if you are a team member you can ask on the development discord or open a github issue.
If you are a team member you can ask for help on the Private Developer Forums
You can also join and ask on our community discord please use the #modding or #development channels for that, depending on why you are trying to compile the game (to make a mod, or to contribute to the development).
Thank you!
The currently used Godot version is 3.5 mono. The regular version will not work. You can download Godot here: https://godotengine.org/download/ if it is still the latest stable version. If a new version of Godot has been released but Thrive has not been updated yet, you need to look through the previous Godot versions to get the right version. Using a different version than what is mentioned above will cause issues.
Godot is self-contained, meaning that you just extract the downloaded archive and run the Godot executable in it.
To clone the Thrive repository properly you need Git with Git LFS.
You need at least Git LFS version 2.8.0, old versions do not work.
On Linux use your package manager to install Git. On Mac install the
package manager homebrew if you don't already have
it, and use it to install Git. On Mac and Linux Git LFS is likely available
as a package named git-lfs
. If it is not install it manually. After
installing remember to run git lfs install
in terminal.
On Windows install Git with the official installer from:
https://git-scm.com/download/win You can use this installer to also
install Git LFS for you. After installing you need to run git lfs install
in command prompt. You'll probably want to turn autocrlf on
with the command git config --global core.autocrlf true
. If you don't,
there is a risk that you accidentally commit Windows-style line
endings.
If autocrlf
is not used on Windows, then nearly all of the game
files will get marked as changed when Godot editor is opened. So it is
strongly recommended that you follow the configuration instructions
regarding that in the previous paragraph.
If you previously had Git installed through cygwin, you must uninstall that and install the official Windows version of Git. You may also have to deleted all your cloned folders to avoid errors, and reboot your computer to have everything detect that Git is now in a different place.
If you haven't used Git before you can read a free online book to learn it here https://git-scm.com/book/en/v2 or if you prefer video learning these two are recommended https://www.youtube.com/watch?v=SWYqp7iY_Tc https://www.youtube.com/watch?v=HVsySz-h9r4
Next you need, .NET SDK. Recommended version currently is 7.0, but a newer version may also work.
On Linux you can use your package manager to install that. The package
might be called dotnet-sdk-7.0
. For example on Fedora this can be
installed with: sudo dnf install dotnet-sdk-7.0
On Windows don't install Mono or MonoDevelop, it will break things. Dotnet is a good tool to use on Windows. You can download an installer for that from: https://dotnet.microsoft.com/en-us/download
On mac you can install the dotnet sdk by downloading an installer from Microsoft's side. Important note for M1 mac users, you need to install the arm version, the x64 version doesn't work out of the box, so it is very much not recommended to be used.
The SDK is also available through Homebrew but it will install the latest version (even if that's not yet officially the version used by Thrive). But if you want that you can install it using:
brew install dotnet-sdk
At this point you should verify that running dotnet
in terminal /
command prompt runs the dotnet tool. If it doesn't you don't have .NET
SDK properly installed in PATH. You can list the available SDK
versions you have installed with:
dotnet --list-sdks
The output of that should not be empty.
You need a supported development environment for Godot with mono. Note: it is possible to get by with just C# build tools, but installing a development environment is the easier route.
Godot currently supports the following development environments:
- Visual Studio 2019
- Visual Studio Code
- JetBrains Rider
- MonoDevelop
- Visual Studio for Mac
On Linux MonoDevelop and Jetbrains Rider are recommended. To get an up
to date version of mono, first enable the mono repository:
https://www.mono-project.com/download/stable/ and then install the
following packages with your package manager: mono-complete monodevelop nuget
. Make sure it is a newer version of mono that comes
with msbuild. Fedora has mono in the official repo but it is too old
to work. If you are going to use Rider you don't need the monodevelop
package. With Rider it may be possible to skip the mono install and just
install dotnet sdk.
For a better experience with Godot, you can install the following addon for MonoDevelop: https://github.com/godotengine/godot-monodevelop-addin This is not needed for basic usage, so you can skip if you can't figure out how to install it.
Jetbrains Rider is recommended for Thrive development on Linux. It is available from: https://www.jetbrains.com/rider/
It has a Godot plugin which is easy to install. With Rider the debugging experience is better than with MonoDevelop.
If building in Rider doesn't work or some features are missing, then install the mono packages, also mentioned in the previous section. Or you can also change the build tools used by Rider.
For better experience make sure to install the Godot plugin for Rider.
On Windows you can use Visual Studio 2019 to work on Thrive. You can find download and setup instructions here: https://docs.godotengine.org/en/stable/getting_started/scripting/c_sharp/c_sharp_basics.html#configuring-vs-2019-for-debugging
Note: Setting up Visual Studio Code with Linux is possible, however it is recommended to use MonoDevelop or Rider instead.
Visual Studio Code, not to be confused with Visual Studio, doesn't come with build tools, so you'll need to install the build tools for Visual Studio from here: https://visualstudio.microsoft.com/downloads/?q=build+tools You will need at least VS Build tools 2019 due to the version of C# used by Thrive. During the installation process, make sure MSBuild tools is listed under the installation details.
Go back to where you downloaded the .NET SDK from and find All .NET
Framework Downloads Choose version 4.7 and select the Developer Pack.
If you can't find it you can download the 4.7.2 .NET developer pack from here: https://dotnet.microsoft.com/en-us/download/dotnet-framework/net472
Open Visual Studio Code and go to the Extensions tab. Get the extensions C#, Mono Debug, and C# Tools for Godot.
Open up a Project in Godot. On the top toolbar, go to Editor -> Editor Settings. Scroll down on the left window until you find Mono. Click on Editor and set External Editor to Visual Studio Code. Click on Builds and set Build Tool to MSBuild (VS Build Tools).
If you want to setup live debugging with Godot follow the instructions here: https://docs.godotengine.org/en/3.3/getting_started/scripting/c_sharp/c_sharp_basics.html#visual-studio-code
After downloading all the prerequisites you can now build Thrive.
If you plan on contributing to Thrive fork it on github so you have your own repository to work with. There is an in-depth guide for working with forks here.
Next, use git clone --recursive
to copy your fork to your
computer. If you're setting up Thrive just for testing or because you
want to try in development features you don't need to fork the
project, and can clone the main Thrive repository. If you cloned
without the --recursive
flag, you can initialize the submodules
afterwards. See the instructions for that a bit later in this
document. Also if you run into sudden build issues updating the
submodules is a good first step to solving such a problem.
Terminal showing git clone command. If you don't see the line with
"filtering content", then you don't have Git LFS working correctly.
If you don't have Github ssh key setup, you'll want to use a HTTPS URL
for cloning. Note that the screenshot is slightly outdated as it
doesn't clone the submodules with the --recursive
flag. So use the
up to date command in this document rather than what is shown in the
screenshot.
If you use the "download as zip" option on Github, it won't work. This is because that option won't properly include the Git LFS files in it.
Thrive uses git submodules so to make sure those are up to date you
need to run the following after cloning or pulling in latest changes
if the submodules were updated: git submodule update --init --recursive
Note: a path with spaces in it MAY NOT WORK, so to avoid issues you
should clone to a folder like ~/projects
or C:/projects
. Also, long
paths may cause issues on Windows. One additional potential problem is
non-English characters in the path name, for example if your path
includes "työpöytä", the setup will fail.
You should check at this point if
the image files in Thrive/assets/textures
can be opened, if they
can't be opened and their file sizes are tiny, you don't have Git LFS
properly installed.
For devs working directly with the Thrive repository switch to a feature
branch or create one when working on new features. For example git checkout 123_feature
.
This keeps the main branch clean as other branches can be merged through
pull requests on github which is the recommended way to get your code into
Thrive.
Now open your installed Godot with mono. It should open with a project manager window. From this window select the option to import a project.
Godot project manager with the import button highlighted. If you haven't used Godot before the list of projects is most likely blank, so please ignore the demo project in this screenshot.
Use that option and input the path to the folder you cloned Thrive in and import the project.godot file. Like this:
Clicking on "import & edit" will immediately open the project in Godot. So next time you open Godot you will see Thrive on the list of projects, double click it to open it.
Thrive on the project list
Now you should let the Godot editor sit for some time until it is done checking and importing all the assets. If the asset import fails it is probably because you didn't have Git LFS installed properly. If that happens delete the Thrive folder you cloned and go back to the Git LFS install step, after doing it again try cloning again.
If everything went fine you should now see Godot editor looking like in this image.
On the top toolbar, go to Editor -> Editor Settings.
Scroll down on the left window until you find the Mono section. Click on Editor. Set External Editor to your development environment.
Here selected IDE is Rider.
Click on Builds under Mono and set Build Tool to your compiler. If you have build errors, check if this is setup properly.
On Linux dotnet is the recommended build tool.
Even if you do not use the Godot script editor, Godot automatically opens some files and replaces the spaces with tabs. To stop Godot from messing with your files, go to Text Editor -> Indent and set Type to spaces
Thrive uses some external C# packages which need to be restored before compiling.
On Linux, or if you're using Visual Studio Code, open a terminal to
the thrive folder and run the following command: dotnet restore
it
should download the missing nuget packages. You may need to rerun this
command when new package dependencies are added to Thrive. Note: if
you use an IDE like MonoDevelop or Rider it like will automatically
restore missing packages when compiling the game through it. Also if
you use the command line dotnet
tool to compile the game, that will
also automatically restore packages.
On Windows you should use Visual Studio to restore the packages. To do
this open Thrive.sln
in the Thrive folder. The package restore might
automatically happen if you compile the solution. If it doesn't please
refer to this page on how to restore the nuget packages with Visual
Studio:
https://docs.microsoft.com/en-us/nuget/consume-packages/package-restore
If you have nuget in path or you use the Visual Studio command prompt
you should also be able to restore the packages by running nuget restore
in the Thrive folder.
Now you should be able to return to the Godot editor and hit the build button in the top right corner. If that succeeds then you should be good to go.
You can also compile from your development environment (and not the Godot editor) to see warnings and get highlighting of errors in the source code. However running the game from Visual Studio is a bit complicated.
If the compile fails with a bunch of Godot.something
or Node
not
found, undefined references, you need to compile the game from the
Godot editor to make it setup the correct Godot assembly
references. After that compiling from an external tool should work.
From MonoDevelop you can use the plugin mentioned before, that adds a
toolbar with a button to launch the game. To do that open Thrive.sln
with MonoDevelop and in the new toolbar select the options Thrive - Launch
and Tools
then you can hit the play button to the left of
the dropdown options. This should compile and start Thrive so that
breakpoints set in MonoDevelop work.
From Rider you can compile the game from the top right menu bar by
selecting the Player
target (with the Godot icon). That target
should automatically appear once you install the Godot plugin
(https://plugins.jetbrains.com/plugin/13882-godot-support). If things
don't work you should check Rider settings to make sure that the used
msbuild version is from dotnet and not mono.
With that plugin you can run the game from Godot (once you have ran once from Godot editor so that it sets up things), using these toolbar buttons and options:
If it doesn't automatically appear you should be able to manually add it with the configuration editor.
If the build in Godot editor succeeded, you should be now good to go.
You can run the game by pressing the play button in the top right of the Godot editor or by pressing F5. Additionally if you open different scenes in the editor you can directly run the current scene to skip the main menu.
If it didn't work you can try these:
- The troubleshooting tips at the end of this document
- Thrive community forums
- Thrive developer forums
- Thrive community discord
- Thrive developer discord (you can only access this if you are a team member)
to get help. Links to the forums and community discord are at the top of this document.
Due to current Git LFS server limitations you can't commit changes to files tracked by Git LFS if you are not a team member. If that is needed for a PR please ask some team member to commit the assets for you.
For information on committing to the LFS repository you can read this wiki page https://wiki.revolutionarygamesstudio.com/wiki/Git_LFS
In addition to the following optional downloads you need to have Godot
in your PATH for the scripts to find it. To do this create a link /
rename the Godot editor executable to just godot
or godot.exe
if
you are on Windows. Then you need to either add the folder where that
executable is to your system PATH or move the executable (along the
other Godot resources it needs) to a path that is already in PATH.
7zip is needed for the game release script, so if you're not packaging the game for release you don't need this.
On Linux and mac, use your package manager to install, it is probably
named p7zip
.
On Windows download the official
installer release. After installing, add the installed folder (where
7z.exe
is) to PATH environment variable. Confirm by running 7z.exe
in command prompt or powershell, it should print 7zip version info and
command line usage.
zip
command is also needed. It is most likely already installed on
Linux and Mac, but needs to be separately installed on Windows.
Thrive uses automatic formatting of source code to keep style as consistent as possible. It is highly recommended you install this linter to check your code formatting before submitting a pull request.
Jetbrains tools are now installed with dotnet. This happens automatically as long as you have installed the dotnet sdk.
If you want, you can manually install them with:
dotnet tool restore
If you specify to the formatting check script to not automatically restore the tools, you'll need to re-run that command in the Thrive folder whenever our checking tools versions change.
If you are planning to do anything that would require translation, or simply to translate the game into your locale language you may need a few more tools.
If you just want to easily make translations, you can find instructions for how to do that online in this document.
NOTE: if you are simply planning to edit or add a new localization, Poedit is enough. You can find more information on how to translate the game with poedit here.
Poedit is a free .pot and .po file editor that may make your life easier when working on translation files.
It is needed to create new .po files without using the command line tools.
NOTE: Poedit will complain about translation format since it was made to directly use text as keys. Those can be ignored.
If you want to run the translation scripts and checks, you need the gettext command line tools. They are also an alternative to using Poedit, with the gettext tools you can just use them and a plain text editor to work on translations.
On Windows you can download precompiled versions of the tools. You
will likely need to extract them and then add the folder you extracted
them in to your PATH for them to be found. Note that there are some
really old versions floating around on the internet. You should try to
find at least version 0.21
.
On Linux use your package manager to install the gettext
package. On Mac the same package
is available through Homebrew.
When you are getting ready to commit you should run dotnet run --project Scripts -- check
in order to automatically run all of the
formatting tools. Make sure that that script doesn't report any errors
before committing.
When running the script like that it can take a long time to run. See the pre-commit hook section for how to speed things up.
Alternatively you can run the script dotnet run --project Scripts -- changes
each time before you run the formatting check. That script
will build a list of changed files that the formatting checks will use
to skip checking non-changed files. But the pre-commit hook is
recommended as it is easier to use.
You can enable a pre-commit hook to automatically run the formatting checks before each commit to avoid accidentally committing code with formatting issues.
To install pre-commit run pip install pre-commit
. On Linux you can
optionally install it with sudo
or with the --user
flag as was
done for the dependencies needed for working with translations. More
instruction for installing pre-commit can be found
here.
Then, to install the hook run the following in the Thrive source folder:
pre-commit install
The hook has the advantage that it will only run the checks on the
files staged for commit, saving many minutes of time. You can manually
emulate this by creating a file in the Thrive folder called
files_to_check.txt
with one relative path per line specifying which
files to check.
First make sure your submodules are up to date:
git submodule update --init --recursive
because if they are not you will have missing or outdated files. Once you have done that check the other troubleshooting tips if that didn't help.
If you especially get errors for RevolutionaryGamesCommon
(for
example
RevolutionaryGamesCommon\DevCenterCommunication\DevCenterCommunication.csproj
or other csproj or .cs files missing), first try initializing and
updating git submodules and building again.
Godot sometimes likes to break your files for no reason. If you keep the Godot editor open while pulling new changes or changing branches, it's very likely to break so it is recommended to close Godot when doing such operations that change files outside the Godot editor, and then reopening the editor afterwards.
Because Godot sometimes just breaks files, before reporting an issue
building the game please check that git status
returns no
changes. If there are changes reported that you didn't make manually,
then see the section below about cleaning Godot.
If Godot still can't build the full game after following the instructions, you should verify that it's using the proper toolset. Go to Editor > Editor Settings > Builds under Mono in the panel on the left. For VS2019, you should select MSBuild (VS Build Tools) for the build tool option, if it isn't already.
If the build fails with errors about unsupported C# language version, you need to update your VS build tools, if you are on Windows, or mono, if on Linux. Note that you should use the official mono repo on Linux to get the latest version of mono.
Your locally cloned Thrive version may get messed up from time to time. Here are the steps to fix it.
You can find information about how to translate the game on the Working with translation page.
If you are on Windows and you see that most game files are marked as
changed after opening the Godot editor, then check your autocrlf
setting (instructions are in this file), and reclone or recheckout all
of the game files (while Godot is closed).
Due to a problem with caching with those tools, they may not be using the latest configuration on your computer. To fix this problem (for now, this has been reported to jetbrains you need to delete some cache folders.
On Linux these folders are:
~/.local/share/JetBrains/Transient
~/.local/share/JetBrains/InspectCode
/tmp/JetBrainsPerUserTemp-*
On Windows the cache folders are somewhere in your APPDATA folders.
There is a provided script dotnet run --project Scripts -- package
which helps with bundling the game up for releases. This relies on
godot
(or godot.exe
) being the name of the Godot editor that is
the current version and it being in PATH.
To set this up basically create a new folder that you add to PATH (Windows
registry, .bashrc
or .zshrc
for Linux/Mac) and create a copy or
symbolic link in it named godot
.
For Mac if you copied the Godot editor to your apps folder, like you should,
run the following (and then edit .zshrc
):
mkdir ~/bin
cd ~/bin
ln -s /Applications/Godot_mono.app/Contents/MacOS/Godot godot
./godot
The last command should have opened the Godot editor correctly. If it did,
close it and you are now ready to edit your shell startup script to put
the bin folder in your PATH. You can run pwd
command to see the full
path you need to include there.
After you have installed the prerequisites and checked the game runs fine from the Godot editor, you can just run the export script:
dotnet run --project Scripts -- package
Or if you want more control you can select which platforms to export to and skip zipping up the folder if you just want to test locally:
dotnet run --project Scripts -- package --zip false "Windows Desktop"
For more options run the script with the -h
parameter to see all of them:
dotnet run --project Scripts -- package --help