Plugin pour Unreal : installer et configurer les composants du plugin - Amazon GameLift
Avant de commencerCréation du serveur Amazon GameLift C++ SDKAjoutez le plugin à votre projet de jeu

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Plugin pour Unreal : installer et configurer les composants du plugin

Cette section décrit les tâches d'installation initiales pour ajouter le plugin à un projet Unreal Engine. La fonctionnalité du plugin est disponible lorsque le projet est ouvert dans l'éditeur Unreal.

Note

Vous pouvez utiliser le GameLift plugin Amazon avec une version standard de l'éditeur UE, mais vous devez utiliser une version créée par le code source lorsque vous créez un package pour le build de votre serveur de jeu.

Avant de commencer

Voici ce dont vous avez besoin pour utiliser le GameLift plugin Amazon pour Unreal Engine :

  • Package de lancement du GameLift plugin Amazon pour Unreal Engine. [Site de téléchargement].

  • Microsoft Visual Studio 2019 ou version ultérieure.

  • Une version créée par le code source de l'éditeur Unreal Engine. Vous avez besoin d'une version créée par le code source pour empaqueter les composants du serveur pour un jeu multijoueur. Pour plus de détails, y compris les prérequis supplémentaires, consultez la documentation d'Unreal Engine :

  • Un projet de jeu multijoueur avec du code de jeu en C++. Si vous travaillez sur un projet Blueprint, consultez la documentation Unreal pour savoir comment générer du code source C++ pour votre projet.

Création du serveur Amazon GameLift C++ SDK

Le package de mise à jour du GameLift plugin Amazon pour Unreal Engine contient le code source du serveur C++ SDK pour Unreal. Avant de pouvoir l'utiliser avec le plugin, vous devez extraire le code source et le créer pour votre environnement de développement.

Note

Si vous créez des serveurs de jeux destinés à fonctionner sur un environnement d'exécution Amazon Linux 2023, vous pouvez tirer parti d'un script d'assistance, disponible dans le référentiel Amazon GameLift Toolkit. Utilisez ce script d'assistance pour générer le SDK binaire et les SSL bibliothèques dont vous avez besoin pour utiliser le plugin. Vous pouvez utiliser le script lorsque vous développez avec Unreal Engine 5 sous Windows ou Linux. Le script est une solution basée sur Docker. Vous pouvez l'exécuter localement avec git et docker installés, ou vous pouvez exécuter le script AWS CloudShell en utilisant le. AWS Management Console

En savoir plus sur le script de GameLift compilation Amazon pour Unreal Engine 5.

Pour créer manuellement le serveur C++ SDK pour Unreal

  1. Décompressez le package de publication du GameLift plugin Amazon pour Unreal Engine pour extraire deux fichiers zip :

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

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

    Décompressez ces fichiers.

  2. Ouvrez le GameLift-Cpp-ServerSDK-<> dossier, puis suivez les instructions suivantes pour votre plate-forme : Linux ou Microsoft Windows.

Linux

  1. Exécutez les commandes suivantes : 

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

    Ces commandes créent le /lib/aws-cpp-sdk-gamelift-server.so fichier.

  2. /lib/aws-cpp-sdk-gamelift-server.soCopiez dans le amazon-gamelift-plugin-unreal/GameLiftPlugin/Source/GameliftServer/ThirdParty/GameLiftServerSDK/Linux/x86_64-unknown-linux-gnu/ répertoire.

Microsoft Windows

  1. Exécutez les commandes suivantes :

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

    Ces commandes créent les fichiers binaires suivants.

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

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

  2. Copiez les fichiers dans le amazon-gamelift-plugin-unreal\GameLiftPlugin\Source\GameliftServer\ThirdParty\GameLiftServerSDK\Win64\ répertoire.

Ajoutez le plugin à votre projet de jeu

En travaillant dans l'éditeur Unreal avec votre projet de jeu ouvert, effectuez les tâches suivantes.

Pour ajouter le plugin à un projet

  1. Installez les fichiers du plugin.

    1. Localisez le dossier racine de votre projet de jeu, tel que... > Unreal Projects/[project-name]/. Locke pour un Plugins dossier. Si le dossier n'existe pas, créez-le.

    2. Décompressez le package de publication du plugin (amazon-gamelift-plugin-unreal-<>-sdk-<>.zip). Ouvrez le amazon-gamelift-plugin-unreal dossier et GameLiftPlugin trouvez-le. Copiez ce dossier dans le Plugins dossier de l'étape 1.

  2. Ajoutez le plugin au .uproject fichier.

    1. Dans le dossier racine de votre projet de jeu, ouvrez le .uproject fichier.

    2. Mettez à jour le fichier pour ajouter GameLiftPlugin « » et WebBrowserWidget « » à la Plugins section et activez-les. Le code suivant montre le .uproject fichier mis à jour pour un jeu appelé « MyGame ».

    UnrealProjects > MyGame > MyGame.uproject
{ 
  ...
  "Plugins": [
    {
      "Name": "ModelingToolsEditorMode",
      "Enabled": true,
      "TargetAllowList": [ "Editor" ]
    },
    {
      "Name": "GameLiftPlugin",
      "Enabled": true
    },
    {
      "Name": "WebBrowserWidget",
      "Enabled": true
    }
  ]
}

  3. Modifiez la version de l'éditeur UE pour votre projet.

    Si vous avez créé un projet pour une version d'éditeur et que vous souhaitez maintenant passer à une autre version (telle qu'une version source), vous devez mettre à jour le projet.

    Dans le dossier racine de votre projet de jeu, sélectionnez le .uproject fichier et choisissez l'option Changer de version d'Unreal Engine. Sélectionnez une nouvelle version de l'éditeur.

  4. Reconstruisez la solution du projet avec vos mises à jour.

    1. Dans le dossier racine du projet, recherchez un fichier de solution (*.sln). S'il n'en existe aucun, sélectionnez le .uproject fichier et choisissez l'option Générer les fichiers de projet Visual Studio.

    2. Ouvrez le fichier de solution et créez ou reconstruisez le projet.

  5. Vérifiez que le plugin est activé dans l'éditeur UE.

    Note

    Si vous avez déjà ouvert l'éditeur, vous devrez peut-être le redémarrer avant qu'il ne reconnaisse le nouveau plugin.

    1. Ouvrez le projet dans l'éditeur UE de votre choix.

    2. Consultez la barre d'outils principale de l'éditeur pour voir le nouveau bouton GameLift du menu Amazon [image requise].

    3. Recherchez les ressources du GameLift plugin Amazon dans le navigateur de contenu. Assurez-vous que l'option Afficher le contenu du plug-in est sélectionnée dans votre paramètre Options d'affichage.