XPProtections

XPProtections

A Minecraft protection plugin that uses chunks for land protection with no dependencies, where players can claim territory and control access using XP levels.

28 downloads 0 followers

XPProtection

Chunk-based land protection, paid for with XP levels. No currency, no dependencies and no complicated setup: stand in a chunk, type /claim, and the land is yours.

Built for Paper.


Features

  • Chunk claims with a single command: /claim.
  • XP level cost that you can configure (4 levels by default). If the player does not have enough levels, no claim is created and nothing is deducted.
  • Trusted players: the owner can grant or remove access for other players.
  • 8 flags per claim to control PvP, mobs, explosions, fire, Elytra and entry.
  • Real world protection: building, chests, furnaces, doors, buttons, levers, item frames, armor stands, buckets, boats and more.
  • Full claim visualization with particles: outlines all of your connected chunks.
  • Bedrock support: /claim chunk shows the borders of the current chunk using fake blocks, which are visible through Geyser.
  • Enter and leave notice in the action bar, fully editable.
  • Safe persistence: claims and flags are saved immediately and survive restarts and shutdowns.
  • Configurable messages using MiniMessage formatting.
  • No dependencies: it does not need Vault, an economy plugin or a database.

Commands

Command Description
/claim Claims the chunk you are standing in.
/claim info Shows the owner and the X/Z coordinates of the chunk.
/claim unclaim Removes the current claim (owner or administrator).
/claim allow <player> Lets a player build and interact inside the claim.
/claim unallow <player> Removes a player's access.
/claim flag <flag> <value> Changes a flag. The value is true or false.
/claim view Shows the full outline of the claim for 5 seconds.
/claim chunk Shows the borders of the current chunk with fake blocks (designed for Bedrock). Also works as /claim bedrock.
/claim reload Reloads the configuration (administrators only).

Permissions

Permission Default Description
xpprotection.admin OP Manage any claim, bypass all protections and use /claim reload.

There is no permission to claim: any player can use /claim as long as they have enough XP levels.


Flags

Flag Default What it controls
entry true When false, players without access cannot enter the claim.
elytra true When false, players without access cannot use Elytra inside the claim.
mob-spawning true When false, no mobs spawn naturally, from spawners or from events.
hostile-mobs true When false, hostile mobs do not spawn.
passive-mobs true When false, passive mobs do not spawn.
pvp false When true, players can damage each other inside the claim.
explosions false When true, explosions can damage blocks in the claim.
fire-spread false When true, fire can spread and burn blocks.

Claiming a chunk does not turn off spawning, so animal and villager farms work from the start. Spawn eggs, commands and breeding are never blocked.


Installation

  1. Make sure you have a compatible Paper.
  2. Download XPProtection.jar from the Versions tab.
  3. Place it in your server's plugins/ folder.
  4. Restart the server (do not use /reload).

Configuration

plugins/XPProtection/config.yml:

claim:
  # XP levels that each chunk costs
  xp-level-cost: 4

messages:
  prefix: "<gold>[XPProtection]</gold> "
  enter-claim: "<gray>Tierra de <yellow>{owner}</yellow>.</gray>"
  leave-claim: "<gray>Saliste de la tierra de <yellow>{owner}</yellow>.</gray>"
  # ... and the rest of the messages

The default messages are written in Spanish. You can translate or restyle any of them in config.yml. If a message is missing from the file, the plugin falls back to a built-in text and never errors.

After editing the file, run /claim reload.


Compatibility

Platform Paper
Minecraft version 26.2 (Paper)
Dependencies None
Bedrock Supported through Geyser/Floodgate (use /claim chunk)

Not supported: Spigot and CraftBukkit (the plugin uses the Paper API) and Folia (it is not adapted to its task scheduler).


FAQ

Do I get my XP back if I remove a claim? No. /claim unclaim does not refund levels.

Can I change the cost? Yes, with claim.xp-level-cost in config.yml, then /claim reload.

What happens to my claims when I update the plugin? They are kept. They are stored in plugins/XPProtection/claims.yml.

Are administrators affected by the protections? No. Anyone with xpprotection.admin can build, interact and enter in any claim.

How can I see where my land ends? Use /claim view for the full outline.


Known limitations

  • Pistons and liquids that cross the border between a claim and the outside are not blocked yet.
  • There is no limit on the number of claims per player.
  • There is no command to list all of your claims.

Support and bug reports

If you find a bug, open an issue using the Issues link on this page and include:

  • Your Paper and XPProtection versions.
  • The steps to reproduce the problem.
  • The server log if any error appears.

No gallery available for this project.

Version Minecraft Loader Download

XPProtections 1.0

1.0

26.1, 26.2
paper
Download