Welcome to CoreMart!

By registering with us, you'll be able to discuss, share, download resources and private message with other members of our community.

Sign-Up Now!
ZorvynClaim — Land Claiming Plugin for Paper 1.21+

Minecraft ZorvynClaim — Land Claiming Plugin for Paper 1.21+ 1.0.0

No permission to download
Required Resources
Soft: WorldEdit
ZorvynClaim
Land Claiming Plugin for Paper 1.21+



A clean, lightweight land claiming plugin built for Paper 1.21+.

Players protect their land with a golden shovel wand, manage trust/co-owners, control per-role permissions through a GUI, fly inside their claims, set home points, and create named warps — all with no database required. Admins get their own named protected zones with a separate blaze-rod wand and full bypass tools.



✦ Features ✦

🟨 Player Claims
  • Golden-shovel wand to select two corners (left-click = pos1, right-click = pos2)
  • Wand is auto-given on first join (configurable)
  • Claims protect full world height — from bedrock to the build limit
  • Particle border preview on selection, creation, and the /claim show toggle
  • Proximity hint: if your selection is near one of your own claims, the plugin suggests /claim upgrade instead of creating a new one
  • Rank-based size limits via permission nodes (works with LuckPerms and any perm plugin)
  • Maximum area cap to prevent oversized claims
  • Claim creation cooldown

👥 Trust & Roles
  • /claim trust <player> — Trusted member access
  • /claim coowner <player> — Co-owner (can edit settings and trust others)
  • /claim untrust / /claim uncoowner to remove access
  • Three-tier permission system: Guest · Trusted · Co-Owner

⚙️ Claim Settings GUI
Open with /claim settings (must be standing in your own claim or a co-owned one). All toggles are per-claim and saved automatically.

Global toggles:
  • PvP — allow/deny player vs. player combat
  • Explosives — allow/deny creeper/TNT block damage
  • Fire Spread — allow/deny fire spreading through the claim
  • Fluid Spread — allow/deny lava and water flow
  • Vine Growth — allow/deny vines and sweet berry bush growth

Per-role permission toggles (Guest / Trusted / Co-Owner):
  • Block Break
  • Block Place
  • Door Use
  • Trapdoor Use
  • Chest/Container Use
  • Claim Fly
  • Item Pickup
  • Mob Drop Pickup
  • Elytra Use
  • Entity Damage

🪽 Claim Flight
  • /claim fly — Toggle claim flight (only active while inside a claim that allows it)
  • /claim autofly — Automatically enable/disable flight as you enter or leave a claim
  • When you fly out of a claim and flight is disabled, fall damage is cancelled for that landing — no sudden deaths from stepping across the border

🏠 Claim Home & Warps
  • /claim sethome — Set a home point (owner only, must be inside own claim)
  • /claim home — Teleport to the home of a claim you are trusted in
  • /claim setwarp <name> — Create a named warp inside your claim (owner only)
  • /claim warp <name> — Teleport to a named warp in any claim you are trusted in
  • /claim warps — List all warps accessible to you across all trusted claims
  • Warps and homes survive claim upgrades — they are never lost when you expand a claim

⬆️ Claim Upgrade
  • /claim upgrade — Merge your current wand selection into your nearest owned claim, expanding its borders (union of the old claim + new selection)
  • Respects rank size limits and max area cap

🛡️ Protection
  • Block break / place protection by role
  • Chest, door, trapdoor interaction by role
  • Item pickup and mob drop pickup by role
  • Elytra use blocked for unauthorised players
  • Entity damage (animals, item frames, armour stands) controlled by role
  • PvP, explosives, fire spread, fluid spread, vine growth all individually toggleable
  • Title and action-bar messages when entering/leaving claims or wilderness
  • Action-bar deny messages with configurable cooldown to reduce spam

👑 Admin Claims
Named server-protected zones. No owner, no trust list — everything is blocked for everyone (except admins and bypass holders). Great for spawn, shops, events, and roads.

  • /aclaim — Get the admin wand (blaze rod)
  • /aclaim create <name> — Create a named admin claim from your selection
  • /aclaim upgrade <name> — Expand an existing admin claim using your selection
  • /aclaim list — List all admin claims with world and coordinates
  • /aclaim show <name> — Display the particle border for one admin claim
  • /aclaim remove <name|all> — Remove one or all admin claims
  • /aclaim <owner> settings — Open the settings GUI for a player's claim as admin
  • /aclaim <owner> trust <player> — Force-trust a player into someone else's claim
  • /aclaim bypass — Toggle claim bypass (walk and interact anywhere)
  • /aclaim bypass auto — Persistent auto-bypass that survives restart/rejoin
  • Proximity hint: admin wand shows "near existing admin claim — use /aclaim upgrade" when your selection is close to one

🔌 WorldGuard Integration (Optional Soft-Depend)
  • If WorldGuard is present, players cannot create claims or admin claims inside existing WorldGuard protected regions (toggleable in config.yml)

💾 Storage
  • Flat-file YAML storage — no database needed
  • claims.yml, admin-claims.yml, bypass.yml written to the plugin data folder
  • Async save with main-thread snapshot; debounced to avoid I/O spam
  • Graceful flush on server shutdown

✨ Quality of Life
  • Full tab-completion for both /claim and /aclaim — subcommands, player names, admin claim names, and warp names all auto-complete
  • All messages fully customisable in messages.yml (legacy & hex colour codes supported)
  • /claim reload — hot-reload config.yml and messages.yml without restart
  • Particle borders toggled with /claim show; interval and style configurable
  • Chunk-indexed spatial lookup for fast overlap detection at any server scale



📜 Commands

Code:
/claim                        Get a claim wand / create from current selection
/claim help                   Show all commands
/claim upgrade                Expand nearest owned claim using current selection
/claim settings               Open the claim settings GUI
/claim trust <player>         Trust a player in the claim you're standing in
/claim untrust <player>       Untrust a player
/claim coowner <player>       Add a co-owner
/claim uncoowner <player>     Remove a co-owner
/claim fly                    Toggle claim flight
/claim autofly                Toggle auto-fly in claims
/claim sethome                Set the home for your claim
/claim home                   Teleport to a claim home you are trusted in
/claim setwarp <name>         Create a named warp in your claim
/claim warp <name>            Teleport to a named warp
/claim warps                  List all warps you have access to
/claim show                   Toggle particle claim borders
/claim unclaim                Remove the claim you are standing in
/claim unclaim all            Remove all claims you own
/claim reload                 Reload config + messages (admin permission)

Code:
/aclaim                           Get the admin claim wand
/aclaim help                      Show all admin commands
/aclaim create <name>             Create a named admin claim
/aclaim upgrade <name>            Expand an existing admin claim
/aclaim list                      List all admin claims
/aclaim show <name>               Preview an admin claim border
/aclaim remove <name>             Remove an admin claim
/aclaim remove all                Remove all admin claims
/aclaim <owner> settings          Edit a player's claim settings
/aclaim <owner> trust <player>    Force-trust in a player's claim
/aclaim bypass                    Toggle bypass mode
/aclaim bypass auto               Toggle persistent auto-bypass



🔑 Permissions

Permission NodeDefaultDescription
simpleclaims.usetrueRequired to use /claim and own claims
simpleclaims.adminopFull admin access — /aclaim, /claim reload, override settings/trust in any player claim, and bypass mode
zorvyn.adminclaimopAlternative node for /aclaim wand access
zorvynclaim.bypassopAccess to /aclaim bypass
zorvynclaim.defaultExample rank node — grants 5-chunk radius
zorvynclaim.vipExample rank node — grants 8-chunk radius

Add more in config.yml under claim-size-permissions.



⚙️ Configuration
config.yml

YAML:
default-claim-radius: 5
# Default wand selection radius in chunks
# (5 = up to 11x11 chunks / ~176x176 blocks)

claim-size-permissions:
  # Map of rank keys to permission + radius-chunks.
  # The plugin picks the largest matching radius.
  vip:
    permission: "zorvynclaim.vip"
    radius-chunks: 8

max-claim-area: 100000
# Maximum claim area in blocks (X × Z). 0 = unlimited.

claim-create-cooldown-seconds: 3
# Seconds between successive claim creations per player.

claim-upgrade-max-distance-blocks: 32
# How far your selection can be from an existing claim and still
# trigger the upgrade hint / /claim upgrade.

selection-nearby-claim-preview-distance-blocks: 16
# While holding the claim wand, show nearby foreign claim borders
# within this distance.

golden-shovel:
  material: "GOLDEN_SHOVEL"
  # Wand item. Can be changed to BLAZE_ROD if another plugin conflicts.
  auto-give-on-first-join: true
  # Automatically hand the wand to new players on first join.

worldguard:
  block-in-protected-regions: true
  # Block /claim and /aclaim inside WorldGuard regions.

particles:
  enabled: true
  # Master toggle for all particle border rendering.
  type: "DUST"
  # Particle type. Options: DUST (red), VILLAGER_HAPPY, FLAME, etc.

titles:
  enabled: true
  # Show enter/leave titles when crossing claim borders.

messages:
  use-actionbar: true
  # Show deny messages in the action bar instead of chat.
  deny-message-cooldown-ms: 1250
  # Minimum milliseconds between repeated deny messages per player.



📥 Installation

Requirements:
  • Paper 1.21 or newer (not Spigot — requires Paper API)
  • Java 21+

Steps:
  1. Drop ZorvynClaims.jar into your /plugins folder.
  2. Start or restart the server.
  3. Edit plugins/ZorvynClaims/config.yml and messages.yml as needed.
  4. Run /claim reload in-game to apply changes without a full restart.

Optional:
  • Install WorldGuard to prevent players from claiming inside protected regions.



📁 Data Files

Code:
plugins/ZorvynClaims/
├── config.yml          — Main configuration
├── messages.yml        — All player-facing messages (supports & colour codes)
├── claims.yml          — All player claim data (auto-saved, do not edit while running)
├── admin-claims.yml    — All admin claim data
└── bypass.yml          — Persistent bypass player list



❓ FAQ

Yes. Every claim spans from the world's minimum height (bedrock level) to the maximum build height automatically, regardless of where you placed your corners.

No. When claim flight is revoked because you left the claim, the plugin cancels the very next fall damage event for that player, preventing instant deaths.

No. Player claims cannot overlap each other, admin claims, or WorldGuard regions (if WorldGuard is installed). The plugin shows the conflicting claim's border in diamond blocks when a conflict is detected.

No. Warps and home points survive upgrades — they are copied to the expanded claim.

No. /claim warps and /claim warp only show and teleport to warps in claims the player is the owner, co-owner, or trusted member of.

Add entries under claim-size-permissions in config.yml, assign the permission node to the rank in your permission plugin, then run /claim reload.

Yes. Players with simpleclaims.admin or the bypass permission can run /aclaim bypass to toggle a bypass mode that ignores all claim protection. /aclaim bypass auto makes this persist through restarts.




👤 Author

Developed by Trust
Plugin name: ZorvynClaims
API version: Paper 1.21

If you enjoy the plugin, please leave a ⭐ review and share your feedback!
Author
trust
Downloads
0
Views
8
First release
Last update

Ratings

0.00 star(s) 0 ratings

More resources from trust

Back
Top