Weapon Swaps

This guide covers swapping weapon models — both the viewmodel (first person) and worldmodel (third person) are swapped in one operation.

For cosmetic swaps see Cosmetic Swaps.

How weapon swaps work

TF2 weapons have two separate model files:

Model type	What it is	Path in VPK
Viewmodel	What you see in first person	models/weapons/c_models/
Worldmodel	What other players see	models/weapons/w_models/

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

Basic weapon swap:

python3 tf2autoswap.py scattergun pistol --weapon

Preview without building:

python3 tf2autoswap.py scattergun pistol --weapon --dry-run

Search for weapons without building:

python3 tf2autoswap.py scattergun --list --weapon

Melee weapons typically do not have separate worldmodels — viewmodel only is expected behaviour, not an error
Only one replacement per weapon slot can be active at a time
Re-run the preloader install after any TF2 update
Changes are client-side only — other players see the original weapon