# BetterAFK ![bStats Servers](https://img.shields.io/bstats/servers/24410?color=d55555) ![bStats Players](https://img.shields.io/bstats/players/24410?color=d55555) ![Minecraft versions](https://img.shields.io/modrinth/game-versions/OQORWMBK?color=d55555) **A stylish AFK plugin for Paper, Purpur and Folia 26.x** with holograms above AFK players, auto-AFK, AFK kick and much more. Fully customizable, with gradients and in English and German. Check the gallery. ### Preview ![Preview](https://cdn.modrinth.com/data/OQORWMBK/images/6e5ced2ec4bca4d53b31083468146f4a273f9b1d.png) ### Features - `/afk` to go AFK manually, **auto-AFK** after a configurable time - **Holograms** above AFK players (with the AFK time) and a rotating symbol - can start one line higher if you show ranks above the name - **Tab prefix** for AFK players - **Kick** after a configurable time AFK - **Immortality:** AFK players become invulnerable after a delay - **Position lock:** AFK players can't be pushed away by players, mobs or water - **Vanish support:** no messages or holograms for vanished players - Optional permission to go AFK - **PlaceholderAPI** support (see below) - **Folia support** - one jar for Paper, Purpur and Folia - **MiniMessage** formatting everywhere (chat, action bar, holograms, tab): gradients, hex colors - classic `&` codes still work - **English, German, French, Spanish, Polish, Russian, Portuguese, Turkish and Chinese** included, add your own language with one file - **Lightweight:** display entities instead of armor stands, holograms only move when the player moves, nothing is saved to the world (no leftover holograms after a crash) - Optional **auto update** from Modrinth (off by default, checked with SHA-512) - new config options are added automatically, your values are kept ### Commands & permissions - `/afk` - toggle AFK mode - `/betterafk reload` - reloads config and messages, permission `betterafk.reload` (OP by default) - `betterafk.use` - allows players to go AFK (only checked if `afk.require_permission: true`)

PlaceholderAPI placeholders

Useful if other plugins change the tab list or the scoreboard - the AFK data can be shown there too. Requires [PlaceholderAPI](https://modrinth.com/plugin/placeholderapi). - `%betterafk_afk_status%` - the AFK tab prefix if the player is AFK - `%betterafk_invulnerability_status%` - the invulnerable text if the player is invulnerable - `%betterafk_afk_query%` - `true` or `false` - `%betterafk_afk_minutes%` - minutes the player is AFK (empty if not AFK) PlaceholderAPI placeholders can also be used inside all BetterAFK messages.

### Requirements - Paper, Purpur or Folia **26.1 - 26.3** - Java 25 - Optional: PlaceholderAPI ### Bug report & support If you need help or have a bug please contact me via discord (add hassanbwo). I will guarantee quick help - Thanks for supporting :) ### config.yml All times are in seconds. ```yaml # ========================================== # BetterAFK – config.yml # ========================================== # Here you can customise all times and settings according to your wishes. # All messages are in messages_en.yml / messages_de.yml (MiniMessage like or and & color codes) # 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 me via discord (add hassanbwo). # I 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 afk: auto_timeout_enabled: true timeout: 180 require_permission: false # Here you can deactivate the tab prefix (the text is in the messages file) tab_prefix: enabled: true # Here you can deactivate the symbol (the barrier) over the holograms if you don't like it or skip one hologram space # With "block" you can replace the barrier with any other item (e.g. CLOCK) # 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 block: BARRIER skip_one_hologram: false # Here you can select if a player should be kicked after a certain time (seconds) kick: enabled: true time: 600 # Here you can select whether you want to block the position of AFK players. # This prevents them from being pushed away (by players, entities or water for example). lock_position: enabled: true # Here you can choose if a player should be invulnerable and immortal after a certain time (seconds) in afk mode # hologram: show the extra "invulnerable" line above the player (text: immortality.status in the messages file) # Note: a value of over 3 seconds is recommended to prevent players from exploiting this feature immortality: enabled: true delay: 10 hologram: true # Language of all messages: en (English), de (Deutsch), fr (Français), es (Español), # pl (Polski), ru (Русский), pt (Português), tr (Türkçe) or zh (简体中文) # The texts are in messages_en.yml / messages_de.yml and support MiniMessage (, ) # and the classic color codes (&c). You can add your own language, e.g. messages_it.yml -> language: it # /betterafk reload (permission betterafk.reload) reloads config and messages. language: en # Updates from Modrinth: a newer version is always announced in the console. # enabled: download new versions automatically. Downloads are checked with the SHA-512 checksum from Modrinth # and installed on the next server restart (plugins/update folder). Only releases for your # Minecraft version and server software (Paper, Purpur, Folia) are downloaded. # major_versions: also download big updates (e.g. 2.x -> 3.0) automatically, otherwise they are only announced. auto_update: enabled: false major_versions: false ``` ### messages_en.yml All texts support MiniMessage (``, ``, `Text`) and the classic `&` color codes. Leave a text empty (`""`) to disable it. Translations are included for German, French, Spanish, Polish, Russian, Portuguese, Turkish and Chinese - switch with `language: de`, `fr`, `es`, `pl`, `ru`, `pt`, `tr` or `zh` in the config. ```yaml # ========================================== # BetterAFK - messages (English) # ========================================== # Formatting: MiniMessage - https://docs.advntr.dev/minimessage/format # Colors: , , <#ff8800> # Styles: , , # Gradients: Text # Rainbow: Text # Classic color codes like &c, &l or &#ff8800 still work as well. # # Placeholders: %player% (name of the AFK player), %time% (minutes AFK), %unit% (minute/minutes) # PlaceholderAPI placeholders can be used too (if PlaceholderAPI is installed). # # Select the language in config.yml (language: en). You can also create your own # file, e.g. messages_fr.yml, and set "language: fr". Missing texts fall back to English. # Leave a message empty ("") to disable it. # ========================================== afk: # Action bar when a player goes AFK action_bar: "You are now AFK!" # Chat message for everyone chat_start: "%player% is now AFK." chat_end: "%player% is no longer AFK after %time% %unit%." # Only for the player himself if he is vanished (no chat message, no holograms) vanished_start: "You are now AFK. Since you're vanished, no messages or holograms will be displayed." vanished_end: "You were AFK for %time% %unit%." # afk.require_permission in config.yml no_permission: "You have no permission to go AFK." # Text above the AFK player (line1 is on top) hologram: line1: "AFK" line2: "since %time% %unit%" # Appended to the name in the tab list (tab_prefix.enabled in config.yml) tab_prefix: " AFK" units: singular: "minute" plural: "minutes" kick: message: "You were kicked for being AFK too long!" lock_position: message: "You can no longer move because you have been marked as AFK. Type /afk to move again." action_bar: "You cannot move while AFK!" immortality: message: "You are now invulnerable due to AFK mode!" # Extra hologram line while invulnerable (immortality.hologram in config.yml), "" = no line status: "invulnerable" commands: reload_success: "BetterAFK configuration reloaded!" no_permission: "You don't have permission to use this command." players_only: "This command can only be used by players." ``` --- ### More plugins by BetterPlugins All for Paper, Purpur and Folia 26.x, in English, German, French, Spanish, Polish, Russian, Portuguese, Turkish and Chinese - see the whole [BetterPlugins collection](https://modrinth.com/collection/4cB8DVqy): | | | |---|---| | [![BetterTimber](https://cdn.modrinth.com/data/l0XLrNVq/3b43e3799ccf07077aa432580ded0d83ba23f66b_96.webp)](https://modrinth.com/plugin/bettertimber) | **[BetterTimber](https://modrinth.com/plugin/bettertimber)** - Fell whole trees with one hit - protection-plugin safe | | [![BannerForLabyMod](https://cdn.modrinth.com/data/TFlskYWO/70153a4fa72b0e1bde74603115067cfeec6b08b3_96.webp)](https://modrinth.com/plugin/bannerforlabymod) | **[BannerForLabyMod](https://modrinth.com/plugin/bannerforlabymod)** - Custom image banner above the tab list for LabyMod | | [![BetterCarry](https://cdn.modrinth.com/data/1n9o2jC5/c8f2afa87c20ea0c5dd409b78165be6b17cb7aaa_96.webp)](https://modrinth.com/plugin/bettercarry) | **[BetterCarry](https://modrinth.com/plugin/bettercarry)** - Carry and throw players, mobs and chests | | [![BetterTimberEnchantment](https://cdn.modrinth.com/data/BoBXENsT/a1a35d2079f46509de1ef12aa3917500a980b670_96.webp)](https://modrinth.com/plugin/bettertimberenchantment) | **[BetterTimberEnchantment](https://modrinth.com/plugin/bettertimberenchantment)** - Timber enchantment for BetterTimber - enchanting table, villagers, loot | | [![BetterRIP](https://cdn.modrinth.com/data/1WumOpfh/b43b64ec9ab6fbbf7ea6a3539b2af79bb9112278_96.webp)](https://modrinth.com/plugin/betterrip) | **[BetterRIP](https://modrinth.com/plugin/betterrip)** - Graves that keep your items in their slots and your experience | | [![BetterSort](https://cdn.modrinth.com/data/94zy4omK/d091e2a6f5595b8d64b848409165c237ac5bdb55_96.webp)](https://modrinth.com/plugin/bettersort) | **[BetterSort](https://modrinth.com/plugin/bettersort)** - Sort chests with one click, hotbar refill and quick stack | | [![BetterWaystones](https://cdn.modrinth.com/data/ObtG2DHH/dbaaf0309ee2bcf86c3327d5fa4f8b1b1108a3dc_96.webp)](https://modrinth.com/plugin/betterwaystones) | **[BetterWaystones](https://modrinth.com/plugin/betterwaystones)** - Build, discover and travel between waystones - own 3D model, no resource pack |

BetterAFK - AFK Holograms & Kick

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details