Skip to content

OldUnreal/UT2004Patches

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 

Repository files navigation

OldUnreal Patch Repository for Unreal Tournament 2004

This is the public repository for OldUnreal's Unreal Tournament 2004 patches. OldUnreal took over maintenance of the Unreal Tournament code base after reaching an agreement with Epic Games in 2025.

Our patches fix stability, security, and performance bugs in the game client, server and editor. They also add quality-of-life features and support for modern platforms and operating systems.

Patch releases hosted here are considered stable enough for widespread use, but they are by no means a finished product. We still release updates on a regular basis.

Legal Disclaimer: This project was approved by Epic Games, but it is not an official Epic project, nor has it been reviewed or tested by Epic.

Patch Downloads

This repository provides downloads for release previews and stable releases of the game patch on the Releases Page. If you are an active tester who wants to test bleeding-edge changes and who can write top-quality bug reports, then please come talk to us on Discord to join our internal testers team.

Important

If you are looking for full game downloads, then please scroll down to our Game Downloads section.

Release Previews

Our release previews primarily target modders and beta testers who want to test our latest changes after they have passed the internal testing stage. These previews are considered relatively stable, but they may not work in online play.

Stable Releases

If you are a regular player or if you want to play online, then please use stable releases only.

Important

If you want to test out our patches, but maintain the possibility to uninstall them, we strongly urge you to create a backup of your entire UT2004 folder before installing the patch.

Important

If you are installing our patch manually, you should update your game client to version 3369 and install the Epic ECE Bonus Pack first. If you use our installers, the necessary files will be installed automatically.

Patch Installation

If you have already installed the game and you wish to update it to the latest version, then please follow the instructions below. If you have not yet installed the game, you should scroll down to our Game Installers section and follow the instructions. Our installers automatically install the game and update it to the latest version.

Windows Installation

We distribute our patches for Windows systems as a zip file. This zip file should be extracted into an existing game installation directory. No other actions are needed to install the patch.

Linux Installation

Caution

Due to case-sensitivity issues, if you are updating your Linux server or client from game version 3369 or lower, we strongly urge you to delete the following files from your game's system folder and from ~/.ut2004/System/: Bonuspack.u, Gui2K4.u, Gameplay.u, Ipdrv.u, Skaarjpack.u, StreamLineFX.u, UT2K4Assault.u, UT2K4AssaultFull.u, XVoting.u, xWebAdmin.u

The Linux version of our patch is only available as a tarball. To install, unpack the tarball into an existing game installation directory. No other actions are needed to install the patch.

macOS Installation

The macOS version of our patch comes as an application bundle. You should drag this bundle into your applications library. No other actions are needed to install the patch.

Updating Existing Client Installations

Before applying the patch we recommend that you take a copy of your existing System directory which you can revert back to if you wish.

Update System/UT2004.ini

  1. To point to the new main menu, which adjusts better to wide-screen layout, in section [Engine.GameEngine] update from MainMenuClass=GUI2K4.UT2K4MainMenu to MainMenuClass=GUI2K4.UT2K4MainMenuWS.
  2. Configure for the available master servers: In section [IpDrv.MasterServerLink] configure with:
MasterServerList=(Address="utmaster.openspy.net",Port=28902,Group=0)
MasterServerList=(Address="ut2004master.333networks.com",Port=28902,Group=1)
MasterServerList=(Address="ut2004master.errorist.eu",Port=28902,Group=1)
MasterServerList=(Address="ut2004master.gonespy.com",Port=28902,Group=1)
MasterServerList=(Address="master.frag-net.com",Port=28902,Group=1)

Updating Existing Server Installations

Caution

If you are currently using any mutator or server actor to report to multiple master servers, remove them. They are unlikely to work any longer due to changes in class MasterServerUplink, and should not be necessary. You should, however, make the following changes to your server configuration file (e.g., UT2004.ini):

  1. In [Engine.GameEngine] section, you should replace ServerActors=IpDrv.MasterServerUplink with ServerActors=IpDrv.MasterServerLauncher
  2. in [IpDrv.MasterServerLink] section, you must have at least one entry in the MasterServerList, whether or not you want to be actively listed ([IpDrv.MasterServerUplink]->DoUplink=True/False). Populate the list with each master server you may wish to report to. Examples:
  • MasterServerList=(Address="utmaster.openspy.net",Port=28902)
  • MasterServerList=(Address="ut2004master.333networks.com",Port=28902)
  • MasterServerList=(Address="ut2004master.errorist.eu",Port=28902)
  • MasterServerList=(Address="ut2004master.gonespy.com",Port=28902)
  • MasterServerList=(Address="master.frag-net.com",Port=28902)

Game Downloads

If you're installing the game for the first time, we recommend that you either use our Full Game Installers. Alternatively, you can follow the instructions below to install the game manually.

Windows Installation

To install the game manually on a Windows system, you should:

  1. Create a new game folder
  2. Mount the game cd or dvd image
  3. Copy the Animations, Help, KarmaData, maps, Music, Prefabs, Sounds, Speech, StaticMeshes, Textures, and Web directories from the game cd/dvd into your game directory.
  4. Install our patch following the instructions above.

Linux Installation

To install the game manually on a Linux system, you should:

Note

The directory names below are Case Sensitive!

  1. Mount the game cd or dvd image, or unpack the GOG distribution with the innoextract tool. We will refer to the root directory of your game cd/image or GOG distribution as the distribution directory.
  2. Copy the Animations, Help, KarmaData, maps, Music, Prefabs, Sounds, Speech, StaticMeshes, Textures, and Web directories from the distribution directory into the game directory.

Caution

Please ensure that you do NOT copy the contents of the System directory in your cd/GoG image into the game directory, otherwise the game will not launch!

  1. Extract our game patch into the game directory following the instructions above.

macOS Installation

To install the game assets manually on a macOS system, you can either:

  • Option 1: copy the game assets from an existing game installation:
  1. Open a new Finder window
  2. Press ⇧⌘G to bring up the "Go to folder:" dialog
  3. Enter "~/Library/Application Support/" (without the quotes!) in the edit box and click ok
  4. Within the ~/Library/Application Support/ folder, create a new folder called "UT2004" (without the quotes!)
  5. Copy the Animations, Help, KarmaData, maps, Music, Prefabs, Sounds, Speech, StaticMeshes, Textures, and Web from your existing UT2004 installation into the folder you've just created
  6. Install our game patch

Caution

Please ensure that you do NOT copy the contents of the original game's System directory into ~/Library/Application Support/, otherwise the game will not launch!

  • Option 2: use our game assets installer to automatically download and install the assets:
  1. Download the assets installer here.
  2. Run the game installer. You can see how to use the installer in this video.
  3. Install our game patch

System Requirements

Windows and Linux systems need a 64-bit Intel CPU or 64-bit ARM CPU.

Windows systems need to run Windows 7 or later.

Linux systems need to run a fairly recent distribution. The patch was developed on Ubuntu 24.04.

macOS systems need a 64-bit Intel or Apple Silicon CPU and macOS Catalina (10.15) or later. Some rendering features may be unavailable on macOS.

Features

Besides fixing hundreds of bugs, the OldUnreal UT2004 patches currently also add features such as:

  • Full 64-bit support
  • SDL3-based window management for the Linux and macOS clients
  • UTF-8 support for game ini, int, and log files
  • PNG screenshots
  • Widescreen fixes
  • An updated in-game server browser with lots of quality-of-life improvements
  • New renderers!

We will update this list as we add more features.

A full list of patch features and changes is available in the Release Notes.

Malware Warnings

Important

Our Windows and macOS binaries are digitally signed, but malware/virus scanners may occasionally still flag them as potential malware because our signing certificate is still building up reputation. Additional information can be found here.

Donations

Note

We are all volunteers who work on Unreal, Unreal Tournament, and Unreal Tournament 2004 in our spare time. If you like our work, then please consider making a small donation here. Please make sure to mention Unreal Tournament 2004 in your donation note!

Bug Reports

You can use our issue tracker to file bug reports. Reasonable feature requests for Unreal Editor, as well as requests for quality-of-life improvements for the game can also be posted there.

Important

Before filing a bug report, please use the GitHub search function to see if someone else has already reported the same issue. If you find an issue that looks similar to yours, then please submit a comment in the existing issue report. When filing a bug report, please include relevant details about your setup (i.e., your operating system and version, your UT2004 version and build date, mods you are using) and describe how we can reproduce the problem.

Credits

The primary developers for OldUnreal's Unreal Tournament 2004 patches are (in no particular order): AnthraX, Higor, Buggie, Dots, Smirftsch, Metallicafan212, Deaod, and Piglet.

We also want to express our sincerest gratitude to the following people:

  • Stacey Conley (aka "Flak"): this project would not have happened without her. Thank you Stacey, you are amazing!
  • Wormbo and Shambler: for the multitude of fixes they implemented between versions 3369 and 3374
  • Ryan C. Gordon (aka "icculus"): for invaluable advice, bug fixes and improvements, and work on the updated SDLDrv. If you like Ryan's work, then please consider supporting him
  • Rejecht: for the many bug reports on unrealarchive.org
  • FineWolf: for the brand new Linux installer