==============================================================================
Shuffle Powerups   --   Mutator   --   Unreal Tournament 3
==============================================================================

Title           : Shuffle Powerups
Version         : 1.0
Release Date    : 2026-07-08
Website         : https://jncressey.github.io
Author          : JNCressey

==============================================================================

--- Mutator Information ---

This mutator randomly replaces the powerups at the start of a match. 

There is a configuration option to lower the frequency that they are re-shuffled, so that the same replacements are done for multiple matches.

==============================================================================

--- Installation ---

Extract .\UTGame into your game directory:
- "C:\Users\YourName\Documents\My Games\Unreal Tournament 3"

==============================================================================

--- Configuration ---

If you want to change these configuration settings, you can edit the file at "C:\Users\YourName\Documents\My Games\Unreal Tournament 3\UTGame\Config\UTShufflePowerupsMutator.ini"

Find the setting name you want to change and edit the value after the equal sign.



-- ReshuffleFrequency --
How often you want to reshuffle for a new set of replacements.
It can take the following values:
	CF_EveryMatch
	CF_EverySession
	CF_EveryHour
	CF_EveryDay
	CF_EveryMonday
	CF_EveryTuesday
	CF_EveryWednesday
	CF_EveryThursday
	CF_EveryFriday
	CF_EverySaturday
	CF_EverySunday
	CF_EveryMonth
The CF_EverySession option means that, when playing back-to-back matches without returning to the menu, the matches will have the same set of replacements.
Default is CF_EveryMatch

-- IncludeTimedPowerups --
Whether to shuffle timed powerups such as the UDamage.
This value can be true or false.
Default is true.

-- ShuffleTimedPowerupsSerparately --
If this is set to true, the timed powerups (such as the UDamage) will be shuffled among themselves, separately to the other powerups being shuffled.
This value can be true or false.
Default is false.

-- IncludeDeployables --
Whether to shuffle deployables such as the shaped charge.
This value can be true or false.
Default is true.

-- ShuffleDeployablesSerparately --
If this is set to true, the deployables (such as the shaped charge) will be shuffled among themselves, separately to the other powerups being shuffled.
This value can be true or false.
Default is false.

-- IncludeShieldBelt --
Whether to include the Shield Belt in the shuffle.
This value can be true or false.
Default is true.

-- IncludeSuperHealth --
Whether to include the Big Keg o' Health in the shuffle.
This value can be true or false.
Default is true.

-- IncludeJumpBoots --
Whether to include the Jump Boots in the shuffle.
This value can be true or false.
Default is false.

-- IncludeEmpMine -- 
Whether to include the EMP Mine in the shuffle. And if so, whether to always include it or to only include it in vehicle gamemodes. (The vehicle gamemode check is done by whether the map name begins with "WAR-" or "VCTF-".)
It can take the following values:
	CV_DontShuffle,
	CV_AlwaysShuffle,
	CV_ShuffleIfVehicleGamemode,
Default is CV_ShuffleIfVehicleGamemode

-- IncludeAvril --
Whether to include the Longbow AVRiL in the shuffle. And if so, whether to always include it or to only include it in vehicle gamemodes. (The vehicle gamemode check is done by whether the map name begins with "WAR-" or "VCTF-".)
It can take the following values:
	CV_DontShuffle,
	CV_AlwaysShuffle,
	CV_ShuffleIfVehicleGamemode,
Default is CV_ShuffleIfVehicleGamemode

-- IncludeRedeemer --
Whether to include the Redeemer in the shuffle. And, if timed powerups or deployables are being shuffled separately, whether to include it in their separated shuffle pool.
It can take the following values:
    CR_DontShuffle,
    CR_WithCommonPool,
    CR_WithTimedPowerups,
    CR_WithDeployables
Default is CR_WithCommonPool

==============================================================================