xAntiAFK - Detect All AFK Players On Your Server - xAntiAFK - 全服挂机检测插件

简介

xAntiAFK 是一款功能强大的 Minecraft 插件，用于自动检测服务器中的挂机玩家，并执行高度自定义的自动化操作，如发送提醒、执行命令或传送玩家，以优化服务器资源与玩家体验。

💡核心功能

• 全面检测：自动检测服务器中所有处于 AFK（挂机）状态的玩家。
• 自定义操作：当玩家挂机时，可执行命令、发送消息、显示标题、传送玩家，甚至将其转移到其他服务器（支持 BungeeCord）。
• 智能返回：当玩家结束挂机状态时，可将其传送回挂机前的位置。
• 高度可定制：所有检测条件、时间、消息和操作均可通过配置文件自由调整。
• 广泛兼容：支持 TAB、PlaceholderAPI、Factions 以及 WorldGuard 7.0.x。

🎮命令与权限

命令

• /xaa reload - 重载插件配置文件。
• /xaa version - 查看插件版本。
• /afk - 查看自己的 AFK 状态。
• /afk <玩家名> - 查看或设置指定玩家的 AFK 状态。

权限

• xantiafk.admin - 允许使用管理员命令（如 /xaa reload）。
• xantiafk.bypass - 使玩家免于 AFK 检测。
• xantiafk.afk - 允许使用 /afk 命令。

🔧配置概览

以下为配置文件 (config.yml) 的主要结构说明：

基础设置

• checkInterval：检测间隔（单位：刻，20刻=1秒）。
• checkOp：是否检测拥有 xantiafk.bypass 权限的 OP 玩家。
• afkOnJoin：玩家加入服务器时是否直接设为 AFK 状态。
• noLongerOnChat：玩家发送聊天消息时是否自动结束 AFK 状态。

阶段化操作

在 actions 部分，可以按时间（秒）设置触发动作：

actions:
  '180': # 挂机180秒后执行
    - messages:prevent # 发送提醒消息
  '240':
    - setAfk # 正式标记为AFK状态
  '360':
    - commands:kick # 执行踢出命令

事件与消息

• onAfk：玩家变为 AFK 时，可设置免伤、发送标题、执行动作（如广播）。
• noLonger：玩家结束 AFK 时，可设置传送回原位并执行动作。
• 所有提示消息、广播前缀、踢出命令等文本均可完全自定义。

其他特性

• 世界管理：可设置特定世界忽略 AFK 检测。
• 领地支持：与 Factions 插件集成，可控制 AFK 玩家是否获得势力能量。
• WorldGuard 标志：支持在 WorldGuard 7.0.x 区域中设置 afk-bypass、afk-check 等标志来控制检测行为。

✨可用动作类型

在配置文件的 actions 中，可以使用以下类型的动作：

• messages:<消息键> - 发送配置文件中定义的私人消息。
• broadcasts:<广播键> - 向全服发送广播。
• commands:<命令> - 以控制台身份执行命令（支持 %player% 变量）。
• playerCommands:<命令> - 以玩家身份执行命令。
• teleport:<位置键> - 将玩家传送至配置文件中预定义的位置坐标。
• titles:<标题键> - 向玩家显示标题动画。
• server:<服务器名> - 将玩家通过 BungeeCord 转送至其他子服。

⭐API 与扩展

开发者 API

插件提供了简单的 API 供其他插件集成

xAntiAFKAPI.getAfkPlayers() // 返回 List<Player>，所有AFK玩家列表
xAntiAFKAPI.isAfk(player) // 返回 Boolean，检查指定玩家是否AFK
xAntiAFKAPI.setAfk(Player, Boolean) // 手动设置玩家的AFK状态

事件：PlayerAfkStatusChangeEvent - 当玩家的 AFK 状态改变时触发。

PlaceholderAPI 变量

若安装了 PlaceholderAPI，可使用以下变量：

• %xantiafk_status%：显示玩家的状态（根据配置显示，如 [AFK]）。
• %xantiafk_time%：显示玩家当前状态已持续的格式化时间。

❓注意事项与支持

• WorldGuard：仅支持 7.0.x 版本，旧版本暂不支持。
• 配置修改：修改 config.yml 后，请使用 /xaa reload 重载。
• 问题反馈：如需获取支持或提交建议，可访问插件发布页或联系作者。
• 服务器列表：若希望您的服务器被列在插件页，请联系作者。