📘 UltimateLandClaim - Complete Documentation

🎯 Executive Summary

**UltimateLandClaim** is a sophisticated, dual-mode land protection plugin for Minecraft Paper/Spigot servers running version 1.21.1+. It uniquely combines the best features of popular claiming systems (Towny, Factions, GriefPrevention) into a single, mode-switchable plugin with universal data storage.

---

🌟 Overview

What is UltimateLandClaim?

UltimateLandClaim is the **only land claiming plugin** that lets server administrators switch between two fundamentally different claiming systems without losing any data:

- **CHUNK Mode** - Grid-based claiming (like Towny/Factions)
- **FREE Mode** - Freeform selection (like GriefPrevention)

Why Choose UltimateLandClaim?

| Feature | UltimateLandClaim | Other Plugins |
|---------|-------------------|---------------|
| **Dual Modes** | ✅ CHUNK + FREE | ❌ Single mode only |
| **Mode Switching** | ✅ Without data loss | ❌ Requires migration |
| **Modern API** | ✅ Paper 1.21.1 | ⚠️ Often outdated |
| **Adventure API** | ✅ Beautiful messages | ❌ Legacy chat |
| **WorldGuard Integration** | ✅ Built-in | ⚠️ Limited or none |
| **Performance** | ✅ Optimized BoundingBox | ⚠️ Varies |
| **Trust Levels** | ✅ 4 hierarchical levels | ⚠️ 1-3 levels |

---

🔑 Key Features

🏗️ **Dual-Mode Claiming System**
- **CHUNK Mode**: Instant 16x16 chunk claiming
- **FREE Mode**: Two-click custom rectangle selection
- **Hot-Swappable**: Change modes via config reload
- **Data Preservation**: Universal BoundingBox storage

🛡️ **Advanced Protection**
- **Block Protection**: Prevent breaking/placing
- **Container Security**: Chest, furnace, hopper protection
- **Interaction Control**: Buttons, levers, doors, gates
- **PvP Management**: Toggle-able per-claim combat
- **Explosion Protection**: Creeper/TNT damage prevention
- **Mob Safety**: Optional mob damage blocking

👥 **Hierarchical Trust System**
- **ACCESS**: Use buttons, levers, doors
- **CONTAINER**: + Open chests, furnaces
- **BUILD**: + Break/place blocks
- **MANAGER**: + Trust/untrust others

💰 **Playtime-Based Economy**
- Configurable starting balance
- Automatic claim block accrual
- Per-minute earning rate
- Maximum cap to prevent hoarding
- Refund system on claim deletion

🎨 **Visual Feedback**
- **Particle Boundaries**: Hold stick to see claim borders
- **Real-time Updates**: Particles follow player movement
- **Performance Optimized**: Distance-based rendering
- **Beautiful Particles**: FLAME particles for visibility

🔧 **WorldGuard Integration**
- Prevent claiming inside protected regions
- Configurable enforcement
- Automatic overlap detection
- Compatible with WorldGuard 7.0+

📊 **Data Management**
- YAML-based storage
- Auto-save functionality
- Persistent claim data
- Player statistics tracking
- Hot-reload configuration

---

🗺️ Claim Modes Explained

📦 CHUNK Mode (Grid-Based)

**Best For**: Faction servers, town systems, organized communities

How It Works:
```
┌─────────────────┐
│ Chunk (16×16) │ ← Claim entire chunk instantly
├─────────────────┤
│ Golden Shovel │ ← Right-click once
│ Right-click │
└─────────────────┘
```

Features:
- ✅ **Instant Claiming**: Single right-click
- ✅ **Fixed Cost**: 256 claim blocks (configurable)
- ✅ **Clean Borders**: Aligns with chunk boundaries
- ✅ **Easy Expansion**: Claim adjacent chunks
- ✅ **Auto-Claim**: (Future feature) Claim while walking

Example Use:
```
Player stands at X: 100, Z: 200
Right-clicks with Golden Shovel
→ Entire chunk (96-111, 192-207) is claimed
→ Cost: 256 claim blocks
```

Configuration:
```yaml
claim-mode: CHUNK
claims:
chunk-claim-cost: 256 Adjust cost per chunk
```

---

🎯 FREE Mode (Freeform Selection)

**Best For**: Survival servers, creative plots, custom regions

How It Works:
```
First Click Second Click Result
● ● ┌──────────┐
│ Custom │
│ Area │
└──────────┘
```

Features:
- ✅ **Custom Shapes**: Any rectangular size
- ✅ **Dynamic Cost**: Area-based (width × length)
- ✅ **Precision**: Block-level accuracy
- ✅ **Min/Max Sizes**: Configurable limits
- ✅ **Two-Click Selection**: Corner-to-corner

Example Use:
```
Player clicks at X: 100, Z: 200
Player clicks at X: 120, Z: 230
→ Custom area 21×31 = 651 blocks claimed
→ Cost: 651 claim blocks
```

Configuration:
```yaml
claim-mode: FREE
claims:
min-claim-size: 25 Minimum area
max-claim-size: 10000 Maximum area
```

---

👥 Trust System

Trust Levels (Hierarchical)

Each level **includes all permissions from lower levels**:

```
┌─────────────────────────────────────┐
│ MANAGER (Level 4) │ ← Full control
│ ├─ Trust/untrust others │
│ ├─ All BUILD permissions │
│ └─ Claim management │
├─────────────────────────────────────┤
│ BUILD (Level 3) │ ← Construction
│ ├─ Break blocks │
│ ├─ Place blocks │
│ └─ All CONTAINER permissions │
├─────────────────────────────────────┤
│ CONTAINER (Level 2) │ ← Storage access
│ ├─ Open chests │
│ ├─ Use furnaces │
│ ├─ Access hoppers/barrels │
│ └─ All ACCESS permissions │
├─────────────────────────────────────┤
│ ACCESS (Level 1) │ ← Basic interaction
│ ├─ Use buttons │
│ ├─ Use levers │
│ ├─ Open doors │
│ └─ Use pressure plates │
└─────────────────────────────────────┘
```

Usage Examples:

Scenario 1: Building Team
```
/claim trust Builder1 BUILD
/claim trust Builder2 BUILD
→ They can build but can't trust others
```

Scenario 2: Storage Access
```
/claim trust ShopKeeper CONTAINER
→ Can access chests but can't break blocks
```

Scenario 3: Co-Owner
```
/claim trust Partner MANAGER
→ Full permissions including trust management
```

Scenario 4: Visitor Access
```
/claim trust Visitor ACCESS
→ Can use doors and buttons only
```

---

💰 Economy System

How Claim Blocks Work

```
┌──────────────────────────────────────┐
│ Player Claim Block Balance │
├──────────────────────────────────────┤
│ Starting Balance: 100 │
│ + Playtime Accrual: 1/minute │
│ + Admin Gifts: Variable │
│ - Claims Created: Area cost │
│ + Claims Deleted: Refund │
│ = Current Balance │
└──────────────────────────────────────┘
```

Earning Claim Blocks

**1. Playtime Accrual**
```yaml
economy:
claim-blocks-per-minute: 1 Earn rate
```
- Automatic every minute
- Only for online players
- Caps at maximum limit

**2. Starting Balance**
```yaml
economy:
starting-claim-blocks: 100 New player amount
```
- Given on first join
- Configurable per server type

**3. Future Features** (Not yet implemented)
- Vote rewards
- Purchase with money
- Admin commands to give/take

Spending Claim Blocks

**CHUNK Mode Costs**
```
Cost per chunk = 256 blocks (configurable)

Example:
- Player has 1000 claim blocks
- Claims 3 chunks (3 × 256 = 768)
- Remaining: 1000 - 768 = 232 blocks
```

**FREE Mode Costs**
```
Cost = Width × Length

Example:
- Player selects 20×30 area
- Cost = 20 × 30 = 600 blocks
- Remaining: 1000 - 600 = 400 blocks
```

Refund System

```
When deleting a claim:
→ 100% refund of claim blocks
→ Added back to player balance
→ Capped at maximum limit
```

Balance Display

```
/claim list output:

━━━━━ Claim Blocks ━━━━━
Total: 1000
Used: 768
Available: 232
```

---

📝 Commands Reference

🏗️ Claiming Commands

| Command | Description | Mode | Permission |
|---------|-------------|------|------------|
| `/claim` | Show claiming instructions | Both | `ultimatelandclaim.claim` |
| `/claim auto` | Toggle auto-claim (walk to claim) | CHUNK | `ultimatelandclaim.claim` |
| `/claim delete` | Delete current claim | Both | `ultimatelandclaim.claim` |

👥 Trust Commands

| Command | Description | Example |
|---------|-------------|---------|
| `/claim trust <player> <level>` | Grant trust | `/claim trust Steve BUILD` |
| `/claim untrust <player>` | Remove trust | `/claim untrust Steve` |

**Trust Levels**: `ACCESS`, `CONTAINER`, `BUILD`, `MANAGER`

📊 Information Commands

| Command | Description | Output |
|---------|-------------|--------|
| `/claim info` | Show current claim details | Owner, area, trusted players |
| `/claim list` | Show your claim blocks balance | Total, used, available |

🆘 Utility Commands

| Command | Description | Use Case |
|---------|-------------|----------|
| `/unstuck` | Teleport out of claim | Stuck in someone's claim |

⚙️ Admin Commands

| Command | Description | Permission |
|---------|-------------|------------|
| `/ultimatelandclaim` | Plugin info | `ultimatelandclaim.admin` |
| `/ultimatelandclaim reload` | Reload config | `ultimatelandclaim.admin` |

Command Aliases

```
/claim → /claims, /c
/unstuck → /escape, /claimstuck
/ultimatelandclaim → /ulc, /landclaim
```

---

🔐 Permissions

Player Permissions

| Permission | Description | Default |
|------------|-------------|---------|
| `ultimatelandclaim.claim` | Create and manage claims | `true` (all players) |
| `ultimatelandclaim.unstuck` | Use /unstuck command | `true` (all players) |

Admin Permissions

| Permission | Description | Default |
|------------|-------------|---------|
| `ultimatelandclaim.admin` | All admin commands | `op` |
| `ultimatelandclaim.reload` | Reload configuration | `op` |
| `ultimatelandclaim.bypass` | Bypass all protections | `op` |

Wildcard Permission

```yaml
ultimatelandclaim.*
- Grants all permissions
- Default: op
- Includes: claim, unstuck, admin, reload, bypass
```

Permission Hierarchy

```
ultimatelandclaim.*
├─ ultimatelandclaim.admin
│ ├─ ultimatelandclaim.reload
│ └─ ultimatelandclaim.bypass
├─ ultimatelandclaim.claim
└─ ultimatelandclaim.unstuck
```

---

⚙️ Configuration Guide

Quick Configuration Examples

**🏰 Survival Server (CHUNK Mode)**
```yaml
claim-mode: CHUNK
economy:
starting-claim-blocks: 500
claim-blocks-per-minute: 2
max-claim-blocks: 10000
claims:
chunk-claim-cost: 256
protection:
allow-pvp: false
allow-explosions: false
prevent-mob-damage: true
worldguard:
enabled: true
prevent-claiming-in-regions: true
```

**⚔️ Faction/PvP Server**
```yaml
claim-mode: CHUNK
economy:
starting-claim-blocks: 200
claim-blocks-per-minute: 1
max-claim-blocks: 5000
claims:
chunk-claim-cost: 256
protection:
allow-pvp: true PvP enabled
allow-explosions: false But no TNT raiding
prevent-mob-damage: false
```

**🎨 Creative Server (FREE Mode)**
```yaml
claim-mode: FREE
economy:
starting-claim-blocks: 10000 Generous
claim-blocks-per-minute: 0 No accrual needed
max-claim-blocks: 50000
claims:
min-claim-size: 100
max-claim-size: 50000 Large plots
protection:
allow-pvp: false
allow-explosions: false
```

**🏘️ Towny-Style Server**
```yaml
claim-mode: CHUNK
economy:
starting-claim-blocks: 100
claim-blocks-per-minute: 1
max-claim-blocks: 8000
claims:
chunk-claim-cost: 256
protection:
allow-pvp: false
allow-explosions: false
worldguard:
enabled: true
prevent-claiming-in-regions: true Protect spawn
```

Configuration Options Explained

**Claim Mode**
```yaml
claim-mode: CHUNK or FREE
```
- Changes how players claim land
- Can be switched without losing data
- Requires server reload to take effect

**Economy Settings**
```yaml
economy:
starting-claim-blocks: 100 New player balance
claim-blocks-per-minute: 1 Accrual rate (0 = disabled)
max-claim-blocks: 10000 Maximum balance
```

**Claim Limits (FREE Mode)**
```yaml
claims:
min-claim-size: 25 Minimum area (prevents 1x1 claims)
max-claim-size: 10000 Maximum area (prevents land hogging)
```

**Chunk Cost (CHUNK Mode)**
```yaml
claims:
chunk-claim-cost: 256 Cost per chunk (default = chunk size)
```

**Protection Settings**
```yaml
protection:
allow-pvp: false Allow player combat?
allow-explosions: false Allow TNT/creepers?
prevent-mob-damage: true Protect from mobs in own claim?
```

**WorldGuard Integration**
```yaml
worldguard:
enabled: true Use WorldGuard?
prevent-claiming-in-regions: true Block claims in WG regions?
```

**Visualization**
```yaml
visualization:
particle-distance: 50 How far particles render
refresh-rate-ticks: 20 Update frequency (20 = 1 second)
```

---

🔗 Integration & Compatibility

✅ Compatible Plugins

| Plugin | Version | Integration Level | Notes |
|--------|---------|-------------------|-------|
| **WorldGuard** | 7.0+ | Deep | Prevents claiming in protected regions |
| **Vault** | Any | Future | Planned economy integration |
| **LuckPerms** | 5.4+ | Full | Permission system support |
| **PlaceholderAPI** | Any | Future | Planned placeholder support |
| **Dynmap** | Any | Future | Planned claim visualization |

🛡️ WorldGuard Integration

What It Does:
- Prevents players from creating claims inside WorldGuard regions
- Protects spawn areas, arenas, admin zones
- Automatic overlap detection

Setup:
```yaml
In config.yml
worldguard:
enabled: true
prevent-claiming-in-regions: true
```

Behavior:
```
Player tries to claim in spawn region
→ ❌ "You cannot claim inside a WorldGuard region!"
→ Claim is cancelled
```

📊 Performance Impact

| Server Size | Expected Impact | Notes |
|-------------|----------------|-------|
| **Small (1-20 players)** | Negligible | < 1% TPS impact |
| **Medium (20-100 players)** | Minimal | < 2% TPS impact |
| **Large (100+ players)** | Low | < 5% TPS impact |

**Optimization Features:**
- Efficient BoundingBox calculations
- Distance-based particle rendering
- Cached claim lookups
- Asynchronous saving (future)

🔧 Server Requirements

| Requirement | Minimum | Recommended |
|-------------|---------|-------------|
| **Minecraft Version** | 1.21.1 | 1.21.1+ |
| **Server Software** | Paper | Paper/Purpur |
| **Java Version** | 21 | 21 |
| **RAM** | 2GB | 4GB+ |
| **Storage** | 10MB | 50MB+ |

---

🎮 Use Cases & Server Types

🏰 Survival Servers

**Best Mode**: CHUNK or FREE
**Configuration**:
```yaml
claim-mode: CHUNK or FREE based on preference
economy:
starting-claim-blocks: 500
claim-blocks-per-minute: 2
protection:
allow-pvp: false
allow-explosions: false
```

**Benefits**:
- Prevents griefing
- Encourages community building
- Fair playtime-based economy

---

⚔️ Faction/PvP Servers

**Best Mode**: CHUNK
**Configuration**:
```yaml
claim-mode: CHUNK
economy:
starting-claim-blocks: 200
claim-blocks-per-minute: 1
protection:
allow-pvp: true Enable PvP
allow-explosions: false Disable TNT
```

**Benefits**:
- Organized territory control
- Grid-based expansion
- Balanced warfare

---

🎨 Creative Servers

**Best Mode**: FREE
**Configuration**:
```yaml
claim-mode: FREE
economy:
starting-claim-blocks: 10000
claim-blocks-per-minute: 0
claims:
max-claim-size: 50000
```

**Benefits**:
- Custom plot sizes
- No economy pressure
- Flexible building areas

---

🏘️ Towny-Style Servers

**Best Mode**: CHUNK
**Configuration**:
```yaml
claim-mode: CHUNK
economy:
starting-claim-blocks: 100
claim-blocks-per-minute: 1
protection:
allow-pvp: false
worldguard:
prevent-claiming-in-regions: true
```

**Benefits**:
- Town expansion mechanics
- Clean chunk borders
- Protected spawn areas

---

🌍 SMP (Survival Multiplayer)

**Best Mode**: FREE
**Configuration**:
```yaml
claim-mode: FREE
economy:
starting-claim-blocks: 500
claim-blocks-per-minute: 2
claims:
min-claim-size: 100
max-claim-size: 5000
```

**Benefits**:
- Natural land boundaries
- Custom claim shapes
- Flexible community plots

---

🏗️ Technical Architecture

Core Design Principles

**1. Universal Abstraction Layer**
```
┌─────────────────────────────────────┐
│ Mode Selection (config.yml) │
│ ┌─────────┐ ┌─────────┐ │
│ │ CHUNK │ OR │ FREE │ │
│ └────┬────┘ └────┬────┘ │
│ │ │ │
│ └────────┬───────┘ │
│ ▼ │
│ ┌──────────────────────┐ │
│ │ BoundingBox Core │ │
│ │ (minX, minZ, maxX, │ │
│ │ maxZ, world) │ │
│ └──────────────────────┘ │
│ ▼ │
│ ┌──────────────────────┐ │
│ │ Universal Storage │ │
│ │ (claims.yml) │ │
│ └──────────────────────┘ │
└─────────────────────────────────────┘
```

**Why This Matters**:
- Mode switching doesn't corrupt data
- Protection logic works for both modes
- Future modes can be added easily

**2. Mode-Specific Logic**

```java
// ToolListener.java - The switching happens here
ClaimMode mode = config.getClaimMode();

switch (mode) {
case CHUNK -> {
// Instant chunk claiming
BoundingBox box = ChunkUtil.chunkToBoundingBox(chunk);
createClaim(box);
}
case FREE -> {
// Two-click selection
if (firstClick) storeCorner();
else createClaim(cornersToBoundingBox());
}
}
```

**3. Data Flow**

```
Player Action → ToolListener → ClaimManager → Storage
│ │ │ │
│ │ │ ▼
│ │ │ claims.yml
│ │ │
│ │ ▼
│ │ ProtectionListener
│ │ │
│ ▼ ▼
│ Economy Check Permission Check
│ │ │
└───────────────┴──────────────┘
│
Success!
```

Class Responsibilities

| Class | Responsibility | Key Methods |
|-------|---------------|-------------|
| **ClaimManager** | CRUD operations | `createClaim()`, `getClaimAt()`, `hasOverlap()` |
| **ToolListener** | Mode-aware claiming | `handleChunkMode()`, `handleFreeMode()` |
| **ProtectionListener** | Grief prevention | Block events, interactions, PvP |
| **TrustManager** | Permission checking | `hasTrust()`, `addTrust()` |
| **PlayerDataManager** | Economy system | `addClaimBlocks()`, `removeClaimBlocks()` |

Performance Optimizations

**1. BoundingBox Calculations**
```java
// O(1) containment check
public boolean contains(int x, int z) {
return x >= minX && x <= maxX && z >= minZ && z <= maxZ;
}

// O(1) overlap detection
public boolean overlaps(BoundingBox other) {
return !(this.maxX < other.minX || ...);
}
```

**2. Caching Strategy**
```java
// Claims stored in HashMap for O(1) lookup
Map<UUID, Claim> claims = new HashMap<>();

// Quick location lookup
public Claim getClaimAt(Location loc) {
return claims.values().stream()
.filter(c -> c.contains(loc))
.findFirst().orElse(null);
}
```

**3. Particle Rendering**
```java
// Distance-based culling
if (player.distance(particle) > maxDistance) {
return; // Don't render far particles
}

// Refresh rate throttling (default 20 ticks = 1 second)
task.runTaskTimer(plugin, 0L, refreshRate);
```

---

🚀 Installation & Setup

Step 1: Download

**Download Release**
```
Download UltimateLandClaim-1.0.0.jar
```

Step 2: Install Plugin

```bash
Copy JAR to plugins folder
cp UltimateLandClaim-1.0.0.jar /path/to/server/plugins/

Start server (generates config)
java -jar paper-1.21.1.jar
```

Step 3: Configure

```yaml
Edit plugins/UltimateLandClaim/config.yml
claim-mode: CHUNK Choose your mode

economy:
starting-claim-blocks: 100
claim-blocks-per-minute: 1

protection:
allow-pvp: false
allow-explosions: false
```

Step 4: Reload

```
/ultimatelandclaim reload
```

Step 5: Test

```
1. Give yourself a Golden Shovel: /give @s golden_shovel
2. Right-click to claim (behavior depends on mode)
3. Hold stick to see boundaries
4. Test protection by trying to break blocks
```

Optional: WorldGuard Integration

```bash
Download WorldGuard
https://dev.bukkit.org/projects/worldguard

Install to plugins/
cp WorldGuard.jar /path/to/server/plugins/

Enable in config
worldguard:
enabled: true
```

---

❓ FAQ

General Questions

**Q: Can I switch between CHUNK and FREE mode?**
A: Yes! Change `claim-mode` in config.yml and reload. All claims remain intact.

**Q: Will switching modes delete my claims?**
A: No. Claims are stored as universal bounding boxes.

**Q: What's the difference between CHUNK and FREE mode?**
A: CHUNK = Grid-based (16x16), instant. FREE = Custom shapes, two-click.

**Q: Can players use both modes?**
A: No, the server runs in one mode at a time. Admins choose.

Economy Questions

**Q: How do players earn claim blocks?**
A: Automatically, 1 block per minute online (configurable).

**Q: Can I disable automatic earning?**
A: Yes, set `claim-blocks-per-minute: 0`.

**Q: What happens when I delete a claim?**
A: You get 100% refund of claim blocks.

**Q: Is there a maximum balance?**
A: Yes, configurable in `max-claim-blocks` (default: 10000).

Trust Questions

**Q: What's the difference between trust levels?**
A: ACCESS < CONTAINER < BUILD < MANAGER (hierarchical).

**Q: Can trusted players trust others?**
A: Only MANAGER level can trust/untrust.

**Q: How do I remove all trust?**
A: Use `/claim untrust <player>` for each player.

**Q: Do trust levels carry between claims?**
A: No, trust is per-claim.

Protection Questions

**Q: Can I enable PvP in claims?**
A: Yes, set `allow-pvp: true` in config.

**Q: Do explosions damage claims?**
A: Only if `allow-explosions: true` (default: false).

**Q: Can mobs hurt me in my claim?**
A: Not if `prevent-mob-damage: true` (default: true).

**Q: Can admins bypass protection?**
A: Yes, with `ultimatelandclaim.bypass` permission.

Technical Questions

**Q: What Minecraft version is supported?**
A: 1.21.1+ (Paper/Spigot).

**Q: Is Bukkit supported?**
A: Paper is recommended, Spigot may work but untested.

**Q: Does it work with Forge/Fabric mods?**
A: No, this is a Bukkit/Paper plugin.

**Q: What's the performance impact?**
A: Minimal (~1-2% TPS on medium servers).

**Q: How is data stored?**
A: YAML files (claims.yml, playerdata.yml).

**Q: Can I use MySQL/MongoDB?**
A: Not in v1.0, planned for future.

WorldGuard Questions

**Q: Is WorldGuard required?**
A: No, it's optional integration.

**Q: What does WorldGuard integration do?**
A: Prevents claiming inside WG regions.

**Q: Can I disable WorldGuard integration?**
A: Yes, set `worldguard.enabled: false`.

**Q: Does it work with WorldGuard flags?**
A: No, only region overlap detection.

---

🐛 Troubleshooting

Common Issues

**Issue: "Could not load plugin"**
**Symptoms**: Plugin doesn't load on startup
**Solutions**:
1. Check Java version: `java -version` (must be 21+)
2. Verify Paper version: 1.21.1+
3. Check console for errors

---

**Issue: "Claims not saving"**
**Symptoms**: Claims disappear on restart
**Solutions**:
1. Check file permissions on `plugins/UltimateLandClaim/`
2. Verify disk space
3. Check console for save errors
4. Run `/ultimatelandclaim reload` to force save

---

**Issue: "Particles not showing"**
**Symptoms**: No boundary visualization with stick
**Solutions**:
1. Verify you're holding a stick
2. Stand inside a claim
3. Check `particle-distance` in config
4. Ensure client particles are enabled

---

**Issue: "WorldGuard not detected"**
**Symptoms**: Warning about WorldGuard
**Solutions**:
1. Install WorldGuard 7.0+
2. Set `worldguard.enabled: false` if not using
3. Check plugin load order

---

**Issue: "Can't claim anything"**
**Symptoms**: Right-click with shovel does nothing
**Solutions**:
1. Check permission: `ultimatelandclaim.claim`
2. Verify mode in config: `/ultimatelandclaim`
3. Check claim blocks: `/claim list`
4. Look for overlap with existing claims

---

Debug Mode

Enable detailed logging:
```yaml
advanced:
debug: true
```

Then check `logs/latest.log` for detailed information.

---

Reporting Bugs

Include:
1. Server version (`/version`)
2. Plugin version (`/ultimatelandclaim`)
3. Full error from console
4. Steps to reproduce
5. Config.yml contents

```

🎉 Conclusion

**UltimateLandClaim** represents the next generation of land protection plugins, combining flexibility, performance, and ease of use. Whether you're running a small survival server or a large faction network, ULC adapts to your needs.

Quick Summary:
✅ **Dual Modes** - CHUNK or FREE
✅ **Safe Switching** - Change modes without data loss
✅ **Modern Codebase** - Paper 1.21.1, Java 21
✅ **Trust System** - 4 hierarchical levels
✅ **Economy** - Playtime-based claim blocks
✅ **Protection** - Comprehensive grief prevention
✅ **Integration** - WorldGuard compatible
✅ **Performance** - Optimized BoundingBox system

---

**Ready to protect your world?** 🛡️
**Install UltimateLandClaim today!** 🚀

---

*Documentation Version: 1.0.0*
*Last Updated: 2024*
Plugin Version: 1.0.0

Need a server to run UltimateLandClaim?
Get 24/7 high-performance hosting from reliable hosting for your community!
Click here to get started with KCB Hosting