RUMBLE Mod Manager

Welcome to the RUMBLE Mod Manager! This tool is designed to help you manage your RUMBLE mods and make mod installation easier for both new and experienced users.

How to Install

1. Click on the Manual Download button at the top of the page, or go to the Versions tab and download whichever version you want.
2. Extract the downloaded zip file to a folder of your choice.
3. Open the folder RUMBLE Mod Manager and run RUMBLE Mod Manager.exe to start the program.
4. You're all set! You can follow the instructions below for how to use the mod manager.

Important Notes

• Backup your data: Always a good practice to back up important files before trying new software. I'm working on adding automatic data backup to the manager soon.
• File Handling: The mod manager involves managing files (obviously). It's designed to be safe, but your feedback will help ensure everything is smooth.
• Community Review: Feel free to give your input and contribute towards making the manager better.

Please keep in mind this is my first time making a program like this. I am not good at this by any means. Your constructive feedback and suggestions would be extremely valuable as I work on refining and enhancing the project.

System Requirements

• NET 8 and NET 6 is required to run this application. You can download NET 8 here and NET 6 here. Install the window runtime for each.
• This application is only compatible with Windows.

How To Use

1. Initial Setup: When you first open the manager, you might see a message saying "Path not found." Select the appropriate path.

   • Once your RUMBLE path is found, you should see some buttons appear. If the path is found automatically, you can close the settings menu. If not, set your RUMBLE path manually (this is where your RUMBLE.exe is located).

2. Launching the Manager:

   • Click "Launch." The manager will fetch the mods from Thunderstore. If you already have the custom maps mod installed, it will fetch the maps as well.
   • Once everything is set up, you're good to go!

3. Installing Mods:

   • Click the Thunderstore button in the bottom right to install mods from the internet.
   • Reinstalling a mod on the Thunderstore page will update the mod.
     • You can also update mods by selecting one in the main menu and clicking on the cloud icon next to the version number on the top right.
     • Color Indicators:
       • Blue: Future version installed
       • Green: Up to date
       • Red: Out of date
   • You can check if a mod is out of date by looking at the square in the bottom right corner of each mod.

4. Managing Local Mods:

   • Click on one of the panels on the left of the main menu to see the details of your local mods (the ones you have installed).
     • If the mod is not recognized (e.g., downloaded from somewhere else or if the DLL file is not named clearly), it may show as "Unknown."
   • This panel displays the name, description, last updated date, dependencies, version, icon, and several buttons:
     • Toggle: Turn the mod on or off.
     • Uninstall: Remove the mod by clicking "Uninstall" and confirming in the popup window.

5. Settings:

   • Change your settings by clicking the gear icon next to the Thunderstore button.

MelonLoader Installation

If this is your first time modding RUMBLE and you don't have MelonLoader installed, don't worry! The mod manager will install it for you. Just follow the instructions carefully:

1. If you dont have MelonLoader installed, just click the launch button (after finding your path)

   • After fetching the mods, it should start to install MelonLoader

2. Once MelonLoader is installed, it will launch the game. (Make sure to read the popup first).

   • Ensure you see the MelonLoader start screen when the game opens.
   • Wait until the game reaches the T-pose screen (where the RUMBLE man is standing with arms outstretched).
   • Once you see that, close the game, and the mod manager should open.

3. Congratulations! You have successfully modded RUMBLE!

Version 1.4.7

• Hopefully fixed MelonLoader downgrading issue
• Added back option to auto-update mods on load
• Switched buttons to use steam URI protocol to hopefully allow them to work on Linux

Version 1.4.6

• Fixed invisible window issue

Version 1.4.5

• First release added to thunderstore
• Finally fixed the in-app updater system.

Version 1.4.4

• Sorting options save between sessions.
• Fixed an issue where Thunderstore sorting just... didn't. M wasn't after C and it hurt.
• Selecting local mods with modifiers (Shift or Ctrl) was being wonky with favorited mods.
• Fixed detection for launch buttons and running from external sources.
• Thunderstore Mods page now scales and resizes like a civilized window. (More to come)
• Forms now remember their size and position, which I don't think anyone asked for, but oh well.

Version 1.4.3

• HOPEFULLY FINALLY FIXED the automatic updater! (The solution is incredibly scuffed)
• Fixed manually introduced mods being removed when loading a profile (sorry 'bout that, they didn't deserve it)
• CheckForModsUpdate() no longer takes naps.
• The update system and "Show Mod on Thunderstore" button are both function again. I believe?
• Some other small bugs were squished. I don't remember what they were, but they're dead now. Probably.

Version 1.4.2

• Automatic mod updating when first opening the manager (if toggled, of course)

• Able to run in the background (might allow for future automation capabilities, but currently this does nothing)

• Changed the close button to a red version of the in game button

• Added a minimize button (a blue button!)

• HOPEFULLY finally fixed the issue with issue #2

• Fixed the error "Failed to preload mod panels"

• When downloading a mod from an online download link, the update button for the mod now works.

• Version number doesn't reset when clicking from a known to an unknown mod.

• Stupidly threw an error when you didn't have any mods... so yeah, that's fixed!

Version 1.4.1

• Profile Bug Fix: Fixed the issue affecting mod profiles.
• Minor Fixes: A few small bug fixes and optimizations to improve overall performance.
• New Features: Addeded a couple of small features to enhance your expierence (details are a bit fuzzy, but they should be noticeable).

Version 1.4.0

• Favoriting: Mark your favorite mods to easily find them layer.
• In-App Updater: Stay up to date without leaving the manager! Update the app with just a click.
• Mod Profile Exporting & Importing: Share your mod profiles or back them up with ease.

Version 1.3.1

• Search Bar for Local Mods: Quickly find the mods you're looking for without scrolling endlessly.
• Quicker Local Mod Loading: Improved loading for local mods to be quicker by preloading them in the launch page.
• Launch Game Button: A quick button at the top to launch and stop the game from the manager.

Version 1.2.1

• Revamped Local Mods Page
• Improved Thunderstore Mods Page
• Updated Maps Page
• Refreshed Loading Screen

Version 1.1.1

• Fixed bug where UserLibs folder was mistakingly going into mods folder

• Allowed unknown mods to show author as well

• Changed version square to be blue if unknown and tooltip to say "Unreleased / Not Found"

Version 1.1.0

• Automatic Dependency Installation: Mods will now automatically check for and install any necessary dependencies

• Optimized Mod Fetching: Improved the mod fetching process to allow more mods to load in parallel, significantly reducing loading times

• Fixed issues with duplicate pinned mods.

• Corrected deprecated mods showing as unknown or incorrectly identified.

• Resolved mod matching issues for local mods and improved retry logic for custom maps.

Version 1.0.0

• Initialize release of Rumble Mod Manager!!

Features:

• Install MelonLoader
• Manage Your Mods and Maps
• Auto-Detect Your Rumble Path
• Thunderstore Integration