UMODEL (UE Viewer)
(c) Konstantin Nosov (Gildor), 2007-2017
Please support the development by making a donation here:
http://www.gildor.org/en/donate
System requirements
~~~~~~~~~~~~~~~~~~~
Windows or Linux operating system
x86-compatible CPU with SSE2 support
OpenGL 1.1 videocard (OpenGL 2.0 is recommended)
SDL 2.0 (for Linux only, windows distribution has SDL2.dll included)
List of supported games
~~~~~~~~~~~~~~~~~~~~~~~
Supported all Unreal engine versions (1-3). The list of supported games consists of
more than 100 game titles, it is not reasonable to include it here. Some game titles
has limited support or not supported at all. Detailed information can be found here:
http://www.gildor.org/projects/umodel/compat
Web resources
~~~~~~~~~~~~~
Umodel home page and forum:
http://www.gildor.org/en/projects/umodel
or Russian page:
http://www.gildor.org/projects/umodel
Umodel FAQ:
http://www.gildor.org/projects/umodel/faq
Some tutorials available here:
http://www.gildor.org/projects/umodel/tutorials
Youtube page with tutorials and news:
https://www.youtube.com/playlist?list=PLJROJrENPVvK-V8PCTR9qBmY0Q7v4wCym
Other documentation:
http://www.gildor.org/smf/index.php/board,9.0.html
Quick start
~~~~~~~~~~~
WARNING: it's highly recommended to read the FAQ and to watch video tutorials (see the
links above) before starting the umodel for the first time.
UModel primarily is a console application, with rich command line capabilities. Easiest
run is 'umodel <package_file>', it will start umodel in a viewer mode. To see the full
list of available command line options run 'umodel -help'.
You could also drag a package file (.upk, .xxx, .ukx etc) to umodel's icon to launch
the application. However default settings will be used in this case, so if game requires
some compatibility options, this will not work.
GUI
~~~
Some time ago simple GUI has been added for Windows version of UModel. It appears when
you start UModel without arguments (for example, clicking on UModel icon from Windows
Explorer). Please note that all command line option still works even in GUI mode.
A startup window appears only when you have neither game path nor package name specified.
It will allow you to choose where UModel will look for files ('-path' option) as well as
compatibility options. If you will set '-path' from the command line, startup GUI will
not appear. In a case you want to specify path and show startup GUI, add option '-gui'
to the command line.
Viewer window has user menu on the top of the window. Please review and try options
provided there. Most of them could be duplicated with keystrokes, and these key shortcuts
are listed in menu.
Viewer mode
~~~~~~~~~~~
The application is controlled with keyboard and mouse. You may see the full list of
keyboard shortcuts by pressing 'H' (Help) key. Here's the list of some shortcuts:
PgUp/PgDn browse through loaded objects
Ctrl+S take a screenshot into the file Screenshots/ObjectName.tga
Alt+S take screenshot with transparent background
Ctrl+X export all objects from the current scene
Ctrl+PgUp/PgDn scroll onscreen texts
Shift+Up/Down change scene FOV
Ctrl+L switch lighting modes
Ctrl+Q toggle visualization of debug information (text, 3D axis etc)
Ctrl+G toggle OpenGL 2.0 / OpenGL 1.1 renderer
Esc exit from the umodel
You may attach the AnimSet to the SkeletalMesh object using Ctrl+A key. Animation
sequences are listed by '[' and ']' keys, playback is started with a Space key.
Psk/psa export
~~~~~~~~~~~~~~
To load psk or psa into the 3ds Max you'll need ActorX Importer script created by me:
http://www.gildor.org/projects/unactorx
It has own announcements thread here:
http://www.gildor.org/smf/index.php/topic,228.0.html
Some meshes contains information which cannot fit into psk standard. For this reason I've
extended the format to hold advanced information. Files in this format has extension pskx
and cannot be loaded into UnrealEd or any other application with ActorX support. There's
only one tool with pskx support at the moment - ActorX Importer mentioned above.
Md5mesh/md5anim export
~~~~~~~~~~~~~~~~~~~~~~
Umodel has possibility to export skeletal meshes and animations in idSoftware md5 format.
To use this exporter you should use command line option "-md5". MeshAnimation and AnimSet
objects are exported as multiple md5anim files (one file for each animation track). "bounds"
section in md5anim is filled with dummy data. "hierarchy" section also does not contain real
skeleton hierarchy because Unreal engine uses hierarchy from the mesh, not from the
animation. Some md5 viewers/importers does require md5anim hierarchy, some - does not.
There is a 3ds Max md5mesh/md5anim importer script available on umodel forum:
http://www.gildor.org/smf/index.php?topic=87.0
or here
http://www.gildor.org/downloads
This script was originally created by der_ton, but was updated by me.
Please note that psk/psa format is more powerful, and ActorX Importer script has much more
capabilities than md5 Importer.
StaticMesh export
~~~~~~~~~~~~~~~~~
StaticMesh export is performed into psk format. This format was originally designed to hold
SkeletalMesh, but umodel uses it for StaticMesh too. Exported mesh will not have a skeleton
and vertex influences. Resulting psk files cannot be imported directly into the UnrealEd,
so I've decided to save ot with pskx extension to avoid silly user errors. Such mesh could
be imported into 3ds Max using ActorX Importer plugin as well as ordinary psk file.
Material export
~~~~~~~~~~~~~~~
Materials are exported in a custom format. File extension is ".mat". At the current moment,
this format is supported by ActorX Importer plugin only. Unreal engine materials are very
complex, so it's very hard to separate a few channels (diffuse, specular, bump etc) from it.
Umodel tries to accomplish this with use of some heuristics - sometimes with good results,
sometimes with bad. Umodel will never export full materials (GLSL script etc). Do not expect
too much from this feature.
Used third-party libraries
~~~~~~~~~~~~~~~~~~~~~~~~~~
SDL - Simple DirectMedia Layer
(c) Sam Lantinga
http://www.libsdl.org/
zlib data compression library
(c) Jean-loup Gailly and Mark Adler
http://zlib.net/
LZO data compression library
(c) Markus F.X.J. Oberhumer
http://www.oberhumer.com/opensource/lzo/
libmspack - a library for Microsoft compression formats
(c) Stuart Caie
http://www.cabextract.org.uk/libmspack/
NVIDIA Texture Tools
(c) NVIDIA
https://github.com/castano/nvidia-texture-tools
PVRTexLib Library
(c) Imagination Technologies Limited
http://www.imgtec.com/powervr/insider/
ASTC encoder
(c) ARM Limited and Contributors
https://github.com/ARM-software/astc-encoder
detex
(c) Harm Hanemaaijer
https://github.com/hglm/detex
Changes
~~~~~~~
02.10.2017
- added Fortnite support (currently requres game override)
29.09.2017
- added Unreal engine 4.17 support and initial UE4.18 support
29.07.2017
- implemented Lawbreakers support
28.07.2017
- added Gigantic auto detection
27.07.2017
- showing object's group name in viewer for UE1-UE3 games
12.06.2017
- added Tekken 7 support, game requires override -game=tekken7
09.06.2017
- added Friday the 13th: The Game support, game requires override -game=friday13
16.05.2017
- fixed loading of UE4 source animation assets
09.05.2017
- fixed bug in Win32 SDL2 caused incorrect handling of -path="some path" command line option
26.04.2017
- added Android ETC2 texture format support
25.04.2017
- fixes with mesh rotation (only affects mesh display in viewer)
- exporting skeletal mesh with "-uc" parameter will not also dump mesh socket information
- 1
- 2
前往页