Cosmetic Swaps

Cosmetic Swaps

This guide covers swapping cosmetic items — hats, miscs, and other wearable items.

For weapon swaps see Weapon Swaps.

---

Step by step — interactive mode

Select option 1 from the main menu.

Step 1 — Class

Choose which class the item belongs to, or select "all (no filter)" to search all classes.

Step 2 — Item to replace

Search for the cosmetic you want to replace. This is the slot that will show the new model.

The search is flexible — try the item's name, part of its name, or its internal keyword.

Step 3 — Replacement source

Choose where the replacement model comes from:

Option	When to use
TF2's built-in cosmetics	Swapping one TF2 item for another
Import a model from disk	Using a custom model downloaded from Gamebanana or elsewhere

You can still proceed past any warning. The choice is yours.

---

Command line examples

Basic swap — replace one cosmetic with another:

python3 tf2autoswap.py hollowhead hot_air

With class filter for all-class items:

python3 tf2autoswap.py cozy_camper cozy_camper --filter pyro

Import a custom model from disk:

python3 tf2autoswap.py --import ~/Downloads/mymod/models/player/items/pyro/myhat.mdl hot_air

Preview without building:

python3 tf2autoswap.py hollowhead hot_air --dry-run

---

Notes

• Only one replacement per cosmetic slot can be active at a time
• Re-run the preloader install step after any TF2 update
• Changes are client-side only — other players see the original item