Início › Documentação › Configuração · origen_banking

Configuração · origen_banking

Toda a configuração está em config/main.lua. Os valores exclusivos do servidor estão em config/server/webhooks.lua.

Geral

Variável	Por omissão	Descrição
`Config.Debug`	`false`	Imprime a saída de depuração na consola do servidor
`Config.Language`	`'en'`	Idioma do recurso — `'es'` ou `'en'`
`Config.MaxAccounts`	`3`	Número máximo de contas que um jogador pode ter

Config.Framework é detetado automaticamente em init.lua. Não o substituas no ficheiro de configuração.

IBAN

Os IDs de conta são gerados como IBANPrefix seguido de dígitos aleatórios, até completar IBANLength caracteres no total.

Variável	Por omissão	Descrição
`Config.IBANPrefix`	`''`	Prefixo que se antepõe a cada ID de conta gerado
`Config.IBANLength`	`16`	Comprimento total do ID de conta, prefixo incluído

Bancos

Cada entrada cria um ponto de interação bancário físico com o respetivo blip.

Campo	Tipo	Descrição
`coords`	`vector3`	Obrigatório. Posição do ponto de interação do banco
`isCentral`	`boolean`	Opcional, por omissão `false`. Se for `true`, os jogadores podem criar novas contas partilhadas a partir desta agência
`label`	`string`	Opcional. Texto mostrado no blip

lua

Config.Banks = {
    { coords = vector3(150.266, -1040.203, 29.374),  isCentral = false, label = 'Banco - Legion Square' },
    { coords = vector3(-1212.980, -330.841, 37.787), isCentral = false, label = 'Banco - Pillbox Hill' },
    { coords = vector3(-2962.582, 482.627, 15.703),  isCentral = false, label = 'Banco - Del Perro' },
    { coords = vector3(314.187, -278.621, 54.170),   isCentral = false, label = 'Banco - Alta Street' },
    { coords = vector3(-112.202, 6469.295, 31.626),  isCentral = true,  label = 'Banco Central - Paleto Bay' },
    { coords = vector3(246.727, 223.705, 106.286),   isCentral = true,  label = 'Banco Central - Vinewood Hills' },
    { coords = vector3(1830.41, 3850.33, 35.89),     isCentral = false, label = 'Banco - Sandy' },
    { coords = vector3(-351.04, -49.71, 49.04),      isCentral = false, label = 'Banco - Rockford Hills' },
}

Marcador

Marcador desenhado em cada ponto de interação bancário.

lua

Config.Marker = {
    type = 20,
    color = {0, 0, 0, 200},
    size = vector3(0.3, 0.3, -0.3),
    coords = vector3(0.0, 0.0, 1.0),
    bobUpAndDown = false,
    faceCamera = false,
    rotate = true,
}

Multibancos

Os props de multibanco são detetados automaticamente pelo modelo; não têm blips.

Variável	Por omissão	Descrição
`Config.ATM.Models`	`prop_atm_01`, `prop_atm_02`, `prop_atm_03`, `prop_fleeca_atm`	Modelos de prop tratados como multibancos
`Config.ATM.DetectRadius`	`1.5`	Distância em metros para mostrar a interface de texto e permitir a interação
`Config.ATM.ShowSharedAccounts`	`true`	Se for `true`, as contas partilhadas (trabalho, gangue, sociedade) a que o jogador tem acesso também podem ser usadas num multibanco

Limites dos multibancos

Os limites aplicam-se por conta, por ciclo e apenas no canal dos multibancos. As agências bancárias não têm limite.

Variável	Por omissão	Descrição
`Config.ATM.Limits.Enabled`	`true`	Ativa o sistema de limites por ciclo
`Config.ATM.Limits.ResetMinutes`	`20`	Minutos reais até um ciclo reiniciar e os limites voltarem a zero
`Config.ATM.Limits.WithdrawPerCycle`	`50000`	Máximo que se pode levantar por conta e ciclo
`Config.ATM.Limits.DepositPerCycle`	`50000`	Máximo que se pode depositar por conta e ciclo

Os limites ficam em cache na memória. Reiniciar o recurso ou o servidor repõe todos os contadores a zero.

Empréstimos

Toda a validação (montantes, prazos, elegibilidade e fundos do banco) é feita no servidor. A interface só simula e mostra; nunca decide.

Aprovação

Variável	Por omissão	Descrição
`Config.Loans.Enabled`	`true`	Ativa o sistema de empréstimos
`Config.Loans.AutoApproveUnder`	`25000`	Os empréstimos deste montante ou inferiores são aprovados de imediato; acima disso vão para a fila manual
`Config.Loans.ApprovalJob`	`'banker'`	Trabalho autorizado a aprovar empréstimos, desde que o grau seja pelo menos `ApprovalGrade`
`Config.Loans.ApprovalGrade`	`2`	Grau mínimo do trabalho necessário para aprovar
`Config.Loans.ApprovalAce`	`'origen_banking.approve'`	Permissão ACE que também concede direitos de aprovação
`Config.Loans.ApprovalCommand`	`'loansadmin'`	Comando de chat que abre a NUI na fila de aprovação. Define `''` para o desativar

Limites globais

Variável	Por omissão	Descrição
`Config.Loans.MaxActiveLoans`	`2`	Empréstimos ativos em simultâneo por jogador, incluindo os pendentes
`Config.Loans.MinAmount`	`1000`	Montante mínimo global de um empréstimo
`Config.Loans.BlockIfOverdue`	`true`	Bloqueia novos empréstimos enquanto o jogador tiver um em atraso

Penalizações

Variável	Por omissão	Descrição
`Config.Loans.Penalty.Enabled`	`true`	Ativa as penalizações por pagamento em atraso
`Config.Loans.Penalty.RatePerMiss`	`5.0`	Percentagem adicional somada à prestação por cada pagamento falhado
`Config.Loans.Penalty.MaxMisses`	`3`	Falhas permitidas antes de o empréstimo ser marcado como `defaulted` e de disparar o evento de garantia

Amortização antecipada

Variável	Por omissão	Descrição
`Config.Loans.EarlyPayoff.Enabled`	`true`	Permite liquidar o empréstimo antes do prazo
`Config.Loans.EarlyPayoff.InterestRebate`	`50`	Percentagem dos juros restantes que é perdoada na amortização antecipada

Tipos de empréstimo

Campo	Descrição
`label`	Nome mostrado na interface
`interestRate`	Percentagem total de juros
`minAmount` / `maxAmount`	Intervalo permitido do capital
`allowedTerms`	Array com os números de prestações permitidos
`frequency`	Dias entre prestações
`requiresCollateral`	Exige uma referência a um bem (matrícula, ID de propriedade)
`forceManualApproval`	Envia sempre o empréstimo para a fila manual, ignorando `AutoApproveUnder`

lua

Config.Loans.Types = {
    personal = {
        label              = 'Personal',
        interestRate       = 12.0,
        minAmount          = 1000,
        maxAmount          = 50000,
        allowedTerms       = { 6, 12, 24 },
        frequency          = 7,
        requiresCollateral = false,
    },
    mortgage = {
        label               = 'Mortgage / Vehicle',
        interestRate        = 6.0,
        minAmount           = 25000,
        maxAmount           = 500000,
        allowedTerms        = { 24, 48, 96 },
        frequency           = 7,
        requiresCollateral  = true,
        forceManualApproval = true,
    },
}

Fornecedores do bridge

Definem-se em init.lua. Usa "auto" para detetar o recurso ativo, ou força um fornecedor específico pelo nome.

lua

BridgeConfig.HelpText  = "auto"
BridgeConfig.Notify    = "auto"
BridgeConfig.Inventory = "auto"

Webhooks

Ficheiro: config/server/webhooks.lua

lua

Config.Webhook = {
    banking = "YOUR_DISCORD_WEBHOOK_URL"
}