GPExpansion

Extend GriefPrevention with rental signs, mailboxes, and more

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

Haven't heard of GriefPrevention 3D Subdivisions? Get it here to enable mailbox support. This is a fork that replaces the GriefPrevention jar.

Supported Platforms

Spigot, Paper, Purpur, and Folia

Requires GriefPrevention and optionally Vault for economy features.

Optionally, replace GriefPrevention with GriefPrevention3D for seamless mailboxes (1x1x1 subdivisions and public container trust). Mailboxes will work with regular GP and there is a config setting called mailbox-protocol: virtual that helps if you want to be able to stack mailboxes on top of each other.

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 command
• Rental Snapshots – Save and restore claim state between renters

[SPOILER=Setting up a rental sign manually][/SPOILER]

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

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

[SPOILER=Setting up a sell sign manually][/SPOILER]

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

• Owners have full access to retrieve items
• Non-owners see a virtual inventory (snapshot at open time)
  • Changes save only when the menu closes
  • Can take back items before closing (reversible deposits)
  • Items returned if mailbox fills up while viewing
• Chest opening sound/animation on sign click
• Storage warnings when mailbox is nearly full
• Purchasable via signs with configurable prices
• Interactive setup wizard with /mailbox command

[SPOILER=Creating a self mailbox][/SPOILER] [SPOILER=Selling a mailbox to other players][/SPOILER] [SPOILER=Sharing a mailbox with other players][/SPOILER]

Self Mailboxes (Instant Creation):

• Owners and renters can place [Mailbox] wall signs directly on containers in claims they own or rent
• Configurable limit via defaults.max-self-mailboxes-per-claim

** Global Claims** Allow claims to be listed in a global claim list, viewable to all.

• Set global settings like icon, description, name, spawn point, and more
• Allows users to teleport to global claims via GUI by default
• Allows [global] claim signs to instantly set spawn and list as global
• Simple /claim global <true|false> command to manage global listing status

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

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

** Rental Restoration Snapshots** Admins with griefprevention.restoresnapshot can save and restore claim block state for rentals. When a rental or eviction ends, the claim can be restored to a saved snapshot so the next renter sees the original build.

• Create – Save the current claim blocks as a snapshot (e.g., before listing for rent)
• List – View snapshots for a claim or for all claims
• Restore – On eviction or rental end, the latest snapshot is applied automatically

Commands:

• /claim snapshot create [claimId] – Create a snapshot
• /claim snapshot list [claimId|all] – List snapshots
• /claim snapshot remove <snapshotId> – Delete a snapshot

** Claim Management & GUIs** Interactive claim management with fully configurable GUIs:

• /claim name <name> - Set claim name (supports color codes with permissions)
• /claim desc <description> - Set claim description (uses same color permissions as name)
• /claim icon <material> - Set claim icon for GUI display
• /claim spawn - Set the teleport spawn point for your claim
• /claim tp [claimId] - Teleport to a claim's spawn point
• /claim flags [claimId] - Open the claim flags GUI (GPFlags)
• /claim options [claimId] - Open the claim options GUI
• /claim ban <player> - Ban players from your claims
• /claim unban <player> - Unban players from your claims
• /claim info [claimId] - View detailed claim information
• /mailbox - Manage your mailboxes
• /gpx reload - Reload configuration and language files
• /gpx max - Manage player sign creation limits

[SPOILER=Claim options GUI management][/SPOILER]

Claim GUI Features:

• Visual claim map editor – Resize, subdivide, and manage claims via interactive GUI
• Customizable layouts, icons, and permissions
• Teleport to claims, view claim info, and manage settings from one interface
• Integration with GPFlags for claim flag management

** Configurable Tax System** Optional tax system for claim maintenance:

• Configurable tax rates per claim block
• Multiple payment methods (money, claim blocks, experience)
• Grace periods before claim deletion
• Tax exemptions via permissions

Documentation

Sign formats, configuration, permissions, and detailed guides All here

Support

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

Building from Source

git clone https://github.com/castledking/GPExpansion.git
cd GPExpansion
mvn clean install

The compiled jar will be in target/.