# no_mining

**Repository Path**: nimshade/no_mining

## Basic Information

- **Project Name**: no_mining
- **Description**: 禁止玩家挖掘方块，但是允许放置方块。在一些FPS服务器中非常好用
- **Primary Language**: Java
- **License**: LGPL-2.1
- **Default Branch**: no_mining
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-12
- **Last Updated**: 2026-04-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# NoMining - 禁止挖掘模组

## 📖 简介

NoMining 是一个轻量级的Forge 模组，允许服务器管理员或地图制作者通过简单的游戏规则禁止玩家挖掘方块，同时保持放置物品的功能不受影响。

## ✨ 功能特性

- ✅ **禁止挖掘** - 玩家无法破坏任何方块
- ✅ **允许放置** - 放置物品完全正常
- ✅ **游戏规则控制** - 通过 `/gamerule` 命令实时开关
- ✅ **模式限制** - 只对生存模式玩家生效，创造/旁观模式不受影响
- ✅ **不影响攻击** - 左键攻击生物完全正常
- ✅ **轻量级** - 几乎零性能开销

## 🎮 使用方法

### 游戏规则

| 命令 | 说明 |
|------|------|
| `/gamerule disableMining` | 查看当前设置 |
| `/gamerule disableMining true` | 开启禁止挖掘（默认） |
| `/gamerule disableMining false` | 关闭禁止挖掘 |

## ⚙️ 配置

模组无需额外配置，所有功能通过游戏规则控制。

## 📝 工作原理

1. 监听 `BlockEvent.BreakEvent` 事件，直接取消方块破坏
2. 监听 `PlayerEvent.BreakSpeed` 事件，将挖掘速度设为0
3. 客户端每帧重置挖掘进度，清除破裂纹理
4. 通过游戏规则控制功能开关

## ❓ 常见问题

### Q: 为什么我开启模组后还能挖掘？
A: 请检查：
- 是否开启了游戏规则：`/gamerule disableMining true`
- 是否处于创造/旁观模式（这些模式不受限制）
- 服务端是否安装了模组（多人游戏需要服务端也安装）

### Q: 会影响其他玩家吗？
A: 游戏规则对全体玩家生效，但创造模式玩家不受限制。

### Q: 会影响 Mod 中的特殊工具吗？
A: 会，所有方块的挖掘都会被阻止，无论使用什么工具。