==========-
READ ME for UT3Fixer P3.1
==========-
Author:       Nico de Vries
Platform:     Unreal Tournament 3 (Tested with UT3 1.2)
Website:      BigBattleServers.com (the forum can be used for feedback and requests)
Release date: May 24 2008
Version:      P3.1 (prototype 3.1)

==========-
Installation (server admin manual)
==========-
Windows dedicated server:
    Store the .u and .upk file(s) in your ..\UTGame\CookedPC\ directory and the 
    .ini file(s) in your ..\UTGame\Config\ directory. 

Linux dedicated server:
    Store the .u and .upk file(s) in your ../UTGame/CookedPC/ directory and the 
    .ini file(s) in your ../UTGame/Config/ directory.

For servers you need to add to the command line: ?Mutator=UT3Fixer.UT3Fixer

You can use UTUT3Fixer.ini to change the timeout. A high timeout means the chance
a client gets disconnected while switching maps becomes smaller but also that the
client has to wait longer in case of real connection problems. The default is
120 seconds.

There are 2 special versions included. BRPG for use together with BattleRPG and
BTFA for use together with Battle Team/Freezetag Arena. When you use these the
mutator becomes UT3Fixer_BRPG.UT3Fixer or UT3Fixer_BTFA.UT3Fixer.

REMARK: the .uc files contain sourcecode for those who are interested in that. They 
are NOT needed to use and run UT3Fixer.

==========-
What does it do?
==========-
This is a fix for the "package not found download was already attempted" error that 
prevents UT3 server owners from installing custom maps on UT3 servers. P1 has been 
tested on several Unreal servers and does indeed fix this problem there. UT3Fixer 
is an ugly hack that seems to do the job. It is a temporary solution allowing server 
owners to use custom maps until Epic releases UT3 1.3 which will probably fix the 
problem.

It is based on a combination of disabling "seamless travel" while at the same time
still keeping the players connected to the server (disabling seamless travel will 
initially kick all players off the server).

==========-
Important to know
==========-
R3PORTER does not seem to work together with UT3Fixer, since there is no sourcecode 
with R3PORTER I do not know yet how to make them compatible.

UT3Fixer is an unusual piece of software since it tries to solve an inside UT3 problem 
from the outside. I have been wondering if I should make it at all. P3, P2 and P1 use 
slightly different approaches so in some cases (depending on what other mutators are 
installed) P2 or P1 might work better than P3. You might need to experiment a little
to see what version works best for you. All versions are available from
http://bigbattleservers.com/ut3mods.php

UT3Fixer allows to set up a properly working server with fully working custom maps,
several server owners have done this already, and no "package not found..." errors. 
Unfortunately it will not work together with every mutator or gametype. So you might 
need to experiment with these.

I have done a LOT of experiments with alternative approaches, but it seems the current
one is the best possible give the options of the UT3 1.2 engine. UT3Fixer will allow 
proper use of custom maps while we all wait for UT3 1.3, but the best solution to the
custom maps problem will of course be UT3 1.3.

==========-
Changes
==========-
P3 -> P3.1
- Replaced UT3Fixer.u with the proper version

P2 -> P3
- Made the client timeout configurable now with UTUT3Fixer.ini, default timeout is 120 seconds
- Made the timeout clock much more accurate
- Did extensive research into a PlayerController free solution, only found many dead ends
- Did extensive research into R3PSpectator, dead end due to not having R3PSpectator source code

P1 -> P2
- Changed logic so things like banning and real connection problems are now properly handled
- Made special versions for use with BattleRPG and Battle Team/Freezetag Arena

==========-
Thanks to (for contributions, running servers and suggestions)
==========-
Contributors:
- Matt Oelfke (Mysterial) from Epic for the suggestion of disabling seamless travel
- Shambler for the usual useful input
- Hedsteem for extensive testing and feedback 
- Leslie Moss (Mossa) for extensive testing and feedback 
- Michiel "elmuerte" Hendriks for testing and useful input
- [PHX]Big_Deal for pointing out I put the wrong UT3Fixer.u in the ZIP

Communities:
- BigBattleServers.com
- ut2004.titaninternet.co.uk
- justwarfare.com
- forums.beyondunreal.com
- forums.epicgames.com   
- UT3SERVERS@LIST.EPICGAMES.COM

==========-
UT3Fixer Copyright (C) 2007-2008 Nico de Vries.

UT3Fixer 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 3 of the License, or
(at your option) any later version.

This program 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 this program.  If not, see http://www.gnu.org/licenses/.
==========-