Valheim Client Logger

A client-side BepInEx plugin that detects gameplay events and sends them to a server mod for webhook integration.

Features

• Player Login/Logout: Tracks when you join or leave the server
• Mob Kills: Logs when you defeat creatures (with internal English names)
• Skill Level Ups: Tracks when your skills increase to a new level
• Clean Data: All mob and item names use internal English identifiers

Requirements

• BepInEx 5.4.2202 or later
• Valheim Server Logger mod must be installed on the server

Installation

Using r2modman (Recommended)

1. Install r2modman
2. Search for "ValheimClientLogger" in the mod manager
3. Click Install
4. Launch the game through r2modman

Manual Installation

1. Download the latest release
2. Extract the zip file
3. Copy ValheimClientLogger.dll to BepInEx/plugins/ folder
4. Launch the game

Configuration

The mod works automatically once installed. Configuration is done on the server side via the Valheim Server Logger mod.

Server Setup

This mod requires the server-side companion mod Valheim Server Logger to be installed on your dedicated server. The server mod receives events from clients and forwards them to your webhook endpoint.

Events Logged

1. player_login: When you spawn into the world
2. player_logout: When you disconnect from the server
3. mob_kill: When you defeat a creature
   • Includes: mob name, level, boss status, position
4. skill_level_up: When a skill reaches a new integer level
   • Includes: skill type, new level, previous level

Technical Details

• Uses custom RPC communication to send events to the server
• Events are batched and sent via webhook (configured server-side)
• Minimal performance impact - only logs significant events
• Item pickup logging is disabled by default to reduce spam

Compatibility

• Valheim (latest version)
• Works with dedicated servers and local games
• Compatible with most other mods

Support

For issues, questions, or contributions, please visit the GitHub repository.

Changelog

1.0.0

• Initial release
• Player login/logout detection
• Mob kill tracking with English names
• Skill level up detection
• Custom RPC communication with server mod

Changelog

All notable changes to Valheim Client Logger will be documented in this file.

[1.0.2] - 2025-11-13

Fixed

• Fixed BepInEx dependency version (5.4.2202 → 5.4.2333) to resolve r2modman installation issues

[1.0.1] - 2025-11-13

Fixed

• Fixed skill level up detection to only log once per level (was logging on every XP gain)
• Improved skill tracking with static dictionary to prevent duplicate events

Technical

• Added skill level tracking dictionary to maintain last logged level per skill
• Reset skill tracking on player logout for accurate detection on next login

[1.0.0] - 2025-11-13

Added

• Initial release of Valheim Client Logger
• Player login detection using Player.OnSpawned
• Player logout detection with RPC delivery guarantee
• Mob kill tracking with internal English names
• Skill level up detection (only logs when reaching new integer level)
• Custom RPC communication with server mod (com.paim.valheimlogger.LogEvent)
• Clean event data with English identifiers (no localization keys)

Technical

• Uses Harmony patches for event detection
• Custom JSON serialization to avoid external dependencies
• Skill level tracking to prevent duplicate events
• Thread.Sleep on logout to ensure event delivery
• Disabled item pickup logging to reduce event spam