匹配/枢纽游戏
我们提供 API/设置来管理玩家如何被匹配到你游戏中的服务器,并允许你将玩家路由到新服务器,以支持枢纽游戏场景。
匹配偏好
填充模式:
All Out 在全球托管服务器,为玩家提供低延迟体验;不过,如果你的游戏刚刚起步,你可能需要在延迟上做一些妥协,以确保玩家能够在同一个服务器中一起游玩。填充模式已记录在 Creator 门户主页上,并且可以随时更改。
实例优先级 + 要求高优先级模式
有一种特殊的匹配模式,可让你通过代码避免将玩家发送到特定服务器。
游戏可以根据回合状态、玩家数量等为每个实例设置“优先级”级别,使用 Server.set_matchmaking_priority(priority).
你还可以选择请求为你的游戏启用“要求高优先级”模式,这将 仅 将玩家路由到优先级设为 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 查询仅在服务器端返回有用数据。不要基于它们的结果在共享预测游戏流程中分支。
示例:将玩家发送到另一款游戏
最后更新于