Skip to content
Now is not the time to use that. (Dimension based item filter)
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
src/main Added new event that can trigger bans, Any time an inventory is close… Jun 13, 2019
.gitignore I hate rendering. Oct 21, 2015
LICENSE.txt I hate rendering. Oct 21, 2015 1.12.2 port. Sep 7, 2018
build.gradle 1.12.2 port. Sep 7, 2018 Version bump. Jun 13, 2019


Now is not the time to use that.


/blockitem (also /itemblacklist or /blacklist)

The main command, it has an ingame help. (/blockitem help)


Lets anyone unpack there own inventory. Useful for items required in crafting. Can be disabled in the config

Pack vs World bans

Since v1.2 there is 2 possible blacklists:

They both apply at the same time!

  • World: Changeable trough the command /blockitem. Also a file: <world data>/ItemBlacklist.json.
  • Pack: Only via the file: config/ItemBlacklist.json.

You cannot change the pack config in the game, its meant for pack makers who want to ban items from use for all servers. If you as a server owner then want to ban more items, just use the command.

This also makes it easy to maintain the 2 lists. The pack maker can update the Pack list, and not override bans made by server owners. And server owners can further restrict items without much effort. The only hard thing comes when a server owner wants to overrule a pack maker's ban. You will have to manually edit the Pack JSON file (config/ItemBlacklist.json) to remove the entry, and do that every pack update.

For this reason I recommend pack makers to provide an extra file, if they want to have optional/recommended extra bans, and put that file somewhere safe (so it won't override world/ItemBlacklist.json!), and attach a note to your server download/info page.

JSON format

Example format:

  "__GLOBAL__": [
      "item": "minecraft:wool",
      "damage": "1"
  "0": [
      "item": "minecraft:wool",
      "damage": "*"

This file means that: Wool with damage 1 (orange wool) is banned everywhere. Wool with any damage (any color) is banned in the overworld (dim 0)

Ranges / Multiple dimensions

If you want to specify multiple dimensions (for example, "0, -1 and 1", you can do so by using a comma , to separate the numbers: 0,-1,1. You can also specify a range of dimensions with the pound/hash # symbol: 10#100.

You can create multiple overlapping ranges, they should merge. Just don't make 2 identical ranges.

You can’t perform that action at this time.