Repository navigation
Blacklist and Protection
Fabric Guard 1.7.10 implements two complementary systems:
- Region flags that control behavior inside areas.
- A global JSON blacklist for matching particular items/actions, optionally restricted by dimensions.
config/fabricguard/blacklist.json
The installed configuration class seeds one default blacklist entry matching minecraft:tnt and minecraft:lava_bucket, with the actions deny and notify.
The format written by the implementation uses an entries array. A representative configuration is:
{
"entries": [
{
"items": ["minecraft:tnt", "minecraft:lava_bucket"],
"actions": ["deny", "notify"]
}
]
}This is an example of the recognized structure, not a recommendation to block these items on every server. Review your server's actual generated file before making changes.
The binary declares these blacklist action names:
| Action | Intended behavior |
|---|---|
deny |
Block the matched action. |
notify |
Issue a notification. |
log |
Record a matched action. |
broadcast |
Broadcast a message. |
tell |
Send feedback to an affected user. |
The exact event and recipient behavior depends on the listener that processes a matched entry. Test each action before applying security-sensitive policies.
The blacklist parser accepts optional dimensions and excluded-dimensions arrays in entries:
{
"entries": [
{
"items": ["minecraft:tnt"],
"actions": ["deny", "log"],
"dimensions": ["minecraft:overworld"]
}
]
}For custom dimensions, use the correct namespaced dimension ID.
The flag registry includes environmental protections such as creeper-explosion, other-explosion, tnt, fire-spread, water-flow, lava-flow, pistons, enderman-grief and more. See Flag-Reference.
- A blacklist entry is not the same as a region flag; understand which policy you are configuring.
- Keep a backup before editing JSON.
- Validate JSON punctuation and strings before reloading.
- Test TNT, buckets, dispensers and modded blocks separately when they matter to your server.
See Configuration, Flags and Troubleshooting.
Fabric Guard 1.7.10 · Modrinth · CurseForge · Home · Troubleshooting · Discord
Independent Fabric region-protection mod; not the official WorldGuard plugin.
🛡️ Fabric Guard Wiki
Regions
Protection
Help