转载 工具 AutoSavePlayer 1.1

[MD]
## 简介

AutoSavePlayer 是一款适用于 Spigot/Bukkit 服务端的插件，可自动备份玩家背包，并通过 GUI 快速恢复丢失的物品栏数据。

# AutoSavePlayer

**AutoSavePlayer** 是一款适用于 Spigot/Bukkit 服务端的插件，可自动备份玩家背包，并通过 GUI 快速恢复丢失的物品栏数据。

## 功能特点

- 快速恢复玩家丢失的背包数据。
- 按最近 10 个已备份日期保留历史记录。
- 支持全局或按玩家单独启用、禁用备份。
- 提供清晰的管理员操作日志。
- 支持按日期、备份类型和具体时间点选择恢复记录。
- 当单日备份记录超过 45 条时，恢复界面会自动分页。

## 备份机制（V4）

在线备份会按照服务器实际时间的固定间隔触发，仅对触发时在线的玩家执行备份。

### 在线快照

| 备份频率 | 配置项 |
|---|---|
| 每小时备份一次 | `1h`（法语版本对应：`1h`） |
| 每 30 分钟备份一次 | `30min`（法语版本对应：`30min`） |
| 每 5 分钟备份一次 | `5min`（法语版本对应：`5min`） |

每小时备份的触发项：`xx:00`（法语版本对应：`xx:00`）。

每 30 分钟备份的触发项：`xx:00`、`xx:30`（法语版本对应：`xx:00`、`xx:30`）。

**保留规则：** 只要该日期仍属于最近 10 个已备份日期，在线快照就会被保留。

### 每日快照

每日快照会在玩家退出服务器时自动创建。

| 每日备份数量 | 配置项 | 说明 |
|---|---|---|
| 每天 1 份 | `1day`（法语版本对应：`1day`） | 保留当天最新的一份备份。 |
| 每天 2 份 | `2day`（法语版本对应：`2day`） | 备份分布在当天的不同时段。 |
| 每天 4 份 | `4day`（法语版本对应：`4day`） | 备份分布在当天的不同时段。 |

**保留规则：** 最多保留玩家最近 10 个实际登录并产生备份的日期，而不是最近 10 个自然日。

## 重要说明

- 在线备份仅会在玩家在线时执行：`5min/30min/1h`（法语版本对应：`5min/30min/1h`）。
- 每日快照会在玩家退出时自动创建：`1day/2day/4day`（法语版本对应：`1day/2day/4day`）。
- “保留 10 天”指最近 10 个已备份日期；产生第 11 个备份日期时，最早的日期会被删除。
- 删除某个日期时，该日期下的所有备份都会一并删除：`1day`、`2day`、`4day`、`1h`、`30min`、`5min`。
对应的法语版本配置项为：`1day`、`2day`、`4day`、`1h`、`30min`、`5min`。
- GUI 支持分页浏览指定日期的任意备份记录，适合查看高频备份：`5min/30min/1h`（法语版本对应：`5min/30min/1h`）。
- 服务器处于离线状态时，无法执行任何备份。
- 备份将以 `.dat` 文件保存（法语版本对应：`.dat`）。

## 恢复背包

管理员可使用以下命令打开恢复界面。

### 打开在线玩家列表

``/restore-inv``（法语版本对应：``/restore-inv``）

该命令会打开一个列出当前在线玩家的 GUI。选择目标玩家后，可依次：

1. 选择备份日期，即最近 10 个可用的已备份日期。
2. 选择备份类型：`1/day`、`2/day`、`4/day`、`1h`、`30min`、`5min`。
对应的法语版本配置项为：`1/jour`、`2/jour`、`4/jour`、`1h`、`30min`、`5min`。
3. 选择带日期和时间的具体备份记录；如果单类记录超过 45 条，界面会启用分页。

### 直接打开指定玩家的恢复界面

``/restore-inv <player>``（法语版本对应：``/restore-inv <player>``）

该命令会直接打开指定玩家的恢复 GUI，随后可选择日期和备份类型。

## 管理员功能

| 功能 | 命令或配置项 |
|---|---|
| 打开语言设置 GUI | `/asp`（法语版本对应：`/asp`） |
| 打开按玩家管理备份的 GUI，可启用或禁用该玩家的备份 | `/asp players`（法语版本对应：`/asp players`） |
| 启用全局备份 | `/asp start`（法语版本对应：`/asp start`） |
| 禁用全局备份 | `/asp stop`（法语版本对应：`/asp stop`） |
| 切换插件语言 | `/asp fr|en|all`（法语版本对应：`/asp fr|en|all`） |
| 德语语言选项 | `all`（法语版本对应：`all`） |

## 权限节点

- `autosaveplayer.restore`
- `autosaveplayer.language`
- `autosaveplayer.admin`
- `autosaveplayer.restore`
- `autosaveplayer.language`
- `autosaveplayer.admin`

请根据所使用的权限管理插件，为管理员配置相应权限。

## 日志与配置文件

- 背包恢复操作日志：`plugins/AutoSavePlayer/plugin-logs/plugin-logs.log`
法语版本对应：`plugins/AutoSavePlayer/plugin-logs/plugin-logs.log`
- 已禁用备份的玩家配置：`plugins/AutoSavePlayer/player-controls.yml`
法语版本对应：`plugins/AutoSavePlayer/player-controls.yml`

## 安装方法

1. 将 ``.jar`` 文件放入服务端的 ``plugins/`` 目录。
法语版本对应文件与目录：``.jar``、``plugins/``。
2. 重启服务器。
3. 通过权限管理插件配置管理员权限。
4. 进入游戏后使用 `/asp` 和 `/restore-inv`。
法语版本对应：`/asp` 和 `/restore-inv`。

## V4 更新内容

V4 版本新增按日期恢复、多种备份类型选择，以及针对每小时和分钟级备份记录的分页浏览功能。
[/MD]