LL2 SayaLLBDSPlugin 跨服务器多功能插件 [1.19.30.04] 1.1.1

[MD]
# 版本号说明

版本号的格式是`A.B.C`，其中`A`、`B`、`C`都是数字

`C`代表普通的bug修正，`B`代表普通的功能新增，`A`代表不向前兼容的改动（可能是bug修正，也可能是功能的新增或者功能的改动）

`A`改变时`B`和`C`会归零，`B`改变时`C`会归零

# 简要说明

该插件通过微软账号唯一确定一个玩家（也就是说强制要求正版），通过MySQL实现在多个安装了相同插件的服务器之间同步玩家的物品、gamemode、是否为op以及其他配置信息的功能。

该插件自带了若干可以跨服务器同步配置的子插件，包括：
- 批量挖掘，玩家可以控制批量挖掘是否开启、批量挖掘的大小和偏移量；
- 自动容器物品排序和重新堆叠，玩家可以选择是否开启该功能。

# 安装步骤

1. 安装 MySQL 和 LiteLoaderBDS
2. 在数据库中建表（数据库结构见附件）
3. 将 MySQL Connector/C++ 1.1.12 中的三个 dll 文件复制到 bedrock_server_mod.exe 所在的文件夹下
4. 将 SayaLLBDSPlugin.dll 和 SayaLLBDSPlugin_extItemSortOrder.txt 复制到 plugins 文件夹下
5. 在 plugins 文件夹下创建文件 SayaLLBDSPlugin_mysql.json （详情见下文）
6. 在 plugins 文件夹下创建文件 SayaLLBDSPlugin_serverIdentity.txt （详情见下文）

## 关于文件 SayaLLBDSPlugin_extItemSortOrder.txt

此文件存储物品的排序信息

## 关于文件 SayaLLBDSPlugin_mysql.json

此文件存储 MySQL 数据库的连接信息，样例如下：

```json
{
"host": "127.0.0.1",
"port": 3306,
"user": "root",
"password": "33e5e684c8193c9b",
"schema": "liteloaderbds"
}
```

## 关于文件 SayaLLBDSPlugin_serverIdentity.txt

此文件存储该服务器的唯一名称，是一个普通的字符串，样例如下：

```
main server
```

# 数据库初始化

目前只需要在 server_config 表中添加服务器的默认出生点，其中 server_identity 字段的值就是 SayaLLBDSPlugin_serverIdentity.txt 文件中的内容。出生点的坐标可能需要服主创建好世界后自己进入游戏挑选合适的位置。

# 使用方式

使用命令 /saya 打开配置面板

## 批量挖掘

在配置面板中点击 BatchDig 可以配置批量挖掘的范围、偏移量以及是否启用自由模式。

拿着稿子或者铲子点击右键可以放置或移除批量挖掘的中心线，中心线以绿色粒子效果展示，同时标记批量挖掘的四个角的位置，当玩家挖掘位于中心线上的方块时，便会触发批量挖掘效果。

拿着稿子或铲子，按住shift键（潜行）点击右键可以打开或关闭批量挖掘的自由模式，处于自由模式时不受中心线限制，每次挖掘都会触发批量挖掘效果。

## 自动容器物品排序和重新堆叠

在配置面板中点击 AutomaticContainerSortor 可以对该功能进行配置，如果启用该功能，则当玩家打开箱子之前，会对箱子中的物品进行自动排序和重新堆叠（把可能占用了多个格子，但是每个格子都没叠满的物品合并在一起）

该功能只会对箱子、潜影盒和末影箱中的物品进行排序和重新堆叠，不会对玩家的物品栏或者其他有格子的容器进行排序。

# 测试服务器

- 服务器1：mcbds.saya.pw:19132 (BETewaker, SayaLLBDSPlugin, tpstick)
- 服务器2：mcbds.saya.pw:19232 (BETewaker, SayaLLBDSPlugin)

服务器是在家里用笔记本开的，可能不太稳定

# 更新记录

- 1.1.1: 升级到1.19.30.04
- 1.1.0: 批量挖掘添加“当工具耐久度过低时中断批量挖掘”的选项
- 1.0.1: 批量挖掘跳过空气、水和岩浆方块
- 1.0.0: 修复存储玩家物品时可能产生SQL注入的问题
- 0.1.1: 修复在启用自动容器物品排序和重新堆叠功能时打开工作台可能导致服务器崩溃的问题
- 0.1.0: 添加自动容器物品排序和重新堆叠功能
- 0.0.2: 支持 1.19.22.01
- 0.0.1.1: 第一个版本

[/MD]