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.
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.
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
/rentclaimcommand - Rental Snapshots – Save and restore claim state between renters
Setting up a rental sign manually
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
/sellclaimcommand
Setting up a sell sign manually
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
/mailboxcommand
Creating a self mailbox
Selling a mailbox to other players
Sharing a mailbox with other players
- 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
| Protocol Type | Subdivision Created | Non-Owner View | Live Updates | Stackable |
|---|---|---|---|---|
| Real Protocol | 1x1x1 (GP3D) or 1x1 2D (regular GP) | Real chest with public container trust | Yes | No |
| Virtual Protocol | None | Virtual snapshot inventory | No (snapshot at open time) | Yes |
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
Protect your rental and mailbox signs from unauthorized modification.
- Admin-only sign breaking for active rentals
- Automatic cleanup on sign removal
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
/claim snapshot create [claimId]– Create a snapshot/claim snapshot list [claimId|all]– List snapshots/claim snapshot remove <snapshotId>– Delete a snapshot
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
- 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
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
Permission-based claim block accrual profiles for different player groups:
- Configurable blocks per hour, maximum accrued blocks, and maximum claim limits
- Profiles match by Vault/LuckPerms group or custom permission nodes (
griefprevention.accruals.<group>) - Per-player overrides for fine-grained control
- Automatic application on login and claim creation
Example configuration:
accruals:
groups:
- name: default
blocks-per-hour: 100
max-blocks: 80000
max-claims: 0 # disabled
- name: vip
blocks-per-hour: 20
max-blocks: 250000
max-claims: 10Admin commands:
/gpx accruals check [player]– View effective limits for a player/gpx accruals group <group> set|add|remove <per-hour|max-blocks|max-claims|all> <amount>– Edit group settings/gpx accruals player <name> set|add|remove|reset <per-hour|max-blocks|max-claims|all> [amount]– Manage player overrides/gpx accruals creategroup <name> [blocks-per-hour] [max-blocks] [max-claims] [permission]– Create new group/gpx accruals deletegroup <name>– Delete a group
Sign formats, configuration, permissions, and detailed guides All here
- Issue Tracker - Report bugs or problems
- Discussions - Feature requests and questions
- Wiki - Detailed documentation and guides
- Discord - Join our community
git clone https://github.com/castledking/GPExpansion.git
cd GPExpansion
mvn clean install
The compiled jar will be in target/.