Skip to content

Team Fortress 2: Install Mods

Learn how to use Workshop maps, custom maps, and custom content on your Team Fortress 2 server → Find out more

19 November 20263 min read3 Views0 helpful

Don't have your own server yet? Host your Team Fortress 2 server with ZAP-Hosting.

Introduction

Custom maps, Workshop maps, and other custom content give your Team Fortress 2 game server a personal touch. This guide explains how to play Steam Workshop maps on your server, upload your own .bsp maps, and provide additional content such as sounds, materials, or models.

Preparation

For Workshop maps, you only need the Workshop ID of the map you want. You can find it in the Steam Workshop for Team Fortress 2 in the address bar on the map's page: it's the number after .../?id=.

To add your own maps and custom content, access your server's files. You can do this directly in the Files tab of your game server or via SFTP using a program such as FileZilla or WinSCP. Our guide Access via SFTP shows you how to connect via SFTP.

Using Workshop maps

Team Fortress 2 downloads Workshop maps automatically when they are selected. You don't need to upload the map files yourself. Use the format workshop/<ID> to select a Workshop map; the server automatically adds the full map name.

To switch directly to a Workshop map, open the Console tab and enter the following command:

Code
changelevel workshop/123456789

Replace 123456789 with your map's ID. The map is downloaded or updated when you switch to it. The first switch may take a little longer for large maps.

Tip

Use the command tf_workshop_map_sync <ID> to download a Workshop map in the background ahead of time, making the later map change faster.

Workshop maps in the map rotation

Workshop maps also work in the map rotation. To add them, open the tf/cfg folder in the Files tab and add the maps to the mapcycle.txt file, one map per line. Enter regular maps without a file extension and Workshop maps in the format workshop/<ID>:

Code
ctf_2fort
workshop/123456789
pl_badwater

Uploading your own maps

If you have a map as a .bsp file, upload it to the tf/maps folder in the Files tab. Then restart your server: when it starts, the server automatically makes all maps in this folder available alongside the default maps.

Important

If your map has the same file name as a default game map, it will be skipped and the default map will remain active. Always give your custom maps unique names.

After restarting, use changelevel <kartenname> in the Console to switch to the map, for example, changelevel ctf_meinekarte. To have the server start directly with your map, enter its name in the Start map field under Startup parameters in the Configuration tab. Use the maps command with part of a map name, for example, maps ctf_, to check which maps the server recognizes.

Info

We recommend FastDL so your players can download custom maps quickly. Our guide Setting up FastDL explains how.

Adding custom content

Add your own sounds, materials, models, and other content to the appropriate folders under tf in the Files tab:

FolderContent
tf/soundCustom sounds
tf/materialsTextures and materials
tf/modelsModels
tf/resourceResource files
tf/scriptsScript files
tf/particlesParticle effects

Each time the server starts, it links the files in these folders to the game directory. The same rule applies here: files with the same name as a game file are skipped, and the original file is kept.

There is also the tf/custom folder. You can put custom content packages in their own subfolders here, for example, tf/custom/mybundle/ with the subfolders maps, materials, models, or sound.

Tip

If a SourceMod plugin uses custom sounds or models, place them directly in the folders listed in the table above. Our guide Installing plugins explains how to install SourceMod and plugins.

Conclusion

You now know how to use Workshop maps, your own maps, and custom content on your Team Fortress 2 game server. If you have any questions or need help, our support team is available every day! 🙂

FAQ

Frequently asked questions

In the Console tab, enter changelevel workshop/<ID>, replacing <ID> with the map's Workshop ID from the address bar on its Workshop page. The server downloads the map when you switch to it.
Add them to mapcycle.txt in the tf/cfg folder, one map per line. Use workshop/<ID> for Workshop maps.
Upload them to the tf/maps folder in the Files tab. The server makes them available after a restart. Maps with the same name as a default map are skipped.

Feedback

Was this article helpful?

Your feedback helps us prioritize and improve content.

0 of 0 people found this article helpful.

Personal support

Need more help than the guide provides?

Our ZAP support team knows your product — briefly describe your issue and we'll help you personally.

Zappy knows this guide and answers you right in the chat.