UE3:Mutator (UT3)

From Unreal Wiki, The Unreal Engine Documentation Site
UT3 Object >> Actor >> Info >> Mutator
Package:
Engine
Direct subclass:
UTMutator
This class in other games:

Mutator.

Mutators allow modifications to gameplay while keeping the game rules intact. Mutators are given the opportunity to modify player login parameters with ModifyLogin(), to modify player pawn properties with ModifyPlayer(), or to modify, remove, or replace all other actors when they are spawned with CheckRelevance(), which is called from the PreBeginPlay() function of all actors except those (Decals, Effects and Projectiles for performance reasons) which have bGameRelevant==true. Copyright 1998-2008 Epic Games, Inc. All Rights Reserved.

Properties

Property group 'Mutator'

GroupNames

Type: array<string>

list of groups this mutator is in. Mutators that share any group cannot be activated simultaneously

Internal variables

bUserAdded

Type: bool


NextMutator

Type: Mutator


Default values

Subobjects

Sprite

Class: Engine.SpriteComponent

Inherits from: Info.Sprite

No new values.

Functions

Events

Destroyed

event Destroyed ()

Overrides: Actor.Destroyed


PreBeginPlay

event PreBeginPlay ()

Overrides: Actor.PreBeginPlay


Other instance functions

AddMutator

function AddMutator (Mutator M)


AllowBecomeActivePlayer

function bool AllowBecomeActivePlayer (PlayerController P)


AllowBecomeSpectator

function bool AllowBecomeSpectator (PlayerController P)


AllowChangeTeam

function bool AllowChangeTeam (Controller Other, out int num, bool bNewTeam)


AlwaysKeep

function bool AlwaysKeep (Actor Other)


CanLeaveVehicle

function bool CanLeaveVehicle (Vehicle V, Pawn P)


CheckRelevance

function bool CheckRelevance (Actor Other)


CheckReplacement

function bool CheckReplacement (Actor Other)

Returns true to keep this actor

DriverEnteredVehicle

function DriverEnteredVehicle (Vehicle V, Pawn P)


DriverLeftVehicle

function DriverLeftVehicle (Vehicle V, Pawn P)


GetSeamlessTravelActorList

function GetSeamlessTravelActorList (bool bToEntry, out array<ActorActorList)

called on the server during seamless level transitions to get the list of Actors that should be moved into the new level PlayerControllers, Role < ROLE_Authority Actors, and any non-Actors that are inside an Actor that is in the list (i.e. Object.Outer == Actor in the list) are all automatically moved regardless of whether they're included here only dynamic (!bStatic and !bNoDelete) actors in the PersistentLevel may be moved (this includes all actors spawned during gameplay) this is called for both parts of the transition because actors might change while in the middle (e.g. players might join or leave the game)

Parameters:

  • bToEntry - true if we are going from old level -> entry, false if we are going from entry -> new level
  • ActorList - out) list of actors to maintain

GetServerDetails

function GetServerDetails (out Info.ServerResponseLine ServerState)


GetServerPlayers

function GetServerPlayers (out Info.ServerResponseLine ServerState)


InitMutator

function InitMutator (string Options, out string ErrorMessage)

This function can be used to parse the command line parameters when a server starts up

IsRelevant

function bool IsRelevant (Actor Other)


ModifyLogin

function ModifyLogin (out string Portal, out string Options)


ModifyPlayer

function ModifyPlayer (Pawn Other)


Mutate

function Mutate (string MutateString, PlayerController Sender)


MutatorIsAllowed

function bool MutatorIsAllowed ()


NotifyBecomeActivePlayer

function NotifyBecomeActivePlayer (PlayerController Player)


NotifyBecomeSpectator

function NotifyBecomeSpectator (PlayerController Player)


NotifyLogin

function NotifyLogin (Controller NewPlayer)


NotifyLogout

function NotifyLogout (Controller Exiting)


NotifySetTeam

function NotifySetTeam (Controller Other, TeamInfo OldTeam, TeamInfo NewTeam, bool bNewTeam)


ParseChatPercVar

function string ParseChatPercVar (Controller Who, string Cmd)