DiscordBot AWL

DiscordBot AWL for Valheim

AWL Gaming maintenance fork of the original RustyMods DiscordBot. It preserves the existing two-way Valheim and Discord integration while maintaining compatibility with current Valheim releases and safer client/server transport.

Original author: RustyMods. AWL Gaming maintains this fork and does not claim authorship of the upstream implementation. See NOTICE.md.

AWL 1.4.9 highlights

• AI-generated responses can now use a configurable output language across the supported AI providers.
• Chat relay now has separate Game To Discord and Discord To Game switches while the existing Enabled setting remains the master switch for backward compatibility.

Prerequisites

• BepInEx installed
• JsonDotNet installed
• Discord Webhooks configured for your server
• Discord Bot Token (If you want your discord server to be able to send messages into your game)
• Required on client and server

Installation

Discord Setup

How to create Discord Bot

1. Create a Discord Application

• Go to the Discord Developer Portal
• Click "New Application" (top-right)
• Give your application a name (e.g. ValheimBot) and click "Create".

1. Add a Bot to the Application

• In the left sidebar, click "Bot"
• Click "Add Bot" ----> confirm by clicking "Yes, do it!"
• You now have a bot user attached to your application.
• You must enable Message Content Intent

1. Copy the Bot Token

• On the Bot page, under the "Token" section, click "Reset Token" (or "Copy" if it is already shown).
• Confirm, then copy the generated token.
• Keep this token secret. If it leaks, click "Reset Token" to generate a new one

1. Invite the Bot to your Discord Server

• In the sidebar, click "OAuth2" ----> "URL Generator".
• Under SCOPES, check bot
• Under BOT PERMISSIONS, check the permissions your bot will need
• Send Messages
• Read Message History
• View Channels
• Copy the generated URL at the bottom
• Open that URL in your browser and invite the bot to your Discord server

Creating Discord Webhooks

Webhooks allow the plugin to send messages to Discord channels without using the bot's identity.

1. Create Webhook

• Go to "Integrations" tab
• Click "Create Webhook"
• Give it a name (e.g., "Valheim Chat")

1. Copy Webhook URL

• Click "Copy Webhook URL"
• Save this URL for your plugin configuration

Getting Channel IDs

You'll need Discord Channel IDs for the bot to read messages:

1. Enable Developer Mode

• In Discord, go to User Settings (gear icon)
• Go to "Advanced" settings
• Enable "Developer Mode"

1. Copy Channel IDs

• Right-click on each channel you want to use
• Select "Copy ID"
• Save these IDs for your configuration

Configure the Plugin

After first run, configuration files will be generated in BepInEx/config/. Edit the Discord Bot config file to set up your:

• Channel IDs
• Webhook URLs [SERVER ONLY]
• Bot Token [SERVER ONLY]
• AI API keys [SERVER ONLY when using the server broker]

Configurations

Find DiscordBot plugin configurations in BepinEx/config/RustyMods.DiscordBot.cfg.

Configure webhook URLs, the Discord bot token, and server AI API keys only in the dedicated server config. Version 1.4.1 no longer synchronizes webhook URLs or API keys to clients. Connected clients submit bounded webhook requests to the server broker, which resolves the destination locally.

Webhook URL requires the complete Discord webhook URL. Channel ID requires only the numeric Discord channel ID. They are not interchangeable.

Config file edits are watched and reloaded automatically after saving. No console command is required. Replacing DiscordBot.dll is not hot-reloadable and requires restarting the affected server or client process.

Here's what your configuration might look like:

[1 - General]

## If on, the configuration is locked and can be changed by server admins only. [Synced with Server]
Lock Configuration = On

## Set interval between check for messages in discord, in seconds [Synced with Server]
Poll Interval = 5

## If on, errors will log to console as warnings [Synced with Server]
Log Errors = Off

[2 - Notifications]

## Set webhook to receive notifications, like server start, stop, save etc... [Server Only] [Not Synced with Server]
Webhook URL = <your-discord-webhook-url>

## If on, bot will send message when server is starting [Synced with Server]
Startup = Off

## If on, bot will send message when server is shutting down [Synced with Server]
Shutdown = Off

## If on, bot will send message when server is saving [Synced with Server]
Saving = Off

## If on, bot will send message when player dies [Synced with Server]
On Death = On

## If on, bot will send message when new player connects [Synced with Server]
New Connection = Off

[3 - Chat]

## Set discord webhook to display chat messages [Server Only] [Not Synced with Server]
Webhook URL = <your-discord-webhook-url>

## Set channel ID to monitor for messages [Synced with Server]
Channel ID = <channel-id>

## Legacy master switch for chat relay. Leave on and use the direction settings below to control each direction independently. [Synced with Server]
Enabled = On

## Forward in-game shout chat to Discord when Enabled is on. [Synced with Server]
Game To Discord = On

## Forward messages from the configured Discord chat channel into the game when Enabled is on. [Synced with Server]
Discord To Game = On

[4 - Commands]