Browse docs
Tuning and Orders
Tuning modes
Sky Mechanic Job supports workshop tuning, public self-service tuning, and optional instant tuning locations. Access and pricing should be reviewed separately for each mode.
Instant tuning can be public, mechanic-only, or restricted to an allow-list of jobs. Its price multiplier is applied on top of the normal tuning price.
Order lifecycle
- A customer or mechanic selects tuning options.
- The resource calculates the price from the configured vehicle value and pricing profile.
- The customer selects an enabled payment method.
- A tuning order is created for the mechanic workflow.
- Required items and installation steps are completed.
- Installed tuning and order history are saved for the vehicle plate.
Orders can also store refund information. Confirm the order state before refunding or repeating an installation.
Pricing
Config.TuningCostProfile supports percentage-based and fixed pricing.
| Setting | Purpose |
|---|---|
priceType | Selects percentage or fixed prices |
fallbackVehicleValue | Used when no vehicle purchase price is found |
freeVehicles | Makes all tuning options free for listed models |
addRevenueToSociety | Deposits paid tuning revenue into the mechanic society account |
publicUsersSeePrices | Controls whether public users see normal prices |
Percentage pricing is only reliable when vehicle catalog prices can be resolved. Custom vehicle shops may require the open vehicle price lookup hook in config/sv_functions.lua.
Required items
Individual tuning options can be enabled or hidden and can require one or more inventory items. Items are normally consumed after a successful installation unless that option explicitly keeps them.
Keep these three areas synchronized:
- Inventory item definitions
- Mechanic shop or Parts Shop catalog
- Tuning option item requirements
Workshop enforcement
Config.TuningWorkshopRequirement can require order installations and tuning removals to take place near a self-service tuning workshop point. Enable this when mechanics should not complete work anywhere on the map.
Installation flows
Different modifications can use wheel, hood, lift, oil-change, fluid-refill, paint, or other configured flows. Workshop points and required items must support every enabled flow.
Testing checklist
- Test both percentage and fixed prices before launch.
- Verify cash, card, and society behavior used by your setup.
- Confirm paid revenue reaches the expected society account.
- Confirm required items are removed only after a successful install.
- Test a cancelled or failed install for unintended item loss.
- Verify free vehicles and disabled options behave as configured.
- Confirm tuning persists after storing, retrieving, and restarting the vehicle.