ItemJoin

Added:

• Support 1.21.11 (8858957)
• UUID String for skull owner (57fbb5d)
  • You can now specify the UUID of the player skin as the skull-owner to be set for the item.
• translatable update messages (a427733)
• itemflag messages (b7cedd5)
  • You can now specify messages that will be sent when an itemflag is triggered.
  • Support has been added for the following itemflags; placement, inventory-modify, cancel-equip, not-hat, cancel-events, item-store, item-modifiable, item-craftable, item-repairable, ip-limit, death-drops, self-drops, and erase-drops.
  • A message is defined by simply specifying the itemflag name -message e.g: self-drops-message: '&cYou cannot drop items!'

Fixed:

• Folia AuthMe support (19a14ea)
• item-repairable itemflag (c16b966)
  • Shift+Clicking the item into a crafting table would occasionally result in the item not being returned to the player.
• death-keep for crafting items (a5e1ff7)
  • Items were being incorrectly dropped when the gamerule keepInventory was true.
  • If dying fast enough, it was also possible to have the items be dropped on death.
• incorrect cooldown for on_hold commands (a7876b7)
• item-store itemflag storing in pots (c736778)
  • item-store will now properly block the storage of items in FLOWER_POT and DECORATED_POT.
• folia delay ticks exception (c0b78bc)
• windowId on paperspigot (4f0728a)
• database failure when isClosed not supported (63590ef)
  • Fixes a major bug that prevented data from being fetched from the database when the isClosed method wasn't implemented in the specific sql driver version.
  • The fallback is to assume connections aren't closed to allow the statement to try executing. If it fails, the connection will then be assumed closed and tries to get the connection again.
• rendering menu pages that do not exist (cec60a0)
• updateInventory (9abb123)
  • Fixes the updateInventory function in Legacy Minecraft Versions due to incorrectly not using the windowId.
  • This fixes ghost items when viewing an open container.
• implement proper reflections caching (ed16760)
  • Improves performance, especially on papers new on-the-fly remapping, which is not performant.

Changed:

• implement proper reflections caching (32820bd)
  • Improves performance on server forks utilizing on-the-fly remapping.
• rewrite item animation handler (6ba7f8a)
  • Fixes item animations still being ran when the animations were suppose to be closed.
  • Fixes duplicate animation tasks when using /ij remove and /ij get causing animation flicker.
  • Fixes animation flicker when two players are viewing the same inventory.
  • The item(s) will now animate based on the first viewing player.
  • Fixes the accidental closing of animations when items are removed or lost. Items could exist in containers so we should continue trying to animate.
• support 1.21.4+ pick item handling (3da6ac7)
• improve handling crafting (e2194bc)

Removed

• ProtocolLib as soft depend (d4406c4)
• Temporarily disabled SkinsRestorer support (212e042)
  • API in newer versions of SkinsRestorer has become unstable, resulting in server crashes when fetching skins on the main thread.

Added:

• Support 1.21.9/1.21.10 (fa6e625)
• Support Crafters (a33395d)
  • Custom Recipes will now be properly handled by crafters.

Fixed:

• toggle command overwriting items (631d3bd)
  • Toggling an item will no longer overwrite items unless the item explicitly allow overwrite or global overwrite is enabled.
• toggle command tab completion (fe9e9b2)
  • Fixes tab completion not functioning for toggle commands.
• cache isPaper and isFolia (e051413)

Changed:

• cache isPaper and isFolia (9da46a3)

Added:

• use-cooldown visual (61868a0)

  • The use-cooldown is now visually shown on the custom item in server versions 1.21.3+.

• Support 1.21.8 (aaa02bf)

• Support 1.21.7 (abd6b80)

• #getNodes API method (120cd19)

  • Returns a list of all defined itemNodes.

Fixed:

• multi-slot items (f61f21c)

  • Fixes multi-slots being ignored, only the first slot was being given.

• zero commands cost in menu (bef06ad)

• delayed item commands on paper (04b3b67)

  • Paper changed to region schedulers which was causing a noticeable delay when running item commands.

• use-cooldown bugs (6e60579)

• Was not well designed causing a cooldown to trigger for the wrong item or to trigger when it shouldn't have. Use cooldown is now triggered properly upon the respective action.

• null paper edge case (8794941)

• properties (01c436a)

  • Fixes properties being cut off when saving. Fixes tag list errors on 1.20.5+.

• vanilla-control itemflag (46f3161)

  • Wasn't properly being identified as a custom item when a name and lore were not specified.

• item-store trade errors (9062aa8)

  • Was throwing errors on older server versions.

• permissions detected as clickable links (a050e98)

• region-enter duplicating items (7fe7d68)

• dummy attributes (c3514cf)

Changed:

• improve region handling performance (d9068d0)

  • Will help avoid expensive calls when they're unnecessary.

• bump commons-lang (7ca0e85)

• improve API docs (12db9ed)

  • Clarifies some functionality of the API functions

Remove:

• commons-lang (f0c6c7b)

Added:

• Support 1.21.6 (7cf4c15)
• model components (5d7162a)
  • You can now specify model components for the 1.21.4+ resource packs.
  • You can specify multiple values, example; strings: 'chest_old, tutorial_sword'
  • Example of all available options;

    model-components:
      strings: 'chest_old'
      colors: ORANGE
      flags: 'true'
      floats: '20.0'

Fixed:

• always-give itemflag (c04e592)
  • The proper function of the always-give itemflag is to ALWAYS give the item upon performing a trigger or getting the item via commands, regardless of the player already having the item or not. This wasn't being respected and was not giving the item in the designated slot FIRST before adding it to the next available if the designated slot was occupied.
• incorrectly detecting empty slots (1d1d8e5)
  • Fixes an issue with Paper where empty slots are no longer null, instead they are Material.AIR.

Added:

• support custom sounds (3af8c5f)
  • Sounds from resource packs are now supported for commands-sounds and teleport-sound.
• Support 1.21.5 (00e7936)

Fixed:

• economy balance checking (3617208)
  • Now only checks the players economy balance if the custom item is using a commands-cost. Fixes edge case errors with users not using economy while having a registered economy plugin in a disabled state.
• pale_oak_boat enum not present (0e0ceaa)
  • Issue was with paper or related forks..
• item-store itemflag with villager trades (65fe312)
  • Now properly prevents the trading of items with the item-store itemflag.
• Wait for MySQL connection (9c40ad6)
  • Players were able to join the server before the MySQL connection was established, resulting in players getting items they had already received. When the server is starting up, it will now wait for the plugin to successfully establish MySQL connection. Fixes issues with first-join and ip-limit.
• interact offhand commands (0d1c6fa)
  • Certain command executors like damage and swap-item were non-functional for the offhand slot when using the interact command action.
• ItemMeta is not PotionMeta (54d6cd1)
• 1.21.5 Paper Spigot deobfuscation (90230a1)
• SkinsRestorer proxy mode (a6b191c)
  • Fixes the console spam regarding SkinsRestorer being in the unsupported proxy mode.

Changed:

• update deprecated (8d76a2a)
  • Adds support for the new 1.21.5 methods.
• remove trim patterns enum (a5b1dc9)
  • This isn't needed and was very convoluted. The trim pattern is literally just the NamespaceKey name + "_ARMOR_TRIM_SMITHING_TEMPLATE". Not defining static values allows us to dynamically support new patterns.
• French translation corrections (94af689)
  • Corrected by wokonago on Discord.

Added:

• 1.21.4 Support (1362df8)
• custom item models (c9ba735)
  • model-data now supports model names in Minecraft 1.21.4+, versions below this will still take the numerical input.
  • Example; model-data: example:custom_sword
• saving NBT Properties (519a776)
  • When saving an item via the in-game menu, NBT Properties will now be pulled. This is VERY helpful as it adds support for plugins like ItemsAdder, ExecutableItems, and other custom item plugins without having to utilize their API (manually adding support).
• nbt package nesting (c1aafc3)
  • NBT Properties now support nesting, so you can implement keys inside a package.
  • A package is defined by specifying it as a route, e.g package.key. Example with a key having no package and two keys with a package.
  • Example; properties: 'itemsadder.id:icon_next_orange, itemsadder.namespace:_ianternal'
• dyeing leather horse armor (1f13d52)
  • Minecraft versions 1.14+ now supports dyeing leather horse armor. The functionality is identical to leather armor.
• FIRST-WORLD active-commands tigger (d0f0a85)
  • Command(s) will be executed in every specified world upon entering the world.

Fixed:

• major paper spigot packet issue (7f5e34e)
  • Was causing the selected hotbar item to become "latched" but only server-side, this was not visible on the client causing various bugs.
• NBT Properties Nesting/Listing (7e487b0)
  • This... never functioned from day 1... just randomly noticed this wasn't working....
• chestsort indexoutofbounds (6b4e03d)
  • Would occur when other plugins utilize the ChestSort API with an inventory lacking viewers. Now these calls will simply be ignored since they can't be handled anyways.
• folia item commands (6696fb2)
• dropping items running commands (3264876)
  • If you dropped an item with an interact command while holding it, the command had a chance of being ran. Recent changes broke the old check method for drops resulting in the drops check being ran after the interact event already triggered.
• database pipeline (a61a596)
  • Various fixes that should help improve database connectivity to prevent executions while the connection is refused.
• move-next loading legacy methods (c346e55)
  • Was causing major lag when the first player joins the server as Spigot was force loading unsafe legacy methods as a result of #setData being called for the move-next itemflag. Furthermore this lag could result in the loss of the item being moved.
• improved %player_interact% accuracy (1581b21)
  • The value wasn't being passed from events that directly include this variable. No need to calculate when we already have the player.
• database columns (ea8be06)
  • Changed the larger varchar to text to force MySQL servers to use the max 60k length.
• table purging (a9f3f5e)
  • Tables failed to purge if a player argument was missing.
• use-cooldown (6c8d3f0)
  • Simply wasn't working with entities like ender pearls. It only was respecting fireworks and block placements.
• data saving to database (3cc56b3)
  • Larger inventories were failing to save to the database due to the limited character size.
• crafting definition (735359a)
• old enum resolving (9ac611f)
  • 1.21.3 contained a change to replace old enums with the registry, this resulted in no longer being able to resolve the old enum names. A change has been implemented to attempt to resolve the old names but it likely will stop working in the future.
• return items compression (465739e)
  • Some MYSQL hosts couldn't handle the large Base64 string so it is now compressed to half its original size.
• return items (7288016)
  • This simply wasn't working, items were being cleared after these items are returned instead of before.
• cancel-equip armor (1984055)
• hide-attributes itemflag (50fea47)
  • Paper changed their ItemFlag functionality in 1.20.5 to be different than Spigot. This change made it impossible to hide default attribute values without setting dummy data.
• cross-platform experimental features (26a4cca)
  • Experimental features added by Spigot are sometimes missing in other forks like Purpur.

Changed:

• middle click support (4861b26)
  • Middle click support for item commands has been removed in 1.21+. Blame Microsoft.
• folia tweaks (a184e1b)
• Performance improvement (71318ac)
  • Introduces class caching when using Reflections.

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)

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.