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

# Instalación y actualizaciones

> Instala, ordena, actualiza y revierte el recurso de FiveM de forma segura.

## Instalar una release

Usa el archivo `humalike.zip` de
[GitHub Releases](https://github.com/Humalike/humalike-fivem-npc/releases). No
descargues los archivos de código fuente automáticos de GitHub: contienen los ficheros
del repositorio, no el recurso de tiempo de ejecución compuesto.

Coloca el directorio `humalike` extraído directamente en un directorio de recursos y
arráncalo por nombre:

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

El directorio no debe quedar anidado como `humalike/humalike`.

## Orden de recursos

Humalike puede arrancar sin un framework. Para que la selección automática funcione
durante el arranque inicial, arranca primero las dependencias opcionales:

```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
```

Las dependencias que arrancan tarde o se reinician se detectan. Un puente personalizado
debería arrancar después de `humalike` y declararlo como dependencia.

## Red del callback

La URL de callback registrada en el panel debe llegar al FXServer desde la internet
pública. Permite el tráfico TCP entrante al puerto del servidor seleccionado. Si cambias
el puerto o la dirección pública del FXServer, actualiza el callback en el panel.

El formato de la URL es:

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

El host debe ser una dirección IPv4 literal enrutable globalmente. No se aceptan nombres
de host, IPv6, direcciones privadas, direcciones de loopback ni direcciones de ejemplo
reservadas. Los puertos admitidos son `1024`–`65535`; no añadas ruta, query ni
fragmento.

## Actualizar

1. Descarga la nueva release y verifica su suma de comprobación SHA-256 publicada.
2. Detén `humalike` o detén el FXServer.
3. Conserva el directorio anterior como copia de reversión fuera del árbol de recursos
   activo.
4. Sustituye el directorio `humalike` completo.
5. Arráncalo y ejecuta `humalike_status`.

No fusiones una release nueva sobre el directorio antiguo. Los ficheros eliminados
seguirían activos y pueden producir un comportamiento de versiones mezcladas.

Mantén el código personalizado en un recurso puente separado. Actualizar Humalike nunca
debería sobrescribir trabajos, lógica de despacho, recompensas ni hooks de UI específicos
del servidor.

## Revertir

Detén el recurso, restaura el directorio completo de la release anterior y arráncalo de
nuevo. La licencia de servidor sigue siendo válida. Si en una release cambió el esquema
del panel o el comportamiento requerido del servidor, sigue las notas de esa release
antes de revertir.

## Builds de desarrollo

Los servidores de producción deberían usar los archivos de release. Los checkouts del
repositorio requieren una build del frontend y están pensados solo para colaboradores.
Una release ya contiene todos los assets NUI compilados.

## Siguiente

* [Completa el inicio rápido](/es/ai-npc/quickstart).
* [Revisa la configuración](/es/ai-npc/configuration).
* [Prepara las operaciones en producción](/es/ai-npc/operations).