Plugin para Unreal: instala y configura los componentes del plugin - Amazon GameLift

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Plugin para Unreal: instala y configura los componentes del plugin

En esta sección se describen las tareas de instalación iniciales para añadir el complemento a un proyecto de Unreal Engine. La funcionalidad del complemento está disponible cuando tiene el proyecto abierto en el editor de Unreal.

nota

Puedes usar el GameLift plugin Amazon con una versión estándar del editor UE, pero tendrás que usar una versión basada en el código fuente cuando empaques la compilación de tu servidor de juegos.

Antes de comenzar

Esto es lo que necesitas para usar el GameLift plugin de Amazon para Unreal Engine:

  • Paquete de lanzamiento GameLift del plugin de Amazon para Unreal Engine. [Sitio de descargas].

  • Microsoft Visual Studio 2019 o una versión posterior.

  • Una versión original del editor de Unreal Engine. Necesitará una versión original para empaquetar los componentes del servidor para un juego multijugador. Para obtener más información, incluidos los requisitos previos adicionales, consulte la documentación de Unreal Engine:

  • Un proyecto de juego multijugador con código de juego en C++. Si estás trabajando con un proyecto de Blueprint, consulta la documentación de Unreal sobre cómo generar código fuente en C++ para tu proyecto.

Cree el servidor Amazon GameLift C++ SDK

El paquete de lanzamiento del GameLift plugin de Amazon para Unreal Engine contiene el código fuente del servidor C++ SDK de Unreal. Antes de poder usarlo con el complemento, debes extraer el código fuente y compilarlo para tu entorno de desarrollo.

nota

Si estás creando servidores de juegos para que se ejecuten en un entorno de ejecución de Amazon Linux 2023, puedes aprovechar un script auxiliar, que está disponible como parte del repositorio de Amazon GameLift Toolkit. Use este script auxiliar para generar el SDK binario y las SSL bibliotecas que necesita para usar con el complemento. Puedes usar el script cuando estés desarrollando con Unreal Engine 5 en Windows o Linux. El script es una solución basada en Docker. Puede ejecutarlo localmente con get y docker instalados, o puede ejecutar el script utilizando AWS CloudShell el. AWS Management Console

Obtén más información sobre el script de GameLift compilación de Amazon para Unreal Engine 5.

Para compilar manualmente el servidor C++ SDK para Unreal
  1. Descomprime el paquete de lanzamiento del GameLift plugin Amazon para Unreal Engine para extraer dos archivos zip:

    • amazon-gamelift-plugin-unreal-<>-sdk-<>.zip

    • GameLift-Cpp-ServerSDK-<>.zip.

    Descomprime estos archivos.

  2. Abra la GameLift-Cpp-ServerSDK-<> carpeta y, a continuación, complete las siguientes instrucciones para su plataforma: Linux o Microsoft Windows.

Linux

  1. Ejecute los comandos siguientes:

    mkdir out cd out cmake -DBUILD_FOR_UNREAL=1 .. make

    Estos comandos crean el /lib/aws-cpp-sdk-gamelift-server.so archivo.

  2. Copie /lib/aws-cpp-sdk-gamelift-server.so al amazon-gamelift-plugin-unreal/GameLiftPlugin/Source/GameliftServer/ThirdParty/GameLiftServerSDK/Linux/x86_64-unknown-linux-gnu/ directorio.

Microsoft Windows

  1. Ejecute los comandos siguientes:

    mkdir out cd out cmake -G "Visual Studio 17 2022" -DBUILD_FOR_UNREAL=1 .. msbuild ALL_BUILD.vcxproj /p:Configuration=Release

    Estos comandos crean los siguientes archivos binarios.

    • prefix\bin\aws-cpp-sdk-gamelift-server.dll

    • prefix\lib\aws-cpp-sdk-gamelift-server.lib

  2. Copie los archivos al amazon-gamelift-plugin-unreal\GameLiftPlugin\Source\GameliftServer\ThirdParty\GameLiftServerSDK\Win64\ directorio.

Adición del complemento al proyecto de juego

Trabajando en el Unreal Editor con el proyecto de juego abierto, completa las siguientes tareas.

  1. Instale los archivos del complemento.

    1. Busque la carpeta raíz del proyecto del juego, por ejemplo ... > Unreal Projects/[project-name]/. Busca una Plugins carpeta. Si la carpeta no existe allí, créela.

    2. Descomprime el paquete de lanzamiento del plugin (amazon-gamelift-plugin-unreal-<>-sdk-<>.zip). Abre la amazon-gamelift-plugin-unreal carpeta y busca la GameLiftPlugin carpeta. Copia esta carpeta en la Plugins carpeta del paso 1.

  2. Añada el complemento al archivo .uproject.

    1. En la carpeta raíz del proyecto de juego, abra el archivo .uproject.

    2. Actualice el archivo para añadir "GameLiftPlugin" y "WebBrowserWidget" a la Plugins sección y habilítelos. El siguiente código muestra el .uproject archivo actualizado de un juego llamado "MyGame».

    UnrealProjects > MyGame > MyGame.uproject { ... "Plugins": [ { "Name": "ModelingToolsEditorMode", "Enabled": true, "TargetAllowList": [ "Editor" ] }, { "Name": "GameLiftPlugin", "Enabled": true }, { "Name": "WebBrowserWidget", "Enabled": true } ] }
  3. Cambie la versión del editor de UE para el proyecto.

    Si ha creado un proyecto para una versión del editor y ahora quiere cambiarlo a otra versión (por ejemplo, una versión original), debe actualizar el proyecto.

    En la carpeta raíz del proyecto de juego, seleccione el archivo .uproject y elija la opción Cambiar de versión de Unreal Engine. Seleccione una nueva versión del editor.

  4. Vuelva a compilar la solución del proyecto con sus actualizaciones.

    1. En la carpeta raíz del proyecto, busque un archivo de solución (*.sln). Si no existe ninguno, seleccione el archivo .uproject y elija la opción Generar archivos de proyecto de Visual Studio.

    2. Abra el archivo de la solución y cree o reconstruya el proyecto.

  5. Verifique que el complemento esté habilitado en el editor de UE.

    nota

    Si ya tiene el editor abierto, es posible que tenga que reiniciarlo para que reconozca el nuevo complemento.

    1. Abra el proyecto en el editor de UE que haya elegido.

    2. Consulta la barra de herramientas principal del editor para ver el nuevo botón de GameLift menú de Amazon [necesita imagen].

    3. Busca en el navegador de contenido los activos del GameLift plugin de Amazon. Asegúrese de que la configuración de las Opciones de visualización tenga seleccionada la opción Mostrar contenido del complemento.