TF2autoswap — client-side TF2 model swapping tool
A Python tool that swaps TF2 cosmetic and weapon models client-side. Nothing in your game files is touched.
Requires Python 3.8+ · Dependencies install automatically
Built to work with the Casual Preloader by cukei
- Run this tool while TF2 is closed.
- Client-side mods may violate competitive league rules (RGL, ETF2L & others) — check your league's policy before use.
- VAC bans for client-side mods are rare but possible. Use at your own risk.
Developer info
Developed by Sky
A mostly solo passion project — designed, directed & maintained by Sky, with coding support from Claude. Each release is documented in the changelog.
Origin story
The project started as a fix for a visual bug dating back to 2015 — unusual effects rendering incorrectly on A Head Full of Hot Air. Despite reporting it with no fix ever released, I took matters into my own hands. With Claude's assistance I built a script to replace the cosmetic with the Bubble Pipe, which fixed the effect rendering and inadvertently solved clipping issues with chest-slot cosmetics too. That one script was enough to turn it into something bigger.
Special thanks
- cukei — Casual Preloader
- Revan/cooolbros — vscode-vdf, first Windows tester
- :Akuji: — early notice
- Eevah — mods.tf interest
- OpenDyslexic by Abbie Gonzalez — accessibility font, bundled with thanks
Coding assistance: Claude (Anthropic). All direction and decisions are Sky's. Full policy →
This site is powered by Netlify (open source plan).
Contact
Bug reports
GitHub Issues — include your log file
Discussions
Questions, ideas, feedback
Discord
@melancholysky
Pending deploymentSponsor
GitHub Sponsors
Pending approval