Skip to content

OmiJod/vehiclemerger

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

5 Commits
Β 
Β 
Β 
Β 

Repository files navigation

FiveM Vehicle Merger Tool

πŸš— Simplify the process of merging vehicle resources for your FiveM server! πŸš—

This tool automates the task of combining multiple vehicle resource folders into a single, organized package, making it easier to manage and integrate custom vehicles into your server.


🎯 Features

  • Automatic Folder Merging: Combines meta files and stream files from multiple vehicle folders into a structured format.
  • Ready-to-Use fxmanifest.lua: Automatically generates a manifest file for immediate use in your FiveM server.
  • Vehicle Spawn Codes: Creates a spawncodes.txt file listing all vehicle spawn codes (based on folder names in the data directory).
  • Folder Organization: Neatly organizes your data and stream folders.
  • Auto Folder Opening: Opens the merged output folder after processing.
  • User-Friendly Interface: A clean GUI to simplify folder selection and merging.

πŸ–₯️ How to Use

  1. Download and Run:

    • Clone this repository or download the .exe from Releases.
    • Run the executable.
  2. Select Folders:

    • Choose your input folder (where vehicle resources are located).
    • Choose your output folder (or use the same folder as the input).
  3. Merge Vehicles:

    • Click "Merge Vehicles" to start the process.
    • The tool will merge the files, generate the required files, and open the output folder automatically.
  4. Deploy:

    • Place the mergedvehicles folder into your FiveM server's resources directory.
    • Add start mergedvehicles to your server.cfg.

πŸ› οΈ Requirements

no additional setup is needed!


πŸ“ Output Structure

After merging, the mergedvehicles folder will look like this:

mergedvehicles/
β”œβ”€β”€ fxmanifest.lua
β”œβ”€β”€ spawncodes.txt
β”œβ”€β”€ data/
β”‚   β”œβ”€β”€ vehicle1/
β”‚   β”‚   β”œβ”€β”€ handling.meta
β”‚   β”‚   β”œβ”€β”€ vehicles.meta
β”‚   β”‚   └── carvariations.meta
β”‚   β”œβ”€β”€ vehicle2/
β”‚       β”œβ”€β”€ handling.meta
β”‚       β”œβ”€β”€ vehicles.meta
β”‚       └── carvariations.meta
β”œβ”€β”€ stream/
    β”œβ”€β”€ vehicle1/
    β”‚   β”œβ”€β”€ vehicle1.yft
    β”‚   β”œβ”€β”€ vehicle1.ytd
    β”‚   └── vehicle1_hi.yft
    β”œβ”€β”€ vehicle2/
        β”œβ”€β”€ vehicle2.yft
        β”œβ”€β”€ vehicle2.ytd
        └── vehicle2_hi.yft

πŸ”§ Customization

Feel free to customize the script for additional functionality. You can modify:

  • fxmanifest.lua content.
  • Folder naming conventions.
  • Additional file generation.

πŸš€ Contribute

We welcome contributions! If you find a bug or have a feature request, feel free to:

  • Submit an issue.
  • Fork the repo and create a pull request.

πŸ† Credits

  • Author: nullvalue
  • Description: Built to simplify vehicle merging for FiveM servers.

πŸ“œ License

This project is licensed under the MIT License. See the LICENSE file for details.


πŸ’¬ Questions or Feedback?

Feel free to open an issue or contact us through GitHub. We’d love to hear your thoughts! πŸš—πŸ’¨ Discord - https://discord.gg/khN9aqTnY6

About

A Fivem Vehicle Merger tool to Compress Vehicles into One Folder

Resources

Stars

Watchers

Forks

Packages