NoMessageHudToggle
Client-side Valheim mod that filters Message HUD notifications. Hide pickups, inventory notices, skill-ups, unlocks, center messages and events, with a temporary F8 toggle.No Message HUD Toggle
A client-side Valheim mod for hiding unwanted Message HUD notifications and preventing the chat window from automatically appearing.
Features
- Persistent enable/disable setting.
- F8 temporarily toggles the mod at runtime without changing the saved configuration.
- Automatically reloads edited configuration values without restarting the game.
- Hides item pickup notifications, including creature drops.
- Hides inventory change notifications and skill-up messages.
- Filters newly discovered items, trophies, materials, recipes, crafting stations and station upgrades.
- Provides separate filters for event/raid notifications (
$event_*) and regular center-screen messages. - Optionally hides uncategorized Message HUD notifications.
- New in 1.3.0: prevents automatic chat window popups from incoming messages and player join/leave notifications, while allowing manual chat access.
Installation
Install using Thunderstore Mod Manager, r2modman, or another compatible mod manager with BepInExPack for Valheim.
The mod is client-side only and does not need to be installed on a dedicated server. For manual installation, place the compiled mod DLL in BepInEx/plugins/.
Configuration
The configuration file is generated after the first launch:
BepInEx/config/com.xtasy.NoMessageHudToggle.cfg
Default values:
[General]
Enabled = true
Toggle Hotkey = F8
[Messages]
Hide Item Pickup = true
Hide Inventory Notifications = true
Hide Skill Up = true
Hide New Items = true
Hide New Materials = true
Hide New Recipes = true
Hide New Stations = true
Hide Station Level Up = true
Hide Events = false
Hide Center Messages = true
Hide Other = false
[Chat]
Disable Automatic Chat Popup = true
Automatic chat popup
Disable Automatic Chat Popup = true attempts to prevent the chat panel from appearing automatically when other players send messages or join/leave the server.
true: suppress automatic chat popups while the mod is active.false: preserve normal Valheim chat visibility behavior.- Enter can still be used to open the chat manually.
- Incoming chat messages are not deliberately discarded or filtered.
This option controls chat window visibility, not the server's delivery of chat messages. The implementation patches Chat.Update and accesses m_chatWindow; it has not yet been validated in-game on the current Valheim version.
Runtime toggle and auto-reload
Press F8 to turn the mod on or off temporarily. This does not alter Enabled in the config file. On the next launch, the mod starts according to the saved value.
Config file changes are detected and reloaded automatically without restarting the game. The toggle key is ignored while chat, console, or another text input has focus.
Compatibility
Previously documented as tested with:
- Valheim 1.0.15
- BepInExPack Valheim 5.4.2350 / 5.4.2351
Version 1.3.0's new chat popup behavior has not yet been tested in-game. Compatibility with future Valheim updates is not guaranteed.
The mod patches:
MessageHud.ShowMessageMessageHud.QueueUnlockMsgChat.Update(new in 1.3.0)
If a Valheim update changes these methods or relevant UI fields, an update may be required.
Known behavior
Creature drops and normal pickups use $msg_added, so both are controlled by Hide Item Pickup.
Raid and event messages can use MessageHud.MessageType.Center, so $event_* messages are checked first. Hide Center Messages does not suppress raid/event notifications; use Hide Events for those.
License
MIT