> For the complete documentation index, see [llms.txt](https://docs.edgegap.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.edgegap.com/fr/docs/sample-projects/unity-netcodes/photon-fusion-2-br200.md).

# Photon Fusion 2 BR200

Hébergez l’exemple battle royale BR200 de Photon (Photon Fusion 2) sur des serveurs dédiés Edgegap, un déploiement par partie, en utilisant le kit Edgegap BR200.

Découvrez comment héberger des projets Unity sur Edgegap en utilisant des techniques tirées du [exemple BR200 Battle Royale](https://assetstore.unity.com/packages/templates/packs/br200-battle-royale-multiplayer-photon-fusion-226753), un battle royale pouvant accueillir jusqu'à 200 joueurs.

{% hint style="info" %}
Notre [kit Edgegap BR200](https://github.com/edgegap/netcode-game-sample-photon-fusion2-battleroyale-200) est un ensemble de fichiers que vous copiez dans votre projet BR200. Il **ne modifie ni n'inclut aucun code sous licence Photon**, donc vous obtenez BR200 depuis l'Unity Asset Store sous votre propre licence.
{% endhint %}

Cet exemple montre :

* **BR200 en tant que serveur dédié** - un déploiement par partie, [placé près des joueurs](https://docs.edgegap.com/fr/learn/orchestration/deployments.md#server-placement).
* **Aucune modification du code BR200** - un script de démarrage associe [les variables injectées](https://docs.edgegap.com/fr/learn/orchestration/deployments.md#injected-environment-variables) aux propres options de ligne de commande de BR200.
* **Connexions directes** - le serveur se lie `0.0.0.0`, donc les clients se connectent directement au lieu de passer par le relais Photon.
* **Choix de la région Photon** - le serveur choisit la région Photon la plus proche de son déploiement.
* **Arrêt automatique du serveur** - le serveur arrête son propre déploiement lorsque la partie se termine.

{% hint style="success" %}
Voir [Photon Fusion 2](https://docs.edgegap.com/fr/docs/sample-projects/unity-netcodes/photon-fusion-2-on-edgegap.md) pour un **guide général de Photon Fusion 2 sur Edgegap**. Voir le [README](https://github.com/edgegap/netcode-game-sample-photon-fusion2-battleroyale-200) pour la liste complète des fichiers, des variables d'exécution et des résultats des tests.
{% endhint %}

## ✔️ Préparation

Avant de commencer, vous aurez besoin de :

* [BR200 Battle Royale (Photon Fusion)](https://assetstore.unity.com/packages/templates/packs/br200-battle-royale-multiplayer-photon-fusion-226753) - à télécharger et à ouvrir dans une version prise en charge de Unity.
* [kit Edgegap BR200](https://github.com/edgegap/netcode-game-sample-photon-fusion2-battleroyale-200).
* ID d’application Photon Fusion - trouvez-le dans votre [tableau de bord Photon](https://dashboard.photonengine.com).

{% hint style="info" %}
Ouvrez votre projet et installez les outils de compilation du serveur en suivant [Unity](https://docs.edgegap.com/fr/unity.md) les étapes de préparation.
{% endhint %}

Ce kit a été testé avec BR200 2.1.0, Fusion 2.1.1 (build 2177) et Unity 6000.3.11f1 sous Windows.

{% hint style="warning" %}
Votre serveur **doit être une build IL2CPP** (par défaut dans BR200). `MethodAccessException` et les joueurs n’obtiennent jamais de personnage.
{% endhint %}

☑️ Pour compiler IL2CPP Linux sous Windows, ajoutez la chaîne d’outils Linux de Unity dans Window / Package Manager / + / Add package by name :

* Unity 6000.3 et versions ultérieures : `com.unity.toolchain.win-x86_64-linux` et `com.unity.sdk.linux-x86_64`,
* versions antérieures : `com.unity.toolchain.win-x86_64-linux-x86_64`.

## ⚡ Déployer et connecter

### 1. Ajoutez le kit à votre projet

☑️ Copiez `Assets/EdgegapBR200`, `edgegap/`, `scripts/`, `.dockerignore` et `.gitattributes` du kit à la racine de votre projet BR200, à côté de `Assets/`.

☑️ Collez votre ID d’application Fusion dans Tools / Fusion / Realtime Settings, et notez votre **version de l’application**.

{% hint style="info" %}
Les clients et le serveur **doivent utiliser le même ID d’application, la même version de l’application et la même région Photon**, sinon ils ne se trouveront pas.
{% endhint %}

☑️ Définissez **Peer Mode** sur `Single` dans Tools / Fusion / Network Project Config.

☑️ Exécutez Tools / Edgegap BR200 / Check Project et corrigez tout problème signalé.

Vous n’avez pas besoin de modifier la scène ou le script Loader. Le mode serveur, l’adresse, le port, la session et la région sont passés en ligne de commande.

{% hint style="info" %}
Si votre console affiche `Le code non sécurisé ne peut apparaître que si la compilation est effectuée avec /unsafe` juste après la première importation, fermez et rouvrez votre projet.
{% endhint %}

✅ Vous pouvez maintenant passer à l’étape suivante.

### 2. Compiler et téléverser le serveur

☑️ Pour commencer, vous devrez [créer un compte gratuit sur Edgegap](https://app.edgegap.com/auth/register). Aucune carte de crédit requise.

☑️ Compilez et téléversez votre serveur avec le plugin Edgegap ou depuis un terminal :

{% tabs %}
{% tab title="Plugin Edgegap (recommandé)" %}
☑️ Exécutez Tools / Edgegap BR200 / Build Linux Server. Il vérifie votre projet, active *Autoriser le code 'unsafe'* si nécessaire, et compile le **serveur** sous-cible en `Builds/EdgegapServer`.

☑️ Ouvrez Tools / Edgegap Server Hosting. À l’étape **3. Conteneurisez votre serveur**, cliquez sur **Path To Dockerfile** et sélectionnez `edgegap/Dockerfile`. Conservez **Relative Build Path** à `Builds/EdgegapServer`, puis conteneurisez et téléversez.

☑️ Conservez le port `7777` / UDP lorsque le plugin crée votre version d’application.
{% endtab %}

{% tab title="Terminal (pour les agents)" %}
☑️ Trouvez votre [registre de conteneurs](https://docs.edgegap.com/fr/learn/advanced-features/edgegap-container-registry.md#getting-your-credentials) nom de projet et vos identifiants, puis connectez-vous avec `docker login registry.edgegap.com`.

☑️ Compilez votre serveur, puis empaquetez et publiez l’image (Git Bash fonctionne sous Windows) :

{% code collapsedlinecount="10" %}

```bash
scripts/build-server.sh
scripts/package.sh registry.edgegap.com/<your-registry-project>/br200
```

{% endcode %}

`package.sh` affiche le nouveau tag qu’il a publié.

☑️ [Créez une application](https://app.edgegap.com/application-management/applications/list) et une version pour votre image. Vous pouvez aussi utiliser les `examples/app-version.json` avec `POST /v1/app/{app}/version`.
{% endtab %}
{% endtabs %}

{% hint style="danger" %}
:x: **À ÉVITER — écraser les tags existants ou utiliser `latest`  tag** — cela déploiera un cache obsolète.\
:white\_check\_mark: **À FAIRE — toujours incrémenter votre tag de version** et déployer la nouvelle version.
{% endhint %}

☑️ Configurez la version de votre application avec :

* [port](https://docs.edgegap.com/fr/learn/orchestration/application-and-versions.md#port-mapping) `7777`, protocole **UDP**, nommé `gameport`,
* [politique de redémarrage](https://docs.edgegap.com/fr/learn/orchestration/application-and-versions.md#safety-guardrails) `jamais` - le déploiement se termine lorsque la partie se termine et que le serveur quitte,
* durée maximale légèrement supérieure à votre partie la plus longue (60 minutes dans l’exemple),
* ressources : 1 vCPU et 2 Go comme point de départ.

✅ Vous pouvez maintenant passer à l’étape suivante.

### 3. Tester localement

☑️ Exécutez votre image localement avec les mêmes variables injectées qu’un vrai déploiement reçoit :

{% code collapsedlinecount="10" %}

```bash
scripts/run-local.sh eu
```

{% endcode %}

☑️ Rejoignez le nom de session affiché depuis deux éditeurs ou deux builds clients, en utilisant **Option B** de l’étape suivante avec ce nom de session et la région que vous avez fournie.

{% hint style="info" %}
Les clients locaux se connectent **Relais**, car des clients sur la même machine ne peuvent pas atteindre directement l’adresse NAT de Docker Desktop. Sur Edgegap, la même image se connecte **Direct**.
{% endhint %}

✅ Vous pouvez maintenant passer à l’étape suivante.

### 4. Déployer et se connecter

☑️ Démarrez un déploiement depuis le plugin, [tableau de bord](https://app.edgegap.com/deployment-management/deployments/list), ou `POST /v2/deployments` avec les `examples/deploy-request.json`. Transmettez les adresses IP publiques de vos joueurs pour [déployer près d’eux](https://docs.edgegap.com/fr/learn/orchestration/deployments.md#server-placement).

Le FQDN de votre déploiement (par ex. `0a1b2c3d4e5f.pr.edgegap.net`) est aussi le nom de session et de serveur BR200. Les premières lignes du journal du serveur affichent l’adresse de liaison, l’adresse publique et la région Photon choisie :

{% code collapsedlinecount="10" %}

```
[edgegap-br200] deployment=0a1b2c3d4e5f session=0a1b2c3d4e5f.pr.edgegap.net bind=0.0.0.0:7777/udp public=203.0.113.10:31502
[edgegap-br200] photon_region=eu (le plus proche de Francfort (50.11, 8.68)) max_players=200 mode=default scene=default
```

{% endcode %}

☑️ Connectez un client avec l’une de ces options :

* **Option A : Menu** - ouvrez `TPSBR/Scenes/Menu`, appuyez sur ▶️ Play, choisissez la même région et rejoignez le serveur depuis la liste,
* **Option B : connexion automatique via Standalone Manager** - ouvrez la scène définie comme **scène Batch Mode**. Dans **Standalone Manager**, définissez Game Mode `Client`, définissez Server Name et Session Name sur votre FQDN, définissez Region sur la région du serveur, puis appuyez sur ▶️ Play.

{% hint style="warning" %}
BR200 lance un **minuteur d’attente de 120 secondes au démarrage du serveur**. Les joueurs qui rejoignent après son expiration sont considérés comme éliminés. Déployez une fois votre groupe prêt, et connectez les clients dès que le déploiement est Ready.
{% endhint %}

☑️ Appuyez sur **Tab** dans un client connecté. Le coin supérieur gauche de la surcouche affiche **CT** (type de connexion), qui doit indiquer **Direct**.

🙌 Félicitations pour votre premier déploiement sur Edgegap !

## 🔄 Cycle de vie d’une partie

1. Edgegap démarre le déploiement et [injecte `ARBITRIUM_*` variables](https://docs.edgegap.com/fr/learn/orchestration/deployments.md#injected-environment-variables).
2. `edgegap/start-server.sh` les transforme en options de ligne de commande de BR200. Il transmet toujours `-dedicatedServer -ip 0.0.0.0 -port 7777`, nomme la session d’après le FQDN du déploiement et choisit la région Photon la plus proche du déploiement.
3. Les clients trouvent le serveur dans la même région Photon et se connectent en Direct.
4. Lorsque BR200 se ferme à la fin de la partie, le script appelle `ARBITRIUM_DELETE_URL` pour arrêter le déploiement, ainsi une partie terminée arrête la facturation immédiatement. Lorsque Edgegap arrête le déploiement, le script transmet plutôt le signal d’arrêt à BR200.

Voir [Déploiements](https://docs.edgegap.com/fr/learn/orchestration/deployments.md) pour en savoir plus.

## ⚙️ Variables d’environnement

Edgegap [injecte `ARBITRIUM_*` variables](https://docs.edgegap.com/fr/learn/orchestration/deployments.md#injected-environment-variables) automatiquement. Définissez ces `BR200_*` variables sur la version de votre application (à chaque partie) ou sur la demande de déploiement (pour cette partie uniquement) :

| Variable                 | Par défaut                                                                                                                 | Option BR200                                     |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------ |
| `BR200_SESSION`          | Le FQDN du déploiement, `<ARBITRIUM_REQUEST_ID>.pr.edgegap.net`                                                            | `-sessionName`                                   |
| `BR200_SERVER_NAME`      | Identique à la session                                                                                                     | `-serverName`                                    |
| `BR200_REGION`           | `auto`: la région Photon la plus proche du déploiement. `best`: laissez Fusion effectuer un ping. Ou un code tel que `eu`. | `-region`                                        |
| `BR200_REGION_ALLOWLIST` | Toutes les régions Photon. Codes séparés par des virgules que `auto` peut choisir.                                         |                                                  |
| `BR200_MAX_PLAYERS`      | `200` (1 à 200)                                                                                                            | `-maxPlayers`                                    |
| `BR200_MODE`             | par défaut de BR200. `battleRoyale`, `deathmatch` ou `elimination`.                                                        | `-battleRoyale` / `-deathmatch` / `-elimination` |
| `BR200_SCENE`            | La scène Batch Mode du Loader                                                                                              | `-scene`                                         |
| `BR200_LOBBY`            | par défaut de BR200                                                                                                        | `-lobby`                                         |
| `BR200_FPS`              | taux de ticks de Fusion                                                                                                    | `-fps`                                           |
| `BR200_RECORD`           | `false`. `true` écrit les statistiques de session dans `/data`.                                                            | `-recordSession -dataPath /data`                 |
| `BR200_EXTRA_ARGS`       | Aucune. Les autres options sont ajoutées en dernier.                                                                       |                                                  |
| `BR200_SELF_STOP`        | `true`. Arrêtez le déploiement lorsque BR200 se ferme.                                                                     |                                                  |

Si vos clients utilisent une région Photon fixe, ou si votre application Photon n’autorise que certaines régions, définissez `BR200_REGION` sur le déploiement, ou restreignez `auto` avec `BR200_REGION_ALLOWLIST`.

## 🔌 Connexion directe

de BR200 `IP` et `Port` définissez l’adresse sur laquelle votre serveur **se lie** à. Le kit se lie `0.0.0.0:7777`, Fusion trouve lui-même l’adresse publique du déploiement, et les clients se connectent **Direct** - même si Edgegap donne aux joueurs un [port externe](https://docs.edgegap.com/fr/learn/orchestration/application-and-versions.md#port-mapping).

| serveur `IP`                 | Résultat                                                                                                                                                               |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `0.0.0.0` (ce kit)           | **Direct** sur Edgegap.                                                                                                                                                |
| `127.0.0.1`                  | Le serveur démarre, mais les clients sont **Relais** via Photon, ce qui ajoute de la latence. Rien à l’extérieur du conteneur ne peut atteindre l’adresse de loopback. |
| L’IP publique du déploiement | Le serveur **ne démarre pas** (`Échec de la liaison du socket`), car le conteneur ne possède pas cette adresse. Les clients reçoivent `GameNotFound`.                  |

{% hint style="warning" %}
Laissez `IP` vide ou `0.0.0.0`. **Ne le définissez pas sur `127.0.0.1` ni sur l’IP publique de votre déploiement.**
{% endhint %}

## 🚨 Dépannage

<details>

<summary><code>MethodAccessException ... CheckInvokeRpc</code> dans le journal du serveur</summary>

* Votre serveur a été compilé avec Mono. Recompilez-le avec IL2CPP.

</details>

<details>

<summary><code>Aucune toolchain trouvée pour la plateforme hôte</code> ou <code>Aucun sysroot Linux trouvé</code></summary>

* Les paquets de toolchain Linux sont manquants, voir [Préparation](#preparation).

</details>

<details>

<summary>Le client reçoit <code>GameNotFound</code></summary>

* La version de l’application ou la région Photon diffère entre le client et le serveur. Comparez avec `photon_region=` la ligne du journal.

</details>

<details>

<summary>Le client reçoit <code>InvalidAuthentication</code></summary>

* Votre ID d’application Fusion est incorrect ou absent de la build.

</details>

<details>

<summary>La surcouche Tab affiche CT Relayed</summary>

* Votre serveur se lie `127.0.0.1`, voir [Connexion directe](#direct-connection).

</details>

<details>

<summary>Le serveur n’apparaît pas dans le menu</summary>

* La région du client diffère de celle du serveur, ou le minuteur d’attente de 120 secondes est déjà expiré.

</details>

<details>

<summary>Le déploiement se termine immédiatement avec <code>erreur : ...</code></summary>

* Un `BR200_*` valeur est invalide. La ligne du journal indique laquelle.

</details>

{% hint style="info" %}
Si vous avez besoin d’aide, [veuillez nous contacter sur Discord](https://discord.gg/MmJf8fWjnt). Pour l’assistance aux jeux en direct, consultez notre [système de tickets](https://edgegap.atlassian.net/servicedesk/customer/portal/3).
{% endhint %}
