FAQ

Common questions about the GriefPrevention Premium Addon.

Do I need a license key?

Yes. Paste the key you received with your purchase into license-key in market-config.yml and restart. The add-on verifies it on startup and won’t enable without a valid key. If the key is missing or rejected, the console prints a clear message telling you what to fix.

Do I need a special / patched GriefPrevention?

No. Install the stock, unmodified GriefPrevention3D from its official release. The add-on attaches through the public API and events only — a patched core isn’t needed and can cause errors.

What do I need for the claim market?

Vault plus an economy plugin. The market moves real currency when a claim is bought, so an economy is required for buying/selling (the rest of the add-on works without one).

Does it run on Folia / Canvas?

Yes — it was written from scratch for Folia’s regionised threading (disk/DB work is async, state is keyed by UUID). It also runs on Paper, Purpur and Pufferfish, MC 1.2026.2.

Will inactivity auto-delete nuke my players’ claims?

Only owners who haven’t logged in for inactivity.threshold-days are affected, and an owner with no recorded login is never deleted. You can disable it entirely with inactivity.enabled: false.

Can players keep using a claim while it’s for sale?

By default no — a listed claim is locked (no building, containers, trust changes, resize or delete) until it’s sold or unlisted. Set sale.lock-enabled: false in market-config.yml if you want listed claims to stay fully usable; buying stays atomic and safe either way.

Can buyers visit a claim before buying it?

Yes — open the claim from Claims for Sale and left-click the Teleport button on its detail screen. It uses the same countdown warp as own-claim teleport and follows the teleport.enabled setting.

How do buyers find a specific claim for sale?

Sellers can name their listing (an optional second sign prompt after the price). Buyers then search it with /claim search <name>, /marketclaims <name> or /listedclaims <name> — the match is case-insensitive and also covers seller names. Unnamed listings still appear in the normal browser.

Can a trustee get more power than I gave them?

No. The per-trustee toggles can only restrict what GriefPrevention’s trust already allows — they never elevate a player above their trust tier.

Someone’s base was deleted and instantly re-claimed

That’s what the anti-snipe lockout prevents — deleted land stays locked for claim-lockout.seconds (default 45 min). Staff can bypass with griefprevention.claimlockoutbypass.

How do I translate it?

Edit market-messages.yml — every player-facing string is there, with & and &#rrggbb colour codes.

Is WorldGuard required?

No, it’s optional. Enable the hook to stop players claiming on land that overlaps a WorldGuard region.