For the complete documentation index, see llms.txt. This page is also available as Markdown.

匹配/枢纽游戏

我们提供 API/设置来管理玩家如何被匹配到你游戏中的服务器,并允许你将玩家路由到新服务器,以支持枢纽游戏场景。

匹配偏好

填充模式:

All Out 在全球托管服务器,为玩家提供低延迟体验;不过,如果你的游戏刚刚起步,你可能需要在延迟上做一些妥协,以确保玩家能够在同一个服务器中一起游玩。填充模式已记录在 Creator 门户主页上,并且可以随时更改。

实例优先级 + 要求高优先级模式

有一种特殊的匹配模式,可让你通过代码避免将玩家发送到特定服务器。

游戏可以根据回合状态、玩家数量等为每个实例设置“优先级”级别,使用 Server.set_matchmaking_priority(priority).

你还可以选择请求为你的游戏启用“要求高优先级”模式,这将 仅 将玩家路由到优先级设为 0 的实例,并会启动 新服务器 如果没有可用实例。

如果你有一款基于回合的游戏,不希望新玩家加入已经进行中的对局,这会很有用。

此功能仅限申请开通,因为如果你的实例从不/很少被设为优先级 0,它会启动大量服务器!请 联系我们!

中枢游戏

中枢游戏是一种常见模式,允许玩家聚在一起并排队进入基于回合的游戏。示例包括:

  • Red Sun 的大厅,允许玩家排队一起游玩,并在等待时购买升级

  • Bed Wars 的中枢,允许你在不同游戏模式之间选择(如 classes/vs classic)

API 参考

Server :: struct {
    // 将玩家转移到另一款游戏(中枢 -> 对局、对局 -> 中枢等)。
    transfer_player_to_game :: proc(player: Player, game_id: string);

    // 为此实例设置匹配优先级(0 = 最高优先级)。
    set_matchmaking_priority :: proc(priority: int);

    // 将玩家踢出服务器。
    kick_player :: proc(player: Player, reason: string = "Kicked.");

    // 自定义匹配的队列系统。这些 API 目前已弃用,但未来可能恢复。请优先使用 transfer_player_to_game API。
    queue_add_player           :: proc(queue: string, player: Player);
    queue_remove_player        :: proc(queue: string, player: Player);
    queue_set_server_available :: proc(queue: string, available: bool);

    // 服务器标识。
    get_id :: proc() -> string;
    get_private_server_host_id :: proc() -> (string, bool);
}

transfer_player_to_game, set_matchmaking_priority.data kick_player 会在服务器端生效。请从正常的共享游戏流程中调用它们;对应的客户端调用不会产生任何效果。

这两个 ID 查询仅在服务器端返回有用数据。不要基于它们的结果在共享预测游戏流程中分支。

示例:将玩家发送到另一款游戏

目前在将玩家转移到新游戏时无法传递额外信息,也无法在启动时动态配置服务器。如果你想要不同模式(例如 1v1 对 2v2),你需要创建专用游戏,并使用游戏父子系统将它们链接起来。

我们建议启用 跨游戏产品/数据 在使用传送/中枢 API 时,以确保玩家购买内容和存档数据可以在两者之间轻松复用。

最后更新于