Instalacao

Etapa 1 — Download

O hz_lib e um asset gratuito. Baixe-o na loja Hz-Scripts ou no seu FiveM Keymaster:

Faca login em keymaster.fivem.net
Va em Granted Assets
Baixe o hz_lib

O hz_lib e necessario para todos os recursos Hz-Scripts. Se voce ja o instalou, basta atualiza-lo quando uma nova versao for publicada.

Etapa 2 — Arquivos

Extraia o arquivo
Coloque a pasta hz_lib no seu diretorio resources/

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

O nome da pasta deve ser hz_lib (sensivel a maiusculas/minusculas em servidores Linux).

Etapa 3 — server.cfg

Adicione o hz_lib ao seu server.cfg antes de qualquer Hz-Script que dependa dele:

# Framework (se aplicavel)
ensure es_extended
# ensure qb-core

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

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

A ordem de inicializacao e critica! O hz_lib deve iniciar depois do seu framework mas antes de qualquer Hz-Script que o utilize.

Etapa 4 — Configuracao (opcional)

Abra o config.lua para personalizar a deteccao. Por padrao, tudo esta definido como 'auto' e funciona diretamente.

Consulte a pagina Configuracao para todas as opcoes.

Etapa 5 — Verificacao

Inicie seu servidor e verifique o console para:

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

Pronto! Se voce ver a linha de deteccao com seus sistemas corretamente identificados, o hz_lib esta funcionando. Todos os Hz-Scripts o utilizarao automaticamente a partir de agora.

Atualizacao

Baixe a versao mais recente no Keymaster
Substitua todos os arquivos (nao ha configuracao do usuario para preservar — config.lua e minimo)
Reinicie: ensure hz_lib, depois reinicie seus Hz-Scripts

As atualizacoes do hz_lib sao retrocompativeis. Seus Hz-Scripts existentes continuarao funcionando apos uma atualizacao.

Solucao de problemas

O hz_lib nao detecta meu framework

Certifique-se de que seu framework (es_extended, qb-core, qbx_core) esta com ensure antes do hz_lib
Verifique se o nome do recurso esta exato (sensivel a maiusculas/minusculas)
Se voce quiser forcar um framework, defina HZBridge.Framework = 'esx' (ou 'qbcore', etc.) no config.lua

Um script diz "hz_lib not found"

Verifique se o hz_lib esta no seu server.cfg com ensure hz_lib
Certifique-se de que a pasta esta nomeada exatamente como hz_lib
O hz_lib deve iniciar antes do script que precisa dele

Sistema errado detectado

Se a deteccao automatica escolher o sistema errado (por ex. o inventario errado), voce pode forca-lo no config.lua:

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