-
Notifications
You must be signed in to change notification settings - Fork 0
Home
Melancholy Sky edited this page Jun 10, 2026
·
5 revisions
Welcome to the TF2autoswap wiki. This is the central reference for everything about the tool.
Current version: 4.7
| Page | What it covers |
|---|---|
| Installation & Setup | Requirements, downloading, first run |
| Usage Guide | Interactive menu and command line reference |
| Cosmetic Swaps | Step by step cosmetic swap guide |
| Weapon Swaps | Step by step weapon swap guide |
| Output Formats | VPK vs addon folder, where files go |
| Roadmap | Planned features and upcoming versions |
| Version History | Summary of all releases |
| Troubleshooting | Common issues and fixes |
| Credits | People and projects that helped |
| AI Assistance | My policy in regards to Ai usage within the project |
TF2autoswap is a Python tool for swapping Team Fortress 2 cosmetic and weapon models client-side.
- You choose two items — one to replace, and one to use as the replacement
- The tool swaps the model files and builds an output file
- Only you see the change — other players see the original item
- No game files are permanently changed
Output files work with the Casual Preloader by cukei.
- Download the latest release from the releases page
- Extract the zip
- Run
python3 tf2autoswap.py
See Installation & Setup for full details.