Standalone

Agency-Banking Configuração

Um sistema bancário completo para FiveM. Gere o teu dinheiro pelo banco online e pelos multibancos, com uma interface.

v1.2.0Pago4 Páginas

01Configuração

Instalação rápida · config.lua · Agency-Banking

--[[ ============================================================================
     AGENCY BANKING — CONFIGURATION
     ----------------------------------------------------------------------------
     Adjust the values in the "SETTINGS" section to suit your server.
     The "INTERNAL" section at the bottom holds the framework auto-detection and
     the translation helper — you normally do not need to touch it.
============================================================================ ]]

Config = {}

--[[ ============================================================================
     SETTINGS
============================================================================ ]]

-- ----------------------------------------------------------------------------
-- General / UI
-- ----------------------------------------------------------------------------
Config.BankName        = 'Agency Bank' -- Name shown across the UI and on cards
Config.BankLogo        = 'logo.png'    -- Image in this resource's root folder (next to config.lua)
Config.UseAgencyNotify = true          -- true = route all banking messages through the Agency-Notify resource

-- ----------------------------------------------------------------------------
-- Localization
-- ----------------------------------------------------------------------------
-- Available languages live in the locales/ folder (e.g. 'en', 'de', 'fr', 'es', 'pt', 'ru', ...).
Config.Locale = 'en'

-- ----------------------------------------------------------------------------
-- Framework
-- ----------------------------------------------------------------------------
-- 'auto'   -> detect the running framework automatically (ESX / QBCore / Qbox)
-- 'esx'    -> force ESX    (es_extended)
-- 'qbcore' -> force QBCore (qb-core) or Qbox (qbx_core)
Config.Framework = 'auto'

-- ----------------------------------------------------------------------------
-- Database
-- ----------------------------------------------------------------------------
-- The resource ships with oxmysql (declared in fxmanifest.lua), which keeps it
-- compatible with Tebex and modern servers.
Config.DatabaseType = 'oxmysql'

-- ----------------------------------------------------------------------------
-- Agency Companion App (free iOS / Android remote)
-- ----------------------------------------------------------------------------
-- Links this bank to the free Agency Companion app so players can check their
-- balance, send transfers and manage fixed deposits from their phone. Each
-- player links their OWN device via a QR code (bank Settings tab or /abconnect).
-- Money actions are always re-validated server-side against the LIVE player —
-- transfers/deposits require the player online; reads work offline too.
Config.Companion = {
    Enable       = true,                     -- master switch for the companion integration
    EnableRemote = true,                     -- dial out to the Agency relay (no port-forwarding needed)
    RelayUrl     = 'https://api.agencyg.de', -- Agency relay endpoint
    TokenTTL     = 300,                      -- seconds a pairing QR / code stays valid
}

-- ----------------------------------------------------------------------------
-- Fixed Deposits (Savings)
-- ----------------------------------------------------------------------------
Config.EnableFixedDeposits = true
Config.FixedDepositOptions = {
    { days = 7,  interestRate = 2.0 }, -- 7 days  • 2.0% return
    { days = 14, interestRate = 3.5 }, -- 14 days • 3.5% return
    { days = 30, interestRate = 6.0 }, -- 30 days • 6.0% return
}

-- ----------------------------------------------------------------------------
-- Interaction (Banks & ATMs)
-- ----------------------------------------------------------------------------
-- UseTarget = true  -> interact via a target resource (qb-target / ox_target)
-- UseTarget = false -> interact via 3D markers + [E]
-- The active target system is auto-detected; if TargetResource isn't running,
-- the script picks whichever is available, or falls back to markers + [E].
Config.UseTarget      = false
Config.TargetResource = 'qb-target' -- 'qb-target' or 'ox_target'

-- ----------------------------------------------------------------------------
-- Locations
-- ----------------------------------------------------------------------------
-- Bank blip / interaction points.
Config.BankLocations = {
    vector3(149.91, -1040.64, 29.37),     -- Legion Square
    vector3(314.19, -278.62, 54.17),      -- Alta
    vector3(-1212.98, -330.84, 37.78),    -- Rockford Hills
    vector3(-2962.58, 482.63, 15.70),     -- Chumash
    vector3(-112.20, 6469.29, 31.62),     -- Paleto Bay
    vector3(1175.06, 2706.64, 38.09),     -- Sandy Shores
    vector3(241.727, 220.706, 106.286),   -- Pacific Standard
    vector3(1143.514, -471.189, 66.828),  -- Mirror Park
    vector3(-350.938, -49.805, 49.042),   -- Burton
}

-- ATM prop models detected client-side for interaction.
Config.ATMProps = {
    `prop_atm_01`,
    `prop_atm_02`,
    `prop_atm_03`,
    `prop_fleeca_atm`,
}

--[[ ============================================================================
     INTERNAL — framework detection & translation helper
     (no configuration needed below this line)
============================================================================ ]]

-- Resolves Config.Framework to a concrete value ('esx' or 'qbcore') based on the
-- framework resource that is currently running. Runs in both the client and
-- server VM (this file is a shared_script), so each side detects independently.
local function DetectFramework()
    -- Manual override: respect an explicitly configured framework.
    if Config.Framework and Config.Framework ~= 'auto' then
        local fw = string.lower(Config.Framework)
        if fw == 'qb' or fw == 'qbcore' or fw == 'qbx' or fw == 'qbox' then
            return 'qbcore' -- normalise every QBCore/Qbox variant to 'qbcore'
        elseif fw == 'esx' then
            return 'esx'
        end
        return fw
    end

    -- A framework is "running" if it is started or in the middle of starting.
    -- (Avoids matching leftover, stopped resource folders.)
    local function isRunning(name)
        local state = GetResourceState(name)
        return state == 'started' or state == 'starting'
    end

    -- A resource "exists" if it is registered on the server at all.
    local function exists(name)
        return GetResourceState(name) ~= 'missing'
    end

    -- 1) Prefer a framework that is actively running.
    if isRunning('es_extended') then return 'esx' end
    if isRunning('qbx_core')    then return 'qbcore' end -- Qbox is QBCore-compatible
    if isRunning('qb-core')     then return 'qbcore' end

    -- 2) Fallback for early boot (framework not "started" yet at this point):
    --    pick whichever framework resource is present on the server.
    if exists('es_extended') then return 'esx' end
    if exists('qbx_core')    then return 'qbcore' end
    if exists('qb-core')     then return 'qbcore' end

    print('^1[Agency Banking] ^7Could not auto-detect a framework (ESX / QBCore / Qbox). Set Config.Framework manually in config.lua.^7')
    return 'qbcore' -- safe fallback
end

Config.Framework = DetectFramework()
print(('^2[Agency Banking] ^7Active framework: ^5%s^7'):format(tostring(Config.Framework)))

-- Translation helper: _U('key', ...) returns the localized, string.format-ed text.
function _U(str, ...)
    local locale = Locales[Config.Locale]
    if not locale then
        return ('Locale [%s] does not exist'):format(Config.Locale)
    end
    if locale[str] == nil then
        return ('Translation [%s][%s] does not exist'):format(Config.Locale, str)
    end
    return string.format(locale[str], ...)
end

02Arquivo SQL

Importe este arquivo SQL no seu banco de dados antes de iniciar o recurso:

CREATE TABLE IF NOT EXISTS `agency_transactions` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `identifier` varchar(50) NOT NULL,
  `type` varchar(50) NOT NULL, -- 'transfer', 'deposit', 'withdraw', 'fixed_deposit', 'interest'
  `amount` int(11) NOT NULL,
  `target_identifier` varchar(50) DEFAULT NULL,
  `reason` varchar(255) DEFAULT NULL,
  `date` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`)
);

CREATE TABLE IF NOT EXISTS `agency_cards` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `identifier` varchar(50) NOT NULL,
  `card_number` varchar(16) NOT NULL,
  `card_pin` varchar(4) NOT NULL,
  `card_type` varchar(50) DEFAULT 'Agency 1',
  `card_color` varchar(50) DEFAULT 'Ultra Blue',
  `is_active` tinyint(1) DEFAULT 1,
  PRIMARY KEY (`id`)
);

CREATE TABLE IF NOT EXISTS `agency_fixed_deposits` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `identifier` varchar(50) NOT NULL,
  `amount` int(11) NOT NULL,
  `interest_rate` float NOT NULL,
  `duration_days` int(11) NOT NULL,
  `start_date` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `end_date` timestamp NOT NULL,
  `is_claimed` tinyint(1) DEFAULT 0,
  PRIMARY KEY (`id`)
);