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 音效 |
安装
- 从上方文件选项卡下载
EzAfk-x.x.x.jar。 - 将其放入服务器的
plugins/文件夹中。 - 重启服务器。EzAfk 会自动生成所有配置文件。
- 编辑
plugins/EzAfk/config.yml以配置你所需的功能。 - 在游戏中运行
/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枚举
EzAfk
Keep AFK management simple.
EzAfk is a modern, lightweight AFK management plugin for Paper and Spigot servers. It automates AFK detection, rewards or charges players based on idle state, gives staff a real-time overview panel, and integrates with the tools you already run, all without sacrificing performance.
v3.1.1 · Minecraft 1.21+ · Java 21+ · Paper / Spigot / Bukkit / Purpur
Feature Highlights
| Feature | Summary |
|---|---|
| AFK Detection | Idle timeout with configurable broadcasts, titles, animations, display-name changes, and a blindness-blur overlay |
| Anti-Bypass | Block infinite water flow, vehicle riding, and bubble column tricks from resetting idle timers |
| AFK Kick | Kick idle players after a configurable period, optionally only when the server is full |
| Kick Warnings | Multi-stage countdown messages (chat and/or title) at custom intervals before the kick fires |
| Staff GUI | /afk gui panel showing all AFK players with one-click kick, message, teleport, and custom command buttons |
| AFK Zones | Cuboid regions where players earn rewards (economy, commands, or items) for being AFK |
| Economy Costs | Charge a one-time entry fee and/or a recurring fee while AFK via any Vault economy plugin |
| AFK Leaderboard | Per-player cumulative AFK time, /afk top leaderboard, persisted across restarts |
| PlaceholderAPI | 16 placeholders for status, session time, totals, counts, prefix/suffix, and playtime |
| Multi-language | EN, ES, NL, RU, ZH, DE, fully overridable per server |
| Storage backends | YAML (default), SQLite, or MySQL |
| Simple Voice Chat | Play a custom MP3 sound when a player goes AFK |
Installation
- Download
EzAfk-x.x.x.jarfrom the files tab above. - Drop it into your server's
plugins/folder. - Restart the server. EzAfk generates all config files automatically.
- Edit
plugins/EzAfk/config.ymlto configure your desired features. - Run
/afk reloadin-game to apply changes without a restart.
Commands
| Command | Description | Permission |
|---|---|---|
/afk |
Toggle your own AFK status | (none) |
/afk reload |
Reload all configuration files | ezafk.reload |
/afk gui |
Open the AFK staff overview panel | ezafk.gui |
/afk toggle <player> |
Force a player's AFK state | ezafk.toggle |
/afk bypass whitelist <add|remove|list> [player] |
Manage the persistent bypass whitelist | ezafk.bypass.manage |
/afk bypass blacklist <add|remove|list> [player] |
Manage the persistent bypass blacklist | ezafk.bypass.manage |
/afk bypass <player> |
Toggle per-session bypass for a player | ezafk.bypass.manage |
/afk info <player> |
View a player's AFK session details | ezafk.info |
/afk time [player] |
View total AFK time | ezafk.time |
/afk time reset <player> |
Reset a player's AFK time | ezafk.time.reset |
/afk top |
Show the AFK time leaderboard | ezafk.top |
/afk zone pos1 / pos2 |
Select zone corners | ezafk.zone.manage |
/afk zone add <name> |
Create an AFK zone | ezafk.zone.manage |
/afk zone remove <name> |
Remove an AFK zone | ezafk.zone.manage |
/afk zone list |
List all zones | ezafk.zone.list |
Aliases: /ezafk, /ea, /afktime, /afktop
Permissions
| Node | Default | Description |
|---|---|---|
ezafk.reload |
OP | Reload configuration |
ezafk.bypass |
OP | Never be marked AFK automatically |
ezafk.bypass.manage |
OP | Toggle bypass for other players |
ezafk.toggle |
OP | Toggle other players' AFK state |
ezafk.info |
OP | View AFK details for other players |
ezafk.kick.bypass |
OP | Never be kicked by EzAfk |
ezafk.gui |
OP | Open the staff GUI |
ezafk.gui.view-active |
OP | View non-AFK players in the GUI |
ezafk.gui.actions |
OP | Use action buttons in the GUI |
ezafk.time |
all | View own AFK time |
ezafk.time.others |
OP | View another player's AFK time |
ezafk.time.reset |
OP | Reset a player's AFK time |
ezafk.top |
OP | View the leaderboard |
ezafk.economy.bypass |
OP | Skip economy AFK charges |
ezafk.zone.list |
OP | List AFK zones |
ezafk.zone.manage |
OP | Create and remove zones |
PlaceholderAPI Placeholders
Requires PlaceholderAPI. The expansion registers automatically. No extra setup needed.
| Placeholder | Returns |
|---|---|
%ezafk_status% |
AFK or ACTIVE |
%ezafk_status_colored% |
&cAFK or &aACTIVE |
%ezafk_since% |
Seconds since AFK session started (empty if not AFK) |
%ezafk_last_active% |
Seconds since last player activity |
%ezafk_total_seconds% |
Total lifetime AFK seconds |
%ezafk_total% |
Total AFK time HH:MM:SS |
%ezafk_total_formatted% |
Verbose, e.g. 2 hours 15 minutes |
%ezafk_prefix% |
Configured AFK display-name prefix |
%ezafk_suffix% |
Configured AFK display-name suffix |
%ezafk_playtime_active_seconds% |
Active (non-AFK) playtime in seconds |
%ezafk_playtime_active% |
Active playtime HH:MM:SS |
%ezafk_playtime_active_formatted% |
Active playtime verbose |
%ezafk_afk_count% / %ezafk_afk_players% |
Number of AFK players |
%ezafk_active_count% / %ezafk_active_players% |
Number of non-AFK players |
Configuration Overview
EzAfk's settings are spread across focused files for clarity:
config.yml AFK detection, kick, anti-bypass, economy, integrations
gui.yml Staff GUI layout and action buttons
zones.yml AFK zone definitions with coordinates and rewards
mysql.yml Database connection (only when storage.type: mysql)
messages/ Language files: en.yml, es.yml, nl.yml, ru.yml, zh.yml, de.yml
Core settings (config.yml)
afk:
timeout: 300 # seconds of inactivity → AFK
broadcast:
enabled: true # announce AFK in chat
title:
enabled: true # show title to the AFK player
anti:
infinite-waterflow: false
infinite-vehicle: false
bubble-column: false
kick:
enabled: false # kick AFK players
enabledWhenFull: false # only kick when server is at capacity
timeout: 600 # seconds AFK before kick
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
Integrations
| Integration | Notes |
|---|---|
| Vault / Economy | Required for economy costs and zone economy rewards |
| PlaceholderAPI | Auto-detected; provides 16 AFK placeholders |
| WorldGuard | Adds afk-bypass region flag; use /rg flag <region> afk-bypass allow |
| TAB | Delegate tab-list AFK prefix formatting to the TAB plugin |
| Simple Voice Chat | Play MP3 sounds on AFK state changes |
| bStats | Anonymous usage statistics (opt-out in config.yml) |
| Spigot update checker | Console reminder when a new version is available |
Links
- Documentation: full configuration guide, feature pages, and API reference
- Discord: support, bug reports, and feature requests
- GitHub: source code and issue tracker
- Developer API:
PlayerAfkStatusChangeEventandAfkReasonenum
下载 EzAfk
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EzAfk
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EzAfk
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EzAfk
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EzAfk
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EzAfk
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EzAfk
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EzAfk
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EzAfk
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EzAfk
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
修复
- 聊天消息(AFK 广播、返回、进入/离开区域等)现在支持在 PlaceholderAPI 占位符值中使用 MiniMessage 标签(例如
<red>、<gradient>),同时保留传统的&颜色代码,与物品描述中已有的格式保持一致。 - 解决了 Paper/Folia 冒烟测试 CI 中的一个问题:当版本 组 键(例如
26.1)直接传递给 fill.papermc.io 的构建查找端点时,该端点需要具体的版本号(例如26.1.2)。现在会自动查找给定组对应的最新版本号。 - 修复了 Spigot 冒烟测试 BuildTools 步骤中,当
--rev解析出的具体版本与矩阵中的字面值不同(例如26.1构建出spigot-26.1.2.jar)时,复制错误 jar 文件名的问题。
更改
- 将项目重构为多模块 Maven 构建结构(
ezafk-api、ezafk-core、ezafk-folia、ezafk-paper-26.1、ezafk),以更好地隔离平台特定(Paper/Folia)的代码路径。发布的插件仍为单个阴影 jar 包,安装和配置方式无任何变化。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧