> 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/unity/developer-tools.md).

# Outils pour développeurs

Outils Edgegap pour développeurs Unity, conçus pour une itération rapide et des déploiements fréquents de vos serveurs de jeu multijoueurs.

Nous développons ces outils pour vous avec un mantra simple : « les clés d’équipes performantes sont l’itération rapide et les tests fréquents ». Si vous voyez une opportunité d’amélioration, veuillez nous le faire savoir dans notre [Discord communautaire](https://discord.gg/NgCnkHbsGp). Nous espérons que vous bénéficierez d’une expérience fluide. 🚀

{% hint style="info" %}
[Trouvez des exemples concrets](https://docs.edgegap.com/fr/docs/sample-projects/unity-netcodes.md) que vous pouvez utiliser comme point de départ d’un projet et modifier davantage.
{% endhint %}

#### Versionnement sémantique

Nos outils de développement et nos services managés utilisent la version officielle [Versionnement sémantique](https://semver.org/), indiquant quelles mises à jour sont ✅ sûres (mineures, correctifs) et lesquelles peuvent contenir des changements incompatibles ⚠️ (majeurs).

**Une fois qu’une version est publiée, elle ne sera jamais modifiée/changée**.

{% hint style="warning" %}
**Pour mettre à niveau la version du service - Arrêter, Modifier, Redémarrer.** Le redémarrage rapide n’appliquera pas les changements de version.
{% endhint %}

## ⚡ Plugin de démarrage rapide pour serveurs dédiés

Créez et lancez votre serveur de jeu dédié dans le cloud directement depuis votre éditeur Unity !

* [Plugin Dedicated Servers pour Unity - solution clé en main, code source et notes de version complètes.](https://github.com/edgegap/buildtool-unity-plugin)

{% hint style="success" %}
Ce plugin est fourni 100 % gratuitement, conformément aux conditions générales du niveau gratuit.
{% endhint %}

Toutes les versions Long Term Support (LTS) de Unity3D à partir de 2021.3+ sont officiellement prises en charge.

Ce plugin contient des fonctionnalités destinées à vous aider à :

* construire et conteneuriser vos serveurs dédiés pour Linux,
* tester localement l’image Docker de votre serveur,
* téléverser et déployer votre serveur sur Edgegap.

{% hint style="info" %}
Ce plugin ne modifie aucun comportement du jeu, c’est simplement un outil de développement pratique pour les tâches Edgegap. Le plugin n’est pas inclus dans vos builds, car il est utilisé uniquement lors de la préparation de la compilation du serveur.
{% endhint %}

#### Installation

Veuillez vous référer à [le dépôt officiel du plugin](https://github.com/edgegap/buildtool-unity-plugin) pour des instructions détaillées sur l'installation.

Ce plugin a été testé et prend en charge les versions de Unity 2021.2 et ultérieures, y compris toutes les versions LTS, Unity 2023 et Unity 6.

{% embed url="<https://youtu.be/3a5veDyxpoE>" %}

<details>

<summary>Installer les modules de prise en charge de compilation Linux pour Unity</summary>

* Utilisez Unity Hub pour sélectionner l'onglet **Installe**, accéder à **Paramètres** et **Ajouter des modules** pour chaque version d'Unity que vous avez l'intention d'utiliser avec la plateforme Edgegap :

<figure><img src="https://3008966946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FylRG4r8orenZrw5ijjpJ%2Fimage.png?alt=media&amp;token=fb981825-8a15-4c07-9180-0f79a6a77a91" alt=""><figcaption></figcaption></figure>

* Faites défiler vers le bas pour sélectionner et installer les modules Unity suivants :
  * **Prise en charge de compilation Linux (IL2CPP),**
    * **Prise en charge de compilation Linux (Mono),**
    * **Prise en charge de compilation pour serveur dédié Linux**

<figure><img src="https://3008966946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FuXtyqoLhBOk8CZJ4WdzA%2Fimage.png?alt=media&amp;token=19e956ed-a731-420d-b911-130c334794fc" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><a href="https://www.docker.com/products/docker-desktop/">Installez Docker Desktop (ou Docker CLI)</a></summary>

* [Installez Docker Desktop à partir de la source officielle](https://www.docker.com/products/docker-desktop/) (aucun compte requis).
* Redémarrez votre ordinateur après avoir terminé l'installation.

</details>

{% hint style="success" %}
Voir [Unity](https://docs.edgegap.com/fr/unity.md) pour commencer et pour des instructions détaillées sur l’utilisation du plugin.
{% endhint %}

<details>

<summary>Dépannage et FAQ</summary>

Erreur Unity : `[Fenêtre du gestionnaire de paquets] Erreur lors de l’ajout du package : https://github.com/edgegap/buildtool-unity-plugin.git`

* Pour ajouter notre plugin via une URL git, vous devrez avoir installé le client git ([#installation](#installation "mention")).

***

Erreur Unity : `Support de compilation Linux manquant`

* Voir [#usage-requirements](#usage-requirements "mention"), il vous manque très probablement les modules de support de compilation Linux, que vous pouvez installer via Unity Hub. Assurez-vous de choisir la même version d’Unity que celle de votre projet.

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

{% hint style="info" %}
**Pour les développeurs de plugins** - si vous souhaitez détecter la présence de ce plugin dans l’éditeur de l’utilisateur, vous pouvez le faire à l’aide d’une directive de compilation `#if EDGEGAP_PLUGIN_SERVERS {votre code} #endif` .
{% endhint %}

## ⭐ Kit de développement logiciel

Le SDK Unity contient des utilitaires d’intégration facultatifs pour les déploiements, le matchmaking et le navigateur de serveurs. Ce plug-in prend officiellement en charge Unity 2021.3.0f1 et les versions ultérieures.

{% hint style="info" %}
**La dernière version du SDK Unity est la `3.5.6`**. Tous les exemples de cette documentation sont à jour.
{% endhint %}

{% hint style="success" %}
Ce plug-in est fourni entièrement gratuitement, conformément aux conditions générales de l’offre gratuite.
{% endhint %}

#### Prérequis

<details>

<summary>Installez un client Git (par exemple <a href="https://git-scm.com/">git-scm</a>)</summary>

Unity a besoin d’un client Git pour télécharger et installer automatiquement notre package Unity. Une fois le client installé, vous n’aurez pas besoin d’utiliser Git directement.

</details>

#### Installation

1. Ouvrez votre projet Unity,
2. sélectionnez `Window > Package Management > Package Manager` ,
3. Cliquez sur l’ :heavy\_plus\_sign: icône, puis sélectionnez `Add package from git URL...` ,
4. Lorsque vous y êtes invité, saisissez l’URL de notre SDK :

{% code title="" collapsedlinecount="10" %}

```
https://github.com/edgegap/sdk-unity-sessions-matchmaker-server-browser.git
```

{% endcode %}

5. Cliquez sur `Add`  et attendez la fin de l’installation.

#### Importer les exemples

Ce package comprend plusieurs exemples, conçus pour être utilisés individuellement (ne combinez pas les exemples).

#### Sources vérifiées

Il s’agit de l’unique canal de distribution officiel de ce SDK. Ne faites pas confiance aux sources non vérifiées !

#### Mettre à jour le package

Dans le gestionnaire de packages Unity, accédez au SDK Edgegap et cliquez sur `Update` .

{% hint style="warning" %}
**Les exemples importés ne sont pas mis à jour automatiquement !** Sauvegardez les valeurs de propriétés personnalisées, supprimez les scripts d’exemple actuellement utilisés dans votre scène, puis réimportez les exemples.
{% endhint %}

{% hint style="info" %}
Certaines versions peuvent inclure des changements incompatibles. Elles sont signalées par une nouvelle version MAJEURE.
{% endhint %}

#### Mise à jour vers la version 3

Cette mise à jour comprend de nombreux nouveaux [Navigateur de serveurs](https://docs.edgegap.com/fr/unity/server-browser.md) utilitaires et exemples, améliore la gestion des erreurs de matchmaking, et bien plus encore. Consultez [Notes de version](https://docs.edgegap.com/fr/docs/release-notes.md) pour obtenir la liste complète.

{% hint style="warning" %}
La mise à jour 3 du SDK Unity inclut quelques changements incompatibles. Veuillez tester à nouveau soigneusement votre intégration.
{% endhint %}

<details>

<summary>Changements incompatibles de la version 3 du SDK Unity — portée, impact et résolution</summary>

Dans l’espace de noms `Edgegap.Matchmaking`:

* Méthode fusionnée `Client._Abandon -> Client.StopMatchmaking` .
  * Faible impact : concerne principalement les implémentations personnalisées de gestionnaires clients.
  * Résolution : remplacez les appels à `_Abandon` par la méthode `StopMatchmaking` .
* Écouteur d’événement fusionné `onTicketUpdate -> onAssignmentUpdate`.
  * Faible impact : la plupart des implémentations n’avaient pas besoin d’utiliser cet écouteur.
  * Résolution : recherchez et remplacez par [nouveaux événements](https://docs.edgegap.com/unity/matchmaking#client-events) sous `onAssignmentUpdate` écouteur.
* Dissocié `Ping` , `SafeHttpRequest` , et `Observable` . Déplacé vers l’espace de noms `Edgegap` .
  * Impact faible : les fonctionnalités restent identiques, elles ont simplement été déplacées vers un autre espace de noms.
  * Résolution : mettez à jour les instructions d’importation ou les références aux espaces de noms si nécessaire.
* Suppression de la fonctionnalité de mise en cache en raison de sa mauvaise compatibilité avec la console et des difficultés d’intégration.
  * Impact faible : les joueurs ayant subi un plantage risquent de créer des tickets en double au lieu de reprendre à partir du cache.
  * Résolution : implémentez un cache personnalisé à l’aide de `onAssignmentUpdate` comme écouteur d’événement.
* Assembly renommé `com.edgegap.unity-matchmaking-sdk -> com.edgegap.unity-sdk` .
  * Impact faible : concerne certaines chaînes de compilation hautement personnalisées qui référencent ce SDK.
  * Résolution : mettez à jour les références au nom de l’assembly du SDK dans vos outils personnalisés.

</details>

<details>

<summary>Dépannage et FAQ</summary>

Unity : `[Fenêtre du gestionnaire de paquets] Erreur lors de l’ajout du package : https://github.com/edgegap/sdk-unity-sessions-matchmaker-server-browser.git`

* Pour ajouter notre plugin via une URL git, vous devrez avoir installé le client git.

***

Visual Studio : `le nom du type ou de l’espace de noms est introuvable` pour l’espace de noms Edgegap.

1. Dans l’éditeur Unity, allez à **Édition / Préférences / Outils externes / Générer les fichiers .csproj**.
2. Assurez-vous d’avoir activé **les packages Git**.
3. Cliquez sur **Régénérer les fichiers du projet**.

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

## 📫 Bibliothèque Distributed Relay Transports

Trouvez un Transport personnalisé pour votre bibliothèque netcode afin d’utiliser les relais distribués dans les jeux en pair à pair.

[Voir la documentation](https://docs.edgegap.com/fr/learn/distributed-relay/relay-transport-samples.md):

* Téléchargez les exemples Edgegap Relay :
  * [Exemple Mirror](https://github.com/edgegap/relay-sample-unity-mirror-),
  * [Exemple FishNet](https://github.com/edgegap/relay-sample-unity-fishnet-),
  * [Exemple Unity NGO](https://github.com/edgegap/relay-sample-unity-ngo-helloworld).
* [Bibliothèque Edgegap Relay Transport - code source et notes de version pour les netcodes pris en charge.](https://github.com/edgegap/relay-transport-template-model)
