diamondclaims

# DiamondClaims DiamondClaims is a simple land claiming plugin for Paper servers that uses **real diamonds** instead of an economy plugin. I made this because I wanted a claim system that felt more natural for survival. Players already understand diamonds, and they already have value, so using them for land claims keeps things simple. No Vault setup, no money plugin, no extra economy balancing. If a player wants land, they pay diamonds. ## What it does Players can claim the chunk they are standing in by spending diamonds from their hand or inventory. Once a chunk is claimed, other players cannot break blocks, place blocks, open containers, mess with doors/buttons/levers, use buckets, grief with pistons, or damage protected entities inside the claim. It also includes a trust system, so players can allow friends to build in their claims without giving access to everyone. ## Main features * Claim chunks using physical diamonds * No Vault or economy plugin required * Diamonds are removed from the player and tracked in a virtual server bank * Weekly upkeep system to help prevent abandoned claims * Players can prepay upkeep with extra diamonds * Claim protection for blocks, containers, entities, fluids, explosions, fire, and pistons * Trust and untrust commands for friends * Chat-based claim map * Admin/server claims for spawn and protected areas * Optional BlueMap support for showing claims on the web map * Configurable messages and protection settings ## Basic player commands ```text /dclaim claim /dclaim unclaim /dclaim info /dclaim list /dclaim map /dclaim trust /dclaim untrust /dclaim trustlist /dclaim upkeep pay /dclaim upkeep pay all /dclaim upkeep deposit ``` There is also a short claim alias: ```text /claim ``` ## Paying upkeep ahead Players can deposit diamonds ahead of time for future upkeep: ```text /dclaim upkeep deposit 64 ``` This removes 64 diamonds and stores them as upkeep credit for that player. ## Admin/server claims Admins can claim chunks as server-owned land. This is useful for spawn, warps, shops, event areas, or anything staff wants protected. ```text /dclaimadmin serverclaim /dclaimadmin serverclaimradius /dclaimadmin serversetspawnclaims /dclaimadmin serverclaims ``` Example: ```text /dclaimadmin serversetspawnclaims 2 ``` That protects a 5x5 chunk area around the world spawn. Server claims do not cost diamonds, do not require upkeep, and do not expire. ## Server bank Diamonds spent on claims and upkeep are tracked in a virtual server bank. ```text /serverbank /serverbank balance /serverbank add /serverbank remove /serverbank set ``` The bank tracks claim income, upkeep income, refunds, and manual admin adjustments. ## BlueMap support BlueMap support is optional. If BlueMap is installed, DiamondClaims can show claim rectangles on the map. Important: do not put the BlueMap API jar in your plugins folder. Only install the real BlueMap plugin if you want map markers. DiamondClaims still works fine without BlueMap. ## Requirements * Paper 1.21.11 * Java 21 or newer * BlueMap optional ## Installation 1. Stop the server. 2. Put `DiamondClaims.jar` in the `plugins` folder. 3. Start the server once to generate config files. 4. Edit `plugins/DiamondClaims/config.yml`. 5. Restart the server or run: ```text /dclaimadmin reload ``` Generated files: ```text plugins/DiamondClaims/config.yml plugins/DiamondClaims/messages.yml plugins/DiamondClaims/claims.yml plugins/DiamondClaims/players.yml plugins/DiamondClaims/bank.yml plugins/DiamondClaims/expired-claims.log ``` ## Permissions ```text diamondclaims.use diamondclaims.claim diamondclaims.unclaim diamondclaims.trust diamondclaims.upkeep diamondclaims.admin diamondclaims.bypass diamondclaims.limit.10 diamondclaims.limit.25 diamondclaims.limit.50 diamondclaims.limit.100 ``` Example LuckPerms setup: ```text lp group default permission set diamondclaims.use true lp group default permission set diamondclaims.claim true lp group default permission set diamondclaims.unclaim true lp group default permission set diamondclaims.trust true lp group default permission set diamondclaims.upkeep true lp group admin permission set diamondclaims.admin true lp group admin permission set diamondclaims.bypass true lp group admin permission set diamondclaims.limit.100 true ``` ## Default gameplay balance The default setup is: * 8 diamonds to claim a chunk * 2 diamonds per chunk per week for upkeep * 3 day grace period before unpaid claims expire * 25 default max claims per player You can change all of this in the config. ## Notes DiamondClaims is meant for survival servers that want land claiming without turning the server into a full economy setup. It keeps the system easy for players to understand: diamonds claim land, diamonds keep land active, and abandoned claims can eventually clear themselves out.