hz_lib

Apresentacao

hz_lib e a base compartilhada utilizada por todos os recursos Hz-Scripts. Ele detecta automaticamente o ambiente do seu servidor e fornece uma API unificada para que cada Hz-Script funcione imediatamente, independentemente do seu framework ou combinacao de addons.

Asset gratuito — hz_lib esta disponivel gratuitamente na loja Hz-Scripts. Baixe uma vez e todos os scripts compativeis o utilizarao automaticamente.

Para que serve?

Em vez de cada script embutir seu proprio codigo de deteccao de framework e adaptador, o hz_lib gerencia isso de forma centralizada:

Modulo	O que ele detecta
Framework	ESX, QBCore, QBox, Ox Core, vRP, Standalone
Inventario	ox\_inventory, qs-inventory, ps-inventory, codem, core, origen, tgiann, framework
Notificacoes	ox\_lib, okokNotify, mythic\_notify, codem, pNotify, framework, GTA nativo
Target	ox\_target, qb-target, interact, TextUI integrado
Menu / UI	ox\_lib (completo), qb-menu + qb-input, ESX menu, fallback GTA nativo
Dispatch	cd\_dispatch, ps-dispatch, qs-dispatch, rcore\_dispatch, emergencydispatch, integrado
Callbacks	Bidirecional (cliente-servidor) com limitacao de taxa e timeout
Minigames	Barra de progresso, skill check, sequencia

Ele tambem inclui um painel de administracao centralizado (/hzpanel) — cada modulo HZ-Script declara seu schema de configuracao, e o painel constroi automaticamente um editor tipado no jogo para modificar tudo sem tocar nos arquivos nem reiniciar. Veja Painel de administracao.

Vantagens principais

Instalacao unica — Todos os Hz-Scripts compartilham o mesmo bridge, sem codigo duplicado
Deteccao automatica — Deixe tudo em 'auto' e o hz_lib detecta sua configuracao
Override quando necessario — Force um sistema especifico em um unico arquivo de configuracao
60+ exports — Use o bridge a partir dos seus proprios scripts tambem
Interface admin centralizada — /hzpanel abre um unico painel para cada modulo HZ-Script (saiba mais)
Tema unificado — altere o destaque, as superficies, a escala de arredondamento em um unico lugar, cada NUI HZ se retinta ao vivo
Zero impacto na performance — A deteccao e executada uma vez na inicializacao, os exports sao instantaneos

Sistemas suportados

Frameworks

Framework	Recurso	Status
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	Status
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	—	Basico

Sistema de menu	Recurso	Funcionalidades
ox\_lib	`ox_lib`	Context, Input, Alert, TextUI, Progress, Menu lista
qb-menu	`qb-menu`	Context, Input (via qb-input), TextUI (via qb-core)
ESX menu	`esx_menu_default`	Context, Menu lista, TextUI (via esx\_textui)
Nativo	—	Entrada de teclado GTA, texto de ajuda, fallback basico

Inicio rapido

Baixe o hz_lib na loja (gratuito)
Coloque-o na sua pasta resources/
Adicione ensure hz_lib no seu server.cfg antes de qualquer Hz-Script
Pronto — todos os Hz-Scripts o detectarao automaticamente

Consulte o guia de Instalacao para todos os detalhes.

Para desenvolvedores

O hz_lib expoe 60+ exports que voce pode usar nos seus proprios scripts:

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

-- Notificacoes
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 a referencia completa Exports & API.