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, qs-inventory, ps-inventory, codem, core, origen, tgiann, 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
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.

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
60+ 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
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 60+ 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.