Use this plugin to ban items and blocks for Bukkit, Tekkit, and FTB servers using the Bukkit API. ItemRestrict removes banned items from the world and player inventories. It is easy to configure, can be applied retroactively, and automatically removes the items. It requires no permissions plugin unless exceptions are need for certain players. It is compatible with 1.2.5, 1.3.2, 1.4.7, 1.5.2, 1.6.4, 1.7.10.

Because every story that starts with "We decided to make a change..." shouldn't end with " we had to reset the world."


Copy the .jar file into your plugins folder to install the plugin. Then restart the server or use a plugin manager to load the plugin.


Use the command "/ires reload" to reload the config file.

CommandPermission NodeDescription
/ires reloaditemrestrict.reloadReload the config
/ires ban <banType> <id-datavalue>itemrestrict.banAdd item to the ban list
/ires unban <banType> <id-datavalue>itemrestrict.banRemove item from the ban list


There are 4 major sections in the cofig file (config.yml). Enabled worlds are listed under Worlds. World Ban scanner settings is under Scanner. Ban settings are under Bans. Notification settings to the player are under Messages. A default config for Tekkit was generously created by BigScary.

Worlds listed in the Worlds section are enabled worlds which will be checked by the plugin. You can name normal worlds, dimensions, and mystcraft worlds by using the world's folder name. Add the case sensitive world called "All" to bypass the world check.

The Scanner settings indicate the percentage chance (from 0 to 1) that it scans a loaded player or a loaded chunk.

You can specify the items you wish to ban under the Bans section. Take a look at the different types of bans below. An entry with only the item id (32) will specify ALL wool (all datavalues). An entry with the item id and datavalue separated by a dash (32-2) specifies MAGENTA wool (datavalue 2). Some items have a different values in your inventory as opposed to ones place in the world (eg. a door item in the inventory versus a placed door in the world). A full list of Block IDs will help you add banned items.

The label gives the item a name when notifying the player. The reason provides the reason of why the item was banned for them. You can use colour with both the label and the reason by using the escape character "&" and a hex number corresponding to the minecraft colour.


Making Ban Exceptions

You can make individual ban exceptions to give some players to generally banned items through permission nodes. A player who has /op automatically ignores bans. Specifying the item ID without the datavalue means all data values (-*). Here are various examples, which should help you understand without further explanation.

- ItemRestrict.bypass.usage.35
- ItemRestrict.bypass.ownership.35-6

You can't prevent a specific player's placed block from being removed from the world as this plugin does not track who owns placed blocks in the world.

Types of Bans

Usage Bans

This ban prevents players from using an item, which means left-click or right-click while the item is in-hand. This ban also prevents players from right clicking a block specified by this ban. This ban also prevents a player from building a block in the world. This works well for items like the Mining Laser, but won't stop players from using items which benefit from passive use (eg. modded armors, Talisman of Repair, etc.). You will need an ownership ban to prevent players from getting those items at all. A player that already has an item which is later placement-banned can still trade it with another player or break it down into energy (EE mod) to get some value out of it.

It's not possible for any plugin to prevent a player from using an item when it is activated by a keystroke (eg. R, G, C, etc.), which are common especially for Equivalent Exchange items. This is why many EE items are on the default ownership bans list even though their functions are not all really ban-worthy.

It is recommend to place most or all usage ban items to your ownership ban list. This will prevent your players from unknowingly spending their resources to craft a block which they then can't place in the world like they planned leading to them feeling cheated and likely complaining. The only exception you might make to this rule is for an item which can't be placed, but is still useful because it's an ingredient in another recipe for an item you haven't banned.

Ownership Bans

This ban prevents player from picking up an item from the ground or from a container (eg. a chest). If a player doesn't have permission to own an item, they won't be able to craft it. The contraband scanner will search each player's inventory for ownership-banned items and actually remove them without warning, notification, or compensation.

This ban also prevents players from crafting an item. When the player tries to craft the item, they get a message that they can't. This is the most player-friendly approach to preventing players from getting banned items. Forge mods don't always hook into Bukkit, meaning its possible for players to get banned items through some automatic or non-crafting approach (eg. alchemy). When you crafting-ban an item, test for workarounds, which may lead you to ban additional items to prevent those workarounds.

World Bans

This ban will retroactively remove the placed block from the world through the Asynchronous World Scanner (AWS). This is great if you need to ban an item, but also know it's in the world (eg. energy collectors and world anchors). This will help clean up newly-banned items without having to search your entire world for them. There are exceptions to this removal as the scanner can't determine who owns the block.


This plugin uses the idea from BigScary's TekkitCustomizer. However all components in his code have been replaced with high performing and simple implementations. As a server administrator, I care about performance as much as you. Thus no code is actually used from the TekkitCustomizer plugin and the source code can be found here.

The default ban list is made for Classic Tekkit based on hands on testing done by BigScary. Before deciding to remove items from this list, be sure to read the reasons for default bans to understand why it was originally removed. If you are running FTB, Tekkit Lite, or other mod packs, do your own research for what you want banned and change the config file accordingly.

Save yourself some time! Check our Frequently Asked Questions page for the answer to your question. If you found a bug, make a ticket and include your config file.




Thank you to piritacraft for testing each ticketed issue. Thank you to excavator5 for testing the plugin.

Thank you to our contributers that have helped contribute to this project:

Thank you to our supporters that have generously donated to ItemRestrict:

  • Thundercoyote


Unlike other players who have a choice to play the game, my commitment to development and administration usually means I cannot and I'm fine with that choice. A lot of my free time is actually spent designing, developing, testing, and fixing plugins like this one to make Minecraft more enjoyful for all players. If you like this plugin, please consider sending me a donation by clicking the button below :) Thanks!


You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of robertjones6 robertjones6 Dec 17, 2013 at 10:51 UTC - 0 likes

    i have a few questions

    1. is it compatible with tekkit classic

    2. is it possible to prevent usage when block is placed eg stop a person interacting with an energy collectors

    3. does it recognise any blocks around the prevented block eg a condensor thats in an mk3 energy collector power flower

    would appreciate if you swung by my tekkit classic server: as i may consider moving from tekkit customizer

  • Avatar of krisdestruction krisdestruction Dec 13, 2013 at 05:49 UTC - 0 likes

    @HeyAwesomePeople: Go

    Can you quickly make a ticket? Thanks to Slind14, the next release should fix any async issues.

    Last edited Dec 13, 2013 by krisdestruction

  • Avatar of HeyAwesomePeople HeyAwesomePeople Dec 13, 2013 at 05:44 UTC - 0 likes

    @Zulgol: Go

    Most tekkit mods have a config in the config folder that can disable crafting certain items or crafting altogether.


  • Avatar of HeyAwesomePeople HeyAwesomePeople Dec 13, 2013 at 05:42 UTC - 0 likes

    Getting a error while running. Using tekkit version 1.5.2. Using plugin version 1.5.2. Error Code:

    [m 2013-12-12 21:38:15 [SEVERE] Exception in thread "pool-1-thread-516" 2013-12-12 21:38:15 [SEVERE] org.apache.commons.lang.UnhandledException: Plugin ItemRestrict v1.4 generated an exception while executing task 1527 at at java.util.concurrent.ThreadPoolExecutor.runWorker(Unknown Source) at java.util.concurrent.ThreadPoolExecutor$ Source) at Source) Caused by: java.lang.IllegalStateException: Asynchronous entity track! at net.minecraft.entity.EntityTracker.func_72785_a( at net.minecraft.entity.EntityTracker.func_72786_a( at at at at at at at at at at org.bukkit.craftbukkit.v1_5_R3.CraftChunk.getHandle( at org.bukkit.craftbukkit.v1_5_R3.block.CraftBlock.getTypeId( at info.terrismc.itemrestrict.ConfigStore.getConfigStringParent( at info.terrismc.itemrestrict.ConfigStore.isBanned( at info.terrismc.itemrestrict.ConfigStore.isBannable( at info.terrismc.itemrestrict.QuickStore$ at at ... 3 more

    It happened while literally just running. Thanks.

  • Avatar of krisdestruction krisdestruction Dec 11, 2013 at 15:36 UTC - 0 likes

    @Zulgol: Go

    A known workaround is to ban the item using this plugin. If you wish to remove the recepe entirely from the game, a mod is required. I'm not a fan of mods (go figure), so I suggest that people use the plugin instead. Go with whatever works for you guys.

  • Avatar of Zulgol Zulgol Dec 11, 2013 at 09:21 UTC - 0 likes

    If its not possible to do with a plugin then people could take a peak at

  • Avatar of krisdestruction krisdestruction Dec 08, 2013 at 05:45 UTC - 0 likes

    I will be returning to active development in 2 days.

    @unga23: Go

    I will take a look into it, but to my knowledge, it is not possible to restrict custom recepies for custom blocks as no bukkit events fire for crafting table-like mods.

    @McyD1: Go

    Please submit a bug with the config file and server logs. I will take a look in 2 days.

  • Avatar of unga23 unga23 Nov 27, 2013 at 04:45 UTC - 0 likes

    AWESOME PLUGIN! The only thing:


    Example: I want to change some recipes and also give some people permissions, or creating recipes so we can manage all the crafting and smelting!

    :) thank you!

  • Avatar of McyD1 McyD1 Nov 24, 2013 at 10:48 UTC - 0 likes

    Just updated the my server to 1.6.4, and MCPC+ .150 and item restrict 1.4 is not working at all. I can get it to reload from the command line, but other than that is not enforcing any of the bans I have set.

  • Avatar of krisdestruction krisdestruction Nov 16, 2013 at 16:39 UTC - 0 likes

    Hey guys, just a heads up that I am unable to make any code changes from now until Dec 10 due to exams. I will have day and night to work on issues and features after that date.

What permissions plugin do you use while using ItemRestrict?

  1. Choice:

  1. Results
  2. 4 comments


Date created
Sep 22, 2013
Last update
Oct 07, 2013
Development stage
GNU General Public License version 3 (GPLv3)
Curse link
Recent files