> For the complete documentation index, see [llms.txt](https://docs.menanak47.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.menanak47.com/multi-framework/ak47_mechanic.md). # ak47\_mechanic The ultimate advanced mechanic and vehicle tuning experience for FiveM servers. {% embed url="" %} ak47\_mechanic completely redefines vehicle customization and workshop roleplay with a sleek modern UI, real-time 360-degree camera controls, and physical prop installation workflows. Featuring dynamic vehicle-based pricing, an itemized billing system, comprehensive diagnostics, flatbed and tow rope systems, and dynamic NPC roadside missions, it delivers unmatched depth powered by `ak47_lib` multi-framework support. *** ### 🔥 Key Features Designed to improve roleplay immersion and economy balancing: #### 🚗 Advanced Customization & Modern NUI * **Modern Tablet Interface:** Sleek, responsive web UI with smooth animations, intuitive categorization, and right-click camera pan and orbital control around the vehicle. * **Complete Tuning Suite:** Full performance upgrades (Engine, Brakes, Transmission, Suspension, Armor, Turbo, Nitrous) and extensive cosmetic options (Spoilers, Bumpers, Skirts, Hoods, Exhausts, Grilles, Roofs, Fenders, Roll Cages). * **Interior & Wheel Styling:** Custom racing seats, custom steering wheels, dashboard trims, dials, plaques, and an expansive catalog of wheel categories including Benny's Original and Open Wheel. * **Gen9 Chameleon Respray & RGB:** Primary, secondary, pearlescent, wheel, dash, and interior colors with custom RGB sliders and GTA V Gen9 Chameleon paint ramp effects. * **Interactive Vehicle Controls:** Toggle vehicle doors, hood, trunk, and test horn audio directly inside the customization menu. #### 🔧 Immersive Mechanic Roleplay & Usable Props * **Interactive Mechanic Process:** Option to require mechanics to physically grab and install components rather than applying upgrades instantly from a menu. * **Physical 3D Props:** Realistic props attached and carried by mechanics—including engine hoists, toolboxes, wheels, bumpers, hoods, exhausts, spoilers, and seats—with interactive pickup, carry, and drop commands. * **Color-Synced Spray Particles:** Respraying vehicles generates realistic spray paint can animations and synchronized RGB paint smoke particles. * **Usable Repair & Maintenance Kits:** Dedicated standalone items including Tire Repair Kits (with burst tire animation), Repair Kits, Advanced Repair Kits (engine, body, deformation, and fuel tank restoration), and Cleaning Kits with sponge props. #### 💼 Economy, Billing & Workshop Management * **Dynamic Vehicle-Based Pricing:** Upgrade costs automatically scale as a percentage of the vehicle's dealership price, ensuring balanced pricing for low-end vs. supercar modifications. * **Static Fallback & Multipliers:** Fully customizable static price tables with category multipliers when not using dealership pricing. * **Itemized Invoicing System:** Mechanics can generate detailed bills sent directly to nearby customers to review subtotal, labor fees, and total costs before payment. * **Society & Business Revenue:** Configurable labor fees and shop revenue cuts automatically deposited into company society accounts (ESX Society / qb-management / qbx\_management). * **Multi-Shop & Garage Integration:** Configure multiple mechanic locations (Bennys, LS Customs, custom shops) with dedicated vehicle garages, rank access, employee stashes, and parts supply stores. #### 🚛 Diagnostics, Towing & NPC Roadside Missions * **Component Diagnostic Menu:** Detailed ox\_lib / Lib47 context menu showing color-coded health percentages for body, engine, fuel tank, and individual wheels (requires a mechanic toolbox nearby to perform repairs). * **Dual Towing Systems:** Scaleform-controlled flatbed and Guardian ramp towing with real-time height, movement, and tilt controls, plus a dynamic physics-based tow rope system with detach protection. * **Dynamic NPC Service Calls:** Automated NPC roadside distress calls (`/mecnpcjob`) featuring stranded vehicles, repair and tow-to-depot objectives, and dynamic payouts based on distance and damage extent. #### 🛠️ Technical Excellence * **Multi-Framework & Target Support:** Seamlessly works with ESX, QB, QBX, and various target systems (ox\_target, qb-target, qtarget). * **Highly Secure:** Built-in server-side exploit checks, including distance validation and trigger authentication, to prevent cheating. * **Extensive Inventory Compatibility:** Built-in support for ox\_inventory, qb-inventory, qs-inventory, and ps-inventory with pre-configured items, SQL setups, and high-resolution inventory icons. *** ### 💻 Framework: * ESX, QB, QBX *** ### ⚙️ Dependencies: * ak47\_lib: *** ### ⚙️ How To Install: * Download ak47\_mechanic from your cfx portal. * Add the script in your resources folder. * Add items based on your framework instruction. * Add item images into inventory. * Start the script in your server.cfg below framework files. * Make sure you have all dependencies. * Restart the server. *** ### 🔗 Links & Support: * **📖 Documentation:** * **🛒 Buy Now (Tebex):** * **💬 Discord Support:** *** ### 📝 Note: * We don't support custom framework. Make sure you are using official framework update. * Renaming the script is not allowed. It may break the functionalities. * Don't upload the script with FileZilla, Use Winscp if you are using FTP for file uploading