Features Guide

Moon Logistics is a comprehensive 3-in-1 job system that creates a fully functional supply chain ecosystem for FiveM servers. This script simulates a realistic warehouse distribution network where

🔄 How The Three Jobs Connect

The Complete Workflow:

Players (Suppliers) → Warehouse → Businesses → Truckers → Businesses (Receive)
        ↓                ↓            ↓            ↓              ↓
   Sell Items      Process Orders  Place Orders  Deliver    Get Items

1. Stock Suppliers collect items and sell them to the warehouse, building the inventory foundation.

2. Warehouse Workers manage stock levels, accept business orders, collect items from storage, and prepare them for delivery.

3. Businesses place orders for supplies they need, paying upfront for ingredients and goods.

4. Truckers pick up packed orders and deliver them to business locations for payment.

5. Business Employees receive delivered orders from truckers, adding items directly to their inventory.

This creates a circular economy where every role depends on the others - warehouses need suppliers, businesses need warehouses, truckers need orders, and everyone benefits from a thriving supply chain.


💼 Job 1: Warehouse Worker

Role Description

Warehouse workers are the backbone of the logistics operation. They manage inventory levels, process incoming business orders, and prepare shipments for delivery. Working inside a secure warehouse facility, they use a computerized system to track orders, collect items from organized storage locations, pack them professionally, and stage them for trucker pickup.

Responsibilities

  • Monitor warehouse stock levels and low-stock alerts

  • Accept incoming orders from businesses via laptop system

  • Navigate storage areas to collect ordered items from storage chests

  • Pack collected items at the packing table

  • Load packed orders onto delivery pallets for trucker pickup

  • Toggle duty status for shift management

How It Works

  1. Clock In: Toggle duty status at the warehouse laptop

  2. View Orders: Check pending orders from businesses through the UI

  3. Accept Order: Select an order to process (status: pending → processing)

  4. Collect Items: Visit storage chests around the warehouse and collect ordered items

  5. Pack Order: Take collected items to the packing table to prepare for delivery

  6. Stage for Delivery: Load packed order onto delivery pallet (status: processing → packed)

  7. Order Ready: Trucker can now pick up and deliver the order

Earnings

  • Hourly wage from the warehouse company

  • Potential bonuses for fast processing times

  • Tips from satisfied truckers

Location

  • Warehouse Interior: Humane Labs area (coordinates configured in config.lua)

  • Multiple storage chest locations

  • Centralized packing and loading areas


🏪 Job 2: Business Owner/Employee

Role Description

Business owners and employees manage their establishment's inventory by ordering supplies from the warehouse. This role represents restaurants, cafes, shops, and other businesses that need regular stock deliveries. They monitor their inventory needs, place orders through a digital ordering system, and coordinate with delivery personnel to receive shipments.

Responsibilities

  • Monitor business inventory and identify needed supplies

  • Browse available warehouse stock and pricing

  • Create and submit orders with specific items and quantities

  • Pay for orders upfront from business or personal funds

  • Receive deliveries from truckers at designated business locations

  • Verify delivered items and accept them into inventory

How It Works

  1. Access Ordering System: Use the ordering terminal at your business location

  2. Browse Catalog: View all available items from the warehouse with real-time pricing

  3. Build Order: Add items to cart with desired quantities

  4. Place Order: Confirm order and pay from bank account (status: pending)

  5. Wait for Processing: Warehouse workers prepare your order

  6. Track Delivery: Order moves through statuses (processing → packed → in_transit)

  7. Receive Delivery: When trucker arrives, target the delivery ped at your location

  8. Collect Items: Interact with delivery ped to receive items (status: awaiting_pickup → received)

  9. Items Added: All ordered items are automatically added to your inventory

Configurable Businesses

  • BurgerShot - Burgers, ingredients, beverages

  • Cat Cafe - Coffee supplies, pastries, milk

  • Pizza This - Pizza ingredients, cheese, dough

  • Taco Bomb - Mexican food ingredients

  • Vanilla Unicorn - Bar supplies

  • Police Department - Supplies and provisions

Pricing

  • Variable pricing per item (configured in warehouse stock)

  • Total cost calculated automatically during checkout

  • Low-stock items may have bonus pricing

  • Bulk ordering available

Order Locations

  • Each business has a dedicated ordering terminal

  • Permanent delivery ped stationed at each business

  • Delivery peds accept shipments from truckers

  • Business employees collect items from delivery peds


🚚 Job 3: Trucker/Delivery Driver

Role Description

Truckers are independent contractors who transport packed orders from the warehouse to businesses across San Andreas. They operate box trucks, follow GPS routes, manage delivery schedules, and ensure timely shipment arrival. This role offers freedom, good pay, and the satisfaction of keeping the economy moving.

Responsibilities

  • Check available delivery jobs at the trucking depot

  • Accept delivery contracts for packed warehouse orders

  • Drive delivery trucks safely to business locations

  • Deliver orders to business delivery personnel

  • Collect payment for completed deliveries

  • Maintain vehicle condition during routes

How It Works

  1. Visit Trucking Depot: Go to the trucker sign-in location

  2. Browse Jobs: Open the trucker UI to see available deliveries

  3. Accept Job: Select a delivery job (order status: packed → in_transit)

  4. Get Truck: Box truck automatically spawns at the depot

  5. GPS Navigation: Follow the GPS waypoint to the business location

  6. Find Delivery Ped: Locate the permanent delivery ped at the business

  7. Complete Delivery: Target the ped and select "Deliver Order"

  8. Unload: 5-second progress bar with animation

  9. Get Paid: Payment deposited to bank account automatically

  10. Business Notified: Business employees receive notification that delivery arrived

Earnings

  • Base payment: $500 per delivery

  • Distance multiplier: $0.50 per meter traveled

  • Typical delivery: $800-$1,500 depending on distance

  • Payment calculation: Base Rate + (Distance × Multiplier)

Vehicle

  • Truck Model: Mule4 (Box Truck)

  • Automatic spawn at depot location

  • GPS route automatically set

  • Vehicle automatically removed after delivery

Delivery Locations

  • All registered businesses have permanent delivery peds

  • GPS guidance to exact coordinates

  • Blip markers on map

  • On-screen notifications


🔗 How The Jobs Interconnect

The Supply Chain Flow:

Phase 1: Stock Supply

  • Players farm/collect items (onions, lettuce, beef, etc.)

  • Visit stock refill ped at warehouse exterior

  • Sell items to warehouse for immediate payment

  • Warehouse inventory increases

Phase 2: Business Orders

  • Business employees check their stock needs

  • Open ordering system at business location

  • Select items and quantities from warehouse catalog

  • Submit order with payment

  • Order enters warehouse queue (status: pending)

Phase 3: Warehouse Processing

  • Warehouse worker clocks in for duty

  • Views pending orders on laptop system

  • Accepts an order to process (status: processing)

  • Navigates to storage chests containing ordered items

  • Collects each item one by one from storage

  • Takes items to packing table

  • Packs order professionally (status: processing)

  • Loads onto delivery pallet (status: packed)

Phase 4: Trucker Delivery

  • Trucker checks available jobs at depot

  • Sees newly packed orders

  • Accepts delivery job (status: in_transit)

  • Receives box truck automatically

  • Follows GPS to business location

  • Finds delivery ped at business

  • Completes delivery interaction

  • Gets paid (status: awaiting_pickup)

  • Truck despawns

Phase 5: Business Reception

  • Business employee receives notification

  • Goes to delivery ped at business

  • Targets ped and selects "Receive Delivery"

  • 5-second receiving animation plays

  • Items automatically added to employee inventory

  • Order marked complete (status: received)

Economic Impact:

  • Stock Suppliers: Generate initial inventory, earn money selling to warehouse

  • Warehouse Workers: Create value through order fulfillment, maintain stock levels

  • Businesses: Receive supplies needed for operations, drive demand

  • Truckers: Transport goods efficiently, earn delivery fees

  • Everyone: Participates in a functional economy with multiple earning opportunities


📦 Key Features

Warehouse Management

  • Real-time inventory tracking

  • Low-stock alert system with bonus pricing

  • Multi-chest storage organization

  • Duty status management

  • Order progress tracking

  • Professional packing workflow

Business Ordering

  • Modern, intuitive UI

  • Real-time stock availability

  • Shopping cart system

  • Automatic payment processing

  • Order status notifications

  • Delivery tracking

Trucking System

  • Job board with available deliveries

  • Automatic truck spawning

  • GPS navigation to destinations

  • Distance-based payment calculation

  • Vehicle cleanup after delivery

  • Professional delivery animations

Delivery Reception

  • Permanent NPCs at all business locations

  • Target-based interaction system

  • Inventory space validation

  • Permission-based access (job verification)

  • Automatic item distribution

  • Completion timestamps

Stock Supply System

  • NPC vendor for selling items

  • Configurable stock items and prices

  • Real-time inventory updates

  • Automatic payment processing

  • Low-stock bonus multipliers

Last updated