hz_lib

Presentación

hz_lib es la base compartida utilizada por todos los recursos Hz-Scripts. Detecta automáticamente el entorno de su servidor y proporciona una API unificada para que cada Hz-Script funcione inmediatamente, sin importar su framework o combinación de addons.

Asset gratuito — hz_lib está disponible de forma gratuita en la tienda Hz-Scripts. Descarguelo una vez y todos los scripts compatibles lo utilizaran automáticamente.

¿Para que sirve?

En lugar de que cada script incluya su propio código de detección de framework y adaptador, hz_lib lo gestiona de forma centralizada:

Módulo	Lo que detecta
Framework	ESX, QBCore, QBox, Ox Core, vRP, Standalone
Inventario	ox\_inventory, hz\_inventory, qs-inventory, ps-inventory, codem, core, origen, tgiann, ak47, qb-inventory, framework
Notificaciones	ox\_lib, okokNotify, mythic\_notify, codem, pNotify, framework, GTA nativo
Target	ox\_target, qb-target, interact, TextUI integrado
Menú / UI	ox\_lib (completo), qb-menu + qb-input, ESX menú, fallback GTA nativo
Dispatch	cd\_dispatch, ps-dispatch, qs-dispatch, rcore\_dispatch, emergencydispatch, integrado
Banca / Sociedad	hz\_banking, qb-banking, qb-management, Renewed-Banking, okokBanking, qs-banking, tgg-banking, crm-banking, tgiann-bank, esx\_society
Callbacks	Bidireccional (cliente-servidor) con limitación de tasa y timeout
Minijuegos	Barra de progreso, skill check, secuencia

También incluye un panel de administración centralizado (/hzpanel) — cada módulo HZ-Script declara su esquema de configuración, y el panel construye automáticamente un editor tipado en el juego para modificar todo sin tocar archivos ni reiniciar. Vea Panel de administración.

Además, dibuja dos elementos en pantalla que comparten todos los scripts HZ: una caja de diálogo con NPC (la frase se escribe al ritmo de la voz y luego aparecen hasta cuatro opciones) y un seguimiento de objetivos para trabajos y misiones. Consulta Diálogo con NPC y Seguimiento de objetivos.

Ventajas principales

Instalación única — Todos los Hz-Scripts comparten el mismo bridge, sin código duplicado
Detección automática — Deje todo en 'auto' y hz_lib detecta su configuración
Override cuando sea necesario — Fuerce un sistema especifico en un solo archivo de configuración
140+ exports — Utilice el bridge desde sus propios scripts también
Interfaz admin centralizada — /hzpanel abre un solo panel para cada módulo HZ-Script (más información)
Tema unificado — cambie el acento, las superficies, la escala de bordes redondeados en un solo lugar, cada NUI HZ se retinta en directo
Cero impacto en rendimiento — La detección se ejecuta una vez al inicio, los exports son instantáneos

Sistemas soportados

Frameworks

Framework	Recurso	Estado
ESX	`es_extended`	Completo
QBCore	`qb-core`	Completo
QBox	`qbx_core`	Completo
Ox Core	`ox_core`	Completo
vRP	`vRP`	Completo
Standalone	—	Completo

Inventarios

Inventario	Recurso	Estado
ox\_inventory	`ox_inventory`	Completo
qs-inventory	`qs-inventory`	Completo
ps-inventory	`ps-inventory`	Completo
codem-inventory	`codem-inventory`	Completo
core\_inventory	`core_inventory`	Completo
origen\_inventory	`origen_inventory`	Completo
tgiann-inventory	`tgiann-inventory`	Completo
ak47\_inventory	`ak47_inventory`	Completo
qb-inventory	`qb-inventory`	Completo
hz\_inventory	`hz_inventory`	Completo (adaptador ox\_inventory)
Framework nativo	—	Básico

Sistemas de menú

Sistema de menú	Recurso	Funcionalidades
ox\_lib	`ox_lib`	Context, Input, Alert, TextUI, Progress, Menú lista
qb-menu	`qb-menu`	Context, Input (vía qb-input), TextUI (vía qb-core)
ESX menú	`esx_menu_default`	Context, Menú lista, TextUI (vía esx\_textui)
Nativo	—	Entrada por teclado GTA, texto de ayuda, fallback básico

Inicio rápido

Descargue hz_lib desde la tienda (gratuito)
Colóquelo en su carpeta resources/
Agregue ensure hz_lib en su server.cfg antes de cualquier Hz-Script
Listo — todos los Hz-Scripts lo detectaran automáticamente

Consulte la guía de Instalación para todos los detalles.

Para desarrolladores

hz_lib expone 140+ exports que puede utilizar desde sus propios scripts:

-- Framework
local job = exports['hz_lib']:GetPlayerJob()

-- Notifications
exports['hz_lib']:Notify('Hello!', 'success', 3000)

-- Inventory (server)
exports['hz_lib']:AddItem(source, 'bread', 5)

-- Menu (client)
exports['hz_lib']:ContextMenu('my_menu', 'My Menu', {
    { title = 'Option 1', onSelect = function() print('selected') end },
})

-- Callbacks
exports['hz_lib']:RegisterCallback('myResource:getData', function(source)
    return { money = 1000 }
end)

Consulte la referencia completa de Exports y API.