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

# Inicio rápido

> Instala Humalike y habla con tu primer NPC de IA.

Esta guía lleva un servidor de FiveM limpio desde el registro hasta su primer NPC de IA.

## 1. Registra el servidor

Abre el [panel de AI NPC](https://humalike.ai/ai-npc), elige **Registrar
servidor** e introduce:

* Un nombre que identifique el servidor en tu panel.
* Su URL de callback pública IPv4 enrutable globalmente, por ejemplo
  `http://PUBLIC_IPV4:30120`.

Usa la dirección IPv4 pública que usan los jugadores para llegar al FXServer. No se
aceptan nombres de host, IPv6, direcciones privadas, direcciones de loopback ni
direcciones de ejemplo reservadas. La URL debe usar `http`, contener un puerto explícito
no privilegiado (`1024`–`65535`) y no tener ruta, query ni fragmento.

El panel muestra la nueva licencia de servidor una sola vez. Cópiala de inmediato. Puedes
rotar más adelante una licencia perdida o expuesta.

## 2. Descarga el recurso

Descarga `humalike.zip` desde la última
[release de GitHub](https://github.com/Humalike/humalike-fivem-npc/releases/latest).
El archivo contiene un directorio `humalike` listo para ejecutar.

Extráelo en los recursos de tu servidor:

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

## 3. Configura FXServer

Añade la licencia justo antes de que arranque el recurso:

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

<Warning>
  Usa `set`, no `setr`, para `humalike_license_key`. Una convar replicada
  expondría la licencia a los clientes conectados.
</Warning>

No configures URLs de voz ni secretos de voz. Humalike aprovisiona la voz
automáticamente a partir de la licencia de servidor.

## 4. Verifica la conexión

Arranca el servidor y ejecuta esto en su consola:

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

El recurso debería informar de credenciales de tiempo de ejecución instaladas y de un
proveedor de jugador seleccionado. Los proveedores de framework e inventario aparecen
cuando sus dependencias están en ejecución.

## 5. Crea un NPC

En el panel:

1. Abre el servidor registrado.
2. Selecciona **Crear NPC**.
3. Empieza con un NPC **estático**.
4. Elige su nombre, personalidad, idioma, voz, modelo y coordenadas.
5. Guárdalo y actívalo.

El NPC aparece tras la siguiente actualización de la plantilla. Mientras configuras un
servidor nuevo también puedes reiniciar solo el recurso `humalike`.

## 6. Habla

Entra en el servidor, acércate al NPC, mantén pulsada la tecla de pulsar para hablar de
voz que tengas configurada y habla. Humalike selecciona el NPC al que te diriges a partir
de la proximidad, la dirección de la vista, el estado de seguimiento y el contexto del
vehículo.

<Check>
  Si el NPC aparece, muestra un indicador de voz activo y responde, la
  instalación básica está completa.
</Check>

Si algún paso falla, consulta [Operaciones y resolución de problemas](/es/ai-npc/operations).

## Siguiente

* [Configura Humalike](/es/ai-npc/configuration) para tu servidor.
* [Elige una integración de framework](/es/ai-npc/frameworks).
* [Entiende la selección de interlocutor por voz](/es/ai-npc/voice).