ValheimLoading...DiscordLogSync1.0.1

You are viewing a potentially older version of this package. View Latest Version

Install

Date Uploaded

3 months ago

Downloads

166

Size

23KB

Dependency string

tarbaby-DiscordLogSync-1.0.1

Download

Details Required (1)Versions

DiscordLogger — Valheim BepInEx Mod

Pipes all BepInEx log output to a Discord webhook in near-real-time, with local buffering so no lines are lost on unexpected process death.

How It Works

Every log line
      │
      ▼
BepInEx/DiscordLogBuffer.txt   ← flushed to disk immediately, every line
      │
      ▼ (every N seconds, background thread)
Discord Webhook POST
      │
      ├─ read from front of buffer
      ├─── success (200) → remove read lines from front.
      └─── failure (500) → leave buffer, retry next tick

On next startup:
  buffer file exists? → send as "recovered from crash" → delete → begin fresh

Build

Requirements: .NET SDK with netstandard2.1 support (i.e. .NET Core 3.0+ or .NET 5+ SDK), dotnet CLI, Valheim dedicated server + BepInEx installed.

Targets netstandard2.1, which runs on Unity's Mono 6.4+ runtime. Not compatible with plain .NET Framework 4.7.2.

The .csproj assumes the default Linux Steam dedicated server path:

~/.steam/steam/steamapps/common/Valheim dedicated server

Edit the <ValheimDir> property if your path differs.

dotnet build -c Release

Output: bin/Release/netstandard2.1/DiscordLogger.dll

Install

Copy DiscordLogger.dll into BepInEx/plugins/
Launch the game once to generate the config file
Open BepInEx/config/com.byawn.DiscordLogSync.cfg
Set your webhook URL:

[Discord]
WebhookUrl = https://discord.com/api/webhooks/YOUR_ID/YOUR_TOKEN
SendIntervalSeconds = 3
MaxMessageChars = 1800

Restart

Config Options

Key	Default	Description
`WebhookUrl`	(empty)	Required. Discord webhook URL.
`SendIntervalSeconds`	`3`	How often to flush buffer to Discord. Minimum 2.
`MaxMessageChars`	`1800`	Characters per embed.

Buffer File

BepInEx/DiscordLogBuffer.txt

Created fresh each run
Every line flushed to disk immediately (no in-memory buffering)
If the file exists on startup → previous run crashed → contents sent as recovery message
Treated like a FIFO so as to fit inside Discord message size limits.

Discord Message Colors [UNUSED FEATURE?]

Situation	Color
Contains `[Fatal]` or `[Error]`	🔴 Red
Contains `[Warning]`	🟠 Orange
Recovery (crash)	🟣 Purple
Normal	🔵 Blue

How It Works

Every log line │ ▼ BepInEx/DiscordLogBuffer.txt ← flushed to disk immediately, every line │ ▼ (every N seconds, background thread) Discord Webhook POST │ ├─ read from front of buffer ├─── success (200) → remove read lines from front. └─── failure (500) → leave buffer, retry next tick On next startup: buffer file exists? → send as "recovered from crash" → delete → begin fresh

Build

Requirements: .NET SDK with netstandard2.1 support (i.e. .NET Core 3.0+ or .NET 5+ SDK), dotnet CLI, Valheim dedicated server + BepInEx installed.

Targets netstandard2.1, which runs on Unity's Mono 6.4+ runtime. Not compatible with plain .NET Framework 4.7.2.

The .csproj assumes the default Linux Steam dedicated server path:

~/.steam/steam/steamapps/common/Valheim dedicated server

Edit the <ValheimDir> property if your path differs.

dotnet build -c Release

Output: bin/Release/netstandard2.1/DiscordLogger.dll

Key

Default

Description

WebhookUrl

(empty)

Required. Discord webhook URL.

SendIntervalSeconds

3

How often to flush buffer to Discord. Minimum 2.

MaxMessageChars

1800

Characters per embed.

Situation

Color

Contains [Fatal] or [Error]

🔴 Red

Contains [Warning]

🟠 Orange

Recovery (crash)

🟣 Purple

Normal

🔵 Blue