GPExpansion adds powerful features to GriefPrevention including rental signs, claim mailboxes, sell signs, global claims, sign protection, and more — all while maintaining the self-service philosophy.

Mailboxes work with regular GriefPrevention or the GriefPrevention3D fork. With regular GP you use the virtual protocol (no subdivisions). With GP3D you can use real (1x1x1 subdivision + container trust) or virtual; the config option mailbox-protocol defaults based on which GP you have installed.

Supported Platforms
Spigot, Paper, Purpur, and Folia

Requires GriefPrevention and optionally Vault for economy features.

Optionally use GriefPrevention3D for seamless mailboxes (1x1x1 subdivisions and public container trust). With regular GP, set mailbox-protocol: virtual in config for stackable mailboxes without subdivisions.

Features

Rental Signs
Allow claim owners to rent out their claims to other players using signs.

• Set rental prices and durations
• Automatic trust/untrust on rental start/expiry
• Supports Vault economy, experience, claim blocks, and item-based payments
• Interactive setup wizard with /rentclaim

Short Format (place sign inside claim):
OR with max time:
Condensed Format (outside claim):
OR with max time:
Note: maxTime is optional and defaults to renewTime. Hold the item in your offhand for item-based signs.

Sell Signs
Allow claim owners to sell their claims to other players using signs.

• Set claim prices
• Automatic transfer of ownership
• Supports Vault economy, experience, claim blocks, and item-based payments
• Interactive setup wizard with /sellclaim

Short Format (place sign inside claim):
Condensed Format (outside claim):
OR with explicit eco type:
Note: ecoType defaults to money. Hold the item in your offhand for item-based signs.

Claim Mailboxes
Give each claim a mailbox where other players can deposit items.

• Owners have full access to retrieve items
• Non-owners get deposit-only (real protocol) or a virtual snapshot (virtual protocol)
• Storage warnings when mailbox is nearly full
• Purchasable via signs with configurable prices, or instant self mailboxes for owners/renters
• Interactive setup wizard with /mailbox (no claim ID needed — choose self or buyable)

Self Mailbox (instant — place wall sign on container in a claim you own or rent):
Behavior depends on mailbox-protocol: real creates a subdivision and public container trust (GP3D or regular GP 2D); virtual creates no subdivision (works with regular GP, stackable mailboxes). Limit per claim: defaults.max-self-mailboxes-per-claim.

Buyable Mailbox (others pay to get the mailbox):
Example: money;100 or exp;50. Place sign on container in a claim you own. Others click to purchase.

All mailbox signs are wall signs on a container (chest, barrel, hopper, etc.) inside a claim. With real protocol a 1x1 (2D) or 1x1x1 (GP3D) subdivision is created on creation/purchase; with virtual protocol no subdivision is created.

Global Claims

• List claims in a global claim list viewable to all
• Set icon, description, name, spawn point via GUI or commands
• [global] sign (inside claim) or [global] with <id> (admin, outside claim)
• /claim global <true|false> to toggle listing

Sign Protection
Protect your rental and mailbox signs from unauthorized modification.

• Admin-only sign breaking for active rentals
• Automatic cleanup on sign removal

Setup Wizards
Use interactive setup wizards for easier sign creation:

• /rentclaim — Start rental sign setup wizard
• /sellclaim — Start sell sign setup wizard
• /mailbox — Start mailbox setup wizard (choose self or buyable)

The wizard guides you through claim selection (if needed), payment type, price/duration, and optional auto-paste mode.

Claim Management

• /claim name <name> — Set claim name
• /claim desc <description> — Set claim description
• /claim icon <material> — Set claim icon for GUI
• /claim spawn — Set teleport spawn point
• /claim tp [claimId] — Teleport to claim spawn
• /claim ban <player> — Ban players from your claim
• /claim unban <player> — Unban players
• /claim info [id] — View detailed claim information
• /claimlist — List all your claims with IDs
• /mailbox — Manage your mailboxes
• /gpx reload — Reload configuration and language files
• /gpx max <sell|rent|mailbox|self-mailboxes|globals> <add|take|set> <player> <amount> — Manage sign limits

Installation

1. Download the latest release
2. Place GPExpansion.jar in your plugins folder
3. Ensure GriefPrevention is installed
4. (Optional) Install Vault for economy support
5. Restart your server
6. Configure plugins/GPExpansion/config.yml

Configuration

The plugin creates config.yml and lang.yml with sensible defaults.

All messages are customizable in lang.yml. Use /gpx reload to reload without restarting.

Permissions

Sign Creation

Permission	Description
griefprevention.sign.create.rent	Create rental signs
griefprevention.sign.create.rent.anywhere	Create rental signs outside the target claim
griefprevention.sign.create.sell	Create sell signs
griefprevention.sign.create.sell.anywhere	Create sell signs outside the target claim
griefprevention.sign.create.mailbox	Create buyable mailbox signs
griefprevention.sign.create.self-mailbox	Create self mailboxes (wall sign on container)
griefprevention.sign.create.self-mailbox.1	1 self mailbox per claim (etc. .2, .5, .10)

Sign Usage

Permission	Description
griefprevention.sign.use.rent	Use rental signs
griefprevention.sign.use.sell	Use sell signs
griefprevention.sign.use.mailbox	Use mailbox signs

Economy Types

Permission	Description
griefprevention.sign.rent.money	Money for rent signs
griefprevention.sign.rent.exp	Experience for rent signs
griefprevention.sign.rent.claimblocks	Claim blocks for rent signs
griefprevention.sign.rent.item	Item for rent signs
griefprevention.sign.buy.money	Money for sell signs (etc. .exp, .claimblocks, .item)
griefprevention.sign.mailbox.money	Money for mailbox signs (etc. .exp, .claimblocks, .item)

Sign Limits

Permission	Description
griefprevention.sign.limit.rent.<number>	Limit to &lt;number&gt; rental signs
griefprevention.sign.limit.buy.<number>	Limit to &lt;number&gt; sell signs
griefprevention.sign.limit.mailbox.<number>	Limit to &lt;number&gt; mailbox signs
griefprevention.sign.create.self-mailbox.&lt;number&gt;	Limit to &lt;number&gt; self mailboxes per claim

Claim Management

Permission	Description
griefprevention.claim.name	Set claim names
griefprevention.claim.description	Set claim descriptions
griefprevention.claim.icon	Set claim icon
griefprevention.claim.setspawn	Set claim spawn
griefprevention.claim.teleport	Teleport to claims
griefprevention.claim.ban	Ban players from claims
griefprevention.claim.unban	Unban players
griefprevention.claiminfo	View claim info

Admin

Permission	Description
griefprevention.admin	Admin commands and sign management
gpexpansion.admin.reload	Use /gpx reload
gpexpansion.admin.max	Use /gpx max
gpexpansion.admin.debug	Use /gpx debug

Support

• Issue Tracker — Report bugs or problems
• Discussions — Feature requests and questions
• Wiki — Detailed documentation and guides
• Discord — Join our community

Building from Source

The compiled jar will be in target/.