FiresDiscordIntegration

Two-way Discord ↔ Valheim chat, a live server-status panel with restart/stop reactions, automatic per-client login snapshots, crash detection, GIF/image rendering in chat, and an auto-restart wrapper bat — all driven by a single Discord bot of your own.

Need help, found a bug, want a feature? https://discord.gg/H9uKGcAujs

What this mod does

Installation

1. Install BepInEx — the BepInExPack_Valheim on Thunderstore is the standard one.
2. Drop FiresDiscordIntegration.dll into BepInEx/plugins/. Which side(s) need it depends on which features you want — see the table below.
3. Start the server once. It will:
   • Create BepInEx/config/com.Fire.FiresDiscordIntegration.cfg with every setting commented for you.
   • Extract BepInEx/config/FiresDiscordIntegration/valheim_server_wrapper.bat (the auto-restart wrapper template).
4. Open the server config and fill in [Discord] Enabled = true plus the webhook URLs / bot token you set up below.

The DLL auto-detects which side it's running on at ZNet.Awake (it calls IsServer() and routes itself to InitServer() or InitClient()). The config file is only read on the side that needs it — clients don't need to configure anything.

Where the DLL needs to go, per feature

**Without the DLL on the client, the server sees no log data for that player and skips the snapshot entirely (no false-positive embed, no crash).

A player joining a server that has the mod installed but who doesn't have the mod themselves still works — they just don't contribute a snapshot. The rest of the server-side features (status panel, crash notifications, in-game-shout → Discord) work for everyone regardless.

Setting up a Discord bot

If you only want outgoing webhooks (events posted to Discord), you don't need a bot at all — just create webhooks on the channels you want to receive each kind of post and paste the URLs into the config.

If you want the server-manager panel, the chat relay back from Discord, the per-user role colors, or the reaction-based log requests, you need a bot. Here's the 5-minute setup:

1. Create the application

1. Open https://discord.com/developers/applications and click New Application.
2. Give it a name (e.g. My Valheim Server). Click Create.

2. Add the bot user

1. In the left sidebar click Bot.
2. Set the avatar / display name you want players to see.
3. Under Privileged Gateway Intents, enable Server Members Intent. This is what lets the bot read each Discord user's role colors so the in-game chat can recolor their messages. (Message Content intent is not required — we use REST, not the gateway.)

3. Generate the bot token

1. Still on the Bot page, click Reset Token → Yes, do it!.
2. Copy the long string that appears.
3. The token is shown once. If you lose it, reset it again.

Where to paste the token

The token goes into a dedicated file at your Valheim install root (the folder that contains valheim_server.exe) — not into any BepInEx config:

<server folder>/FiresDiscordIntegration_BotToken.cfg

If the file doesn't exist yet, start the server once with the mod installed — it auto-creates an empty template there on first load. Open the file, paste your token after BotToken = , save, restart.

Why it's not in BepInEx/config/: Modman and other profile sharing mehods sync configs when shared, sharing a bot token with ANYONE is a bad idea. The dedicated file lives outside that path so the sync tools never touch it.

The wrapper bat reads the same file to drive the Discord-triggered restart polling, so the bat and the mod stay in sync automatically.

4. Invite the bot to your Discord

1. In the left sidebar click OAuth2 → URL Generator (or Installation depending on Discord version).
2. Scopes: tick bot.
3. Bot permissions: View Channels, Send Messages, Read Message History, Add Reactions, Manage Messages (lets the mod clean up old status messages on restart).
4. Copy the generated URL, paste it into your browser, pick your server, click Authorize.

5. Copy the channel + guild IDs you'll use

In Discord, User Settings → Advanced → Developer Mode turns on the "Copy ID" right-click option.

Then right-click and Copy ID on:

• Your server (the guild name in the sidebar) → [Discord] DiscordGuildId
• The chat channel you want the bot to read and relay → [Discord.BotListener] ChatChannelId
• The channel where the status panel + login snapshots should live → [Discord.BotListener] StatusChannelId (or ServerManagerChannelId if you want the panel in a separate channel from snapshots)

6. Create the outgoing webhooks

In each channel that should receive event posts: Edit Channel → Integrations → Webhooks → New Webhook → Copy URL. Paste the URL into the matching [Discord.Webhooks] setting:

• GeneralWebhookUrl — start / stop / save / hourly summary / daily summary
• ChatWebhookUrl — relayed in-game chat (so messages show with the player's name + avatar instead of the bot's)
• AntiCheatWebhookUrl — kick / violation notifications
• ClientLogWebhookUrl — login snapshots + on-demand log artifacts

Webhooks and the bot can post into the same channel — Discord doesn't care.

The wrapper bat (auto-restart + Discord-triggered restart/stop)

On first server load the mod extracts valheim_server_wrapper.bat to:

<server folder>\BepInEx\config\FiresDiscordIntegration\valheim_server_wrapper.bat

That's a template. Open it in a text editor and fill in the config block near the top:

SET SERVER_NAME=My Valheim Server (these don't need "")
SET SERVER_PORT=2456
SET SERVER_WORLD=Dedicated
SET SERVER_PASSWORD=changeme
SET SERVER_PUBLIC=1
SET RESTART_DELAY=10

These are the same flags you'd normally pass on the valheim_server.exe command line. Password must be 5+ chars and cannot appear inside the server name.

Then copy the edited bat to your Valheim dedicated-server folder (the one with valheim_server.exe in it). The bat can be renamed to anything — run_my_server.bat, server.bat, whatever — and you can drop a copy of it into multiple server folders if you run several instances on one machine. Each copy reads sentinel + flag paths relative to its own location, so they don't step on each other.

This feature is mostly for server owners running their own server off of a spare pc using windows who dont have ftp setup or a convenient server console... you can stop and restart the server from your phone on discord if the heartbeat stops and the cmd window is still open It does have its own heartbeat falure code to auto restart, but lets face it... its not working as intended yet (future feature maybe)

Then run the bat instead of valheim_server.exe. The bat:

• Auto-restarts the server with a 10-second cooldown if it crashes / is killed.
• Auto-restarts immediately when a Discord admin clicks the 🔄 reaction on the status panel.
• Stops cleanly (and waits for the next 🔄 click) when a Discord admin clicks the ⛔ reaction.
• Falls through to a 15-second Discord polling loop while stopped, so you don't need a separate process to revive the server.

Do not add setlocal enabledelayedexpansion to this bat.(not like you will edit below the restart delay line) The inline PowerShell for polling discord hates it and it mangles the script. The template ships with delayed expansion off for that reason.

Config map (quick reference)

The BepInEx/config/com.Fire.FiresDiscordIntegration.cfg file has every setting documented inline — open it for the full list. Highlights:

Compatibility

• Designed to run alongside other Valheim mods. Tested with the same heavy-modded environments as FiresGhettoNetworking.
• The chat-relay's TMP rich-text recoloring of [Discord]-prefixed lines happens in a Harmony postfix on Chat.OnNewChatMessage — should coexist with chat-channel mods as long as they don't strip the buffer entry before our patch runs.
• The wrapper bat reads the bot token from FiresDiscordIntegration_BotToken.cfg at the server root, and the channel IDs from this mod's BepInEx config. Other mods' configs are not touched.
• This mods Discord webhooks and Bot Listener are toggled off by default in the cfgs as a cognative test to prevent people from refusing to read. If you wish for them to actually do something you will need to toggle them on and setup your bot/webhooks.

Credits

The Discord webhook + REST plumbing was originally built inside FiresGhettoNetworking. Split out into this standalone mod so people dont have a mod outside the scope of their networking mod wrapped up in one. decided to actually offer it as a stand alone after working on it for the last few months since I've noticed a few sub par versions surface lately that can't pull the log from discord itself and dont have cool features like gifs XD

License

MIT — see LICENSE.

Issues / questions

https://discord.gg/H9uKGcAujs