Appimage release

Package information

Appimage is a portable packaging format designed to simplify user interaction with software by removing the need to install it as a package or install its dependencies.

32 bit Appimage packages are provided since v1.8.12-alpha9 (25 Aug 2023).

The Appimage contains all 3 executables: non-hd client, hd client and dedicated server.

The Appimage release is not portable by default – it overrides config location and data location to use user’s home folder conforming to Freedesktop standard “XDG Base Directory Specification v0.8”. This is done specifically to allow making packages out of this AppImage and to allow direct system installation (in /usr/local/bin for example).

Paths used by the Appimage release

Please note, that $HOME is either user’s home or a portable home, depending on how you install OpenNox.

• Game files are expected to be in this directory: $HOME/.local/share/opennox
• Game configuration files are expected to be in this directory: $HOME/.config/opennox
• Game logs will be put into this directory: $HOME/.local/state/opennox

Prerequisites

Most probably, you are using 64 bit distribution of Linux. To use OpenNox you have to enable i386 architecture and install these packages:

• libc6:i386
• libfuse2:i386
• zlib1g:i386

Make sure you have 32 bit version of your graphics drivers installed to provide libgl1:i386.

On 32 bit distributions you probably have everything installed already.

Installation process (standard usage)

1. Download the Appimage file from the Opennox releases page. Put it anywhere you think is appropriate and mark it as executable.
2. Copy Nox content files into the $HOME/.local/share/opennox folder. Alternatively, you can install Nox into this folder.
3. (Optional) If you are migrating from binary release, please put opennox.yml into $HOME/.config/opennox folder.

Installation process (portable)

1. Download the Appimage file from the Opennox releases page. Put it anywhere you think is appropriate and mark it as executable.
2. Create portable home folder for the Appimage by running it with parameter –appimage-portable-home or by creating a folder with the same name as the Appimage and “.home” appended to the end. If Appimage file is opennox-bundle-i386.AppImage, then portable home folder must be named opennox-bundle-i386.AppImage.home.
3. Copy Nox content files into the .local/share/opennox folder inside the portable home folder you had created in step 2.
4. (Optional) If you are migrating from binary release, please put opennox.yml into the .config/opennox folder inside the portable home folder you had created in step 2.

Running the Appimage

Appimage release always checks the first parameter to decide which executable to run.

• To run OpenNox (legacy version), simply run the Appimage file.
• To run OpenNox HD, run the Appimage file with “hd” parameter as the first parameter.
• To run OpenNox dedicated server, run the Appimage file with “server” parameter as the first parameter.
• To get help about this Appimage release, run the Appimage file with “help” parameter as the first parameter. The help explains how to use Appimage and where files should be placed.

Troubleshooting

OpenNox doesn’t start

• Try starting OpenNox from the terminal. Check if there are any error messages there.
• Make sure you have Nox game files in $HOME/.local/share/opennox folder.

If nothing helps, please contact us on OpenNox Discord in #feedback channel and share the opennox.log located in the .local/state/opennox folder.

Can’t connect to a server: Version mismatch

HD and legacy versions won’t join servers of the opposite version.

Most online servers still run legacy version, so if you want to join them, you must run legacy version of OpenNox as well.

Binary archive release

Release information

This release is just OpenNox binaries packed into tar.gz archive.

Prerequisites

To run OpenNox you will need to install this dependencies:

• libc6:i386
• libopenal1:i386
• libsdl2-2.0-0:i386

Make sure you have 32 bit version of your graphics drivers installed to provide libgl1:i386.

Installation process (portable)

1. Download the tag.gz file from the Opennox releases page.
2. Unpack tar.gz archive contents into Nox installation folder.
3. Mark files opennox, opennox-hd and opennox-server as executable.

Installation process (non-portable)

1. Download the tag.gz file from the Opennox releases page.
2. Unpack tar.gz archive contents into folder of your choice.
3. Mark files opennox, opennox-hd and opennox-server as executable.
4. Copy Nox content files into your $HOME/Nox folder. Alternatively, you can install Nox into this folder.

Running the game

You need to create launchers yourself for executables you want to run.

Please note, that working directory must be set to the Nox installation folder.

Running from terminal

opennox

To run OpenNox HD, issue this command:

opennox-hd

To run OpenNox dedicated server, issue this command:

opennox-server

Troubleshooting

OpenNox doesn’t start

• Try starting OpenNox from the terminal. Check if there are any error messages there.
• Make sure you have put binaries into your Nox installation folder or have game files in the $HOME/Nox directory or in the place specified in opennox.yml (which can be either in $HOME/.config/opennox or in the working directory used to call binaries from):

game:
  data: /home/user/some/path/to/Nox

Change this path manually to a folder where your copy of Nox is installed, if necessary. Restart OpenNox.

If nothing helps, please contact us on OpenNox Discord in #feedback channel and share the opennox.log located in the $HOME/snap/opennox/common/logs folder.

Can’t connect to a server: Version mismatch

HD and legacy versions won’t join servers of the opposite version.

Most online servers still run legacy version, so if you want to join them, you must run legacy version of OpenNox as well.

Flatpak release

Package information

Flatpak is a packaging format designed to simplify user interaction with software by removing the need to install its dependencies.

Flatpak package is provided since v1.8.12-dev (0a8352c) (13 Jan 2023).

Flatpak package supplies only 2 executables: non-hd client and hd client.

Prerequisites

You will need Flatpak installed.

Installation process

1. Follow installation instructions on Flathub
2. Copy Nox content files into your $HOME/Nox folder. Alternatively, you can install Nox into this folder.

Running the game

After installing you should get two launchers in your applications menu: OpenNox and OpenNox HD. Run the one you need.

Running from terminal

To run OpenNox Non-HD (legacy) issue this command:

flatpak run io.github.noxworld_dev.OpenNox

To run OpenNox HD issue this command:

flatpak run --command=opennox-hd io.github.noxworld_dev.OpenNox

Troubleshooting

OpenNox doesn’t start

• Try starting OpenNox from the terminal. Check if there are any error messages there.
• Make sure you have Nox game files in $HOME/Nox or in the place specified in $HOME/opennox.yml:

game:
  data: /home/user/some/path/to/Nox

Change this path manually to a folder where your copy of Nox is installed, if necessary. Restart OpenNox.

If nothing helps, please contact us on OpenNox Discord in #feedback channel and share the opennox.log located in the logs folder, which is located either in your home folder or in OpenNox working directory.

Can’t connect to a server: Version mismatch

HD and legacy versions won’t join servers of the opposite version.

Most online servers still run legacy version, so if you want to join them, you must run legacy version of OpenNox as well.

Snap release

Package information

Snap is a packaging format designed to simplify user interaction with software by removing the need to install its dependencies.

Snap package is provided since v1.8.6 (19 Dec 2021).

Snap package supplies all 3 executables: non-hd client, hd client and dedicated server.

Prerequisites

You will need snapd installed.

Installation process

1. Follow installation instructions on Snapcraft
2. Copy Nox content files into your $HOME/Nox folder. Alternatively, you can install Nox into this folder.

Running the game

After installing you should get two launchers in your applications menu: OpenNox and OpenNox HD. Run the one you need.

Running from terminal

To run OpenNox Non-HD (legacy), issue this command:

snap run opennox

To run OpenNox HD, issue this command:

snap run opennox.hd

To run OpenNox dedicated server, issue this command:

snap run opennox.server

Troubleshooting

OpenNox doesn’t start

• Try starting OpenNox from the terminal. Check if there are any error messages there.
• Make sure you have Nox game files in $HOME/Nox or in the place specified in $HOME/opennox.yml:

game:
  data: /home/user/some/path/to/Nox

Change this path manually to a folder where your copy of Nox is installed, if necessary. Restart OpenNox.

If nothing helps, please contact us on OpenNox Discord in #feedback channel and share the opennox.log located in the $HOME/snap/opennox/common/logs folder.

Can’t connect to a server: Version mismatch

HD and legacy versions won’t join servers of the opposite version.

Most online servers still run legacy version, so if you want to join them, you must run legacy version of OpenNox as well.