UTComp v1.4b Readme


Quickstart Basic Setup Full Command list Changelog FAQ
Player Server Player Server Player Server Known Issues Credits

Player Quickstart Back to Top

This version of UTComp is recommended for clients updated to version 3323 or higher. Using an older version should work, but it has not been extensively tested.


Server Quickstart Back to Top

This version of UTComp is recommended for servers updated to version 3323 or higher. Using an older version should work, but it has not been extensively tested. We also strongly suggest that server admins, especially on linux, download and use the .zip version.


Basic Player Setup Back to Top

Instructions on how to install the files can be found in the Client Quickstart section. This Basic Setup section mostly discusses the most important settings for a variety of gametypes. Reading through this should be enough to get a good understanding of UTComp's features. For a full list of everything the mutator does, read the Player Full Command List section.

Warning: This version of UTComp is recommended for clients updated to version 3323 or higher. You can download the patch from BeyondUnreal. It is still possible to use UTComp with older versions, but most of the testing has been done using version 3323, therefore using this version of UTComp on older UT2004 versions is strongly discouraged.


Basic Server Setup Back to Top

A full list of every server command can be found in the Server Full Command List Section. This basic setup section has step-by-step instructions on how to set up UTComp on your server, as well as a list of settings that are likely to be changed. This is not a generic Unreal Tournament 2004 server setup guide, this info is UTComp specific. I recommend reading the Unreal Admin Page tutorials if you need help on generic UT2004 server setup.

Warning: This version of UTComp is recommended for servers updated to version 3323 or higher. You can download the patch from BeyondUnreal. It is still possible to use UTComp on server running and older version of UT2004, but most of the testing has been done using version 3323, therefore using this version of UTComp on a server with an older UT2004 version is strongly discouraged.

1- Installing the files

Note that the ut4mod version will not work on linux, unless you use ucc to manually extract the files from the .ut4mod file. It will probably not work on the stand-alone win32 dedicated server package either. We therefore recommend using the zip version for servers.

2- Modifying your server ini

Adding a Serverpackage line to your server's ini file is required for UTComp to work properly on a version 3186(original UT2004 version) server. If you fail to add that line, players will freeze on the loading screen when they try to connect. It is not required on servers running more recent versions of UT2004, but if you don't add the line, you will not be able to record serverside demos on your server. Your server ini is called ut2004.ini by default. Rented servers often change this, ask your game server company for more info if they do. The line you need to add is in the [Engine.GameEngine] section. You should see a list of ServerPackage= lines there already, add a new one, which needs to be exactly:

ServerPackages=utcompv14b

Note that if you're hosting your server on linux, the ServerPackages line is case sensitive, which means if you write ServerPackages=UtCoMpv14b, it won't work. We intentionally distribute the mutator's files in lower case names to make this easy.
If you're upgrading from a previous version of UTComp, it is recommended to remove ServerPackages= lines from old versions: if you don't, players will automatically download every version of UTComp that has its own ServerPackages= line, even if its not used anymore.

3- Making sure the mutator loads

For UTComp to work, it needs to be loaded as a mutator on your server. There are five ways to do that:

  1. If you set up your server with the "Host Game" interface, select "UTComp version 1.4b" in the mutator list.
  2. Using Webadmin, in the Mutators section, click in "UTComp version 1.4b" and restart the map.
  3. Using Webadmin, in the Server console section, type in servertravel DM-DE-Ironic?Mutator=utcompv14b.MutUTComp
  4. In game, log in as admin, and type in admin servertravel DM-DE-Ironic?Mutator=utcompv14b.MutUTComp
  5. On the server command line, add in ?mutator=utcompv14b.MutUTComp
4- Configuring your server settings

Some of the basic UTComp server settings can be configured directly in Webadmin. They are under Defaults, UTComp Settings. If you don't use Webadmin on your server, the settings are all listed in the [utcompv14b.MutUTComp] section, in your server ini. Refer to the Server Full Command list section for information on server side ini settings.


Player Full Command List Back to Top

Player Console Commands

Spectator Console Commands
These commands can only be used by spectators. GUI Settings
These settings are found in the in-game F5 menu. If for some reason the mutator doesn't automatically bind your F5 key to that menu, you can type in mymenu in the console when connected to a UTComp server to bring it up.


  • Auto Demo/SS
  • Miscellaneous
    Server Full Command List Back to Top

    All of those settings are located in your server ini, which by default is ut2004.ini, under the section [utcompv14b.MUTUTComp]. You need to start your server at least once for the [utcompv14b.MUTUTComp] section to be created, along with its default settings.

    Epic Mapvote Information

    For server admins relying on Epic's Map Vote utility to change Gametypes and settings, you can now configure some of UTComp's settings through that by adding the following information to your GameConfig= lines in [xVoting.XVotingHandler] in your server's ini. For example, this is the stock Webadmin-generated line for Team Deathmatch:

    GameConfig=(GameClass="XGame.xTeamGame",Prefix="DM",Acronym="TDM",GameName="Team DeathMatch",Mutators=,Options=)

    The Options= parameter can be configured with the following settings:

    These values accept the same parameters than in the [utcompv14b.MUTUTComp] section, refer to the documentation above for settings. Here's an example of a modified TDM line that would always turn on Double Damage, and Team Overlay:

    GameConfig=(GameClass="XGame.xTeamGame",Prefix="DM",Acronym="TDM",GameName="Team DeathMatch",Mutators=,Options=EnableOverlay=True,DoubleDamage=True)

    These values can also be passed as parameters in a regular servertravel line, as an admin, or in the server console / webadmin. For example, you could type servertravel dm-antalus?doubledamage=True?EnableOverlay=False, which would change the map to DM-Antalus, enable Double Damage and disable Team Overlays.


    Change Log Back to Top

    v1.4b:

    v1.4a:

    v1.4:

    v1.4 beta3:

    v1.4 beta2:

    v1.4 beta1:

    v1.3b:

    v1.3:

    v1.3 RC1:

    v1.2:

    v1.2 RC3:

    v1.2 RC2:

    v1.2 RC1:

    v1.1a:

    v1.1:

    v1.0b:

    v1.0:

    TCM v1.0c:

    TCM v1.0b:

    TCM V1.0a:

    TempCompMod V1.0:


    Known Issues Back to Top


    FAQ Back to Top


    Credits Back to Top

    The Crew
    Lead Programming, DesignAaron "Lotus" Everitt
    Programming, GraphicsAnthony "ono" Pilger
    Documentation, DesignJoël "dnx3" Moffatt
    Overlay DesignAdam "Heywood" Booth

    Contact info
    WWWhttp://ut2004.gameamp.com/ut2004/viewutcomp
    IRC#dz, on irc.enterthegame.com.[mirc6 link]

    Note that we are not online 24/7, and therefore cannot answer IRC questions at all times. We strongly recommend posting on the UTComp Forums on the UTComp webpage if you have questions or feedback.
    Documentation proudly written entirely in notepad.