支持 Minecraft 1.19.3
为大部分 NBT 逻辑添加了接口，包括只读版本
新增工具类 NBT，提供简洁的 Lambda 方式读写 NBT。使用示例已更新至：https://github.com/tr7zw/Item-NBT-API/wiki/Using-the-NBT-API
为 NBTFile 添加了工具方法 readFrom 和 saveTo
新增 hasTag 方法，作为 hasKey 的替代方案，返回类型为 boolean 而非 Boolean
新增 getOrDefault 方法
新增 getOrNull 方法
已弃用 setObject / getObject 方法，请自行使用您偏好的库或配置完成序列化
getUUID / setUUID 方法现已能自动正确处理 1.16 版本前后的 UUID 格式
getItemStack 方法在标签未找到时将返回 null
getKeys 方法现在返回的是 Set 的副本，不再关联 NMS 内部对象
新增 setItemStackArray / getItemStackArray 方法
为 ItemStack 新增 modifyMeta 方法。请勿在 modifyMeta 作用域内直接修改 NBT
文档 Wiki 已迁移至 GitHub 仓库中，欢迎任何人通过 Pull Request 补充示例、说明等内容
NBTItem 现在会正确拒绝大小为 0 的 ItemStack
大量更新了 JavaDoc 注释
完整的 API JavaDoc 现已发布于：https://tr7zw.github.io/Item-NBT-API/v2-api/
通过 Maven/Gradle 引入 NBTAPI 插件时，现在将同时包含 API 的 JavaDoc（此前仅含插件本身的 JavaDoc）
修复了错误报告过程中出现的一个小型空指针异常（NPE）问题（颇具讽刺意味）
NBTCompoundList 现继承自 NBTList<ReadWriteNBT>, 不再继承 NBTList<NBTListCompound>。这是一项编译期破坏性变更，相关代码需相应调整。已发布的插件不受此变更影响。

2.10.0

on 2026 Jul 17

下载

新增：

支持 1.19 版本
支持 1.7.10 版本的坩埚（请使用最新构建版本）。感谢 EverNife

2.15.7

on 2026 Apr 06

下载

更新内容

新增将任何 26.1.x 构建版本视为受支持，前提是 Mojang/Spigot/Paper 不会在补丁版本中引入破坏性变更
新增对 Paper 26.1.1+ 新版本格式的支持

完整更新日志：https://github.com/tr7zw/Item-NBT-API/compare/2.15.6...2.15.7

2.15.6

on 2026 Mar 28

下载

更新内容

新增对 26.1 的完全支持（上一个构建无需改动即可运行）
修复升级物品 nbt 时 DataVersion 不会变更的问题
将 org.bstats:bstats-bukkit 从 3.1.0 升级到 3.2.1，贡献者：@dependabot[bot]，见 https://github.com/tr7zw/Item-NBT-API/pull/347
将 org.apache.maven.plugins:maven-compiler-plugin 从 3.14.1 升级到 3.15.0，贡献者：@dependabot[bot]，见 https://github.com/tr7zw/Item-NBT-API/pull/344
将 org.codehaus.mojo:license-maven-plugin 从 2.7.0 升级到 2.7.1，贡献者：@dependabot[bot]，见 https://github.com/tr7zw/Item-NBT-API/pull/341
将 org.apache.maven.plugins:maven-shade-plugin 从 3.6.1 升级到 3.6.2，贡献者：@dependabot[bot]，见 https://github.com/tr7zw/Item-NBT-API/pull/348

完整更新日志：https://github.com/tr7zw/Item-NBT-API/compare/2.15.5...2.15.6

2.15.5

on 2025 Dec 09

下载

更新内容

修复了API报告无法识别1.21.11版本的问题

完整更新日志: https://github.com/tr7zw/Item-NBT-API/compare/2.15.4...2.15.5

2.15.4

on 2025 Dec 09

下载

更新内容

为 Spigot/Paper 添加 1.21.11 版本支持
将 org.apache.maven.plugins:maven-source-plugin 从 3.3.1 升级至 3.4.0，由 @dependabot[bot] 提交于 https://github.com/tr7zw/Item-NBT-API/pull/339

完整更新日志: https://github.com/tr7zw/Item-NBT-API/compare/2.15.3...2.15.4

2.15.3

on 2025 Oct 13

下载

更新内容

添加对 1.21.9/1.12.10 版本 Spigot/Paper 的支持
修复 1.20.5+ 版本中 GameProfile 的读写问题
将 org.apache.maven.plugins:maven-javadoc-plugin 从 3.11.3 升级至 3.12.0（由 @dependabot[bot] 提交）https://github.com/tr7zw/Item-NBT-API/pull/338
将 org.apache.maven.plugins:maven-compiler-plugin 从 3.14.0 升级至 3.14.1（由 @dependabot[bot] 提交）https://github.com/tr7zw/Item-NBT-API/pull/337
将 org.codehaus.mojo:license-maven-plugin 从 2.6.0 升级至 2.7.0（由 @dependabot[bot] 提交）https://github.com/tr7zw/Item-NBT-API/pull/336
将 org.apache.maven.plugins:maven-shade-plugin 从 3.6.0 升级至 3.6.1（由 @dependabot[bot] 提交）https://github.com/tr7zw/Item-NBT-API/pull/335

完整更新日志: https://github.com/tr7zw/Item-NBT-API/compare/2.15.2...2.15.3

2.15.2

on 2025 Oct 08

下载

主要变更

标记 1.21.8 为兼容版本（此前实际已兼容，此次更新仅移除日志中的警告）
修复在 Spigot 上 1.21.5 版本出现的 CODEC 错误
修复 DataFixerUtil 中变量以使用正确的版本修订
将 org.apache.maven.plugins:maven-javadoc-plugin 从 3.11.2 升级至 3.11.3（由 @dependabot[bot] 提交）https://github.com/tr7zw/Item-NBT-API/pull/333

完整更新日志: https://github.com/tr7zw/Item-NBT-API/compare/2.15.1...2.15.2

2.15.1

on 2025 Jul 03

下载

变更内容

添加了 1.21.6/1.21.7 支持
重新设计了 bStats 阴影/更新了 bStats 版本
修复了带有轻微格式错误的父级 (paper-)plugin.yml 的错误
为字段提供了更好的 Mojmap 支持
添加了新的 bStats 图表：https://bstats.org/plugin/bukkit/ItemNBTAPI/1058
[1.21.6] 通过 @patyhank 在 https://github.com/tr7zw/Item-NBT-API/pull/326 中支持实体和块实体
通过 @dependabot 在 https://github.com/tr7zw/Item-NBT-API/pull/325 中将 org.codehaus.mojo:license-maven-plugin 从 2.5.0 升级到 2.6.0
通过 @patyhank 在 https://github.com/tr7zw/Item-NBT-API/pull/328 中将 1.21.7 标记为受支持

新贡献者

@patyhank 在 https://github.com/tr7zw/Item-NBT-API/pull/326 中进行了首次贡献非常感谢您对更新的贡献，我无法及时完成它。

完整变更日志：https://github.com/tr7zw/Item-NBT-API/compare/2.15.0...2.15.1

2.15.0

on 2025 Apr 25

下载

有哪些变更

增加1.21.5支持（Spigot/Paper及其分支）
大量更新了维基页面
由@SoSeDiK在https://github.com/tr7zw/Item-NBT-API/pull/319中添加了用于物品堆转换的数据版本
修复了列表的#remove(Object)方法会移除对象的每个实例，而不只是第一个实例的问题。#293
由@SoSeDiK在https://github.com/tr7zw/Item-NBT-API/pull/321中添加了一个提取两个化合物之间差异的方法
由@SoSeDiK在https://github.com/tr7zw/Item-NBT-API/pull/320中更新了“读取世界数据”的维基示例
由@dependabot在https://github.com/tr7zw/Item-NBT-API/pull/312中将org.apache.maven.plugins:maven-javadoc-plugin从3.11.1版本升级到3.11.2版本
由@FireML在https://github.com/tr7zw/Item-NBT-API/pull/311中将EvenMoreFish添加到Plugins.md中
由@dependabot在https://github.com/tr7zw/Item-NBT-API/pull/309中将org.codehaus.mojo:license-maven-plugin从2.4.0版本升级到2.5.0版本
由@SoSeDiK在https://github.com/tr7zw/Item-NBT-API/pull/313中更新了维基
由@dependabot在https://github.com/tr7zw/Item-NBT-API/pull/316中将org.apache.maven.plugins:maven-compiler-plugin从3.13.0版本升级到3.14.0版本

新贡献者

@FireML在https://github.com/tr7zw/Item-NBT-API/pull/311中做出了他们的首次贡献

完整变更日志：https://github.com/tr7zw/Item-NBT-API/compare/2.14.1...2.15.0

2.14.1

on 2024 Dec 24

下载

有哪些更改

添加 1.21.4 支持
添加新的实验性 NBTJsonUtil#itemStackToJson 方法，用于 1.20.3+ 聊天悬停组件
@SoSeDiK 在 https://github.com/tr7zw/Item-NBT-API/pull/308 中更新了维基
@dependabot 在 https://github.com/tr7zw/Item-NBT-API/pull/306 中将 org.apache.maven.plugins:maven-javadoc-plugin 从 3.10.1 升级到 3.11.1

完整变更日志：https://github.com/tr7zw/Item-NBT-API/compare/2.14.0...2.14.1

2.14.0

on 2024 Nov 29

下载

无

2.13.2

on 2024 Nov 29

下载

变更内容

添加 1.21.1 支持
@SoSeDiK 在 https://github.com/tr7zw/Item-NBT-API/pull/287 中进行了一些小的维基更改
@dependabot 在 https://github.com/tr7zw/Item-NBT-API/pull/290 中将 org.apache.maven.plugins:maven-javadoc-plugin 从 3.7.0 升级到 3.8.0
@SoSeDiK 在 https://github.com/tr7zw/Item-NBT-API/pull/288 中防止在方块实体测试期间加载区块

完整变更日志：https://github.com/tr7zw/Item-NBT-API/compare/2.13.1...2.13.2