UT Converter Readme file

Description

• Name: UT Converter
• Author: Thomas 'XtremeXp/WinterIsComing' P.
• Download: GitHub - Releases
• Source Code: GitHub

UT Converter is a program that helps converting maps from Unreal (Tournament) previous games to UT3 (2007) and Unreal Tournament 4 (2015).

Notes :

• Conversion from non unreal/ut games might work, but it's not tested and won't be supported at all
• This is not a 'plug and play' program, user will have to do manual operations using Unreal Editor to get results.

UT games supported

Here are the different conversion possible :

• Source Game -> Dest Game (Conversion quality)
• U1/UT99/Duke Nukem Forever (2001) -> UT3/UT4 (Good)
• UT2003/2004 -> UT4 (Good)
• Unreal Championship 2/Unreal 2/UT3/UDK -> UT4 (Medium)
• X -> Unreal Engine 5 (Not Supported)

Some users reported these games to work for conversion (untested/unsupported from me) :

• Star Wars Republic Commando
• Stargate SG-1 : The Alliance

Notes:

• All: Custom scripts and blueprints are not converted
• All: Shader materials are not converted
• UT3: Since there is no actor possible for conversion of ZoneInfo, converted level might appear too dark sometimes
• U1/UT99 : Meshes (Unreal Engine 1/2) are not converted
• U2: Staticmeshes have bad UV
• UT3/UDK: Music is not converted
• UTx->UT4: Movers are replaced with the only UT4 mover actor, the lift, which may not suit for some kind of movers (such as doors, switches, ...)

---

Requirements

• Windows 7/8/10/11 - 64 Bit
• UT3 or UT4 editor for output converted map
• Any Unreal (Tournament) game for input map
• Some minimum skills with unreal engine editors

Installation and quick start

---

• Install program by clicking on .exe file
• Launch program (.exe file)
• Go to Settings and set the unreal games folders
• Convert your map in Menu: File -> Unreal (Tournament) -> Convert Map to UT4/UT3 ...

Program Update

• Uninstall program in windows applications configuration panel
• Install new version (.exe file)

How to convert a map?

Check wiki page at: UT Converter Wiki

---

Build and run from source code

• Install git
• Install maven
• Clone project using this command line:

git clone https://github.com/xtremexp/UT4X-Converter

• Download and install OpenJDK19:
• Build and run with maven command :

mvn clean javafx:run

• Package application with maven command (.exe install file will be generated in <project_path>/target/package folder) :

mvn clean install

Notes :

• UI(.fxml files) can be easily modified with Scene Builder editor
• ExtractTextures.exe and UtxAnalyser.exe programs have been compiled using modified source code from "UT Package Delphi Unit" by Antonio Corbero
• Download and install Delphi Comunity Edition
• Download and extract UT Package Delphi Unit
• Add the /src/delphi/-.dpr files where you installed UT Package Delphi Unit
• Open ExtractTextures.dpr or UtxAnalyser.dpr with the IDE

External programs used

These programs are being used during conversion process.

Library / Program	Description	Author	Website
Texture Toolkit (g16convert.exe)	Unreal terrain bitmap conversion	Alex Stewart	http://www.foogod.com/UEdTexKit/
UModel (umodel_64.exe)	Unreal package extractor	Konstantin Nosov	http://www.gildor.org/en/projects/umodel
SoundExchange (sox.exe)	Sound wave conversion	Multiple	https://sox.sourceforge.net/
UTXAnalyser.exe / ExtractTextures.exe	Texture info / Texture extract (for Unreal 2)	Me / Modified code of UT Package Delphi Unit by Antonio Acordero	https://www.acordero.org/projects/unreal-tournament-package-delphi-library/

License

See LICENSE file.

History

See history.md for complete changes history