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

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

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

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)

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