BetterAFK

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"