QBESXStandalone

Agency-Lifeinvader V3 Yapılandırma

QBCore, Qbox, ESX veya tamamen standalone üzerinde FiveM için şehrin reklam ajansı.

v3.2.1Ücretli5 Sayfalar

01Yapılandırma

Hızlı Kurulum · config.lua · Agency-Lifeinvader V3

--[[ ============================================================================
     AGENCY LIFEINVADER 3.2  ·  config.lua
     ----------------------------------------------------------------------------
     The ad agency of the city. Players write ads that run across the screen of
     every player: categories, boosts, scheduling, drafts, a live feed, review
     by admins or the staff of the agency job, and an Auto-Check for spam.

     Finds QBCore, Qbox or ESX by itself and runs fully standalone without any
     of them, with or without a database.

     Admins change prices, review and the categories in the menu (/aladmin,
     tab Settings). Those values are saved for the whole server and win over
     this file until "Reset to config.lua" is pressed.
============================================================================ ]]

Config = {}

-- =============================================================================
-- 1. GENERAL
-- =============================================================================
Config.Framework = 'auto'      -- 'auto' | 'qbcore' (also Qbox) | 'esx' | 'standalone'
Config.Locale    = 'en'        -- en de fr es it pt nl pl cs sv da no fi ro hu hr bg el tr ru uk ar hi ja ko zh
-- Debug mode: every request and every ad of the queue in the server console.
-- Admins can switch it in the menu as well.
Config.Debug     = false

-- Where ads, drafts and player settings are saved. 'auto' uses oxmysql when
-- it runs (the V3 tables, created and upgraded by themselves) and otherwise
-- the server's own key value store, so a server without a database works too.
Config.Storage = 'auto'        -- 'auto' | 'mysql' | 'kvp'

-- How messages are shown: 'auto' = Agency-Notify when it runs, then a
-- notification on Agency Phone, then your framework, then the GTA feed.
-- While the app is open, messages appear in it.
-- Agency-Notify is free: https://agencyscripts.dev/en/product/notify
Config.Notify = 'auto'         -- 'auto' | 'agency' | 'framework' | 'gta'

-- =============================================================================
-- 2. LOOK
-- =============================================================================
Config.UI = {
    brand    = 'LIFEINVADER',  -- name in the app and on every ad
    subtitle = '',             -- line under the name, '' = "Ad agency" in the server language
    -- A file in html/, a nui:// or https:// link, or '' for a megaphone icon.
    -- Best as a square PNG with a transparent background (logo.png is the
    -- gold Agency logo).
    logo     = 'logo.png',
    tintLogo = false,          -- true draws the logo in the accent colour (good for a white logo)
    accent   = '#E2B649',      -- accent colour of app and ads (Agency gold)
    scale    = 1.0,            -- size of the app, 0.8 to 1.3 (players size their ad banners themselves)
}

-- =============================================================================
-- 3. KEYS AND COMMANDS
-- =============================================================================
-- Players can change both keys in the GTA settings (Key Bindings > FiveM).
-- F6 is free in all Agency scripts (Vehiclekeys F5, Housing F7, Admin F10).
Config.Keys = {
    open = 'F6',               -- opens the app
    feed = '',                 -- opens the live feed directly, '' = no key (players can set one)
}

Config.Commands = {
    open   = 'alad',           -- the app
    feed   = 'alfeed',         -- the live feed
    test   = 'altest',         -- shows a sample ad to yourself, to try the banner position
    admin  = 'aladmin',        -- admin panel
    agency = 'alagency',       -- staff panel of the ad agency job
}

-- =============================================================================
-- 4. ADS
-- =============================================================================
Config.Ads = {
    minLength   = 10,          -- characters an ad needs at least
    maxLength   = 300,         -- characters at most
    maxLines    = 6,           -- lines one ad may have
    maxRepetitions = 5,        -- how often one ad may run (categories can lower it)
    interval    = { min = 30, max = 300, default = 60 },  -- seconds between two runs of the same ad
    duration    = { min = 5,  max = 60,  default = 8 },   -- seconds an ad stays on screen
    delays      = { 0, 10, 30, 60, 300 },                 -- start delays the form offers, in seconds
    anonymous   = true,        -- players may post without their name
    schedule    = { enabled = true, maxHoursAhead = 24 }, -- post an ad for a later time
    -- Seconds between two ads across the whole city. Ads wait in a queue and
    -- never flood the screen, however many are booked.
    gap         = 15,
    maxOnScreen = 3,           -- banners on a player's screen at the same time
}

Config.Boost = {
    enabled    = true,
    multiplier = 2.0,          -- a boosted ad costs this many times the price
    priority   = 8,            -- and jumps this far ahead in the queue
}

-- =============================================================================
-- 5. PRICES AND PAYMENT
-- =============================================================================
-- Price of one run = (base + perSecond x seconds on screen) x category factor,
-- times 2 with a boost. The total is that times the number of runs.
Config.Pricing = {
    base      = 5000,
    perSecond = 500,
}

Config.Money = {
    -- What players pay with. The first one is picked in the form, the player
    -- can switch when there are more. 'bank' | 'cash'
    methods   = { 'bank', 'cash' },
    currency  = '$',
    -- Rejected, withdrawn and stopped ads pay back what has not run yet.
    -- A player who is offline gets it the next time he joins.
    refunds   = true,
    -- Agency Pay from Agency Phone: the phone opens, the player confirms the
    -- payment there, the money comes from his bank account. Offered as soon
    -- as the phone runs; enabled = false hides it.
    agencyPay = { enabled = true, resource = 'agency-phone', timeout = 90 },
}

-- =============================================================================
-- 6. CATEGORIES
-- =============================================================================
--   id              stays the same once ads use it
--   label           used when the language files have no text for this id
--   icon            briefcase car home wrench party pin food shop music heart star megaphone tag bolt
--   price           factor on the price (0.9 = 10 % cheaper)
--   priority        places ahead in the queue
--   review          ads of this category always wait for a staff member
--   maxRepetitions  runs at most (below Config.Ads.maxRepetitions)
--   minInterval     seconds at least between two runs
Config.Categories = {
    { id = 'jobs',       label = 'Jobs',        icon = 'briefcase', price = 0.9,  priority = 2, review = false, maxRepetitions = 4, minInterval = 30 },
    { id = 'vehicles',   label = 'Vehicles',    icon = 'car',       price = 1.15, priority = 1, review = false, maxRepetitions = 5, minInterval = 45 },
    { id = 'realestate', label = 'Real Estate', icon = 'home',      price = 1.25, priority = 1, review = true,  maxRepetitions = 4, minInterval = 60 },
    { id = 'services',   label = 'Services',    icon = 'wrench',    price = 1.0,  priority = 2, review = false, maxRepetitions = 5, minInterval = 30 },
    { id = 'events',     label = 'Events',      icon = 'party',     price = 1.1,  priority = 3, review = false, maxRepetitions = 5, minInterval = 30 },
    { id = 'other',      label = 'Other',       icon = 'pin',       price = 1.0,  priority = 0, review = false, maxRepetitions = 3, minInterval = 45 },
}

-- =============================================================================
-- 7. REVIEW
-- =============================================================================
Config.Review = {
    -- Every ad waits for an admin or a staff member of the agency before it
    -- runs. Admins switch this in the menu.
    required = false,

    -- Auto-Check: simple rules on your own server, no outside service. It
    -- looks for shouting, links, phone number walls, repeated texts and spam
    -- and holds such ads back for review. Admins see why.
    autoCheck = {
        enabled          = true,
        holdOnFlag       = true,   -- flagged ads wait for review
        threshold        = 4,      -- penalty points that count as flagged
        duplicateMinutes = 30,     -- the same text again within this time is a repeat
        duplicateLimit   = 1,      -- repeats allowed before it counts
        links      = { 'http://', 'https://', 'www.', 'discord.gg', 'bit.ly' },
        suspicious = { '@everyone', 'free money', 'hack', 'exploit', 'cheap cash', 'real money' },
        blocked    = {},           -- ads with one of these words are refused outright
        points = {
            duplicate_message = 3, aggressive_frequency = 2, excessive_caps = 1, excessive_symbols = 1,
            external_link = 2, contact_heavy = 1, suspicious_term = 2, long_copy = 1,
        },
    },
}

-- =============================================================================
-- 8. LIMITS PER PLAYER
-- =============================================================================
Config.Limits = {
    cooldown    = 45,          -- seconds between two ads of one player
    maxWaiting  = 3,           -- ads waiting for review
    maxRunning  = 4,           -- ads running or scheduled
    maxDrafts   = 12,
    staffBypass = true,        -- admins are not limited
}

-- =============================================================================
-- 9. AD BANNERS
-- =============================================================================
-- Defaults for every player. Players change position, size, sound and the
-- categories they want to see in the app (tab Settings).
Config.Banner = {
    position   = 'middle-left', -- 'top-left' | 'top-right' | 'middle-left' | 'middle-right' | 'bottom-left' | 'bottom-right'
    scale      = 1.0,           -- 0.8 to 1.3
    sound      = true,
    width      = 380,           -- pixels
    showAuthor = true,          -- false hides who posted, on every ad
    sounds = {
        ad      = { name = 'TEXT_ARRIVE_TONE', set = 'HUD_AWARDS' },
        publish = { name = 'PURCHASE', set = 'HUD_LIQUOR_STORE_SOUNDSET' },
    },
}

-- =============================================================================
-- 10. THE AD AGENCY (JOB)
-- =============================================================================
-- Staff of the agency get a panel (/alagency): the company account, what
-- the ads earn, and the review of waiting ads. The company earns a share of
-- every ad as it runs; the staff member who approved an ad gets a commission
-- on every run of it.
Config.Agency = {
    enabled    = true,
    job        = 'lifeinvader',        -- job of the staff (QBCore, Qbox, ESX)
    ace        = 'agency.lifeinvader.staff', -- without a framework: players with this ACE are staff
    grade      = 0,                    -- lowest job grade that opens the panel
    bossGrade  = 3,                    -- grade that may take money out of the company account
    review     = true,                 -- staff may approve and reject waiting ads
    revenue    = 100,                  -- % of every ad's price that goes to the company account
    commission = 10,                   -- % for the staff member who approved the ad, taken from the company share
    account    = 'lifeinvader',        -- name of the company (society) account
    -- 'auto' finds Renewed-Banking, qb-banking, qb-management, okokBanking and
    -- esx_addonaccount (society_<account>). 'internal' keeps the money in
    -- this script; bosses pay it out in the panel.
    bank       = 'auto',
    payTo      = 'bank',               -- commission and payouts go to 'bank' or 'cash'
}

-- =============================================================================
-- 11. AGENCY PHONE AND AGENCY PAD
-- =============================================================================
-- When Agency Phone or Agency Pad (27.0.2 or newer) runs on the server,
-- Lifeinvader puts its own app on them by itself: the live feed, new ads,
-- my ads and drafts, right on the device. Nothing to set up.
Config.Devices = {
    phone         = true,      -- app on Agency Phone
    pad           = true,      -- app on Agency Pad
    label         = 'Lifeinvader',
    installed     = true,      -- already on the home screen, not only in the App Store
    -- Messages about your ads (approved, rejected, refunds) come as app
    -- notifications on the phone while its app is there.
    notifications = true,
}

-- =============================================================================
-- 12. ADMINS
-- =============================================================================
-- Admins: players with the ACE below, group.admin or group.superadmin, one of
-- the framework groups, or one of the identifiers.
Config.Admin = {
    ace         = 'agency.lifeinvader.admin',
    groups      = { 'admin', 'god', 'superadmin' },
    identifiers = {
        -- 'license:xxxxxxxx', 'discord:xxxxxxxx', 'steam:xxxxxxxx',
    },
}

-- =============================================================================
-- 13. HISTORY
-- =============================================================================
Config.History = {
    keepDays = 30,             -- finished ads and admin log entries older than this are removed
    feed     = 30,             -- ads in the live feed
    mine     = 20,             -- a player's own ads in "My ads"
}

-- =============================================================================
-- 14. STANDALONE
-- =============================================================================
-- Without QBCore, Qbox or ESX:
--   money:  'auto' uses Agency-Banking when it runs, otherwise ads are free.
--           'hooks' uses the functions below, 'free' never charges.
--   staff:  players with Config.Agency.ace, admins by Config.Admin.
Config.Standalone = {
    money = 'auto',            -- 'auto' | 'banking' | 'hooks' | 'free'
    -- getMoney        = function(src, account) return 0 end,             -- account: 'cash' | 'bank'
    -- removeMoney     = function(src, account, amount) return true end,
    -- addMoney        = function(src, account, amount) return true end,
    -- getName         = function(src) return GetPlayerName(src) end,     -- the character name on ads
    -- addCompanyMoney = function(account, amount) return true end,       -- company account of the agency
}

-- =============================================================================
-- 15. YOUR OWN WORDING
-- =============================================================================
-- Any text of the language files can be replaced here and survives updates:
--   Config.Text = { ui_publish = 'Send it!', ad_published = 'Your ad is live.' }
Config.Text = {}

02SQL Dosyası

İsteğe bağlı: Resource başlatıldığında bu tabloları otomatik oluşturur. Bu dosyayı yalnızca veritabanını manuel kurduysanız içe aktarın:

-- =============================================================================
-- Agency Lifeinvader 3.2: database tables (OPTIONAL)
-- -----------------------------------------------------------------------------
-- You do not need to run this file. With oxmysql the script creates these
-- tables on the first start and upgrades the tables of Lifeinvader V2 and V3
-- in place. Run it only if your server creates tables by hand.
-- =============================================================================

CREATE TABLE IF NOT EXISTS `lifeinvader_ads` (
    `id` INT NOT NULL AUTO_INCREMENT,
    `identifier` VARCHAR(100) NOT NULL,
    `author_name` VARCHAR(100) DEFAULT NULL,
    `message` TEXT NOT NULL,
    `category` VARCHAR(50) DEFAULT 'other',
    `anonymous` TINYINT DEFAULT 0,
    `boosted` TINYINT DEFAULT 0,
    `repetitions_total` INT DEFAULT 1,
    `repetitions_left` INT DEFAULT 1,
    `interval_seconds` INT DEFAULT 60,
    `display_duration` INT DEFAULT 8,
    `status` VARCHAR(16) NULL DEFAULT 'active',
    `approved` TINYINT DEFAULT 1,
    `approved_by` VARCHAR(100) DEFAULT NULL,
    `rejected_reason` TEXT DEFAULT NULL,
    `next_send_time` DATETIME DEFAULT NULL,
    `scheduled_for` DATETIME DEFAULT NULL,
    `review_requested_at` DATETIME DEFAULT NULL,
    `reviewed_at` DATETIME DEFAULT NULL,
    `review_decision` VARCHAR(32) DEFAULT NULL,
    `queue_priority` INT DEFAULT 0,
    `ai_score` INT DEFAULT 0,
    `ai_flags` LONGTEXT DEFAULT NULL,
    `admin_notes` LONGTEXT DEFAULT NULL,
    `price_paid` INT DEFAULT NULL,
    `paid_with` VARCHAR(16) DEFAULT NULL,
    `refunded` INT DEFAULT 0,
    `reviewer` VARCHAR(100) DEFAULT NULL,
    `sent_count` INT DEFAULT 0,
    `last_sent_at` DATETIME DEFAULT NULL,
    `created_at` DATETIME DEFAULT CURRENT_TIMESTAMP,
    `updated_at` DATETIME DEFAULT CURRENT_TIMESTAMP,
    PRIMARY KEY (`id`),
    KEY `idx_identifier` (`identifier`),
    KEY `idx_status` (`status`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

CREATE TABLE IF NOT EXISTS `lifeinvader_ad_drafts` (
    `id` INT NOT NULL AUTO_INCREMENT,
    `identifier` VARCHAR(100) NOT NULL,
    `title` VARCHAR(120) DEFAULT NULL,
    `message` TEXT NOT NULL,
    `category` VARCHAR(50) DEFAULT 'other',
    `anonymous` TINYINT DEFAULT 0,
    `boosted` TINYINT DEFAULT 0,
    `repetitions_total` INT DEFAULT 1,
    `interval_seconds` INT DEFAULT 60,
    `display_duration` INT DEFAULT 8,
    `delay` INT DEFAULT 0,
    `scheduled_for` DATETIME DEFAULT NULL,
    `created_at` DATETIME DEFAULT CURRENT_TIMESTAMP,
    `updated_at` DATETIME DEFAULT CURRENT_TIMESTAMP,
    PRIMARY KEY (`id`),
    KEY `idx_identifier` (`identifier`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

CREATE TABLE IF NOT EXISTS `lifeinvader_player_settings` (
    `id` INT NOT NULL AUTO_INCREMENT,
    `identifier` VARCHAR(100) NOT NULL,
    `notification_position` VARCHAR(20) DEFAULT 'middle-left',
    `notification_enabled` TINYINT DEFAULT 1,
    `notification_scale` FLOAT DEFAULT 1.0,
    `ui_transparency` FLOAT DEFAULT 0.55,
    `accent_color` VARCHAR(20) DEFAULT NULL,
    `sound_enabled` TINYINT DEFAULT 1,
    `admin_panel_scale` FLOAT DEFAULT 1.0,
    `muted_categories` VARCHAR(255) DEFAULT NULL,
    `created_at` DATETIME DEFAULT CURRENT_TIMESTAMP,
    `updated_at` DATETIME DEFAULT CURRENT_TIMESTAMP,
    PRIMARY KEY (`id`),
    UNIQUE KEY `uniq_identifier` (`identifier`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

CREATE TABLE IF NOT EXISTS `lifeinvader_admin_logs` (
    `id` INT NOT NULL AUTO_INCREMENT,
    `admin_identifier` VARCHAR(100) DEFAULT NULL,
    `admin_name` VARCHAR(100) DEFAULT NULL,
    `action` VARCHAR(64) NOT NULL,
    `ad_id` INT DEFAULT NULL,
    `metadata` LONGTEXT DEFAULT NULL,
    `created_at` DATETIME DEFAULT CURRENT_TIMESTAMP,
    PRIMARY KEY (`id`),
    KEY `idx_action` (`action`),
    KEY `idx_ad_id` (`ad_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

+Bilmenizde fayda var

config.lua, framework'ten kendi metinlerinize kadar yorum satırlarıyla açıklanmış 16 bölüme sahiptir. Fiyatlar, inceleme kuralları, boostlar ve kategoriler oyun içindeki Admin panelinden tüm sunucu için de değiştirilebilir.

Genel ve Görünüm: Config.Framework, Config.Locale, Config.Debug, Config.Storage ve Config.Notify; framework'ü, dili, debug modunu, verilerin nerede saklanacağını ve bildirimlerin nasıl gösterileceğini belirler. Config.UI; marka adını, alt başlığı, logoyu, vurgu rengini ve uygulamanın boyutunu ayarlar.
Tuşlar ve Komutlar: Config.Keys, F6 tuşunu ve canlı yayın için isteğe bağlı tuşu ayarlar; Config.Commands ise /alad, /alfeed, /altest, /aladmin ve /alagency komut adlarını belirler.
Reklamlar ve Boost'lar: Config.Ads uzunluğu, satırları, yayın sayısını, aralığı, ekranda kalma süresini, başlangıç gecikmelerini, anonim reklamları, zamanlamayı, iki reklam arasındaki boşluğu ve bir ekranın aynı anda kaç banner göstereceğini belirler. Config.Boost ise fiyat çarpanını ve öne çıkarılan bir reklamın ne kadar ileri atlayacağını ayarlar.
Fiyatlar ve Ödeme: Config.Pricing taban fiyatı ve ekrandaki saniye başına fiyatı belirler. Config.Money banka ile nakit parasını, para birimini, iadeleri ve Agency Pay'i ayarlar.
Kategoriler: Config.Categories altı kategoriyi simge, fiyat çarpanı, öncelik, inceleme, yayın sayısı ve aralık ile listeler.
İnceleme ve Otomatik Kontrol: Config.Review her ilanın inceleme bekleyip beklemeyeceğini ve Auto-Check'in bağlantıları, büyük harfleri, sembolleri, sayıları, tekrarları ve şüpheli ya da engellenen kelimeleri nasıl puanlayacağını belirler.
Sınırlar: Config.Limits; bir oyuncunun iki ilanı arasındaki bekleme süresini, oyuncu başına bekleyen ve aktif ilan sayısını, taslakları ve yöneticilerin sınırlandırılıp sınırlandırılmayacağını belirler.
Bannerlar, Meslek ve Cihazlar: Config.Banner banner'ların varsayılan konumunu, boyutunu, sesini ve genişliğini belirler. Config.Agency mesleği, rütbeleri, gelir paylaşımını, komisyonu ve şirket hesabını, Config.Devices ise Agency Phone ve Agency Pad üzerindeki uygulamayı ayarlar.
Adminler, Geçmiş, Standalone ve Metinler: Config.Admin admin ACE yetkilerini, gruplarını ve tanımlayıcılarını, Config.History reklamların ne kadar süre saklanacağını, Config.Standalone framework olmadan parayı belirler ve Config.Text ifadelerinizin güncellemelerden etkilenmemesi için herhangi bir metni değiştirir.

?Sıkça sorulan sorular

Admin panelindeki ayarlar neleri değiştirir?

İnceleme kuralları, Auto-Check, anonim ilanlar, hata ayıklama modu, fiyatlar, ilanlar arası süre, öne çıkarmalar ve her kategori. Bunlar tüm sunucu için kaydedilir ve Reset to config.lua seçeneğine basılana veya konsolda lifeinvader reset çalıştırılana kadar config.lua üzerinde önceliklidir.

Bir metni nasıl değiştirebilirim?

Bunu dil dosyalarındaki anahtarla birlikte Config.Text içine yerleştirin, örneğin Config.Text = { ui_publish = 'Send it!' }. Güncellemelerden etkilenmez.