Skip to content

Qinloren/QuickMate

Repository files navigation

QuickMate

Minecraft Fabric Java

一个功能强大的 Minecraft Fabric 连锁挖掘模组,提供智能扫描和批量破坏功能

✨ 特性

🔍 智能扫描系统

  • 多种扫描策略:支持无规则、水平直线、垂直直线、阶梯式、3x3隧道等多种扫描模式
  • 精准/模糊匹配:可选择只破坏相同方块或相似类型方块
  • 实时预览:通过选择框高亮显示将要破坏的方块范围
  • 可配置最大数量:限制单次连锁破坏的最大方块数(1-2048)

⛏️ 连锁破坏

  • 服务端权威:所有扫描和破坏逻辑在服务端执行,防止作弊
  • 自动批量破坏:破坏一个方块后自动破坏所有匹配的相邻方块
  • 游戏模式适配
    • 生存模式:正常生成掉落物
    • 创造模式:可选是否生成掉落物
  • 高效性能:使用并发数据结构,支持多玩家同时使用

🎮 用户友好

  • 按键绑定:一键开关连锁挖掘功能
  • 配置界面:美观的图形化配置界面
  • 多语言支持:支持中文和英文
  • 实时通知:可选的功能开启/关闭提示

📦 安装

前置要求

安装步骤

  1. 下载最新版本的 QuickMate .jar 文件
  2. 将文件放入 .minecraft/mods 文件夹
  3. 启动游戏即可使用

🎯 使用方法

基本操作

  1. 打开配置界面:按下默认按键(可在控制设置中修改)
  2. 启用连锁挖掘:在配置界面或通过按键切换状态
  3. 对准目标方块:看向想要挖掘的方块
  4. 开始挖掘:正常破坏方块,连锁功能会自动生效

配置选项

连锁配置

  • 连锁挖掘:启用/禁用连锁挖掘功能
  • 最大方块数:单次连锁破坏的最大方块数量(1-2048)
  • 匹配模式
    • 精准模式:只破坏完全相同的方块
    • 模糊模式:破坏相似的方块类型
  • 显示通知:是否在聊天栏显示功能开关提示

扫描配置

  • 扫描策略:选择不同的扫描算法
    • 无规则:向所有方向扩展
    • 水平直线:仅水平方向扫描
    • 垂直直线:仅垂直方向扫描
    • 向下阶梯:向下楼梯式扫描
    • 向上阶梯:向上楼梯式扫描
    • 3x3 隧道:3x3 范围的隧道式扫描
  • 显示选择框:是否高亮显示扫描结果
  • 创造模式掉落:创造模式下是否生成掉落物

🔧 开发

环境要求

  • Java 21 或更高版本
  • Gradle 8.x
  • IDE(推荐 IntelliJ IDEA)

构建项目

# 克隆仓库
git clone https://github.com/yourusername/QuickMate.git
cd QuickMate

# 构建模组
./gradlew build

# 运行客户端(开发模式)
./gradlew runClient

项目结构

QuickMate/
├── src/main/java/com/zeeyeh/
│   ├── entity/              # 数据包实体类
│   ├── manager/             # 核心管理器(连锁破坏、玩家状态)
│   ├── network/             # 网络通信处理
│   ├── strategy/            # 扫描策略实现
│   └── enums/               # 枚举定义
├── src/client/java/com/zeeyeh/client/
│   ├── config/              # 配置管理
│   ├── gui/                 # 配置界面
│   ├── manager/             # 客户端管理器
│   ├── network/             # 客户端网络处理
│   └── render/              # 渲染器(选择框)
└── src/main/resources/
    └── assets/quickmate/
        └── lang/            # 多语言文件

🌐 技术架构

客户端-服务端通信

客户端                          服务端
  |                               |
  |--- VeinMineActivePayload --->|
  |     (启用/禁用连锁)           |
  |                               |
  |--- ScanRequestPayload ------>|
  |     (请求扫描)                |
  |                               |
  |<-- ScanResultPayload --------|
  |     (返回扫描结果)            |
  |                               |
  |   [显示选择框]                |
  |                               |
  |   [玩家破坏方块]              |
  |                               |
  |   [PlayerBlockBreakEvents] -->|
  |     (触发连锁破坏)            |
  |                               |
  |                       [批量破坏方块]

关键设计决策

  • 服务端权威:扫描和破坏逻辑都在服务端执行,确保公平性
  • 状态缓存:服务端缓存每个玩家的扫描结果和配置
  • 事件驱动:使用 Fabric API 的事件系统监听方块破坏
  • 并发安全:使用 ConcurrentHashMap 管理多玩家状态

📝 许可证

本项目采用 MIT 许可证。详见 LICENSE 文件。

🙏 致谢

📮 反馈与支持

如果你遇到问题或有建议,欢迎提交 Issue 或 Pull Request!


Made with ❤️ by Zeeyeh

About

一键连锁破坏,极速批量建造 —— 让你的建筑效率飞跃升级。​

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages