HexedUT2k4 - Hexed Unreal Tournament 2004

This is a collection of packages and mutators providing a variety of features and QoL improvements. The following packages are provided:

• HexedUT: main mutator, provides hit sounds, damage numbers, colored death messages, enhanced map vote menu, and more.
• HexedUTComp: hexed-compliant version of UTComp, stripped down to eye height algorithms and NewNet weapons. Not thoroughly tested, so it might have some bugs.
• HexedSRC: package containing shared classes and resources used by HexedUT and HexedUTComp.
• HexedPatches: provides QoL improvements, such as better scaling for fonts, HUDs, and weapons (non-versioned, client-only package).

Installation

Download the latest release and extract it inside the root directory of your UT2004 installation, merging the System directory when asked. You can safely delete the .uz2 files extracted to the root directory (only useful for download redirection servers).

Players: when upgrading to a new version of HexedUT, keep the old version in you system folder (e.g. HexedUTv3.u) to allow HexedUT to automatically copy your configuration to the new version.

Server administrators: when upgrading to a new version of HexedUT, add the previous version to your ServerPackages to allow players that don't have it locally installed to automatically copy their configuration to the new version.

HexedUT & HexedUTComp

Specify MutHexedUT and/or MutUTComp to enable either HexedUT and/or HexedUTComp through the command line for your dedicated server as follows:

./ucc-bin server DM-Gestalt?game=XGame.xTeamGame?Mutator=HexedUTv4.MutHexedUT,HexedUTCompv4.MutUTComp ini=Server.ini -nohomedir

An in-game menu is provided to configure the mutators. To open it, execute either mutate HexedMenu or mutate HexedUT (the last one is only available if HexedUT is enabled). You can bind this command to a key, e.g. set input F5 mutate HexedMenu.

A note about upgrading to a new version

HexedPatches

To enable HexedPatches, open System/UT2004.ini and replace the default value of GUIController with HexedPatches.HxGUIController:

; GUIController=GUI2K4.UT2K4GUIController
GUIController=HexedPatches.HxGUIController

WARNING: do not change the GUIController if you plan to join servers running AntiTCC, otherwise you will most likely be banned.

All configuration can be changed through a new tab called "HexedPatches" in the settings.

Features

HexedUT

The following features are provided:

• Hit sounds: pings and pongs to know when you hit someone.
• Damage numbers: pop-up numbers to know how much damage you've dealt.
• Skin highlights: can't see your enemy? Paint him radioactive green.
• Spawn protection timer: a timer to keep track of spawn protection duration.
• Colored death messages: easily identify from which team is the killer and the victim.
• Health leech: part of damage dealt restores health, similar to the Vampire mutator, but with more customization.
• Movement modifiers: change movement speed, jump acceleration, number of jumps, etc.
• Starting values modifiers: add/remove health, shield, number of Assault Rifle grenades, adrenaline, etc.
• Disable specific combos and/or UDamage on maps.
• Enhanced map voting page:
  • On-screen map previews: screenshots, number of players, author and description.
  • Liked/disliked map classification.
  • New column with the recommended minimum/maximum of players.
  • Search bar for each column of the map list.
  • New button to select a random map.
  • Filter by source: any map, official maps or custom maps.
  • Several improvements to font size, line spacing, alignments, backgrounds and colors.

HexedUTComp

HexedUTComp is a fork of WSUTComp made to work together with HexedUT and significantly reduce the amount of features. For the sake of a streamlined building process, releases of HexedUTComp are bundled together with HexedUT here.

The following features are provided:

• New eye height algorithm: fixes where your aim is on uneven terrain (such as ramps).
• NewNet Weapons (a.k.a. enhanced netcode): ping compensation implementation.
• Timed overtime: limit overtime duration.

HexedPatches

The following QoL improvements are provided (any game version):

• Better font scaling for higher resolutions (may cause some font cropping/overflow, since some background elements are not properly scaled).

The following QoL improvements are provided for the legacy 3369 version of the game:

• Modern resolutions available in the settings menu.
• Small cursor to compensate absurd scaling when using high resolutions.
• Correct widescreen scaling for default HUDs.
• Higher FOV limit in the settings menu.
• Player models are no longer cropped in the settings menu (when using a widescreen resolution).
• Persistent custom network speed (applied on every level change).
• Master server selector (either 333network or OpenSpy).

Troubleshooting

If you find any bugs, feel free to open an issue.

The cursor is too small

The small cursor should be an adequate size for the most commonly used resolutions nowadays, but if you think it is too small, disable it in the Patches tab.

Fonts are too big or too small

Font size is automatically determined based on the current resolution. You can override the font size in the Patches tab (a restart is required). Try different values (between 0 and 6) to find the one that suites your needs.

HUD options are grayed out

You have foxWSFix enabled. In order to use HexedPatches's HUDs, you need to disable foxWSFix. Restore all InputClass values in System/User.ini to the default value:

InputClass=Class'Engine.PlayerInput'

Can't access HexedUT's Server tab

You need to log-in as administrator first. Open the in-game terminal and execute:

adminlogin YOUR_ADMIN_PASSWORD