Skip to content

Version History

Melancholy Sky edited this page Jun 8, 2026 · 1 revision

Version History

A summary of all releases. Full release notes are on the releases page.


v4.6 — Current release

Bug fixes and quality of life improvements.

  • World model detection fixed — weapons now pack both viewmodel and worldmodel correctly
  • All-class cosmetic class filtering fixed — correct class variants shown per class search
  • Duplicate weapon search results removed
  • Weapon search clutter filtered — animation rigs, arm models, skin variants removed from results by default
  • Path validation on custom output paths
  • Subfolder mod scanning in the mod manager
  • Keyword normalisation — apostrophes and punctuation stripped before searching
  • Friendly name reverse search — search by item name, not just internal keyword
  • Auto-select when only one result is found
  • Menu selection confirmation line added
  • Smarter "did you mean" suggestions
  • Melee world model note — clarifies viewmodel-only is expected for melee weapons

v4.5 [Legacy]

  • Broadened equip region mismatch warnings for cosmetics
  • Preloader write warning — requires typing yes before writing to the preloader folder
  • Output folder and log file moved to be self-contained within the tool folder

v4.4 [Legacy]

  • Weapon swaps — swaps both viewmodel and worldmodel in one operation
  • Slot mismatch warnings for weapons
  • --weapon CLI flag
  • Interactive menu expanded to 4 options

v4.3 [Legacy]

  • Preloader native addon folder output format
  • Dry run preview — --dry-run flag and interactive preview at confirm step
  • --list-installed shows native addon folders and loose VPKs

v4.2 [Legacy]

  • TF2autoswap rename
  • Top-level interactive menu
  • List and remove built mods
  • Direct output to preloader folder — --to-preloader flag
  • --version flag

v4.0-beta [Legacy]

  • Core/interface architecture split — tf2_core.py separated from interface
  • Error logging to tf2autoswap.log
  • Typed exceptions for error handling

v3 [Legacy]

  • Schema parsing via tf2_schema.py
  • Friendly item names from items_game.txt
  • Head-clip warnings

v2 [Legacy]

  • Interactive guided mode
  • Import custom models from disk with automatic materials bundling
  • "Did you mean" typo suggestions
  • Cross-platform TF2 path detection
  • Auto-install of vpk library

v1 [Legacy]

  • Initial release — command line only
  • Core swap engine
  • Linux only
  • The proof of concept that started everything

Clone this wiki locally