Reading the repo
Opening the box…
Reading the repo
Opening the box…
How to install on Linux
The Operative: No One Lives Forever source code
Saved setup from 3 h ago
Will it work on Linux?
docs/INSTALL.mdThis guide is for players. It explains how to get from a release download to
a running game. To build the game from source instead, see
BUILDING.md.
Each release has these archives, named for its version (v0.0.3-alpha, for
example):
| Archive | What it is |
|---|---|
| nolfsrc-<version>.tar.gz | The one you want. The game built from source with the modern build's fixes and features. |
| nolfsrc-debug-<version>.tar.gz | The same with debug information. If the game crashes, it writes a backtrace to nolfsrc.log. |
To try changes before the next release, there is the
nightly: the
latest master, rebuilt each time a change is merged and its builds pass.
Its archives are named for the commit they were built from,
nolfsrc-nightly-<commit>.tar.gz and nolfsrc-debug-nightly-<commit>.tar.gz
(the first seven digits of its hash, nolfsrc-nightly-a16e5e8.tar.gz for
example), and each unpacks to a directory of that name. It has had no
testing beyond the builds, so expect the occasional new bug; say in a bug
report that you are on a nightly, and which commit. It installs like any
release.
The legacy build, the game built exactly as it shipped in 2001, bugs
included, is kept for archive purposes and is not attached to releases. To
get it, build it (BUILDING.md); each build on GitHub
Actions also keeps it as an artifact for a while.
No game files are included. Each archive has an installer script that copies the game's data from your own disc images and checks every file it writes.
Each release is the whole game, not a patch. Unpack it into a new, empty
directory, never over an earlier release or another installation of the
game. The installer checks this first and stops if the directory holds
anything the release does not: it lists every file of the release, and every
file the installer writes, in SHA256SUMS. To keep your saved games, copy
the old directory's Save folder into the new one.
Once the game is installed, sha256sum -c SHA256SUMS in its directory checks
every file of it (all but your settings, autoexec.cfg, which the game
rewrites).
The two discs of The Operative: No One Lives Forever, Game of the Year Edition (Europe), as disc images. These are the images the installer expects:
An image can be a plain .iso (your own rip), redump's .bin (or its
.cue), or redump's .zip download. A .bin or .zip is first
converted to a temporary .iso, which needs about 0.6 GB of free space per
disc; it is removed at the end. Other editions and other regions' discs
are not supported: the installer checks each image's checksum.
On Linux: Wine with 32-bit support, or Proton (Steam), and python3
if your images are .bin or .zip.
On Windows: nothing else. The game is a 32-bit Windows program.
On a Mac: CrossOver, or another Wine for macOS, to run it. The installer needs nothing more: it is a Perl script, and every Mac has Perl.
Unpack the archive:
tar xzf nolfsrc-v0.0.3-alpha.tar.gz # the version you downloaded
cd nolfsrc-v0.0.3-alpha
Each archive unpacks to a directory of its own name
(nolfsrc-debug-v0.0.3-alpha for the debug one).
Install the game data from your disc images, in either order:
./linux-install.sh /path/to/disc1.zip /path/to/disc2.zip
With no arguments it looks for the images in the game directory and the directory above it. You can run it again safely: files already in place are checked and kept, and your saves, settings, logs and screenshots are left alone.
Play:
./linux-run.sh
This starts the game immediately using your saved settings. To open the
launcher, run wine NOLFLauncher.exe with the same Wine prefix
(WINEPREFIX=~/.wine-nolf by default). Its Display and Advanced buttons
set the renderer, the resolution and the engine's options.
The game uses its own Wine prefix, ~/.wine-nolf, which is created on
the first run, so your own prefix is left alone. Arguments go to the
game: ./linux-run.sh ++windowed 1 starts it in a window whatever
Options > Display says. ./linux-run.sh --help says more.
Sound needs Wine's audio to work on your machine (winecfg, Audio tab). The
music needs nothing extra: the game directory has its own DirectMusic.
linux-install.sh as above.NOLF.exe.The controller works as an Xbox-style pad (see Controller). No winetricks or Protontricks are needed.
.tar.gz).windows-install.bat, or put them in the game
folder and double-click it.NOLF.exe to play immediately. Open NOLFLauncher.exe to change
launcher settings or use its Launch button.Windows support has had less testing than Linux. The programs are not signed, so SmartScreen may warn before the first start. If something goes wrong, please report it.
The game is a Windows program, so on a Mac it runs in CrossOver (or another
Wine). Its data is installed in macOS itself, with mac-install.command.
Unpack the archive into a folder of its own: double-click it in Finder.
Put both disc images into the game folder, then double-click
mac-install.command. It runs in a Terminal window and says when it is
done.
macOS may refuse to open it, as it was downloaded and is not signed. Then allow it in System Settings > Privacy & Security ("Open Anyway"), or run it in Terminal, which can also take the images from elsewhere:
cd ~/Downloads/nolfsrc-v0.0.3-alpha # the game folder
./mac-install.command /path/to/disc1.zip /path/to/disc2.zip
In CrossOver, make a new bottle (Windows 10), then use the bottle's Run
Command, browse to the game folder's NOLF.exe and run it; "Save command
as a launcher" keeps it for next time. The game starts immediately.
Run NOLFLauncher.exe in the same bottle to open the launcher.
The game, its movies and its music need nothing installed in the bottle.
If the picture is wrong, try opengl.ren or d3d7.ren in Options >
Display. The Mac installer has been tested on Linux, which runs the same
Perl, but not on a Mac yet, and the game has not been tried in CrossOver
here: please report how it goes.
d3d9.ren (Direct3D 9). If you see
rendering problems, pick opengl.ren or d3d7.ren (the original DirectX 7
renderer) in Options > Display. On Intel integrated graphics with
d3d7.ren, turn on "Intel graphics fix" if the screen goes black
underwater.Game > "Toggle crouch" to Yes.
An Xbox-style (XInput) controller works in the menus and in the game. That is also what Steam Input makes of the Steam Deck's controls and of most other pads.
Press the key left of 1 (backquote), or Shift+Esc, to open the developer
console in single player. Type Help for the commands and Cheats for the
cheat codes.
CONSOLE.md lists every command and cheat.VARIABLES.md lists the settings you can change there.If you get stuck in the level geometry, mpclip lets you fly out.
| File | What |
|---|---|
| autoexec.cfg | Your settings and key bindings, rewritten when the game exits. Delete it to start from the defaults (defaults.cfg). |
| Save/ | Saved games. |
| nolfsrc.rez | This project's archive: the game's code, built from source, and the modern build's own new files (the jukebox's list, the seasonal main menus). It loads after the game's own archives, so it overrides them. |
| nolfsrcdisc.rez | The modern build's changes to the game's own data (weapon and layout tables, a few textures), which the installer makes from your discs. |
| Custom/ | Mods: a .rez archive here can be picked in the launcher's custom archives, and loads after nolfsrc.rez. |
| launcher.ini | The launcher's settings (its Advanced options, the custom archives to load, the command line), in the modern build; the original kept them in the Windows registry. |
| modern.log | The modern build's log, emptied each run. Attach it when you report a problem. |
| NetHost.txt, modern-server.log | The dedicated server's settings, and its log in the modern build (below). |
The internet server list uses the OpenSpy master server
(master.openspy.net) in place of GameSpy's, which is gone. The modern build
plays with retail 1.003 players and servers.
The game directory also has the game's stand-alone server, NolfServ.exe:
a server with no player of its own, that keeps hosting deathmatch or
H.A.R.M. vs UNITY games for others to join. Players join it from the
Multiplayer menu (on the internet list, or over a LAN), or start the game
with +connect <address>:27888.
NolfServ.exe. Its setup wizard asks for the
session's name, the game type, the number of players, the port, the
options and the worlds; Finish starts the server../linux-server.sh. The first time it shows the same wizard;
after that it starts straight away with the saved settings. Without a
display (a server machine, a container) it runs under xvfb-run, a
virtual display, which then needs to be installed (xvfb); the wizard
then cannot be shown, so start it once on a desktop, or give the settings
on the command line.The settings are kept in NetHost.txt in the game directory. Each can also
be given on the command line as -<setting> <value>: -NetSessionName,
-NetPort (default 27888), -NetMaxPlayers (up to 16), -NetGameType (2
deathmatch, 1 H.A.R.M. vs UNITY), -NetUsePassword and -NetPassword, and
the game's options (-NetEndFrags, -NetEndTime, -NetRunSpeed, ...).
-nowiz starts without the wizard. For example:
./linux-server.sh -NetSessionName "My server" -NetMaxPlayers 8
The modern build adds to that:
-NetLevel <world>, once per world, sets the deathmatch level list
(-NetCALevel for H.A.R.M. vs UNITY), for example -NetLevel 'Worlds\Multi\DeathMatch\001THEPAD_DM';-MasterServer <host> names the master server the game is listed on
(default master.openspy.net; none lists it nowhere), which the
server's console shows when it starts;modern-server.log.The server answers on UDP port 27888 (or the -NetPort you give it): let
it through the firewall for players on other machines. It runs until Stop
Server is clicked (or the process is ended). Players on your own network
need nothing more. For the internet's server list, forward that UDP port on
your router to the server: the server reports to the master server itself,
but each player's browser then asks the server for its details directly,
and joins on the same port.
Run headless (--headless, or with no display), linux-server.sh keeps a
Wine prefix of its own, ~/.wine-nolf-server, so a game started on the same
machine is not tied to the server's invisible display.
In the legacy build, -nowiz is only read when another argument follows
it (a bug of the original server, which linux-server.sh works around).
You need Linux with Docker and the submodules:
git submodule update --init (or clone with
--recurse-submodules). ext/toolchains/ is the compilers (about 560 MB,
see ext/toolchains/README.md); ext/rez/ fetches and installs the retail game
(see ext/rez/README.md); ext/tools/ is the build's helpers and the
reconstruction tools and guides; ext/openmiles and ext/ffmpeg are the
modern build's open-source middleware (about 130 MB), and
ext/nolf1-modernizer the NOLF Modernizer, two of whose models the
modern build uses (about 60 MB); ext/lithtools is our LithTech tools,
whose lithrez packs the game's nolfsrc.rez.make # -> out/nolf-legacy-release/ and its -private / -public .tar.gz
# (about 3 minutes; the first time, also the docker image
# and the retail game's download and install)
make test # optional: plays two levels under Xvfb with scripted input
make debug # optional: the same game with symbols and debug logging,
# in out/nolf-legacy-debug/
make modern # optional: the game with the retail bugs fixed, in
# out/nolf-modern-release/ (both: docs/BUILDING.md, "Variant builds")
make progress # optional: how much of it matches the retail binaries
make help lists the other targets. docs/BUILDING.md explains the build in
detail.
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
The repo uses git submodules, so the clone fetches them too.
git clone --recurse-submodules https://github.com/nolffan/nolfsrc.git cd nolfsrc
make
sudo apt install make
In the maintainers' order. Do the README instructions above first — they cover steps outside the terminal.
make # -> out/nolf-legacy-release/ and its -private / -public .tar.gz make test # optional: plays two levels under Xvfb with scripted input make debug # optional: the same game with symbols and debug logging, make modern # optional: the game with the retail bugs fixed, in make progress # optional: how much of it matches the retail binaries
No reports for Linux yet.
GitManual AI Agent reads the 5 key files and writes a step-by-step guide for Linux. Once written, it's saved for everyone.