UT4X-Converter

Introduction: Helps converting old Unreal Tournament maps to new Unreal Tournament 4 game.
More: Author   ReportBugs   
Tags:

Codacy Badge

Description

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)

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 /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

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

Apps
About Me
GitHub: Trinea
Facebook: Dev Tools