기술 자료

지원

Multiplay Hosting for the Unreal Engine

Multiplay Hosting overview

Multiplay Hosting for the Unreal Engine

블루프린트 연동

Learn how to integrate Multiplay Hosting with Unreal Engine Blueprints.
읽는 시간 2분최근 업데이트: 10일 전
Unreal Engine의 블루프린트 비주얼 스크립팅 시스템을 사용하여 Multiplay Game Server SDK에 연동하는 방법에 대해 알아봅니다. Multiplay Game Server SDK는 다음 인터페이스와 상호 작용할 수 있습니다.

Multiplay Game Server SDK 플러그인 설치

계속하려면 Multiplay Game Server SDK 플러그인이 올바르게 설치되어 있어야 합니다.

Multiplay 서버 구성 시스템의 보조 시스템

이 보조 시스템에는 현재 세션의 서버 구성이 들어 있습니다. 이 보조 시스템은 초기화 시 
server.json
파일에서 서버 설정 정보를 가져옵니다. MultiplayServerConfigSubsystem 노드를 배치하고 Server Config 변수에 액세스하여 서버 구성을 가져올 수 있습니다. Server Config에는 다음 값이 있습니다.
  • 서버 ID
  • 할당 ID
  • 서버 쿼리 프로토콜 포트
  • 세션의 연결 포트
  • 게임 서버가 로그 파일을 저장하는 디렉토리

Multiplay 게임 서버 시스템의 보조 시스템

Multiplay 게임 서버 시스템의 보조 시스템을 통해 게임 서버가 할당되거나 게임 서버가 플레이어를 받을 준비가 완료되는 등의 게임 서버 이벤트를 구독하고 해당 이벤트에 응답할 수 있습니다. 게임 서버 라이프사이클과 서버 준비를 참고하십시오. MultiplayGameServerSubsystem의 인스턴스를 사용하여 다음 블루프린트로 Multiplay 게임 서버 시스템의 보조 시스템과 상호 작용합니다.

SubscribeToServerEvents

MultiplayGameServerSubsystem의 인스턴스를 확보하면 Subscribe 블루프린트를 사용하여 OnAllocate, ReadyServerForPlayers, UnreadyServer, OnDeallocate와 같은 Multiplay 이벤트를 구독할 수 있습니다.
이벤트를 구독한 후에 게임 서버는 할당될 때까지 대기해야 합니다. OnAllocate 블루프린트를 사용하면 게임 서버에서 서버가 할당된 시점을 알 수 있습니다.

OnAllocate

이 블루프린트를 사용하면 게임 에셋을 불러오고 ReadyServerForPlayers로 Backfill을 시작하는 등 플레이어가 게임 매치를 위해 게임 서버에 참여하기 전에 필요한 설정 로직을 수행할 수 있습니다.
플레이어가 게임 서버에 참여할 수 있도록 필요한 설정 로직을 수행하고 나면 ReadyServerForPlayers 블루프린트를 통해 게임 서버가 플레이어를 받을 준비가 되었다고 Multiplay에 알릴 수 있습니다.

ReadyServerForPlayers

이 블루프린트를 사용하여 게임 서버가 게임 매치를 위해 플레이어를 받을 준비가 되었다고 Multiplay에 알립니다.
언제든지 더 이상 새 플레이어를 받지 않기 위해 게임 매치의 상태가 변경되면, UnreadyServer 블루프린트를 사용해 게임 서버가 더 이상 플레이어를 받을 수 없다고 Multiplay에 알립니다.

UnreadyServer

이 블루프린트를 사용하여 게임 서버가 더 이상 플레이어를 받을 수 없다고 Multiplay에 알립니다. 다음과 같은 시나리오에서 UnreadyServer 블루프린트를 사용할 수 있습니다.
  • 게임 매치가 거의 끝난 경우
  • 게임 매치가 끝난 경우
  • 게임 서버가 가득 찬 경우

OnDeallocate

이 블루프린트를 사용하여 Multiplay가 게임 서버를 할당 해제하는 시점을 알 수 있습니다. OnDeallocate 블루프린트를 활용하면 게임 서버가 종료되기 전에 필요한 마지막 클린업 또는 저장 작업을 수행할 수 있습니다.

Multiplay 서버 쿼리 핸들러 시스템의 보조 시스템

Multiplay 서버 쿼리 핸들러 시스템의 보조 시스템을 통해 게임 서버 쿼리 프로토콜이 모니터링하는 게임 서버 변수를 설정할 수 있습니다. 이 구현은 SQP를 사용합니다. 서버 쿼리 프로토콜을 참고하십시오. 
UMultiplayServerCheckSubsystem
을 사용하여 다음을 수행할 수 있습니다.

설정 블루프린트

다음 설정 블루프린트를 사용하여 게임 서버의 쿼리 값을 설정합니다. SetCurrentPlayers, SetMaxPlayers, SetServerName, SetGameType, SetBuildId, SetMap, SetPort 등의 설정 블루프린트가 있습니다.

SetCurrentPlayers

이 블루프린트를 사용하여 게임 서버에 연결된 플레이어 수를 설정합니다.

SetMaxPlayers

이 블루프린트를 사용하여 게임 서버에 연결할 수 있는 최대 플레이어 수를 설정합니다.

SetServerName

이 블루프린트를 사용하여 게임 서버의 현재 이름을 설정합니다.

SetGameType

이 블루프린트를 사용하여 게임 서버가 실행 중인 게임 유형을 설정합니다.

SetBuildId

이 블루프린트를 사용하여 게임 서버의 현재 빌드 ID를 설정합니다.

SetMap

이 블루프린트를 사용하여 게임 서버의 현재 맵을 설정합니다.

SetPort

이 블루프린트를 사용하여 게임 서버의 포트 번호를 설정합니다.
게임이 진행되면서 이 값이 계속 변경되므로 지속적으로 값을 업데이트해야 합니다. 그래야 서버가 실행 중인 동안 Multiplay가 데이터를 수집하고 표시할 수 있습니다. 모든 값을 설정하면 Connect 블루프린트를 추가할 수 있습니다.

Connect 블루프린트

이 블루프린트를 사용하여 게임 서버와의 연결을 구축합니다. 액세서 블루프린트를 사용하려면 먼저 게임 서버와의 연결을 구축해야 합니다.

액세서 블루프린트

이 블루프린트를 사용하여 설정한 값에 액세스합니다. 이러한 액세서 블루프린트에는 GetCurrentPlayers, GetMaxPlayers, GetServerName, GetGameType, GetBuildId, GetMap, GetPort 등이 있습니다.

GetCurrentPlayers

이 블루프린트를 사용하여 게임 서버에 연결된 현재 플레이어 수를 가져옵니다.

GetMaxPlayers

이 메서드를 사용하여 게임 서버에 연결할 수 있는 최대 플레이어 수를 가져옵니다.

GetServerName

이 블루프린트를 사용하여 게임 서버의 현재 이름을 가져옵니다.

GetGameType

이 블루프린트를 사용하여 게임 서버가 실행 중인 게임 유형을 가져옵니다.

GetBuildId

이 블루프린트를 사용하여 게임 서버가 실행 중인 빌드 ID를 가져옵니다.

GetMap

이 블루프린트를 사용하여 게임 서버의 현재 맵을 가져옵니다.

GetPort

이 블루프린트를 사용하여 게임 서버의 현재 포트를 가져옵니다.

Disconnect 블루프린트

이 블루프린트를 사용하여 게임 서버를 종료하기 전에 연결을 해제합니다.