Description

This package contains the Mutator SBMutatorFastWarShell for Unreal Tournament (UT99).

What it does

With my default INI settings every Redeemer fired by a Bot or Player has the high speed of 3000 instead of the default 600, a launch sound and message are broadcasted to the players and also a message is broadcasted if the projectile is destroyed by someone.

Comprehensive Description

If a WarHeadLauncher enters the game, the Mutator changes its projectiles if it has the default ones ("WarShell"/"GuidedWarshell"). Depending on the INI settings of bReplaceAllProjectileClasses and bReplaceAllAltProjectileClasses, projectiles are also replaced, if they are not the default ones.
When the weapon is fired - what means a projectile is spawned - the Mutator checks the instigator of the projectile: If it is one of the ValidWeaponInstigators, the speed of the projectile is set to the value of ProjectileSpeed given in the INI file. Also an optional launch sound is played, and a launch message as well as a message if the projectile was destroyed by someone can be broadcasted. Nothing is changed, if the instigator is not one of the desired, for example if it is an UMSSpaceMarine.
You can define up to eight ValidWeaponInstigators classes in the INI file for which these changes should be applied. Sub classes of these Actors are also included.

Ini file values

All settings are adjustable by editing the configuration file SBMutatorFastWarShell.ini. The settings are explained below.

Section SBMutatorFastWarShell

This section is for the Mutator itself.
Namedata typedefault valuedescription
bDebugboolfalseset it to TRUE for logging what Mutator does
bTreatWarHeadLauncherSubClassesboolfalseset it to TRUE for treating sub classes of WarHeadLauncher also
bReplaceAllProjectileClassesboolfalseset to TRUE if also other projectiles types beside Class'WarShell' should be replaced (see Projectile Replacements also)
bReplaceAllAltProjectileClassesboolfalseset to TRUE if also other projectiles types beside Class'GuidedWarShell' should be replaced (see Projectile Replacements also)

Section SBWarShell

This section is for the WarShell.
Namedata typedefault valuedescription
bDebugboolfalseset it to TRUE for logging what Mutator does
ValidWeaponInstigators[0]name"PlayerPawn"apply projectile modifications if instigator is a PlayerPawn
ValidWeaponInstigators[1]name"Bots"apply projectile modifications if instigator is a Bots
ValidWeaponInstigators[2]name"Bot"apply projectile modifications if instigator is a Bot
ValidWeaponInstigators[3...7]name(not defined)
ProjectileSpeedfloat3000Speed of projectile. Should be equal or below ProjectileMaxSpeed.
ProjectileMaxSpeedfloat10000Maximum speed of projectile (a WarShell is accelerated). Should be equal or above ProjectileSpeed.
LaunchMessagestring"%k fired a Redeemer"If not empty, this message is broadcasted on firing. See String Replacements also.
LaunchSoundNamestring"SBIncomingSndsV0.NuclearLaunchDetected"If not empty, this sound is loaded and played for every player on firing.
ProjectileHealthbyte5If damage above this value is applied to the projectile, it gets destroyed.
bApplyFullDamagebooltrueApply full damage to a hit actor? Otherwise Actors with a huge collision cylinder won't be hurt by the explosion shock wave.
Destroymessagestring"%o destroyed %k's Redeemer"If not empty, this message is broadcasted if the projectile is destroyed. See String Replacements also.
UnknownDestroyerNamestring"Someone"In case the projectile destroyer is already removed from level (imagine an already killed Brute, but his still flying rocket destroys the projectile), this name will be used instead of destroyer's name.
bDestroyedBroadcastMsgboolfalseDisplay the Destroymessage as a normal broadcast message (that messages in the text box on top of HUD).
bDestroyedBroadcastMsgCriticalbooltrueDisplay the Destroymessage as a critical broadcast message (usually screen centered message).

Section SBGuidedWarShell

This section is for the guided WarShell.
Namedata typedefault valuedescription
bDebug(same as in SBWarShell)
ValidWeaponInstigators(same as in SBWarShell)
ProjectileSpeedfloat600Speed of the projectile. The maximum speed for it is set by code to the same value because this projectile does not accelerate.
Warning: changing this value does not work proper on net play: projectile speed of client and server are different what results in stutting. I recommend not to change this if you use it on a server.
LaunchMessagestring"%k started guiding a Redeemer"(same as in SBWarShell)
LaunchSoundName(same as in SBWarShell)
ProjectileHealth(same as in SBWarShell)
bApplyFullDamagebooltrue(same as in SBWarShell)
Destroymessagestring"%o destroyed %k's guided Redeemer"(same as in SBWarShell)
UnknownDestroyerName(same as in SBWarShell)
bDestroyedBroadcastMsg(same as in SBWarShell)
bDestroyedBroadcastMsgCritical(same as in SBWarShell)

String Replacements

The following replacements are done in some strings:
%khuman readable name of projectile instigator
%ohuman readable name of destroyer
Due to execution speed (and safety: image a player has the name "Pe%ky") only the first occurence of each is replaced. The letter case is respected (that means that %K or %O won't get replaced).

Sounds

The package comes with the three sounds NuclearLaunchDetected, SS_Incoming and Male2_Incoming in the file SBIncomingSndsV0.uax.
If you want one of these or another sound that is played for all players if the WarShell or GuidedWarshell is launched, enter the name of the sound in the ini file in the form Packagename.Soundname.
Example: LaunchSoundName="SBIncomingSndsV0.NuclearLaunchDetected"

If you run this Mutator locally, every sound should work. If you run it on a server, make sure that the sound package is available for the client (see ServerPackages below) and that the package does not have the flag "ServerSideOnly" - some stock files have it.

To disable sound, set the corresponding ini values to an empty string.

Pitfalls

Projectile Replacements

I left it as an option for the user to decide if sub classes of WarHeadLauncher are treated also - maybe a sub class has some code that relies on having a specific projectile class and will fail if that projectile is replaced. I recommend to stay with the default settings. With these settings only stock stuff is treated and things will work as expected.

Update

If you have a previous version of SBMutatorFastWarShell installed, you should remove the existing files SBMutatorFastWarShell*.* in the System folder of your UT installation before installing this version.

Installation (Client and Server)

Put the files into the System folder of your UT installation. Change the values in SBMutatorFastWarShell.ini to your needs. If you want to use the sound package, add SBIncomingSndsV0.uax to the Sounds folder.

Installation on a Server

Installation on a Client

Start UT and choose the Mutator "SB Fast Redeemer Version 5" for a local game.

About

Autor

Name: Barbie
Contact: SeriousBarbie AT barbies DOT world

Copyright

This package is copyleft - do whatever you want.

Changelog

SBMutatorFastWarShell-V5, release 22 Mar 2023

Filelist
NameSizeDateMD5 sum
./Help/SBMutatorFastWarShell-Readme.htm230272023-03-22(this file)
./Sounds/SBIncomingSndsV0.uax3113672017-03-2601c776a21d2b9bedd72da16f33362bdd
./Sourcecode/Classes/SBGuidedWarShell.uc67192019-03-09c760c2ddc40d31fee4fd2393ed910a1c
./Sourcecode/Classes/SBMutatorFastWarShell.uc97832023-03-22bee8d651e329baa696c7daecea6e4594
./Sourcecode/Classes/SBWarShell.uc64812023-03-22bc371e165afcc980b934db5bbda6aacb
./Sourcecode/make.ini3362023-03-229f3250ca86ecd58e1b7090d6045aa6cf
./Sourcecode/readme.txt692016-01-0965e1642a4cd5f397e424d0521cca2d42
./Sourcecode/Sounds/Male2_Incoming.wav85062016-01-113514f3d101ba4970b4805051197a3b7f
./Sourcecode/Sounds/NuclearLaunchDetected.wav1803242015-09-1112dc6a7ced08c637ef316303cf70668a
./Sourcecode/Sounds/SS_Incoming.wav1222202016-01-11d2a942b31339808eb30f887d7552009b
./System/SBMutatorFastWarShell.ini11752019-03-031fcdbfb36eb04516899b5d1c80cab39a
./System/SBMutatorFastWarShell-V5.int2082019-03-0306f6d791e2d85f24bf297f908f4979bb
./System/SBMutatorFastWarShell-V5.u379292023-03-22e7f91b5028327297bff7ab3609c64079
./testing/Maps/TestSBMutatorFastWarShell.unr132362019-03-09102b7edd9fec455ab7bc8b38797229a7
./testing/RunTestmap.cmd2872023-03-22f30927bd5f26be8861b9b4fc6f5c4085
./testing/Sounds/marine.uax16887962006-10-204d71c18fe510ec2b514e154eb25bd29b
./testing/System/Adrenaline.u797582014-05-31ccd5efdcf9a57e5585eb13b1877a292c
./testing/System/umsspacemarine.u70658082013-06-11de066cc9064611eef019560162e692be

SBMutatorFastWarShell-V4, release 13 Apr 2017

Filelist
NameSizeDateMD5 sum
./Help/SBMutatorFastWarShell-Readme.htm195562017-04-13d50df16bc16ed07e640d8792a9e5e6f3
./Sounds/SBIncomingSndsV0.uax3113672017-03-2601c776a21d2b9bedd72da16f33362bdd
./Sourcecode/Classes/SBGuidedWarShell.uc60412017-04-055ae1ebe01626ff190926322c857f4acf
./Sourcecode/Classes/SBMutatorFastWarShell.uc96622017-03-28a182a04c82efa8302159472a38fa52b7
./Sourcecode/Classes/SBWarShell.uc51012017-04-04ced675abad589c1e460aba253bbdfed0
./Sourcecode/make.ini3222016-08-02a3d2527314eebb04084c7cc876f9fed9
./Sourcecode/readme.txt692016-01-0965e1642a4cd5f397e424d0521cca2d42
./Sourcecode/Sounds/Male2_Incoming.wav85062016-01-113514f3d101ba4970b4805051197a3b7f
./Sourcecode/Sounds/NuclearLaunchDetected.wav1803242015-09-1112dc6a7ced08c637ef316303cf70668a
./Sourcecode/Sounds/SS_Incoming.wav1222202016-01-11d2a942b31339808eb30f887d7552009b
./System/SBMutatorFastWarShell.ini11292017-04-053acb5e5827b0e0768ade1e4d9038597b
./System/SBMutatorFastWarShell-V4.int2082017-04-02e903c37eeb7ff65d2d6553030c4ebefb
./System/SBMutatorFastWarShell-V4.u342742017-04-048e299343f380cc9f602624dd66f9c5cf
./testing/Maps/TestSBMutatorFastWarShell.unr82812017-03-262c5ac41fa6620896da498780f06823cf
./testing/RunTestmap.cmd2832017-03-269c2df14fd4d49ff2e04e9a4e44dc0983
./testing/Sounds/marine.uax16887962006-10-204d71c18fe510ec2b514e154eb25bd29b
./testing/System/umsspacemarine.u70658082013-06-11de066cc9064611eef019560162e692be

SBMutatorFastWarShell-V3, no public release

Filelist
NameSizeDateMD5 sum
./Help/SBMutatorFastWarShell-Example/Sounds/SBIncomingSnds.uax1309882016-01-1147f18660ee0e0f9c0b4a0465514a2bb2
./Help/SBMutatorFastWarShell-Example/System/SBMutatorFastWarShell.ini892016-01-112dc7fcd5b74013c8c728536a4a7aa953
./Help/SBMutatorFastWarShell-Readme.txt68622016-07-302ab343175ec7b9a98e3fce9a2f0641b9
./redirect/SBMutatorFastWarShell-V3.u.uz1800492016-07-307593e2e64872fc7251554b47083fe853
./SBMutatorFastWarShell-md5sums.txt11822016-01-11934ec0d4958a098527ed3b1786ebb7bd
./Sourcecode/Classes/SBGuidedWarShell.uc40772016-01-134da967eff2da2db2c1941e8ed36b04bb
./Sourcecode/Classes/SBMutatorFastWarShell.uc89512016-07-302232c87b05c3ee43add45867831d7e13
./Sourcecode/Classes/SBWarShell.uc19432016-01-115a3e3fad7bbdde5cdb7c93986a7dacd9
./Sourcecode/copyleft.txt972015-10-02ae5e178649b00957f4fe7af70b13bc75
./Sourcecode/make.ini3222016-07-2193fb3041b0dd83ca8a2e0eb20853da80
./Sourcecode/readme.txt692016-01-0965e1642a4cd5f397e424d0521cca2d42
./Sourcecode/Sounds/Male2_Incoming.wav85062016-01-113514f3d101ba4970b4805051197a3b7f
./Sourcecode/Sounds/NuclearLaunchDetected.wav1803242015-09-1112dc6a7ced08c637ef316303cf70668a
./Sourcecode/Sounds/SS_Incoming.wav1222202016-01-11d2a942b31339808eb30f887d7552009b
./System/SBMutatorFastWarShell.ini18232016-07-2120cae3b1692d46a6114c936364fdd959
./System/SBMutatorFastWarShell-V3.int1502016-01-086ba13ac9189b24e3467d1b97770a130d
./System/SBMutatorFastWarShell-V3.u2051152016-07-3016de78d4a63ee1267165b0f6dbffaff1

SBMutatorFastWarShell-Rev2, 02 Oct 2015

Filelist
NameSizeDateMD5 sum
./copyleft.txt972015-10-02ae5e178649b00957f4fe7af70b13bc75
./Make.cmd21932015-10-101d808e4be88a0a619a2b0a1432413bb7
./md5sums.txt3742015-09-171533179ef5ca8b9cc05d0cb8ee555109
./Readme.txt29732015-10-023d27576e2eab2a43d0cb27b4f23ec09c
./redirect/SBMutatorFastWarShell-Rev2.u.uz1711762015-10-107885b73157ee7258575726397f2f7eec
./Sourcecode/Classes/SBGuidedWarShell.uc12332015-10-022116661ac501c963fabe2483fdf6e10e
./Sourcecode/Classes/SBMutatorFastWarShell.uc5962015-10-0224132da27ecfdb5e99d71e762fd4ed60
./Sourcecode/Classes/SBWarShell.uc22272015-10-1021098b9ab3da5d8ce4e315cdd7c8fac6
./Sourcecode/make.ini6262015-10-03e461bdc9ab46b803731a800964c1c00b
./Sourcecode/Sounds/NuclearLaunchDetected.wav1803242015-09-1112dc6a7ced08c637ef316303cf70668a
./System/SBMutatorFastWarShell.ini6672015-10-04f1f8005bc55a198b0552651f06899d49
./System/SBMutatorFastWarShell-Rev2.int1472015-10-010465864d9f54f48f3d1f945fd407690d
./System/SBMutatorFastWarShell-Rev2.u1881002015-10-10a4dd80af28c026306b70f1fdab34c520

SBMutatorFastWarShell-Rev1, 17 Sep 2015

Filelist
NameSizeDateMD5 sum
./md5sums.txt3742015-09-171533179ef5ca8b9cc05d0cb8ee555109
./Readme.txt23602015-09-1737108b87a5cb0a5d08cd22d4bf2d8b25
./redirect/SBMutatorFastWarShell.u.uz1692702015-09-17193b5fa6f7eb6f030fa976ec4039ee9b
./Sourcecode.7z1612122015-09-17be19887b569ffd202d5175c7f12fd6fb
./System/SBMutatorFastWarShell.ini5572015-09-173e675cc1f1473afa660f741ec6b4e77a
./System/SBMutatorFastWarShell.int1342015-09-1637ce310a88ee6e7c97fc73ab35f66f42
./System/SBMutatorFastWarShell.u1848942015-09-179d5180c2cc1d4b4533d4ebe48e68a08e

SBMutatorFastWarheadLauncher, 29 Aug 2015

first release