跳到主要内容

常见问题

多年来,用户经常问我们一些相同的问题。本FAQ尝试从用户角度回答尽可能多的这些问题。

Velocity需要什么版本的Java?

Velocity 3.3.x需要Java 17或更高版本。

在哪里可以找到Velocity插件?

找到与Velocity兼容的插件的好来源是我们的插件仓库Hangar

Velocity支持为BungeeCord或Waterfall开发的插件吗?

不支持。如果我们决定支持BungeeCord插件,Velocity能做的很多事情就无法实现。

然而,某些插件可能有Velocity移植版本或替代方案。此外,支持BungeeCord但只需要安装在服务器上的插件(代理上不需要安装)通常使用BungeeCord插件消息通道,这在最新版本的Velocity中原生支持。

帮助,我无法连接到我的服务器!

无法连接到服务器有几个常见原因。

基本故障排除

首先,你应该验证:

  • 你的服务器已启动并能响应控制台输入
  • 代理已启动
  • 服务器和代理绑定到了适当的端口和IP

不正确的玩家信息转发错误

Can't connect to server lobby: If you wish to use IP forwarding, please enable it in your Bungeecord config as well!
Can't connect to server lobby: Your server did not send a forwarding request to the proxy. Is it set up correctly?

这些错误是由配置不当导致的。请参阅玩家信息转发了解如何正确设置玩家信息转发。

Can't connect to server lobby: This server requires you to connect with Velocity.

此错误是由于在后端服务器上启用了Velocity现代转发,但在Velocity中未启用它。要修复此错误,请确保在代理上设置了正确的玩家信息转发方法。有关更多信息,请参阅玩家信息转发

无效的负载REGISTER

[server connection] player1 -> hub has connected
[connected player] player1 (/localhost:58943): kicked from server hub: Invalid payload REGISTER!

当有人使用模组客户端连接时,这个错误通常会在基于Spigot的服务器上出现。如果你使用Paper(或Paper的分支)1.12.2或更高版本,可以通过添加启动标志-Dpaper.disableChannelLimit=true到服务器的启动标志并重启服务器来修复此问题。

参数类型标识符未知

Argument type identifier <namespace>:<name> unknown.

如果你收到此消息,有两种可能。如果你运行模组服务器并使用Fabric 1.16+及以上版本,请更新到至少Velocity 1.1.2并安装CrossStitch。(如果你运行任何其他类型的模组服务器并且能与Velocity一起工作,请让我们知道!)

如果你收到此消息但运行的是原版服务器,请向Velocity问题追踪器报告错误

切换到Forge服务器时读取超时

特别是对于一些非常大的模组包,玩家和代理之间的连接有较高的断开风险。我们在代理端无法做太多事情来缓解这个问题。我们建议要么减少服务器使用的模组数量,要么在velocity.toml中提高read-timeout设置,并在Forge服务器上添加-Dfml.readTimeout启动标志,将其设置为你为代理选择的值(以秒为单位)。例如,如果你确定120秒是最佳的读取超时时间,请使用-Dfml.readTimeout=120并在velocity.toml中设置read-timeout = 120000

我的强制主机不工作!

首先,仔细检查你是否为你选择的强制主机正确设置了指向你的代理的DNS记录。强制主机与SRV记录不兼容,所以如果你依赖SRV记录将玩家引导到代理,你需要找到一种方法让代理运行在默认的Minecraft端口25565上。

插件无法修改消息或命令

A plugin tried to cancel a signed chat message. This is no longer possible in 1.19.1 and newer. Disconnecting player <player>

从Minecraft 1.19.1开始,Mojang实现了一个新的聊天系统,每条消息都使用每个玩家拥有的签名密钥进行加密。Velocity目前还没有完全支持取消或修改这种类型的消息和命令,所以你可以安装SignedVelocity插件,它将允许消息或命令传输到你的服务器,当在服务器上收到它时,将应用在Velocity中计算的结果。