本帖最后由 pXiaoD 于 2021-12-29 18:22 编辑
常见异常
通常，用户在使用 Geyser 时会遇到无法连接到服务器类似的错误，这个页面帮助你尝试解决这些异常。如果你仍然没有解决，请不妨加入 我们的 Discord 以获得支持。
Floodgate
有关 Floodgate 的帮助，请见: Floodgate Wiki。
我无法连接到服务器! (服务器在好友选项卡没有显示或者在连接服务器时出现 "无法连接到世界")
如果服务器没有在好友选项卡显示
如果 Geyser 服务器就在本地：尝试将 localhost 或者 0.0.0.0 作为IP，以添加服务器形式进行连接。如果这没有效果，或者你的 Geyser 服务器不在同一个电脑，那么请使用：你 本地 的 IPv4 地址。
点击这里 以修复 "无法连接至世界" 且后台无报错
在启动时提示 java.net.BindException: Address already in use: bind
这代表 Geyser 服务器所开设的端口已被占用，请确保你关闭了所有占用该端口的软件，然后再试。如果这没有起作用，通常重启你的电脑即可解决该问题。
[...] has been compiled by a more recent version of the Java Runtime (class file version 60.0)
点击这个链接以了解如何升级到 Java 16: https://paper.readthedocs.io/en/latest/java-update/index.html.
您的服务商可能没有及时打开UDP端口
这通常和你的主机端的端口有关。最常见的是，跟Java版的常用的 TCP 协议的端口不同，你的主机很有可能没有开放基岩版所使用的 UDP 协议的端口。一个确认此问题的方法是关闭你的服务器，然后选择其他 基岩版服务端，例如 Nukkit（你不一定非要用 Nukkit）以检查是否是该问题导致的。
卡在 "正在连接服务器" 且后台没有报错
你或许需要升级你的 Java，如果确实是这样，请访问 AdoptOpenJDK.net。
有时这会发生在网络较差的环境中。 Geyser 配置中有一个 mtu 选项； 慢慢降低这个数字（以 100 为基准），每次修改后重新启动，并重新测试加入。
如果您收到“无法连接到世界”而没有提示新的连接的控制台记录，则此选项很可能没有作用。
登录失败
如果你正在使用一个插件版本： 在你的 Geyser 配置，将你的 bedrock 的 ip 设置为 127.0.0.1。
Cannot reply to EncryptionRequestPacket without profile and access token
出现这个消息一般有两个原因:
Floodgate 问题:
如果您配置启用了 Floodgate 可能会出现此消息。 通常，这意味着您的 Floodgate 配置是错误的，或与其他插件冲突。如果您曾将 Floodgate 的密钥文件复制到 同一服务器 上的 Geyser 文件夹，那么 Geyser 文件夹内的密钥文件就是多余的。您可以放心的删除复制到 Geyser 文件夹中的密钥文件，重新启动服务器。
服务器是正版模式而你的 Geyser 设置的是离线模式:
如果你的配置如上所述，那么简单来说，Geyser 自然不会正常运作。如果你将服务器设置为正版认证，那么你的 Geyser 配置也应该是相同的。 正版认证的服务器将会要求您使用 Java正版账户 进行登录认证，如果你在登陆 Geyser 的时候没有使用正版账户认证，那么你将无法加入服务器。如果你的配置没有问题却仍然遇到这个报错，那么有可能是您的登录凭据无效（如密码错误）或者是连接正版认证服务器时连接超时。
Connection Refused: <INSERT IP AND/OR DOMAIN>
连接被拒绝通常意味着请求该端口时无法连接 Java 服务器，或者服务器拒绝访问网络级别的外部连接。后者可能会发生在类似 TCPShield 等 DDOS 防护插件上，如果您没有类似的 DDOS 防护插件，请确保您尝试连接的服务器连接 IP 或域名在配置中拼写正确，已启动且端口转发正确。
如果您从旧版本的 Geyser 进行更新，请将您的远程地址设置为auto，然后重试。
Floodgate Misconfiguration
请查看 Floodgae Wiki 查看更多信息
Mojang Resetting Account Credentials
不幸的是，这是我们无法控制的事情，当您在服务器上将 Geyser 作为插件运行，很可能出现这种情况，异地登陆会让 Mojang 判定您的账户可能被盗号，并因此重置登录凭据。 如果您在本地运行 Geyser，这不应该发生。我们推荐由我们制作的插件 Floodgate, 它允许基岩版客户端在不需要 Java 版帐户的情况下加入您的服务器。 点击了解这个插件 以获得更多帮助。
基岩版客户端提示 "无效IP地址"
目前尚不清楚为什么，即使对于有效的域名也会发生这种情况。尝试使用 IPv4 地址。
基岩版客户端在使用指令时出现卡顿或者崩溃
在你的 Geyser 配置文件中关闭 command-suggestions 选项。 关闭这个设置后基岩版玩家将无法进行命令补全，但是可以防止因此造成的游戏卡顿或崩溃。 如果你是服务器的管理员，你可以准备一份命令白名单让玩家使用， 这将会把非必要的命令从TAB补全中移除，对于Java版玩家来说也是一样。他还有其他好处。这是一个可以做到此功能的插件： CommandWhitelist
BungeeCord 在基岩版玩家加入后卡顿或者崩溃
请确保你的 BungeeCord 的 config.yml 配置文件中将 ip-forward 设置为 true 并在你的所有子服的 spigot.yml 配置文件中将 bungeecord 设置为 true。
Failed to load locale asset cache: Unrecognized token 'Cannot'
这与启动时无法下载区域设置文件相关的任何其他内容通常是由 java 尝试使用 IPv6 连接而 Mojang 仅使用 IPv4 引起的，因此使用在启动命令添加此标识来固定使用ipv4： -Djava.net.preferIPv4Stack=true, 就像这样: java -Xms1024M -Djava.net.preferIPv4Stack=true -jar Geyser.jar
Outdated client! Please use 1.x.x
Java 版服务器太新，Geyser 对它来说有点旧了。请确保你的 Geyser 是最新版本，如果是，请耐心等待 Geyser 完成更新。
Outdated server! I'm still on 1.x.x
更新你的 Java 版服务器或者使用 ViaVersion 插件。 你也可以尝试 VIAaaS。
Query: Incorrect Magic!
看这里： https://www.spigotmc.org/threads/query-incorrect-magic-and-high-cpu-usage.159386/#post-2709057
*如果您不使用 TCPShield 等反向代理，请确保将 enable-proxy-protocol 设置为 false.
只在安装 Floodgate 的 BungeeCord 服务器上有效
如果您使用 Floodgate，请确保将其安装在所有 Spigot 子服上，如下所示：
如果您的玩家无法从大厅连接到另一个子服，请检查控制台。
可能造成该问题的插件：
常见异常
通常，用户在使用 Geyser 时会遇到无法连接到服务器类似的错误，这个页面帮助你尝试解决这些异常。如果你仍然没有解决，请不妨加入 我们的 Discord 以获得支持。
Floodgate
有关 Floodgate 的帮助，请见: Floodgate Wiki。
我无法连接到服务器! (服务器在好友选项卡没有显示或者在连接服务器时出现 "无法连接到世界")
- 如果你不使用像 TCPShield 的反向代理，请保证你的 enable-proxy-protocol 选项是设置为 false 的。
如果服务器没有在好友选项卡显示
- 如果你使用的是 Windows 10, iOS, 或者 Android: 尝试以添加服务器形式连接。
- 如果你使用的是 Xbox One: 尝试使用 BedrockConnect 连接。
- 如果你使用的是 PS4: 请使用使用一个 LAN 代理
- 如果你使用的是 Nintendo Switch: 目前没有方法可以使用好友选项卡连接，但你仍然可以使用 BedrockConnect 以添加服务器形式连接。
如果 Geyser 服务器就在本地：尝试将 localhost 或者 0.0.0.0 作为IP，以添加服务器形式进行连接。如果这没有效果，或者你的 Geyser 服务器不在同一个电脑，那么请使用：你 本地 的 IPv4 地址。
点击这里 以修复 "无法连接至世界" 且后台无报错
在启动时提示 java.net.BindException: Address already in use: bind
这代表 Geyser 服务器所开设的端口已被占用，请确保你关闭了所有占用该端口的软件，然后再试。如果这没有起作用，通常重启你的电脑即可解决该问题。
[...] has been compiled by a more recent version of the Java Runtime (class file version 60.0)
点击这个链接以了解如何升级到 Java 16: https://paper.readthedocs.io/en/latest/java-update/index.html.
您的服务商可能没有及时打开UDP端口
这通常和你的主机端的端口有关。最常见的是，跟Java版的常用的 TCP 协议的端口不同，你的主机很有可能没有开放基岩版所使用的 UDP 协议的端口。一个确认此问题的方法是关闭你的服务器，然后选择其他 基岩版服务端，例如 Nukkit（你不一定非要用 Nukkit）以检查是否是该问题导致的。
卡在 "正在连接服务器" 且后台没有报错
你或许需要升级你的 Java，如果确实是这样，请访问 AdoptOpenJDK.net。
有时这会发生在网络较差的环境中。 Geyser 配置中有一个 mtu 选项； 慢慢降低这个数字（以 100 为基准），每次修改后重新启动，并重新测试加入。
如果您收到“无法连接到世界”而没有提示新的连接的控制台记录，则此选项很可能没有作用。
登录失败
如果你正在使用一个插件版本： 在你的 Geyser 配置，将你的 bedrock 的 ip 设置为 127.0.0.1。
Cannot reply to EncryptionRequestPacket without profile and access token
出现这个消息一般有两个原因:
Floodgate 问题:
如果您配置启用了 Floodgate 可能会出现此消息。 通常，这意味着您的 Floodgate 配置是错误的，或与其他插件冲突。如果您曾将 Floodgate 的密钥文件复制到 同一服务器 上的 Geyser 文件夹，那么 Geyser 文件夹内的密钥文件就是多余的。您可以放心的删除复制到 Geyser 文件夹中的密钥文件，重新启动服务器。
服务器是正版模式而你的 Geyser 设置的是离线模式:
如果你的配置如上所述，那么简单来说，Geyser 自然不会正常运作。如果你将服务器设置为正版认证，那么你的 Geyser 配置也应该是相同的。 正版认证的服务器将会要求您使用 Java正版账户 进行登录认证，如果你在登陆 Geyser 的时候没有使用正版账户认证，那么你将无法加入服务器。如果你的配置没有问题却仍然遇到这个报错，那么有可能是您的登录凭据无效（如密码错误）或者是连接正版认证服务器时连接超时。
Connection Refused: <INSERT IP AND/OR DOMAIN>
连接被拒绝通常意味着请求该端口时无法连接 Java 服务器，或者服务器拒绝访问网络级别的外部连接。后者可能会发生在类似 TCPShield 等 DDOS 防护插件上，如果您没有类似的 DDOS 防护插件，请确保您尝试连接的服务器连接 IP 或域名在配置中拼写正确，已启动且端口转发正确。
如果您从旧版本的 Geyser 进行更新，请将您的远程地址设置为auto，然后重试。
Floodgate Misconfiguration
请查看 Floodgae Wiki 查看更多信息
Mojang Resetting Account Credentials
不幸的是，这是我们无法控制的事情，当您在服务器上将 Geyser 作为插件运行，很可能出现这种情况，异地登陆会让 Mojang 判定您的账户可能被盗号，并因此重置登录凭据。 如果您在本地运行 Geyser，这不应该发生。我们推荐由我们制作的插件 Floodgate, 它允许基岩版客户端在不需要 Java 版帐户的情况下加入您的服务器。 点击了解这个插件 以获得更多帮助。
基岩版客户端提示 "无效IP地址"
目前尚不清楚为什么，即使对于有效的域名也会发生这种情况。尝试使用 IPv4 地址。
基岩版客户端在使用指令时出现卡顿或者崩溃
在你的 Geyser 配置文件中关闭 command-suggestions 选项。 关闭这个设置后基岩版玩家将无法进行命令补全，但是可以防止因此造成的游戏卡顿或崩溃。 如果你是服务器的管理员，你可以准备一份命令白名单让玩家使用， 这将会把非必要的命令从TAB补全中移除，对于Java版玩家来说也是一样。他还有其他好处。这是一个可以做到此功能的插件： CommandWhitelist
BungeeCord 在基岩版玩家加入后卡顿或者崩溃
请确保你的 BungeeCord 的 config.yml 配置文件中将 ip-forward 设置为 true 并在你的所有子服的 spigot.yml 配置文件中将 bungeecord 设置为 true。
Failed to load locale asset cache: Unrecognized token 'Cannot'
这与启动时无法下载区域设置文件相关的任何其他内容通常是由 java 尝试使用 IPv6 连接而 Mojang 仅使用 IPv4 引起的，因此使用在启动命令添加此标识来固定使用ipv4： -Djava.net.preferIPv4Stack=true, 就像这样: java -Xms1024M -Djava.net.preferIPv4Stack=true -jar Geyser.jar
Outdated client! Please use 1.x.x
Java 版服务器太新，Geyser 对它来说有点旧了。请确保你的 Geyser 是最新版本，如果是，请耐心等待 Geyser 完成更新。
Outdated server! I'm still on 1.x.x
更新你的 Java 版服务器或者使用 ViaVersion 插件。 你也可以尝试 VIAaaS。
Query: Incorrect Magic!
看这里： https://www.spigotmc.org/threads/query-incorrect-magic-and-high-cpu-usage.159386/#post-2709057
*如果您不使用 TCPShield 等反向代理，请确保将 enable-proxy-protocol 设置为 false.
只在安装 Floodgate 的 BungeeCord 服务器上有效
如果您使用 Floodgate，请确保将其安装在所有 Spigot 子服上，如下所示：
- Bungee: Geyser 和 Floodgate
- 大厅: floodgate
- 子服-1: floodgate
- 子服-2: floodgate 其他的同理。
- 请保证你的 key.pem 和 config.yml 在所有的服务器上使用的是相同的配置。
如果您的玩家无法从大厅连接到另一个子服，请检查控制台。
可能造成该问题的插件：
- HamsterAPI
本帖最后由 pXiaoD 于 2021-12-29 19:03 编辑
修复 “无法连接至世界”
无法连接至世界 是许多人在使用 Geyser 时遇到的共同问题，下面我们将一步一步教你如何解决这一问题。
在我们开始之前...
...Java 玩家同样也无法加入！
这 肯定不是 Geyser的问题。Geyser 不会对 Java版服务器 进行任何改动。Floodgate 也只对 基岩版玩家 修改登录流程。所以，请联系你的服务商，向他们寻求解决服务器连接的问题。
...我刚刚更新了Geyser，现在它没法正常工作了！
如果这在你更新了插件版的Geyser后出现，请确保你是关闭了你的服务器，然后替换了 Geyser jar 文件，然后重新开启你的服务器。
...控制台有一堆报错！
请阅读 常见异常。如果你的问题并不在那个页面出现，请加入我们的 Discord 以寻求帮助。
...你被无限的重启困扰了吗？
特别是手机用户，有时，你只需要重启你的游戏客户端就可以解决这个问题了。
是服务器的问题还是客户端的问题？
将你的 Java 版服务器 IP 和基岩版的 IP 放在 https://mcsrvstat.us/ 网站查询。这是首先确定服务器是否正常工作的好办法。
一般排除步骤
确保你使用正确的 IP 连接
您应该连接到 Java 服务器 IP 和基岩端口。 例如，如果您转发了 19132 端口，则在从基岩版连接时应指定端口 19132。
我正在使用一个云主机 或者 VPS！
请向你的服务商寻求帮助。
端口转发
您的服务器需要进行端口转发。通常，您可以使用 Minecraft Java版的端口转发相关教程获取帮助；但是，您需要将其中的 TCP 替换为 UDP，并且默认情况下，将端口 25565 替换为 19132。
在 DNS 选项/端口转发中使用 TCP 而不是 UDP
Minecraft Java版使用 TCP 进行连接； Minecraft 基岩版使用 UDP。仅使用 TCP 转发您的基岩版端口将不起作用，它必须是 UDP。 使用TCP/UDP（两种协议）转发你的基岩版端口也应该有效，但不推荐使用，除非 Java 版和基岩版共享同一个端口。
基岩版端口值小于 10000
从以前的数据上看，拥有一个较低的基岩版端口值会导致问题。 将其设置为 10000 或更高似乎是更为稳妥的。
更改配置文件 'bedrock' 项的 'address'
除了少数的服务商只开放给您指定的端口或者其他特殊情况，您通常不需要更改 Geyser 配置的这一部分。 但是，在极少数情况下，它确实可以解决问题。
对于服务商
翼龙面板
如果您在使用翼龙面板时遇到此错误，请尝试编辑 Geyser 配置并将端口更改为除“19132”之外的其他值（例如“25566”）。
在同一网络上的另一台计算机上使用 Geyser
只能在主机上连接，不能以其他任何方式连接
您的防火墙很可能屏蔽了 Geyser 的端口。 尝试在其中添加基岩版所连接的端口，或出于测试目的禁用防火墙。
在同一台电脑上使用 Geyser
Windows 10
这只会影响尝试从 Windows 10 版加入 Geyser 且与 Geyser 服务器在同一台电脑上的人。
这是由未解除环回限制(Loopback restrictions)引起的问题。 默认情况下，微软应用对其所有本地连接的应用程序都有此限制。 Geyser 将尝试自动解决此问题；但是，如果您在使用 Geyser 时若仍然遇到连接问题，您可以通过在管理员模式下在 Windows PowerShell 中输入以下内容来解除它：（如果正常执行，它应该返回“OK.”）
复制代码
如果这不起作用，您可以尝试以下步骤：
修复 “无法连接至世界”
无法连接至世界 是许多人在使用 Geyser 时遇到的共同问题，下面我们将一步一步教你如何解决这一问题。
在我们开始之前...
...Java 玩家同样也无法加入！
这 肯定不是 Geyser的问题。Geyser 不会对 Java版服务器 进行任何改动。Floodgate 也只对 基岩版玩家 修改登录流程。所以，请联系你的服务商，向他们寻求解决服务器连接的问题。
...我刚刚更新了Geyser，现在它没法正常工作了！
如果这在你更新了插件版的Geyser后出现，请确保你是关闭了你的服务器，然后替换了 Geyser jar 文件，然后重新开启你的服务器。
...控制台有一堆报错！
请阅读 常见异常。如果你的问题并不在那个页面出现，请加入我们的 Discord 以寻求帮助。
...你被无限的重启困扰了吗？
特别是手机用户，有时，你只需要重启你的游戏客户端就可以解决这个问题了。
是服务器的问题还是客户端的问题？
将你的 Java 版服务器 IP 和基岩版的 IP 放在 https://mcsrvstat.us/ 网站查询。这是首先确定服务器是否正常工作的好办法。
一般排除步骤
确保你使用正确的 IP 连接
您应该连接到 Java 服务器 IP 和基岩端口。 例如，如果您转发了 19132 端口，则在从基岩版连接时应指定端口 19132。
我正在使用一个云主机 或者 VPS！
请向你的服务商寻求帮助。
端口转发
您的服务器需要进行端口转发。通常，您可以使用 Minecraft Java版的端口转发相关教程获取帮助；但是，您需要将其中的 TCP 替换为 UDP，并且默认情况下，将端口 25565 替换为 19132。
在 DNS 选项/端口转发中使用 TCP 而不是 UDP
Minecraft Java版使用 TCP 进行连接； Minecraft 基岩版使用 UDP。仅使用 TCP 转发您的基岩版端口将不起作用，它必须是 UDP。 使用TCP/UDP（两种协议）转发你的基岩版端口也应该有效，但不推荐使用，除非 Java 版和基岩版共享同一个端口。
基岩版端口值小于 10000
从以前的数据上看，拥有一个较低的基岩版端口值会导致问题。 将其设置为 10000 或更高似乎是更为稳妥的。
更改配置文件 'bedrock' 项的 'address'
除了少数的服务商只开放给您指定的端口或者其他特殊情况，您通常不需要更改 Geyser 配置的这一部分。 但是，在极少数情况下，它确实可以解决问题。
对于服务商
翼龙面板
如果您在使用翼龙面板时遇到此错误，请尝试编辑 Geyser 配置并将端口更改为除“19132”之外的其他值（例如“25566”）。
在同一网络上的另一台计算机上使用 Geyser
只能在主机上连接，不能以其他任何方式连接
您的防火墙很可能屏蔽了 Geyser 的端口。 尝试在其中添加基岩版所连接的端口，或出于测试目的禁用防火墙。
在同一台电脑上使用 Geyser
Windows 10
这只会影响尝试从 Windows 10 版加入 Geyser 且与 Geyser 服务器在同一台电脑上的人。
这是由未解除环回限制(Loopback restrictions)引起的问题。 默认情况下，微软应用对其所有本地连接的应用程序都有此限制。 Geyser 将尝试自动解决此问题；但是，如果您在使用 Geyser 时若仍然遇到连接问题，您可以通过在管理员模式下在 Windows PowerShell 中输入以下内容来解除它：（如果正常执行，它应该返回“OK.”）
- CheckNetIsolation LoopbackExempt -a -n="Microsoft.MinecraftUWP_8wekyb3d8bbwe"
如果这不起作用，您可以尝试以下步骤：
- 按住Windows键+ R
- 在提示中输入hdwwiz.exe，然后回车然后下一步
- 手动安装硬件
- 选择 网络适配器 > 下一步 > 左边选择 "Microsoft" > 右边选择 "Microsoft KM-TEST 环回适配器" 然后点击 下一步 直到完成。
本帖最后由 pXiaoD 于 2021-12-29 19:16 编辑
常见问题
Geyser 是如何工作的？
Geyser 像一个翻译官那样工作，将传入和传出的数据包翻译为客户端和服务端（服务器） 都能理解的格式。这样说来，它模拟了 Minecraft Java版 客户端，因此服务器实际上认为您是从 Java版本 加入的。无论是什么服务器以及它安装了什么插件，您都可以将其与 Geyser 连接（只要服务器支持最新的Minecraft版本）。
红石是按照哪个版本工作的？
红石，还有 指令、农场 等各种机制都是按照 Java版 工作的。因为你加入的服务器是一个 Java版 服务器。
Geyser 是付费的吗?
不，Geyser 和 它的相关一切作品 都是 免费且开源的，且遵循 MIT 协议。
哪些插件不兼容 Geyser？
Geyser 应当和大部分 服务端插件 兼容，但总有例外，例如：
Floodgate 与修改登录流程的插件不兼容。请务必注意以下各个支持离线登录的插件只是为了 Wiki 编写，Geyser 官方不对离线服务器提供帮助支持。
如果你发现其他不兼容情况，可通过 Discord 联系我们。
我应该使用哪个版本的 插件版Geyser？
Geyser-Spigot 支持什么版本?
支持 1.12.2 及更高版本。如果你的服务器比这个版本还低，请使用独立版。
如果我使用 BungeeCord，那么 Geyser/Floodgate 应该放置到哪?
你只需要在你的 BungeeCord 服务器安装 Geyser/Floodgate，这是在你的服务器不使用 Floodgate API 的情况下。如果不是这种情况，你还需要在每个子服都正确安装 Floodgate。
我应该给基岩版玩家什么 IP？
一般来说，如果你没有自己修改过，那么你的基岩版玩家连接你的服务器的IP应该和你的 Java版玩家 一样。至于端口，则根据你的 Geyser 配置下的 bedrock 下的 port 选项来决定。
我如何让基岩版玩家加载资源包？
你可以在 Geyser 下的 packs 文件夹放置资源包。基岩版客户端在加入服务器时会自动下载资源包。目前没有 Java-基岩 资源包自动转换 的功能，如果你需要转换资源包格式，请前往 https://rtm516.github.io/ConvertJavaTextureToBedrock/ 并把转换好的资源包放置在 Geyser 内。
基岩版玩家如何副手拿物品？
你可以使用指令 /geyser offhand 来进行 主手和副手 的切换。你也可以通过修改 Geyser 下的配置 (emote-offhand-workaround) 来使得基岩版通过游戏里的 表情 按钮来进行 主手和副手 的切换。
在使用 Floodgate 时，执行指令的玩家变量是什么？
如果基岩版玩家有前缀，所有指令的 必须 在名称中 包含该前缀 。Floodgate 还将名称中的所有 空格 替换为 下划线 ，因此在执行命令时请务必将所有空格替换为下划线。 如果这不起作用，请在名称周围加上双引号。
示例: /tp ".<基岩版玩家>"。
在使用 Floodgate 时，我该如何添加基岩版玩家到白名单内？
您可以通过三种方式执行此操作。 第一种方法是使用 Floodgate 的内置白名单命令，/fwhitelist add .<基岩版玩家>。 第二种方法是执行 /whitelist off 关闭白名单，然后让基岩版玩家加入，然后执行 /whitelist add ".<基岩版玩家>"指令，最后执行 /whitelist on 重新打开白名单。 ( 如果你使用了基岩版和Java版账号连接功能，那么你无需再为基岩版玩家设置白名单，在 Java版 玩家尝试申请连接后，对应的基岩版玩家的游戏ID会被立即给予白名单 ) 第三种方法是添加基岩版玩家的 UUID ( 由 Floodgate 生成 ) 添加到 whitelist.json 文件，然后执行 /whitelist reload 命令。
当使用 Floodgate 时，如何实现在玩家没有加入服务器的情况下查看他们的 UUID？
请尝试使用 此页面，如果这不起作用，请尝试下面这个方法：
首先，您需要获取基岩玩家的 XUID。 有几个第三方网站可以找到这个，例如 这个（与 Geyser 无关）。确保选择“十六进制”。 您需要输入玩家的 Xbox 名，并且一旦提交，它应该以 xxxxxxxxxxxxxxxx 的格式显示 XUID。 要把XUID变成Java版可以识别的UUID，需要把XUID写成这样的格式：00000000-0000-0000-xxxx-xxxxxxxxxxxx。如果格式正确，Java 版应该可以识别它并作为 UUID。
在使用 Floodgate 时，我能删除基岩玩家的前缀吗?
虽然您可以删除基岩版玩家前缀，但通常建议 不要删除 它，因为这可以防止出现两个版本中 玩家名称相同 的情况（例如：基岩版玩家名称：DJelly4K，Java 版玩家名称：DJelly4K）。由于 Floodgate 与 Java版服务端 的 UUID 生成规则不同，这导致虽然他们具有不同的 UUID，但是他们都有相同的游戏名称，从而可能导致与涉及玩家名称的指令发生 冲突。如果尝试删除基岩版玩家前缀只是为了使用指令，请尝试在游戏名称两边添加引号。示例：/tp ".<基岩版玩家>"。如果你执意要删除，那么基岩版玩家前缀的配置在 Floodgate 文件夹内的 config.yml 文件中的 username-prefix: 下，你可以将其修改为 "" 以删除。
要使用 Geyser 就必须安装 Floodgate 吗？
不。当你的服务器是 正版服务器 但你不希望基岩版玩家也需要 Java版正版账号 登录，那么这时你可以通过安装 Floodgate 实现这一愿望。但是如果你是正版服务器且也想要让基岩版玩家必须使用 Java 版正版账号或者你是盗版服务器，那么 Floodgate 不是强制需要你去安装的。
有时，世界跑的很远以后客户端会很卡.
这是 基岩版 客户端的问题。具体请 点击 这里查看。
我可以使用 Geyser 使得 Java 版玩家进入基岩版服务器吗?
不，Geyser 只是一个使得 基岩版玩家加入Java版服务器 的工具，你是怎么想到反着来也可以的？
我可以通过 Geyser 连接一个旧版本的服务器吗？
如果这个服务器安装了 ViaVersion 或者通过其他方法支持最新的 Minecraft 版本，那么，是的，你可以！但是，我们 不推荐 这么做！
我可以通过 Geyser 连接一个 Mod (Forge/Fabric) 服务器吗？
简单来说，如果你的服务器没有安装任何 客户端Mod，那么是可以的。
换句话说，如果你的服务器有 客户端Mod，那么 Geyser 目前无法翻译 Mod 所新增的 一切物品、方块等，因此，也就不受支持了。
如何实现自动更新 Geyser？
Geyser MC Auto Updater 是一个通过 命令行 更新 Geyser 的一个不错的方法，但你需要注意这不是 Geyser官方的项目。
GeyserUpdater (GitHub 页面/Spigot 页面) 是一个 Spigot/BungeeCord 插件，通过 插件 更新 Geyser 也是一个不错的方法。请注意这个插件同样不是 Geyser官方的项目，如果你需要支持，请联系他们的 Discord。
Geyser 支持哪些语言？
我们支持所有 基岩版 本身支持的语言。 点击 这里以查看我们的 Crowdin 页面。下面是所有语言和其对应的代码。我们同时也对基岩版本身不提供支持的语言提供额外支持，你可以在下面查看。 (客户端语言调整请查看 https://www.curseforge.com/minecraft/mc-addons/translations-for-minecraft)
基岩版支持的语言
额外提供支持的语言：
和游戏方面无关的问题
CubeCraft 和 Geyser 是什么关系？
Redned 最早在 2019年7月 开始 Geyser 的开发。在 2020年5月，CubeCraft 收购了 Geyser，这意味着他们有时也会参与 Geyser 的开发，并赞助 Geyser 团队。但他们不拥有 Geyser 代码。
CubeCraft 使用 Geyser 吗？
并不。CubeCraft 的双通是自己研发的。
常见问题
Geyser 是如何工作的？
Geyser 像一个翻译官那样工作，将传入和传出的数据包翻译为客户端和服务端（服务器） 都能理解的格式。这样说来，它模拟了 Minecraft Java版 客户端，因此服务器实际上认为您是从 Java版本 加入的。无论是什么服务器以及它安装了什么插件，您都可以将其与 Geyser 连接（只要服务器支持最新的Minecraft版本）。
红石是按照哪个版本工作的？
红石，还有 指令、农场 等各种机制都是按照 Java版 工作的。因为你加入的服务器是一个 Java版 服务器。
Geyser 是付费的吗?
不，Geyser 和 它的相关一切作品 都是 免费且开源的，且遵循 MIT 协议。
哪些插件不兼容 Geyser？
Geyser 应当和大部分 服务端插件 兼容，但总有例外，例如：
- TCPShield 如果你没有购买付费计划，需要关闭该插件的 only-allow-proxy-connections 选项。然而，如果你购买了付费计划，则无需担心，因为他们的付费计划有对 Geyser 添加额外支持。
Floodgate 与修改登录流程的插件不兼容。请务必注意以下各个支持离线登录的插件只是为了 Wiki 编写，Geyser 官方不对离线服务器提供帮助支持。
- DynamicBungeeAuth 使得基岩版玩家生成无效的登录请求。
- FastLogin 不让 Floodgate 为基岩版玩家添加前缀。
- ExploitFixer 认为 Floodgate 玩家使用 恶意UUID - 请关闭该插件的 uuidspoof 配置。
- JPremium 改变 Floodgate 玩家的 UUID，导致 Floodgate API 等可能存在异常。
- LibHatesMods 造成玩家无法登录，且报错： com.github.steveice10.mc.auth.exception.request.InvalidCredentialsException
- ProtocolSupport 虽然和 Floodgate兼容，但我们推荐使用 ViaBackwards。
- ProtocolSupportBungee 破坏 Floodgate 玩家登录流程，导致 Floodgate API 等可能存在异常。
- SayNoToMcLeaks 使得 Floodgate 玩家无法完成登录。
如果你发现其他不兼容情况，可通过 Discord 联系我们。
我应该使用哪个版本的 插件版Geyser？
- Geyser-Spigot 支持:
- Geyser-Bungee 支持:
- Geyser-Velocity 支持 Velocity
- Geyser-Sponge 支持 SpongeVanilla 或者 SpongeForge
Geyser-Spigot 支持什么版本?
支持 1.12.2 及更高版本。如果你的服务器比这个版本还低，请使用独立版。
如果我使用 BungeeCord，那么 Geyser/Floodgate 应该放置到哪?
你只需要在你的 BungeeCord 服务器安装 Geyser/Floodgate，这是在你的服务器不使用 Floodgate API 的情况下。如果不是这种情况，你还需要在每个子服都正确安装 Floodgate。
我应该给基岩版玩家什么 IP？
一般来说，如果你没有自己修改过，那么你的基岩版玩家连接你的服务器的IP应该和你的 Java版玩家 一样。至于端口，则根据你的 Geyser 配置下的 bedrock 下的 port 选项来决定。
我如何让基岩版玩家加载资源包？
你可以在 Geyser 下的 packs 文件夹放置资源包。基岩版客户端在加入服务器时会自动下载资源包。目前没有 Java-基岩 资源包自动转换 的功能，如果你需要转换资源包格式，请前往 https://rtm516.github.io/ConvertJavaTextureToBedrock/ 并把转换好的资源包放置在 Geyser 内。
基岩版玩家如何副手拿物品？
你可以使用指令 /geyser offhand 来进行 主手和副手 的切换。你也可以通过修改 Geyser 下的配置 (emote-offhand-workaround) 来使得基岩版通过游戏里的 表情 按钮来进行 主手和副手 的切换。
在使用 Floodgate 时，执行指令的玩家变量是什么？
如果基岩版玩家有前缀，所有指令的 必须 在名称中 包含该前缀 。Floodgate 还将名称中的所有 空格 替换为 下划线 ，因此在执行命令时请务必将所有空格替换为下划线。 如果这不起作用，请在名称周围加上双引号。
示例: /tp ".<基岩版玩家>"。
在使用 Floodgate 时，我该如何添加基岩版玩家到白名单内？
您可以通过三种方式执行此操作。 第一种方法是使用 Floodgate 的内置白名单命令，/fwhitelist add .<基岩版玩家>。 第二种方法是执行 /whitelist off 关闭白名单，然后让基岩版玩家加入，然后执行 /whitelist add ".<基岩版玩家>"指令，最后执行 /whitelist on 重新打开白名单。 ( 如果你使用了基岩版和Java版账号连接功能，那么你无需再为基岩版玩家设置白名单，在 Java版 玩家尝试申请连接后，对应的基岩版玩家的游戏ID会被立即给予白名单 ) 第三种方法是添加基岩版玩家的 UUID ( 由 Floodgate 生成 ) 添加到 whitelist.json 文件，然后执行 /whitelist reload 命令。
当使用 Floodgate 时，如何实现在玩家没有加入服务器的情况下查看他们的 UUID？
请尝试使用 此页面，如果这不起作用，请尝试下面这个方法：
首先，您需要获取基岩玩家的 XUID。 有几个第三方网站可以找到这个，例如 这个（与 Geyser 无关）。确保选择“十六进制”。 您需要输入玩家的 Xbox 名，并且一旦提交，它应该以 xxxxxxxxxxxxxxxx 的格式显示 XUID。 要把XUID变成Java版可以识别的UUID，需要把XUID写成这样的格式：00000000-0000-0000-xxxx-xxxxxxxxxxxx。如果格式正确，Java 版应该可以识别它并作为 UUID。
在使用 Floodgate 时，我能删除基岩玩家的前缀吗?
虽然您可以删除基岩版玩家前缀，但通常建议 不要删除 它，因为这可以防止出现两个版本中 玩家名称相同 的情况（例如：基岩版玩家名称：DJelly4K，Java 版玩家名称：DJelly4K）。由于 Floodgate 与 Java版服务端 的 UUID 生成规则不同，这导致虽然他们具有不同的 UUID，但是他们都有相同的游戏名称，从而可能导致与涉及玩家名称的指令发生 冲突。如果尝试删除基岩版玩家前缀只是为了使用指令，请尝试在游戏名称两边添加引号。示例：/tp ".<基岩版玩家>"。如果你执意要删除，那么基岩版玩家前缀的配置在 Floodgate 文件夹内的 config.yml 文件中的 username-prefix: 下，你可以将其修改为 "" 以删除。
要使用 Geyser 就必须安装 Floodgate 吗？
不。当你的服务器是 正版服务器 但你不希望基岩版玩家也需要 Java版正版账号 登录，那么这时你可以通过安装 Floodgate 实现这一愿望。但是如果你是正版服务器且也想要让基岩版玩家必须使用 Java 版正版账号或者你是盗版服务器，那么 Floodgate 不是强制需要你去安装的。
有时，世界跑的很远以后客户端会很卡.
这是 基岩版 客户端的问题。具体请 点击 这里查看。
我可以使用 Geyser 使得 Java 版玩家进入基岩版服务器吗?
不，Geyser 只是一个使得 基岩版玩家加入Java版服务器 的工具，你是怎么想到反着来也可以的？
我可以通过 Geyser 连接一个旧版本的服务器吗？
如果这个服务器安装了 ViaVersion 或者通过其他方法支持最新的 Minecraft 版本，那么，是的，你可以！但是，我们 不推荐 这么做！
我可以通过 Geyser 连接一个 Mod (Forge/Fabric) 服务器吗？
简单来说，如果你的服务器没有安装任何 客户端Mod，那么是可以的。
换句话说，如果你的服务器有 客户端Mod，那么 Geyser 目前无法翻译 Mod 所新增的 一切物品、方块等，因此，也就不受支持了。
如何实现自动更新 Geyser？
Geyser MC Auto Updater 是一个通过 命令行 更新 Geyser 的一个不错的方法，但你需要注意这不是 Geyser官方的项目。
GeyserUpdater (GitHub 页面/Spigot 页面) 是一个 Spigot/BungeeCord 插件，通过 插件 更新 Geyser 也是一个不错的方法。请注意这个插件同样不是 Geyser官方的项目，如果你需要支持，请联系他们的 Discord。
Geyser 支持哪些语言？
我们支持所有 基岩版 本身支持的语言。 点击 这里以查看我们的 Crowdin 页面。下面是所有语言和其对应的代码。我们同时也对基岩版本身不提供支持的语言提供额外支持，你可以在下面查看。 (客户端语言调整请查看 https://www.curseforge.com/minecraft/mc-addons/translations-for-minecraft)
基岩版支持的语言
| 语言名称 | 代码 |
| Bulgarian | bg_bg |
| Czech | cs_cz |
| Danish | da_dk |
| German | de_de |
| Greek | el_gr |
| British English | en_gb |
| American English | en_us |
| Spanish | es_es |
| Mexican Spanish | es_mx |
| Finnish | fi_fi |
| Canadian French | fr_ca |
| French | fr_fr |
| Hungarian | hu_hu |
| Indonesian | id_id |
| Italian | it_it |
| Japanese | ja_jp |
| Korean | ko_kr |
| Dutch | nl_nl |
| Norwegian Bokmål | nb_no |
| Polish | pl_pl |
| Brazilian Portuguese | pt_br |
| Portuguese | pt_pt |
| Russian | ru_ru |
| Slovak | sk_sk |
| Swedish | sv_se |
| Turkish | tr_tr |
| Ukrainian | uk_ua |
| Chinese Simplified (China) | zh_cn |
| Chinese Traditional (Taiwan) | zh_tw |
额外提供支持的语言：
| 语言名称 | 代码 |
| Afrikaans | af_za |
| Belarusian | be_by |
| Hebrew | he_il |
| Hindi | hi_in |
和游戏方面无关的问题
CubeCraft 和 Geyser 是什么关系？
Redned 最早在 2019年7月 开始 Geyser 的开发。在 2020年5月，CubeCraft 收购了 Geyser，这意味着他们有时也会参与 Geyser 的开发，并赞助 Geyser 团队。但他们不拥有 Geyser 代码。
CubeCraft 使用 Geyser 吗？
并不。CubeCraft 的双通是自己研发的。
本帖最后由 pXiaoD 于 2021-12-29 18:24 编辑
理解配置
这个页面主要为你介绍 Geyser 配置各个选项的作用，尽管配置文件中已经介绍，我们还在这里为你带来更详细的讲解。
基岩版部分
这些选项适用于 Geyser 基岩端方面。
address: Geyser 所开启的地址。一般情况下，你不需要修改这里，保持原样即可。
port: Geyser 所开启的端口。默认和基岩版的默认端口一样，为 19132。
clone-remote-port: 服务器每次开启时，Geyser 所开启的端口和 Java版服务器是否保持一致。独立版无法使用此选项。
motd1: Geyser 所开启的服务器显示的 MOTD 的第一行。
motd2: Geyser 所开启的服务器显示的 MOTD 的第二行。请务必注意该选项只在基岩版客户端 好友 选项卡显示 Geyser 服务器时有效。
server-name: 基岩版客户端在 暂停页面 所显示的世界名称。
compression-level: 一个数字值，表示压缩传出流量的程度。 可以是 -1 到 9 之间的任意数字；任何其他值都将替换为最接近的可接受值。数字越大，使用的 CPU 处理越多，但使用的 带宽 越少。
远程服务器部分 (Java版 部分)
这些选项适用于 Java 版服务器。
address: 你所要连接的 Minecraft:Java 版服务器的地址。默认情况下，这个选项被设置为 auto。如果一直设置为 auto，那么 Geyser 会自动同步 Java版服务器 的 IP、端口和Floodgate配置信息。在独立版，将其设置为 auto 将代表设置成 127.0.0.1。
port: 你在 address 选项所要连接的 Minecraft:Java 版服务器的端口。
auth-type: 登录到 Minecraft:Java 版服务器的方式，包括 online, offline和 floodgate。
请务必注意您的 auth-type 选项必须和对应 Java 版服务器保持一致 (除了你的 Java 版服务器是盗版服务器，而你在这里设置为正版的情况)。尝试不用正版登录方式进入正版服务器是行不通的。如果你希望你的正版服务器的基岩版玩家无需使用 Java正版账号 登录，请查看 Floodgate Wiki。
use-proxy-protocol: 是否在连接到服务器时使用 PROXY/HAProxy 协议，这一般在以下情况有用：
forward-hostname: 是否将 Geyser 服务器的 IP/端口 和 Java版服务器 保持一致。
通用选项
通用选项一般适用于 Geyser 本身的修改。
floodgate-key-file: Floodgate 生成的 key 文件的路径。你必须安装 Floodgate 且 auth-type 选项设置成 floodgate。
userAuths: 一个放置你自己的 Minecraft:Java版 正版账号的选项，这样你每次登录 Geyser 服务器将会自动进入服务器，不需要输入你的正版账号信息。 我只建议你在个人使用 Geyser 时配置此选项，我想没人会愿意把自己的正版账号共享给其他人使用。
如果你的 Xbox 账号名称是 Notch，你的 Java版正版账号 的邮箱地址是s[email protected] 然后你的密码是 hunter2 ，那么你就需要按下面这样的格式填写配置:
复制代码
账号名称前面是两个空格，email 等前面是四个空格。
command-suggestions: 如果你的服务器指令提示太多，基岩版客户端在玩家首次打开聊天框并输入指令时会出现卡顿或者崩溃。这个配置选项可以根本指令提示功能，以解决卡顿问题。自从 1.16.100 版本更新后: 指令提示造成的崩溃问题已经大幅度解决，在大多数情况下你不需要关闭这个选项。
passthrough-motd: 是否直接显示 Java 版服务器的 MOTD。如果设置为是，那么 motd1 和 motd2 选项在 基岩版客户端 的 MOTD不会显示。
passthrough-protocol-name: 是否直接显示自定义的 Java 版自定义版本信息。 (例如 BungeeCord [X.X], Paper 1.X) - 这通常在你的Java版服务器使用自定义版本信息功能情况下才有用，如果你不知道你的服务器是否有使用相关功能，你可以前往 MCSrvStatus 查看你的服务器版本信息以确认。<mcsrvstat.us>
passthrough-players: 是否直接显示 Java 版服务器的人数。
legacy-ping-passthrough: 如果启用，则通过模拟 Minecraft 客户端而不是使用服务器的 API 手动 ping 服务器。你应当 **_只在你_ 的MOTD人数不正确情况下再考虑开启此选项。由于这个选项开启通常会在 **BungeeCord 等上出现问题。此选项在独立版无效。
ping-passthrough-interval: 虚拟的 Minecraft 客户端应该尝试 ping 远Java版服务器以更新信息的频率，以秒为单位（设置为 1 将每秒 ping 一次服务器；设置为 3 将每三秒 ping 一次服务器）。 仅与独立和传统 ping 直通相关。 如果您遇到超时或 BrokenPipe 错误，请增加该数字。
max-players: 在 ping Geyser服务器时显示的最多玩家数量。这个选项实际上不是真的去限制玩家上限。当服务器玩家满员时，人数上限也会跟着提升，而基岩版客户端本身在检测到服务器满员时会直接不尝试连接到服务器。
debug-mode: debug 信息是否在控制台输出。这在你遇到错误或者需要技术信息时有用。
general-thread-pool: Geyser 将能够使用的线程数量。越高并不总是代表越好 :P。
allow-third-party-capes: 是否为基岩版玩家显示第三方 (Optifine, 5zig, LabyMod等) 的披风。
allow-third-party-ears: 是否为基岩版玩家显示第三方 Deadmau5-style ears。目前只支持 MinecraftCapes。
show-cooldown: 基岩版客户端目前并没有 Java版 1.9+ 的 PvP 机制。为了解决这个问题，Geyser 发送虚假的 Title 以代替攻击冷却条。如果你的服务器使用 1.8 的 PvP 机制，那么此攻击冷却条将不会显示。此选项可以填写 false (不发送攻击冷却条)， title/true (以 Title 形式显示攻击冷却条)，或者actionbar (以底部条显示攻击冷却条)。填写其他值等于填写 false。
show-coordinates: 基岩版有一个可以在屏幕的左上角显示坐标的选项。 此选项启用或禁用此功能。
emote-offhand-workaround: 从 Java 版 1.9 开始，客户端可以使用所设置的按键 在主手和副手中切换物品（默认是 F）。基岩版没有这个功能，所以这个选项弥补了它。如果设置，当基岩版玩家使用任意表情时，他就会交换副手和主手物品，就像Java版的一样。 这里可以填写为三个值：
default-locale: 如果无法查找玩家的语言，那么 Geyser 给玩家设置的语言。点击这里 以查看你的语言的代码。
chunk-caching: 为每位基岩版玩家提供区块缓存，这将以增加 RAM 内存为代价而带来 额外音效支持和修复移动问题。在 Spigot 上使用将会始终启用此选项，因为我们可以使用服务器的 API 来获取区块信息而没有其他任何增加的资源损耗。 Geyser 不推荐你关闭这个选项。
cache-images: 指定图片将被缓存到本地的天数以节省从 互联网 下载它们的时间。 如果设置成 0 则是被禁用。（默认值：0）
allow-custom-skulls: 允许 Geyser 翻译自定义头颅皮肤。这会在一些低端/老的设备上造成严重的卡顿问题。
above-nether-bedrock-building: 基岩版的下界最高高度是127，玩家无法在 128 格以上高度放置方块 - 开启这个选项以后，Geyser 会把下界维度翻译成末地维度，虽然这么做会导致下界的天空是末地的样子，但目前只能通过这种方法解决你在下界放置 128 格以上高度放置方块的问题。
force-resource-packs: 如果 Geyser 加载了资源包，那么将强制玩家使用改资源包。如果设置为 false，那么玩家可以拒绝该资源包并断开与服务器的连接。
xbox-achievements-enabled: 是否在玩家游戏时解锁 Xbox 成就。这将导致你的服务器的指定指令无法使用，因为”作弊“选项将会被关闭。该如果开启，像 /gamemode 和 /give 这样的指令在基岩版将无法使用。
高级选项
scoreboard-packet-threshold: Geyser 会在每个记分板数据包之后更新记分板，但是当 Geyser 试图每秒处理大量记分板数据包时会导致严重的延迟。 此选项允许您指定在每秒多少个计分板数据包之后，计分板更新将被限制到每秒四次更新。
enable-proxy-connections: 允许来自 ProxyPass 和 Waterdog 的连接。 查看 https://www.spigotmc.org/wiki/firewall-guide/ 以获取帮助 - 使用 UDP 而不是 TCP。如果你使用 BungeeCord 或者 Velocity 这样的代理端，则不需要开启本选项。
mtu: https://en.wikipedia.org/wiki/Maximum_transmission_unit -互联网支持的最大 MTU 为 1492，但可能会导致数据包碎片问题。 1400 是默认值。
use-direct-connection: 是否直接连接到 Java 服务器而不创建 TCP 连接。只有当某个插件的数据包或网络无法与 Geyser 正常工作时，才应关闭此功能。 如果在插件版本上启用，Java版服务器地址和端口部分将被忽略。 如果在插件版本上禁用，将会导致性能会下降，延迟会增加。
默认 Geyser 配置：
复制代码
理解配置
这个页面主要为你介绍 Geyser 配置各个选项的作用，尽管配置文件中已经介绍，我们还在这里为你带来更详细的讲解。
基岩版部分
这些选项适用于 Geyser 基岩端方面。
address: Geyser 所开启的地址。一般情况下，你不需要修改这里，保持原样即可。
port: Geyser 所开启的端口。默认和基岩版的默认端口一样，为 19132。
clone-remote-port: 服务器每次开启时，Geyser 所开启的端口和 Java版服务器是否保持一致。独立版无法使用此选项。
motd1: Geyser 所开启的服务器显示的 MOTD 的第一行。
motd2: Geyser 所开启的服务器显示的 MOTD 的第二行。请务必注意该选项只在基岩版客户端 好友 选项卡显示 Geyser 服务器时有效。
server-name: 基岩版客户端在 暂停页面 所显示的世界名称。
compression-level: 一个数字值，表示压缩传出流量的程度。 可以是 -1 到 9 之间的任意数字；任何其他值都将替换为最接近的可接受值。数字越大，使用的 CPU 处理越多，但使用的 带宽 越少。
远程服务器部分 (Java版 部分)
这些选项适用于 Java 版服务器。
address: 你所要连接的 Minecraft:Java 版服务器的地址。默认情况下，这个选项被设置为 auto。如果一直设置为 auto，那么 Geyser 会自动同步 Java版服务器 的 IP、端口和Floodgate配置信息。在独立版，将其设置为 auto 将代表设置成 127.0.0.1。
port: 你在 address 选项所要连接的 Minecraft:Java 版服务器的端口。
auth-type: 登录到 Minecraft:Java 版服务器的方式，包括 online, offline和 floodgate。
请务必注意您的 auth-type 选项必须和对应 Java 版服务器保持一致 (除了你的 Java 版服务器是盗版服务器，而你在这里设置为正版的情况)。尝试不用正版登录方式进入正版服务器是行不通的。如果你希望你的正版服务器的基岩版玩家无需使用 Java正版账号 登录，请查看 Floodgate Wiki。
use-proxy-protocol: 是否在连接到服务器时使用 PROXY/HAProxy 协议，这一般在以下情况有用：
- 你的服务器支持 PROXY 协议（大多数情况下是不支持的）。
- 你的 Java 版服务器使用 Velocity 或者 BungeeCord 代理端并且其对应配置也是开启的。
forward-hostname: 是否将 Geyser 服务器的 IP/端口 和 Java版服务器 保持一致。
通用选项
通用选项一般适用于 Geyser 本身的修改。
floodgate-key-file: Floodgate 生成的 key 文件的路径。你必须安装 Floodgate 且 auth-type 选项设置成 floodgate。
userAuths: 一个放置你自己的 Minecraft:Java版 正版账号的选项，这样你每次登录 Geyser 服务器将会自动进入服务器，不需要输入你的正版账号信息。 我只建议你在个人使用 Geyser 时配置此选项，我想没人会愿意把自己的正版账号共享给其他人使用。
如果你的 Xbox 账号名称是 Notch，你的 Java版正版账号 的邮箱地址是s[email protected] 然后你的密码是 hunter2 ，那么你就需要按下面这样的格式填写配置:
- userAuths:
- Notch: # MCPE/Xbox 账号名称
- email: [email protected]
- password: "hunter2"
- microsoft-account: true
账号名称前面是两个空格，email 等前面是四个空格。
command-suggestions: 如果你的服务器指令提示太多，基岩版客户端在玩家首次打开聊天框并输入指令时会出现卡顿或者崩溃。这个配置选项可以根本指令提示功能，以解决卡顿问题。自从 1.16.100 版本更新后: 指令提示造成的崩溃问题已经大幅度解决，在大多数情况下你不需要关闭这个选项。
passthrough-motd: 是否直接显示 Java 版服务器的 MOTD。如果设置为是，那么 motd1 和 motd2 选项在 基岩版客户端 的 MOTD不会显示。
passthrough-protocol-name: 是否直接显示自定义的 Java 版自定义版本信息。 (例如 BungeeCord [X.X], Paper 1.X) - 这通常在你的Java版服务器使用自定义版本信息功能情况下才有用，如果你不知道你的服务器是否有使用相关功能，你可以前往 MCSrvStatus 查看你的服务器版本信息以确认。<mcsrvstat.us>
passthrough-players: 是否直接显示 Java 版服务器的人数。
legacy-ping-passthrough: 如果启用，则通过模拟 Minecraft 客户端而不是使用服务器的 API 手动 ping 服务器。你应当 **_只在你_ 的MOTD人数不正确情况下再考虑开启此选项。由于这个选项开启通常会在 **BungeeCord 等上出现问题。此选项在独立版无效。
ping-passthrough-interval: 虚拟的 Minecraft 客户端应该尝试 ping 远Java版服务器以更新信息的频率，以秒为单位（设置为 1 将每秒 ping 一次服务器；设置为 3 将每三秒 ping 一次服务器）。 仅与独立和传统 ping 直通相关。 如果您遇到超时或 BrokenPipe 错误，请增加该数字。
max-players: 在 ping Geyser服务器时显示的最多玩家数量。这个选项实际上不是真的去限制玩家上限。当服务器玩家满员时，人数上限也会跟着提升，而基岩版客户端本身在检测到服务器满员时会直接不尝试连接到服务器。
debug-mode: debug 信息是否在控制台输出。这在你遇到错误或者需要技术信息时有用。
general-thread-pool: Geyser 将能够使用的线程数量。越高并不总是代表越好 :P。
allow-third-party-capes: 是否为基岩版玩家显示第三方 (Optifine, 5zig, LabyMod等) 的披风。
allow-third-party-ears: 是否为基岩版玩家显示第三方 Deadmau5-style ears。目前只支持 MinecraftCapes。
show-cooldown: 基岩版客户端目前并没有 Java版 1.9+ 的 PvP 机制。为了解决这个问题，Geyser 发送虚假的 Title 以代替攻击冷却条。如果你的服务器使用 1.8 的 PvP 机制，那么此攻击冷却条将不会显示。此选项可以填写 false (不发送攻击冷却条)， title/true (以 Title 形式显示攻击冷却条)，或者actionbar (以底部条显示攻击冷却条)。填写其他值等于填写 false。
show-coordinates: 基岩版有一个可以在屏幕的左上角显示坐标的选项。 此选项启用或禁用此功能。
emote-offhand-workaround: 从 Java 版 1.9 开始，客户端可以使用所设置的按键 在主手和副手中切换物品（默认是 F）。基岩版没有这个功能，所以这个选项弥补了它。如果设置，当基岩版玩家使用任意表情时，他就会交换副手和主手物品，就像Java版的一样。 这里可以填写为三个值：
- disabled - 默认值，不使用此解决方案
- no-emotes - 表情将不会发送给其他基岩版玩家，同时进行主手和副手的切换物品。这也代表表情功能在 Geyser服务器 中关闭。
- emotes-and-offhand - 表情发送给其他基岩版玩家同时也会进行主手和副手切换物品
default-locale: 如果无法查找玩家的语言，那么 Geyser 给玩家设置的语言。点击这里 以查看你的语言的代码。
chunk-caching: 为每位基岩版玩家提供区块缓存，这将以增加 RAM 内存为代价而带来 额外音效支持和修复移动问题。在 Spigot 上使用将会始终启用此选项，因为我们可以使用服务器的 API 来获取区块信息而没有其他任何增加的资源损耗。 Geyser 不推荐你关闭这个选项。
cache-images: 指定图片将被缓存到本地的天数以节省从 互联网 下载它们的时间。 如果设置成 0 则是被禁用。（默认值：0）
allow-custom-skulls: 允许 Geyser 翻译自定义头颅皮肤。这会在一些低端/老的设备上造成严重的卡顿问题。
above-nether-bedrock-building: 基岩版的下界最高高度是127，玩家无法在 128 格以上高度放置方块 - 开启这个选项以后，Geyser 会把下界维度翻译成末地维度，虽然这么做会导致下界的天空是末地的样子，但目前只能通过这种方法解决你在下界放置 128 格以上高度放置方块的问题。
force-resource-packs: 如果 Geyser 加载了资源包，那么将强制玩家使用改资源包。如果设置为 false，那么玩家可以拒绝该资源包并断开与服务器的连接。
xbox-achievements-enabled: 是否在玩家游戏时解锁 Xbox 成就。这将导致你的服务器的指定指令无法使用，因为”作弊“选项将会被关闭。该如果开启，像 /gamemode 和 /give 这样的指令在基岩版将无法使用。
高级选项
scoreboard-packet-threshold: Geyser 会在每个记分板数据包之后更新记分板，但是当 Geyser 试图每秒处理大量记分板数据包时会导致严重的延迟。 此选项允许您指定在每秒多少个计分板数据包之后，计分板更新将被限制到每秒四次更新。
enable-proxy-connections: 允许来自 ProxyPass 和 Waterdog 的连接。 查看 https://www.spigotmc.org/wiki/firewall-guide/ 以获取帮助 - 使用 UDP 而不是 TCP。如果你使用 BungeeCord 或者 Velocity 这样的代理端，则不需要开启本选项。
mtu: https://en.wikipedia.org/wiki/Maximum_transmission_unit -
use-direct-connection: 是否直接连接到 Java 服务器而不创建 TCP 连接。只有当某个插件的数据包或网络无法与 Geyser 正常工作时，才应关闭此功能。 如果在插件版本上启用，Java版服务器地址和端口部分将被忽略。 如果在插件版本上禁用，将会导致性能会下降，延迟会增加。
默认 Geyser 配置：
- # --------------------------------
- # Geyser Configuration File
- #
- # A bridge between Minecraft: Bedrock Edition and Minecraft: Java Edition.
- #
- # GitHub: https://github.com/GeyserMC/Geyser
- # Discord: https://discord.geysermc.org/
- # --------------------------------
- bedrock:
- # The IP address that will listen for connections.
- # There is no reason to change this unless you want to limit what IPs can connect to your server.
- address: 0.0.0.0
- # The port that will listen for connections
- port: 19132
- # Some hosting services change your Java port everytime you start the server and require the same port to be used for Bedrock.
- # This option makes the Bedrock port the same as the Java port every time you start the server.
- # This option is for the plugin version only.
- clone-remote-port: false
- # The MOTD that will be broadcasted to Minecraft: Bedrock Edition clients. This is irrelevant if "passthrough-motd" is set to true
- # If either of these are empty, the respective string will default to "Geyser"
- motd1: "Geyser"
- motd2: "Another Geyser server."
- # The Server Name that will be sent to Minecraft: Bedrock Edition clients. This is visible in both the pause menu and the settings menu.
- server-name: "Geyser"
- # How much to compress network traffic to the Bedrock client. The higher the number, the more CPU usage used, but
- # the smaller the bandwidth used. Does not have any effect below -1 or above 9. Set to -1 to disable.
- compression-level: 6
- # Whether to enable PROXY protocol or not for clients. You DO NOT WANT this feature unless you run UDP reverse proxy
- # in front of your Geyser instance.
- enable-proxy-protocol: false
- # A list of allowed PROXY protocol speaking proxy IP addresses/subnets. Only effective when "enable-proxy-protocol" is enabled, and
- # should really only be used when you are not able to use a proper firewall (usually true with shared hosting providers etc.).
- # Keeping this list empty means there is no IP address whitelist.
- # Both IP addresses and subnets are supported.
- #proxy-protocol-whitelisted-ips: [ "127.0.0.1", "172.18.0.0/16" ]
- remote:
- # The IP address of the remote (Java Edition) server
- # If it is "auto", for standalone version the remote address will be set to 127.0.0.1,
- # for plugin versions, it is recommended to keep this as "auto" so Geyser will automatically configure address, port, and auth-type.
- address: auto
- # The port of the remote (Java Edition) server
- # For plugin versions, if address has been set to "auto", the port will also follow the server's listening port.
- port: 25565
- # Authentication type. Can be offline, online, or floodgate (see https://github.com/GeyserMC/Geyser/wiki/Floodgate).
- # For plugin versions, it's recommended to keep the `address` field to "auto" so Floodgate support is automatically configured.
- auth-type: online
- # Allow for password-based authentication methods through Geyser. Only useful in online mode.
- # If this is false, users must authenticate to Microsoft using a code provided by Geyser on their desktop.
- allow-password-authentication: true
- # Whether to enable PROXY protocol or not while connecting to the server.
- # This is useful only when:
- # 1) Your server supports PROXY protocol (it probably doesn't)
- # 2) You run Velocity or BungeeCord with the option enabled in the proxy's main config.
- # IF YOU DON'T KNOW WHAT THIS IS, DON'T TOUCH IT!
- use-proxy-protocol: false
- # Forward the hostname that the Bedrock client used to connect over to the Java server
- # This is designed to be used for forced hosts on proxies
- forward-hostname: false
- # Allows the overworld world height to be extended from 0 - 255 to -64 - 319. This option cannot be changed during a reload.
- # 1.17.0-1.17.2 Bedrock clients cannot connect with this option enabled.
- # Performance issues and/or additional bugs may occur for Bedrock clients as this is an experimental toggle on their end.
- extended-world-height: false
- # Floodgate uses encryption to ensure use from authorised sources.
- # This should point to the public key generated by Floodgate (BungeeCord, Spigot or Velocity)
- # You can ignore this when not using Floodgate.
- # If you're using a plugin version of Floodgate on the same server, the key will automatically be picked up from Floodgate.
- floodgate-key-file: key.pem
- # The Xbox/Minecraft Bedrock username is the key for the Java server auth-info.
- # This allows automatic configuration/login to the remote Java server.
- # If you are brave enough to put your Mojang account info into a config file.
- # Uncomment the lines below to enable this feature.
- #userAuths:
- # BedrockAccountUsername: # Your Minecraft: Bedrock Edition username
- # email: [email protected] # Your Minecraft: Java Edition email
- # password: javaccountpassword123 # Your Minecraft: Java Edition password
- # microsoft-account: true # Whether the account is a Mojang or Microsoft account.
- #
- # bluerkelp2:
- # email: [email protected]
- # password: "this isn't really my password"
- # microsoft-account: false
- # Bedrock clients can freeze when opening up the command prompt for the first time if given a lot of commands.
- # Disabling this will prevent command suggestions from being sent and solve freezing for Bedrock clients.
- command-suggestions: true
- # The following three options enable "ping passthrough" - the MOTD, player count and/or protocol name gets retrieved from the Java server.
- # Relay the MOTD from the remote server to Bedrock players.
- passthrough-motd: false
- # Relay the protocol name (e.g. BungeeCord [X.X], Paper 1.X) - only really useful when using a custom protocol name!
- # This will also show up on sites like MCSrvStatus. <mcsrvstat.us>
- passthrough-protocol-name: false
- # Relay the player count and max players from the remote server to Bedrock players.
- passthrough-player-counts: false
- # Enable LEGACY ping passthrough. There is no need to enable this unless your MOTD or player count does not appear properly.
- # This option does nothing on standalone.
- legacy-ping-passthrough: false
- # How often to ping the remote server, in seconds. Only relevant for standalone or legacy ping passthrough.
- # Increase if you are getting BrokenPipe errors.
- ping-passthrough-interval: 3
- # Whether to forward player ping to the server. While enabling this will allow Bedrock players to have more accurate
- # ping, it may also cause players to time out more easily.
- forward-player-ping: false
- # Maximum amount of players that can connect. This is only visual at this time and does not actually limit player count.
- max-players: 100
- # If debug messages should be sent through console
- debug-mode: false
- # Thread pool size
- general-thread-pool: 32
- # Allow third party capes to be visible. Currently allowing:
- # OptiFine capes, LabyMod capes, 5Zig capes and MinecraftCapes
- allow-third-party-capes: true
- # Allow third party deadmau5 ears to be visible. Currently allowing:
- # MinecraftCapes
- allow-third-party-ears: false
- # Allow a fake cooldown indicator to be sent. Bedrock players do not see a cooldown as they still use 1.8 combat
- # Can be title, actionbar or false
- show-cooldown: title
- # Controls if coordinates are shown to players.
- show-coordinates: true
- # If set, when a Bedrock player performs any emote, it will swap the offhand and mainhand items, just like the Java Edition keybind
- # There are three options this can be set to:
- # disabled - the default/fallback, which doesn't apply this workaround
- # no-emotes - emotes will NOT be sent to other Bedrock clients and offhand will be swapped. This effectively disables all emotes from being seen.
- # emotes-and-offhand - emotes will be sent to Bedrock clients and offhand will be swapped
- emote-offhand-workaround: "disabled"
- # The default locale if we dont have ** the client requested. Uncomment to not use the default system language.
- # default-locale: en_us
- # Specify how many days images will be cached to disk to save downloading them from the internet.
- # A value of 0 is disabled. (Default: 0)
- cache-images: 0
- # Allows custom skulls to be displayed. Keeping them enabled may cause a performance decrease on older/weaker devices.
- allow-custom-skulls: true
- # Whether to add (at this time, only) the furnace minecart as a separate item in the game, which normally does not exist in Bedrock Edition.
- # This should only need to be disabled if using a proxy that does not use the "transfer packet" style of server switching.
- # If this is disabled, furnace minecart items will be mapped to hopper minecart items.
- # This option requires a restart of Geyser in order to change its setting.
- add-non-bedrock-items: true
- # Bedrock prevents building and displaying blocks above Y127 in the Nether -
- # enabling this config option works around that by changing the Nether dimension ID
- # to the End ID. The main downside to this is that the sky will resemble that of
- # the end sky in the nether, but ultimately it's the only way for this feature to work.
- above-bedrock-nether-building: false
- # Force clients to load all resource packs if there are any.
- # If set to false, it allows the user to connect to the server even if they don't
- # want to download the resource packs.
- force-resource-packs: true
- # Allows Xbox achievements to be unlocked.
- # THIS DISABLES ALL COMMANDS FROM SUCCESSFULLY RUNNING FOR BEDROCK IN-GAME, as otherwise Bedrock thinks you are cheating.
- xbox-achievements-enabled: false
- # bStats is a stat tracker that is entirely anonymous and tracks only basic information
- # about Geyser, such as how many people are online, how many servers are using Geyser,
- # what OS is being used, etc. You can learn more about bStats here: https://bstats.org/.
- # https://bstats.org/plugin/server-implementation/GeyserMC
- metrics:
- # If metrics should be enabled
- enabled: true
- # UUID of server, don't change!
- uuid: generateduuid
- # ADVANCED OPTIONS - DO NOT TOUCH UNLESS YOU KNOW WHAT YOU ARE DOING!
- # Geyser updates the Scoreboard after every Scoreboard packet, but when Geyser tries to handle
- # a lot of scoreboard packets per second can cause serious lag.
- # This option allows you to specify after how many Scoreboard packets per seconds
- # the Scoreboard updates will be limited to four updates per second.
- scoreboard-packet-threshold: 20
- # Allow connections from ProxyPass and Waterdog.
- # See https://www.spigotmc.org/wiki/firewall-guide/ for assistance - use UDP instead of TCP.
- enable-proxy-connections: false
- # The internet supports a maximum MTU of 1492 but could cause issues with packet fragmentation.
- # 1400 is the default.
- # mtu: 1400
- # Whether to connect directly into the Java server without creating a TCP connection.
- # This should only be disabled if a plugin that interfaces with packets or the network does not work correctly with Geyser.
- # If enabled on plugin versions, the remote address and port sections are ignored
- # If disabled on plugin versions, expect performance decrease and latency increase
- use-direct-connection: true
- config-version: 4
独立版命令行参数
通用命令行参数
--config [文件路径]
简写: -c
指定一个路径下的 config.yml 文件使用。
--gui / --nogui
简写: gui / nogui
强制使用图形化页面启动/强制不使用图形化页面启动。
重写特定配置选项
通过重写特定配置选项，Geyser 直接优先读取参数内的配置，无视 config.yml 内对应的配置。
重写一个标准配置选项 (例如 command-suggestions):
--command-suggestions=false
重写一个嵌套配置选项(例如 remote 下的 address):
--remote.address=test.geysermc.org
通用命令行参数
--config [文件路径]
简写: -c
指定一个路径下的 config.yml 文件使用。
--gui / --nogui
简写: gui / nogui
强制使用图形化页面启动/强制不使用图形化页面启动。
重写特定配置选项
通过重写特定配置选项，Geyser 直接优先读取参数内的配置，无视 config.yml 内对应的配置。
重写一个标准配置选项 (例如 command-suggestions):
--command-suggestions=false
重写一个嵌套配置选项(例如 remote 下的 address):
--remote.address=test.geysermc.org
本帖最后由 pXiaoD 于 2021-12-28 22:38 编辑
指令
指令
反作弊兼容
请注意，这是由社区维护的列表，它不是很准确，也不是那么完整。如果你像修改这里，请随意。
反作弊兼容报告
完美支持 (能够很好的检测基岩版玩家)
部分支持 (它们只是给基岩版玩家绕过)
不兼容 (基岩版玩家会被视为作弊玩家)
请注意，这是由社区维护的列表，它不是很准确，也不是那么完整。如果你像修改这里，请随意。
反作弊兼容报告
完美支持 (能够很好的检测基岩版玩家)
部分支持 (它们只是给基岩版玩家绕过)
- AAC
- Flappy Anticheat
- Matrix
- Spartan (Spartan Syn 提供额外的基岩版玩家检测功能，但你需要额外花费 $43)
- Vulcan
不兼容 (基岩版玩家会被视为作弊玩家)
在游戏主机上使用 Geyser
所有的游戏主机版本客户端都可以加入第三方服务器 - 包括 Geyser 的服务器。像 Xbox One，Nintendo Switch 和 PS4 系统的玩家可以通过一个名为 BedrockConnect 的第三方软件进入第三方服务器。要获取该项目的技术信息或者如何搭建该软件，请查看 他们的 GitHub 页面 (这个项目不隶属于 GeyserMC)。没有其他替代的方法以解决此问题。
Xbox One
(请见原Wiki)
Nintendo Switch
(请见原Wiki)
PlayStation 4
(请见原Wiki)
可替**法
如果您更愿意尝试在另一台设备上的网络上模拟 LAN 连接，请按照以下方法进行操作。
请注意这个办法不适用于 Nintendo Switch。
使用PC
如果你拥有一个 PC，那么你可以使用 Phantom。
使用一个安卓设备
如果你拥有一个安卓设备，那么你有很多选择：
使用一个 iOS 设备
如果你拥有一个 iOS 14+ 设备，那么你可以使用 BedrockTogether。
所有的游戏主机版本客户端都可以加入第三方服务器 - 包括 Geyser 的服务器。像 Xbox One，Nintendo Switch 和 PS4 系统的玩家可以通过一个名为 BedrockConnect 的第三方软件进入第三方服务器。要获取该项目的技术信息或者如何搭建该软件，请查看 他们的 GitHub 页面 (这个项目不隶属于 GeyserMC)。没有其他替代的方法以解决此问题。
Xbox One
(请见原Wiki)
Nintendo Switch
(请见原Wiki)
PlayStation 4
(请见原Wiki)
可替**法
如果您更愿意尝试在另一台设备上的网络上模拟 LAN 连接，请按照以下方法进行操作。
请注意这个办法不适用于 Nintendo Switch。
使用PC
如果你拥有一个 PC，那么你可以使用 Phantom。
使用一个安卓设备
如果你拥有一个安卓设备，那么你有很多选择：
使用一个 iOS 设备
如果你拥有一个 iOS 14+ 设备，那么你可以使用 BedrockTogether。
本帖最后由 pXiaoD 于 2021-12-29 18:30 编辑
当前限制
Geyser 是两个不同版本游戏的协议转换器，但很遗憾的是，Geyser 仍有一些无法解决的限制。虽然 Minecraft 基岩版 和 Java版 看起来在很多地方是一致的，但它们在某些领域上仍有巨大的差异。
除非 Java版或者基岩版 协议进行更新或者修改，否则下列限制 Geyser 永远无法修复：
下面的限制 可以通过 使用 GeyserOptionalPack 解决，它是一个资源包：
当前限制
Geyser 是两个不同版本游戏的协议转换器，但很遗憾的是，Geyser 仍有一些无法解决的限制。虽然 Minecraft 基岩版 和 Java版 看起来在很多地方是一致的，但它们在某些领域上仍有巨大的差异。
除非 Java版或者基岩版 协议进行更新或者修改，否则下列限制 Geyser 永远无法修复：
在背包内显示 玩家头颅 皮肤
聊天框内的 可点击信息
发光效果
在 创造模式 中使用 2x2 合成
在背包内区分基岩版玩家的 左键和右键
红石粉非点形状
一些方块 的 "无法放置/破坏" 标签 - 例如，不同颜色的羊毛、粘土
通过 NBT 赋予颜色的药水
不使用 Minecraft Brigadier 库的命令的命令补充提示
任何在聊天框依赖 Tab 补充和直接发送的UI
无法查看叠加超过 6 种图案的旗帜
由于 Java版 和 基岩版 之间的差异，玩家在竹子周围存在移动问题。下面的插件可解决此问题，但请在使用前阅读 README：https://github.com/Camotoy/BambooCollisionFix
自定义铁砧配方
主世界维度最低高度低于 -64 或者最高高度高于 320 、在其他维度最低高度低于 0 或者最高高度高于 256。
海豚的恩惠视觉效果（药水效果本身可以正常工作）
隐形物品展示框
实体头上的方块（例如盔甲架、玩家）
下面的限制 可以通过 使用 GeyserOptionalPack 解决，它是一个资源包：
自定义盔甲架姿势
幻术师
铁傀儡受伤后”裂开“纹理
击打粒子和其他基岩版原版不存在的粒子
副手动画
潜影贝隐形
光灵箭纹理
本帖最后由 pXiaoD 于 2021-12-29 12:27 编辑
Floodgate Wiki
这是另外一个 Wiki 项目，请到 Gitbook 查看。
本贴由于排版问题，暂不列出。
Floodgate Wiki
这是另外一个 Wiki 项目，请到 Gitbook 查看。
本贴由于排版问题，暂不列出。
Geyser-Farbic
点击这里下载
就大部分方面而言，Geyser-Farbic和其他平台的版本一致。下面是几个区别：
该项目的源代码可以在 这里查看。
permissions.yml
位于 config/Geyser-Fabric 目录下的文件控制哪些指令可以被非 OP 玩家使用（基岩版和Java版玩家都是）。您可以将您想要让玩家使用的指令取消注释以使得非OP玩家正常使用。
为什么要单独分开一个源代码库？
点击这里下载
就大部分方面而言，Geyser-Farbic和其他平台的版本一致。下面是几个区别：
- Geyser-Fabric 安装在 mods 文件夹，它的配置文件应当在你的服务器的根目录下的 config/Geyser-Fabric/config.yml 被找到。
- 服务器要求使用任何 客户端Mod 都会导致基岩版玩家无法进入服务器。
- Floodgate-Fabric 可以在 这里 被找到。
- 你必须安装 Fabric API Mod。
该项目的源代码可以在 这里查看。
permissions.yml
位于 config/Geyser-Fabric 目录下的文件控制哪些指令可以被非 OP 玩家使用（基岩版和Java版玩家都是）。您可以将您想要让玩家使用的指令取消注释以使得非OP玩家正常使用。
为什么要单独分开一个源代码库？
- 通过分开源代码库，我们可以更轻松的支持多个 Minecraft 版本。
- Fabric 通过 Gradle 工具构建，而 Geyser 通过 Maven 工具构建。
GeyserOptionalPack
下载: https://ci.opencollab.dev/job/GeyserMC/job/GeyserOptionalPack/job/master/lastSuccessfulBuild/artifact/GeyserOptionalPack.mcpack
GeyserOptionalPack 是 Geyser 为 基岩版与Java版 同步而为基岩版提供额外功能支持的资源包。该资源包为基岩版带来 新的功能和错误修复，包括：
更详细的列表可见该资源包的 README 页面。如果你对如何实现这些功能的细节方面感兴趣，你可以 点击这里 查看。
虽然我们推荐您使用此资源包，但您不需要在 Geyser 服务器上安装此资源包 - 玩家可以自己安装到客户端中。此外，如果您使用 WaterdogPE 等代理端，则可以在服务器上安装该资源包，并且不会影响其他基岩版子服上的游戏。
资源包冲突
如果你当前服务器资源包包含任何与本资源包系统的 实体改动 相同的部分，那么您需要将对这些实体改动的文件进行合并才能正常工作。否则，基于本资源包的关于实体方面的改动将会根据资源包的顺序来决定优先级，将有可能导致本资源包或者服务器的资源包作用失效。这个过程较为复杂，我们建议您人工操作，当然您也可以尝试使用 脚本 来操作。
下载: https://ci.opencollab.dev/job/GeyserMC/job/GeyserOptionalPack/job/master/lastSuccessfulBuild/artifact/GeyserOptionalPack.mcpack
GeyserOptionalPack 是 Geyser 为 基岩版与Java版 同步而为基岩版提供额外功能支持的资源包。该资源包为基岩版带来 新的功能和错误修复，包括：
- 自定义盔甲架姿势
- 幻术师
- 铁傀儡受伤后”裂开“纹理
- 击打粒子和其他基岩版原版不存在的粒子
- 副手动画
- 潜影贝隐形
- 光灵箭纹理
更详细的列表可见该资源包的 README 页面。如果你对如何实现这些功能的细节方面感兴趣，你可以 点击这里 查看。
虽然我们推荐您使用此资源包，但您不需要在 Geyser 服务器上安装此资源包 - 玩家可以自己安装到客户端中。此外，如果您使用 WaterdogPE 等代理端，则可以在服务器上安装该资源包，并且不会影响其他基岩版子服上的游戏。
资源包冲突
如果你当前服务器资源包包含任何与本资源包系统的 实体改动 相同的部分，那么您需要将对这些实体改动的文件进行合并才能正常工作。否则，基于本资源包的关于实体方面的改动将会根据资源包的顺序来决定优先级，将有可能导致本资源包或者服务器的资源包作用失效。这个过程较为复杂，我们建议您人工操作，当然您也可以尝试使用 脚本 来操作。
17.Geyser-Farbic
fabric：淦
久等了 感谢翻译
顶一个，毕竟我也有出力（）
顶一个，毕竟我也有出力（）
pXiaoD 发表于 2021-12-28 22:16
反作弊兼容
请注意，这是由社区维护的列表，它不是很准确，也不是那么完整。如果你像修改这里，请随意。
Matrix在站内也有介绍，虽然是出口转内销，不过作者给中国服主有优惠，所以放个站内链接更好
MCBBS有你更精彩~
无法用二级映射的IP登录服务器怎么解决
请问下，这个映射要怎么设置呢
我使用TCP转发25565端口后，使用这个ipjava玩家可以进入
然后我又开了一个隧道，使用UDP转发19132端口，想让基岩版玩家使用这个ip进入，但是进不来，这是什么问题？
geyser已正常安装
服务器:1.18.1Paper
我使用TCP转发25565端口后，使用这个ipjava玩家可以进入
然后我又开了一个隧道，使用UDP转发19132端口，想让基岩版玩家使用这个ip进入，但是进不来，这是什么问题？
geyser已正常安装
服务器:1.18.1Paper
可以666666666
MCBBS有你更精彩~
想下载旧版独立间歇泉怎么办？1.16.5
请问，该如何关闭Xbox验证登录
请问下，如何关闭Xbox验证，手机版登录问题
当我使用give指令附魔得到的 效率5 时运5 锋利10的钻石镐 无法在基岩版挖掘方块 而java版正常（java1.18.1 be 1.18.12
久等了 感谢翻译
感谢楼主分享 很有帮助
无法翻译TrMenu数据包
感谢LZ分享
漠然一笑 发表于 2022-4-11 07:15
感谢LZ分享
大佬会操作吗
版本支持最低是多少
感谢作者的翻译
冷い桜_ 发表于 2021-12-28 22:30
久等了 感谢翻译
我用的是群组最新版geyser 不知道为什么现在可能是头颅太多(附近种了很多粘液苹果树)现在无法打开所有的gui(背包漏斗箱子发射器)
谢谢，谢谢，谢谢
谢谢，谢谢，谢谢
Unrecognized token 'Read': was expecting
(JSON String, Number, Array, Object or token 'null', 'true' or 'f
alse')
大佬们这个是什么情况
(JSON String, Number, Array, Object or token 'null', 'true' or 'f
alse')
大佬们这个是什么情况
ERROR] 无法获取本地附件缓存 Unrecognized token 'Read': was expecting (JSON String, Number, Array, Object or token 'null', 'true' or 'false')
at [Source: (String)"Read timed out"; line: 1, column: 5]
怎么解决
at [Source: (String)"Read timed out"; line: 1, column: 5]
怎么解决
作者真是太棒啦
使用Geyser插件和手机基岩版互通后，手机基岩版每次都得账号验证吗？
BC版一直显示非法的本地下载和加载请求zh_cn，请问怎么解决啊？现在已经把zh_cn放到locales文件夹里了，还是不能解决
The prowided ualue for the 'code' Parameter is not ualid. 楼主这个报错是什么啊
在手机上使用微软账户时候出现的
在手机上使用微软账户时候出现的
The prowided ualue for the 'code' Parameter is not ualid. 楼主这个报错是什么啊
在手机上使用微软账户时候出现的
在手机上使用微软账户时候出现的
6666666感谢分享
这个服务器太棒了吧
影刃__C6799 发表于 2022-8-11 13:27
同问，请问你解决了吗
我想要的是1.16.5的spigot
解决，官方构建里每个版本最后一次构建都会保留
我在手机版登陆了我的微软账户，但是他提示我服务器需要一个付费的Java账户，我的账户Java和基岩版都有购买正版
66666666666666666666666
MCBBS有你更精彩~