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

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

Requirements

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

---

🌍 Adding Languages

1. Copy messages/messages_en_US.yml to messages/messages_xx_XX.yml
2. Copy gui/gui_en_US.yml to gui/gui_xx_XX.yml
3. Translate all strings
4. Set language: xx_XX in config.yml
5. 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

1. Get a claim tool with /claimtool or /claim tool
2. Right-click a block to set the first corner
3. Right-click another block to set the second corner and create the claim
4. Left-click to scan for nearby claims
5. 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

This plugin is proprietary software. All rights reserved.

---

💝 Support Development

If you enjoy HorizonsClaims, please consider:

• ⭐ Leaving a review
• 🐛 Reporting bugs
• 💡 Suggesting features

---