Retro Garage

File System

Current rs_garages structure:

• Directoryrs_garages

  • Directorybridge

    • loader.lua Framework & target auto-detection, DB schema
    • target.lua Target system bridge (ox/qb/qtarget/E-key)
    • Directoryframeworks

      • esx.lua ESX bridge
      • qbcore.lua QBCore bridge
      • qbox.lua QBox bridge
  • Directoryclient

    • main.lua Garage UI, NUI callbacks, NPC/marker spawn, vehicle spawn
    • garage_interior.lua MLO interior enter/exit, drive-out, dashboard zones
    • private_garages.lua /creategarage, /deletegarage, FindGarageById
    • admin.lua Admin commands (/admincar, /vreturn, /vplate, etc.)
  • Directoryconfig

    • config.lua Main configuration
    • garages.lua Garage list loader (merges all categories)
    • Directorygarages

      • public_garages.lua 16 public garages
      • depot_garages.lua 1 impound depot
      • gang_garages.lua 4 gang garages
      • job_garages.lua 1 police job garage
      • air_garages.lua 5 aircraft garages (+ air depot)
      • sea_garages.lua 4 boat garages (+ sea depot)
      • rig_garages.lua 6 big rig garages (+ rig depot)
  • Directorylocales

    • en.lua English locale (Lua keys)
    • en.json English locale (NUI keys)
  • Directoryserver

    • main.lua Vehicle state management, spawn/store, key sharing, impound logic
    • garage_interior.lua Interior level management, routing buckets, vehicle placement
    • private_garages.lua Private garage CRUD
    • job_vehicles.lua Job spawner + shared fleet management
    • admin.lua Admin callbacks (admincar, plate change, force return)
  • Directoryshared

    • locale.lua Locale loader and Locale.T() function
  • Directorysql

    • install.sql Base schema (shared_keys table)
  • Directorystream

    • _manifest.ymf MLO manifest (ALL 3 levels, single file)
    • Directorylv1/ Standard garage MLO assets

      • …
    • Directorylv2/ Premium garage MLO assets

      • …
    • Directorylv3/ Executive garage MLO assets

      • …
  • Directoryutils

    • cl_utils.lua GetFuel/SetFuel, GetVehicleMods/ApplyVehicleMods
    • sv_utils.lua HasImpoundJob, GetImpoundGarageForType
  • Directoryweb

    • Directorydist/ Built NUI files

      • …
  • fxmanifest.lua

What each folder is for:

• bridge/: Framework (QBCore/QBox/ESX) and target system abstraction. DB schema mapping for different frameworks.
• client/: All client-side logic - garage UI, interior system, admin commands, private garages.
• config/: User-facing configuration and garage definitions split by category.
• locales/: Translation files for both Lua and NUI.
• server/: Core server logic - vehicle state management, impound, key sharing, job vehicles, admin operations.
• shared/: Locale loading utility.
• sql/: Base table schema (additional tables auto-created by server scripts).
• stream/: MLO interior assets for 3 garage levels. _manifest.ymf at root is critical.
• utils/: Fuel integration (12 resources), vehicle mod save/restore (50+ data points).
• web/: React NUI interface (TypeScript, Tailwind CSS, Vite).