# CamboProtection – Land Claim Plugin<\/p>\n
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.<\/p>\n
## Requirements<\/p>\n
### Server Requirements
\n– **Minecraft Version**: 1.21.7+
\n– **Java Version**: 21+<\/p>\n
### Dependencies
\n– **Vault** (Required): For economy integration and permission handling
\n– **PlaceholderAPI** (Optional): For placeholder support in other plugins
\n– **Floodgate** (Optional): For Bedrock player support with custom forms<\/p>\n
## Overview<\/p>\n
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.<\/p>\n
## Features<\/p>\n
### Core Protection System
\n– **Beacon-Based Claims**: Create protections by placing special beacon blocks
\n– **6 Customizable Levels**: Expand your protection from 31×31 to 181×181 blocks
\n– **Unlimited Expansion**: Define your own custom protection levels with any cost and size
\n– **Multi-World Support**: Enable protection in specific worlds via configuration
\n– **Auto-Expiration**: Automatically remove inactive protections (configurable days)<\/p>\n
### Member & Access Management
\n– **Trusted Members**: Add up to 6 trusted players per protection (configurable)
\n– **Block List**: Prevent specific players from entering your protection
\n– **Owner-Only Control**: Only the protection owner can manage settings<\/p>\n
### Advanced Protection Settings
\n10 customizable toggleable options for each protection:
\n– **PVP Protection**: Enable\/disable PVP combat in protected areas
\n– **Fire Spread Control**: Prevent fire from spreading in protections
\n– **Mob Spawning**: Allow\/block natural mob spawning
\n– **Explosions**: Control whether explosions can damage blocks
\n– **Mob Griefing**: Prevent mobs (endermen, creepers) from destroying blocks
\n– **Building**: Restrict non-member block placement
\n– **Breaking**: Restrict non-member block breaking
\n– **Plant Growth**: Allow\/block natural plant growth
\n– **Interaction**: Control access to doors, containers, redstone blocks
\n– **Redstone**: Enable\/disable redstone device functionality<\/p>\n
### Economy Integration
\n– **Vault Support**: Integrate with any economy plugin supporting Vault
\n– **Level Upgrades**: Cost-based protection level upgrades
\n– **Downgrade Refunds**: Get partial refunds when downgrading (configurable percentage)
\n– **Free Starter Level**: First protection is free at level 1<\/p>\n
### Quality of Life Features
\n– **Protection Particles**: Visual indicators showing protection boundaries
\n– **Particle Customization**: Configure particle view distance and update interval
\n– **Spawn Locations**: Set custom respawn points within your protection
\n– **Death Respawn**: Respawn at your protection spawn on death (toggleable)
\n– **First-Join Reward**: Automatically give new players a protection block
\n– **Floodgate Support**: Bedrock form menus for Bedrock players (if Floodgate installed)<\/p>\n
### Admin Commands & Tools
\n– **Live Configuration Reload**: Reload all settings without restarting
\n– **Flexible Management**: Admin tools to manage, remove, and view protections
\n– **Debug Commands**: Check expiration and config status
\n– **Teleport System**: Teleport to protection spawn locations
\n– **Force Expiration**: Manually expire inactive protections<\/p>\n
## Installation<\/p>\n
1. Download the plugin JAR file
\n2. Place it in your `plugins\/` directory
\n3. Restart your server or use `\/reload confirm`
\n4. Configure the plugin in `plugins\/CamboProtection\/config.yml`
\n5. Reload with `\/cp admin reload`<\/p>\n
## Commands<\/p>\n
### Player Commands<\/p>\n
#### Main Menu
\n– `\/camboprotection` or `\/cp` – Open main protection management menu<\/p>\n
#### Protection Management
\n– `\/cp upgrade` – Upgrade protection to next level
\n– `\/cp downgrade` – Downgrade protection and receive partial refund
\n– `\/cp remove` – Remove your protection
\n– `\/cp view on|off` – Toggle protection boundary visualization<\/p>\n
#### Member Management #### Spawn System ### Admin Commands<\/p>\n #### Permission: `camboprotection.admin`<\/p>\n – `\/cp admin give ## Permissions<\/p>\n – `camboprotection.use` (default: true) – Use CamboProtection features ## Configuration<\/p>\n ### Default Configuration Location ### Configuration Sections<\/p>\n #### Worlds #### Protection Settings #### Protection Levels #### Expiration Settings #### Protection Defaults #### Spawn Settings #### First-Join Reward ## PlaceholderAPI Support<\/p>\n CamboProtection registers the `%camboprotection_*%` placeholder namespace. All placeholders work with PlaceholderAPI-integrated plugins and commands.<\/p>\n ### Status Placeholders ### Protection Details ### Members & Access ### Expiration & Timing ### Economy & Levels ### Protection Settings (All 10 Options) ## Usage Examples<\/p>\n ### Creating a Protection ### Expanding Your Protection ### Setting Up Member System ### Using Placeholders ## Configuration Examples<\/p>\n ### Small Economy Server (Cheap Upgrades) ### Large Economy Server (Expensive Upgrades) ### Hardcore Mode (Strict Protection) defaults: ### Peaceful Mode (Relaxed) defaults: ## Data Persistence<\/p>\n – **Protections Saved**: All protection data is saved to YAML files ## Performance Considerations<\/p>\n – **Particle System**: Optional, configurable update interval and view distance CamboProtection is a beacon-based land claim plugin for Paper servers with 6 customizable levels, member management, economy integration, and support for both Java and Bedrock players via intuitive GUIs.<\/p>\n","protected":false},"featured_media":36607,"template":"","meta":{"_minecraft_slug":"camboprotection","_minecraft_project_id":"YJysvaOq","_minecraft_author":"UnReal-HaFiz","_minecraft_license":"MIT","_minecraft_downloads":172,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"camboprotection.zip","_minecraft_size_bytes":133054,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T13:08:12.628706Z","_minecraft_date_created":"2026-01-17T23:47:39.831423Z","_minecraft_date_modified":"2026-01-13T09:53:08.987863Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/camboprotection","_minecraft_icon_attachment_id":36607,"_minecraft_imported_at":"2026-06-01T18:14:21+00:00","_minecraft_import_hash":"1a76b805ec8675ba5b2abc211f19850d","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,156,844,125,1003,122,126,127,128,129,92],"mod_loader":[130,131,1004,132,133,134],"minecraft_version":[40,41,80,81,82],"class_list":["post-36606","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-decoration","mod_category-economy","mod_category-folia","mod_category-geyser","mod_category-magic","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-geyser","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– `\/cp trust
\n– `\/cp untrust
\n– `\/cp block
\n– `\/cp unblock
\n– `\/cp setspawn` – Set respawn point within your protection (must be inside)
\n– `\/cp spawn` – Teleport to your protection spawn location<\/p>\n
\n– `\/cp admin reload` – Reload all configuration and data
\n– `\/cp admin remove
\n– `\/cp admin list` – List all active protections
\n– `\/cp admin teleport
\n– `\/cp admin view
\n– `\/cp admin forceexpire
\n– `\/cp admin debug expiration` – Display expiration system debug information
\n– `\/cp admin debug config` – Display configuration version and status information<\/p>\n
\n– `camboprotection.admin` (default: op) – Access admin commands and management features
\n– `camboprotection.bypass` (default: op) – Bypass protection restrictions<\/p>\n
\n`plugins\/CamboProtection\/config.yml`<\/p>\n
\n“`yaml
\nworlds:
\n – world
\n“`
\nSpecify which worlds have protection enabled.<\/p>\n
\n“`yaml
\nprotection:
\n max-per-player: 1
\n max-trusted-players: 6
\n“`
\n– `max-per-player`: Maximum number of protections per player
\n– `max-trusted-players`: Maximum players that can be trusted in one protection<\/p>\n
\nDefine unlimited custom levels with cost and size:
\n“`yaml
\nlevels:
\n refund-percentage: 0.5
\n 1:
\n cost: 0
\n size: 31
\n 2:
\n cost: 10000
\n size: 61
\n“`
\n– `cost`: Economy currency needed to upgrade
\n– `size`: Protection radius (size x size area)
\n– `refund-percentage`: Percentage refunded on downgrade (0.0 – 1.0)<\/p>\n
\n“`yaml
\nexpiration:
\n enabled: true
\n days: 7
\n“`
\nRemove protections after owner is offline for specified days.<\/p>\n
\n“`yaml
\ndefaults:
\n pvp: false
\n fire: false
\n mob-spawn: true
\n explosion: false
\n mob-griefing: false
\n build: false
\n break: false
\n plant-growth: true
\n interact: false
\n redstone: false
\n“`
\nDefault settings applied to all new protections.<\/p>\n
\n“`yaml
\nspawn:
\n death-spawn-enabled: true
\n“`
\nEnable\/disable respawning at protection spawn on death.<\/p>\n
\n“`yaml
\nfirst-join:
\n enabled: true
\n level: 1
\n“`
\nGive new players a protection block on their first join.<\/p>\n
\n– `%camboprotection_has_protection%` – Returns “true” if player has protection
\n– `%camboprotection_is_owner%` – Returns “true” if player owns a protection
\n– `%camboprotection_is_member%` – Returns “true” if player is a member of a protection<\/p>\n
\n– `%camboprotection_protection_name%` – Owner’s name of the protection
\n– `%camboprotection_protection_owner%` – Full owner name
\n– `%camboprotection_protection_level%` – Current protection level (1-6+)
\n– `%camboprotection_protection_size%` – Protection dimensions (e.g., “31×31”)
\n– `%camboprotection_protection_radius%` – Protection radius in blocks
\n– `%camboprotection_protection_world%` – World where protection exists
\n– `%camboprotection_protection_x%` – Center X coordinate
\n– `%camboprotection_protection_z%` – Center Z coordinate
\n– `%camboprotection_protection_created%` – Creation date (format: yyyy-MM-dd HH:mm)<\/p>\n
\n– `%camboprotection_protection_members%` – Number of trusted members
\n– `%camboprotection_protection_members_max%` – Maximum allowed members
\n– `%camboprotection_protection_blocked%` – Number of blocked players<\/p>\n
\n– `%camboprotection_protection_expire%` – Time until expiration (e.g., “5d 3h 45m”)
\n – Returns “ONLINE” if owner is online
\n – Returns “EXPIRED” if protection is expired
\n – Shows days, hours, and minutes remaining<\/p>\n
\n– `%camboprotection_upgrade_cost%` – Cost to upgrade to next level
\n– `%camboprotection_downgrade_refund%` – Refund amount for downgrading
\n– `%camboprotection_max_level%` – Highest available protection level
\n– `%camboprotection_total_protections%` – Total protections on server<\/p>\n
\n– `%camboprotection_setting_pvp%` – PVP enabled status
\n– `%camboprotection_setting_fire%` – Fire spread enabled status
\n– `%camboprotection_setting_mobspawn%` – Mob spawning enabled status
\n– `%camboprotection_setting_explosion%` – Explosion enabled status
\n– `%camboprotection_setting_mobgriefing%` – Mob griefing enabled status
\n– `%camboprotection_setting_build%` – Building enabled status
\n– `%camboprotection_setting_break%` – Breaking enabled status
\n– `%camboprotection_setting_plantgrowth%` – Plant growth enabled status
\n– `%camboprotection_setting_interact%` – Interaction enabled status
\n– `%camboprotection_setting_redstone%` – Redstone enabled status<\/p>\n
\n1. Give yourself a protection block: `\/cp admin give @s 1`
\n2. Place the special beacon block in your desired location
\n3. The protection is created automatically at 31×31<\/p>\n
\n“`
\n\/cp upgrade # If you have economy set up
\n“`
\nThis upgrades your protection to the next level with increased radius and cost.<\/p>\n
\n“`
\n\/cp trust PlayerName # Add trusted member
\n\/cp untrust PlayerName # Remove trusted member
\n\/cp block BadPlayer # Block player from entering
\n“`<\/p>\n
\nIn any PlaceholderAPI-supported plugin:
\n“`
\nPlayer Protection: %camboprotection_has_protection%
\nOwner: %camboprotection_protection_owner%
\nLevel: %camboprotection_protection_level% (Size: %camboprotection_protection_size%)
\nMembers: %camboprotection_protection_members%\/%camboprotection_protection_members_max%
\nExpires in: %camboprotection_protection_expire%
\n“`<\/p>\n
\n“`yaml
\nlevels:
\n refund-percentage: 0.75
\n 1:
\n cost: 0
\n size: 31
\n 2:
\n cost: 1000
\n size: 61
\n 3:
\n cost: 2500
\n size: 91
\n“`<\/p>\n
\n“`yaml
\nlevels:
\n refund-percentage: 0.5
\n 1:
\n cost: 0
\n size: 31
\n 2:
\n cost: 50000
\n size: 61
\n 3:
\n cost: 150000
\n size: 91
\n 4:
\n cost: 400000
\n size: 121
\n 5:
\n cost: 1000000
\n size: 151
\n“`<\/p>\n
\n“`yaml
\nexpiration:
\n enabled: true
\n days: 3<\/p>\n
\n pvp: false
\n fire: false
\n mob-spawn: false
\n explosion: false
\n mob-griefing: false
\n build: false
\n break: false
\n plant-growth: false
\n interact: false
\n redstone: false
\n“`<\/p>\n
\n“`yaml
\nprotection:
\n max-trusted-players: 12<\/p>\n
\n pvp: false
\n fire: true
\n mob-spawn: true
\n explosion: true
\n mob-griefing: true
\n build: true
\n break: true
\n plant-growth: true
\n interact: true
\n redstone: true
\n“`<\/p>\n
\n– **Auto-Save**: Protections are saved automatically on changes
\n– **Data Location**: `plugins\/CamboProtection\/data\/`<\/p>\n
\n– **Spatial Caching**: Efficient location-based protection lookups
\n– **Async Operations**: Where possible, operations are async to prevent lag
\n– **Scalable**: Supports 100+ protections without noticeable performance impact<\/p>\n","protected":false},"excerpt":{"rendered":"