> For the complete documentation index, see [llms.txt](https://docs.superiormc.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.superiormc.cn/tab-wiki/functions/mysql.md).

# MySQL

## 关于

默认情况下，组和玩家是储存在不同的文件下。（groups.yml 和 users.yml）

启用 MySQL 将会使用它来储存组和玩家的数据而不是储存在本地的文件里。

playerdata.yml 文件 (用来储存玩家开关计分板、boss条并记录他们偏好的文件 ) 将不会受到影响，或许在后续版本我们会提供支持。

## 配置

在 **config.yml** 找到如下部分：

```
mysql:
  enabled: false
  host: 127.0.0.1
  port: 3306
  database: tab
  username: user
  password: password
```

`enabled` 将决定插件是否使用 **MySQL** 储存，其他选项则是修改 MySQL 数据库信息的。

## 数据转换

### 将数据从 MySQL 下载到本地文件

这可以通过使用指令 `/tab mysql download` 实现 (权限是 `tab.mysql.download`)。它将会从所连接的 MySQL 下载数据并保存到 users.yml 和 groups.yml 文件。\
这个指令只会在你使用 MySQL 储存数据时才会有效。

### 将数据上传到 MySQL

这可以通过使用指令 `/tab mysql upload` 实现 (权限是 `tab.mysql.upload`)。 它将会将本地 users.yml 和 groups.yml 文件的数据上传到所连接的 MySQL。\
这个指令只会在你使用 MySQL 储存数据时才会有效。