-
Notifications
You must be signed in to change notification settings - Fork 0
Home
Melancholy Sky edited this page Jun 15, 2026
·
7 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 |
| Development Process | How the project is developed and released |
| Credits | People and projects that helped |
| AI Assistance | AI usage policy and role within the project |
TF2autoswap is a guided Python pipeline for client-side TF2 cosmetic and weapon model swapping.
- 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.