Plugin per Unreal: installa e configura i componenti del plug-in - Amazon GameLift
Prima di iniziareCrea il server Amazon GameLift C++ SDKAggiungi il plugin al tuo progetto di gioco

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Plugin per Unreal: installa e configura i componenti del plug-in

Questa sezione descrive le attività di installazione iniziali per aggiungere il plugin a un progetto Unreal Engine. La funzionalità del plug-in è disponibile quando il progetto è aperto nell'editor Unreal.

Nota

Puoi utilizzare il GameLift plug-in Amazon con una versione standard dell'editor UE, ma devi utilizzare una versione generata dal codice sorgente quando impacchetti la build del tuo server di gioco.

Prima di iniziare

Ecco cosa ti serve per utilizzare il GameLift plug-in Amazon per Unreal Engine:

  • GameLift Plugin Amazon per il pacchetto di rilascio di Unreal Engine. [Scarica il sito].

  • Microsoft Visual Studio 2019 o versione successiva.

  • Una versione sorgente dell'editor Unreal Engine. È necessaria una versione generata dal codice sorgente per impacchettare i componenti del server per una partita multiplayer. Per maggiori dettagli, inclusi prerequisiti aggiuntivi, consulta la documentazione di Unreal Engine:

  • Un progetto di gioco multiplayer con codice di gioco C++. Se lavori con un progetto Blueprint, consulta la documentazione di Unreal su come generare codice sorgente C++ per il tuo progetto.

Crea il server Amazon GameLift C++ SDK

Il pacchetto di rilascio del GameLift plug-in Amazon per Unreal Engine contiene il codice sorgente per il server C++ SDK per Unreal. Prima di poterlo utilizzare con il plugin, devi estrarre il codice sorgente e crearlo per il tuo ambiente di sviluppo.

Nota

Se stai creando server di gioco da eseguire in un ambiente di runtime Amazon Linux 2023, puoi sfruttare uno script di supporto, disponibile come parte del repository Amazon GameLift Toolkit. Usa questo script di supporto per generare il SDK file binario e le SSL librerie necessarie per l'uso con il plugin. Puoi usare lo script quando sviluppi con Unreal Engine 5 su Windows o Linux. Lo script è una soluzione basata su Docker. Puoi eseguirlo localmente con get e docker installati, oppure puoi eseguire lo script usando AWS CloudShell in. AWS Management Console

Scopri di più sullo script di GameLift build di Amazon per Unreal Engine 5.

Per creare manualmente il server SDK C++ per Unreal

  1. Decomprimi il pacchetto di rilascio del GameLift plug-in Amazon per Unreal Engine per estrarre due file zip:

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

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

    Decomprimi questi file.

  2. Apri la GameLift-Cpp-ServerSDK-<> cartella, quindi completa le seguenti istruzioni per la tua piattaforma: Linux o Microsoft Windows.

Linux

  1. Esegui i comandi seguenti: 

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

    Questi comandi creano il /lib/aws-cpp-sdk-gamelift-server.so file.

  2. /lib/aws-cpp-sdk-gamelift-server.soCopia nella amazon-gamelift-plugin-unreal/GameLiftPlugin/Source/GameliftServer/ThirdParty/GameLiftServerSDK/Linux/x86_64-unknown-linux-gnu/ directory.

Microsoft Windows

  1. Esegui i comandi seguenti:

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

    Questi comandi generano i seguenti file binari.

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

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

  2. Copia i file nella amazon-gamelift-plugin-unreal\GameLiftPlugin\Source\GameliftServer\ThirdParty\GameLiftServerSDK\Win64\ directory.

Aggiungi il plugin al tuo progetto di gioco

Lavorando nell'Unreal Editor con il progetto di gioco aperto, completa le seguenti attività.

  1. Installa i file del plugin.

    1. Individua la cartella principale del progetto di gioco, ad esempio... > Unreal Projects/[project-name]/. Blocca per una Plugins cartella. Se la cartella non esiste lì, creala.

    2. Decomprimi il pacchetto di rilascio del plugin (amazon-gamelift-plugin-unreal-<>-sdk-<>.zip). Apri la amazon-gamelift-plugin-unreal cartella e trova la GameLiftPlugin cartella. Copia questa cartella nella Plugins cartella del passaggio 1.

  2. Aggiungi il plugin al .uproject file.

    1. Nella cartella principale del progetto di gioco, apri il .uproject file.

    2. Aggiorna il file per aggiungere GameLiftPlugin "" e "WebBrowserWidget" alla Plugins sezione e abilitarli. Il codice seguente mostra il .uproject file aggiornato per un gioco chiamato "MyGame».

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

  3. Cambia la versione dell'editor UE per il tuo progetto.

    Se hai creato un progetto per una versione dell'editor e ora desideri passare a un'altra versione (ad esempio una versione source-build), devi aggiornare il progetto.

    Nella cartella principale del progetto di gioco, seleziona il .uproject file e scegli l'opzione Switch Unreal Engine Version. Seleziona una nuova versione dell'editor.

  4. Ricostruisci la soluzione del progetto con i tuoi aggiornamenti.

    1. Nella cartella principale del progetto, cercate un file solution (*.sln). Se non ne esiste nessuno, seleziona il .uproject file e scegli l'opzione Genera file di progetto di Visual Studio.

    2. Apri il file della soluzione e crea o ricostruisci il progetto.

  5. Verifica che il plugin sia abilitato nell'editor UE.

    Nota

    Se hai già l'editor aperto, potresti dover riavviare l'editor prima che riconosca il nuovo plugin.

    1. Apri il progetto nell'editor UE che hai scelto.

    2. Controlla la barra degli strumenti principale dell'editor per il nuovo pulsante del GameLift menu Amazon [immagine necessaria].

    3. Cerca nel Content Browser le risorse del GameLift plug-in Amazon. Assicurati che nelle impostazioni delle opzioni di visualizzazione sia selezionata l'opzione Mostra contenuto del plug-in.