Configuration - bloodmc/GriefDefender GitHub Wiki

GriefDefender includes various configuration files for admins. The current available config files are the following

bans.conf
blacklist.conf
claimnames.conf
flags.conf
global.conf
gui.conf
options.conf
storage.conf

The bans.conf file stores all global and world ban data performed by the ban command /claimban.

You will find two sections within this file : global and worlds.
The global section is used to store a list of global banned blocks, entities, and items. The worlds section is used to store a list of world specific banned blocks, entities, and items.

Bans will be stored in format "modid:id"=<message>""
Ex. "minecraft:axolotl_bucket"=""

The following commands can be used to ban a block, entity, or item : /claimban or /gd ban
This command supports the following arguments hand | <type> <target> [worldname] [message]

hand - Uses the item held in main hand. Note: This only works when banning items.
type - The type to ban : block, entity, or item.
<target> - The target id to ban. This is tab complete supported. You can specific a single id or use a tag. Ex. minecraft:tnt , minecraft:enderpearl, #minecraft:signs
[worldname] - A world name can be specified at end of command which will instruct GD to only ban in the world the player is in.
[message] - A ban message can be added to end of command which will be shown to player if interacting with a banned block, entity, or item.

The blacklist controls events from interacting with items, blocks, or entities on either a per-flag or global basis. Blacklists are extremely useful as it allows you to force GD to ignore actions in a world you do not need protected. By doing this, you prevent GD from wasting resources when it attempts to protect. To determine what you want to prevent GD from controlling, you will need to run a GDDebug in order to gather the data needed for the config. See User Contributions for some examples on how to use it.

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 GD is as shown

block-break=["modID:itemID"]

See Claim Identifiers

The claimnames.conf file is used to store a mapping of player UUID to friendly claim names.

e035f345-1234-5678-b341-cb1c91fe2123 {
    store_front=e5da3742-c916-48a0-b2af-283092fd6ef8
    valhalla=bdc6ca20-f62a-4c8a-a549-ec903fd63772
}

The above example shows player with UUID e035f345-1234-5678-b341-cb1c91fe2123.
The player has configured 2 friendly claim identifiers.
The first claim identifier is store_front which is mapped to claim UUID e5da3742-c916-48a0-b2af-283092fd6ef8
The second claim identifier is valhalla which is mapped to claim UUID bdc6ca20-f62a-4c8a-a549-ec903fd63772

There are 2 built-in UUID's that GriefDefender uses for friendly identifiers.

00000000-0000-0000-0000-000000000000 - This UUID represents the world user and is used to set friendly identifiers in wilderness claims.
11111111-1111-1111-1111-111111111111 - This UUID represents the admin user and is used to set friendly identifiers in admin claims.

The flags.conf file is not to be confused with flag definitions and/or presets. This file controls all core flags that GD uses in events.

The first section in this file is default-claim-flags which is responsible for setting default transient flag permissions. Transient permissions only exist in memory and do not persist. These permissions are designed as fallback permissions when there is no permission found for a LP user or group.

There are 2 configured types in this file

user - This configures default transient flag permissions for all claims EXCEPT wilderness.
wilderness - This confingures default transient flag permissions for all wilderness claims.

The flag control section lets you enable/disable flag functionality on a per-flag basis. By default, all flags are enabled. If you have no use for a specific flag, set the flag to false in this section. By disabling a flag, this will cause GriefDefender to ignore all events related to the flag.

# Controls which flags are enabled.
# Note: Disabling a flag will cause GD to bypass all functionality for it.
# Note: If you want full protection, it is recommended to keep everything enabled.
flag-control {
    block-break=true
    block-grow=true
    block-modify=true
    block-place=true
    block-spread=true
    collide-block=true
    collide-entity=true
    command-execute=true
    command-execute-pvp=true
    enter-claim=true
    entity-chunk-spawn=true
    entity-damage=true
    entity-riding=true
    entity-spawn=true
    entity-teleport-from=true
    entity-teleport-to=true
    exit-claim=true
    explosion-block=true
    explosion-entity=true
    interact-block-primary=true
    interact-block-secondary=true
    interact-entity-primary=true
    interact-entity-secondary=true
    interact-inventory=true
    interact-inventory-click=true
    interact-item-primary=true
    interact-item-secondary=true
    inventory-item-move=true
    item-drop=true
    item-pickup=true
    item-spawn=true
    item-use=true
    leaf-decay=true
    liquid-flow=true
    portal-use=true
    projectile-impact-block=true
    projectile-impact-entity=true
}

See Global Config

The gui.conf file is responsible for all settings related to Chat and Inventory GUI.

capture-clear-timeout - The timeout in seconds when chat GUI will clear all captured chat.
capture-idle-timeout - The idle timeout in seconds when chat GUI will stop capturing chat.
protocol-lib - Whether to use ProtocolLib, if detected, to capture all messages directed toward a player.

command-input-idle-timeout - The idle timeout in seconds when a command GUI will stop waiting for player input.

The inventory section controls what icons and titles will be used when loading the GD inventory GUI for players.

enchanted - Controls if the icon will have an enchanted effect.
id - The icon item id. Ex. minecraft:diamond_shovel
title - The icon title to display on hover.
lore - The icon lore.
quantity - The item quantity amount.
meta - The item identifier associated with icon.
Note: Meta is used instead of a material identifier when needed to be compatible across MC versions or for modded items that do not have an associated name identifier.

icon-flags
Icon flags are a special attribute of an icon and are stored as such

icon-flags=[
    "hide_attributes"
]

The following icon flags are available to use with an icon

HIDE_ENCHANTS - Controls whether to show enchants.
HIDE_ATTRIBUTES - Controls whether to show attributes.
HIDE_UNBREAKABLE - Controls whether to show the unbreakable state.
HIDE_DESTROYS - Controls whether to show what can break or destroy.
HIDE_PLACED_ON - Controls whether to show what can be built or placed on.
HIDE_POTION_EFFECTS - Controls whether to show potion effects.
HIDE_DYE - Controls whether to show dyes.

The options.conf file controls all default claim and player settings.

default-user-basic-options - Controls min/max claim size limits for basic claims.
The default min basic limit is 5x5x5.
Note: Y is not used unless claim is a 3D claim.
Note: A value of 0 means no limit.

default-user-subdivision-options - Controls min/max claim size limits for subdivision claims.
The default min subdivision limit is 5x5x5.
The default max subdivision limit is 1000x0x1000 where 0 represents no limit in height.
Note: Y is not used unless claim is a 3D claim.
Note: A value of 0 means no limit.

default-user-town-options - Controls min/max claim size limits for basic claims.
The default town limit is 32x32x32.
Note: Y is not used unless claim is a 3D claim.
Note: A value of 0 means no limit.

default-user-options - Controls default player options such as player-deny-flight in claims.
Note: Applying an option to a specific claim type section as shown above will override the option in this section.

The option control section lets you enable/disable option functionality. By default, all player/pvp and spawn options are disabled. To enable this functionality, you will need to set the corresponding option to true.

Here are the delivered options that can be controlled

option-control {
    player-command-enter=false
    player-command-exit=false
    player-deny-flight=false
    player-deny-godmode=false
    player-deny-hunger=false
    player-fly-speed=false
    player-gamemode=false
    player-health-regen=false
    player-keep-inventory=false
    player-keep-level=false
    player-teleport-cost=false
    player-teleport-delay=false
    player-walk-speed=false
    player-weather=false
    pvp=false
    pvp-combat-command=false
    pvp-combat-teleport=false
    pvp-combat-timeout=false
    pvp-item-drop-lock=false
    raid=false
    spawn-limit=false
}

This section is currently only used for player fly and walk default speeds. If your server uses a different default value, you can adjust it here.

The delivered defaults are

vanilla-fallback-values {
    player-fly-speed="0.1"
    player-walk-speed="0.2"
}

The storage.conf file controls GriefDefender storage settings.