FAQ:UT3

From UnrealAdminWiki

(Difference between revisions)
Revision as of 00:31, 19 October 2007
nomadicus ( | contribs)

← Previous diff
Revision as of 18:53, 20 October 2007
Cruz ( | contribs)
Query Protocol
Next diff →
Line 59: Line 59:
* The query port for servers is currently dynamic and cannot be set. * The query port for servers is currently dynamic and cannot be set.
* You will need an up-to-date version of qstat to enable some specific fixes for the current UT3 demo * You will need an up-to-date version of qstat to enable some specific fixes for the current UT3 demo
 +
 +
 +For more details about the query protocol (including the PHP code to do web-based querying and details on the query variables) check out the [[UT3_query_protocol]] page.
==== Multiple Servers on One Machine ==== ==== Multiple Servers on One Machine ====

Revision as of 18:53, 20 October 2007


Contents

Demo

Running a dedicated server

The basic format of running server start command line is:-

UT3Demo Server <map>?<variable1>=<value1>?<variable2>=<value2>.... -login <login> -password <password> -unattended

Examples of this would be:-

UT3Demo Server DM-ShangriLa?CustomMapName=DM-ShangriLa?MaxPlayers=6?game=UTGame.UTDuelGame?CustomGameMode=UTGame.UTDuelGame?GameMode=5?GoalScore=0?TimeLimit=5?ServerDescription=068000111000110000116000032000106000111000105000110000?GamePassword=test? -log=DedicatedServer.log -Login=<login> -Password=<password> -unattended

UT3Demo Server VCTF-Suspense?GameMode=3?bIsDedicated=True?AdminPassword=adminpass?ServerDescription=descr -Login=username -Password=pass

Game Types

There are a few important things to note about the above, firstly to set the gametype you need to set the variable:-

  1. GameMode=<GameTypeId>

This is a list of the valid gametypes and their gametypeid for the demo:

Name GameType GameTypeId
DM UTGame.UTDeathmatch 0
Duel UTGame.UTDuelGame 5
TDM UTGame.UTTeamGame 4
Vehicle CTF UTGameContent.UTVehicleCTFGame_Content 3

If you don't GameMode=<GameTypeId> correctly then your server wont appear in the right server list in the client browser

Common Variables

  • MaxPlayers=<number> Maximum number of players on the server (overrides ini setting)
  • MinNetPlayers=<number> Minimum number of players before a match starts (real players not bots)
  • bShouldAdvertise=[True|False] Show the server in the server browser (default: true)
  • bIsLanMatch=[True|False] Is this a LAN only game? (default: false)
  • bIsDedicated=[True|False] Changes dedicated server flag (default: false, even if started as dedicated)
  • GamePassword=<password> Sets a game password
  • AdminPassword=<password> Sets an admin password
  • Port=<port> Sets the server game port (default: 7777; can also be changed via the INI file)
  • GameMode=<number> Sets the gamemode (so servers will show up in the right catagory in the server browser) see above
  • GoalScore=<number> Sets the max frags / max caps before the server will change maps.
  • bUsesStats=[True|False] Report stats or not?
  • ServerDescription=<UCS2 numeric string> Sets the second part of the server name
  • TimeLimit=<number> Sets the timelimit in minutes for each map.

Server Logins

ATM all servers need a unique login, as in no two servers can use the same login. Doing so will mean that one of those servers will not show in the list. This login has to be created via the client "Create Profile". You can create multiple profiles under the same email address but you must use the same password for each if you do so.

Query Protocol

The server uses the GameSpy query Protocol ( v4 ) which can be queried with qstat e.g.

qstat -R -gs4 <ip>:<port>

Notes

  • If you want the map you must currently request server rules with -R as the server doesnt currently return the map in the basic query.
  • The query port for servers is currently dynamic and cannot be set.
  • You will need an up-to-date version of qstat to enable some specific fixes for the current UT3 demo


For more details about the query protocol (including the PHP code to do web-based querying and details on the query variables) check out the UT3_query_protocol page.

Multiple Servers on One Machine

If you are looking to run multiple servers on the same machine you need to specify all of the settings which will vary between servers on the command line as there is currently no way of telling a server to load a specific server configuration file or ini, short of running each server process under a different account (which is really not such a bad idea in any case). Important things to note are:

  • -login <login> and -password <password> as these must be unique
  • The servers port is changed with ?Port=<port> in the URL, or via the setting in UTEngine.ini
  • You must specify -unattended as without it you will get prompted to confirm the upgrade of the server's configuration files

Server Names

Server names are currently made up of two components the Login and the ServerDescription so if your have ?ServerDescription=<my description> -login <login> you will see your server as:

<login>: <my description>

Yes this is a total pain in the arse not to mention totally impractical but it doesnt stop there the ServerDescription field isnt in plain ascii or text as you and I know it. Instead its in UCS2 aka UTF-16 which is then serialized as numeric strings. It is possible to generate the server description code here: [Cruz's UT3 Server Description Generator]

Admin Commands

You ment to be able to admin the game using rcon but when we tried it although adminlogin worked none of the subsiquent commands did.

First off login with: AdminLogin <password>

The you can use the following command:

  • AdminRestartMap Restarts the current map
  • AdminChangeMap <MapName> Loads a different map (gametype will change too depeding on map)
  • Admin addbots <#> Adds # bots
  • Admin killbots Removes all bots
  • Adminkick <playername> Kicks player
  • Adminkickban <playername> Kicks and Bans Player (bans stored in ini)

When your done you can logout with: AdminLogout

Current Issues / Bugs

  • The default generated UTGame.ini only contains the last maplist in DefaultGame.ini
  • Without -unattended the server will prompt to upgrade the servers config files, particularly if you run more than one server as the same user on a machine
  • The server's query port is dynamic so it can't be fixed to a given value or changed at this time.
  • The multihome option -multihome doesn't work properly; process binds to the correct IP address, yet still the wrong one gets published.
  • Running servers under Windows requires the latest Direct3D support installed via the DirectX runtime.
  • Each server requires a unique login
  • The MessageOfTheDay seperator | doesnt work currently
  • Server installer doesn't work on Windows 2003 however there is now an updated .exe to enable you to run a pre-extracted version
  • Port scanning a server or connecting to a full server can make it show more than the max players connected.
  • CPU usage at idle is high
  • Generation of the default UTGame.ini is broken for multiple <var1>=<val1> <var1>=<val2>
  • Rcon admin commands don't appear to work ATM
the UnrealAdmin Page
History
  • FAQ:UT3