InventoryRestore
InventoryRestore 备份玩家物品栏,并允许工作人员检查、恢复及记录退款操作——支持可选的 MySQL 数据库、崩溃恢复、自动保存以及用于退款确认的 Discord Webhook。
功能特性
备份与存储
-
自动保存:在玩家加入、离开、死亡、切换世界、崩溃时触发,以及按照可配置的自动保存间隔进行保存。
-
强制备份:针对单个在线玩家或所有在线玩家执行 (
/ir forcebackup)。 -
使用 YAML(默认)或 MySQL 进行集中式存储。
-
每种保存类型针对每个玩家设有上限 (
max-saves:加入、离开、死亡、换世界、强制、崩溃)。
## 每种类型的备份为用户保留的最大存档数量。
max-saves:
join: 10
quit: 10
death: 50
world-change: 10
force: 10
crash: 20
- 材质忽略列表:指定某些物品永不存储 (
backup-ignore-materials)。这可以避免占用大量存储空间,例如如果你有一个/string插件,可以忽略“线”这种物品。
## 从备份中排除且不存储的材质(Bukkit 名称)。示例:[DIRT, STONE]
## 空列表 = 不忽略任何物品。
backup-ignore-materials: []
-
离线恢复与物品栏查看
-
导出恢复到潜影盒、箱子、 bundles 及掉落物。如果你不想直接恢复某人的当前物品栏,你可以将箱子放置在他们的主基地,或将 bundle 放入他们的物品栏中等。
工作人员 GUI
-
主菜单 — 浏览玩家(恢复模式下显示名字;退款模式可隐藏名字以保护隐私)。

-
玩家菜单 — 选择备份类别(加入、离开、死亡、换世界、强制、崩溃)。

| Joins | Quits | Deaths |
|---|---|---|
![]() |
![]() |
![]() |
| World changes | Force saves | Crashes |
|---|---|---|
![]() |
![]() |
![]() |
- 回滚列表 — 带有时间戳的分页快照列表(时区/格式可配置)。

- 主物品栏备份 — 完整的 36 格预览,护甲和副手槽位布局与原版一致,并包含以下操作:
- 恢复主物品栏 + 护甲 + 副手(当目标仍有物品时会显示覆盖警告;如果检测到其物品栏完全为空,则跳过此步骤)。
- 末影箱备份查看与恢复。
- 饥饿值和经验值恢复(仅当目标在线时可用)。
- 传送至已保存的备份位置(权限
inventoryrestore.restore.teleport)。 - 导出到存储容器(提取物品以便手动处理)。
- 备份活动日志 — 谁打开或恢复了某个快照(审计追踪)。
- 覆盖警告 — 在确认完全恢复之前,显示目标的当前物品栏(或离线时的上次保存布局),包括护甲和副手。

截图 — 恢复操作与工具
| Teleport to backup coords | Ender chest | Ender chest |
|---|---|---|
![]() |
![]() |
![]() |
| Restore food | Restore XP | Restore offline |
|---|---|---|
![]() |
![]() |
![]() |
| Export (chest) | Export (bundle) |
|---|---|
![]() |
![]() |

| 退款 / 恢复历史记录 (1) | 退款 / 恢复历史记录 (2) |
|---|---|
![]() |
![]() |
指令与安全机制
/restore//ir restore [player|uuid]— 打开恢复图形界面;支持通过 UUID 或名称进行自动补全。/refund//ir refund [player|uuid]— 打开退款图形界面及账本上下文。/ir enable、/ir disable、/ir reload、/ir version、/ir help。/ir import confirm— 一次性从旧版备份数据迁移(需要权限inventoryrestore.import;如需,请通过你的权限插件授予)。- 可配置的与其他插件的死亡事件执行顺序(
allow-other-plugins-edit-death-inventory)。 - 在多个类似死亡箱的插件之前加载(
loadbefore),以减少顺序冲突。
集成与运维
- 当从退款图形界面确认完整恢复时,可选的Discord 退款 Webhook(位于
config.yml中的refund-webhook)。 - 启动时的更新检查器(可配置)。
- 音效:用于恢复、传送、食物、饥饿和经验值(每项均可单独切换开关)。
指令
| 指令 | 权限 | 描述 |
|---|---|---|
/restore [player] |
inventoryrestore.viewbackups |
打开恢复图形界面(可选目标玩家)。 |
/refund [player] |
inventoryrestore.refund |
打开退款图形界面。 |
/ir restore [player] |
inventoryrestore.viewbackups |
同 /restore。 |
/ir refund [player] |
inventoryrestore.refund |
同 /refund。 |
/ir forcebackup all |
inventoryrestore.forcebackup |
强制保存所有在线玩家的数据。 |
/ir forcebackup player <name> |
inventoryrestore.forcebackup |
强制保存单个在线玩家的数据。 |
/ir enable |
inventoryrestore.enable |
开启插件。 |
/ir disable |
inventoryrestore.disable |
关闭插件。 |
/ir reload |
inventoryrestore.reload |
重新加载配置。 |
/ir version |
inventoryrestore.version |
版本信息。 |
/ir help |
inventoryrestore.help |
游戏内指令列表。 |
/ir import confirm |
inventoryrestore.import |
导入旧版备份(破坏性操作;仅确认)。 |
子权限 inventoryrestore.restore.teleport — 允许从图形界面传送到备份所保存的世界/坐标。
完整的权限树请参阅 plugin.yml。
配置 (config.yml)
| 选项 | 功能说明 |
|---|---|
enabled |
总开关。 |
max-saves |
限制每种类型每个玩家的存档数量上限。 |
backup-lines-visible |
回滚列表中可见的行数(最多 5 行)。 |
folder-location |
数据存储路径或使用 DEFAULT(默认值)。 |
mysql |
启用数据库及连接池设置。 |
sounds.*.enabled |
切换反馈音效。 |
time-zone / time-format |
备份时间戳显示格式。 |
allow-other-plugins-edit-death-inventory |
控制存档时机与其他插件的交互顺序。 |
restore-to-player-button |
显示完整恢复按钮。 |
save-empty-inventories |
是否保留空背包快照。 |
backup-ignore-materials |
跳过备份的 Bukkit 材质名称列表。 |
refund-webhook |
在退款路径下的完整恢复时发送 Discord POST 请求。 |
autosave-* |
定时自动存档间隔及崩溃恢复行为。 |
update-checker |
GitHub Releases 更新通知(vanillaxtra/inventoryrestore)。 |
bStats |
匿名统计数据(见下文)。 |
debug |
额外的控制台日志记录。 |
? bStats
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
















评论 0
登录后参与评分
还没有评论,来抢沙发吧