> ## 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.

# Visão geral do plug-in PlayFab Unreal GSDK

> Visão geral do plug-in PlayFab Unreal GSDK para integrar servidores de jogo dedicados ao PlayFab Multiplayer Servers usando as APIs de Blueprint ou de C++.

# Como usar o plug-in PlayFab GSDK para Unreal

Este artigo descreve como integrar o plug-in Unreal Online Subsystem (OSS) do PlayFab Multiplayer Server SDK (GSDK) ao seu projeto do Unreal.

Este plug-in oferece uma API de Blueprint e uma API de C++. A API de Blueprint ainda exige que o seu projeto do Unreal seja um projeto C++ e não funcionará em um projeto somente Blueprint. Se atualmente ele for um projeto somente Blueprint, você precisará convertê-lo em um projeto C++ antes de adicionar o plug-in.

Ele foi testado originalmente com o Unreal Engine 4.26, 4.27, 5.0 e 5.1. Este plug-in será mantido ativamente para funcionar com as 3 a 4 versões mais recentes do Unreal. Se algo falhar ao usar essas versões, abra um problema aqui: [Repositório do Unreal Engine GSDK](https://github.com/PlayFab/gsdk/issues).

Para usar estes guias, substitua todas as ocorrências de **ThirdPersonMP** pelo nome do seu projeto, se for diferente.

## Requisitos

* Baixe o Visual Studio. A [versão Community](https://visualstudio.microsoft.com/vs/community/) é gratuita.
  * Cargas de trabalho necessárias: Desenvolvimento para desktop com .NET e Desenvolvimento para desktop com C++
* Baixe o código-fonte do Unreal Engine. Para obter instruções, consulte [Baixando o código-fonte do Unreal Engine (externo)](https://docs.unrealengine.com/ProgrammingAndScripting/ProgrammingWithCPP/DownloadingSourceCode/).
* Se ainda não fez isso, execute um git clone deste repositório no seu computador local
  * `git clone https://github.com/PlayFab/gsdk.git`
  * As etapas posteriores envolverão a integração de arquivos deste repositório ao seu projeto
* \[Opcional] Baixe o [LocalMultiplayerAgent](https://github.com/PlayFab/MpsAgent/releases)
  * \[Opcional] Como alternativa, baixe o [código-fonte do LocalMultiplayerAgent](https://github.com/PlayFab/MpsAgent/tree/main/LocalMultiplayerAgent).
* \[Opcional] [Plug-in do PlayFab no Marketplace](https://www.unrealengine.com/marketplace/product/playfab-sdk) ou a [versão de código-fonte no GitHub](https://github.com/PlayFab/UnrealMarketplacePlugin/tree/master/PlayFabPlugin/PlayFab). Esse plug-in não é necessário para o GSDK, mas é necessário para muitos serviços do PlayFab, incluindo o logon.

## Criação do projeto

O projeto de servidor do Unreal precisa ser um projeto multijogador do Unreal habilitado para rede, com um modo de servidor dedicado. Se você não tiver um projeto que atenda a esses pré-requisitos, siga nosso [guia de configuração de pré-requisitos do Unreal](/pt-BR/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/third-person-mp-example-project-setup) para configurar um. Depois de ter um projeto multijogador habilitado para rede, com um servidor dedicado, volte para esta etapa e continue.

Quando estiver pronto, abra seu projeto de servidor multijogador do Unreal habilitado para rede e continue para a próxima etapa para instalar o Unreal GSDK.

## Configuração do GSDK no projeto

* Detalhes dos pré-requisitos do projeto para o GSDK
  * Servidor dedicado:
    * Seu projeto deve ter um arquivo \{ProjectName}Server.Target.cs separado
    * Esse arquivo deve conter `Type = TargetType.Server;` para habilitar o modo de servidor dedicado
    * Quando criado na configuração "development server" para Win64, sua saída contém \{ProjectName}Server.exe
  * Habilitado para rede:
    * Há várias maneiras de atender a esse requisito, mas a resposta simples é: seu cliente pode estabelecer uma conexão de rede com um servidor de jogo em outro computador e se comunicar de forma significativa
    * Nossas instruções orientam você pelo sistema interno de replicação de dados do Unreal, que atende à maior parte desse requisito para você
    * Você pode estabelecer essa conexão de forma mais direta com um soquete, por exemplo, por meio do ISocketSubsystem, que é um tópico muito mais avançado
  * Multijogador:
    * Seu servidor de jogo pode aceitar várias conexões de clientes de entrada e se comunicar corretamente com ambas
    * Novamente, com a replicação de dados interna do Unreal, esse requisito é atendido em grande parte para você

Com um projeto multijogador configurado corretamente, você está pronto para [instalar o GSDK](/pt-BR/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/third-person-mp-example-gsdk-project-setup). Esse plug-in permitirá que seu servidor seja executado no PlayFab Multiplayer Services.

## Configurações de build do projeto do Unreal

Depois que o GSDK estiver instalado e configurado no seu projeto, você poderá [criar seu projeto do Unreal](/pt-BR/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/building-the-third-person-mp-example-project). Há várias configurações de build que você precisará para executar toda a gama de testes nas etapas futuras.

## Testar a implantação local do servidor

Depois de ter qualquer build de cliente e um build "Development Server", você poderá [testar localmente o processo de implantação do MPS](/pt-BR/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/third-person-mp-example-project-local-deployment-and-debugging) e verificar se o seu servidor funciona.

## Implantar no PlayFab

Agora você está pronto para criar servidores de jogo na nuvem usando o PlayFab Multiplayer Services. O PlayFab MPS oferece suporte a [servidores Windows](/pt-BR/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/third-person-mp-example-project-cloud-deployment) e [servidores Linux](/pt-BR/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/setting-up-a-linux-dedicated-server-on-playfab).

## Conectar-se ao servidor implantado

Por fim, você está pronto para [se conectar ao seu servidor implantado](/pt-BR/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/connect-to-mps-hosted-build).

## Agradecimentos

Agradecemos a [Stefan Krismann](https://github.com/stkrwork) por criar e enviar este plug-in.

Agradecemos a [Nick Arthur](https://github.com/narthur157) pelo incrível [Dockerfile](https://github.com/narthur157/playfab-gsdk-ue4).

Agradecemos a [Adam Rehn](https://github.com/adamrehn) por todo o seu trabalho com Unreal e Docker, incluindo código, exemplos, amostras e tutoriais.


## Related topics

- [Visão geral do PlayFab para Unreal Engine](/pt-BR/services/playfab/sdks/unified-unreal/overview.md)
- [Visão geral do plug-in PlayFab Multiplayer para Unity](/pt-BR/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/multiplayer-unity-overview.md)
- [Integrar o plug-in do PlayFab do Unreal Engine Marketplace](/pt-BR/services/playfab/multiplayer/networking/party-unreal-engine-oss-playfab-plugin-integration.md)
- [Início rápido da Unreal Engine](/pt-BR/services/playfab/sdks/unreal/quickstart.md)
- [Visão geral do Unreal Engine](/pt-BR/paths/unreal/overview.md)
