Skip to content

About

Graphical mod downloader for RImworld base and DLC's by using SteamCMD and API's

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

RimWorld Mod Downloader

Downloads and installs Steam Workshop mods for RimWorld copies that are not tied to Steam (GOG, DRM-free, and so on). It drives SteamCMD in anonymous mode, so no Steam account is involved.

Screenshot

What it does

  • Built-in Workshop browser: text search, sorting by trending / subscribers / most recent, a game-version filter and pagination.
  • Resolves dependencies on its own. It reads the Required items panel of each mod page and, once a mod is downloaded, also checks its About.xml, because some authors only declare dependencies there.
  • Installs into <RimWorld>/Mods and enables the mods in ModsConfig.xml, keeping your DLCs and leaving Harmony at the top of the load order.
  • Finds your installation and its version by itself (scans the drives for RimWorldWin64.exe and prefers the newest install it finds).
  • Lists installed mods so you can enable, disable or uninstall them.
  • English or Spanish interface. Workshop descriptions are translated on the fly and cached.

Usage

Grab the .exe from Releases and run it. No installation needed.

The first time you download something, the app fetches SteamCMD on its own (about 40 MB) and keeps it in %LOCALAPPDATA%\RimWorldModDownloader.

If your game is not detected, point the app at the folder containing RimWorldWin64.exe from the Settings tab.

Running from source

pip install -r requirements.txt
python src/main.py

To build the executable:

powershell -File scripts/build_exe.ps1

Needs Python 3.10 or newer. Run the tests with python -m pytest tests.

How it works

Steam has no keyless Workshop search API, and the new browse page uses obfuscated CSS class names that change on every deploy. So the search only scrapes item IDs from that page (the filedetails/?id=N link pattern is stable) and everything shown comes from GetPublishedFileDetails, which is public and needs no key.

Dependencies are a separate problem: that endpoint returns an empty children field, so they have to be read from the Required items panel on the mod page, which still uses the classic HTML layout.

One detail worth knowing if you edit ModsConfig.xml yourself: RimWorld stores package IDs lower-cased and compares them case-insensitively. Writing them in the casing used by About.xml makes the game append a second entry later, and a mod listed twice will throw Harmony patching errors. This tool always writes them lower-cased.

Note

Mods are downloaded from the Workshop exactly as their authors publish them. If a mod is useful to you, drop by its page and give it a thumbs up.

License

MIT. See LICENSE.

About

Graphical mod downloader for RImworld base and DLC's by using SteamCMD and API's

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages