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