BetterAFK

插件

· 作者 hassanbwo

适用于 Paper 和 Folia 26.x 的 AFK 插件,支持在挂机玩家头顶显示全息图、自动 AFK、AFK 踢出、位置锁定、无敌状态以及标签页前缀。轻量级、完全可定制,支持 PlaceholderAPI。

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

最新 2.9.2 · 26.3 · Folia / Paper

一键开服(送7天)

BetterAFK

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

预览

Preview

功能

  • /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 合集:

BetterTimber BetterTimber - 一击砍伐整棵树 - 兼容保护插件安全机制
BannerForLabyMod BannerForLabyMod - 为 LabyMod 的标签页列表上方提供自定义图片横幅
BetterCarry BetterCarry - 携带并投掷玩家、生物和箱子
BetterTimberEnchantment BetterTimberEnchantment - BetterTimber 的伐木附魔 - 附魔台、村民、战利品
BetterRIP BetterRIP - 保留物品栏位和经验值的墓碑
BetterSort BetterSort - 一键整理箱子、快捷栏补充和快速堆叠
BetterWaystones BetterWaystones - 建造、发现并在传送石之间旅行 - 拥有独立的 3D 模型,无需资源包

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源