Installation

Last modified: 05 April 2025

Summary: Installing Ninja Combat


  • Install Ninja Combat using the Epic Launcher and enable it in your project.

  • Optionally, install the source code from GitHub and enable C++ in the project.

  • If using C++, then make sure to add all module dependencies to the Build.cs file.

This page will walk you through the pre-requisites and steps necessary to enable the Ninja Combat plugin.

Pre-Requisites

Before enabling Ninja Combat, make sure to have the following pre-requisites addressed:

  1. A working setup for the Gameplay Ability System Component. If you are using Ninja G.A.S., then make sure to configure it first.

  2. A working setup for the Enhanced Input. If you are using Ninja Input, then make sure to configure it first.

Installing the Plugin

To get started, install the plugin to your engine using the Epic Games Launcher.

Installing via the Epic Launcher

  1. Open the Epic Games Launcher and locate the Ninja Combat code plugin.

  2. Click Install to Engine and select the engine version to install, from the list of compatible versions.

    tip

    Plugins installed via the Epic Launcher are added to your Engine directory and are available to all projects using that engine version.

  3. Once installed, create or open your project, navigate to Edit → Plugins and find Ninja Combat on the list. You can search for it in the Search Bar too.

  4. Enable the plugin and restart the engine.

Working with the Source Code

If you plan to work with the source code, you can copy the plugin to your local engine or install it from GitHub.

Enable C++ in your Project

  1. Make sure to perform all necessary steps to enable C++ in your environment and project.

  2. To work with the source code, you will need an editor installed, such as Visual Studio or Rider. Make sure to install your editor of choice.

  3. If your project was originally Blueprint-only, create at least one C++ class, such as a base Character or Game Mode, via Tools → New C++ Class.

GitHub Repository

  1. Ensure that you have access to the Ninja Combat repository on GitHub.

  2. In your project, create a Plugins folder if you don't have one. If you're using multiple Ninja Bear Studio plugins, we recommend organizing them under a NinjaBearStudio folder.

  3. Clone the Ninja Combat repository into your desired Plugins Folder.

  4. Right-click the .uproject file and select Generate Visual Studio project files (or your IDE equivalent).

  5. Launch the project. The plugin should now be available in your project's Plugins list.

Enable C++ Modules

  1. Close your Unreal Engine project if it is currently open.

  2. In your IDE of choice, open the Build.cs file, named after your project (e.g., MyGame.Build.cs in the Source/MyGame folder), and add the following contents.

    PublicDependencyModuleNames.AddRange(new string[]
{
    // Ninja Combat
    "CommonUI",
    "GameplayAbilities",
    "GameplayTags",
    "GameplayTasks",
    "InputCore",
    "ModelViewViewModel",
    "Niagara",
    "NinjaCombat",
    "NinjaCombatCamera",
    "NinjaCombatCore",
    "NinjaCombatActorPool",
    "NinjaCombatUI",
    "StructUtils",
    "UMG"
});

    warning

    Do not remove or replace any existing dependencies. Just add the ones listed below. Add the ones in the list above, and watch out for duplicates.

  3. Remove the version installed in the engine, if there is one.

    tip

    Unreal may load the Engine version of the plugin over the one in your project, leading to version mismatches or undefined behavior. Make sure only one copy is active.

  4. Recompile the project. If this is the first time doing that, it might take a while.