HowLongAFK detects inactive players and transforms them into a realistic BlockDisplay tree 🌿 to visually represent AFK status in-game. The plugin tracks playtime and AFK time every second and stores all data permanently for later use.

Players can view their stats anytime using: /howlongafk profile (showing personal playtime, AFK time and more)

It also fully supports PlaceholderAPI, so you can use: /papi parse me %howlongafk_time% | %howlongafk_all% | %howlongafk_playtime% | %howlongafk_percent% | %howlongafk_avg% for scoreboards, chat and tablists 📊

Admins can be configured in the config file, unlocking additional permissions and control over AFK behavior and player statistics.

Perfect for immersive survival, RPG, or stats-driven servers 🌍

Config

# =================================================================
# HowLongAFK Configuration
# =================================================================

# Sprache des Plugins (de = Deutsch, en = Englisch)
# Plugin language (de = German, en = English)
language: de

# Der Prefix, der vor allen Nachrichten angezeigt wird
# The prefix displayed before all plugin messages
prefix: '&6&lHowlongafk &8» '

# Zeit in Minuten, bis ein Spieler automatisch als AFK markiert wird
# Time in minutes until a player is automatically marked as AFK
afk-time-minutes: 10

# =================================================================
# Konsolen und User Einstellungen
# Console and Allowed Users Settings
# =================================================================

# Erlaubt oder verbietet der Server-Konsole die Nutzung der
# Admin-Befehle (on, off, reload, afktime)
#
# True = Konsole darf Befehle verwenden
# False = Konsole wird vollständig blockiert
#
# Allows or blocks the server console from using
# admin commands (on, off, reload, afktime)
#
# True = Console can use commands
# False = Console is completely blocked
console-use: false

# Liste der Spieler, die die Admin-Befehle im Spiel verwenden dürfen
# (/howlongafk on/off/reload/afktime/profile <player>)
#
# Völlig unabhängig von OP, Permissions oder LuckPerms.
# Spieler, die hier nicht eingetragen sind, werden blockiert.
#
# List of players allowed to use admin commands in-game
# (/howlongafk on/off/reload/afktime/profile <player>)
#
# Completely independent of OP status, permissions,
# or LuckPerms groups.
# Players not listed here will be denied access.
allowed-users:
  - "D4rkSn0w"
  - "SilasGaming13"

# =================================================================
# Nachrichten / Messages
# =================================================================

messages:

  # ===============================================================
  # Deutsche Nachrichten
  # German Messages
  # ===============================================================
  de:
    no-permission: "&cDazu hast du keine Rechte!"
    player-not-found: "&cSpieler nicht gefunden."
    player-not-online: "&cSpieler ist nicht online."
    tracking-disabled: "&cFür diesen Spieler ist das Tracking deaktiviert."
    afk-marked: "&7Du bist nun als AFK markiert."
    afk-back: "&aDu bist nicht mehr AFK. Der Baum ist verschwunden!"
    global-on: "&aAFK-Tracking wurde global für ALLE online Spieler aktiviert."
    global-off: "&cAFK-Tracking wurde global für ALLE online Spieler deaktiviert."
    player-on-self: "&aAFK-Tracking wurde für dich aktiviert."
    player-on-other: "&aAFK-Tracking für %player% aktiviert."
    player-off-self: "&cAFK-Tracking wurde für dich deaktiviert."
    player-off-other: "&cAFK-Tracking für %player% deaktiviert."
    reload-success: "&aKonfiguration und Daten erfolgreich neu geladen!"
    afk-time: "&e%player% ist seit %time% afk"

  # ===============================================================
  # Englische Nachrichten
  # English Messages
  # ===============================================================
  en:
    no-permission: "&cYou do not have permission to do this!"
    player-not-found: "&cPlayer not found."
    player-not-online: "&cPlayer is not online."
    tracking-disabled: "&cTracking is disabled for this player."
    afk-marked: "&7You are now marked as AFK."
    afk-back: "&aYou are no longer AFK. The tree has disappeared!"
    global-on: "&aAFK tracking has been enabled globally for ALL online players."
    global-off: "&cAFK tracking has been disabled globally for ALL online players."
    player-on-self: "&aAFK tracking has been enabled for you."
    player-on-other: "&aAFK tracking enabled for %player%."
    player-off-self: "&cAFK tracking has been disabled for you."
    player-off-other: "&cAFK tracking disabled for %player%."
    reload-success: "&aConfiguration and data successfully reloaded!"
    afk-time: "&e%player% has been afk for %time%"

# =================================================================
# PlaceholderAPI Infos
# =================================================================
# (DE) Du kannst folgende Placeholder in kompatiblen Scoreboards, Tablisten oder Chat-Plugins verwenden:
# (EN) You can use the following placeholders in compatible scoreboards, tablists, or chat plugins:
#
# %howlongafk_time%
#      -> (DE) Aktuelle AFK-Zeit des Spielers (0 wenn online)
#      -> (EN) Current AFK time of the player (0 if online)
#
# %howlongafk_all%
#      -> (DE) Anzahl aller AFK-Spieler von allen getrackten (z.B. 2/10)
#      -> (EN) Amount of all AFK players out of tracked players (e.g., 2/10)
#
# %howlongafk_playtime%
#      -> (DE) Gesamte native Spielzeit des Spielers (Keine Konflikte mit anderen Plugins)
#      -> (EN) Total native playtime of the player (No conflicts with other plugins)
#
# %howlongafk_percent%
#      -> (DE) Prozentualer Anteil der AFK-Zeit zur gesamten Spielzeit
#      -> (EN) Percentage of AFK time compared to total playtime
#
# %howlongafk_avg%
#      -> (DE) Durchschnittliche AFK-Zeit pro Session
#      -> (EN) Average AFK time per session
#
# -----------------------------------------------------------------
# (DE) Test-Befehle (PlaceholderAPI muss installiert sein)
# (EN) Test Commands (PlaceholderAPI must be installed)
# -----------------------------------------------------------------
# (DE) Nutze diesen Befehl im Chat, um alle Platzhalter auf einmal zu testen:
# (EN) Use this command in chat to test all placeholders at once:
#
# /papi parse me %howlongafk_time% | %howlongafk_all% | %howlongafk_playtime% | %howlongafk_percent% | %howlongafk_avg%