1.21.2 & 1.21.3 Support, Bugfixes

ItemJoin-v6.1.1-RELEASE

Changelog

Added:

• 1.21.2/1.21.3 Support (0953236)
• first-wild trigger (1ac6f2d)
  • Gives the item once upon the player joining for the first time. It will also give the item to the player every time they respawn as long as they didn't respawn at a bed or anchor.
• respawn-point trigger (b073f20)
  • Gives the player the item upon respawning as long as they respawned at a bed or anchor.

Fixed:

• memory usage (19500db)
• respawn trigger(s) (4d99408)
• deprecated compatibility (cd7e1a8)
• revealing ghost items (deeaec3)
• CarbonSpigot Support (38b34c7)
  • Implements a fallback for when the #isEmpty method is missing from the Bukkit Inventory.
• Menu ConcurrentModificationException (2ba14c3)
• null item when animating (c5105b4)
  • Sometimes animations would cause an item to return null.
• invisible menu items (f8edb6f)
• disabled regions (9f6364d)
• Metrics Logging (6e0b69e)
  • Setting Metrics-Logging to false in the config.yml ended up doing nothing because the value wasn't being checked programmatically.
• menu saving (3e26789)
  • Trying to save a modified or new custom item via /itemjoin menu would incorrectly fail when an item count or command cost was not specified.
• region messages (8e510a6)
  • Region triggers for custom items were causing a lot of message spam for overwrite or inventory full failures in addition to debugging messages. This would happen every time the player moved which was not intended.
• Active-Commands first-join (1475481)
  • The first-join trigger/executor was being ignored for Active-Commands defined in the config.yml. Proper function is now restored, first-join will only execute once per-world.
• slot clearing blacklist (d86298f)
  • Defining custom slots to be blacklisted from clearing as in; HELMET, CHESPLATE, LEGGINGS, BOOTS, and OFFHAND would be ignored.
• SkinsRestorer API (3eee1f8)
  • When SkinsRestorer is in proxy mode or stuck loading it throws errors when initializing.

Changed:

• renamed respawn-point to respawn-wild (3bdefee)
  • This naming scheme was counter intuitive and confusing.
• GitLab to Jenkins (b9ab699)

1.21 & 1.21.1 Support, New Features, Bugfixes

ItemJoin-v6.1.0-RELEASE

Notice: This release contains a major change to item permissions. If you define a custom permission-node for an item, this will be required in order to get the item, ignoring any permission settings in the config.yml. It is now expected that by setting a custom permission-node you actually want to have permissions be required for that item.

Changelog

Added:

• 1.21 & 1.21.1 Support.
• Folia Support.
  • Folia is a new fork of PaperSpigot that adds regionized multithreading to the server.
• no-clear itemflag
  • Prevents the player from using any plugins /clear commands to remove the custom item.
  • Executing /clear will now clear all items excluding any custom items with the no-clear itemflag.
• %state% placeholder for toggle command messages.
• erase-drops itemflag
  • This itemflag entirely removes the item from the player when they try to drop it or on-death.
  • Unlike the self-drops counterpart, the item is not given back.
• Polish Language translation.
  • Thanks @Coreli0!
• selectable-delay
  • You can modify your selectable itemflag individually for each item by specifying selectable-delay: 1 on your item to increase the amount of time the user is allowed to have the item selected before they are forced to unselect it.
  • By default, the selectable itemflag no longer has a delay, you can add this delay to increase the amount of time the user can select the item. For each numerical value (1..., 2..., 3...) adds 10 ticks, so 1 is half a second, 2 is a full second, 4 is two seconds, etc.
• disabled-regions
  • This was added as a replacement for region-priority, the idea of this is to allow the specification of enabled-regions while having the ability to disable specific regions inside the enabled-regions. There are other use cases for this but it was the main reason for being added.
  • This prevents region-enter and region-access items from being given in those regions, (region-access will have them auto-removed).
  • This also allows region-leave and region-egress items to be given in those regions (works best if they are a sub-region inside an enabled-region)
• on-join item command
  • You can now add on-join item commands to custom items.
  • This will only trigger if the player already has the custom item while joining the server, not after getting the item.
  • This respects and waits for AuthMe authorization.
• item command permissions
  • Every command action can have its own permission or set of permissions required to execute the command. In the example below I use interact, but this can be anything like interact-right, interact-left, inventory, inventory-creative, etc.
  • You can use a ! symbol in front of the permission to invert the condition, making the permission strictly not required to execute the command. If they have that permission and it's not set to false then they will not be allowed to execute the command.
  • Example;

    interact:
    - 'console: eco give %player% 5000'
    interact-permission: 
    - '!itemjoin.group.owner'
    - 'itemjoin.group.newbies'
    interact-fail-message: '%prefix% &cfailed to execute the interact-right commands.'

• Inverted permission-node on custom items.
  • You can now use the ! symbol to invert the permission requirement from permission-node on custom items.
  • Example; permission-node: '!fish.cakes' - players without this permission will be given the item.
• Entity selectors can now be used in plugin commands.
  • Example; /itemjoin get item_1 @a[team=afk]
• commands-cost can now accept placeholders and double values.
  • Example; commands-cost: '%player_deaths%' - increases the cost to execute a command each time the player dies.
  • Example; commands-cost: 1.5 - will charge exactly $1.5 from the economy balance.

Fixed:

• AuthMe authentication.
  • AuthMe authentication was bypassed when any region trigger was defined.
• stackable itemflag duplication.
• self-drop itemflag
  • With an open GUI menu from any plugin you could drop the item from your inventory via your cursor.
• placement itemflag
  • Containers can now be opened when the placement itemflag is present.
  • Previously the itemflag would prevent containers like chests from being opened.
• item conditions
  • If a placeholder had a colon inside it, the conditions would fail to parse.
• AutoCraft bug
  • Inventories smaller than 4 slots would cause the AutoCraftEvent to break, for example a furnace.
• Data loading
  • Added a short delay to allow items to properly generate before finalizing the data.
• fireworks use-cooldown
  • The use-cooldown would fail to function with fireworks if the player was actively flying with an Elytra.
• region triggers debugging
  • Disabled "player has item" debug messages for region triggers as they are not necessary and are quite spammy.
• /ij get fail count
  • Using /ij get, getAll, or getOnline with a non-ItemJoin item occupying the custom item slot would incorrectly say the player has all items.
  • Now the number of failed items to be given will be displayed if the custom item slot is occupied.
• accidental removing of vanilla recipes.
  • Furnace, stone cutter, and enchant recipes were accidentally being removed on /ij reload resulting in them being non-functional.
  • The way recipes are removed has been changed to only remove ItemJoin recipes.
• crafting items death-keep and death-drops
  • Crafting items were not being returned despite having the death-keep itemflag defined.
  • Crafting items were not being cleared if death-drops was defined.
• death-keep breaking item animations.
• death-keep online check.
• death-keep itemflag with multi-slots
  • Multi-Slots were not being properly restored, instead they were being stacked.
• AuthMe authentication
  • If a user hasn't logged in but hovered over a slot that previously had an ItemJoin item, the Item Commands could be triggered.
  • AuthMe does not remove items from the player inventory, they simply are made invisible (ghosts).
• Illegal characters in chat.
  • Only occurred with alternative versions of Spigot, like PaperSpigot.
  • The issue typically was with using chat colors in item commands.
• /ij get enabled-worlds checks.
  • The get commands were not checking to see if the player was in an enabled world for the item.
• Clear-Items region clearing.
  • Items were constantly being cleared and restored instead of only doing so once.
  • The original functionality of Region-Enter clearing has been restored.
• /ij dump (paste api)
  • Servers would crash in some geo-blocked locations.
• count-lock bug with projectiles.
  • 1.20.5/1.20.6 broke the built-in API for blocking item consumption so a custom method has been added to replace this.
• inventory-creative commands.
  • A bug would occur when shift+clicking "Destroy Items" in creative mode while having an item defined with inventory-creative commands.
  • Clicking "Destroy Item" would cause any item in the player inventory with inventory-creative defined to execute.
• Check for updates bug.
  • Major version jumps would not be handled properly causing the updater to get confused.
• Purge commands.
  • Trying to purge an entire data-set (not specifying a player) would result in a "command not found" error.
• ChestSort API double-clicking bug.
  • Would cause custom items to duplicate when sorting.
• Concurrent Exceptions.
• Permission pages.
  • Would list duplicates.
• Many many miscellaneous legacy Minecraft bugs.

Changed:

• selectable itemflag.
  • Removed delay and added other special cases like click-dropping items and giveTo triggers.
• In /ij menu the CustomModelData definition will now show a preview of the model data.
• Rewrote timers to function better.

Major bugfixes

ItemJoin-v6.0.7-RELEASE

Changelog

Added:

• Permission-Switch trigger.
  • Adding this trigger to a custom item will allow it to be given at the moment the permission is granted to the user.
  • If the permission is revoked the custom item will be automatically removed.

Fixed:

• 1.17.0 - 1.17.1 bug with not being able to join the server when defining a custom book item.
• JSON Books being non-functional for Legacy Minecraft versions 1.8 - 1.20.4.
• Menu would break if items are empty or null in the items.yml.
• Menu region-egress trigger being broken.
  • Was incorrectly referenced as region-engress instead of region-egress.
• Menu disable triggers not removing all triggers.
  • A few new trigger values were missing instead, the list is just cleared rather than being checked.
• Legacy Minecraft animation spam when updating the Player Inventory.
  • Even if no action was taken to the player inventory a force update was incorrectly triggered.
• Legacy PotionMeta bug.
  • ItemMeta was incorrectly specified in the reflection.
• Another VirusTotal false-flag.
  • This is very unlikely to happen again, the method has been entirely rewritten.
• commands-cost bug.
  • Users with a balance in the negatives (less than zero) would not be allowed to execute commands regardless of commands-cost being specified.
  • commands-cost being set to zero or not defined now allows the commands to execute properly.

Changed:

• Dump URL is now interactable.
  • Easier to copy the URL.

1.20.5 & 1.20.6 Support, Bugfixes, and New Features.

ItemJoin-v6.0.6-RELEASE

Changelog

Added:

• on-drop item command.
  • If you drop an item with on-drop command(s) specified these will execute.
  • Example;

  example-item:
    id: DIAMOND_SWORD
    slot: 0
    on-drop:
      - 'message: &cCome back! You left me behind!'

• model-data, durability, and data saving using the in-game menu.
  • Previously this information was not saved when trying to import an existing item.
• Snapshot update checking.
  • If you ever download a snapshot from our integration server ItemJoin now checks for updates to see if a new snapshot is available.
  • If a snapshot update is found it can be automatically fetched via /itemjoin upgrade.
  • Additionally, if a snapshot is outdated because it has officially hit the release stage, you will be moved off of the snapshot branch to update to the official release. You will not be automatically moved to the next snapshot branch (Aka v6.0.6 to v6.0.7). If you wish to move to the new snapshot versioning you will need to manually download it. This is done to encourage updating to the official release since initial snapshots after an official release are typically unstable.

Fixed:

• Bug with custom items being held in a cursor was not being removed.
• Trigger conditions being erased when saving using the menu.
• MCAntiMalware false-flag bug.
• VirusTotal false-flag bug.
• World-switch null item bugfix.
• Item Statistics being lost when reloading (Enchantments, Placeholders, etc).
• no-hat itemflag bugfix.
  • If this was enabled on the item and you typed in chat or executed a command that contained the characters hat the message or command would be blocked.
  • EX; What are you doing? would be blocked due to hat existing inside what.
  • Now supporting types are defined, currently EssentialsX /ehat, CMI /cmi hat, and General /hat are currently blocked, more can be added if needed in the future.
• Null animations bugfix.
  • Items could continue to try to animate even when the player was offline or the item didn't exist for the player.
• Death-Chest / Tombstone plugin bugfix.
  • death-drops / death-keep itemflags now properly prevent the item from being stored in a death chest from plugins like AngelChest.
• Custom consumable potion effects bugfix.
  • These were functioning outside their defined enabled-worlds.
• Null crafting items bugfix.
• NMS bugfix.
  • The NMS checker would always think it was running a developer version.
  • This function exists to alert the player if they are using ItemJoin on a server version newer than what ItemJoin has been compiled and tested against.
• Arbitrary item stacking bugfix.
  • Items with the arbitrary slot specified were not automatically stacking where applicable, instead they were always given in a new slot when using the /itemjoin get command.
• Move-next itemflag bugfix.
  • If the player had already been given the item, it would try to move itself to the next available slot despite not needing to be given.
• Limit-switch bugfix.
  • This was just straight-up broken and non-functional when WorldGuard was enabled on the server.
• Limit-modes bugfix.
  • Old gamemode references were being used when respawning or switching worlds due to the item delay causing the item to be given (or not given) when it was supposed to.
  • Gamemodes are now properly checked at the exact time the item is to be given or removed.
• Null NBT bugfix.
  • Some item types were being detected as ItemJoin items because they had NBT data even though it didn't match ItemJoin's data.
  • NBT data is now properly checked and verified.
• Miscellaneous Menu bug fixes.
• Bug with how items are displayed as loaded.
  • The incorrect number of items successfully loaded were listed in console at startup.
  • All items would be listed if they were successfully read instead of listing items that were successfully loaded into memory.
• disposable itemflag duplication bugfix.
  • Items using the disposable itemflag but not having the item-store itemflag defined could result in item duplication when storing the item into chests or clicking on item-frames, armor stands, and other entities.
• Major recipe bugfix for recipes with custom ItemJoin items defined.
  • These simply wouldn't work and would break the default crafting table functionality.

Changed:

• death-keep itemflag.
  • This now functions more as a death-keep itemflag as the name implies.
  • Only items that currently exist at the time of death with the death-keep itemflag will be kept upon respawning.
  • If they do not meet the conditions to be given (enabled-worlds, enabled-regions, or limit-modes) the item will not be kept.
• PlayerAutoCraftEvent whitelisting.
  • Plugins that utilize the PlayerAutoCraftEvent to open GUI menus can now request to be added to the whitelist.
• Region triggers are now handled differently.
  • Instead of checking the regions when entering/leaving them the regions are always checked on player movement every 10 ticks.
  • This may result in higher timings but this makes the triggers more accurate reducing bugs and glitches.

Bug fixes

ItemJoin-v6.0.5-RELEASE

Changelog

Added:

• dynamic-count itemflag.
  • Automatically sets the items count back to its original defined stack size defined in the items.yml.
  • The dynamic or animate itemflag must be enabled for this to function.
  • This was originally a feature by default but now must be specified via this new itemflag.

Fixed:

• SkinsRestorer API bugs...
• Hex colors not properly functioning for custom book pages or the messages command identifier.

1.20.4 Support, New Features & Bug fixes

ItemJoin-v6.0.4-RELEASE

Changelog

Added:

• 1.20.3/1.20.4 Support.
  • Note that old JSON books will likely break!
  • Note that old items with the glowing itemflag will likely break!
• splittable itemflag.
  • Items with this itemflag will not allowed to be "split" if their amount is greater than 1.
  • Blocks both right-click splitting and click-dragging.
• damage command instance.
  • You can specify the amount of damage (durability) an item takes upon executing the command.
  • If durability hits 0 (or below) it will be automatically removed.
  • Example;

  example-item:
    id: DIAMOND_SWORD
    slot: 0
    interact:
      - 'damage: 15'
      - 'message: &cI have lost 15 durability points!'

• on-kill command executor.
  • Executes the command set upon killing a Player.
  • Example;

  example-item:
    id: IRON_SWORD
    slot: 0
    on-kill:
      - 'message: &aYou killed a player!'

Fixed:

• Null check bug fixes for Legacy Minecraft.
• Java 8 support.
  • Some newer methods were accidentally implemented resulting in errors in Java 8.
• Death-drops bugfix with multi-slots.
• Major recipe bug that caused a server crash.
  • Typically only occurred if you had an item with the vanilla itemflag defined and tried to craft items.
• Implemented fall-back toggle messages into the lang.yml files.
  • Furthermore the plugin prefix has been removed from custom toggle messages that are defined per-item.
• CheckforUpdates bugfix.
  • Just wasn't working, accidentally hard-coded instead of checking config.yml.
• GameProfiles/PlayerProfiles are now properly cached.
• Auto Chat-Tab-Completion for the upgrade command. Was still set to autoupdate which no longer exists.

Changed:

• enchantment: and enchantments: are now acceptable on an item.
  • Previously only enchantment: would function.
• /itemjoin dump has been switched to a self-hosted paste alternative.
  • Pastebin has been dropped, mainly because of it being blocked in quite a few regions.
• Relocated ChaosCore package to be directly inside the main package.
  • Fixes conflicts with other plugins using ChaosCore.

Removed:

• Minecraft 1.7 support.
  • According to statistics, nobody is using this version and it was A PAIN to support.
  • There is no reason to be using this instead Minecraft 1.8 should be used to avoid combat mechanics...

1.20.2 Support & Bug fixes

ItemJoin-v6.0.3-RELEASE

Changelog

Added:

• 1.20.2 Support
• respawn-point trigger.
  • An item with the respawn-point trigger defined will ONLY be given if the player is NOT spawning in a bed, anchor, or spawn-point.
  • To further clarify, the item will be given if spawning randomly in the wilderness, or at a set spawn such as an EssentialsX spawn.
• Added Italian Language by Ale1x
• Latest SkinsRestorer Support.
• Region triggers now support the auto-remove itemflag.
• Armor Trim Support.
  • You can now specify trim-meta for your item to change its trim and trim color, this can be done manually or in the menu.
  • This should be defined as trim-meta: MATERIAL:PATTERN on your item, this could look as follows; trim-meta: LAPIS:COAST.
  • List of supported materials; https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/inventory/meta/trim/TrimMaterial.html#AMETHYST
  • List of supported patterns; https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/inventory/meta/trim/TrimPattern.html
  • Example item;

  trim-test:
    id: DIAMOND_CHESTPLATE
    slot: CHESTPLATE
    trim-meta: LAPIS:COAST

Fixed:

• Bug with enchantments not working after reload.
• GameProfile bug fixes.
  • Designed a GameProfile caching system.
• first-life itemflag bugfix.
  • Simply just wasn't working.
• Item Recipe bugfix for Legacy Minecraft.
• ProtocolAPI & TinyProtocol bugfixes.
• Arbitrary slot bugfix for Legacy Minecraft.
• JSON bugfix for Legacy Minecraft.
• Bugfix for Book items in Legacy Minecraft.
• Bugfix for global ItemMovement bypass.
  • Despite a bypass being set, all itemMovement was blocked.
• Custom map image bugfix.
• NMS Checker.
  • Using ItemJoin on a version of Minecraft NEWER than the version it was compiled for will now properly throw a not-supported warning.
• Arbitrary slot bugfix for get and getall commands.
  • If one of the listed arbitrary slots were missing, it would say you had all items despite missing a defined slot.
  • Now all slots will be properly filled.

Changed:

• Reformatted a lot of the major code structure.
• Implemented a "query" test in the menu.
  • Currently only setting the name of the item triggers the new query menu.

Removed:

• BetterNick dependency support.
  • It's a dead plugin that can't be downloaded anymore, use NickAPI instead.

1.20 Support & Bug fixes

ItemJoin-v6.0.2-RELEASE

Changelog

Added:

• 1.20/1.20.1 Support
• ALLAY support to the item-store itemflag.
  • ALLAYs will no longer be able to take your item if the item is using the item-store itemflag.

Fixed:

• VirusTotal (False Flag) bugfix.
• Major SQL/Database bugfixes.
• Legacy skull items bugfix.

Changed:

• The glowing itemflag will now only register the glowing enchantment when the itemflag is actually used.

Major bug fix

ItemJoin-v6.0.1-RELEASE

Changelog

Fixed:

• Major bug preventing the SQL data from being loaded (breaking multiple features).
• Database purging bug.
• Enchant glowing bug on legacy Minecraft versions.

1.19.4 Support & Major Changes

ItemJoin-v6.0.0-RELEASE

Changelog

Added:

• Minecraft 1.19.4 Support.
• NMS Check.
  • You will now receive a warning if you are using ItemJoin on an unsupported version of Minecraft.
  • This will cause the plugin to enter compatibility mode and attempt to function as normal (although not guaranteed).
• PlaceholderAPI support for Enchantments.
• Teleport trigger
  • You can now give players items upon teleporting to new locations.
  • This also applies to the Active-Commands in the config.yml.
• /itemjoin dump
  • Thank goodness, I can finally debug bug reports.
• hide-enchants itemflag.
  • This... hides enchantments :)
• not-hat itemflag.
  • Prevents the item from being equipped via the /hat command.
  • This applies to any plugin which uses the /hat command.
• ItemCommand executors to Active-Commands (config.yml).
  • All executors for items now function for Active-Commands excluding delay and swap-item for obvious reasons.
  • The only addition is Active-Commands support the first-join executor whereas ItemCommands do not.
• Portuguese language (pt-lang.yml) thanks to DeskTecc.
• ignoreErrors in the config.yml.
  • Setting this to true will prevent admins from receiving messages upon login and reloading about ItemJoin errors.
• Grindstone to the item-modifiable itemflag.

Fixed:

• A bug that made items from recipes lose their properties.
• Bug that prevented crafting slots from being cleared using clear-items.
• Bug with specific slots being able to bypass the item-modifiable itemflag.
• 2x2 crafting recipe bugfix.
• Items that are supposed to be in the player's crafting menu would be moved to the hotbar.
• Misc NBT bugfix.
• /itemjoin getall bugfix (console).
• Server crashing bugfix.
• Duplicate condition fail-messages being sent if more than one command was specified in a list.
• Condition fail-messages being sent when using a command action that wasn't even sent...
• ItemMap fetching bugfix.
  • Now more simple and more likely to return an ItemMap instead of null.
• Enchantment level checking
  • If the level is detected to be below 1 it will automatically set the level as 1.
• Animation / Dynamic bugfixes.
• Major WorldGuard rework/bugfix.
• ItemCommands bugfix.
• on-equip bugfix.
  • Now properly only functions on right-clicking.
• leather-color PlaceholderAPI bugfix.
  • Simply wasn't working at all...
• Menu bugfixes.

Changed:

• Major plugin recode.
  • Now implements the use of the "ChaosCore" API.
  • This should make updating the plugin easier as well as streamline updates across all of my plugins.
• Default config.yml no longer uses the console executor to set players to creative, instead it is now permission-based.
• ChestSort Support.
  • If the player instance returns null (cannot find the player) then the ChestSort event is ignored and ItemJoin items are allowed to be moved.
• Model-Data now supports Placeholders.
• Reworked potions, now they even get the proper potion skin related to their potion effect!

Removed:

• Slot identifier from NBT Tags.
  • This is simply just no longer needed and causes unnecessary headaches.
  • The items (node name) specified as the path of the item are used instead to identify the item features.