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

# Démarrage rapide

> Installez Humalike et parlez à votre premier PNJ IA.

Ce guide mène un serveur FiveM vierge de l'enregistrement à son premier PNJ IA.

## 1. Enregistrer le serveur

Ouvrez le [tableau de bord PNJ IA](https://humalike.ai/ai-npc), choisissez
**Enregistrer un serveur** et saisissez :

* Un nom qui identifie le serveur dans votre tableau de bord.
* Son URL de callback IPv4 publique globalement routable, par exemple
  `http://PUBLIC_IPV4:30120`.

Utilisez l'adresse IPv4 publique que les joueurs utilisent pour joindre le
FXServer. 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. L'URL doit
utiliser `http`, contenir un port non privilégié explicite (`1024`–`65535`) et
ne comporter ni chemin, ni requête, ni fragment.

Le tableau de bord affiche la nouvelle licence serveur une seule fois. Copiez-la
immédiatement. Vous pourrez renouveler plus tard une licence perdue ou exposée.

## 2. Télécharger la ressource

Téléchargez `humalike.zip` depuis la dernière
[release GitHub](https://github.com/Humalike/humalike-fivem-npc/releases/latest).
L'archive contient un répertoire `humalike` prêt à l'emploi.

Extrayez-le dans les ressources de votre serveur :

```text theme={null}
resources/
└── humalike/
    ├── fxmanifest.lua
    ├── integration/
    ├── npc/
    ├── voice/
    └── world/
```

## 3. Configurer FXServer

Ajoutez la licence juste avant le démarrage de la ressource :

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

<Warning>
  Utilisez `set`, et non `setr`, pour `humalike_license_key`. Une convar
  répliquée exposerait la licence aux clients connectés.
</Warning>

Ne configurez ni URL vocale ni secret vocal. Humalike provisionne la voix
automatiquement à partir de la licence serveur.

## 4. Vérifier la connexion

Démarrez le serveur et exécutez ceci dans sa console :

```text theme={null}
humalike_status
```

La ressource doit signaler des identifiants d'exécution installés et un
fournisseur joueur sélectionné. Les fournisseurs de framework et d'inventaire
apparaissent lorsque leurs dépendances sont en cours d'exécution.

## 5. Créer un PNJ

Dans le tableau de bord :

1. Ouvrez le serveur enregistré.
2. Sélectionnez **Créer un PNJ**.
3. Commencez par un PNJ **statique**.
4. Choisissez son nom, sa personnalité, sa langue, sa voix, son modèle et ses coordonnées.
5. Enregistrez-le et activez-le.

Le PNJ apparaît après le prochain rafraîchissement du registre. Vous pouvez aussi
redémarrer uniquement la ressource `humalike` pendant la mise en place d'un
nouveau serveur.

## 6. Parler

Rejoignez le serveur, approchez-vous du PNJ, maintenez la touche appuyer pour
parler configurée pour la voix et parlez. Humalike sélectionne le PNJ auquel
vous vous adressez d'après la proximité, la direction du regard, l'état de suivi
et le contexte du véhicule.

<Check>
  Si le PNJ apparaît, affiche un indicateur vocal actif et répond,
  l'installation de base est terminée.
</Check>

Si une étape échoue, consultez [Exploitation et dépannage](/fr/ai-npc/operations).

## Suite

* [Configurer Humalike](/fr/ai-npc/configuration) pour votre serveur.
* [Choisir une intégration de framework](/fr/ai-npc/frameworks).
* [Comprendre le ciblage vocal](/fr/ai-npc/voice).