Instalação

Dependências

Dependência	Obrigatória	Por quê
hz_lib	Sim	Framework, inventário, target, notificações, a caixa de diálogo do bancário e as fontes do seu tema. Grátis, mantenha-o atualizado.
ox_lib	Sim	Biblioteca compartilhada.
oxmysql	Sim	Banco de dados.
ESX, QBCore ou Qbox	Sim	O saldo pessoal é o dinheiro de banco do seu framework. Servidores sem framework não são suportados.
OneSync	Sim	O servidor verifica onde os jogadores estão antes de cada operação.
ox_target / qb-target	Não	Usado quando presente: o olho do target vai nos bancários e nos caixas eletrônicos.
HZ-TextUi	Não	Usado quando presente: pins acima dos bancários e nos caixas eletrônicos. Sem ele, o hz_lib mostra um aviso [E].

Passos

Se você usa outro banco (qb-banking, Renewed-Banking, esx_banking, okokBanking…), leia antes Substituir seu script de banco.
Coloque a pasta hz_banking na sua pasta resources.
Adicione o item do cartão bancário ao seu inventário (veja abaixo).
Adicione o HZ-Banking ao seu server.cfg, depois do framework, do inventário, do target e do hz_lib:

ensure oxmysql
ensure ox_lib

# seu framework, inventário e target (exemplos)
ensure qb-core
ensure ox_inventory
ensure ox_target

ensure hz_lib
ensure hz_banking

Depois reinicie o servidor e reconecte.

O item do cartão bancário

O HZ-Banking dá a cada jogador um item de cartão bancário, bank_card por padrão (Config.CreditCardItem). O item precisa existir no seu inventário, senão os cartões não podem ser entregues e os caixas eletrônicos recusam os jogadores. O console do servidor avisa em vermelho na inicialização quando ele está faltando.

Adicione o item antes da primeira inicialização com o ox_inventory. O ox_inventory remove dos inventários salvos os itens que ele não conhece.

ox_inventory — em ox_inventory/data/items.lua:

['bank_card'] = {
    label = 'Bank Card',
    weight = 10,
    stack = false,
    close = true,
    description = 'Debit card linked to your bank account.',
},

QBCore — já existe no qb-core recente (qb-core/shared/items.lua). Se não existir:

bank_card = { name = 'bank_card', label = 'Bank Card', weight = 0, type = 'item', image = 'bank_card.png', unique = true, useable = true, shouldClose = true, description = 'Debit card linked to your bank account.' },

ESX sem ox_inventory — no seu banco de dados:

INSERT IGNORE INTO `items` (`name`, `label`, `weight`) VALUES ('bank_card', 'Bank Card', 1);

Imagens — copie os arquivos de hz_banking/inventory/ para a pasta de imagens do seu inventário (ox_inventory: web/images/). Há uma imagem de cartão por banco.

Reinicie o servidor depois de adicionar o item. O mesmo guia vem em install/items.md.

Banco de dados

Nada para importar. O HZ-Banking cria as próprias tabelas (todas começando com hz_banking_) na inicialização e nunca mexe em uma tabela existente. O sql/schema.sql vem como referência.

Convars opcionais

# Log no Discord de depósitos, saques, transferências, /givecash, empréstimos e encerramento de contas compartilhadas
set hz_banking_webhook "https://discord.com/api/webhooks/..."

# Um segredo privado usado para guardar os PINs
set hz_banking_pin_secret "a-long-random-secret"

Defina o segredo do PIN uma vez, antes que os jogadores definam seus PINs. Mudá-lo depois faz todos os PINs existentes deixarem de bater, e os jogadores teriam que definir um novo em um balcão.

O que você deve ver

Um blip em cada um dos 8 bancos, na cor do seu banco.
Um bancário atrás de cada balcão. Chegue perto: ele olha para você e cumprimenta.
Fale com ele: uma caixa de diálogo abre com a fala dele e quatro escolhas. Escolha Open my account (abrir minha conta) e a página de login do banco abre.
Peça um cartão na página Cards (o primeiro é grátis), defina um PIN e vá a qualquer caixa eletrônico: seu personagem fica de frente para ele, insere o cartão e a tela pede o PIN.
Nenhuma mensagem vermelha sobre o HZ-Banking no console do servidor.

Atualização

Depois de uma atualização, reinicie o servidor inteiro em vez de reiniciar só o hz_banking. Mantenha o hz_lib atualizado ao mesmo tempo.

Seus arquivos de config/ e locales/ são seus: compare-os com os novos e copie as chaves que você mudou.