NoAFKRaids

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)