How to install:
Dependencies:
Inventory support:
Clothing support:
Notes:
Useful Links:
| feature | Multi-weapon switch configuration supporting unlimited base and upgraded weapon pairs. |
| feature | Bidirectional conversion allows installing switches (A -> B) and removing switches (B -> A) with item refunds. |
| feature | Preserves weapon metadata across switches including ammo count, serial numbers, and durability/quality. |
| feature | Flexible item management allowing universal switch items or unique attachment items per weapon pair. |
| feature | Configurable weapon requirement: enforce weapons held in hand or auto-detect from player inventory. |
| feature | Custom installation and removal durations configurable globally or individually per weapon entry. |
| feature | Immersive synchronized character animations, progress bar integration, and temporary firing lockouts. |
| feature | Convenient detachment command (/r_switch) with carry capacity validation and instant return of switch item. |
| feature | Server-side exploit verification preventing item duplication, trigger cheating, or unauthorized weapon swaps. |
| feature | Native modern ak47_lib multi-framework architecture supporting ESX, QBCore, and QBX out of the box. |
| feature | Native JSON translation system via locales/en.json for fast and clean multi-language customization. |
| feature | Ready-to-use client and server exports for radial menus, inventory use actions, or custom job scripts. |
| install | Download ak47_switch from your cfx portal. |
| install | Add the script into resources folder. |
| install | Add items based on your framework instruction. |
| install | Add item images into inventory. |
| install | Add this resource at the bottom of your server.cfg |
| install | Make sure you have all dependencies. |
| install | Restart your server |
| dependency | esx/qb/qbx |
| dependency | ak47_lib |
| note | We don't support custom framework. Make sure you are using official framework update. |
| note | Renaming the script is not allowed. It may break the functionalities. |
| note | Don't upload the script with FileZilla, Use Winscp if you are using FTP for file uploading. |
| link | ak47_lib: https://github.com/MenanAk47/ak47_lib/releases/latest |
| link | Documentation: https://docs.menanak47.com/multi-framework/ak47_switch |
© MenanAK47 | All Rights Reserved.