> 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-simple-fps.md).

# Photon Fusion 2 Simple FPS

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

Découvrez comment héberger des projets Unity sur Edgegap en utilisant les techniques du [Simple FPS Multiplayer Sample](https://assetstore.unity.com/packages/templates/tutorials/simple-fps-multiplayer-photon-fusion-272941). Les joueurs rejoignent un serveur depuis le **Party** en saisissant l'adresse du déploiement et la région Photon.

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

Cet exemple montre :

* **Simple FPS en tant que serveur dédié** - un déploiement par match, [placé près des joueurs](https://docs.edgegap.com/fr/learn/orchestration/deployments.md#server-placement).
* **Connexion du menu Party** - la carte Join prend votre FQDN de déploiement et un code de région Photon, **Créer une partie** est inchangé.
* **Connexions directes** - le serveur se lie `0.0.0.0` sur le port `7777`, donc les clients se connectent directement.
* **Un seul projet pour les deux côtés** - les builds serveur et client partagent la même liste de scènes.
* **Arrêt automatique du serveur** - lorsque le processus serveur se termine de lui-même, le script de démarrage arrête le déploiement.

{% 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**. Consultez le [README](https://github.com/edgegap/netcode-game-sample-photon-fusion2-simple-fps) pour la liste complète des fichiers et des résultats de test.
{% endhint %}

## ✔️ Préparation

Avant de commencer, vous aurez besoin de :

* [Simple FPS Multiplayer (Photon Fusion)](https://assetstore.unity.com/packages/templates/tutorials/simple-fps-multiplayer-photon-fusion-272941) - à télécharger et importer dans un nouveau projet Unity.
  * Cet exemple apporte ses propres paramètres de projet.
* [kit Edgegap Simple FPS](https://github.com/edgegap/netcode-game-sample-photon-fusion2-simple-fps),
* Unity 6000.3 avec les modules de build Linux ci-dessous, et **Windows Build Support (IL2CPP)** pour les clients (nécessite la charge de travail C++ de Visual Studio),
* 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 build serveur en suivant les [Unity](https://docs.edgegap.com/fr/unity.md) étapes de préparation.
{% endhint %}

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

{% hint style="warning" %}
Votre serveur **doit utiliser IL2CPP** (valeur par défaut de l'exemple). Les serveurs Mono échouent irrémédiablement à l'exécution.
{% endhint %}

☑️ Pour compiler Linux IL2CPP sous Windows, ajoutez la toolchain 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 se connecter

### 1. Ajoutez le kit à votre projet

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

☑️ Collez votre ID d'application Fusion dans Tools / Fusion / Realtime Settings.

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

{% hint style="warning" %}
Le package Asset Store inclut également un `PhotonAppSettings` asset dans `Assets/AssetStoreTools/Resources/` avec l'ID d'application de l'éditeur. **Mettez-y aussi votre ID d'application, ou supprimez cette copie.**
{% endhint %}

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

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

☑️ Exécutez Tools / Edgegap Simple FPS / Set Up Project. Cela ne modifie que les paramètres de scène et de build, et peut être relancé sans risque :

* Deathmatch : `FusionBootstrap` devient `EdgegapFusionBootstrap` (en conservant ses paramètres), et le mode de démarrage devient **Interface utilisateur**,
* Démarrage : du menu Party `FusionMenuUIParty` devient `EdgegapPartyMenu` (l'instance du prefab du menu est décomposée pour permettre cela),
* Le champ de code de la carte Join accepte jusqu'à 30 caractères (lettres, chiffres et points) et obtient un nouveau **Région** champ à côté,
* le profil de build est défini sur Startup (0), puis Deathmatch (1).

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

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

☑️ Pour commencer, vous devrez [créer un compte gratuit chez 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é)" %}
☑️ 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 Conteneuriser et téléverser.

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

{% tab title="Terminal (pour les agents)" %}
☑️ Trouvez votre [Container Registry](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 poussez l'image (Git Bash fonctionne sous Windows) :

{% code collapsedlinecount="10" %}

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

{% endcode %}

`package.sh` affiche le nouveau tag qu'il a poussé.

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

La première compilation du serveur IL2CPP prend environ 13 minutes.

{% 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 %}

Vous pouvez aussi compiler depuis l'éditeur avec Tools / Edgegap Simple FPS / Build Linux Server, qui génère la même sortie dans `Builds/EdgegapServer`. Voir [Unity](https://docs.edgegap.com/fr/unity.md) pour en savoir plus sur la compilation de serveurs Unity.

{% hint style="warning" %}
Si vous empaquetez votre serveur avec le plugin Unity d'Edgegap, définissez son **Path To Dockerfile** sur `edgegap/Dockerfile`.
{% endhint %}

☑️ [Créez une application](https://app.edgegap.com/application-management/applications/list) et une version avec :

* votre image et votre tag,
* votre nom d'utilisateur et votre jeton Container Registry,
* ressources 1 vCPU et 2 Go au démarrage,
* [port](https://docs.edgegap.com/fr/learn/orchestration/application-and-versions.md#port-mapping) `7777`, protocole **UDP**, avec la vérification du port désactivée.

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

### 3. Tester localement

☑️ Compilez une image locale et exécutez-la avec les variables qu'Edgegap injecterait :

{% code collapsedlinecount="10" %}

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

{% endcode %}

☑️ Repérez la ligne de log `[edgegap-simplefps] server started: session=f68e011bfb01.pr.edgegap.net photon_region=<code>` et rejoignez depuis un client avec cette session et cette région, comme à l'étape suivante.

{% hint style="info" %}
Les clients locaux se connectent **Relayé**, 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

☑️ Lancez un déploiement depuis le plugin, [tableau de bord](https://app.edgegap.com/deployment-management/deployments/list), ou `POST /v2/deployments`. Passez les IP publiques de vos joueurs à [déployer près d'eux](https://docs.edgegap.com/fr/learn/orchestration/deployments.md#server-placement).

☑️ Trouvez `server started: session=<fqdn> photon_region=<code>` dans les journaux de votre déploiement.

☑️ Compilez un client avec `scripts/build.sh client` (ou votre build Windows habituel), lancez-le et cliquez sur **Party Menu** dans le menu principal.

☑️ Sur la carte Join, saisissez le FQDN de votre déploiement (par ex. `f68e011bfb01.pr.edgegap.net`) dans le champ de code, et le code de région (par ex. `cae`) dans le **Région** champ, puis cliquez sur **Join**.

{% hint style="info" %}
Si votre client ne se connecte pas, votre région ne correspond probablement pas au journal du serveur.
{% endhint %}

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

## 🔄 Cycle de vie du match

1. Le build serveur ignore le menu Startup et charge Deathmatch.
2. `EdgegapFusionBootstrap` démarre un serveur Fusion sur `ARBITRIUM_PORT_GAMEPORT_INTERNAL` (`7777` par défaut), lié à `0.0.0.0`, et nomme la session d'après le FQDN du déploiement, `<ARBITRIUM_REQUEST_ID>.pr.edgegap.net`.
3. Le serveur enregistre le nom de session et la région Photon, que les joueurs saisissent dans la carte Join du menu Party et se connectent en Direct au déploiement.
4. Lorsque le processus serveur se termine de lui-même, `edgegap/start-server.sh` appelle `ARBITRIUM_DELETE_URL` pour arrêter le déploiement.

{% hint style="info" %}
Le script de démarrage n'affiche jamais l'environnement, donc **votre jeton de suppression reste hors des journaux**.
{% endhint %}

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

## ⚙️ Variables d'environnement

| Variable                                         | Défini par                    | Effet                                                                                                                                                                                                  |
| ------------------------------------------------ | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `ARBITRIUM_REQUEST_ID`                           | Edgegap                       | Le nom de session devient `<request id>.pr.edgegap.net`, le FQDN du déploiement.                                                                                                                       |
| `ARBITRIUM_PORT_GAMEPORT_INTERNAL`               | Edgegap                       | Le port UDP auquel le serveur se lie (`7777` par défaut). Il se lie `0.0.0.0`, donc les clients se connectent en Direct.                                                                               |
| `PHOTON_REGION`                                  | Vous (version ou déploiement) | Une région Photon fixe, par exemple `us`. Lorsqu'elle n'est pas définie, le serveur utilise la région offrant le meilleur ping depuis son lieu d'exécution. Cette surcharge n'a pas encore été testée. |
| `ARBITRIUM_DELETE_URL`, `ARBITRIUM_DELETE_TOKEN` | Edgegap                       | Lorsque le processus serveur se termine de lui-même, le script de démarrage les utilise pour arrêter le déploiement.                                                                                   |

Voir [variables injectées](https://docs.edgegap.com/fr/learn/orchestration/deployments.md#injected-environment-variables) pour en savoir plus.

## 🔌 Connexion directe

du Simple FPS  `IP` et `Port` définissent l'adresse à laquelle votre serveur **se lie** se lie. Le kit 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 **Relayé** via Photon, ce qui ajoute de la latence. Rien à l'extérieur du conteneur ne peut atteindre l'adresse 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 obtiennent `GameNotFound`.              |

## 🎬 Scènes du serveur

Fusion indique aux clients quelle scène charger en fonction de **l'index de build**. Un serveur compilé avec seulement Deathmatch aurait Deathmatch à l'index 0, tandis que les clients ont Startup à l'index 0. Les clients ne trouvent alors jamais les objets de jeu et déclenchent `NullReferenceException` dans `Player.FixedUpdateNetwork` à chaque tick. C'est pourquoi les deux builds utilisent Startup (0) et Deathmatch (1), et le serveur ignore Startup.

Pour la même raison, le serveur marque Deathmatch **actif au chargement**, comme l'hôte natif de l'exemple. Sans cela, les clients chargent Deathmatch mais laissent Startup actif, avec la même exception.

## ⚠️ Problèmes connus

* Terminer un match, et savoir si le serveur se ferme après un match, n'ont pas encore été testés - voir le [README](https://github.com/edgegap/netcode-game-sample-photon-fusion2-simple-fps).
* `PHOTON_REGION` la surcharge n'a pas encore été testée.

## 🚨 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 obtient <code>GameNotFound</code></summary>

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

</details>

<details>

<summary>Le client obtient <code>InvalidAuthentication</code></summary>

* Votre ID d'application Fusion est incorrect ou manquant dans le build.

</details>

<details>

<summary>La superposition de l'onglet affiche CT Relayé</summary>

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

</details>
