Installation

Prerequisites

  • FiveM Server (latest recommended artifacts)
  • ox_lib
  • oxmysql
  • QBCore, QBox, or ESX

Step 1: Place Resource

Place nc-garages in your server's resources directory.

Step 2: server.cfg

ensure ox_lib
ensure oxmysql
ensure qb-core       # or es_extended, qbx_core
ensure nc-garages

nc-garages must start after your framework, ox_lib, and oxmysql.

Step 3: Configure

Edit config/config.lua for general settings (impound, fuel, UI). See Configuration.

Edit config/garages.lua to add/modify public garage locations.

Edit config/purchasable_garages.lua to set up buyable garages and their interiors.

Step 4: Target System (Optional)

If using Config.UseTarget = true, ensure one of these is started before nc-garages:

ensure ox_target    # or qb-target

Step 5: Start

refresh
ensure nc-garages

Database tables are created automatically on first start.

Troubleshooting

Garage UI not opening

  1. Ensure you are near a configured garage location
  2. If using NPC mode (Config.UseNPC = true), check that the NPC is spawned
  3. If using target mode (Config.UseTarget = true), ensure ox_target or qb-target is running
  4. Check server console for errors

Purchasable garage not showing in shop

  1. Ensure Config.PurchasableGarages.enabled = true
  2. The garage must be defined in config/purchasable_garages.lua
  3. The shop NPC must be configured in Config.PurchasableGarages.shop

Vehicles disappearing after restart

  1. Ensure oxmysql is running and connected
  2. Check that the vehicle table name matches your framework (auto-detected)
  3. Purchasable garage vehicles are stored with garage = 'pgarage_<id>' — do not clear this column

Flatbed not spawning on impound

  1. Ensure Config.ImpoundFlatbed.enabled = true
  2. The impound location needs a road nearby for the flatbed to path
  3. Check that the flatbed model (flatbed) exists on your server
Last updated 1 month ago