A guided Python pipeline for client-side TF2 cosmetic and weapon model swapping. Handles asset lookup, safety checks, and VPK or native addon output automatically. Free to use — requires Python 3.8+.
Changes are visible only to you. No game files are permanently modified. TF2 AutoSwap is a fan-made project and is not affiliated with Valve or Team Fortress 2.
- Swap any cosmetic or weapon model for another
- Outputs a file ready for use with the Casual Preloader by cukei
- Guided step-by-step menu, or run from the command line
- Warns you before any swap that may cause visual clipping or animation issues
- Python 3.8 or later
- Dependencies install automatically on first run
Download the latest release, extract the folder, then run:
python3 tf2autoswap.py
Full documentation is included with each release.
All releases follow a structured pipeline:
Research & evaluation → Scope check & feasibility → Implementation → Local testing → Robust evaluation → Release
See the Development Process wiki page for full details.
GNU GENERAL PUBLIC LICENSE — Free to use and modify with credit.
- Tool by Sky (TF2Autoswap) with coding assistance from Claude (Anthropic)
- Casual Preloader by cukei — gamebanana.com/tools/19049