How to Install Red Eclipse

From Red Eclipse Wiki
Jump to: navigation, search

Windows

  • Download the Windows installer.
  • When it is done, double click the resulting EXE installer.
  • Run through the prompts to install Red Eclipse on your computer.
  • Run the Red Eclipse shortcut placed in your Start Menu.

If you get a permission denied error during install, right click the installer and Run as Administrator. Alternatively, you can change the install location to a user-writable folder (like "[My] Documents") during the install process.

Linux

Official packages

  • Install git, curl and the runtime dependencies of Red Eclipse.
    • On a Debian-like system (e.g. Ubuntu, Linux Mint), this can be done with the command:
      • sudo apt-get install git curl libsdl2-mixer-2.0-0 libsdl2-image-2.0-0 libsdl2-2.0-0
    • On a Fedora system, this can be done with the command:
      • dnf install curl SDL2 SDL2_mixer SDL2_image
  • Download the Linux tarball.
  • When it is done, move the resulting TAR.BZ2 file to your home directory (~/ or $HOME = /home/username).
  • Extract the contents into your home directory using your favourite archive utility.
    • Terminal command: tar -jxvf redeclipse_X.Y.Z_nix.tar.bz2
  • Enter the resulting folder (which will be called ~/redeclipse-X.Y.Z where X.Y.Z is the version number of the package).
  • Run ./redeclipse.sh

Debian/Ubuntu repository

There is a Red Eclipse package repository hosted on openSUSE Build Service that you can use to install game and/or server. The packages provided there are newer than distributions' packages, so if you prefer to install Red Eclipse via apt, you should install this repository. These packages are created by third parties and aren't officially supported by the Red Eclipse project.

Beware that only the latest stable release is available on the repository. It will occasionally receive updates whenenever the stable branch on GitHub is updated. If you want to test the latest and greatest version of Red Eclipse, you need to either use an #AppImage or install Red Eclipse from source.

The oldest supported distributions are Ubuntu 16.04 and Debian 8.0 for the client, and Ubuntu 14.04 and Debian 7.0 for the server.

To install the client, just go to this site and follow the instructions.

For the server, visit this site instead, and follow the instructions.

The packages are a fork of the original Debian Red Eclipse packages, but have been improved to reduce the size of a server installation.

AppImage

You can install Red Eclipse's stable and development editions as an AppImage. At the moment, only 64-bit AppImages are provided. If you need a 32-bit version, please join our chat and let us know. These packages are currently in testing and aren't officially supported by the Red Eclipse project.

Stable version

Download the latest stable AppImage, make it executable (using your file manager or running chmod +x redeclipse-stable-x86_64.AppImage). Then, double click the file or run it from the commandline (./redeclipse-stable-x86_86.AppImage). That's all you have to do, Red Eclipse should be up and running.

You can easily update Red Eclipse's AppImage by using AppImageUpdate. To do so, download the latest version, make it executable, and run it:

./AppImageUpdate-x86_64.AppImage redeclipse-stable-x86_64.AppImage

Development version

Download the latest development AppImage, make it executable (using your file manager or running chmod +x redeclipse-master-x86_64.AppImage). Then, double click the file or run it from the commandline (./redeclipse-master-x86_86.AppImage). That's all you have to do, Red Eclipse should be up and running.

You can easily update Red Eclipse's AppImage by using AppImageUpdate. To do so, download the latest version, make it executable, and run it:

./AppImageUpdate-x86_64.AppImage redeclipse-master-x86_64.AppImage

For better desktop integration (like updating AppImages with just a few clicks), check out appimaged.

OS X

  • Download the OS X tarball.
  • When it is done, click the resulting TAR.BZ2 file in your downloads folder on the dock.
  • Archive utility will extract the contents into the same folder and open a Finder window with redeclipse.app highlighted.
  • Drag and drop the redeclipse.app package to your favourite location (Desktop, Applications folder, whatever).
  • Run redeclipse.app.

If this is the first time running the app, the operating system complains that it can't run an unsigned package, simply right (or cmd) click and select Open. In future you will be able to run the app as normal, this will override the warning for all future attempts. You can also do this from the command line.

If you get stuck

Don't panic! If you have trouble working out how to install and run the game, you can get assistance on our live chat or forums. Please be ready to provide as much information as possible, especially what operating system you're on and specifically which package you're trying to install!