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

# Información general del complemento GSDK de Unreal de PlayFab

> Información general del complemento GSDK de Unreal de PlayFab para integrar servidores de juego dedicados con PlayFab Multiplayer Servers mediante las API de Blueprint o C++.

# Cómo usar el complemento GSDK de PlayFab para Unreal

En este artículo se describe cómo integrar el complemento del subsistema en línea (OSS) de Unreal del SDK de servidor multijugador de PlayFab (GSDK) con su proyecto de Unreal.

Este complemento ofrece tanto una API de Blueprint como una API de C++. La API de Blueprint sigue requiriendo que su proyecto de Unreal sea un proyecto de C++ y no funcionará en un proyecto exclusivamente de Blueprint. Si actualmente es un proyecto solo de Blueprint, deberá convertirlo previamente en un proyecto de C++ antes de agregar el complemento.

Se probó originalmente con Unreal Engine 4.26, 4.27, 5.0 y 5.1. Este complemento se mantendrá activamente para funcionar con las 3 o 4 versiones más recientes de Unreal. Si algo falla usando estas versiones, abra una incidencia aquí: [Repositorio del GSDK de Unreal Engine](https://github.com/PlayFab/gsdk/issues).

Para usar estas guías, reemplace todas las apariciones de **ThirdPersonMP** por el nombre de su proyecto, si es diferente.

## Requisitos

* Descargue Visual Studio. La [versión Community](https://visualstudio.microsoft.com/vs/community/) es gratuita.
  * Cargas de trabajo necesarias: desarrollo de escritorio de .NET y desarrollo para el escritorio con C++
* Descargue el código fuente de Unreal Engine. Para obtener instrucciones, consulte [Descarga del código fuente de Unreal Engine (externo)](https://docs.unrealengine.com/ProgrammingAndScripting/ProgrammingWithCPP/DownloadingSourceCode/).
* Si aún no lo ha hecho, clone este repositorio con git en su máquina local
  * `git clone https://github.com/PlayFab/gsdk.git`
  * Los pasos posteriores implicarán integrar archivos de este repositorio en su proyecto
* \[Opcional] Descargue el [LocalMultiplayerAgent](https://github.com/PlayFab/MpsAgent/releases)
  * \[Opcional] Como alternativa, descargue el [código fuente de LocalMultiplayerAgent](https://github.com/PlayFab/MpsAgent/tree/main/LocalMultiplayerAgent).
* \[Opcional] [Complemento de PlayFab en el Marketplace](https://www.unrealengine.com/marketplace/product/playfab-sdk) o la [versión de código fuente en GitHub](https://github.com/PlayFab/UnrealMarketplacePlugin/tree/master/PlayFabPlugin/PlayFab). Este complemento no es necesario para el GSDK, pero sí lo es para muchos servicios de PlayFab, incluido el inicio de sesión.

## Creación del proyecto

El proyecto de servidor de Unreal debe ser un proyecto multijugador de Unreal habilitado para red con un modo de servidor dedicado. Si no tiene un proyecto que cumpla estos requisitos previos, siga nuestra [guía de configuración de requisitos previos de Unreal](/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/third-person-mp-example-project-setup) para configurar uno. Una vez que tenga un proyecto multijugador habilitado para red, con un servidor dedicado, vuelva a este paso y continúe.

Cuando esté listo, abra su proyecto de servidor multijugador de Unreal habilitado para red y continúe con el paso siguiente para instalar el GSDK de Unreal.

## Configuración del GSDK del proyecto

* Detalles de los requisitos previos del proyecto para el GSDK
  * Servidor dedicado:
    * Su proyecto debe tener un archivo \{ProjectName}Server.Target.cs independiente
    * Este archivo debe contener `Type = TargetType.Server;` para habilitar el modo de servidor dedicado
    * Cuando se compila en la configuración "development server" para Win64, la salida contiene \{ProjectName}Server.exe
  * Habilitado para red:
    * Hay varias formas de cumplir este requisito, pero la respuesta sencilla es: su cliente puede establecer una conexión de red con un servidor de juego en una máquina independiente y comunicarse de forma significativa
    * Nuestras instrucciones le guían a través del sistema de replicación de datos integrado de Unreal, que gestiona la mayor parte de este requisito por usted
    * Puede establecer esta conexión de forma más directa con un socket, por ejemplo mediante ISocketSubsystem, que es un tema mucho más avanzado
  * Multijugador:
    * Su servidor de juego puede aceptar varias conexiones de cliente entrantes y comunicarse correctamente con ambas
    * De nuevo, con la replicación de datos integrada de Unreal, este requisito queda cubierto en su mayor parte

Con un proyecto multijugador configurado correctamente, está listo para [instalar el GSDK](/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/third-person-mp-example-gsdk-project-setup). Este complemento permitirá que su servidor se ejecute en PlayFab Multiplayer Services.

## Configuraciones de compilación del proyecto de Unreal

Una vez que el GSDK esté instalado y configurado en su proyecto, puede [compilar su proyecto de Unreal](/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/building-the-third-person-mp-example-project). Hay varias configuraciones de compilación que necesitará para ejecutar la gama completa de pruebas en pasos futuros.

## Prueba de la implementación local del servidor

Una vez que tenga cualquier compilación de cliente y una compilación de "Development Server", puede [probar el proceso de implementación de MPS localmente](/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/third-person-mp-example-project-local-deployment-and-debugging) y verificar que su servidor funciona.

## Implementación en PlayFab

Ya está listo para crear servidores de juego en la nube mediante PlayFab Multiplayer Services. PlayFab MPS admite [servidores Windows](/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/third-person-mp-example-project-cloud-deployment) y [servidores Linux](/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/setting-up-a-linux-dedicated-server-on-playfab).

## Conexión al servidor implementado

Por último, está listo para [conectarse a su servidor implementado](/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/connect-to-mps-hosted-build).

## Agradecimientos

Gracias a [Stefan Krismann](https://github.com/stkrwork) por crear y enviar este complemento.

Gracias a [Nick Arthur](https://github.com/narthur157) por su increíble [Dockerfile](https://github.com/narthur157/playfab-gsdk-ue4).

Gracias a [Adam Rehn](https://github.com/adamrehn) por todo su trabajo con Unreal y Docker, incluidos código, ejemplos, muestras y tutoriales.


## Related topics

- [Información general del complemento GSDK de Unreal de PlayFab](/es/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/index.md)
- [Información general de PlayFab para Unreal Engine](/es/services/playfab/sdks/unified-unreal/overview.md)
- [Información general del complemento de Unity de PlayFab Multiplayer](/es/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/multiplayer-unity-overview.md)
- [Información general del complemento de Party para Unity](/es/services/playfab/multiplayer/networking/party-unity-overview.md)
- [Uso del GDK con Unreal Engine](/es/build/gdk-and-engines/unreal/unreal.md)
