
1.21.7 & 1.21.8 Support and Bugfixes
release24 сентября 2025 г.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)
1.21.6 Support
release23 июня 2025 г.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.
1.21.5 Support and Bugfixes
release29 мая 2025 г.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.
1.21.4 Support, New Features, and Bugfixes
release19 февраля 2025 г.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:
1.21.2 & 1.21.3 Support, Bugfixes
release24 ноября 2024 г.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: