Repository navigation
v0.1.0
Linux-only for now. Win+Mac coming soon.
OpenUT2k4 v0.1.0
OpenUT2k4 is an open-source recreation of Unreal Tournament 2004 on Unreal Engine 5.8. This release is a Linux client
and dedicated server. The server includes the OpenUT2k4 Validator.
No UT2004 game data is included. The client can download the game for you from OldUnreal, or use a copy you
already have.
Client
Download: OpenUT2k4-0.1.0-Linux.tar.gz
- Extract the archive anywhere and run
./OpenUT2k4.sh. To see the frame rate, runmangohud ./OpenUT2k4.sh. - On first start the UT2004 Content screen opens.
- If you don't have UT2004, choose Download UT2004 from OldUnreal.
- OldUnreal distributes the full game for free with Epic's permission. You accept the Epic Games Terms of Service
once, then everything happens automatically:- The game downloads the 3 GB image from OldUnreal's mirrors. The download can be resumed and is checked with
SHA-256. - It installs only what it needs.
- It deletes the image afterwards.
- The game downloads the 3 GB image from OldUnreal's mirrors. The download can be resumed and is checked with
- It takes about 2 minutes on a fast connection and needs about 9 GB of free space while installing.
- No CD key is needed.
- OldUnreal distributes the full game for free with Epic's permission. You accept the Epic Games Terms of Service
- If you already have UT2004 (retail, Steam or OldUnreal), the game usually finds it. Otherwise choose
Browse for UT2004... and pick the folder that containsSystemandMaps. Your install is only read, never
changed. - The content is converted once: about 1.5 minutes, about 6 GB. After that you go straight to the main menu.
UT2004 Content in the main menu converts again if you need it.
Features:
- Offline: Single Player tournament, Instant Action and bots in DM, TDM, CTF, Bombing Run, Double Domination,
Onslaught, Assault, Invasion, Last Man Standing and Mutant. - Online:
- Join Game lists UT2004 servers from the 333networks and OpenSpy master servers, plus LAN servers.
- Missing maps and server packages download automatically.
- Supported on modded servers:
- NewNet hit registration with lag compensation;
- UTComp and UTPlus hit sounds;
- UTComp warmup and ready-up;
- the mods' own HUDs and scoreboards (3SPN/TAM, UTComp, RezQ-style).
- Host Game: a listen server or a dedicated server that both OpenUT2k4 and real UT2004 players can join.
- Player identity: on first start the client silently makes a player key. Servers that run the OpenUT2k4 Validator
use it as your stable player ID. There is nothing to set up. - Stats tracking is off by default, as in UT2004.
Known limitations:
- Missing on modded servers:
- the mods' own on-screen messages (UTComp emoticons, the "press F5" prompt);
- UTComp's in-game settings menu;
- mod 3D models.
- Anti-cheat: servers that run third-party anti-cheat (AntiTCC and similar) may kick OpenUT2k4. The client does
not run or imitate third-party anti-cheat; see the Validator section below. - Movement: a few map-specific spots still cause small position corrections online.
Dedicated server
Download: OpenUT2k4Server-0.1.0-Linux.tar.gz
The server is headless: no window, GPU or audio. It hosts matches for OpenUT2k4 players and for real UT2004 clients
(retail 3369 and OldUnreal 3374). It uses UT2004-style ini files and command lines. The default settings are the
stock UT2004 dedicated server's, and master server listing is off by default.
# Once: convert the content. If the client already ran (and downloaded or converted UT2004) as the same user on
# this machine, the server finds that copy by itself and you can skip this.
./openut2k4-server -ConvertOnly -UT2004Dir=/path/to/UT2004
./openut2k4-server # DM with the stock map rotation, port 7777
./openut2k4-server "CTF-Face3?game=XGame.xCTFGame?MinPlayers=8" -port=7787
./ucc server "DM-Rankin?game=XGame.xDeathMatch" ini=MyServer.ini # UT2004 style-
Configuration: copy
Server/OpenUT2k4Server.iniand pass it with-ServerConfig=MyServer.ini. An existing
UT2004.iniworks too, because the section names match. -
Admin:
- Type
helpon the console for the commands (status,kick,ban,map,addbot...). - A TCP admin console is available on 127.0.0.1:7780 when enabled.
- Type
-
systemd service:
Server/linux/install-service.sh --user --name dm1 [--convert --ut2004 /path/to/UT2004]. -
Ports:
Port Protocol Purpose 7777 UDP game 7778 UDP query 10777 UDP LAN beacon To be listed publicly, set
DoUplink=Trueand forward the game and query ports.
OpenUT2k4 Validator (optional, for admins)
In plain terms: UT2004 servers identify players by a CD-key hash, and anyone can change that today, so a banned
player can simply come back. The validator gives every OpenUT2k4 player a proven identity instead. Admins get bans
that stick, a way to treat brand-new identities with caution, and ban lists they can share with other servers.
- For players: this is invisible. The client creates its key on first start and answers the server
automatically. There are no accounts, no registration and nothing to configure. - For admins: it is opt-in. Install it, and from then on you can see which players are OpenUT2k4, recognise them
across visits, and ban them reliably. - For other anti-cheat: existing anti-cheat mods can ask the validator about a player and decide to trust
validated OpenUT2k4 players instead of kicking them.
The validator is not an anti-cheat bypass:
- OpenUT2k4 clients always identify themselves as OpenUT2k4.
- They never imitate the stock client or answer third-party anti-cheat.
- What the validator proves is who a player is. Catching cheats is left to its server-side checks and to the
admins.
What it does:
- Player identity:
- Each OpenUT2k4 player has their own key, generated automatically.
- The server sends a fresh challenge, bound to its address. The client signs it and the server checks the
signature. - Each player gets a result: Identified, Failed (bad, relayed or replayed answer) or None (real UT2004
clients, which are left untouched).
- Bans that stick: a ban records the player key, the IP address the server sees, an optional subnet and the
UT2004 CD-key ID. A banned player who deletes their key and rejoins is still caught by the IP match. - Probation for new keys: admins can allow, flag, limit or kick keys their server has never seen, for a set time,
with an optional cap on how many are let in. - Shared ban lists: lists signed by an admin's own Ed25519 key, imported only from issuers you trust.
- Server-side checks: speed hack (timestamp rate), movement speed, NewNet timing and aim snaps. These are
conservative and log only by default. - For other mods and anti-cheat authors: an API exposes each player's result, key fingerprint, first-seen date,
IP, probation flag and a ban-list query. Existing anti-cheat can choose to trust validated OpenUT2k4 players.
Cost: about 13–17 ms of UnrealScript time per login, spread over several server frames, on a stock server.
Install on a stock UT2004 server (3369 or OldUnreal 3374), from the package's Validator/ folder:
- Copy
System/OpenUT2k4Validator.uand.intinto the server'sSystemfolder. - Merge
System/OpenUT2k4Validator.iniinto the server ini. - Under
[Engine.GameEngine]add:ServerActors=OpenUT2k4Validator.OUTValidator - Behind NAT, set
PublicAddress=<your public IP or host name>in[OpenUT2k4Validator.OUTValidator], so
relayed challenges fail.
On the OpenUT2k4 dedicated server the validator is built in. It is off by default; enable it with the same
ServerActors line.
Defaults are permissive: everyone is allowed, and results are logged and marked. Admins choose stricter policies
in the ini.
Shared ban lists:
- Signing tool:
Validator/Tools/openut2k4_signing.py, withgenkey --name banlist,banlist-export,-sign,
-verifyand-import. - Stock servers fetch lists through a small cron helper, because UT2004 has no HTTPS.
- The OpenUT2k4 server fetches and verifies lists itself.
Limits:
- The validator proves who a player is, not that their build is unmodified.
- A new key plus a VPN or a new IP still gets past a ban; probation slows that down.
- Subnet bans can hit innocent players on shared ISPs, so they are off by default.
Full documentation: Validator/Validator.md in the server package, or Server/Docs/Validator.md in the repository.
Feature parity with UT2004
| Area | Status |
|---|---|
| Game types: DM, TDM, CTF, Bombing Run, Double Domination, Onslaught, Assault, Invasion, Last Man Standing, Mutant | ✅ |
| Vehicle CTF | ✅ online; played with CTF rules when hosted by OpenUT2k4 |
| Single Player tournament, Instant Action, Host Game, server browser, settings | ✅ |
| Stock maps (all 239), weapons including the Translocator, vehicles, adrenaline combos | ✅ |
| UE2 movement: dodge, double jump, air control, step-up, swimming, ladders, lifts | ✅ matches the UT2004 server's physics to within a few units |
| Map behaviour: zones, volumes and currents, movers, triggers, emitters, sky boxes, jump pads | ✅ |
| Bots in every mode | ✅ Assault is partial: AS-MotherShip's shield is destroyed in about a third of rounds |
| Custom community maps and packages | ✅ converted automatically from the custom content folder |
| UnrealScript mods on servers | |
| Voice chat | ❌ |
WebAdmin, in-game adminlogin, map voting on OpenUT2k4-hosted servers |
❌ (admin console and admin commands instead) |
| Package downloads offered by OpenUT2k4-hosted servers | ❌ (clients must already have the map) |
| Windows and macOS builds |
Compatibility with UT2004
- Content: uses your own UT2004 install (retail, Steam, or OldUnreal 3369 / 3374), including custom
.ut2maps
and packages. Nothing in your install is modified. - Joining servers:
- Joins stock 3369 and OldUnreal 3374 servers.
- Joins modded servers: UTComp / WSUTComp, 3SPN / TAM / Freon, NewNet weapons, UTPlus, RezQ-style scoreboards,
Vehicle CTF. - Logs in without a CD key, as the OldUnreal 3374 client does.
- Stats logins are compatible.
- Downloads: server packages and maps come over HTTP redirects (
.uz2) or the in-game file channel, with GUID
checks. A map with the same name as a stock map but a different GUID is detected. - Hosting:
- Real UT2004 clients (3369 and 3374) can join OpenUT2k4 listen and dedicated servers.
- The server answers UT2004 server queries and the LAN beacon, and can register with the 333networks and OpenSpy
master servers.
- Server configuration:
- UT2004-style
ucc server <Map>?game=...command lines. UT2004.inisection names, stock map lists,ServerActorsandBannedIDs.- Ban IDs compatible with the stock server's CD-key IDs.
- UT2004-style
- OpenUT2k4 Validator: runs as a normal mutator on stock 3369 and 3374 servers.
New in OpenUT2k4
- Modern engine: Unreal Engine 5.8 rendering of the original art.
- Hardware ray-traced lighting.
- HDR, ultrawide and modern window modes.
- FSR 3.1 upscaling.
- Low-latency modes: AMD Anti-Lag and frame pacing.
- Native 64-bit Linux with Vulkan.
- Zero-hassle setup: the client downloads the game from OldUnreal if you don't have it and converts it
automatically. Custom maps are converted as you add them. - Online:
- NewNet lag compensation and the mods' HUDs and scoreboards in a non-stock client.
- Resumable, verified downloads with a cache shared across servers.
- Player identity and the OpenUT2k4 Validator:
- automatic per-player keys;
- bans that combine key and IP;
- probation for new identities;
- signed shared ban lists;
- server-side sanity checks;
- an API for other mods.
- Dedicated server:
- Headless, with no GPU or audio.
- Runs as a service with systemd; Windows and launchd service setups are included but untested.
- TCP admin console, server profile folders, clear exit codes,
MinPlayersbots.
- Signed releases: every archive comes with a minisign signature and a SHA-256 checksum.
- Open source: MIT licence.
Verify your download
minisign -Vm OpenUT2k4-0.1.0-Linux.tar.gz -P RWTwrDCWkxaitEWZhWEHlXdSShHiq+gy9bdiuAOTGT2/dUxD5Z7d+ap/
minisign -Vm OpenUT2k4Server-0.1.0-Linux.tar.gz -P RWTwrDCWkxaitEWZhWEHlXdSShHiq+gy9bdiuAOTGT2/dUxD5Z7d+ap/
sha256sum -c OpenUT2k4-0.1.0-Linux.tar.gz.sha256 OpenUT2k4Server-0.1.0-Linux.tar.gz.sha256OpenUT2k4 is an unofficial fan project, not affiliated with or endorsed by Epic Games. Unreal and Unreal Tournament are
trademarks of Epic Games, Inc. The code is MIT licensed; Unreal Engine is licensed separately by Epic Games.