> ## Documentation Index
> Fetch the complete documentation index at: https://docs.humalike.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Vue d'ensemble des intégrations

> Étendez Humalike via des domaines de fournisseurs indépendants et versionnés.

Humalike fonctionne de manière autonome et isole le comportement spécifique au
serveur derrière des fournisseurs. Un fournisseur est un descripteur Lua
enregistré par une ressource distincte via un export public.

## Domaines

| Domaine       | Côté    | Responsabilité                                                                      |
| ------------- | ------- | ----------------------------------------------------------------------------------- |
| `player`      | Serveur | Identité du personnage, état de chargement, métiers, service, notifications.        |
| `inventory`   | Serveur | Ajouter un objet à l'inventaire d'un personnage.                                    |
| `dispatch`    | Serveur | Traduire un incident neutre vers le système de dispatch du serveur.                 |
| `actions`     | Serveur | Exécuter des actions de PNJ spécifiques au serveur.                                 |
| `interaction` | Client  | Ajouter/retirer des options d'interaction avec les PNJ et afficher une progression. |

Les domaines sont volontairement indépendants. Un adaptateur joueur ne doit pas
choisir en plus une implémentation d'inventaire, de dispatch, d'action ou
d'interaction.

## Sélection

Les fournisseurs déclarent un nom, une version d'API, une priorité et un
callback de disponibilité facultatif. `auto` sélectionne l'unique fournisseur
disponible ayant la priorité la plus élevée. Une égalité est `ambiguous` ;
Humalike ne devine pas.

Les callbacks des fournisseurs s'exécutent dans la ressource qui les a
enregistrés, ils peuvent donc utiliser l'objet framework local et les exports de
cette ressource.

## Propriété et cycle de vie

* Les noms de fournisseurs appartiennent à la ressource qui les enregistre.
* Une autre ressource ne peut pas remplacer ce nom de fournisseur.
* Réenregistrer le même nom depuis la même ressource est idempotent.
* Arrêter la ressource propriétaire retire automatiquement ses fournisseurs.
* Démarrer ou arrêter une dépendance surveillée réévalue la disponibilité.
* Redémarrer Humalike crée une nouvelle époque d'exécution et émet
  `humalike:integration:ready` côté serveur et côté client.

Écoutez l'événement ready et enregistrez à nouveau. Cela permet à l'une ou
l'autre ressource de démarrer en premier et rend les redémarrages individuels
sûrs.

## Ce qui appartient à un pont

* Les recherches de joueurs et les règles de métiers spécifiques au framework.
* Les appels d'inventaire et les listes d'objets autorisés.
* La traduction des événements de dispatch.
* La validation et l'exécution d'actions personnalisées.
* L'intégration avec le système de ciblage ou l'interface.
* La traduction des événements roleplay du serveur vers les événements neutres de Humalike.

Ne copiez pas les internes de Humalike et ne modifiez pas le répertoire publié.
Commencez par le [guide du pont personnalisé](/fr/ai-npc/integrations/custom-bridge).

## Suite

* [Construire un pont personnalisé](/fr/ai-npc/integrations/custom-bridge).
* [Lire l'API des fournisseurs](/fr/ai-npc/integrations/provider-api).
* [Signaler les événements roleplay du serveur](/fr/ai-npc/integrations/world-events).