Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
| Date uploaded | 5 months ago |
| Version | 1.0.1 |
| Download link | Dumba-NoAFKRaids-1.0.1.zip |
| Downloads | 519 |
| Dependency string | Dumba-NoAFKRaids-1.0.1 |
This mod requires the following mods to function
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.2333README
No AFK Raids
Prevents raids from occurring within 200 meters (configurable) of an AFK player.
- Players are considered AFK after three minutes of inactivity (configurable)
- Crossplay compatible
- Works with global raids and player-based raids
- ServerSync: Config syncs from server to clients automatically
Installation
Server & Client: Install on both server and all clients.
Manual: Place NoAFKRaids.dll in BepInEx/plugins/
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
General
| 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 |
Proximity Protection
| Setting | Default | Description |
|---|---|---|
| AFKProtectionRadius | 200 | Distance (meters) around AFK players where raids are blocked |
| ProtectGlobalRaids | false | Block global raids if any player is AFK anywhere |
| GlobalRaidAFKRadius | 200 | Protection radius for global raids |
Timing
| Setting | Default | Description |
|---|---|---|
| PositionCheckDelay | 0.1 | Seconds to wait after raid start before checking position |
| MaxPositionRetries | 5 | Max attempts to get raid position before fallback |
| UseDelayedEvaluation | true | Use delayed evaluation for reliable position detection |
| FallbackPolicy | Conservative | Policy when position detection fails: Conservative, Liberal, Smart, PlayerBased |
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 |
| LogRaidPositions | true | Log raid spawn positions |
| ShowProtectionRadius | true | Show protection radius info in logs |
| DebugMode | false | Enable verbose debugging output |
Lightweight
- Activates on the server when raids occur (rare events)
- Uses simple position comparisons
- Server handles event approval; clients report AFK status
CHANGELOG
Changelog
[2.0.0] - Major Rewrite
Major rewrite - Rewritten from ~2500 lines to ~700 lines of clean, maintainable code.
Why so much smaller?
- Better hook point: Patches where the raid position is already calculated, made a lot of code obsolete
Added
- UseEventRangeAsProtection: New option to use Valheim's native event range (96m) as protection radius
- AllowForcedEvents: New option to let boss fights and forced events proceed without interference
- Direct integration with Valheim's event positioning system for enhanced reliability
Changed
- Streamlined configuration - removed advanced timing options in favor of automatic handling
- Now uses Valheim's public API methods for better forward compatibility
- Simplified logging options:
LogRaidPositionsandShowProtectionRadiusmerged intoDebugMode
Removed
PositionCheckDelay,MaxPositionRetries,UseDelayedEvaluation,FallbackPolicy,ProtectGlobalRaids,GlobalRaidAFKRadius- all obsolete, no longer needed in version 2.0.0.
Notes
- Config Migration: If upgrading from 1.x, you may want to delete your old config file to get clean defaults. Core settings like
AFKMinutesandAFKProtectionRadiusremain the same.
[1.0.1]
Added
- ServerSync Integration: Config settings are now synchronized from server to clients
- Server administrators can enforce consistent raid protection settings across all players
- Added
ServerConfigLockedoption (default:true) to control whether server enforces settings - Logging and debug settings remain client-side preferences
Fixed
- Minor performance improvements during raid evaluation
[1.0.0] - Initial Release
Added
- AFK detection based on player movement (configurable)
- Proximity-based raid protection (configurable)
- Support for all raid types
- Configurable AFK timeout (default: 3 minutes)
- Client-server communication for AFK state
- Position tracking
- Debug logging
- Support for both Steam and crossplay connections
Configuration Options
AFKMinutes: Minutes without movement before considered AFK (default: 3)MovementThreshold: Minimum movement distance to be considered active (default: 0.1)UpdateInterval: Seconds between AFK status updates (default: 10)AFKProtectionRadius: Protection radius around AFK players (default: 200m)ProtectGlobalRaids: Whether to block global raids if any player is AFK (default: false)GlobalRaidAFKRadius: Protection radius for global raids (default: 200m)FallbackPolicy: Policy if position detection fails (default: Conservative)