A centralized configuration repository for UDL.TF Team Fortress 2 game servers, managing SourceMod plugins, server configurations, and game mode assets.
ServerFiles serves as the single source of truth for all UDL.TF Team Fortress 2 server configurations and assets. This repository manages everything from SourceMod plugins and their configurations to game mode-specific settings and custom map files. By centralizing these resources, it ensures consistency across all server instances while providing a versioned history of all server changes.
The repository follows a modular structure where shared base configurations are stored in the base/ directory, while game mode-specific configurations are organized in their own directories. This approach allows for efficient deployment of different server types while maintaining common plugins and configurations. The system is designed to work with FastDL for quick client downloads and supports multiple difficulty levels for various game modes.
Built on top of SourceMod, a popular Source engine server modification framework, ServerFiles includes essential plugins for server management, anti-cheat systems (SourceBans++), player utilities, and game mode-specific enhancements. The configuration system leverages SourceMod's modular approach and Valve's config execution system to provide flexible server behavior across different game modes.
- Plugin Management: Hosts compiled SourceMod plugins (.smx files) for server functionality including admin tools, SourceBans++ integration, player utilities, and game mode features
- Configuration Distribution: Maintains centralized server configs (server.cfg, game mode-specific configs) that define server behavior, networking, logging, and SourceMod plugin settings
- Asset Management: Organizes custom maps and materials, utilizing chunked compression (.bz2.parts) for large map files to overcome GitHub file size limitations
- Game Mode Support: Provides isolated configuration sets for different TF2 game modes with varying difficulty levels and specific plugin requirements
graph TB
subgraph "ServerFiles Repository"
BASE[base/]
GAMEMODES[Game Mode Directories]
end
subgraph "Base Components"
BASE --> ADDONS[addons/sourcemod/]
BASE --> CFG[cfg/]
ADDONS --> PLUGINS[plugins/*.smx]
ADDONS --> CONFIGS[configs/]
ADDONS --> GAMEDATA[gamedata/]
ADDONS --> TRANSLATIONS[translations/]
CFG --> SERVERCFG[server.cfg]
CFG --> MODECFG[Game mode configs]
CFG --> SMCFG[sourcemod/*.cfg]
end
subgraph "External Systems"
FASTDL[FastDL Server<br/>fastdl.udl.tf]
GAMESERVERS[TF2 Game Servers]
SOURCEBANS[SourceBans++ Database]
end
SERVERCFG -.->|sv_downloadurl| FASTDL
PLUGINS -.->|sbpp_* plugins| SOURCEBANS
BASE -.->|deployed to| GAMESERVERS
GAMEMODES -.->|deployed to| GAMESERVERS
style BASE fill:#1e3a5f,stroke:#4a90e2,color:#ffffff
style GAMEMODES fill:#5f3e1e,stroke:#e2a04a,color:#ffffff
style PLUGINS fill:#1e5f3e,stroke:#4ae27a,color:#ffffff
style FASTDL fill:#5f1e3e,stroke:#e24a7a,color:#ffffff
sequenceDiagram
autonumber
participant Admin
participant Repo as ServerFiles Repo
participant Server as TF2 Server
participant SM as SourceMod
participant FastDL as FastDL Server
participant Client as TF2 Client
Admin->>Repo: Clone/update repository
Admin->>Server: Deploy configs & plugins
Server->>Server: Load server.cfg
Server->>SM: Initialize SourceMod
SM->>SM: Load plugins from addons/sourcemod/plugins/
SM->>SM: Parse configs from addons/sourcemod/configs/
Server->>Server: Execute game mode cfg
Client->>Server: Connect to server
Server->>Client: Send required files list
alt File needs download
Client->>FastDL: Request file (map/material/sound)
FastDL->>Client: Return compressed file
end
Client->>Server: Join game
SM->>Client: Apply plugin features (ads, logos, utilities)
stateDiagram-v2
[*] --> Original: Map file added
Original --> Checking: Check file size
Checking --> SmallFile: Size < 25MB
Checking --> LargeFile: Size >= 25MB
SmallFile --> Committed: Commit .bsp directly
LargeFile --> Compressing: bzip2 compression
Compressing --> Splitting: Split into parts
Splitting --> PartsCreated: Create .bz2.parts/ dir
PartsCreated --> Committed: Commit parts
Committed --> FastDL: Upload to FastDL
FastDL --> [*]: Available for download
note right of LargeFile
GitHub has 25MB limit
Large maps need splitting
end note
note right of PartsCreated
Each part < 25MB
Named sequentially:
.part.000, .part.001, etc.
end note
- SourceMod Plugin Suite: Comprehensive collection of server management plugins including admin controls (admingrab.smx), communication systems (advertisements.smx, tidychat.smx), and player utilities (respawn.smx, hugkiss.smx, aimnames.smx)
- SourceBans++ Integration: Full SourceBans++ system with main functionality (sbpp_main.smx), communications management (sbpp_comms.smx), admin configuration (sbpp_admcfg.smx), checker (sbpp_checker.smx), reporting (sbpp_report.smx), and sleuth capabilities (sbpp_sleuth.smx) for centralized ban management
- Game Mode Configurations: Dedicated configuration files for multiple TF2 game modes with optimized settings for each playstyle
- FastDL Integration: Configured sv_downloadurl pointing to http://fastdl.udl.tf/ for rapid client-side asset downloads, reducing connection times and improving player experience
- Custom Map Support: Organized storage for custom maps with intelligent handling of large files through .bz2 compression and part-splitting to overcome GitHub's file size limitations
- Modular Difficulty System: Game modes support multiple difficulty levels with separate plugin configurations and settings allowing progressive gameplay challenges
- Network Optimization: Dedicated network.cfg with optimized server networking settings, rate limits, and bandwidth configurations for stable multiplayer performance
- Comprehensive Logging: Structured logging configuration (log.cfg) for server events, player actions, and plugin activities, essential for debugging and server administration
- Translation Support: Multi-language translation files for plugins (hugkiss.phrases.txt, respawn.phrases.txt, sbpp_*.phrases.txt) enabling internationalization of server messages
- Extension Ecosystem: Collection of SourceMod extensions and gamedata files (connect.games.txt, tf2.attributes.txt, sourcetvmanager.games.txt) providing low-level functionality for advanced plugin features
| File | Description | Location |
|---|---|---|
server.cfg | Main server configuration with sv_downloadurl, sv_tags, and core settings | base/cfg/server.cfg |
<gamemode>.cfg | Game mode-specific settings (e.g., bhop.cfg, surf.cfg) | base/cfg/<gamemode>.cfg |
network.cfg | Network and bandwidth configuration | base/cfg/network.cfg |
log.cfg | Logging configuration | base/cfg/log.cfg |
plugins.cfg | Plugin-specific settings | base/cfg/plugins.cfg |
sourcetv.cfg | SourceTV demo recording settings | base/cfg/sourcetv.cfg |
advertisements.txt | Server advertisement messages | base/addons/sourcemod/configs/advertisements.txt |
serverhudlogo.cfg | Server HUD logo configuration | base/addons/sourcemod/configs/serverhudlogo.cfg |
tidychat.cfg | Chat formatting and filtering | base/cfg/sourcemod/tidychat.cfg |
spirt.dl.cfg | Spirit download precache configuration | base/cfg/sourcemod/spirt.dl.cfg |
ServerFiles/
├── .github/ # GitHub Actions and workflows
├── base/ # Shared base files for all servers
│ ├── addons/sourcemod/ # SourceMod framework files
│ │ ├── configs/ # Plugin configuration files
│ │ ├── extensions/ # SourceMod extensions (.so/.dll files)
│ │ ├── gamedata/ # Game signatures and offsets
│ │ ├── plugins/ # Compiled SourceMod plugins (.smx)
│ │ └── translations/ # Multi-language phrase files
│ └── cfg/ # Server configuration files
│ ├── server.cfg # Main server config
│ ├── <gamemode>.cfg # Game mode configs
│ ├── network.cfg # Network settings
│ ├── log.cfg # Logging configuration
│ └── sourcemod/ # SourceMod-specific configs
├── <gamemode>/ # Game mode-specific files
│ ├── base/ # Shared files for this game mode
│ │ ├── addons/sourcemod/ # Game mode-specific plugins
│ │ ├── cfg/ # Game mode configurations
│ │ ├── maps/ # Custom maps
│ │ └── materials/ # Custom textures (optional)
│ └── <difficulty>/ # Difficulty variant overrides (optional)
├── LICENSE
└── README.md
Maps in this repository are organized by game mode under their respective directories (<gamemode>/base/maps/). Each map consists of:
- The .bsp file: The actual compiled Source engine map file that the server loads
- The .bsp.bz2 file: Compressed version uploaded to FastDL for client downloads
- The .bz2.parts/ directory: Split compressed parts stored in GitHub for large maps
GitHub has a 25MB file size limit. Many custom TF2 maps exceed this limit, so this repository uses a chunking system:
mapfile.bsp # Actual map file (too large for GitHub)
mapfile.bsp.bz2.parts/ # Directory containing split parts
├── mapfile.bsp.bz2.part.000 # Part 1 (< 25MB)
├── mapfile.bsp.bz2.part.001 # Part 2 (< 25MB)
├── mapfile.bsp.bz2.part.002 # Part 3 (< 25MB)
└── ... # Additional parts as needed
Creating split map files:
# Compress the map
bzip2 -k mapfile.bsp # Creates mapfile.bsp.bz2# Split into 20MB chunks (safely under 25MB limit)
mkdir mapfile.bsp.bz2.parts
split -b 20M mapfile.bsp.bz2 mapfile.bsp.bz2.parts/mapfile.bsp.bz2.part.Reassembling split map files:
# Concatenate parts back together
cat mapfile.bsp.bz2.parts/*.part.*> mapfile.bsp.bz2
# Decompress
bunzip2 mapfile.bsp.bz2 # Creates mapfile.bsp- Always compress maps for FastDL: Use
bzip2 -k mapfile.bspto create .bsp.bz2 files - Test maps locally first: Verify maps load correctly before committing
- Use consistent naming: UDL maps follow pattern
gamemode_mapname_udl_version.bsp - Update mapcycle.txt: Add new maps to the game mode's mapcycle.txt for rotation
- Version your maps: Include version numbers in filenames (e.g., _v4, _a06 for alpha)
- Keep source files external: .vmf (map source) files should not be committed to this repo
See LICENSE file for details.
- SourceMod - Source engine server modification framework
- MetaMod:Source - Plugin loading framework for Source engine servers
- SourceBans++ - Advanced ban management system for Source servers
- RipExt - REST in Pawn extension for HTTP/HTTPS requests
- TF2 Attributes - Plugin for modifying TF2 item attributes
- SteamWorks - Extension providing access to Steam API
- SourceTV Manager - Enhanced SourceTV control and management
- SM-Env - Environment extension for SourceMod
- Connect - Connection management extension
- WebCon & Conplex - Conplex and WebCon extension for web-based server control
- JSON Extenstion - Used for more complex JSON. But for more native only we use https://github.com/clugg/sm-json
- Websocket - Used for websocket support.