> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PlayFab Online Subsystem (OSS) Dedicated Server Setup

> Party 통합 및 서버 측 구성을 포함하여 Unreal Engine에서 PlayFab Online Subsystem(OSS)을 사용하여 전용 서버를 설정하는 단계입니다.

# 빠른 시작 가이드: PlayFab Online Subsystem으로 전용 서버 설정

이 가이드는 PlayFab Online Subsystem(OSS)이 통합된 게임을 준비하고 전용 서버 시나리오에서 검증하는 데 도움이 됩니다. 이 가이드는 로컬로 호스팅된 전용 서버로의 검증에 초점을 맞춥니다.

PlayFab OSS는 플레이어 호스팅 시나리오에서 통신에 PlayFab Party Sockets 사용을 기본으로 합니다. 그러나 서버 호스팅 시나리오에서는 PlayFab Party Sockets가 연결에 실패하며, 게임은 서버와 통신하기 위해 명시적으로 `ISocketSubsystem::Get(PLATFORM_SOCKETSUBSYSTEM)`을 호출해야 합니다.

PlayFab OSS는 클라이언트가 전용 서버에 연결하고 있음을 인식하고 클라이언트에서 서버로의 통신을 위해 네이티브 `PLATFORM_SOCKETSUBSYSTEM` 사용으로 대체합니다.

## 사전 요구 사항

* [PlayFab Online Subsystem](/services/playfab/multiplayer/networking/party-unreal-engine-oss-overview)을 통합했으며 클라이언트 호스팅 시나리오를 만들 수 있는 게임.
* 게임의 연결 클라이언트로 사용할 수 있는 “클라이언트” PC.
* 게임의 호스팅 서버로 사용할 수 있는 “서버” PC.
  * 두 번째 PC를 권장하지만, 원하는 경우 동일한 PC, 가상 머신 인스턴스 또는 Docker 인스턴스를 사용할 수 있습니다. 이 빠른 시작 가이드는 두 번째 PC로 설정하는 방법을 안내합니다.
  * 두 번째 PC의 IP 주소가 첫 번째 PC에서 네트워크로 액세스할 수 있는지 확인하세요.

## 설정

### Unreal Engine (UE) 5용 전용 서버 설정

UE 5 [전용 서버 가이드](https://docs.unrealengine.com/5.3/en-US/setting-up-dedicated-servers-in-unreal-engine/)는 UE의 Lyra Game을 기본 예제로 사용하여 게임을 전용 서버로 패키징하는 방법을 안내합니다.

### Unreal Engine (UE) 4용 전용 서버 설정

UE 4 [전용 서버 가이드](https://docs.unrealengine.com/4.27/en-US/InteractiveExperiences/Networking/HowTo/DedicatedServers/)는 UE의 Shooter Game을 기본 예제로 사용하여 게임을 전용 서버로 패키징하는 방법을 안내합니다.

### 추가 설정

* 게임의 `<Game>Server.Target.cs`를 구성한 후에는 게임의 `WindowsClient` 및 `WindowsServer` 플레이버에 대한 바이너리를 생성할 수 있는지 확인합니다.
* `<Game>Server.exe` 바이너리를 `Binaries/Win64/`에서 두 번째 PC의 원하는 위치로 이동합니다.

## 연결

### 서버 배포

1. `<Game>Server.exe`가 있는 디렉터리에서 두 번째 PC의 터미널을 엽니다.

```ps theme={null}
PS  C:\WindowsServer\ >
```

2. 전용 서버를 시작합니다.

```ps theme={null}
PS  C:\WindowsServer\ > .\<Game>Server.exe <map> -log –NOSTEAM
```

* `-NOSTEAM` 인수는 게임의 기본 OSS(이 경우 OSS PlayFab)를 비활성화하고 이를 `OnlineSubsystemNull`로 대체합니다. 기본 온라인 서브시스템을 비활성화하면 전용 서버가 일관되게 올바른 서브시스템을 사용합니다.
* `-log` 인수는 별도의 창을 열어 로그의 내용을 실시간으로 표시합니다.
* UE의 CLI 인수에 대한 자세한 내용은 [Unreal Engine's Command Line Arguments](https://docs.unrealengine.com/4.27/en-US/ProductionPipelines/CommandLineArguments/) 문서를 방문하세요.

서버가 생성되었음을 확인하는 UE 로그가 있는 별도의 창이 나타납니다. 로그에 다음 줄이 포함되어 있는지 확인하세요.

```log theme={null}
LogOnline: Warning: PLAYFAB: PlayFab API disabled!
LogOnline: Display: PLAYFAB: OnlineSubsystemPlayFab::Shutdown()
LogOnline: Verbose: PLAYFAB: FOnlineSubsystemPlayFab::CleanUpPlayFab PartyInitialized 0, LobbyInitialized 0
LogOnline: Verbose: PLAYFAB: FOnlineSubsystemPlayFab::UnregisterNetworkInitCallbacks
```

이러한 로그는 OSS PlayFab이 전용 서버에서 올바르게 비활성화되었음을 나타냅니다.

### 클라이언트 연결

1. `<Game>Client.exe`가 있는 디렉터리에서 첫 번째 PC의 터미널을 엽니다.

```ps theme={null}
PS  C:\WindowsClient\ >
```

2. 게임 클라이언트를 시작합니다.

```ps theme={null}
PS C:\WindowsClient\ > .\<Game>Client.exe <ipaddress_of_server_machine>:7777 -log
```

* 전용 서버의 기본 포트는 일반적으로 7777입니다. 연결 오류가 발생하면 서버가 올바른 포트에 배포되고 있는지 확인하거나 연결 명령을 해당 포트와 일치하도록 변경하세요.

게임 클라이언트가 나타나서 서버에서 시작된 게임에 연결됩니다. 클라이언트가 참가했음을 나타내는 로그가 전용 서버의 로그 창에 표시되어야 합니다.


## Related topics

- [PlayFab Online Subsystem (OSS)](/ko/services/playfab/multiplayer/networking/party-unreal-engine-oss-overview.md)
- [PlayFab Online Subsystem (OSS) Quickstart](/ko/services/playfab/multiplayer/networking/party-unreal-engine-oss-quickstart.md)
- [Unreal Engine용 PlayFab OnlineSubsystem 릴리스 노트](/ko/services/playfab/multiplayer/networking/unreal-release-notes.md)
- [PlayFab for Unreal Engine 개요](/ko/services/playfab/sdks/unified-unreal/overview.md)
- [Integrate the PlayFab Unreal Engine Marketplace plugin](/ko/services/playfab/multiplayer/networking/party-unreal-engine-oss-playfab-plugin-integration.md)