本指南涵盖了在 Legion Hosting 上设置和配置 Onset 专用服务器所需的一切。Onset 是一款基于 Unreal Engine 4 的多人沙盒游戏，允许玩家通过 Lua 脚本创建自定义游戏模式。有关管理员命令和扩展包管理，请参阅我们的 Onset 管理员与扩展包设置指南。
什么是 Onset？
Onset 是由 Blue Mountains GmbH 开发的多人沙盒游戏，提供了一个空白画布，用于创建几乎任何多人游戏体验。与具有固定玩法的传统游戏不同，Onset 完全依赖社区使用 Lua 编写的扩展包（游戏模式）来定义每个服务器的规则、机制和内容。
主要特性包括：
- Lua 脚本 — 使用 Lua 编程语言通过全面的服务器端和客户端 API 创建完整的游戏模式
- Unreal Engine 4 — 由 UE4 驱动的高质量视觉效果和物理引擎
- 开放世界地图 — 具有多样地形、城市和室内环境的大型开放世界
- 扩展包系统 — 可组合和自定义的模块化游戏模式扩展包
- 多人游戏 — 支持大量玩家的自定义游戏模式专用服务器
首次启动
当您的 Onset 服务器在 Legion Hosting 上开通后，它已预配置了基础服务器文件。首次运行服务器：
- 登录 GPanel：gpanel.legionhosting.net
- 从服务器列表中选择您的 Onset 服务器
- 查看 Startup Variables 以在首次启动前设置服务器名称和最大玩家数
- 点击 Start 启动服务器
- 服务器将初始化并在首次启动时生成默认配置文件
- 当控制台显示服务器已就绪并在监听时，玩家即可通过 Onset 启动器连接
默认端口：Onset 默认使用 UDP 端口 7777 用于游戏连接，TCP 端口 7776 用于 HTTP 查询。您服务器分配的端口显示在 GPanel 服务器主页上。除非您拥有私有 IP，否则端口为随机分配。
重要提示：Onset 服务器至少需要安装一个游戏模式扩展包，玩家才能获得有意义的体验。没有扩展包的情况下，服务器会运行但玩家将没有任何游戏机制。有关扩展包安装说明，请参阅 Onset 管理员与扩展包设置指南。
GPanel 启动变量
GPanel 在 Startup 选项卡下提供了一个用于自动更新的启动变量。所有其他服务器设置（服务器名称、密码、最大玩家数）在 server_config.json 中配置（见下文）。
| 变量 | 默认值 | 描述 |
|---|---|---|
AUTO_UPDATE |
1 |
重启时自动更新服务器。设置为 0 以禁用。 |
注意：服务器名称、密码和最大玩家数在
server_config.json 中配置，而非 GPanel 启动变量。请参阅下方的配置部分。
服务器配置（server_config.json）
主服务器配置文件是位于服务器根目录的 server_config.json。您可以通过 GPanel 的 File Manager 编辑此文件。该文件使用 JSON 格式：
{
"servername": "My Onset Server",
"hostname": "0.0.0.0",
"port": 7777,
"maxplayers": 50,
"password": "",
"visible": true,
"streamdistance": 800,
"streamrate": 50,
"tickrate": 50,
"loglevel": 1,
"packages": [
"mygamemode"
],
"plugins": []
}配置设置说明
| 设置 | 默认值 | 描述 |
|---|---|---|
servername |
Onset Server | 在 Onset 启动器服务器浏览器中显示的名称。 |
hostname |
0.0.0.0 | 服务器绑定的 IP 地址。保持 0.0.0.0 以绑定到所有接口。 |
port |
7777 | 用于游戏流量的主要 UDP 端口。通常由 GPanel 自动管理。 |
maxplayers |
50 | 最大同时在线玩家数。更高的数量会增加资源使用。 |
password |
（空） | 服务器密码。留空字符串表示公开服务器。 |
visible |
true | 服务器是否显示在公共服务器浏览器中。 |
streamdistance |
800 | 实体流式传输给玩家的距离（Unreal 单位）。较低的值可减少网络负载。 |
tickrate |
50 | 服务器刷新率（Hz）。更高的值意味着更流畅的游戏体验，但 CPU 使用率更高。 |
packages |
（空数组） | 启动时加载的扩展包文件夹名称列表。扩展包定义游戏模式和游戏机制。 |
JSON 语法：
server_config.json 文件必须是有效的 JSON。缺少逗号、多余的逗号或不匹配的括号将阻止服务器启动。如果您不确定编辑是否正确，请使用 JSON 验证器。
网络设置
Onset 使用不同的端口处理游戏流量和 HTTP 查询。了解网络配置对于正确的连接性非常重要：
| 端口 | 协议 | 用途 |
|---|---|---|
7777 |
UDP | 用于玩家连接和游戏数据的主要游戏端口 |
7776 |
TCP | 用于服务器浏览器列表和 API 查询的 HTTP 查询端口 |
玩家如何连接
玩家通过官方 Onset 启动器连接到 Onset 服务器，而非直接通过 Steam。
通过服务器浏览器
- 从 Steam 启动 Onset 游戏
- 在 Onset 启动器中，点击 Server Browser
- 在列表中搜索您的服务器名称或按游戏模式筛选
- 选择服务器并点击 Connect
- 如果设置了密码，请输入密码
通过直接连接
- 从 Steam 启动 Onset 游戏
- 在 Onset 启动器中，点击 Direct Connect
- 输入您服务器的 IP 地址和端口（例如
192.168.1.100:7777） - 点击 Connect
查找服务器 IP：您服务器的 IP 地址和端口可以在 GPanel 服务器主页上找到。有关详细指引，请参阅我们的 如何查找服务器 IP 和端口指南。
相关文章
需要帮助？
如果您的 Onset 服务器遇到问题或需要进一步帮助，我们的支持团队随时为您服务。提交支持工单，我们将尽快回复您。
