> For the complete documentation index, see [llms.txt](https://spintowin.superiormc.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://spintowin.superiormc.cn/jian-ti-zhong-wen-2/gong-neng/saved-item.md).

# 💾保存物品

## 保存手持物品

使用 `/s2w save <saveItemID>` 保存主手物品。保存方式有两种：

* **Bukkit**：通过 Bukkit API 序列化。可以保存原版数据及 Bukkit 持久化数据容器中的数据，但不保证保存第三方插件的其他自定义 NBT。
* **Paper**：通过 Paper API 保存更完整的物品数据，英文版文档标注为 Paper 1.15 及以上专用功能。

Paper 服务端默认可以使用 Paper 保存方式。如果希望仍使用 Bukkit 方式，在 `config.yml` 中将 `paper-api.save-item` 设为 `false`。

## 使用已保存物品

在[物品格式](https://ultimateshop.superiormc.cn/format/itemformat-tm)的 `material` 选项中，可以填写保存时使用的物品 ID，而不只限于原版物品 ID。

```yaml
display-item:
  material: superior_sword # 已保存物品 ID 为 superior_sword
```

例如，在奖励节点中设置 `material: superior_sword`，即可读取同名已保存物品。

插件会持续缓存已加载的保存物品，避免重复读取文件；保存物品数量越多，也会占用更多内存。
