Files
netease-bedrock-wiki/mcguide/27-手机网络游戏/课程10:使用Spigot开服/90-常见问题合集.md
2025-08-26 17:11:11 +08:00

98 lines
5.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
front:
hard: 入门
time: 60分钟
---
# 常见问题合集
## 1、开发机上是否有对外开放的tcp端口
目前开发机上没有对外开放的tcp端口只有[10000,20000]的udp端口允许外部访问
## 2、能否支持连接相同Geyser的玩家加载不同的Mod
目前Mod经过Geyser加载并分发因此当前版本中通过同一个Geyser连接的玩家加载的Mod都相同如果需要实现不同bc或者spigot加载不同的Mod效果可通过配置不同的geyser连接不同的bc实现
## 3、开发机上Java命令怎么调用
由于目前Geyser和Spigot使用的java版本不同因此开发机上存在两个版本的java对应的命令分别是 **java18** 以及 **java8**因此在启动Spigot时请使用命令视情况自行选择java版本
![问题1-8](./res/quest8.png)
## 4、Geyser服日志怎么查看
使用ssh登录服务器后查看对应网络id下的geyser目录可以查看geyser的日志
![问题1-5](./res/quest5.png)
## 5、部署测试时遇到玩家连接不上问题怎么排查
部署测试时,遇到玩家连接不上的问题请根据如下步骤排查
### (1) 首先确定下调试标识
- 部署时,开启了如下标识
![问题1-1](./res/quest2.png)
> 则在bc服和master未成功连接时登录会有如下提示
![问题1-2](./res/quest1.png)
- 当对应标识未开启时,提示如下:
![问题1-3](./res/quest3.png)
### (2) 排查Geyser与Master、Proxy服是否正常连接
- 当geyser与proxy及master正常连接时Geyser服会输出如下日志
![问题1-6](./res/quest6.png)
- 当玩家正常连接上proxy及geyser时会输出如下日志
![问题1-7](./res/quest7.png)
- 当玩家登录时没有上述输出证明Geyser和Master、Proxy连接异常请对照文档检查配置
[Apollo2.0简述](./10-支持基岩版客户端的Java版网络游戏概述.md)
### (3) 排查BC服及BungeeMaster插件是否正常加载
- 当确定Geyser服连接正常时请查看BC服日志排查BungeeMaster插件是否正常加载以及master服是否正常连接上正常连接会有如下日志打印:
![问题1-4](./res/quest4.png)
- 当遇到没有上述输出时证明Geyser服、Master服、Bungee服组网失败。请根据文档排查以下几种常见原因
[Apollo2.0简述](./10-支持基岩版客户端的Java版网络游戏概述.md)
- 首先检查BC服的**config.yml**配置中,**master_port**是否和Studio配置的一致
- 再检查Studio配置的BC服端口是否为BC的**config.yml**中的**query_port(红框)**,请不要配置成**servers**里具体**Spigot服(绿框)**监听的端口
![问题1-9](./res/quest10.png)
- 若一致请通过netstat命令排查端口是否冲突被多个应用监听
- 若上述结果都显示正常请联系官方提供网络id、机器ip以供排查
### (4) 排查Spigot服是否正常连接
- 当出现如下截图信息时一般是Spigot无法连接到
![问题1-8](./res/quest9.png)
- 请检查BC服与Spigot服配置以及日志确定BC服能正常连接上Spigot服
### (5) 排查 Apollo 版本兼容性问题
- 当客户端与服务端的 Apollo 版本不一致(例如客户端为 3.1.0,而服务端为 3.0.0)时,玩家将无法进入游戏,界面会一直停留在“正在链接外部服务器”,同时 Geyser 日志中不会有任何输出。
- 请确保客户端与服务端使用的是相同版本,以避免因版本不兼容导致连接失败的问题。
- 可能您会疑惑:“我怎么知道什么时候需要更新 Apollo 版本呢?”
建议您在收到类似下图的 **开发包更新提醒短信或站内信** 时,**及时将开发环境中的服务器更新到最新的开发版本**,以确保当正式版本发布时能够顺利对接,避免出现严重兼容性问题,导致玩家无法连接或难以及时修复。
![问题1-9](./res/quest11.png)
- 在正式版本发布后,通常也会通过类似短信或站内信的方式通知您进行更新。**此外,请务必前往“编辑更新”中的“上传网络游戏”界面,在“适用版本”选项中勾选对应的新版本**,以确保玩家可以正常进入服务器。
- 同时我们建议为了防御可能的外挂破解和兼容性问题建议只开放最新的2个版本如目前最新为3.4版本则只开放3.3和3.4版本)
## 6、SpigotMaster是否必须加载?
目前Spigotmaster是强制要求加载虽然不加载不会报错但是会有部分功能无法支持。如皮肤防作弊、聊天插件控制、商城接口等。因此强烈要求必须加载SpigotMaster
**另外目前SpigotMaster不支持reload指令使用后会不正常建议不使用Spigot等端的reload指令**
## 7、Geyser的config.tpl如果有需要该如何修改?
目前暂不支持直接修改config.tpl如果有需要目前deploy.json文件提供了几个参数用于修改config.tpl中的常用参数。详见[其他部署时可配置字段](./13-其他部署时可配置字段.md)