BanItem [1.7+] - Speedgot

BanItem [1.7+] -----

Lightweight, powerful & configurable per world ban item plugin

Download Now
228.6 KB .jar

Fixes

v3.6:

Fix console error "BLOCK is not an item"
Fix offhand glitch with the transfer action

----------, Sep 1, 2024

New action + bug fixes

v3.5:

Added sweepingedge action (MC>=1.12): when the player attacks an entity with an item that has sweeping edge. The original attack will continue but the sweeping edge damage will be cancelled;
Added displayname-equals-regex for custom items
Added configurable worlds for illegal-stacks
Fixed lore-contains-regex metadata for custom item
Fixed entityinteract action throwing error (MC >=1.9 && MC <=1.15)

One year update ! The plugin is pretty stable.

----------, Oct 10, 2023

New action + bug fixes

v3.5:

Added sweepingedge action (MC>=1.12): when the player attacks an entity with an item that has sweeping edge. The original attack will continue but the sweeping edge damage will be cancelled;
Added displayname-equals-regex for custom items
Added configurable worlds for illegal-stacks
Fixed lore-contains-regex metadata for custom item
Fixed entityinteract action throwing error (MC >=1.9 and MC <=1.15)

----------, Oct 10, 2023

New action + illegal stack + bug fixes

v3.4:

Added mending action (MC>=1.13): when a player has an item repaired via the mending enchantment;
Added an illegal stacks item scanner: you can set custom max stacks amount for items and choose what to do if the player has an illegal stacked item into its inventory. (you have to delete the config in order to generate a new one which has this feature or copy and add this below)

Code (YAML):

# Illegal stack configuration
# You can either set the vanilla-max-stack-size to true, so all items will respect their max stacks
# And/or configure for each material the max stack amount you wish
# You can use the material formatting ('*', 'stone, dirt', '*,!dirt' etc.). Example regex: '#(?i)_helmet' -> will give all helmets
# Players with banitem.bypassillegalstack permission will not be affected
# The block-type are:
# - split (to split and give items back until the correct max stack is respected)
# - delete (to delete the whole stack)
# - deletemore (to delete only the exceeded amount)
illegal-stacks:
enabled : false
vanilla-max-stack-size : true
block-type : split
#items:
# 'diamond_helmet,iron_helmet':
# amount: 1
# block-type: split

Added complete item attributes matches for custom items (big thanks to Epicanard) (MC>=1.8):

Code (YAML):

mysword:
material : diamond_sword
attribute : GENERIC_ATTACK_DAMAGE:>2.3

Disabled particles by defaut in the config;
Fixed hoppers-block for transfer action;
Fixed offhand for entityinteract;
[Dev] Created, hosting and fixed maven repository for all dependencies;

----------, Jul 13, 2022

v1.18 update

v3.3.3:

Added reverted custom items:
- Using the reverted keyword, the plugin will revert the ban of a custom item (all items will be banned except the custom item);
Updated plugin for 1.18 and more:
- full recode of the versioning system which allows the plugin to work on several updates;

Happy new year!

----------, Jan 6, 2022

Custom permission + new action + multiple fixes

v3.3.2: HOTFIX

Fixed smith action error (MC>=1.16)

v3.3.1: HOTFIX

Fixed inventory error;
Fixed enchantments ban data;

v3.3:

Added smith action: when the recipe of an item is completed inside a smithing table (MC>=1.16);
Added custom permission per item/action:
- This is an important notable improvement for the permission system.
- This will highly optimize the permission system (both for the plugin and for you), and it's a great solution for groups permissions.
- You can set a custom permission like so:
  
  Code (YAML):
  
  blacklist:
  world:
  stone:
  place:
  message : '&cYou can not place a stone.'
  permission : 'mycustom.permission'
- Result: players with mycustom.permission permission will bypass the ban. No other permissions will be checked but this one.
- More information on the doc.

Fixed craft action:
- was displaying banned message even if the item does not match;
- now displays the crafted item but block it;
Removed "addeverywhere" from tab completition;
Fixed click action on air (thanks to @LoneDev): require 'click' priority into config;
Fixed transfer action for the workbench;
Fixed transfer action for dragging items;
Fixed water bottle error when using potion custom item;
Fixed error with inventories on 1.7;
Fixed error with entitydrop;
Code clean up;
PlayerBanItemEvent#getaction() and #getactiondata() are now deprecated (typo);

----------, Oct 25, 2021

Custom permission + new action + multiple fixes

v3.3.1: HOTFIX

Fixed inventory error;
Fixed enchantments ban data;

v3.3:

Added smith action: when the recipe of an item is completed inside a smithing table (MC>=1.16);
Added custom permission per item/action:
- This is an important notable improvement for the permission system.
- This will highly optimize the permission system (both for the plugin and for you), and it's a great solution for groups permissions.
- You can set a custom permission like so:
  
  Code (YAML):
  
  blacklist:
  world:
  stone:
  place:
  message : '&cYou can not place a stone.'
  permission : 'mycustom.permission'
- Result: players with mycustom.permission permission will bypass the ban. No other permissions will be checked but this one.
- More information on the doc.

Fixed craft action:
- was displaying banned message even if the item does not match;
- now displays the crafted item but block it;
Removed "addeverywhere" from tab completition;
Fixed click action on air (thanks to @LoneDev): require 'click' priority into config;
Fixed transfer action for the workbench;
Fixed transfer action for dragging items;
Fixed water bottle error when using potion custom item;
Fixed error with inventories on 1.7;
Fixed error with entitydrop;
Code clean up;
PlayerBanItemEvent#getaction() and #getactiondata() are now deprecated (typo);

----------, Oct 18, 2021

Custom permission + New action + multiple fixes

v3.3:

Added smith action: when the recipe of an item is completed inside a smithing table (MC>=1.16);
Added custom permission per item/action:
- This is an important notable improvement for the permission system.
- This will highly optimize the permission system (both for the plugin and for you), and it's a great solution for groups permissions.
- You can set a custom permission like so:
  
  Code (YAML):
  
  blacklist:
  world:
  stone:
  place:
  message : '&cYou can not place a stone.'
  permission : 'mycustom.permission'
- Result: players with mycustom.permission permission will bypass the ban. No other permissions will be checked but this one.
- More information on the doc.

Fixed craft action:
- was displaying banned message even if the item does not match;
- now displays the crafted item but block it;
Removed "addeverywhere" from tab completition;
Fixed click action on air (thanks to @LoneDev): require 'click' priority into config;
Fixed transfer action for the workbench;
Fixed transfer action for dragging items;
Fixed water bottle error when using potion custom item;
Fixed error with inventories on 1.7;
Fixed error with entitydrop;
Code clean up;
PlayerBanItemEvent#getaction() and #getactiondata() are now deprecated (typo);

----------, Oct 17, 2021

Improvements

v3.2:

IMPORTANT: the previous place action is now replaced with use (when the player uses right click with an item). The new place action now only check for block placed (BlockPlaceEvent).

Added use action: when the player right click with the item in hand (replace previous place);
Relaxed place action: only matches block placements;
NBTAPI into custom items can be written inline;
Enhanced info command:
- Custom items names shows if the item matches;
- Added bi info debug, to entirely debug an item with item meta (and more if NBTAPI available);
Added new hooks for custom items:
- AdvancedEnchantments (beta);
- ItemsAdder (big thanks to @LoneDev);
Added lore contains with regex for custom items;

----------, Jul 12, 2021

Multiple fixes;

v.3.1.1:

Added resistance potion alias;
Enhanced drops action for MC>=1.13.2;
Fixed metaitem get command;
Fixed enchants on custom item with enchanted book;
Fixed & improved wear action;
Fixed wear scanner shutdown after reload;
Fixed smelt action for forge;
Fixed some permissions with custom items;
Fixed permissions with meta items;
Code cleanup;

----------, Apr 21, 2021

Multiple enhancements;

v3.1:

Recoded & highly optimized whole custom items system:
- You can now set multiple materials (also support regex);
- You can now use friendly minecraft potions names;
- You can now set interval levels for potions, enchantments and durability;
- Added integration with NBT-API: matches custom NBTs;
- Fixed durability matches for MC<1.13;
Commands:
- Removed /banitem addeverywhere;
- Modified /banitem add command to allow:
  - Writting none, one or multiples worlds;
  - Writting none, one or multiples materials;
  - Usable from console;
- Modified /banitem remove command to allow:
  - Writting none, one or multiples worlds;
  - Writting none, one or multiples materials;
  - Usable from console;
Config:
- Added configurable activable/deactivable debug section:
  - errors: better debug for errors (was already available);
  - reload: more details when reloading the plugin;
  - colors-console: color codes into the messages on console;
Added a wear scanner: will check (async) each second if a player is wearing a banned item;
Added 'allitems' bypass permission;
Fixed data into permissions (ex: entity type in 'attack' action);
Fixed NPE when using the command before the plugin is loaded;
Multiple other fixes & enhancements;

----------, Mar 24, 2021

Fixes

v3.0.1:

Added unbreakable metadata for custom items: check if the item is unbreakable;
Fixed FurnaceExtractEvent error with break action;

----------, Feb 3, 2021

Major update

v3.0:
!!There are many changes into this update: previous configuration files may not work anymore!!
Please read carefully everything before updating!

NEW:
- Custom items:
  - they are now customizable bannable items created in customitems.yml;
  - they can have configurable item metas, this allows easier bans;
- Meta items:
  - previously named "custom items";
  - items that match the exact item meta;
- Renamed options to actions
REMOVED:
- Removed metadata: they are now part of custom items!

ADDED:
- Added enchant action: when a player enchants the item, with anvil or enchantment table;
- Added hold action: when the player holds the item;
- Added support of hex codes for 1.16+ (ex: &#1258DA)
- Added regex for item names & worlds names using a hashtag (#):
  - Example: #world will get world, world_nether & world_the_end;
- Added '/bi load <filename>' to load differents configurations files;
- Added '/bi addeverywhere' to ban an item in all worlds;
- Added 'run' action data, it's a commands list executed when a banned action is done;
- Added modeldataequals for custom items: to matches items with model datas (MC>=1.14);
- Added lore_line_contains for custom items: if a string from a line of the lore matches;
- Added an option in config to cancel the delete action in some inventory (using titles);
- Added friendly enchantments names for all versions;

Permissions:
- Enhanced permissions checks & compatibility;
- Should now be fully compatible with GroupManager;
- Added banitem.bypass.*;
- Added banitem.bypass.world.*;
- Added banitem.bypass.allworlds.*;

Fixes:
- Fixed brewing action (ingridients/potions);
- Fixed a bug with break action;

API:
- Added a DeleteBannedItemEvent : run when an item should be deleted from a player inventoryview;
- Multiple Code & Performance enhancements;

Feel free to report to me any bugs/suggestions!

----------, Jan 21, 2021

New option + fixes

v2.4:

New option bookedit: when the player edits or signs a book and quill item;
[Config] Added wear worldguard region check (configurable): the plugin will check the player's equipment when changing regions;
Fixed swap shift+click;
Fixed color codes deserialization;

----------, Aug 19, 2020

1.16 support + multiple addons/fixes

v2.3:

Added 1.16 support;
Added WorldGuard region support (http://banitem.andross.fr/doc.html#options-data-region);
Added 'inventoryclick' option: can not click this item in any inventory;
Added 'rename' option: can not rename the item in an anvil, or from a (configurable) rename commands;
Added configurable prefix;
Added support of potions levels for metadata;
Added update checker (configurable);
Added metrics;
Updated config file with new 'options' section: multiple configurations available for some options;
Better recognition for craft option;
Fixed swap option (+ no more drag item into inventory);
Fixed specific subcommands permissions;
Whole project restructure (packages, pom...);
Updated API;

----------, Jul 2, 2020

New options + fixes

v2.2:

Added 'fill' option: block when a player try to fill a bucket with a fluid;
Added 'unfill' option: block when a player try to unfill a bucket;
Improved & fixed wear option;
Fixed delete option for items with metadata;
Fixed clientside inventory visual bug if an item is banned (MC<1.12);
Code cleanup

----------, Jun 2, 2020

Fixes

v2.1.2:

Added available enchantments & potions name list in /banitem help;
Fixed metadata potion names. They are also correctly debugged if not valid;
Fixed metadata enchantments for enchanted book;
Fixed events activation versions compatibility: no more errors if trying to use an option unavailable for the current minecraft version;

----------, May 10, 2020

Fixes

v2.1.1:

Fixed multiple same items in config overriden: now correctly add items instead of overriding them;
Fixed potion metadata for MC<1.13;
Fixed durability recognition for MC<1.13;

----------, May 7, 2020

Full Documentation! + fixes & metadata

v2.1:

Added metadata ban data -> ban items only if they have a custom metadata (durability, displayname, lore, enchantment...);
Entitydrop option now correctly support the player bypass permission;
Optimized check command;
Optimized blacklist & whitelist map;
Fixed left hand utilisation;

Full documentation on: https://banitem.andross.fr/

----------, May 4, 2020

Fixes

v2.0.1:

Fixed info command;
Fixed check command;
Fixed drops option (FurnaceExtractEvent error);
Fixed <1.8 rare exception;

I'm available & i will fix any errors if reported!

----------, Apr 30, 2020

-[Major Update & Improvements]-

v2.0:

New option brew: when the item is brewed into a brewing stand;
New option drops: remove item drop from a breaked block;
New option entitydrop: when the item is dropped by an entity;
New option glide: when trying to glide with an elytra;
New option hangingplace: when a player try to place a hanging item (itemframe, painting...);
Option 'inventory' renamed to transfer, optimized & fixed: can not transfer an item from an inventory to another;
Option wear optimized & fixed. Now also automatically give the item back (in inventory, or drop it if full) if a player already wear an item & change the world;
Creative option is now part of ban data gamemode;
Added options data:
- Can now check multiples datas depending of the option (entity involved, inventory used, player gamemode etc.)
- Added a 'gamemode' data, which will consider the player gamemode to apply the ban or not
- Added a 'log' boolean data, which allows players in game to be directly notified if player use a banned item, with /banitem log
- Added a 'cooldown' (in milliseconds) long data (non persistent), the ban only applies if players aren't in cooldown
New in configuration:
- Better debug: displays a more detailled debug message, if something is not loaded well;
- Hopper transfer block: if it's enabled and if an item has transfer option, this will be blocked;
- Use the event api: to let others plugins modify the behavior of a banned action
- You can now set multiples ban messages (using a list)
Commands improved, commented & added new ones:
- /banitem log: activate the live log mode, sending message (of banned items with 'log: true') to them;
- /banitem add <name> <options> [message]: to directly ban in game an item (type, without metadata);
- /banitem ci add <name> [options] [message]: to directly ban in game an item (with metadata);
- /banitem help <type>: give some informations about a specific type (option? entity? etc.);
Materials now also supports '*' & '!' operators, and correctly support AIR (player empty hand)
Fixed & optimized whitelist;
Fixed rare exceptions where custom items aren't banned;
Fixed custom items;
Fixed command permissions;
Fixed display of custom items permissions in /banitem info;
Recoded & optimized large part of the code;
Recoded & optimized API. New PlayerBanItemEvent. Every class is now documented.

As always, if there is any bug/questions/suggestions, I'm available here, by pm, or on my discord (Andross#5254)

----------, Apr 25, 2020

Fixed custom items for MC1.13+

v1.9.9.3:

Fixed custom items persistence (not recognized anymore after reload) for Minecraft 1.13+

----------, Apr 4, 2020

New options + multiple fixes

v1.9.9.2:

Added new option attack: can not attack an entity with the item;
Added new option consume: can not consume the food item;
Added new command /banitem customitem get <name>: to get the custom item in your inventory;
Added tab completition: commands can now be completed with tabs. Also display available custom items name into custom item commands;
Added a allworlds permission, which include all worlds: banitem.bypass.allworlds.apple.consume
Better Worlds configuration: can now be excluded: *, !world -> all worlds, except 'world';
Better Options configuration: can now be excluded: *, !pickup -> everything banned (not include creative & delete), except 'pickup';
Whitelist deactivated by default in config.yml (commented);
Better command integration with Bukkit: does not display the command to player if do not have the permission;
Fixed delete permission;
Fixed custom item visual amount bug;
Code reorganization;

Do not hesitate to review, or give me suggestions (Andross#5254) .
The 2.0 update will contains even more feature!

----------, Mar 30, 2020

[Important] Worlds FIX

v1.9.9.1:

Fixed problem where items are not correctly banned in some other (custom) worlds (case sensitive issue)

----------, Mar 5, 2020

Fixes

v1.9.9:

Fixed whitelist
Fixed armorstand events
Fixed 1.7 compatibility

----------, Feb 19, 2020

1.15 support & new options

v1.9.8:

Added the swap option: when the player try to swap the item in hands
Added the armorstandplace option: when the player try to place the item on an armorstand
Added the armorstandtake option: when the player try to take the item from an armorstand
Updated the config ban options list: Options can be written single 'break', multiple 'break, place' or '*' will include all options (except creative & delete)
Fixed compatibility with 1.15

----------, Jan 7, 2020

Added "wear" option + craft option fix

v1.9.7:

Added the wear option: players can't equip the item (armor);
Fixed an error with the craft option (thanks to @IceFrogg)

----------, Oct 29, 2019

Fixed smelt option

v1.9.6:

Fixed another error with the smelt option (thanks to @IceFrogg)

----------, Oct 12, 2019

Fixed smelt option

v1.9.5:

Fixed errors with the smelt option (thanks to @CaoTrongThang)

----------, Oct 4, 2019

Multiple addons + fixes

v1.9.4:

Added new permission based on option: banitem.bypass.WorldName.MaterialName.Option
Added craft option: the player will not be able to craft the item anymore
Added smelt option: the player will not be able to smelt the item anymore
Added configurable particle & sound effect for banned items
Added new methods in developer api (+ added maven repo on github)
Fixed delete options: now correctly send a message, if configurated
Fixed rare issue with whitelisted custom items

----------, Sep 28, 2019

Bug fixes

v1.9.3:

Fixed prohibited items can be used when they are renamed on the anvil (or durability changed) - thanks to @IceFrogg
The delete option now applies when player open or close any inventory

For any (possible) bug or suggestions, please contact me.

----------, Sep 19, 2019

Added click option

v1.9.2:

Added new click option: the banned item can not be used with a left click (like tools [pickaxe, axe etc.]), thanks to AlarmClock for the suggestion.

----------, Sep 18, 2019

Added 'delete' option

v1.9.1:

Added new delete option for blacklist: when a player open an inventory (except his), the plugin will automatically delete banned items in it (considering the world)

----------, Sep 10, 2019

Added "dispense" option + fixed some bans

v1.9:

Added dispense ban option: block/allow an item to be dispensed from a block
Fixed some rare case where items are not banned (it deals with datas)

----------, Aug 29, 2019

Fixed durability for custom items

v1.8.1:

Fixed banning custom items with different durability (thanks @Crayzeur)

----------, Aug 24, 2019

[Stable] New command + Fixes

v1.8:

Added new command /banitem check [delete]: give a list of players which has a blacklisted item in its inventory (respects the world); use the delete argument to remove them;
The command /banitem info now correctly shows a custom name, if its the case;
Replaced the use option with the place one: for example, to ban the use of an enderpearl, the option will be place (stability and code performance reasons)
Added an 'ignored' options key for whitelisted worlds: by default in a whitelisted world, you can not place/break/use/interact/pickup & drop items, you can now choose to disable some;
Fixed whitelist worlds: all options are correctly usable;
Fixed world recognition: worlds created by others plugin are now correctly supported;
Fixed double messages;
Code & listeners reorganisation

----------, Aug 23, 2019

Added support for custom items + fixes

v1.7:

Added support for custom items (with differents item meta, name etc.): it offers possibility to ban modded items or specific items (like potions);
Fixed bug with the use option;
Whitelist config reorganization & options fixed;
Code: reorganization, optimization & clean up;
Added developer API: check, add or remove a banned item, easily access to the plugin

----------, Aug 20, 2019

Added "use" and "creative" options

v1.6:

Added new use option: ban the use (right click) of items (like lava_buckets, ender_pearl etc.)
Added new creative option: the ban will apply only if the player is in creative mode
Fixed rare issues when other plugins blocks this one

----------, Aug 7, 2019

Inventory option, messages for each options, multiples fix and new command

v1.5:

New inventory option: item can be inventory-banned, means that transfering a banned item from an inventory to another is blocked;
Configuration reorganization: you can now set a custom message for each banned options;
Added new command /banitem info: will give the exact material name (to use in config) & permission node for the item in your hand;
Fixed spawn eggs banning;
Fixed pickup message cooldown;

Due to (final) configuration reorganization, you'll have to update your config.yml.

----------, Jul 13, 2019

Added whitelist mode

v1.4:

Added whitelist (thanks for suggestion @TheBlueKing)
Fixed drop option
Code & config reorganization

Due to config reorganization, you'll have to reconfigure your previous config.yml.

----------, Jul 6, 2019

Improvements

v1.3:

Simplified the config file
Added "creative" options: ban apply only if the player is in creative gamemode
Added new "per material per world" bypass permission: banitem.bypass.<WorldName>.<MaterialNameInLowerCase>
Fixed some version compatibility issue

----------, Jun 1, 2019

Compatibility update

v1.2: