Java 插件 BC 配置

# 自动绑定令牌功能配置指南

> w **注意**：需插件版本 ≥ 3.9.0
> 插件不能在 BC 上运行哦，因此每一个子服都需要配置

## 简介

一个插件只能绑定一个令牌。对于像 BC 这样拥有多个子服或跨区部署的情况，频繁修改令牌较为不便。因此，可以使用自动绑定令牌功能来简化操作。

## 配置步骤

### 1. 填写配置

编辑 `server-tokens.yml` 配置文件。

![](/media/202603/2026-03-26_180730_6949900.5103809081403621.png)
首先，在官网的服务器页面复制 `插件 API 令牌`，然后粘贴到配置中：

```
api-token: <复制的插件 API 令牌>
```

### 2. 获取数据

保存配置文件后，执行 `mp reload`命令，让插件从官网获取服务器数据。重载完成后，你应该能能在 `server-tokens.yml` 配置文件看到类似以下内容：

```
token-bind:
  - name: <服务器名称>
    # 子服的端口，必须唯一，对应的是 server.properties 中的 server-port
    server-port: 0
    token: <服务器令牌>
```

### 3. 绑定端口

根据你的子服 `server.properties`文件中的 `server-port`来绑定端口。例如，如果子服端口为 `25564`，则配置示例如下：

```
token-bind:
  - name: <服务器名称>
    server-port: 25564
    token: <服务器令牌>
```

再次执行 `mp reload`，插件将自动绑定令牌。

### 4. 验证配置

配置完成后，你可以通过查看核心日志来验证绑定是否成功。以下是一个配置成功的示意图：

![](/media/202603/2026-03-22_185236_4753110.9861232754954168.png)

# 配置文件同步机制
如果你的服务器很多，而且需要经常复制配置文件，可以使用配置文件同步机制来实现自动共享。

## 配置 MySQL
> 参考插件的 mysql.yml 配置文件

## 配置功能
修改 `bc-config.yml`
```yaml
# 是否启用配置文件拉取功能  
# 用于 BC 下配置文件同步  
# 如果开启必须配置 mysql.yml
enabled: false
```

任意一个子服都可以将自己的配置文件上传进行共享，直接执行命令：`/mp bc upload`，所有的子服插件稍后就会进行拉取。

## 常见问题（Q&A）

Q：我的机器不在同一台机器上，但端口号相同，这种情况可以吗？
A：不行，端口必须唯一。你可以修改子服的端口，使其唯一。

Q：我还需要修改 `config.yml` 中的 `token` 吗？
A：都已经自动绑定了，直接忽略即可