
[](https://modrinth.com/plugin/onechunkguard)
[](https://github.com/Kamesuta/OneChunkGuard/releases)
[](https://bstats.org/plugin/bukkit/OneChunkGuard/26619)
[](LICENSE)
English | [日本語](https://github.com/Kamesuta/OneChunkGuard)
> 🏆 **只需放置一个方块 - 一片区域保护插件** for Minecraft
OneChunkGuard 是一个简单的土地保护插件,**适合从新手到 Minecraft 高手** 的所有人轻松使用。
利用 WorldGuard API,它将直观的无命令操作与便捷性相结合。
## 🚀 为什么选择 OneChunkGuard?
### 🎮 **完全生存模式支持**
- ⚔️ **无需 OP** - 普通玩家可以保护他们的土地
- 🏗️ **生存或创造** - 在任何游戏模式下都适用
- 🎯 **公平系统** - 每个人都可以保护相同数量的区域(1 片区域)
### ✨ **简单的易用性**
- 🎯 **无需命令即可轻松保护** - 只需放置一个方块即可立即保护
- 🎁 **自动分发系统** - 保护方块自动发给新玩家
- 👀 **视觉反馈** - 玩家头像显示了所有者一目了然。 进入区域时在动作条上显示所有者
- ✨ **区域可视化器** - 粒子显示区域边界
### 🛡️ **灵活的保护系统**
- 🏗️ **多种保护方块类型** - 像出生区域(1x1 片区域)或 VIP 区域(3x3 片区域)一样的多层保护(可配置)
- 📐 **可变的区域范围** - 可以从 1x1 自由配置为 NxN
- 🏛️ **父区域限制** - 仅适用于特定区域的保护方块
- 🔄 **独立的保护管理** - 可以按区域类型独立创建和删除保护
### 👥 **协作功能**
- 🤝 **高级信任系统** - 对每个玩家进行细粒度的权限管理
- 💬 **交互式 TUI** - 在右键单击时显示直观的菜单
- 🎮 **直观的设置** - 只需右键单击和输入玩家姓名即可设置合作玩家
## 📋 要求
- **Minecraft**: 1.20+ | **Java**: 21+
- **服务器**: Spigot/Paper
- **依赖项**:
- WorldGuard 7.0+
- WorldEdit 7.2+
## 🚀 安装
1. 安装 [WorldGuard](https://modrinth.com/plugin/worldguard) 和 [WorldEdit](https://modrinth.com/plugin/worldedit)
2. 从 [Release](https://github.com/Kamesuta/OneChunkGuard/releases) 下载最新版本
3. 将 `OneChunkGuard-X.X.X.jar` 放在 `plugins` 文件夹中
4. 重启服务器
5. 确认插件已成功加载
## 🎯 使用方法 (非常简单!)
### ✨ **只需 3 个步骤!无需任何命令!**
#### 🔥 **1. 加入服务器**

首次加入服务器时,**一个保护方块会自动放置在热栏的第 9 个槽位**。
无需操作! 您可以立即开始保护土地。
#### 🏠 **2. 在您想保护的位置放置方块**

只需在您想保护的位置放置保护方块。
- 放置后,**1 片区域 (16x16 个方块) 得到保护**
- 会自动放置一个玩家头像在上方,**所有者清晰可见**
- 粒子显示区域边界,因此您**可以立即看到受保护区域**
#### 👥 **3. 与朋友分享 (可选)**

**右键单击**保护方块以显示直观的菜单:
- **[添加成员]** 点击 → 自动填充 `/trust playername`
- **[移除成员]** 点击 → 自动填充 `/untrust playername`
- **[成员列表]** 点击 → 显示受信任的玩家列表
### 📱 **像智能手机一样简单**
| 动作 | 方法 | 结果 |
|--------|--------|--------|
| 🏠 **土地保护** | 放置方块 | 即时 1 片区域保护 |
| 👥 **添加朋友** | 右键单击→菜单 | 2 次点击完成 |
| 🔓 **移除保护** | 破坏方块或 `/unprotect` | 方块返回 & 保护移除 |
| 👁️ **检查所有者** | 进入区域 | 在动作条上显示 |
### 💎 **命令列表 (无需记住!)**
虽然您不需要记住命令,但这些命令是可用的:
| 命令 | 描述 | 何时使用 |
|---------|-------------|-------------|
| `/unprotect` | 移除保护 & 返回方块 | 在远处移除时 |
| `/trust Steve` | 将 Steve 添加为受信任的玩家 | 当菜单不方便时 |
| `/untrust Steve` | 从受信任列表移除 Steve | 当菜单不方便时 |
| `/trustlist` | 显示受信任的玩家列表 | 当您忘记了您添加了谁时 |
### 🎮 **实际使用案例**
```
🎯 案例 1: 单独建造
1. 在您想建造的位置放置保护方块
2. 完成! 可以自由建造
🤝 案例 2: 与朋友一起建造
1. 放置保护方块
2. 右键单击该方块
3. 单击 [添加成员]
4. 输入朋友的姓名并按 Enter 键
5. 完成! 朋友也可以建造
🔄 案例 3: 移动到新位置
1. 破坏旧的保护方块 (自动收集)
2. 在新位置放置
3. 完成!
```
### 🛠️ **管理命令**
为服务器管理员提供的高级命令:
| 命令 | 描述 | 示例 |
|---------|-------------|---------|
| `/giveprotectionblock
[amount]` | 向玩家提供保护方块 | `/giveprotectionblock Steve vip 1` |
| `/giveprotectionblock ` | 提供默认的保护方块 | `/giveprotectionblock Steve` |
**管理命令特性:**
- 🎯 **选择器支持** - Minecraft 选择器,例如 `@p`、`@a`、`@r` 可以使用
- 🎁 **多种方块类型分发** - 可以指定配置的类型,例如默认、VIP
**权限设置:**
- `onechunkguard.admin` - 管理命令使用权限
- `onechunkguard.give` - 保护方块分发命令权限
## ⚙️ 配置
在 `plugins/OneChunkGuard/config.yml` 中自定义设置:
```yaml
# 保护方块设置
protection-block:
material: END_STONE # 保护方块材质
display-name: "&6&lProtection Block"
lore:
- "&7Place this block to"
- "&7protect a chunk"
- "&cOne chunk per person!"
# 保护设置
protection:
min-y: -64 # 最小保护高度
max-y: 320 # 最大保护高度
max-trusted-players: 5 # 最大受信任玩家数
# 消息 (可定制)
messages:
protection-created: "&aProtection activated!"
# ... 其他消息
```
## 🐛 错误报告 & 功能请求
如果您发现错误或有任何功能请求,请在 [GitHub Issues](https://github.com/Kamesuta/OneChunkGuard/issues) 中告知我们。
## 📊 统计数据
此插件使用 [bStats](https://bstats.org/plugin/bukkit/OneChunkGuard/26619) 收集匿名使用统计数据。
统计数据是匿名的,并有助于改进插件。
如果您想禁用统计信息收集,可以在 `plugins/bStats/config.yml` 中执行此操作。