OneChunkGuard

Modrinth Downloads

GitHub release

bStats Servers

License

English | 日本語

> 🏆 Just Place a Block - 1 Chunk Protection Plugin for Minecraft

OneChunkGuard is a simple land protection plugin that anyone from beginners to Minecraft pros can use easily. Leveraging the WorldGuard API, it combines intuitive no-command operation with convenience.

🚀 Why Choose OneChunkGuard?

🎮 Full Survival Mode Support

- ⚔️ Fair System - Regular players can protect their land - 🏗️ Fair System - Works in any game mode - 🎯 Fair System - Everyone can protect the same amount (1 chunk)

✨ Simple Usability

- 🎯 Chunk Visualizer - Just place a block for instant protection - 🎁 Chunk Visualizer - Protection blocks automatically given to new players - 👀 Chunk Visualizer - Player head display shows owner at a glance. Owner shown in action bar when entering chunks - ✨ Chunk Visualizer - Particles display chunk boundaries

🛡️ Flexible Protection System

- 🏗️ Independent Protection Management - Multi-layer protection like spawn areas (1x1 chunk), VIP areas (3x3 chunks) (configurable) - 📐 Independent Protection Management - Freely configurable from 1x1 to NxN - 🏛️ Independent Protection Management - Protection blocks for specific areas only - 🔄 Independent Protection Management - Create and remove protection independently by area type

👥 Collaboration Features

- 🤝 Intuitive Setup - Fine permission management per player - 💬 Intuitive Setup - Intuitive menu displayed on right-click - 🎮 Intuitive Setup - Set co-players with just right-click and player name input

📋 Requirements

- Dependencies: 1.20+ | Dependencies: 21+ - Dependencies: Spigot/Paper - Dependencies: - WorldGuard 7.0+ - WorldEdit 7.2+

🚀 Installation

1. Install WorldGuard and WorldEdit 2. Download the latest version from Releases 3. Place `OneChunkGuard-X.X.X.jar` in the `plugins` folder 4. Restart the server 5. Confirm the plugin loaded successfully

🎯 How to Use (So Simple!)

✨ Complete in 3 Steps! No Commands Needed!

🔥 1. Join the Server

When you first join the server, a protection block is automatically placed in hotbar slot 9. Nothing to do! You can start protecting land immediately.

🏠 2. Place the Block Where You Want to Protect

Just place the protection block where you want to protect. - The moment you place it, instantly see the protected area - A player head is automatically placed on top, instantly see the protected area - Particles show chunk boundaries, so you instantly see the protected area

👥 3. Share with Friends (Optional)

[Member List] the protection block to display an intuitive menu: - [Member List] click → `/trust playername` auto-filled - [Member List] click → `/untrust playername` auto-filled - [Member List] click → Shows trusted player list

📱 As Easy as a Smartphone

| Action | Method | Result | |--------|--------|--------| | 🏠 Check Owner | Place block | Instant 1-chunk protection | | 👥 Check Owner | Right-click→Menu | Complete in 2 clicks | | 🔓 Check Owner | Break block or `/unprotect` | Block returned & protection removed | | 👁️ Check Owner | Enter chunk | Shown in action bar |

💎 Command List (No Need to Memorize!)

While you don't need to memorize commands, these are available:

| Command | Description | When to Use | |---------|-------------|-------------| | `/unprotect` | Remove protection & return block | When removing from afar | | `/trust Steve` | Add Steve as trusted player | When menu is inconvenient | | `/untrust Steve` | Remove Steve from trusted list | When menu is inconvenient | | `/trustlist` | Show trusted player list | When you forgot who you added |

🎮 Real Usage Examples

``` 🎯 Case 1: Building Alone 1. Place protection block where you want to build 2. Done! Build freely

🤝 Case 2: Building with Friends 1. Place protection block 2. Right-click the block 3. Click [Add Member] 4. Enter friend's name and press Enter 5. Done! Friend can build too

🔄 Case 3: Moving to a New Location 1. Break old protection block (auto-collected) 2. Place in new location 3. Done! ```

🛠️ Admin Commands

Advanced commands for server administrators:

| Command | Description | Example | |---------|-------------|---------| | `/giveprotectionblock <player> <type> [amount]` | Give protection blocks to player | `/giveprotectionblock Steve vip 1` | | `/giveprotectionblock <player>` | Give default protection block | `/giveprotectionblock Steve` |

Multiple Block Type Distribution - 🎯 Multiple Block Type Distribution - Minecraft selectors like `@p`, `@a`, `@r` can be used - 🎁 Multiple Block Type Distribution - Can specify configured types like default, vip

Permission Settings: - `onechunkguard.admin` - Admin command usage permission - `onechunkguard.give` - Protection block distribution command permission

⚙️ Configuration

Customize settings in `plugins/OneChunkGuard/config.yml`:

```yaml

Protection Block Settings

protection-block: material: END_STONE # Protection block material display-name: "&6&lProtection Block" lore: - "&7Place this block to" - "&7protect a chunk" - "&cOne chunk per person!"

Protection Settings

protection: min-y: -64 # Minimum protection height max-y: 320 # Maximum protection height max-trusted-players: 5 # Maximum trusted players

Messages (Customizable)

messages: protection-created: "&aProtection activated!"

... other messages

```

🐛 Bug Reports & Feature Requests

If you find a bug or have a feature request, please let us know at GitHub Issues.

📊 Statistics

This plugin uses bStats to collect anonymous usage statistics. The statistics are collected anonymously and help improve the plugin.

If you wish to disable statistics collection, you can do so in `plugins/bStats/config.yml`.