Installation

This page will walk you through any pre-requisites and steps necessary to enable Ninja Tokens.

Pre-Requisites

Ninja Tokens is compatible with Behavior Trees or State Trees. Make sure that the AI Support plugin is enabled in your project and, if you are using State Trees, also make sure that the State Trees plugin is enabled as well.

Installing the Plugin

To get started, install the plugin to a supported engine version using to your engine Epic Games Launcher, and then enable it in your project.

Installing via the Epic Launcher

Open the Epic Games Launcher and locate the Ninja Tokens plugin.
Click Install to Engine and select the desired version from the version list.
Once installed, create or open your project, and navigate to Edit and Plugins.
Find Ninja Tokens from the list and enable it.
When prompted, restart the engine to fully activate the plugin.

Working with Sources

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

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.

GitHub Repository

Ensure that you have access to the Ninja Tokens 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 Interaction 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.

Enable C++ Modules

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[] { "AIModule", "GameplayStateTreeModule", "GameplayTasks", "StateTreeModule", "NinjaTokens", "NinjaTokensBehaviorTree", // If you are using Behavior Trees. "NinjaTokensStateTree", // If you are using State Trees. });
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: 10 October 2025