이 가이드는 Team Fortress 2 서버에 MetaMod:Source 및 SourceMod 설치, 관리자 계정 설정, 플러그인 관리를 다룹니다. 핵심 서버 구성, GSLT 토큰, 맵 로테이션은 TF2 서버 설정 가이드를 참조하십시오.

MetaMod:Source 설치

MetaMod:Source는 게임 엔진과 SourceMod 사이에 위치하는 플러그인 계층입니다. SourceMod보다 먼저 설치해야 합니다.

1. sourcemm.net에서 최신 안정 빌드를 다운로드합니다. Linux 빌드를 선택하십시오(서버는 Linux에서 실행됨).
2. 아카이브를 압축 해제합니다. 여기에는 addons/ 폴더가 포함되어 있습니다.
3. SFTP 또는 GPanel 파일 관리자를 통해 서버의 tf/addons/ 디렉터리에 병합되도록 내용을 업로드합니다. 결과 경로는 tf/addons/metamod/여야 합니다.
4. 서버를 시작하고 콘솔에서 meta version을 실행하여 설치를 확인합니다. MetaMod 버전 문자열이 표시되어야 합니다.

SourceMod 설치

SourceMod는 Source 엔진 게임을 위한 스크립팅 및 플러그인 프레임워크입니다. MetaMod:Source를 먼저 설치해야 합니다.

1. sourcemod.net에서 최신 안정 SourceMod 빌드를 다운로드합니다. Linux 빌드를 선택하십시오.
2. 아카이브를 압축 해제합니다. 여기에는 addons/와 cfg/ 폴더가 포함되어 있습니다.
3. SFTP를 통해 두 폴더를 업로드하여 각각 tf/addons/와 tf/cfg/에 병합합니다.
4. 서버를 재시작합니다.
5. 서버 콘솔에서 sm version을 실행하여 확인합니다.

주요 SourceMod 디렉터리

경로	용도
tf/addons/sourcemod/plugins/	컴파일된 플러그인 파일(.smx)
tf/addons/sourcemod/plugins/disabled/	여기에 배치된 플러그인은 로드되지만 활성화되지 않습니다
tf/addons/sourcemod/configs/	플러그인 구성 파일
tf/addons/sourcemod/logs/	SourceMod 및 플러그인 로그 파일
tf/addons/sourcemod/translations/	언어 문구 파일

SourceMod 관리자 추가

Steam 계정에 게임 내 관리자 접근 권한을 부여하려면 tf/addons/sourcemod/configs/admins_simple.ini를 편집하고 다음 형식으로 줄을 추가하십시오:

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

SteamID를 대상 계정의 SteamID2로 교체하십시오. 플래그 z는 모든 권한을 부여합니다. steamid.io와 같은 도구를 사용하여 플레이어의 SteamID를 찾을 수 있습니다.

일반적인 관리자 플래그

플래그	권한
b	플레이어 추방
c	플레이어 차단
d	플레이어 차단 해제
e	플레이어 처치/슬랩
f	맵 변경
g	서버 cvar 변경
z	모든 권한(root)

서버를 재시작하지 않고 관리자를 다시 로드하려면 서버 콘솔에서 sm_reloadadmins를 실행하십시오.

플러그인 설치

플러그인은 .smx 파일로 배포됩니다. 플러그인을 설치하려면:

1. forums.alliedmods.net 또는 플러그인의 저장소에서 .smx 파일을 다운로드합니다.
2. SFTP를 통해 .smx 파일을 tf/addons/sourcemod/plugins/에 업로드합니다.
3. 플러그인에 추가 파일(구성, 번역, 게임 데이터)이 포함된 경우 해당 SourceMod 하위 디렉터리에 업로드합니다.
4. 서버를 재시작하거나, 콘솔에서 sm plugins load pluginname을 실행하여 핫 로드합니다.

권장 플러그인

플러그인	용도	출처
Admin File Manager	게임 내 관리자 명령: 추방, 차단, 음소거, 맵 변경	SourceMod에 포함됨
Basevotes / NativeVotes	플레이어 투표: sm_vote, sm_votemap, sm_votekick	SourceMod에 포함됨 / AlliedModders 포럼
RockTheVote (RTV)	플레이어가 현재 맵을 일찍 건너뛰도록 투표	AlliedModders 포럼
MapChooser Extended	지명 지원 및 쿨다운이 있는 맵 종료 투표	AlliedModders 포럼
TF2Attributes	런타임 아이템 속성 수정, 많은 TF2 플러그인에서 필요함	GitHub / AlliedModders
Freak Fortress 2 (FF2)	보스 대 플레이어 커스텀 게임 모드	AlliedModders 포럼
VSH / Saxton Hale	클래식 1대 다수 Saxton Hale 게임 모드	AlliedModders 포럼
SourceBans++	여러 서버에 걸친 웹 통합 차단 관리	AlliedModders 포럼

플러그인 관리

로드된 플러그인 나열

현재 로드된 모든 플러그인과 상태를 보려면 서버 콘솔에서 다음을 실행하십시오:

sm plugins list

플러그인 비활성화

.smx 파일을 tf/addons/sourcemod/plugins/에서 tf/addons/sourcemod/plugins/disabled/로 이동한 다음, 콘솔에서 sm plugins unload pluginname을 실행하거나 서버를 재시작하십시오.

플러그인 업데이트

1. .smx 파일의 새 버전을 다운로드합니다.
2. tf/addons/sourcemod/plugins/의 기존 파일을 교체합니다.
3. 업데이트된 구성 또는 번역 파일이 포함된 경우 해당 파일도 교체합니다.
4. 업데이트된 플러그인을 로드하기 위해 서버를 재시작합니다.

---

관련 문서

• TF2 서버 설정 가이드 — Server.cfg 구성, GSLT 토큰, 맵 로테이션, FastDL, 접속
• TF2 문제 해결 가이드 — GSLT, SourceMod, VAC 및 서버 가시성과 관련된 일반적인 문제
• SFTP로 파일을 업로드하는 방법

---