Steam Group Facebook Twitter Google+ Announcements

This is the tutorial for how to install mods from distributed in ".vpk" format. This tutorial will guide you step by step through the process of installing mods downloaded from the site on OS X.

If you are running Windows, you can find the related tutorial here. Alternatively, if you are running Ubuntu, you may find the related tutorial here instead.

Should any mod require additional information to be installed, you will find a “Read Me” with the necessary information included in the “.zip” file.

Also note that while this tutorial is designed for, it can be used as a general reference for installing all Team Fortress 2 mods that are distributed in “.vpk” format.

Video Tutorial
Written Tutorial Overview

There are no special tools required for this tutorial. The only skills required are a basic understanding of browsing and navigating through OS X files and folders. This tutorial will assume you are using a standard two button mouse.

This guide will make use of the following mods as examples:

You can find their respective downloads by following the attached links. While it is not required to download and install these exact mods, it would greatly aid in the learning process if you were to follow along using the exact same mods.

Should you use an alternative program to extract compressed files other than the system default, you are responsible for resolving the differences you may encounter.

This tutorial will assume the “.zip” files were not automatically uncompressed after being downloaded. Safari by default will automatically unzip compressed files after downloading. If you wish to modify this behavior, start by opening Safari and going to “Safari” on the menu bar. Select “Preferences...” from the drop down menu. From the “General” tab, at the bottom of the window you will see a checkbox labeled, “Open ‘safe’ files after downloading.” Simply disable this setting to prevent Safari from unzipping files automatically.

Basic Installation

1. Open up the folder containing the downloaded mod files. You may do so by opening up a new Finder window and navigating to the location which they were downloaded to.

2. Open up a new Finder window to navigate to your “custom” folder. Arrange the open windows so they are in a position where you can easily see the contents of both. It is assumed that Steam and Team Fortress 2 have been installed to the default file locations.

3. You now need to access your user “Library” folder. There are two methods we will be looking at.

First method:

On the menu bar, select “Go”. Here you can select various quick links to different parts of your system including your “Library” folder. However, if you are running OS X version 10.7 or newer, your user “Library” folder is hidden by default. To unhide the folder and make it visible for selection, press and hold down the “Option” key. While holding the key, select “Library” from the list.

Second method:

On the menu bar, select “Go”. Then select “Go to Folder…” near the bottom of the list. In the box that pops up, type “~/Library” into the field. Upon clicking “Go”, Finder will open to your user “Library” folder.

4. Once you’ve accessed your user “Library” folder by whichever method you chose, your “custom” folder can be found by following:
"Library/Application Support/Steam/SteamApps/common/Team Fortress 2/tf/custom"

If you did not install Steam or TF2 to its default location, you are required to find the "custom" folder location yourself. The "custom" folder is where all your mod related files will be hosted.

5. In the window open to the downloaded mods, extract the “.zip” file of the Spike’s Spade mod by double clicking on it. Upon extraction, you will see the mod’s “.vpk” file. For those not familiar, a “.vpk” file is package of multiple files to allow for easy storage, distribution and installation of mods and other add on content for Valve games. Whenever this tutorial references “.vpk” files, these are the files it is referring to.

6. Click on the “.vpk” file then proceed to drag the file over to the other window currently opened to your “custom” folder. Release the mouse button once the cursor is hovering over the new window. Now that the “.vpk file resides in your “custom” folder, it is now considered installed.

Thus concludes the basic method to installing all mods available from

Extended Learning

While the five steps outlined above demonstrate the basic process used to install all mods from the site, some mods require more than one file to be moved over in order to work properly due to the addition of choices.

1. From the window open to your downloaded mods, extract the “.zip” file of the Team Coloured Wonderbolt Wind Guards by double clicking on it. Upon doing so, it will generate a new folder with a title matching that of the zipped one. Upon entering, you will see a list of folders with names matching that of various hats and misc. items as well as a Read Me text file. This Read Me text file contains basic installation instructions pertaining to this particular mod.

2. With this mod, you have the option of choosing which items you want the Team Coloured Wonderbolt Wind Guards to replace. You may select as few or as many replacement options as you desire. Just enter into the folder with the matching name of the item you wish to be replaced and move over the “.vpk” file like you had with the previous Spike’s Spade mod. In the case of this mod, if you choose to replace an all class item like the Summer Shades, they will only be replaced on the Scout.

3. In the window currently open to the Team Coloured Wonderbolt Wind Guards, return back to the folder with the other mod files. You may delete the folder generated by the Wonderbolt Wind Guards mod at this point if desired.

4. Double click on the “.zip” file for the Pony Books mod to extract it. Upon opening, you will see three numerically numbered folders in addition to a Read Me text file with basic installation instructions pertaining to this particular mod.

5. After opening the first folder titled “Book Materials,” you will be present with two different options to choose from. Select which style you want by opening the folder with the name matching style you desire and move the “.vpk” file to your “custom” folder like you have with previous mod files.

6. Return to the root folder of the mod’s “.zip” file and repeat the same process for the folder titled “Book Models” as you did for the “Book Materials” folder. Select the desired style and move over the contained “.vpk” file.

7. As noted in brackets, while not required, a new paper trail is an available option that can be installed following the same steps as previous mods.

That concludes the examples of situations you may encounter when installing mods from

Additional Information

All mods downloaded from the site are client side and legal for use. This means only you can see the mods when playing and you cannot be VAC banned for possessing them.

When you install new mods, test them to make sure they are working properly. Mods are guaranteed to always work on servers running “sv_pure 0”. To check if the server is running “sv_pure 0”, you can open up the console (required to be enabled under “Advanced Keyboard Settings”), and enter the command “sv_pure” to which it will state the value for that server. By default, when you launch a map from the console or start offline practice, “sv_pure” will be set to 0 making them the best options to test new mods.

When first installing mods, install and test them in small batches of ten to fifteen at a time. By doing so, you can see how each group of mods affects your computer’s performance and easily identify which mods might be causing you issues.

With regards to VPK files, they are scanned by the game in alphabetical order. Meaning, if you have happened to have already installed a previous skin or model replacement for an item, it is often required to uninstall the previous mod instead of relying on the new mod to take priority over the previous files. Additionally, since not all mods for a particular item will contain the same files, adverse effects could occur should you not remove the old “.vpk” files first. For information on how to uninstall mods, you can view the related tutorial.

If you intend to be downloading new mods frequently, it would be a useful idea to add your “custom” folder to your Favourites in the sidebar of Finder for quicker access in the future. From your “custom” folder, select “File” from the menu bar then click “Add to Sidebar”. Now you can easily navigate to your “custom” folder from anywhere within Finder.

For additional help with installing mods, visit the support section of the site.