이 가이드는 Mount & Blade II: Bannerlord 전용 서버의 관리자 설정, 플레이어 관리, 서버 콘솔 명령어, 맵 순환 관리, 게임 모드 전환, 모딩 지원, 문제 해결을 다룹니다. 초기 서버 설정, 게임 모드 구성, 맵 선택, 진영 설정, 접속 안내에 대해서는 Mount and Blade II Bannerlord 서버 설정 가이드를 참조하세요.

1. 관리자 설정

관리자 비밀번호 설정

관리자 비밀번호는 GPanel의 ADMIN_PASSWORD 시작 변수를 통해, 또는 구성 파일에서 AdminPassword 명령어를 사용하여 설정합니다:

AdminPassword YourAdminPassword

이 비밀번호는 웹 관리자 인터페이스와 게임 내 관리자 접근 모두에 필요합니다.

웹 관리자 패널 접근

Bannerlord에는 DedicatedCustomServerHelper 모듈로 구동되는 내장 웹 관리자 패널이 포함되어 있습니다.

1. GPanel의 Network 탭에서 서버의 IP 주소와 포트를 찾습니다.
2. 웹 브라우저를 열고 다음 주소로 이동합니다:

   http://<your-server-ip>:<port>

   웹 패널은 게임 서버와 동일한 포트(기본 UDP 7210)에서 실행됩니다. 정확한 포트는 GPanel Network 탭에서 확인하세요.

3. 메시지가 표시되면 관리자 비밀번호를 입력합니다.

게임 내 관리자 접근

1. 일반 플레이어로 서버에 참여합니다.
2. Alt + ~ (물결표 키)로 게임 콘솔을 엽니다.
3. Help를 입력하여 사용 가능한 명령어를 확인합니다.
4. 메시지가 표시되면 게임 내 관리자 메뉴를 통해 관리자 비밀번호로 인증해야 할 수 있습니다.

2. 서버 콘솔 명령어

다음 명령어는 서버 콘솔(GPanel 콘솔) 또는 웹 관리자 패널에서 사용할 수 있습니다. 콘솔에 Help 또는 list를 입력하면 사용 가능한 모든 명령어를 볼 수 있습니다.

서버 관리 명령어

3. 플레이어 관리

플레이어 추방

서버에서 플레이어를 제거하려면:

• 웹 관리자: 웹 관리자 패널의 Players 섹션으로 이동하여 플레이어를 찾고 Kick을 클릭합니다.
• 채팅 명령어: 게임 내 채팅을 열고 다음을 입력합니다:

  !kick <playername>

추방된 플레이어는 차단하거나 서버 비밀번호를 설정하지 않는 한 즉시 다시 참여할 수 있습니다.

플레이어 차단

플레이어가 영구적으로 참여하지 못하게 하려면:

• 웹 관리자: 웹 관리자 패널의 Players 섹션에서 차단 옵션을 사용합니다.
• 채팅 명령어: 게임 내 채팅을 열고 다음을 입력합니다:

  !ban <playername>

차단은 서버 재시작 후에도 유지됩니다.

플레이어 차단 해제

차단을 해제하고 플레이어가 다시 참여할 수 있게 하려면:

!unban <playername>

플레이어 음소거

플레이어가 게임 내 채팅을 사용하지 못하게 하려면:

• 웹 관리자 패널의 음소거 옵션을 사용합니다.
• 음소거된 플레이어는 계속 플레이할 수 있지만 채팅 메시지를 보낼 수 없습니다.

4. 맵 순환 관리

현재 맵 변경

게임플레이 중 맵을 변경하려면 웹 관리자 패널을 사용하거나 구성 파일을 수정한 후 서버를 재시작하세요. 맵은 현재 게임 모드와 일치해야 합니다.

맵 순환 편집

맵 순환은 게임 모드 구성 파일에 정의되어 있습니다. 변경하려면:

1. GPanel에서 서버를 중지합니다.
2. 구성 파일을 엽니다 (예: Modules/Native/siege_config.txt).
3. add_map_to_automated_battle_pool 라인을 수정하여 맵을 추가하거나 제거합니다.
4. 자동 순환을 원하면 enable_automated_battle_switching이 있는지 확인합니다.
5. 저장하고 서버를 재시작합니다.

단일 맵 모드

순환 없이 단일 맵을 실행하려면, add_map_to_automated_battle_pool 라인을 하나만 포함하고 enable_automated_battle_switching을 생략하세요. 동일한 맵이 매 라운드 반복됩니다.

5. 게임 모드 전환

맵은 모드별로 다르기 때문에, 게임 모드를 변경하려면 GameType 설정과 맵 풀을 모두 업데이트해야 합니다.

1. GPanel에서 서버를 중지합니다.
2. 구성 파일을 열고 GameType 라인을 변경합니다:

   GameType Siege

3. add_map_to_automated_battle_pool 라인을 새 모드와 호환되는 맵으로 교체합니다. 맵 목록은 설정 가이드를 참조하세요.
4. 파일을 저장하고 서버를 시작합니다.

6. 모딩 지원

Bannerlord는 전용 서버에서 커스텀 모듈(모드)을 지원합니다. 모드는 새로운 맵, 게임 모드, 무기, 병종, 게임플레이 메커니즘을 추가할 수 있습니다.

모드 설치

1. GPanel에서 서버를 중지합니다.
2. SFTP를 통해 서버에 연결합니다. 안내는 SFTP를 통한 파일 업로드 방법을 참조하세요.
3. Modules/ 디렉터리로 이동합니다.
4. 모드 폴더를 Modules/에 업로드합니다. 각 모드는 SubModule.xml 파일이 있는 자체 디렉터리에 있어야 합니다.
5. 모듈 목록에 모드를 포함하도록 서버의 시작 명령 또는 배치 파일을 업데이트합니다. 시작 구성의 _MODULES_ 매개변수는 모든 활성 모듈을 참조해야 합니다:

   Native*Multiplayer*DedicatedCustomServerHelper*YourModName

   모듈은 별표(*)로 구분됩니다. 로드 순서가 중요합니다 -- 의존 모드는 선행 모드 뒤에 배치하세요.

6. 서버를 시작합니다.

Steam Workshop 모드

Bannerlord는 모드 배포를 위해 Steam Workshop을 지원합니다. 전용 서버에 Workshop 모드를 설치하려면:

1. 일반 Bannerlord 설치본에서 Steam Workshop의 모드를 구독합니다.
2. 로컬 Bannerlord 설치본의 Modules/ 디렉터리에서 다운로드된 모드 폴더를 찾습니다.
3. SFTP를 통해 모드 폴더를 전용 서버의 Modules/ 디렉터리에 업로드합니다.
4. 시작 모듈 목록에 모듈 이름을 추가합니다.

DedicatedCustomServerHelper 모듈

이 내장 모듈은 웹 관리자 패널을 제공합니다. 항상 모듈 목록에 포함되어야 합니다. 게임 업데이트 후 버전 불일치 오류가 발생하면:

1. 서버를 중지합니다.
2. Modules/DedicatedCustomServerHelper/로 이동합니다.
3. SubModule.xml을 엽니다.
4. Version 값을 현재 게임 버전과 일치하도록 업데이트합니다.
5. 모든 DependedModule 버전 값도 그에 맞게 업데이트합니다.
6. 저장하고 서버를 재시작합니다.

7. 문제 해결

시작 시 서버 충돌

• 콘솔 출력에서 오류 메시지를 확인하세요. 일반적인 원인은 다음과 같습니다:
  • 누락되거나 만료된 인증 토큰 -- 토큰 오류가 보이면 지원팀에 문의하세요.
  • 잘못된 AdminPassword 구성 -- AdminPassword 라인이 존재하고 값이 있는지 확인하세요.
  • 잘못된 형식의 구성 파일 구문 -- 각 명령어는 후행 문자 없이 자체 라인에 있어야 합니다.
  • 게임 업데이트 후 모듈 버전 불일치 -- SubModule.xml 버전 번호를 업데이트하세요.
• 모든 커스텀 모드를 제거하고 기본 모듈(Native*Multiplayer*DedicatedCustomServerHelper)만으로 실행해 보세요.
• 구성 문제를 배제하기 위해 구성 파일을 삭제하고 서버가 기본값을 재생성하도록 하세요.

플레이어가 접속할 수 없음

• GPanel에서 서버가 실행 중인지 확인하세요.
• 플레이어가 GPanel Network 탭의 올바른 IP와 포트를 사용하고 있는지 확인하세요.
• 게임 비밀번호가 올바른지 확인하세요(대소문자 구분).
• 플레이어가 동일한 게임 버전과 모드를 설치했는지 확인하세요.
• 모드를 사용하는 경우, 플레이어가 정확히 동일한 모듈 버전을 가지고 있는지 확인하세요.
• 특정 원인을 나타낼 수 있는 "player rejected" 메시지가 콘솔에 있는지 확인하세요.

서버가 브라우저에 나타나지 않음

• 서버가 완전히 시작되었고 콘솔에 접속을 받고 있다고 표시되는지 확인하세요.
• 구성 파일에 start_game 또는 start_game_and_mission이 포함되어 있는지 확인하세요 -- 이것이 없으면 서버가 마스터 서버 목록에 등록되지 않습니다.
• 서버 브라우저는 업데이트되는 데 몇 분이 걸릴 수 있습니다. 기다리는 동안 직접 접속을 시도하세요.
• 인증 토큰이 만료된 경우, 서버는 시작되지만 브라우저에 나타나지 않을 수 있습니다. 토큰 갱신을 위해 지원팀에 문의하세요.

모드 충돌

• 모드를 추가한 후 서버가 충돌하면, 해당 모드를 제거하고 다시 테스트하여 원인인지 확인하세요.
• 모드의 SubModule.xml이 올바른 의존성을 나열하고 있으며 모듈 목록의 로드 순서가 올바른지 확인하세요.
• 모드가 현재 버전의 Bannerlord와 호환되는지 확인하세요. 구버전의 모드는 충돌을 일으킬 수 있습니다.
• 일부 모드는 서로 충돌합니다. 알려진 비호환성에 대해서는 모드 문서와 커뮤니티 포럼을 확인하세요.
• 모드 변경 후 그래픽 문제나 로딩 오류가 발생하면 서버의 셰이더 캐시와 임시 파일을 정리하세요.

플레이어 디싱크

• 디싱크는 플레이어의 게임 상태가 서버와 어긋날 때 발생합니다. 증상으로는 플레이어가 순간이동하는 것처럼 보이거나, 타격이 적용되지 않거나, 고무줄 현상(rubber-banding)이 있습니다.
• 가장 흔한 원인은 높은 지연 시간입니다. 영향을 받는 플레이어에게 인터넷 연결을 확인하도록 권장하세요.
• 게임플레이 메커니즘(이동 속도, 물리, 무기 스탯)을 수정하는 모드는 디싱크를 일으킬 가능성이 더 높습니다.
• 디싱크가 광범위하게 발생하면, MaxNumberOfPlayers를 줄이거나 더 가벼운 게임 모드(Siege 대신 Duel 또는 Skirmish)로 전환해 보세요.
• 서버를 재시작하면 지속적인 디싱크 문제를 해결할 수 있습니다.

인증 토큰 문제

• Bannerlord는 전용 서버를 실행하기 위해 유효한 인증 토큰이 필요합니다. 토큰은 약 3개월 후에 만료됩니다.
• 콘솔에 토큰 관련 오류가 보이면, 토큰을 갱신해야 할 가능성이 높습니다.
• 서버의 인증 토큰을 갱신하려면 지원 티켓을 열어 주세요.

8. 로그 파일

Bannerlord 서버 로그는 충돌, 접속 문제, 플레이어 활동을 진단하는 데 유용합니다.

• 로그 파일은 서버의 로그 디렉터리에 저장되며, 일반적으로 GPanel의 Files 탭이나 SFTP를 통해 접근할 수 있습니다.
• 콘솔 출력만으로 충분하지 않을 때 자세한 오류 메시지는 로그 파일을 확인하세요.
• 더 빠른 해결을 위해 지원 티켓을 열 때 관련 로그 발췌를 포함하세요.

관련 문서

• Mount and Blade II Bannerlord 서버 설정 가이드
• 서버 IP 및 포트 찾는 방법
• SFTP를 통한 파일 업로드 방법
• 서버 시작 가이드

도움이 필요하신가요?

여기서 다루지 않은 Bannerlord 서버 관련 문제가 발생하면, 지원 티켓을 열고 서버 IP, 실행 중인 게임 모드, 설치된 모든 모드, GPanel 콘솔이나 로그 파일의 관련 오류 메시지를 포함하세요.