Umodel Frequently Asked Questions

Table of Contents:

 

General


How can I check for umodel updates?

There is RSS feed available on the main site - check icon on ther upper right corner. But not every game takes its own entry in a news list.
Forum RSS feed is also available.
Another option is to subscribe on the facebook umodel news. I am trying to keep it up to date. You can also find a link to the facebook page on the left column of this page, below the site menu.
The best way to check for a new version is to verify online version of readme file. It contains detailed changelog.

Which game titles are supported?

There are more than 200 games made with all Unreal engine versions, for all platform supported by Epic Games. Check this table:
http://www.gildor.org/projects/umodel/compat
I'm trying to keep it up-to-date, mostly with reports posted on my forum. Note presense of the filter on the top of the table which lets you to find a game by the part of its name or by the company name quickly.

Why don't you add support for non-Unreal engine games?

Other game engines has different principles of data storage. Umodel is focused on Unreal engine games and most of it's code works with Unreal engine data. Another reasons (that's why I did not created separate application for other games): other game engines are usually has more simple data formats, there are a lot of extractors for them exists already, even made with non-professional programmers. So I don't think there is any reason to support other engines.

 

What's the reason of starting your development of UE Viewer?

I had a task on my job to write a skeletal animation system for upcoming game. I checked a lot of open-source systems, read some articles. But I was not satisfied with these. So I started research animation system from Unreal Tournament 2004 to learn how to do that.

If you're really interested, more information is available on my "About me" page, check the link on site's menu.

 

How can I help you?

The best help is a donation.

Also you may vote for the umodel (press "LIKE") on its Facebook page.

 

I have made some project/video with a help of umodel. Can I add you/your program to the credits?

Yes of course

 

Can I post your tool on my site/forum?

I see no reason to do so, my site is alive. You should not copy texts from this site, post a link instead. Do not post direct links to files - these links may be (and will be) changed in a future.

 

Where could I find the source code?

The source code is available on GitHub. The discussion is open on the forum.

What are you going to do next?

I've put my "TODO"/roadman on Trello service, it's publicly available.

 

What should I provide to you for support for some new game?

First of all, I should mention that with my current job I'm extremely busy, and sometimes I can't work on UModel at all, with exceptions for small stability issue fixes. Also, supporting new UE2 or UE3 games has lower priority for me than extending UE4 support and making a better UI.

Things which most likely will not be supported (i.e. not worth sending any files to me):

1. Online games - these have frequent updates, often have protected executable files (not possible to analyze), often have encryption on packages.

2. Encrypted UE4 pak files. Encryptions means "keep off from our files", and I'd like not to disappoint developers with providing decryption keys as part of open-source software.

Ok. For making a new game supported, I'll need a few files:

  1. The game executable.
    1. Unreal engine 3. The game is usually placed in the single executable file. Note: I need non-encrypted file! For PC it should contain a few "key" strings in ANSI and Unicode - one of them is a "USkeletalMesh". If this string is not present in the file - either it is encrypted, or it's a wrong file, and useless for me. Typical Unreal engine 3 executable is about 15Mb of size, it could be larger or a bit smaller.
    2. XBox360. The executable is usually (or always?) named "default.xex". It is always encrypted, but that's not a problem.
    3.  Unreal engine 1 or 2. The game executable itself is relatively small (a few hundreds of kilobytes) and has no "key strings" inside.  Most of the engine code is located in core.dll and engine.dll, so I'll need these files as well.
  2. core.u and engine.u (for some UE3 games file extension may be "xxx") - these files contains compiled scripts. Placing all .u files into archive is welcome unless they're too big.
  3. startup_int package (usually present for cooked games).
  4. file version report of the pkgtool - to let me make autodetection of this game with umodel.

These files should be compressed to reduce traffic - use Rar or 7zip. It is good to send archive which is nearly 50Mb of size.
NOTE: I can not guarantee that I will support the game, but in most cases it is not possible to do anything without having the files.

Umodel is crashed!

When you've got a crash, first of all check the compatibility table. Most probably the game you are trying to open is not fully supported and you must restrict umodel to not load some kinds of resources: use -nomesh, -nostat, -noanim or -notex switches.

Also verify that you did not mixed files from different games in the same directory. For example if you'll replace textures.tfc file with the file from other game you'll definitely get a crash when umodel will try to access textures. Another example - if you'll place package from Batman: Arkham Asylum into the directory with Batman: Arkham City files - these games has a lot of files with the same names, but these files are not compatible with each other.


... TODO ...

 

Umodel is crashed with error "zlib uncompress() returned -3"

Try adding option "-lzo" to the command line.

 

Umodel is crashed with "BindFramebuffer error ..."

Your videocard has buggy drivers. Umodel is crashed when trying to render scene to texture. Update your drivers.

   

What does error "specified package has no supported objects" means?

This is not an error. The package file you're trying to open has nothing to display in umodel. Unreal engine has thousands of various object types, but umodel supports only a dozen of them. Verify other packages. The easiest way to find something in UE3 is to check largest packages first.

 

What does error "too many unknown objects" means?

The answer is here.

What does error "wrong tag in package" means?

This means you're trying to open non-package file. Or you're trying to open file from some unsupported game which uses modified package format. Sometimes this error happens when people trying to open incorrectly extracted package files from XBox360 ISO images.

 

UModel displaye error message "Unversioned UE4 packages are not supported"

This could happen when you're opening UE4 packages which were cooked with stripped out version information. This is a very strange feature of UE4, but we should agree and live with it. To bypass this error, you should select UE4 version manually. You may do that either from startup UI or by passing "-game=ue4.nn" option to the command line. If the game was already found as supported, most likely you will find exact UE4 version in the compatibility table on this site. Also you could check forums. If not - just try every UE4 version, and if UModel will crash - try another version next run.

Please keep in mind that you could have the following situation: you will set UE4.5 and get skeletal meshes and textures loaded. However static mesh will crash UModel. In this case you should try 4.6 - in this version SkeletalMesh format is not changed, but StaticMesh - was.

Versions not worth trying: 4.1, 4.5, 4.9 - these versions has no changes important for UModel, so you may simply bypass them.

 

Why umodel error messages are so strange? Text1 <- Text2 <- Text3 ...

This error message is in Unreal engine 1 and 2 style. It displays callstack of the function calls, plus some additional information which allows me to determine the reason of error with just looking at the log.

 

What is the message "WARNING: BoolProperty "SomeClass::SomeProp" was not found" in the log?

This message means: object of SomeClass has property SomeProp which is not known to the umodel. Simply ignore these messages, it could be useful for some diagnostic only.

 

What is "cooked package"?

Cooking were introduced in Unreal engine 3. Cooking is a process in development cycle which produces package files for target platform. Cooked packages are smaller than non-cooked and could be loaded faster. Usually these packages resides in "Cooked<PlatformName>" game folder. This folder contains compiled script packages, map packages and seek-free packages. For more information please read UDN article "Content cooking".

 

Why the same mesh is duplicated in multiple packages?

This is a side effect (or feature) of the UE3 cooking process. Read more about cooking above.

 

Starting umodel


Is there a GUI for umodel?

Yes, starting from September of 2014 Windows version of UModel has a GUI. Just run UModel executable without arguments, and startup options window will appear. Command line options still works, so if you need some option which is missing in settings UI but exists in a command line, just add these options to the command line. An example: you want to use GUI for export, and need to use DDS texture format. Just run "umodel.exe -dds" - you will see GUI, and everything will work as usual, but exported textures will be saved in .dds format whenever possible.

 

Program is not working - when I started umodel some black window appears and immediately disappears

This could happen if you're starting UModel in command line mode with some parameters wrong. Please review your command line parameters. If you're using .bat file (Windows batch), add "pause" command at the end to be able to see possible error message.

Which command line options are available?

Start umodel with option "-help" from the command line, it will display a full list of command line options.
 

Viewer questions


How to use umodel in a viewer mode? What umodel can do?

Viewer will start automatically when you'll not specify "-export", "-list" etc options which affects umodel mode. In a viewer mode press <H> key to display full information about keyboard shortcuts. Note: this list depends on the object beeng displayed - texture and mesh viewer has a different set of commands.
Also check my brief introduction into umodel:
http://www.gildor.org/en/projects/umodel/tutorials
"Unreal Model Viewer basics"

How can I take a screenshot?

Press <Ctrl+S>. Screenshot will be placed in the current directory, in subdirectory "Screenshots". They are in TGA format. If you want to produce screenshot with transparent background you should use key <Alt+S>. In this case umodel will replace background color with translucent black color. Also key <Ctrl+Q> could be useful - it will disable onscreen debug output such as texts and coordinate system axis.

How can I view player models combined from a few meshes?

Start umodel in a viewer mode. Browse through the meshes. Find a mesh which is a part of "combined mesh". Press <Ctrl+T> ("tag mesh"). Mesh name will appear in a list on the screen. Now, when you will browse to another mesh, tagged mesh will remains on the screen. Use the same method to tag all required meshes (head, legs, torso, arms etc). Note: the combined mesh can be animated in a usual way.

Also I suggest you to watch second tutorial video.

 

How to view animations for UE3 games? When I'm opening a model it has no available animations

Press <Ctrl+A> key. This key will cycle through all loaded AnimSets (MeshAnimation object for UE2).

Animated mesh has gone outside from viewport. How can I focus camera on it?

Probably animation uses "Root Motion". Press <F> ("focus") key to focus camera on the mesh center. You may hold this key pressed during the animation to keep mesh on the screen center.
Of course, you may also use traditional navigation with mouse.

 

How can I view animation when it is stored separately from the mesh (in a different package)?

When starting umodel add extra switch "-pkg=<package_name>" providing the name of that "different package". Umodel will load the priomary package (which name is provided in an "ordinary way") and all secondary packages (there may be any number of "-pkg=..." options).
Note: you may use the same approach to combine meshes which parts are placed in a different packages too. Example - UT3 Bonus Pack - it contains additional head, torso, legs meshes for human races - you may combine them with the meshes from retail game and even animate it with a standard animations.

There are a lot of materials in object browser. How can I quickly view meshes?

Use additional command line option "-meshes".

Texturing questions


Meshes in a viewer are not textured. What's wrong?

There are a few variants of answer:

  1. umodel is unable to find some package containing materials - check umodel logs
  2. mesh is not textured, materials are assigned by the game in runtime or in MeshComponent object (UE3)
  3. material is too complex for umodel, so it is replaced with "default texture"
  4. this is a variant of (1) - you're trying to start umodel with a wrong game path. For example: UE2 game usually has "Textures", "Animations" and some other directories. If you'll start umodel from the "Amimations" directory, umodel will not file textures. You should start it from the parent directory - common for the "Animations" and "Textures".

More info here and here.

Why UE3 game textures are in very low resolution - 64x64 instead of 2048x2048?

That's another "side effect" (really - feature) of cooking. Check the log. Most probably umodel is unable to find tfc file (usually "textures.tfc"). If this file really exists - verify your "-path=..." option.
More info. Also check this thread.

Another note: this error often exists when user (following some third-party tutorials) is copying game files to some directory and trying to extract files from that place. This is wrong - umodel is written to open files directly from the game directory, no file copying is required.

Newer versions of Unreal engine 3 has capabilities to completely remove texture data from packages so you whould get completely black textures instead of low-res ones when tfc file is missing.

 

I'm using -dds option for export, but textures are still in tga format

This could happen if you're exporting textures which are not in DXT format. For example, ETC or PVRTC (mobole texture formats) can not be saved as dds because they are encoded in format which is not supported by dds container. Uncompressed textures are also saved in tga format.

 

How to extract data from the textures.tfc?

Textures.tfc cannot be extracted directly. This file is used by Unreal Engine 3 (and by umodel) automatically when package file has streamed texture. This file contains texture data, but texture metadatas (texture name, size, format) are located inside upk files.
The same applies to the Bioshock's .blk and Unreal Championship 2 .xpr files.

 

Exporter and PSK/PSA questions


Where I can find extracted files?

Files should be located by default in a current directory.

Windows Vista and 7 has disabled writting files into "Program Files" directory for non-admin users. When you're trying to export contect from some game located in Program Files, operating system will redirect all output to the "C:\Users\<UserName>\AppData\Local\VirtualStore\Program Files" directory.

If you having trouble locating exported files, use "-out=SomeOtherDirectory" option.

 

Umodel extracts nothing from package SomePackageName.upk

If umodel is not crashed - it's ok. Most probably this package has neither textures nor meshes inside, relax. Some time ago I've added a helper which allows to easily determine if package has something useful:

1. In package selection GUI, select "Tools | Scan package content". After that you will see number of textures, skeletal, static meshes, and animations near every package name.

2. If you will open a package which has nothing to display, UModel will display a simple on-screen text showing number of objects of every type stored in this package.

 

How to recompile extracted data back to the packages?

You may recreate package if target game has UnrealEd (of course, if all required data were exported - most data types are not supported, it is impossible to support everything). If the game has no publically available UnrealEd, this task is impossible.

 

How can I load PSK file into 3ds Max?

Use my ActorX Importer plugin.

 

How can I save (export) PSK/PSA files from 3ds Max or Maya?

Use Epic Games ActorX plugin for 3ds Max or Maya. These plugins were discontinued by Epic Games in favour of FBX file format, and you will not find versions for recent Max or Maya software. Updated plugins could be found on this site, see this location.

 

Is there PSK/PSA importer for Maya?

Check this forum thread.

 

Is there importer for Blender?

Yes. There are number of solutions available (none were made by me). It seems that the best link for Blender psk and psa importer is this one. This script has possibility to import PSKX files.

For more information please refer to these threads: first, second.

 

What is PSKX format?

This format is a modified PSK (ActorX mesh) format. Modifications were made by me (Gildor) to allow placing some additional information into the file. You should not try to import PKSX into UnrealEd, it may crash. I have changed file extension specially for people who trying to load such files into programs with PSK support (and asking after that "why that program is crashed when I've loaded psk?"). There is no PSKX documentation available, but I can reveal my changes if there will be any interest.

Currently PSKX has following additional features in comparison to PSK:

  • can store mesh without a skeleton (i.e. StaticMesh)
  • mesh can be made with more than 64k vertices

Earlier versions of the umodel were produced PSAX files too (in some conditions), but later it was overrided with text .config files stored aside with PSA file.

 

What are .mat files exported by UModel?

UModel generates .mat files to allow ActorX Importer to load materials into 3ds Max. The format of these .mat files are completely custom, don't try to load it into any other application (except perhaps any text editor). The format is fully human readable and you may read it to see which textures are used for material's diffuse, normal, etc.

 

Mesh is loaded into 3ds Max untextured, while it is appeared in umodel's viewer correctly

You should correctly set up ActorX Importer options "Path to materials" and "recurse".

Check this thread for more details. Also you could check 2nd tutorial video, I'm describing how to load textured mesh into 3ds max there.

 

How to export sounds?

Use "-sounds" command line option. This options is not used by default because I cannot guarantee that umodel will not crash on exporting sounds for particular game.

 

How to export FaceFX and ScaleForm assets?

Use "-3rdparty" option.

 

How can I export data from all game packages?

1. GUI approach. Start UModel with GUI, enter all required options on startup window. You will see a window containing list of found game packages. Just select all packages there and press "Export". If packages are located in multiple directories, check "flat view" checkbox, and you will see all packages in a single list.

2. Command line approach. Use this batch extractor. Note that this page has a lot of information about tuning this batch.