GriefPrevention3D

Introduction

GriefPrevention3D is a comprehensive grief prevention plugin for Minecraft servers. It allows players to protect their builds by creating 3D claims, managing trust levels, and more. This plugin is inspired by the original GriefPrevention plugin but with the added dimension of 3D claims.

Features

• 3D Claims: Create cuboid claims to protect your builds in all three dimensions.
• Claim Resizing: Easily resize your claims by right-clicking the corner markers with a golden shovel.
• Claim Block System: Earn claim blocks over time to expand your protected area.
• Trust System: Grant different levels of permission to other players in your claims.
• Subclaims: Divide your claims into smaller, manageable sub-areas.
• Advanced Protection: Protects against explosions, pistons, and fluid flow.
• FAWE Integration: Save and load claims as schematics using FastAsyncWorldEdit.
• Configurable: Customize the plugin to your server's needs through the config.yml file.

Installation

1. Place the GriefPrevention3D.jar file in your server's plugins directory.
2. Install the latest version of FastAsyncWorldEdit.
3. Restart your server.

Resizing Claims

To resize a claim, hold a golden shovel. You will see the corners of your claims marked with gold blocks. Right-click one of the corner blocks to select it for resizing. Then, right-click a new location to move the corner. The plugin will automatically calculate the new claim volume and check if you have enough claim blocks.

Commands

Command	Description
/claim create	Creates a new claim.
/claim abandon	Deletes the claim you are standing in.
/claim trust <player> <level>	Trusts a player in your claim.
/claim untrust <player>	Untrusts a player in your claim.
/claim subdivide	Toggles subdivide mode.
/claim blocks	Shows your claim block balance.
/claim giveblocks <player> <amount>	Gives claim blocks to a player. (Admin only)
/claim saveall	Saves all claims to schematics and deletes old, unused schematic files. (Admin only)
/claim loadall	Loads all claims from schematics. (Admin only)
/claim abandonall	Abandons all of the player's claims.

Permissions

Permission	Description	Default
griefprevention3d.claim.create	Allows players to create claims.	true
griefprevention3d.claim.abandon	Allows players to abandon their claims.	true
griefprevention3d.claim.abandonall	Allows players to abandon all their claims.	true
griefprevention3d.claim.trust	Allows players to trust other players.	true
griefprevention3d.claim.untrust	Allows players to untrust other players.	true
griefprevention3d.claim.subdivide	Allows players to subdivide their claims.	true
griefprevention3d.claim.blocks	Allows players to check their claim block balance.	true
griefprevention3d.visualize	Allows players to visualize claims with a stick.	true
griefprevention3d.admin.giveblocks	Allows admins to give claim blocks.	op
griefprevention3d.admin.saveall	Allows admins to save all claims.	op
griefprevention3d.admin.loadall	Allows admins to load all claims.	op
griefprevention3d.admin.bypass	Allows players to bypass claim protections.	op
griefprevention3d.max-accrued-claim-blocks.<tier_name>	Sets a player's maximum claim blocks based on a configured tier.	false

Configuration

The config.yml file allows you to customize various aspects of the plugin.

claim-block-accrual:
  amount: 500
  max-limit: 10000

new-player-claim-blocks: 1000

visualization:
  particle: "FLAME"

messages:
  no-permission-break: "&cYou do not have permission to break blocks in this claim."
  no-permission-place: "&cYou do not have permission to place blocks in this claim."
  no-permission-interact: "&cYou do not have permission to interact with blocks in this claim."

max-claim-blocks-by-permission:
  default: 10000
  griefprevention3d.max-accrued-claim-blocks.tier1: 20000
  griefprevention3d.max-accrued-claim-blocks.tier2: 50000

• claim-block-accrual.amount: The number of claim blocks players receive every hour.
• claim-block-accrual.max-limit: The default maximum number of claim blocks a player can have if no specific permission is found.
• new-player-claim-blocks: The number of claim blocks a new player starts with.
• visualization.particle: The particle effect used to visualize claim boundaries.
• messages: Customizable messages for various plugin actions.
• max-claim-blocks-by-permission: This section defines different maximum claim block limits based on permissions. The plugin will check if a player has any of the permissions listed here (e.g., griefprevention3d.max-accrued-claim-blocks.tier1) and apply the highest corresponding limit. If no specific permission is found, the default value will be used.