wallabra / mushmatch Goto Github PK

Whenever running Mush Match with any of the Relics mutators included in Unreal Tournament: Game of the Year Edition or the Epic Bonus Pack, the Mush Match HUD is completely absent.

If you're a player and have met that issue, please scroll to the bottom and read the final section.

Pretext

The Mush Match gametype includes a "base mutator", which is akin to a special internal mutator that is always loaded by the gametype (many gametypes can have their own for a variety of reasons).

The Mush Match base mutator is particularly important because it is responsible for rendering Mush Match specific HUD features, both client- and server-side. Said HUD features include the self status icons at the top of the screen (such as whether you're a Human or a Mush); and, when looking at another player, known information about said player ("Status" and "Alignment"). The latter is important for being a much more convenient way of checking a nearby player's information than checking the scoreboard.

Due to the fact that those features require the base mutator in order to function, it is imperative that the Mush Match base mutator is always able to register itself as, and function properly as, a HUD mutator like any other.

Relic related mutators are bundled with Unreal Tournament: Game of the Year Edition, and can be otherwise found in the Epic Bonus Pack. Each Relic has its own associated Mutator, which spawns the Relic somewhere in the level. Each Relic imparts an effect on the player for as long as it is worn; however, only one Relic can be worn at a time.

Whenever a Relic is worn, this must be known to the player; to do so, each Relic mutator is also a HUD mutator, which displays the icon of the relic on the bottom left if and only if the relic is being worn by the client player at that instant.

Issue

When a Relic mutator is loaded in a Mush Match game, the Mush Match HUD ceases to function entirely. There is no identification information (Status/Alignment when you look at someone), nor the self status icon at the top of the screen; said HUD features are completely absent in these circumstances. The scoreboard functions as normal.

The fact that Relic mutators interfere with other HUD mutators, such as Mush Match's own base mutator, in this most undesirable manner, is an old and well-known issue. The only known fix to this is to install RelicsHUDPatch (note: HTTPS unavailable).

Status

There may be no possible work-around; players who want to play Mush Match with relics will most likely need the RelicsHUDPatch installed, and servers will also have to set it up with respective ServerPackages configuration in order to support netgames with both.

If a fix is found that can be applied to Mush Match, does not require additional third-party mods or patches, and does not involve excessive and potentially counterproductive levels of 'hackiness', this issue may be reopened to track said efforts. Until then, this will serve as a placeholder and potential documentation for players who find trouble running Mush Match in applicable circumstances.

Conclusion

If you are having issues with the HUD when playing Mush Match, before you open an issue, check if you have any relics mutators loaded. If you do, please install Wormbo's RelicsHUDPatch (note: HTTPS unavailable) and add the Relics HUD Patch to your loaded mutators list.

If issues persist, do feel free to open an issue. In fact, if in doubt, open anyway! We are lenient and patient, and will assist you in resolving your problems, even if they do not necessarily involve an issue within Mush Match itself.