Navigateur de serveurs

Bienvenue dans Edgegap Server Browser OPEN BETA. Nous espérons que vous apprécierez l'occasion de prévisualiser notre nouveau service et d'aider à façonner son avenir via des tables rondes sur notre Discord.

Server Browser est un service géré pour Déploiements et persistants serveurs :

• aider les joueurs à lister et rejoindre des serveurs adaptés en fonction de la capacité, de la latence ou des paramètres du jeu ;

• pré-chauffer de nouveaux serveurs pour servir la demande mondiale à grande échelle et éviter des files d'attente frustrantes ;

• 📢 rationaliser les opérations serveur y compris les mises à jour, redémarrages, persistance, maillage, et plus encore.

Les éléments marqués de l'icône 📢 sont des fonctionnalités prévues pour le lancement initial et au-delà (pas encore disponibles).

Vous souhaitez appairer des joueurs selon des règles strictes, sans permettre le choix du serveur ? Envisagez Matchmaking.

✔️ Préparation

Flux réseau

Server Browser - Flux réseau

Il y a quatre (4) flux de données importants lors de l'utilisation de Server Browser :

1. API Déploiements est utilisée pour déployer, mettre à l'échelle et gérer vos serveurs dédiés.

   1. Utilisez l'API v2/deploy pour sessions liées à des matchs durant moins de 24 heures.

   2. Utilisez API de déploiement de flotte privée pour démarrer des serveurs en veille avec Persistance.

   3. 📢 Utilisez Hot Standby pour la mise à l'échelle automatique basée sur des règles et le support de maillage.

2. API Serveur utilisée par les serveurs dédiés pour annoncer leur disponibilité et gérer la capacité.

3. API de réservation de place utilisée par les clients de jeu pour découvrir et se connecter aux serveurs dédiés.

4. Les transports Netcode sont utilisés pour communiquer entre les clients de jeu et les serveurs dédiés.

Après la sortie, votre navigateur de serveurs devra fonctionner 24/7 pour garantir que les joueurs du monde entier puissent rejoindre des serveurs.

▶️ Commencer la navigation

Découvrez le cycle de vie des serveurs/joueurs et leurs responsabilités pour garantir une utilisation efficace des serveurs.

Authentifier

Server Browser génère automatiquement deux types de jetons :

• Jeton Serveur - requis pour API Serveur méthodes, peut être injecté comme variable de version d'application.

  • Accorde l'accès à toutes les méthodes API, et est pratique pour les tests, le devops ou les orchestrateurs personnalisés.

• Jeton Client - requis pour Surveiller et API de réservation de place méthodes utilisées par les clients de jeu.

  • Nous recommandons de stocker ce jeton dans un coffre-fort de secrets tiers pour faciliter la rotation des jetons.

Découvrir une instance

API Déploiements est utilisée pour déployer, mettre à l'échelle et gérer vos serveurs dédiés.

• Utilisez l'API v2/deploy pour sessions liées à des matchs durant moins de 24 heures.

• Utilisez API de déploiement de flotte privée pour démarrer des serveurs en veille avec Persistance.

• 📢 Utilisez Hot Standby pour la mise à l'échelle automatique basée sur des règles et le support de maillage.

Lorsque vous démarrez une nouvelle Déploiements, notifiez Server Browser d'une nouvelle instance et définissez un nombre quelconque de paramètres de métadonnées optionnels utiles pour le filtrage, le tri et la navigation des joueurs :

• informations sur les emplacements - capacité d'équipe et métadonnées spécifiques à l'équipe (par ex. nom de l'équipe),

  • au moins un emplacement par instance est requis pour gérer la capacité des joueurs ;

• nom et tags - étiquettes personnalisables, uniques, lisibles par l'humain et recherchables ;

• détails de connexion - URL, IP, ports externes ou autres paramètres ;

• données de compatibilité - version du serveur ou versions clientes prises en charge ;

• qualificateurs de latence - identifiants de ville et de région, et Balises Ping détails assignés ;

• paramètres du jeu - niveau/scene/carte, mode de jeu, difficulté, mods utilisés ;

• tous les autres paramètres personnalisés pour aider les joueurs à filtrer et trouver un serveur adapté.

Les paramètres de métadonnées ci-dessus ne sont que des exemples, vous pouvez définir n'importe quels paramètres y compris ceux ci-dessus. Tous les paramètres de métadonnées sont optionnels, et certaines instances peuvent ne pas avoir besoin de définir tous les paramètres.

Les métadonnées prennent en charge des clés de type chaîne et des valeurs contenant chaîne, nombre, booléen ou tableau de chaînes.

Pour sérialiser des objets imbriqués, essayez d'encoder leur chemin d'accès dans la clé comme "object.child.property".

Les serveurs peuvent mettre à jour les métadonnées d'instance ou d'emplacement à tout moment pour modifier leurs critères de découvrabilité.

Les instances de serveur doivent envoyer périodiquement un battement de cœur keep-alive pour vérifier leur disponibilité continue et empêcher les joueurs d'essayer de rejoindre des serveurs plantés ou hors ligne. L'absence du battement de cœur pendant 30 secondes supprimera automatiquement l'instance et toutes les réservations de places en attente.

📢 Les serveurs peuvent mettre à jour leur instance en « mode hibernation » avant d'être réduits (arrêtés) pour rester découvrables sans envoyer d'autres requêtes de battement de cœur. Lorsqu'un joueur demande à Navigateur de serveurs pour une instance en hibernation, Server Browser redéploiera automatiquement votre serveur.

Voir Persistance pour gérer l'état persistant du monde et Applications et versions pour des déploiements plus rapides.

Rechercher et parcourir

Les joueurs peuvent lister les instances de serveur et paginer à travers les résultats pour trouver un serveur qu'ils souhaiteraient rejoindre. Pour afficher les données de ping (latence), lisez les Balises Ping détails de chaque instance et mesurer la latence.

Les instances et emplacements peuvent être filtrés par sièges joignables ou paramètres de métadonnées indexés.

Paramètre	Opérateurs	Filtre d'exemple (basé sur l'exemple simple)
"joinable_seats"	eq ou ne ou lt ou le ou gt ou ge	?filter=joinable_seats gt 0 &orderby=joinable_seats desc
"string" (métadonnées)	eq ou ne ou lt ou le ou gt ou ge ou contient	?filter=metadata.custom_name contains 'my game' and metadata.server_version le '1.1.0' and metadata.server_version ge '1.0.0' &orderby=metadata.custom_name asc
"int" , ou "float" (métadonnées)	eq ou ne ou lt ou le ou gt ou ge	?filter=metadata.xp_multiplier gt 1.0 &orderby=metadata.xp_multiplier desc
"bool" (métadonnées)	eq ou ne	?filter=metadata.allows_new_connections eq true

Filtrez par régions et/ou villes pour affiner la sélection avant de mesurer la latence vers les serveurs.

En savoir plus sur la pagination basée sur curseur Pagination pour permettre aux utilisateurs de récupérer plus de résultats.

Réserver des places

Avant de rejoindre un serveur, une réservation de place est requise pour garantir que l'instance offre une capacité disponible suffisante. Les réservations peuvent inclure un groupe de joueurs ou un individu seul.

Les réservations dépassant la capacité de sièges joignables du slot seront automatiquement rejetées (409 Conflit). Les sièges joignables sont tous les sièges disponibles qui n'ont pas encore été réservés par d'autres joueurs.

Identité fédérée : les joueurs doivent fournir un identifiant joueur unique tiers dans leur réservation. L'envoi du même identifiant une fois qu'ils Navigateur de serveurs permettra au serveur de vérifier leur identité.

Une fois qu'une réservation est effectuée avec succès (200 OK) les joueurs doivent tenter de se connecter immédiatement. Les réservations en attente expireront après 30 secondes à moins qu'elles ne soient confirmées par votre serveur.

Le serveur peut modifier de force la capacité de n'importe quel slot, ajouter, supprimer ou mettre à jour n'importe quel slot. Toutes les réservations pour un slot donné seront supprimées si des réservations en attente dépassent la nouvelle capacité de sièges disponible.

Se connecter au serveur

Une fois qu'un joueur a trouvé une instance appropriée, il peut récupérer les détails de connexion requis à partir des métadonnées (URL, IP, Port externe). Dès que la réservation de place est effectuée, les joueurs peuvent procéder à la connexion au serveur de jeu de votre déploiement et transmettre leur identifiant joueur.

Unreal Engine

Pour se connecter depuis PIE (éditeur) pendant le développement et les tests, appuyez sur la touche tilde ~ et tapez open {URL}:{port} et attendez que votre éditeur charge la carte.

En cas d'échecs de connexion ou d'écran noir, consultez notre guide de dépannage.

Unity

Pour authentifier les nouvelles connexions, votre serveur doit envoyer une requête de confirmation de réservation groupée avec tous les identifiants des nouveaux joueurs, recevant les informations dans la réponse de confirmation :

• attribution des réservations de joueurs acceptées à leur slot préféré,

• attribution des réservations de joueurs expirées à leur slot préféré,

• une liste d'identifiants de joueurs inconnus.

Votre serveur peut décider comment gérer chaque groupe de joueurs et s'il faut autoriser ou expulser/bannir les utilisateurs expirés ou rejetés. Chacun des slots de l'instance doit être mis à jour immédiatement avec le nouveau nombre de sièges disponibles pour s'assurer que de nouvelles réservations ne dépasseront pas la capacité.

Abandonner le serveur

Lorsque les joueurs partent, le serveur doit mettre à jour leur slot attribué pour refléter la nouvelle capacité de sièges disponible.

Si la conception de votre jeu permet une période de reconnexion, votre serveur peut attendre avant de libérer les sièges.

Nous recommandons d'arrêter les serveurs sans joueurs pour optimiser vos coûts d'hébergement. Attendre quelques minutes avant de le faire peut réduire le nombre de redémarrages durant de courtes périodes d'inactivité.

Lisez à propos de Persistance pour empêcher des retours en arrière frustrants des serveurs persistants.

⚙️ Configuration

L'API Server Browser est générée à partir d'une configuration JSON spécifiée lorsque vous créez un nouveau Server Browser (ou redémarrage rapide). Vous pouvez spécifier l'expiration des serveurs et des slots, et des métadonnées personnalisées :

🍀 Exemple simple

{
  "version": "0.0.5",
  "server_instances": {
      "expiration_period": "30s",
      "indices": {
        "custom_id": "string",
        "custom_name": "string",
        "server_version": "string",
        "allows_new_connections": "bool",
        "xp_multiplier": "float",
        "beacon_ip": "string",
        "beacon_port_udp": "int",
        "beacon_port_tcp": "int"
      }
  },
  "server_instance_slots": {
    "indices": {
      "custom_team_name": "string",
      "average_team_skill_rating": "float"
    }
  },
  "seat_reservations": {
    "expiration_period": "30s"
  }
}

Pour de meilleures performances, évitez de spécifier des indices pour des métadonnées non utilisées pour le filtrage ou le tri. Les paramètres non indexés peuvent toujours être définis et lus avec les méthodes API de détails d'instance serveur ou de slot, voir 📗 API.

☁️ Cluster d'hébergement

Server Browser est hébergé et géré 24/7 de manière pratique par Edgegap.

Choisissez une option d'hébergement la mieux adaptée à votre objectif :

Niveaux de cluster privé

Passez à un cluster privé en un clic pour bénéficier d'un hébergement hautement disponible maintenu par l'équipe Edgegap avec un support en direct 24/7 pour les jeux publiés publiquement.

Les exigences en ressources pour votre instance dépendront de facteurs :

• nombre de joueurs - plus de joueurs entraînent plus de requêtes API,

• nombre de requêtes par joueur - des nouvelles tentatives plus rapides augmentent la charge du service et consomment des ressources,

• nombre de serveurs - plus de serveurs entraînent plus de données stockées et plus de requêtes API,

• logique de repli de nouvelle tentative côté client - retenter avec un backoff avec jitter aide à répartir les pics de trafic,

• durée moyenne des matchs - des sessions plus courtes nécessitent des interactions plus fréquentes avec le navigateur de serveurs.

📗 API

Les clients de jeu et les serveurs dédiés envoient des requêtes API tout au long de leur cycle de vie à Server Browser.

57KB

sb-openapi-open-beta.json

Ouvrir

Importez la spécification API dans Client Web Scalar API ou Swagger Editor pour inspecter les détails.

Pagination

Server Browser fournit une pagination par curseur pour récupérer des données filtrées de manière incrémentale dans un ordre spécifique. Cette approche nécessite l'envoi d'un curseur (point de départ) et d'une taille de page (nombre d'éléments de réponse) chaque fois que vous récupérez plus de résultats, contrairement à la pagination traditionnelle par limit-offset.

Combinée à notre système d'indexation de base de données propriétaire développé pour les métadonnées de serveurs de jeu, la pagination par curseur offre une expérience utilisateur rapide, cohérente et flexible pour filtrer des données hautement dynamiques.

Notre objectif est que les utilisateurs trouvent un serveur adapté dès la première page. Pour une meilleure expérience, nous recommandons d'afficher les résultats mis en cache pour les pages précédentes, et de ne rafraîchir les résultats que lorsque l'utilisateur clique sur Rechercher.

🔖 Journal des modifications

La dernière version du navigateur de serveurs est 0.0.4 . Restez à l'affût des mises à jour et des annonces.

0.0.4 (05 Janv. 2026)

• Entrée en OPEN BETA, introduction de filtrage et tri pour les instances de serveur et les emplacements!

0.0.3 (28 Nov. 2025)

• Publication initiale du service Server Browser lancée en CLOSED BETA.

• Lister les serveurs, gérer la capacité et obtenir les détails de connexion.

• Prise en charge des sessions de match avec déploiements cloud et toujours en ligne avec des flottes privées.