ItemRules is a simple to use, but highly configurable plugin for controlling how, when and even where items and blocks can be used, picked up, crafted, placed or broken based on the world, a players xp level, the faction they are in, their mcMMO skill level, their rank/group, their permissions, and more. It is a complete rewrite/revisioning of my previous plugin LevelRestrictions

Latest Builds


ItemRules can allow you to restrict items and blocks based on XP level and/or will integrate with Factions (e.g. allow only certain factions to use certain items), McMMO (e.g. restrict ores from being mined unless mining skill is a minimum level), Vault (e.g. restrict weapons based on permission group).

ItemRules will also allow you to configure certain rules that will be applied when players walk into defined regions (e.g. a PvP zone that only allows you to use carrots as weapons)

Configuration Examples

Here is an example of restricting iron tools and equipment until player is level 2:

        description: 'Use of iron stuff until level 2' 
            restricted: 'You cant %s %s until level 2'
        actions: [USE, BREAK, PICKUP]
            min: 2
            restrict: [256, 257, 258, 267, 292]

Here is an example of McMMO integration that prevents cutting down Birch trees until woodcutting skill is level 2:

           restricted: 'You cant cut birch until woodcutting 2'
        actions: [BREAK]
                woodcutting: 2
           restrict: ['17.2']

You can also specify rules to apply to groups (note this requires Vault) by adding this to your rule:

    applyto: ['newbs', 'badpeeps']

You can use the same format to exclude rules from groups (using Vault) like:

    exclude: ['vips']


Note that by default all OP's will bypass rules.

itemRules.bypass.*Do not process ANY rules for player
itemRules.bypass.RULENAMEDo not process specific rule for player


/rules[playername]list all rules currently applied to player. No arguments for self

Change log

  • v1.0.9 - Jun 21st, 2013
    • Silent exception handling when Entity attacks player with an invalid item.
  • v1.0.8 - Feb 18th, 2013
    • Fixed potential issue with groups and perms not applying correctly.
  • v1.0.6 - Feb 17th, 2013
    • Fixed bug with certain manual rules not properly applying.
    • Changed Item text to use Vault if installed.
  • v1.0.5 - Feb 9th, 2013
    • Changed permission check to prefer Vault (if installed) over Bukkit.
    • Bugs zapped
  • v1.0.3 - Feb 9th, 2013
    • Changes mcMMO skill type checks to take advantage of their new api accepting strings instead of data types.
  • v1.0.2 - Jan 30th 2013
    • Added support for mcMMO versions with build newer than #1282 ( Jan 22nd 2013). Otherwise, same exact build.

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

  • Avatar of MineCraftMyph MineCraftMyph Sep 21, 2014 at 17:03 UTC - 0 likes

    @Geekola: Go

    I would love an update on this.

  • Avatar of kev3200 kev3200 Sep 10, 2014 at 12:40 UTC - 0 likes

    Hey Geekola,

    I'm still here and still waiting for an update. I've abandoned my project for now until one comes out. This plugin really is a crucial part and an update would be extremely helpful. If you aren't going to keep this plugin updated, please hand the responsibilities off to someone else...

  • Avatar of drAkeTool drAkeTool Aug 04, 2014 at 09:39 UTC - 1 like

    Update plugin plz :D

  • Avatar of kev3200 kev3200 Jul 17, 2014 at 00:02 UTC - 0 likes

    @Geekola: Go

    I would really appreciate a response as this problem still exists and I'm not sure how to proceed.

    EDIT: This is one of my core plugins and an update or workaround (such as an /ir reload command maybe?) to get the plugin to recognize changes in a player's permissions immediately would be greatly appreciated...

    PS. (A reply to this comment would be nice so I know you actually saw it)

    Last edited Jul 18, 2014 by kev3200
  • Avatar of kev3200 kev3200 Jul 02, 2014 at 22:21 UTC - 0 likes

    @Geekola: Go

    Thank you for responding. Would it be possible for you to release an update? I have something I would like added.

    It would be very helpful if the plugin recognized when a player's permissions were updated without me having to /reload the server after any change. Right now, everything works fine, but when I add or remove a permission from a player, I need to /reload the server from the console for ItemRules to recognize the change; something I would greatly prefer not to have to do since I run a bigger server and it takes a couple seconds to reload each time.

    Also, in your examples file (for basic configs) the option for permissions, the exclude sub-option, has the permissions read just like this: mycustom.permission. However, after numerous testing and frustration, I realized that the config actually only reads the permission when it is in this format: ['mycustom.permission']

    It would be nice to change that so others are not confused. And a new release would be very nice, just to change the reload problem I mentioned. Other than that, the plugin works great, I was just confused at first.

    Last edited Jul 02, 2014 by kev3200
  • Avatar of Geekola Geekola Jul 02, 2014 at 15:00 UTC - 0 likes

    @kev3200: Go

    Hi Kev, I haven't updated this in over a year so am going off memory here... But read the part about permissions... I am assuming you are an OP:

    Note that by default all OP's will bypass rules.

    You may need to add a negative permission to you for: itemRules.bypass.*

    to your permissions


  • Avatar of kev3200 kev3200 Jul 02, 2014 at 13:43 UTC - 0 likes

    @kev3200: Go

    Ok I figured out part of the problem. I had accidently had ItemRules disabled :P

    But, the rules still aren't working. When I type /rules on my test server it says: 'You have no rules applied to you.'

    Why is this?

  • Avatar of kev3200 kev3200 Jul 01, 2014 at 11:18 UTC - 0 likes

    I'm having a problem on my 1.7.9 server. I have this in my Config that I took from the examples:

    rules: diamondEquipment: description: 'use of diamond equipment until level 5' messages: restricted: 'You cannot %s %s until level 5' xp: min: 5 actions: [USE, CRAFT] items: restrict: - 276

    But it doesn't seem to be doing anything. I also have this:

    rules: woodenEquipment: description: 'use of wooden equipment' messages: restricted: 'You cannot %s %s until a higher level' actions: [USE, BREAK, CRAFT] permissions: exclude: allowed.woodenSword items: restrict: ['268,270']

    but that doesn't seem to do anything either... Is my syntax wrong or what?

  • Avatar of Milspec Milspec Jan 06, 2014 at 11:57 UTC - 0 likes

    I installed ItemRules v1.0.10 on my test server running Bukkit 1.7.2-R0.2 and everything worked fine in a new 1.7.4 world. I spot-checked new item ids that were released after the last ItemRules was published and it behaved normally.

    I use McMMO, Factions, PermissionsEX and a few other plugins and ItemRules appears to be playing nicely with them all. Your results may vary. :-)

  • Avatar of Jo11yWombat Jo11yWombat Dec 29, 2013 at 18:28 UTC - 0 likes

    Does this plugin still work? Will it ever get an update? I could really use it.


Date created
Jan 27, 2013
Last update
Jun 27, 2013
Development stage
GNU General Public License version 3 (GPLv3)
Curse link
Recent files