Administrator Guide

This guide covers the verified admin tools in ARS Banking, including permission setup, the economy dashboard, player search, and loan review.

---

Table of Contents

1. Admin Permissions
2. Economy Dashboard
3. Loan Management
4. Player Search
5. Admin Commands
6. Need Help?

---

1. Admin Permissions

Admin access is controlled through config.lua:

Config.AdminPermissions = {
    Permissions = { 'admin', 'god' },
    License = {
        -- ['license:YOUR_LICENSE_HERE'] = true,
    }
}

• Permissions: Framework permission groups that grant access to admin tabs.
• License: Rockstar license identifiers that grant direct admin access.

Only players matching either criterion will see the admin-only tabs in the banking interface.

---

2. Economy Dashboard

The Economy Dashboard provides a server-wide overview of financial activity. Open the banking interface and select the admin dashboard tab.

What You Can See

• Total Money: Combined bank balances across the server.
• Money by Type: Breakdown for checking, savings, shared, job, and gang accounts.
• Account Counts: Total number of bank accounts.
• Player Counts: Number of players with active accounts.
• Distribution: Average, median, and balance spread data.
• Recent Large Transactions: Count of large transactions in the last 24 hours.

Use this data to monitor inflation, identify unusual wealth accumulation, or assess the overall economic health of your server.

---

3. Loan Management

The loan admin tab is your central hub for reviewing applications and managing active loans. The system uses a 3-slot design, so each player can have up to 3 concurrent loans.

Reviewing Loan Applications

1. Open the banking interface and go to the Loan Admin tab.
2. View applications and active loans.
3. Review the application details:
   • Loan type, amount, and requested term
   • Borrower name and account number
   • Purpose of the loan
4. Click Approve to grant the loan or Deny to reject it.

Tip: Approved loans deposit the amount directly into the player’s bank account. The system automatically calculates weekly payments and sets the first due date (7 days out).

Loan Slot System

Each player has 3 loan slots. A slot can be in one of these states:

Status	Meaning
empty	Slot is available for a new application.
pending	Application submitted, awaiting admin review.
under_review	Application is being reviewed.
active	Loan is active with scheduled payments.
overdue	A payment was missed.
suspended	Temporarily paused by an admin.
paid / completed	Fully repaid.
denied	Application was rejected.
defaulted	Multiple payments missed, loan is in default.

When a loan is fully paid and Config.AutoUnloadCompletedLoans = true, the slot is automatically freed for a new application.

Managing Active Loans

The Active Loans view shows all ongoing loans with their current status across all players.

Admin Actions

Action	Description
Approve	Approve a pending loan and disburse funds.
Deny	Reject a pending loan with optional reason.
Force Payment	Deduct a payment from the player’s account immediately.
Suspend Loan	Temporarily pause a player’s loan.
Reactivate Loan	Resume a suspended loan.
Mark as Default	Change a loan’s status to defaulted.
Extend Term	Add additional weeks to the loan term and recalculate the weekly payment.

Loan Statistics

The dashboard provides aggregate loan statistics:

• Total active loans count
• Total loan value and outstanding balance
• Overdue loans count and amount
• Average interest rate
• Default rate percentage
• Collection amount

Loan History

Completed loans are retained based on Config.KeepLoanHistory and Config.HistoryRetentionDays.

---

4. Player Search

The economy dashboard includes a player search feature for finding and inspecting player finances.

Search Methods

You can search by:

• Player Name: Partial or full name match.
• Identifier: Rockstar license or framework identifier.

Player List

The player list shows paginated results with:

• Name, identifier, total balance
• Account count and types
• Account creation date

Player Details

Selecting a player shows their detailed financial profile:

• All bank accounts with balances and account numbers
• Active loans and their status
• Job and gang information
• Recent transaction history

---

5. Admin Commands

Command	Description
/givecash [playerId] [amount]	Gives cash to a nearby player within 5 units.

---

Need Help?

1. Verify your admin permissions are correctly set in Config.AdminPermissions.
2. Check the server console for error messages when using admin features.
3. Ensure the database tables exist and are up to date.
4. If loan applications do not appear, confirm that Config.UseLoans = true in config.lua.
5. Admin tabs are hidden if the player does not have admin permissions or if Config.UseLoans = false.

---

Note: This guide is written by a third party. If you find any incorrect or outdated information, please contact us on Discord so we can update it for you.