挂机实用工具

AFK Utilitys

一款面向 Minecraft Fabric 的高级实用模组，通过智能自动化与安全功能管理 AFK（暂离键盘）状态。

设置按键绑定：K

使用场景

• 服务器 AFK 保护：防止因 AFK 超时系统被踢出
• 安全管理：生命值过低或受到伤害时自动断开连接
• 自动重连：服务器重启时不会丢失你的位置
• 饥饿管理：离开时保持饥饿条全满
• 农场自动化：为被动生物农场和自动点击器维持活跃状态

功能

反 AFK 系统

模拟自然的玩家活动，防止被服务器踢出：

• 自动跳跃：随机化的跳跃间隔，使行为更自然
• 自动挥手：定期挥手并配合 使用（右键）交互。非常适合自动拨动拉杆或与按钮交互。
• 自动潜行：可配置的下蹲时长与间隔
• 平移模式：自动左右移动，避免基于坐标的检测
• 旋转模式：
  • 客户端模式：在视觉上旋转你的视角
  • 服务端模式：发送旋转数据包，同时保持屏幕静止
• 聊天消息：定期发送自定义文本消息
  • 间隔范围：0.1 至 30 分钟
  • 支持自定义消息

自动重连

智能重连系统，实现不间断游戏体验：

• 服务器记忆：自动记住上次连接的服务器
• 倒计时计时器：在断开连接界面显示视觉倒计时
• 快速开关：可直接在断开连接界面启用/禁用
• 可配置延迟：设置重连尝试前的自定义等待时间

自动登出（安全断开）

离开时保护你的角色：

• 生命值阈值：当生命值低于配置值时断开连接
• 即时受伤模式：受到任何伤害时立即断开连接
• 安全锁：自动登出触发后可选禁用自动重连
• 防止死亡：在危险情况下保障你的安全

自动进食

智能饥饿管理：

• 智能时机：仅在饥饿恢复不会被浪费时进食
• 黑名单支持：排除特定物品（例如腐肉、蜘蛛眼）
• 高效消耗：根据食物价值计算最佳进食时机

安装

要求

• Minecraft 1.21+
• Fabric Loader 0.16.0+
• FabricAPI

下载

从 Modrinth 下载模组，并将 .jar 文件放入你的 .minecraft/mods 文件夹。

在 Modrinth 下载

配置

该模组采用基于侧边栏的配置界面，包含四个主要类别：

1. Anti-AFK：配置所有防踢出功能与间隔
2. Auto-Eat：设置饥饿阈值并管理食物黑名单
3. Reconnect：调整重连延迟并切换自动重连
4. Auto-Log：配置生命值阈值与安全设置

配置文件

设置会保存至：

.minecraft/config/afkutility.json

示例配置：

{
  "antiAfk": {
    "autoJump": true,
    "autoSwing": true,
    "autoSneak": false,
    "sneakTime": 2.0,
    "strafeMode": false,
    "spinMode": "OFF",
    "chatMessages": false,
    "messageInterval": 5.0,
    "customMessage": "I am not AFK"
  },
  "autoReconnect": {
    "enabled": true,
    "delay": 5
  },
  "autoLog": {
    "enabled": true,
    "healthThreshold": 4.0,
    "onDamage": false,
    "disableReconnect": true
  },
  "autoEat": {
    "enabled": true,
    "blacklist": ["minecraft:rotten_flesh", "minecraft:spider_eye"]
  }
}

面向开发者

构建

./gradlew build

输出：build/libs/afk-utility-1.0.0.jar

项目结构

src/client/java/dev/afk/utility/
├── AFKUtilityClient.java          # 客户端入口点
├── config/
│   └── ModConfig.java             # 配置管理
├── features/
│   ├── AntiAFK.java               # 反 AFK 实现
│   ├── AutoReconnect.java         # 重连处理器
│   ├── AutoLog.java               # 安全断开
│   └── AutoEat.java               # 饥饿管理
├── mixin/client/
│   ├── DisconnectScreenMixin.java # UI 集成
│   └── ClientPlayerMixin.java     # 玩家事件钩子
└── screen/
    └── ConfigScreen.java          # 侧边栏配置界面

许可证

MIT

鸣谢

• Fabric API 团队
• Minecraft 模组社区