• If you downloaded the zip version:
  • Extract the contents of the .zip file to your /UT2004 main folder. Make sure to keep the folder structure.
  • Press F5 the first time you join a UTComp server to configure and save your UTComp settings.
  • Press F5 and click on the ready button to start the game.
• If you downloaded the ut4mod version:
  • Extract the contents of the .zip file anywhere on your hard drive.
  • Double Click the .ut4mod file, and follow the onscreen instructions.
  • Press F5 the first time you join a UTComp server to configure and save your UTComp settings.
  • Press F5 and click on the ready button to start the game.

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

• If you downloaded the zip version, and your server is updated to version 3204 or higher:
  • Extract the contents of the .zip file to your /UT2004 main folder. Make sure to keep the folder structure.
  • Load the mutator, either with webadmin, with the "host game" interface, or by adding ?Mutator=utcompv13rc1.MutUTComp to your server command line.
  • Reading the Basic Server Setup section is highly recommended.
• If you downloaded the ut4mod version, (not recommended for servers) and your server is updated to version 3204 or higher:
  • Extract the contents of the .zip file anywhere on your hard drive.
  • Double Click the .ut4mod file, and follow the onscreen instructions.
  • Load the mutator, either with webadmin, with the "host game" interface, or by adding ?Mutator=utcompv13rc1.MutUTComp to your server command line.
  • Reading the Basic Server Setup section is highly recommended.
• If you downloaded the zip version, and your server is running the release 3186 version:
  • Extract the contents of the .zip file to your /UT2004 main folder. Make sure to keep the folder structure.
  • In your server ini, (ut2004.ini by default) add the following line anywhere in the [Engine.GameEngine] section:

    ServerPackages=utcompv13rc1

  • Load the mutator, either with webadmin, with the "host game" interface, or by adding ?Mutator=utcompv13rc1.MutUTComp to your server command line.
  • Reading the Basic Server Setup section is highly recommended.
• If you downloaded the ut4mod version, (not recommended for servers) and your server is running the release 3186 version:
  • Extract the contents of the .zip file anywhere on your hard drive.
  • Double Click the .ut4mod file, and follow the onscreen instructions.
  • In your server ini, (ut2004.ini by default) add the following line anywhere in the [Engine.GameEngine] section:

    ServerPackages=utcompv13rc1

  • Load the mutator, either with webadmin, with the "host game" interface, or by adding ?Mutator=utcompv13rc1.MutUTComp to your server command line.
  • Reading the Basic Server Setup section is highly recommended.

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.

• Skins
  • UTComp has two Brightskin types: Bright Epic Style Skins and UTComp Style Skins. Both brightskins types can be disabled by the server. That server setting can also be voted in the Voting menu by players.
  • A potentially confusing setting is the Base on Enemy/Teammate checkbox. By default, this checkbox is not clicked, which means that you can set a Brightskin color for players on the Red Team, and a different color (preferrably!) for players on the Blue Team. If you enable Base on Enemy/Teammate, you can set up colors for Teammates and Enemies, regardless of whether you're in the Blue or Red team.
  • There are really no "better" settings for skin colors. Just make sure to pick colors that don't blend in with the walls too much for the maps you frequently play, as this might make players hard to see.
• Colors
  • UTComp fully supports Colored Names and Colored text/death messages. The system to set up your colored name uses a slider to select a letter, and three sliders for color. Basically, you move the letter selection slider under your name to the letter for which you want to change colors, and then select a color from the bottom color sliders.
  • You can also select where you want colored names to be displayed from the upper checkboxes.
• Models
  • UTComp models lets you force players on a team to a specific player model, so that they all look the same. Just like in brightskins, a Base on Enemy/Teammate checkbox is provided, if you want to set player models for Teammates and Enemies, instead of Red and Blue teams.
  • Recommended settings are to enable Base on Enemy/Teammate, and then setting a large player model for enemies, such as Gorge, and a small one for teammates, such as Sapphire. This adds more visual feedback to differentiate Teammates and Enemies than brightskin color only.
• Hitsounds
  • Hitsounds play a "beep" sound when you hit an enemy, giving the player additional feedback to help know when you hit. (especially useful from very long ranges)
  • CPMA Style Hitsounds change the hitsound pitch depending on how much damage the shot did. This is recommended, as it brings additional audio feedback to tell how much damage a rocket or flak ball did, as opposed to merely guessing from the distance.
  • Servers can disable hitsounds entirely if they wish. This can also be voted on and off by players on the voting menu, like the Brightskins settings.
  • If you don't want hitsounds, you can simply turn the Hitsounds Volume down to 0.
• Voting
  • UTComp's voting options complement epic's voting by adding a few useful features for competitive play.
  • Every voting options can be disabled by the server, if the server admin doesnt want players to be able to change specific settings.
  • Voting for Double Damage or Warmup Mode requires a map restart. Brightskins Mode and Hitsounds Mode take effect instantly.
  • If another player calls a vote, you hear a sound and receive a message telling you to vote. Press F5 to vote Yes or No. If you do not vote, your vote is counted as a No.
• Miscellaneous
  • "Stats" lets you select two different ways to display the player statistics on the scoreboard. If you click in the checkbox, there will be one table on the left to show stats on primary firing modes (shock primaries, link plasma, etc.) and one on the right to show secondary firing modes. (shock balls, link beam, etc.) If that checkbox is disabled, both firing modes are combined into a single table.
  • Auto Demo Recording and Auto Screenshots will automatically take demos and screenshots of every UTComp game you play. This is useful for players who want to keep track of every game they play.

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 "Unreal Tournament 2004" server setup guide, this info if UTComp specific. I recommend reading the Unreal Admin Page tutorials if you want to know anything not UTComp related.

Warning: This version of UTComp is recommended for servers updated to version 3204 or higher. You can download the windows patch from BeyondUnreal. It is still possible to use UTComp on a version 3186 server, but most of the testing has been done using version 3204, therefore using this version of UTComp on a version 3186 server is not supported.

1- Installing the files

• If you downloaded the zip version:
  • Extract the contents of the .zip file to your /UT2004 main folder. Make sure to keep the folder structure.
• If you downloaded the ut4mod version (not recommended for servers):
  • Extract the contents of the .zip file anywhere on your hard drive.
  • Double Click the .ut4mod file, and follow the onscreen instructions.

2- Optional for version 3186 servers only: Modifying your server ini

Adding a Serverpackage line to your server's ini file is absolutely required for UTComp to work properly on a version 3186 server. If you fail to add that line, players will freeze on the loading time when they try to connect. 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=utcompv13rc1

Note that if you're hosting your server on linux, the ServerPackages line is case sensitive, which means if you write ServerPackages=UtCoMpV13rC1, 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.3 RC1" in the mutator list.
2. Using Webadmin, in the Mutators section, click in "UTComp version 1.3 RC1" and restart the map.
3. Using Webadmin, in the Server console section, type in servertravel DM-DE-Ironic?Mutator=utcompv13rc1.MutUTComp
4. In game, log in as admin, and type in admin servertravel DM-DE-Ironic?Mutator=utcompv13rc1.MutUTComp
5. On the server command line, add in ?mutator=utcompv13rc1.MutUTComp

Some of the basic UTComp server settings can be configured directly in Webadmin. If you don't use Webadmin on your server, the settings are all listed in the [utcompv13rc1.MutUTComp] section, in your server ini. This section will not appear until you've started your server at least once. There are many more server settings available, those are listed in the Server Full Command list section.

• Enable Double Damage

  This is called bEnableDoubleDamage in your server ini. Setting this to false, or unchecking it in webadmin, removes the double damage from the game. This is a popular 1v1 setting.

• Enable Serverside Demo-Recording

  This is called bEnableServerDemorec in your server ini. Setting this to true, or checking it in webadmin, will make the server automatically record serverside demos of every game played. This is useful for big lan tournaments, that want to record demos of all of their games, without having to type in demorec in the server console for every match played.

• Enable Warmup

  This is called bEnableWarmup in your server ini. Setting this to false, or unchecking it in webadmin, turns off warmup entirely.

• Brightskins Mode

  This is called ServerSideEnableBrightskins in your server ini. Setting this to 0 disable brightskins entirely, setting it to 1 enables bright Epic skins, and setting it to 2 enables full UTComp skins.

• Hitsounds Mode

  This is called ServerSideEnableHitSounds in your server ini. Setting this to 0 disables hitsounds entirely, setting it to 1 enables full hitsounds, and 2 enables line-of-sight hitsounds. Line-of-sight hitsounds will not make a "beep" sound if a player cannot see the enemy when his shot hit an enemy. (This is mostly noticeable with rockets spammed down hallways)

• Voting Max Players

  This is called maxServerPlayers in your server ini. This setting limits the player's ability to call a vote that changes maxplayers higher than the number defined. This is very useful for rented servers: if for example you pay for a 10 player server, you set this to 10, and players will not be able to call a vote that sets maxplayers higher than 10.

Player Console Commands

• echo

  Allows you to print a message on your screen, useful for scripts. For example, echo hello world! would print hello world! on the player's screen.

• mymenu

  Opens the UTComp F5 menu

• notready

  Used to remove yourself from "ready" state, in warmup mode. When every player has typed in ready, the game starts.

• ready

  Used to notify the server that you're ready, when in warmup mode. When every player has typed in ready, the game starts.

• setvolume

  Allows modification of the main game volume from 0 to 1.

• voteno

  Votes No on the current UTComp vote (does't work with Epic's map/kick vote)

• voteyes

  Votes Yes on the current UTComp vote (does't work with Epic's map/kick vote)

• gotoitem #

  Moves the spectator's viewpoint to a specific powerup. The accepted values are:

  50 = Shield Pack +50
  50a = Shield Pack +50
  small = Shield Pack +50
  100 = Super Shield Pack +100
  100a = Super Shield Pack +100
  large = Super Shield Pack +100
  amp = Double Damage
  dd = Double Damage
  double = Double Damage

• gotoplayer #

  Moves the spectator's viewpoint to a specific player, defined by a number.

• nextblueplayer

  Moves the spectator's viewpoint to the next player in the blue team.

• nextnode

  Moves the spectator's viewpoint to the next powernode. Powercores also count as powernodes.

• nextredplayer

  Moves the spectator's viewpoint to the next player in the red team.

• prevnode

  Moves the spectator's viewpoint to the previous powernode. Powercores also count as powernodes.

• Skins/Models
  UTComp brightskins allow you to set bright colored skins to players, to increase visibility. By default, Epic has included "Brightskins" in the game already, but those are quite complicated to set up, (you have to change several options in your ut2004.ini and user.ini) and frankly aren't all that bright. There are two brightskins styles in UTComp: Bright Epic Style skins, which take the regular Epic Brightskins but makes them much brighter, or UTComp Style skins, which allow you to select brightskins color with Red/Green/Blue sliders. Note that in gametypes that aren't team based (deathmatch), players will show as the Red color if you use Red/Blue based skins, or as the Enemy color if you use Teammate/Enemy based skins.
  • Use UTComp skins
    • Allows enabling or disabling of UTComp Style Skins. If UTComp skins are disabled client side, "Bright Epic Style Skins" will be used instead.
  • Base on Enemy/Teammate
    • If checked, you can set a color for your own team, and a color for the enemy team, regardless of whether they are on the blue or red team. If unchecked, you can set a color for the red team, and a color for the blue team.
  • Red Team Color (if Use UTComp skins is enabled)
    • Allows the player to set a specific color for the Red Team's bodies, using Red/Green/Blue sliders. If Base on Enemy/Teammate is enabled, this section changes to "Teammate Color" and allows you to set a color for your Teammates.
  • Blue Team Color (if Use UTComp skins is enabled)
    • Allows the player to set a specific color for the Blue Team's bodies, using Red/Green/Blue sliders. If Base on Enemy/Teammate is enabled, this section changes to "Enemy Color" and allows you to set a color for the enemies.
  • Red Team Color (if Use UTComp skins is disabled)
    • Allows you to select a Bright Epic Style Skins color (Red, Blue or Purple) for the Red Team. If Base on Enemy/Teammate is enabled, this section changes to "Teammate Color" and allows you to set a color for your Teammates.
  • Blue Team Color (if Use UTComp skins is disabled)
    • Allows you to select a Bright Epic Style Skins color (Red, Blue or Purple) for the Blue Team. If Base on Enemy/Teammate is enabled, this section changes to "Enemy Color" and allows you to set a color for the enemies.
  
  
• Colors
  Colored names in UTComp use an "override" system, which basically ignores what your actual name is. To set colors, you set specific colors to letters in your name, for example, you set your first letter to red, your second to blue, and so on. When you change your actual name, (either through the setname console command or in UT2004 menus) the color scheme stays. You can also use colors in actual typed messages, through color codes.
  • Use Colors on:

    Selects what should be colored by color codes. This is intended for very slow pc's, where colored text might bring a noticeable fps hit. The options are:

    • In-Game Messages: This will show colored names in text messages and death messages.
    • Red/Blue DeathMsgs: Changes the colors on the death messages to show red or blue depending on the team the players are on, instead of showing their colored name.
    • Scoreboard: This will show colored names on the scoreboard.
    • Q3 Style Color Codes: This will display colors in messages that players type, based on "color codes" that you type in your messages. To make it work, you use the ^ character and a number. For example, if you wanted to say "Hello World!", you would press your say key, and type ^1Hello ^4World!. Everything that appears after the color code will use that color. The colors are:

      0 = Black

      1 = Red

      2 = Green

      3 = Yellow

      4 = Dark Blue

      5 = Pink

      6 = Light Blue

      7 = White

  • Letter Selection
    • Allows the selection, through a slider, of the letter for which you want to change color.
  • Letter Color
    • Allows the player to set a specific color for the letter selected above, in Red/Green/Blue format.
  • Reset Colors
    • Resets every letter to the default white setting.
  
  
• Models
  Forcemodels allows you to lock the models on teammates and enemies to a specific player model, regardless of what model those players picked. Just like brightskins, models can be set on a red team/blue team basis, or on a Teammate/enemy basis. "Epic Force models" can be set without the UTComp mutator through ini file modification, but it's got two major drawbacks: You can't use every model built in the game, and you can't force a different model for teammates and for enemies. UTComp's forcemodel implementation allows for both. Note that in gametypes that aren't team based (deathmatch), players will always show up on the Blue/Enemy Model..
  • Enable Forcemodel
    • Enables or disables Forcemodel. (duh)
  • Forcemodel on Enemy/Teammate basis
    • If checked, you can set a model that will show for teammates, and a model that will show for enemies, regardless of whether they're in the Red or Blue teams. If unchecked, you can set a model for players on the red team, and for players on the Blue Team.
  • Red Team Model
    • Allows you to set a model for the players on the Red Team. If Forcemodel on Enemy/Teammate Basis. is enabled, this changes to "Teammate model" and allows you to set a model for teammates.
  • Blue Team Model
    • Allows you to set a model for the players on the Blue Team. If Forcemodel on Enemy/Teammate Basis. is enabled, this changes to "Enemy model" and allows you to set a model for enemies.
  
  
• Hitsounds
  Hitsounds are a feature that play a "beep" type sound when you succesfully hit an enemy with any weapon. Line of sight hitsounds only play when you can see the enemy on your screen, while regular hitsounds will play even if you fire a rocket down a hallway randomly, and hit an opponent 15 seconds later while you're in a completely different part of the level.Optionally, CPMA type hitsounds can be enabled, which modify the "beep" sound pitch depending on how much damage a shot you fired did to the enemy. For example, a minigun bullet does very little damage, and plays a very high pitched sound, while a lightning gun headshot would play a low pitched sound due to the very high damage. (Think about double damage+redeemer...) This is especially useful for splash-damage weapons whose damage isnt constant, (grenades, shock cores/combos, flak balls, rockets) as you can guess from the sound how much damage you've done. (As opposed to having to guess from the distance of the hit relative to the enemy's position)
  • Hitsound Volume
    • Allows the player to set how loud hitsounds should play. To completely disable hitsounds clientside, set this to zero.
  • CPMA Style Hitsounds
    • Enables or disables hitsounds that change pitch according to the damage the shot did, as described above in the Hitsounds description
  • Pitchmodifier
    • Allows modification of the Pitch on CPMA hitsounds. The higher the scroll bar, the higher the pitch modification.
  • Friendly Hitsound Fike
    • For custom friendly hitsounds. Type in the name of the sound file in packagename.nameofsound format.
  • Enemy Hitsound File
    • For custom enemy hitsounds. Type in the name of the sound file in packagename.nameofsound format.
  
  
• Voting
  UTComp's voting system allows players to vote on gametypes, along with maxplayers, as well as Enabling or Disabling server side brightskins, server side hitsounds, warmup mode and double damage. When a player calls a vote, the other players get a message to indicate a vote is in progress, and can vote yes or no to the proposed changes by pressing F5. If a majority vote yes, the changes are applied.
  • Change Map
    • Changes to a new map.
  • Change Gametype
    • Changes to a new gametype and map. You can select a gametype from the drop down list, type in a map name (required), and select maxplayers. The number to the right of the maxplayers box is the maximum players allowed on the server. If you try to vote to something higher, it will default to that number.
  • Brightskins Mode
    • Changes the server's brightskins setting. The choices are Brightskins disabled, Bright Epic Style Skins, and UTComp Style Skins. This takes effect instantly.
  • Hitsounds Mode
    • Changes the server's hitsounds setting. The choices are disabled, enabled Everywhere, and Line-of-sight only. This takes effect instantly.
  • Warmup Mode
    • Changes the server's warmup mode from unlimited warmup to disabled warmup. If the server uses time-limited warmup, "enabled" goes to time-limited warmup instead of unlimited warmup. This requires a map restart after the vote passed.
  • Double Damage
    • Enables or disables the double damage. This requires a map restart after the vote passed.