BetterAFK

PlaceholderAPI Support This is useful if servers use other plugins that change the tab or the scoreboard.

This means that the AFK data and values can also be used in other plugins.

The following placeholders are available:

%betterafk_afk_status% (returns AFK, if a player is AFK)

%betterafk_invulnerability_status% (returns invulnerable, if a player is invulnerable)

%betterafk_afk_query% (returns true or false, true if a player is AFK)

%betterafk_afk_minutes% (returns the minutes a player is AFK, nothing if the player is not AFK)

Please note that you must also download the PlaceholderAPI plugin here to use this feature: https://www.spigotmc.org/resources/placeholderapi.6245/

A simple stylistic AFK plugin with holograms which is fully customisable. Check the gallery.

Preview

Features

Always check the changelog to find out about the latest features and how they work

• PlaceholderAPI Support
• Support for vanished players
• Optional permission to go AFK
• Built on the principle of not stealing performance
• With /afk a player can put himself in afk mode
• AFK player positions are locked
• kick-feature: The player is kicked from the server after a certain time
• immortality-feature: AFK players are invulnerable and cannot take damage
• Holograms integrated to make the afk display more modern and clearer
• Possibility to start the holograms higher so that they do not overlap
• Leave a value for a hologram empty with "" to simply deactivate it
• Completely customisable
• Built-In reload command (/betterafk reload)
• Each message and time values can be changed in the config

Permissons

• betterafk.use which allows players to go AFK (must first be activated in the config)
• betterafk.reload which allows players to reload the config.yml. (OP Players can reload the config.yml by deafult)

Bug report & support

If you need help or have a bug please contact our Team via Discord. We will guarantee quick help - Thanks for supporting :)

config.yml

Simple config. Change the messages and time values according to your wishes. Minecraft color codes (use &) fully integrated!

# ==========================================
# BetterAFK – config.yml
# ==========================================
# Here you can customise all messages and times according to your wishes.
# Minecraft color codes are possible with a "&"
# Times are measured in seconds (e.g. 5 minutes = 300 seconds)
# Check the plugin page for more information:
# https://modrinth.com/plugin/betterafk
# ==========================================
# If you need help or have a bug please contact our team via discord (https://dsc.gg/betterplugins).
# We will guarantee quick help - Thanks for supporting :)
# ==========================================


# Here you can change the time for when a player is automatically set afk (and if they should)
# Also if players should need a permission ("betterafk.use") to go AFK and the error message

afk:
  auto_timeout_enabled: true
  timeout: 180
  require_permission: false
  no_permission_message: "&7You have no permission to go &cAFK&7."

# Here you can deactivate the tab prefix

tab_prefix:
  enabled: true
  value: " &c&lAFK"

# Here you can deactivate the symbol (the barrier) over the holograms if you don't like it or skip one hologram space
# if skip_one_hologram is set to true, the holograms start one hologram place higher (If displaying ranks or hearts above the name this is useful)

holograms:
  barrier: true
  skip_one_hologram: false

# Here you can select if a player should be kicked after a certain time and the message if so

kick:
  enabled: true
  time: 600
  message: "&7You were &ckicked &7for being AFK too long!"

# Here you can select whether you want to block the position of AFK players and the message for that.
# This prevents them from being pushed away (by players, entities or water for example).

lock_position:
  enabled: true
  message: "&7You can no longer move because you have been marked as &c&lAFK&7. Type &c/afk &7to move again."
  action_bar_message: "&7You cannot move &c&lwhile AFK&7!"

# Here you can choose if a player should be invulnerable and immortal after a certain time in afk mode and the message if so
# Note: a value of over 3 seconds is recommended to prevent players from exploiting this feature

immortality:
  enabled: true
  delay: 10
  status: "&ainvulnerable"
  hologram: true
  message: "&7You are now &dinvulnerable &7due to AFK mode!"

# Here you can customise all messages, units and the holograms to your liking
# Use these placeholders:
# %player% - The name of the AFK player
# %time% - Minutes a player is/was AFK
# %unit% - The correct unit (minute/minutes)
# %target% - The name of the targeted player for /afk <nick>

messages:
    action_bar: "&7You are now &c&lAFK&7!"
    chat_afk_start: "&d%player% &7is now &c&lAFK&7."
    chat_afk_end: "&d%player% &7is no longer &c&lAFK &7after &c&l%time% &7%unit%."
    hologram_line1: "&c&lAFK"
    hologram_line2: "&7since %time% %unit%"
    vanished_afk_message: "&7You are now &c&lAFK&7. Since you're vanished, no messages or holograms will be displayed."
    chat_afk_vanished_end: "&7You were &c&lAFK &7for &c&l%time% &7%unit%."
    unit_singular: "minute"
    unit_plural: "minutes"