Перейти к содержимому
Mineforgian

WolfyUtils

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

Загрузки
148K
Подписчики
65
Обновлён
21 сентября 2025 г.
Лицензия
GPL-3.0-or-later

Опубликован 24 июня 2023 г.

Исходный кодСообщить об ошибке
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.

Ченджлог

4.19.1.2Релиз1.21.6, 1.21.7, 1.21.8 · 21 сентября 2025 г.

🐛 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)
4.19.0.0Релиз1.21.6, 1.21.7, 1.21.8 · 15 апреля 2025 г.

🚧 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

⚙️ CI/CD

  • ci: remove misc from changelog (details)
  • ci: create release as draft (details)
4.18.6Релиз1.21.4 · 26 марта 2025 г.

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

4.17-beta.7Бета1.20.6, 1.21, 1.21.1 · 12 августа 2024 г.

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

4.17-beta.6Бета1.20.5, 1.20.6, 1.21 · 20 июля 2024 г.

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

4.17-beta.5Бета1.20.5, 1.20.6, 1.21 · 15 июля 2024 г.
  • #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

4.17-beta.4Бета1.20.5, 1.20.6, 1.21 · 13 июня 2024 г.

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

4.17-beta.3Бета1.20.4, 1.20.5, 1.20.6 · 26 мая 2024 г.
  • #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

Комментарии

Загружаем…