Getting Started

Getting Started

This page walks through installing GriefPrevention3D and getting it running on a Spigot/Paper/Folia server.

Requirements

• Minecraft: 1.21+ (API level 1.21).
• Server software: Spigot, Paper, or Folia. GP3D supports Folia's regional scheduling.
• Java: 21+ (same as Minecraft 1.21).
• Optional: Vault for /buyclaimblocks and /sellclaimblocks.

Older Minecraft versions are not officially supported. Some older-Minecraft compatibility fixes are carried (e.g., for COPPER_GOLEM_STATUES, CHAINS), but the plugin targets modern server jars.

Installation

1. Drop the built GriefPrevention.jar into your server's plugins/ directory.
2. Start the server once so GriefPrevention3D generates the default config under plugins/GriefPreventionData/.
3. Stop the server, edit config.yml to taste, and restart. Or use /gpreload to pick up config changes without a full restart.

First-Time Setup Checklist

• Decide on claim modes per world. config.yml has GriefPrevention.Claims.WorldModes — common values are Survival, Creative, SurvivalRequiringClaims, and Disabled.
• Decide on the shaped-claims toggle. Shaped polygon claims are off by default. Set GriefPrevention.Claims.AllowShapedClaims: true in config.yml if you want them. See Key Features › Shaped Claims.
• Decide on nested subclaims. GriefPrevention.Claims.AllowNestedSubClaims: true to allow subdivisions inside other subdivisions.
• Decide on visualization style. GriefPrevention.VisualizationGlow: true turns on glowing claim borders (requires 1.19.3+).
• Review the alias file. plugins/GriefPreventionData/alias.yml controls the unified /claim and /aclaim root commands plus standalone aliases. See Key Features › Unified Command Handler.

Claiming Your First Land

Teach players the basics in this order:

1. Chest claim: Place a chest. The plugin auto-creates a small protected claim around it for new players (if AutomaticNewPlayerClaimsRadius > -1).
2. Golden shovel: Right-click two opposite corners of the area to claim. The plugin draws a visual border.
3. Trust someone: /trust <player> while standing inside the claim.
4. Expand a claim: Right-click a corner with the golden shovel, then right-click the new corner.

Once a claim exists, owners can use /claim trust, /claim abandon, /claim explosions, etc. directly, and shift-click boundaries to enter shaped-mode edits if enabled.

Verifying It Works

• /claimslist lists your claims.
• /trustlist while standing in a claim lists permissions there, including inherited permissions from parent claims.
• Admins can /ignoreclaims to temporarily override protections while building infrastructure.

Next Steps

• Read Migration if you are upgrading from upstream GriefPrevention — the behavior differences matter.
• Read Key Features for the detailed feature list.
• Read the Administrator's Guide for day-to-day server operations.