83561d639d
mono was the bottleneck restricting our ability to use a newer C# version. mono 6.12 is currently available. Although poorly documented on their website, this supports C# 9. https://www.mono-project.com/docs/about-mono/versioning/#mono-source-versioning indicates mono 6.12 uses Roslyn 3.9.0. https://github.com/dotnet/roslyn/blob/main/docs/wiki/NuGet-packages.md#versioning indicates Roslyn 3.9.0 supports C# 9. This unlocks C# 8 and C# 9 features previously unavailable to us. - https://learn.microsoft.com/en-us/dotnet/csharp/whats-new/csharp-version-history#c-version-80 - https://learn.microsoft.com/en-us/dotnet/csharp/whats-new/csharp-version-history#c-version-9 A newer version of StyleCop is required to avoid rules tripping up on the new syntax. Currently only prerelease versions are available but their use is encouraged https://github.com/DotNetAnalyzers/StyleCopAnalyzers/issues/3420#issuecomment-994899135 Fix style rule violations on existing rules where the newer language version makes some existing casts redundant or allows use of the null coalescing assignment operator.
4.4 KiB
To run OpenRA, several files are needed from the original game disks. A minimal asset pack can also be downloaded and installed by the game.
The following lists per-platform dependencies required to build from source.
Windows
Compiling OpenRA requires the following dependencies: * Windows PowerShell >= 4.0 (included by default in recent Windows 10 versions) * .NET 6 SDK (or via Visual Studio)
To compile OpenRA, open the OpenRA.sln solution in the
main folder, build it from the command-line with dotnet or
use the Makefile analogue command make all scripted in
PowerShell syntax.
Run the game with launch-game.cmd. It can be handed
arguments that specify the exact mod one wishes to run, for example, run
launch-game.cmd Game.Mod=ra to launch Red Alert,
launch-game.cmd Game.Mod=cnc to start Tiberian dawn or
launch-game.cmd Game.Mod=d2k to launch Dune 2000.
Linux
.NET 6 or Mono (version 6.12 or later) is required to compile OpenRA.
We recommend using .NET 6 when possible, as Mono is poorly packaged by
most Linux distributions (e.g. missing the required msbuild
toolchain), and has been deprecated as a standalone project.
The .NET 6
download page provides repositories for various package managers and
binary releases for several architectures. If you prefer to use Mono, we
suggest adding the upstream
repository for your distro to obtain the latest version and the
msbuild toolchain.
To compile OpenRA, run make from the command line (or
make RUNTIME=mono if using Mono). After this one can run
the game with ./launch-game.sh. It is also possible to
specify the mod you wish to run from the command line, e.g. with
./launch-game.sh Game.Mod=ts if you wish to try the
experimental Tiberian Sun mod.
The default behaviour on the x86_64 architecture is to download
several pre-compiled native libraries using the Nuget packaging manager.
If you prefer to use system libraries, compile instead using
make TARGETPLATFORM=unix-generic.
If you choose to use system libraries, or your system is not x86_64, you will need to install SDL 2, FreeType, OpenAL, and liblua 5.1 before compiling OpenRA.
These can be installed using your package manager on various distros:
Arch Linux
sudo pacman -S openal libgl freetype2 sdl2 lua51Debian/Ubuntu
sudo apt install libfreetype6 libopenal1 liblua5.1-0 libsdl2-2.0-0Fedora
sudo dnf install SDL2 freetype "lua = 5.1" openal-softGentoo
sudo emerge -av media-libs/freetype:2 media-libs/libsdl2 media-libs/openal virtual/opengl '=dev-lang/lua-5.1.5*'Mageia
sudo dnf install SDL2 freetype "lib*lua5.1" "lib*freetype2" "lib*sdl2.0_0" openal-softopenSUSE
sudo zypper in openal-soft freetype2 SDL2 lua51Red Hat Enterprise Linux (and rebuilds, e.g. CentOS)
The EPEL repository is required in order for the following command to run properly.
sudo yum install SDL2 freetype "lua = 5.1" openal-softType sudo make install for system-wide installation. Run
sudo make install-linux-shortcuts to get startup scripts,
icons and desktop files. You can then run the Red Alert by executing the
openra-ra command, the Dune 2000 mod by running the
openra-d2k command and Tiberian Dawn by the
openra-cnc command. Alternatively, you can also run these
mods by clicking on their desktop shortcuts if you ran
sudo make install-linux-shortcuts.
macOS
.NET 6 or Mono (version 6.12 or later) is required to compile OpenRA. We recommend using .NET 6 unless you are running a very old version of macOS (10.9 through 10.14).
To compile OpenRA, run make from the command line (or
make RUNTIME=mono if using Mono). Run with
./launch-game.sh.