이 가이드는 Legion Hosting에서 호스팅하는 Left 4 Dead 2 전용 서버에서 발생할 수 있는 일반적인 문제(접속 문제, 애드온 일관성 오류, 플러그인 충돌, 서버 브라우저 목록 문제 포함)를 다룹니다. 초기 서버 설정은 L4D2 서버 설정 가이드를 참조하세요.
애드온 일관성 오류 — 접속 시 클라이언트 추방
- 이 오류는
sv_consistency 1이 설정되어 있고 클라이언트의 로컬 파일이 서버의 파일과 일치하지 않을 때 발생합니다. 이는 일반적으로 커스텀 캠페인이나 사운드/모델 교체에서 발생합니다. - 일치하는 애드온이 없는 클라이언트가 접속할 수 있도록 하려면
server.cfg에서sv_consistency 0으로 설정하고 재시작하세요. - 일관성 강제를 원하는 경우, 모든 플레이어가
left4dead2/addons/디렉터리에 커스텀.vpk파일의 동일한 사본을 가지고 있는지 확인하세요.
// In left4dead2/cfg/server.cfg — set to 0 to disable file hash checking
sv_consistency 0
절충점:
sv_consistency 0으로 설정하면 클라이언트가 추방되지 않고 임의의 로컬 수정(커스텀 스킨, 사운드 팩)도 실행할 수 있습니다. 이것이 우려되는 경우 1로 유지하고 모든 플레이어가 동일한 애드온 파일을 설치하도록 요구하세요.
SourceMod 플러그인 충돌 또는 서버 충돌
left4dead2/addons/sourcemod/logs/errors_YYYYMMDD.log에서 SourceMod 오류 로그를 확인하세요. 어떤 플러그인이 실패했고 그 이유가 나열됩니다.- 일부 플러그인은 현재 버전의 SourceMod 또는 다른 특정 플러그인과 호환되지 않습니다. 알려진 충돌에 대해서는 AlliedModders의 플러그인 스레드를 읽어보세요.
- 문제를 분리하려면 한 번에 하나씩 플러그인을
left4dead2/addons/sourcemod/plugins/disabled/로 옮기고 충돌이 멈출 때까지 재시작하세요. 마지막으로 비활성화한 플러그인이 원인일 가능성이 높습니다. - MetaMod:Source와 SourceMod 모두 최신 안정 버전을 사용하고 있는지 확인하세요. 버전 불일치는 불안정성의 일반적인 원인입니다.
빠른 진단: 서버 콘솔(GPanel Console 탭을 통해)에서
sm plugins list를 실행하여 어떤 플러그인이 성공적으로 로드되었고 어떤 것이 실패했는지 확인하세요.
서버가 서버 브라우저 또는 로비에 표시되지 않음
server.cfg에sv_lan 0이 설정되어 있는지 확인하세요.- GSLT 토큰이 유효하고 차단되지 않았는지 확인하세요. steamcommunity.com/dev/managegameservers에서 토큰 상태를 확인할 수 있습니다. 차단되거나 만료된 토큰은 목록 표시를 방해합니다.
server.cfg의sv_setsteamaccount에 토큰이 포함되어 있고 오타나 추가 공백이 없는지 확인하세요.- 서버 브라우저는 새로 시작된 서버를 목록에 표시하는 데 최대 10분이 걸릴 수 있습니다. 먼저 콘솔 직접 접속을 시도하여 서버가 올바르게 실행되고 있는지 확인한 다음 브라우저가 따라잡을 때까지 기다리세요.
sv_gametypes에 최소한 하나의 유효한 게임 모드 문자열이 포함되어 있고mp_gamemode가 해당 값 중 하나와 일치하는지 확인하세요.
| 증상 | 가능한 원인 | 해결 |
|---|---|---|
| 서버가 실행되지만 브라우저에 없음 | GSLT 토큰 누락 또는 유효하지 않음 | App ID 550에 대한 새 토큰을 생성하고 sv_setsteamaccount를 통해 설정 |
| 서버가 브라우저에 있지만 잘못된 게임 모드 | sv_gametypes / mp_gamemode 불일치 |
mp_gamemode 값이 sv_gametypes에 나열되어 있는지 확인 |
| 서버가 전혀 보이지 않음 | sv_lan 1 설정됨 |
server.cfg에서 sv_lan 0으로 설정하고 재시작 |
커스텀 캠페인 맵이 로드되지 않거나 찾을 수 없음
- 캠페인의 모든
.vpk파일이left4dead2/addons/에 업로드되어 있는지 확인하세요. 여러 부분으로 구성된 캠페인은 모든 부분이 필요합니다 — 보조.vpk가 누락되면 맵 로드 실패가 발생합니다. changelevel과 함께 정확한 내부 맵 이름을 사용하세요. 맵 이름이 항상 캠페인의 표시 이름과 같은 것은 아닙니다. 올바른 맵 파일 이름은 캠페인 문서 또는.vpk의 내용을 확인하세요.- 새
.vpk파일을 업로드한 후 서버를 재시작하세요. 엔진은 시작 시에만 애드온을 인덱싱합니다.
// Use the internal map name, not the campaign display name
changelevel c1m1_hotel // Official campaign example
changelevel custom_map_chapter1 // Custom campaign — check campaign docs for exact name서버에 접속할 수 없음
- GPanel Console 탭에서 활성 출력을 확인하여 서버가 실행 중인지 확인하세요.
- GPanel Network 탭의 올바른 IP 주소와 포트를 사용하고 있는지 확인하세요. 기본 포트를 가정하지 마세요 — 할당된 포트가 다를 수 있습니다.
- 서버가 비밀번호로 보호되어 있는 경우 올바른 비밀번호를 입력하고 있는지 확인하세요.
left4dead2/cfg/server.cfg의sv_password에서 확인하거나 재설정할 수 있습니다. - 접속을 시도하기 전에 서버가 시작을 완료했는지 확인하세요. 서버가 접속 준비가 되면 콘솔에
VAC secure mode is activated와 같은 줄이 표시됩니다.
방화벽 참고: Legion Hosting 서버는 기본적으로 필요한 포트가 열려 있습니다. 서버 포트를 변경했거나 추가 서비스를 사용하는 경우, GPanel Network 탭에서 올바른 포트 할당을 확인하세요. 먼저 접속 세부 정보가 올바른지 확인하지 않은 채로 포트에 관한 지원 티켓을 열지 마세요.
맵 변경 또는 시작 시 서버 충돌
- 충돌 전 마지막 오류 메시지를 GPanel의 서버 콘솔 출력에서 확인하세요.
- 커스텀 맵에서 충돌이 발생하는 경우 공식 맵(예:
changelevel c1m1_hotel)을 로드하여 커스텀 콘텐츠 없이 서버가 안정적인지 확인하세요. - SourceMod가 설치되어 있는 경우
left4dead2/addons/sourcemod/logs/에서 오류 세부 정보를 확인하세요. - 최근에 추가한
.vpk파일이나 플러그인을 한 번에 하나씩 제거하고 재시작하여 원인을 분리하세요. - 손상된 서버 파일은 시작 충돌을 일으킬 수 있습니다. 모든 커스텀 콘텐츠를 제거한 후에도 문제가 지속되면 GPanel Settings 탭에서 서버를 재설치해 보세요.
관련 문서
- L4D2 서버 설정 가이드 — Server.cfg 구성, GSLT 토큰, 게임 모드 및 접속 방법
- L4D2 관리자 설정 및 플러그인 관리 — SourceMod, MetaMod 설치, 관리자 추가 및 플러그인 관리
- SFTP로 파일 업로드하는 방법
이 가이드를 따른 후에도 문제가 계속되면 legionhosting.net/submitticket.php에서 지원 티켓을 열고 서버 ID, 콘솔 로그의 오류 메시지 및 이미 수행한 단계에 대한 설명을 포함하세요.
