# JBxSM Loans — Housing Loan System for Qbox

A complete player loan system for Qbox servers, with a polished admin

oversight panel, society-funded banking, automatic weekly payments,

and full Discord webhook logging.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🎥  **WATCH THE FULL PREVIEW ON YOUTUBE**

▶️  👉  https://www.youtube.com/watch?v=cRwKQcG4vdY

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

## 📋 Overview

JBxSM Loans is a feature-complete loan management system built specifically

for Qbox Framework servers. Players apply for loans through any configured

bank location using ox_target or the /myloans command, and admins manage

the entire loan lifecycle through a dedicated oversight panel — approvals,

rejections, modifications, payment enforcement, write-offs, and defaults.

Every action is logged to Discord and to an in-database audit trail.

Loans are funded through a real shared society account (default gov), so

money actually cycles through your economy instead of being created and

destroyed out of thin air. Down payments, disbursements, weekly auto-payments,

and manual payments all move funds between the player wallet and the society

bank account. If a player is offline when a payment is due, the system deducts

directly via SQL, so loans behave consistently whether players are logged in

or not.

The included NUI features custom JBxSM Designs branding, a clean dark theme,

statistics dashboard, search, filtering, and per-loan payment history. Discord

webhook integration ships rich embeds for every event in the loan lifecycle,

split across two configurable webhooks so player events and admin actions can

go to separate channels.

╔══════════════════════════════════════════════════╗

║  🎬  SEE IT BEFORE YOU BUY                       ║

║                                                  ║

║  Full feature walkthrough, admin panel demo,     ║

║  and Discord logging in action:                  ║

║                                                  ║

║  ▶️  https://youtu.be/YOUR-VIDEO-ID-HERE         ║

╚══════════════════════════════════════════════════╝

## ✨ Key Features

✅ Player loan applications with configurable down payment, term length, and interest

✅ Automatic weekly payments deducted from the player's bank account (works offline via SQL)

✅ Society-funded lending — money cycles through a configurable shared account

✅ Admin oversight panel with statistics, search, and filter

✅ Admin actions: approve, reject, modify terms, force payment, waive, write off, mark defaulted

✅ Full payment history and admin audit log stored in the database

✅ Discord webhook logging with rich embeds, split between player events and admin actions

✅ ox_target integration at every configured bank location

✅ Compatible with Renewed-Banking, qbx_management, and any banking resource using bank_accounts_new

✅ Permission system supports both ace permissions and job + grade allow-lists

✅ Full configuration via config.lua — no code editing required for normal setup

## 🔐 Admin Access

Configurable via:

- Ace permission: `qbx_loans.admin`

- Or by job and grade — defaults include bankers (any grade), real estate grade 4+, and gov grade 3 (mayor)

## 📢 Discord Logging

Two webhooks, split by audience:

| Webhook | Events Logged |

|---|---|

| Player | Applications, payments, payoffs, missed payments, auto-defaults |

| Admin | Approvals, rejections, force payments, waivers, write-offs, term modifications, manual defaults |

Webhooks are sent fire-and-forget and wrapped in pcall, so a Discord outage

cannot block a loan operation.

## ⚙️ Requirements

- qbx_core

- ox_lib

- ox_target

- oxmysql

- A bank_accounts_new table (created by Renewed-Banking, qbx_management, or any compatible Qbox banking resource)

## 🛠️ Installation

1. Drop the folder into your `resources/` directory

2. Import `sql/qbx_loans.sql` into your database

3. Add `ensure jbxsm_loans` to your `server.cfg` after qbx_core, ox_lib, oxmysql, and ox_target

4. Edit `config.lua` to set bank locations, admin jobs, society account, and Discord webhooks

5. Grant admin access via ace permission or job grade

A full README is included covering configuration, money flow, upgrade paths

from earlier versions, and troubleshooting.

## 📦 Delivery

This resource is delivered automatically via FiveM Asset Escrow directly to

your server after purchase. Simply add it through your Cfx.re Asset Manager —

no manual setup needed beyond the standard installation steps above.

## ℹ️ Product Info

- **Version:** 1.2.0

- **Framework:** Qbox

- **Code:** Escrow-protected, config files open for editing

- **Support:** Provided via JBxSM Designs

- **Preview:** ▶️ https://youtu.be/YOUR-VIDEO-ID-HERE