Admin Management Menu

The Admin Management Menu is a powerful tool for efficiently managing and configuring tuner shops within the game. Accessible via command or keybind, this menu allows admins to create, view, and manage tuner shops in real-time.

Using the shop creator tool, admins can fully customize each shop by setting a unique name, enabling or disabling map blips to create hidden or public shops, and integrating the shop with existing server jobs, automatically pulling job grades. Alternatively, admins can create a new job with a custom name and label, using predefined job grades from the configuration. Additionally, admins can set an initial account balance and limit the shop’s services to specific modification categories, enabling the creation of specialized tuner shops. The system comes with the following predefined modification categories: respray, body works, chassis, engine bay, exterior, interior, lights, wheels, and performance.

When managing tuner shops, admins can designate a shop boss, adjust the shop’s account balance, and modify allowed modification categories. Admins can also configure various shop markers, each with distinct functionalities. Multiple instances of the same marker type are supported, providing greater flexibility in shop operations. Each marker can be given a unique name, with customizable blip settings and marker visuals, allowing for a tailored in-game experience.

When overseeing tuner shops, admins can designate a shop boss, manage the shop's account balance or customize the shop's allowed modification categories.

Admins have the ability to configure various shop markers, each offering distinct functionalities. Multiple instances of the same marker type are supported, enhancing shop flexibility. Each marker can be uniquely named, with customizable blip settings and marker visuals for a tailored in-game experience.

Should a shop become redundant, it can be permanently removed with ease. This versatile menu streamlines shop management and configuration without requiring server restarts, ensuring smooth and uninterrupted gameplay administration.

Tuner Shops

Each tuner shop is equipped with essential markers, each offering unique functionalities necessary for the shop’s operations:

• Duty Marker: Allows tuners to toggle their duty status, enabling them to clock in for work or go off-duty as unemployed.
• Boss Marker: Grants the shop’s boss the ability to manage the shop’s finances (deposit, withdraw, and view funds), oversee employee management (recruit, fire, promote, and demote employees), and set the shop's markup percentage.
• Garage Marker: Provides a dedicated space for storing and retrieving personally owned vehicles. This is a private garage, not a shared one.
• Storage Marker: A secure location for storing and accessing items such as mods, tools, kits, and materials. This storage is accessible to all hired employees, ensuring that all staff members have access to the resources they need for their work.
• Workbench Marker: Allows tuners to craft usable mod items and tools necessary for their work. Each craftable item has configurable recipes based on available materials, adding depth and customization to the shop's crafting system.
• Laptop Marker: Enables tuners to order mods and kits if they lack the necessary materials. The cost is deducted from the shop's account, and items are automatically delivered to a selected storage marker or the tuner’s inventory.
• Customs Marker: The area where players can customize their vehicles through self-service, with modifications restricted to the categories enabled for that specific shop. Players have the option to pay immediately for instant modifications at an incentivized price or submit a mod order at a discounted rate, which will require tuners to install the mods.
• Tuning Bay Marker: The core workspace for tuners, where they can access and start mod orders, order new engines for engine swaps to alter vehicle sound, or install various nitrous kits. This is the primary area for performing advanced tuning tasks and modifications.

Vehicle Tuning

At the customs marker in a tuner shop, players can access a self-service customization menu, limited to the modification categories enabled for that shop. There will also be a prompt to quick-repair the vehicle for configurable base price, this feature can also be disabled, encouraging roleplay with mechanics.

Explore all available GTA tuning options, including DLC mods and the latest GTA: Online Chop Shop update, featuring seven new custom plates. Create unique respray combinations or choose from the standard GTA color palette. The system also supports special resprays like chameleon, util, and worn, which can also be applied to certain wheels and interiors.

Players can preview all modifications live before adding them to their basket. Once satisfied with the customization, they have the option to either pay immediately for instant modifications at an incentivized price or submit a mod order at a discounted rate, requiring tuners to complete the installations.

Configurable options in the configuration file allow you to disable specific mods, such as weapon mods, restrict immediate purchases to encourage roleplay opportunities for tuners, and enable or disable incentivized pricing for immediate payments. You can also set a desired incentivized percentage to be added to mod prices for instant purchases.

Mods Pricing

The Tuning System features an advanced pricing mechanism designed to support a balanced and realistic economy for your roleplay server. The pricing system is highly customizable, offering several key options to fine-tune the cost of modifications:

• Price Escalation: This option allows you to set a percentage between 0-100% to progressively increase the prices of mod variants. Setting it to 0 disables escalation, resulting in a flat price for all variants. When enabled, each successive upgrade costs more, reflecting the increased value of higher-tier modifications.
• Parts Acquisition Costs: You can choose to include or exclude the cost of acquiring parts in the final mod price. If enabled, the configured item price is added to the calculated mod cost, simulating the expense of sourcing parts. This feature helps cover the costs associated with acquiring materials for more realistic financial management.
• Tiered Pricing: This feature bases mod prices on the vehicle’s market value, using a tiered system with specific price caps and multipliers. For example, Tier 1 could apply a 5% multiplier for vehicles priced up to $10,000, making mods for expensive cars costlier than those for cheaper ones. If tiered pricing is disabled, all modifications are priced equally, regardless of the vehicle’s value.
• Base Price Configuration: You can set a base price for each mod type within the configuration file, providing a foundation for all mod prices. This allows you to tailor the costs to align with your server’s economic model.

This comprehensive pricing system enables you to create a finely-tuned and sustainable economy, perfectly suited to your roleplay server’s needs and player dynamics.

Tuner Tablet

The tuner tablet is an essential tool for every tuner, offering a range of functionalities to enhance vehicle diagnostics and shop operations. When connected to a vehicle, it provides vital information such as engine and body health values, fuel level, and details about the installed GTA performance parts, including the engine, brakes, transmission, suspension, turbo, and armor. It also grants access to the dyno for fine-tuning vehicle handling.

When not connected to a vehicle, the tuner tablet allows tuners to create and manage bills, request NPC jobs during low player activity, and view a comprehensive list of submitted mod orders along with detailed information on each order.

Mod Orders

Mod orders can be managed directly from the tuner tablet, allowing tuners to view or refund orders as needed. To begin working on a mod order, the tuner must bring the specified vehicle to an available tuning bay marker. A custom workflow UI will guide the tuner through each step, requiring the manual installation of all ordered mods using the appropriate items.

When using a mod item, a menu of possible mod variants will appear, and the tuner must select the corresponding variant from the order. A configurable prop representing the mod, with customizable offsets and animations, will appear in the tuner's hands. The tuner must then target the vehicle at the designated interaction points (hood, trunk, side, or wheel), complete a skill check (configurable), and initiate the immersive installation animation. Upon completion, the vehicle’s properties will update with the newly installed mod variant, and the item will be removed.

If the correct mod variant is installed, it will be marked as complete in the workflow UI, allowing the tuner to proceed to the next task. If not, the tuner must repeat the process with the correct item. Once all installations are complete, the pre-paid amount from the customer will be credited to the shop’s account, and the customer can leave with their modified vehicle.

Drift Tyres

Tuners can enhance vehicle performance by installing drift tires, enabling "drift mode" for improved control during drifting. The system also allows for resetting to standard performance by reinstalling stock tires. Both actions are facilitated through the use of consumable items, adding a layer of immersion with detailed animations and props. This feature brings realistic customization options and dynamic driving mechanics to enhance the player experience.

Engine Swaps

Configure engines based on vehicle class, allowing for unique engine sounds using either GTA’s default or custom streamed sounds. Each engine can have a custom label, price, and optional icon. The script comes pre-configured with 4-5 engines per vehicle class, giving you the flexibility to maintain realistic sound profiles and prevent mismatches, like a basic car sounding like a supercar—although you have full control over the sound assignments.

Engine swaps do not affect vehicle handling; they are designed solely to alter the vehicle’s sound. Tuners can bring any vehicle to the tuning bay marker, select “Engine Swaps,” and view a list of available engines based on the vehicle's class. Once an engine is ordered, the tuner must prepare and extract the old engine using a hoist, wait for the new engine to arrive, and then install it into the vehicle— all with realistic props and immersive animations.

Engine sounds are synchronized across all players using statebags and saved in the database for owned vehicles, ensuring persistence even after server restarts.

Nitrous

The built-in advanced nitrous system revolutionizes vehicle performance, offering an immersive and highly configurable nitrous experience for tuners and players. Tuners can install nitrous kits at the Tuning Bay, selecting the kit size in pounds (lb), with each pound providing 10 shots of NOS Burst. The installation process is detailed and immersive, requiring tuners to prepare the engine bay with props and animations to fit the new kit.

To extend the NOS Burst duration, tuners can install burst upgrade kits, which increase the burst threshold from the default value to a maximum configurable limit. The installation follows the same detailed process, complete with props and animations. Admins can set up these burst kits in the configuration file with customized thresholds.

NOS 10-Shots Bottles, containing 1 lb of nitrous each, can be purchased by tuners to refill a vehicle’s NOS capacity, providing 10 shots per use. Empty bottles can be refilled at designated locations around the map, with finite nitrous supplies that reset after each server restart.

The purge button allows players to expel excess nitrous gas while stationary, boosting the effectiveness of the NOS Burst. Each second of purging consumes 1 shot of nitrous, with purge efficiency stacking up to the burst kit’s threshold, achieving 100% efficiency at full purge. Shorter purges offer reduced efficiency (e.g., 70% for a 1-second purge), with all percentages fully configurable. If no purge is used, the efficiency defaults to 30% (configurable), and once the efficiency window expires, it defaults to 50% (configurable). During the efficiency window, NOS Burst operates at the available efficiency.

The burst button significantly boosts vehicle performance, consuming 1 shot of nitrous per second, with the performance directly tied to the purge efficiency. Bursting without purging introduces a medium risk of engine damage, while bursting after the efficiency window expires carries a lower risk. Holding the burst key beyond the burst kit’s threshold creates a high risk of engine damage, with all risk chances configurable.

If players attempt to purge during the nitrous cooldown (can be disabled), triggers when the efficiency window expires, a gas leak may occur, leading to a loss of nitrous shots (configurable). Visuals, particle effects, and sounds accompany purging, bursting, and gas leaks, enhancing immersion. Additionally, tuners can inject a purge dye item into the nitrous kit to apply personalized RGB colors to the purge effects.

The system also tracks key nitrous properties—such as shots, kit size, and burst kits—through vehicle statebags, ensuring persistent and synchronized data across the server. This advanced nitrous system elevates the vehicle tuning experience, providing tuners and players with a dynamic, immersive, and realistic way to customize and boost vehicle performance while adding layers of strategy and risk to roleplay servers.

Dyno Tuning

Dyno tuning is accessed via the tuner tablet when connected to a vehicle. The dyno provides detailed insights into the vehicle’s current modifiers for torque, power, and brakes, enabling precise performance adjustments.

• Torque: Represents the drive force at the wheels.
• Power: Determines how quickly the engine revs.
• Brakes: Adjusts the braking strength by multiplying the game's deceleration calculation (higher values result in stronger braking).

The fine-tuning slider allows for precise modifications to these performance parameters. A hard reset option is also available to restore all modifiers to their default values.

NPC Jobs

The Tuning System offers two immersive NPC job opportunities for tuners to engage in during periods of low customer activity at their shop:

1. Salvage Job: Tuners are tasked with locating and salvaging junk cars to recover materials and potentially valuable parts for tuning purposes. The tuner must 3rd-eye-target the different bones of the vehicle to salvage it. This job is highly customizable, allowing for the configuration of cooldown intervals between jobs, selection of specific junk car models, and customization of map blips. Additional settings include skill check requirements and customizable rewards, with options to define the probability and quantity of items. The system includes 7 predefined locations, with the flexibility to add more to suit your server’s needs.
2. Mobile Tuning Job: This job involves responding to a customer request for on-site performance enhancements or cosmetic modifications. Tuners receive detailed instructions on the required installation and must ensure they have the appropriate part before heading to the location. Upon arrival, the tuner interacts with the NPC to confirm the mod variant needed and then performs the installation using the required item. Accurate installation is essential for successful completion and payment. This job can be tailored with configurable settings such as cooldown periods, car and ped models, blip customization, and minimum and maximum cash rewards. The system includes 12 predefined locations, with the option to add more as desired.

Both job systems are synchronized across players to prevent multiple tuners from receiving the same assignment, ensuring a seamless and engaging roleplay experience.

Mod Stations

The system includes pre-configured self-service mod stations specifically designed for whitelisted jobs. Each station offers configurable options such as location coordinates, accessible job roles, permitted modifications, and the ability to toggle modification costs and map blip visibility. This feature is particularly beneficial for roles like law enforcement, enabling quick and efficient vehicle modifications before heading out on duty

Billing System

This resource features a comprehensive billing system designed for tuners to create detailed, itemized bills for their customers. Tuners can add specific notes for each service, providing transparency and clarity for customers. Before the payment is processed, customers must review, confirm, and sign the bill, ensuring they agree with the charges. Tuners can access a list of all issued bills, which is particularly useful for shop owners to monitor transactions, track completed work, and manage overall shop expenses effectively. This system not only enhances the customer experience with clear communication but also helps shop owners maintain accurate financial records and accountability.

Customization

The scripts has config file(s) with an extensive amount of configurable options, allowing extreme customization to make the system work with your roleplay server. A separate language file, containing all strings, makes it very easy for you to translate the system into your preferred language of choice. There's an icon folder with inventory icons for all included items.

Performance

The script has been rigorously tested to ensure maximum optimization and smooth performance, even on large servers with high player counts. Its low resource usage minimizes server strain, providing a stable and seamless gameplay experience for all users. The focus on efficiency and reliability ensures that the script can handle peak activity without compromising functionality or player immersion, making it a robust choice for any server environment.

Sync

The script is fully synchronized across all players, utilizing OneSync Infinity and statebags for seamless and reliable synchronization.