CamboProtection (Land Claim)

CamboProtection - Land Claim Plugin

A powerful and customizable land claim protection plugin for Paper Minecraft servers (API 1.21+). Create, manage, and protect your land with customizable protection levels, member management, and advanced protection settings.

Requirements

Server Requirements

- Java Version: 1.21.7+ - Java Version: 21+

Dependencies

- Floodgate (Required): For economy integration and permission handling - Floodgate (Optional): For placeholder support in other plugins - Floodgate (Optional): For Bedrock player support with custom forms

Overview

CamboProtection is a beacon-based land claim plugin that allows players to protect their territories with expandable protection zones. The plugin features multi-level protections, economy integration, PlaceholderAPI support, and advanced permission systems.

Features

Core Protection System

- Auto-Expiration: Create protections by placing special beacon blocks - Auto-Expiration: Expand your protection from 31x31 to 181x181 blocks - Auto-Expiration: Define your own custom protection levels with any cost and size - Auto-Expiration: Enable protection in specific worlds via configuration - Auto-Expiration: Automatically remove inactive protections (configurable days)

Member & Access Management

- Owner-Only Control: Add up to 6 trusted players per protection (configurable) - Owner-Only Control: Prevent specific players from entering your protection - Owner-Only Control: Only the protection owner can manage settings

Advanced Protection Settings

10 customizable toggleable options for each protection: - Redstone: Enable/disable PVP combat in protected areas - Redstone: Prevent fire from spreading in protections - Redstone: Allow/block natural mob spawning - Redstone: Control whether explosions can damage blocks - Redstone: Prevent mobs (endermen, creepers) from destroying blocks - Redstone: Restrict non-member block placement - Redstone: Restrict non-member block breaking - Redstone: Allow/block natural plant growth - Redstone: Control access to doors, containers, redstone blocks - Redstone: Enable/disable redstone device functionality

Economy Integration

- Free Starter Level: Integrate with any economy plugin supporting Vault - Free Starter Level: Cost-based protection level upgrades - Free Starter Level: Get partial refunds when downgrading (configurable percentage) - Free Starter Level: First protection is free at level 1

Quality of Life Features

- Floodgate Support: Visual indicators showing protection boundaries - Floodgate Support: Configure particle view distance and update interval - Floodgate Support: Set custom respawn points within your protection - Floodgate Support: Respawn at your protection spawn on death (toggleable) - Floodgate Support: Automatically give new players a protection block - Floodgate Support: Bedrock form menus for Bedrock players (if Floodgate installed)

Admin Commands & Tools

- Force Expiration: Reload all settings without restarting - Force Expiration: Admin tools to manage, remove, and view protections - Force Expiration: Check expiration and config status - Force Expiration: Teleport to protection spawn locations - Force Expiration: Manually expire inactive protections

Installation

1. Download the plugin JAR file 2. Place it in your `plugins/` directory 3. Restart your server or use `/reload confirm` 4. Configure the plugin in `plugins/CamboProtection/config.yml` 5. Reload with `/cp admin reload`

Commands

Player Commands

Main Menu

- `/camboprotection` or `/cp` - Open main protection management menu

Protection Management

- `/cp upgrade` - Upgrade protection to next level - `/cp downgrade` - Downgrade protection and receive partial refund - `/cp remove` - Remove your protection - `/cp view on|off` - Toggle protection boundary visualization

Member Management

- `/cp trust <player>` - Add a player to your trusted members - `/cp untrust <player>` - Remove a trusted member - `/cp block <player>` - Block a player from entering your protection - `/cp unblock <player>` - Unblock a player

Spawn System

- `/cp setspawn` - Set respawn point within your protection (must be inside) - `/cp spawn` - Teleport to your protection spawn location

Admin Commands

Permission: `camboprotection.admin`

- `/cp admin give <player> <level>` - Give a player a protection block of specified level - `/cp admin reload` - Reload all configuration and data - `/cp admin remove <player>` - Remove a player's protection - `/cp admin list` - List all active protections - `/cp admin teleport <owner>` - Teleport to a player's protection spawn - `/cp admin view <player>` - View detailed information about a protection - `/cp admin forceexpire <player>` - Force expire a protection immediately - `/cp admin debug expiration` - Display expiration system debug information - `/cp admin debug config` - Display configuration version and status information

Permissions

- `camboprotection.use` (default: true) - Use CamboProtection features - `camboprotection.admin` (default: op) - Access admin commands and management features - `camboprotection.bypass` (default: op) - Bypass protection restrictions

Configuration

Default Configuration Location

`plugins/CamboProtection/config.yml`

Configuration Sections

Worlds

```yaml worlds: - world ``` Specify which worlds have protection enabled.

Protection Settings

```yaml protection: max-per-player: 1 max-trusted-players: 6 ``` - `max-per-player`: Maximum number of protections per player - `max-trusted-players`: Maximum players that can be trusted in one protection

Protection Levels

Define unlimited custom levels with cost and size: ```yaml levels: refund-percentage: 0.5 1: cost: 0 size: 31 2: cost: 10000 size: 61 ``` - `cost`: Economy currency needed to upgrade - `size`: Protection radius (size x size area) - `refund-percentage`: Percentage refunded on downgrade (0.0 - 1.0)

Expiration Settings

```yaml expiration: enabled: true days: 7 ``` Remove protections after owner is offline for specified days.

Protection Defaults

```yaml defaults: pvp: false fire: false mob-spawn: true explosion: false mob-griefing: false build: false break: false plant-growth: true interact: false redstone: false ``` Default settings applied to all new protections.

Spawn Settings

```yaml spawn: death-spawn-enabled: true ``` Enable/disable respawning at protection spawn on death.

First-Join Reward

```yaml first-join: enabled: true level: 1 ``` Give new players a protection block on their first join.

PlaceholderAPI Support

CamboProtection registers the `%camboprotection_*%` placeholder namespace. All placeholders work with PlaceholderAPI-integrated plugins and commands.

Status Placeholders

- `%camboprotection_has_protection%` - Returns "true" if player has protection - `%camboprotection_is_owner%` - Returns "true" if player owns a protection - `%camboprotection_is_member%` - Returns "true" if player is a member of a protection

Protection Details

- `%camboprotection_protection_name%` - Owner's name of the protection - `%camboprotection_protection_owner%` - Full owner name - `%camboprotection_protection_level%` - Current protection level (1-6+) - `%camboprotection_protection_size%` - Protection dimensions (e.g., "31x31") - `%camboprotection_protection_radius%` - Protection radius in blocks - `%camboprotection_protection_world%` - World where protection exists - `%camboprotection_protection_x%` - Center X coordinate - `%camboprotection_protection_z%` - Center Z coordinate - `%camboprotection_protection_created%` - Creation date (format: yyyy-MM-dd HH:mm)

Members & Access

- `%camboprotection_protection_members%` - Number of trusted members - `%camboprotection_protection_members_max%` - Maximum allowed members - `%camboprotection_protection_blocked%` - Number of blocked players

Expiration & Timing

- `%camboprotection_protection_expire%` - Time until expiration (e.g., "5d 3h 45m") - Returns "ONLINE" if owner is online - Returns "EXPIRED" if protection is expired - Shows days, hours, and minutes remaining

Economy & Levels

- `%camboprotection_upgrade_cost%` - Cost to upgrade to next level - `%camboprotection_downgrade_refund%` - Refund amount for downgrading - `%camboprotection_max_level%` - Highest available protection level - `%camboprotection_total_protections%` - Total protections on server

Protection Settings (All 10 Options)

- `%camboprotection_setting_pvp%` - PVP enabled status - `%camboprotection_setting_fire%` - Fire spread enabled status - `%camboprotection_setting_mobspawn%` - Mob spawning enabled status - `%camboprotection_setting_explosion%` - Explosion enabled status - `%camboprotection_setting_mobgriefing%` - Mob griefing enabled status - `%camboprotection_setting_build%` - Building enabled status - `%camboprotection_setting_break%` - Breaking enabled status - `%camboprotection_setting_plantgrowth%` - Plant growth enabled status - `%camboprotection_setting_interact%` - Interaction enabled status - `%camboprotection_setting_redstone%` - Redstone enabled status

Usage Examples

Creating a Protection

1. Give yourself a protection block: `/cp admin give @s 1` 2. Place the special beacon block in your desired location 3. The protection is created automatically at 31x31

Expanding Your Protection

``` /cp upgrade # If you have economy set up ``` This upgrades your protection to the next level with increased radius and cost.

Setting Up Member System

``` /cp trust PlayerName # Add trusted member /cp untrust PlayerName # Remove trusted member /cp block BadPlayer # Block player from entering ```

Using Placeholders

In any PlaceholderAPI-supported plugin: ``` Player Protection: %camboprotection_has_protection% Owner: %camboprotection_protection_owner% Level: %camboprotection_protection_level% (Size: %camboprotection_protection_size%) Members: %camboprotection_protection_members%/%camboprotection_protection_members_max% Expires in: %camboprotection_protection_expire% ```

Configuration Examples

Small Economy Server (Cheap Upgrades)

```yaml levels: refund-percentage: 0.75 1: cost: 0 size: 31 2: cost: 1000 size: 61 3: cost: 2500 size: 91 ```

Large Economy Server (Expensive Upgrades)

```yaml levels: refund-percentage: 0.5 1: cost: 0 size: 31 2: cost: 50000 size: 61 3: cost: 150000 size: 91 4: cost: 400000 size: 121 5: cost: 1000000 size: 151 ```

Hardcore Mode (Strict Protection)

```yaml expiration: enabled: true days: 3

defaults: pvp: false fire: false mob-spawn: false explosion: false mob-griefing: false build: false break: false plant-growth: false interact: false redstone: false ```

Peaceful Mode (Relaxed)

```yaml protection: max-trusted-players: 12

defaults: pvp: false fire: true mob-spawn: true explosion: true mob-griefing: true build: true break: true plant-growth: true interact: true redstone: true ```

Data Persistence

- Data Location: All protection data is saved to YAML files - Data Location: Protections are saved automatically on changes - Data Location: `plugins/CamboProtection/data/`

Performance Considerations

- Scalable: Optional, configurable update interval and view distance - Scalable: Efficient location-based protection lookups - Scalable: Where possible, operations are async to prevent lag - Scalable: Supports 100+ protections without noticeable performance impact