?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
AntiAFKPlus

AntiAFKPlus

Smart and configurable AFK management for your server!

2.3Kdownloads
3followers
2.3Kdownloads
3followers

Links

View source Join Discord server
Donate on PayPal

Tags

Creators

Details

Licensed ARR
Published last year
Updated 7 months ago
All versions

2.9

Release
AFK Time Windows11 months ago 30
Download

Compatibility

Minecraft: Java Edition
1.21ā€“1.21.10
1.20.x
1.19.x
1.18.x
1.17.x
1.16.5
Platforms
Bukkit
Folia
Paper
Purpur
Spigot

Changes

AntiAFKPlus v2.9 ā€” AFK Time Windows

Release type: Feature Update Compatibility: Minecraft 1.16 ā€“ 1.21.10 | Java 17+

What's New

šŸ•’ AFK Time Windows

  • Configurable Time Ranges: Define daily hour ranges where AFK actions are paused or modified

  • Multiple Behaviors: Choose how the plugin handles AFK detection during configured windows:

    • SKIP_ACTIONS: Suppress all warnings, countdowns, and kicks
    • MESSAGE_ONLY: Suppress actions and send informational message
    • EXTEND_THRESHOLD: Delay final action by configurable seconds
    • DEFAULT: Normal AFK enforcement (used outside windows)

  • Timezone Support: Use server timezone or specify any IANA timezone ID (e.g., America/New_York, Europe/London)

  • Wrap-Around Ranges: Support for overnight ranges (e.g., 22:00-02:00)

  • Bypass Permission: Staff can ignore windows with antiafkplus.window.bypass

šŸ“ Configuration Example

afk-windows:
  enabled: true
  timezone: "SERVER"              # or explicit IANA ID like "America/New_York"
  ranges:
    - "08:00-12:00"
    - "20:00-23:00"
  behavior-inside-window: "SKIP_ACTIONS"
  behavior-outside-window: "DEFAULT"
  extend-seconds: 900             # used when behavior is EXTEND_THRESHOLD
  bypass-permission: "antiafkplus.window.bypass"

šŸŽ® Use Cases

  • Peak Hours Protection: Disable AFK kicks during busy server hours
  • Event Periods: Pause AFK enforcement during special events
  • Off-Hours Flexibility: Allow extended AFK times during late night/early morning
  • Regional Adaptation: Use different timezones for international servers

šŸ”§ Technical Details

  • TimeWindowService: Minute-level granularity with intelligent caching
  • AFKManager Integration: Evaluates windows before warnings and final actions
  • Countdown/Transfer Compatibility: Pipelines and sequences respect window controls
  • Reload Support: /afkplus reload updates window settings without restart

āœØ New Permission

  • antiafkplus.window.bypass: Allows players to ignore AFK windows and receive normal enforcement
    • Automatically included in antiafkplus.* wildcard
    • Useful for staff testing and development accounts

Compatibility

  • Minecraft: 1.16 ā€“ 1.21.10
  • Platforms: Bukkit, Spigot, Paper, Purpur, Folia
  • Java: 17+
  • Backward Compatible: All existing configurations work without changes

Upgrade Notes

  1. Replace the old JAR with AntiAFKPlus v2.9
  2. Optional: Configure afk-windows section in config.yml to enable time-based protection
  3. Optional: Customize the afk-window-active message in messages.yml for localization
  4. Update your dependency to 2.9 if using the API:
    <dependency>
    <groupId>com.github.koyere</groupId>
    <artifactId>AntiAFKPlus</artifactId>
    <version>2.9</version>
    <scope>provided</scope>
</dependency>

No configuration changes are required. The plugin works with your existing setup. AFK windows are disabled by default.

For Developers

API Version: 2.9 (unchanged from 2.8, no breaking changes)

The time window system is internal and transparent to the API. Developers using the API will benefit from the improved flexibility without code changes.

Version: 2.9 Release Date: 14/11/2025 Compatibility: Minecraft 1.16 - 1.21.10 Java: 17+