background image

TF2 Admin & Plugin Setup (SourceMod/MetaMod) - Base de connaissances

  1. Accueil
  2. Base de connaissances
  3. Team Fortress 2
  4. TF2 Admin & Plugin Setup (SourceMod/MetaMod)
Base de connaissances Ouvrir un ticket Tickets en cours
Game Servers 380 7 Days to Die 4 Abiotic Factor 2 Aloft 2 alt:V 2 Americas Army Proving Grounds 2 Among Us 2 Archean 2 ARK Survival Ascended 6 ARK Survival Evolved 3 Arma 3 3 Arma Reforger 2 Aska 2 AssaultCube 2 Assetto Corsa 3 Astro Colony 2 Astroneer 2 Automobilista 2 2 Avorion 2 Banana Shooter 2 Barotrauma 3 BATTALION Legacy 2 BeamNG.drive (BeamMP) 2 Black Mesa 2 Brickadia 2 Call of Duty 2 Citadel: Forged with Fire 2 ClassiCube 2 Clone Hero 2 Colony Survival 2 Conan Exiles 4 Contagion 2 Core Keeper 2 Counter-Strike 2 3 Craftopia 2 CryoFall 2 CS2D 2 Cube 2: Sauerbraten 2 Cubic Odyssey 2 DayZ 4 DDNet 2 DDRaceNetwork 2 Dead Matter 2 Dont Starve Together 4 Eco 2 Empyrion Galactic Survival 2 Enshrouded 3 Escape from Tarkov 2 Euro Truck Simulator 2 2 Factorio 2 Farming Simulator 25 2 Fistful of Frags 2 FiveM 3 FortressCraft Evolved 2 Foundry 2 Foundry VTT 2 Frozen Flame 2 FTL Tachyon 2 Garrys Mod 3 Ground Branch 2 Half-Life 2 Deathmatch 2 Hogwarp 2 Holdfast: Nations at War 2 HumanitZ 2 Hurtworld 2 Hytale 1 Icarus 2 Insurgency Sandstorm 2 IOSoccer 2 Just Cause 3 Multiplayer 2 Kerbal Space Program 2 Killing Floor 2 3 LeagueSandbox 2 Left 4 Dead 2 Left 4 Dead 2 3 Longvinter 2 Los Angeles Crimes 2 Medal of Honor 2 Midnight Ghost Hunt 2 Mindustry 2 Minecraft 4 Minetest 2 Modiverse 2 Mordhau 3 Mount & Blade II: Bannerlord 2 Myth of Empires 2 Nazi Zombies Portable 2 Necesse 2 NeosVR 2 Neverwinter Nights EE 2 Night of the Dead 2 Nightingale 2 No Love Lost 2 No More Room in Hell 2 No One Survived 2 Nova-Life Amboise 2 Nuclear Option 2 Onset 2 Open Fortress 2 OpenArena 2 OpenRA 2 OpenRCT2 2 OpenTTD 2 Operation Harsh Doorstop 2 Palworld 3 Path of Titans 2 Pavlov VR 3 PixARK 2 Plains of Pain 2 Portal Knights 2 Post Scriptum 2 Project Zomboid 8 Puck 2 Quake Live 2 R5Reloaded 2 RedM 2 Renown 2 Resonite 2 Return to Moria 2 Rimworld Together 2 Rising World 2 Risk of Rain 2 1 Rust 4 Satisfactory 1 SCP Secret Laboratory 3 SCUM 2 Smalland 2 Solace Crafting 2 Soldat 2 Soldat 2 2 Sonic Robo Blast 2 2 Sons of the Forest 2 Soulmask 2 SourceCoop 2 Space Engineers 3 Space Station 14 2 Squad 3 Starbound 3 StarMade 2 Stationeers 2 Stormworks 2 Subnautica Nitrox 2 Sunkenland 2 SuperTuxKart 2 Sven Co-op 2 Swords 'n Magic and Stuff 2 Team Fortress 2 3 Teeworlds 2 Terraria 3 TerraTech Worlds 2 TF2 Classified 2 The Forest 3 The Front 2 The Isle 2 Tower Unite 2 Trackmania 2 Unturned 4 Urban Terror 2 V Rising 3 Valheim 3 VEIN 2 Veloren 2 Vintage Story 3 Voyagers of Nera 2 Wolfenstein: Enemy Territory 2 Wreckfest 2 Wurm Unlimited 2 Xonotic 2 Zandronum 2 Getting Started 2 Network & Connectivity 1 Server Management 2
Support
Catégories

TF2 Admin & Plugin Setup (SourceMod/MetaMod)

tf2 sourcemod metamod plugins admin 0 ont trouvé cet article utile
Disponible en : ESPAÑOL

This guide covers installing MetaMod:Source and SourceMod on your Team Fortress 2 server, setting up admin accounts, and managing plugins. For core server configuration, GSLT tokens, and map rotation, see the TF2 Server Setup Guide.

In This Article
  1. Installing MetaMod:Source
  2. Installing SourceMod
  3. Adding SourceMod Admins
  4. Installing Plugins
  5. Recommended Plugins
  6. Managing Plugins

Installing MetaMod:Source

MetaMod:Source is a plugin layer that sits between the game engine and SourceMod. It must be installed before SourceMod.

  1. Download the latest stable build from sourcemm.net. Choose the Linux build (the server runs on Linux).
  2. Extract the archive. It contains an addons/ folder.
  3. Upload the contents so they merge into your server's tf/addons/ directory via SFTP or the GPanel file manager. The resulting path should be tf/addons/metamod/.
  4. Verify the install by starting the server and running meta version in the console. You should see the MetaMod version string.
Directory structure after install:
tf/addons/metamod/
tf/addons/metamod.vdf

Installing SourceMod

SourceMod is the scripting and plugin framework for Source engine games. It requires MetaMod:Source to be installed first.

  1. Download the latest stable SourceMod build from sourcemod.net. Choose the Linux build.
  2. Extract the archive. It contains an addons/ and a cfg/ folder.
  3. Upload both folders via SFTP, merging them into tf/addons/ and tf/cfg/ respectively.
  4. Restart the server.
  5. Verify by running sm version in the server console.

Key SourceMod Directories

Path Purpose
tf/addons/sourcemod/plugins/ Compiled plugin files (.smx)
tf/addons/sourcemod/plugins/disabled/ Plugins placed here are loaded but not activated
tf/addons/sourcemod/configs/ Plugin configuration files
tf/addons/sourcemod/logs/ SourceMod and plugin log files
tf/addons/sourcemod/translations/ Language phrase files

Adding SourceMod Admins

To grant in-game admin access to a Steam account, edit tf/addons/sourcemod/configs/admins_simple.ini and add a line in the following format:

"STEAM_0:X:XXXXXXXX"   "99:z"    // 99:z = full root access

Replace the SteamID with the target account's SteamID2. The flag z grants all permissions. You can find a player's SteamID using tools like steamid.io.

Common Admin Flags

Flag Permission
b Kick players
c Ban players
d Unban players
e Slay/slap players
f Change map
g Change server cvars
z All permissions (root)

Reload admins without restarting the server by running sm_reloadadmins in the server console.

Tip: For multi-server setups, consider using SourceBans++ for centralized ban and admin management via a web panel.

Installing Plugins

Plugins are distributed as .smx files. To install a plugin:

  1. Download the .smx file from forums.alliedmods.net or the plugin's repository.
  2. Upload the .smx file to tf/addons/sourcemod/plugins/ via SFTP.
  3. If the plugin includes additional files (configs, translations, gamedata), upload them to the corresponding SourceMod subdirectories.
  4. Restart the server, or run sm plugins load pluginname in the console to hot-load it.
Important: Always read the plugin's AlliedModders thread before installing. Many plugins require specific dependencies (such as TF2Attributes or DHooks) that must be installed separately. Using an incompatible version can cause errors or crashes.
Plugin Purpose Source
Admin File Manager In-game admin commands: kick, ban, mute, map change Included with SourceMod
Basevotes / NativeVotes Player voting: sm_vote, sm_votemap, sm_votekick Included with SourceMod / AlliedModders forums
RockTheVote (RTV) Players vote to skip current map early AlliedModders forums
MapChooser Extended End-of-map vote with nomination support and cooldowns AlliedModders forums
TF2Attributes Runtime item attribute modification, required by many TF2 plugins GitHub / AlliedModders
Freak Fortress 2 (FF2) Boss-vs-players custom game mode AlliedModders forums
VSH / Saxton Hale Classic one-vs-all Saxton Hale game mode AlliedModders forums
SourceBans++ Web-integrated ban management across multiple servers AlliedModders forums

Managing Plugins

Listing Loaded Plugins

Run the following in the server console to see all currently loaded plugins and their status:

sm plugins list

Disabling a Plugin

Move the .smx file from tf/addons/sourcemod/plugins/ to tf/addons/sourcemod/plugins/disabled/, then run sm plugins unload pluginname in the console or restart the server.

Updating a Plugin

  1. Download the new version of the .smx file.
  2. Replace the existing file in tf/addons/sourcemod/plugins/.
  3. If updated config or translation files are included, replace those as well.
  4. Restart the server to load the updated plugin.
Tip: Check tf/addons/sourcemod/logs/ after any plugin change to verify it loaded successfully and no errors occurred.

Related Articles

Need help? If you run into issues installing SourceMod or plugins, please open a support ticket and include any error messages from tf/addons/sourcemod/logs/.
Cet article vous a-t-il été utile ?
Contribuer à l'amélioration

Articles associés

Team Fortress 2 Server Setup Guide
This guide walks you through configuring your Team Fortress 2 dedicated server, including server set... TF2 Server Troubleshooting Guide
This guide covers common issues you may encounter when running a Team Fortress 2 dedicated server, i...
Retour

Ready to Get Started?

The servers are booted, select your plan and become our latest satisfied client.