Installation

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:

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

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

Open the Epic Games Launcher and locate the Ninja Combat code plugin.
Click Install to Engine and select the engine version to install, from the list of compatible versions.
Plugins installed via the Epic Launcher are added to your Engine directory and are available to all projects using that engine version.
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.
Enable the plugin and restart the engine.

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

Make sure to perform all necessary steps to enable C++ in your environment and project.
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.
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.

Ensure that you have access to the Ninja Combat repository on GitHub.
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.
Clone the Ninja Combat repository into your desired Plugins Folder.
Right-click the .uproject file and select Generate Visual Studio project files (or your IDE equivalent).
Launch the project. The plugin should now be available in your project's Plugins list.

Close your Unreal Engine project if it is currently open.
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" });
Do not remove or replace any existing dependencies. Add the ones in the list above, and watch out for duplicates.
Remove the version installed in the engine, if there is one.
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.
Recompile the project. If this is the first time doing that, it might take a while.

Last modified: 04 June 2025