GriefDefender

https://docs.griefdefender.com/
Admin
GriefDefender is a versatile protection plugin designed for Minecraft servers running Bukkit,...
Tokens:24,208
Snippets:291
Trust Score:5.7
Update:3 months ago
Show doc for...
Tokens:
Raw
### Claimnames Mapping Example

Source: https://docs.griefdefender.com/wiki/Configuration

Example structure of the claimnames.yml file mapping player UUIDs to friendly claim identifiers.

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

--------------------------------

### Blacklist Configuration Example

Source: https://docs.griefdefender.com/wiki/Configuration

Syntax for adding items to the blacklist to prevent GriefDefender from checking them.

```text
block-break=["modID:itemID"]
```

--------------------------------

### Ban Format Example

Source: https://docs.griefdefender.com/wiki/Configuration

The syntax for defining banned items in the bans.yml file.

```text
"minecraft:axolotl_bucket"=""
```

--------------------------------

### Configure enter-claim flag for monsters

Source: https://docs.griefdefender.com/wiki/advanced/Flags

Examples of using the #monster context group to restrict monster entry into admin claims.

```text
/cf enter-claim #monster false default=admin
```

```text
/cf enter-claim false default=admin target=#monster
```

--------------------------------

### Configure Global Optimization Settings

Source: https://docs.griefdefender.com/wiki/advanced/Optimizations

Settings for tuning performance in global.yml. Use caution with async settings and cache expiration times to avoid unintended behavior.

```yaml
    optimization {
    # Whether to process player claim tool actions async for performance. (Default: true)
    # Note: If you encounter any async thread issues, disable this setting.
    async-claim-tool-actions=true
    # Whether to process player claim visuals async for performance. (Default: true)
    # Note: If you encounter any async thread issues, disable this setting.
    async-player-claim-visuals=true
    # Controls whether to ignore item drops from block sources.
    # Note: This is only triggered when a player breaks a block.
    block-item-drops=true
    # Controls the amount of time, in seconds, for the permission cache of all entity damage actions in world. If the cache is accessed before expiration then the time is reset.
    # Note: Setting this too high may result in wrong entity damage permission results.
    cache-entity-damage-expiration=5
    # Controls the amount of time, in seconds, for the permission lookup cache of all actions in world. If the cache is accessed before expiration then the time is reset.
    # Note: This cache will occur after special caches such as entity damage, explosions, and physics.
    # Note: Setting this too high may result in players not seeing proper results with their actions.
    cache-permission-lookup-expiration=3
    # Controls the amount of time, in seconds, for the permission cache of all block physic changes in world.
    # Note: Blocks such as redstone will usually cache longer due to the repeated calls made.
    # Note: Setting this too high may result in players not being tracked properly during block changes.
    cache-physics-tracking-expiration=5
    # Controls whether dispener item spawns are ignored.
    dispenser-item-spawns=true
    # Controls whether entity damage events that contain both a source/target living passive entity, such as two animals fighting, are ignored.
    entity-damage-living-passive=true
    # Controls whether entity damage events that contain both a source/target monster are ignored.
    entity-damage-monster=true
    # Controls whether entity damage events that contain a monster and other entity, except players, are ignored.
    entity-damage-monster-other=true
    # Controls whether entity damage source or block that target a living passive are ignored.
    entity-damage-source-living-passive=true
    # Controls whether entity damage source or block that target a monster are ignored.
    entity-damage-source-monster=true
    # Controls whether an entity interacting with a block is ignored.
    entity-interact-block=true
    # Controls whether entity item pickups made by non-players are ignored.
    entity-item-pickup-non-player=true
    # Controls whether non-player falls are ignored.
    fall-non-player=true
    # Controls whether monster attacks against a player are ignored.
    # Note: This does not include explosion damage.
    # Note: If you need to prevent damage from monsters in claims then this should remain false.
    monster-player-damage=false
    # Controls whether player attacks against a monster are ignored.
    # Note: This does not include explosion damage.
    player-monster-damage=true
    # Controls whether ambient spawns, such as bats, are ignored in wilderness.
    # Note: If you want to control aquatic spawns in wilderness, set this to false.
    wilderness-ambient-spawns=true
    # Controls whether animal spawns, such as pigs, are ignored in wilderness.
    # Note: If you want to control animal spawns in wilderness, set this to false.
    wilderness-animal-spawns=true
    # Controls whether aquatic spawns, such as squids, are ignored in wilderness.
    # Note: If you want to control aquatic spawns in wilderness, set this to false.
    wilderness-aquatic-spawns=true
    # Controls whether liquid flow is ignored in wilderness.
    # Note: If you want to control liquid flow in wilderness, set this to false.
    wilderness-liquid-flow=true
    # Controls whether monster spawns, such as creepers, are ignored in wilderness.
    # Note: If you want to control monster spawns in wilderness, set this to false.
    wilderness-monster-spawns=true
    # Controls whether experience orbs are ignored when dropped.
    xp-orb-drop=true
    }
```

--------------------------------

### Configure entity-damage flag for starters group

Source: https://docs.griefdefender.com/wiki/advanced/Flags

Demonstrates disabling animal damage in basic claims for the starters group using both GriefDefender and LuckPerms commands.

```text
/cfg starters entity-damage #animal false default=basic
```

```text
/lp group starters permission set griefdefender.flag.entity-damage false gd_claim_default=basic target=#animal
```

--------------------------------

### Import Notepad++ HOCON Syntax Highlighting

Source: https://docs.griefdefender.com/wiki

Use this XML structure to define HOCON syntax highlighting in Notepad++.

```xml
<NotepadPlus>
  <UserLang name="Hocon" ext="conf" udlVersion="2.1">
    <!-- XML trimmed for brevity -->
  </UserLang>
</NotepadPlus>
```

--------------------------------

### Configure Option Control Settings

Source: https://docs.griefdefender.com/wiki/Configuration

Enables or disables specific player, pvp, and spawn functionality by setting values to true or false.

```yaml
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
}
```

--------------------------------

### View GriefDefender configuration directory structure

Source: https://docs.griefdefender.com/wiki

Displays the standard file layout for the GriefDefender configuration directory.

```text
plugins/
└── GriefDefender/
    ├── bans.yml
    ├── blacklist.yml
    ├── claimnames.yml
    ├── config_format.txt
    ├── flags.yml
    ├── global.yml
    ├── gui.yml
    ├── options.yml
    ├── storage.yml
    └── tag.yml
```

--------------------------------

### Grant Inventory GUI Permission

Source: https://docs.griefdefender.com/wiki

Permission node to enable the inventory-based GUI for players.

```text
griefdefender.login.inventory-gui
```

--------------------------------

### Add GriefDefender API Dependency (Gradle)

Source: https://docs.griefdefender.com/API

Include the API dependency and the repository URL in your build.gradle file.

```groovy
compileOnly group: 'com.griefdefender', name: 'api', version: '2.1.0-SNAPSHOT'
```

```groovy
maven 
{
    name = 'griefdefender'
    url = 'https://repo.glaremasters.me/repository/bloodshot'
}
```

--------------------------------

### Configure Option Control Settings

Source: https://docs.griefdefender.com/wiki/advanced/Optimizations

Manages player-specific options such as flight, godmode, and PvP combat settings.

```hocon
    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-item-drop-lock=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
    }
```

--------------------------------

### Access Blacklist Configuration

Source: https://docs.griefdefender.com/wiki

Reference to the blacklist configuration file.

```text
blacklist.yml
```

--------------------------------

### Add GriefDefender API Dependency (Maven)

Source: https://docs.griefdefender.com/API

Include the dependency and repository configuration in your pom.xml file.

```xml
<dependency>
    <groupId>com.griefdefender</groupId>
    <artifactId>api</artifactId>
    <version>2.1.0-SNAPSHOT</version>
    <scope>provided</scope>
</dependency>
```

```xml
<repository>
    <id>griefdefender</id>
    <url>https://repo.glaremasters.me/repository/bloodshot</url>
</repository>
```

--------------------------------

### View GriefDefender File Structure

Source: https://docs.griefdefender.com/wiki

The default file-based storage layout for GriefDefender configuration and data.

```text
config/
└── GriefDefender/
    ├── claimgroups/
    ├── GlobalPlayerData/
    ├── lang/
    ├── presets/
    ├── snapshots/
    ├── worlds/
    ├── *.yml
```

--------------------------------

### Define Vanilla Fallback Values

Source: https://docs.griefdefender.com/wiki/Configuration

Adjusts default server speeds for flying and walking if the standard defaults are not suitable.

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

--------------------------------

### List of GriefDefender Configuration Files

Source: https://docs.griefdefender.com/wiki/Configuration

The set of YAML files used to manage different aspects of the GriefDefender plugin.

```text
bans.yml
blacklist.yml
claimnames.yml
config_format.txt
flags.yml
global.yml
gui.yml
options.yml
storage.yml
tag.yml
```

--------------------------------

### Configure GriefDefender Option Controls

Source: https://docs.griefdefender.com/wiki/advanced/Optimizations

Toggles specific player-related options and permissions within claims.

```hocon
    option-control {
        player-command-enter=false
        player-command-exit=false
        player-deny-flight=false
        player-deny-glide=false
        player-deny-godmode=false
        player-deny-hunger=false
        player-fly-speed=false
        player-gamemode=false
        player-health-regen=false
        player-item-drop-lock=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
    }
```

--------------------------------

### Select Admin Claim Permissions via SQL

Source: https://docs.griefdefender.com/wiki/Permissions

Retrieves all admin claim permissions from the LuckPerms database by joining with GriefDefender claim data.

```sql
SELECT A.* FROM minecraft.luckperms_group_permissions A, griefdefender.gd_claim_data B WHERE A.contexts LIKE CONCAT('%', BIN_TO_UUID(B.claim_uuid), '%') AND B.claim_type = 'admin'
UNION
SELECT * FROM minecraft.luckperms_group_permissions WHERE contexts LIKE CONCAT('%gd_claim_default":"admin"%')
```

--------------------------------

### Interaction Inventory Configuration

Source: https://docs.griefdefender.com/mods/Pixelmon

Defines blocks that trigger inventory interactions.

```text
interact-inventory=[
			"pixelmon:end_table",
			"pixelmon:fridge"
		]
```

--------------------------------

### PixelMon Configuration Block

Source: https://docs.griefdefender.com/mods/Pixelmon

Defines lists of PixelMon items for event handling and optimization settings.

```hocon
			"pixelmon:orange_cushion_chair",
			"pixelmon:purple_cushion_chair",
	# armchair
			"pixelmon:red_armchair",
			"pixelmon:yellow_armchair",
			"pixelmon:green_armchair",
			"pixelmon:pink_armchair",
			"pixelmon:blue_armchair",
			"pixelmon:black_armchair",
			"pixelmon:gray_armchair",
			"pixelmon:cyan_armchair",
			"pixelmon:white_armchair",
			"pixelmon:brown_armchair",
			"pixelmon:orange_armchair",
			"pixelmon:purple_armchair",
	# couch
			"pixelmon:red_couch",
			"pixelmon:yellow_couch",
			"pixelmon:green_couch",
			"pixelmon:pink_couch",
			"pixelmon:blue_couch",
			"pixelmon:black_couch",
			"pixelmon:gray_couch",
			"pixelmon:cyan_couch",
			"pixelmon:white_couch",
			"pixelmon:brown_couch",
			"pixelmon:orange_couch",
			"pixelmon:purple_couch",
	# folding
			"pixelmon:red_folding_chair",
			"pixelmon:yellow_folding_chair",
			"pixelmon:green_folding_chair",
			"pixelmon:pink_folding_chair",
			"pixelmon:blue_folding_chair",
			"pixelmon:black_folding_chair",
			"pixelmon:gray_folding_chair",
			"pixelmon:cyan_folding_chair",
			"pixelmon:white_folding_chair",
			"pixelmon:brown_folding_chair",
			"pixelmon:orange_folding_chair",
			"pixelmon:purple_folding_chair",
	# Healer
			"pixelmon:healer",
			"pixelmon:orange_healer",
			"pixelmon:magenta_healer",
			"pixelmon:light_blue_healer",
			"pixelmon:yellow_healer",
			"pixelmon:lime_healer",
			"pixelmon:pink_healer",
			"pixelmon:gray_healer",
			"pixelmon:light_gray_healer",
			"pixelmon:cyan_healer",
			"pixelmon:purple_healer",
			"pixelmon:blue_healer",
			"pixelmon:brown_healer",
			"pixelmon:green_healer",
			"pixelmon:red_healer",
			"pixelmon:black_healer",
	# Fridge
			#"pixelmon:fridge",
	# End_table
			#"pixelmon:end_table",
			"pixelmon:pixelmon_grass"
		]
        inventory-item-move=[]
        item-damage=[]
        item-drop=[]
        item-pickup=[]
        item-spawn=[]
        item-use=[]
        leaf-decay=[]
        liquid-flow=[]
        portal-use=[]
        projectile-impact-block=[
			"pixelmon:occupied_pokeball",
			"pixelmon:empty_pokeball"
		]
        projectile-impact-entity=[
            "pixelmon:occupied_pokeball",
			"pixelmon:empty_pokeball"
        ]
    }
    global-source=[]
    global-target=[]
}
```

--------------------------------

### Select User Claim Permissions via SQL

Source: https://docs.griefdefender.com/wiki/Permissions

Retrieves all non-admin user claim permissions from the LuckPerms database.

```sql
SELECT A.* FROM minecraft.luckperms_group_permissions A, griefdefender.gd_claim_data B WHERE A.contexts LIKE CONCAT('%', BIN_TO_UUID(B.claim_uuid), '%') AND B.claim_type <> 'admin'
UNION
SELECT * FROM minecraft.luckperms_group_permissions WHERE contexts LIKE CONCAT('%gd_claim_default":"basic"%') OR contexts LIKE CONCAT('%gd_claim_default":"user"%')
```

--------------------------------

### Disable Economy Confirmation Prompts

Source: https://docs.griefdefender.com/wiki

Permission node to bypass confirmation prompts when creating claims in economy mode.

```text
griefdefender.user.claim.economy.create-confirm
```

--------------------------------

### List FIT Known Issues

Source: https://docs.griefdefender.com/wiki/advanced/Optimizations

A list of currently identified issues and limitations within the FITFC optimization implementation.

```text
- Do not block teleportation caused by plugins
- big_dripleaf moves when a player interacts with it
- Does not disable vine/grass/crop growth
- Is it possible to get fruits from sweet_berry
- Other problems are being cataloged
```

--------------------------------

### Configure FIT Option Control

Source: https://docs.griefdefender.com/wiki/advanced/Optimizations

Defines the option-control block settings to manage player-specific behaviors and PvP rules.

```hocon
    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-item-drop-lock=false
        player-keep-inventory=false
        player-keep-level=false
        player-teleport-cost=false
        player-teleport-delay=false
        player-walk-speed=false
        player-weather=true
        pvp=true
        pvp-combat-command=false
        pvp-combat-teleport=false
        pvp-combat-timeout=false
        pvp-item-drop-lock=false
        raid=true
        spawn-limit=false
    }
```

--------------------------------

### GriefDefender Optimization Configuration

Source: https://docs.griefdefender.com/wiki/advanced/Optimizations

Configuration block for managing entity and block event filters. Modify these lists to control spawn, interaction, and movement behaviors within claims.

```hocon
            "minecraft:furnace_minecart",
            "minecraft:tnt_minecart"
        ]
        entity-chunk-spawn=[]
        entity-damage=[
            "minecraft:fire",
            "minecraft:lava",
            "minecraft:fall",
            "minecraft:freeze"
        ]
        entity-riding=[
    # Horses by default already have mount protection.
            "minecraft:horse",
        ]
        entity-spawn=[
    # minecraft:armor_stand Some plugins like Hologram/Damage Indicators plugins generate these entities, which end up generating lag in GD because there are too many events to check, if you use it, comment.
            "minecraft:armor_stand",
    # comment out all peaceful animals to control their spawn in /cf
            "minecraft:axolotl",
            "minecraft:bat",
            "minecraft:squid",
            "minecraft:pig",
            "minecraft:cow",
            "minecraft:sheep",
            "minecraft:egg",
            "minecraft:chicken",
            "minecraft:rabbit",
            "minecraft:bee",
            "minecraft:cat",
            "minecraft:fox",
            "minecraft:horse",
    # comment out all aquatic animals to control their spawn in /cf
            "minecraft:cod",
            "minecraft:dolphin",
            "minecraft:firework_rocket",
            "minecraft:fireworks",
            "minecraft:turtle",
            "minecraft:glow_squid",
            "minecraft:tropical_fish",
            "#minecraft:fishes",
            "#minecraft:ambient",
            "minecraft:fishing_bobber",
            "minecraft:salmon",
            "minecraft:snowball",
            "minecraft:trident",
            "minecraft:xp_orb",
    # comment if you want to control phantom spawn in claims.
            "minecraft:phantom",
            "minecraft:sniffer",
            "spawnreason:village_defense"
        ]
        entity-teleport-from=[
    # If you use any teleport plugins that are giving you problems like elevator plugins, enable this.
            #"minecraft:plugin"
        ]
        entity-teleport-to=[
    # If you use any teleport plugins that are giving you problems like elevator plugins, enable this.
            #"minecraft:plugin"
        ]
        exit-claim=[
            "#minecraft:monster",
            "minecraft:minecart",
            "minecraft:hopper_minecart",
            "minecraft:chest_minecart",
            "minecraft:furnace_minecart",
            "minecraft:tnt_minecart"
        ]
        explosion-block=[]
        explosion-entity=[]
        interact-block-primary=[]
    # Avoid adding anything in interact-block-secondary as it creates vulnerabilities in the protection.
        interact-block-secondary=[]
        interact-entity-primary=[]
        interact-entity-secondary=[
            "minecraft:falling_block"
        ]
        interact-inventory=[
    # This makes the inventory of these blocks public, comment if you want to control.
            "minecraft:crafting_table",
            "minecraft:stonecutter",
            "minecraft:grindstone",
            "minecraft:smithing_table",
            "minecraft:cartography_table",
            "minecraft:loom",
            "minecraft:ender_chest",
            "minecraft:enchanting_table"
        ]
        interact-inventory-click=[
    # This makes the inventory of these blocks public, comment if you want to control.
            "minecraft:crafting",
            "minecraft:crafting_table",
            "minecraft:stonecutter",
            "minecraft:grindstone",
            "minecraft:smithing_table",
            "minecraft:cartography_table",
            "minecraft:loom",
            "minecraft:ender_chest",
            "minecraft:enchanting_table"
        ]
        interact-item-primary=[]
        interact-item-secondary=[
            "minecraft:ender_pearl",
            "minecraft:firework_rocket",
            "minecraft:#food",
            "minecraft:spyglass",
            "#food"
        ]
        inventory-item-move=[]
        item-drop=[]
        item-pickup=[]
        item-spawn=[]
        item-use=[
            "minecraft:#food",
            "minecraft:any",
            "#any",
            "minecraft:player",
            "#food"
        ]
        leaf-decay=[]
        liquid-flow=[]
        portal-use=[]
        projectile-impact-block=[]
        projectile-impact-entity=[
            "minecraft:ender_pearl"
        ]
    }
    # A global list of source id's that are ignored by events. 
    # Note: This only affects events where the id specified is the source.
    global-source=[]
    # A global list of target id's that are ignored by events. 
    # Note: This only affects events where the id specified is the target.
    global-target=[]
```

--------------------------------

### Configure GriefDefender Blacklist for Performance

Source: https://docs.griefdefender.com/wiki/advanced/Optimizations

Use this configuration to ignore specific entity damage sources and block events that contribute to server lag. Comment out entries if you wish to re-enable specific flag controls.

```hocon
GriefDefender {
    # A global list of entity damage sources that are ignored in events by default.
    # https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/entity/EntityDamageEvent.DamageCause.html
    entity-damage-source-blacklist=[
        "block_explosion",
        contact,
        cramming,
        "dragon_breath",
        drowning,
        dryout,
        "falling_block",
        fall,
        fire,
        "fly_into_wall",
        lava,
        melting,
        "fire_tick",
        "hot_floor",
        poison,
        "sonic_boom",
        starvation,
        suffocation,
        suicide,
        void
    ]
    # A list of id's ignored by flags.
    flag-id-blacklist {
        block-break=[]
        block-grow=[
    # Trees generate noise, which can cause a slight lag on the server, if you want to control it, comment.
            "minecraft:oak_leaves",
            "minecraft:spruce_leaves",
            "minecraft:birch_leaves",
            "minecraft:jungle_leaves",
            "minecraft:acacia_leaves",
            "minecraft:dark_oak_leaves",
            "minecraft:mangrove_leaves",
            "minecraft:azalea_leaves",
            "minecraft:flowering_azalea_leaves",
            "minecraft:cherry_leaves",
            "minecraft:oak_log",
            "minecraft:spruce_log",
            "minecraft:birch_log",
            "minecraft:jungle_log",
            "minecraft:acacia_log",
            "minecraft:dark_oak_log",
            "minecraft:mangrove_log",
            "minecraft:cherry_log",
            "minecraft:cherry_sapling",
            "minecraft:oak_sapling",
            "minecraft:spruce_sapling",
            "minecraft:birch_sapling",
            "minecraft:jungle_sapling",
            "minecraft:acacia_sapling",
            "minecraft:dark_oak_sapling",
    # Plants generate noise, which can cause a slight lag on the server, if you want to control it, comment.
            "minecraft:pumpkin",
            "minecraft:melon",
            "minecraft:wheat",
            "minecraft:sugar_cane",
            "minecraft:beetroots",
            "minecraft:cactus",
            "minecraft:carrots",
            "minecraft:potatoes",
            "minecraft:#mushroom",
            "minecraft:grass",
            "minecraft:podzol",
            "minecraft:sweet_berry_bush",
            "minecraft:air"
    # If you want to block crop growth via /claimflags, comment above.
        ]
        block-modify=[
    # Redstone ores change state to create the glow.
            "minecraft:deepslate_redstone_ore",
            "minecraft:redstone_ore",
    # frosted ice is in relation to the enchantment of Frost Walker, only to remove the player's permission to generate minecraft:ice in the waters.
            "minecraft:frosted_ice",
            "minecraft:grass_block",
            "minecraft:dirt",
            "minecraft:weathered_*",
            "minecraft:netherrack",
            "minecraft:big_dripleaf",
            "minecraft:farmland",
            "minecraft:warped_nylium",
            "minecraft:ice",
            "minecraft:villager",
            "minecraft:sheep",
            "minecraft:fox",
        # Comment if you want players/foxes not to get minecraft:sweet_berry
            "minecraft:sweet_berry_bush"
        ]
        block-place=[
    # Enable it if you experience lag with RealisticSeasons, however this will allow other players to be able to claim minecraft:snow for others.
            #"minecraft:snow"
        ]
        block-pre=[]
        block-spread=[
            "minecraft:bamboo",
    # if you want to use /claimflags in the vine-growth section, comment minecraft:vine.
            "minecraft:vine",
            "minecraft:cave_vines",
            "minecraft:cave_air",
            "minecraft:glow_lichen",
            "minecraft:grass_block",
            "minecraft:mycelium",
            "minecraft:twisting_vines",
            "minecraft:brown_mushroom",
            "minecraft:budding_amethyst",
            "minecraft:weeping_vines",
            "minecraft:kelp",
            "minecraft:air"
        ]
        collide-block=[
    # This makes the big dripleaf interact with the player always, if you want to control it, comment.
            "minecraft:big_dripleaf"
        ]
        collide-entity=[]
        command-execute=[]
        command-execute-pvp=[]
        enter-claim=[
    # Monsters and Minecart generate a lot of noise, if you want to control it, comment them all.
            "#minecraft:monster",
            "minecraft:minecart",
            "minecraft:hopper_minecart",
            "minecraft:chest_minecart",
```

--------------------------------

### Configure GriefDefender Flag Controls

Source: https://docs.griefdefender.com/wiki/advanced/Optimizations

Sets the default enabled or disabled state for various claim flags.

```hocon
    flag-control {
        block-break=true
        block-grow=false
        block-modify=true
        block-place=true
        block-spread=true
        collide-block=true
        collide-entity=true
        command-execute=true
        command-execute-pvp=false
        enter-claim=true
        entity-chunk-spawn=false
        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=false
        interact-block-secondary=true
        interact-entity-primary=true
        interact-entity-secondary=true
        interact-inventory=true
        interact-inventory-click=false
        interact-item-primary=false
        interact-item-secondary=true
        inventory-item-move=true
        item-damage=true
        item-drop=true
        item-pickup=false
        item-spawn=true
        item-use=true
        leaf-decay=false
        liquid-flow=true
        portal-use=false
        projectile-impact-block=true
        projectile-impact-entity=true
    }
```

--------------------------------

### Pixelmon Blacklist Configuration

Source: https://docs.griefdefender.com/mods/Pixelmon

Defines blacklisted entities and blocks for various GriefDefender flags to optimize performance.

```hocon
GriefDefender {
    entity-damage-source-blacklist=[]
    flag-id-blacklist {
        block-break=[]
        block-grow=[]
        block-modify=[]
        block-place=[]
        block-spread=[]
        collide-block=[
	# pixelmon_grass
			"pixelmon:pixelmon_grass"
		]
        collide-entity=[]
        command-execute=[]
        command-execute-pvp=[]
        enter-claim=[]
        entity-chunk-spawn=[]
        entity-damage=[]
        entity-riding=[]
        entity-spawn=[
	# empty pokeball
			"pixelmon:empty_pokeball",
        ]
        entity-teleport-from=[]
        entity-teleport-to=[]
        exit-claim=[]
        explosion-block=[]
        explosion-entity=[]
        interact-block-primary=[]
        interact-block-secondary=[
	# tv
			"pixelmon:tv",
			"pixelmon:tv2",
	# berrys
			"pixelmon:berry_leaves_cheri",
			"pixelmon:berry_leaves_chesto",
			"pixelmon:berry_leaves_pecha",
			"pixelmon:berry_leaves_rawst",
			"pixelmon:berry_leaves_aspear",
			"pixelmon:berry_leaves_leppa",
			"pixelmon:berry_leaves_oran",
			"pixelmon:berry_leaves_persim",
			"pixelmon:berry_leaves_lum",
			"pixelmon:berry_leaves_sitrus",
			"pixelmon:berry_leaves_figy",
			"pixelmon:berry_leaves_wiki",
			"pixelmon:berry_leaves_mago",
			"pixelmon:berry_leaves_aguav",
			"pixelmon:berry_leaves_iapapa",
			"pixelmon:berry_leaves_razz",
			"pixelmon:berry_leaves_bluk",
			"pixelmon:berry_leaves_nanab",
			"pixelmon:berry_leaves_wepear",
			"pixelmon:berry_leaves_pinap",
			"pixelmon:berry_leaves_pomeg",
			"pixelmon:berry_leaves_kelpsy",
			"pixelmon:berry_leaves_qualot",
			"pixelmon:berry_leaves_hondew",
			"pixelmon:berry_leaves_grepa",
			"pixelmon:berry_leaves_tamato",
			"pixelmon:berry_leaves_cornn",
			"pixelmon:berry_leaves_"magost,
			"pixelmon:berry_leaves_rabuta",
			"pixelmon:berry_leaves_nomel",
			"pixelmon:berry_leaves_spelon",
			"pixelmon:berry_leaves_pamtre",
			"pixelmon:berry_leaves_watmel",
			"pixelmon:berry_leaves_durin",
			"pixelmon:berry_leaves_belue",
			"pixelmon:berry_leaves_occa",
			"pixelmon:berry_leaves_passho",
			"pixelmon:berry_leaves_wacan",
			"pixelmon:berry_leaves_rindo",
			"pixelmon:berry_leaves_yache",
			"pixelmon:berry_leaves_chople",
			"pixelmon:berry_leaves_kebia",
			"pixelmon:berry_leaves_shuca",
			"pixelmon:berry_leaves_coba",
			"pixelmon:berry_leaves_payapa",
			"pixelmon:berry_leaves_tanga",
			"pixelmon:berry_leaves_charti",
			"pixelmon:berry_leaves_kasib",
			"pixelmon:berry_leaves_haban",
			"pixelmon:berry_leaves_colbur",
			"pixelmon:berry_leaves_babiri",
			"pixelmon:berry_leaves_chilan",
			"pixelmon:berry_leaves_roseli",
			"pixelmon:berry_leaves_liechi",
			"pixelmon:berry_leaves_ganlon",
			"pixelmon:berry_leaves_salac",
			"pixelmon:berry_leaves_petaya",
			"pixelmon:berry_leaves_apicot",
			"pixelmon:berry_leaves_lansat",
			"pixelmon:berry_leaves_starf",
			"pixelmon:berry_leaves_pumkin",
			"pixelmon:berry_leaves_drash",
			"pixelmon:berry_leaves_eggant",
			"pixelmon:berry_leaves_strib",
			"pixelmon:berry_leaves_nutpea",
			"pixelmon:berry_leaves_ginema",
			"pixelmon:berry_leaves_kuo",
			"pixelmon:berry_leaves_yago",
			"pixelmon:berry_leaves_touga",
			"pixelmon:berry_leaves_niniku",
			"pixelmon:berry_leaves_topo",
			"pixelmon:berry_leaves_enigma",
			"pixelmon:berry_leaves_micle",
```

--------------------------------

### Assign Flag Definition Permission

Source: https://docs.griefdefender.com/wiki

Use this permission node to grant users access to specific flag definitions within the GUI.

```text
griefdefender.user.definition.flag.minecraft.user.pvp
```

--------------------------------

### Configure Dino's Blacklist

Source: https://docs.griefdefender.com/wiki/advanced/Optimizations

Defines global entity damage sources and specific flag IDs to be ignored by events.

```hocon
blacklist {
    # A global list of entity damage sources that are ignored in events by default.
    # https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/entity/EntityDamageEvent.DamageCause.html
        entity-damage-source-blacklist=[
            contact,
            cramming,
            drowning,
            "falling_block",
            flyintowall,
            "fire_tick",
            "hot_floor",
            poison,
            starvation,
            suffocation,
            suicide,
            void
    ]
        # A list of id's ignored by flags.
        flag-id-blacklist {
            block-break=[]
            block-grow=[]
            block-modify=[
                "minecraft:water",
                "minecraft:dirt",
                "minecraft:big_dripleaf",
                "minecraft:grass_block",
                "minecraft:warped_nylium",
                "minecraft:netherrack",
                "minecraft:ice"
            ]
            block-place=[
                "minecraft:snow"
            ]
            block-pre=[]
            block-spread=[
                "minecraft:vine",
                "minecraft:grass_block",
                "minecraft:mycelium",
                "minecraft:twisting_vines",
                "minecraft:weeping_vines"
            ]
            collide-block=[]
            collide-entity=[]
            command-execute=[]
            command-execute-pvp=[]
            enter-claim=[
                "minecraft:hopper_minecart"
            ]
            entity-damage=[]
            entity-riding=[
                "minecraft:minecart"
            ]
            entity-spawn=[
                "minecraft:axolotl",
                "minecraft:bat",
                "minecraft:squid",
                "minecraft:pig",
                "minecraft:cow",
                "minecraft:sheep",
                "minecraft:egg",
                "minecraft:chicken",
                "minecraft:rabbit",
                "minecraft:bee",
                "minecraft:cat",
                "minecraft:fox",
                "minecraft:horse",
                "minecraft:cod",
                "minecraft:dolphin",
                "minecraft:firework_rocket",
                "minecraft:turtle",
                "minecraft:glow_squid",
                "minecraft:fishing_bobber",
                "minecraft:salmon",
                "minecraft:snowball",
                "minecraft:trident"
            ]
            entity-teleport-from=[]
            entity-teleport-to=[]
            exit-claim=[
                "minecraft:hopper_minecart"
            ]
            explosion-block=[]
            explosion-entity=[]
            interact-block-primary=[]
            interact-block-secondary=[
                "minecraft:#banners",
                "minecraft:#logs",
                "minecraft:#planks",
                "minecraft:#saplings",
                "minecraft:#signs",
                "minecraft:#wooden_slabs",
                "minecraft:#wooden_stairs",
                "minecraft:#walls",
                "minecraft:#shulker_boxes",
                "minecraft:#cauldrons",
                "minecraft:#rails",
                "minecraft:#deepslate_blocks",
                "minecraft:#dirt",
                "minecraft:#sand",
                "minecraft:#terracotta",
                "minecraft:#small_flowers",
                "minecraft:#tall_flowers",
                "minecraft:#climbable",
                "minecraft:#gold_ores",
                "minecraft:#wool",
                "minecraft:stone",
                "minecraft:dirt",
                "minecraft:deepslate",
                "minecraft:spruce_fence",
                "minecraft:oak_leaves",
                "minecraft:basalt",
                "minecraft:grass_block",
                "minecraft:andesite",
                "minecraft:#corals"
            ]
            interact-entity-primary=[
                "minecraft:minecart"
            ]
            interact-entity-secondary=[
                "minecraft:minecart"
            ]
            interact-inventory=[]
            interact-inventory-click=[]
            interact-item-primary=[]
            interact-item-secondary=[]
            inventory-item-move=[]
            item-drop=[]
            item-pickup=[]
            item-spawn=[]
            item-use=[]
            leaf-decay=[]
            liquid-flow=[
                "minecraft:water"
            ]
            portal-use=[]
            projectile-impact-block=[
                "minecraft:arrow",
                "minecraft:trident"
            ]
            projectile-impact-entity=[
                "minecraft:ender_pearl"
            ]
        }
        # A global list of source id's that are ignored by events. 
        # Note: This only affects events where the id specified is the source.
        global-source=[]
```

--------------------------------

### Apply LuckPerms Permissions

Source: https://docs.griefdefender.com/wiki

Command to assign GriefDefender user permissions to a specific group.

```text
/lp group <group> permission set griefdefender.user.*
```

--------------------------------

### Configure Pixelmon Animal Spawning

Source: https://docs.griefdefender.com/mods/Pixelmon

Allows occupied pokeballs to spawn Pixelmon animals by default. Requires administrative permissions.

```text
/cf entity-spawn #pixelmon:animal true source=pixelmon:occupied_pokeball default=global
```

--------------------------------

### Record Debugging Sessions

Source: https://docs.griefdefender.com/wiki/advanced/Debugging

Initiates a recording session to capture flag checks. Optional filters can be applied to narrow down the scope of the data.

```text
/gddebug record [filter]
```

```text
/gddebug record
```

```text
/gddebug record claim
```

```text
/gddebug record KratosKnox
```

```text
/gddebug record my-test-session
```
Tokens:
Raw