修复格式

This commit is contained in:
RENaa_FD 2024-05-18 15:16:20 +08:00
parent 34b58d2153
commit bea3d8ab0e

View File

@ -17,50 +17,50 @@ Geyser有以下版本类型:
其中:
Spigot版本 可以作为插件安装在以Spigot及其分叉(如Paper)为核心的服务端上
Bungeecord Velocity和ViaProxy版本 可以作为插件安装在这些代理端上
Fabric和NeoForge版本 可以作为模组安装在这些模组端上
Standalone版本 可以作为一个独立的代理端启动
Spigot版本 可以作为插件安装在以Spigot及其分叉(如Paper)为核心的服务端上
BungeecordVelocity和ViaProxy版本 可以作为插件安装在这些代理端上
Fabric和NeoForge版本 可以作为模组安装在这些模组端上
Standalone版本 可以作为一个独立的代理端启动
## 挑选版本
在安装前, 你需要找到合适的Geyser版本
你可以参考下图:
在安装前你需要找到合适的Geyser版本
你可以参考下图:
![version](_image/VersionChoose.png)
* 1、运行独立版**仍需要Java16**及以上环境, 只不过你可以将其和目标服务器所处的Java环境隔开 此外**在任何情况下** 你都可使用独立版, 甚至独立版可以和其目标不在同一服务器上
* 2、你可以通过ViaVersion插件来适配版本 这会允许不同版本的玩家进入服务器, 不过问题不大
* 3、[Hydraulic](https://github.com/GeyserMC/Hydraulic) 可以允许你加入带客户端模组的服务器, 但是项目处于**早期开发阶段** 你可以做个尝试, 但是请不要在实际情况下使用
* 1、运行独立版**仍需要Java16**及以上环境只不过你可以将其和目标服务器所处的Java环境隔开 此外**在任何情况下**,你都可使用独立版,甚至独立版可以和其目标不在同一服务器上
* 2、你可以通过ViaVersion插件来适配版本这会允许不同版本的玩家进入服务器不过问题不大
* 3、[Hydraulic](https://github.com/GeyserMC/Hydraulic) 可以允许你加入带客户端模组的服务器,但是项目处于**早期开发阶段**,你可以做个尝试,但是请不要在实际情况下使用
## 下载
你可以在此处下载 [Geyser](https://geysermc.org/download#geyser) 的对应版本
你可以在此处下载 [Geyser](https://geysermc.org/download#geyser) 的对应版本
## 安装
### 其他版本
作为插件或模组安装到对应文件夹即可
作为插件或模组安装到对应文件夹即可
### 独立版
独立版作为一个单独的服务端
你可以参考 [此处](../../正式开服/开启服务端) 的开启方法
独立版作为一个单独的服务端
你可以参考 [此处](../../正式开服/开启服务端) 的开启方法
## 配置
找到配置文件夹下的config.yml
(什么,你连配置文件夹都找不到? 那你真是连笨蛋都不如, 配置文件在对应版本Geyser名称的文件夹下一般开启服务器后都会生成)
找到配置文件夹下的config.yml
(什么,你连配置文件夹都找不到? 那你真是连笨蛋都不如配置文件在对应版本Geyser名称的文件夹下一般开启服务器后都会生成)
:::danger
作为一个新手, 在本教程未提及前, 请不要随意更改任何配置项
作为一个新手,在本教程未提及前,请不要随意更改任何配置项
:::
第一眼你可能会被全是英文的配置文件镇住
别急,善用翻译来理解配置文件中的注释
**在完成本教程的基础配置配置后, 若需进阶, 请参考 [此处](https://docs.superiormc.cn/v/geyser-wiki/user-guide/li-jie-pei-zhi) 的配置参考**
第一眼你可能会被全是英文的配置文件镇住
别急,善用翻译来理解配置文件中的注释
**在完成本教程的基础配置配置后,若需进阶,请参考 [此处](https://docs.superiormc.cn/v/geyser-wiki/user-guide/li-jie-pei-zhi) 的配置参考**
接下来回到配置映入你眼帘的应该是bedrock和remote两个大项
bedrock所代表的是你所开放的端口 也是基岩版玩家看到的那个
remote是连接的目标服务器 若不使用独立版此选项无效, 请不要随意更改
接下来回到配置映入你眼帘的应该是bedrock和remote两个大项
bedrock所代表的是你所开放的端口也是基岩版玩家看到的那个
remote是连接的目标服务器若不使用独立版此选项无效请不要随意更改
```yaml
bedrock:
@ -71,7 +71,7 @@ bedrock:
server-name: "Geyser"
compression-level: 6
enable-proxy-protocol: false
#proxy-protocol-whitelisted-ips: [ "127.0.0.1" "172.18.0.0/16" ]
#proxy-protocol-whitelisted-ips: [ "127.0.0.1""172.18.0.0/16" ]
```
```yaml
@ -84,19 +84,19 @@ remote:
forward-hostname: false
```
### Bedrock项
**`port`**: 其代表你向基岩版玩家所开放的端口, 在设置端口时请不要低于10000
**`motd1`** 和 **`motd2`**: 其代表向基岩版玩家所显示的MOTD 可根据你的喜好配置, 仅支持最基础的颜色符号
**`server-name`**: 基岩版所看到的服务器名称, 在暂停菜单和设置中可见
**`port`**: 其代表你向基岩版玩家所开放的端口在设置端口时请不要低于10000
**`motd1`** 和 **`motd2`**: 其代表向基岩版玩家所显示的MOTD可根据你的喜好配置仅支持最基础的颜色符号
**`server-name`**: 基岩版所看到的服务器名称,在暂停菜单和设置中可见
### Remote项
**若不使用独立版请忽略!**
**`address`**: 其代表目标服务器的地址, 若目标服务器和Geyser处于同一服务器下请不要更改
**`port`**: 请和目标服务器对外开放的端口一致
**`auth-type`**: 有offline online和floodgate模式offline和online分别对应离线和正版 你目标服务器用的什么就选什么, floodgate会在后续教程中解释
**若不使用独立版请忽略!**
**`address`**: 其代表目标服务器的地址若目标服务器和Geyser处于同一服务器下请不要更改
**`port`**: 请和目标服务器对外开放的端口一致
**`auth-type`**: 有offlineonline和floodgate模式offline和online分别对应离线和正版你目标服务器用的什么就选什么floodgate会在后续教程中解释
### 其他项
再往下翻你会注意到不少其他乱七八糟的项
这里挑几个重点
再往下翻你会注意到不少其他乱七八糟的项
这里挑几个重点
```yaml
passthrough-motd: true
@ -110,124 +110,124 @@ show-coordinates: true
above-bedrock-nether-building: false
```
**`passthrough-motd`**: 把Java版本的MOTD发送给基岩版
**`passthrough-player-counts`**: 将玩家数量和最大玩家数量发给基岩玩家
**`show-cooldown`**: 由于基岩版没有战斗冷却, 此功能会模拟一个冷却提示器, 你可以设置为title(小标题) actionbar(物品栏上方的标题) 或 false(关闭)
**`show-coordinates`**: 是否向玩家显示坐标
**`above-bedrock-nether-building`**: 开启后你将被允许在下届高度127以上建造 缺点是整个下界中雾的颜色不再可变, 将一直是红色
**`passthrough-motd`**: 把Java版本的MOTD发送给基岩版
**`passthrough-player-counts`**: 将玩家数量和最大玩家数量发给基岩玩家
**`show-cooldown`**: 由于基岩版没有战斗冷却此功能会模拟一个冷却提示器你可以设置为title(小标题)actionbar(物品栏上方的标题) 或 false(关闭)
**`show-coordinates`**: 是否向玩家显示坐标
**`above-bedrock-nether-building`**: 开启后你将被允许在下届高度127以上建造缺点是整个下界中雾的颜色不再可变将一直是红色
## Floodagte
为进一步兼容, 你需要安装 [floodgate](https://geysermc.org/download#floodgate)
floodgate可作为一个插件安装到Spigot及其分支的核心上或BungeeCord Velocity之类的代理上
群组服/独立版Geyser 的Floodgate安装需要进行一些额外步骤 请跟随教程完成
为进一步兼容,你需要安装 [floodgate](https://geysermc.org/download#floodgate)
floodgate可作为一个插件安装到Spigot及其分支的核心上或BungeeCordVelocity之类的代理上
群组服/独立版Geyser 的Floodgate安装需要进行一些额外步骤请跟随教程完成
:::warning
纯模组端无法使用Floodgate 不要考虑
纯模组端无法使用Floodgate不要考虑
:::
Floodgate是一个允许 **Minecraft 基岩版** 帐号加入 **Minecraft Java版** 正版服务器而无需其**正版账号**的混合模式插件
Floodgate是一个允许 **Minecraft 基岩版** 帐号加入 **Minecraft Java版** 正版服务器而无需其**正版账号**的混合模式插件
但**不止于此**
但**不止于此**
它还允许:
它还允许:
* 让Java版玩家看到基岩版玩家的皮肤
* 向基岩版玩家发送BE Form UI (基岩版独有的一种菜单格式)
* 允许基岩版玩家与Java版玩家进行账号数据间的连接
* 提供一个通用的API 使更多插件可以兼容基岩版玩家
* 以基岩版XUID作为UUID储存数据 使在基岩版玩家改名后不丢失数据
* 提供一个通用的API使更多插件可以兼容基岩版玩家
* 以基岩版XUID作为UUID储存数据使在基岩版玩家改名后不丢失数据
所以就算**非正版服务器** 也有**必要**安装此插件来获取更强大的兼容性
所以就算**非正版服务器**,也有**必要**安装此插件来获取更强大的兼容性
此外, Floodgate有个小缺点 在安装之后你无法直接使基岩版玩家和Java版玩家数据互通
这将在进阶教程中给出两个可行的解决办法
此外Floodgate有个小缺点在安装之后你无法直接使基岩版玩家和Java版玩家数据互通
这将在进阶教程中给出两个可行的解决办法
### 基础配置
:::warning
由于Floodgate在设计时并未考虑离线服务器
接下来的教程中将告诉你如何进行调整以更好的适配离线服
由于Floodgate在设计时并未考虑离线服务器
接下来的教程中将告诉你如何进行调整以更好的适配离线服
:::
:::warning
若你在使用独立版Geyser或群组服 请翻到下方跟随对应教程完成安装
若你在使用独立版Geyser或群组服请翻到下方跟随对应教程完成安装
:::
安装Floodgate后 打开配置文件, 注意到以下项
安装Floodgate后打开配置文件注意到以下项
```yaml
username-prefix: "."
```
这是Floodgate为了区分基岩版玩家和Java版玩家 而在基岩版玩家名称前添加的前缀
这是Floodgate为了区分基岩版玩家和Java版玩家而在基岩版玩家名称前添加的前缀
为什么?
为什么?
因为在安装Floodgate后 基岩版玩家的UUID将会和Java版玩家有很大不同
若是遇到重名, 则会出现一个ID拥有两个完全不同的UUID 这可能会发生一些无法预知的错误
而使用"."前缀是因为Java正版玩家名中不可使用"."
因为在安装Floodgate后基岩版玩家的UUID将会和Java版玩家有很大不同
若是遇到重名则会出现一个ID拥有两个完全不同的UUID这可能会发生一些无法预知的错误
而使用"."前缀是因为Java正版玩家名中不可使用"."
**但是**
这在离线服中,有几个问题:
* 离线服玩家名是可以任意修改的, 所以Java玩家一样可以使用相同前缀进入服务器
* 部分登录插件会禁止诸如带有"."玩家名的玩家进入服务器, 这会导致基岩版玩家无法进入服务器
**但是**
这在离线服中,有几个问题:
* 离线服玩家名是可以任意修改的所以Java玩家一样可以使用相同前缀进入服务器
* 部分登录插件会禁止诸如带有"."玩家名的玩家进入服务器,这会导致基岩版玩家无法进入服务器
接下来我们来解决这些问题
接下来我们来解决这些问题
要解决第一个问题, 由于离线服务器玩家可以使用任何名称进入服务器, 我们可以选择禁止所有使用基岩版玩家名前缀的Java玩家进入服务器
要解决第一个问题由于离线服务器玩家可以使用任何名称进入服务器我们可以选择禁止所有使用基岩版玩家名前缀的Java玩家进入服务器
**此部分未完工, 咕咕咕!**
**此部分未完工,咕咕咕!**
在第一个问题解决后, 我们可以使用任意前缀作为基岩版玩家的区分
于是将前缀修改为诸如"BE_"这类的合法字符即可解决第二个问题
在第一个问题解决后,我们可以使用任意前缀作为基岩版玩家的区分
于是将前缀修改为诸如"BE_"这类的合法字符即可解决第二个问题
```yaml
username-prefix: "BE_"
```
### 独立版Geyser配置
首先, 按照基础配置在目标服务器安装Floodgate
然后注意到Floodgate配置文件夹下 理应会生成一个叫key.pem的文件
将其复制到独立版Geyser配置文件夹下
首先按照基础配置在目标服务器安装Floodgate
然后注意到Floodgate配置文件夹下理应会生成一个叫key.pem的文件
将其复制到独立版Geyser配置文件夹下
然后来到Geyser配置文件
然后来到Geyser配置文件
找到Remote项中的 **`auth-type`** 并将其改为 **`floodgate`**
找到Remote项中的 **`auth-type`**,并将其改为 **`floodgate`**
```yaml
remote:
auth-type: floodgate
```
若Geyser已开启 则重启Geyser即可完成配置
若Geyser已开启则重启Geyser即可完成配置
### 群组服配置
首先, 在群组端安装Floodgate 并按照基础配置完成安装
首先在群组端安装Floodgate并按照基础配置完成安装
:::warning
不要将子服中的Floodgate配置直接复制到群组服 会缺少某个重要项
不要将子服中的Floodgate配置直接复制到群组服会缺少某个重要项
:::
接下来来到群组服的Floodgate配置
找到 **`send-floodgate-data`** 这一项, 将其修改为true
接下来来到群组服的Floodgate配置
找到 **`send-floodgate-data`** 这一项将其修改为true
```yaml
send-floodgate-data: true
```
这样子服就可以接收到来自群组服的基岩版玩家数据了
请注意在开启此项后, 若子服不安装Floodgate则基岩版玩家则无法进入子服
但是此项很重要, 若不开启, 则在子服中Floodgate不起效果
这样子服就可以接收到来自群组服的基岩版玩家数据了
请注意在开启此项后若子服不安装Floodgate则基岩版玩家则无法进入子服
但是此项很重要若不开启则在子服中Floodgate不起效果
接下来, 在子服一一安装Floodgate并确保和群组服的Floodgate配置一致
然后注意到群组端Floodgate配置文件夹下 理应会生成一个叫key.pem的文件
用群组服的key.pem将子服中的key.pem覆盖 确保key.pem完全相同
接下来在子服一一安装Floodgate并确保和群组服的Floodgate配置一致
然后注意到群组端Floodgate配置文件夹下理应会生成一个叫key.pem的文件
用群组服的key.pem将子服中的key.pem覆盖确保key.pem完全相同
即可完成群组端配置
即可完成群组端配置
## 结尾
恭喜你,配置完毕!!,开始和你的好友一起玩吧
恭喜你,配置完毕!!,开始和你的好友一起玩吧