1. We are planning scheduled maintenance on this website on Friday 5 March (tomorrow) at 4:00 am UTC. It is estimated that this maintenance will last 15 minutes. You can view this time in your local timezone here. Thanks.
    Dismiss Notice

Item Restrict by CraftersLand 2.4.1

[1.6.4 - 1.12.2] Restrict item ownership, placement, usage, pickup, crafting, brewing, creative menu

  1. brunyman
    Tested Minecraft Versions:
    • 1.7
    • 1.8
    • 1.9
    • 1.10
    • 1.11
    • 1.12
    Source Code:
    https://github.com/brunyman/ItemRestrict
    This plugin allows you to create a restricted items list, you can restrict item ownership, usage, placement, pickup, brewing potions, wearing armor, drop, smelt, craft or items from creative menu. Also it features a world scanner to remove blocks already placed. It was created for modded servers in first place because there you need to restrict dangerous stuff. Was well tested on MCPC 1.6.4 and KCauldron 1.7.10, should work fine on newer versions.

    Important! I made this plugin for my 1.6.4 and 1.7.10 modded servers where you need to ban bad items, it was made for this thing in mind and if you still run a 1.6 or 1.7 modded server this works great! However since 1.9 Minecraft made allot of changes to remove items numeric ID's and in 1.13 they are now completely removed, this plugin was made to work with item ID's therefore further updates no longer make sense on this plugin. I will no longer update this plugin for newer Minecraft versions, also updates with new features will be less likely as my time is limited. But plugin source code is available if you need to improve it.

    Do you want to save players data (Inventory, Enderchest, Money, Health, Exp and more...) on MySQL database? Or sync players data across servers? Then check out my other plugin:
    [​IMG] MySQL Player Data Bridge
    Do you want to save Essentials data on MySQL database? Or sync Essentials data across servers?
    Then consider checking out my other plugin:
    [​IMG] Essentials MySQL Storage Extension


    Features
    • Restrictions can be enabled on all worlds or specific worlds. Config option 'EnableOnAllWorlds: true' it's great for modded servers where players can create dimensions and with this option nobody will be able to bypass restrictions in some worlds.
    • Features a World Scanner that can be enabled or disabled in the config. The world scanner scans the loaded chunks to remove restricted items. The scanning is done in a separate thread so the server performance will not be affected.
    • The restricted list saves the items ID, this way it's easy to restrict modded items and vanilla items too.
    • You can provide reasons for each restricted item.
    • Features sound effects on commands and when interacting with a restricted item.
    • All chat messages and prefix can be customized with full color and format codes support.
    • Features particle effects when trying to pickup a restricted item from the ground.
    Limitations!
    1. Because after minecraft 1.9 came out some items like potions have the same item ID and data value, restricting them is no longer possible in versions 1.9 and later because this plugin uses items ID and values and not NBT data.
    2. Removing recipes from the game is no longer possible in any spigot 1.12 versions due to a bug. Use CraftingBan feature until this is fixed. Bug tracker: https://hub.spigotmc.org/jira/browse/SPIGOT-3308

    What can you restrict?

    Ownership
    This is the main restriction that covers multiple ways of getting items. This will confiscate the items if the player manage to get them in his inventory or tries to pick them up.

    Usage
    This will block the usage of items or placed blocks.

    Crafting
    You can just block the crafting of items and allow others with bypass permission to still craft them or completely remove the crafting recipe from the game.

    Smelting
    You can just block the smelting of items and allow others with bypass permission to still smelt them or completely remove the smelting recipe from the game.

    Placement
    Blocks the placement of certain blocks.

    Block break
    Restrict breaking of certain blocks.

    Brewing
    Block brewing of certain potions.

    Wearing Armor
    Block players from wearing certain armors.

    Creative
    Block getting certain items using the creative menu or mouse middle click.

    Pickup
    Block the pickup of items.

    Drop
    Block dropping of certain items.

    World Banned
    This will use the world scanner to remove blocks already placed on the map.


    No Dependencies.

    Install instructions

    • Place the plugin in the server plugins folder.
    • Start the server to generate the config.yml and the RestrictedItems.yml configs, then stop the server.
    • Open the config.yml and customize the settings, then open the RestrictedItems.yml to add items to the restricted list. You will find in the config file a lot of details about settings and how to add items to the restricted list.
    • Start the Server. Done, enjoy you server will be safe now.
    How to add items to the Restricted list?
    • Open the RestrictedItems.yml config and add the items there, you will find there details about how to do it.
    • Save the changes done and run the command /itemrestrict reload to apply the changes.

    Permissions
    • ItemRestrict.bypass --> Bypass all the restrictions
    • ItemRestrict.admin --> Bypass the item restrictions and access to the /itemrestrict reload command. Default to OP
    Ban Exceptions on some items only.
    Permission structure: ItemRestrict.bypass.itemID.dataValue.restrictionType
    Restriction types: use | place | break | craft | smelt | brew | creative | own | wear | drop | pickup

    Examples:
    • ItemRestrict.bypass.57.*.place
    • ItemRestrict.bypass.57.*.craft
    • ItemRestrict.bypass.57.*.*
    • ItemRestrict.bypass.57.10.own
    • ItemRestrict.bypass.57.10.*
    Commands
    • /itemrestrict and /itemrestrict help --> Will give you the help page
    • /itemrestrict reload --> Reloads the config.yml and RestrictedItems.yml configs. Needs permission: ItemRestrict.admin
    Configuration Example:
    General:
    #Enable restrictions on all worlds. (true or false)
    EnableOnAllWorlds: true
    #If EnableOnAllWorlds: false | Enable restrictions on following worlds only:
    Worlds:
    - world
    - test

    #Enable the world scanner. (true or false)
    #Runs every minute and scans 5% of loaded chunks.

    WorldScannerON: false
    #World Scanner scan delay in minutes. Default 1 minute.
    WorldScannerDelay: 1

    #Enable or disable sound effects.
    Sounds:
    #Enable or disable sounds when running commands. (true or false)
    onCommands: true
    #Enable or disable sound when applying restrictions. (true or false)
    onRestrictions: true

    #Enable or disable optional restrictions. (true or false)
    Restrictions:
    #Brewing Stand Restrictions. Block potions from brewing.
    EnableBrewingBans: false
    #Resting the wearing of certain armors.
    ArmorWearingBans: false
    #Creative Mode bans.
    CreativeBans: false
    #Pickup bans.
    PickupBans: false
    #Drop bans.
    DropBans: false
    #Block break bans.
    BreakBans: false

    #Other optional settings
    Settings:
    #For Ownership restrictions - restrictions will apply for player inventory only and not all inventory's. (true or false)
    #This is useful if you use some menus that contain restricted items and prevents the player from using the menu, if this is the case set this to true.

    OwnershipPlayerInvOnly: false


    #Chat messages. Supports color and format codes.
    #Minecraft Color and Format Codes: http://minecraft.gamepedia.com/Formatting_codes

    chatMessages:
    #Chat messages prefix.
    #To disable the prefix set it to '' ; Example: prefix: ''

    prefix: '&4&l[ItemRestrict] '

    #Chat messages.
    #The place holder: %reason will be replaced with the reason provided in the RestrictedItems.yml

    noPermission: '&cYou do not have permission!'
    restrictedConfiscated: '&cRestricted item confiscated! Reason: &7%reason'
    restricted: '&cRestricted item! Reason: &7%reason'
    pickupRestricted: '&cYou cant pickup a restricted item. Reason: &7%reason'
    ussageRestricted: '&cUssage of this item is restricted. Reason: &7%reason'
    craftingRestricted: '&cCrafting of this item is restricted. Reason: &7%reason'
    smeltingRestricted: '&cSmelting of this item is restricted. Reason: &7%reason'
    placementRestricted: '&cPlacement of this block is restricted. Reason: &7%reason'
    blockBreakRestricted: '&cBreak of this block is restricted. Reason: &7%reason'
    creativeRestricted: '&cYou cant use this in Creative Mode! Reason: &7%reason'
    reload: '&cConfig and RestrictedItems reload complete!'
    unknownCommand: '&cUnknown command! for help do:&7 /itemrestrict'
    brewingRestricted: '&cThis potion is restricted! Reason: &7%reason'
    wearingRestricted: '&cYou cant wear this armor! Reason: &7%reason'
    dropingRestricted: '&cYou cant drop this item! Reason: &7%reason'
    #Restricted Items List

    #----------------------------------------------------------------------------------------------------------------------------------------------------------
    #How to add items to the restricted list? Here is an example:
    #
    # - itemID:DataValue:Description:BannedReason
    #
    # itemID -> represents the item ID
    # DataValue -> represents the item damage value, to cover all values use *
    # Description -> here you can type anything, it's useful to type the item name so you know what item you banned
    # BannedReson -> (optional) Here you can provide a reason to let your players know why this item is restricted, the reason will be sent to players when they try to get/interact with a banned item.
    #
    # Example:
    # - 7:*:Bedrock:You can't get this item!
    # - 383:50:CreeperEgg:Used to grief
    #
    #----------------------------------------------------------------------------------------------------------------------------------------------------------


    #OWNERSHIP BANS - Block any kind of interaction with these items, like: Getting them from creative menu, item pick up, crafting, usage, placement.
    OwnershipBanned:
    - 137:*:CommandBlock:Example setting, you may need to remove this!
    - 422:*:MineCartCommandBlock:Example setting, you may need to remove this!

    #USAGE BANS - Block item or block usage only, also blocks entity damage! You don't need to add here items already added to OwnershipBanned.
    UsageBanned:
    - 145:*:Anvil:Example setting, you may need to remove this!

    #CRAFTING BANS - Block crafting without removing the recipe! You don't need to add here items already added to OwnershipBanned.
    CraftingBanned:
    - 57:*:Diamond Block:Example setting, you may need to remove this!

    #CRAFTING DISABLED - The following crafting recipes will be completely removed from the game.
    CraftingDisabled:
    - 77:*:StoneButton:Example setting, you may need to remove this!

    #SMELTING BANS - Block smelting without removing the recipe! You don't need to add here items already added to OwnershipBanned.
    SmeltingBanned:
    - 17:2:Birch Wood Log:Example setting, you may need to remove this!

    #SMELTING DISABLED - Smelting of these items will be disabled for everyone. These smelting recipes will be removed from the game.
    # !!!NOTE!!! - Add here the item resulted after smelting and not the item that will get smelt. Ex. for Iron add iron ingot and not iron ore.

    SmeltingDisabled:
    - 351:2:CactusGreen:Example setting, you may need to remove this!

    #PLACEMENT BANS - Block block place only! You don't need to add here items already added to OwnershipBanned.
    PlacementBanned:
    - 7:*:Bedrock:Example setting, you may need to remove this!

    #Block break BANS - Block break only!
    #(Optional restriction - Default is disabled - check config.yml to enable it)

    BlockBreakBanned:
    - 7:*:Bedrock:Example setting, you may need to remove this!

    #BREWING POTIONS BANS - Block brewing potions in brewing stand!
    #(Optional restriction - Default is disabled - check config.yml)

    BrewingBanned:
    - 373:16:Awkward Potion:Example setting, you may need to remove this!

    #WEARING ARMOR BANS - Block wearing of certain armors.
    #(Optional restriction - Default is disabled - check config.yml)

    WearingBanned:
    - 311:*:DiamondChestPlate:Example setting, you may need to remove this!

    #CREATIVE MODE BANS - Block using/getting these items with creative mode on only! You don't need to add here items already added to OwnershipBanned.
    #(Optional restriction - Default is disabled - check config.yml)

    CreativeBanned:
    - 399:*:Nether Star:Example setting, you may need to remove this!

    #PICKUP BANS - Block item pickup. You don't need to add here items already added to OwnershipBanned.
    #(Optional restriction - Default is disabled - check config.yml)

    PickupBanned:
    - 7:*:Bedrock:Example setting, you may need to remove this!

    #DROP BANS - Block item drop. You don't need to add here items already added to OwnershipBanned.
    #(Optional restriction - Default is disabled - check config.yml)

    DropBanned:
    - 265:*:IronIngot:Example setting, you may need to remove this!

    #WORLD BANS - The world scanner will remove these from your world.
    #(Optional restriction - Default is disabled - check config.yml)

    WorldBanned:
    - 46:*:TnT:Example setting, you may need to remove this!

    [​IMG]

    Notes!
    This plugin was inspired by popular TekkitCustomizer plugin, but as we needed some things changed and updated we coded this plugin from 0 with similar features and new options to fit our needs.



    If you like this resource and want to say thank you with a donation please use this PayPal button. Thanks!
    [​IMG]


    This plugin is made by CraftersLand Minecraft Community.
    :) Feel free to check us out at: www.craftersland.net

Recent Updates

  1. Fixes and improvements
  2. New stuff
  3. Fixes

Recent Reviews

  1. ArrowMark
    ArrowMark
    5/5,
    Version: 2.4.1
    This plugin its so good, i have a question how can i eliminated strength II, which its the ID of this potion plssss, im in the 1.8.8
  2. RFSMassacre
    RFSMassacre
    5/5,
    Version: 2.4.1
  3. hihl
    hihl
    5/5,
    Version: 2.4.1
    GOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOD
  4. bambu
    bambu
    5/5,
    Version: 2.4.1
    A very great plugin does exactly what it says, I recommend it!

    Though you might want to change all of the "&" into "ยง" otherwise you might get some weird letter "a" showing up.
  5. JaHollYT
    JaHollYT
    5/5,
    Version: 2.4.1
    Someone with an Update fpr 1.13 and especially 1.13 Items ?Good Plugin :) Update woud be so nice!!
  6. cooklover
    cooklover
    5/5,
    Version: 2.4.1
    omg this plugin has help me so much, i have tryed so many plugins that banitems and couldnt find one that would ban items in offnad and now i have i love this plugin thanks so much =D
  7. Fiiuden
    Fiiuden
    1/5,
    Version: 2.4.1
    The config for world don't work......
    Very bad plugin
  8. Roadhog360
    Roadhog360
    5/5,
    Version: 2.4.1
    This plugin looks great!
    Is it possible to make it so some items are taken away only in a certain world?
    I want to make dangerous grief-prone items be deleted when you enter spawn.
  9. devleuo
    devleuo
    4/5,
    Version: 2.4.1
    Awesome plugin.

    My only complaint is that there should be an option to not show messages when the plugin restricts something. Hopefully you can add that.
  10. Mavhill
    Mavhill
    5/5,
    Version: 2.4.1
    Very Glad to see this plug kept alive. Very useful and versatile. Hope it continues in the future. Thanks for your work.