BetterAFK

A simple stylistic AFK plugin with holograms which is fully customisable with PlaceholderAPI support

Загрузки: 2K
Подписчики: 9
Обновлён: 5 марта 2025 г.
Лицензия: All-Rights-Reserved

Опубликован 9 января 2025 г.

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"

Ченджлог

b2.3Бета1.21.4, 1.21.10, 1.21.11 · 5 марта 2025 г.

[+] Added support for mounted players - This means that players who are AFK and sitting on other players (e.g. with the help of GSit etc.) are no longer reset incorrectly when standing up

[IMPROV] Adjusted the update interval for updating the hologram position

2.2Релиз1.21.2, 1.21.3, 1.21.4 · 26 февраля 2025 г.

[NEW] Added ConfigUpdater, this will check if new values are available for the config.yml through updates. Old values will be saved.

[+] The command /betterafk reload can now be completed by tabulation

[FIX] The values for minutes and minutes can now be changed in config.yml.

[+] Values unit_singular and unit_plural added to the config.yml

[FIX] The AFK status is now correctly removed when an AFK player removes/places blocks or when interacting with a chest

[FIX] Fixed a bug where in some cases the immortality status was not removed correctly

2.1Релиз1.21.2, 1.21.3, 1.21.4 · 7 февраля 2025 г.

[NEW] Added an UpdateMonitor that checks if a newer version of BetterAFK is available when starting or reloading the server

[NEW] Added support for vanish players. Now when a player goes AFK in vanish mode, no chat messages are sent for other players. Also, the holograms are not created.

[+] Values vanished_afk_message and chat_afk_vanished_endadded to the config.yml

[NEW] You can now select whether players need a permission if they want to go afk

[+] Added permisson betterafk.use which allows players to go AFK in the config.yml (^ see above).

[+] Values require_permission and no_permission_message added to the config.yml

[FIX] Fixed a bug where you could not deactivate the AFK timeout in config.yml

[+] Value auto_timeout_enabled added to the config.yml

[CHANGE] If a text with "" is left blank in the messages in the config.yml, it will simply be deactivated

2.0Релиз1.21.2, 1.21.3, 1.21.4 · 1 февраля 2025 г.

[NEW] AFK players are now locked on their position by default. This also prevents them from being pushed away (e.g. by player entities or water). Can be deactivated in the config.yml

[+] Values lock_position.enabled, lock_position.message and lock_position.action_bar_message added to the config.yml

[NEW] It is now possible to display the holograms one position higher. This is useful when displaying ranks or hearts above the player's name. Simply set holograms.skip_one_hologram to true in config.yml (thanks to spira)

[+] Value holograms.skip_one_hologram added to the config.yml

[NEW] Added PlaceholderAPI support (thanks to spira)

Attention: The plugin now requires the placeholder api IF you want to use the BetterAFK placeholders in other Plugins (e.g. TAB), so make sure you download the latest version as well. You can get it here: https://www.spigotmc.org/resources/placeholderapi.6245/

[+] Added Placeholder: %betterafk_afk_status% (returns AFK, if a player is AFK)

[+] Added Placeholder: %betterafk_invulnerability_status% (returns invulnerable, if a player is invulnerable)

[+] Added Placeholder: %betterafk_afk_query% (returns true or false, true if a player is AFK)

[+] Added Placeholder: %betterafk_afk_minutes% (returns the minutes a player is AFK, nothing if the player is not AFK)

[+] Added another hologram that indicates the immortality status.

[+] Values immortality.status and immortality.hologram added to the config.yml

[+] Added new /betterafk reload command to simply reload the config.yml configurations/settings to not to interfere with other server mechanics while using /reload. This means also that it is no longer necessary to restart the server. Either people with the authorisation ‘betterafk.reload’ can use this command or players with operator status (op).

[+] Added permisson betterafk.reload which allows players to reload the config.yml (^ see above).

[CHANGE] If a text with "" is left blank in the holograms in the config.yml, it will simply be deactivated (thanks to spira)

[FIX] Fixed a bug that caused the minutes a player is AFK to not be updated in the hologram (thanks to spira)

[FIX] Fixed a bug where in some cases the AFK status was removed when looking around (thanks to spira)

[IMPROV] Improvements to stability and general performance

[IMPROV] Updated API (Just internal)

b2.0Бета1.21.2, 1.21.3, 1.21.4 · 29 января 2025 г.

[NEW] Added PlaceholderAPI support. Attention: The plugin now requires the placeholder api in any case, so make sure you download the latest version as well. You can get it here: https://www.spigotmc.org/resources/placeholderapi.6245/

[+] Added Placeholder: %betterafk_afk_status% (returns AFK, if a player is AFK)

[+] Added Placeholder: %betterafk_invulnerability_status% (returns invulnerable, if a player is invulnerable)

[+] Added Placeholder: %betterafk_afk_query% (returns true or false, true if a player is AFK)

[+] Added another hologram that indicates the immortality status.

[+] Values immortality.status and immortality.hologram added to the config.yml

[+] Added permisson betterafk.reload which allows players to reload the config.yml (^ see above).

[CHANGE] If a text with "" is left blank in the holograms in the config.yml, it will simply be deactivated

[FIX] Fixed a bug that caused the minutes a player is AFK to not be updated in the hologram

[FIX] Fixed a bug where in some cases the AFK status was removed when looking around

[IMPROV] Improvements to stability and general performance

[IMPROV] Updated API (Just internal)

1.0Релиз1.21.2, 1.21.3, 1.21.4 · 10 января 2025 г.

Verion 1.0

BetterAFK

Preview

Features

Permissons

Bug report & support

config.yml

Ченджлог

Комментарии