The Wermiversary Update

2.1.1 Changelog

Small patch to fix profiles not properly skipping default TF2 installation logic.

The Wermiversary Update (hotfix)

2.1.0 Changelog

Hotfix to fix some issues with the release.

New Features

• Added refresh button on addons tab
• Restore addon state from user settings
• Added particle selection numerical count to matrix
• Fixed confirmation button styling

The Wermiversary Update

2.0.0 Changelog

Hi everyone! Today (February 3rd) marks exactly one year since I first uploaded this application to GameBanana - and what a year it's been!

I'm so thankful for everyone who has supported this project, especially my fellow worm associates who help me daily with discord (Feathers) support tickets (Akuji) and code (djsigmann). We've come a long way in a short time, and to be frank, I'm still shocked Valve is letting us get away with this.

I hope we all appreciate how much this game means to so many people. I'm glad to have given back in my own small way. In many ways, this work has consumed a part of my life. I do my best to stave off burnout, but I'm extremely busy with day-to-day work as it stands. Still, the overwhelming appreciation (coincidence that we hit 100 stars on GitHub today) fuels my drive to keep at it.

So as always, more to come. With these changes landed, further UI improvements should be underway shortly, along with some requested features that had to sit on the backburner while this nearly 9k-line refactor took precedence. :)

~ cueki

Features

• Gave UI a massive face lift thanks to backend logic changes
• Added pretty logging across the entire codebase (core, gui, handlers, util, operations, quickprecache, etc). Thanks @djsigmann
• Added new setting to disable painted cosmetics
• Added/updated particles and particle map for Smissmas 2025
• Check if VPK is writable before install
• Added support for any TF2 based sourcemod (goldrush, classified, etc)

Major Refactors (UI Rework)

• Extracted install logic to core/services, merged InstallationManager into Interface
• Moved non-GUI logic out of drag_and_drop.py and addons_manager
• Moved settings_manager to core
• Added new conflicts service and setup service
• Moved download/extraction of modpack and particle logic out of GUI into services
• Moved path normalization out of GUI
• Reworked util module (added file, zip submodules)
• Reworked auto-update mechanism
• Removed dead code from gui/
• Removed duplicate library constants

Bug Fixes

• Fix mods.zip unzip path being incorrect
• Fix ensuring pip can be installed into a venv
• Fix drag_and_drop.py passing strings instead of Path objects
• Fix pip install progress showing warnings
• Fix embeddable Python site-packages path
• Fix studiomdl exception only thrown when actually needed
• Fix non-zero return values being masked in Linux run script
• Fix getting real path of Linux run script

CI / Build

• Added Dependabot for dependency management
• Added release workflow

casual pre-loader

v1.7.2

What's new:

• Fix newly broken link to my modpack.
• More janitorial work for Linux.

casual pre-loader

v1.7.1

What's new:

• Added support for Gold Rush mod in options menu.
• Various file cleanups.
• Linux is now easier to use. (not part of release)
• Linux updater is now less cringe.
• Linux now has its own run.sh for installing/running.

casual pre-loader

v1.7.0

What's new:

• Fixed bug with quickprecache caching cosmetics.
• Documentation overhaul.
• Icons updated to support light/dark mode.
• Hud files generated by the preloader will now be separate in custom.
• Options added to disable console on startup.
• Config now dynamically generated based on detected files.
• Hopefully fixed skeleton hotel fire and jump effects. (re-download mods.zip in app)
• Added fallback support for failed installs.
• Added ability for users to cancel during installs.

casual pre-loader

v1.6.6

What's new:

• Fixed bug with dereferenced elements (4294967295).
• Fixed bug with de-duplication using incorrect index.
• Fixed bug with missing unknown header.
• PCF Processing optimizations.
• Installation performance optimizations.
• Better loading bar updates.
• valve-parser library optimizations.
• huds now install separately.

casual pre-loader

v1.6.2

What's new:

• Fix for sound mods having mixed slashes in sound scripts not being picked up by regex.

casual pre-loader

v1.6.1

Minor bugfixes

What's new:

• Fix for some bugged Valve particle systems not being properly structured.
• Fix for r_rootlod in quickprecache not being written.
• Fix for item_fx.pcf being named item_fx.pcf.pcf.
• Fix for json decode errors in main installation thread.

casual pre-loader

v1.6.0

HAPPY HALLOWEEN :DDD

What's new:

• Added missing weapon unusual particle files and Halloween 2025 unusuals.
• Added Simple/Advanced particle mode, simple mode shows 10 particle groups instead of 100+ files.
• Added particle file splitting for item_fx.pcf (now split into unusuals and gameplay for mix-and-match).
• Added "Export as VPK" button to export addons as VPK files.
• Added dedicated Load Order panel for managing addon installation order with drag-and-drop.
• Added "Edit mod.json" button in Details panel for editing addon metadata.
• Added mods.zip download functionality directly.
• Fixed major bug in particle_system_map.json where parent effects were improperly marked.
• Fixed major bug with improper byte termination in some PCF files.
• Fixed ZIP files with mod folders at root level not being named.
• Fixed ZIP files not properly importing mod.json
• Prevented sound.cache files from being included in VPK during installation.
• Moved "Refresh Addons" and "Open Addons Folder" to Options dropdown.
• Moved "delete addons" to a right-click menu.
• Category headers now hidden when no addons match that category.
• UI is no longer QSplitter based and uses QHBoxLayout.