Quick Workshop Launcher

A lightweight BakkesMod plugin for Rocket League that lets you browse and launch local workshop maps with a single click.

Instead of manually typing load_workshop "<map path>" into the BakkesMod console every time, this plugin scans your workshop maps folder and displays every available map in a searchable list.

---

📑 Table of Contents

• Features
• Building
• Installation
• Opening the Launcher
• Binding to F3
• Workshop Maps Folder
• Downloading Workshop Maps
• Example Folder Structure
• Known Issues
• Future Improvements
• License

---

🚀 Features

• Automatically scans a workshop maps folder recursively.
• Supports .udk and .upk maps.
• Search maps instantly.
• Launch any map with one click.
• Refresh button to rescan the folder.
• Automatically formats map names into a more readable format.
• Lightweight and minimal.

---

🔨 Building

Requirements

• VS Code
• Visual Studio Build Tools 2022 (MSVC + Windows SDK)
• CMake
• Git
• BakkesMod SDK

Build the plugin with:

.\build.ps1

The script will:

• Delete the previous build folder.
• Configure CMake.
• Build the project in Release mode.
• Copy QuickWorkshopLauncher.dll into the project root.

---

📦 Installation

Copy:

QuickWorkshopLauncher.dll

into:

...\BakkesMod\bakkesmod\plugins\

Restart Rocket League (or reload plugins if supported).

---

🖥 Opening the Launcher

Open the BakkesMod console (F6 by default) and run:

togglemenu quickworkshoplauncher

---

⌨️ Binding to F3

To open the launcher using F3:

bind F3 "togglemenu quickworkshoplauncher"

To remove the bind:

unbind F3

---

📁 Workshop Maps Folder

By default, the plugin automatically uses:

%APPDATA%\bakkesmod\bakkesmod\maps

which usually resolves to something like:

C:\Users\<YourUser>\AppData\Roaming\bakkesmod\bakkesmod\maps

If your maps are stored somewhere else, simply paste the desired folder path into the plugin and click Refresh.

---

📥 Downloading Workshop Maps

1. Visit the BakkesMod Workshop Maps website.

2. Download the desired map as a ZIP archive.

3. Extract the ZIP.

4. Copy the extracted folder into:

%APPDATA%\bakkesmod\bakkesmod\maps

For example:

maps/
└── LethDribbleChallenge1_1.0.0/
    └── LethDribbleChallenge1.udk

After copying the map:

• Open Quick Workshop Launcher.
• Click Refresh.
• The new map should immediately appear in the list.

---

📂 Example Folder Structure

maps/
├── air_dribble_hoops/
│   └── air_dribble_hoops.udk
│
├── LethDribbleChallenge1_1.0.0/
│   └── LethDribbleChallenge1.udk
│
├── LethIceRings_1.0.0/
│   └── LethIceRings.udk
│
├── Orbital_Rings/
│   └── Orbital_Rings.udk
│
└── Speed_Jump_Rings_3__By_dmc/
    └── Speed_Jump_Rings_3__By_dmc.udk

---

⚠️ Known Issues

Maps folder path is not saved

Currently, the configured maps folder path is not persisted after Rocket League closes.

This means you'll need to paste the folder path again after restarting the game.

If you don't want to deal with this for now, simply use the default BakkesMod maps directory:

%APPDATA%\bakkesmod\bakkesmod\maps

The plugin will automatically use this path on first launch.

If anyone knows the proper BakkesMod API or preferred method for persisting plugin settings, pull requests are welcome.

---

🛣 Future Improvements

• Save the maps folder path between sessions.
• Favorites.
• Recently played maps.
• Better map name formatting.
• Sorting options.
• Optional thumbnails (if available).

---

🤝 Contributing

Issues, suggestions, and pull requests are welcome.

If you're able to implement persistent configuration saving for the maps folder, feel free to open a PR.

---

📄 License

This project is open source and provided as-is for the Rocket League community.