Client-side · Preloader-ready · Open source

TF2autoswap

A Python tool that swaps TF2 cosmetic and weapon models client-side, no game files modified.

Requires Python 3.8+ · Dependencies install automatically

Download Read the wiki

Select an Operation

Cosmetic Swap ↗

Replace any cosmetic model client-side. Preloader or native addon output.

Weapon Swap

c_ and w_ model support. Animation risk warnings included.

War Paint Swap

Planned — in development.

Map Props Swap

Planned — in development.

TF2autoswap started as a single Python script written to replace A Head Full of Hot Air with the Bubble Pipe. It worked — and that was enough to turn it into something bigger.

About the project

What it is

A Python CLI tool for swapping TF2 cosmetic and weapon models client-side. Outputs preloader-ready VPKs or native addon folders compatible with the Casual Preloader.

Who builds it

Sky (Melancholy Sky)

Design, direction, and maintenance. Every decision is documented in the credits wiki page.

Special thanks

cukei (Casual Preloader) · Revan/cooolbros (vscode-vdf, first Windows tester) · :Akuji: (early notice) · Eevah (mods.tf interest) · mileyDna

Coding assistance: Claude (Anthropic). All direction and decisions are Sky's. Full policy →

Get in touch

Contact

Bug reports

GitHub Issues — include your log file

Discussions

Questions, ideas, feedback

Discord

@melancholysky

Pending deployment

Sponsor

GitHub Sponsors

Pending approval