Legacy:Mutator (UT) - Revision history

213.46.33.10 at 08:50, 11 November 2017

2017-11-11T08:50:51Z

Draconx: *

2005-10-25T15:47:50Z

New page

{{classbox| [[Legacy:UT|UT]] :: [[Legacy:Actor (UT)|Actor (UT)]] >> [[Legacy:Info (UT)|Info (UT)]] >> Mutator (Package: Engine)}}

An actor designed to modify smaller aspects of the game. For an overview of how the Mutator system, see [[Legacy:Mutator Topics|Mutator Topics]].

See [[Legacy:Linked List/Existing Lists In Unreal Tournament|Linked List/Existing Lists in Unreal Tournament]] for a thorough description of the different mutator types (including how to make a working HUD mutator).

See [[Legacy:Mutator|Mutator]] for the UT2003 version of this class.

==Properties ==
; Mutator NextMutator : The next mutator in the mutators linked list.
; Mutator NextDamageMutator : The next registered damage mutator. These mutators receive MutatorTakeDamage calls from [[Legacy:Pawn (UT)|Pawn (UT)]]s.
; Mutator NextMessageMutator : The next registered message mutator. Message mutators receive MutatorTeamMessage, MutatorBroadcastMessage and MutatorBroadcastLocalizedMessage calls.
; Mutator NextHUDMutator : The next registered HUD mutator. Mutators can only be registered to one [[Legacy:HUD (UT)|HUD (UT)]]. However HUDs work client-side, so a HUD mutator can be registered to one HUD on the first client or the server and to another HUD on another client.
; bool bHUDMutator : If this variable is true the mutator was successfully registered as HUD mutator on this client/server.
; class<[[Legacy:Weapon (UT)|Weapon (UT)]]> DefaultWeapon : A weapon class that should replace the default weapon (usually the impact hammer).

==Functions ==

Most mutator functions (except ReplaceWith, RegisterHUDMutator, CheckReplacement and MyDefaultWeapon) call the corresponding function of the next mutator in the list.
; PostRender ([[Legacy:Canvas (UT)|Canvas (UT)]] Canvas) [simulated] : Called by the [[Legacy:HUD (UT)|HUD (UT)]] when this mutator is registered as HUD mutator. Always call NextHUDMutator.PostRender(Canvas) to allow the next HUD mutator to draw on the canvas.
; ModifyPlayer ([[Legacy:Pawn (UT)|Pawn (UT)]] Other) : Called by the [[Legacy:GameInfo (UT)|GameInfo (UT)]]'s AddDefaultInventory function which is called by RestartPlayer and AcceptInventory.
; bool HandleRestartGame ( ) : This function is never called anywhere in script. Nowhere. It is serving no other purpose than to add a couple of bytes to the Engine.U package. Completely useless...
; bool HandleEndGame ( ) : This is called when the GameInfo wants to end the game. If the mutator returns True, the Game will not attempt to Set the end cams. If it does return true, the code should either execute its own implementation of the gameinfo.SendEndCams() function or set bOverTime to true to force the game into overtime...
; bool HandlePickupQuery ([[Legacy:Pawn (UT)|Pawn (UT)]] Other, [[Legacy:Inventory (UT)|Inventory (UT)]] item, out byte bAllowPickup) : This is similar to the [[Legacy:Inventory (UT)|Inventory (UT)]]'s HandlePickupQuery function. Return true handle the pickup query from this function or deny pickup.
; bool PreventDeath ([[Legacy:Pawn (UT)|Pawn (UT)]] Killed, [[Legacy:Pawn (UT)|Pawn (UT)]] Killer, name damageType, vector HitLocation) : Called by the killed pawn's Died function. If the function returns True it should set the pawn's health to a value greater than 0.
; ModifyLogin (out class<[[Legacy:PlayerPawn|PlayerPawn]]> SpawnClass, out string Portal, out string Options) : Called from the GameInfo's LogIn function. The mutator can change any options before the LogIn function processes them.
; ScoreKill ([[Legacy:Pawn (UT)|Pawn (UT)]] Killer, [[Legacy:Pawn (UT)|Pawn (UT)]] Other) : Called by the GameInfo's ScoreKill function.
; Class<[[Legacy:Weapon (UT)|Weapon (UT)]]> MutatedDefaultWeapon ( ) : Returns which weapon should be used as default weapon. You shouldn't modify this function. Use the DefaultWeapon property instead.
; Class<[[Legacy:Weapon (UT)|Weapon (UT)]]> MyDefaultWeapon ( ) : Use by the MutatedDefaultWeapon function. Returns the DefaultWeapon property of this mutator or (if DefaultWeapon is None) the DefaultWeapon of the GameInfo.
; AddMutator (Mutator M) : Adds another mutator to the list of mutators. If NextMutator is None it is set to M, otherwise NextMutator.AddMutator(M) is called.
; bool ReplaceWith ([[Legacy:Actor (UT)|Actor (UT)]] Other, string aClassName) : Intended to use in CheckReplacement. ReplaceWith replaces an actor ''Other'' with a new one of the class specified in aClassName.
; bool AlwaysKeep ([[Legacy:Actor (UT)|Actor (UT)]] Other) : Called by the [[Legacy:GameInfo (UT)|GameInfo (UT)]]'s IsRelevant function. If it returns true neither the GameInfo nor any mutator will try to remove the actor. In this case no mutator receives a CheckReplacement call for this actor.
; bool IsRelevant ([[Legacy:Actor (UT)|Actor (UT)]] Other, out byte bSuperRelevant) : Also called by the [[Legacy:GameInfo (UT)|GameInfo (UT)]]'s IsRelevant function. It calls the CheckReplacement function, so you don't need to modify IsRelevant.<br />If bSuperRelevant is set to 1 the [[Legacy:GameInfo (UT)|GameInfo (UT)]] will not modify the actor (generally running filter tests). If IsRelevant returns false the actor will be destroyed.
; bool [[Legacy:CheckReplacement|CheckReplacement]] ([[Legacy:Actor (UT)|Actor (UT)]] Other, out byte bSuperRelevant) : Called by IsRelevant() to determine whether the actor should be available within the game or not. If this function returns ''true'' for every mutator within the mutator chain then the actor will be kept within the game. If '''any''' of the mutators within the mutator chain return ''false'' then the actor will be removed. You can replace actors by using ReplaceWith() and then return false.
; Mutate (string MutateString, [[Legacy:PlayerPawn|PlayerPawn]] Sender) : With this function mutators are able to handle console commands. (e.g. "mutate tossrelic", MutateString then is "tossrelic")
; MutatorTakeDamage(out int ActualDamage, [[Legacy:Pawn (UT)|Pawn (UT)]] Victim, [[Legacy:Pawn (UT)|Pawn (UT)]] InstigatedBy, out Vector HitLocation, out Vector Momentum, name DamageType) : Called by the victim's take damage function if the mutator is a registered damage mutator. (Done via [[Legacy:GameInfo (UT)|GameInfo (UT)]].RegisterDamageMutator(Self); from within the mutator.)<br />This is called after the [[Legacy:GameInfo (UT)|GameInfo (UT)]] and the victim's [[Legacy:Inventory (UT)|Inventory (UT)]] items had the chance to reduce the damage.
; bool MutatorTeamMessage ([[Legacy:Actor (UT)|Actor (UT)]] Sender, [[Legacy:Pawn (UT)|Pawn (UT)]] Receiver, [[Legacy:PlayerReplicationInfo|PlayerReplicationInfo]] PRI, coerce string S, name Type, optional bool bBeep) : Called by the Say and TeamSay functions of PlayerPawn (= Sender). The message will be sent eventually if all message mutators return True.
; bool MutatorBroadcastMessage ([[Legacy:Actor (UT)|Actor (UT)]] Sender, [[Legacy:Pawn (UT)|Pawn (UT)]] Receiver, out coerce string Msg, optional bool bBeep, out optional name Type) : Called by the BroadcastMessage function of the sending actor. The message mutator can change the string and the message type. Only if all message mutators return true the message will be sent to Receiver.
; bool MutatorBroadcastLocalizedMessage ([[Legacy:Actor (UT)|Actor (UT)]] Sender, [[Legacy:Pawn (UT)|Pawn (UT)]] Receiver, out class<[[Legacy:LocalMessage (UT)|LocalMessage (UT)]]> Message, out optional int Switch, out optional [[Legacy:PlayerReplicationInfo (UT)|PlayerReplicationInfo (UT)]] RelatedPRI_1, out optional [[Legacy:PlayerReplicationInfo (UT)|PlayerReplicationInfo (UT)]] RelatedPRI_2, out optional [[Legacy:Object|Object]] OptionalObject) : Called by the BroadcastLocalizedMessage function of the sending actor. The message mutator can change all aspects of the message. Only if all message mutators return true the message will be sent to Receiver.
; RegisterHUDMutator ( ) [simulated] : Registers this mutator as a HUD mutator if the local [[Legacy:PlayerPawn|PlayerPawn]] (the PlayerPawn with a HUD) exists. bHUDMutator is set to True after successfully registering the HUD mutator. See [[Legacy:Useful Mutator Functions|Useful Mutator Functions]] for details.

==Known Subclasses ==
* [[Legacy:Arena|Arena]]
* [[Legacy:ChainsawMelee|ChainsawMelee]]
* [[Legacy:DMMutator|DMMutator]]
* [[Legacy:FatBoy|FatBoy]]
* [[Legacy:InstantRockets|InstantRockets]]
* [[Legacy:JumpMatch|JumpMatch]]
* [[Legacy:LowGrav|LowGrav]]
* [[Legacy:NoPowerups|NoPowerups]]
* [[Legacy:NoRedeemer|NoRedeemer]]
* [[Legacy:Stealth|Stealth]]
:
* [[Legacy:Relic|Relic]]
* [[Legacy:HUDMutator|HUDMutator]] (used as base class for the relic HUD mutator) – '''Don't use this! Prefer breaking compatibility with the relic HUD mutator instead of breaking compatibility with any other HUD mutator. See [[Legacy:Relics_Patch|Relics_Patch]] for restoring compatibility without using this subclass.'''
* [[Legacy:EnhancedItems|EnhancedMutator]] ([[Legacy:EnhancedItems|EnhancedItems]])

----

'''Tarquin:''' probably a dumb question... is it possible to embed a mutator in a map so that it is included automatically when the map is played?

'''Wormbo:''' Should be possible with this code: <uscript>
function PreBeginPlay()
{
Level.Game.BaseMutator.AddMutator(Self);
}</uscript>It might not be able to replace map actors, but I wouldn't consider that being a problem in this particular case.

'''Mychaeel:''' Alright... you were faster. (Damn. ;-))

'''Dawn:''' I have developed a robust, generic Embedded Mutator and written a tutorial to accompany it. Go here to check it out: [[Legacy:Writing And Using An Embedded Mutator|Writing and Using an Embedded Mutator]]. Hope someone finds it useful!

[[Category:Legacy Class (UT)|{{PAGENAME}}]]

Ramx: *

2005-04-16T01:58:35Z

Ramx: *

2005-04-16T01:56:56Z

@@ Line 21: / Line 21: @@
 ; ModifyPlayer ([[Legacy:Pawn (UT)|Pawn (UT)]] Other) : Called by the [[Legacy:GameInfo (UT)|GameInfo (UT)]]'s AddDefaultInventory function which is called by RestartPlayer and AcceptInventory.
 ; bool HandleRestartGame ( ) : This function is never called anywhere in script.  Nowhere.  It is serving no other purpose than to add a couple of bytes to the Engine.U package.  Completely useless...
-; bool HandleEndGame ( ) : This is called when the GameInfo wants to end the game.  If the mutator returns True, the Game will not attempt to Set the end cams.  If it does return true, the code should either execute its own implementation of the gameinfo.SendEndCams() function or set bOverTime to true to force the game into overtime...
+; bool HandleEndGame ( ) : This is called when the GameInfo wants to end the game.  If the mutator returns True, the Game will not attempt to Set the end cams.  If it doesn't return true, the code should either execute its own implementation of the gameinfo.SendEndCams() function or set bOverTime to true to force the game into overtime...
 ; bool HandlePickupQuery ([[Legacy:Pawn (UT)|Pawn (UT)]] Other, [[Legacy:Inventory (UT)|Inventory (UT)]] item, out byte bAllowPickup) : This is similar to the [[Legacy:Inventory (UT)|Inventory (UT)]]'s HandlePickupQuery function. Return true handle the pickup query from this function or deny pickup.
 ; bool PreventDeath ([[Legacy:Pawn (UT)|Pawn (UT)]] Killed, [[Legacy:Pawn (UT)|Pawn (UT)]] Killer, name damageType, vector HitLocation) : Called by the killed pawn's Died function. If the function returns True it should set the pawn's health to a value greater than 0.
@@ Line 31: / Line 31: @@
 ; bool ReplaceWith ([[Legacy:Actor (UT)|Actor (UT)]] Other, string aClassName) : Intended to use in CheckReplacement. ReplaceWith replaces an actor ''Other'' with a new one of the class specified in aClassName.
 ; bool AlwaysKeep ([[Legacy:Actor (UT)|Actor (UT)]] Other) : Called by the [[Legacy:GameInfo (UT)|GameInfo (UT)]]'s IsRelevant function. If it returns true neither the GameInfo nor any mutator will try to remove the actor. In this case no mutator receives a CheckReplacement call for this actor.
-; bool IsRelevant ([[Legacy:Actor (UT)|Actor (UT)]] Other, out byte bSuperRelevant) : Also called by the [[Legacy:GameInfo (UT)|GameInfo (UT)]]'s IsRelevant function. It calles the CheckReplacement function, so you don't need to modify IsRelevant.<br />If bSuperRelevant is set to 1 the [[Legacy:GameInfo (UT)|GameInfo (UT)]] will not modify the actor (generally running filter tests). If IsRelevant returns false the actor will be destroyed.
+; bool IsRelevant ([[Legacy:Actor (UT)|Actor (UT)]] Other, out byte bSuperRelevant) : Also called by the [[Legacy:GameInfo (UT)|GameInfo (UT)]]'s IsRelevant function. It calls the CheckReplacement function, so you don't need to modify IsRelevant.<br />If bSuperRelevant is set to 1 the [[Legacy:GameInfo (UT)|GameInfo (UT)]] will not modify the actor (generally running filter tests). If IsRelevant returns false the actor will be destroyed.
 ; bool [[Legacy:CheckReplacement|CheckReplacement]] ([[Legacy:Actor (UT)|Actor (UT)]] Other, out byte bSuperRelevant) : Called by IsRelevant() to determine whether the actor should be available within the game or not.  If this function returns ''true'' for every mutator within the mutator chain then the actor will be kept within the game.  If '''any''' of the mutators within the mutator chain return ''false'' then the actor will be removed.  You can replace actors by using ReplaceWith() and then return false.
 ; Mutate (string MutateString, [[Legacy:PlayerPawn|PlayerPawn]] Sender) : With this function mutators are able to handle console commands. (e.g. "mutate tossrelic", MutateString then is "tossrelic")