Installation

Requirements

• Unreal Engine 5.7
• UE 5.7 target settings:
  • DefaultBuildSettings = BuildSettingsVersion.V6
  • IncludeOrderVersion = EngineIncludeOrderVersion.Unreal5_7

Install The Plugin

Copy ForbocAI_SDK into your project’s Plugins/ directory:

YourProject/
├── Plugins/
│   └── ForbocAI_SDK/
├── Source/
└── YourProject.uproject

Enable it in .uproject:

1
{
2
  "Plugins": [
3
    {
4
      "Name": "ForbocAI_SDK",
5
      "Enabled": true
6
    }
7
  ]
8
}

Add The Module Dependency

In your module Build.cs:

1
PublicDependencyModuleNames.AddRange(new string[] {
2
    "Core",
3
    "CoreUObject",
4
    "Engine",
5
    "ForbocAI_SDK"
6
});

Build Settings

In both target files:

1
DefaultBuildSettings = BuildSettingsVersion.V6;
2
IncludeOrderVersion = EngineIncludeOrderVersion.Unreal5_7;

First Runtime Configuration

The plugin persists config in ~/.forbocai.json. Set the canonical hosted API URL explicitly:

$
-run=ForbocAI_SDK -Command=config_set -Key=apiUrl -Value=https://api.forboc.ai
$
-run=ForbocAI_SDK -Command=config_set -Key=apiKey -Value=YOUR_KEY

Other supported keys:

• modelPath
• databasePath
• vectorDimension
• maxRecallResults

Verify The Install

Run the commandlet health check:

$
"/Users/Shared/Epic Games/UE_5.7/Engine/Binaries/Mac/UnrealEditor-Cmd" \
>
  "/Path/To/YourProject.uproject" \
>
  -run=ForbocAI_SDK -Command=doctor -ApiUrl=https://api.forboc.ai \
>
  -nosplash -nopause -unattended

Expected log shape:

ForbocAI SDK CLI (UE5) - Command: doctor
API Status: online (v...)

Native Runtime Verification

After building, verify that native inference and vector storage are working:

$
"/Users/Shared/Epic Games/UE_5.7/Engine/Binaries/Mac/UnrealEditor-Cmd" \
>
  "/Path/To/YourProject.uproject" \
>
  -run=ForbocAICommandlet -Command=setup_runtime_check \
>
  -stdout -nosplash -unattended

Expected output (all 4 stages must pass):

[OK] node memory initialized
[OK] embedding runtime initialized
[OK] memory store/recall verified
[OK] cortex initialized and generated a completion
[RESULT] Command completed successfully

Models are downloaded automatically on first use — no manual download step is needed.

ThirdParty Dependencies

The plugin includes pre-built native libraries in ThirdParty/:

• llama.cpp: SLM inference + embeddings (static libs for Mac/Win64)
• sqlite-vec: Vector search via sqlite vec0 virtual tables

These ship with the plugin. Build.cs auto-detects them and sets WITH_FORBOC_NATIVE=1 and WITH_FORBOC_SQLITE_VEC=1. If ThirdParty is missing, the SDK returns proper errors with UE_LOG diagnostics — no mock or simulated behavior.

First C++ Includes

For the current public runtime, start with:

1
#include "RuntimeStore.h"
2
#include "RuntimeConfig.h"
3
#include "CLI/CliOperations.h"

The current docs and current plugin source are the source of truth for integration shape.