### 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
```
--------------------------------
### 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
com.griefdefender
api
2.1.0-SNAPSHOT
provided
```
```xml
griefdefender
https://repo.glaremasters.me/repository/bloodshot
```
--------------------------------
### 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 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
```
--------------------------------
### Configure Flag Control Settings
Source: https://docs.griefdefender.com/wiki/advanced/Optimizations
Sets the default state for various block and entity interaction flags within claims.
```hocon
flag-control {
block-break=true
block-grow=false
block-modify=true
block-place=true
block-spread=false
collide-block=false
collide-entity=false
command-execute=false
command-execute-pvp=false
enter-claim=true
entity-chunk-spawn=false
entity-damage=true
entity-riding=true
entity-spawn=true
entity-teleport-from=false
entity-teleport-to=false
exit-claim=true
explosion-block=true
explosion-entity=false
interact-block-primary=false
interact-block-secondary=true
interact-entity-primary=false
interact-entity-secondary=true
interact-inventory=true
interact-inventory-click=false
interact-item-primary=false
interact-item-secondary=false
inventory-item-move=true
item-drop=false
item-pickup=false
item-spawn=false
item-use=false
leaf-decay=false
liquid-flow=true
portal-use=false
projectile-impact-block=true
projectile-impact-entity=true
}
```
--------------------------------
### Configure Claim Accrual via LuckPerms
Source: https://docs.griefdefender.com/wiki
Apply these meta values to LuckPerms groups to override default claim block settings defined in options.yml.
```text
/lp group vip meta set initial-blocks 3000
/lp group vip meta set block-accrual-per-hour 150
/lp group vip meta set max-accrued-blocks 10000
```
--------------------------------
### Configure GriefDefender Blacklists
Source: https://docs.griefdefender.com/wiki/advanced/Optimizations
Defines global entity damage sources and specific flag IDs that are ignored by GriefDefender events.
```hocon
GriefDefender {
# A global list of entity damage sources that are ignored in events by default.
entity-damage-source-blacklist=[
contact,
cramming,
drowning,
"falling_block",
flyintowall,
fire,
"fire_tick",
"hot_floor",
poison,
starvation,
suffocation,
suicide,
void
]
# A list of id's ignored by flags.
flag-id-blacklist {
block-break=[
"minecraft:fire"
]
block-grow=[]
block-modify=[
"minecraft:weathered_*",
"minecraft:netherrack",
"minecraft:farmland",
"minecraft:sheep",
"minecraft:dirt",
"minecraft:frosted_ice"
]
block-place=[]
block-spread=[
"minecraft:vine",
"minecraft:grass_block",
"minecraft:mycelium",
"minecraft:twisting_vines",
"minecraft:weeping_vines",
"minecraft:kelp"
]
collide-block=[]
collide-entity=[]
command-execute=[]
command-execute-pvp=[]
enter-claim=[]
entity-chunk-spawn=[]
entity-damage=[]
entity-riding=[]
entity-spawn=[]
entity-teleport-from=[]
entity-teleport-to=[]
exit-claim=[]
explosion-block=[]
explosion-entity=[]
interact-block-primary=[]
interact-block-secondary=[]
interact-entity-primary=[]
interact-entity-secondary=[
"minecraft:villager",
"minecraft:falling_block"
]
interact-inventory=[]
interact-inventory-click=[]
interact-item-primary=[]
interact-item-secondary=[]
inventory-item-move=[]
item-damage=[]
item-drop=[]
item-pickup=[]
item-spawn=[]
item-use=[]
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=[]
}
```
--------------------------------
### Interaction Entity Secondary Configuration
Source: https://docs.griefdefender.com/mods/Pixelmon
Defines entities that allow secondary interaction, such as NPCs and traders.
```text
interact-entity-secondary=[
"pixelmon:chattingnpc",
"pixelmon:relearner",
"pixelmon:tutor",
"pixelmon:nursejoy",
"pixelmon:oldfisherman",
"pixelmon:shopkeeper",
"pixelmon:trader"
]
```
--------------------------------
### Configure Pokeball Block Impact
Source: https://docs.griefdefender.com/mods/Pixelmon
Forces pokeballs to impact blocks. Requires administrative permissions.
```text
/cf projectile-impact-block any true source=pixelmon:occupied_pokeball override=global
```
--------------------------------
### Configure Flag Control in flags.yml
Source: https://docs.griefdefender.com/wiki/Configuration
Defines which flags are enabled or disabled globally. Disabling a flag causes GriefDefender to ignore all associated events.
```yaml
# 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
}
```
--------------------------------
### Interaction Item Secondary Configuration
Source: https://docs.griefdefender.com/mods/Pixelmon
Defines items that allow secondary interaction, specifically various types of PokeBalls.
```text
interact-item-secondary=[
# pokeball
"pixelmon:poke_ball",
# pokeball 1.12.2
"pixelmon:great_ball",
"pixelmon:ultra_ball",
"pixelmon:master_ball",
"pixelmon:level_ball",
"pixelmon:moon_ball",
"pixelmon:friend_ball",
"pixelmon:love_ball",
"pixelmon:safari_ball",
"pixelmon:heavy_ball",
"pixelmon:fast_ball",
"pixelmon:repeat_ball",
"pixelmon:timer_ball",
"pixelmon:nest_ball",
"pixelmon:net_ball",
"pixelmon:dive_ball",
"pixelmon:luxury_ball",
"pixelmon:heal_ball",
"pixelmon:dusk_ball",
"pixelmon:premier_ball",
"pixelmon:sport_ball",
"pixelmon:quick_ball",
"pixelmon:lure_ball",
"pixelmon:park_ball",
"pixelmon:cherish_ball",
"pixelmon:gs_ball"
```
--------------------------------
### Define Icon Flags in gui.yml
Source: https://docs.griefdefender.com/wiki/Configuration
Specifies special attributes for GUI icons, such as hiding item attributes.
```yaml
icon-flags=[
"hide_attributes"
]
```