Java 插件常见问题

## 付款后插件不发货？
如果官网能够查询到订单
请检查插件是否为最新版本
或服务器后台有无报错。

如果官网查询不到订单
请检查是否正确配置了监听方案

## 输入任何指令都没有反应 或 出现报错：An internal error occurred while attempting to perform this command
当看到这个代表插件在启动的时候报错了，
检查插件是否为最新版本且配置文件没有错误，
请勿热加载插件使用重启服务器来加载插件，
如仍有疑问，可以截图启动时的报错日志加群联系。

## 令牌问题

![](/media/202602/2026-02-10_151718_5743410.01766822695224224.png)
说明你没有填写令牌或输入了错误的令牌
除此之外可以尝试删除所有的配置文件然后重载来重新生成所有的默认配置文件
然后仅仅填写令牌，看看是否问题依旧？如果问题解决了那就说明是存在 Yaml 语法错误

## 插件提示联系服主解决插件未初始化问题
请查看核心后台插件日志，大多数情况根据日志提供的信息即可解决

## 无法下单，提示麦币不足？
你的麦币小于订单金额，
请前往首页进行充值，
详情请看麦币帮助页面。

![](/media/202602/2026-02-10_151731_2188950.6364730092788197.png)
## 下单提示礼包不存在或者出现金额不对

![](/media/202602/2026-02-10_151739_9772490.471984994044253.png)
如果提示信息显示“礼包错误或不存在”
请检查 `kit.yml` 配置文件是否有错误

如果提示信息显示“礼包不存在”或者“错误金额”
如果你正在使用`BC端`或者存在多个服务器
请检查是否存在多个服务器同用一个令牌
服务器同用一个令牌是非常不推荐的行为
**不仅会导致同步礼包及数据错误还会导致
网页订单的发货以及带来更多严重的问题**

## 服务诊断问题
> 诊断出现多个 javax.net.ssl.SSLHandshakeException 问题
> ![](/media/202602/2026-02-10_151755_1582890.09754812743307162.png)
你的服务器时间或者服务器证书有问题，修改插件网络通信方式为 `http`，具体查看配置文档

## 插件开启数据库后累计金额错误？
1. 请使用插件支持的 `MySQL 5.7 ~ 8` 版本
2. 一个令牌被多个服务器使用

以上情况可能出现累计金额错误或其他问题

## 游戏中 MP 输出乱码
> 此问题一般出现在旧版本核心（1.7.x - 1.8.x）

在核心启动的时候添加编码
```
-Dfile.encoding=GBK
```
如果重载之后输出还是乱码，请确保配置文件也是 `GBK` 编码哦

## 使用 Geyser 玩家名字前面多一个点，导致数据不同步？

请修改 Geyser 配置文件，移除基岩玩家默认前缀。