# Void AFK - 简单且可配置的 AFK 管理器,附带奖励
## 什么是 Void AFK?
- Void AFK 是一个轻量级且易于管理的 Minecraft 服务器插件,可帮助您自动检测和处理 AFK(Away From Keyboard,离开键盘)玩家。跟踪谁在积极游戏,甚至奖励那些在您的服务器上花费时间的人!
## 特性
* **自动 AFK 检测:** 在可配置的不活动时间段后,玩家会被自动标记为 AFK(没有移动、互动等)。
* **视觉 AFK 标签:** 被标记为 AFK 的玩家会在他们的名字中添加自定义前缀或标签,包括聊天显示名称和玩家列表(标签菜单)。
* **活动监测:** 任何配置的活动(移动、互动等)都会自动移除 AFK 状态,并恢复玩家的名字。
* **可配置阈值:** 可以在 `config.yml` 中轻松设置触发 AFK 状态所需的不活动时间。
* **可定制消息:** 发送给玩家的所有消息和命令响应都可以完全配置,支持标准的 Minecraft 颜色代码 (`&`)。
* **可选奖励系统:** 通过在定期间隔执行可配置的控制台命令来奖励您的 AFK 玩家。非常适合奖励游戏时间!
* **高度可配置的奖励:** 配置奖励间隔(以分钟为单位),控制台命令模板(支持 `%player%` 占位符),可选的玩家消息,并使用可定制的粒子和声音效果添加视觉效果!
* **奖励视觉效果和声音:** 通过在玩家收到奖励时播放可配置的粒子和声音来使奖励更令人满意。
---
## 占位符 (安装 PlaceholderAPI 插件才能使用)
- `%voidafk_is_afk%` (true/false)
- `%voidafk_afk_time%` (格式化时间)
---
## 命令
- `/voidafk reload` - 重新加载插件的 `config.yml`。
- `/voidafk reward ` - 设置奖励的控制台命令模板。使用 `%player%` 作为占位符。
- 别名: `/vafk`
---
## 权限
- `voidafk.reload` - 允许使用 `/voidafk reload` 命令。(默认:OP)
- `voidafk.reward` - 允许使用 `/voidafk reward` 命令。(默认:OP)
---
## 安装
1. 从本页面下载最新的 `VoidAFK-VERSION.jar` 文件。
2. 将 JAR 文件放入您的 Spigot/Paper 服务器的 `plugins` 文件夹中。
3. 启动或重启您的服务器。
4. (可选)编辑生成的 `plugins/VoidAFK/config.yml` 以定制设置。在游戏中或控制台中通过 `/voidafk reload` 应用更改。
---
## 支持与报告问题
如果您发现任何错误、有功能请求或需要帮助,请...
- ...在 [SpigotMC 页面](https://www.spigotmc.org/resources/voidafk.125858/) 上留言。
提供服务器版本、插件版本以及任何相关的控制台错误将非常有帮助!
---
## 鸣谢
由 **Void Labs** 充满热情地开发。
---
## 未来计划
- 添加 `/afk` 命令,允许玩家手动切换 AFK 状态。
- 实施防止玩家 AFK 时执行更具体的操作。
- 更多 AFK 标签选项(例如更改显示名称)。
- 更多功能
敬请关注更新!