WhosAFK - 挂机玩家列表

许多插件会在玩家挂机时进行广播通知。这固然不错，但如果玩家在广播之后才加入服务器，他们如何知道哪些玩家正在挂机呢？本插件正是为了解决这个问题而设计的。

当玩家进入挂机状态时，插件会将他们的玩家名在 TAB 列表中显示为蓝色，并在名字末尾添加“(AFK)”标识。其他玩家既可以通过服务器广播得知有人挂机，也可以通过按住 TAB 键查看列表，轻松识别出所有挂机玩家。

处于挂机状态的玩家将不会受到伤害，也不会消耗饥饿值。

💡功能特性

• 自动检测玩家静止状态并标记为 AFK。
• 在 TAB 列表中，AFK 玩家的名字会变为蓝色并带有“(AFK)”后缀。
• 服务器会广播玩家进入或离开 AFK 状态的通知。
• AFK 玩家不会受到伤害或损失饥饿值。
• 提供完整的权限控制和可配置选项。
• 支持开发者 API，允许其他插件监听 AFK 状态变化事件。

🎮命令

/afk

• 执行此命令的玩家将广播自己进入 AFK 状态。
• 管理员可以通过添加玩家名作为参数，为其他玩家设置 AFK 状态。
• 示例：/afk 或 /afk Notch

/whosafkreload

• 用于在修改配置文件后重新加载配置。
• 需要权限：whosafk.reload

✨权限

• whosafk.afk

允许玩家使用 /afk 命令。默认所有玩家都拥有此权限。

• whosafk.autoafk

允许玩家在静止一段时间后自动进入 AFK 模式。默认所有玩家都拥有此权限。

• whosafk.reload

允许玩家使用 /whosafkreload 命令。默认仅授予管理员。

🔧配置

以下是默认配置文件内容

auto-afk:
  enabled: true
  timeout: 60
allow-movement-while-afk: true
movement-affects-afk: true
allow-collisions: false

配置项说明

• auto-afk.enabled

设置为 true 时，插件会在玩家静止一段时间后自动将其设为 AFK 模式。

• auto-afk.timeout

玩家被自动设为 AFK 前需要静止的秒数。

• allow-movement-while-afk

设置为 false 时，AFK 玩家将无法移动，直到他们输入 /afk 命令。

• movement-affects-afk

设置为 true 时，如果玩家移动或被外力推动，将自动退出 AFK 模式。

注意：如果 allow-movement-while-afk 设为 false，此设置无效。

• allow-collisions

设置为 false 时，其他生物或玩家将无法推动 AFK 状态下的玩家（推动会导致其退出 AFK 模式）。

⭐工作原理

本插件利用计分板队伍系统实现 AFK 状态显示。

• 插件启用时，会自动创建一个名为 afkers 的队伍（如果不存在）。
• 该队伍的颜色会被设为蓝色，队伍后缀设为“ (AFK)”。
• 当玩家输入 /afk 后，会被加入 afkers 队伍。
• 当玩家再次输入 /afk 或以其他方式退出 AFK 状态时，会从 afkers 队伍中移除，之后不再属于任何队伍。
• 如果配置中 allow-collisions 设为 true，插件加载或重载时会将队伍的碰撞规则设为 NEVER，否则设为 ALWAYS。

❓API 文档

WhosAFK 在玩家进入或离开 AFK 状态时会触发事件。开发者可以监听这些事件来自定义行为。

事件监听示例

@EventHandler
public void playerGoesIntoAFKMode(AFKStatusOnEvent e){
    // 设置自定义消息
    e.setMessage(ChatColor.YELLOW + "- " + e.getPlayer().getName() + " is now AFK");
    // 禁用消息
    e.setMessage(null);
    // 取消事件
    e.setCancelled(true);
}

@EventHandler
public void playerLeavesAFKMode(AFKStatusOffEvent e){
    // 设置自定义消息
    e.setMessage(ChatColor.YELLOW + "- " + e.getPlayer().getName() + " is no longer AFK");
    // 禁用消息
    e.setMessage(null);
    // 取消事件
    e.setCancelled(true);
}

🔧源代码

本插件的源代码托管在 GitHub 上。

点击此处查看 GitHub 仓库

开发状态

• 添加配置文件：已完成