Skip to content

v0.1.0

Choose a tag to compare

@GloriousEggroll GloriousEggroll released this 18 Oct 23:11
· 36 commits to main since this release

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

  1. Extract the archive anywhere and run ./OpenUT2k4.sh. To see the frame rate, run mangohud ./OpenUT2k4.sh.
  2. On first start the UT2004 Content screen opens.
  3. 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:
      1. The game downloads the 3 GB image from OldUnreal's mirrors. The download can be resumed and is checked with
        SHA-256.
      2. It installs only what it needs.
      3. It deletes the image afterwards.
    • It takes about 2 minutes on a fast connection and needs about 9 GB of free space while installing.
    • No CD key is needed.
  4. If you already have UT2004 (retail, Steam or OldUnreal), the game usually finds it. Otherwise choose
    Browse for UT2004... and pick the folder that contains System and Maps. Your install is only read, never
    changed.
  5. 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.ini and pass it with -ServerConfig=MyServer.ini. An existing
    UT2004.ini works too, because the section names match.

  • Admin:

    • Type help on the console for the commands (status, kick, ban, map, addbot...).
    • A TCP admin console is available on 127.0.0.1:7780 when enabled.
  • 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=True and 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:

  1. Copy System/OpenUT2k4Validator.u and .int into the server's System folder.
  2. Merge System/OpenUT2k4Validator.ini into the server ini.
  3. Under [Engine.GameEngine] add:
    ServerActors=OpenUT2k4Validator.OUTValidator
  4. 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, with genkey --name banlist, banlist-export, -sign,
    -verify and -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 ⚠️ partial: decoding, HUDs, scoreboards, hit sounds and warmup work; mod messages, menus, models and per-frame client code do not run yet
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 ⚠️ scripts exist, untested; this release is Linux only

Compatibility with UT2004

  • Content: uses your own UT2004 install (retail, Steam, or OldUnreal 3369 / 3374), including custom .ut2 maps
    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.ini section names, stock map lists, ServerActors and BannedIDs.
    • Ban IDs compatible with the stock server's CD-key IDs.
  • 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, MinPlayers bots.
  • 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.sha256

OpenUT2k4 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.