Repository navigation
Releases
v0.1.9
OpenUT2k4 0.1.9
Vehicles you can drive on Onslaught servers, older custom maps that load with their walls and floors, and online games that follow the server instead of offline rules.
Fixes
- Can't get into vehicles online: on Onslaught servers the client also spawned its own offline vehicles, which the server didn't have. Pressing Use (E) beside one did nothing, and its collision pushed you around. You now see only the server's vehicles, and E gets you in and out. As in UT2004, there is no on-screen prompt: stand right next to the vehicle and press Use.
- Maps with no walls or floors: custom maps saved with an older UT2004 editor, such as DM-(ED)-CarPark, DM-Bartokk and DM-ShudderCreek, loaded without their level geometry, leaving you floating in empty space with invisible walls. They now load completely. Maps you already have are converted again once at the next start.
- Pickups online: pickups now appear only where the server has them, and only the server gives you items. Before, the client could show and hand out pickups the server didn't have, for example on instagib servers, and the HUD could show health or weapons you didn't really have.
- Other players dying on your screen only: lava and pain zones no longer hurt or kill other players on your side while they're alive on the server.
- Online game rules: map triggers, teleporters, map scripts and Domination point placement now follow the server instead of running locally, so there are no doubled messages or players flickering through teleporters. Jump pads only predict your own launch.
- Onslaught power links: the links between nodes now come from the server, so servers using a different link setup show the right links and nodes on the map.
- Invasion: the HUD and scoreboard show the server's current wave, and the radar shows its monsters.
- Faster joins: offline bot pathing is no longer built when joining a server, which saves several seconds on large maps.
Downloads
| File | SHA-256 |
|---|---|
OpenUT2k4-0.1.9-Linux.tar.gz (client) |
448f664804b14ff6f333a3467164866658ddd87925b8bf4ceb3c82e2e849a496 |
OpenUT2k4Server-0.1.9-Linux.tar.gz (server) |
14f3c4fe55be2c8b70f9abb106c9f3bbc4326b5cef5c6782936747d2a28bac7e |
Each archive has a .minisig signature and a .sha256 checksum. To verify a signature with minisign:
minisign -Vm OpenUT2k4-0.1.9-Linux.tar.gz -P RWTwrDCWkxaitEWZhWEHlXdSShHiq+gy9bdiuAOTGT2/dUxD5Z7d+ap/
v0.1.8
OpenUT2k4 0.1.8
Map voting on more servers, a real CD key for OldUnreal installs, and textured player skins on modded servers.
Fixes
- Map voting: the end-of-match map vote window used by some servers (UT2Vote) now sends your vote and closes properly. Before, clicking a map did nothing.
- CD key for OldUnreal installs: an install downloaded from OldUnreal has no CD key. It now gets a random key in the UT2004 format, written to
System/cdkeyand toRegistry_Fix.reg(for Wine), as the OldUnreal 3374 patch does. Your player ID (GUID) stays the same from then on and can be looked up from the key, so server admins can whitelist it. To play under your own key, put it inSystem/cdkeyof the install (formatXXXXX-XXXXX-XXXXX-XXXXX). - White player bodies: on servers with mods such as UTComp or Freon, players' bodies no longer show up white. Team colour skins, bright skins and Freon's frozen ice now show over the character's own texture, and players go back to their normal skin when a mod stops changing it.
Downloads
| File | SHA-256 |
|---|---|
OpenUT2k4-0.1.8-Linux.tar.gz (client) |
b1ee92c3b071984c048d3632de9af8ad23f4e7223f7e467ff40f5043d47c611a |
OpenUT2k4Server-0.1.8-Linux.tar.gz (server) |
10e21e84ec3b91a8ccd8122a1cba217a79e75ea4fa8177bac28a7794782e2fb6 |
Each archive has a .minisig signature and a .sha256 checksum. To verify a signature with minisign:
minisign -Vm OpenUT2k4-0.1.8-Linux.tar.gz -P RWTwrDCWkxaitEWZhWEHlXdSShHiq+gy9bdiuAOTGT2/dUxD5Z7d+ap/
v0.1.7
OpenUT2k4 0.1.7
Water on custom maps, cleaner disconnects, smoother movement on terrain and a working ping display.
Fixes
- Missing water: water, lava and grate surfaces that some maps build as zone portals are now drawn, translucent and animated, for example on DM-BronzeAge2K4. Map surfaces flagged translucent are drawn translucent. Maps you already have are converted again once at the next start.
- Leaving a server: closing the window, leaving through the menu or a crash now tell the server you left, so you no longer stay behind as a ghost player. If the client is killed or loses its connection, the server now drops you after about 20 seconds instead of 200, as with the original client.
- Jittery movement on terrain: on rough terrain you now stand where the server puts you, so the server corrects your position far less often.
- Ping shown as 0: the scoreboard now shows your real ping, and the server is told your ping as the original client does.
- Shadows on modded servers: players on servers with mods such as UTComp no longer pile up broken shadow objects over a match.
Downloads
| File | SHA-256 |
|---|---|
OpenUT2k4-0.1.7-Linux.tar.gz (client) |
217441c2858c5aac1e53a91fdceb3d63282643fa64eaacbc7ebd521ad6a64116 |
OpenUT2k4Server-0.1.7-Linux.tar.gz (server) |
eb025ddb06318cf738d42730335e57867997b5c6a198322c1f8941a20c4dc371 |
Each archive has a .minisig signature and a .sha256 checksum. To verify a signature with minisign:
minisign -Vm OpenUT2k4-0.1.7-Linux.tar.gz -P RWTwrDCWkxaitEWZhWEHlXdSShHiq+gy9bdiuAOTGT2/dUxD5Z7d+ap/
v0.1.6
OpenUT2k4 0.1.6
Fixes for player bodies on modded servers.
Fixes
- T-pose bodies: on servers whose mods use their own player class, such as UTComp, dead players no longer leave a body standing in a T-pose next to their ragdoll or gibs. Dying yourself no longer shows a dark shape in front of the camera.
- Untextured players at spawn: players no longer flash an untextured model for a moment when they spawn. The character's skin and team colours now appear with the model.
Downloads
| File | SHA-256 |
|---|---|
OpenUT2k4-0.1.6-Linux.tar.gz (client) |
a8c6e2232db080904b573cf6414559947a975e852425f8d381a01719116b3062 |
OpenUT2k4Server-0.1.6-Linux.tar.gz (server) |
bd62fd7e05e216c489b8b56613e71a38ffb7f97a3f8f5dc4a4a5c9ee0fbecb8f |
Each archive has a .minisig signature and a .sha256 checksum. To verify a signature with minisign:
minisign -Vm OpenUT2k4-0.1.6-Linux.tar.gz -P RWTwrDCWkxaitEWZhWEHlXdSShHiq+gy9bdiuAOTGT2/dUxD5Z7d+ap/
v0.1.5
OpenUT2k4 0.1.5
Server mods now run their own client code: mod weapons, effects, HUD messages and in-game menus work like they do in UT2004.
Mods on servers
- Mod client code: mods' own client-side code now runs, so their effects, muzzle flashes, projectiles, hit effects and the parts they spawn on your machine show up. One example is the Odin's ion cannon and its charge-up.
- Mod weapons without a standard equivalent (such as Ballistic Weapons) now work in your hands: their own model, animations, firing, reload, special fire, firing modes, scope and magazine ammo on the HUD. Other players see them in your hand too.
- Mod commands can be run from the console with
ModExec <command>, and bound withModBind <key> <command>.
- Mod commands can be run from the console with
- Mod fire rates: mod weapons that borrow a standard weapon now follow the fire rate the mod sets while you play.
- Mod in-game menus: mods' own menus now open and work, for example UTComp's settings (
mymenu), Ballistic Weapons' loadout and settings, and 3SPN/Freon's menu. Settings you change are saved in OpenUT2k4's own settings, never in your UT2004 install. - Mod HUD messages are drawn in the mod HUD's own layout.
- Freeze Tag: frozen players are shown as ice statues, with the snowflake beacon, the thaw percentage and a thaw bar. When you're frozen, the camera watches your frozen body like in UT2004.
- Network calls: the client only sends the server the calls a real UT2004 client sends. Mod announcements and zoom resets from the server now play.
Vehicles and maps
- Vehicle camera: vehicles use their own UT2004 third-person camera distance and height, and the camera no longer bumps into the vehicle's own parts.
- Onslaught announcer: node and core announcements now play.
- Mod pickups and models: mod pickups sit at the right height, and more mod weapon models convert correctly.
Fixes
- Fixed a crash on servers with Ballistic Weapons.
- Fixed mod weapon switching sending the server more than one switch.
- Fixed a warning on every join about announcer sounds.
Mod content you've already downloaded is converted again automatically the next time you join a server that uses it.
Downloads
| File | SHA-256 |
|---|---|
OpenUT2k4-0.1.5-Linux.tar.gz (client) |
c381a6030f4e041b04d9c958e966aaeacd7b6c85f136012f5030c50b99195e92 |
OpenUT2k4Server-0.1.5-Linux.tar.gz (server) |
1083479db590dc9c8b7ef2a48c983de0d8a0aed8006f13842f5550fcb5f43c09 |
Each archive has a .minisig signature and a .sha256 checksum. To verify a signature with minisign:
minisign -Vm OpenUT2k4-0.1.5-Linux.tar.gz -P RWTwrDCWkxaitEWZhWEHlXdSShHiq+gy9bdiuAOTGT2/dUxD5Z7d+ap/
v0.1.4
OpenUT2k4 0.1.4
Mod weapons and vehicles now look like themselves, plus fixes for joining some servers.
Online play
- Older servers: servers running UT2004 3339 no longer reject the client with "needs client 3180 or newer".
- Fire to join: on servers with a player agreement, pressing Fire after agreeing now gets you into the match even if the server hadn't given you a weapon yet. Before a match starts, Fire now shows "You are READY - waiting for the match to begin".
Mod weapons
- Server mod weapons now use their own first-person model, skins, animations, screen position, fire sounds, fire rate, third-person model, pickup model and HUD icon, taken from the packages the server sends you. Anything a mod doesn't provide falls back to the closest standard weapon.
- Ballistic Weapons mod guns no longer show up as the Bombing Run ball launcher.
Mod vehicles and objects
- Mod vehicles use their own skins, including red and blue team skins, instead of coming out white or untextured. This includes skins and models stored in separate mod packages or inside the map itself.
- Mod vehicles and their guns are drawn at the right size, and parts a mod hides stay hidden.
- Mod Raptors, Mantas and Scorpions with their own skins show them instead of the standard look.
- Parts a mod creates on each player's machine, such as the Odin's ion cannon, are now drawn.
- Mod decorations, pickups and dropped weapons that were invisible are now drawn, including Halloween masks on players' heads.
- Stationary turrets no longer show their destroyed base while they're alive.
Graphics
- Reflective (environment-map) skins render as polished metal instead of a stretched pink-white image.
- Fixed the SPMA cannon sometimes losing its animations, and the "ArtilleryCannonMesh does not fit skeleton" warning.
Mod content you've already downloaded is converted again automatically the next time you join a server that uses it.
Downloads
| File | SHA-256 |
|---|---|
OpenUT2k4-0.1.4-Linux.tar.gz (client) |
f266f201c811e58ad31be9fa7c844bc2fb4c5edf90289c8111764164edcdd966 |
OpenUT2k4Server-0.1.4-Linux.tar.gz (server) |
bc42f6bf47aa607a7bc4192796654bd173628f8ab6ca64a51b8f7849195cee9d |
Each archive has a .minisig signature and a .sha256 checksum. To verify a signature with minisign:
minisign -Vm OpenUT2k4-0.1.4-Linux.tar.gz -P RWTwrDCWkxaitEWZhWEHlXdSShHiq+gy9bdiuAOTGT2/dUxD5Z7d+ap/
v0.1.3
OpenUT2k4 0.1.3
Fixes for joining modded servers, mod weapons and how some custom maps look.
Online play
- Player agreement servers: on servers that make you accept rules before playing, "fire to join" now works.
- The agreement page shows the server's text, with the countdown before you can accept.
- Agreeing lets you spawn. Declining disconnects you.
- Until you answer, the spectator bar says why you can't join yet.
- Disconnect reasons: when a server kicks you with a message, that message is now shown.
- Mod weapons: server mod weapons with no direct equivalent, such as the Pro Sniper Rifle, now use the closest standard weapon. Before, firing them showed no weapon model, ammo, flash or impacts. Their wall-hit effects are drawn too.
Maps
- Night maps: maps without a sun no longer get a default daytime sun and blue sky, so night maps such as DM-Big_City now look like night. Space skies like CTF-FaceClassic's are dark again.
- Custom map conversion: fixed a converter bug that broke some custom maps' meshes, such as DM-Big_City's. Maps that failed to convert with an older version are converted again automatically.
Downloads
| File | SHA-256 |
|---|---|
OpenUT2k4-0.1.3-Linux.tar.gz (client) |
1578f888650c2fb3ec8fb88dd21a20347262e50f43065e9a53b7e87febd523db |
OpenUT2k4Server-0.1.3-Linux.tar.gz (server) |
58076c81335cd2139871ab514de7ed7d47ec5ca963c50b824e7e8a0b530458b7 |
Each archive has a .minisig signature and a .sha256 checksum. To verify a signature with minisign:
minisign -Vm OpenUT2k4-0.1.3-Linux.tar.gz -P RWTwrDCWkxaitEWZhWEHlXdSShHiq+gy9bdiuAOTGT2/dUxD5Z7d+ap/
v0.1.2
OpenUT2k4 0.1.2
Fixes for online play: weapon effects, spectating, movement and a few map and sound problems.
Weapons
- Hit detection through terrain and objects: shots no longer pass through terrain or through many visible objects (crates, pipes, girders, rocks, trees, wall panels). Instant-hit weapons and beams now stop where UT2004's do.
- Your own shots online:
- Assault Rifle and Minigun bullets now show their tracer and impact sparks.
- The Link Gun beam, Mine Layer target laser and Target/Ion Painter beam now show while you hold fire.
- Other players' beams: their Link Gun beams, painter beams and Mine Layer lasers are now drawn.
- Guided Redeemer (alt fire): you can now fly the warhead online, with the scope view. Fire detonates it, then the static screen shows and you return to your player. The main fire now explodes as a full nuke. Other players' warheads show as a missile.
- Zoom online: works for the Lightning Gun, Classic Sniper Rifle and painters. The AVRiL zooms while it is locked on.
- Translocator: the throw and recall sounds and animation now play, the fail sound plays when it has no charge, and teleport flashes show. Its ammo display is fixed.
- Charged and held fire:
- Assault Rifle grenades, the Bio Rifle's alt fire and loaded rockets play their shot once, on release, instead of while charging.
- Zooming no longer plays fake shots.
- Shield Gun:
- The shield shows while held, and only with at least 15 energy.
- The primary fires on contact after 0.15 s, as in UT2004.
- Painter beam: now looks like UT2004's.
- It starts at the gun, fades toward the weapon and widens when the strike is acquired.
- It has the right width and brightness, and the stock hum and target sounds.
- It fades out after release, and after a strike you switch to your best weapon.
- Smaller fixes:
- Classic Sniper impacts are now shown.
- The Shock Rifle and instagib beams start at the gun's barrel.
- Instagib modes share one refire time.
- A shock combo no longer also shows the ball's small impact.
Spectating
- Frame drops while spectating: fixed. This was the cost of ray-traced reflection lighting at the Full ray tracing setting.
- Up and down view: following another player is now smooth, not stepped.
Movement and world
- Swimming: water friction and currents match UT2004, so swimming no longer jitters with constant server corrections.
- Steep slopes: you no longer step up onto slopes too steep to walk on, or onto a steep face next to a wall. This removes the jitter on sloped pits and corners.
- Water splashes: the splash sound plays only when you hit the water fast enough, at UT2004's volume. Before, it restarted every frame, which distorted the sound underwater.
Maps and downloads
- Map names: names containing
)or,, such asFR-(00)_It'sAlive!!!_B9, now load and download correctly.
Downloads
| File | SHA-256 |
|---|---|
OpenUT2k4-0.1.2-Linux.tar.gz (client) |
f71a27c0ffc79a24870d29b46a0725b414d429e0671609d03a4dec3412e7c2b0 |
OpenUT2k4Server-0.1.2-Linux.tar.gz (server) |
bfb93aeae0fda6ecf60231032435fee4d90b7155ca6bd0fc7bc72ca9368ab0ec |
Each archive has a .minisig signature and a .sha256 checksum. To verify a signature with minisign:
minisign -Vm OpenUT2k4-0.1.2-Linux.tar.gz -P RWTwrDCWkxaitEWZhWEHlXdSShHiq+gy9bdiuAOTGT2/dUxD5Z7d+ap/
v0.1.1
OpenUT2k4 v0.1.1
A bug-fix release for online play: sound, movement, map voting, downloads, stats, crashes and rendering. It has the
same Linux client and dedicated server packages as v0.1.0, and the server still includes the OpenUT2k4 Validator.
No UT2004 game data is included. Install and setup are unchanged from v0.1.0. Extract the archive and run
./OpenUT2k4.sh. Your converted content and settings from v0.1.0 are kept.
Downloads
- Client:
OpenUT2k4-0.1.1-Linux.tar.gz - Dedicated server:
OpenUT2k4Server-0.1.1-Linux.tar.gz
Fixes
Sound
- Sound no longer plays from only one channel. Surround output is folded down to stereo on stereo devices.
- Fixed distortion and crackling. Effects now play at UT2004's own effects level, and a limiter stops the mix from
clipping when many sounds play at once. - Your own weapon and movement sounds play centred, as in UT2004. Sound volumes and ambient loops match UT2004's
levels.
Online play
- Other players no longer glide instead of running, jumping or swimming.
- Map voting works. Servers running xVoting open the Map Voting tab when a match ends. You can also open it
from the in-game menu at any time. Select a map and press Vote, or double-click a map. - The menu no longer gets stuck at the end of a match. A loading screen now shows the map change and its progress, or
the reason the rejoin failed. - "Press fire to join" now works on round-based servers (Freon, 3SPN/TAM). Until the next round starts you
spectate, with the usual spectator controls. - Anti-cheat servers (AntiTCC and similar):
- The server browser asks whether you want to join as a spectator.
- In game, a clear message explains why you can't spawn.
- OpenUT2k4 still never runs, imitates or bypasses third-party anti-cheat.
- Restart Match is no longer offered on someone else's server.
Downloads and joining
- Downloads no longer hang on servers whose redirect is down or stalls. After a timeout the game switches to the
in-game file transfer. A progress bar with Cancel shows on every menu page. - Joining no longer does nothing after the downloads finish. A join that can't complete now says why.
- Older packages from the UT99 era are recognised correctly.
- A map with a few missing sound, texture or mesh packages is now played with those parts left out. It is no longer
refused.
Stats tracking
- Settings > Game now has a Stats section: Track Stats, user name and password (hidden), with UT2004's rules
for both. - Joining a server that requires stats opens these settings and then rejoins.
- Stats remain off by default.
Rendering and stability
- Fixed a crash during online play. It was a game object used after it had been freed.
- Fixed untextured player models. 37 characters (Mekkor among them) had no skins.
- Smoke and other particle effects no longer turn into black or grey squares after a map change. The UE2 "darken"
effect style now renders correctly. - Fixed lag and frame spikes, which came from the game's log file being flushed to disk for every line.
Menus
- Tooltips have a solid background, a short delay and line wrapping, as in UT2004.
- In the server list, the row you click stays where it is, so double-clicking to join works.
- The password box hides what you type.
Diagnostics
- The client always writes
~/.config/Epic/OpenUT2k4/Saved/Logs/OpenUT2k4.log. When something goes wrong, attach
this file to your bug report. - The log also records stutters, with per-thread frame times.
Known limitations
These are unchanged from v0.1.0 except where noted:
- In offline matches, bot and weapon sounds don't fade with distance yet.
- The scope overlay of zoom-instagib servers isn't drawn.
- Mods' own on-screen messages, menus and 3D models don't appear yet.
- A short hitch can happen the first time a character model appears in a match.
- Map voting is supported when you join UT2004 servers. Servers hosted with OpenUT2k4 don't offer it yet.
The full feature list, server guide and Validator documentation are in the v0.1.0 release notes and in the repository
(Server/Docs/, Client/Docs/).
Verify your download
minisign -Vm OpenUT2k4-0.1.1-Linux.tar.gz -P RWTwrDCWkxaitEWZhWEHlXdSShHiq+gy9bdiuAOTGT2/dUxD5Z7d+ap/
minisign -Vm OpenUT2k4Server-0.1.1-Linux.tar.gz -P RWTwrDCWkxaitEWZhWEHlXdSShHiq+gy9bdiuAOTGT2/dUxD5Z7d+ap/
sha256sum -c OpenUT2k4-0.1.1-Linux.tar.gz.sha256 OpenUT2k4Server-0.1.1-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.
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 |
❌ (adm... |