FAQ:UT3

From UnrealAdminWiki

(Difference between revisions)
Revision as of 20:20, 1 January 2008
AnnihilatorSC ( | contribs)
Game Types & Mutators
← Previous diff
Revision as of 20:22, 1 January 2008
AnnihilatorSC ( | contribs)
Game Types & Mutators
Next diff →
Line 14: Line 14:
NOTE: To launch multiple servers on a machine you must use the ut3.exe binary, not the ut3.com binary. In at least one instance, using only "ut3" selected the .COM binary. Results were among others that it was impossible to stop a single instance without killing all running instances. NOTE: To launch multiple servers on a machine you must use the ut3.exe binary, not the ut3.com binary. In at least one instance, using only "ut3" selected the .COM binary. Results were among others that it was impossible to stop a single instance without killing all running instances.
==== Game Types & Mutators ==== ==== Game Types & Mutators ====
-This is a list of the valid gametypes and their gametypeid for the demo:+This is a list of the valid gametypes:
{| border="1" {| border="1"
-! Name !! GameType !! GameTypeId+! Name !! GameType
|- |-
-| Deathmatch || UTGame.UTDeathmatch || 0+| Deathmatch || UTGame.UTDeathmatch
|- |-
-| Capture the Flag || UTGameContent.UTCTFGame_Content || 1+| Capture the Flag || UTGameContent.UTCTFGame_Content
|- |-
-| Warfare || UTGameContent.UTOnslaughtGame_Content || 2+| Warfare || UTGameContent.UTOnslaughtGame_Content
|- |-
-| Vehicle Capture the Flag || UTGameContent.UTVehicleCTFGame_Content || 3+| Vehicle Capture the Flag || UTGameContent.UTVehicleCTFGame_Content
|- |-
-| Team Deathmatch || UTGame.UTTeamGame || 4+| Team Deathmatch || UTGame.UTTeamGame
|- |-
-| Duel || UTGame.UTDuelGame || 5+| Duel || UTGame.UTDuelGame
|} |}
- 
- 
-If you don't <tt>GameMode=<GameTypeId></tt> correctly then your server wont appear in the right server list in the client browser 
For mutators you need to set the variable of each mutator:- For mutators you need to set the variable of each mutator:-

Revision as of 20:22, 1 January 2008


Contents

Running a dedicated server

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

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

Examples of this would be:-

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

UT3.exe Server VCTF-Suspense?AdminPassword=adminpass?ServerDescription=descr -Login=username -Password=pass -unattended

NOTE: To launch multiple servers on a machine you must use the ut3.exe binary, not the ut3.com binary. In at least one instance, using only "ut3" selected the .COM binary. Results were among others that it was impossible to stop a single instance without killing all running instances.

Game Types & Mutators

This is a list of the valid gametypes:

Name GameType
Deathmatch UTGame.UTDeathmatch
Capture the Flag UTGameContent.UTCTFGame_Content
Warfare UTGameContent.UTOnslaughtGame_Content
Vehicle Capture the Flag UTGameContent.UTVehicleCTFGame_Content
Team Deathmatch UTGame.UTTeamGame
Duel UTGame.UTDuelGame

For mutators you need to set the variable of each mutator:-

  1. Mutator=<MutatorIdentifier>

Here is a list of Mutators shipped with the Retail Version:

Name MutatorIdentifier
Instagib UTGame.UTMutator_Instagib
BigHead UTGame.UTMutator_BigHead
Low Gravity UTGame.UTMutator_LowGrav
Super Berserk UTGame.UTMutator_SuperBerserk
Friendly Fire UTGame.UTMutator_FriendlyFire
No Translocator UTGame.UTMutator_NoTranslocator
Speed Freak UTGame.UTMutator_SpeedFreak
Handicap UTGame.UTMutator_Handicap
No Powerups UTGame.UTMutator_NoPowerups
Slomo UTGame.UTMutator_Slomo
Weapon Replacement UTGame.UTMutator_WeaponReplacement
Weapon Respawn UTGame.UTMutator_WeaponsRespawn

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)
  • QueryPort=<port> Sets the server query port (default: 6500)
  • 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.

Running Behind a Router/Firewall

1. Setup port forwarding for three ports (all UDP only): 13000, 7777 and 6500 (or whatever port/queryport your server is running on; 7777/6500 are the defaults).

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.

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

Each server process needs to run under a different gamespy account (can be created in the game). Important things to note are:

  • The -nohomedir command forces the servers to use the install directory instead of My Documents...
  • The -configsubdir=<serverfoldername> will create a folder under ..\UTGame\config\ so each server instance can have it's own ini files
  • -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
  • The servers query port is changed with -QueryPort=<port>
  • You must specify -unattended as without it you will get prompted to confirm the upgrade of the server's configuration files. This option needs to be last in the command line.

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]

Enable Mapvote

Edit the ...\UTGame\Config\UTGame.ini. Under the [UTGame.UTGame] section, be sure to have this:

  • bAllowMapVoting=True
  • VoteDuration=45
  • GameSpecificMapCycles=(GameClassName="UTDeathmatch",Maps=("DM-Arsenal","DM-Biohazard","DM-CarbonFire","DM-Deck","DM-Defiance","DM-Deimos","DM-Diesel","DM-Fearless","DM-Gateway","DM-HeatRay","DM-RisingSun","DM-Sanctuary","DM-Sentinel","DM-ShangriLa"))
  • GameSpecificMapCycles=(GameClassName="UTTeamGame",Maps=("DM-Arsenal","DM-Biohazard","DM-CarbonFire","DM-Deck","DM-Defiance","DM-Deimos","DM-Diesel","DM-Fearless","DM-Gateway","DM-HeatRay","DM-RisingSun","DM-Sanctuary","DM-Sentinel","DM-ShangriLa"))
  • GameSpecificMapCycles=(GameClassName="UTCTFGame_Content",Maps=("CTF-Coret","CTF-Hydrosis","CTF-Reflection","CTF-Vertebrae","CTF-OmicronDawn","CTF-Strident"))
  • GameSpecificMapCycles=(GameClassName="UTVehicleCTFGame_Content",Maps=("VCTF-Containment","VCTF-Corruption","VCTF-Kargo","VCTF-Necropolis","VCTF-Sandstorm","VCTF-Suspense"))
  • GameSpecificMapCycles=(GameClassName="UTOnslaughtGame_Content",Maps=("WAR-Avalanche","WAR-Downtown","WAR-Dusk","WAR-FloodGate","WAR-Islander","WAR-Islander_Necris","WAR-MarketDistrict","WAR-OnyxCoast","WAR-Powersurge","WAR-Serenity","WAR-Serenity_Necris","WAR-SinkHole","WAR-TankCrossing","WAR-Torlan","WAR-Torlan_Leviathan","WAR-Torlan_Necris"))
  • GameSpecificMapCycles=(GameClassName="UTDuelGame",Maps=("DM-Arsenal","DM-Biohazard","DM-CarbonFire","DM-Deck","DM-Defiance","DM-Deimos","DM-Diesel","DM-Fearless","DM-Gateway","DM-HeatRay","DM-RisingSun","DM-Sanctuary","DM-Sentinel","DM-ShangriLa"))

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:

  • AdminLogin <password> - Logs you in as an admin
  • AdminLogout - Logs you out of admin mode
  • AdminRestartMap - Restarts the current map
  • AdminChangeMap <MapName> - Loads a different map (gametype will change too, depending on map)
  • Admin addbots <#> - Adds number of bots
  • Admin killbots - Removes all bots
  • AdminPlayerList - Shows PlayerID of players
  • Adminkick <playername> - Kicks player from current game
  • Adminkickban <playername> - Kicks player from current game and bans player from reconnecting (bans are stored in .ini file for later editing)
  • AdminForceVoiceMute <playername> - Blocks a player from sending voip to others
  • AdminForceVoiceUnMute <playername> - Allows a player to resume sending voip to others
  • AdminForceTextMute <playername> - Blocks a player from sending text to others
  • AdminForceTextUnMute <playername> - Allows a player to resume sending text to others
  • AdminPublishMapList - Overrides the server's map list for the current game type with the one on the client that used the command

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
  • 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
  • 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
  • Linux Demo Server crashes when IP is entered in HLSW
  • Linux Demo Server requires SSE2 which requires a Pentium 4 class CPU or better. For AMD CPUs this translates to "Athlon64 or better".
the UnrealAdmin Page
History
  • FAQ:UT3