Server and Discord Ops

Updated a month ago

Server and Discord Ops

FrostVale includes VerdantsAscent-FiresDiscordIntegration-1.0.1 so the host can run Discord operations from the same canonical pack as players.

Discord is not plug and play. The host must configure the Discord bot, webhooks, channel IDs, and permissions after installing the package.

Secrets rule

Do not commit, publish, or share:

  • Discord bot tokens
  • Discord webhook URLs
  • server passwords
  • generated live configs
  • any config file containing private host credentials

The token lives only on the server and is never shipped in the public pack.

What the host needs

  • Discord server admin permission
  • Discord bot token
  • one or more webhook URLs
  • Discord server ID
  • channel IDs for chat, status, client logs, and admin messages
  • admin Discord user IDs if reaction-based admin controls are enabled

Suggested channels

  • frostvale-events: joins, leaves, deaths, server start/stop, summaries
  • frostvale-chat: in-game chat relay
  • frostvale-admin: client log snapshots, anti-cheat, and server manager controls

Recommended bot permissions

  • View Channels
  • Send Messages
  • Read Message History
  • Add Reactions
  • Manage Messages

Enable Message Content Intent if Discord-to-Valheim chat relay is enabled.

First boot check

After configuration, restart the server and watch the BepInEx/server log.

Confirm:

  • FiresDiscordIntegration loads.
  • No bot authentication errors appear.
  • Server status posts to Discord.
  • Chat relay works if enabled.
  • Client log snapshots post only where expected.

Client behavior

Regular players do not need to configure Discord secrets. With no bot token, the integration is idle on solo and client installs.