Before You Begin#

Before installing Quasar Downtown Mechanic, make sure your FiveM server is updated and ready to load custom map resources.

This resource does not require any framework dependency and works independently with any server setup, including:

ESX
QBCore
QBox
Standalone

No database, inventory, or external library is required.

The only requirement is a working FiveM server with permission to load custom map assets.

Downloading Downtown Mechanic#

After purchasing Quasar Downtown Mechanic, download the latest version from your CFX Portal granted assets.

Once downloaded, extract the resource and place the complete folder inside your server resources directory.

The resource structure should remain unchanged:

code

qs_downtown_mechanic/
├── fxmanifest.lua
├── client.lua
├── server.lua
├── map_state.json
└── stream/

The stream folder contains all required MLO files, custom props, collisions, and map assets required for the mechanic workshop.

Do not remove or rename any files inside the resource, as the streaming system depends on the original asset names.

Installing the Resource#

Move the qs_downtown_mechanic folder into your server resources directory.

Example:

code

resources/
└── [maps]/
    └── qs_downtown_mechanic/

After placing the resource, add it to your server.cfg:

code

ensure qs_downtown_mechanic

Restart your server completely to allow FiveM to load the new map assets correctly.

A simple resource refresh is not recommended on the first installation because the MLO contains new streamed models, collisions, and map replacements that need to be loaded from a fresh client connection.

Verifying the Installation#

After installing the resource and restarting your server, verify that Quasar Downtown Mechanic has loaded correctly.

In your server console, you should see a message similar to:

code

[MECHANIC MAP] State loaded: 0

If this is the first startup and no state file exists, the resource will automatically create the default configuration:

code

File not found, creating default state.

When a player joins the server, the client console should display:

code

[MECHANIC MAP] Active map set to: 0

Once loaded, travel to the mechanic location:

code

-74.6, -1332.2, 29.8

and verify that the workshop interior, custom props, doors, and collisions are visible correctly.