FAQ

Frequently Asked Questions

General Questions

What is GPExpansion?

GPExpansion is a plugin that extends GriefPrevention with economy and management features including rental signs, mailboxes, sell signs, and global claims.

Do I need GriefPrevention?

Yes, GPExpansion requires GriefPrevention to function. It optionally works with GriefPrevention3D for enhanced features.

Is it compatible with Folia?

Yes, GPExpansion supports Spigot, Paper, Purpur, and Folia 1.20+.

Does it work with regular GriefPrevention (not GP3D)?

Yes, but some features work differently:

• Mailboxes: Use virtual protocol (snapshots) instead of real subdivisions
• 3D Subclaims: Not available
• All other features work normally

Installation

Where do I download it?

Get the latest release from GitHub Releases.

What are the requirements?

• Java 17+
• Minecraft Server 1.20+
• GriefPrevention (latest version)
• Vault (optional, for economy)

It's not loading, what do I check?

1. Check console for error messages
2. Verify GriefPrevention is installed
3. Check Java version (17+ required)
4. Try /plugins - should show GPExpansion in green

Features

What's the difference between virtual and real mailbox protocol?

Feature	Virtual	Real
Works with regular GP	✅	⚠️ Limited
Requires GP3D	❌	✅
Multiple mailboxes per spot	✅	❌
Live container updates	❌	✅
Easier to set up	✅	⚠️

Can I use multiple economy types?

Yes! You can use money (Vault), XP, claim blocks, or items. Configure per-sign or set defaults in config.

Do rental signs work cross-world?

Yes, as long as the sign format includes the claim ID (condensed format), you can place rental signs anywhere.

Can players have multiple rentals?

Yes, players can rent multiple claims simultaneously if they can afford them.

What happens when a rental expires?

1. Player is untrusted from claim
2. If configured, claim restores from snapshot
3. Renter receives notification
4. Sign updates to show availability

Commands

Why does /claim show a GUI instead of help?

GUI mode is enabled by default. To see text help, disable GUI in config, or use a specific subcommand.

How do I use commands on claims I'm not standing in?

Most commands support a [claimId] parameter:

/claim trust Steve 12345
/claim name "New Name" 67890

What's my claim ID?

Run /claim list - the ID is shown next to each claim.

Can I teleport to any claim?

With griefprevention.claim.tp.other permission, yes. Otherwise, only your own claims and global claims.

Permissions

What permission do players need to use mailboxes?

• Self-mailboxes: griefprevention.sign.create.self-mailbox
• Purchasable mailboxes: griefprevention.sign.create.mailbox
• Using mailboxes: griefprevention.mailbox.use

How do I give players more sign limits?

Use the limit permissions:

griefprevention.sign.limit.rent.5
griefprevention.sign.limit.self-mailbox.10

Why can't players use color codes?

They need color permissions:

griefprevention.claim.color.*
griefprevention.claim.format.*

Signs

Why isn't my sign working?

Common issues:

1. Wrong format - check Sign Formats
2. Missing permission for sign type
3. Wrong claim ID (for condensed format)
4. Sign not in valid location

Can I edit a sign after placing it?

Breaking and replacing is the easiest way. Editing in-place requires breaking anyway.

What happens if I break a rental sign with active renters?

• All rentals end immediately
• Renters are untrusted
• Partial refunds may be issued (configurable)
• Admins can break with griefprevention.sign.admin.break

Economy

Do I need Vault?

Only if using money-based payments. XP, claim blocks, and items work without Vault.

Can I use custom items for payment?

Yes, via allow-item-payments per sign type. No per-item-type filter currently exists; all valid Minecraft items are accepted.

Where does rental money go?

To the claim owner's economy account.

What if the buyer doesn't have enough money?

The transaction fails and the buyer gets an error message.

Troubleshooting

Signs aren't activating

1. Check format against Sign Formats
2. Verify permissions with /lp user <player> permission check griefprevention.sign.create.rent
3. Check console for errors
4. Try debug mode: /gpx debug

GUI not opening

1. Verify gui.enabled: true in config
2. Check griefprevention.claim.gui permission
3. Try /gpx reload

Mailboxes not working

1. Check signs.mailbox.protocol setting
2. Verify container type is valid
3. For real protocol, ensure GP3D is installed
4. Check sign is directly on container

Database errors

1. Check file permissions for plugins/GPExpansion/
2. Verify disk space
3. For MySQL, check connection settings

Performance

Is GPExpansion laggy?

No, it's designed for performance:

• Async database operations
• Efficient caching
• Minimal tick impact

Can I use it on large servers?

Yes, GPExpansion is used on servers with 500+ concurrent players.

How much disk space does it use?

Minimal:

• YAML storage: ~1KB per claim
• Snapshots: Depends on claim size
• Typical server: < 100MB

Development

Is there an API?

Yes, GPExpansion provides events and methods for developers. See API documentation (if available).

Can I contribute?

Yes! The project is open source on GitHub. Pull requests welcome.

Where do I report bugs?

GitHub Issues

Support

Where can I get help?

1. This wiki
2. GitHub Discussions
3. Discord (if available)

What info should I provide when reporting issues?

• Server version
• GPExpansion version
• GriefPrevention version
• Error logs
• Steps to reproduce

Is there a donation/support link?

Check the GitHub repository for sponsor links.