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
- Click here for details on configuring basic rules.
- Click here for details on configuring rules that only apply to specified areas.
Here is an example of restricting iron tools and equipment until player is level 2:
ironEquipment:description:'Use of iron stuff until level 2'messages:restricted:'You cant %s %s until level 2'actions:[USE,BREAK,PICKUP]xp:min: 2 items: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:
Woodcutting-Brichwood:messages:restricted:'You cant cut birch until woodcutting 2'actions:[BREAK]mcmmo:skills:woodcutting: 2 items:restrict:['17.2']
You can also specify rules to apply to groups (note this requires Vault) by adding this to your rule:
groups:applyto:['newbs','badpeeps']
You can use the same format to exclude rules from groups (using Vault) like:
groups:exclude:['vips']
Permissions
Note that by default all OP's will bypass rules.
| permission | notes |
|---|---|
| itemRules.bypass.* | Do not process ANY rules for player |
| itemRules.bypass.RULENAME | Do not process specific rule for player |
Commands
| command | arguments | example | explanation |
|---|---|---|---|
| /rules | [playername] | list all rules currently applied to player. No arguments for self |
Change log
- v1.0.8 - Feb 18th, 2012
- Fixed potential issue with groups and perms not applying correctly.
- v1.0.6 - Feb 17th, 2012
- Fixed bug with certain manual rules not properly applying.
- Changed Item text to use Vault if installed.
- v1.0.5 - Feb 9th, 2012
- Changed permission check to prefer Vault (if installed) over Bukkit.
- Bugs zapped
- v1.0.3 - Feb 9th, 2012
- Changes mcMMO skill type checks to take advantage of their new api accepting strings instead of data types.
- v1.0.2 - Jan 30th 2012
- Added support for mcMMO versions with build newer than #1282 ( Jan 22nd 2012). Otherwise, same exact build.