Skip to content

Blacklist and Protection

Ghost edited this page Nov 15, 2026 · 1 revision

🛑 Blacklist and Protection

Fabric Guard 1.7.10 implements two complementary systems:

  1. Region flags that control behavior inside areas.
  2. A global JSON blacklist for matching particular items/actions, optionally restricted by dimensions.

Blacklist file

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.

Supported actions

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.

Per-dimension rules

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.

Region protection beyond block breaking

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.

Tips

  • 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.

Clone this wiki locally