
UberTunnel 3.0
==============

UberTunnel is an application for tunneling UDP packets. It's designed to be used together with Unreal Tournament, although the basic tunneling is not game specific in any way. 


Features
========

 * Any number of tunnels can be active at the same time
 * Any number of people can use a tunnel at the same time
 * Works with passworded servers
 * Static tunnels can be added to favorites list in UT and are marked with [UberTunnel]
 * Temporary tunnels can be created remotely from within UT


Installation
============

UberTunnel is composed of two parts, the tunneling program and the remote administration UT mod.

Installing the tunneling program
--------------------------------

 * Extract the file ubertunnel.exe to a suitable directory.

Installing the remote administration UT mod
-------------------------------------------

 * Extract the files ubertunnel.u and ubertunnel.int to the unrealtournament\system directory.


How to use
==========

The tunnel program should be easy to understand how to operate. Create and maintain static tunnels with the top row of buttons. You have to press reload after adding or editing a tunnel before the changes take effect. Configure the remote administration with the Options button.

The remote administration can be found under the Mod menu->UberTunnel in UT. Start with entering the address, port and password of the tunnel. After that, enter the address of the UT server that you want to connect to, and press Tunnel!. The server address can be entered just as it would have been in the regular Open Location, i.e. 33.34.148.212, 33.34.148.212:8888 and unreal://33.34.148.212:9999 will all work.


Misc information
================

UberTunnel was created by Fnordia. It can be downloaded from http://utv.clan-sy.com. If there is any problems with it you can contact me by mail on d97-rwe@nada.kth.se. Thanks to sniggel[f] for the encouragement and testing. :)

*******************************************************
*******************************************************


UberTunnel 3.0
==============

UberTunnel is an application for tunneling UDP packets. It's designed to be used together with Unreal Tournament, although the basic tunneling is not game specific in any way. 


Features
========

 * Any number of tunnels can be active at the same time
 * Any number of people can use a tunnel at the same time
 * Works with passworded servers
 * Static tunnels can be added to favorites list in UT and are marked with [UberTunnel]
 * Temporary tunnels can be created remotely from within UT


Installation
============

UberTunnel is composed of two parts, the tunneling program and the remote administration UT mod.

Installing the tunneling program
--------------------------------

 * Extract the file ubertunnel.exe to a suitable directory.

Installing the remote administration UT mod
-------------------------------------------

 * Extract the files ubertunnel.u and ubertunnel.int to the unrealtournament\system directory.


How to use
==========

The tunnel program should be easy to understand how to operate. Create and maintain static tunnels with the top row of buttons. You have to press reload after adding or editing a tunnel before the changes take effect. Configure the remote administration with the Options button.

The remote administration can be found under the Mod menu->UberTunnel in UT. Start with entering the address, port and password of the tunnel. After that, enter the address of the UT server that you want to connect to, and press Tunnel!. The server address can be entered just as it would have been in the regular Open Location, i.e. 33.34.148.212, 33.34.148.212:8888 and unreal://33.34.148.212:9999 will all work.


Misc information
================

UberTunnel was created by Fnordia. It can be downloaded from http://utv.clan-sy.com. If there is any problems with it you can contact me by mail on d97-rwe@nada.kth.se. Thanks to sniggel[f] for the encouragement and testing. :)

****************************************************************************************************
1. make a new copy of UT, if you haven't already. start it and stop it so you know it starts and this will create some of the ini entries we will need to modify

2. download a copy of uberlink from the first link and save it into the System folder

3. create or edit the DoUplink option in UnrealTournament.ini to true

[ipserver.udpserveruplink]
douplink=true

4. set the port= setting under [URL] to any port you want - this is not important for anything just don't use a port that another program might want to use

5. Password your server under [Engine.GameInfo]

6. replace IpServer.UdpServer lines under [Engine.GameEngine] to
ServerActors=uberlink.uberQuery
ServerActors=uberlink.uberUplink MasterServerAddress=unreal.epicgames.com MasterServerPort=27900
ServerActors=uberlink.uberUplink MasterServerAddress=master0.gamespy.com MasterServerPort=27900

7. you will need to decide on an incoming port for the tunnel, this is the port number people will be connecting to, if 7777 is fine then skip this step, otherwise add this new section to your UnrealTournament.ini

[uberlink.settings]
uberport=8888

8. start your server

9. Download ubertunnel from link 2

10. add your gameserver to it, the incoming port you want people connecting to (7777 or set in uberport setting above), and under options enable the +1 box, you should disable all the functions below that box unless you know what it's for. click reload


advanced:

setting up ubertunnel on linux (with wine)

note: this is a guide telling you how to set up a GUI that you can connect to from another computer and open GUI interfaces like ubertunnel, if you already have a GUI don't install KDE, you will only need vncserver and wine

Debian

apt-get update
apt-get install x-window-system kde kdm tightvncserver wine
mkdir .vnc
nano .vnc/xstartup (apt-get install nano)

only one line 'kde' without quotes

chmod +x .vnc/xstartup
vncserver :1


CentOS:

1. yum groupinstall "KDE (K Desktop Environment)"

2. yum install vnc-server

3. vncpasswd

4. nano /etc/sysconfig/vncservers
do this:
VNCSERVERS="1:root"
VNCSERVERARGS[1]="-geometry 640x480"
(i'd use 800x600 or a higher resolution)

run commands: to create xstartup file
5. /sbin/service vncserver start
6. /sbin/service vncserver stop

7. nano /root/.vnc/xstartup (yum install nano)

uncomment these 2 lines:

unset SESSION_MANAGER
exec /etc/X11/xinit/xinitrc


8. /sbin/service vncserver start
(port to connect to is :1)

installing wine centos:
su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm%27

su -c 'yum install wine'


advanced:

rename your master list server from "[UberTunnel 3.0] Servername" to "IPv6 --- Servername"

open ubertunnel.exe with a hex editor. find the string "[UberTunnel 3.0]" replace each letter with one of your choice, this includes spaces. but don't overwrite anything before or after the string, and don't add anything new, only overwrite as if the insert key was active if you were editing a document




