# OneKeyMiner

**Repository Path**: mai_xiyu/OneKeyMiner

## Basic Information

- **Project Name**: OneKeyMiner
- **Description**: 连锁挖矿~
mcmod:https://www.mcmod.cn/class/15461.html
curseforge:https://www.curseforge.com/minecraft/mc-mods/onekeyminerforge
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 2
- **Created**: 2024-09-17
- **Last Updated**: 2026-01-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OneKeyMiner NF  

一个便捷的Minecraft模组，支持一键挖矿等实用功能，适配多个版本，已发布于MC百科、Modrinth及CurseForge平台。  


## 🔍 关于模组  
OneKeyMiner NF 是一款为Minecraft玩家设计的辅助模组，核心功能包括一键批量挖矿、智能挖掘范围设置等，旨在提升生存与建筑过程中的操作效率。  

- **MC百科详情页**：[https://www.mcmod.cn/class/15461.html](https://www.mcmod.cn/class/15461.html)  
- **Modrinth页面**：[https://modrinth.com/mod/onekeyminer_nf](https://modrinth.com/mod/onekeyminer_nf)  
- **CurseForge页面**：[https://www.curseforge.com/minecraft/mc-mods/onekeyminer-nf](https://www.curseforge.com/minecraft/mc-mods/onekeyminer-nf)  


## 📋 功能说明  
- 一键挖矿：按下设定快捷键，自动挖掘指定范围（可自定义）内的方块；  
- 智能过滤：支持排除特定方块（如 ores、建筑方块等），避免误挖；  
- 多版本适配：兼容 Minecraft 1.18.x、1.20.x、1.21.x；  
- 轻量设计：无冗余功能，对游戏性能影响极小。  


## 📥 安装方法  
1. 确保已安装对应版本的 Minecraft 客户端及 Forge/Fabric 加载器（根据模组适配类型选择）；  
2. 从 Modrinth 或 CurseForge 下载对应版本的模组JAR文件；  
3. 将JAR文件放入客户端的 `mods` 文件夹中；  
4. 启动游戏，在“模组列表”中确认模组已加载。  


## 📝 使用指南  
1. 进入游戏后，通过“选项-控制”设置一键挖矿的快捷键（默认快捷键可在模组配置界面修改）；  
2. 按快捷键启动/停止挖矿功能，可通过模组配置界面调整挖掘范围（如3x3x3、5x5x5等）；  
3. 配置界面可设置过滤方块列表，支持按方块ID或标签排除。  


## 📜 许可证协议  
本模组的源代码仓库及所有内容（包括但不限于源代码、分支、发行版、衍生作品）受 **《代码仓库许可协议》** 约束，具体条款如下：  

### 核心条款  
- **版权声明**：Copyright (c) 2025 饩雨，保留所有权利。  
- **生效时间**：本协议自2025年1月12日起生效。  
- **使用限制**：  
  1. 禁止任何商业使用（包括但不限于嵌入付费产品、用于盈利性服务、企业商业运营等）；  
  2. 禁止以任何形式发布、上传、分发至网易公司（含关联公司）旗下平台（如网易我的世界、网易云服务等）。  
  3. 禁止基于本代码的任何修改或衍生作品以任何形式发布到网易Minecraft平台。
  (人话:你不能拿着我的锅勺砸我的饭碗，我也就网易这么一个收入来源，我家一个月只给我1000生活费，我也不容易，我只是一个大学生，也是一名重度抑郁患者)
- **衍生与贡献**：Fork仓库或提交内容需完整保留本协议及版权声明，贡献者需保证提交内容不侵权且同意受本协议约束。  
  

完整协议详见仓库根目录的 `LICENSE` 文件。  


## 🤝 贡献指南  
欢迎通过以下方式参与项目：  
1. 提交Issue：报告bug、建议新功能（请在Issue中注明 Minecraft 版本及模组版本）；  
2. 发起Pull Request：修复bug或实现新功能（提交前请确保代码符合项目规范，且未侵犯第三方权利）；  
3. 翻译支持：帮助将模组文案或文档翻译成其他语言。  

所有贡献内容将被视为同意纳入本仓库并受《代码仓库许可协议》约束。  


## ❓ 常见问题  
- **Q：模组支持多人服务器吗？**  
  A：支持多人服务器，前提是服务器也安装该模组。  
- **Q：遇到崩溃或功能失效怎么办？**  
  A：请在对应平台（Modrinth/CurseForge）的评论区或仓库Issue中提交日志文件，注明游戏版本、加载器及冲突模组。  


## 📞 联系作者  
- 项目维护者：Mai_xiyu@vip.qq.com 
- 反馈渠道：优先通过仓库Issue或上述平台评论区沟通。  


---  
请遵守许可协议合理使用本模组，感谢支持！