Configuration

Complete configuration reference for the Multiplayer Garbage Job.

---

Configuration Files

The script uses multiple configuration files located in the config/ folder:

File	Purpose
config.lua	Main configuration (framework, settings, rewards)
coordinate.lua	Location coordinates for all job areas
GetCore.lua	Framework detection (usually don't modify)

---

Basic Settings

Framework & Core

-- Framework Selection
-- Options: 'qb', 'oldqb', 'esx', 'oldesx', 'vrp', 'vrp2', 'standalone'
Config.Framework = 'qb'

-- Language (Available: 'en', 'tr', 'de', 'fr', 'pt', 'ru', 'ar')
Config.Locale = 'en'

-- Currency Display
Config.CurrencyUnit = '$'  -- Options: '$', '€', '₺'

-- Database Resource
Config.SQL = "oxmysql"  -- Options: 'oxmysql', 'mysql-async', 'ghmattimysql'

QBox Users: QBox is fully compatible. Set Config.Framework = 'qb' for QBox servers.

---

Inventory Settings

-- Inventory System (ignored in standalone mode)
Config.Inventory = "qb_inventory"
-- Options: 'qb_inventory', 'esx_inventory', 'ox_inventory', 'qs_inventory', 'tgiann-inventory'

-- Inventory Images Path (adjust based on your inventory)
Config.InventoryImagePath = "nui://qb-inventory/html/images/"

-- Default/Fallback Image
Config.DefaultItemImage = "nui://tw-garbagev2/html/img/garbage.png"

Image Path Examples

Inventory	Image Path
QBCore Inventory	"nui://qb-inventory/html/images/"
ox_inventory	"nui://ox_inventory/web/images/"
qs-inventory	"nui://qs-inventory/html/images/"

---

Interaction Settings

-- Interaction Handler
Config.InteractionHandler = 'drawtext'  -- Options: 'drawtext', 'ox-target'

System	Config Value	Description
DrawText	'drawtext'	Built-in text prompts (no dependency)
ox_target	'ox-target'	Overextended target system

---

Server & Display Settings

-- Server Name (displayed in UI)
Config.ServerName = "TWORST"  -- Max 10 characters

-- Money Settings
Config.MoneyType = "$"        -- Currency symbol in UI
Config.MoneyType2 = "bank"    -- Payment type: 'bank' or 'cash'

-- Profile Picture (displayed in UI)
Config.ExampleProfilePicture = "https://r2.fivemanage.com/biv23I9cFWICSObhZsr4C/LogoNEW.png"

---

Job Settings

Lobby & Players

-- Maximum Players in Lobby
Config.MaxPlayersInLobby = 4  -- 1-4 players per lobby

-- Job Cooldown (hours between jobs)
Config.jobCoolDownHours = 0  -- 0 = no cooldown

-- Level Requirement Check
Config.jobLevelCheck = false  -- true = check player levels before starting

Commands

Config.Command = {
    jobReset = "jobresetgarbage",      -- Reset current job
    jobLeave = "jobleavegarbage",      -- Leave lobby
    openTutorial = "openTutorialgarbage", -- Open tutorial menu
}

---

Vehicle Settings

-- Work Vehicle
Config.Vehicle = "tolgartur"  -- Garbage truck model

-- Vehicle Key System
Config.Vehiclekey = true

-- Remove Keys on Job End
Config.Removekeys = true

The script auto-detects your vehicle key system:

• qb-vehiclekeys

• qbx-vehiclekeys

• qs-vehiclekeys

• wasabi-carlock

• cd_garage

• Renewed-Vehiclekeys

---

Clothing System

-- Enable Job Clothing
Config.ChangeClothesSystem = false  -- true/false

-- Clothing Script
Config.ClothingScript = "qb-clothing"
-- Options: 'qb-clothing', 'illenium-appearance', 'fivem-appearance', 'esx_skin', 'rcore_clothing'

---

Debug Settings

-- Debug Mode (shows console messages)
Config.Debug = false

-- Debug Commands (enables testing commands)
Config.DebugCommands = false

Production Servers: Always set Config.Debug = false and Config.DebugCommands = false for better performance!

---

Region & Rewards

Configure work regions and their rewards:

['regionData'] = {
    {
        regionID = 1,
        regionInfo = {
            regionName = "El Burro Heights",
            regionJobTask = Locales[Config.Locale]['regionJobTask'],
            regionImage = "region.png",
            regionMinimumLevel = 0  -- Minimum level required
        },
        regionAwards = {
            money = 5000,           -- Base money reward
            xp = 1000,              -- Base XP reward
            onlineJobExtraAwards = 1,  -- Multiplayer bonus multiplier
            bonusExtraMoney = 500,  -- Bonus money for teamwork
            bonusExtraXP = 200,     -- Bonus XP for teamwork
        },
    },
    -- Region 2: Paleto Bay
    -- Region 3: Sandy Shores
}

---

Task Configuration

Configure tasks per region:

['dumpsterCleaning'] = {
    taskCount = 5,  -- Number of dumpsters to clean
},
['bagCleaning'] = {
    taskCount = 8,  -- Number of bags to collect
},
['trashCollection'] = {
    taskCount = 10, -- Number of trash items to pick up
},
['dumpsterConversion'] = {
    taskCount = 1,  -- Number of dumpsters to convert
},

---

Daily Missions

Configure daily missions for extra rewards:

Config.Job['dailyMission'] = {
    {
        name = 'jobtask_one',
        header = Locales[Config.Locale]['jobtask'] .. " 1",
        label = Locales[Config.Locale]['dailyjobone'],
        count = 50,    -- Tasks to complete
        xp = 2500,     -- XP reward
        money = 1000,  -- Money reward
    },
    -- Up to 5 daily mission tiers
}

---

Level System

Configure XP required for each level (up to level 70):

Config.RequiredXP = {
    [1] = 1000,
    [2] = 1500,
    [3] = 2000,
    [4] = 2500,
    [5] = 3000,
    -- ... up to level 70
    [70] = 45500,
}

---

Reconnection System

Configure player reconnection settings:

Config.Reconnection = {
    enabled = true,                    -- Enable reconnection
    gracePeriodSeconds = 0,            -- 0 = unlimited until lobby closes
    maxReconnectAttempts = 3,          -- Max reconnection attempts
    resetAttemptsAfterSeconds = 300,   -- Reset after 5 minutes stable
    autoCleanupExpired = true,         -- Auto-remove expired players

    ownerTransfer = {
        enabled = true,                -- Transfer ownership if owner disconnects
        allowRejoinAsMember = true,    -- Owner can rejoin as member
        prioritizeByScore = true,      -- Highest score becomes owner
        minimumLobbyTime = 60,         -- Min time to be eligible for transfer
    },

    notifications = {
        notifyOnDisconnect = true,
        notifyOnReconnect = true,
        notifyAttemptsRemaining = true,
    },
}

---

UI Positions

Customize UI element positions:

Config.DefaultUIPositions = {
    teamList = { top = '77.22vh', left = '85.94vw' },
    scoreList = { top = '2.64vh', left = '1.61vw' },
    inviteSide = { top = '2.85vh', left = '73.07vw' },
    notificationDiv = { top = '40.48vh', left = '81.54vw' },
    keyInfoSide = { top = '50%', right = '2.0833vw' },
}

Players can also adjust UI positions in-game through the settings menu!

---

Need Help?

Having configuration issues? Join our Discord server and open a support ticket.