Subsections of Installation

Subsections of Install on Linux

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

Warning

OpenNox is not a full game. It requires game content files of the original Nox installation!

See GoG for purchase options. Original CD should work as well.

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

Warning

OpenNox is not a full game. It requires game content files of the original Nox installation!

See GoG for purchase options. Original CD should work as well.

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

Info

Navigate to the Nox installation folder, before running any of these commands.

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

opennox

To run OpenNox HD, issue this command:

opennox-hd

To run OpenNox dedicated server, issue this command:

opennox-server
Info

If you placed binaries not Nox installation folder, you have to provide a full or relative path to the binary.

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

Warning

OpenNox is not a full game. It requires game content files of the original Nox installation!

See GoG for purchase options. Original CD should work as well.

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

Warning

OpenNox is not a full game. It requires game content files of the original Nox installation!

See GoG for purchase options. Original CD should work as well.

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.

Install on Windows

Installation process

Warning

OpenNox is not a full game. It requires game content files of the original Nox installation!

See GoG for purchase options. Original CD should work as well.

  1. Install original Nox. Prefer locations outside of “Program Files”.
  2. Download latest OpenNox installer. Use .exe file for Windows.
  3. Install it to any directory (shouldn’t be the same as Nox itself).

Playing

HD version

  1. Go to OpenNox installation directory.
  2. Make a shortcut for opennox-hd.exe.
  3. Run it!
Info

HD version will not join public legacy servers!

This is done for fairness reasons, since not everyone runs OpenNox in HD. You can still host your own server for your friends to join.

Legacy version

  1. Go to OpenNox installation directory.
  2. Make a shortcut for opennox.exe.
  3. Run it!
Info

Legacy version will not join HD servers.

Make sure to run the same version as the server when playing online.

Troubleshooting

OpenNox doesn’t start

First, try running OpenNox with Administrator permissions. If it works, then your Nox copy is likely installed in the protected folder like “Program Files” which causes issues. Delete OpenNox folder, reinstall Nox to some other folder and install OpenNox again.

If it doesn’t help, open opennox.yml in OpenNox installation directory in a text editor (Notepad++ is a good option). Find section similar to this:

game:
  data: C:\Games\Nox

Change the path manually to a folder where your copy of Nox is installed. Restart OpenNox.

If it still doesn’t work, please contact us on OpenNox Discord in #feedback channel. It will help if you share opennox.log located in log folder in OpenNox install directory.

Can’t connect to a server: Version mismatch

As was explained in the installation section, 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. Make sure to try a correct version when joining a server.

Install on Steam Deck

Note

This guide is based on Linux installation guide.

Specific Steam Deck guide will be provided in the future as well.

Installing

Warning

OpenNox is not a standalone game. It requires a copy of original Nox installed!

See GoG for purchase options.

  1. Install original Nox from GoG (via Lutris or Heroic).
  2. Install OpenNox via Flatpak.

Playing

HD version

Installation should create a “OpenNox HD” shortcut in the start menu. Alternatively: run opennox-hd binary from terminal.

Info

HD version will not join public legacy servers!

This is done for fairness reasons, since not everyone runs OpenNox in HD. You can still host your own server for your friends to join.

Legacy version

Installation should create a “OpenNox” shortcut in the start menu. Alternatively: run opennox binary from terminal.

Info

Legacy version will not join HD servers.

Make sure to run the same version as the server when playing online.

Troubleshooting

OpenNox doesn’t start

Try starting opennox from the terminal. Check if there are any error messages there.

If it doesn’t help, open opennox.yml in OpenNox installation directory in a text editor. Find section similar to this:

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

Change the path manually to a folder where your copy of Nox is installed. Restart OpenNox.

If it still doesn’t work, please ping us on OpenNox Discord in #feedback channel. It will help if you share opennox.log located in log folder in OpenNox install directory.

Can’t connect to a server: Version mismatch

As was explained in the installation section, 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. Make sure to try a correct version when joining a server.