集成要求

注意:本页上的内容适用于 Clanforge。如果使用 Multiplay Hosting,请参阅 Multiplay Hosting 文档

下表包含游戏服务器二进制文件要与 Clanforge 业务流程平台集成所需满足的要求。如果您在与 Clanforge 业务流程平台集成时对特定要求或例外存在疑问,请联系 Multiplayer 支持团队。

想要充分利用 Clanforge 服务?请参阅集成最佳实践

支持的操作系统

要求描述
操作系统

Clanforge 官方支持:

  • Windows Server 2019
  • Ubuntu 20.04

最低要求

要求描述例外
多个实例

您的二进制文件进程必须支持在同一机器上运行多个进程实例。

无例外

可绑定的端口

Clanforge 按服务器实例动态生成端口编号(使用偏移来确保服务器启动时不会出现端口冲突)。

要利用此功能,您的服务器实例必须支持可配置的端口(例如,通过命令行参数接收端口编号)。

Clanforge 建议使用命令行参数,如 -PORT=-Port=。更多有关可绑定的端口的信息,请参阅 Multiplay 为何要求使用可绑定的端口?

无例外

可绑定的 IP 地址

所有引擎必须绑定到 0.0.0.0。

无例外。

日志目录

您的服务器应该在保存可执行文件的服务器实例根目录相关的目录中生成日志。如果您使用的是 Unreal Engine,则日志目录应该与 Saved 目录相关。Clanforge 会将此目录中生成的文件公开到各个服务器实例的 Clanforge 面板上。

如需长期留存,Clanforge 还建议在服务器代码中设置日志轮替,以确保您拥有日志历史记录,而无需不断地覆盖单个文件。这有助于调试历史问题。

Clanforge 建议使用命令行参数,如 -log=-LogPath=。更多有关公开的文件和目录的信息,请参阅 Clanforge 公开的目录

如果您不打算访问服务器日志或崩溃转储,则可以忽略日志目录要求。

高级托管

除了上述最低要求,该表还包含高级托管(Multiplay 托管服务)的额外要求。

要求描述例外
查询协议

Clanforge 支持游戏服务器查询协议,以收集您的游戏服务器的分析数据。Clanforge 提供偏差(主端口为 +10;其他查询端口为 +100),以避免任何冲突。借助查询端口功能,我们可以为您提供实时分析,从而为您的游戏提供更好的支持。Clanforge 建议通过命令行参数(如 -QueryPort=)指定查询端口。更多有关游戏服务器查询协议的信息,请参阅我为何需要游戏服务器查询协议?

无例外。

配置目录

如果您的游戏服务器接受通过配置文件提供的额外配置选项,您必须为 Clanforge 提供一种方式,以供其动态更改该文件的存储位置,以便您的服务器找到该文件。

Clanforge 建议使用命令行参数,如 -Homedir=-Userdir=-Config=

配置目录要求仅在您的服务器在配置文件中查找其他参数时才适用。

server.json

要使用分配系统,您必须启用命令行参数,以指定具备该分配 UUID(由您的 Matchmaker 提供)的文件。该参数可通过事件触发器设置(首选方法)或在流程中进行间歇性检查(这会导致冲突情况)来读取。

Clanforge 建议使用命令行参数,如 -serverjson=。要了解更多有关 server.json 文件的信息,请参阅 Server.json 文件

如果您选择使用 Clanforge 的非托管服务,则可以忽略 server.json 要求。