Pular para o conteúdo principal

Guia de início rápido: configuração de servidor dedicado com o PlayFab Online Subsystem

Este guia tem como objetivo ajudar você a preparar seu jogo integrado ao PlayFab Online Subsystem (OSS) e validá-lo em cenários de servidor dedicado. Este guia se concentra na validação com servidores dedicados hospedados localmente. Por padrão, o PlayFab OSS usa os PlayFab Party Sockets para a comunicação em cenários hospedados por jogadores. No entanto, em cenários hospedados em servidor, os PlayFab Party Sockets não conseguirão se conectar, e o jogo precisará chamar explicitamente ISocketSubsystem::Get(PLATFORM_SOCKETSUBSYSTEM) para se comunicar com o servidor. O PlayFab OSS reconhece quando um cliente está se conectando a um servidor dedicado e passa a usar o PLATFORM_SOCKETSUBSYSTEM nativo para a comunicação entre cliente e servidor.

Pré-requisitos

  • Um jogo que tenha integrado o PlayFab Online Subsystem e consiga criar cenários hospedados por clientes.
  • Um PC “cliente” que você possa usar como cliente de conexão para o seu jogo.
  • Um PC “servidor” que você possa usar como servidor de hospedagem para o seu jogo.
    • Um segundo PC é recomendado, mas você pode usar o mesmo, uma instância de máquina virtual ou uma instância do Docker, se preferir. Este guia de início rápido orienta você pela configuração com um segundo PC.
    • Verifique se o endereço IP do seu segundo PC está acessível pela rede a partir do primeiro PC.

Configuração

Configuração de servidor dedicado para o Unreal Engine (UE) 5

O Guia de servidor dedicado do UE 5 mostra como empacotar seu jogo como um servidor dedicado, usando o Lyra Game do UE como exemplo principal.

Configuração de servidor dedicado para o Unreal Engine (UE) 4

O Guia de servidor dedicado do UE 4 mostra como empacotar seu jogo como um servidor dedicado, usando o Shooter Game do UE como exemplo principal.

Configuração adicional

  • Depois de configurar o <Game>Server.Target.cs do seu jogo, verifique se você consegue gerar binários para as variantes WindowsClient e WindowsServer do seu jogo.
  • Mova o binário <Game>Server.exe de Binaries/Win64/ para qualquer local no seu segundo PC.

Conexão

Implantando o servidor

  1. Abra um terminal no segundo PC, no diretório em que o <Game>Server.exe está localizado.
  1. Inicie seu servidor dedicado.
  • O argumento -NOSTEAM desabilita o OSS padrão do jogo (neste caso, o OSS PlayFab) e o substitui por OnlineSubsystemNull. Desabilitar o subsistema online padrão garante que o servidor dedicado use consistentemente o subsistema correto.
  • O argumento -log abre uma janela separada para exibir o conteúdo dos logs em tempo real.
  • Para obter mais informações sobre os argumentos de CLI do UE, visite a documentação de Argumentos de linha de comando do Unreal Engine.
Uma janela separada aparecerá com logs do UE confirmando que um servidor foi gerado. Verifique se os logs contêm estas linhas:
Esses logs indicam que o OSS PlayFab está corretamente desabilitado no servidor dedicado.

Conectando o cliente

  1. Abra um terminal no primeiro PC, no diretório em que o <Game>Client.exe está localizado.
  1. Inicie o cliente do seu jogo.
  • A porta padrão de um servidor dedicado geralmente é 7777. Se você encontrar erros de conexão, verifique se o servidor está sendo implantado na porta correta ou altere o comando de conexão para corresponder a essa porta.
Um cliente de jogo aparecerá e se conectará ao jogo iniciado no servidor. Você deverá ver logs na janela de log do servidor dedicado indicando que um cliente ingressou.
Última modificação em 8 de outubro de 2026