Dumba-NoAFKRaids icon

NoAFKRaids

Prevents raids from starting near players that are AFK.

By Dumba
Last updated a week ago
Total downloads 1240
Total rating 1 
Categories Mods Tweaks Server-side Client-side Ashlands Update
Dependency string Dumba-NoAFKRaids-2.0.0
Dependants 6 other packages depend on this package

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2333 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2333

README

No AFK Raids

Version 2.0.0 - Complete rewrite! Now extremely lightweight. If upgrading from 1.x, you may want to delete your server's old config file.

Prevents raids from occurring within 200 meters (configurable) of an AFK player.

  • Players are considered AFK after three minutes of inactivity (configurable)
  • Crossplay compatible
  • ServerSync: Config syncs from server to clients automatically
  • Uses Valheim's native event system for optimal reliability

Installation

Place NoAFKRaids.dll in BepInEx/plugins/

Scenario Where to Install
Singleplayer Your game only
Self-hosted multiplayer Host + all clients
Dedicated server Server + all clients

Note: Players without the mod installed won't have their AFK status tracked and won't be protected from raids.


ServerSync

This mod uses ServerSync to synchronize configuration from the server to clients. When ServerConfigLocked = true (default), the server's settings override client settings for gameplay options. Logging preferences remain client-side.


Configuration Options

Config file: BepInEx/config/dumba.noafkraids.cfg

AFK Detection

Setting Default Description
ServerConfigLocked true Server settings override client settings
AFKMinutes 3 Minutes without movement before considered AFK
MovementThreshold 0.1 Minimum movement distance to be considered active
UpdateInterval 10 Seconds between AFK status updates

Protection

Setting Default Description
AFKProtectionRadius 200 Distance (meters) around AFK players where raids are blocked
UseEventRangeAsProtection false Use the game's native event range (96m) instead of custom radius
AllowForcedEvents true Allow boss fights and forced events to proceed (don't block these)

Logging (Client-Side Only)

Setting Default Description
LogRaidDecisions true Log when raids are blocked or allowed
LogAFKStateChanges false Log when players go AFK or become active
DebugMode false Enable verbose debugging output

How It Works

The mod integrates directly with the event system at the optimal point where raid positions are determined. When a raid attempts to start:

  1. The game selects a raid type and target position
  2. NoAFKRaids checks if any AFK players are within the protection radius
  3. If an AFK player is nearby, the raid is prevented before it begins
  4. Active players can still experience raids normally

Why Client-Side AFK Detection?

For better performance on large servers. Server simply maintains a dictionary of AFK states and checks distances when raids occur (rare event).

Task Who Does It
Position monitoring & AFK timers Each client (distributed load)
State change notification Client → Server via RPC (infrequent)
Raid blocking decision Server (only when raids trigger)

Contact

Discord - Dumba (dumba7435)