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

Minecraft Version: 1.21.7+
Java Version: 21+

Dependencies

Vault (Required): For economy integration and permission handling
PlaceholderAPI (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

Beacon-Based Claims: Create protections by placing special beacon blocks
6 Customizable Levels: Expand your protection from 31x31 to 181x181 blocks
Unlimited Expansion: Define your own custom protection levels with any cost and size
Multi-World Support: Enable protection in specific worlds via configuration
Auto-Expiration: Automatically remove inactive protections (configurable days)

Member & Access Management

Trusted Members: Add up to 6 trusted players per protection (configurable)
Block List: 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:

PVP Protection: Enable/disable PVP combat in protected areas
Fire Spread Control: Prevent fire from spreading in protections
Mob Spawning: Allow/block natural mob spawning
Explosions: Control whether explosions can damage blocks
Mob Griefing: Prevent mobs (endermen, creepers) from destroying blocks
Building: Restrict non-member block placement
Breaking: Restrict non-member block breaking
Plant Growth: Allow/block natural plant growth
Interaction: Control access to doors, containers, redstone blocks
Redstone: Enable/disable redstone device functionality

Economy Integration

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

Quality of Life Features

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

Admin Commands & Tools

Live Configuration Reload: Reload all settings without restarting
Flexible Management: Admin tools to manage, remove, and view protections
Debug Commands: Check expiration and config status
Teleport System: Teleport to protection spawn locations
Force Expiration: Manually expire inactive protections

Installation

Download the plugin JAR file
Place it in your plugins/ directory
Restart your server or use /reload confirm
Configure the plugin in plugins/CamboProtection/config.yml
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

worlds:
  - world

Specify which worlds have protection enabled.

Protection Settings

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:

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

expiration:
  enabled: true
  days: 7

Remove protections after owner is offline for specified days.

Protection Defaults

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

spawn:
  death-spawn-enabled: true

Enable/disable respawning at protection spawn on death.

First-Join Reward

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

Give yourself a protection block: /cp admin give @s 1
Place the special beacon block in your desired location
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)

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)

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)

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)

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

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

Performance Considerations

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

CamboProtection (Land Claim)