Plugin Installation
Great decision! You're about to install a plugin that will make your life easier.
Unfortunately, the Epic Games FAB plugin disrupts the functionality of the EIK plugin. The FAB plugin enables the EOS Shared Engine plugin, while EIK utilizes a custom version, leading to conflicts between the two. This can result in a LNK2005 error during project packaging or prevent EIK from initializing properly.
To resolve this issue for the EIK project, please disable the FAB plugin. This conflict has been addressed in engine version 5.5 and later.
Marketplace Edition
- Open Library in the Unreal Engine section of the Epic Games Launcher.
- Go to the Vault section and install
EOS Integration Kit
.
- Open the Plugins window in the Unreal Engine editor.
- Enable the plugin by checking the box next to
EOS Integration Kit
.
- Restart the Unreal Engine editor.
Done! You've successfully installed the plugin.
Source Edition
Because the source version of the plugin is not compiled, you will need to compile it yourself before using it in your project. This is why you need a C++ project to use the source version of the plugin.
- Clone the repository from GitHub (opens in a new tab) either using the
git clone
command or by downloading the repository as a ZIP archive.
- Once downloaded, extract the contents of the ZIP archive to the
Plugins
folder of your Unreal Engine project.
- Download the 1.16.4 EOS SDK (opens in a new tab) from the Epic Games website. Download the SDK for the platform you are developing for.
- Windows : C SDK
- Mac : C SDK
- Linux : C SDK
- Android : Android SDK
- iOS : iOS SDK
- Now we need to copy the SDK files to the plugin folder. The SDK files are located in the
SDK
folder of the downloaded ZIP archive. The SDK files are different for each platform. Let me guide you through the process.
C SDK
- Extract the downloaded ZIP archive and then copy the elements of the
SDK
folder to theThirdParty/EIKSDK
folder of the plugin.
Android SDK
The current Android implementation of EIK only supports Android API Level 34 and above because of Google's new API updates, we are trying to make the plugin work on older Android versions as well, but till then, make sure you have the latest Gradle (Tested on 8.5), Android SDK 34 and above, and NDK 26c and above. Make sure you update the SDK/NDK location in your environment variables and Project Settings.
Starting EOS SDK V1.16.2, Epic Games doesn't provide the libEOSSDK.so
files for Android. So, we have to extract them from the SDK ourselves. Let's go through the steps.
- From the unzipped SDK folder, navigate to
SDK\Bin\Android\static-stdc++\aar
and extract theeossdk-StaticSTDC-release.aar
file using an archive manager like 7-Zip.
- Now from the extracted files, navigate to
eossdk-StaticSTDC-release\jni
and copy all the folders and files to theThirdParty/EIKSDK/Bin/Android
folder of the plugin. The folder should look like this :
- Copy the includes from the extracted files to the
Source/ThirdParty/EIKSDK
folder of the plugin. The new folder structure should look like this :
- Then go back to
SDK\Bin\Android\static-stdc++\aar
and copyeossdk-StaticSTDC-release.aar
toPlugin\Source\ThirdParty\EIKSDK\Bin
and rename the file aseos-sdk.aar
iOS SDK
- Extract the downloaded ZIP archive and then copy the elements of the
SDK
folder to theThirdParty/EIKSDK
folder of the plugin, same as the C SDK.
To verify that the SDK files are copied correctly, the folder structure of ThirdParty/EIKSDK/Bin/IOS
should look like this :
Back to the unified steps
- Now right click on the
.uproject
file of your project and selectGenerate Visual Studio project files
.
-
Open the generated
.sln
file in Visual Studio and compile the project. -
Once compiled, open the Plugins window in the Unreal Engine editor and enable the plugin by checking the box next to
EOS Integration Kit
.
- Restart the Unreal Engine editor.
Done! You've successfully installed the plugin.