修改示例配置文件的位置

.documentation/JAVADOC-README.md

@@ -1,6 +1,6 @@
-# UltraBackpack Javadoc
+# UltraDepository Javadoc
 
-基于 [Github Pages](https://pages.github.com/) 搭建，请访问 [JavaDoc](https://carmjos.github.io/UltraBackpack) 。
+基于 [Github Pages](https://pages.github.com/) 搭建，请访问 [JavaDoc](https://carmjos.github.io/UltraDepository) 。
 
 ## 如何实现？
 

.documentation/README.md

@@ -1,17 +1,18 @@
 ```text
- _    _ _ _             ____             _                     _    
+ _    _ _ _             _____                       _ _                   
-| |  | | | |           |  _ \           | |                   | |   
+| |  | | | |           |  __ \                     (_) |                  
-| |  | | | |_ _ __ __ _| |_) | __ _  ___| | ___ __   __ _  ___| | __
+| |  | | | |_ _ __ __ _| |  | | ___ _ __   ___  ___ _| |_ ___  _ __ _   _ 
-| |  | | | __| '__/ _` |  _ < / _` |/ __| |/ / '_ \ / _` |/ __| |/ /
+| |  | | | __| '__/ _` | |  | |/ _ \ '_ \ / _ \/ __| | __/ _ \| '__| | | |
-| |__| | | |_| | | (_| | |_) | (_| | (__|   <| |_) | (_| | (__|   < 
+| |__| | | |_| | | (_| | |__| |  __/ |_) | (_) \__ \ | || (_) | |  | |_| |
- \____/|_|\__|_|  \__,_|____/ \__,_|\___|_|\_\ .__/ \__,_|\___|_|\_\
+ \____/|_|\__|_|  \__,_|_____/ \___| .__/ \___/|___/_|\__\___/|_|   \__, |
-                                             | |                    
+                                   | |                               __/ |
-                                             |_|                    
+                                   |_|                              |___/ 
 ```
-# UltraBackpack 帮助介绍文档
+
+# UltraDepository 帮助介绍文档
 
 ## [开发文档](JAVADOC-README.md)
 
-基于 [Github Pages](https://pages.github.com/) 搭建，请访问 [JavaDoc](https://carmjos.github.io/UltraBackpack) 。
+基于 [Github Pages](https://pages.github.com/) 搭建，请访问 [JavaDoc](https://carmjos.github.io/UltraDepository) 。
 
 ## 文档目录

.examples/depositories/README.md

@@ -0,0 +1,31 @@
+# UltraDepository 示例仓库配置
+
+## 使用须知
+
+示例配置基于 MineCraft 1.16 实现，更低版本可能无法使用。
+
+## 如何使用？
+
+1. 下载并安装 UltraDepository 插件。
+2. 启动服务器，配置 `config.yml` 中的一些基础设置。
+3. 下载你想要的示例仓库配置文件，并放入 `插件配置目录/depositories` 下。
+4. 重启服务器，即可令对应的配置文件生效！
+
+
+## 示例图片
+
+### 渔夫仓库 ([fishman.yml](files/fishman.yml))
+
+![fishman](images/fishman.png)
+
+### 矿工仓库 ([miner.yml](files/miner.yml))
+
+![miner](images/miner.png)
+
+### 农夫仓库 ([farmer.yml](files/farmer.yml))
+
+![farmer](images/farmer.png)
+
+### 猎人仓库 ([hunter.yml](files/hunter.yml))
+
+![hunter](images/hunter.png)

.examples/depositories/files/farmer.yml

@@ -0,0 +1,129 @@
+name: "&a&l农夫仓库"
+
+capacity:
+  default: 500 # 若为0则默认不可以使用该仓库
+  permissions:
+    - "ud.farmer.vip:1000"
+
+gui:
+  title: "&a&l农夫仓库"
+  lines: 6
+  items:
+    "INFO":
+      material: CHEST
+      data: 0
+      slot: 49
+      name: "&2&l背包信息"
+      lore:
+        - " "
+        - "&f仓库最大容量&a %UltraDepository_capacity_farmer%"
+        - "&f仓库已用容量&a %UltraDepository_used_farmer%"
+        - "&f仓库剩余容量&a %UltraDepository_usable_farmer%"
+        - " "
+
+items:
+  "WHEAT_SEEDS":
+    slot: 10
+    price: 0.1
+    limit: 500
+    name: "&a&l小麦种子"
+  "MELON_SEEDS":
+    slot: 11
+    price: 0.1
+    limit: 500
+    name: "&8&l西瓜种子"
+  "PUMPKIN_SEEDS":
+    slot: 12
+    price: 0.1
+    limit: 500
+    name: "&f&l南瓜种子"
+  "BEETROOT_SEEDS":
+    slot: 13
+    price: 0.1
+    limit: 500
+    name: "&7&l甜菜种子"
+  "NETHER_WART":
+    slot: 14
+    price: 0.1
+    limit: 500
+    name: "&c&l地狱疣"
+  "COCOA_BEANS":
+    slot: 15
+    price: 0.1
+    limit: 500
+    name: "&6&l可可豆"
+  "SWEET_BERRIES":
+    slot: 16
+    price: 0.1
+    limit: 500
+    name: "&c&l树莓"
+  "BEETROOT":
+    slot: 19
+    price: 0.1
+    limit: 500
+    name: "&c&l甜菜根"
+  "CARROT":
+    slot: 20
+    price: 0.1
+    limit: 500
+    name: "&6&l胡萝卜"
+  "POTATO":
+    slot: 21
+    price: 0.1
+    limit: 500
+    name: "&e&l土豆"
+  "WHEAT":
+    slot: 22
+    price: 0.1
+    limit: 500
+    name: "&e&l小麦"
+  "MELON_SLICE":
+    slot: 23
+    price: 0.1
+    limit: 500
+    name: "&c&l西瓜片"
+  "PUMPKIN":
+    slot: 24
+    price: 0.1
+    limit: 500
+    name: "&6&l南瓜"
+  "CACTUS":
+    slot: 25
+    price: 0.1
+    limit: 500
+    name: "&2&l仙人掌"
+  "POISONOUS_POTATO":
+    slot: 28
+    price: 0.1
+    limit: 500
+    name: "&a&l毒土豆"
+  "KELP":
+    slot: 29
+    price: 0.1
+    limit: 500
+    name: "&2&l海带"
+  "SUGAR_CANE":
+    slot: 30
+    price: 0.1
+    limit: 500
+    name: "&a&l甘蔗"
+  "BAMBOO":
+    slot: 31
+    price: 0.1
+    limit: 500
+    name: "&a&l竹子"
+  "VINE":
+    slot: 32
+    price: 0.1
+    limit: 500
+    name: "&2&l藤蔓"
+  "CHORUS_FRUIT":
+    slot: 33
+    price: 0.1
+    limit: 500
+    name: "&d&l紫颂果"
+  "CHORUS_PLANT":
+    slot: 34
+    price: 0.1
+    limit: 500
+    name: "&5&l紫颂植株"

.examples/depositories/files/fishman.yml

@@ -0,0 +1,64 @@
+name: "&b&l渔夫仓库"
+
+capacity:
+  default: 500 # 若为0则默认不可以使用该仓库
+  permissions:
+    - "ud.fishman.vip:1000"
+
+gui:
+  title: "&b&l渔夫仓库"
+  lines: 4
+  items:
+    "INFO":
+      material: CHEST
+      data: 0
+      slot: 31
+      name: "&9&l背包信息"
+      lore:
+        - " "
+        - "&f仓库最大容量&b %UltraDepository_capacity_fishman%"
+        - "&f仓库已用容量&b %UltraDepository_used_fishman%"
+        - "&f仓库剩余容量&b %UltraDepository_usable_fishman%"
+        - " "
+
+items:
+  "INK_SAC":
+    slot: 11
+    price: 0.1
+    limit: 500
+    name: "&8&l墨囊"
+    lore:
+      - " "
+      - "&f抓住墨鱼！"
+  "TROPICAL_FISH":
+    slot: 12
+    price: 0.1
+    limit: 500
+    name: "&(#EE7942)&l小丑鱼"
+    lore:
+      - " "
+      - "&f不是小丑！"
+  "SALMON":
+    slot: 13
+    price: 0.1
+    limit: 500
+    name: "&c&l鲑鱼"
+    lore:
+      - " "
+      - "&f肉质鲜美！"
+  "COD":
+    slot: 14
+    price: 0.1
+    limit: 500
+    name: "&f&l鳕鱼"
+    lore:
+      - " "
+      - "&f十分美味！"
+  "PUFFERFISH":
+    slot: 15
+    price: 0.1
+    limit: 500
+    name: "&6&L河豚"
+    lore:
+      - " "
+      - "&f小心有毒！"

.examples/depositories/files/hunter.yml

@@ -0,0 +1,130 @@
+name: "&5&l猎人仓库"
+
+capacity:
+  default: 500 # 若为0则默认不可以使用该仓库
+  permissions:
+    - "ud.hunter.vip:1000"
+
+gui:
+  title: "&5&l猎人仓库"
+  lines: 6
+  items:
+    "INFO":
+      material: CHEST
+      data: 0
+      slot: 49
+      name: "&5&l背包信息"
+      lore:
+        - " "
+        - "&f仓库最大容量&d %UltraDepository_capacity_hunter%"
+        - "&f仓库已用容量&d %UltraDepository_used_hunter%"
+        - "&f仓库剩余容量&d %UltraDepository_usable_hunter%"
+        - " "
+
+
+items:
+  "CHICKEN":
+    slot: 10
+    price: 0.1
+    limit: 500
+    name: "&6&l鸡肉"
+  "PORKCHOP":
+    slot: 11
+    price: 0.1
+    limit: 500
+    name: "&c&l猪肉"
+  "BEEF":
+    slot: 12
+    price: 0.1
+    limit: 500
+    name: "&c&l牛肉"
+  "MUTTON":
+    slot: 13
+    price: 0.1
+    limit: 500
+    name: "&6&l羊肉"
+  "RABBIT":
+    slot: 14
+    price: 0.1
+    limit: 500
+    name: "&f&l兔肉"
+  "RABBIT_HIDE":
+    slot: 15
+    price: 0.1
+    limit: 500
+    name: "&f&l兔子皮"
+  "LEATHER":
+    slot: 16
+    price: 0.1
+    limit: 500
+    name: "&c&l皮革"
+  "EGG":
+    slot: 19
+    price: 0.1
+    limit: 500
+    name: "&f&l鸡蛋"
+  "RABBIT_FOOT":
+    slot: 20
+    price: 0.1
+    limit: 500
+    name: "&f&l兔子脚"
+  "FEATHER":
+    slot: 21
+    price: 0.1
+    limit: 500
+    name: "&f&l羽毛"
+  "GOLD_NUGGET":
+    slot: 22
+    price: 0.1
+    limit: 500
+    name: "&e&l金粒"
+  "GHAST_TEAR":
+    slot: 23
+    price: 0.1
+    limit: 500
+    name: "&7&l恶魂之泪"
+  "BLAZE_ROD":
+    slot: 24
+    price: 0.1
+    limit: 500
+    name: "&e&l烈焰棒"
+  "MAGMA_CREAM":
+    slot: 25
+    price: 0.1
+    limit: 500
+    name: "&c&l岩浆球"
+  "SLIME_BALL":
+    slot: 28
+    price: 0.1
+    limit: 500
+    name: "&a&l粘液球"
+  "BONE":
+    slot: 29
+    price: 0.1
+    limit: 500
+    name: "&f&l骨头"
+  "SPIDER_EYE":
+    slot: 30
+    price: 0.1
+    limit: 500
+    name: "&4&l蜘蛛眼"
+  "GUNPOWDER":
+    slot: 31
+    price: 0.1
+    limit: 500
+    name: "&7&l火药"
+  "ROTTEN_FLESH":
+    slot: 32
+    price: 0.1
+    limit: 500
+    name: "&2&l腐肉"
+  "STRING":
+    slot: 33
+    price: 0.1
+    limit: 500
+    name: "&f&l线"
+  "ENDER_PEARL":
+    slot: 34
+    price: 0.1
+    limit: 500
+    name: "&5&l末影珍珠"

.examples/depositories/files/miner.yml

@@ -0,0 +1,136 @@
+name: "&e&l矿工仓库"
+
+capacity:
+  default: 5000 # 若为0则默认不可以使用该仓库
+  permissions:
+    - "ud.miner.vip:10000"
+
+gui:
+  title: "&e&l矿工仓库"
+  lines: 6
+  items:
+    "INFO":
+      material: CHEST
+      data: 0
+      slot: 49
+      name: "&e&l背包信息"
+      lore:
+        - " "
+        - "&f仓库最大容量&6 %UltraDepository_capacity_miner%"
+        - "&f仓库已用容量&6 %UltraDepository_used_miner%"
+        - "&f仓库剩余容量&6 %UltraDepository_usable_miner%"
+        - " "
+
+items:
+  "COBBLESTONE":
+    slot: 11
+    price: 0.1
+    limit: 500
+    name: "&f&l圆石"
+    lore:
+      - " "
+      - "&f方块！"
+  "IRON_ORE":
+    slot: 12
+    price: 0.1
+    limit: 500
+    name: "&f&l铁矿"
+    lore:
+      - " "
+      - "&f升级！"
+  "GOLD_ORE":
+    slot: 13
+    price: 0.1
+    limit: 500
+    name: "&e&l金矿"
+    lore:
+      - " "
+      - "&f财富！"
+  "COAL":
+    slot: 14
+    price: 0.1
+    limit: 500
+    name: "&8&l煤炭"
+    lore:
+      - " "
+      - "&f燃料！"
+  "FLINT":
+    slot: 15
+    price: 0.1
+    limit: 500
+    name: "&7&l燧石"
+    lore:
+      - " "
+      - "&f点火！"
+  "IRON_INGOT":
+    slot: 20
+    price: 0.1
+    limit: 500
+    name: "&f&l铁锭"
+    lore:
+      - " "
+      - "&f制造！"
+  "GOLD_INGOT":
+    slot: 21
+    price: 0.1
+    limit: 500
+    name: "&e&l金锭"
+    lore:
+      - " "
+      - "&f高贵！"
+  "LAPIS_LAZULI":
+    slot: 22
+    price: 0.1
+    limit: 500
+    name: "&9&l青金石"
+    lore:
+      - " "
+      - "&f附魔！"
+  "DIAMOND":
+    slot: 23
+    price: 10
+    limit: 1500
+    name: "&b&l钻石"
+    lore:
+      - " "
+      - "&f钻石！"
+  "EMERALD":
+    slot: 24
+    price: 10
+    limit: 1500
+    name: "&a&l绿宝石"
+    lore:
+      - " "
+      - "&f交易！"
+  "CLAY_BALL":
+    slot: 30
+    price: 0.1
+    limit: 500
+    name: "&7&l黏土"
+    lore:
+      - " "
+      - "&f塑形！"
+  "REDSTONE":
+    slot: 29
+    price: 0.1
+    limit: 500
+    name: "&c&l红石"
+    lore:
+      - " "
+      - "&f电路！"
+  "GLOWSTONE_DUST":
+    slot: 32
+    price: 0.5
+    limit: 1500
+    name: "&6&l萤石"
+    lore:
+      - " "
+      - "&f发光！"
+  "QUARTZ":
+    slot: 33
+    price: 0.5
+    limit: 1500
+    name: "&f&l石英"
+    lore:
+      - " "
+      - "&f美丽！"

.examples/depositories/miner.yml

@@ -1,28 +0,0 @@
-name: "&c&l矿业仓库"
-
-capacity:
-  default: 0 # 若为0则默认不可以使用该仓库
-  permissions:
-    - "ub.miner.vip:5000"
-
-gui:
-  title: "&c&l矿业仓库"
-  lines: 6
-  items:
-    "CLOSE":
-      material: RED_STONE
-      data: 0
-      slot: 0
-      name: "关闭界面"
-      lore:
-        - "点击后您将关闭本界面。"
-      actions:
-        - "[LEFT:CLOSE]"
-        - "[SHIFT_LEFT:CLOSE]"
-
-items:
-  "DIAMOND":
-    slot: 5
-    price: 10
-    limit: 100
-    name: "&b&l钻石"

README.md

@@ -27,6 +27,7 @@
 ## 效果预览
 
 ### 收集物品
+
 ![collect](.documentation/images/collect-message.jpg)
 
 ### 仓库界面 (可自定义配置)
@@ -43,7 +44,7 @@
 
 - **[必须]** 插件本体基于 [Spigot-API](https://hub.spigotmc.org/stash/projects/SPIGOT)、[BukkitAPI](http://bukkit.org/) 实现。
 - **[自带]** 数据部分基于 [EasySQL](https://github.com/CarmJos/EasySQL) 实现。
-  - 本插件连接池使用 [BeeCP](https://github.com/Chris2018998/BeeCP) ，更轻量、快速。
+    - 本插件连接池使用 [BeeCP](https://github.com/Chris2018998/BeeCP) ，更轻量、快速。
 - **[推荐]** 变量部分基于 [PlaceholderAPI](https://www.spigotmc.org/resources/6245/) 实现。
 - **[推荐]** 经济部分基于 [VaultAPI](https://github.com/MilkBowl/VaultAPI) 实现。
 
@@ -65,7 +66,6 @@
 <details>
 <summary>展开查看所有玩家指令</summary>
 
-
 ```text
 # open [仓库ID]
 @ 玩家指令 (UltraDepository.use)
@@ -107,6 +107,7 @@
 - 若不填写仓库，则售出所有仓库内所有物品。
 - 该指令受到玩家每日售出数量的限制。
 ```
+
 </details>
 
 ## 插件变量 ([PlaceholderAPI](https://www.spigotmc.org/resources/6245/))
@@ -200,6 +201,54 @@
 
 ```yaml
 
+name: "&b&l示例仓库" # 仓库名，用于消息显示
+
+capacity: # 容量配置
+  default: 500 # 若为0则默认不可以使用该仓库
+  permissions: # 特殊权限对应的仓库容量，格式为 "权限:容量
+    - "UltraDepository.vip:1000"
+    - "UltraDepository.mvp:1500"
+
+gui: # GUI额外配置
+  title: "&b&l示例仓库 &7| 界面" #示例仓库的GUI标题
+  lines: 4 # GUI的行数，支持 1-6行。
+  items:
+    "TEST":
+      material: CHEST # 物品图标的类型
+      data: 0 # 物品图标的数据值
+      slot: 31 # 在GUI中显示的格子
+      name: "&9&l测试图标"
+      lore:
+        # 支持使用变量
+        - "你好 %player_name% !"
+      actions: # 物品点击操作
+        - "[CHAT] Hello!" #以玩家身份发送Hello，支持PlaceholderAPI变量
+        - "[CHAT] /help" #若内容以"/"开头，则会以玩家身份执行指令,支持PlaceholderAPI变量
+        - "[CONSOLE] say HELLO WORLD" #以后台身份执行指令，不需要加"/"，支持PlaceholderAPI变量
+        - "[MESSAGE] &(#FFBBBBB)Test %player_name%" # 向玩家发送消息，支持PlaceholderAPI变量和RGB颜色
+        - "[SOUND] ENTITY_EXPERIENCE_ORB_PICKUP:0.5" # 向玩家发送声音，可以规定音量大小和音调，格式为 <声音>:[音量]:[音调]
+        - "[CLOSE]" # 为玩家关闭界面
+
+        - "[LEFT:CLOSE]" #限制只有 鼠标左键 才触发CLOSE
+        - "[SHIFT_LEFT:CLOSE]" #限制只有 按住Shift+鼠标左键 才触发CLOSE
+        - "[RIGHT:CLOSE]" #限制只有 鼠标右键 才触发CLOSE
+        - "[SHIFT_RIGHT:CLOSE]" #限制只有 按住Shift+鼠标右键 才触发CLOSE
+        - "[MIDDLE:CLOSE]" #限制只有 鼠标中键 才触发CLOSE
+        - "[DROP:CLOSE]" #限制只有 丢弃建 才触发CLOSE
+        - "[CONTROL_DROP:CLOSE]" #限制只有 按住Ctrl+丢弃键 才触发CLOSE
+        - "[DOUBLE_CLICK:CLOSE]" #限制只有 鼠标双击物品 才触发CLOSE
+        - "[NUMBER_KEY:CLOSE]" #限制只有 数字键切换 才触发CLOSE
+
+items:
+  "INK_SAC": #物品ID，若需要限制数据ID则可以加“:”,如 "INK_SANK:4" 
+    slot: 11 # 物品在GUI中显示的槽位
+    price: 0.1 # 物品单价
+    limit: 500 # 物品每日售出限制
+    name: "&8&l墨囊" # 物品显示的名字
+    lore: # 物品的lore
+      - " "
+      - "&f抓住墨鱼！"
+
 ```
 
 </details>

pom.xml

@@ -14,7 +14,7 @@
     <groupId>cc.carm.plugin</groupId>
     <artifactId>ultradepository</artifactId>
     <packaging>jar</packaging>
-    <version>1.0.0</version>
+    <version>1.0.1</version>
 
     <name>UltraDepository</name>
     <description>超级仓库插件，支持设定不同物品的存储仓库。</description>

src/main/java/cc/carm/plugin/ultradepository/data/UserData.java

@@ -60,6 +60,7 @@ public class UserData {
 	}
 
 	public @NotNull DepositoryItemData getItemData(@NotNull DepositoryItem itemType) {
+		checkoutDate();
 		return getDepositoryData(itemType.getDepository()).getItemData(itemType);
 	}
 
@@ -70,7 +71,6 @@ public class UserData {
 	}
 
 	public @Nullable Integer getItemSold(@NotNull String depositoryID, @NotNull String typeID) {
-		checkoutDate();
 		DepositoryItemData data = getItemData(depositoryID, typeID);
 		if (data == null) return null;
 		return data.getSold();

src/main/java/cc/carm/plugin/ultradepository/listener/CollectListener.java

@@ -3,6 +3,7 @@ package cc.carm.plugin.ultradepository.listener;
 import cc.carm.plugin.ultradepository.Main;
 import cc.carm.plugin.ultradepository.configuration.PluginConfig;
 import org.bukkit.Material;
+import org.bukkit.configuration.file.YamlConfiguration;
 import org.bukkit.entity.Item;
 import org.bukkit.entity.Player;
 import org.bukkit.event.EventHandler;
@@ -65,7 +66,6 @@ public class CollectListener implements Listener {
 		UUID thrower = event.getItem().getThrower();
 		if (thrower != null && thrower.equals(player.getUniqueId())) return;
 
-
 		ItemStack item = event.getItem().getItemStack();
 		Main.debug("Picked up " + item.getType().name() + " " + item.getAmount());
 		if (Main.getDepositoryManager().collectItem(player, item)) {

src/main/java/cc/carm/plugin/ultradepository/manager/DepositoryManager.java

@@ -7,6 +7,7 @@ import cc.carm.plugin.ultradepository.configuration.depository.Depository;
 import cc.carm.plugin.ultradepository.configuration.depository.DepositoryItem;
 import cc.carm.plugin.ultradepository.data.UserData;
 import com.google.common.collect.HashMultimap;
+import org.bukkit.DyeColor;
 import org.bukkit.Material;
 import org.bukkit.configuration.file.FileConfiguration;
 import org.bukkit.configuration.file.YamlConfiguration;

src/main/resources/plugin.yml

@@ -7,6 +7,8 @@ website: ${project.url}
 
 author: CarmJos
 
+api-version: 1.13
+
 softdepend:
   - PlaceholderAPI
   - Vault
@@ -32,7 +34,6 @@ permissions:
 
   "UltraDepository.auto.enable":
     description: "用于判断是否启用了自动收集功能"
-    default: op
 
   "UltraDepository.admin":
     description: "超级仓库的管理权限"