转载 闭源 工具 世界管理 物品仓库 1.0.0

[MD]
## 简介

ItemVault 是一款 Minecraft 虚拟物品仓库插件。玩家可以将物品存入数据库，并在需要时随时取出。

# 物品仓库

**ItemVault** 是一款 Minecraft 虚拟物品仓库插件。玩家可以将物品存入数据库，并在需要时随时取出。

插件会以分类 GUI 展示已存储的物品；每种物品都会保留原始图标，并显示当前存储数量。适用于生存、经济、RPG、SkyBlock、BoxPvP 以及资源需求较高的服务器。

## 功能特性

- 为每位玩家提供独立的虚拟物品仓库。
- 基于分类的图形化界面。
- 物品搜索功能。
- 支持原版物品与自定义物品。
- 可保存物品名称、Lore、附魔及其他元数据。
- 自动存入物品功能。
- 忽略快捷栏槽位功能。
- 支持通过控制台执行管理命令。
- 安全取出机制：背包空间不足时，无法放入的物品不会丢失。
- 支持 PlaceholderAPI。
- 使用 SQLite 数据库。
- 支持 Paper、Purpur 及其兼容分支服务端。

## 兼容性

ItemVault 专为 Paper 和 Purpur 服务端设计。

支持环境：

- Minecraft 1.20.1
- Minecraft 1.21.x
- Java 21
- Paper / Purpur

可选依赖：

- PlaceholderAPI

## 玩家命令

| 命令 | 说明 |
| --- | --- |
| ```txt
/itemvault
``` | 打开虚拟仓库。 |
| ```txt
/itemvault guardar
``` | 存入当前手持的物品。 |
| ```txt
/itemvault guardar
``` | 存入背包中所有可存储的物品。 |
| ```txt
/itemvault retirar <material> <amount>
``` | 取出指定数量的某种材料。 |
| ```txt
/itemvault buscar <text>
``` | 按名称、材料或文本搜索已存储的物品。 |
| ```txt
/itemvault ignorar
``` | 将当前选中的快捷栏槽位设为忽略或取消忽略。使用 `/itemvault guardarall` 自动存入物品时，该槽位中的物品不会被存入。 |
| ```txt
/itemvault autoguardar
``` | 为当前选中的物品开启或关闭自动存入。 |
| ```txt
/itemvault mensajes
``` | 开启或关闭自动存入提示消息。 |

## 西班牙语命令别名

插件同时提供西班牙语命令别名：

```txt
/almacen
/almacen guardar
/almacen guardarall
/almacen retirar <material> <cantidad>
/almacen buscar <texto>
/almacen ignorar
/almacen autoguardar
/almacen mensajes
```

## 管理命令

```txt
/itemvault admin give <player> <material> <amount>
/itemvault admin take <player> <material> <amount>
/itemvault admin set <player> <material> <amount>
```

这些命令可通过控制台执行，管理员可以向指定玩家的虚拟仓库中添加、移除或设置物品数量。

## 命令别名

```txt
/itemvault
/almacen
```

## PlaceholderAPI 支持

ItemVault 内置 PlaceholderAPI 支持。

```txt
%itemvault_item_<MATERIAL>%
```

该占位符可显示指定材料的存储数量。

示例：

```txt
%itemvault_item_DIAMOND%
%itemvault_item_IRON_INGOT%
%itemvault_item_TORCH%
%itemvault_item_COBBLED_DEEPSLATE%
```

其他占位符：

```txt
%itemvault_total_items%
%itemvault_total_types%
%itemvault_is_empty%
%itemvault_has_<MATERIAL>%
```

计分板示例：

```yaml
- '&bDiamonds: &f%itemvault_item_DIAMOND%'
- '&7Torches: &f%itemvault_item_TORCH%'
- '&aTotal stored: &f%itemvault_total_items%'
```

## GUI 分类

仓库菜单按以下类别整理，便于管理物品：

- 全部
- 矿物
- 方块
- 木材
- 食物
- 工具与武器
- 盔甲
- 农业
- 红石
- 生物掉落物
- 装饰
- 药水
- 其他

## 物品搜索

搜索系统可帮助玩家快速查找已存储的物品。

示例：

```txt
/itemvault search diamond
/itemvault search iron
/itemvault search torch
/itemvault search pickaxe
/itemvault search sword
/itemvault search food
```

同时支持西班牙语搜索：

```txt
/almacen buscar diamante
/almacen buscar hierro
/almacen buscar antorcha
/almacen buscar pico
/almacen buscar espada
```

搜索系统还会忽略重音符号，例如：

```txt
carbon
carbón
pocion
poción
```

## 安全取出

当玩家尝试取出的物品数量超过背包可容纳的数量时，ItemVault 只会给予能够放入背包的部分，剩余物品会安全保留在虚拟仓库中。

该机制可避免因背包空间不足而意外丢失物品。

## 自动存入

玩家可以使用以下命令，为选中的物品启用自动存入：

```txt
/itemvault autoguardar
```

当玩家从地面拾取该物品时，物品会自动转移至虚拟仓库。

## 忽略槽位

玩家可使用以下命令保护当前选中的快捷栏槽位：

```txt
/itemvault ignorar
```

使用 `/storage saveall` 自动存入物品时，放置在该槽位中的任何物品都不会被自动存入。

此功能适合保护工具、武器、食物、不死图腾或其他重要物品。

## 依赖项

可选依赖：

```txt
PlaceholderAPI
```

## 数据库

ItemVault 会自动使用 SQLite 数据库。

数据库文件保存位置：

```txt
plugins/ItemVault/itemvault.db
```

## 适用场景

- 生存服务器
- 经济服务器
- RPG 服务器
- Java 与 Bedrock 跨平台服务器
- 资源消耗较高的服务器
- 奖励系统
- 结合 PlaceholderAPI 的计分板与全息显示
- 需要通过控制台命令扣除玩家物品的活动

## 截图


[/MD]