Information
This is an information page for the official Unreal Tournament 3 Web Administration tool. You will find here the latest releases. The UT3 WebAdmin is not included with the official patches for UT3, it will be released seperately. This way issues can quickly be addressed and new features can be made available as soon as possible. Note: the minimal requirement for the UT3 WebAdmin (versions 1.3 and earlier) is UT3 with patch 1.2, since version 1.4 UT3 with patch 1.3 is required. Version 1.9 and later require UT3 version 2.0. And starting from version 1.13 UT3 patch 2.1 is required.
Installation
Download the release package and extract its content to the Unreal Tournament 3 installation directory. The release package
In order to enable the WebAdmin you need to edit the UTWeb.ini
and change the variable bEnabled
to True
in the [UWeb.WebServer]
section.
The UTWeb.ini
is automatically created in the config directory based on the DefaultWeb.ini
located in the GameDir/UTGame/Config
.
If you do not have the UTWeb.ini
file in your active configuration directory you can simply copy the content of DefaultWeb.ini
.
When you start the server you should see the following log entry:
ScriptLog: Web Server Created http://some.ip:port [...] Enabled TrueThis means the webserver was succesfully started. You should be able to connect to it using the reported address. Note: Check the firewall settings when you are unable to connect to it.
You can log in on the webadmin using any user name and the password is the same as the configured admin password.
Configuration
The default configuration for the various parts of the WebAdmin should be good enough for most people.
But if you want to you can change the settings in the UTWebAdmin.ini
, the default settings can be found in DefaultWebAdmin.ini
.
Below you can find an overview of all configuration variables.
[WebAdmin.WebAdmin]
- AuthenticationClass
- The fully qualified classname to use as authentication module. An authentication module has to implement the
WebAdmin.IWebAdminAuth
interface. The authentication module defaults toWebAdmin.BasicWebAdminAuth
. An alternative authentication module is included starting from version 1.8, it supports multiple administrators with different privileges. To use the multi-admin authentication use:WebAdmin.MultiWebAdminAuth
. - SessionHandlerClass
- The fully qualified classname to use as session manager. An session manager has to implement the
WebAdmin.ISessionHandler
interface. The session manager defaults toWebAdmin.SessionHandler
. - QueryHandlers
- A list of fully qualified classnames for
WebAdmin.IQueryHandler
implementators. Query handlers provide the actual functionality for the various webpages served by the WebAdmin. There currently two query handlers:WebAdmin.QHCurrent
, which provides pages to manage the current game; andWebAdmin.QHDefault
, which provides functionality to change default settings for various elements. - bHttpAuth
- If
true
the WebAdmin will used HTTP authentication rather than a HTML form. The HTTP authentication method isbasic
, there is no support fordigest
. Using form based authentication you can easily log out from the WebAdmin interface. Both methods are equally secure. - startpage
- The default page to open after logging in. This default is
/current
. The URL should not contain the path to the WebAdmin (which is/ServerAdmin
by default.) - bChatLog
- Enabled chat logging. The chat logs will be saved in the logs directory. (since v1.2)
[WebAdmin.BasicWebAdminAuth]
- RequireUsername
- A list of usernames that are allowed when using this authentication module. By default (when the list does not contain any entries) any name is accepted. Using this option you can limit the accepted names. This adds some additional security to the WebAdmin interface.
[WebAdmin.QHCurrent]
- ChatRefresh
- The refresh time of the chat console in miliseconds. This is the delay before the pay tries to check for new messages. You should not set this too low, the minimum value is 500.
- bConsoleEnabled
- If
true
the management console is activated. The management console allows admins to execute arbitrary console commands directly on the server. - denyConsoleCommands
- A list of console commands that are now allowed in the management console. The first part of the entered command is
check with this list. So if for example
obj
is in the list no command starting withobj any other data
will be allowed. ButobjectSomething
will still be allowed. - denyUrlOptions
- A list of URL options that are not allowed to be set in the miscelaneous options setting of the change game page. These options will be filtered out. If any of these options was previously set to launch the current game, then they will be added before switching the game to the new map.
- bAdminConsoleCommandsHack
- If
true
then the admin console commands will be supported. The admin console commands are the commands you usually enter when loggin in as an admin player (like thekick
command). You do not need to prefix these commands with admin like you would need to do on the server. - bEnableTeamChat
- Enabled support for reading participating in team chat from the chat console. (since v1.2).
[WebAdmin.QHDefaults]
- SettingsClasses
- A list of classname to settings class mappings. It will be used to find the settings class that will handle the settings for a given gametype or mutator. The WebAdmin will try to automatically find the correct class using the name of the class that needs to be set up. More about this can (soon) be found on the UnrealWiki.
- GeneralSettingsClass
- The fully qualified name of the settings class that should be used to change the general settings. Defaults to
WebAdmin.GeneralSettings
. - AdditionalMLClass
- The fully qualified name of the storage class for the additional map lists. Defaults to
WebAdmin.AdditionalMapLists
, which stores the map lists in the UTGame.ini. You can change it toWebAdmin.AdditionalMapListsAlt
to store the map lists in UTAdditionalMapLists.ini. (Available from v0.9)
[WebAdmin.Chatlog]
(since v1.2)
- bUnique
- If true unique files names will be created.
- bIncludeTimeStamp
- Append a timestamp to the log filenames. This will make sure the log files are unique for each game.
Downloads
- Latest stable release
- v1.17 – 2009-09-13 – requires UT3 version 2.1 (engine version 3805)
- All releases
-
- v1.17 – 2009-09-13 – requires UT3 version 2.1 (engine version 3805)
- v1.16 – 2009-07-30 – requires UT3 version 2.1 (engine version 3805)
- v1.15 – 2009-05-17 – requires UT3 version 2.1 (engine version 3805)
- v1.14.1 – 2009-04-05 – requires UT3 version 2.1 (engine version 3805)
- v1.14.0 – 2009-04-05 – requires UT3 version 2.0 (engine version 3792)
- v1.13 – 2009-03-22 beta – requires UT3 version 2.1 (engine version 3805)
- v1.12 – 2009-03-09 – requires UT3 version 2.0 (engine version 3792)
- v1.11.1 – 2009-03-07 – requires UT3 version 2.0 (engine version 3792)
- v1.11 – 2009-03-07 – requires UT3 version 2.0 (engine version 3797)
- v1.10 – 2009-02-28 – requires UT3 version 2.0 (engine version 3786)
- v1.9 – 2009-02-20 – requires UT3 version 2.0 (engine version 3786)
- v1.8 – 2008-12-05 – requires UT3 version 1.3 (engine version 3601)
- v1.7 – 2008-09-21 – requires UT3 version 1.3 (engine version 3601)
- v1.6 – 2008-08-23 – requires UT3 version 1.3 (engine version 3601)
- v1.5 – 2008-08-08 – requires UT3 version 1.3 (engine version 3601)
- v1.4 – 2008-06-03 – requires UT3 version 1.3 (engine version 3601)
- v1.3 – 2008-05-18
- v1.2 – 2008-05-07
- v1.1 – 2008-04-06
- v1.0 – 2008-03-24
- v0.10 – 2008-03-16
- v0.9 – 2008-03-07
- v0.8 – 2008-03-02
- v0.7 – 2008-02-29
- v0.6 – 2008-02-29
- v0.5 – 2008-02-24
- v0.4 – 2008-02-19
- v0.3 – 2008-02-11
- v0.2 – 2008-02-07
- v0.1 – 2008-01-28