AFKStatus

AFKStatus – 服务器简易挂机检测

!\[\](https://media.forgecdn.net/attachments/description/1318335/description\_49b50151-d6ab-43be-bb54-6c133719fb55.png)

AFKStatus 是一款适用于Minecraft的轻量级服务端模组，基于NeoForge 和 Forge 加载器开发。它会自动追踪玩家活动，并在玩家一段可配置的时间内停止移动或聊天时将其标记为挂机（离开键盘）。玩家也可以使用简单的 /afk 命令手动切换挂机状态。

功能

自动检测挂机
通过追踪移动和聊天活动来检测玩家是否处于非活动状态。超过可配置的超时时间后，玩家会被标记为挂机并广播通知。

手动切换挂机状态
/afk 命令允许玩家手动设置或取消挂机状态。

可自定义超时时间
可通过配置设置挂机触发延迟，以及可选的踢出超时时间。

可选的自动踢出
自动踢出挂机时间超过设定时长的玩家。

自定义消息和颜色
系统消息可自定义，包括颜色选项。

记分板集成
使用 Minecraft 的队伍系统，为挂机玩家显示 [AFK] 标记。

仅需安装在服务端
无需在客户端安装。只需将模组放入服务器的 mods/ 文件夹即可。

配置

服务器首次启动后，会在 config/ 目录中创建配置文件（afkstatus-server.toml）。

afkTriggerTimer — 玩家在被标记为挂机前的非活动时间（分钟）。
默认值：5
范围：1-60 分钟

afkKickTimer — 玩家挂机后，等待多久将其踢出（分钟）。
默认值：0（已禁用）
范围：0-120 分钟

kickMessage — 玩家被踢出时显示给他的踢出消息。

systemMessages — 是否广播挂机状态变更。
默认值：false
选项：true / false

checkIntervalTick — 检查挂机状态的频率。
（20 ticks = 1 秒）
默认值：20
范围：1-1200 ticks

messageColor —  消息颜色。
默认值：yellow

detection.enabled — 如果为 true，鼠标视角转动（摄像机旋转）会被视为活动。
默认值：false

detection.thresholdDegrees — 被视为活动所需的偏航角/俯仰角最小变化值。
默认值：5
范围：1-45 度

有效颜色： black, dark_blue, dark_green, dark_aqua, dark_red, dark_purple, gold, gray, dark_gray, blue, green, ¨C25C, ¨C26C, ¨C27C, ¨C28C, ¨C29C

bypassEnabled
计算睡眠比例时忽略挂机玩家

黑名单

AFKStatus 提供灵活的黑名单系统，可将特定玩家排除在自动挂机踢出功能之外。此功能适用于需要在非活动状态下仍保持连接的服务器管理人员、受信任玩家或机器人。

• 存储： 黑名单条目以 JSON 文件形式保存在 config/AFKStatus/ 目录下，文件名为 afk_blacklist.json。
• 命令： 管理员可以在游戏中使用 /afk blacklist 子命令修改黑名单。
• 行为：
  • 黑名单中的玩家仍会正常被追踪挂机状态并添加标记。
  • 无论配置的踢出计时器如何设置，黑名单中的玩家都不会因挂机而被踢出。

/afk — 切换你的挂机状态。状态变化会自动广播给其他玩家。

/afk help— 显示 AFKStatus 命令的帮助说明。    

以下命令需要管理员权限

/afk blacklist add — 将玩家添加到挂机黑名单。黑名单中的玩家可以挂机，但不会被自动踢出。       

/afk blacklist remove — 将玩家从挂机黑名单中移除。

/afk blacklist list — 列出当前挂机黑名单中的所有玩家。

afk blacklist reload — 从磁盘重新加载黑名单，适用于手动编辑黑名单文件后。

这样，玩家无需移动或聊天，即可手动标记自己正在挂机或已经回来。