Dual Wielding is a mutator for UT2004 designed to allow each player to dual-wield any two of the weapons they own. For example, it is possible, however illogical, to use the Shield Gun's shield and the Assault Rifle's rapid fire or grenades at the same time.

The Dual Weapon

The Dual Weapon is a virtual weapon given to each player. The Dual Weapon is what allows a player to wield two weapons at once.

Weapon Restrictions

The player/server admin can restrict which weapons may be dual-wielded. See Weapon Restrictions for more information.

Key-Bindings

The default configuration requires at least two key-bindings. These are used in combination with other keys to control the dual-wielded weapons. If you have not bound these keys, you will be asked at the start of the match to bind some temporary keys (this can be disabled.)

See Controls for more information.

2. Installation

Copy or move the following files into your UT2004\System directory:

· DualWield.u

· DualWield.int

· DualWield.ucl

For UT2004RPG compatibility (optional), also copy the following file into UT2004\System:

· DualWield_RPG.u

3. Options

Dual Wielding can be configured three ways:

· Before starting a game, by pressing Configure Mutators after adding it to the mutator list.

· During the game, using the Open Config In-Game key (or by typing Mutate DualWieldConfig into the console.)

· By editing the DualWield.ini file (advanced.)

The configuration interface has three tabs: Options, Weapons and Controls. The Options tab includes:

Misc

Allow Akimbo Weapons

If enabled, players will be able to pick up two identical weapons to dual-wield. (Normally you cannot pick up two weapons of the same class.)

Disable Dual Assault Rifles

If enabled, picking up a second Assault Rifle won't enable 'dual mode', thus preventing you from dual-wielding the Assault Rifle with other weapons. (This also applies to the Enforcer and ChaosUT2 CPP.)

Encourage Bot Dual-Wielding

If enabled, the Dual Weapon will get a rating boost to increase the likelihood of bots dual-wielding.

Firing

Disallow Zoom

Prevent zoom fire-modes from being selected. Note that this does not disable zoom when using the extra fire-buttons or Easy Zoom option.

Merge Akimbo Weapons

If enabled, Fire and AltFire control primary and alternate fire for both weapons when both weapons are identical. (Normally, Fire and AltFire control the left and right weapon respectively.)

Spaced Firing

If enabled, firing will alternate between akimbo weapons, instead of both firing simultaneously. This is always enabled for modes with colliding projectiles (e.g. Shock Rifle alt-fire.)

This option only affects akimbo weapons, and when Merge Akimbo Weapons is enabled.

HUD

Display Fire-Modes

If enabled, each weapon's selected fire-mode will be displayed on the HUD (near the crosshair.)

Auto-Switch Ammo Display

If enabled, the ammo counter on the HUD will automatically show the ammo for the last weapon fired.

Weapon Name Fade Time

How long the weapon names displayed on the HUD take to fade out. Specify 0.00 to always show the weapon names.

Zoom Render Weapon

This option affects which weapon is rendered while you are zoomed-in (with a sniper weapon.)

Neither – Don't render either weapon or sniper HUD while zoomed in.

Always Left – Always render the left weapon or its sniper HUD while zoomed in.

Always Right – Always render the right(-hand) weapon or its sniper HUD while zoomed in.

Always Both – Always render both weapons while zoomed in.

First Sniper – Render only one weapon while zoomed in, preferring a sniper weapon if you have one. (Recommended)

Controls

Single-Button Mode

Enable this if you want to bind only one key for dual-wielding. In Single-Button mode, the dual-wielding control key (either left or right) toggles dual-wielding mode. When in dual-wielding mode, the usual weapon-switching keys (mouse wheel, number keys, etc.) apply to your preferred hand (usually the right hand.) Holding a dual-wielding control key forces weapon-switching keys to apply to the other hand (usually the left hand.)

Entering or exiting dual-wielding mode gives the appearance of simply taking out or putting away the second weapon. You can continue to fire your main weapon while switching between dual- and single-wielding modes.

Tip: If you want to put down your main weapon instead of the second weapon you took out, switch your handedness from right to left (or left to right) using a key-binding (SetWeaponHand Left and SetWeaponHand Right) before exiting dual-wielding mode.

Toggle Fire-Mode w/ Control

If enabled, pressing & releasing the left/right dual-wielding control key toggles the selected fire-mode for the left/right weapon.

This option is not available when Single-Button Mode is enabled.

Set Fire-Mode w/ Control+Fire

If enabled:

· Left Weapon Control + Fire/AltFire sets the active fire-mode for the left weapon.

· Right Weapon Control + Fire/AltFire sets the active fire-mode for the right weapon.

If Single-Button Mode is enabled, the following option is available instead of this one.

Toggle Fire-Mode w/ Control+Fire

If enabled, hold a dual-wielding control key and press:

· Fire to toggle the active fire-mode for the left weapon.

· AltFire to toggle the active fire-mode for the right weapon.

Only available when Single-Button Mode is enabled.

Easy Weapon-Switching

If enabled, holding a dual-wielding control key causes weapon-switching keys (usually the mouse wheel and number keys) to apply to the left or right hand.

For example, hold Left Weapon Control and press 4 to put a Shock Rifle in your left hand.

Easy Zoom

If enabled, holding a dual-wielding control key and pressing AltFire while wielding a Sniper weapon activates zoom.

This option is not available when Single-Button Mode is enabled.

Easy Throw-Weapon

If enabled, you can quickly throw your left- or right-hand weapon by holding a dual-wielding control key and pressing your ThrowWeapon key.

Middle-Mouse = SwitchToBest

If enabled, the middle mouse button acts like a SwitchToBestWeapon key while you are holding a dual-wielding control key.

Sub-Weapon Command Keys

Here you can add or remove key aliases for third-party weapon support. For example, if your left-hand weapon can be reloaded, add Reload to the sub-weapon command keys list, then hold the Left Weapon Control key and press reload to reload your left-hand weapon.

Commands listed here must be exactly the same as the alias which is bound to the key.

4. Weapon Restrictions

Maybe you want to realistically restrict which weapons can be dual-wielded, or maybe some weapons just don't work well with dual-wielding. Dual Wielding allows you to define which weapons can or cannot be dual-wielded. Weapon Restrictions can be configured through the Dual Wielding Configuration screen, on the Weapons tab.

Profiles

At the top of the screen are controls for manipulating profiles. Preset profiles cannot be modified, renamed or deleted.

To view or edit a profile, select it from the “Profiles” drop-down list at the top-left corner of the screen.

· To add a custom profile, type a name for it in the “Name” box and click Add.

· To rename the current profile, type the new name and and click Rename.

· To delete the current profile, click Del.

Weapon Groups

Restrictions are applied to weapons via “Weapon Groups”. Each weapon group may contain many weapons, and has an associated display name, restriction, and filter.

To create a group, ensure you have a non-Preset profile selected, then select <New Weapon Group> from the Weapon Groups list. Changing any weapon group properties (name, restriction, filter, or selected weapons) will automatically create the new group.

There are three types of groups/restrictions:

· Disallowed – Weapons in disallowed groups may not be dual-wielded.

· Mutually Exclusive – Weapons in these groups may not be dual-wielded with other weapons in the same group, but they may be dual-wielded with weapons in other groups.

· Allowed – When Exclude Mode is enabled, weapons in these groups may be dual-wielded. (Otherwise all weapons are allowed by default.)

Additionally, a filter can be applied to each weapon in a group, to decide whether the group should apply to it. For example, if the filter is bDualMode=True and the group is a disallowed group, any weapons in it may not be dual-wielded while bDualMode equals True. (This is how to prevent Dual Assault Rifles from being dual-wielded with other weapons.)

In addition to “=” (equals), “<” (less than), “>” (greater than), and “><” (text contains) may also be used. Operators can be prefixed with “!”, meaning “Not”. For example, bDualMode!=False means the group restriction will apply to each weapon in the group if bDualMode is not equal to False.

Multiple filters can be specified by seperating each one with a “;” (semicolon). For example: bDualMode=True;AmmoCharge[0]>0

Weapons

To place weapons in a group, double-click a weapon or package in the Available Weapons group. (Double-clicking a package puts all weapons from that package into the group.)

Profile Options

Exclude Mode

If enabled, weapons are disabled by default - use Allowed and/or Mutually Exclusive groups to allow dual-wielding for specific weapons.

Strict Naming

If enabled, sub-class weapons won't automatically be included wherever their base is included. For example, if the Ion Painter is in a “Disabled” group, the Onslaught Target Painter is automatically disabled when Strict Naming is disabled, but not if Strict Naming is enabled.

5. Controls

See Controls Configuration below for a full list of bindable keys, and where to bind them.

Default

The default control style requires two extra key-bindings: Control Left Weapon and Control Right Weapon. These act as modifiers for other keys, letting you control the left- or right-hand weapon (depending on which Control*Weapon key you press) while dual-wielding. The following keys behave differently while a dual-wielding control key is pressed:

KEY	NEW ACTION
Fire (usually left mouse button)	Sets the primary fire-mode as active for the left- or right-hand weapon.
Alt-Fire (usually right mouse button)	Sets the alternate fire-mode as active for the left- or right-hand weapon.
Next Weapon (usually mouse wheel up)	Weapon Selection Select weapons to wield in your left or right hand.
Prev Weapon (usually mouse wheel down)
Best Weapon (default is G)
Weapon Selection (SwitchWeapon <num>) (usually the number keys)
Throw Weapon (default is backslash)	Throw the weapon currently held in the left or right hand.
Grow Hud (usually equals/plus)	Changes the Zoom Render Weapon option. (See Options: HUD.)
Shrink Hud (usually minus/underscore)	Toggles the Display Fire-Modes option. (See Options: HUD.)

KEY

NEW ACTION

Fire

(usually left mouse button)

Sets the primary fire-mode as active for the left- or right-hand weapon.

Alt-Fire

(usually right mouse button)

Sets the alternate fire-mode as active for the left- or right-hand weapon.

Next Weapon

(usually mouse wheel up)

Weapon Selection

Select weapons to wield in your left or right hand.

Prev Weapon

(usually mouse wheel down)

Best Weapon

(default is G)

Weapon Selection (SwitchWeapon <num>)

(usually the number keys)

Throw Weapon

(default is backslash)

Throw the weapon currently held in the left or right hand.

Grow Hud

(usually equals/plus)

Changes the Zoom Render Weapon option. (See Options: HUD.)

Shrink Hud

(usually minus/underscore)

Toggles the Display Fire-Modes option. (See Options: HUD.)

Note that if you hold both control keys at once, you can perform the same action on both hands simultaneously. For example, hold both control keys and press 4 to take out akimbo Shock Rifles (if Allow Akimbo Weapons is enabled; see Options.)

Also note that these key overrides can be enabled or disabled through the Dual Wielding configuration screen.

Single-Button Mode

In Single-Button mode (see Options: Controls), the keys listed above automatically apply to your preferred hand (depends on your handedness setting). Holding either control key lets you control the opposite hand. This makes it completely plausible to dual-wield with only one extra key-binding. The following keys act slightly differently, however:

KEY	NEW ACTION
Fire (usually left mouse button)	Toggles the active fire-mode for the left-hand weapon.
Alt-Fire (usually right mouse button)	Toggles the active fire-mode for the right-hand weapon.

KEY

NEW ACTION

Fire

(usually left mouse button)

Toggles the active fire-mode for the left-hand weapon.

Alt-Fire

(usually right mouse button)

Toggles the active fire-mode for the right-hand weapon.

Controls Configuration

Dual-wielding controls can be configured in three places:

· The standard UT2004 “Configure Keys” interface, under “Dual Wielding”.

· The window that pops up automatically at the start of a match when you have no keys bound.

· The Dual Wielding configuration screen, either through “Configure Mutators” or the in-game config key (which can only be set through the Dual Wielding configuration screen :-P).

Key-bindings available to all three include:

KEY	ACTION
Control Left Weapon	In combination with other keys, these let you control the left- or right-hand weapon (see above.)
Control Right Weapon
Left Alternate Fire	As fire and alt-fire control the active fire-modes for the left- and right-hand weapon respectively, these two keys control the inactive fire-modes. (That is, these would be primary-fire if you have the alternate fire-modes selected.)
Right Alternate Fire

Additional (Optional!) keys can be bound via the Dual Wielding configuration screen:

KEY	ACTION
Toggle Both Fire-Modes	Toggle the active fire-mode (the fire-modes assigned to Fire/AltFire.)
Toggle Left Fire-Mode
Toggle Right Fire-Mode
Next Weapon (Left)	Cycle weapons for the left/right hand.
Next Weapon (Right)
Prev Weapon (Left)
Prev Weapon (Right)
Best Weapons	Take out your two best weapons.
Switch Ammo Display	The standard UT2004 HUD is only capable of showing one ammo indicator at a time. Press this to toggle which weapon's ammo is shown.
Open Config In-Game	Open the Dual Wielding configuration screen to configure options, weapon restrictions and controls in-game.

Additional Commands

The following console commands also exist.

COMMAND	ACTION
GetWeaponLeft <weaponClass>	These act like GetWeapon, but for the left or right hand while dual-wielding.
GetWeaponRight <weaponClass>
SwitchWeaponLeft <num>	These act like SwitchWeapon, but for the left or right hand while dual-wielding.
SwitchWeaponRight <num>
DieDieDieDie	Duplicates all of your weapons (allowing akimbo). For Instant Action only. Mmm... akimbo Shield Guns. ;-)

Third-Party Weapon Commands

Console commands implemented in custom weapons will not work unless explicitly supported by Dual Wielding. (Some ChaosUT2, Remote Strike and Ballistic Weapons commands are supported.) One way around this is to use the CommandSubWeapon <hand> <command> or CommandSubWeapons <command> console commands. For example, to reload your left-hand weapon:

CommandSubWeapon 0 Reload

(The left hand is “0” and the right hand is “1”.)

6. Version History

Version 2, rc1

I call it a release candidate (despite having released it.) Not quite finished, but nearly version 2.0. Dual Wielding underwent a large internal structural change to get to this version, and in the process many features were added, bugs were fixed, and (oh no!) bugs were probably introduced. Because there were so many changes, I see no point in listing changes from previous versions.

The highlights of this version are:

· A stylish new configuration screen, and several new options to go into it.

· An entirely new weapon restriction system, allowing users/server admins to customize which weapons may be dual-wielded.

· A new control style – Single-Button mode.

· The ability to fire all four modes at once (for any two weapons), also making it possible to switch fire-modes while firing.

· Improved bot support (firing both weapons independantly, rating weapons more intelligently).

· All Dual Wielding settings now go in DualWield.ini.

· Improved stability. (Dual Wielding shouldn’t cause General Protection Faults/crashes anymore.)

· More accurate weapon stats (if you die while dual-wielding, it’ll count as 1 death with each weapon.)

Version 2, rc2

This release contains a number of bug fixes relevant only when the UT2004 RPG mutator is active.

· Fixed quick-switching (switching between a single weapon and the Dual Weapon, without requiring the weapon to be put down.)

· Fixed “Deaths w/” stats showing as unnamed weapons (stats were being tracked for the different types of magical weapons, rather than the actual weapons.)

· The Denial ability works at level 2 again (it was “locking up” the dual-wielded weapons.)

· Hopefully fixed an intermittent bug which was preventing weapon-switching.

The following bug fixes apply only while UT2004 RPG is active in an online game:

· Fixed Single-Button mode.

· Fixed dual-wielding control key-press not automatically switching to the Dual Weapon.

Additional changes:

· Set default dual-wielding crosshair to the Assault Rifle crosshair. (Default crosshair was invisible in third-person with Aerial View.)