Advanced Configuration

⚙️ Configuration Guide (Config.lua)

Moon Logistics is designed to be fully configurable. Almost every part of the system—jobs, items, warehouses, trucker routes, restaurants, and AI orders—can be customized through the config.lua file.

This guide explains each section clearly, what it does, and how you can modify it safely.

---

🧩 Step 2: Configure the config.lua File

The config.lua file controls how Moon Logistics behaves on your server. You can add, remove, or adjust values without touching any core logic.

---

🐞 General Settings

Config.Debug = false

• Enables debug prints in server/client console

• Recommended:

  • false for live servers

  • true for testing & development

---

🎯 Target & Screen Effects

Config.UseTarget = true
Config.UseScreenFade = true

• UseTarget

  • Enables interaction via qb-target / ox_target

  • Set to false if you prefer key-based interaction

• UseScreenFade

  • Smooth fade in/out during warehouse teleport

---

🚪 Warehouse Teleport Locations

Config.Locations = {
    {
        name = "main_warehouse",
        outside = vector4(...),
        inside = vector4(...),
        labelEnter = "Enter Warehouse",
        labelExit = "Exit Warehouse",
    }
}

• Controls warehouse entry & exit

• You can:

  • Rename labels

  • Change teleport coordinates

💡 Tip: Add more entries to support multiple logistics hubs

---

💻 Warehouse Laptop Access

Config.WarehouseLaptop = {
    location = vector4(...),
    job = "warehouse",
}

• Defines who can access the warehouse management laptop

• Options:

  • job = "warehouse" → only warehouse employees

---

🚚 Trucker Job Configuration

Config.TruckerJob = {
    jobName = "trucker",
    signInLocation = vector4(...),
    truckSpawnLocation = vector4(...),
    truckReturnLocation = vector4(...),
    truckModel = "mule4",
}

This section controls everything related to the trucker job:

Key Options

• Sign-in location – Where truckers start work

• Truck spawn location – Where the delivery truck appears

• Return location – Where the truck must be returned to get paid

• Truck model – Change to any GTA vehicle

Payment System

payment = {
    baseRate = 500,
    distanceMultiplier = 0.5,
}

• Base payment per delivery

• Extra pay based on distance traveled

• Encourages long-haul routes

---

📦 Warehouse Storage Chests

Config.StorageChests = {
    {
        location = vector4(...),
        items = {"onions", "potatoes", "bread"},
    },
}

• Defines physical storage points inside the warehouse

• Each chest:

  • Has its own location

  • Accepts only specific items

• You can:

  • Add more chests

  • Change allowed items

  • Create category-based storage (meat, dairy, vegetables)

---

📦 Packing Table

Config.PackingTable = {
    location = vector4(...)
}

• Used to pack goods for delivery

• Usually restricted to warehouse employees

• You can move or duplicate this for larger warehouses

---

🚛 Delivery Pallet Location

Config.DeliveryPallet = {
    location = vector4(...)
}

• Where packed orders are placed

• Trucker deliveries are collected from here

---

👤 Stock Refill Ped

Config.StockRefillPed = {
    location = vector4(...),
    model = "s_m_m_trucker_01",
}

• NPC responsible for warehouse stock refills

• Can be used for:

  • Buying stock

  • Triggering AI supply

• Model and location are fully customizable

---

🍔 Restaurants & Businesses

Config.Restaurants = {
    {
        job = "burgershot",
        label = "Burgershot",
        deliveryLocation = vector4(...),
        allowedItems = {...},
    }
}

This defines which businesses can receive deliveries.

Per Restaurant

• Job name (business job)

• Delivery location

• Allowed items

• Ped delivery location (optional)

💡 You can:

• Add unlimited restaurants

• Restrict what items they can order

• Support custom MLOs

---

📉 Low Stock Bonus System

Config.LowStockBonus = {
    enabled = true,
    multiplier = 1.5,
}

• Encourages players to deliver rare / low-stock items

• Automatically increases payout when stock is low

---

📦 Warehouse Stock Items

Config.StockItems = {
    {
        name = "onions",
        price = 10,
        minQuantity = 50,
        initialStock = 500,
    }
}

Each stock item defines:

• Item name (must exist in inventory)

• Base price

• Minimum stock threshold

• Starting warehouse stock

You can:

• Add new items

• Adjust economy balance

• Control scarcity

---

🤖 AI Order System

Config.AIOrders = {
    enabled = true,
    initialOrders = 5,
    orderInterval = 300000,
}

• Automatically generates delivery orders

• Keeps the logistics system active even with low players

• Fully adjustable:

  • Order count

  • Interval timing

  • Item quantities

  • Price multiplier

---

✅ Summary

Moon Logistics is designed to be:

• 🔧 Highly configurable

• 🧠 Easy to understand

• 📈 Scalable for large RP servers

You can customize:

• Jobs

• Items

• Warehouses

• Restaurants

• AI economy behavior —all from config.lua, without touching core code.