_    _ _ _             _____                       _ _                   
| |  | | | |           |  __ \                     (_) |                  
| |  | | | |_ _ __ __ _| |  | | ___ _ __   ___  ___ _| |_ ___  _ __ _   _ 
| |  | | | __| '__/ _` | |  | |/ _ \ '_ \ / _ \/ __| | __/ _ \| '__| | | |
| |__| | | |_| | | (_| | |__| |  __/ |_) | (_) \__ \ | || (_) | |  | |_| |
 \____/|_|\__|_|  \__,_|_____/ \___| .__/ \___/|___/_|\__\___/|_|   \__, |
                                   | |                               __/ |
                                   |_|                              |___/ 

UltraDepository

超级仓库插件，支持设定不同物品的存储仓库。

本插件基于 Spigot(1.16.3) 实现，理论上支持1.16后的全部版本。

本插件由 墨豆Mordo、子墨Zimrs 资助本人开发，经过授权后开源。

本插件已发布于 MCBBS 和 SpigotMC 。

功能介绍

本插件允许配置多个不同功能的仓库，玩家通过 击杀生物/挖掘方块/捡起收集 获得的原版物品可以自动被放入仓库中。

进入仓库后的物品玩家可以选择拿出或直接按量出售，且每日的出售数量上限和每件物品的价格可以自定义。

插件支持针对不同的权限配置仓库的容量，由此可以制作付费享用的”作物仓库“、”药剂师仓库“、”伐木仓库“...

综上，该插件不但提供了一种功能特权，对其合理配置之后也将大大为玩家带来便利。

效果预览

收集物品

仓库界面 (可自定义配置)

出售界面

插件依赖

• [必须] 插件本体基于 Spigot-API 、 BukkitAPI 实现。
• [自带] 插件功能基于 EasyPlugin 实现。
• [自带] 数据部分基于 EasySQL 实现。
  • 本插件连接池使用 BeeCP ，更轻量、快速。
• [推荐] 变量部分基于 PlaceholderAPI 实现。
• [推荐] 经济部分基于 VaultAPI 实现。

详细依赖列表可见 Dependencies 。

特殊优势

• 详细的变量与指令！
• 支持多种存储方式！
• 可自定义程度高，配置任何想要的仓库！
• 仓库容量权限配置，可给予特殊用户更大的仓库容量！
• 仓库自动收集物品，提供API操作玩家数据！
• ...

插件指令

指令主指令为 /UltraDepository (/ud | /Depository)

展开查看所有玩家指令

# open [仓库ID]
@ 玩家指令 (UltraDepository.use)
- 打开对应仓库的界面。

# sell <仓库ID> <物品ID> <数量>
@ 玩家指令 (UltraDepository.Command.Sell)
- 售出对应数量的对应物品。
- 该指令受到玩家每日售出数量的限制。

# sellAll [仓库ID] [物品ID]
@ 玩家指令 (UltraDepository.Command.SellAll)
- 售出所有相关物品。
- 该指令受到玩家每日售出数量的限制。

展开查看所有后台指令

以下指令只有后台才可以使用，可用于搭配变量自制玩家管理GUI。

# info <玩家> [仓库ID] [物品ID]
- 得到玩家的相关物品信息。

# add <玩家> <仓库ID> <物品ID> <数量>
- 为玩家添加对应仓库中对于物品的数量。

# remove <玩家> <仓库ID> <物品ID> [数量]
- 为玩家减少对应仓库中对于物品的数量。
- 若不填写数量，则清空对应仓库的对应物品。

# sell <玩家> [仓库ID] [物品ID] [数量]
- 为玩家售出相关物品。
- 若不填写数量，则售出所有对应仓库的对应物品。
- 若不填写物品，则售出对应仓库内所有物品。
- 若不填写仓库，则售出所有仓库内所有物品。
- 该指令受到玩家每日售出数量的限制。

插件变量 (PlaceholderAPI)

变量部分基于 PlaceholderAPI 实现，如需使用变量请安装其插件。

展开查看所有变量

# %UltraDepository_amount_<仓库ID>_<物品ID>%
- 得到对应仓库内对应物品的数量

# %UltraDepository_price_<仓库ID>_<物品ID>%
- 得到对应仓库内对应物品的价格

# %UltraDepository_sold_<仓库ID>_<物品ID>%
- 得到对应仓库内对应物品的今日售出数量

# %UltraDepository_limit_<仓库ID>_<物品ID>%
- 得到对应仓库内对应物品的每日售出限制

# %UltraDepository_remain_<仓库ID>_<物品ID>%
- 得到对应仓库内对应物品的剩余可售出数量
- $剩余可售出数量 = $每日售出限制 - $今日售出数量

# %UltraDepository_capacity_<仓库ID>%
- 得到对应仓库的容量

# %UltraDepository_used_<仓库ID>%
- 得到已使用的仓库容量

# %UltraDepository_usable_<仓库ID>%
- 得到剩余可使用的仓库容量

插件权限

展开查看所有权限

# UltraDepository.use
- 超级仓库的基本使用权限 (默认所有人都有)

# UltraDepository.Command.Sell
- 玩家使用Sell指令的权限

# UltraDepository.Command.SellAll
- 玩家使用SellAll指令的权限

# UltraDepository.auto
- 超级仓库的自动收集权限

# UltraDepository.auto.enable
- 用于判断是否启用了自动收集功能
- 若玩家有"UltraDepository.auto"权限，且玩家有该权限，则会开始为玩家自动收集物品。
- 若玩家缺失该权限或“UltraDepository.auto”权限，则自动收集物品功能不会启用。
- 您可以自己使用GUI创建一个按钮，后通过给玩家添加/删除该权限决定玩家是否开启自动收集。

# UltraDepository.silent
- 拥有该权限将不再接收到放入背包的提示。
- 您可以自己使用GUI创建一个按钮，后通过给玩家添加/删除该权限决定玩家是否开启收集提示。

# UltraDepository.admin
- "超级仓库的管理权限"

配置文件

插件配置文件 (config.yml)

详见源文件。

消息配置文件 (messages.yml)

详见代码文件中默认值，相关文件将在首次运行时创建。

仓库配置文件 (depositories/<仓库ID>.yml)

所有仓库配置均为单独的配置文件，存放于 插件配置目录/depositories 下，便于管理。

文件名即仓库的ID，强烈推荐使用纯英文。以.开头的仓库配置不会被加载。部分符号可能会影响正常读取，请避免使用。

随本项目预设了几个常用的仓库类型，可以 在这里 直接下载您需要的仓库配置加以修改后使用。

您也可以 点击这里 查看一份详细的仓库配置示例，以制作您自己的仓库。

开发

详细开发介绍请 点击这里 , JavaDoc(最新Release) 请 点击这里 。

使用统计

支持与捐赠

若您觉得本插件做的不错，您可以捐赠支持我！

开源协议

本项目源码采用 GNU General Public License v3.0 开源协议。

关于 GPL 协议

GNU General Public Licence (GPL) 有可能是开源界最常用的许可模式。GPL 保证了所有开发者的权利，同时为使用者提供了足够的复制，分发，修改的权利：

可自由复制

你可以将软件复制到你的电脑，你客户的电脑，或者任何地方。复制份数没有任何限制。

可自由分发

在你的网站提供下载，拷贝到U盘送人，或者将源代码打印出来从窗户扔出去（环保起见，请别这样做）。

可以用来盈利

你可以在分发软件的时候收费，但你必须在收费前向你的客户提供该软件的 GNU GPL 许可协议，以便让他们知道，他们可以从别的渠道免费得到这份软件，以及你收费的理由。

可自由修改

如果你想添加或删除某个功能，没问题，如果你想在别的项目中使用部分代码，也没问题，唯一的要求是，使用了这段代码的项目也必须使用 GPL 协议。

需要注意的是，分发的时候，需要明确提供源代码和二进制文件，另外，用于某些程序的某些协议有一些问题和限制，你可以看一下 @PierreJoye 写的 Practical Guide to GPL Compliance 一文。使用 GPL 协议，你必须在源代码代码中包含相应信息，以及协议本身。

以上文字来自 五种开源协议GPL,LGPL,BSD,MIT,Apache 。