Installing the HiveMP SDK for Unreal Engine 4

How did we do?

Supported versions

We've tested the SDK on the following versions of Unreal Engine 4 and support them:

  • Unreal Engine 4.18
  • Unreal Engine 4.19
  • Unreal Engine 4.20

The SDK may work on older versions of Unreal Engine 4, but we only support the latest 3 major releases of Unreal Engine. For more information on supported versions of Unreal Engine 4 and the platforms the SDK operates on, refer to our Platform Roadmap.

Downloading the SDK

Download the latest release of the Unreal Engine 4 SDK from the GitHub releases page.

This will be a ZIP archive for Unreal Engine 4. Extract the ZIP somewhere on your computer; you'll need to copy the extracted files later in this guide.

Setting your project up for the SDK

Before you can use the Unreal Engine 4 SDK, your project needs to have at least one C++ class in it. If your project doesn't have any C++ classes in it, Unreal Engine 4 will refuse to load any C++-based plugins (which the SDK is).

If you don't have any C++ code in your project, you can add an empty file by doing the following:

  • Click File -> New C++ Class... when the editor is open.
  • Accept all the default values.

Your new C++ class doesn't need to do anything or have any behaviour in it. It's only necessary to exist so that Unreal Engine 4 will build the HiveMP SDK as part of your game.

Installing the SDK

Copy the previously extracted files into your project's Plugins directory. If the Plugins directory doesn't exist, you'll need to create it.

Once you've installed the SDK, the file <yourproject>\Plugins\HiveMPSDK\HiveMPSDK.uplugin should exist. If it doesn't, adjust where you've extracted the SDK files.

You can now open your project with the Epic Games launcher. You'll be prompted to build the HiveMP SDK DLL the first time your project opens; this might take a while but only needs to happen once.

If you need to update the HiveMP SDK, delete the HiveMPSDK directory inside Plugins and repeat the installation process with the new ZIP archive.

Further reading