​

ThirdPersonMP 예제 프로젝트 로컬 배포 및 디버깅

​

목표

• ThirdPersonMP+GSDK 프로젝트의 로컬 배포 옵션을 테스트합니다.
• LocalMultiplayerAgent를 사용하여 실행 시 서버가 제대로 실행되는지 확인합니다.
• 서버 인스턴스에 디버거를 연결할 수 있는지 확인합니다.

​

요구 사항

• Visual Studio를 다운로드합니다. Community 버전은 무료입니다.
  • 필수 워크로드: .NET 데스크톱 개발 및 C++를 사용한 데스크톱 개발
• Unreal Engine 소스 코드를 다운로드합니다. 자세한 내용은 Downloading Unreal Engine Source code (외부)를 참조하세요.
• PlayFab Unreal GSDK가 설치되고 구성된 완료된 Unreal 프로젝트
• Visual Studio에서 빌드된 프로젝트의 “Development Server” 구성
• [선택 사항] LocalMultiplayerAgent 다운로드
  • [선택 사항] 또는 LocalMultiplayerAgent 소스를 다운로드하세요.
• Visual Studio를 사용하여 이 리포지토리에서 빌드된 LocalMultiplayerAgent의 “Debug” 또는 “Release” 구성
  • Visual Studio를 사용하여 MpsAgent.sln을 열고 Debug 또는 Release 구성을 선택한 다음 LocalMultiplayerAgent를 빌드합니다.
• [선택 사항] Docker for Windows 설치

​

표기법

• {depot}/ThirdPersonMP
• {depot}/MpsAgent
• [선택 사항] {depot}/gsdk [이는 이전에 ThirdPersonMP에 설치된 PlayFab Unreal GSDK 플러그인을 포함합니다]
• [선택 사항] {depot}/UnrealMarketplacePlugin [이는 이 가이드에 필요하지 않지만 대부분의 PlayFab 기능에 필요한 PlayFab Unreal Marketplace 플러그인을 포함합니다]

​

지침

​

로컬 실행, 컨테이너 없음

{
  "RunContainer": false,
  "OutputFolder": "<Local absolute path that will be used to store the required output artifacts>",
  ...
  "AssetDetails": [
    {
      "MountPath": "C:\\Assets",
      "LocalFilePath": "{PATH-TO-ZIP}"
    }
  ],
  ...
  "PortMappingsList": [
    [
      {
        "NodePort": 30000,
        "GamePort": {
          "Name": "gameport",
          "Number": 8888,
          "Protocol": "UDP"
        }
      }
    ]
  ],
  "ProcessStartParameters": {
    "StartGameCommand": "{PATH-TO-EXE} -log"
  },
  "ContainerStartParameters": {
    "StartGameCommand": "C:\\Assets\\ThirdPersonMPServer.exe -log",
    ...
  }
}

• RunContainer: 이 가이드에서는 항상 false입니다. 이를 true로 설정하려면 Docker가 필요합니다.
  • true인 경우 ProcessStartParameters/StartGameCommand는 무시되고 대신 ContainerStartParameters/StartGameCommand가 사용됩니다.
  • true인 경우 모든 것이 로컬 컴퓨터 컨텍스트가 아닌 docker 컨테이너에서 빌드되고 실행됩니다.
  • 이 가이드는 서버 프로세스를 더 쉽게 디버깅할 수 있도록 RunContainer가 false인 시나리오를 다룹니다.
  • 이를 true로 설정하려면 Shipping Server 빌드, 추가 Docker for Windows가 필요합니다.
• OutputFolder: "<Local absolute path that will be used to store the required output artifacts>"
  • 이 위치는 완전히 정의되어야 하며 유효한 디렉터리가 이 위치에 있어야 합니다.
• AssetDetails/LocalFilePath: {PATH-TO-ZIP}
  • 이 위치는 완전히 정의되어야 하며 이 위치에 유효한 zip 파일이 있어야 합니다.
  • 이 zip 파일에는 완전히 구성된 “Shipping Server” 빌드가 포함되어야 합니다.
• PortMappingsList:
  • 이는 Game Manager에서 포트를 정의하는 LocalMultiplayerAgent 동등물입니다.
  • GSDK 플러그인은 gameport라는 이름의 포트를 찾도록 하드 코딩되어 있습니다.
  • GSDK 플러그인 SetDefaultServerHostPort 메서드는 이 포트에 맞게 내부 Unreal 서버 호스팅 포트를 내부적으로 재정의합니다.
  • GSDK 플러그인은 LocalMultiplayerAgent를 사용할 때 PortMappingsList에 구성된 gameport라는 이름의 포트만 사용합니다.
  • 이 json을 사용하면 MPS에서 이 포트 번호를 로컬로 테스트하고 GSDK 플러그인이 제대로 수신하도록 할 수 있습니다.
• ContainerStartParameters/StartGameCommand: RunContainer가 false인 동안에는 사용되지 않습니다.
  • RunContainer==true인 경우 ProcessStartParameters/StartGameCommand를 대체합니다.
  • 이 경로는 docker 컨테이너 내의 내부 경로이며, AssetDetails/MountPath와 AssetDetails/LocalFilePath로 정의된 zip 파일 내부의 내부 경로-to-exe의 합이 됩니다.
  • 이 예제에서는 다음이 될 수 있습니다: C:\\Assets\\ThirdPersonMPServer.exe -log
• ProcessStartParameters/StartGameCommand: 이 명령은 사실상 exe에 대한 경로와 게임 서버를 시작하는 데 사용되는 명령줄 매개 변수가 됩니다.
  • -log는 게임 서버가 실행 로그를 저장하도록 지시하는 Unreal 명령입니다.
  • {PATH-TO-EXE}는 두 가지 선택 중 하나가 될 수 있습니다:
    • 게임 서버(development 게임 서버 포함)에 대한 exe의 절대 경로와 서버에 대한 명령줄 매개 변수
      • 이 선택은 zip 파일의 내용을 무시하고 대신 어느 위치에서든 임의의 exe를 실행합니다.
      • 이는 development 빌드를 디버깅하기 위해 로컬 컴퓨터에서만 작동하는 로컬 디버그 옵션입니다: zip 파일이 MPS에 업로드할 준비가 되었는지 확인하는 데 도움이 되지 않습니다.
      • 이 선택은 VS 디버거를 연결하는 데 적합한 development 서버를 테스트할 때 사용해야 합니다.
      • 이 예제에서는 다음이 될 수 있습니다: {depot}\\ThirdPersonMP\\Binaries\\Win64\\ThirdPersonMPServer.exe -log
      • 저자의 경우 이는 다음과 같습니다: M:\\depot\\GSDK\\ThirdPersonMPGSDK\\Binaries\\Win64\\ThirdPersonMPServer.exe -log
    • 서버를 실행하기 위해 zip 파일의 상대 경로를 나타내는 상대 경로
      • 이는 MPS 클라우드 인스턴스에서 작동하는 방식을 반영하는 표준 워크플로입니다.
      • 이 선택은 shipping 서버를 테스트할 때 사용해야 하며 zip이 MPS에 업로드할 준비가 되었는지 확인하는 데 도움이 됩니다.
      • 이 예제에서는 다음이 될 수 있습니다: ThirdPersonMPServer.exe -log

​

서버 디버깅

​

문제 해결

​

Task Manager에 ThirdPersonMPServer 인스턴스가 여러 개

​

LocalMultiplayerAgent가 ThirdPersonMPServer 인스턴스 두 개를 시작

​

다음 단계