# Society Account ## Introduction T1GER Resources supports compatibility with society accounts handled by `esx_addonaccount`, `qb-banking` or `qb-management`. {% hint style="success" %} You can also use a custom society-/shared account resource, however you need to implement the functionality yourself. {% endhint %} ### Config.SocietyAccount ```lua Config.SocietyAccount = 'esx_addonaccount' -- Set the society account system ``` Specifies the society account system in use. Update this based on your selected society system. * **Type**: `string` * **Options**: * `'esx_addonaccount'` - [ESX addon Account](https://github.com/esx-framework/esx_addonaccount) * `'qb-banking'` - [QB Banking](https://docs.qbcore.org/qbcore-documentation/qbcore-resources/qb-banking) * `'qb-management'` - [QB Management](https://docs.qbcore.org/qbcore-documentation/qbcore-resources/qb-management) * `'`renewed-banking`'` - [Renewed Banking](https://github.com/Renewed-Scripts/Renewed-Banking) * `'custom'` - You need to make your own integrations! ## Setup This guide will help you setup society account functionality with T1GER Resources.
ESX ## `esx_addonaccount` Setting up functionality to create shared account in runtime is very simple; all you need to is download and install latest `esx_addonaccount` from here: . ***Only do the following if you CANNOT download and install latest version and you are required/force to do the changes manually!!*** If you prefer to keep your current `esx_addonaccount` resource for some weird reason, you can also manually implement the functionality. 1. Navigate to `esx_addonaccount/server/main.lua` 2. Find this function: {% code fullWidth="false" %} ```lua function GetSharedAccount(name) ``` {% endcode %} 3. Add this export code below the function ```lua exports("GetSharedAccount", GetSharedAccount) ``` If done correct, it will look like this:\ ![](/files/qHUwxFa4OOy9gmTnTtuC) 5. Now in the same file, find this function: ```lua function AddSharedAccount(society, amount) ``` 6. If the function exists, replace the whole function, if it doesn't exist, the insert - in both cases it's the same code: ```lua function AddSharedAccount(society, amount) -- society.name = job_name/society_name -- society.label = label for the job/account -- amount = if the shared account should start with x amount if type(society) ~= 'table' or not society?.name or not society?.label then return end -- check if account already exist? if SharedAccounts[society.name] ~= nil then return SharedAccounts[society.name] end -- addon account: local account = MySQL.insert.await('INSERT INTO `addon_account` (name, label, shared) VALUES (?, ?, ?)', { society.name, society.label, 1 }) if not account then return end -- if addon account inserted, insert addon account data: local account_data = MySQL.insert.await('INSERT INTO `addon_account_data` (account_name, money) VALUES (?, ?)', { society.name, (amount or 0) }) if not account_data then return end -- if all data inserted successfully to sql: SharedAccounts[society.name] = CreateAddonAccount(society.name, nil, (amount or 0)) return SharedAccounts[society.name] end exports("AddSharedAccount", AddSharedAccount) ``` 6. You have succesfully set up `esx_addonaccount` to allow for automatic society account creation in runtime. All you need to do is restart the server!
QB Core ## `qb-banking` Setting up functionality to create shared account in runtime is very simple; all you need to is download and install latest `qb-banking` from here: . ## `qb-management` ***Only do the following if you are using**** ****`qb-management`****:*** 1. Navigate to `qb-management/server/sv_boss.lua` 2. Scroll down all the way to the bottom and insert the following code: ```lua -- ## T1GER Integrations: function CreateManagementAccount(job_name, amount) local findRow = MySQL.query.await('SELECT * FROM management_funds WHERE type = @type AND job_name = @job_name', { ['@job_name'] = job_name, ['@type'] = 'boss' }) if not findRow[1] then MySQL.insert('INSERT INTO management_funds (job_name, amount, type) VALUES (@job_name, @amount, @type)', { ['@job_name'] = job_name, ['@amount'] = amount or 0, ['@type'] = 'boss' }) Accounts[job_name] = amount or 0 end end exports("CreateManagementAccount", CreateManagementAccount) ``` 3. Restart your server and you will now be able to create society accounts in runtime!
Qbox ## Renewed Banking Setting up functionality to create shared account in runtime is very simple; all you need to is download and install latest `Renwed-Banking` from here: . 1. Navigate to `Renewed-Banking/server/main.lua` 2. Go all the way to bottom of the file. 3. Paste the follow coding there:
```lua local function CreateJobAccount(job, initialBalance) -- job(table): name(string), label(string) - job name and job label -- initialBalance(int): (optional) amount for account to start with if not job.name or not job.label then return end -- check if account already exist? if cachedAccounts[job.name] then return cachedAccounts[job.name] end cachedAccounts[job.name] = { id = job.name, type = locale('org'), name = job.label, frozen = 0, amount = initialBalance or 0, transactions = {}, auth = {}, creator = nil } MySQL.insert("INSERT INTO bank_accounts_new (id, amount, transactions, auth, isFrozen, creator) VALUES (?, ?, ?, ?, ?, NULL) ",{ job.name, cachedAccounts[job.name].amount, json.encode(cachedAccounts[job.name].transactions), json.encode({}), cachedAccounts[job.name].frozen }) return cachedAccounts[job.name] end exports('CreateJobAccount', CreateJobAccount) ``` 4. You have succesfully set up qbox default banking resource to allow for automatic society account creation in runtime. All you need to do is restart the server!
## Functions These are the functions used in our T1GER resources. {% hint style="info" %} These are also the functions you want to modify in case you want to integrate your custom society/shared account resource. Simply use `'custom'` in `Config.SocietyAccount` and integrate your export/functions in the if/else statements for `'custom'`. {% endhint %} ### GetSharedAccount ```lua GetSharedAccount(society) -- parameters: society(string) -- returns account(table or integer (based on resource return value)) ``` ### CreateSharedAccount ```lua CreateSharedAccount(society, startBalance) -- parameters: society(string), startBalance(integer) -- returns account(table/integer) ``` ### GetSharedAccountBalance ```lua GetSharedAccountBalance(society) -- parameters: society(string) -- returns balance(integer) ``` ### AddSharedAccountMoney ```lua AddSharedAccountMoney(society, m) -- parameters: society(string), m(integer) -- void: adds m amount to shared account with society/job name ``` ### RemoveSharedAccountMoney ```lua RemoveSharedAccountMoney(society, m) -- parameters: society(string), m(integer) -- void: removes m amount from shared account with society/job name ``` ### SetSharedAccountMoney ```lua SetSharedAccountMoney(society, m) -- parameters: society(string), m(integer) -- void: sets m amount to shared account with society/job name ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.t1ger.net/resources/t1ger-library/installation/society-account.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.