GriefPrevention’s default config offers extended customization for your server. Below is a breakdown of all default variables for your convenience.
:warning: 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.conffile. All migration variables should ALWAYS be used AFTER a backup of your data is made. :warning:
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
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 |
