Browse docs
Advanced Pricing
Advanced Pricing replaces flat tuning markups with a server-authoritative calculation. It keeps the Dynasty supplier cost, mechanic margin, labor, tax, discount, and customer price separate so expensive vehicles cannot create uncontrolled workshop profits.
The feature is optional and disabled by default. Enable and configure it under /jobconfig → Mechanic Jobs → Advanced Pricing, or edit Config.TuningCostProfile.advancedPricing when the Job Configurator is disabled.
Price calculation
Each tuning position is calculated from these components:
| Component | Purpose |
|---|---|
| Supplier cost | Dynasty base cost, adjusted by category, stock, and demand |
| Mechanic margin | Configurable profit share constrained by global and grade limits |
| Labor | Installation cost from category, difficulty, vehicle class, and mechanic grade |
| Tax | Optional separately recorded tax percentage |
| Discount | Mechanic discount constrained by the configured maximum |
| Retail total | Final customer price constrained by minimum and maximum boundaries |
The server recalculates and validates the result. Client-supplied prices cannot bypass the configured boundaries.
Category and difficulty rules
Use categoryRules to define supplier share, margin, labor, difficulty, and price boundaries for groups such as:
- Bodywork and paint
- Engines and transmissions
- Brakes and suspension
- Wheels and stance
- Turbo and anti-lag
- Lighting and custom tuning
difficultyRules add a reusable labor fee for simple, standard, complex, or expert work. This allows an engine conversion to carry more labor than a color change without duplicating the complete price configuration.
Vehicle classes and mechanic grades
vehicleClassRules adjust margin and labor by GTA vehicle class. Compact vehicles can use lower labor multipliers while sports and super vehicles use higher values.
mechanicGradeRules control:
- Margin adjustments
- Labor multipliers
- Maximum discounts
- Grade labels shown in pricing details
Global minimumMarginPercent and maximumMarginPercent remain hard boundaries after all adjustments.
Quotes and order-bound procurement
Advanced Pricing creates a server-calculated quote for every tuning order. quoteLifetimeMinutes controls how long the quote remains valid before it must be recalculated.
Dynasty purchases are bound to the specific tuning order. This prevents a mechanic from buying a cheap generic part and applying it to an unrelated high-value order. When an order-bound part is returned, returnRefundPercent controls the refund deduction.
Dynamic Dynasty inventory
The optional inventory block maintains virtual supplier stock and demand:
| Setting | Purpose |
|---|---|
baseStock | Normal stock level for supplier items |
lowStockThreshold | Point at which scarcity pricing begins |
lowStockMarkupPercent | Maximum markup caused by low stock |
demandMarkupPerUnitPercent | Price increase for every demand point |
maximumDemandMarkupPercent | Demand markup ceiling |
restockPerDay | Virtual units restored per elapsed day |
demandDecayPerDay | Demand points removed per elapsed day |
Disable inventory.enabled to retain the other Advanced Pricing rules without stock- and demand-based supplier changes.
Tablet profit analysis
Authorized workshop staff can review the configured analytics period in the Parts Shop tablet. The report separates:
- Revenue
- Supplier costs
- Labor costs
- Mechanic margin
- Tax and discounts
- Refunds
- Profit and profit margin
- Best-selling parts and categories
The underlying accounting entries are stored server-side when order pricing or fulfillment changes.
Configuration preview
JobConfig includes compact, sports, and supercar examples. The preview uses the configured vehicle values and tuning percentage to show how category, class, margin, labor, and supplier settings affect the final price before you save them.
Recommended rollout
- Enable Advanced Pricing on a staging server.
- Configure realistic vehicle values and category rules.
- Set minimum and maximum margins before adding grade adjustments.
- Test the compact, sports, and supercar previews.
- Complete an order, buy its Dynasty parts, install it, and verify the accounting report.
- Test quote expiry, discounts, returns, low stock, and demand changes.