BetterAFK

插件

· 作者 hassanbwo

适用于 Paper、Purpur 和 Folia 26.x 的 AFK 插件:全息图、自动AFK、踢出、每个玩家独立的 AFK 设置,AFK 玩家不会阻止睡觉。轻量级,支持 PlaceholderAPI。

0 本站下载 0 关注 更新于 2 天前

最新 2.10.0 · 26.3 · Folia / Paper

一键开服(送7天)

BetterAFK

适用于 Paper、Purpur 和 Folia 26.x 的时尚挂机插件,具备玩家头顶全息图、自动挂机、挂机踢出等功能。玩家可自定义自己的挂机设置,挂机玩家不会阻碍睡眠,且所有功能均可关闭。完全可定制,支持 9 种语言。查看画廊。

预览

Preview

特性

  • /afk 手动进入挂机状态,或在可配置时间后自动挂机
  • 挂机玩家头顶的全息图(显示挂机时长)及旋转符号 - 若要在名字上方显示头衔,全息图可向上偏移一行
  • 挂机玩家的 Tab 列表前缀
  • 在可配置的挂机时长后踢出玩家 - 并为你的团队提供绕过权限
  • 睡眠: 挂机玩家不计入睡眠人数 - 当其他所有人都入睡时,夜晚会被跳过
  • 每位玩家拥有独立设置(已保存,重启后保留):独立的自动挂机时间、隐藏他人的挂机消息、选择是否被踢出
  • /afk list - 查看谁在挂机以及挂机的时长
  • 不死性: 经过延迟后,挂机玩家变为无敌状态
  • 移动即可退出挂机 - 只需再次移动,无需使用 /afk
  • 位置锁定(可选): 挂机玩家不会被玩家、生物或水流推开 - 配合 walk_to_leave 选项,有意的步骤(W、A、S、D 或跳跃)仍可结束挂机状态
  • 隐身支持: 对隐身玩家不显示消息或全息图
  • 可选的进入挂机状态的权限
  • PlaceholderAPI 支持(见下文)
  • Folia 支持 - 一个 jar 文件同时兼容 Paper、Purpur 和 Folia
  • 全处支持 MiniMessage 格式化(聊天、操作栏、全息图、Tab 列表):渐变、十六进制颜色 - 传统的 & 代码仍然有效
  • 内置英语、德语、法语、西班牙语、波兰语、俄语、葡萄牙语、土耳其语和中文,可通过单个文件添加你自己的语言
  • 轻量级: 使用显示实体而非盔甲架,全息图仅在玩家移动时更新,数据不保存到世界文件中(崩溃后不会留下残留全息图)
  • 可选的来自 Modrinth 的自动更新(默认关闭)- 新配置选项会自动添加,你的数值设置将被保留

命令与权限

  • /afk - 切换挂机模式
  • /afk list - 查看所有挂机玩家及其挂机时长
  • /afk timer <seconds> / reset / off - 设置你自己的自动挂机倒计时
  • /afk notifications on|off - 显示或隐藏关于其他玩家挂机状态的消息
  • /afk kick on|off - 选择自己是否在挂机过久时被踢出(如果服务器允许的话)
  • /betterafk reload - 重载配置文件和消息文件

所有命令都可以在 config.yml 中禁用 - 禁用的命令不会出现在 Tab 补全列表中。

权限 默认值 说明
betterafk.use OP 进入挂机状态 - 仅在 afk.require_permission: true 时检查此权限
betterafk.kick.bypass 无任何人 永远不会因挂机而被踢出 (kick.bypass_permission)
betterafk.reload OP 执行 /betterafk reload
PlaceholderAPI 占位符

如果其他插件更改了 Tab 列表或记分板,这些占位符非常有用 - AFK 数据也可以在那里显示。需要 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

# 在此可以设置玩家在一定时间(秒)后是否被踢出
# bypass_permission: 拥有权限 "betterafk.kick.bypass" 的玩家永远不会被踢出(例如团队成员)

kick:
  enabled: true
  time: 600
  bypass_permission: true

# 在此可以选择是否锁定 AFK 玩家的位置。
# false: AFK 玩家可以通过简单地走动来离开 AFK 模式(他们也可以被玩家、生物或水流推动)。
# true:  AFK 玩家不能被推动,但他们必须输入 /afk 才能再次移动。
# walk_to_leave (仅在 enabled: true 时生效): AFK 玩家仍然不能被推动,但按下任意移动键
#                (W、A、S、D 或跳跃)即可结束 AFK 模式——无需使用 /afk。

lock_position:
  enabled: false
  walk_to_leave: false

# 在此可以选择玩家在 AFK 模式下经过一定时间(秒)后是否获得无敌和永生状态
# hologram: 在玩家上方显示额外的“invulnerable”行(文本为消息文件中的 immortality.status)
# 注意:建议设置超过 3 秒的值,以防止玩家利用此功能

immortality:
  enabled: true
  delay: 10
  hologram: true

# 每位玩家可自行更改的设置(保存在玩家文件中,重启后保留)
# timer:         /afk timer <seconds> - 设置自动进入 AFK 的倒计时时间,介于 min 和 max 秒之间;/afk timer reset 重置计时
#                allow_off: 同时允许使用 /afk timer off(该玩家将完全不会自动进入 AFK)
# notifications: /afk notifications <on|off> - 隐藏关于其他玩家“... 现在处于 AFK 状态”的聊天消息
# kick:          /afk kick <on|off> - 玩家自行决定是否在 kick.time 设定的时间后被踢出

player_settings:
  timer:
    enabled: true
    min: 60
    max: 1800
    allow_off: false
  notifications: true
  kick: false

# AFK 玩家不计入睡眠人数:当所有非 AFK 玩家都入睡时,夜晚会被跳过

sleep:
  ignore_afk_players: true

# /afk list - 显示所有 AFK 玩家及其处于 AFK 状态的时长

list:
  enabled: 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 校验和进行验证,
#          并在下次服务器重启时安装(插件/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 进行切换。

# ==========================================
# 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>挂机</bold></red><gray> 状态!"
  # 发送给所有人的聊天消息
  chat_start: "<light_purple>%player%</light_purple> <gray>现在处于 <red><bold>挂机</bold></red><gray> 状态。"
  chat_end: "<light_purple>%player%</light_purple> <gray>在 <red><bold>%time%</bold></red> <gray>%unit% 后不再处于 <red><bold>挂机</bold></red> <gray>状态。"
  # 仅对隐身状态的玩家本人可见(不发送聊天消息,不显示全息图)
  vanished_start: "<gray>你现在处于 <red><bold>挂机</bold></red><gray> 状态。由于你处于隐身状态,不会显示任何消息或全息图。"
  vanished_end: "<gray>你曾 <red><bold>挂机</bold></red> <gray>了 <red><bold>%time%</bold></red> <gray>%unit%。"
  # 对应 config.yml 中的 afk.require_permission 配置项
  no_permission: "<gray>你没有权限进入 <red>挂机</red><gray> 状态。"

# 显示在挂机玩家头顶的全息文字(line1 在最上方)
hologram:
  line1: "<red><bold>挂机</bold></red>"
  line2: "<gray>自 %time% %unit% 起"

# 追加到标签列表(Tab 列表)中玩家名字前的前缀(对应 config.yml 中的 tab_prefix.enabled 配置项)
tab_prefix: " <red><bold>挂机</bold></red>"

units:
  singular: "分钟"
  plural: "分钟"

kick:
  message: "<gray>你因 <red>挂机时间过长</red><gray> 被踢出服务器!"

lock_position:
  message: "<gray>由于你已被标记为 <red><bold>AFK(挂机)</bold></red><gray>,你将无法移动。输入 <red>/afk</red><gray> 以解除挂机状态并恢复移动。"
  # with lock_position.walk_to_leave: true (config.yml)
  message_walk: "<gray>你已被标记为 <red><bold>AFK(挂机)</bold></red><gray>。只需走动即可退出挂机模式。"
  action_bar: "<gray>你在 <red><bold>AFK(挂机)</bold></red><gray> 状态下无法移动!"

immortality:
  message: "<gray>你现在由于挂机模式而<light_purple>无敌</light_purple><gray>!"
  # 无敌时额外的全息行 (config.yml 中的 immortality.hologram),"" = 无行
  status: "<green>无敌"

commands:
  reload_success: "<gradient:#ff5555:#ff55ff><bold>BetterAFK</bold></gradient> <gray>配置已重新加载!"
  no_permission: "<red>你没有权限使用此命令。"
  players_only: "<red>只有玩家才能使用此命令。"
  # /afk 带未知子命令
  afk_usage: "<gray>用法: <red>/afk</red> <gray>%commands%"

# /afk list (config.yml 中的 list.enabled)
list:
  header: "<gray>挂机玩家 (<red>%count%</red><gray>):"
  entry: "<dark_gray>- <light_purple>%player%</light_purple> <gray>自 <red>%time%</red> <gray>起"
  empty: "<gray>目前没有人挂机。"

# /afk timer, /afk notifications, /afk kick (config.yml 中的 player_settings)
settings:
  timer_current: "<gray>你将在 <red>%seconds%</red> <gray>秒后自动设置为挂机状态。"
  timer_current_off: "<gray>你<red>未</red><gray>设置为自动挂机。"
  timer_set: "<gray>你将在 <red>%seconds%</red> <gray>秒后自动设置为挂机状态。"
  timer_reset: "<gray>你的自动挂机时间已恢复为服务器默认值 (<red>%seconds%</red> <gray>秒)。"
  timer_off: "<gray>你不再自动设置为挂机状态。"
  usage_timer: "<gray>用法: <red>/afk timer [%min%-%max%]</red> <gray>(秒) 或 <red>/afk timer reset"
  usage_timer_off: "<gray>用法: <red>/afk timer [%min%-%max%]</red> <gray>(秒), <red>/afk timer off</red> <gray>或 <red>/afk timer reset"
  usage_notifications: "<gray>用法: <red>/afk notifications on|off"
  notifications_on: "<gray>你再次看到其他玩家的挂机消息。"
  notifications_off: "<gray>你不再看到其他玩家的挂机消息。"
  usage_kick: "<gray>用法: <red>/afk kick on|off"
  kick_on: "<gray>如果你挂机时间过长,你将再次被<red>踢出</red><gray>游戏。"
  kick_off: "<gray>你将不再因挂机而被踢出。"

---
### BetterPlugins 的其他插件
适用于 Paper、Purpur 和 Folia 26.x,提供英文、德文、法文、西班牙文、波兰文、俄文、葡萄牙文、土耳其文和中文——查看完整的 [BetterPlugins 合集](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)** - 一击砍倒整棵树 - 兼容保护插件 |
| [![BannerForLabyMod](https://cdn.modrinth.com/data/TFlskYWO/70153a4fa72b0e1bde74603115067cfeec6b08b3_96.webp)](https://modrinth.com/plugin/bannerforlabymod) | **[BannerForLabyMod](https://modrinth.com/plugin/bannerforlabymod)** - LabyMod 标签页列表上方的自定义图片横幅 |
| [![BetterCarry](https://cdn.modrinth.com/data/1n9o2jC5/c8f2afa87c20ea0c5dd409b78165be6b17cb7aaa_96.webp)](https://modrinth.com/plugin/bettercarry) | **[BetterCarry](https://modrinth.com/plugin/bettercarry)** - 搬运和投掷玩家、生物与箱子 |
| [![BetterTimberEnchantment](https://cdn.modrinth.com/data/BoBXENsT/a1a35d2079f46509de1ef12aa3917500a980b670_96.webp)](https://modrinth.com/plugin/bettertimberenchantment) | **[BetterTimberEnchantment](https://modrinth.com/plugin/bettertimberenchantment)** - BetterTimber 的伐木附魔 - 附魔台、村民、战利品 |
| [![BetterRIP](https://cdn.modrinth.com/data/1WumOpfh/b43b64ec9ab6fbbf7ea6a3539b2af79bb9112278_96.webp)](https://modrinth.com/plugin/betterrip) | **[BetterRIP](https://modrinth.com/plugin/betterrip)** - 保留物品栏位和经验值的坟墓 |
| [![BetterSort](https://cdn.modrinth.com/data/94zy4omK/d091e2a6f5595b8d64b848409165c237ac5bdb55_96.webp)](https://modrinth.com/plugin/bettersort) | **[BetterSort](https://modrinth.com/plugin/bettersort)** - 一键整理箱子、快捷栏补充与快速堆叠 |
| [![BetterWaystones](https://cdn.modrinth.com/data/ObtG2DHH/dbaaf0309ee2bcf86c3327d5fa4f8b1b1108a3dc_96.webp)](https://modrinth.com/plugin/betterwaystones) | **[BetterWaystones](https://modrinth.com/plugin/betterwaystones)** - 建造、发现并在传送石之间旅行 - 拥有独立 3D 模型,无需资源包 |

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源