Since I couldn't find any internet resource for this mutator (and thus no documentation), I made a little documentation myself and want to provide the mutator for other admins here.
I think it might be useful for Carnage and Cheshire too, because it can not just punish the killing of frozen players, but also reward it.
To check it out without prior downloading, I'll quote the documentation here (it's also incuded in the download below).
Thanks again to partydevil for pointing me to this!Omni3SPNv3Awards Version 1 release 7 for Unreal Tournament 2004
===============================================================
Note: This document was written by }TCP{Coco after having received
the necessary files from an install package of the redirected files
from the "Spawn of Chaos" Freon server. No documentation was
included, so I wrote this document myself, which contains the
information I could find out about it. Due to the fact that I didn't
actually make this mutator, you should be aware that this document
might be incomplete and/or contain incorrect information.
Purpose:
--------
This mutator is an addition to 3SPN's Freon gametype. It adds new
awards to the game (like the "hot sauce" award, for example, which
is being given to players who thaw a certain amount of teammates),
as well as extended functionality for the gameplay. Depending from
its configuration, it can be used to reward or punish players who
kill frozen enemies by pushing them into lava, into a portal (and
then walking through it and thus telefragging them), under a
stomper, next to an opening crate or a closing door, etc.
Installation:
-------------
Copy the files to their appopriate destination:
Omni3SPNv3Awards_v1r7.u -> System
Omni3SPNv3Awards_v1r7.ucl -> System
OmniBase_v1r7.u -> System
Omni3SPNAwardSounds_v1.uax -> Sounds
The Omni3SPNv3Awards come as a mutator, so you can add them to your
gamconfig entries (in case you use voteable gametypes on your server)
or directly to the mutator list of your server start-parameters using
the following classname: Omni3SPNv3Awards_v1r7.MutOmni3SPNv3Awards
Configuration:
--------------
When active, the mutator creates a section in your server.ini (or
UT2004.ini - whatever name you use) that contains several options you
can change with a text editor. You might as well manually add them to
your ini file prior to running it for the first time. To do so, simply
copy the entries given below and alter them according to your needs:
[Omni3SPNv3Awards_v1r7.MutOmni3SPNv3Awards]
FatalityTime=15
FatalityPoints=5
DamageHandling=DH_Normal
PunishmentType=PT_Random
ReplaceScoreboards=True
MaxFrozenPlayerAbuse=0
AbuseWarnings=I wouldn't keep doing that if I were you...
AbuseWarnings=You have a really bad feeling about this...
AbuseWarnings=That is going to end badly for you eventually...
Explanation of the options:
FatalityTime:
After a player froze another player, he gets a chance to kill him in
a certain timeframe and thus to get extra points for it. This option
sets the length of that timeframe (in seconds). The player will get
an info in the game and see a countdown for it. Note: If you don't
want to reward players for killing frozen enemies, you can disable
this feature by setting this value to 0.
FatalityPoints:
Declares the amount of points given to a player for killing a frozen
enemy within the fatality time (see option above). Set to 0 if you
don't want to reward players for this.
DamageHandling:
I don't really know what this is good for. I found these legal values
in the code: DH_Normal, DH_TeammatesOnly and DH_PunishAbusers. I
suppose, it somehow configures how damage that is being done to a
player (who e.g. is being pushed into lava) is applied. According to
this, the setting would mean:
DH_Normal - the normal way (i.e. player in the lava gets the damage)
DH_TeammatesOnly - the teammates of the player in the lava get damage
DH_PunishAbusers - the player who pushed gets the damage
PunishmentType:
There are several ways how a player, who killed a frozen enemy can be
punished. The possible values for this setting are:
PT_SwapPlaces - the killing player swaps places with his victim
PT_Telefrag - the killing player is being telefragged
PT_ThawTeam - the entire enemy team of the killing player is thawed
PT_Kill - the killing player is being killed himself
PT_Random - any of the above (randomly selected every time)
ReplaceScoreboards:
Apparently, the standard Freon scoreboard can be replaced or extended
by this mutator. In my tests, I couldn't see anything when setting
this to 'True', so I suppose it only works with an older version of
Freon. Because there's no benefit of this option, I suggest setting
this to 'False' to avoid any problems.
MaxFrozenPlayerAbuse:
This option sets the maximum amount of abuses (i.e. killing a frozen
player) allowed for the game. If a player has less or equal as many
abuses as the value set here, he will get a warning message (see
AbuseWarnings option below). Only if the amount of abuses is larger
than this value, the punishment action defined under PunishmentType
(see above) is applied. Note: Setting this to 0 will disable player
punishment. Setting it to 1 will result in one warning before the
player is being punished when abusing again. Thus, punishing without
a warning isn't possible!
AbuseWarnings:
You can define the text of the warnings given to an abusive player
here. This option can be given multiple times to define a sequence
of warnings prior to the punishment. However, this depends from the
MaxFrozenPlayerAbuse setting (see above). If it is set to 2, for
example, only the first 2 warnings will be displayed, regardless how
many messages you define here.
FatalityZones:
The mutator will add several of these lines itself when playing
various maps. These lines define areas in certain maps that are good
to kill a frozen enemy. Whenever a player freezes an enemy in such
an area, the mutator will incite him to kill his enemy with the
method given in this line. You don't need to care about this option
at all - the mutator will do this automatically. You can take a look
at the server.ini after having played some maps, if you're curious
about it. Note: The mutator will not incite to kill if it's
configured to punish abusive players!
Annotations:
------------
This mutator can be used together with the Cuddles extension for
Freon, which was made by Piglet. But since Cuddles also modifies the
scoreboard, I strongly recommend to disable the ReplaceScoreboards
option of the Omni3SPNv3Awards mutator (as written above). Otherwise,
the behaviour of the game could possibly become unpredictable and the
game might even crash. This is just a warning. In fact, I didn't
observe any problems when activating the ReplaceScoreboards option
together with Cuddles. But since this option doesn't seem to work
anymore, there's absolutely no reason to do so.
Weblinks:
---------
Omnip)o(tents clan webpage (creators of this mutator):
http://www.omnipotents.com/
}TCP{ clan webpage:
http://www.tcpclan.net
Spawn of Chaos clan webpage (where I got these files from):
http://spawnofchaos.webs.com/index.htm
Titan servers forum link for the Cuddles Freon extension:
http://ut2004.titaninternet.co.uk/forum ... 71&t=16616
Coco.
