Team Damage mutator for UT2004 v1.07

From T. Rus, aka "+++crowbar+++" 2005, West Germany
E-mail: crowbar666@gmx.net

  1. Features
  2. Change log
  3. Installation
  4. Configuration
  5. Console commands

Features
So, for what the f**k is this mutator for?

  • Simple, "Call of Duty"-style damage reflection mutator for UT 2004.
  • This mutator deals with team-killers in the way, that the damage the team-killer attempts to commit to his team mate is mirrored back to himself. How much of the damage will be mirrored can be defined by the variable TransferScaling. There's also an option which defines if a killer shall die instantly, when he kills a team mate.
  • Mirrored damage can be scaled when using SuperShokRifle.
  • Team killer, which commit more team-kills than allowed, can be:
    • Kicked from the server
    • Banned from the server (be carefull with this option!)
    • Temporary banned from the server: the player will be banned only for the rest of the running match. When a new match starts, the player can reconnect to the server, but until then, the team-killer has to wait. This will give the team killer some time to think about his foolish game style and let the admin have an easy time ;-)
  • Completly configurable through UT console. No ini-file editing necessary any more.
  • Works with:
    • DeathMatch: No (of course)
    • TeamDeathMatch: Yes
    • CaptureTheFlag: Yes
    • Instagib CTF: Yes
    • Onslaught: Yes, but when in vehicle, damage committed to vehicle, not to player. If vehile "dies" --> player will also die.
    • DoubleDomination: Yes
    • BombingRun: Yes
    • Assault: Not tested yet

Change log
v1.08:

  • Changed: version number
  • Changed: position of warning messages

v1.07:

  • Added: mirrored damage to killer can be scaled, when using SuperShokRifle or ZoomSuoerShokRifle.
  • Fixed: removed bug in KickKiller function.

v1.06:

  • Added: mutator is now fully configurable through the console.
  • Changed: colours of warning message set to red, default message to whithe

v1.05:

  • Added: Kick-option. Team killer, who committs more team-kills than defined in iMaxTeamKills can be kicked, banned or temporary banned from the server.
  • Added: Kick- and ban-warning message
  • Changed: package name for "DamageReflection" to "TeamDamage".

v1.03:

  • Fixed: found out, that SuperShokRifle and ZoomSuperShokRifle have different damage types. Therefore using SuperShokRifle instead of ZoomSuperShokRifle caused still spamming of server log with access none warnings. This is now fixed.
  • Added: bKillKiller option, so that it can be defined if a killer will survive his violence to his team mate ;-)

v1.02:

  • Fixed: missing package error, damn!!! ;-)

v1.01:

  • Fixed: using the SuperShokRifle will not spam the server log with access none warnings any more.
  • Added: bInstagibSurvive will let the victim survive a SuperShokRifle shot, but kill the shooter.

v1.00:

  • Initial release

Installation

  1. Unpack the files and copy them to the system folder of your UT2004 installation.
  2. Edit the server.ini file and add the following to the [Engine.GameEngine] section (because of LocalizedMessage):
    ServerPackages=TeamDamage107v
  3. Restart server.
  4. Start server with UCC-command, e.g.:
    ucc server DM-Antalus.ut2?Game=xGame.xTeamGame?bAuroNumBots=True?Mutator=TeamDamage107v.TeamDamage107v log=server.log
    or:
    Select mutator in WebAdmin page
  5. For offline gaming or dedicated servers, simply select "Team Damage v1.07" from mutator list in UT2004.

Configuration
 NOTE: FRIENDLY FIRE MUST BES SET TO A VALUE BIGGER THAN ZERO TO MAKE THIS MUTATOR WORK. I RECOMMEND THE VALUE 1.0

The configuration settings for this mutator can be modified with the file TeamDamage.ini

  • EnableDamageReflection
    This one is self explainig, isn't it? Setting this option to false, will completely disable the mutator. Default = True
  • TransferScaling
    This parameter defines how much of the committed damage will be split to the shooter or the victim. A value of 0.0 splits the damage to 100% to the victim, 0% to the shooter, like friendly fire without mutator. A value of 1.0 splits the damage to 0% to the victim, and 100% to the shooter. Default value is 0.5, what means 50% of the damage is committed to both, victim and shooter. Default = 1.0
  • bInstagibSurvive
    This value will let a vicim survive a SuperShokRifle shot, like FriendlyFire = 0, but kill the shooter. Default = False.
  • iInstagibSelf
    This value defines the amount of damage, that will be mirrored back to the killer, when using SuperShokRifle or ZoomSuperShokRifle e.g. in instagib matches. Setting the value of this parameter to zero will disable this function and instantly kill the killer --> instagib!
  • bKillKiller
    This value will define if a killer should be killed for killing a team mate. bKillKiller = True --> killer will be killed. Default = True
  • bKickTeamKiller
    This option will make the team killer be kicked from the server, when more than iMaxTeamKills are comitted. Setting this value to False will completely disable the kick and kickban function! Default = True
  • bTemporaryBanTeamKiller
    Temporary banned from the server: the player will be banned only     for the rest of the running match. When a new match starts, the player can reconnect to the server, but until then, the team-killer has to wait. This will give the team killer some time to think about his foolish game style and let the admin have an easy time ;-) Default = False
  • bBanTeamKiller
    This option will make the team killer be     PERMANENTLY banned from the server, when more than iMaxTeamKills are comitted. This punishment can only be undone by an admin who has access to the server.ini (or ut2004.ini). So be carefull with this one! Default = False
  • iMaxTeamKills
    Defines the maximum of allowed team kills, before a team killer will be kicked/kickbanned. Default = 5
  • iWarningLevel
    Defines the number of team kills, when the team killer get's a warning message, like "Stop team-killing or you will be kicked!" This value should be smaller than iMaxTeamKills. Default = 4
  • bLogging
    Enable/disable logging to server log file. Only kick/kickban actions will be logged. Default = True

Console Commands
Open the console and login as a server administrator.

Next, type into the console (without the quotation marks):

  • "mutate teamdamage" or "mutate td"
    What you see is a list of available commands to modify the mutator functions.
  • To see, which configuration is actually set on the server, type:
    "mutate teamdamage list" or "mutate td list"
  • To change a configuration parameter value, e.g. activate or deactivate the DamageReflection, type:
    "mutate teamdamage damageref on" or "mutate td damageref off"
  • To see the actual parameter set to a configuration variable type:
    "mutate teamdamage ?"

Some other examples:

  • mutate td damageref ON
  • mutate td killkiller ON
  • mutate td tempbantk ON
  • mutate td banteamkiller OFF
  • mutate td maxteamkills 5
  • mutate td warninglevel 4
  • mutate td transferscaling 0.5
  • ...