Instalación

Paso 1 — Descarga

hz_lib es un asset gratuito. Descarguelo desde la tienda Hz-Scripts o su FiveM Keymaster:

Inicie sesión en keymaster.fivem.net
Vaya a Granted Assets
Descargue hz_lib

hz_lib es requerido por todos los recursos Hz-Scripts. Si ya lo tiene instalado, solo necesita actualizarlo cuando se publique una nueva versión.

Paso 2 — Archivos

Extraiga el archivo
Coloque la carpeta hz_lib en su directorio resources/

server/
├── resources/
│   ├── [standalone]/
│   │   ├── hz_lib/
│   │   │   ├── bridge/
│   │   │   ├── modules/
│   │   │   │   ├── callback/
│   │   │   │   ├── dispatch/
│   │   │   │   ├── framework/
│   │   │   │   ├── inventory/
│   │   │   │   ├── menu/
│   │   │   │   ├── minigame/
│   │   │   │   ├── notify/
│   │   │   │   └── target/
│   │   │   ├── shared/
│   │   │   ├── config.lua
│   │   │   └── fxmanifest.lua

El nombre de la carpeta debe ser hz_lib (sensible a mayúsculas en servidores Linux).

Paso 3 — server.cfg

Agregue hz_lib a su server.cfg antes de cualquier Hz-Script que dependa de el:

# Framework (si corresponde)
ensure es_extended
# ensure qb-core

# hz_lib (antes de todos los Hz-Scripts)
ensure hz_lib

# Sus Hz-Scripts
ensure hz_television
ensure hz_weather
# ensure hz-phone

¡El orden de inicio es critico! hz_lib debe iniciarse después de su framework pero antes de cualquier Hz-Script que lo utilice.

Paso 4 — Configuración (opcional)

Abra config.lua para personalizar la detección. Por defecto, todo está configurado en 'auto' y funciona directamente.

Consulte la página de Configuración para todas las opciones.

Paso 5 — Verificación

Inicie su servidor y verifique la consola en busca de:

[HZ Bridge] v1.0.0 | Framework: qbcore | Inventory: ox_inventory | Notify: ox_lib | Dispatch: builtin | Target: ox_target | Menu: ox_lib

¡Listo! Si ve la línea de detección con sus sistemas correctamente identificados, hz_lib funciona. Todos los Hz-Scripts lo utilizaran automáticamente a partir de ahora.

Actualización

Descargue la última versión desde Keymaster
Reemplace todos los archivos (no hay configuración de usuario que conservar — config.lua es mínimo)
Reinicie: ensure hz_lib, luego reinicie sus Hz-Scripts

Las actualizaciones de hz_lib son retrocompatibles. Sus Hz-Scripts existentes seguirán funcionando después de una actualización.

Solución de problemas

hz_lib no detecta mi framework

Asegúrese de que su framework (es_extended, qb-core, qbx_core) tiene ensure antes de hz_lib
Verifique que el nombre del recurso sea exacto (sensible a mayúsculas)
Si quiere forzar un framework, establezca HZBridge.Framework = 'esx' (o 'qbcore', etc.) en config.lua

Un script dice "hz_lib not found"

Verifique que hz_lib esta en su server.cfg con ensure hz_lib
Asegúrese de que la carpeta se llama exactamente hz_lib
hz_lib debe iniciarse antes del script que lo necesita

Sistema incorrecto detectado

Si la auto-deteccion elige el sistema equivocado (por ej. el inventario incorrecto), puede forzarlo en config.lua:

HZBridge.Inventory = 'ox_inventory'  -- Force specific inventory