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

# Operaciones y resolución de problemas

> Comprueba el estado en tiempo de ejecución y resuelve problemas habituales de instalación, NPC, voz y proveedores.

Empieza por los comandos de estado. Exponen el estado operativo admitido sin requerir
registros detallados.

## Comandos de estado

Ejecuta en la consola del servidor:

```text theme={null}
humalike_status
humalikenpc:status
```

`humalike_status` informa del arranque de credenciales y de los dominios de proveedor
`player`, `inventory`, `dispatch` y `actions`. `humalikenpc:status` informa del
proveedor de jugador seleccionado, el tamaño de la plantilla y la última sincronización
de la plantilla.

Ejecuta `humalike_status` en la consola F8 del cliente para inspeccionar el proveedor de
interacción; también imprime de dónde procede el ajuste de interacción: `server`
(establecido en server.cfg y recibido), `default` (los ajustes del servidor llegaron y
lo dejan en `auto`) o `local` (aún no recibido). Ejecuta `/voice` para inspeccionar la
conexión de voz local.

`humalikenpc:reload` solicita una actualización inmediata de la plantilla. Los comandos
de servidor y cliente están restringidos por ACE allí donde se aplican los permisos de
comandos de FiveM.

## Estados de proveedor

| Estado        | Significado                                                        | Acción                                                  |
| ------------- | ------------------------------------------------------------------ | ------------------------------------------------------- |
| `selected`    | Hay un proveedor disponible activo.                                | Ninguna.                                                |
| `disabled`    | El dominio está configurado como `none`.                           | Actívalo solo si la función es necesaria.               |
| `unavailable` | Ningún proveedor coincide con el ajuste.                           | Arranca su dependencia o corrige el nombre configurado. |
| `ambiguous`   | Los proveedores disponibles principales tienen la misma prioridad. | Selecciona uno explícitamente.                          |
| `degraded`    | Falló un callback del proveedor seleccionado.                      | Inspecciona ese puente o dependencia.                   |

## Registro de depuración temporal

```cfg theme={null}
set humalike_debug 1
```

Reinicia el recurso, reproduce un problema, recopila las líneas relevantes y vuelve a
ponerlo a `0`. El modo de depuración es ruidoso a propósito y no debería quedarse
activado en un servidor de producción con carga.

Elimina las credenciales y las URLs de conexión firmadas antes de compartir registros.

## El recurso no llega a estar listo

Comprueba, en orden:

1. `humalike_license_key` usa `set`, contiene la licencia de servidor actual y aparece
   antes de `ensure humalike`.
2. La URL de callback registrada contiene la dirección IPv4 pública literal enrutable
   globalmente de este FXServer.
3. El tráfico TCP entrante llega a ese puerto.
4. El registro del servidor está activado.
5. La build de FXServer es actual y OneSync está activado.

Rota la licencia solo si se ha perdido o expuesto; la rotación invalida el valor antiguo
de inmediato.

## Falta un NPC

* Confirma que el estado del servidor es listo y que el recuento de la plantilla no es
  cero.
* Confirma que el NPC y el servidor están activados en el panel.
* Para NPC estáticos, verifica el modelo, las coordenadas, la orientación, el routing
  bucket y la geometría del mapa.
* Para NPC ambientales, verifica que la política ambiental está activada y que los
  jugadores están en una zona con tráfico peatonal (una cordillera o mar abierto no
  reciben a nadie).
* Ejecuta `humalikenpc:reload` una vez en lugar de reiniciar el servidor repetidamente.

## El NPC no responde

* Verifica el micrófono del jugador y la asignación de PTT de Humalike.
* Usa `/voice` y comprueba que el NPC previsto no está silenciado para ese jugador.
* Acércate y mira al NPC para una conversación directa.
* Comprueba los [turnos de NPC](/es/npc-turns) disponibles del servidor.
* Confirma que el NPC tiene voz y está activado.

Un NPC también puede decidir no hablar según su personaje y la conversación actual.
Prueba varias intervenciones claras antes de tratar el silencio como un fallo de
conexión.

## `/me` o `/do` se ignora

La integración incorporada depende del evento de rol admitido por el framework. Un
recurso de chat personalizado puede mostrar el comando sin publicar ese evento. En ese
caso, llama a `ReportPlayerEvent` desde el handler de servidor del recurso de chat.
Consulta [Informar de eventos del jugador](/es/ai-npc/integrations/world-events).

## La acción de inventario no está disponible

Ejecuta `humalike_status` y comprueba el dominio `inventory`. `give_item` solo se
anuncia mientras hay un proveedor de inventario seleccionado. Resuelve un proveedor no
disponible o ambiguo y deja que Humalike actualice sus capacidades.

## Errores de callback NUI o de assets tras una actualización

La causa habitual son releases mezcladas. Detén Humalike, sustituye el directorio
completo del recurso por el contenido de un único `humalike.zip` y arráncalo de nuevo.
No superpongas releases ni copies solo los ficheros web compilados.

## Informar de un error

Incluye la versión de la release de Humalike, la versión del artefacto de FXServer, el
estado del framework y de los proveedores, los pasos exactos de reproducción y registros
saneados. Informa de los problemas de seguridad mediante el
[informe privado de vulnerabilidades](https://github.com/Humalike/humalike-fivem-npc/security/advisories/new).

## Siguiente

* [Consulta los comandos y exports públicos](/es/ai-npc/reference).
* [Revisa las recomendaciones de seguridad](/es/ai-npc/security).
* [Abre el panel de AI NPC](https://humalike.ai/ai-npc).