AxInventoryRestore - 简易背包备份

⭐AxInventoryRestore - 玩家背包备份与恢复工具

支持的 Minecraft 版本： 1.20.2 - 1.26.2

所需 Java 版本： 21 或更高

AxInventoryRestore（简称 AxIr）是一款服务端管理工具，能够记录玩家背包状态，并允许管理员一键恢复或将其导出为潜影盒。

源代码：<https://github.com/Artillex-Studios/AxInventoryRestore/>

如需定制开发、技术支援或其他帮助，请查看相关渠道。

---

💡功能亮点

• 数据库支持 – 支持 SQLite、H2、MySQL、PostgreSQL
• 多服务器支持 – 基于 MySQL / PostgreSQL 实现跨服数据共享
• 一键恢复 – 只需一次点击即可还原玩家背包
• 自动清理 – 可设置天数，到期自动删除旧数据
• 高效异步 – 数据库操作尽可能异步执行，提升性能
• 简单易用 – 仅需一个主命令和少量子命令，大部分操作可通过图形界面完成
• 导出潜影盒 – 将背包内容导出为潜影盒
• 全面可定制 – 所有消息均可翻译
• 开发者 API – 支持创建自定义的保存类别
• Discord 附加功能 – 额外增强

---

✨Discord 附加功能

通过 Discord 请求恢复备份

• 允许具有特定权限的工作人员向 Discord 服务器发送恢复请求。
• 一键决策 – 若你在 Discord 服务器上有操作权限，只需一次点击即可批准或拒绝恢复请求。
• 即时执行 – 点击恢复按钮后，当玩家下次登录时，背包将立即以潜影盒形式还原。
• 可开关 – 可根据需要启用或禁用此功能。

💡简介

AXInventoryRestore 是一款功能强大的 Minecraft 插件，它允许服务器管理员查看并恢复玩家的背包、末影箱和盔甲栏内容。无论是处理物品丢失问题、调查玩家行为，还是进行数据备份，该插件都提供了直观的界面和便捷的操作。

🎮功能特性

• 查看与恢复：可查看并恢复任何玩家的背包、末影箱和盔甲栏。
• 时间点快照：插件会定期自动保存玩家数据快照，你可以回溯到特定的时间点进行恢复。
• 离线玩家支持：即使玩家不在线，也能查看和恢复其数据。
• 多世界支持：完美支持多世界服务器环境。
• MySQL 支持：可选择使用 MySQL 数据库来存储玩家数据。
• 自动保存：可配置自动保存玩家数据的间隔时间。
• 权限控制：所有功能都通过细致的权限节点进行保护。

🔧命令与权限

主要命令

• /inventoryrestore 或 /ir

- `/ir help` - 显示帮助信息。

- `/ir gui <玩家名>` - 打开指定玩家的数据恢复 GUI 界面。

- `/ir version` - 显示插件版本信息。

- `/ir reload` - 重载插件配置文件。

权限节点

• axinventoryrestore.command.gui - 允许使用 /ir gui 命令。
• axinventoryrestore.command.reload - 允许使用 /ir reload 命令。
• axinventoryrestore.command.version - 允许使用 /ir version 命令。
• axinventoryrestore.bypass - 允许查看和恢复其他玩家的数据（默认 OP 拥有此权限）。

✨安装与配置

安装步骤

• 确保服务器已安装 Java 17 或更高版本。
• 将下载的 AXInventoryRestore.jar 文件放入服务器的 plugins 文件夹。
• 重启或重载服务器。
• 根据需求编辑生成的配置文件。

配置说明

插件首次运行后，会在 plugins/AXInventoryRestore 目录下生成 config.yml 文件。主要配置项包括：

• storage-method： 数据存储方式。可选 LOCAL（本地文件）或 MYSQL（MySQL 数据库）。
• auto-save-interval： 自动保存玩家数据的间隔时间（单位：分钟）。设置为 0 可禁用自动保存。
• snapshots-to-keep： 为每个玩家保留的数据快照数量上限。达到上限后，最旧的快照将被删除。

数据库配置（如使用 MySQL）

在配置文件中找到 mysql 部分，并根据你的数据库信息进行填写：

host: "localhost"
port: 3306
database: "minecraft"
username: "root"
password: "password"

❓使用方法

通过 GUI 恢复数据

• 执行命令 /ir gui <玩家名>（例如 /ir gui Steve）。
• 在打开的界面中，你将看到该玩家的所有数据快照，按时间倒序排列。
• 点击任意一个快照，可以预览该时间点玩家的背包、末影箱和盔甲。
• 在预览界面中，点击界面底部的“恢复”按钮即可将数据恢复到该玩家身上。

注意事项

• 执行恢复操作时，目标玩家当前的背包、末影箱或盔甲内容将被选中的快照数据覆盖。
• 请谨慎操作，建议在恢复前告知玩家。

⭐常见问题

• 问：插件支持哪些 Minecraft 版本？

- 答：插件支持 **1.17.x** 至 **1.20.x** 的服务器版本。

• 问：数据快照是如何工作的？

- 答：插件会根据配置的 `auto-save-interval` 定时保存玩家数据。每次保存都会创建一个带有时间戳的新快照。

• 问：我可以恢复多久以前的数据？

- 答：这取决于 `snapshots-to-keep` 的配置数量以及自动保存的频率。插件只保留最近的一定数量的快照。

• 问：使用 MySQL 存储是必须的吗？

- 答：不是。对于小型服务器，使用默认的 `LOCAL`（本地文件）存储完全足够且更简单。MySQL 更适合大型或跨服网络。

🔧支持与链接

• 支持 Discord： 如有问题，请加入我们的 Discord 服务器 获取帮助。
• 插件主页： 访问 SpigotMC 资源页面 了解更多信息。
• 文档： 本文档的在线版本位于 Artillex Studios 文档站。