BetterAFK
适用于 Paper、Purpur 和 Folia 26.x 的时尚 AFK 插件,在闲置玩家头顶显示全息图,支持自动闲置、闲置踢出等功能。完全可自定义,支持渐变色,并提供英文和德文界面。查看画廊。
预览

功能
/afk 手动进入闲置状态,自动闲置在可配置的时间后触发
- 全息图显示在闲置玩家头顶(包含闲置时间)以及旋转符号 - 如果在名字上方显示头衔,全息图可以从高一行开始显示
- Tab 列表前缀用于标识闲置玩家
- 踢出:闲置超过可配置时间后被踢出
- 无敌: 闲置一段时间后,玩家变为无敌状态
- 移动离开闲置 - 只需再次移动即可退出闲置模式,无需使用
/afk
- 位置锁定(可选): 闲置玩家不会被其他玩家、生物或水流推开 - 配合
walk_to_leave 选项,按下任意移动键(W、A、S、D 或跳跃)即可结束闲置状态
- 隐身支持: 对隐身玩家不发送消息或显示全息图
- 可选权限控制是否允许进入闲置状态
- PlaceholderAPI 支持(见下文)
- Folia 支持 - 一个 jar 文件同时兼容 Paper、Purpur 和 Folia
- MiniMessage 格式全局支持(聊天、动作栏、全息图、Tab 列表):支持渐变色、十六进制颜色代码 - 经典的
& 颜色代码依然有效
- 内置英文、德文、法文、西班牙文、波兰文、俄文、葡萄牙文、土耳其文和中文,可通过单个文件添加自己的语言
- 轻量级: 使用显示实体而非盔甲架,全息图仅在玩家移动时更新,数据不保存至世界文件(崩溃后不会遗留全息图)
- 可选 Modrinth 自动更新(默认关闭,通过 SHA-512 校验)- 新增的配置选项会自动添加,您的自定义值将被保留
命令与权限
/afk - 切换闲置模式
/betterafk reload - 重新加载配置和消息文件,需要权限 betterafk.reload(默认 OP 拥有)
betterafk.use - 允许玩家进入闲置状态(仅在 afk.require_permission: true 时检查)
PlaceholderAPI 占位符
如果其他插件更改了 Tab 列表或计分板,此功能非常有用 - 闲置数据也可以在那里显示。需要 PlaceholderAPI。
%betterafk_afk_status% - 如果玩家处于闲置状态,则显示 Tab 前缀
%betterafk_invulnerability_status% - 如果玩家处于无敌状态,则显示无敌文本
%betterafk_afk_query% - true 或 false
%betterafk_afk_minutes% - 玩家闲置的分钟数(未闲置时为空)
PlaceholderAPI 占位符也可用于所有 BetterAFK 消息中。
要求
- Paper、Purpur 或 Folia 26.1 - 26.3
- Java 25
- 可选:PlaceholderAPI
Bug 报告与支持
如果您需要帮助或发现 Bug,请通过 Discord 联系我(添加好友 hassanbwo)。我保证快速提供帮助 - 感谢您的支持 :)
config.yml
所有时间单位均为秒。
# ==========================================
# BetterAFK – config.yml
# ==========================================
# 您可以根据喜好自定义所有时间和设置。
# 所有消息位于 messages_en.yml / messages_de.yml 文件中(支持 MiniMessage 格式的 <red> 或 <gradient:...> 以及 & 颜色代码)
# 时间以秒为单位计算(例如 5 分钟 = 300 秒)
# 更多详情请查看插件页面:
# https://modrinth.com/plugin/betterafk
# ==========================================
# 如果您需要帮助或发现 Bug,请通过 Discord 联系我(添加好友 hassanbwo)。
# 我保证快速提供帮助 - 感谢您的支持 :)
# ==========================================
# 在此处更改玩家自动设置为闲置状态的时间(以及是否需要该功能)
# 以及玩家是否需要权限 ("betterafk.use") 才能进入闲置状态
afk:
auto_timeout_enabled: true
timeout: 180
require_permission: false
# 在此处禁用 Tab 前缀(文本位于消息文件中)
tab_prefix:
enabled: true
# 如果您不喜欢全息图上方的障碍方块符号,或者想跳过一行全息图空间,可以在此处禁用它
# 使用 "block" 可以用任何其他物品替换障碍方块(例如 CLOCK)
# 如果 skip_one_hologram 设置为 true,全息图将从高一格的位置开始显示(如果在名字上方显示头衔或心形图标,这将很有用)
holograms:
barrier: true
block: BARRIER
skip_one_hologram: false
# 在此处选择是否在特定时间(秒)后踢出玩家
kick:
enabled: true
time: 600
# 在此处选择是否锁定闲置玩家的位置。
# false: 闲置玩家可以简单地走开以退出闲置模式(他们也可能被玩家、生物或水流推开)。
# true: 闲置玩家不会被推开,但他们必须输入 /afk 才能再次移动。
# walk_to_leave(仅在 enabled: true 时有效):闲置玩家仍然不会被推开,但按下移动键
# (W、A、S、D 或跳跃)即可结束闲置模式 - 无需 /afk。
lock_position:
enabled: false
walk_to_leave: false
# 在此处选择玩家在闲置模式下经过一定时间(秒)后是否应获得无敌和永生状态
# hologram: 在玩家上方显示额外的 "invulnerable" 行(文本:消息文件中的 immortality.status)
# 注意:建议值超过 3 秒,以防止玩家利用此功能
immortality:
enabled: true
delay: 10
hologram: true
所有消息的语言:en (English)、de (Deutsch)、fr (Français)、es (Español)、
pl (Polski)、ru (Русский)、pt (Português)、tr (Türkçe) 或 zh (简体中文)
文本位于 messages_en.yml / messages_de.yml 中,支持 MiniMessage (<red>, gradient:...)
以及经典颜色代码 (&c)。你可以添加自己的语言,例如 messages_it.yml -> language: it
/betterafk reload (权限 betterafk.reload) 重载配置和消息。
language: en
Modrinth 更新:控制台始终会公告新版本。
enabled: 自动下载新版本。下载时会使用 Modrinth 的 SHA-512 校验和进行检查,
并在下次服务器重启时安装(plugins/update 文件夹)。仅下载适用于你的
Minecraft 版本和服务端软件(Paper、Purpur、Folia)的发布版。
major_versions: 也自动下载大版本更新(例如 2.x -> 3.0),否则仅进行公告。
auto_update:
enabled: false
major_versions: false
### messages_en.yml
所有文本均支持 MiniMessage (`<red>`, `<bold>`, `<gradient:#ff5555:#ff55ff>Text</gradient>`) 和经典的 `&` 颜色代码。将文本留空 (`""`) 可禁用该文本。已包含德语、法语、西班牙语、波兰语、俄语、葡萄牙语、土耳其语和中文的翻译——在配置中使用 `language: de`、`fr`、`es`、`pl`、`ru`、`pt`、`tr` 或 `zh` 进行切换。
```yaml
# ==========================================
# BetterAFK - 消息 (英文)
# ==========================================
# 格式说明:MiniMessage - https://docs.advntr.dev/minimessage/format
# 颜色: <red>, <gray>, <#ff8800>
# 样式: <bold>, <italic>, <underlined>
# 渐变: <gradient:#ff5555:#ff55ff>Text</gradient>
# 彩虹: <rainbow>Text</rainbow>
# 经典的 &c、&l 或 &#ff8800 等颜色代码同样有效。
#
# 占位符:%player% (挂机玩家的名字)、%time% (挂机分钟数)、%unit% (分钟/分钟复数)
# 如果安装了 PlaceholderAPI,也可以使用其占位符。
#
# 在 config.yml 中选择语言 (language: en)。你也可以创建自己的
# 文件,例如 messages_fr.yml,并设置 "language: fr"。缺失的文本将回退到英文。
# 将消息留空 ("") 以禁用它。
# ==========================================
afk:
# 当玩家进入挂机状态时的动作栏提示
action_bar: "<gray>你现在处于 <red><bold>AFK</bold></red><gray> 状态!"
# 全员聊天消息
chat_start: "<light_purple>%player%</light_purple> <gray>现在处于 <red><bold>AFK</bold></red><gray> 状态。"
chat_end: "<light_purple>%player%</light_purple> <gray>在 <red><bold>%time%</bold></red> <gray>%unit% 后不再处于 <red><bold>AFK</bold></red> <gray>状态。"
# 仅对隐身中的玩家本人显示(无聊天消息,无全息图)
vanished_start: "<gray>你现在处于 <red><bold>AFK</bold></red><gray> 状态。由于你处于隐身状态,不会显示任何消息或全息图。"
vanished_end: "<gray>你曾处于 <red><bold>AFK</bold></red> <gray>状态,持续了 <red><bold>%time%</bold></red> <gray>%unit%。"
# config.yml 中的 afk.require_permission
no_permission: "<gray>你没有权限进入 <red>AFK</red><gray> 状态。"
# 挂机玩家头顶的全息图文字(line1 在最上方)
hologram:
line1: "<red><bold>AFK</bold></red>"
line2: "<gray>自 %time% %unit% 起"
# 追加在标签页列表名字后的前缀(config.yml 中的 tab_prefix.enabled)
tab_prefix: " <red><bold>AFK</bold></red>"
units:
singular: "minute"
plural: "minutes"
kick:
message: "<gray>由于你挂机时间过长,你被 <red>踢出</red> <gray>服务器了!"
lock_position:
message: "<gray>由于你已被标记为 <red><bold>AFK</bold></red><gray>,你无法再移动。输入 <red>/afk</red> <gray>即可恢复移动。"
# 配合 lock_position.walk_to_leave: true (config.yml) 使用
message_walk: "<gray>你已被标记为 <red><bold>AFK</bold></red><gray>。只需走动即可离开 AFK 模式。"
action_bar: "<gray>你在 <red><bold>AFK 期间</bold></red><gray> 无法移动!"
immortality:
message: "<gray>由于处于 AFK 模式,你现在 <light_purple>无敌</light_purple> <gray>!"
# 无敌时的额外全息图行(config.yml 中的 immortality.hologram),"" = 不显示该行
status: "<green>invulnerable"
commands:
reload_success: "<gradient:#ff5555:#ff55ff><bold>BetterAFK</bold></gradient> <gray>配置已重载!"
no_permission: "<red>你没有权限使用此命令。"
players_only: "<red>此命令只能由玩家使用。"
BetterPlugins 的其他插件
全部适用于 Paper、Purpur 和 Folia 26.x,提供英语、德语、法语、西班牙语、波兰语、俄语、葡萄牙语、土耳其语和中文支持——查看完整的 BetterPlugins 合集:
BetterAFK
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

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
- Walk to leave AFK - just move again, no
/afk needed
- Position lock (optional): AFK players can't be pushed away by players, mobs or water - and with
walk_to_leave a deliberate step (W, A, S, D or jump) still ends AFK
- 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.
%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.
# ==========================================
# 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 <red> or <gradient:...> 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.
# false: AFK players can simply walk away to leave AFK mode (they can also be pushed by players, mobs or water).
# true: AFK players can't be pushed away, but they have to type /afk to move again.
# walk_to_leave (only with enabled: true): AFK players still can't be pushed away, but pressing a movement key
# (W, A, S, D or jump) ends AFK mode - no /afk needed.
lock_position:
enabled: false
walk_to_leave: false
# 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 (<red>, <gradient:...>)
# 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 (<red>, <bold>, <gradient:#ff5555:#ff55ff>Text</gradient>) 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.
# ==========================================
# BetterAFK - messages (English)
# ==========================================
# Formatting: MiniMessage - https://docs.advntr.dev/minimessage/format
# Colors: <red>, <gray>, <#ff8800>
# Styles: <bold>, <italic>, <underlined>
# Gradients: <gradient:#ff5555:#ff55ff>Text</gradient>
# Rainbow: <rainbow>Text</rainbow>
# 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: "<gray>You are now <red><bold>AFK</bold></red><gray>!"
# Chat message for everyone
chat_start: "<light_purple>%player%</light_purple> <gray>is now <red><bold>AFK</bold></red><gray>."
chat_end: "<light_purple>%player%</light_purple> <gray>is no longer <red><bold>AFK</bold></red> <gray>after <red><bold>%time%</bold></red> <gray>%unit%."
# Only for the player himself if he is vanished (no chat message, no holograms)
vanished_start: "<gray>You are now <red><bold>AFK</bold></red><gray>. Since you're vanished, no messages or holograms will be displayed."
vanished_end: "<gray>You were <red><bold>AFK</bold></red> <gray>for <red><bold>%time%</bold></red> <gray>%unit%."
# afk.require_permission in config.yml
no_permission: "<gray>You have no permission to go <red>AFK</red><gray>."
# Text above the AFK player (line1 is on top)
hologram:
line1: "<red><bold>AFK</bold></red>"
line2: "<gray>since %time% %unit%"
# Appended to the name in the tab list (tab_prefix.enabled in config.yml)
tab_prefix: " <red><bold>AFK</bold></red>"
units:
singular: "minute"
plural: "minutes"
kick:
message: "<gray>You were <red>kicked</red> <gray>for being AFK too long!"
lock_position:
message: "<gray>You can no longer move because you have been marked as <red><bold>AFK</bold></red><gray>. Type <red>/afk</red> <gray>to move again."
# with lock_position.walk_to_leave: true (config.yml)
message_walk: "<gray>You have been marked as <red><bold>AFK</bold></red><gray>. Just walk to leave AFK mode."
action_bar: "<gray>You cannot move <red><bold>while AFK</bold></red><gray>!"
immortality:
message: "<gray>You are now <light_purple>invulnerable</light_purple> <gray>due to AFK mode!"
# Extra hologram line while invulnerable (immortality.hologram in config.yml), "" = no line
status: "<green>invulnerable"
commands:
reload_success: "<gradient:#ff5555:#ff55ff><bold>BetterAFK</bold></gradient> <gray>configuration reloaded!"
no_permission: "<red>You don't have permission to use this command."
players_only: "<red>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:
|
|
 |
BetterTimber - Fell whole trees with one hit - protection-plugin safe |
 |
BannerForLabyMod - Custom image banner above the tab list for LabyMod |
 |
BetterCarry - Carry and throw players, mobs and chests |
 |
BetterTimberEnchantment - Timber enchantment for BetterTimber - enchanting table, villagers, loot |
 |
BetterRIP - Graves that keep your items in their slots and your experience |
 |
BetterSort - Sort chests with one click, hotbar refill and quick stack |
 |
BetterWaystones - Build, discover and travel between waystones - own 3D model, no resource pack |
评论 0
登录后参与评分
还没有评论,来抢沙发吧