Halloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsClean PCRecommendedOne scan can reveal what keeps slowing WindowsLook for cleanup and repair opportunities.Run ScanHalloween DealsAmazon USOctober picks are moving - compare before checkoutAmazon US: current deals, useful picks and tech finds.See Picks×
FREEDOM251

Freedom251 › Blog › custom game modes

How to Configure Custom Game Modes on a TF2 Server

By Freedom251 Team · · 11 min read

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

To run a custom mode on a Team Fortress 2 dedicated server, install the Metamod:Source and SourceMod frameworks, add the mode plugin and every dependency it documents, upload compatible maps and downloadable assets, then separate global, mode-specific, and map-specific settings. Finish with a full restart, console checks, and a test on the intended player count before opening the server to players.

Modes such as Versus Saxton Hale (VSH), Dodgeball, Prop Hunt, DeathRun, Trade, Jump, and MGE are community-server configurations rather than stock matchmaking options. Their reliability depends on the plugin, map pool, configuration files, and client downloads working together.

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 installing a custom mode

Use a dedicated TF2 server with writable access to its tf directory. You also need a dependable way to stop and start the server, because framework and plugin changes normally require a full restart rather than a map change. Make a backup of the current tf directory and configuration files before changing a production instance.

  • File access: You must be able to upload files and create directories under the server’s TF2 mod folder.
  • Restart control: Keep a console, service manager, or hosting-panel restart method available so you can load newly installed extensions cleanly.
  • A known map pool: Have the exact map names and any mode-specific maps ready before editing rotation files.
  • Dependency documentation: Read the selected plugin’s requirements for versions, companion plugins, configuration files, translations, bosses, weapons, models, and sounds.
  • A test plan: Reserve time to test with the number of players the mode expects; a mode that loads with one administrator is not necessarily ready for a full round.

Managed hosting can be convenient for this workflow only when it exposes persistent storage, restarts, map uploads, and writable configuration paths. If a host hides those controls, you will not be able to complete or maintain many custom modes.

#1 Best Overall
Sale
TOZO A1 Wireless Earbuds Bluetooth 5.3 Light Weight in Ear Headphones | IPX5 Waterproof,2 Mics for AI Calls,Immersive Premium Sound Bass Headset with Charging Case,32 EQ via App Black
  • [Ultra-Lightweight Ear Buds Designed for Small Ears] Each earbud weighs only 3.7g and features a compact, ergonomic in-ear design made especially for small ears. Secure, low-profile, and comfortable for workouts, all-day wear or overnight sleeping.The ultra-slim profile sits flush in your ear with no hard edges poking or rubbing, so you can even sleep on your side without discomfort.
  • [Immersive Stereo Sound with TOZO OrigX Technology] TOZO OrigX tuning delivers clear vocals, balanced mids, and natural stereo sound for music, podcasts, and videos.
  • [Long Battery Life for Daily Use] Get up to 7 hours of playtime on a single charge, with up to 32 hours total using the charging case—ideal for workdays, commuting, and extended listening sessions.
  • [Bluetooth 5.3 & Stable Connection] Bluetooth 5.3 provides fast pairing, stable wireless performance, and reduced dropouts as you move around home or office.
  • [Deep Bass with Clear Vocals] High-performance drivers produce punchy bass while keeping vocals clean and detailed for everyday listening.

How the TF2 custom-mode stack fits together

A custom mode is usually a plugin-driven ruleset layered onto the TF2 server. Metamod:Source provides the extension layer, SourceMod supplies the scripting and administration framework, and the mode’s .smx plugin implements the gameplay. Maps and downloadable assets complete the experience.

Layer Purpose Typical location or check
TF2 dedicated server Runs the game process, networking, maps, and baseline cvars. Writable tf directory and reliable restart method.
Metamod:Source Loads server extensions used by SourceMod and other plugins. Verify with meta list in the server console.
SourceMod Provides plugin loading, commands, configuration, and administration. Plugins live under tf/addons/sourcemod/plugins.
Mode plugin Implements VSH, Dodgeball, Prop Hunt, DeathRun, or another ruleset. Install its .smx file and all documented companion files.
Maps and assets Supply the arenas, models, sounds, and other content expected by the plugin. Maps go in tf/maps; custom content follows the plugin’s download instructions.
Configuration Controls persistent server behavior, mode rules, and map exceptions. server.cfg, plugin-generated cfg files, and map-specific cfg files.

Step 1: Install Metamod:Source and SourceMod

Install Metamod:Source first

Download a current Metamod:Source build that supports your TF2 server, then extract it into the TF2 mod directory so its addons files are in the server’s actual tf/addons path. Do not place the files in the server root or in a different game installation.

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

SourceMod’s installation documentation states: “SourceMod requires Metamod:Source 1.9.0 or higher (it is recommended that the latest version is used).” Treat that as a dependency, not an optional upgrade. A mismatched or misplaced Metamod installation prevents SourceMod from loading.

Extract SourceMod into the same mod folder

Extract SourceMod so its framework is alongside Metamod under tf/addons. The resulting layout should include the SourceMod directory and its plugin directory at tf/addons/sourcemod/plugins. Preserve the archive’s directory structure while extracting; flattening folders is a common cause of an apparently missing installation.

Restart and verify the framework

  1. Stop the TF2 server completely.
  2. Start it again and wait for the server to finish loading.
  3. In the server console, run meta list.
  4. Confirm that Metamod:Source and SourceMod are listed without load errors.

If meta list is empty, stop installing the mode and fix the framework path or build first. Check that Metamod:Source is in the active TF2 addons directory and that the SourceMod build is compatible. Repeating plugin uploads will not correct an unloaded framework.

Rank #2
Sale
Smart Watch for Men Women Compatible with iPhone Samsung Android Phone 1.69 inch Full Touch Screen IP68 Waterproof Bluetooh Fitness Tracker Heart Rate/Sleep Monitor (Black)
  • 【IP68 Waterproof Multifunctinal Smart Watch】Torjalph fitness activity tracker smart watch is IP68 waterproof technology ,you can wear it when swimming,handwashing,it's rain-proof which means that you perform multiple exercise modes outside without worrying about sweat or rain corroding your fitness smart watch,and this watch equipped with a 230 mAh large capacity battery magnetic charging ,and this sports activity tracker watch can be used 5-7 days If fully charged.
  • 【Larger 1.83'' Full Screen Watch & Multi-dial Selection】1.83 inch full HD color touch screen smart watch for men / women provides excellent 240*284 resolution image quality ,This Bluetooth smart watch offers a better touch experience and remarkable immersion and ,more than 200 watch faces for you to choose from App"Da Fit ", you can change the dial style according to your mood to wear keeping the world on your wrist
  • 【Accurate Activity Tracker Smart Watch 】sports watch activity tracker uses sweat and dust resistant breathable silicone strap, our Fitness Tracker Smart Watch for Android iOS Phones supports 12 sports modes,walking,running,bicycle,swimming,badminton,basketball,football,rope skipping. This bluetooth calls smart watch for men women is lightweight and stylish, bringing more convenient and relaxing sports experience while also providing more protection.
  • 【Your 24 Hour Personal Daily Health Monitor】Fitness watch for women men full touch screen IP67 waterproof bluetooth smartwatch for Android iOS Phones with heart rate blood pressure monitor multifunction Andriod smart watch with steps counter sleep monitor sports fitness watch, monitoring blood oxygen saturation allows you to understand your physical condition in real time to track fitness progress ,to know your health status in time.
  • 【More Functions Bluetooth Call Smart Watch】This fitness activity smart watch full screen for iPhone and Android phones includes a bunch of new features including:The bluetooth smart watch can hang up the phone, receive and display WhatsAPP /Text /Facebook /Twitter /Messenger reminder.Support sedentary reminder, alarm clock, stopwatch, timer,weather information,music control, remote camera control compatible with Android 5.0 and above or iOS 9.0 and above smartphones.

SourceMod 1.12 was identified as the stable recommended release in an official release post dated October 20, 2024. For a production server, check current compatibility before replacing a working installation with a newer build.

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

Step 2: Install the custom mode and its dependencies

Place the main plugin

Copy the mode’s compiled .smx file into:

tf/addons/sourcemod/plugins

Do not assume the plugin is self-contained. Follow its installation notes for required extensions, companion plugins, translations, configuration templates, boss definitions, weapon lists, and data files. Keep each file in the path specified by that mode; a correctly named file in the wrong directory is functionally absent.

Preserve the plugin’s generated configuration

Many SourceMod plugins create a configuration file on first load, commonly under tf/cfg/sourcemod or another directory documented by the author. Start the server once after installation, inspect the generated files, and change mode rules there rather than copying all of them into the global server configuration.

Confirm plugin loading

After the restart, run:

sm plugins list

Find the mode by name and check for an error state. A plugin listed as loaded can still fail to start its gameplay if the active map, required data files, or dependencies do not match its expectations, so treat the list as a framework check rather than proof that a round works.

Step 3: Add maps, models, sounds, and rotation entries

Install every required map

Upload each required .bsp file to:

tf/maps

Use the exact spelling supplied by the map or mode documentation. Then add the map name without the .bsp extension to tf/cfg/mapcycle.txt. Keep only maps that are installed and tested; an unavailable entry can interrupt rotation or send players to an unintended fallback.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
New Bee Guitar Cable 10ft Electric Instrument Bass AMP Cord
  • [Low Noise High Fidelity] New bee guitar cord with 22AWG oxygen-free-copper center conductors provides enhanced signal transfer, the PVC insulation material and the high-density stranded copper double shield provide noise rejection for quiet operation
  • [Ideal for Choice] New bee 1/4 straight and right angle metal connectors, ensures a secure connection in any instrument, pedal, or amp jack. L shape great fro on stage guitar stands
  • [Wide Compatible] Suitable for mixer, power amplifier, microphone, effector, decoder, equalizer, electoronic organ, electric guitar, electric bass and other electronic equipments. Widely used in the installation of smart home, karaoke speaker, professional stage audio, etc
  • [Easy Disassemble] Making incidental repairs quick and easy! Very nice, flexible cable
  • [Dont Hesite to Order] 24 hours customer services and professional technology team are standing by

Make custom assets downloadable

If the mode uses custom models, sounds, materials, or other files, follow its download configuration exactly. Test from a client that does not already have the files cached. A server-side copy alone is not enough if clients cannot receive the content when they join.

Change to a required map manually

Before relying on rotation, change the server to one of the mode’s required maps and watch the console. This exposes missing map files, incorrect prefixes, and plugin assumptions faster than waiting for a scheduled rotation.

Step 4: Put each setting in the right configuration file

Configuration scope is the difference between a predictable multi-mode server and one whose rules leak from one map into the next.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
File or location Use it for Do not use it for
tf/cfg/server.cfg Identity, network, logging, and baseline gameplay cvars that should persist across maps. This file is normally created manually and loaded at startup. Every mode’s special rules, limits, or team settings.
Plugin-generated cfg, often tf/cfg/sourcemod Rules exposed by the custom-mode plugin, such as its round behavior, boss, weapon, or timing options. Unrelated server-wide identity or network settings.
tf/cfg/mapcycle.txt The ordered list of map names used for rotation, written without .bsp. Console variables or plugin rules.
Map-specific cfg in tf/cfg Exceptions for one map: different limits, team rules, timing, or mode activation. Values that should apply on every map unless you deliberately duplicate and maintain them.

Map-specific configuration is loaded after the general server settings, so it can override them. When several modes share one instance, explicitly set values back to safe defaults in the next map’s configuration; otherwise a cvar from a previous mode may remain active.

Example configuration workflow

  1. Place baseline identity, network, logging, and universal gameplay settings in server.cfg.
  2. Let the plugin generate its mode cfg, then edit only the rules belonging to that plugin.
  3. Create a map-named cfg in tf/cfg for exceptions required by a particular arena.
  4. Document every override and reset value beside the relevant map entry so future changes do not create hidden state.

Step 5: Configure common TF2 custom modes

Versus Saxton Hale (VSH)

VSH is generally a boss-versus-players plugin. Expect a dedicated map pool and additional boss or gameplay data rather than a single plugin file. Verify that the boss definitions, translations, weapon settings, and map-specific configuration supplied by the chosen implementation are present before testing a round. VSH maps often assume the plugin controls team assignment, boss selection, and round timing, so avoid imposing unrelated team rules globally.

Rank #4
BSIMB 15.6" Digital Family Calendar & Chore Chart, No Subscription Fees
  • Digital Family Calendar: BSIMB digital calendar wall touch screen puts an end to your chaotic life. Designed for busy families, the digital calendar keeps you organised and in step with your family. Assign different colours and tasks to each family member to make family scheduling easier and more intuitive.
  • Easy Setup and Auto-Sync: Plug in, connect to WLAN and auto-syn your electric calendar in minutes. Digital wall calendar compatible with Google calendar, iCloud calendar, Outlook calendar, Cozi calendar and Yahoo calendar. Add events directly on the device or through the ecalendar app. Electronic calendar stays current whether you're at work or traveling—no manual updates needed.
  • All-In-One Home Assistant: Smart calendar builds habits and encourage independence with personalised chores. Display daily meal plan to reduce the daily ‘What's for dinner?’ stress. To-do lists keep track of everything you want. Turning chores into valuable achievements with stars and rewards, making life easier and more enjoyable.
  • Manage Anytime Anywhere: BSIMB electronic calendar for family stay connected with the powerful ecalendar app. Access and manage your digital wall calendar anytime, anywhere with free features like stars & rewards, photo screensaver, chore charts, meals plans, to-do lists etc. Electronic planner paid features like Magic Import tailor advanced tools for users with special needs.
  • Stay in Touch with Loved Ones: Share photos or videos from your phone to electronic wall calendar with app, instantly update your life moment, and keep in touch with your family, especially those who are far away; you can also surprise your smart calendar digital wall by sending him a wish card; it's also great for keeping tech-illiterate elders in touch with the youngsters.

Dodgeball

Dodgeball normally combines specialized dodgeball maps with a plugin that controls projectile behavior and round rules. Test projectile spawning, team setup, round resets, and the intended arena boundaries. A standard TF2 map in the rotation does not provide the entities or layout the mode expects.

Prop Hunt

Prop Hunt requires a compatible plugin plus maps and configuration designed for prop selection, hiding, and hunting. Check that the client-download configuration includes every custom model or sound. Test both teams and a complete round so you can catch missing props, incorrect model paths, or rules that only appear after the initial setup phase.

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.

DeathRun

DeathRun is strongly map-driven: the map supplies traps and route logic while the plugin commonly handles teams, round flow, and administrative controls. Use maps known to support the installed implementation, and isolate DeathRun team or timing cvars in its plugin or map configuration rather than applying them to the whole server.

Trade, Jump, and MGE

Trade, Jump, and MGE are established community-server patterns generally selected through map rotation and plugin-specific configuration. Their requirements differ by implementation, so treat the map list and plugin documentation as authoritative. A shared server should give each of these modes its own map entries and map-specific overrides where rules differ.

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

How to choose a mode for your server

The mode’s name does not tell you the operational cost. Compare the following before committing to a rotation:

Decision axis Questions to answer Why it matters
Plugin maturity and maintenance Is the plugin maintained, compatible with your framework build, and clear about dependencies? An abandoned or undocumented plugin increases upgrade and troubleshooting work.
Maps and assets How many maps, models, sounds, and data files are required, and can clients download them? Every additional asset is another installation and testing point.
Player-count assumptions Does the mode require a minimum or particular team size to make a round functional? A mode can technically load while being unplayable with an undersized population.
CPU and network impact Does the plugin create frequent projectiles, entities, effects, or downloads? Resource behavior differs by implementation; no universal capacity figure is established.
Configuration isolation Can its cvars live in a dedicated plugin or map cfg without conflicting with other modes? Clean scope prevents rules from leaking across map changes.
Admin controls Does it provide the commands and permissions needed to start, stop, or manage rounds? Administrators need a safe recovery path when a map or round stalls.
Map-driven or plugin-driven design Does gameplay depend mainly on the map’s entities or on runtime plugin logic? This determines whether map compatibility or plugin configuration is the larger maintenance burden.

There is no independent performance, player-capacity, or reliability statistic that can be applied to all TF2 custom modes. Measure your own server after installation instead of promising a fixed player count.

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

Run a complete post-installation test

  1. Restart fully: Stop and start the server after framework and plugin changes.
  2. Check the framework: Run meta list and resolve any Metamod or SourceMod load error.
  3. Check plugins: Run sm plugins list and confirm the mode and its dependencies are loaded.
  4. Load a required map: Change to a map from the mode’s documented pool, watching the console for missing files or errors.
  5. Join with a clean client: Confirm custom models, sounds, and materials download successfully.
  6. Test the round: Exercise team assignment, the opening phase, the main objective, round reset, and map change.
  7. Test the expected population: Use the player count the mode is designed around, not only an administrator connected alone.
  8. Review persistence: Change maps and verify that global values remain, map exceptions apply only where intended, and old mode rules are reset.

Do not advertise the mode as working until the plugin, map, dependencies, downloads, and round behavior have all passed this sequence.

Troubleshooting by symptom

meta list is empty

  • Confirm Metamod:Source is installed in the active TF2 addons path.
  • Confirm the SourceMod build is present under the same mod directory and is compatible with Metamod:Source.
  • Perform a full stop/start rather than only changing maps.
  • Recheck extraction paths for an extra nested folder created by the archive.

The plugin appears in sm plugins list, but the mode does not start

  • Verify that the current map name or prefix matches what the plugin expects.
  • Check every required config, translation, boss, weapon, and data file.
  • Look for a dependency listed as failed or missing.
  • Load a documented compatible map manually and read the server console during startup.

Players see missing models or sounds

  • Confirm the files exist on the server in the paths specified by the mode.
  • Check the mode’s client-download settings.
  • Join from a client that has never downloaded the assets to distinguish a real download problem from a cached file.

Rules revert or leak after a map change

  • Move values that must persist to server.cfg.
  • Keep only intentional differences in the map-specific cfg.
  • Set explicit reset values for cvars that another mode changes.
  • Inspect the load order: general server settings are applied before map-specific overrides.

The map will not enter rotation

  • Ensure the map is installed under tf/maps.
  • Use the exact map name in mapcycle.txt, without .bsp.
  • Remove untested or unavailable entries until the rotation contains only known-good maps.

Maintaining a multi-mode TF2 server

Keep an inventory of framework versions, plugin files, dependencies, maps, custom assets, and the cfg files that own each setting. When upgrading SourceMod or Metamod:Source, test the mode on a copy or during a maintenance window, then repeat the full verification sequence. A framework update can expose an old plugin or extension that previously loaded without complaint.

Use one clearly documented map pool per mode when possible. If modes share an instance, name map-specific cfg files consistently, record which plugin they activate, and define the values that must be reset on exit. Keep backups of known-good plugin and configuration versions so a failed update can be rolled back without rebuilding the server.

Final operating checklist

  • Writable, backed-up tf directory.
  • Reliable full restart method.
  • Metamod:Source installed before SourceMod.
  • SourceMod loaded and verified with meta list.
  • Mode plugin and every documented dependency in place.
  • Required maps in tf/maps.
  • Exact map names in tf/cfg/mapcycle.txt.
  • Custom assets downloadable by a clean client.
  • Persistent cvars in server.cfg.
  • Mode rules in plugin cfg files.
  • Map exceptions and reset values in map-specific cfg files.
  • Successful plugin, map, asset, round, player-count, and map-change tests.

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.

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

custom game modesDeathRundodgeballMetaMod:SourceProp HuntSourceModTeam Fortress 2TF2 serverVSH

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
Windows Errors? Fix Them Before They SpreadFree repair scan
Crashes, No Sound, or Screen Glitches?Free driver scan

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.