BanItem [1.7+]

v3.7: · Add new action "crafter" (MC>=1.21): prevent Crafter block to craft an item ; · Add PlaceholderAPI support in ban messages ; · Add PlaceholderAPI support in ban commands run ; · Add PlaceholderAPI condition (depending of a variable) for banning an item ; · Worlds with spaces are now supported ; · Fix AdvancedEnchantments hook ; · Fix hold offhand inventory glitch ; · Fix metaitem remove command ; · Internal code clean up + methods name standardization + update javadoc ; · API Breaking Change: · changed "BanVersion" class to "MinecraftVersion" · removed deprecated methods in PlayerBanItemEvent

v3.6: · Fix console error "BLOCK is not an item" · Fix offhand glitch with the transfer action

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.

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;

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!

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);

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);

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);

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;

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;

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;

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

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!

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;

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;

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

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;

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;

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/

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!

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)

v1.9.9.3: · Fixed custom items persistence (not recognized anymore after reload) for Minecraft 1.13+

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!

v1.9.9.1: · Fixed problem where items are not correctly banned in some other (custom) worlds (case sensitive issue)

v1.9.9: · Fixed whitelist · Fixed armorstand events · Fixed 1.7 compatibility

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

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

v1.9.6: · Fixed another error with the smelt option (thanks to @IceFrogg)

v1.9.5: · Fixed errors with the smelt option (thanks to @CaoTrongThang)

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

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.

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.

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)

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)

v1.8.1: · Fixed banning custom items with different durability (thanks @Crayzeur)

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

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

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

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.

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.

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

v1.2: · Added support version for 1.11, 1.10, 1.9, 1.8 & 1.7 · Optimized listeners (not listening if not needed) · Code cleanup

v1.1: · Banned items prevents now interactions (configurable) · Added per world bypass permission · Added a reload command · Code cleanup