README.txt updated 16.07.2005 by Diablo
mail: diablo_proxy 'at' gmx 'dot' net
project summary page:
https://sourceforge.net/projects/ushock/
project home page:
http://ushock.sourceforge.net/
"Make Something Unreal" contest:
http://www.unrealtournament.com/ut2003/ct_phase3/ct_tool.php
UShock is a experimtenal Unreal level viewer for all Unreal game
series from Unreal1 to UT2004! (tested: Unreal1, UT99, WOT, Unreal2, UT2003, UT2004)
UShock loads all the dependend packages (Textures, Static-Meshes etc.)
and displays everything using a simple (more or less;-) OpenGL renderer.
To view a level just select Unreal game directory (i.e.: C:\Unreal, C:\UT2004)
and the desired level on the popup-GUI-Window and press "run".
Installation:
-------------------
* unpack the contents of the zip-file in a local directory
IMPORTANT: UShock.exe and wxmsw24.dll have to reside in the same directory!
Requirements:
-------------------
* desired Unreal game content (of course)
* full OpenGL support (at least 1.3.0)
-> required extensions: ARB/EXT_multitexture, ARB/EXT_texture_compression[_s3tc], ARB/EXT_texture_env_combine
-> recommended extensions: ARB_vertex_buffer_object
(up to date drivers might help)
* graphics hardware: tested on GeForce2TGS and moblity Radeon 9700 (m11)
-> should run on all mainstream cards
Hint:
-------------------
If your desktop color-depth is set to 32 bit and
you try to start UShock with 16 bit fullscreen mode,
the thing is likely to crash (in this case no correct
gl-driver will be loaded)
Controls:
-------------------
W - forward
S - back
A - left
D - right
F1 - center camera
m - change rendering mode (normal, flat, wireframe, lightmaps only, nolightmaps)
Esc - quit program
Build-Hints:
-------------------
You'll need wxWidgets library (at least 2.4xx) and under Linux the SDL lib.
check out the Makefile first if you want to compile it under Linux - you need an 'old' g++ version for wx-dependend builds
If you are using VisualSTudio .Net there will be some stupid memory error on release-build (debug works)
Verison history:
-------------------
version 0.3:
* .uz2 package support (packages will be uncompressed on the fly)
* hack to load levels from the ut2004 dvd (choose x:\CD1 as Unreal-root directory - very slow because of many 'fseek' calls)
version 0.2:
* lightmap support for ut2003/4 (DXTn Lightmaps only)
* "Wheel of Time" support (ArVer 68 -> UT1 Tech)
* possibility to switch between different rendering modes (m-key)
* support for new 'Material' classes like texpanners, texrotators etc
(just have a look at AS-Convoy ;-)
* rendering fixes for 'Shader' class (well its very tricky to imeplement Unreal shading system correctly...)
* better Unreal1-Tech blending support (including PF_AutoUVPan)
* group-namespaces fixed (package.group.object)
version 0.1
* package support for Unreal1, UT1, Unreal2, UT2003/4 (ArVer 60-127)
* simple terrain rendering added
* GUI config added
LICENCE:
-------------------
COPYRIGHT 2005, Bertram Thomass
This file is part of UShock. UShock is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. UShock is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with Nexuiz; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
-> see gpl.txt or
http://www.gnu.org/copyleft/gpl.html
This Program uses public-Header Information available at
http://unreal.epicgames.com/Downloads.htm
