headerimage

Horizons Claims

Modern region-based claim protection for Paper/Spigot 1.21

✨ Features

Intuitive Claim Tool - Golden shovel system for easy claim creation
Beautiful GUI - Manage all claim settings through an intuitive interface
Role-Based Permissions - Visitor, Trusted, Manager, Owner with 50+ configurable flags
Subclaims - Create areas within claims with independent permissions
Claim Blocks Currency - Earn blocks through playtime or purchase with economy
Multi-Language - English and German included, easily add more
Economy Support - Buy/sell claim blocks with Vault integration
PlaceholderAPI - 25+ placeholders for scoreboards, holograms, etc.
SQLite & MySQL - Choose your preferred database
Map Integration - Dynmap and BlueMap support
Claim NPCs - Citizens integration for interactive claim management
Custom Item Support - HeadDatabase, ItemsAdder, and Oraxen integration
Visualization - Particle borders with glow entity support (1.19.4+)
Teleportation - Teleport to claims with warmup & cooldown
PvP Toggle - Global PvP toggle system for players
Claim Expiration - Automatic cleanup of inactive player claims
Wilderness Flags - Configure default flags for unclaimed areas
Anti-Camping - Minimum distance between claims from different players
WorldGuard Integration - Prevent claiming inside protected regions
Hex Color Support - Full RGB color codes, gradients, and MiniMessage

📋 Commands

Main Commands

Command	Description	Permission
`/claim`	Open help menu	`horizonsclaims.use`
`/claim tool`	Get a claim tool (golden shovel)	`horizonsclaims.use`
`/claim list`	List all your claims	`horizonsclaims.use`
`/claim info`	Show info about the claim you're in	`horizonsclaims.use`
`/claim blocks`	Check your claim blocks balance	`horizonsclaims.use`
`/claim trust <player>`	Trust a player in your claim	`horizonsclaims.use`
`/claim untrust <player>`	Remove trust from a player	`horizonsclaims.use`
`/claim expand <direction> <amount>`	Expand your claim	`horizonsclaims.use`
`/claim shrink <direction> <amount>`	Shrink your claim (refund blocks)	`horizonsclaims.use`
`/claim delete`	Delete the claim you're standing in	`horizonsclaims.use`
`/claim tp <claim>`	Teleport to a claim	`horizonsclaims.teleport`
`/claim name <name>`	Rename your claim	`horizonsclaims.use`
`/claim entermsg <message>`	Set enter message	`horizonsclaims.use`
`/claim leavemsg <message>`	Set leave message	`horizonsclaims.use`
`/claim subclaim`	Create a subclaim within your claim	`horizonsclaims.subclaim`
`/claim subclaims`	List subclaims in the current claim	`horizonsclaims.use`
`/claim transfer <player>`	Transfer claim ownership	`horizonsclaims.transfer`
`/claim accept`	Accept a claim transfer	`horizonsclaims.use`
`/claim deny`	Deny a claim transfer	`horizonsclaims.use`
`/claim ban <player>`	Ban a player from your claim	`horizonsclaims.ban`
`/claim unban <player>`	Unban a player from your claim	`horizonsclaims.ban`
`/claim kick <player>`	Kick a player from your claim	`horizonsclaims.kick`
`/claim setspawn`	Set teleport spawn point	`horizonsclaims.use`
`/claim merge`	Merge adjacent claims	`horizonsclaims.merge`

Shortcut Commands

Command	Aliases	Description
`/claimtool`	`/ct`, `/gstool`, `/schaufel`	Get a claim tool
`/trust <player>`	`/vertrauen`, `/ctrust`	Trust a player
`/untrust <player>`	`/entfernen`, `/cuntrust`	Remove trust
`/claims`	`/myclaims`, `/claimlist`	List your claims
`/claimblocks`	`/cb`, `/cblocks`	Check claim blocks
`/claiminfo`	`/ci`, `/cinfo`	Show claim info
`/expand <dir> <amt>`	`/claimexpand`, `/erweitern`	Expand claim
`/shrink <dir> <amt>`	`/claimshrink`, `/verkleinern`	Shrink claim
`/deleteclaim`	`/unclaim`, `/removeclaim`	Delete claim
`/claimfly`	`/cfly`, `/gsfly`	Toggle flight in claims
`/claimflags`	`/cflags`, `/gsflags`	Open flags GUI
`/claimsettings`	`/csettings`	Open settings GUI
`/claimtp <claim>`	`/ctp`, `/gstp`	Teleport to claim
`/claimban <player>`	`/cban`, `/gsban`	Ban player
`/claimunban <player>`	`/cunban`, `/gsunban`	Unban player
`/claimkick <player>`	`/ckick`, `/gskick`	Kick player
`/claimsetspawn`	`/csetspawn`	Set spawn point
`/claimmerge`	`/cmerge`, `/gsmerge`	Merge claims

Economy Commands

Command	Description	Permission
`/claimblockbuy <amount>`	Buy claim blocks with money	`horizonsclaims.economy.buy`
`/claimblocksell <amount>`	Sell claim blocks for money	`horizonsclaims.economy.sell`
`/claimblockshop`	Open the claim blocks shop GUI	`horizonsclaims.economy.shop`

PvP & NPC Commands

Command	Description	Permission
`/pvp [on\|off\|status]`	Toggle your PvP status	`horizonsclaims.pvp`
`/claimnpc <subcommand>`	Manage claim NPCs	`horizonsclaims.npc`

Admin Commands

Command	Description
`/claimadmin reload`	Reload all configuration files
`/claimadmin delete`	Delete the claim you're standing in
`/claimadmin deleteall <player>`	Delete all claims of a player
`/claimadmin list [player]`	List all claims or a player's claims
`/claimadmin info`	View detailed claim info
`/claimadmin giveblocks <player> <amount>`	Give bonus claim blocks
`/claimadmin setblocks <player> <amount>`	Set a player's claim blocks
`/claimadmin transfer <player>`	Transfer current claim to player
`/claimadmin adminclaim`	Create an admin claim
`/claimadmin setadmin`	Toggle admin claim status
`/claimadmin expire`	Force check for expired claims
`/claimadmin wilderness <world> [flag] [value]`	Manage wilderness flags

Command Aliases

/claim → /c, /grundstück, /grundstueck, /gs, /plot
/claimadmin → /ca, /cadmin, /gsadmin

🔑 Permissions

Basic Permissions

Permission	Description	Default
`horizonsclaims.use`	Create and manage claims	Everyone
`horizonsclaims.pvp`	Toggle PvP status	Everyone
`horizonsclaims.npc`	Manage claim NPCs	Everyone
`horizonsclaims.teleport`	Teleport to claims	Everyone
`horizonsclaims.subclaim`	Create subclaims	Everyone
`horizonsclaims.transfer`	Transfer claim ownership	Everyone
`horizonsclaims.ban`	Ban players from claims	Everyone
`horizonsclaims.kick`	Kick players from claims	Everyone
`horizonsclaims.merge`	Merge adjacent claims	Everyone
`horizonsclaims.economy.buy`	Buy claim blocks	Everyone
`horizonsclaims.economy.sell`	Sell claim blocks	Everyone
`horizonsclaims.economy.shop`	Use claim block shop	Everyone
`horizonsclaims.admin`	Access admin commands	OP
`horizonsclaims.unlimited`	Unlimited claims	OP

Bypass Permissions

Permission	Description
`horizonsclaims.bypass`	Bypass all claim protections
`horizonsclaims.bypass.cost`	Bypass claim block costs
`horizonsclaims.bypass.worldguard`	Bypass WorldGuard restrictions
`horizonsclaims.bypass.distance`	Bypass minimum claim distance
`horizonsclaims.bypass.warmup`	Instant teleport (skip warmup)
`horizonsclaims.bypass.cooldown`	Bypass command cooldowns
`horizonsclaims.pvp.bypass`	Can attack anyone (bypass PvP toggle)

Special Flag Permissions

Permission	Description
`horizonsclaims.flag.fly`	Allow enabling fly flag in claims

🛡️ Claim Flags

HorizonsClaims features over 50 configurable flags organized into categories:

Block Flags

Block Break - Break blocks
Block Place - Place blocks

Interaction Flags

Container Access - Open chests, barrels, hoppers
Door Access - Use doors and trapdoors
Buttons & Levers - Use buttons and levers
Redstone Interact - Use redstone components
Villager Trade - Trade with villagers
Use Anvil - Use anvils
Use Enchant Table - Use enchanting tables
Use Crafting - Use crafting tables
Use Furnace - Use furnaces
Use Beacon - Use beacons
Use Bed - Use beds (set spawn)
Use Respawn Anchor - Use respawn anchors

Entity Flags

Entity Damage - Attack passive animals/mobs
Entity Interact - Interact with entities (leads, saddles)
Armor Stands - Edit armor stands
Item Frames - Edit item frames
Breed Animals - Breed animals
Shear Animals - Shear animals
Leash Animals - Leash animals
Vehicle Place - Place boats and minecarts
Vehicle Destroy - Destroy boats and minecarts

Item Flags

Use Buckets - Use buckets (water, lava)
Use Flint & Steel - Use flint and steel
Use Bonemeal - Use bone meal
Throw Eggs - Throw eggs
Throw Potions - Throw splash potions
Use Ender Pearl - Throw ender pearls
Use Chorus Fruit - Eat chorus fruit (teleport)
Pickup Items - Pick up items from ground
Drop Items - Drop items

Farming Flags

Farm Crops - Plant and harvest crops
Trample Crops - Trample farmland
Harvest Berries - Harvest berries

Combat Flags

PvP - Attack players

Environment Flags

TNT Damage - TNT explosions can destroy blocks
Creeper Damage - Creeper explosions can destroy blocks
Wither Damage - Wither can destroy blocks
Ghast Damage - Ghast fireballs can destroy blocks
Enderman Grief - Endermen can pick up blocks
Mob Griefing - Mobs can change blocks
Fire Spread - Fire can spread
Snow Form - Snow can form
Ice Form - Ice can form (Frost Walker)
Liquid Flow - Water/lava can flow in from outside
Weather: Rain - Rain in claim
Weather: Snow - Snow in claim
Weather: Thunder - Thunder/lightning in claim
Monster Spawn - Monster spawning
Animal Spawn - Animal spawning
Leaf Decay - Leaves can decay
Crop Grow - Crops can grow
Sculk Spread - Sculk can spread (1.19+)
Warden Spawn - Warden can spawn (1.19+)

Special Flags

Fly - Fly in claim (requires permission)
Teleport To - Teleport to claim
Nether Portal - Use nether portal
End Portal - Use end portal
Subclaim Messages - Show/hide subclaim messages

Management Flags

Manage Trust - Trust/untrust players
Manage Flags - Edit flags
Manage Resize - Expand/shrink claim
Delete Claim - Delete claim

👥 Claim Roles

Role	Description
Visitor	Default role, limited permissions
Trusted	Can build and interact
Manager	Can manage claim settings and trust players
Owner	Full control over the claim

Each role can have different permissions configured through the GUI.

🎨 GUI Features

Main Menu

Claim Flags - Configure permissions for each role
Manage Players - Trust, promote, demote, or remove players
Claim Info - View detailed claim information
Expand/Shrink - Resize your claim
Claim Settings - Name, messages, and other settings
Subclaims - Create and manage subclaims
NPC Settings - Configure claim NPCs (requires Citizens)

Flags GUI

Organized by category (Blocks, Interaction, Entities, etc.)
Toggle permissions for each role
Visual indicators for enabled/disabled flags
Category navigation with icons

Player Management

View all trusted players and their roles
Promote/demote players between roles
Remove players from the claim
Search for players to add

Claim Block Shop

Visual GUI for buying/selling claim blocks
Quick-buy buttons for common amounts
Live price calculation

⚙️ Configuration

config.yml

# Language: de_DE or en_US (add your own in messages/ and gui/ folders)
language: en_US

# Database: SQLITE or MYSQL
database:
  type: SQLITE
  sqlite:
    file: "claims.db"
  mysql:
    host: localhost
    port: 3306
    database: horizons_claims
    username: root
    password: ""
  table-prefix: "hc_"

# Claim Settings
claims:
  min-size:
    width: 5
    length: 5
  max-size:
    width: 500
    length: 500
  max-claims-per-player: 5
  
  # Claim Blocks
  claim-blocks-enabled: true
  blocks-cost-per-block: 1
  starting-claim-blocks: 500
  
  # Playtime Rewards
  reward-interval-minutes: 30
  claim-blocks-per-reward: 50
  max-accrued-claim-blocks: 50000
  refund-percentage: 0.8
  
  # Enter/Leave Messages
  enter-leave-messages: true
  enter-leave-type: "title"  # title, actionbar, chat, both
  
  # Teleport Settings
  teleport-warmup: 3
  
  # Disabled Worlds
  disabled-worlds:
    - "world_the_end"

# Subclaim Settings
subclaims:
  min-size: 3
  max-per-claim: 20
  enter-leave-messages: true
  auto-visualize: true
  independent-flags: true

# Player Features
player-features:
  login-messages: true
  respawn-in-claim: true
  anti-claim-camping:
    enabled: true
    min-distance: 5

# Claim NPC (requires Citizens)
claim-npc:
  enabled: true
  default-enabled-per-claim: true
  default-name: "&6Claim Management"
  default-entity-type: PLAYER
  default-skin: "MHF_Chest"
  look-at-players: true
  look-range: 10

# Economy (requires Vault)
economy:
  enabled: true
  buy-enabled: true
  buy-price-per-block: 10.0
  buy-minimum: 10
  buy-maximum: 1000
  sell-enabled: true
  sell-price-per-block: 5.0
  sell-minimum: 10
  sell-maximum: 1000

# Claim Expiration
expiration:
  enabled: false
  days-until-expiration: 90
  new-player-protection-days: 30
  refund-blocks-on-expiration: true
  refund-percentage: 50

# Claim Tool
claim-tool:
  material: GOLDEN_SHOVEL
  name: "&6&lClaim Tool"
  glowing: true
  cooldown: 60

# Protection Settings
protection:
  block-break: true
  block-place: true
  container-access: true
  entity-interact: true
  entity-damage: true
  pvp: true
  explosions: true
  fire-spread: true
  piston-protection: true
  worldguard-regions: true

# PvP Toggle
pvp-toggle:
  enabled: true
  default-enabled: true

# Visualization
visualization:
  enabled: true
  duration-seconds: 10
  glowstone-interval: 5
  glow-entities:
    enabled: true
    interval: 10
    scale: 0.6
    view-range: 1.5

# Map Integration
dynmap:
  enabled: true
  show-labels: true
  fill-opacity: 0.35
  update-interval: 300

bluemap:
  enabled: true
  show-labels: true
  fill-opacity: 0.35
  update-interval: 300

📊 PlaceholderAPI

HorizonsClaims provides the following placeholders:

Player Placeholders

Placeholder	Description	Example
`%horizonsclaims_claims_count%`	Number of claims owned	`3`
`%horizonsclaims_claims_limit%`	Maximum claims allowed	`5`
`%horizonsclaims_blocks_total%`	Total claim blocks	`1500`
`%horizonsclaims_blocks_used%`	Used claim blocks	`800`
`%horizonsclaims_blocks_available%`	Available claim blocks	`700`
`%horizonsclaims_blocks_bonus%`	Bonus claim blocks	`200`
`%horizonsclaims_playtime%`	Playtime in hours	`12.5`
`%horizonsclaims_playtime_hours%`	Playtime (hours only)	`12`
`%horizonsclaims_playtime_minutes%`	Playtime in minutes	`750`
`%horizonsclaims_pvp_status%`	PvP toggle status	`ON` / `OFF`
`%horizonsclaims_pvp_enabled%`	PvP enabled	`true` / `false`
`%horizonsclaims_total_claim_area%`	Total area of all claims	`2500`

Location Placeholders

Placeholder	Description
`%horizonsclaims_current_claim%`	Name of current claim
`%horizonsclaims_current_claim_owner%`	Owner of current claim
`%horizonsclaims_current_claim_id%`	ID of current claim
`%horizonsclaims_in_claim%`	Is in a claim (`true`/`false`)
`%horizonsclaims_is_owner%`	Is owner of current claim
`%horizonsclaims_is_trusted%`	Is trusted in current claim
`%horizonsclaims_trusted_count%`	Trusted players in current claim
`%horizonsclaims_claim_area%`	Area of current claim
`%horizonsclaims_in_subclaim%`	Is in a subclaim
`%horizonsclaims_current_subclaim%`	Name of current subclaim
`%horizonsclaims_can_build%`	Can build at location

🔌 Soft Dependencies

HorizonsClaims integrates seamlessly with:

Plugin	Integration
Vault	Economy for buying/selling claim blocks
PlaceholderAPI	25+ placeholders for other plugins
WorldGuard	Prevent claiming in protected regions
Dynmap	Show claims on the web map
BlueMap	Show claims on the web map
Citizens	Claim NPCs for interactive management
HeadDatabase	Custom head icons (`hdb:12345`)
ItemsAdder	Custom item icons (`itemsadder:namespace:item`)
Oraxen	Custom item icons (`oraxen:item_id`)

All dependencies are optional - the plugin works perfectly without them!

📥 Installation

Download the latest version
Place HorizonsClaims.jar in your plugins/ folder
Restart your server
Edit configuration files in plugins/HorizonsClaims/
Use /claimadmin reload to apply changes

Requirements

Server: Paper, Spigot, or any fork (1.21+)
Java: 21 or higher

🌍 Adding Languages

Copy messages/messages_en_US.yml to messages/messages_xx_XX.yml
Copy gui/gui_en_US.yml to gui/gui_xx_XX.yml
Translate all strings
Set language: xx_XX in config.yml
Reload with /claimadmin reload

🎨 Color Codes

HorizonsClaims supports:

Legacy codes: &a, &b, &c, etc.
Hex colors: &#FF5555 or &#RGB (short format)
Bracket format: <#FF5555>
Gradients: <gradient:FF0000:00FF00>Text</gradient>
Rainbow: <rainbow>Text</rainbow>
MiniMessage: Full MiniMessage format support
Unicode: Small caps, symbols, emojis

🛠️ Claim Tool Usage

Get a claim tool with /claimtool or /claim tool
Right-click a block to set the first corner
Right-click another block to set the second corner and create the claim
Left-click to scan for nearby claims
Right-click air to cancel the current selection

The claim extends from bedrock to sky automatically.

🐛 Support

Found a bug or have a suggestion?

Discord: Join our Discord

📄 License

💝 Support Development

If you enjoy HorizonsClaims, please consider:

⭐ Leaving a review
🐛 Reporting bugs
💡 Suggesting features

Horizons Claims

📖About Horizons Claims

Horizons Claims

✨ Features

📋 Commands

Main Commands

Shortcut Commands

Economy Commands

PvP & NPC Commands

Admin Commands

Command Aliases

🔑 Permissions

Basic Permissions

Bypass Permissions

Special Flag Permissions

🛡️ Claim Flags

Block Flags

Interaction Flags

Entity Flags

Item Flags

Farming Flags

Combat Flags

Environment Flags

Special Flags

Management Flags

👥 Claim Roles

🎨 GUI Features

Main Menu

Flags GUI

Player Management

Claim Block Shop

⚙️ Configuration

config.yml

📊 PlaceholderAPI

Player Placeholders

Location Placeholders

🔌 Soft Dependencies

📥 Installation

Requirements

🌍 Adding Languages

🎨 Color Codes

🛠️ Claim Tool Usage

🐛 Support

📄 License

💝 Support Development