AntiAFKPlus v3.0 Premium — What's New

[HR][/HR]

## ️ In-Game GUI — Configure everything without editing files

Open with /afkplus gui (requires antiafkplus.reload permission).

Main Menu — Central hub with 11 interactive buttons:

• Detection Settings, Module Toggles, General Settings, Zone Settings, Reward Settings
• Credit System toggle, Detection Profile selector, Debug toggle, Reload Config
• Performance stats (live TPS, memory, operations)
• Language selector — change the server language instantly

General Settings — Adjust AFK timing without restarting:

• Default AFK Time: click to add 30 seconds, sneak+click to subtract
• Check Interval: click +1s, sneak+click -1s
• Max Voluntary AFK Time: click +60s, sneak+click -60s
• Toggle: Block item pickup while AFK
• Toggle: Broadcast AFK state changes to chat

Detection Settings — View and toggle pattern detection features:

• Displays current values: water circle radius, min samples, max violations, analysis interval
• Toggle: Linear movement exclusion (reduces false positives)
• Toggle: Large pool detection
• Toggle: Keystroke timeout detection

Module Toggles — Enable/disable 8 feature modules with one click:

• Pattern Detection, Autoclick Detection, Player Protection, AFK Zones
• Reward System, Visual Effects, Database, Analytics
• Changes apply immediately — the wool color switches from red to green (or vice versa)

Zone Settings — Configure AFK zone management:

• Toggle: Zone management on/off
• Toggle: Require WorldGuard
• Toggle: Default AFK allowed in zones
• Adjust: Default zone timeout (click/sneak+click)
• Toggle: Region inheritance from parent WorldGuard regions

Reward Settings — Configure the AFK reward system:

• Toggle: Reward system on/off
• Toggle: Require Vault economy
• Adjust: Max daily rewards (±10 per click)
• Adjust: Required active time before rewards (±5 min per click)
• Toggle: IP-based limits to prevent alt abuse

Language Selector — 10 languages displayed as books:

• The active language shows as an enchanted book with a green ✔
• Click any language to switch instantly — the entire plugin changes language immediately
• No restart needed

All changes made in the GUI are saved to config.yml automatically and take effect immediately.

[HR][/HR]

## Detection Profiles — One-click sensitivity presets

Instead of manually adjusting 4+ detection parameters, choose a preset:

Profile	Max Violations	Threshold	Min Samples	Grace Period	Best For
Conservative	12	0.98	50	90s	Survival servers, fewer false positives
Balanced	8	0.95	40	60s	Most servers (default)
Aggressive	4	0.85	25	30s	Minigame servers, strict anti-AFK

How to use: Open the GUI ( /afkplus gui) and click the book icon "Detection Profile". Each click cycles to the next profile. The change applies immediately.

[HR][/HR]

## ✨ Visual Effects — See who's AFK at a glance

Three visual indicators for AFK players, all independently configurable:

Particles — Floating particles above AFK players' heads:
Tab List Prefix — [AFK] appears before the player's name in the tab list:
Display Name Prefix — [AFK] appears before the player's name in chat:
To enable: set modules.visual-effects.enabled: true in config.yml, or toggle it in the GUI under Module Toggles.

Effects apply automatically when a player goes AFK and are removed when they return. Names are restored on disconnect and plugin shutdown.

[HR][/HR]

## Credit System — New features

Transfer credits between players
Players can send their AFK credits to others:
Sends 30 minutes of credits to Steve. Validates: sufficient balance, recipient's max credits, prevents self-transfer.
Permission: antiafkplus.credit.transfer

Credit leaderboard
See who has the most credits:
Credit multiplier events
Admins can start temporary bonus events:
Broadcasts to all online players when activated. Multiplier range: 0.1x to 10x. Duration: 1 to 1440 minutes.
Permission: antiafkplus.reload

[HR][/HR]

## PlaceholderAPI — All available placeholders

Requires PlaceholderAPI installed on the server.

Placeholder	Returns	Example
%antiafkplus_status%	AFK status text	AFK, ACTIVE, MANUAL AFK
%antiafkplus_afktime%	Seconds since last activity	120
%antiafkplus_credits%	Credit balance (minutes)	45
%antiafkplus_credits_hours%	Credit balance (hours)	2
%antiafkplus_max_credits%	Max credits for player	120
%antiafkplus_credit_ratio%	Earning ratio	5:1
%antiafkplus_in_afk_zone%	In AFK zone?	true / false
%antiafkplus_credits_expire_days%	Days until credits expire	5
%antiafkplus_credits_rank%	Leaderboard position	3

Tip — Show [AFK] in tab list via PlaceholderAPI:

Edit your language file ( languages/en.yml):
Then use %antiafkplus_status% in your tab/chat plugin (TAB, LuckPerms, etc.).

[HR][/HR]

## Plugin Status & Performance

/afkplus status — Quick overview
Shows: plugin version, server uptime, online/AFK player count, enabled modules, pattern detection and credit system status, TPS, memory usage.
Permission: antiafkplus.stats

/afkplus performance — Detailed metrics
Shows: server TPS, average execution time per operation, total operations count, memory usage, cache entries, tracked components.
Permission: antiafkplus.stats

[HR][/HR]

## Integrations

Vault Economy — Connects with any Vault-compatible economy plugin. Detected automatically via reflection.
Enable: integrations.vault.enabled: true

DiscordSRV — Sends AFK notifications to your Discord server automatically.
Enable: integrations.discordsrv.enabled: true

[HR][/HR]

## 10 Languages — Full internationalization

Included languages:
English (en), Español (es), Français (fr), Deutsch (de), Português (pt), Русский (ru), 中文 (zh), 日本語 (ja), 한국어 (ko), Italiano (it).

How to change:
Option 1: In the GUI ( /afkplus gui -> Language icon).
Option 2: In config.yml ( default-language: "es").

[HR][/HR]

## ⚙️ Configuration Improvements

• Config.yml reduced 44% (now 580 lines).
• Single toggle per feature.
• Time units standardized to seconds.
• Plugin size: 396 KB (down from 3.2 MB).

[HR][/HR]

## All Commands

Command	What it does	Permission
/afk	Toggle your AFK status	antiafkplus.afk
/afk list	See who's AFK	antiafkplus.list
/afkplus gui	Open the settings GUI	antiafkplus.reload
/afkcredits transfer	Send credits to player	antiafkplus.credit.transfer

[HR][/HR]

## ⚠️ Upgrading from v2.x

• messages.yml no longer exists — messages are now in languages/en.yml.
• enhanced-detection section removed — use modules.pattern-detection.enabled.
• Time keys renamed from -ms to -seconds.

The plugin auto-migrates your config on first startup. A backup is recommended.

[HR][/HR]

## Compatibility

• Platforms: Bukkit, Spigot, Paper (Recommended), Purpur, Folia.
• Versions: 1.16 to 1.21.x.
• Java: 17 or higher.
• Bedrock: Full support via Geyser/Floodgate.