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, hz\_inventory, qs-inventory, ps-inventory, codem, core, origen, tgiann, ak47, qb-inventory, 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 |
| Banco / Sociedade | hz\_banking, qb-banking, qb-management, Renewed-Banking, okokBanking, qs-banking, tgg-banking, crm-banking, tgiann-bank, esx\_society |
| Callbacks | Bidirecional (cliente-servidor) com limitacao de taxa e timeout |
| Minigames | Barra de progresso, skill check, sequencia |
/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.
Além disso, ele desenha dois elementos na tela compartilhados por todos os scripts HZ: uma caixa de diálogo com NPC (a fala é digitada no ritmo da voz e depois aparecem até quatro escolhas) e um rastreador de objetivos para trabalhos e missões. Veja Diálogo com NPC e Rastreador de objetivos.
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
- 140+ exports — Use o bridge a partir dos seus proprios scripts tambem
- Interface admin centralizada —
/hzpanelabre 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 |
| ak47\_inventory | ak47_inventory | Completo |
| qb-inventory | qb-inventory | Completo |
| hz\_inventory | hz_inventory | Completo (adaptador ox\_inventory) |
| Framework nativo | — | Basico |
Sistemas de menu
| 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_libno seuserver.cfgantes de qualquer Hz-Script - Pronto — todos os Hz-Scripts o detectarao automaticamente
Para desenvolvedores
O hz_lib expoe 140+ 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.