Anti AFK System

插件

· 作者 Samuele_NL

一款适用于 Minecraft Paper 1.21.10 的完整反挂机插件,可自动检测并踢出闲置玩家。

0 本站下载 0 关注 更新于 10 个月前

最新 1.0.0 · 1.21.11 · Paper

一键开服(送7天)

AntiAFK 插件

一个适用于 Minecraft Paper 1.21.10 的完整反挂机(Anti-AFK)插件,可自动检测并踢出闲置玩家。

✨ 功能

  • ? 自动 AFK 检测 - 检测长时间不活跃的玩家
  • ⚠️ 警告系统 - 在踢出玩家前发出警告
  • ? 手动 AFK 切换 - 玩家可以使用 /afk 命令将自己标记为 AFK
  • ⚙️ 完全可配置 - 自定义超时时间、消息和检测方式
  • ?️ 权限系统 - 工作人员可以绕过 AFK 检测
  • ? 广播消息 - 当玩家进入或退出 AFK 状态时,服务器会收到通知

? 要求

  • Minecraft: 1.21.10
  • 服务端软件: Paper(或其分支如 Purpur)
  • Java: 21 或更高版本

? 安装

  1. 从 Releases 页面下载最新的 AntiAFK-1.0.0.jar
  2. 将 JAR 文件放入服务端的 plugins 文件夹中
  3. 重启服务器
  4. 在 plugins/AntiAFK/config.yml 中自定义配置
  5. 使用 /afkreload 重新加载配置

⚙️ 配置

配置文件位于 plugins/AntiAFK/config.yml:

# 玩家被视为 AFK 前的秒数
afk-timeout: 300

# 发出警告前的秒数
warning-time: 270

# 检查间隔(以刻为单位,20 刻 = 1 秒)
check-interval: 100

# 消息(使用 & 表示颜色代码)
messages:
  kick: "&c你因不活跃被踢出!"
  warning: "&e警告:你将在 {time} 秒后因不活跃被踢出!"
  afk-enabled: "&7你现在处于 AFK 状态"
  afk-disabled: "&7你不再处于 AFK 状态"
  player-afk: "&7{player} 现在处于 AFK 状态"
  player-back: "&7{player} 回来了"
  reload: "&a配置已重新加载!"
  no-permission: "&c你没有执行此操作的权限!"

# 重置 AFK 状态的行为
detect-movement: true
detect-chat: true
detect-block-break: true
detect-block-place: true
detect-interact: true
detect-damage: true

配置选项

选项 默认值 描述
afk-timeout 300 玩家被踢出前的秒数
warning-time 270 发出警告前的秒数
check-interval 100 每次检查之间的刻数(20 = 1 秒)
detect-movement true 将移动视为活动
detect-chat true 将聊天视为活动
detect-block-break true 将破坏方块视为活动
detect-block-place true 将放置方块视为活动
detect-interact true 将交互视为活动
detect-damage true 受到伤害视为活动

? 命令

命令 描述 权限
/afk 手动切换你的 AFK 状态 antiafk.command
/afkreload 重新加载插件配置 antiafk.reload

? 权限

权限 默认值 描述
antiafk.command true 使用 /afk 命令
antiafk.bypass op 绕过 AFK 检测(用于工作人员)
antiafk.reload op 重新加载配置

权限示例

LuckPerms:

# 给予版主绕过权限
lp group moderator permission set antiafk.bypass true

# 给予管理员重载权限
lp group admin permission set antiafk.reload true

? 工作原理

  1. 活动追踪:插件追踪玩家上次活跃的时间
  2. 定期检查:每隔 X 刻(可配置)检查玩家是否闲置过久
  3. 警告:在 warning-time 秒时,玩家会收到警告
  4. 踢出:在 afk-timeout 秒时,玩家会被踢出
  5. 广播:当有人进入或退出 AFK 状态时,其他玩家会收到通知

检测到的活动

如果配置中启用,插件会检测以下活动:

  • ✅ 移动(位置变化,不仅仅是头部旋转)
  • ✅ 聊天消息
  • ✅ 破坏方块
  • ✅ 放置方块
  • ✅ 交互(按钮、门等)
  • ✅ 受到伤害
  • ✅ 执行命令

? 示例

示例 1:默认用法

玩家不活跃 4 分钟
→ 4 分 30 秒时:"⚠️ 警告:你将在 30 秒后因不活跃被踢出!"
→ 5 分钟时:玩家被踢出

示例 2:手动 AFK

玩家输入:/afk
→ "你现在处于 AFK 状态"
→ 服务器广播:"Player123 现在处于 AFK 状态"

玩家移动
→ "你不再处于 AFK 状态"
→ 服务器广播:"Player123 回来了"

示例 3:工作人员绕过

拥有 antiafk.bypass 权限的工作人员
→ 无论是否不活跃,永远不会被踢出

? 故障排除

玩家没有被踢出:

  • 检查 afk-timeout 是否正确设置
  • 验证玩家没有 antiafk.bypass 权限
  • 验证插件是否正确加载,使用 /plugins 命令检查

警告不起作用:

  • 确保 warning-time 小于 afk-timeout
  • 检查控制台是否有错误

配置更改未生效:

  • 编辑配置后使用 /afkreload
  • 或者重启服务器

? 许可证

本项目开源,可用于个人和商业用途。


由 ❤️ 为 Minecraft 社区制作

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源