All Mods Resource Packs Data Packs Shaders Modpacks Plugins
WolfyUtils

WolfyUtils

by WolfyScript • Downloads: 0 • Followers: 0
Description
Gallery
Changelog
Versions
WolfyUtilities Banner

bstats_server github_commit

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

APIs & Utils

  • API is plugin dependent, which means there is one instance of the API per plugin.
  • Utils are plugin independent. They can be used everywhere.
  • Registry is bound to the core of WolfyUtilities, but can be accessed from anywhere.

APIs

  • Inventory - Functional API to create in-game GUIs.
  • Language - Load JSON based language files and support multiple languages for GUIs, messages, etc.
  • Chat - Send translatable messages, text click event callbacks, and more.
  • Config - Simple config utilities.
  • NMS - Type specific RecipeIterator, and some Block and Inventory Utils.
  • CustomItems - Create custom items with settings like custom fuel, durability, actions, etc.

Registry

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.

Utils:

  • NamespacedKey - Unique key for all registrable content.
  • JSON - Various Jackson utils that simplify de-/serialization
    • HOCON support for a more human friendly config option.
    • Custom de-/serializer for Bukkit objects
    • Easy de-/serialization from Registry values
      • Object (See @OptionalKeyReference)
      • Type to object (See @KeyedTypeIdResolver & @KeyedTypeResolver)
  • Particles - Configure custom particle effects & animations using JSON.
  • RandomCollection - Weight based random collection.
  • Reflection - Basic Reflection Utils.
  • Player Head utils to set textures and more.
  • Basic MySQL connection to run queries and updates.
  • ItemBuilder to edit/create ItemStacks.
  • Save player specific data.

Plugins using WolfyUtilities

CustomCrafting

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.

All Versions

+ Add Version
Name Game version Platforms Published Downloads Actions
1.21.x
Bukkit Paper Purpur Spigot
23h ago 1
1.21.x
Bukkit Paper Purpur Spigot
23h ago 1
1.21.4
Bukkit Paper Purpur Spigot
23h ago 1
1.21.x 1.20.6 1.19.4 +2
Bukkit Paper Purpur Spigot
23h ago 1
1.21 1.20.x 1.19.4 +2
Bukkit Paper Purpur Spigot
23h ago 1
1.21 1.20.x 1.19.4 +2
Bukkit Paper Purpur Spigot
23h ago 1
1.21 1.20.x 1.19.4 +2
Bukkit Paper Purpur Spigot
23h ago 1
1.20.x 1.19.x 1.18.x +1
Bukkit Paper Purpur Spigot
23h ago 1
1.20.x 1.19.x 1.18.x +1
Bukkit Paper Spigot
23h ago 1
1.20.x 1.19.x 1.18.x +1
Bukkit Paper Purpur Spigot
23h ago 1
1.20.x 1.19.x 1.18.x +1
Bukkit Paper Purpur Spigot
23h ago 1
1.20.x 1.19.x 1.18.x +1
Bukkit Paper Purpur Spigot
23h ago 1
1.20.x 1.19.x 1.18.x +1
Bukkit Paper Purpur Spigot
23h ago 1
1.20.x 1.19.x 1.18.x +1
Bukkit Paper Purpur Spigot
23h ago 1
1.20.x 1.19.x 1.18.x +1
Bukkit Paper Purpur Spigot
23h ago 1
1.20.x 1.19.x 1.18.x +1
Bukkit Paper Purpur Spigot
23h ago 1
1.20.x 1.19.x 1.18.x +1
Bukkit Paper Purpur Spigot
23h ago 1
1.20.x 1.19.x 1.18.x +1
Bukkit Paper Purpur Spigot
23h ago 1
1.20.x 1.19.x 1.18.x +1
Bukkit Paper Purpur Spigot
23h ago 1
1.20.x 1.19.x 1.18.x +1
Bukkit Paper Purpur Spigot
23h ago 1
1.20.x 1.19.x 1.18.x +1
Bukkit Paper Purpur Spigot
23h ago 1
1.20.x 1.19.x 1.18.x +1
Bukkit Paper Purpur Spigot
23h ago 1
1.20.x 1.19.x 1.18.x +1
Bukkit Paper Purpur Spigot
23h ago 1
1.20.x 1.19.x 1.18.x +1
Bukkit Paper Purpur Spigot
23h ago 1
1.20.x 1.19.x 1.18.x +1
Bukkit Paper Purpur Spigot
23h ago 1
1.20.x 1.19.x 1.18.x +1
Bukkit Paper Purpur Spigot
23h ago 1
1.20.x 1.19.x 1.18.x +2
Bukkit Paper Purpur Spigot
23h ago 1
1.20.x 1.19.x 1.18.x +2
Bukkit Paper Purpur Spigot
23h ago 1
1.20.x 1.19.x 1.18.x +2
Bukkit Paper Purpur Spigot
23h ago 1
1.20.x 1.19.x 1.18.x +2
Bukkit Paper Purpur Spigot
23h ago 1
1.20.x 1.19.x 1.18.x +2
Bukkit Paper Purpur Spigot
23h ago 1
[4.19.0.0] 4.19.0.0 by WolfyScript on Oct 12, 2026
Download
## 🚧 Breaking Changes


## 🧪 Tests


## ⚙️ CI/CD





[4.18.6] 4.18.6 by WolfyScript on Oct 12, 2026
Download
## Changes since 4.17
  • Merge PR by @petulikan1 with Bug Fixes, 1.21.4 Support, and more in [#90](https://github.com/WolfyScript/WolfyUtils-Spigot/pull/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

## Changelog

## 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](https://docs.papermc.io/paper/reference/paper-plugins#cyclic-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


> 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


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



[4.16.15.1] WolfyUtils 4.16.15.1 by WolfyScript on Oct 12, 2026
Download


[4.16.15] WolfyUtils 4.16.15 by WolfyScript on Oct 12, 2026
Download
### 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.
<br>

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

_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!_






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

### Changelog

## Changelog

### 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
This fixes & prevents NPEs in:
  • EcoStackIdentifier
  • ExecutableBlocksStackIdentifier
  • ExecutableItemsStackIdentifier
  • ItemsAdderStackIdentifier
  • MMOItemsStackIdentifier
  • MythicMobsStackIdentifier
  • FancyBagsStackIdentifier


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
_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!_

#### !! 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!](https://github.com/WolfyScript/WolfyUtils-Spigot/releases/tag/v4.16.15-beta.3)

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

## Changelog
  • [#67](https://github.com/WolfyScript/WolfyUtils-Spigot/pull/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


#### !! 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

#### !! 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.

<br>

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

[4.16.14.1] WolfyUtils 4.16.14.1 by WolfyScript on Oct 12, 2026
Download
A quick fix for Recipes causing errors due to an invalid method mapping in 1.20.2.

### Changelog

[4.16.14.0] WolfyUtils 4.16.14.0 by WolfyScript on Oct 12, 2026
Download
## Changelog

[4.16.13.0] WolfyUtils 4.16.13.0 by WolfyScript on Oct 12, 2026
Download
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

[4.16.12.1] WolfyUtils 4.16.12.1 by WolfyScript on Oct 12, 2026
Download
### Update to latest SCore API & Fix Crash on 1.17, and prior
<br/>

### Changelog


WolfyUtils Icon
Download WolfyUtils
Select game version
Select platform