FiveM Bundler

Bundle your FiveM resources into optimized .zip files directly inside Visual Studio Code — fast, simple, and without leaving your editor.

✨ Features

• 📦 One-click bundling of FiveM resources
• 📂 Custom output directory (default: Desktop)
• 🧹 Flexible file & folder exclusions
• 📊 Integrated progress tracking
• 🧾 Live logging via VS Code Output Panel
• 🧠 Automatic validation (fxmanifest.lua + lua54)

🚀 Getting Started

1. Open your FiveM resource folder in VS Code
2. Open the Bundler panel in the Activity Bar
3. Configure your exclusions (optional)
4. Choose an output directory (optional)
5. Click Bundle

Your .zip will be generated instantly.

⚙️ Configuration

Exclusions

Exclude files or folders from your bundle (similar to .gitignore):

Examples:

• node_modules
• dist
• build
• src

Output Directory

• Default: Desktop
• Can be changed via the Browse button in the UI

📋 Requirements

• A valid FiveM resource

• Must contain:

  • fxmanifest.lua
  • lua54 "yes"

📊 Logging & Progress

The extension provides:

• Real-time progress bar
• Detailed logs in the Output Panel

To view logs:

1. Open View → Output
2. Select FiveM Bundler

❗ Error Handling

Common issues:

fxmanifest.lua not found → Make sure you opened the correct resource folder

Missing lua54 'yes' → Ensure your manifest includes:

lua54 "yes"

🧠 How It Works

• Scans your resource directory
• Filters excluded files/folders
• Validates manifest configuration
• Compresses everything into a .zip archive

No temporary files, no staging — direct and efficient.

💡 Why Use This?

• No need for external scripts
• No terminal usage required
• Fully integrated into your workflow
• Faster iteration for development & deployment

🛠️ Development

Feel free to contribute or suggest improvements.

📄 License

MIT