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.).