Minecraft Servers HQ

Плагін Minecraft NBTAPI

Інформація про NBTAPI і сервери, де його знайдено

SpigotPaperAPIUtilityDevelopmentLibraryNBTPersistenceItem ManagementStorageDeveloper APIEntity Management

🔌 Про NBT-API

NBT-API (Item-NBT-API) — це бібліотека плагінів Minecraft, яка дозволяє розробникам читати, записувати та прив’язувати теги NBT до предметів, сутностей і блок-сутностей без використання NMS. Проєкт надає стабільну обгортку для роботи з NBT у різних версіях серверів і пропонує утиліти для серіалізації та збереження даних NBT.

🎯 Призначення

Надати API для розробників для роботи з даними Named Binary Tag (NBT), щоб автори плагінів могли зберігати метадані, власні дані предметів, теги сутностей або дані блок-сутностей без прямої залежності від внутрішніх механізмів сервера.

⚙️ Можливості

  • Читання та запис NBT для предметів, сутностей і блок-сутностей.
  • Створення та зміна вкладених compound NBT і примітивних типів тегів.
  • Утиліти для збереження NBT як тексту або в інших контейнерах.
  • Підтримка серіалізації NBT у файли або у вигляді рядків для зберігання в YAML/JSON/SQL/Redis.
  • Прагне надати стабільний шар абстракції між змінами версій сервера.

🧩 Для кого це

  • Для розробників плагінів, яким потрібен надійний доступ до NBT без написання NMS.
  • Для серверів, яким потрібні власні метадані предметів або постійні дані сутностей/блок-сутностей, керовані плагінами.

🏗️ Приклади використання

  • Додати власні метадані до item stack, які зберігаються між збереженнями.
  • Зберігати додаткові властивості на сутностях (наприклад, власні ідентифікатори) без зміни коду сервера.
  • Серіалізувати NBT предмета або блока в базу даних чи файл конфігурації для подальшого відновлення.

⚙️ Встановлення

📥 Налаштування

  • Завантажте офіційний JAR плагіна та/або додайте API як залежність у вашу систему збірки.
  • Помістіть JAR плагіна в директорію сервера plugins/ (якщо використовуєте збірку плагіна) або додайте API як compile/runtime залежність для вашого плагіна.
  • Перезапустіть сервер і перевірте консоль сервера, щоб переконатися, що бібліотека/плагін завантажилися правильно.

🧠 Технічні примітки

  • Проєкт публікується й підтримується на GitHub і розповсюджується за ліцензією MIT.
  • Офіційні джерела вказують на підтримку серверних середовищ Bukkit/Spigot/Paper.
  • Бібліотека містить модулі для прямого використання в проєктах плагінів і модуль плагіна для використання на сервері.

🤝 Коли цей плагін корисний

Якщо вам потрібен надійний, стійкий до змін версій доступ до NBT для предметів, сутностей або блок-сутностей без використання NMS, NBT-API надає зосереджену бібліотеку, яка спрощує читання, запис і збереження цих даних для розробників плагінів.

Сервери з плагіном NBTAPI

Сторінка плагіна NBTAPI показує, на яких серверах моніторинг знайшов цей плагін, з якими платформами та версіями він зустрічається.

Плагіни можуть додавати команди, економіку, захист, права доступу, міні-ігри, інтеграції або інші механіки. Фактична роль NBTAPI залежить від конфігурації конкретного сервера.

Дані формуються автоматично з технічних відповідей серверів. Якщо сервер приховує список плагінів, він може не відображатися в цьому розділі, навіть якщо використовує NBTAPI.

Використовуйте список серверів з NBTAPI, щоб порівняти проєкти, перевірити сумісні версії або знайти приклади використання плагіна на публічних серверах.