EzAfk

插件

· 作者 Shadow48402

一款现代、轻量级的 AFK 管理插件,在保持员工信息更新的同时,温和地提醒闲置玩家重新投入游戏。

0 本站下载 0 关注 更新于 3 个月前

最新 3.1.2 · 26.2 · Bukkit / Folia

一键开服(送7天)

EzAfk

让 AFK 管理变得简单。

EzAfk 是一款面向 Paper 和 Spigot 服务器的现代化、轻量级 AFK 管理插件。 它自动检测玩家是否处于闲置状态,并根据该状态给予奖励或扣除费用;为管理人员提供实时概览面板;并与你已运行的工具集成,且完全不影响服务器性能。

v3.1.1 · Minecraft 1.21+ · Java 21+ · Paper / Spigot / Bukkit / Purpur


功能亮点

功能 简介
AFK 检测 可配置的闲置超时时间,支持广播消息、标题、动画、显示名称更改以及致盲模糊叠加效果
防作弊 阻止无限水流、骑乘载具和气泡柱等技巧重置闲置计时器
AFK 踢出 在可配置的时间后踢出闲置玩家,可选择仅在服务器满员时生效
踢出警告 在踢出前,以自定义间隔发送多阶段倒计时消息(聊天栏和/或标题)
员工 GUI /afk gui 面板,显示所有 AFK 玩家,并提供一键踢出、发消息、传送和执行自定义命令的按钮
AFK 区域 立方体区域,玩家在其中处于 AFK 状态时可获得奖励(经济、命令或物品)
经济费用 通过任何 Vault 经济插件,收取一次性入场费和/或持续性的 AFK 费用
AFK 排行榜 记录每位玩家的累计 AFK 时间,/afk top 排行榜,重启后数据持久保存
PlaceholderAPI 提供 16 个占位符,用于状态、会话时长、总计、计数、前缀/后缀及在线时长
多语言 EN, ES, NL, RU, ZH, DE,每个服务器均可完全覆盖
存储后端 YAML(默认)、SQLite 或 MySQL
简易语音聊天 (Simple Voice Chat) 当玩家进入 AFK 状态时播放自定义 MP3 音效

安装

  1. 从上方文件选项卡下载 EzAfk-x.x.x.jar。
  2. 将其放入服务器的 plugins/ 文件夹中。
  3. 重启服务器。EzAfk 会自动生成所有配置文件。
  4. 编辑 plugins/EzAfk/config.yml 以配置你所需的功能。
  5. 在游戏中运行 /afk reload 即可应用更改而无需重启。

命令

命令 描述 权限节点
/afk 切换你自己的 AFK 状态 (无)
/afk reload 重新加载所有配置文件 ezafk.reload
/afk gui 打开 AFK 员工概览面板 ezafk.gui
/afk toggle <player> 强制设置某玩家的 AFK 状态 ezafk.toggle
/afk bypass whitelist <add|remove|list> [player] 管理持久的免检白名单 ezafk.bypass.manage
/afk bypass blacklist <add|remove|list> [player] 管理持久的免检黑名单 ezafk.bypass.manage
/afk bypass <player> 切换某玩家的单次会话免检状态 ezafk.bypass.manage
/afk info <player> 查看某玩家的 AFK 会话详情 ezafk.info
/afk time [player] 查看总 AFK 时间 ezafk.time
/afk time reset <player> 重置某玩家的 AFK 时间 ezafk.time.reset
/afk top 显示 AFK 时间排行榜 ezafk.top
/afk zone pos1 / pos2 选择区域角点 ezafk.zone.manage
/afk zone add <name> 创建 AFK 区域 ezafk.zone.manage
/afk zone remove <name> 移除 AFK 区域 ezafk.zone.manage
/afk zone list 列出所有区域 ezafk.zone.list

别名:/ezafk, /ea, /afktime, /afktop


权限

节点 默认值 描述
ezafk.reload OP 重新加载配置
ezafk.bypass OP 永不自动标记为 AFK
ezafk.bypass.manage OP 切换其他玩家的免检状态
ezafk.toggle OP 切换其他玩家的 AFK 状态
ezafk.info OP 查看其他玩家的 AFK 详情
ezafk.kick.bypass OP 永不因 EzAfk 被踢出
ezafk.gui OP 打开员工 GUI
ezafk.gui.view-active OP 在 GUI 中查看非 AFK 玩家
ezafk.gui.actions OP 使用 GUI 中的操作按钮
ezafk.time all 查看自己的 AFK 时间
ezafk.time.others OP 查看其他玩家的 AFK 时间
ezafk.time.reset OP 重置某玩家的 AFK 时间
ezafk.top OP 查看排行榜
ezafk.economy.bypass OP 跳过经济 AFK 收费
ezafk.zone.list OP 列出 AFK 区域
ezafk.zone.manage OP 创建和移除区域

PlaceholderAPI 占位符

需要 PlaceholderAPI。扩展会自动注册,无需额外设置。

占位符 返回值
%ezafk_status% AFK 或 ACTIVE
%ezafk_status_colored% &cAFK 或 &aACTIVE
%ezafk_since% 距离 AFK 会话开始经过的秒数(若非 AFK 则返回空)
%ezafk_last_active% 距离上次玩家活动经过的秒数
%ezafk_total_seconds% 累计终身 AFK 秒数
%ezafk_total% 总 AFK 时间 HH:MM:SS
%ezafk_total_formatted% 详细格式,例如 2 hours 15 minutes
%ezafk_prefix% 配置的 AFK 显示名称前缀
%ezafk_suffix% 配置的 AFK 显示名称后缀
%ezafk_playtime_active_seconds% 活跃(非 AFK)在线时长(秒)
%ezafk_playtime_active% 活跃在线时长 HH:MM:SS
%ezafk_playtime_active_formatted% 活跃在线时长详细格式
%ezafk_afk_count% / %ezafk_afk_players% AFK 玩家数量
%ezafk_active_count% / %ezafk_active_players% 非 AFK 玩家数量

配置概览

EzAfk 的设置分散在多个专注文件中,以便清晰明了:

config.yml    AFK 检测、踢出、防作弊、经济、集成
gui.yml       员工 GUI 布局和动作按钮
zones.yml     AFK 区域定义,包含坐标和奖励
mysql.yml     数据库连接(仅在 storage.type: mysql 时使用)
messages/     语言文件:en.yml, es.yml, nl.yml, ru.yml, zh.yml, de.yml

核心设置 (config.yml)

afk:
  timeout: 300             # 闲置秒数 → 进入 AFK 状态
  broadcast:
    enabled: true          # 在聊天中广播 AFK 状态
  title:
    enabled: true          # 向处于 AFK 状态的玩家显示标题
  anti:
    infinite-waterflow: false
    infinite-vehicle: false
    bubble-column: false

kick:
  enabled: false           # 踢出 AFK 玩家
  enabledWhenFull: false   # 仅在服务器满员时踢出
  timeout: 600             # 达到此 AFK 时长后执行踢出
  warnings:
    enabled: true
    intervals: [60, 30, 10]
    mode: both             # chat | title | both

economy:
  enabled: false
  cost:
    enter:
      enabled: true
      amount: 25.0

storage:
  type: yaml               # yaml | sqlite | mysql
  flush-interval-seconds: 30

集成支持

集成项 说明
Vault / Economy 需要用于经济费用和区域经济奖励功能
PlaceholderAPI 自动检测;提供 16 个 AFK 相关的占位符变量
WorldGuard 添加 afk-bypass 区域标志;使用 /rg flag <region> afk-bypass allow 命令
TAB 将标签页列表中的 AFK 前缀格式化委托给 TAB 插件处理
Simple Voice Chat 在 AFK 状态变更时播放 MP3 音效
bStats 匿名使用统计数据(可在 config.yml 中禁用)
Spigot update checker 有新版本可用时在控制台发送提醒

链接

  • Documentation: 完整配置指南、功能页面及 API 参考
  • Discord: 技术支持、错误报告和功能请求
  • GitHub: 源代码和问题追踪器
  • Developer API: PlayerAfkStatusChangeEvent 事件和 AfkReason 枚举

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源