AntiAFKPlus Premium 3.1

AntiAFKPlus Premium
Smart, configurable, and battle-tested AFK management — built for serious servers.

✦ Spigot & Paper 1.16–1.21+ ✦ Folia ✦ BungeeCord & Velocity ✦ Bedrock/Floodgate ✦

✦ Designed for Spigot ✦

AntiAFKPlus is a premium AFK management plugin that goes far beyond a simple kick timer. It detects AFK farming, autoclickers, water-circle exploits, and repetitive movement patterns — then acts on them automatically.

Built with a modular architecture, every feature is independently toggleable. You only run what you need. No bloat, no wasted resources.

Whether you run a small Survival server or a large network with BungeeCord, AntiAFKPlus has a configuration for you.

🔍 Intelligent AFK Detection

1. Smart pattern detection — identifies water circles, AFK pools, confined movement loops, and repetitive paths
2. Autoclick detection — flags suspiciously fast or rhythmic clicking patterns
3. Configurable sensitivity — tune thresholds for water-circle radius, min samples, pattern similarity, max violations
4. False positive reduction — linear movement exclusion, activity grace period, direction variance filters
5. Activity scoring — weighted scoring per activity type (movement, chat, combat, interaction, crafting, etc.)
6. Detection profiles — one-click presets: Conservative / Balanced / Aggressive

💳 Credit System

1. Earn credits through active play — configurable ratios (e.g. 5 active minutes = 1 AFK credit)
2. Spend credits to delay kicks when going AFK
3. Transfer credits between players with /afkcredits transfer
4. Leaderboard — /afkcredits top to see top credit holders
5. Credit multiplier events — admins can run temporary 2x/3x credit events
6. Credit expiry — optional decay system with configurable expiry days
7. Per-rank ratios & caps — VIP, Premium, Admin all have independent limits

🎮 In-Game GUI

1. Full 54-slot settings panel — configure everything without touching YAML
2. Live TPS and memory stats visible in the GUI
3. Module toggles — enable/disable any feature module with a single click
4. Detection profile selector — switch between Conservative, Balanced, Aggressive
5. Open with /afkplus gui

🌍 WorldGuard AFK Zones

1. Define regions where AFK is allowed, restricted, or managed differently
2. Per-zone timeouts, reward multipliers, teleport actions
3. Players earn credits in the AFK zone — then return with /afkback
4. Region inheritance support

🎨 Visual Effects

1. Particle effects — any Bukkit particle type above AFK players
2. TAB list prefix + suffix — e.g. §7[AFK] PlayerName — fully color-coded
3. Display name prefix + suffix — visible in chat and above the player
4. Holograms (DecentHolograms) — floating [AFK] text above players

🛡️ Player Protection

1. Invulnerability when AFK — block fall, fire, lava, and drowning damage
2. Block inventory access while AFK
3. PvP protection — optional PvP invulnerability for AFK players
4. Movement restriction — prevent AFK players from being moved
5. Command whitelist while AFK (e.g. allow /afk, /spawn)

🌐 Integrations

1. PlaceholderAPI — 9 built-in placeholders for TAB plugins, scoreboards, and chat formatters
2. Vault — economy integration for the reward system
3. DiscordSRV — AFK state change notifications sent to Discord automatically
4. WorldGuard — zone-based AFK management
5. BungeeCord / Velocity — transfer AFK players to another server instead of kicking
6. Folia — full compatibility with Folia's regional threading model
7. Floodgate / Bedrock — works seamlessly with Java and Bedrock players

🏆 Reward System

1. Time-based rewards — run commands at configurable AFK intervals (5 min, 15 min, etc.)
2. Anti-abuse — daily reward caps, required playtime, account age, IP-based limits
3. Requires active time before AFK rewards are earned

⏰ Advanced Controls

1. AFK Time Windows — restrict AFK actions to specific hours of the day
2. Per-world control — enable or disable AFK checks per world
3. Per-permission timeouts — VIP gets 10 min, Staff gets 30 min, etc.
4. Multi-warning system — warn at 60s, 30s, 10s before kick (fully configurable)
5. Manual AFK toggle — players can go AFK on demand with /afk
6. Broadcast toggles — control who sees AFK enter/exit messages

🌎 10 Built-In Languages
English · Spanish · French · German · Portuguese · Russian · Chinese · Japanese · Korean · Italian
All ~150 message keys are fully editable. Add your own language by dropping a .yml in the languages/ folder.

Use these in any TAB, chat, or scoreboard plugin that supports PlaceholderAPI:

⌨️ Commands

[SPOILER=Click to view all commands]

[/SPOILER]

[SPOILER=Click to view all permissions]

[/SPOILER]

[SPOILER=Core AFK Settings]

# Seconds before a player is considered AFK
default-afk-time: 300

# Warning times (seconds before kick)
afk-warnings:
  - 60
  - 30
  - 10

# Per-rank timeouts (override default)
permission-times:
  "antiafkplus.time.vip": 600
  "antiafkplus.time.staff": 1800
  "antiafkplus.time.premium": 900
  "antiafkplus.time.donator": 1200

# Per-world control
enabled-worlds:
  - "world"
  - "world_nether"
  - "world_the_end"

[/SPOILER]

[SPOILER=Pattern Detection]

modules:
  pattern-detection:
    enabled: true
    water-circle-radius: 5.0
    min-samples-for-pattern: 40
    repetitive-movement-threshold: 0.95
    max-pattern-violations: 8
    large-pool-detection: true
    keystroke-timeout-seconds: 180
    linear-movement-exclusion: true
    activity-grace-period-seconds: 60

[/SPOILER]

[SPOILER=Visual Effects]

visual-effects:
  particles:
    enabled: true
    type: "CLOUD"
    count: 5
  tab-list:
    enabled: true
    afk-prefix: "&7[AFK] "
    afk-suffix: ""
  name-tags:
    enabled: false
    afk-prefix: "&7[AFK] "
    afk-suffix: ""
  holograms:
    enabled: false
    provider: "DecentHolograms"
    lines:
      - "&c[AFK]"
      - "&7{player}"
      - "&eAFK for {time}"

[/SPOILER]

[SPOILER=Credit System]

credit-system:
  enabled: true
  credit-ratios:
    default: "5:1"   # 5 active min = 1 AFK credit
    vip: "4:1"
    premium: "3:1"
    admin: "2:1"
  max-credits:
    default: 120
    vip: 180
    premium: 240
    admin: 480
  credit-decay:
    enabled: false
    expire-after-days: 7

[/SPOILER]

AntiAFKPlus exposes a clean, thread-safe API for plugin developers. Available via JitPack.

[SPOILER=Maven / Gradle dependency]

    
        jitpack.io
        https://jitpack.io
    



    com.github.koyere
    AntiAFKPlus
    3.0
    provided

[/SPOILER]

[SPOILER=API usage example]

AntiAFKPlusAPI api = AntiAFKPlusAPI.getInstance();

// Check AFK status
boolean isAfk = api.isAFK(player);
AFKStatus status = api.getAFKStatus(player); // ACTIVE, AFK_IDLE, AFK_WARNED, AFK_VOLUNTARY

// Activity info
Duration inactive = api.getTimeSinceLastActivity(player);
PlayerActivityInfo info = api.getActivityInfo(player);

// Pattern detection
if (api.hasSuspiciousPatterns(player)) {
    List patterns = api.getDetectedPatterns(player);
}

// Credit system
long balance = api.getCreditBalance(player);
api.addCredits(player, 15);
api.consumeCredits(player, 5);

// Listen to events
api.registerAFKStateListener(event -> {
    // fires on AFK state changes
});

api.registerPatternDetectionListener(event -> {
    if (event.getPattern().getConfidence() > 0.9) {
        event.getPlayer().kickPlayer("Bot detected");
    }
});

[/SPOILER]

All events fire synchronously on the main thread. Async methods (*Async()) available for heavy operations. Full documentation in API.md on GitHub.

[LIST=1]Purchase and download the latest AntiAFKPlus-3.0.jarDrop it into your /plugins/ folderRestart your server (or use /reload — restart preferred)Configure /plugins/AntiAFKPlus/config.yml as desiredUse /afkplus reload to apply changes without restarting
[/LIST]

Optional dependencies: PlaceholderAPI · WorldGuard · Vault · DiscordSRV · DecentHolograms · Floodgate