UltimateLandClaim
SpigotMCModrinthAll in one land claim plugin with 2 modes chunk claim and free claim (golden shovel)........
# 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:
<br> ┌─────────────────┐<br> │ Chunk (16×16) │ ← Claim entire chunk instantly<br> ├─────────────────┤<br> │ Golden Shovel │ ← Right-click once<br> │ Right-click │<br> └─────────────────┘<br>
#### 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:
<br> Player stands at X: 100, Z: 200<br> Right-clicks with Golden Shovel<br> → Entire chunk (96-111, 192-207) is claimed<br> → Cost: 256 claim blocks<br>
#### Configuration:
yaml<br> claim-mode: CHUNK<br> claims:<br> chunk-claim-cost: 256 # Adjust cost per chunk<br>
---
### FREE Mode (Freeform Selection)
Best For: Survival servers, creative plots, custom regions
#### How It Works:
<br> First Click Second Click Result<br> ● ● ┌──────────┐<br> │ Custom │<br> │ Area │<br> └──────────┘<br>
#### 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:
<br> Player clicks at X: 100, Z: 200<br> Player clicks at X: 120, Z: 230<br> → Custom area 21×31 = 651 blocks claimed<br> → Cost: 651 claim blocks<br>
#### Configuration:
yaml<br> claim-mode: FREE<br> claims:<br> min-claim-size: 25 # Minimum area<br> max-claim-size: 10000 # Maximum area<br>
---
## Trust System
### Trust Levels (Hierarchical)
Each level includes all permissions from lower levels:
<br> ┌─────────────────────────────────────┐<br> │ MANAGER (Level 4) │ ← Full control<br> │ ├─ Trust/untrust others │<br> │ ├─ All BUILD permissions │<br> │ └─ Claim management │<br> ├─────────────────────────────────────┤<br> │ BUILD (Level 3) │ ← Construction<br> │ ├─ Break blocks │<br> │ ├─ Place blocks │<br> │ └─ All CONTAINER permissions │<br> ├─────────────────────────────────────┤<br> │ CONTAINER (Level 2) │ ← Storage access<br> │ ├─ Open chests │<br> │ ├─ Use furnaces │<br> │ ├─ Access hoppers/barrels │<br> │ └─ All ACCESS permissions │<br> ├─────────────────────────────────────┤<br> │ ACCESS (Level 1) │ ← Basic interaction<br> │ ├─ Use buttons │<br> │ ├─ Use levers │<br> │ ├─ Open doors │<br> │ └─ Use pressure plates │<br> └─────────────────────────────────────┘<br>
### Usage Examples:
#### Scenario 1: Building Team
<br> /claim trust Builder1 BUILD<br> /claim trust Builder2 BUILD<br> → They can build but can't trust others<br>
#### Scenario 2: Storage Access
<br> /claim trust ShopKeeper CONTAINER<br> → Can access chests but can't break blocks<br>
#### Scenario 3: Co-Owner
<br> /claim trust Partner MANAGER<br> → Full permissions including trust management<br>
#### Scenario 4: Visitor Access
<br> /claim trust Visitor ACCESS<br> → Can use doors and buttons only<br>
---
## Economy System
### How Claim Blocks Work
<br> ┌──────────────────────────────────────┐<br> │ Player Claim Block Balance │<br> ├──────────────────────────────────────┤<br> │ Starting Balance: 100 │<br> │ + Playtime Accrual: 1/minute │<br> │ + Admin Gifts: Variable │<br> │ - Claims Created: Area cost │<br> │ + Claims Deleted: Refund │<br> │ = Current Balance │<br> └──────────────────────────────────────┘<br>
### Earning Claim Blocks
#### 1. Playtime Accrual
yaml<br> economy:<br> claim-blocks-per-minute: 1 # Earn rate<br>
- Automatic every minute
- Only for online players
- Caps at maximum limit
#### 2. Starting Balance
yaml<br> economy:<br> starting-claim-blocks: 100 # New player amount<br>
- 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
<br> Cost per chunk = 256 blocks (configurable)<br> <br> Example:<br> - Player has 1000 claim blocks<br> - Claims 3 chunks (3 × 256 = 768)<br> - Remaining: 1000 - 768 = 232 blocks<br>
#### FREE Mode Costs
<br> Cost = Width × Length<br> <br> Example:<br> - Player selects 20×30 area<br> - Cost = 20 × 30 = 600 blocks<br> - Remaining: 1000 - 600 = 400 blocks<br>
### Refund System
<br> When deleting a claim:<br> → 100% refund of claim blocks<br> → Added back to player balance<br> → Capped at maximum limit<br>
### Balance Display
<br> /claim list output:<br> <br> ━━━━━ Claim Blocks ━━━━━<br> Total: 1000<br> Used: 768<br> Available: 232<br>
---
## 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
<br> /claim → /claims, /c<br> /unstuck → /escape, /claimstuck<br> /ultimatelandclaim → /ulc, /landclaim<br>
---
## 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<br> ultimatelandclaim.*<br> - Grants all permissions<br> - Default: op<br> - Includes: claim, unstuck, admin, reload, bypass<br>
### Permission Hierarchy
<br> ultimatelandclaim.*<br> ├─ ultimatelandclaim.admin<br> │ ├─ ultimatelandclaim.reload<br> │ └─ ultimatelandclaim.bypass<br> ├─ ultimatelandclaim.claim<br> └─ ultimatelandclaim.unstuck<br>
---
## ⚙️ Configuration Guide
### Quick Configuration Examples
#### ** Survival Server (CHUNK Mode)
yaml<br> claim-mode: CHUNK<br> economy:<br> starting-claim-blocks: 500<br> claim-blocks-per-minute: 2<br> max-claim-blocks: 10000<br> claims:<br> chunk-claim-cost: 256<br> protection:<br> allow-pvp: false<br> allow-explosions: false<br> prevent-mob-damage: true<br> worldguard:<br> enabled: true<br> prevent-claiming-in-regions: true<br>
#### ⚔️ Faction/PvP Server
yaml<br> claim-mode: CHUNK<br> economy:<br> starting-claim-blocks: 200<br> claim-blocks-per-minute: 1<br> max-claim-blocks: 5000<br> claims:<br> chunk-claim-cost: 256<br> protection:<br> allow-pvp: true # PvP enabled<br> allow-explosions: false # But no TNT raiding<br> prevent-mob-damage: false<br>
#### ** Creative Server (FREE Mode)
yaml<br> claim-mode: FREE<br> economy:<br> starting-claim-blocks: 10000 # Generous<br> claim-blocks-per-minute: 0 # No accrual needed<br> max-claim-blocks: 50000<br> claims:<br> min-claim-size: 100<br> max-claim-size: 50000 # Large plots<br> protection:<br> allow-pvp: false<br> allow-explosions: false<br>
#### ️ Towny-Style Server
yaml<br> claim-mode: CHUNK<br> economy:<br> starting-claim-blocks: 100<br> claim-blocks-per-minute: 1<br> max-claim-blocks: 8000<br> claims:<br> chunk-claim-cost: 256<br> protection:<br> allow-pvp: false<br> allow-explosions: false<br> worldguard:<br> enabled: true<br> prevent-claiming-in-regions: true # Protect spawn<br>
### Configuration Options Explained
#### Claim Mode
yaml<br> claim-mode: CHUNK # or FREE<br>
- Changes how players claim land
- Can be switched without losing data
- Requires server reload to take effect
#### Economy Settings
yaml<br> economy:<br> starting-claim-blocks: 100 # New player balance<br> claim-blocks-per-minute: 1 # Accrual rate (0 = disabled)<br> max-claim-blocks: 10000 # Maximum balance<br>
#### Claim Limits (FREE Mode)
yaml<br> claims:<br> min-claim-size: 25 # Minimum area (prevents 1x1 claims)<br> max-claim-size: 10000 # Maximum area (prevents land hogging)<br>
#### Chunk Cost (CHUNK Mode)
yaml<br> claims:<br> chunk-claim-cost: 256 # Cost per chunk (default = chunk size)<br>
#### Protection Settings
yaml<br> protection:<br> allow-pvp: false # Allow player combat?<br> allow-explosions: false # Allow TNT/creepers?<br> prevent-mob-damage: true # Protect from mobs in own claim?<br>
#### WorldGuard Integration
yaml<br> worldguard:<br> enabled: true # Use WorldGuard?<br> prevent-claiming-in-regions: true # Block claims in WG regions?<br>
#### Visualization
yaml<br> visualization:<br> particle-distance: 50 # How far particles render<br> refresh-rate-ticks: 20 # Update frequency (20 = 1 second)<br>
---
## 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<br> # In config.yml<br> worldguard:<br> enabled: true<br> prevent-claiming-in-regions: true<br>
#### Behavior:
<br> Player tries to claim in spawn region<br> → ❌ "You cannot claim inside a WorldGuard region!"<br> → Claim is cancelled<br>
### 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<br> claim-mode: CHUNK # or FREE based on preference<br> economy:<br> starting-claim-blocks: 500<br> claim-blocks-per-minute: 2<br> protection:<br> allow-pvp: false<br> allow-explosions: false<br>
Benefits:
- Prevents griefing
- Encourages community building
- Fair playtime-based economy
---
### ⚔️ Faction/PvP Servers
Best Mode: CHUNK
Configuration:
yaml<br> claim-mode: CHUNK<br> economy:<br> starting-claim-blocks: 200<br> claim-blocks-per-minute: 1<br> protection:<br> allow-pvp: true # Enable PvP<br> allow-explosions: false # Disable TNT<br>
Benefits:
- Organized territory control
- Grid-based expansion
- Balanced warfare
---
### Creative Servers
Best Mode: FREE
Configuration:
yaml<br> claim-mode: FREE<br> economy:<br> starting-claim-blocks: 10000<br> claim-blocks-per-minute: 0<br> claims:<br> max-claim-size: 50000<br>
Benefits:
- Custom plot sizes
- No economy pressure
- Flexible building areas
---
### ️ Towny-Style Servers
Best Mode: CHUNK
Configuration:
yaml<br> claim-mode: CHUNK<br> economy:<br> starting-claim-blocks: 100<br> claim-blocks-per-minute: 1<br> protection:<br> allow-pvp: false<br> worldguard:<br> prevent-claiming-in-regions: true<br>
Benefits:
- Town expansion mechanics
- Clean chunk borders
- Protected spawn areas
---
### SMP (Survival Multiplayer)
Best Mode: FREE
Configuration:
yaml<br> claim-mode: FREE<br> economy:<br> starting-claim-blocks: 500<br> claim-blocks-per-minute: 2<br> claims:<br> min-claim-size: 100<br> max-claim-size: 5000<br>
Benefits:
- Natural land boundaries
- Custom claim shapes
- Flexible community plots
---
## ️ Technical Architecture
### Core Design Principles
#### 1. Universal Abstraction Layer
<br> ┌─────────────────────────────────────┐<br> │ Mode Selection (config.yml) │<br> │ ┌─────────┐ ┌─────────┐ │<br> │ │ CHUNK │ OR │ FREE │ │<br> │ └────┬────┘ └────┬────┘ │<br> │ │ │ │<br> │ └────────┬───────┘ │<br> │ ▼ │<br> │ ┌──────────────────────┐ │<br> │ │ BoundingBox Core │ │<br> │ │ (minX, minZ, maxX, │ │<br> │ │ maxZ, world) │ │<br> │ └──────────────────────┘ │<br> │ ▼ │<br> │ ┌──────────────────────┐ │<br> │ │ Universal Storage │ │<br> │ │ (claims.yml) │ │<br> │ └──────────────────────┘ │<br> └─────────────────────────────────────┘<br>
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<br> // ToolListener.java - The switching happens here<br> ClaimMode mode = config.getClaimMode();<br> <br> switch (mode) {<br> case CHUNK -> {<br> // Instant chunk claiming<br> BoundingBox box = ChunkUtil.chunkToBoundingBox(chunk);<br> createClaim(box);<br> }<br> case FREE -> {<br> // Two-click selection<br> if (firstClick) storeCorner();<br> else createClaim(cornersToBoundingBox());<br> }<br> }<br>
#### 3. Data Flow
<br> Player Action → ToolListener → ClaimManager → Storage<br> │ │ │ │<br> │ │ │ ▼<br> │ │ │ claims.yml<br> │ │ │<br> │ │ ▼<br> │ │ ProtectionListener<br> │ │ │<br> │ ▼ ▼<br> │ Economy Check Permission Check<br> │ │ │<br> └───────────────┴──────────────┘<br> │<br> Success!<br>
### 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<br> // O(1) containment check<br> public boolean contains(int x, int z) {<br> return x >= minX && x <= maxX && z >= minZ && z <= maxZ;<br> }<br> <br> // O(1) overlap detection<br> public boolean overlaps(BoundingBox other) {<br> return !(this.maxX < other.minX || ...);<br> }<br>
#### 2. Caching Strategy
java<br> // Claims stored in HashMap for O(1) lookup<br> Map<UUID, Claim> claims = new HashMap<>();<br> <br> // Quick location lookup<br> public Claim getClaimAt(Location loc) {<br> return claims.values().stream()<br> .filter(c -> c.contains(loc))<br> .findFirst().orElse(null);<br> }<br>
#### 3. Particle Rendering
java<br> // Distance-based culling<br> if (player.distance(particle) > maxDistance) {<br> return; // Don't render far particles<br> }<br> <br> // Refresh rate throttling (default 20 ticks = 1 second)<br> task.runTaskTimer(plugin, 0L, refreshRate);<br>
---
## Installation & Setup
### Step 1: Download
Option A: Build from Source
bash<br> git clone <a href="https://github.com/yourusername/UltimateLandClaim.git" target="_blank" class="externalLink" rel="nofollow">https://github.com/yourusername/UltimateLandClaim.git</a><br> cd UltimateLandClaim<br> mvn clean package<br>
Option B: Download Release
<br> Download UltimateLandClaim-1.0.0.jar from releases<br>
### Step 2: Install Plugin
bash<br> # Copy JAR to plugins folder<br> cp UltimateLandClaim-1.0.0.jar /path/to/server/plugins/<br> <br> # Start server (generates config)<br> java -jar paper-1.21.1.jar<br>
### Step 3: Configure
yaml<br> # Edit plugins/UltimateLandClaim/config.yml<br> claim-mode: CHUNK # Choose your mode<br> <br> economy:<br> starting-claim-blocks: 100<br> claim-blocks-per-minute: 1<br> <br> protection:<br> allow-pvp: false<br> allow-explosions: false<br>
### Step 4: Reload
<br> /ultimatelandclaim reload<br>
### Step 5: Test
<br> 1. Give yourself a Golden Shovel: /give @s golden_shovel<br> 2. Right-click to claim (behavior depends on mode)<br> 3. Hold stick to see boundaries<br> 4. Test protection by trying to break blocks<br>
### Optional: WorldGuard Integration
bash<br> # Download WorldGuard<br> <a href="https://dev.bukkit.org/projects/worldguard" target="_blank" class="externalLink" rel="nofollow">https://dev.bukkit.org/projects/worldguard</a><br> <br> # Install to plugins/<br> cp WorldGuard.jar /path/to/server/plugins/<br> <br> # Enable in config<br> worldguard:<br> enabled: true<br>
---
## ❓ 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<br> advanced:<br> debug: true<br>
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
Kommentare 0
Noch keine Kommentare. Sei der Erste, der seine Meinung teilt.