COWMODSКаталог модов

WolfyUtils

Core API & Utils for Spigot based plugins. Inventory GUI, Language, JSON (Jackson), and many more utils

Автор: WolfyScript167,2 тыс.66обновлён 21 сент. 2025 г.
БиблиотекиУправлениеУтилиты

Описание

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.

Последние версии

Все версии →
release

4.19.1.2

4.19.1.2
21 сент. 2025 г.35,3 тыс.Minecraft: 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8bukkit, paper, purpur, spigot
Скачать
Что нового
## 🐛 Fixes - fix: missing itemMeta null check ([`details`](https://github.com/WolfyScript/WolfyUtils-Spigot/commit/ffd24edf2776f9c86dc42e3379de09990cba1540)) ## ⚙️ CI/CD - ci: fix commit details link pointing to wrong repo ([`details`](https://github.com/WolfyScript/WolfyUtils-Spigot/commit/3bc850dcc06aef2c83c92b7bd3ae03b96f8cbdcc)) - ci: force gradle 8.13 ([`details`](https://github.com/WolfyScript/WolfyUtils-Spigot/commit/0c4e2db34160b0dfa622a26a96cf20a9282bc88a)) - ci: fix missing dependencies ([`details`](https://github.com/WolfyScript/WolfyUtils-Spigot/commit/3b9303c2e88b562b1cb82b8a45de2fe6e8182f9a))
release

4.19.0.0

4.19.0.0
15 апр. 2025 г.9 тыс.Minecraft: 1.21.5, 1.21.6, 1.21.7, 1.21.8bukkit, paper, purpur, spigot
Скачать
Что нового
## 🚧 Breaking Changes - feat!: deprecated CustomItem equipment settings ([`details`](https://github.com/WolfyScript/dev-tools/commit/74d80bad6ac36cb2aaf904345874d7342f73e9b0)) - feat!: remove deprecated validators ([`details`](https://github.com/WolfyScript/dev-tools/commit/7e4dc6dd7d7ccddaa4c0431ac6ef5218b1ab74fa)) - feat!: remove deprecated functional recipe generator ([`details`](https://github.com/WolfyScript/dev-tools/commit/b5f048adfa4882a9d3ad7965735c2163f54aae8a)) - feat!: remove old reflection and nms utils ([`details`](https://github.com/WolfyScript/dev-tools/commit/5169fd3018bd55dbf4707e91cf058842554259c3)) - refactor!: remove mc version checks and backwards compatibility ([`details`](https://github.com/WolfyScript/dev-tools/commit/1c8e582e4728b4c2607a993346c793992859c73e)) - refactor!: remove more old deprecated code ([`details`](https://github.com/WolfyScript/dev-tools/commit/9382deb1e8796d5f600df322643f774ce4225438)) - refactor!: remove functional recipe generator ([`details`](https://github.com/WolfyScript/dev-tools/commit/e40ab65faa73f38a5d237d49ed10e7da65b1baf0)) - refactor!: remove broken custom ArmorEquipEvent ([`details`](https://github.com/WolfyScript/dev-tools/commit/09ab4bd3c5487051fc53a4de9bc7a790f90f5565)) ## 🧪 Tests - test: update to 1.21.5 ([`details`](https://github.com/WolfyScript/dev-tools/commit/91a8e7b085570170792c6b6b735902667de73125)) ## ⚙️ CI/CD - ci: remove misc from changelog ([`details`](https://github.com/WolfyScript/dev-tools/commit/cea42c64e1295fcba05368f07b0338d4a346dd54)) - ci: create release as draft ([`details`](https://github.com/WolfyScript/dev-tools/commit/63b5c49bb321518d9e841880ac62139e5b611570))
release

4.18.6

4.18.6
26 мар. 2025 г.6,5 тыс.Minecraft: 1.21.4bukkit, paper, purpur, spigot
Скачать
Что нового
## 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 * @petulikan1 made their first contribution in [#90](https://github.com/WolfyScript/WolfyUtils-Spigot/pull/90) **Full Changelog**: [`v4.17-beta.7...v4.18.5`](https://github.com/WolfyScript/WolfyUtils-Spigot/compare/v4.17-beta.7...v4.18.5)
beta

WolfyUtils 4.17-beta.7

4.17-beta.7
12 авг. 2024 г.43,8 тыс.Minecraft: 1.17.1, 1.18.2, 1.19.4, 1.20.6, 1.21, 1.21.1bukkit, paper, purpur, spigot
Скачать
Что нового
## Changelog * [#89](https://github.com/WolfyScript/WolfyUtils-Spigot/pull/89) - Fix Wind Charges causing destructive explosions * [`b789607c`](https://github.com/WolfyScript/WolfyUtils-Spigot/commit/b789607c9a375be838a408331d11a9a51fa39327) - Fix DependencyResolver trying to resolve null field values * [`a2cc2459`](https://github.com/WolfyScript/WolfyUtils-Spigot/commit/a2cc24590f883b8fd1631aa7ce6b838690711956) - Bump Item-NBT-API to 2.13.2 * [`88877df0`](https://github.com/WolfyScript/WolfyUtils-Spigot/commit/88877df011cf35b83822577dbed751d4e8de1871) - 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`](https://github.com/WolfyScript/WolfyUtils-Spigot/compare/v4.17-beta.6...v4.17-beta.7)
beta

WolfyUtils 4.17-beta.6

4.17-beta.6
20 июл. 2024 г.12,1 тыс.Minecraft: 1.17.1, 1.18.2, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21bukkit, paper, purpur, spigot
Скачать
Что нового
## 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 * [#87](https://github.com/WolfyScript/WolfyUtils-Spigot/pull/87) - Paper Plugin Removal * [`f42dc1e4`](https://github.com/WolfyScript/WolfyUtils-Spigot/commit/f42dc1e43d6aa75e8aeebeba983d02510b786e22) - Update Item-NBT-API to 2.13.1 **Full Changelog**: [`v4.17-beta.5...v4.17-beta.6`](https://github.com/WolfyScript/WolfyUtils-Spigot/compare/v4.17-beta.5...v4.17-beta.6)
beta

WolfyUtils 4.17-beta.5

4.17-beta.5
15 июл. 2024 г.1,1 тыс.Minecraft: 1.17.1, 1.18.2, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21bukkit, paper, purpur, spigot
Скачать
Что нового
* [#84](https://github.com/WolfyScript/WolfyUtils-Spigot/pull/84) - Potential NMSInventoryUtils Error Fix * [`f60ef7e9`](https://github.com/WolfyScript/WolfyUtils-Spigot/commit/f60ef7e9a96eb5146b379839a72a82be67bde287) - Fix RecipeIterator error when not available for the MC version * [#85](https://github.com/WolfyScript/WolfyUtils-Spigot/pull/85) - Configurable Stack Identifier Priorities **Full Changelog**: [`v4.17-beta.4...v4.17-beta.5`](https://github.com/WolfyScript/WolfyUtils-Spigot/compare/v4.17-beta.4...v4.17-beta.5)
beta

WolfyUtils 4.17-beta.4

4.17-beta.4
13 июн. 2024 г.4,8 тыс.Minecraft: 1.17.1, 1.18.2, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21bukkit, paper, purpur, spigot
Скачать
Что нового
> 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`](https://github.com/WolfyScript/WolfyUtils-Spigot/compare/v4.17-beta.3...v4.17-beta.4)
beta

WolfyUtils 4.17-beta.3

4.17-beta.3
26 мая 2024 г.3,1 тыс.Minecraft: 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6bukkit, paper, purpur, spigot
Скачать
Что нового
* [#83](https://github.com/WolfyScript/WolfyUtils-Spigot/pull/83) - Paper 1.20.5+ Mojang-Mapping Support * [`1fc7732c`](https://github.com/WolfyScript/WolfyUtils-Spigot/commit/1fc7732cf7deb59215efb59a289aa3c68af96c2f) - Fix ExecutableItemsStackIdentifier dependency * [`0ec49110`](https://github.com/WolfyScript/WolfyUtils-Spigot/commit/0ec4911030bc8c2a76730f379c9e30e7bc6e58a1) - Fix missing ItemFlag HIDE_POTION_EFFECTS on 1.20.5+ * CustomCrafting will get the same fix soon * [`02efaa36`](https://github.com/WolfyScript/WolfyUtils-Spigot/commit/02efaa364d4b42db7aa3254cd475816de9f43be1) - Ignore eco wrapped custom items * [`e8f2497a`](https://github.com/WolfyScript/WolfyUtils-Spigot/commit/e8f2497ab7c8f509d514e739952f6906d86a1c60) - 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`](https://github.com/WolfyScript/WolfyUtils-Spigot/compare/v4.17-beta.2...v4.17-beta.3)
beta

WolfyUtils 4.17-beta.2

4.17-beta.2
24 мая 2024 г.464Minecraft: 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6bukkit, paper, spigot
Скачать
Что нового
* [#82](https://github.com/WolfyScript/WolfyUtils-Spigot/pull/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`]([https://github.com/WolfyScript/WolfyUtils-Spigot/commit/54ef052ca8466817baffee7e147974a346ca9365](https://github.com/WolfyScript/WolfyUtils-Spigot/commit/54ef052ca8466817baffee7e147974a346ca9365)) - Fix compatibility with old Particle enums * [`dae5b6f7`]([https://github.com/WolfyScript/WolfyUtils-Spigot/commit/dae5b6f74b81f411da7f0e7786cd2ca9048b7ae7](https://github.com/WolfyScript/WolfyUtils-Spigot/commit/dae5b6f74b81f411da7f0e7786cd2ca9048b7ae7)) - Throw error when KeyedTypeIdResolver cannot find a registered value for a given key * [`d9ab4dea`]([https://github.com/WolfyScript/WolfyUtils-Spigot/commit/d9ab4deaa9d9f2b711e5277077bd054b80cfd95e](https://github.com/WolfyScript/WolfyUtils-Spigot/commit/d9ab4deaa9d9f2b711e5277077bd054b80cfd95e)) - Move PluginIntegration implementations into the proper package **Full Changelog**: [`v4.17-beta.1...v4.17-beta.2`](https://github.com/WolfyScript/WolfyUtils-Spigot/compare/v4.17-beta.1...v4.17-beta.2)
beta

WolfyUtils 4.17-beta.1

4.17-beta.1
2 мая 2024 г.12,8 тыс.Minecraft: 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6bukkit, paper, purpur, spigot
Скачать
Что нового
* [#80](https://github.com/WolfyScript/WolfyUtils-Spigot/pull/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](https://github.com/WolfyScript/WolfyUtils-Spigot/pull/81) - Improved StackReference Serialization * Prioritise MMOItems StackIdentifier Parser over MythicMobs Parser (WolfyScript/CustomCrafting#362) * [#78](https://github.com/WolfyScript/WolfyUtils-Spigot/pull/78) - Migrate Publishing Repo To Artifactory **Full Changelog**: [`v4.16.15.1...v4.17-beta.1`](https://github.com/WolfyScript/WolfyUtils-Spigot/compare/v4.16.15.1...v4.17-beta.1)