AntiAFK 插件
一个适用于 Minecraft Paper 1.21.10 的完整反挂机(Anti-AFK)插件,可自动检测并踢出闲置玩家。
✨ 功能
- ? 自动 AFK 检测 - 检测长时间不活跃的玩家
- ⚠️ 警告系统 - 在踢出玩家前发出警告
- ? 手动 AFK 切换 - 玩家可以使用
/afk命令将自己标记为 AFK - ⚙️ 完全可配置 - 自定义超时时间、消息和检测方式
- ?️ 权限系统 - 工作人员可以绕过 AFK 检测
- ? 广播消息 - 当玩家进入或退出 AFK 状态时,服务器会收到通知
? 要求
- Minecraft: 1.21.10
- 服务端软件: Paper(或其分支如 Purpur)
- Java: 21 或更高版本
? 安装
- 从 Releases 页面下载最新的
AntiAFK-1.0.0.jar - 将 JAR 文件放入服务端的
plugins文件夹中 - 重启服务器
- 在
plugins/AntiAFK/config.yml中自定义配置 - 使用
/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
? 工作原理
- 活动追踪:插件追踪玩家上次活跃的时间
- 定期检查:每隔 X 刻(可配置)检查玩家是否闲置过久
- 警告:在
warning-time秒时,玩家会收到警告 - 踢出:在
afk-timeout秒时,玩家会被踢出 - 广播:当有人进入或退出 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 社区制作
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
46
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
旅行地图
mysticdrew
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
冒险实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧