LordVGames-CleanestHud icon

CleanestHud

A revival/continuation of HIFU's CleanerHud mod. Edits the hud to be cleaner, re-organizes some things, and integrates the color of your survivor throughout the hud.

Last updated 3 days ago
Total downloads 24801
Total rating 7 
Categories Mods Client-side
Dependency string LordVGames-CleanestHud-1.0.1
Dependants 4 other packages depend on this package

This mod requires the following mods to function

bbepis-BepInExPack-5.4.2120 icon
bbepis-BepInExPack

Unified BepInEx all-in-one modding pack - plugin framework, detour library

Preferred version: 5.4.2120
RiskofThunder-HookGenPatcher-1.2.5 icon
RiskofThunder-HookGenPatcher

MMHOOK generation at runtime.

Preferred version: 1.2.5
RiskofThunder-R2API_Language-1.0.1 icon
RiskofThunder-R2API_Language

API for modifying the language localisation of the game

Preferred version: 1.0.1
Brynzananas-Enable_Movement_On_Focused_UI-1.0.0 icon
Brynzananas-Enable_Movement_On_Focused_UI

Enables movement and attacking back on any focused UI

Preferred version: 1.0.0

README

CleanestHud

This is a revival & continuation of HIFU's CleanerHud mod, with permission. (proof at bottom of readme)

Info

  • Pretty much everything about the hud has been edited in some way.
  • Bugs from the original CleanerHud mod are fixed.
  • Uses your survivor's color throughout the hud.
    • This doesn't just include the one you're playing as, but any survivor you're spectating.
  • Supports modded UI from many mods, including (but not limited to):
  • Many parts of the hud are configurable.
  • If a survivor you want to play with doesn't work well with the hud, there's a blacklist you can add them to to prevent the hud from doing changes
  • Lots of modded multiplayer sessions were played while this was being developed, so I've made sure it works in multiplayer

Many elements of the hud are also configurable Most are for the hud in general, but some are for the survivor specific hud elements that seeker and void fiend have!

Screenshots Showcase

Expand

20250719144026_1

20250719144412_1

20250719144446_1

20250719144530_1

Multiplayer

oEgXQq6zmr

Modded Survivor: Driver

20250719144604_1

Bugs/Suggestions

If you find a bug, or have a suggestion for the hud, either make a github issue or ping me (lordvgames) in the RoR2 modding discord server.

Known Issues

  • Changing resolutions mid-stage doesn't re-scale the hud
    • Kind of a vanilla issue, especially when going from a big resolution to a small one, but I feel it should still be mentioned
  • Having the HealthbarImmune mod causes the hp bar text to disappear
    • May or may not be an issue from HealthbarImmune itself. In any case, installing NoMoreMath seems to fix it, even with the "effective health" setting off
  • Sometimes Myst's HUD doesn't appear
    • It's a semi-rare error that randomly happens and it comes straight from Myst itself. Can't really fix it until Myst itself adds support for this HUD.
  • Some part of the HUD is broken when an editing phase is turned off
    • The HUD was built assuming parts of it's editing process weren't turned off, especially structure edits. It'd be a ton of work to go back and make sure everything works with those options, so any bugs stemming from these options likely won't be fixed.

For mod developers

The mod includes some events you can subscribe to that correlate to when certain stages of the HUD editing process are done. These are, in order of completion:

  • HudChanges.HudStructure.OnHudStructureEditsFinished
  • HudChanges.HudDetails.OnHudDetailEditsFinished
  • Main.OnSurvivorSpecificHudEditsFinished (repeatable)
  • HudChanges.HudColor.OnHudColorUpdate (repeatable) The repeatable events happen when the camera/HUD's target changes, so any changes that depend on a specific survivor should go in either. OnSurvivorSpecificHudEditsFinished will always happen after a camera target change, and OnHudColorUpdate will try to run on every camera change, but the event will only be raised after successfully changing the HUD's color.
  • Many config options have an event for when they're toggled on/off.

You can look at the existing code for this mod's survivor HUD support for examples on how to use these.

yes, i did get permission to continue the mod

image