WolfyUtils

🐛 Fixes

• fix: missing itemMeta null check (details)

⚙️ CI/CD

• ci: fix commit details link pointing to wrong repo (details)
• ci: force gradle 8.13 (details)
• ci: fix missing dependencies (details)

🚧 Breaking Changes

• feat!: deprecated CustomItem equipment settings (details)
• feat!: remove deprecated validators (details)
• feat!: remove deprecated functional recipe generator (details)
• feat!: remove old reflection and nms utils (details)
• refactor!: remove mc version checks and backwards compatibility (details)
• refactor!: remove more old deprecated code (details)
• refactor!: remove functional recipe generator (details)
• refactor!: remove broken custom ArmorEquipEvent (details)

🧪 Tests

• test: update to 1.21.5 (details)

⚙️ CI/CD

• ci: remove misc from changelog (details)
• ci: create release as draft (details)

Changes since 4.17

• Merge PR by @petulikan1 with Bug Fixes, 1.21.4 Support, and more in #90
• Add first GitHub workflows to start automating the release to Modrinth
• Remove unused NMS utils, reducing the jar size
• Update to latest Oraxen API, PAPI, WorldEdit, WorldGuard, etc.
• Fix build issues preventing project from building in GitHub workflows

Warning! Versions Before 1.21.4 - Not Supported Anymore!

From this update onward, WolfyUtils and CustomCrafting will only support the latest Minecraft version, including drops (minor versions)!
This will allow me to keep up with the new Minecraft update schedule, and concentrate on new features/bug fixes instead of compatibility.
LTS versions, with backported bug fixes, for the previous Minecraft version will be available to Premium. More info about it soon.

New Contributors

• @petulikan1 made their first contribution in #90

Full Changelog: v4.17-beta.7...v4.18.5

Changelog

• #89 - Fix Wind Charges causing destructive explosions
• b789607c - Fix DependencyResolver trying to resolve null field values
• a2cc2459 - Bump Item-NBT-API to 2.13.2
• 88877df0 - Add missing Bukkit NamespacedKey deserializer
• No longer print NMS warning on 1.21+
  • NMS implementations are no longer available on 1.21+

Full Changelog: v4.17-beta.6...v4.17-beta.7

Paper Plugin Removal

Due to the removal of the Paper Plugin (and no reintroduction in the near future), this may cause load issues on Paper servers... again!

If you encounter any issue enable the "legacy" plugin loading!

I won't fix the loading issues caused by the new Paper loading system! If the Paper Plugins are experimental, then so is their loading system!

Changelog

• #87 - Paper Plugin Removal
• f42dc1e4 - Update Item-NBT-API to 2.13.1

Full Changelog: v4.17-beta.5...v4.17-beta.6

• #84 - Potential NMSInventoryUtils Error Fix
• f60ef7e9 - Fix RecipeIterator error when not available for the MC version
• #85 - Configurable Stack Identifier Priorities

Full Changelog: v4.17-beta.4...v4.17-beta.5

This is a Beta pre-release. Issues may occur! It is recommended to wait for a more stable version, or to try it out on a separate test server!

1.21 support was just added so issues are very likely!

• Removed more NMS Utils and deprecated more of them for future removal
  • The goal is to go NMS-Less in the near future, and rely on NMS via third-parties like Item-NBT-API only!
  • CustomCrafting will need a few more updates to remove its reliance on NMS
• Improved the NMS Fallback to further support versions without NMS implementations
  • I tested 1.21 a bit and so far no issues.
  • 1.21 still uses the fallback with reflections
• Fix Player Head Textures in latest mc versions
• Fix MMOItemsStackIdentifier type serialization
• Don't upgrade Particle Enum on pre-1.20.5
• Fix invalid NMS package for pre-1.20
• Fix Persistent Storage Error on chunk unloading

Full Changelog: v4.17-beta.3...v4.17-beta.4

• #83 - Paper 1.20.5+ Mojang-Mapping Support
• 1fc7732c - Fix ExecutableItemsStackIdentifier dependency
• 0ec49110 - Fix missing ItemFlag HIDE_POTION_EFFECTS on 1.20.5+
  • CustomCrafting will get the same fix soon
• 02efaa36 - Ignore eco wrapped custom items
• e8f2497a - Change StackIdentifier parser priorities
  • This should hopefully make it more convenient for most. Let me know if you'd like to suggest a priority change. An option to make these configurable via config is planned for future betas.
    • 2000 - MMOItems
    • 1900 - Oraxen
    • 1800 - ExecutableItems
    • 1700 - ExecutableBlocks
    • 1600 - MythicMobs
    • 1500 - ItemsAdder
    • 600 - Magic
    • 100 - eco
    • 0 - Denizen

Full Changelog: v4.17-beta.2...v4.17-beta.3

• #82 - Add Dependency Management for Plugin Integrations
  • Note: CustomCrafting needs an update for these changes to apply. It'll be available soon on the CustomCrafting beta branch.
• 54ef052c - Fix compatibility with old Particle enums
• dae5b6f7 - Throw error when KeyedTypeIdResolver cannot find a registered value for a given key
• d9ab4dea - Move PluginIntegration implementations into the proper package

Full Changelog: v4.17-beta.1...v4.17-beta.2

• #80 - Update to 1.20.6
  • 1.17.0 is no longer supported!
  • This plugin is still compiled on Java 17, but also works on Java 21
  • Many NMSUtils were removed and/or delegated to third-party plugins like Item-NBT-API (See #80)
• #81 - Improved StackReference Serialization
• Prioritise MMOItems StackIdentifier Parser over MythicMobs Parser (WolfyScript/CustomCrafting#362)
• #78 - Migrate Publishing Repo To Artifactory

Full Changelog: v4.16.15.1...v4.17-beta.1

• #76 — Fix StackReference Parser Swapping
  • Fixes the ItemEditor GUI in CustomCrafting unable to change the item plugin source
• #77 — Fix CustomItem Replacement & Durability Cost

Full Changelog: v4.16.15...v4.16.15.1

Custom Item Stack Changes

This update introduces the new StackReference and StackIdentifier classes, that provide a lot of features to reference external Items (from like Oraxen, MMOItems, etc.) and replace the old very limited APIReference.

CustomItem ⇾ StackReference

From this update onward CustomItems are no longer used to reference external Items, instead that is the task of the StackReference.

The only purpose of the CustomItem is to represent the well... CustomItem created via WolfyUtils. They do use a StackReference to wrap external stacks, but are no longer used as a plain reference.

APIReference ⇾ StackIdentifier

APIReferences are now replaced by StackIdentifiers, and no longer keep track of the amount and weight, because those properties are now part of the StackReference. StackIdentifiers only contain the info required to identify the external item stack, like an ID or name.

So in return, plugins requiring references to external stacks no longer have to use CustomItems everywhere and no longer need to accept the overhead that comes with it. Instead, it only requires the StackReference, which contains a lot less data, and has a lot less overhead.

Changes

• #66 - New StackReference System to replace old APIReferences
• #72 — Replace NMS GUI Generation with GUIInventoryHolder
  • Fixes GUIs not opening on Paper servers
• #74 - Update paper-plugin.yml & Add missing plugin dependencies
  • Fixes ExecutableBlocks and ExecutableItems NoClassDefFoundError
• #68 - Support for 1.20.3
• 2110329f - Change nmsutil 1_20_R3 to use 1.20.4 mappings This should still work with 1.20.3, because of the very minor changes, but realistically there is no reason to still use 1.20.3!
• 9434dee — Only handle ArmorEquipEvent when CustomItems are involved
• 121cf29 — Add debug agent to docker container
• 771fb79 — Fix Smithing Recipes in 1.20.2
• 9af73f77 — Fix NPE in MythicMobsStackIdentifier for stacks without NBT tag
• 2fb08e7d - Remove 1_16_R3 nmsutils (1.16.5 is no longer supported!)
• aa6a119b - Bump nbtapi-api & nbtapi-data to 2.12.2

Full Changelog: v4.16.14.1...v4.16.15

• #75 — Fix Oraxen StackIdentifier Editing Original Item Amount

Full Changelog: v4.16.15-rc.1...v4.16.15-rc.2

• #74 - Update paper-plugin.yml & Add missing plugin dependencies
  • Fixes ExecutableBlocks and ExecutableItems NoClassDefFoundError

Full Changelog: v4.16.15-beta.12...v4.16.15-rc.1

• 4772b4a5 — Keep backwards compatibility with GuiUpdate
• 705b1360 — Fix MythicMobs matchesIgnoreCount not working

Full Changelog: v4.16.15-beta.11...v4.16.15-beta.12

• ca6365aa — BukkitStackIdentifier needs to check the item type
  • Fixes various recipe issues in CustomCrafting (like invalid recipe results)

Full Changelog: v4.16.15-beta.10...v4.16.15-beta.11

• #72 — Replace NMS GUI Generation with GUIInventoryHolder
  • Fixes GUIs not opening on Paper servers
• 80a53458 — Fix count check in StackIdentifier & Add StackIdentifier#matchesIgnoreCount
• bf9a55d7 — Fix MythicMobsStackIdentifier overriding other stack identifiers

Full Changelog: v4.16.15-beta.9...v4.16.15-beta.10

Changelog

• dc982d43 - Fix StackReference 'weight' property deserialization.
  This fixes loading issues of older configs.

Full Changelog: v4.16.15-beta.8...v4.16.15-beta.9

Changelog

• 91b925a8 - The ExecutableBlocksStackIdentifier should actually be registered to work...

Full Changelog: v4.16.15-beta.7...v4.16.15-beta.8

Changelog

• #70 — Fix StackReference Not Updating & Backwards Compatibility
• #71 — Fix StackReference matches Performance Issues

Full Changelog: v4.16.15-beta.6...v4.16.15-beta.7

StackReference Breaking Change

StackReferences Identifier is Nullable now when the specified parser is not available (e.g. when a third-party plugin isn't available), or the parser fails to parse the item.
To reflect those changes, the StackReference#identifier() returns an Optional instead, and you may fall back to StackReference#originalStack when it is not present.

Changelog

• #69 — Optional StackReference Identifiers
• 4da9339c — Fix NullPointerEexceptions in StackIdentifiers & prevent possible NPEs. This fixes & prevents NPEs in:
  • EcoStackIdentifier
  • ExecutableBlocksStackIdentifier
  • ExecutableItemsStackIdentifier
  • ItemsAdderStackIdentifier
  • MMOItemsStackIdentifier
  • MythicMobsStackIdentifier
  • FancyBagsStackIdentifier

Full Changelog: v4.16.15-beta.5...v4.16.15-beta.6

This update includes a breaking change affecting StackReferences. You are only affected when using the Beta of CustomCrafting! Soon there will be another CustomCrafting Beta that'll be compatible again.

Changelog

• aa6a119b - Bump nbtapi-api & nbtapi-data to 2.12.2
• 2110329f - Change nmsutil 1_20_R3 to use 1.20.4 mappings This should still work with 1.20.3, because of the very minor changes, but realistically there is no reason to still use 1.20.3!
• 4ff8ccef - Add itemKey getter to WolfyUtilsStackIdentifier
• b7620c07 - Add itemKey getter to BukkitStackIdentifier
• db035c32 - Change RegistryStackIdentifierParsers#parseFrom to return an Optional

Full Changelog: v4.16.15-beta.4...v4.16.15-beta.5

• #68 - Support for 1.20.3
• 2fb08e7d - Remove 1_16_R3 nmsutils (1.16.5 is no longer supported!)
• e69deee1 - Fix ItemStack matching in BukkitStackIdentifier
• 15b07299 - Fix StackIdentifier#shrink not consuming stacks of count 1
• 33bdaaa0 - Fix BukkitStackIdentifier stack amount to be always 1
• 7e34264d - StackReference no longer fails to parse

Full Changelog: v4.16.15-beta.3...v4.16.15-beta.4

---

!! Beta Update !!

This is a beta update! It is highly advised to not use it in production or on public servers! It is mostly untested and still very much in development, so breaking changes may occur. Additionally, it may cause game breaking issues (disappearing items, item duplication, config corruption).

There are only a few recommended scenarios where you may use it:

• Your server is private, and you do not mind game breaking issues (like loosing items, item duplication, config corruption)
• You want to try the latest version on a test server, help test it and report issue before release.

Either way, you should make a backup of your server/data before installing this beta.

---

Make sure to update to the latest WolfyUtils Beta version! Download here!

Known Issues

• The ItemCreator in CustomCrafting is broken and does not apply changes made to an item stack

Changelog

• #67 — Fix amount handling in StackIdentifiers & References
• 9434dee — Only handle ArmorEquipEvent when CustomItems are involved
• 121cf29 — Add debug agent to docker container
• 771fb79 — Fix Smithing Recipes in 1.20.2
• 9af73f77 — Fix NPE in MythicMobsStackIdentifier for stacks without NBT tag
• cdf73be1 — Add missing DenizenStackIdentifier

Full Changelog: v4.16.15-beta.2...v4.16.15-beta.3

---

!! Beta Update !!

This is a beta update! It is highly advised to not use it in production or on public servers! It is mostly untested and still very much in development, so breaking changes may occur. Additionally, it may cause game breaking issues (disappearing items, item duplication, config corruption).

There are only a few recommended scenarios where you may use it:

• Your server is private, and you do not mind game breaking issues (like loosing items, item duplication, config corruption)
• You want to try the latest version on a test server, help test it and report issue before release.

Either way, you should make a backup of your server/data before installing this beta.

---

Changelog

• Fix StackReference#swapParser not applying new identifier

Full Changelog: v4.16.15-beta.1...v4.16.15-beta.2

---

!! Beta Update !!

This is a beta update! It is highly advised to not use it in production or on public servers! It is mostly untested and still very much in development, so breaking changes may occur. Additionally, it may cause game breaking issues (disappearing items, item duplication, config corruption).

There are only a few recommended scenarios where you may use it:

• Your server is private, and you do not mind game breaking issues (like loosing items, item duplication, config corruption)
• You want to try the latest version on a test server, help test it and report issue before release.

Either way, you should make a backup of your server/data before installing this beta.

---

This update introduces the new StackReference and StackIdentifier classes, that provide a lot of features to reference external Items (from like Oraxen, MMOItems, etc.) and replace the old very limited APIReference.

CustomItem ⇾ StackReference

From this update onward CustomItems are no longer used to reference external Items, instead that is the task of the StackReference.

The only purpose of the CustomItem is to represent the well... CustomItem created via WolfyUtils. They do use a StackReference to wrap external stacks, but are no longer used as a plain reference.

APIReference ⇾ StackIdentifier

APIReferences are now replaced by StackIdentifiers, and no longer keep track of the amount and weight, because those properties are now part of the StackReference. StackIdentifiers only contain the info required to identify the external item stack, like an ID or name.

So in return, plugins requiring references to external stacks no longer have to use CustomItems everywhere and no longer need to accept the overhead that comes with it. Instead, it only requires the StackReference, which contains a lot less data, and has a lot less overhead.

Changelog

• #66 - New StackReference System to replace old APIReferences

Full Changelog: v4.16.14.1...v4.16.15-beta.1

A quick fix for Recipes causing errors due to an invalid method mapping in 1.20.2.

Changelog

• #65 - Fix error when crafting in 1.20.2

Full Changelog: v4.16.14.0...v4.16.14.1

Changelog

• Add 1.20.2 nms module
• Update Item-NBT-API to 2.12.0
• #64 - Migration to the Gradle build system

Full Changelog: v4.16.13.0...v4.16.14.0

This update adds a few new features that will be required by the upcoming CustomCrafting 4.16.9-beta update, to support multithreaded data loading and improved data validation.

Changelog

• Fix CustomItem#create to work in multithreaded scenarios
• #62 - Improved Plugin Integrations
• #63 - Add Object Validator

Full Changelog: v4.16.12.1...v4.16.13.0

Update to latest SCore API & Fix Crash on 1.17, and prior

Changelog

• #59 - Update to latest SCore API (ExecutableBlocks & ExecutableItems)
• #60 - Include Fastutil library in plugin.yml

Full Changelog: v4.16.12.0...v4.16.12.1

This is the first release on Modrinth. Below you'll find the changelog of the most recent update. For previous changelogs, please visit GitHub

Changelog

• Added NMS support for 1.20.1
• Removed FunctionalRecipe support for 1.20+
• Replaced NMS Inventory Title Update util with Spigots new InventoryView#setTitle in 1.20+
• Added RecipeUtil#setCurrentRecipe NMS util used to apply recipes internally for crafting, smithing and cooking recipes.
• Removed NMS support for versions prior to 1.16.5
• Always unmark blocks with block storage to drop items properly

Full Changelog: v4.16.11.0...v4.16.12.0