LSE - WnBagBackup——定时背包备份、查包、背包暂存、背包导入导出

版权类型: 原创

版权链接: #

语言支持: 中文（简体）

前置组件: GMLIB(MineBBS) - https://www.minebbs.com/resources/gmlib.6636/
GMLIB-LegacyRemoteCallApi(MineBBS) - https://www.minebbs.com/resources/gmlib-legacyremotecallapi-gmlib-remotecallapi.7159
GMLIB(GitHub) - https://github.com/GroupMountain/GMLIB-Release/releases/
GMLIB-LegacyRemoteCallApi(GitHub) - https://github.com/GroupMountain/GMLIB-LegacyRemoteCallApi/releases

适配版本（基岩）

最新版本

# 作者：Wn1027
# 不要在评价区反馈bug，反馈bug请到讨论/反馈区
# 本插件反馈QQ群: 311860068
# 经典查包：InventoryCheck - 可读写所有玩家背包数据的查包插件
# 本插件参考了该插件LSE版本的主菜单界面设计，本插件代码原创。

一、插件功能

有些时候不小心弄丢了一两个重要物品，或是处理较为久远的玩家偷窃或不法物品，此时服主回档操作繁琐耗时又长，服务器还得宕机一会，且存档备份可能已被自动删除。
这个插件可以定时备份背包，这样遇到仅需找回遗失物品的情况，服主就可以方便的找回。

BDS版本	本插件版本	可用情况
...1.21.40	1.0.0	可用
1.21.50	1.0.0	可用
1.21.60	1.0.0	不可用。GMLIB bug
1.21.70	1.0.0	不可用。GMLIB bug
1.21.80	1.0.0	可用
1.21.93	1.0.0	可用
1.21.120	1.0.0	可用
1.21.132	1.0.0	可用
26.10	1.1.0	GMLIB停更，LSE api兼容可用，但可能无法检索到全部存档玩家
26.20	1.1.1	可用

（一）功能

背包定时备份：玩家登录后每间隔一段时间自动备份、玩家退出备份、玩家死亡备份（默认关闭）
查包：可搜索查询服务器所有玩家背包
背包暂存：暂存背包栏位，可方便服主维护。
背包导入导出：可导出所有玩家背包，选择性导入外部背包。开新周目新存档却想保留玩家背包时可用。

（二）特点

仅备份背包且使用kv数据库，比起存档备份存储成本极小，你可以十几分钟就备份一次。
由于占用存储极小，背包备份可保留相当长的时间（上百天）
死亡备份可以缓解某些死亡掉落服物品易丢失的情况。（功能灵感来自于站内专用插件）

二、插件安装及配置（版本升级请查看对应更新内容）

【推荐可选】安装GMLIB_0.13.5、GMLIB-LegacyRemoteCallApi_0.13.3版本以上
解压本插件到plugins文件夹
启动服务器，自动生成配置文件

JavaScript：

let config = {
    "ver": [1, 0, 0],
    "backupInterval": 15,   // 日常定时备份间隔(分钟) 登录后每15分钟备份一次
    "maxSavedDays": 90,   // 备份最多保存90天
    "enableIntervalBackup": true, // 启用日常定时备份
    "enableOnLeftBackup": true, // 启用玩家退出备份
    "enableDeadBackup": false, // 启用死亡备份(默认关闭，适用死亡掉落服)
}

三、插件使用

/bagbackup 打开主菜单，管理员命令
/bagbackup online : 备份一次当前在线玩家
/bagbackup reload : 重载json配置文件
/bagbakcup status：查看当前数据库备份情况（最早最近备份时间、总计备份背包的数量等）

三、插件文件说明

文件路径	文件用途说明
./plugins/WnBagBackup/WnBagBackup.js	插件本体
./plugins/WnBagBackup/data/BagDateBase	背包数据库，备份的背包按time_uuid索引存在这里
./plugins/WnBagBackup/data/BackupIndex	背包索引数据库，记录玩家备份时间及备份文件索引
./plugins/WnBagBackup/data/config.json	配置文件
./plugins/WnBagBackup/data/storage.json	暂存背包存在这里
./plugins/WnBagBackup/data/uuid.json	记录uuid、xuid、realName信息以备不时之需
./plugins/WnBagBackup/data/export_bagdata.json	导出的所有玩家背包数据
./plugins/WnBagBackup/data/backupStats.json	status命令生成，当前数据库所有玩家的备份情况

四、注意问题
此为社区插件，有bug在所难免，在进行任何重要的数据操作前请务必备份存档，若有数据丢失自行承担。
使用LSE api而不使用GMLIB的情况下，无法检索存档内的完整的所有玩家，只能依靠LL数据库(./plugins/LeviLamina/data/playerinfo) 以及本插件记录的玩家基础数据。