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 loansmanualCollectMinGrade→ collect paymentshardCollectMinGrade→ advanced actionsdebtCollectorMinGrade→ 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 = 2Credit 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