ItemBox - 离线送物

Itembox 是一款为玩家提供“物品邮箱”的插件。邮箱内容会在服务器重启后保留，玩家之间也可以互相发送物品；管理员还可以发送可配置的随机奖励箱（Dynamic Box）。

💡概览

• 玩家拥有一个可持久化保存的物品邮箱。
• 其他玩家可以将物品发送到指定玩家的邮箱。
• 玩家可以随时从自己的邮箱中领取物品。
• 管理员可以发送特殊的 Dynamic Boxes，开启后可获得随机物品组合。
• 插件目前仍处于 beta 阶段。

🎮环境要求

• Java 8 及以上
• 已在 spigot 1.11.2 上测试
• 理论上应适用于任意版本

⭐功能特性

• 提供完整的语言设置
• 使用 SQLite 数据库
• 玩家可发送任意物品
• 物品的 lores、displaynames、enchantments 和 attributes 都会被保存

🔧指令

• /itembox open
• 打开你的 Itembox。
• 点击箱子可领取发送给你的物品。

• /itembox open [player]
• 打开其他玩家的 itembox。
• 点击箱子可删除其邮箱中的物品。

• /itembox send [player]
• 向指定玩家发送物品。
• 名称区分大小写。

• /itembox claimall
• 将所有物品直接领取到你的背包中。
• 如果物品过多，超出的部分会掉落到地面。

• /itembox givedynamic box [player] [boxname]
• 向指定玩家发送配置中的 dynamic box。

• /itembox giveAlldynamicbox [boxname]
• 向服务器所有玩家发送指定 dynamic box，包括离线玩家。

• /itembox sendall
• 将你手中的物品发送给服务器所有玩家，包括离线玩家。

• /itembox additemtodynamicbox [boxname] [chance]
• 将你手中的物品以指定概率添加到指定 itembox 中。
• 会直接保存到配置文件，并同时执行一次配置重载。

• /itembox reload
• 从配置中重新加载 dynamic boxes。

✨Dynamic Box 格式

配置格式

dynamic-boxes:
default:
- [material name]:[itemdata (optional)],[chance out of 100 to appear] name:&bExample lore:&cLore<newline>&blike<newline>this [enchantment]:[level]

说明

• name、lore 和 enchantment 都是可选的。
• [itemdata (optional)] 为可选项。
• [chance out of 100 to appear] 表示该物品出现的概率，满分为 100。

🎮权限

• itembox.* - 所有命令与功能
• itembox.open - /itembox open
• itembox.claimall - /itembox claimall
• itembox.send - /itembox send
• itembox.open.others - /itembox open [player]
• itembox.reload
• itembox.givedynamicbox
• itembox.givealldynamicbox
• itembox.sendall
• itembox.additemtodynamicbox
• 基本上是 itembox.command

⭐API

其他插件也可以向玩家发送物品。

获取玩家信息

PlayerInfo info = ItemBox.getInstance().getPlayerDataManager().getOrLoadPlayerInfo(OfflinePlayer p);

• 使用以上代码可以获取玩家的 PlayerInfo。
• 获取后，你可以清空邮箱物品、发送物品，或从邮箱中移除物品。

PlayerInfo 方法

• public void clearItems()
• 清空 itembox 中的所有物品

• public void addItem(ItemStack item)
• 向 itembox 添加一个物品

• public void removeItem(ItemStack item)
• 从 itembox 中移除指定物品
• 如果该物品不存在，则不会执行任何操作
• 也会精确到数量判断

• public Collection<ItemStack> getItems()
• 获取 itembox 中的全部物品

• public OfflinePlayer getPlayer()
• 获取与该 itembox 关联的 offlineplayer

❓计划功能

• Expiry，避免 itembox 被用作双账号仓库存储

💡源码使用说明

• 你可以使用源码中的任何代码，但需要将我（@Hex_27）列为贡献者。
• 如果你的插件是开源的，请在所使用代码上方的注释中写上我的用户名。
• 如果你只是想使用插件中的 scroller inventory，可以在我发布于 Plugin Development 的某个资源帖中找到相关代码及其使用方法。
• 语言文件代码并非由我编写，只是由我修改过。

🔧备注

• 默认图标确实很适合这个插件。