- Tags
-
- Tags
- None
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.
Features
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
Permissions
Permission structure: ItemRestrict.bypass.itemID.dataValue.restrictionType
Restriction types: use | place | break | craft | smelt | brew | creative | own | wear | drop | pickup
Examples:
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.
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.
======> My Plugins <======
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.
- 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.
- 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.
- 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
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.*
- /itemrestrict and /itemrestrict help --> Will give you the help page
- /itemrestrict reload --> Reloads the config.yml and RestrictedItems.yml configs. Needs permission: ItemRestrict.admin
# default config.yml for ItemRestrict
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: Formatting codes – Minecraft Wiki
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'
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: Formatting codes – Minecraft Wiki
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'
#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:*
iamond 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:*iamondChestPlate: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!
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:*
iamond 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:*
iamondChestPlate: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!
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!
This plugin is made by CraftersLand Minecraft Community.
Feel free to check us out at: www.craftersland.net
Feel free to check us out at: www.craftersland.net
