Global Config

GriefPrevention's default config offers extended customization for your server. Below is a breakdown of all default variables for your convenience.

⚠️ Some options can cause irreparable changes to your data. Please ensure that you have read the sub-text found next to the variables in your generated global.conf file. All migration variables should ALWAYS be used AFTER a backup of your data is made. ⚠️

---

Plugin Dependency

Do note, cost variables (such as Towns' creation-cost) require an Economy plugin. Similarly, MCClans is only needed if you plan on using it's integration across plugins. It is not, however, required to use GriefPrevention's Town claims.

Default Claim Flags

All default flags can be customized per claim type. Currently, GriefPrevention supports default flags for Admin, Basic, Town and Wilderness. Please check your global.conf for a list of each default claim-flag setup.

User Claim Flags

The global.conf is also the place where you can list the flags users with griefprevention.user.claim.flag will be able to edit. Note, the permission will be checked under the form of griefprevention.user.flag.[flag]. If you wish to add a new flag to the list, simply follow the format and add it in a new line, and then restart your server (or /gpreload).

For example, adding block-break to the list will translate into griefprevention.user.flag.block-break being checked as true, therefore allowing the player to edit his claim's block-break flag with /cf, /cfg, and /cfp.

Modular Configuration

GriefPrevention allows for modular enabling. As per default configuration files however, all modules are enabled. Disabling a module will render all flags unusable. Only do it if you do not plan on using GriefPrevention's management of said flag. You can choose to disable the following:

• Block-Changes: block-break, block-place
• Collisions: collide-block, collide-entity
• Commands: command-execute, command-execute-pvp
• Movements: enter-claim, exit-claim
• Entity: entity-damage, entity-riding, entity-spawn, entity-teleport-from, entity-teleport-to
• Explosions: explosion, explosion-surface
• Fire-Spread: fire-spread
• Interacts: interact-block-primary, interact-block-secondary, interact-entity-primary, interact-entity-secondary, interact-inventory, interact-inventory-click, interact-item-primary, interact-item-secondary
• Item: item-drop, item-pickup, item-spawn, item-use
• Liquids: liquid-flow
• Portals: portal-use
• Projectiles: projectile-impact-block, projectile-impact-entity

Blacklist

The blacklist controls events from interacting with items, blocks, or entities on either a per-flag or global basis.

It supports wildcards ? and * where ? represents a single character and * represents zero or more characters. For more info you can go to Apache's wildcard matcher.

To add an item into the blacklist simply add the ID between a set of quotation marks.

An example of how to block items from being checked by GP is as shown

block-break=["modID:itemID"]

Claims

Variable	Description	Default Value
accesstrust-commands	The list of slashcommands requiring access trust when in a claim.	NULL
auto-claim-radius	Radius used for auto-created claims.	4
auto-nature-restore	Whether survival claims will be automatically restored to nature when auto-deleted.	FALSE
bank-tax-system	Whether to enable the bank/tax system for claims.	FALSE
bank-transaction-log-limit	Limit of the bank backlog.	60
claims-mode	The mode used when creating claims.	1
cleanup-task-interval	The interval in minutes for restoring blocks in an expired claim.	5
deliver-manuals	Send players manuals on claim creation.	FALSE
investigation-tool	The item used to investigate claims with a right-click.	"minecraft:stick"
modification-tool	The item used to create/resize claims with a right click.	"minecraft:golden_shovel"
tax-apply-hour	The specific hour in day to apply tax to all claims.	12

Economy

Variable	Description	Default Value
claim-block-cost	Cost to purchase a claim block. Set 0 to disable.	0.0
claim-block-sell	Return on a sold claim block. Set 0 to disable.	0.0

General

Variable	Description	Default Value
admin-sign-notifications	Enable sign notifications for admins.	FALSE
admin-whisper-commands	List of whisper commands to eavesdrop on.	NULL
admin-whisper-notifications	Enable whisper notifications for admins.	FALSE
admin-whisper-commands	Whether whispered messages will broadcast to administrators in game.	NULL
admin-whispers	List of whisper commands to eavesdrop on.	FALSE
chat-rules-enabled	Whether chat should be monitored and filtered by rules.	FALSE
limit-pistons-to-claims	Whether pistons are limited to only move blocks located within the piston's land claim.	FALSE
limit-sky-trees	Whether players can build trees on platforms in the sky.	TRUE
limit-tree-growth	Whether trees should be prevented from growing into a claim from outside.	FALSE
limit-sky-trees	Whether players can build trees on platforms in the sky.	TRUE
max-claim-inspection-distance	The max claim inspection block distance.	100
max-players-per-ip	How many players can share an IP address.	3
protect-item-drops-death-non-pvp	Whether players' dropped on death items are protected in non-pvp worlds.	TRUE
smart-ban	Whether to ban accounts which very likely owned by a banned player.	FALSE

Logging

Variable	Description	Default Value
admin-activity	Log admin activity.	FALSE
days-stored	How many days to keep logs in storage.	7
social-activity	Log social activity.	FALSE
suspicious-activity	Log suspicious activity.	FALSE

Message

Variable	Description	Default Value
locale	Set the locale to use for GP messages.	"en_US"

Migrators

Variable	Description	Default Value
classic	Migrates pre 4.0.0 GP claim data to current format.	FALSE
polis	Set to true to enable Polis data migrator.	FALSE
red-protect	Set to true to enable RedProtect data migrator.	FALSE

Player Data

Variable	Description	Default Value
claim-block-system	Determines which claim block system to use for claims.	AREA
migrate-area-rate	The rate to divide each accrued claim blocks total by.	-1
migrate-volume-rate	The rate to multiply each accrued claim blocks total by.	-1
reset-accrued-claim-blocks	Resets all playerdata accrued claim blocks to match total cost of claims owned.	FALSE
reset-migrations	Resets all playerdata migration flags to allow for another migration.	FALSE
use-global-storage	Whether player data should be stored globally.	TRUE

PvP

Variable	Description	Default Value
allow-combat-item-drops	Whether a player can drop items during combat to hide them.	FALSE
combat-timeout	How long combat is considered to continue after the most recent damage.	15
protect-fresh-spawns	Whether to make newly spawned players immune until they pick up an item.	TRUE
protect-item-drops-death	Whether player's dropped on death items are protected in pvp worlds.	FALSE
protect-players-in-adminclaims	Whether players may fight in admin-owned land claims.	FALSE
protect-players-in-claims	Whether players may fight in player-owned land claims.	FALSE
protect-players-in-subdivisions	Whether players may fight in subdivisions of admin-owned land claims.	FALSE
protect-players-in-wilderness	Whether players may fight in wilderness.	FALSE
punish-logout	Whether to kill players who log out during PvP combat.	TRUE
rules-enabled	Whether or not pvp anti-grief rules apply.	TRUE

Spam

Variable	Description	Default Value
allowed-ips	IP addresses which will not be censored.	NULL
autoban-offenders	Whether or not to ban spammers automatically.	FALSE
death-message-cooldown	Cooldown period for death messages (per player) in seconds.	60
enable-spam-monitor	Whether or not to monitor for spam.	TRUE
login-cooldown	How long players must wait between logins. Combats login spam.	60
monitor-commands	The list of slash commands monitored for spam.	NULL

Thread

Variable	Description	Default Value
executor-threads	The number of threads to use for GP's executor.	-1

Town

Variable	Description	Default Value
auto-nature-restore	Whether survival towns will be automatically restored to nature when auto-deleted.	FALSE
clan-require-town	Requires a town to be owned for MCClans.	TRUE
cleanup-task-interval	The interval in minutes for restoring blocks in an expired town.	5
creation-cost	The required amount of funds to create a town.	0.0
extend-into-ground-distance	How far below the shoveled block a new claim will reach.	255
max-depth	Limit on how deep towns can go.	0