> ## 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.

# Installation et mises à jour

> Installez, ordonnez, mettez à jour et restaurez la ressource FiveM en toute sécurité.

## Installer une release

Utilisez l'archive `humalike.zip` des
[releases GitHub](https://github.com/Humalike/humalike-fivem-npc/releases). Ne
téléchargez pas les archives sources automatiques de GitHub : elles contiennent
les fichiers du dépôt, pas la ressource d'exécution composée.

Placez le répertoire `humalike` extrait directement dans un répertoire de
ressources et démarrez-le par son nom :

```cfg theme={null}
set humalike_license_key "ak_secret_replace_me"
ensure humalike
```

Le répertoire ne doit pas être imbriqué sous la forme `humalike/humalike`.

## Ordre des ressources

Humalike peut démarrer sans framework. Pour une sélection automatique dès le
démarrage initial, démarrez d'abord les dépendances optionnelles :

```cfg theme={null}
ensure oxmysql
ensure ox_lib
ensure es_extended       # or qb-core / qbx_core
ensure ox_inventory      # optional
ensure ox_target         # optional

ensure humalike
ensure my-humalike-bridge
```

Les dépendances démarrées tardivement ou redémarrées sont détectées. Un pont
personnalisé doit démarrer après `humalike` et le déclarer comme dépendance.

## Réseau du callback

L'URL de callback enregistrée dans le tableau de bord doit atteindre le FXServer
depuis l'internet public. Autorisez le trafic TCP entrant vers le port serveur
sélectionné. Si vous changez le port ou l'adresse publique du FXServer, mettez à
jour le callback dans le tableau de bord.

Le format de l'URL est :

```text theme={null}
http://PUBLIC_IPV4:port
```

L'hôte doit être une adresse IPv4 littérale globalement routable. Les noms
d'hôte, l'IPv6, les adresses privées, les adresses de bouclage et les adresses
d'exemple réservées ne sont pas acceptés. Les ports pris en charge sont
`1024`–`65535` ; n'ajoutez ni chemin, ni requête, ni fragment.

## Mettre à jour

1. Téléchargez la nouvelle release et vérifiez sa somme de contrôle SHA-256 publiée.
2. Arrêtez `humalike` ou arrêtez le FXServer.
3. Conservez l'ancien répertoire comme copie de restauration en dehors de
   l'arborescence de ressources active.
4. Remplacez le répertoire `humalike` complet.
5. Démarrez-le et exécutez `humalike_status`.

Ne fusionnez pas une nouvelle release par-dessus l'ancien répertoire. Les
fichiers supprimés resteraient actifs et pourraient produire un comportement de
versions mélangées.

Conservez le code personnalisé dans une ressource pont séparée. La mise à jour
de Humalike ne doit jamais écraser les métiers, la logique de dispatch, les
récompenses ou les hooks d'interface propres au serveur.

## Restaurer

Arrêtez la ressource, restaurez le répertoire complet de la release précédente
et redémarrez-la. La licence serveur reste valide. Si le schéma du tableau de
bord ou le comportement serveur requis a changé dans une release, suivez les
notes de cette release avant de restaurer.

## Builds de développement

Les serveurs de production doivent utiliser les archives de release. Les
checkouts du dépôt nécessitent une build du frontend et sont destinés uniquement
aux contributeurs. Une release contient déjà tous les assets NUI compilés.

## Suite

* [Terminer le démarrage rapide](/fr/ai-npc/quickstart).
* [Passer en revue la configuration](/fr/ai-npc/configuration).
* [Préparer l'exploitation en production](/fr/ai-npc/operations).