• permission-times now works. Per-rank AFK times were ignored entirely — every player fell back to default-afk-time regardless of their rank. This affected every config (the shipped format and hand-written nested layouts alike), because dotted keys are stored as nested sections and were not being read back. Permission times are now parsed correctly, and when a player matches several ranks the longest time is used. Both layouts below are valid and equivalent:
  
  permission-times:
    "antiafkplus.time.vip": 120     # flat
  # --- or ---
  permission-times:
    antiafkplus:
     time:
       vip: 120                    # nested
   
• afk-action no longer stops working after a while. With actions like COMMAND or TELEPORT, the AFK action could silently stop firing server-wide after some uptime (players still showed AFK particles but nothing happened), and only came back after a restart. A failure while running the action for a single player could halt the whole AFK check loop. The loop is now isolated per player and command failures are logged instead of breaking everything, so one bad case can't take the system down.
   
• Small AFK pools could block detection indefinitely. A player sitting in a compact water pool (e.g. a 3x3 with a solid center block) could go undetected forever. The water current bouncing the player off the pool's corners was mistaken for real keyboard input, which kept resetting the anti-bypass system's "player is active" window and stopped it from ever analyzing the player's movement pattern. That water-bounce signal is no longer treated as manual input, so pattern detection now runs and catches these pools as intended.
   
• Pattern violations could get stuck and never reach the kick threshold. Even after the fix above, a player idling in water could still bob up and down while technically staying "on the ground" (standing on the pool floor or a center block). That bobbing was mistaken for a real jump, which reset the same "player is active" window and kept knocking the violation count back down before it could reach the configured threshold. Vertical water bobbing is no longer counted as a jump, so violations can now build up properly and trigger the configured AFK action.
   

1. Stop the server.
2. Replace the JAR with AntiAFKPlus-3.2.1.jar.
3. Start the server.

Bug Fixes

• 
  
• 
  

  No more instant kicks after a reload. Players already online during a /reload (or PlugMan/live install) were marked AFK and kicked within seconds, ignoring default-afk-time. They are now treated as active and only go AFK after the configured time.

  
  
• 
  

  permission-times now applies the longest matching time. A player with several matching ranks (or a wildcard/OP permission) could get a random, shorter timeout. The most generous matching value is now used. default-afk-time still applies when no rank matches.

  
  
• 
  

  No more AFK while actively riding. Driving a boat, happy ghast, horse, etc. holding W (straight forward) wrongly triggered AFK; only A/S/D broke out. Active steering (W/A/S/D, jump, sneak) now counts as activity. Passive movement (e.g. a drifting boat) still does not, so AFK detection stays accurate. Steering detection requires Minecraft 1.21.3+.

  
  

No configuration changes are required for any of these fixes.

🔧 How to Update

1. 
   
2. Stop the server.
3. Replace the JAR with AntiAFKPlus-3.2.jar.
4. Start the server.

• Root cause: the performance optimizer compared the whole JVM heap usage against a 50 MB budget — always true on a real server — and forced a full System.gc() every 5 seconds. Each forced GC is a stop-the-world pause that breaks tick timing.
• Fix: the periodic forced GC has been removed. Memory cleanup now runs only under genuine heap pressure (used heap above 90% of the JVM max). CPU usage is also measured correctly now, so it no longer triggers spurious internal adjustments. No config change needed.

• Root cause: EssentialsX (and any plugin with an AFK teleport feature) processes /afk independently and teleports the player to its own AFK zone. The teleport — and the landing/gravity movement right after it — was counted as real player activity, immediately cancelling the manual AFK state.
• Fix: when a plugin teleports a player who went manually AFK within the last 15 seconds, neither the teleport nor the brief movement that follows it unmarks them. After the 15-second grace period, plugin teleports count as normal activity. No config change needed.
• Recommended config action: Disable EssentialsX's /afk in its config to avoid dual handling:
  
  

  # EssentialsX config.yml

  disabled-commands:

    - afk
   
  Then configure teleportation in AntiAFKPlus instead (afk-action.type: TELEPORT or zone-management).

• Face alternation: a door's clickable face changes when it opens (panel rotates 90°). The passive-repeat filter compared faces exactly, so each click was treated as a new action. Fix: doors and trapdoors now use a face-agnostic comparison. Two-tall door clicks are normalized to the bottom half.
• Air clicks through the open door: after the door opens, the auto-click lands on air. Fix: air clicks are suppressed when the player has not moved since the last door toggle. The same suppression applies to clicks on blocks within 2 blocks of the door (the "block behind the open door" scenario) but not beyond, so functional blocks farther away are never affected.

• Fix: {seconds} in the subtitle now uses secondsRemaining (actual time left). No config change needed.

• Fix: pending warnings are cleared whenever a player enters a disabled or non-enabled world, regardless of whether they were already marked AFK. No config change needed.

• Fix: all Bedrock welcome and tip messages now check for null/empty before sending. Setting any of these keys to "" correctly suppresses the message. No config change needed.

1. Stop the server.
2. Replace the plugin JAR with AntiAFKPlus-3.1.1.jar.
3. Start the server — no config changes required unless noted above.

It is very important that you update to version 3.1, as it corrects bugs that could cause the plugin to malfunction.

AntiAFKPlus v3.1 — Changelog

Bug Fixes

• 
  
• 
  

  Console spam from activity logs — [Activity] log lines no longer appear in the console by default. They only show when debug: true is set in config.yml. Core AFK messages (player went AFK, returned, kicked) always appear regardless.

  
  
• 
  

  Blank chat lines when a message is set to "" — Setting any message to an empty string in the language file no longer sends a blank line to the player's chat. It is silently skipped.

  
  
• 
  

  AFK pool bypass via water current — Players inside a water AFK pool could avoid detection indefinitely because water current movement was counted as real activity. Fixed: only manual input (swimming, looking around, jumping, sprinting) counts as activity.

  
  
• 
  

  Door spam-click bypass — Repeatedly clicking a door (manually or with an auto-clicker) was resetting the AFK timer indefinitely. Fixed.

  
  
• 
  

  "Use Item: toggle" bypass on levers and buttons — Holding right-click on levers or buttons prevented AFK detection. Fixed.

  
  
• 
  

  "Attack/Destroy: toggle" bypass on cobblestone generators — Holding left-click on a cobble generator prevented AFK detection indefinitely. Fixed.

  
  
• 
  

  "No longer AFK" broadcast missing or delayed — When a player returned from AFK by sending a chat message, the server broadcast frequently never appeared. It now fires immediately.

  
  
• 
  

  AFK warning messages showed wrong countdown value — The "you will be kicked in {seconds}s" warning displayed the configured threshold instead of the actual time remaining. Fixed.

  
  
• 
  

  AFK warnings not reset after world change — Players who received warnings and then moved to a disabled world would not receive them again on returning. Fixed.

  
  
• 
  

  GUI shift+click did not decrease numeric values — In the settings GUI, shift-clicking was supposed to decrease a value but always increased it instead. Fixed.

  
  
• 
  

  Large AFK pool detection not working — Players in pools larger than 5×5 blocks were never detected even with the feature enabled. Fixed.

  
  
• 
  

  GAMEMODE and COMMAND actions ignored in global AFK action — Setting afk-action.type: GAMEMODE or COMMAND silently fell through to a kick. Both actions now work correctly. GAMEMODE reads afk-action.gamemode; COMMAND reads afk-action.command with {player} / {uuid} support.

  
  

Config / Connectivity Fixes

• 
  
• 
  

  database.enabled ignored by SQL storage — SQL storage now activates correctly when either database.enabled or credit-system.database.enabled is true.

  
  
• 
  

  DiscordSRV pattern alerts never fired — With integrations.discordsrv.send-pattern-alerts: true, a Discord message is now sent when a suspicious pattern is detected, including the player name, pattern type, and confidence level.

  
  
• 
  

  performance.adaptive-intervals had no effect on the AFK check task — The option now correctly adjusts the AFK check interval based on server TPS.

  
  

New Features

Reward system (reward-system) — now functional

• 
  
• Tracks AFK time and fires configured reward-system.intervals.* thresholds once per AFK session.
• Respects require-active-time-minutes, max-daily-rewards, and require-vault.
• Executes console commands and sends player messages. Supports {player} and {uuid} placeholders.

Analytics system (analytics) — now functional

• 
  
• Enable with analytics.enabled: true in config.yml.
• Automatic daily reports generated at midnight in JSON or CSV format (set via analytics.export-format). Files are saved to plugins/AntiAFKPlus/analytics/.
• New commands:
  
  • 
    
  • /afkplus analytics — shows a live in-memory summary.
  • /afkplus analytics export — forces an immediate export.
  • Permission required: antiafkplus.stats.

Hologram support — DecentHolograms and FancyHolograms

• 
  
• A floating hologram appears above AFK players when visual-effects.holograms.enabled: true.
• Auto-detects DecentHolograms first, then FancyHolograms. If neither is installed, holograms are simply disabled.
• Text lines, height offset, and update interval are all configurable under visual-effects.holograms.* in config.yml.
• Supports {player} and {time} placeholders (e.g. &eAFK for {time}).

Bedrock / GUI adaptation (Geyser/Floodgate)

• 
  
• Player-facing messages and GUI menus now adapt automatically when a player is connected from Bedrock Edition via Geyser or Floodgate.

Compatibility

• 
  
• Paper 1.16 — 26.1.2+
• Folia (all versions)
• Spigot 1.16+
• Purpur, Pufferfish, and other Paper forks
• Bedrock via Geyser/Floodgate
• PlaceholderAPI
• DecentHolograms (optional)
• FancyHolograms (optional)

Migration

Drop-in update — no changes required, except for the two notes below.

How to Update

1. 
   
2. Stop the server.
3. Replace the plugin JAR with AntiAFKPlus-3.1.jar.
4. Start the server.

AntiAFKPlus v3.0.4 — Changelog

⚡ Performance

Reduced load on the server main thread

Problem: On servers with many players and active timers, the plugin could contribute to small TPS dips (for example, TPS hovering around 19 instead of a steady 20). Profiling tools (like spark) showed AntiAFKPlus as one of the points where the server was spending time waiting, even though CPU usage looked low.

Cause: An internal check the plugin ran on every scheduled task to know whether the server was paused. That check, repeated many times per second, produced small stalls that, added up, affected TPS.

Fix: The check was rewritten so that:

• 
  
• It only really runs once per tick, no matter how many tasks are active.
• It is skipped entirely on platforms where it does not apply (Spigot and forks without Paper's pause API). On those, the cost is now literally zero.

Expected result: More stable TPS and a much smaller footprint in profiling reports, especially on servers with high concurrency, the credit system enabled, particles, or multiple worlds.

No visible plugin behavior was modified: AFK detection, punishments, messages, and commands work exactly the same.

✅ Compatibility

• 
  
• Paper 1.16 — 1.21+
• Folia (all versions)
• Spigot 1.16+
• Purpur, Pufferfish, and other Paper forks
• Bedrock via Geyser/Floodgate (unchanged)
• PlaceholderAPI (unchanged)

📦 Migration

No action required.

• 
  
• No changes to config.yml.
• No changes to language files (languages/*.yml).
• No changes to permissions.
• No changes to the public API.

Players currently in AFK state when the server restarts will keep their usual behavior.

🔧 How to Update

1. 
   
2. Stop the server.
3. Replace the plugin JAR with AntiAFKPlus-3.0.4.jar.
4. Start the server.

That's it.

AntiAFKPlus v3.0.2 — Changelog

✨ New Features

Global AFK Action (afk-action)

Configure what happens when a player goes AFK directly in config.yml — no zone management or WorldGuard needed.

afk-action:
  type: "TELEPORT"
  teleport-location: "world,250,76,30"

Available actions: KICK, TELEPORT, MARK_AFK_ONLY, NONE

Exempt Worlds (afk-action.exempt-worlds)

Worlds where players get marked as AFK (tab list prefix, visual effects) but are not teleported or kicked. Perfect for spawn worlds.

afk-action:
  type: "TELEPORT"
  teleport-location: "world,250,76,30"
  exempt-worlds:
    - "world_spawn"

Players in world_spawn will show as AFK in tab but won't be teleported. Players in other worlds will be teleported normally.

Hex Color Support

Language files and messages now support hex colors (1.16+):

• 
  
• &#e5be01 format
• {#e5be01} format
• #e5be01 format

Example in your language file:

kick-action-teleport: "&#e5be01[Server] &fYou have been teleported."

🐛 Bug Fixes

Messages always in English on first startup (Critical)

The ConfigManager loaded messages before the LocalizationManager was initialized, so all cached messages (kick warning, AFK state, teleport) defaulted to English. Even after restart, the cached values stayed in English. Fixed: Messages are now reloaded after the localization system is ready.

Players kicked even with TELEPORT configured

Custom zone names (e.g., spawn_final, lobby) were ignored — only "spawn" worked. Now any zone name works.

Zone management required WorldGuard for simple setups

require-worldguard defaulted to true. Now defaults to false.

Warning times showed wrong numbers (29 instead of 30)

Warnings now display the exact configured time (30, 10, 5) instead of the calculated remainder that varied with the check interval.

Warning titles on screen always in English

The on-screen title ("⚠ AFK Warning") was hardcoded. Now reads from your language file (warning-title-standard, warning-subtitle-standard).

Teleport message always in English

Hardcoded. Now reads kick-action-teleport from your language file.

Pattern detection warnings in English

Hardcoded. Now reads suspicious-activity and pattern-violation-kicked from your language file.

Bedrock welcome messages in English

Hardcoded. Now reads from language file (bedrock-detected, bedrock-tip-mobile, bedrock-tip-console, bedrock-tip-desktop).

Language files incomplete

All 10 languages now fully translated. No English leftovers.

📋 Improvements

• 
  
• Config documentation with inline examples for afk-action and zone-management
• Startup validation warns about misconfigured teleport locations
• Action priority: Zone Management > Global afk-action > Server Transfer > KICK

🔧 How to Update

1. 
   
2. Replace the plugin JAR
3. Delete plugins/AntiAFKPlus/languages/ so new translated files are extracted
4. Restart the server
5. Add to your config.yml:

afk-action:
  type: "TELEPORT"
  teleport-location: "world,250,76,30"
  exempt-worlds:
    - "world_spawn"

Note: Back up your language files if you customized them. Re-apply changes after the new files are extracted.

Fix Show [AFK] in tab list via PlaceholderAPI:

Then use %antiafkplus_status% in your tab/chat plugin (TAB, LuckPerms, etc.).