AxInventoryRestore - 简易背包备份

AxIr 是一款面向服务器管理员的玩家背包备份与恢复工具，可记录玩家物品数据，并让管理人员通过 GUI 一键恢复，或将数据导出为潜影盒。

💡基本信息

• 支持的 Minecraft 版本：1.20.2-26.1.1
• 所需 Java 版本：21 或更高
• 源代码：

https://github.com/Artillex-Studios/AxInventoryRestore/

⭐插件简介

什么是 AxIr？

• AxIr 用于记录玩家的背包数据。
• 管理人员可以通过一次点击恢复玩家的背包。
• 也可以将背包内容导出为潜影盒。

✨功能特色

• 数据库支持
• SQLite
• H2
• MySQL
• PostgreSQL

• 多服务器支持
• 支持 MySQL 和 PostgreSQL

• 一键恢复
• 可快速恢复玩家背包

• 自动清理
• 可在数据保存超过 X 天后自动删除

• 高效
• 在可能的情况下，数据库操作会异步处理

• 易于使用
• 只有 1 个主命令和少量子命令
• 几乎所有操作都可以在 GUI 中完成

• 导出功能
• 支持导出为潜影盒

• 完全可自定义
• 你可以翻译每一条消息

• 开发者 API
• 可创建你自己的保存分类

🎮Discord 附加功能

额外特性：通过 Discord 请求恢复备份

• 该功能允许工作人员将恢复请求发送到 Discord 服务器
• 使用此功能需要特定权限

一键决策

• 如果你拥有在 Discord 服务器上点击按钮的权限
• 只需一次点击即可接受或拒绝恢复请求

即时执行

• 点击恢复按钮后
• 玩家首次加入时，其背包会立即以潜影盒形式恢复

可切换启用

• 你可以自行决定是否启用此功能

🔧说明

• 原文中提到了 GIFs 和 text transcript 的折叠内容，但未提供完整可翻译内容。
• 原文还提到 “If you need Commissions, Support, or anything else”，但未包含后续完整信息。

💡简介

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 文档站。