入门指南
本页面介绍如何安装和设置Velocity的最小配置。
安装Java
Velocity是用Java编写的,所以如果你还没有安装Java,你需要在继续之前安装它。Velocity需要Java 17或更新版本。有关详细说明,请参阅我们的Java安装指南。
下载Velocity
前往下载页面获取最新版本的Velocity。我们建议获取最新的稳定版本。下载Velocity后,将JAR文件移动到专门用于代理的文件夹中或上传到你的服务器。
首次启动Velocity
一旦你下载了Velocity,我们将首次启动它以生成配置文件velocity.toml。配置完Velocity后,你可以使用创建的启动脚本来启动Velocity。
在Windows下启动Velocity
在你打算放置代理文件的同一目录中创建一个包含以下内容的start.bat。
@echo off
java -Xms1G -Xmx1G -XX:+UseG1GC -XX:G1HeapRegionSize=4M -XX:+UnlockExperimentalVMOptions -XX:+ParallelRefProcEnabled -XX:+AlwaysPreTouch -jar velocity.jar
pause
确保将velocity.jar更改为你下载的Velocity JAR的名称,或将Velocity JAR重命名为velocity.jar。
保存后,双击start.bat文件。如果成功,你现在应该会看到类似下一节中输出的控制台。
在macOS或Linux下启动Velocity
在你打算放置代理文件的同一目录中创建一个包含以下内容的start.sh。你可以使用文件传输客户端或在主机上运行的文本编辑器来完成此操作。
#!/bin/sh
java -Xms1G -Xmx1G -XX:+UseG1GC -XX:G1HeapRegionSize=4M -XX:+UnlockExperimentalVMOptions -XX:+ParallelRefProcEnabled -XX:+AlwaysPreTouch -XX:MaxInlineLevel=15 -jar velocity*.jar
保存后,如果你还没有打开终端(或登录到机器),请打开终端,导航到你放置Velocity JAR文件和start.sh文件的目录。然后运行chmod +x start.sh和./start.sh。如果成功,你现在应该会看到类似下一节中输出的控制台。
启动后
以下是我们启动代理后你将看到的示例:
[05:41:13 INFO]: Booting up Velocity 3.3.0-SNAPSHOT (git-74c932e5-b363)...
[05:41:13 INFO]: Loading localizations...
[05:41:13 INFO]: Connections will use epoll channels, libdeflate (Linux aarch64) compression, OpenSSL (Linux aarch64) ciphers
[05:41:13 INFO]: Loading plugins...
[05:41:13 INFO]: Loaded 0 plugins
[05:41:13 INFO]: Listening on /[0:0:0:0:0:0:0:0%0]:25565
[05:41:13 INFO]: Done (0.36s)!
Velocity已启动,你现在可以完全配置代理了。在控制台输入end并按回车。代理将关闭:
> end
[05:42:10 INFO]: Shutting down the proxy...
[05:42:10 INFO]: Closing endpoint /0.0.0.0:25565
如果你使用了前面的Windows批处理脚本,窗口会要求你按任意键。你可以按任意键或关闭命令窗口。
配置你的服务器
现在我们需要配置每个服务器以接受来自代理的连接。
Velocity是一个高度可配置的代理。虽然大多数用户不需要更改配置中的所有内容,但在配置参考页面上有大量选项,并附有每个选项的工作原理说明。但是,在本节中,我们将做最低限度的配置以使代理启动并运行。
在文本编辑器中打开velocity.toml文件,搜索[servers]部分。此部分指定Velocity可以连接的服务器。以下是[servers]部分最初的样子:
[servers]
# 在此处配置你的服务器。每个键代表服务器的名称,值代表要连接的服务器的IP地址。
lobby = "127.0.0.1:30066"
factions = "127.0.0.1:30067"
minigames = "127.0.0.1:30068"
# 当玩家登录或从服务器被踢出时,我们应该按什么顺序尝试服务器。
try = [
"lobby",
"factions"
]
在左侧,你将为服务器指定一个名称(例如,lobby),右侧是一个字符串,指示服务器的IP地址和端口。你现在需要将你的服务器添加到列表中。你可以根据需要更改服务器列表。
try设置很特殊。它是一个列表,列出了当玩家首次登录到代理或从服务器被踢出时,Velocity应该尝试连接玩家的服务器。如果你决定更改lobby服务器的名称,那么你应该在此列表中将lobby替换为你为玩家应该首先登录的服务器选择的名称。
以下设置是通用的,旨在适用于任何Minecraft服务器。这种设置不仅不符合人体工程学(玩家将缺少皮肤、正确的UUID,所有连接都将显示来自代理),而且还危险地不安全。在你将服务器设置为离线模式后,你必须按照"玩家信息转发"和"保护你的服务器"主题完成设置。
打开每个服务器的server.properties文件,将online-mode设置为false。这允许Velocity连接到你的服务器。完成后,重启你的服务器。虽然Velocity现在已准备好使用,但你几乎肯定想要保护你的服务器和配置玩家信息转发。