Emparejamiento/Juegos hub

Ofrecemos API/configuraciones para gestionar cómo emparejamos a los jugadores con los servidores de tu juego y te permitimos dirigir a los jugadores a nuevos servidores para admitir escenarios de juegos hub.

Preferencias de emparejamiento

Modo de llenado:

All Out aloja servidores en todo el mundo para ofrecer una experiencia de baja latencia a los jugadores; sin embargo, si tu juego recién está comenzando, quizás quieras sacrificar algo de latencia para asegurarte de que los jugadores puedan jugar juntos en el mismo servidor. Los modos de llenado están documentados en la página principal del portal del creador y pueden cambiarse en cualquier momento.

Prioridad de instancia + Requerir modo de alta prioridad

Existe un modo especial de emparejamiento que te permite evitar enviar jugadores a servidores específicos mediante código.

Los juegos pueden establecer un nivel de "prioridad" para cada instancia según el estado de la ronda, el número de jugadores, etc. usando Server.set_matchmaking_priority(priority).

Opcionalmente, puedes solicitar habilitar el modo "Requerir alta prioridad" para tu juego, lo que solo dirigirá a los jugadores a instancias con la prioridad establecida en cero y pondrá en marcha nuevos servidores si no hay ninguno.

Esto puede ser útil si tienes un juego por rondas en el que no quieres que nuevos jugadores se unan a partidas ya en curso.

Esta función solo está disponible bajo solicitud, ya que si tus instancias nunca o rara vez se configuran con el número de prioridad 0, ¡pondrá en marcha una cantidad masiva de servidores! Por favor contáctanos!

Juegos de hub

Los juegos de hub son un patrón común que permite a los jugadores reunirse y hacer cola juntos para un juego por rondas. Algunos ejemplos incluyen:

• Un vestíbulo para Red Sun que permite a los jugadores hacer cola para jugar juntos y comprar mejoras mientras esperan
• El hub de Bed Wars que te permite seleccionar entre modos de juego (como clases/vs clásico)

Referencia de la API

Server :: struct {
    // Transferir a un jugador a otro juego (hub -> partida, partida -> hub, etc.).
    transfer_player_to_game :: proc(player: Player, game_id: string);

    // Establecer la prioridad de emparejamiento para esta instancia (0 = máxima prioridad).
    set_matchmaking_priority :: proc(priority: int);

    // Expulsar a un jugador del servidor.
    kick_player :: proc(player: Player, reason: string = "Kicked.");

    // Sistema de cola para emparejamiento personalizado. Estas API están actualmente obsoletas, pero podrían volver. Prefiere la API transfer_player_to_game.
    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);

    // Identidad del servidor.
    get_id :: proc() -> string;
    get_private_server_host_id :: proc() -> string, bool;
}

transfer_player_to_game, set_matchmaking_priority, y kick_player tengan efecto en el servidor. Llámalas desde la ruta compartida normal del juego; la llamada correspondiente desde el cliente no tiene efecto.

Las dos consultas de ID solo devuelven datos útiles en el servidor. No bifurques la jugabilidad compartida y predicha basándote en sus resultados.

Ejemplo: enviar a un jugador a otro juego

GAME_ID_2V2 :: "your_game_id_here";

send_to_2v2_game :: proc(player: Player) {
    Server.transfer_player_to_game(player, GAME_ID_2V2);
}

Actualmente no hay forma de pasar información adicional al transferir a un jugador a un nuevo juego, ni tampoco de configurar servidores dinámicamente al iniciar. Si quieres tener diferentes modos (por ejemplo, 1v1 vs 2v2), tendrás que crear juegos dedicados y vincularlos con el sistema de jerarquía de juegos.

Recomendamos habilitar Productos/datos entre juegos al usar las API de teletransporte/hub para garantizar que las compras y los datos guardados de los jugadores puedan reutilizarse fácilmente entre ambos.