> For the complete documentation index, see [llms.txt](https://oneclub-scripts.gitbook.io/oneclub-scripts-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://oneclub-scripts.gitbook.io/oneclub-scripts-docs/free-script/oneclub-banking/configuration.md).
# Configuration
#### **0. Config Languages**
The script uses **two language settings** in config.lua: **Config.Locale** (**active language**)\
And the **Config.FallbackLocale** (**backup language**)\
Now you can use **7 languages** (EN, SK, CZ, DE, ES, IT, FR) or **you can add your own.** Language configuration include full **notification localization** and **full UI localization.**
```lua
Config.Locale = 'en'
Config.FallbackLocale = 'en'
```
#### **1. Config Bank Locations**
Defines a list of Fleeca Bank branch locations used by the script.\
Each entry contains:
* **coords**: the exact world position (`vector3(x, y, z)`) where the bank interaction/NPC/marker should be placed
* **heading**: the direction (rotation in degrees) the entity should face at that location
* **label**: a readable name for the branch (used in UI/menus/logs)
#### **2. Config Targets**
Defines interaction parameters (mainly for target/zone systems like ox\_target):
* **Bank**
* **Size**: `vec3(2.0, 2.0, 2.0)` — the size of the interaction zone/box used at bank locations.
* **Distance**: `2.0` — how close a player must be to interact with the bank target.
* **ATM**
* **Distance**: `1.5` — how close a player must be to interact with an ATM target.
#### **3. Config ATM**
Defines what happens when using an ATM:
* **Animation**: `'/e atm'` — the emote/animation command that plays when a player uses an ATM.
#### **4. Config Card**
Defines bank card limits and defaults:
* **CreationFee**: 500 — the cost (typically in cash) to create a new card.
* **MaxPerAccount**: 2 — maximum number of cards allowed per account.
* **DefaultWithdrawLimit**: 2000 — default daily withdrawal limit assigned to a newly created card.
#### **5. Config Shared Account Limit**
```lua
Config.Shared = {
MaxAccounts = 3
}
```
{% hint style="success" %}
You can configure **how many shared account can player have**, I recommend let this settings for 3 or less
{% endhint %}
#### **6. Personal Bank Loans**
You can configure maximum of 3 types of personal loans
* Configuje "Label"
* Configure maximum borrowable amount
* You can set intallment spread
* You can set Annual Percentage Rage (ARP)
* You can set wich Bank tier can borrow how many money
{% hint style="info" %}
You have command `/ocbank` and this command let you opend bank everywhere, but working only in `Config.Debug = true`
{% endhint %}
Configure blips
`Config.Blips = {Sprite = 108, Display = 4, Scale = 0.7, Colour = 2, ShortRange = true }`
* Sprite = 108 → blip type/icon
* Display = 4 → blip display mode on map
* Scale = 0.7 → blip icon size
* Color = 2 → blip color (color ID)
* ShortRange = true → blip will only be displayed at a short distance (not "globally" all the time)
Config.lua "PREVIEW"
```lua
Config = {}
Config.Debug = false
Config.ServerDebug = false
Config.EnableBlips = true
-- Locale used by oneclub_banking (Lua + NUI).
-- Locale = active language
-- FallbackLocale = language used when the active locale file/key is missing
Config.Locale = 'en'
Config.FallbackLocale = 'en' -- Fallback language used when the active locale is missing keys
Config.BankLocations = {
{ coords = vector3(149.76, -1041.14, 29.58), heading = 338.0, label = 'Fleeca Bank - Legion Square' },
{ coords = vector3(314.06, -279.61, 54.38), heading = 338.0, label = 'Fleeca Bank - Alta' },
{ coords = vector3(-351.04, -50.39, 49.25), heading = 338.0, label = 'Fleeca Bank - Burton' },
{ coords = vector3(-1212.39, -331.13, 38.0), heading = 27.0, label = 'Fleeca Bank - Rockford Hills' },
{ coords = vector3(-2962.05, 482.95, 15.91), heading = 87.0, label = 'Fleeca Bank - Banham Canyon' },
{ coords = vector3(1174.98, 2707.31, 38.3), heading = 0.0, label = 'Fleeca Bank - Harmony' }
}
Config.Targets = {
Bank = {
Size = vec3(2.0, 2.0, 2.0),
Distance = 2.0
},
ATM = {
Distance = 1.5
}
}
Config.ATM = {
Animation = '/e atm'
}
Config.Card = {
CreationFee = 500,
MaxPerAccount = 2,
DefaultWithdrawLimit = 2000
}
-- Shared account limits
Config.Shared = {
MaxAccounts = 3
}
---------- BANK LOANS ----------
Config.Loans = {
CacheSeconds = 10,
MaxActive = 2, -- maximum amount of loans
InstallmentIntervalSeconds = 7 * 24 * 60 * 60, -- weekly installments (default)
AutopayCheckMs = 5 * 60 * 1000, -- how often autopay checks for due installments
RateLimits = {
ApplyMs = 10000,
PayMs = 2000
},
Products = {
payday = {
label = 'Payday',
max = 2000, -- Maximum Borrowable Amount
term_weeks = 2, -- Installment Spread over 10 weeks
apr = 18, -- Annual Percentage Rate (6% APR)
tier_limits = {
D = 1000,
C = 1500,
B = 2000,
A = 2000,
S = 2000
}
},
personal = {
label = 'Personal',
max = 10000,
term_weeks = 6,
apr = 10,
tier_limits = {
D = 3000,
C = 6000,
B = 8000,
A = 10000,
S = 10000
}
},
premium = {
label = 'Premium',
max = 25000, -- Maximum Borrowable Amount
term_weeks = 10, -- Installment Spread over 10 weeks
apr = 6, -- Annual Percentage Rate (6% APR)
allowed_tiers = {
A = true,
S = true
},
tier_limits = {
A = 20000,
S = 25000
}
},
}
}
Config.Accounts = {
PrecreateOnPlayerLoaded = true,
QueueDelayMs = 150
}
Config.Command = {
OpenBank = 'ocbank'
}
Config.Blips = {
Sprite = 108,
Display = 4,
Scale = 0.7,
Colour = 2,
ShortRange = true
}
Config.ATMModels = {
'prop_atm_01',
'prop_atm_02',
'prop_atm_03',
'prop_fleeca_atm'
}
```