Core API & Utils for Spigot based plugins. Inventory GUI, Language, JSON (Jackson), and many more utils
Core API that provides an API and Utils for plugins based on Spigot.
This is the Spigot implementation of WolfyUtils. For more info see WolfyScript/WolfyUtilities
The Registry is the base of all custom content in WolfyUtilities and the plugins that build on it.
It allows you to register types & objects under unique namespaced keys.
That not only allows the plugin to register things like CustomItems, etc., but it can be extended by other plugins too.
CustomCrafting is heavily based on these APIs and Utils.
CustomCrafting especially makes use of the InventoryAPI to create and manage the in-game RecipeCreators.
The JSON utils are used to load/save recipes & items from/to JSON, and to allow for custom settings inside the json files.
Unsupported
Required
Terms for using, modifying and redistributing this product.
Screenshots and images from the original Modrinth page.

Published versions and original Modrinth files.
21.09.2025 · 26 325 downloads
15.04.2025 · 8 861 downloads
details)details)details)details)details)details)details)details)details)26.03.2025 · 6 351 downloads
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.
Full Changelog: v4.17-beta.7...v4.18.5
12.08.2024 · 39 414 downloads
b789607c - Fix DependencyResolver trying to resolve null field valuesa2cc2459 - Bump Item-NBT-API to 2.13.288877df0 - Add missing Bukkit NamespacedKey deserializerFull Changelog: v4.17-beta.6...v4.17-beta.7
20.07.2024 · 11 650 downloads
Due to the removal of the Paper Plugin (and no reintroduction in the near future), this may cause load issues on Paper servers... again!
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!
Full Changelog: v4.17-beta.5...v4.17-beta.6
15.07.2024 · 963 downloads
f60ef7e9 - Fix RecipeIterator error when not available for the MC versionFull Changelog: v4.17-beta.4...v4.17-beta.5
13.06.2024 · 4 155 downloads
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!
Full Changelog: v4.17-beta.3...v4.17-beta.4
26.05.2024 · 3 028 downloads
1fc7732c - Fix ExecutableItemsStackIdentifier dependency0ec49110 - Fix missing ItemFlag HIDE_POTION_EFFECTS on 1.20.5+02efaa36 - Ignore eco wrapped custom itemse8f2497a - Change StackIdentifier parser prioritiesFull Changelog: v4.17-beta.2...v4.17-beta.3
24.05.2024 · 443 downloads
54ef052c - Fix compatibility with old Particle enumsdae5b6f7 - Throw error when KeyedTypeIdResolver cannot find a registered value for a given keyd9ab4dea - Move PluginIntegration implementations into the proper packageFull Changelog: v4.17-beta.1...v4.17-beta.2
02.05.2024 · 12 522 downloads
Full Changelog: v4.16.15.1...v4.17-beta.1
05.03.2024 · 10 697 downloads
Full Changelog: v4.16.15...v4.16.15.1
03.03.2024 · 3 188 downloads
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 ⇾ StackReferenceFrom 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 ⇾ StackIdentifierAPIReferences 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.
2110329f - Change nmsutil 1_20_R3 to use 1.20.4 mappings9434dee — Only handle ArmorEquipEvent when CustomItems are involved121cf29 — Add debug agent to docker container771fb79 — Fix Smithing Recipes in 1.20.29af73f77 — Fix NPE in MythicMobsStackIdentifier for stacks without NBT tag2fb08e7d - Remove 1_16_R3 nmsutils (1.16.5 is no longer supported!)aa6a119b - Bump nbtapi-api & nbtapi-data to 2.12.2Full Changelog: v4.16.14.1...v4.16.15
03.03.2024 · 153 downloads
Full Changelog: v4.16.15-rc.1...v4.16.15-rc.2
02.03.2024 · 221 downloads
Full Changelog: v4.16.15-beta.12...v4.16.15-rc.1
28.02.2024 · 374 downloads
4772b4a5 — Keep backwards compatibility with GuiUpdate705b1360 — Fix MythicMobs matchesIgnoreCount not workingFull Changelog: v4.16.15-beta.11...v4.16.15-beta.12
27.01.2024 · 2 523 downloads
ca6365aa — BukkitStackIdentifier needs to check the item typeFull Changelog: v4.16.15-beta.10...v4.16.15-beta.11
24.01.2024 · 373 downloads
80a53458 — Fix count check in StackIdentifier & Add StackIdentifier#matchesIgnoreCountbf9a55d7 — Fix MythicMobsStackIdentifier overriding other stack identifiersFull Changelog: v4.16.15-beta.9...v4.16.15-beta.10
19.01.2024 · 353 downloads
dc982d43 - Fix StackReference 'weight' property deserialization.Full Changelog: v4.16.15-beta.8...v4.16.15-beta.9
11.01.2024 · 536 downloads
91b925a8 - The ExecutableBlocksStackIdentifier should actually be registered to work... Full Changelog: v4.16.15-beta.7...v4.16.15-beta.8
08.01.2024 · 224 downloads
matches Performance IssuesFull Changelog: v4.16.15-beta.6...v4.16.15-beta.7
02.01.2024 · 354 downloads
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.
4da9339c — Fix NullPointerEexceptions in StackIdentifiers & prevent possible NPEs.Full Changelog: v4.16.15-beta.5...v4.16.15-beta.6
15.12.2023 · 1 579 downloads
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.
aa6a119b - Bump nbtapi-api & nbtapi-data to 2.12.22110329f - Change nmsutil 1_20_R3 to use 1.20.4 mappings4ff8ccef - Add itemKey getter to WolfyUtilsStackIdentifierb7620c07 - Add itemKey getter to BukkitStackIdentifierdb035c32 - Change RegistryStackIdentifierParsers#parseFrom to return an OptionalFull Changelog: v4.16.15-beta.4...v4.16.15-beta.5
06.12.2023 · 332 downloads
2fb08e7d - Remove 1_16_R3 nmsutils (1.16.5 is no longer supported!)e69deee1 - Fix ItemStack matching in BukkitStackIdentifier15b07299 - Fix StackIdentifier#shrink not consuming stacks of count 133bdaaa0 - Fix BukkitStackIdentifier stack amount to be always 17e34264d - StackReference no longer fails to parseFull Changelog: v4.16.15-beta.3...v4.16.15-beta.4
19.11.2023 · 586 downloads
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.
Full Changelog: v4.16.15-beta.2...v4.16.15-beta.3
31.10.2023 · 680 downloads
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.
Full Changelog: v4.16.15-beta.1...v4.16.15-beta.2
29.10.2023 · 176 downloads
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 ⇾ StackReferenceFrom 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 ⇾ StackIdentifierAPIReferences 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.
Full Changelog: v4.16.14.1...v4.16.15-beta.1
12.10.2023 · 6 191 downloads
A quick fix for Recipes causing errors due to an invalid method mapping in 1.20.2.
Full Changelog: v4.16.14.0...v4.16.14.1
12.10.2023 · 287 downloads
Full Changelog: v4.16.13.0...v4.16.14.0
06.09.2023 · 1 298 downloads
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.
Full Changelog: v4.16.12.1...v4.16.13.0
25.07.2023 · 5 098 downloads
Full Changelog: v4.16.12.0...v4.16.12.1
25.06.2023 · 2 433 downloads
This is the first release on Modrinth.
Below you'll find the changelog of the most recent update. For previous changelogs, please visit GitHub
InventoryView#setTitle in 1.20+Full Changelog: v4.16.11.0...v4.16.12.0