Skip to content

RattleSN4K3/UT4Converter

BranchesTags
 
 

Repository files navigation

UT4 Converter Readme file

Description

UT4 Converter helps converting maps from Unreal (Tournament) previous games to Unreal Tournament 4.

UT games supported

  • Unreal 1
  • Unreal 2
  • Unreal Tournament (1999)
  • Unreal Tournament 2003/2004
  • Unreal Tournament 3

Event if all unreal games are supported, since program is in early stages, conversion quality for unreal tournament 2003/2004 and unreal tournament 3 might be pretty bad.

If you want to convert UT games to Unreal Tournament 3, download and use UT3 Converter program instead of UT4 Converter.

What is converted

Here is the conversion table for all ut games about what the program can convert.

Brushes Lightning Sounds Textures Meshes StaticMeshes Terrain Base Pickups Overall
Unreal 1 ++ ++ ++ ++ No N/A N/A ++ GOOD
Unreal 2 ++ ++ ++ + N/A ++ No - MEDIUM
UT99 ++ ++ ++ ++ No N/A N/A ++ GOOD
UT2003/ UT2004 ++ ++ ++ + N/A ++ Yes(partial) + GOOD
UT3 ++ + + + N/A + No + MEDIUM

Note: UT99/U1 Lightning: For Unreal Tournament (99) and Unreal 1, zoneinfo actor does not exist in UT4, since then StaticMesh conversion is not yet operational. Since UT3 is nearly full of staticmeshes, conversion is pretty bad. (same note for some ut2004 maps)

What is NOT converted

  • Models
  • Terrain (UT2004 has partial support only)
  • Music (Unreal Tournament 3 only)
  • All custom things (scripts and pickups)

Note: staticmesh conversion is not fully automatic. You need to convert them manually using Blender software. Converter will do the job to get the right references and textures applied.

Requirements

Installation and first start

If not, make sure you have installed latest Java technology version at www.java.com and create some "run.bat" batch file with notepad that you will save in the program folder with this command line: "java -jar UT4-Converter-.jar" (will force launching this file associating it as java program) Go to Settings and set the unreal games folders as well as umodel and nconvert program paths

Detailed explanations about conversion is always displayed after each end of map conversion in program.

How to convert map?

Make sure you are allowed to convert the original map (if you are not the original author for example)

For UT3 maps only:

  • Open a text editor (notepad for example)
  • Open ut3 map with the UT3 editor.
  • In menu go to "Edit" -> "Select all"
  • Copy all data stuff ("Edit" -> "Copy" or Ctrl+C)
  • Paste data in your text editor and save your file with a .t3d file extension

Note: this .t3d file is needed because the "ut3.com batchexport" command to export .ut3 level to .t3d file messes up the brush order.

In UT4 Converter:

  • Launch UT4 Converter
  • Go to "Convert -> <Unreal Tournament X/Unreal X> Map"
  • In the conversion settings, press "Select" and choose the map
  • for ut3 only: select the .t3d file you previously created manually (see For UT3 maps only section)
  • Press ok and wait while the conversion is running (it might takes several minutes)

In UT4 Editor:

  • Open the UT4 Editor

  • Create new level ("File -> New level ...") and select "Empty level"

  • Import sounds -- Browse to /Maps/WIP/-UT99/U1 path using the internal browser -- Click on "Import" and select converted sound files from /Converted//Sounds -- After import, right click on all sounds imported in editor and choose "create cue" -- Make sounds loop if needed (double click on it and set "looping" to true). Generally sounds with name containing "loop" word are loop sounds (e.g: "AmbOutside_Looping_waves4")

  • Import Textures -- Browse to /Maps/WIP/-UT99/U1 path using the internal browser -- Click on "Import" and select converted sound files from /Converted//Textures -- After import, right click on all texture in editor and choose "create material"

  • Import StaticMeshes -- Browse to /Maps/WIP/-UT99/U1 path using the internal browser -- Click on "Import" and select converted staticmeshes .obj files from /Converted//StaticMeshes

  • Import converted map -- Open the file /Converted//-.t3d with an advanced text editor (like notepad++) -- Select all text (Ctrl+A) and copy(Ctrl+C)/paste(Ctrl+V) it into the editor

  • Rebuid Geometry ("Build" -> "Build Geometry")

Note:

  • If after conversion your map got some bsp holes, remove all "sheet" brushes (e.g: flat lava/water surface, they are generally colored in "green" color in UT/U1 editor). The converter does remove most of them, but not all of them yet.

Limitations / Issues / Troubleshooting

  • [UT99] Some textures may not be correctly aligned
  • Flag bases/Teleporters do not import correctly if you do not have loaded previously a map containing these actors (UE4-side bug)
  • Level may appear too dark sometimes. In this case add a "PostProcessVolume", "Unbound" it and set a cube ambient map texture.
  • Extraction of sound resources only works with Windows
  • Movers are replaced with lift actor which may not suit for all kind of movers (such as doors, switches, ...) You may use the "Door" actor or "Matinee" actor (not auto-converted yet)
  • Since Unreal Engine 4 does not support sheet brushes (e.g: flat lava/water surface, ...) , and as the converter does not remove all of them, some "bsp holes" may appear (in that case try to find out all these brushes and remove them until bsp holes disapear)

License

  • No commercial use allowed
  • You can edit/share source code as well as binaries always keeping original author credits

MAKE SURE YOU GOT AUTHORISATION OR ARE ALLOWED TO CONVERT MAP BEFORE DOING IT. YOU ARE THE ONLY ONE RESPONSIBLE FOR ANY COPYRIGHT INFRINGMENT RELATIVE TO CONVERTED MAP.

How to build and run latest version ?

With Netbeans IDE:

  • Download and install Netbeans IDE: https://netbeans.org/downloads/ ("Java SE" version works but you can download full version)
  • Open Netbeans and in Menu, go to "Team -> Git -> Clone.."
  • Set "Repository URL" = https://github.com/xtremexp/UT4Converter
  • Click "Next" and select "Master" to get latest code (you may select other branches if you want to)
  • Click "Finish" and wait while project is being imported. Project will be saved by default in C:\Documents and Settings<username>\My Documents\NetbeansProject\UT4Converter
  • Right-Click on project and press "Run". At first time it might take several minutes to download required libraries. Note: Once project has been imported to keep the project updated: Right click on project -> Team -> Pull

With Eclipse IDE:

  • Download and install "Eclipse IDE for Java Developers": https://eclipse.org/downloads/packages/eclipse-ide-java-developers/lunasr2
  • Open "Eclipse" Right-click in "Package Explorer" view then "New -> Project..", "Maven" -> "check out Maven projects from SCM"
  • Click on "m2e marketplace" link
  • Install "m2e-git" connect and click on finish.
  • Restart again Eclipse for changes to apply and go back to "New -> Project..", "Maven" -> "check out Maven projects from SCM"
  • Click "Next"
  • Set "SCM Url" to: "https://github.com/xtremexp/UT4Converter.git"
  • Click "Finish"
  • Right click on "UT4-Converter" project then "Run as" -> "Java application" Note: Once project has been imported to keep the project updated: Right click on project -> "Git" -> "Remote" -> "Pull"

Libraries / Technologies used

Converter interfaces with these external tools:

History

  • 0.8.9 - 01/08/2017

  • 0.8.8 - 30/07/2017

  • ut3: fixed sounds not being converted
  • 0.8.7 - 29/07/2017
  • all: fixed embedded sounds and staticmeshes in level package not being converted
  • ut3: fixed critical crash when DefensePoint actor is being converted
  • all: now if some actor fails to be converted won't make stop other actors to be converted
  • 0.8.6 - 28/07/2017
  • ut2003/ut2004: added conversion of WaterVolume, NewWeaponBase, NewHealthCharger
  • ut2003/ut2004: fixed conversion failure of trigger with liveproximity and humanplayerproximity trigger type
  • u2/ut2003/ut2004/ut3: fixed bad description/tuto for converting staticmeshes
  • 0.8.5 - 27/07/2017
  • u1/u2/ut2003/ut2004: blender manual conversion one by one of each staticmeshes is no longer needed. Now only need to import all .obj converted staticmeshes within the UE4 editor

  • 0.8.4 - 19/07/2017

    • u1/u2/ut2003/ut2004: invisible brushes are no longer being converted. This might slightly reduce some bsp holes cases.
    • ut99: fixed some textures not being converted with some specific packages (like with SGTech1.utx texture package)

  • 0.8.3 - 15/04/2017

    • all: fixed some cases where a few brushes had some textures not converted properly

  • 0.8.2 - 18/12/2016

    • all: fix partial conversion if a mover had ambient sound and opened sound set

  • 0.8.1 - 13/11/2016

    • ut2003/4, ut3: fixed some staticmeshes with long material names could not be converted
    • ut3: fixed sniper weapon with weaponpickupfactory not converting properly
    • ut3: fixed UTSlimeVolume, UTLavalVolume not converting properly
    • ut3: reverted back sound volume to original, now handling logarithm distance model for sound radius
    • ut3: added support for UTDefensePoint
    • misc: now also logs unconverted actor class name in .log file

  • 0.8.0 - 11/11/2016

    • ut2003/ut2004: now terrain heightmap is imported (texture, decolayers are NOT yet converted)
    • ut3: default scale factor back to 2.2
    • ut3: added staticmeshes overidden material supported
    • ut3: added conversion of DecalActor, UTKillZVolume, CullDistanceVolume, EnforcerAmmo, UTWeaponPickupFactory, HeightFog
    • ut3: sounds are now converted from .ogg to .wav so they can be imported into UT4 editor
    • ut3: fixed some brushes not being properly converted that was causing bsp holes (see part "How to convert map?" -> "for ut3 maps only" section)
    • ut3: fixed some staticmeshes not being correctly located (prepivot support)
    • ut3: fixed many pickups not correctly aligned with floor
    • ut3: fixed SkyLight with no color set
    • ut3: fixed directional lights rendering as spotlights
    • ut3: reduced by 90% default volume of AmbientSounds
    • u1: added support for WeaponPowerup, StringerAmmo
    • ut99/ut2004: added support for conversion of Domination gametype actors.
    • misc: won't stop converting map resources if one fails to convert properly now.
    • misc: conversion processing is now saved in a conversion.log file
    • ui: slightly improved visibility in conversion settings

  • 0.7.5 - 23/10/2016

  • Changes instructions for import .t3d converted file since UnrealEngine editor 4.13 can no longer directly import .t3d files
  • 0.7.4 - 21/09/2016:
  • Fixed some classes not being converted (like pickups, weapons) when class name was lowercase
  • Fixed bad parsing of tag sometimes
  • 0.7.3 - 18/06/2016:
  • Changed default scale from 2.2 to 2.5 to fit with playersize change in some previous UT4 patch
  • Added settings to only convert some manually specified classes
  • u1, u2, ut: fixed bad lift destination not being scaled with conversion map scale
  • u1, u2, ut: fixed bad converted sounds that was causing crash on play in editor sometimes
  • all: fixed some resources (mainly sounds) that were not being converted
  • 0.7.2 - 14/10/2015:
  • u2/ut2003/ut2004: Fixed bad staticmesh scaling in level if "DrawScale" property set.

  • 0.7.1 - 12/10/2015:

    • Fixed polygon for normal brushes with shader texture not replaced with diffuse texture

  • 0.7 - 11/10/2015:

    • ut2003/ut2004: staticmeshes are now textured (note: shader textures are not fully converted, possibly replaced with diffuse texture)
    • ut2003/ut2004: lifts got their original staticmesh set now Note: you need to update original python script file 'io_import_scene_unreal_psa_psk.py' in C:\Program Files\Blender Foundation\Blender\\scripts\addons with this one (which provide fixes for .psk staticmesh import in blender) by Befzz from https://github.com/Befzz/blender3d_import_psk

  • 0.6 - 27/09/2015:

    • u2, ut2003, ut2004, ut3: added option to export staticmeshes used in map (partial conversion, need to convert .psk file format to.fbx using 3d modeler (like Blender))
    • UI: added information about how to convert map after conversion
    • ut3: added TriggerVolume, DynamicTriggerVolume, Note, UTTeamPlayerStart, UTTeamWarfarePlayerStart, PointLightMovable, PointLightToggleable, SkyLightToggleable, SpotLightMovable, SpotLightToggleable, AmbientSoundSimple, AmbientSoundNonLoop, AmbientSoundSimpleToggleable actors for conversion
    • u2, ut2003, ut2004, ut3: fixed crash when staticmesh actor has no staticmesh set
    • ut3: added partial conversion of ReverbVolume, PhysicsVolume
    • ut3: fixed sometimes a crash when exporting level to t3d file
    • ut3: fixed AmbientSound conversion error
    • ut3: fixed SpotLight bad rotation if 3d scale is negative
    • ut3: fixed resources from map package never exported
    • ut2003, ut2004, ut3: now Trigger actor are replaced with CapsuleTrigger
    • ut2003, ut2004: SunLight converted to DirectionalLight
    • ut2003, ut2004, ut3: fixed lift destination (since new UT4 version automatically scales it with 3d scale of lift mesh)
    • ut2004: increased light brightness and radius
    • ut3: removed useless warnings for actors ModelComponent, ForcedReachSpec

  • 0.5 - 05/09/2015:

    • [UT99] Added partial support for conversion of UT99 assault maps with UTA resurgence mod (https://trello.com/b/Jtvc23S1/uta-resurgence)
    • [UT99] Replaced SmokeGenerator with Blueprint_Effect_Smoke_C blueprint actor
    • Added 2.1875 scale factor in conversion settings
    • Fixed never-ending (stuck) conversion in some rare-cases
    • Fixed brush of movers no longer being converted (_brush actors)
    • Fixed duplicated mover actors
    • Now need to create Cue assets for sounds to be working (after sound files import select them in UE4 Editor asset browser then "Create CUE").

  • 0.4.1 - 07/06/2015:

    • Fixed untextured surfaces if texture coming from level package

  • 0.4.0 - 06/06/2015:

    • Added support for Unreal Tournament 2003 / 2004, Unreal 2, Unreal Tournament 3 (note Unreal 2/UT2003/UT2004/UT3 conversion is pretty bad for some maps since staticmesh conversion is not yet available)
    • Added conversion for textures (note: material textures are not yet converted)
    • Automatically extract music now
    • [UI] Added advanced conversion settings
    • Fixed sounds not being exported from map package
    • Fixed frozen UI on map conversion
    • Some other fixes but can't remember

  • 0.3.0 - 08/05/2015:

    • Improved lightning (brightness, lightning type, ...)
    • Sound export and conversion
    • Added LiftExit, Jumppad and BlockAll for conversion
    • Converts Triggers with "CapsuleTrigger" volume
    • Better alignment of FlagBases
    • UI: improved log display
    • Fixed crash if UT4 converter has whitespace in one of his parent folders
    • Added / Activated support for Unreal 1
    • Auto-creates big additive brush to simulate level in subtract mode and lightning importance volume for level

  • 0.2.1 - 19/04/2015:

    • Fixed movers not importing correctly in UT4 editor

  • 0.2.0 - 18/04/2015:

    • [UI] Added conversion log display
    • Fixed conversion crash with some maps with incorrect name prefix
    • Added support for UT99 Binary maps (.unr) as input file
    • Improved mover conversion (moving good now)
    • Added LavaZone, SlimeZone, WaterZone conversion
    • Added missing weapons conversion for "FlakCannon", "AutoMag", "Enforcer","doubleenforcer", "ImpactHammer", "ASMD", "Rifle", "Minigun", "SuperShockRifle" (instagib)
    • Added teleporter conversion
    • Added conversion for powerup "invisibility", "ut_invisibility", "ut_stealth", "nalifruit" (replaced with normal health), "bandages" (replaced with healthvial), "PowerBelt"
    • Added conversion for ammo "Sludge", "EClip", "FlakShellAmmo", "ASMDAmmo", "RifleAmmo", "RifleRound", "RifleShell", "Minigun", "SuperShockRifle" (instagib)
    • Removed unecessary auto-created notes for unconverted actor for PathNodes, InventorySpot, TranslocDest ...

  • 0.1.0 - 13/04/2015:

    • First version with basic brush, lights and pickups conversion

About

UT4 Converter

Resources

Readme
Activity

Stars

0 stars

Watchers

1 watching

Forks

1 fork
Report repository

Releases

14 tags

Packages

No packages published

Languages

  • Java 99.9%
  • Other 0.1%