Horizons Claims

HorizonsClaims

A lightweight yet powerful region-based land claim plugin built for modern Paper, Purpur, and Spigot servers. HorizonsClaims gives players an intuitive golden shovel claiming experience with deep protection, a flexible trust system, economy-driven claim blocks, and extensive integration support. Whether you run a small SMP or a large network, HorizonsClaims scales to fit your needs while remaining simple for players to use.

---

Features at a Glance

- custom item claim creation with visual feedback - Subclaims, merging, naming, and cross-world support - Comprehensive custom item - Granular custom item with ban/kick/transfer - custom item with playtime rewards and buy/sell shop - Automatic custom item for inactive players - Beautiful boundary custom item (particles, ghost blocks, glow entities) - custom item system with per-claim and wilderness rules - custom item to claims with warmup - custom item for trusted players - custom item via Citizens2 - custom item (Dynmap, BlueMap) - Extensive custom item support (ItemsAdder, Oraxen, and more) - SQLite and MySQL database backends - PlaceholderAPI, Vault, and multi-currency economy support - Multilingual (English & German) - bStats metrics

---

Claiming System

Golden Shovel Tool

Claims are created using a golden shovel (or any configurable material). Right-click two opposite corners to define a rectangular region. The tool can be customized:

- Glow effect -- change from golden shovel to any item - Glow effect -- custom name shown on the tool - Glow effect -- make the claim tool glow with an enchantment shimmer

Obtain the claim tool with `/claim tool` or the shortcut `/claimtool`.

Claim Size & Limits

Server administrators can configure:

- Maximum claims per player -- prevent tiny, cluttered claims - Maximum claims per player -- cap how large a single claim can be - Maximum claims per player -- limit the number of separate claims a player can own - Players with `horizonsclaims.unlimited` bypass size and count limits

Claim Naming

Give your claims meaningful names using the claim settings. Named claims are displayed in enter/leave messages, the claim list, and teleportation menus, making it easy to organize multiple claims.

Cross-World Claiming

Players can own claims across different worlds. Each claim is world-specific, but the player's total claim block pool is shared globally.

Subclaim System

Create claims within claims for fine-grained area control. Subclaims are ideal for:

- Designating public areas within a private base - Giving specific players access to only part of a larger claim - Creating shop plots inside a town claim

Subclaims can operate with inherited flags (their own protection settings) or inherited flags (inheriting from the parent claim). This flexibility lets you build complex permission structures without multiple overlapping claims.

Claim Merging

Own two adjacent claims? Use `/claim merge` or `/claimmerge` to combine them into a single claim. Merging simplifies management when claims have grown to touch each other. The resulting claim inherits the settings and trust lists that you configure.

Claim Block Economy

Players need claim blocks to create and expand claims. The system provides multiple ways to earn and manage blocks:

- Admin grants -- every new player begins with a configurable number of claim blocks - Admin grants -- earn additional blocks automatically for time spent on the server - Admin grants -- purchase claim blocks using the server economy - Admin grants -- sell unused claim blocks back for money - Admin grants -- administrators can give or set blocks for any player

Claim Block Refund

When a player refunded or refunded a claim, a configurable percentage of the invested claim blocks is refunded. Set it to 100% for full refunds or lower to add an economic cost to restructuring claims.

Anti-Claim Camping

Prevent players from claiming land directly adjacent to other players' claims. A configurable minimum distance between claims ensures everyone has breathing room. Players with the `horizonsclaims.bypass.distance` permission can ignore this restriction.

---

Protection

HorizonsClaims provides comprehensive protection for claimed land. Every protection type is active by default and covers a wide range of grief vectors.

Block Protection

- Block placing -- untrusted players cannot break blocks inside a claim - Block placing -- untrusted players cannot place blocks inside a claim

Container Protection

- Chests, barrels, shulker boxes and all other container types are locked to untrusted players - Prevents item theft from any interactable storage block

Entity Protection

- Entity interaction -- protected from manipulation and destruction - Entity interaction -- protected from item removal and breaking - Entity interaction -- controls who can interact with entities inside the claim

Entity Damage Protection

- Villagers -- prevents killing or harming passive mobs in claims - Villagers -- protects villagers from being attacked or killed - Full control over entity damage within claim boundaries

PvP Protection

Claims can individually control whether PvP is allowed within their borders. See the dedicated PvP Toggle section below for the full rule set.

Explosion Protection

- Creepers -- explosions from TNT do not damage blocks or entities in claims - Creepers -- creeper explosions are neutralized within claim boundaries - Covers all explosion sources to keep builds safe

Fire Protection

- Fire spread is prevented within claims, stopping both natural and intentional fire grief

Piston Protection

- Cross-border piston movement is blocked -- pistons outside a claim cannot push or pull blocks into or out of the claimed area - Prevents a common grief technique where players use pistons to bypass claim boundaries

WorldGuard Integration

When WorldGuard is installed, HorizonsClaims can be configured to prevent players from creating claims inside WorldGuard regions. This ensures server-managed areas (spawn, arenas, event zones) remain free of player claims. Players with `horizonsclaims.bypass.worldguard` can override this restriction.

---

Trust System

Control who can interact with your claims through a flexible trust system.

Trust & Untrust

Use `/claim trust <player>` or `/trust <player>` to grant a player access to your claim. Trusted players can build, break, and interact within the claim as if it were their own. Revoke access at any time with `/claim untrust <player>` or `/untrust <player>`.

Trust is per-claim -- you can trust different players in different claims.

Ban & Unban

Ban problematic players from your claim entirely with `/claim ban <player>` or `/claimban <player>`. Banned players:

- Cannot enter the claim - Are teleported out if already inside - Cannot be trusted until unbanned

Unban with `/claimunban <player>`.

Kick

Immediately remove a player from your claim with `/claim kick <player>` or `/claimkick <player>`. The player is teleported outside the claim boundaries. Kicking does not ban the player -- they can re-enter unless also banned.

Transfer Ownership

Transfer full ownership of a claim to another player with the transfer command. The new owner gains complete control, including trust management and claim settings. Requires the `horizonsclaims.transfer` permission.

---

PvP Toggle System

HorizonsClaims includes a dedicated PvP toggle system that integrates with claims and the wilderness.

/pvp Command

Players can toggle their personal PvP status on or off using `/pvp`. This determines whether they can engage in combat with other players.

PvP Rules

| Location | Rule | |---|---| | priority | PvP occurs only if priority players have PvP toggled priority | | priority | PvP occurs only if the claim's PvP flag is priority AND priority players have PvP toggled priority | | priority | WorldGuard PvP flags take priority over the HorizonsClaims PvP system |

This layered approach gives both server owners and individual players control over combat.

---

Teleportation

/claimtp

Teleport directly to any of your claims using `/claim tp` or `/claimtp`. If the claim has a custom spawn point set, you arrive there; otherwise, you are teleported to a safe location within the claim.

/claimsetspawn

Set a custom spawn point for your claim with `/claim setspawn` or `/claimsetspawn`. This is where trusted players and the owner arrive when using `/claimtp`.

Respawn at Claim

When enabled, players can respawn at their claim after dying, rather than at the world spawn. This feature provides a convenient home-respawn mechanic without requiring a separate homes plugin.

Warmup System

Teleportation can include a warmup delay before the player is teleported. During the warmup:

- Taking damage cancels the teleport - Taking damage cancels the teleport

Players with the `horizonsclaims.bypass.warmup` permission skip the warmup entirely. A separate cooldown between teleports can also be configured, bypassable with `horizonsclaims.bypass.cooldown`.

---

Economy

Claim Block Shop

HorizonsClaims features a complete economy system for buying and selling claim blocks.

Commands

| Command | Description | |---|---| | `/claimblockbuy <amount>` | Buy a specific number of claim blocks | | `/claimblocksell <amount>` | Sell a specific number of claim blocks | | `/claimblockshop` | Open the visual claim block shop GUI |

Configuration

- Confirmation dialogs -- how much each claim block costs to purchase - Confirmation dialogs -- how much each claim block sells for - Confirmation dialogs -- minimum number of blocks per buy/sell - Confirmation dialogs -- maximum number of blocks per buy/sell - Confirmation dialogs -- cap on total claim blocks a player can own - Confirmation dialogs -- require confirmation for large transactions to prevent accidental spending

Shop GUI

The `/claimblockshop` command opens a beautiful graphical shop interface featuring:

- Statistics display that update in real-time to reflect current prices and block counts - Statistics display button -- purchase the maximum number of blocks you can afford in one click - Statistics display button -- sell all unused claim blocks at once - Statistics display -- see your current blocks, used blocks, available blocks, and balance

Supported Currency Providers

| Provider | Description | |---|---| | Item-based | Standard economy through any Vault-compatible plugin | | Item-based | Use PlayerPoints as currency | | Item-based | Use any CoinsEngine currency (configurable currency name) | | Item-based | Deduct experience levels or points (configurable mode) | | Item-based | Use specific items as payment (configurable material and amount) |

Players with `horizonsclaims.bypass.cost` skip all economy costs.

---

Claim Expiration

Keep your world clean by automatically expiring claims of inactive players.

How It Works

1. The plugin tracks each player's automatically deleted. 2. If a player has not logged in for more than the configured automatically deleted (in days), their claims are eligible for expiration. 3. Expired claims are automatically deleted, freeing the land and returning claim blocks according to the refund configuration.

Configuration Options

- Notifications -- number of days of inactivity before claims expire - Notifications -- recently joined players are exempt from expiration for a configurable grace period, ensuring new players are not punished for exploring other servers - Notifications -- configure what percentage of claim blocks are returned upon expiration - Notifications -- notify administrators or log expiration events

Admin Control

Use `/claimadmin expire` to manually trigger an expiration check or review pending expirations.

---

Visualization

HorizonsClaims offers multiple ways to visualize claim boundaries, ensuring players always know where claims begin and end.

Boundary Particles

Particle effects are displayed along claim borders when a player enters or interacts with a claim. Particles provide a clear, non-intrusive visual marker.

Ghost Blocks

Temporary Glowstone accents are placed along claim boundaries. These blocks are visible only to the player viewing the claim and disappear after a short time. Glowstone accents highlight corners and edges for enhanced visibility.

Glow Entities (1.19.4+)

On servers running 1.19.4 or newer, HorizonsClaims can use Display Entities with glow effects to outline claim borders. This modern visualization method provides clean, glowing boundary lines without modifying any actual blocks.

Selection Blocks

When creating or resizing claims, temporary blocks indicate:

- Failure indicators -- show the selected corners of your claim - Failure indicators -- confirm a valid claim selection - Failure indicators -- warn when a selection is invalid (overlap, too small, insufficient blocks)

---

Enter & Leave Messages

Players are notified when entering or leaving a claim. The notification method is configurable:

| Mode | Description | |---|---| | Both | Large text displayed center-screen | | Both | Compact text above the hotbar | | Both | Standard chat message | | Both | Title and ActionBar displayed simultaneously |

Message display timing (fade-in, stay, fade-out) is configurable for title-based messages. Messages can include the claim name, owner name, and other dynamic information.

---

Claim Flight

Players with the `horizonsclaims.flag.fly` permission can toggle flight within claims where they are trusted.

- Use `/claim fly` or `/claimfly` to toggle flight on or off - Flight is automatically disabled when leaving the claim boundaries - Provides a safe creative-like flying experience within protected areas

---

NPC System (Citizens2)

When Citizens2 is installed, HorizonsClaims can create management NPCs that players interact with.

Features

- Spawn NPCs that open claim management interfaces when clicked - Choose from custom player skins: Player, Villager, Zombie, Skeleton, and more - Enable the custom player skins feature so NPCs turn to face nearby players - Use custom player skins for Player-type NPCs - Manage NPCs with `/claimnpc`

---

Map Integrations

Dynmap

When Dynmap is installed, all player claims are displayed on the web map:

- Claims appear as Fill opacity on the map - Fill opacity show the claim name and owner - Fill opacity is configurable for visual clarity

BlueMap

When BlueMap is installed, the same claim visualization is available:

- Colored overlays with configurable Labels - Labels for claim identification - Clean integration with BlueMap's rendering system

---

Custom Item Support

HorizonsClaims integrates with popular custom item plugins, allowing these items to be used as claim tools, shop currencies, or in other configurable roles.

| Plugin | Support | |---|---| | EcoItems | Custom items recognized within claims | | EcoItems | Custom items recognized within claims | | EcoItems | Custom heads usable in configurations | | EcoItems | MMOItems integration | | EcoItems | Slimefun items recognized within claims | | EcoItems | Nexo custom items support | | EcoItems | ExecutableItems integration | | EcoItems | EcoItems integration |

---

Claim Flags & Settings GUI

HorizonsClaims provides a comprehensive GUI interface for managing claim flags and settings.

Claim Flags (`/claim flags` or `/claimflags`)

Toggle individual protection flags per claim through an intuitive click-based GUI. Flags control specific behaviors such as:

- PvP, explosion damage, fire spread - Mob spawning, entity interactions - Container access, block modification

Claim Settings (`/claim settings` or `/claimsettings`)

Manage broader claim properties:

- Claim name - Enter/leave messages - Spawn point - Trust list management - Subclaim configuration

---

Database

HorizonsClaims supports two database backends:

| Backend | Description | |---|---| | HikariCP | File-based, zero configuration, ideal for single servers. Default option. | | HikariCP | Network database via HikariCP connection pooling. Ideal for multi-server setups or large servers requiring external database management. |

Switch between backends in the configuration. Data includes claims, trust relationships, player block balances, and settings.

---

PlaceholderAPI

HorizonsClaims provides an extensive set of placeholders (requires PlaceholderAPI):

Claim Block Placeholders

| Placeholder | Description | |---|---| | `%horizonsclaims_claims_count%` | Number of claims owned by the player | | `%horizonsclaims_claims_limit%` | Maximum claims allowed per player | | `%horizonsclaims_blocks_total%` | Total claim blocks allocated to the player | | `%horizonsclaims_blocks_used%` | Claim blocks currently in use | | `%horizonsclaims_blocks_available%` | Remaining available claim blocks | | `%horizonsclaims_blocks_bonus%` | Bonus claim blocks received | | `%horizonsclaims_total_claim_area%` | Total area (in blocks) of all owned claims |

Current Location Placeholders

| Placeholder | Description | |---|---| | `%horizonsclaims_current_claim%` | Name of the claim at the player's location (empty in wilderness) | | `%horizonsclaims_current_claim_name%` | Alias for `current_claim` | | `%horizonsclaims_current_claim_owner%` | Owner of the claim at the player's location | | `%horizonsclaims_current_claim_id%` | Numeric ID of the current claim | | `%horizonsclaims_current_claim_area%` | Area of the current claim in blocks | | `%horizonsclaims_in_claim%` | Whether the player is inside a claim (`true`/`false`) | | `%horizonsclaims_is_owner%` | Whether the player owns the current claim (`true`/`false`) | | `%horizonsclaims_is_trusted%` | Whether the player is trusted in the current claim (`true`/`false`) | | `%horizonsclaims_can_build%` | Whether the player can build at their location (`true`/`false`) | | `%horizonsclaims_trusted_count%` | Number of trusted players in the current claim |

Subclaim Placeholders

| Placeholder | Description | |---|---| | `%horizonsclaims_in_subclaim%` | Whether the player is inside a subclaim (`true`/`false`) | | `%horizonsclaims_current_subclaim%` | Name of the current subclaim | | `%horizonsclaims_current_subclaim_name%` | Alias for `current_subclaim` |

Playtime Placeholders

| Placeholder | Description | |---|---| | `%horizonsclaims_playtime%` | Total tracked playtime in hours (decimal, e.g., "12.5") | | `%horizonsclaims_playtime_hours%` | Playtime in whole hours | | `%horizonsclaims_playtime_minutes%` | Total playtime in minutes |

PvP Placeholders

| Placeholder | Description | |---|---| | `%horizonsclaims_pvp_status%` | PvP toggle status (`ON`, `OFF`, or `N/A` if disabled) | | `%horizonsclaims_pvp%` | Alias for `pvp_status` | | `%horizonsclaims_pvp_enabled%` | Whether PvP is enabled (`true`/`false`) |

---

Commands

Player Commands

| Command | Aliases | Description | |---|---|---| | `/claim tool` | `/claimtool` | Obtain the claim creation tool | | `/claim list` | `/claims` | List all your claims | | `/claim info` | `/claiminfo` | View information about the current claim | | `/claim trust <player>` | `/trust` | Trust a player in your claim | | `/claim untrust <player>` | `/untrust` | Remove trust from a player | | `/claim expand <amount>` | `/expand` | Expand the current claim's borders | | `/claim shrink <amount>` | `/shrink` | Shrink the current claim's borders | | `/claim delete` | `/deleteclaim` | Delete the current claim | | `/claim ban <player>` | `/claimban` | Ban a player from your claim | | `/claim unban <player>` | `/claimunban` | Unban a player from your claim | | `/claim kick <player>` | `/claimkick` | Kick a player from your claim | | `/claim setspawn` | `/claimsetspawn` | Set the claim's spawn point | | `/claim merge` | `/claimmerge` | Merge two adjacent claims | | `/claim fly` | `/claimfly` | Toggle flight within your claim | | `/claim flags` | `/claimflags` | Open the claim flags GUI | | `/claim settings` | `/claimsettings`, `/claimoptions` | Open the claim settings GUI | | `/claim tp` | `/claimtp` | Teleport to a claim | | `/claim help` | -- | Display help information | | `/claimblockbuy <amount>` | -- | Buy claim blocks | | `/claimblocksell <amount>` | -- | Sell claim blocks | | `/claimblockshop` | -- | Open the block shop GUI | | `/claimblocks` | -- | View your claim block balance | | `/pvp` | -- | Toggle your PvP status | | `/claimnpc` | -- | Manage claim NPCs (requires Citizens2) |

Admin Commands

| Command | Description | |---|---| | `/claimadmin reload` | Reload the plugin configuration | | `/claimadmin delete` | Delete any claim (standing in it) | | `/claimadmin deleteall <player>` | Delete all claims of a specific player | | `/claimadmin list [player]` | List claims, optionally filtered by player | | `/claimadmin info` | View detailed info about the current claim | | `/claimadmin expire` | Manually trigger claim expiration | | `/claimadmin wilderness` | Mark current location info (wilderness check) | | `/claimadmin giveblocks <player> <amount>` | Give claim blocks to a player | | `/claimadmin setblocks <player> <amount>` | Set a player's total claim blocks |

---

Permissions

Player Permissions

| Permission | Description | |---|---| | `horizonsclaims.use` | Access to core claim commands (tool, create, list, info, trust, untrust, expand, shrink, delete, flags, settings, help) | | `horizonsclaims.pvp` | Access to the /pvp toggle command | | `horizonsclaims.npc` | Access to claim NPC management | | `horizonsclaims.teleport` | Access to /claimtp and /claimsetspawn | | `horizonsclaims.subclaim` | Ability to create subclaims | | `horizonsclaims.transfer` | Ability to transfer claim ownership | | `horizonsclaims.economy.buy` | Buy claim blocks | | `horizonsclaims.economy.sell` | Sell claim blocks | | `horizonsclaims.economy.shop` | Open the claim block shop GUI | | `horizonsclaims.ban` | Ban players from claims | | `horizonsclaims.kick` | Kick players from claims | | `horizonsclaims.merge` | Merge adjacent claims | | `horizonsclaims.unlimited` | Bypass claim size and count limits | | `horizonsclaims.flag.fly` | Toggle flight in trusted claims | | `horizonsclaims.pvp.bypass` | Bypass PvP toggle restrictions (always able to PvP) |

Bypass Permissions

| Permission | Description | |---|---| | `horizonsclaims.bypass.cost` | Bypass all economy costs | | `horizonsclaims.bypass.worldguard` | Create claims inside WorldGuard regions | | `horizonsclaims.bypass.distance` | Bypass minimum distance between claims | | `horizonsclaims.bypass.warmup` | Skip teleportation warmup | | `horizonsclaims.bypass.cooldown` | Skip teleportation cooldown |

Wildcard permissions: - `horizonsclaims.economy.*` -- grants all economy permissions - `horizonsclaims.bypass.*` -- grants all bypass permissions

Admin Permission

| Permission | Description | |---|---| | `horizonsclaims.admin` | Access to all `/claimadmin` commands |

---

Getting Started

1. Manage settings -- place the HorizonsClaims JAR file in your server's `plugins` folder and restart. 2. Manage settings -- give players `horizonsclaims.use` for basic claiming functionality. 3. Manage settings -- players run `/claimtool` to receive the golden shovel. 4. Manage settings -- right-click one corner, then right-click the opposite corner. The claim is created instantly with visual feedback. 5. Manage settings -- use `/trust <player>` to give friends access to your claim. 6. Manage settings -- use `/claimflags` and `/claimsettings` to fine-tune your claim's behavior through the GUI. 7. (Optional) Configure economy, expiration, visualization, and other systems in the configuration files. 8. Use `/claimadmin reload` to apply changes without restarting.

---

Configuration

HorizonsClaims uses organized YAML configuration files. Major configuration sections include:

- Integrations -- material, name, glow, lore - Integrations -- min/max size, max claims per player, minimum distance - Integrations -- starting amount, playtime rewards (interval, amount), max total blocks - Integrations -- percentage of blocks refunded on shrink/delete - Integrations -- currency provider, buy/sell prices, min/max transactions, confirmation thresholds - Integrations -- toggle individual protection types (blocks, containers, entities, PvP, explosions, fire, pistons) - Integrations -- enable/disable, inactivity days, new player protection, refund percentage - Integrations -- mode (particles, ghost blocks, glow entities), colors, duration - Integrations -- display mode (title, actionbar, chat), timing, format - Integrations -- warmup duration, cooldown duration, respawn at claim - Integrations -- enable/disable - Integrations -- default toggle state, wilderness rules - Integrations -- configurable sounds for various events - Integrations -- SQLite or MySQL with full connection configuration - Integrations -- WorldGuard, Dynmap, BlueMap, Citizens2, custom item plugins

Language files support German with HEX colors, gradients, and click/hover events. The plugin ships with German and German translations, and additional languages can be added easily.

---

Compatibility

| Requirement | Details | |---|---| | Java Version | Paper, Purpur, or Spigot 1.21 or newer | | Java Version | Java 21 or newer |

Optional Integrations

| Plugin | Purpose | |---|---| | EcoItems + Economy Plugin | Currency provider for claim block shop | | EcoItems | Alternative currency provider | | EcoItems | Alternative currency provider | | EcoItems | Placeholder support for external plugins | | EcoItems | Prevent claiming in protected regions | | EcoItems | Claim management NPCs | | EcoItems | Web map claim overlay | | EcoItems | Web map claim overlay | | EcoItems | Custom item support | | EcoItems | Custom item support | | EcoItems | Custom head support | | EcoItems | Custom item support | | EcoItems | Custom item support | | EcoItems | Custom item support | | EcoItems | Custom item support | | EcoItems | Custom item support |

Metrics

HorizonsClaims collects anonymous usage statistics via bStats to help guide development. This can be disabled in the bStats configuration.

---

Support

If you encounter any issues or have feature suggestions, please reach out through the Modrinth project page or the linked support channels. When reporting a bug, please include:

- Your server version (`/version`) - The plugin version - Your database backend (SQLite or MySQL) - A clear description of the issue - Relevant console errors or logs, if any