이 가이드는 관리자 설정, RCON 접근, 서버 명령어, 플레이어 관리, 맵 로테이션, Steam Workshop 모드 지원, 문제 해결을 포함하여 Ground Branch 전용 서버의 관리에 대해 다룹니다. 초기 서버 설정은 Ground Branch 서버 설정 가이드를 참조하세요.
관리자 설정
Ground Branch는 Steam ID 기반 관리자 시스템을 사용합니다. 관리자 권한을 부여하려면 서버의 관리자 구성에 Steam ID를 추가해야 합니다.
관리자 추가하기
- GPanel에서 서버를 중지합니다.
- File Manager를 열거나 SFTP를 통해 연결합니다.
GroundBranch/ServerConfig/디렉터리로 이동합니다.Admins.cfg파일을 열거나 생성합니다.- 한 줄에 하나씩 Steam64 ID를 추가합니다:
# Ground Branch Admin List
# One Steam64 ID per line
76561198012345678
76561198087654321- 파일을 저장하고 서버를 시작합니다.
steamid.io를 방문하여 Steam 프로필 URL을 입력하면 자신의 Steam64 ID를 찾을 수 있습니다. ID는 7656119로 시작하는 17자리 숫자입니다.
RCON 접근
RCON(Remote Console)을 사용하면 플레이어로 접속하지 않고도 원격으로 서버 명령을 실행할 수 있습니다. Ground Branch는 Unreal Engine 기반을 통해 RCON을 지원합니다.
RCON 활성화하기
서버 구성 파일(GroundBranch/ServerConfig/Server.ini)에 다음을 추가하세요:
[/Script/GroundBranch.GBGameMode]
RCONEnabled=true
RCONPassword=YourSecurePassword연결하려면 서버 IP, RCON 포트(GPanel의 Network 탭에 표시됨), 그리고 구성한 비밀번호를 사용하여 Source RCON 호환 클라이언트를 사용하세요.
관리자 명령어
관리자는 게임 내 콘솔(` 키를 누름)이나 RCON을 통해 명령을 실행할 수 있습니다. 다음 표는 가장 일반적으로 사용되는 명령어를 나열합니다.
플레이어 관리
| 명령어 | 사용법 | 설명 |
|---|---|---|
listplayers |
listplayers |
접속한 모든 플레이어를 ID 및 Steam ID와 함께 나열 |
kick |
kick <playerID> |
플레이어 ID로 서버에서 플레이어를 추방 |
ban |
ban <steamID> |
Steam64 ID로 플레이어를 차단 |
unban |
unban <steamID> |
Steam64 ID로 차단을 해제 |
say |
say <message> |
서버 전체에 채팅 메시지를 전송 |
게임 및 라운드 제어
| 명령어 | 사용법 | 설명 |
|---|---|---|
changemap |
changemap <mapName> |
지정한 맵으로 변경 |
restartround |
restartround |
현재 라운드를 재시작 |
endround |
endround |
현재 라운드를 강제로 종료 |
setgamemode |
setgamemode <mode> |
활성 게임 모드를 변경 |
setmaxplayers |
setmaxplayers <count> |
런타임에 최대 플레이어 수를 변경 |
setpassword |
setpassword <password> |
런타임에 서버 비밀번호를 설정하거나 변경 (제거하려면 비워 둠) |
맵 로테이션
Ground Branch는 서버 구성을 통해 맵 로테이션을 지원합니다. 관리자는 미션 계획 화면이나 콘솔 명령을 통해 즉석에서 맵을 변경할 수도 있습니다.
맵 로테이션 구성하기
Server.ini 파일을 편집하고 로테이션 목록에 맵 항목을 추가하세요:
[/Script/GroundBranch.GBGameMode]
MapRotation=SmallTown
MapRotation=Tanker
MapRotation=PowerStation
MapRotation=City
MapRotation=Depot서버는 이 맵들을 순서대로 순환합니다. changemap 명령을 사용하여 언제든지 맵을 변경할 수 있습니다.
Steam Workshop 및 모드
Ground Branch는 커스텀 맵, 무기 스킨, 게임 모드 수정을 포함한 Steam Workshop 콘텐츠를 지원합니다.
Workshop 모드 설치하기
- Ground Branch Steam Workshop에서 원하는 Workshop 모드를 찾습니다.
- 모드의 URL에서 Workshop ID를 복사합니다. 예를 들어
https://steamcommunity.com/sharedfiles/filedetails/?id=123456789에서 ID는123456789입니다. - GPanel에서 Startup 탭으로 이동하여 적절한 workshop/mod 시작 변수에 Workshop ID를 추가하거나(사용 가능한 경우), 서버 구성 파일에 추가합니다.
- 서버를 재시작합니다. 모드는 다음 시작 시 자동으로 다운로드됩니다.
Workshop 맵
커스텀 Workshop 맵은 설치되면 맵 로테이션에 추가할 수 있습니다. 맵 이름은 Workshop 항목 이름과 일치합니다. 로테이션 구성에 사용할 정확한 맵 이름은 모드의 Workshop 페이지에서 확인하세요.
문제 해결
서버가 브라우저에 나타나지 않음
- 서버가 마스터 서버 목록에 등록될 때까지 시작 후 최소 2-3분을 기다리세요.
- GPanel의 콘솔 출력에서 오류 메시지를 확인하여 서버가 성공적으로 시작되었는지 확인하세요.
- 직접 IP를 통해 연결을 시도하여 서버가 실행 중인지 확인하세요.
플레이어가 접속할 수 없음
- GPanel에서 서버가 실행 중이고 완전히 시작되었는지 확인하세요.
- 비밀번호를 사용하는 경우 플레이어가 올바르게 입력하고 있는지 확인하세요.
- 서버가 최대 플레이어 제한에 도달하지 않았는지 확인하세요.
- 플레이어가 서버와 동일한 게임 버전을 실행하고 있는지 확인하세요.
서버 충돌
- GPanel 콘솔의 서버 로그에서 오류 세부 정보를 확인하세요.
- 모드를 추가한 후 충돌이 발생하면 모드를 제거하여 문제를 분리해 보세요.
- 구성 파일에 구문 오류가 없는지 확인하세요.
- 게임 업데이트 후에도 충돌이 계속되면 GPanel의 Reinstall 옵션을 통해 재설치를 시도하세요(먼저 구성을 백업하세요).
모드 관련 문제
- 모든 Workshop 모드가 최신 상태인지 확인하세요. 오래된 모드는 게임 업데이트 후 충돌이나 비호환성을 일으킬 수 있습니다.
- 한 번에 하나씩 모드를 제거하여 어느 것이 문제를 일으키는지 식별하세요.
- 모드의 Workshop 페이지에서 알려진 문제나 호환성 참고 사항을 확인하세요.
관련 문서
서버 관리에 추가 지원이 필요하면 지원 티켓을 열어주세요. 저희 팀이 도와드리겠습니다.
