NoAFKRaids
Prevents raids from starting near players that are AFK.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:
- The game selects a raid type and target position
- NoAFKRaids checks if any AFK players are within the protection radius
- If an AFK player is nearby, the raid is prevented before it begins
- 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)