Halloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsWindows FixRecommendedWindows errors stealing your time? Find the fix fastScan stability, cleanup and performance issues.Fix NowHalloween DealsAmazon USOctober picks are moving - compare before checkoutAmazon US: current deals, useful picks and tech finds.See Picks×
FREEDOM251

Freedom251 › Blog › Game Server

How to Install MetaMod:Source and SourceMod on a Team Fortress 2 Server

By Freedom251 Team · · 8 min read

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Install MetaMod:Source before SourceMod. Stop the dedicated server, download archives that match the server’s operating system, and extract both packages into the Team Fortress 2 game directory—the folder named tf. A correct installation creates tf/addons/metamod/, tf/addons/metamod.vdf, tf/addons/sourcemod/, and tf/cfg/sourcemod/. Restart fully, then run meta version and sm version at the server console or through RCon.

MetaMod:Source is the loading layer that lets SourceMod attach to the Team Fortress 2 server. SourceMod depends on it, so installing SourceMod first or placing its files in the wrong directory will leave its commands unavailable. The procedure is the same on a self-managed machine and on a hosting panel, but the way you upload files and restart the process differs.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

What you need before changing files

Access and permissions

  • A running Team Fortress 2 dedicated server.
  • Filesystem access through a shell, FTP/SFTP, or your host’s file manager.
  • Permission to stop and start the server. A map change or an in-game reconnect is not a substitute for a process restart.
  • A way to open the server console or send RCon commands after startup.
  • A backup location for customized SourceMod configuration and plugin files.

The relevant destination is the tf directory inside the server installation. It is not necessarily the home directory shown when you first connect to a host. In a panel, browse until you can see the game’s existing cfg, maps, or materials folders; that is normally the directory into which the archives must be extracted.

Choose files for the server, not your administration computer

MetaMod:Source and SourceMod publish packages for different operating systems. Select the package matching the operating system on which the dedicated server process runs. A Windows administrator connecting to a Linux server still needs the Linux archive; the operating system of the computer used for FTP or RCon is irrelevant.

#1 Best Overall
Sale
Razer BlackShark V3 X HyperSpeed Wireless PC Gaming Headset, Black | 50mm Drivers, Cardioid Mic, 2.4 GHz, Bluetooth, USB, Works with Mac, PS5, Nintendo Switch, Smartphone, 70 Hr Battery
  • TRIFORCE 50MM DRIVERS GEN-2 — Tuned for improved clarity and positional performance, the Gen-2 drivers not only deliver more powerful audio, but have an improved soundstage to clearly hear every footstep and audio cue
  • DETACHABLE HYPERCLEAR CARDIOID 9.9MM MIC — The mic’s unidirectional pickup pattern ensures more voice and less noise, while its detachable design allows for easy removal when not in use
  • HYPERSPEED WIRELESS — Featuring an ultra-fast 2.4 GHz wireless connection, enjoy high-performance, low-latency competitive play with sound that’s perfectly synced to the game
  • 3 MODES OF CONNECTIVITY — Gain the competitive edge when gaming on PC, console or mobile; seamlessly switch between 2.4 GHz and Bluetooth with SmartSwitch Dual Wireless or stay plugged in for non-stop gaming via USB
  • 7.1 SURROUND SOUND — With our advanced 7.1 surround sound, enjoy true-to-life acoustics that optimizes the game’s sound design to hear everything like being right in the middle of it all
Dedicated-server operating system Package to select Common mistake
Windows Windows build Uploading a Linux archive because the administrator uses Linux tools, or because the download was made from a Linux workstation
Linux Linux build Uploading a Windows archive and expecting Linux to load its binaries

Stable or development build

Use the current stable build unless you have a specific compatibility reason to test a development build. SourceMod uses rolling releases, so “latest” is a moving target rather than a permanently numbered major release. Record the version you install, and read the release notes when the TF2 engine has recently updated.

Expected directory layout

After both packages are merged into the game directory, the important paths should look like this:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
tf/
├── addons/
│   ├── metamod/
│   ├── metamod.vdf
│   └── sourcemod/
└── cfg/
    └── sourcemod/

The exact contents vary by release. What must not happen is an extra archive-name directory between tf and the folders above. For example, tf/SourceMod-.../addons/sourcemod/ is usually wrong. The files need to be merged so that addons and cfg are direct children of tf.

Install MetaMod:Source first

  1. Stop the server. Use the panel’s Stop control or stop the dedicated-server process from the shell. Editing binaries while the process is running can leave an incomplete or inconsistent installation.
  2. Download the MetaMod:Source package for the server OS. Use the project’s official download location and choose the archive intended for a Team Fortress 2 dedicated server.
  3. Open the real TF2 game directory. Locate the directory named tf beneath the server installation, rather than a generic account or game-root folder.
  4. Extract the archive into tf. The extraction should create or merge tf/addons/metamod/. If your archive utility shows a top-level folder, inspect it before extracting; do not create a second tf directory accidentally.
  5. Check the VDF file. Recent MetaMod:Source packages, including the 1.10.0-and-later line, normally include metamod.vdf for standard games. It belongs directly at tf/addons/metamod.vdf, not inside tf/addons/metamod/.
  6. Correct the VDF when necessary. If no VDF was included, or the file targets a different game, obtain or generate a Team Fortress 2-specific VDF and put that file directly in tf/addons/. A VDF for another Source game will not reliably load MetaMod in TF2.
  7. Start or restart the server. A complete process restart is required before testing. Wait for the normal startup sequence to finish.

The VDF is the entry point that tells the game to load MetaMod. The metamod directory contains MetaMod’s files, but those files can remain unused if the entry-point file is absent, misplaced, or aimed at another game.

Rank #2
Sale
Logitech G432 Wired Gaming Headset - Black | DTS Headphone:X 2.0, 50 mm audio drivers, USB and 3.5 mm jack, Flip-to-Mute mic, PC compatible
  • Enjoy expansive cinematic sound. Big 50 mm audio drivers deliver an incredible sound experience
  • Hear Enemies From All Sides. DTS Headphone:X 2.0 surround sound(1) lets you hear enemies sneaking behind you, special ability cues, and immersive environments. It’s positional clarity that can make the difference between victory and defeat. Experience three-dimensional audio that goes beyond 7.1 channels to make you feel like you’re right in the middle of the action. (1) DTS Headphone:X 2.0 requires Logitech G HUB Software.
  • Be Heard Loud and Clear. The big 6 mm boom mic makes sure you’re heard by gaming partners and mutes when flipped up.
  • Use One Headset For Most Game Platforms. Your headphones work with your PC or Mac via USB DAC or 3.5 mm cable, mobile devices with 3.5 mm cable or with gaming consoles including PlayStationⓇ 5 and PlayStationⓇ 4 (USB wireless stereo sound only), Nintendo Switch (wireless stereo sound when docked)
  • Game for Hours in Comfort. Everything about these headphones is about comfort: The deluxe lightweight leatherette ear cups and headband are made to keep pressure off your ears. Ear cups rotate up to 90 degrees for convenience.

Install SourceMod into the same game directory

  1. Stop the server again. Do not overwrite SourceMod files while the server is running.
  2. Download the current stable SourceMod build for the dedicated server’s operating system. SourceMod’s release stream is continuous, so use the latest stable package shown on its official downloads page unless a plugin or host specifically requires another version.
  3. Extract the package into the same tf directory. Merge both the addons and cfg trees with the directories already created by MetaMod.
  4. Confirm the two SourceMod destinations. You should be able to browse to tf/addons/sourcemod/ and tf/cfg/sourcemod/. If you see these under an archive-name folder, move the contents up so they are directly under tf.
  5. Check the dependency version. SourceMod requires MetaMod:Source 1.9.0 or higher; using the latest compatible version is recommended. An old MetaMod installation can therefore prevent a current SourceMod build from loading even when the folders look correct.
  6. Start the server with a full restart. Allow the process to load MetaMod before testing SourceMod commands.

“SourceMod requires Metamod:Source 1.9.0 or higher (it is recommended that the latest version is used).”

AlliedModders, Installing SourceMod

Verify that both components loaded

Use the server console, or send the commands through RCon after startup. Run them separately so you can identify which layer failed.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Command What it tests Successful result
meta version MetaMod:Source itself Version and build information is printed
sm version SourceMod’s command layer SourceMod version information is printed
sm plugins list SourceMod plugin loading A list of currently loaded plugins and their status is displayed

Run meta version first. If it is unknown, SourceMod cannot load yet; fix MetaMod before investigating SourceMod. If MetaMod responds but sm version is unknown, concentrate on SourceMod’s directory placement, its dependency version, and the restart. Once both version commands work, sm plugins list shows whether the standard SourceMod plugins loaded and whether an individual plugin reports an error.

Troubleshoot an installation that does not load

Both commands are unknown

  • Verify that the files were extracted into the server’s tf directory, not a parent installation directory or a client-side TF2 folder.
  • Check for unwanted nesting such as tf/MetaMod-.../addons/metamod/ or tf/SourceMod-.../addons/sourcemod/.
  • Confirm that the archive matches the dedicated server’s operating system.
  • Ensure the server process was stopped and started, rather than merely changing the map.

meta version is unknown

Inspect tf/addons/metamod/ and tf/addons/metamod.vdf first. The VDF must be directly in addons, and it must be for TF2. If the directory exists but MetaMod still does not load, replace a mismatched package with the build for the server OS and restart again.

Rank #3
Sale
SteelSeries Arctis Nova 5 Wireless Multi-System Gaming Headset - Black | Neodymium Magnetic Drivers — 60 HR Battery — 2.4GHz or BT — ClearCast Gen2.X Mic — PC, PS5, PS4, Switch, Mobile
  • 100+ GAME AUDIO PRESETS — Unlock tailored audio presets for top games like GTA V, FIFA, Call of Duty, and more, with the Arctis Nova 5 Companion App
  • 60-HOUR BATTERY — Play longer than ever with the next-gen battery. Go 8 hours a day all week; plus with USB-C Fast Charge get 6 hours of use in just 15 minutes
  • QUICK-SWITCH WIRELESS — Toggle between 2.4GHz gaming and Bluetooth 5.3 with a tap of a button to take a call or listen to media; notification beeps keep you posted on incoming calls while gaming
  • NEODYMIUM MAGNETIC DRIVERS — These drivers create an ultra-detailed soundscape of crystal clear highs, pinpoint mids, and deep bass for your space journey
  • NEXT-GEN MIC — Our upgraded, fully retractable ClearCast 2.X microphone has 2X the clarity with a high-bandwidth chipset supporting 32KHz/16Bit audio

meta version works but sm version is unknown

SourceMod is either not under tf/addons/sourcemod/, was extracted into a nested directory, or is incompatible with the installed MetaMod version. Confirm that MetaMod is at least 1.9.0, then reinstall the current stable SourceMod archive and perform a complete restart.

Linux reports a MetaMod failure

Inspect metamod-fatal.log in MetaMod’s bin directory. The log can reveal a binary or required-version problem that is not obvious from the console. Compare the installed build with the project’s required-version guidance and make sure the Linux package, rather than the Windows package, was uploaded.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The commands work, but a plugin is missing

Use sm plugins list to identify the plugin’s status. A working MetaMod and SourceMod installation does not guarantee that every third-party plugin is compatible with the current TF2 engine or with your SourceMod build. Read that plugin’s own documentation, check its required files, and place any VDF plugin file in the documented addons/metamod location.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Update MetaMod and SourceMod safely

Back up before replacing files

Copy the complete tf/addons and tf/cfg/sourcemod trees, especially customized configuration files and any locally installed plugins. Keep the backup outside the live server directory so a cleanup or archive extraction cannot overwrite it.

Rank #4
Sale
Ozeino Wireless Gaming Headset for PS5, PC, Switch| Lossless Audio-40H Batt | Play & Charge, 2.4GHz USB & Type-C, Flip Mic, Works with PS4, Mac, laptop, mobile, Ideal for FPS, RPG
  • 【Amazing Stable Connection-Quick Access to Games】Real-time gaming audio with our 2.4GHz USB & Type-C ultra-low latency wireless connection. With less than 30ms delay, you can enjoy smoother operation and stay ahead of the competition, so you can enjoy an immersive lag-free wireless gaming experience.
  • 【Game Communication-Better Bass and Accuracy】The 50mm driver plus 2.4G lossless wireless transports you to the gaming world, letting you hear every critical step, reload, or vocal in Fortnite, Call of Duty, The Legend of Zelda and RPG, so you will never miss a step or shot during game playing. You will completely in awe with the range, precision, and audio quality your ears were experiencing.
  • 【Flexible and Convenient Design-Effortless in Game】Ideal intuitive button layout on the headphones for user. Multi-functional button controls let you instantly crank or lower volume and mute, quickly answer phone calls, cut songs, turn on lights, etc. Ease of use and customization, are all done with passion and priority for the user.
  • 【Less plug, More Play-Dual Input From 2.4GHz & Bluetooth】 Wireless gaming headset adopts high performance dual mode design. With a 2.4GHz USB dongle, which is super sturdy, lag<30ms, perfectly made for gamers. Bluetooth mode only work for phone, laptop and switch. And 3.5mm wired mode (Only support music and call).
  • 【Wide Compatibility with Gaming Devices】Setup the perfect entertainment system by plugging in 2.4G USB. The convenience of dual USB work seamlessly with your PS5,PS4, PC, Mac, Laptop, Switch and saves you from swapping cables.

Preserve configuration changes

When updating SourceMod, do not blindly replace customized files under its configuration directories. Compare new defaults with your saved versions and reapply only the settings you intend to keep. This avoids losing administrator lists, command overrides, plugin settings, and other local changes.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Account for TF2 engine updates

SourceMod’s rolling releases and TF2 engine updates can affect binary compatibility. Read the release information for the versions you are installing, update MetaMod when required, and test the server privately before reopening it to players. If a new build causes a failure, restore the backed-up directories and the previously working packages while you investigate compatibility.

Use a controlled replacement order

  1. Stop the server and save the backup.
  2. Update MetaMod:Source first when its release is required by the SourceMod version you plan to use.
  3. Verify the MetaMod files and VDF placement.
  4. Update SourceMod and merge its addons and cfg directories.
  5. Start the server and run meta version, sm version, and sm plugins list.

Choose a deployment method that fits your access

Deployment choice What changes What stays the same
Self-hosted server You manage the operating system, archive extraction, permissions, logs, and process restarts. The destination is still the TF2 tf directory, and the verification commands are unchanged.
Managed game-server host A control panel or support system may handle file upload, startup parameters, and restarts; access to binaries and logs can be limited. You still need OS-matched archives, the same directory layout, the MetaMod dependency, and a full restart.
Shell or FTP/SFTP You manually extract locally or upload the extracted folders and preserve permissions as required by the host. metamod, metamod.vdf, sourcemod, and cfg/sourcemod must end up in the same paths.
Hosting control panel The panel may offer an archive extractor and a Restart button; some panels extract into an extra folder by default. Check the resulting paths yourself and verify from the console.

If a managed host does not provide filesystem access or a way to restart the process, ask whether MetaMod:Source and SourceMod are supported before moving the server. Without those permissions, you cannot correct a misplaced VDF, inspect the Linux fatal log, or complete the verification procedure.

Understand the loading order

At startup, TF2 reads the VDF entry in tf/addons and loads MetaMod:Source. MetaMod then provides the interface through which SourceMod starts. SourceMod reads its configuration under tf/cfg/sourcemod, discovers its installed plugins, and exposes commands such as sm version. This dependency explains why installing only SourceMod, or installing both packages but omitting the VDF, leaves the sm commands unavailable.

Final installation checklist

  • The server was stopped before files were changed.
  • The archives match the dedicated server’s operating system.
  • The files were merged into the real TF2 tf directory.
  • tf/addons/metamod/ exists.
  • tf/addons/metamod.vdf exists and targets TF2.
  • tf/addons/sourcemod/ exists.
  • tf/cfg/sourcemod/ exists.
  • MetaMod:Source is version 1.9.0 or newer for SourceMod compatibility.
  • The server was fully restarted after installation.
  • meta version, sm version, and sm plugins list return results.

Once those checks pass, MetaMod:Source and SourceMod are installed in the locations TF2 expects, and you can add individual plugins according to each plugin’s documentation.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Game ServerMetaMod:Sourceserver administrationSourceModTeam Fortress 2TF2 server

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Recommended PC Tool
Recommended PC Tool
PC Slower Than It Used to Be?Free scan - under a minute
Outdated Drivers Are Slowing You DownFree scan - exact matches

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.