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.
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.
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:
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.
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 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>:
ctf_2fort
workshop/123456789
pl_badwater
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.
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.
We recommend FastDL so your players can download custom maps quickly. Our guide Setting up FastDL explains how.
Add your own sounds, materials, models, and other content to the appropriate folders under tf in the Files tab:
| Folder | Content |
|---|---|
tf/sound | Custom sounds |
tf/materials | Textures and materials |
tf/models | Models |
tf/resource | Resource files |
tf/scripts | Script files |
tf/particles | Particle 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.
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.