Comment intégrer le système de matchmaking à votre jeu multijoueur de survie

â -> Cet article est basé sur la documentation sur le matchmaking. Si vous rencontrez des problèmes ou des incohérences, veuillez vous référer au guide original, car il est plus souvent mis à jour.

L'exemple suivant vous aidera à tester le flux principal des joueurs dans le système de matchmaking, à savoir :

• Créer une instance du système de matchmaking sur le Cluster d'Hébergement partagé,

• Définir des règles et des paramètres dans la Configuration de votre système de matchmaking,

• Et enfin, tester le flux des joueurs et gérer les Billets Joueur avec notre API.

Il y a cinq étapes pour intégrer notre système de matchmaking dans votre jeu :

1. La première étape consiste à créer un compte et à utiliser notre exemple de jeu de survie. Voilà, vous êtes (techniquement) à mi-chemin ! Il vous suffit d'intégrer le système de matchmaking dans votre jeu (voir étape 5).

2. Maintenant, vous ne devez jamais suivre aveuglément un exemple JSON trouvé sur Internet, et il est donc fortement recommandé d'adapter les règles ci-dessus à votre jeu à tours. L'étape 2 (“Explorer la Configuration”) est notre “comment lire” qui explique le fonctionnement de chaque règle du système de matchmaking (“Explorer la Configuration”).

3. L'étape 3 (“Vérifier les Détails de l'Instance”) couvre votre matchmaker personnel et spécifique afin de garantir qu'il est déployé et fonctionne avec le design de votre jeu.

4. L'étape 4, comme son nom l'indique (“4. Tester l'API de Billets”), concerne tout ce qui a trait aux requêtes de matchmaking des joueurs reçues par le système de matchmaking, appelées billets.

5. L'étape 5 (“Intégrer le Système de Matchmaking dans votre Jeu”) souligne comment intégrer la survie au sein du projet de votre moteur.

Si vous éprouvez des problèmes de dépannage, notre Centre d'Apprentissage propose des conseils supplémentaires.

1. Configuration du Niveau Gratuit

Inscrivez-vous pour obtenir votre compte Edgegap gratuit, et accédez à la page du tableau de bord de matchmaking.

À partir de là, cliquez d'abord sur Créer un Matchmaker ensuite, saisissez :

• Un nom pour votre matchmaker – qui est uniquement pour votre propre référence, par exemple quickstart-dev,

• Ensuite, téléchargez l'exemple simple suivant comme configuration JSON ci-dessous pour votre jeu de survie :

{
  "version": "2.1.0",
  "inspect": true,
  "max_deployment_retry_count": 3,
  "ticket_expiration_period": "5m",
  "ticket_removal_period": "1m",
  "profiles": {
    "custom-lobby-example": {
      "application": {
        "name": "my-game-server",
        "version": "2024.01.30-16.23.00-UTC"
      },
      "rules": {
        "initial": {
          "match_size": {
            "type": "player_count",
            "attributes": {
              "team_count": 1,
              "team_size": 4
            }
          },
          "lobby_id": {
            "type": "string_equality"
          }
        },
        "expansions": {}
      }
    }
  }
}

(petit rappel : veuillez vous assurer de changer le nom de l'application et version pour correspondre à votre Application et Versions!)

Si aucune erreur de validation n'apparaît, cliquez sur Créer et Démarrer et attendez que le processus se termine. Cela entraînera le démarrage d'un nouveau cluster gratuit, avec votre Matchmaker d'exemple simple.

Vous pouvez maintenant passer à l'étape suivante.

2. Explorer la Configuration​

Règles uniques de jeux de survie multijoueurs

Les lobbies personnalisés (lobbies privés, niveaux sandbox) sont une option très populaire pour le multijoueur sur canapé, mais aussi pour tester de nouvelles fonctionnalités dans des jeux compétitifs ou coopératifs avant qu'elles n'entrent dans les modes de jeu principaux. Ces jeux nécessitent généralement le moins de restrictions, mais visent à garantir que les joueurs peuvent Rejoindre en Groupe.

Les billets de Backfill peuvent utiliser des profils de Lobby Personnalisé pour soutenir l'invitation fiable d'amis, tant que les billets de Backfill sont valides.

• Conseil: Ajoutez le profil custom-lobby-example à votre configuration en plus de vos autres profils pour supporter les lobbies personnalisés.

Versionnage Sémantique

Au fur et à mesure que nous publions des mises à jour du Matchmaker, chaque nouvelle version utilise le Versionnage Sémantique pour communiquer clairement l'impact des changements en interprétant le format major.minor.patch :

• les versions major comprennent des changements importants et nécessitent une révision de l'intégration,

• les versions minor comprennent des améliorations rétrocompatibles substantielles,

• les versions patch comprennent des corrections de bogues et des améliorations mineures.

Certaines déploiements peuvent entraîner des erreurs. Nous tentons de résoudre cela en réessayant le déploiement jusqu'à max_deployment_retry_count fois automatiquement (sans confirmation du client).

Pour garantir que les pannes inattendues du client ou les billets abandonnés ne persistent pas et n'occupent pas vos ressources de matchmaking, les billets seront annulés après ticket_expiration_period causant leur statut à changer en CANCELLED et ensuite définitivement supprimés après ticket_removal_period.

Le cœur de notre logique de matchmaking est configuré dans Profils de Matchmaking. Chaque profil est une file d'attente de matchmaking complètement isolée, pointant vers Versions d'App avec une quantité pré-définie de CPU et de mémoire (RAM) requises.

Règles de Matchmaking dans l'ensemble de règles initial doit être respectée pour que les joueurs soient regroupés, chacune définie par trois propriétés :

• nom de votre choix, par exemple - taille de match,

• type de règle, également connu sous le nom d'opérateur, par exemple - nombre_de_joueurs,

• et enfin les attributs de l'opérateur, par exemple nombre_de_equipes ou taille_de_l'équipe.

Règle du Nombre de Joueurs

C'est une règle spéciale définissant combien de joueurs doivent correspondre pour initier l'attribution :

• nombre_de_equipes fait référence au nombre d'équipes, 1 équipe peut être utilisée pour des modes coopératifs ou en free-for-all,

• taille_de_l'équipe fait référence au nombre de joueurs par équipe.

Notre exemple simple démontre un jeu coopératif avec 2 joueurs.

Veuillez noter que la règle