Banker Configuration

This document explains how to configure the Banker Job / Loan System.

Job Setup

Lua
BankerConfig.JobName = 'banker'
  • Job required to access loan system.

Grade Permissions

Lua
BankerConfig.JobGrades = { ... }

Controls what each grade can do:

  • originateLoanMinGrade → create loans
  • manualCollectMinGrade → collect payments
  • hardCollectMinGrade → advanced actions
  • debtCollectorMinGrade → field collection

Tablet System

Lua
BankerConfig.TabletItem = 'banker_tablet'
  • Item to open banker UI.
Lua
BankerConfig.Desk = { ... }
  • Physical locations where UI can be accessed.

Loan Agreement Item

Lua
BankerConfig.LoanAgreementItem = 'loan_agreement'

Loan Signing

Lua
BankerConfig.LoanSignExpirySeconds = 900
  • Time borrower has to accept loan.

Test Mode

Lua
BankerConfig.TestMode = true
  • Allows:
    • Self-loans
    • Test alerts

Loan Account

Lua
BankerConfig.LoanAccount = {
    label = 'Loan'
}
  • Separate account created per loan.

Banker Commission

Lua
BankerConfig.Commission = {
    percentOfPrincipal = 10
}
  • Banker earns % on loan approval.

Society Lending

Lua
BankerConfig.SocietyLending = { enabled = true }
  • Loan money comes from society account.

Credit Score System

Lua
BankerConfig.CreditScore = { ... }
  • Default: 580
  • Range: 300–850

Affects:

  • Loan approval
  • Interest rate
  • Max loan amount

Loan Limits

Lua
BankerConfig.MaxActiveLoansPerBorrower = 2

Credit Gating

Lua
BankerConfig.CreditGating = { enabled = true }
  • Restricts big loans unless player has history.

Loan Products

Lua
BankerConfig.LoanProducts = {
    personal = {...},
    business = {...},
    home = {...}
}

Each product defines:

  • Interest rate
  • Min/max amount
  • Term duration
  • Credit scaling

Repayment System

Lua
BankerConfig.Repayment = { ... }

Includes:

  • EMI cycle (periodSeconds)
  • Grace period
  • Late penalties
  • Missed payment tracking

Loan Penalties

  • Late fee: % of EMI
  • Account lock after missed payments
  • Forced liquidation after multiple misses

Debt Collector System

Lua
BankerConfig.DebtCollector = { ... }

Features:

  • NPC clerk
  • Collection van
  • Field RP system