NBT-API
Add custom NBT tags to Items/Tiles/Entities without NMS
Автор: tr7zw356,9 тыс.299обновлён 17 сент. 2026 г.
Библиотеки
Описание
(Item-)NBT-API
Add custom NBT tags to Items/Tiles/Entities without NMS! Modify NBT and store it Files, other NBT or as String in yaml/json/SQL/Redis. Server Owner/Developer Wiki
Build/Maven Status
SpigotMC Status
Getting started
Import the API using Maven, then check out the basic usage or code examples like working with Skulls.
bStats
Последние версии
Все версии →release
2.16.1
2.16.117 сент. 2026 г.18,6 тыс.Minecraft: 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 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.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3bukkit, folia, paper, purpur, spigot
Что нового
## What's Changed
* Add Minecraft 26.3 item stack compatibility by @NriotHrreion in https://github.com/tr7zw/Item-NBT-API/pull/360
* Bump org.apache.maven.plugins:maven-compiler-plugin from 3.15.0 to 3.16.0 by @dependabot[bot] in https://github.com/tr7zw/Item-NBT-API/pull/359
## New Contributors
* @NriotHrreion made their first contribution in https://github.com/tr7zw/Item-NBT-API/pull/360
**Full Changelog**: https://github.com/tr7zw/Item-NBT-API/compare/2.16.0...2.16.1
release
2.16.0
2.16.027 июл. 2026 г.23,2 тыс.Minecraft: 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 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.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2bukkit, folia, paper, purpur, spigot
Что нового
## What's Changed
* Add 26.2 as supported (already worked, but now without complaining)
* Migrate NBTBlock & NBTChunk to NBT by @SoSeDiK in https://github.com/tr7zw/Item-NBT-API/pull/353
* Fix 'GET_LIST' and 'OWN_TYPE' to their 'LEGACY' sufixed name on Forge at 1.7.10 by @EverNife in https://github.com/tr7zw/Item-NBT-API/pull/356
* Update readme badges by @SoSeDiK in https://github.com/tr7zw/Item-NBT-API/pull/354
## Dev notes
* Consider updating to the new ``NBT.readAndGetChunkPDC``/``NBT.readChunkPDC`` etc. methods as a replacement for the ``NBTChunk``/``NBTBlock`` classes. The new methods will be faster for reading, and not leave behind empty tags.
* Reminder that 1.7.10 is not officially supported anymore, including Forge hybrids. Use at your own risk/use PRs to resolve issues
* When shading, just because the MinecraftVersion is UNKNOWN doesn't mean the NBTAPI isn't working, just that this version hasn't been tested against that Minecraft version. So don't refuse the plugin loading just because of that.
**Full Changelog**: https://github.com/tr7zw/Item-NBT-API/compare/2.15.7...2.16.0
release
2.15.7
2.15.76 апр. 2026 г.40,5 тыс.Minecraft: 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 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.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2bukkit, folia, paper, purpur, spigot
Что нового
## What's Changed
* Added any 26.1.x build as supported, assuming that Mojang/Spigot/Paper don't introduce breaking changes in patch releases
* Added support for Papers 26.1.1+ new versioning format
**Full Changelog**: https://github.com/tr7zw/Item-NBT-API/compare/2.15.6...2.15.7
release
2.15.6
2.15.628 мар. 2026 г.3 тыс.Minecraft: 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 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.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1bukkit, folia, paper, purpur, spigot
Что нового
## What's Changed
* Add 26.1 as fully supported (last build did work without changes)
* Fix DataVersion not changing when upgrading Item nbt
* Bump org.bstats:bstats-bukkit from 3.1.0 to 3.2.1 by @dependabot[bot] in https://github.com/tr7zw/Item-NBT-API/pull/347
* Bump org.apache.maven.plugins:maven-compiler-plugin from 3.14.1 to 3.15.0 by @dependabot[bot] in https://github.com/tr7zw/Item-NBT-API/pull/344
* Bump org.codehaus.mojo:license-maven-plugin from 2.7.0 to 2.7.1 by @dependabot[bot] in https://github.com/tr7zw/Item-NBT-API/pull/341
* Bump org.apache.maven.plugins:maven-shade-plugin from 3.6.1 to 3.6.2 by @dependabot[bot] in https://github.com/tr7zw/Item-NBT-API/pull/348
**Full Changelog**: https://github.com/tr7zw/Item-NBT-API/compare/2.15.5...2.15.6
release
2.15.5
2.15.59 дек. 2025 г.26,8 тыс.Minecraft: 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 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.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, folia, paper, purpur, spigot
Что нового
## What's Changed
* Fixed that the API reports that it doesn't know about 1.21.11
**Full Changelog**: https://github.com/tr7zw/Item-NBT-API/compare/2.15.4...2.15.5
release
2.15.4
2.15.49 дек. 2025 г.306Minecraft: 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 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.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, folia, paper, purpur, spigot
Что нового
## What's Changed
* Add 1.21.11 support for Spigot/Paper
* Bump org.apache.maven.plugins:maven-source-plugin from 3.3.1 to 3.4.0 by @dependabot[bot] in https://github.com/tr7zw/Item-NBT-API/pull/339
**Full Changelog**: https://github.com/tr7zw/Item-NBT-API/compare/2.15.3...2.15.4
release
2.15.3
2.15.311 окт. 2025 г.13,1 тыс.Minecraft: 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 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.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10bukkit, folia, paper, purpur, spigot
Что нового
## What's Changed
* Add 1.21.9/1.12.10 spigot/paper support
* Fix gameprofile writing/reading in 1.20.5+
* Bump org.apache.maven.plugins:maven-javadoc-plugin from 3.11.3 to 3.12.0 by @dependabot[bot] in https://github.com/tr7zw/Item-NBT-API/pull/338
* Bump org.apache.maven.plugins:maven-compiler-plugin from 3.14.0 to 3.14.1 by @dependabot[bot] in https://github.com/tr7zw/Item-NBT-API/pull/337
* Bump org.codehaus.mojo:license-maven-plugin from 2.6.0 to 2.7.0 by @dependabot[bot] in https://github.com/tr7zw/Item-NBT-API/pull/336
* Bump org.apache.maven.plugins:maven-shade-plugin from 3.6.0 to 3.6.1 by @dependabot[bot] in https://github.com/tr7zw/Item-NBT-API/pull/335
**Full Changelog**: https://github.com/tr7zw/Item-NBT-API/compare/2.15.2...2.15.3
release
2.15.2
2.15.226 авг. 2025 г.8,7 тыс.Minecraft: 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 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.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8bukkit, folia, paper, purpur, spigot
Что нового
## What's Changed
* Mark 1.21.8 as compatible (it was before too, this just removes the warning in the log)
* Fix 1.21.5 on spigot having CODEC errors
* Fixed variables for the DataFixerUtil to use revisions
* Bump org.apache.maven.plugins:maven-javadoc-plugin from 3.11.2 to 3.11.3 by @dependabot[bot] in https://github.com/tr7zw/Item-NBT-API/pull/333
**Full Changelog**: https://github.com/tr7zw/Item-NBT-API/compare/2.15.1...2.15.2
release
2.15.1
2.15.11 июл. 2025 г.12,8 тыс.Minecraft: 1.8.8, 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 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.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8bukkit, folia, paper, purpur, spigot
Что нового
## What's Changed
* Added 1.21.6/1.21.7 support
* Reworked bStats shading/Updated bStats version
* Fixed errors with slightly malformed parent (paper-)plugin.yml
* Better Mojmap support for fields
* Added new bStats graphs: https://bstats.org/plugin/bukkit/ItemNBTAPI/1058
* [1.21.6] support Entity and BlockEntity by @patyhank in https://github.com/tr7zw/Item-NBT-API/pull/326
* Bump org.codehaus.mojo:license-maven-plugin from 2.5.0 to 2.6.0 by @dependabot in https://github.com/tr7zw/Item-NBT-API/pull/325
* Mark 1.21.7 as supported by @patyhank in https://github.com/tr7zw/Item-NBT-API/pull/328
## New Contributors
* @patyhank made their first contribution in https://github.com/tr7zw/Item-NBT-API/pull/326
Thank you so much for the contributions to the update, I wouldn't have been able to finish it in time.
**Full Changelog**: https://github.com/tr7zw/Item-NBT-API/compare/2.15.0...2.15.1
release
2.15.0
2.15.017 апр. 2025 г.23,1 тыс.Minecraft: 1.8.9, 1.9, 1.9.1, 1.9.2, 1.9.3, 1.9.4, 1.10, 1.10.1, 1.10.2, 1.11, 1.11.1, 1.11.2, 1.12, 1.12.1, 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 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.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5bukkit, paper, purpur, spigot
Что нового
## What's Changed
* Add 1.21.5 support (Spigot/Paper/forks)
* Updated Wiki pages a lot
* Add DataVersion for itemstack conversions by @SoSeDiK in https://github.com/tr7zw/Item-NBT-API/pull/319
* Fixed list#remove(Object) removing every instance of the Object, not just the first one. #293
* Add a method to extract difference between two compounds by @SoSeDiK in https://github.com/tr7zw/Item-NBT-API/pull/321
* Update "Reading world data" wiki example by @SoSeDiK in https://github.com/tr7zw/Item-NBT-API/pull/320
* Bump org.apache.maven.plugins:maven-javadoc-plugin from 3.11.1 to 3.11.2 by @dependabot in https://github.com/tr7zw/Item-NBT-API/pull/312
* Add EvenMoreFish to Plugins.md by @FireML in https://github.com/tr7zw/Item-NBT-API/pull/311
* Bump org.codehaus.mojo:license-maven-plugin from 2.4.0 to 2.5.0 by @dependabot in https://github.com/tr7zw/Item-NBT-API/pull/309
* Update wiki by @SoSeDiK in https://github.com/tr7zw/Item-NBT-API/pull/313
* Bump org.apache.maven.plugins:maven-compiler-plugin from 3.13.0 to 3.14.0 by @dependabot in https://github.com/tr7zw/Item-NBT-API/pull/316
## New Contributors
* @FireML made their first contribution in https://github.com/tr7zw/Item-NBT-API/pull/311
**Full Changelog**: https://github.com/tr7zw/Item-NBT-API/compare/2.14.1...2.15.0
