Valheim Chat Plus

Author: APOCRYPHOS (EnzoAlzueta on GitHub)

By APOCRYPHOS · Version 0.1.16 · MIT License

A vanilla-style chat improvement for playing Valheim with friends. Global chat, private messages and useful player notifications stay inside the game's familiar chat interface.

Features

• Global chat without distance limits, enabled by default.
• Private messages with /w, replies with /r, and player-name completion with Tab when using /w.
• Persistent player colors and administrator color commands.
• Map pings with local feedback.
• Connection, disconnection, death and sleep notifications.
• A configurable incoming-message sound.
• Automatic English/Spanish interface and notification language based on each player's game language. Other languages fall back to English; player messages are not translated.
• Dedicated servers, worlds hosted from the game, and local play.

Requirements

Install BepInEx for Valheim and the same version of this mod on the host/server and every player's PC. A dedicated server is optional: one player can open a world with Start server.

For Steam and Microsoft Store PC installations that support BepInEx. Xbox consoles are not supported. The mod uses its own chat RPC route, but does not repair general PlayFab disconnections or game transport failures.

Installation

Mod manager

Install this package and its BepInEx dependency in your Valheim profile, then launch the modded game from the manager. Each player needs the mod. Install it separately on a dedicated server if you use one.

Manual installation: PC or dedicated server

1. Install and configure BepInEx for your game/server first, if it is not already working.
2. Close Valheim or stop the dedicated server.
3. Extract this ZIP's BepInEx folder into the game/server folder.
4. The DLL should be at BepInEx/plugins/ValheimChatPlus/ValheimChatPlus.dll.
5. Start the game/server. Use /chathelp for in-game help.

The same DLL works on the PC clients and Linux dedicated server. No compilation or .NET SDK is needed to install it. With AMP, stop the Valheim instance before copying the DLL and start it afterwards.

Commands

Color commands also accept player IDs from /cplayers.

Behavior and limitations

Ordinary text falls back to vanilla when connected to a server without a compatible mod. Explicit private messages never fall back to public chat. Global chat reaches compatible mod users.

Sleep counts cover compatible mod participants, including the local host. This mod does not change Valheim's rules for skipping the night. Closing a player-hosted world ends the session.

Whispers are routed through the host/server; they are not end-to-end encrypted. Session mutes apply to mod global messages and whispers, not every notification or ping.

Source and feedback

Source code · Report an issue

Troubleshooting and uninstalling

Check BepInEx/LogOutput.log for VALHEIM_CHAT_PLUS_READY 0.1.16. A player hosting a world should also see VALHEIM_CHAT_PLUS_HOST_READY 0.1.16 after their character loads. Check that all participants have the same mod version and that there are no duplicate DLLs.

When reporting a problem, include the game and BepInEx versions, whether you are hosting or joining, reproduction steps, and the relevant log excerpt. Remove private information before sharing logs.

To uninstall, close the game/server and remove the mod DLL. Settings may remain for later reuse.

Español

Instalá BepInEx y la misma versión del mod en todas las PC y en el servidor dedicado, si lo usás. También funciona cuando uno abre su mundo con Iniciar servidor; no exige un dedicado.

Con el juego o servidor detenido, copiá la carpeta BepInEx del ZIP a la carpeta del juego/servidor. La DLL queda en BepInEx/plugins/ValheimChatPlus/ValheimChatPlus.dll. En AMP, detené la instancia antes de copiar y volvé a iniciarla después.

El idioma se detecta desde el juego: español si lo tenés en español, inglés como alternativa. /chathelp muestra la ayuda. /chatmode global activa el chat global; /chatmode vanilla vuelve al chat normal conservando las otras funciones.

Credits and license

Valheim Chat Plus by APOCRYPHOS. Released under the MIT License; see LICENSE.

This is an unofficial community mod, not affiliated with Iron Gate or Coffee Stain.

Thanks to Mange for helping with testing.

0.1.16 — Release naming and installation candidate

0.1.17

• Documentation-only package update: explain the original Steam/Microsoft Store crossplay chat and ping issue.

• Includes the unchanged, tested 0.1.16 DLL. No gameplay changes or server update required.

• Build the real assembly as ValheimChatPlus.dll (not just a renamed download).

• Keep plugin ID, config/color paths and explicitly named embedded sound resource to preserve preferences, colors and audio.

• Rename the project and deployment folder. Build scripts also generate ValheimChatPlus_0.1.16_install.zip containing the DLL and player installation instructions.

• AMP installer backs up both legacy/new DLL copies, including download duplicates, outside plugins; preserves configuration/colors; rolls back DLL changes if installation fails.

• Build scripts detect client/server Managed folders and normalize input paths.

• No gameplay changes from 0.1.15. Both automatic suites remain required before building.

• This is the version to validate in game before public release, not a claim of completed live validation.

0.1.15 — Local hosting

• Add a local participant for a player hosting from the game; a separate dedicated-server process is no longer required.
• Reuse the validated server paths for host global chat, whisper/reply, admin commands, presence, sleep/death events and pings.
• Include the host in rosters and sleep totals. Keep the endpoint across respawn and clear it on world changes.
• Keep remote identity/admin verification unchanged. Never accept client RPCs as local-host or server-delivery authority.
• Persist host colors by local character ID. Guest colors still use transport identities.
• Use separate outgoing/server ping budgets so the host does not consume the same limiter twice.
• Preserve protocol 0114 and all English/Spanish behavior from 0.1.14.
• Add 66 executable checks of actual plugin handlers with controlled game API doubles. Both test suites now run before a production build.
• Source-only delivery. A build against real dependencies and live listen-host/dedicated validation are still required.

0.1.14 — Valheim Chat Plus

• Rename the displayed plugin and player-facing branding; retain the assembly name, plugin ID, config and persistent colors.
• Default new configurations to global chat; preserve previously saved mode choices.
• Fall back to vanilla for ordinary text without a compatible mod server; preserve the preferred mode. Explicit mod commands never take the public fallback path.
• Add translated /chathelp, concise connection notice and preferred/active mode status.
• Centralize player-facing English/Spanish messages. Read game language at display time; default to English.
• Send structured administrative notices and translate them on each recipient.
• Send literal-name/localization-key tags for death attackers; translate enemy keys on each recipient without translating player names.
• Separate language initialization from whisper setup and recover from temporary language lookup failures.
• Require messaging handshake 0114. Update server and clients together; mixed old/new versions do not exchange mod messages.
• Keep notifications and pings independent of the ordinary-text mode. No new per-frame work, UI or online translation service.
• Add 282 automatic checks for localization, notice validation, death names and chat fallback. Retain the original domain tests.

Source and automated checks are ready. Live Valheim validation and a production build with the installed game dependencies remain required.