SDK version 3

.gitignore

@@ -33,7 +33,6 @@
 *.idb
 
 # Kernel Module Compile Results
-*.mod*
 *.cmd
 modules.order
 Module.symvers
@@ -50,10 +49,6 @@ dkms.conf
 
 # Compiled Dynamic libraries
 
-# Fortran module files
-*.mod
-*.smod
-
 # Compiled Static libraries
 *.lai
 
@@ -165,16 +160,6 @@ Temporary Items
 # Visual Studio 2015 database file
 *.VC.db
 
-# Compiled Object files
-
-# Precompiled Headers
-
-# Compiled Dynamic libraries
-
-# Fortran module files
-
-# Compiled Static libraries
-
 # Executables
 *.ipa
 
@@ -187,6 +172,8 @@ Temporary Items
 *.sdf
 *.VC.opendb
 
+*.vsconfig
+
 # Precompiled Assets
 SourceArt/**/*.png
 SourceArt/**/*.tga
@@ -547,10 +534,12 @@ NakamaBlueprintsTest/DerivedDataCache
 NakamaBlueprintsTest/Saved
 NakamaBlueprintsTest/Binaries
 
-NakamaTest/Plugins/Nakama
-NakamaTest/Intermediate
-NakamaTest/Saved
-NakamaTest/Binaries
+IntegrationTests/Plugins/Nakama
+IntegrationTests/Plugins/Satori
+IntegrationTests/Intermediate
+IntegrationTests/DerivedDataCache
+IntegrationTests/Saved
+IntegrationTests/Binaries
 
 Nakama/Intermediate
 Nakama/Saved
@@ -570,3 +559,16 @@ IntegrationTests/DerivedDataCache
 vcpkg_installed/
 /NakamaBlueprintsTest/Content/Developers
 /NakamaBlueprintsTest/Content/Collections
+.env
+proto/
+Reports/IntegrationTests/index.html
+Reports/IntegrationTests/index.json
+Reports/NakamaProfile/
+/IntegrationTests/Reports
+NakamaTest/Binaries
+NakamaTest/DerivedDataCache
+NakamaTest/Intermediate/
+NakamaTest/Saved/
+Reports
+IntegrationTests/satori/
+IntegrationTests/dashboards/

CHANGELOG.md

@@ -3,6 +3,27 @@ All notable changes to this project are documented below.
 
 The format is based on [keep a changelog](http://keepachangelog.com/) and this project uses [semantic versioning](http://semver.org/).
 
+### [3.0.0] - 2026-05-11
+### Added 
+- Async Future-based API.
+- Missing Server-to-server methods.
+- Auto-generation from Nakama/Satori schema.
+- Extensive Integration Test suite.
+
+### Changed
+- Function signatures (please refer to documentation).
+- Component lifetimes are less coupled to Unreal Engine Garbage Collector.
+
+### Fixed
+- Improved consistency across the SDK.
+- Revamped real-time websocket code.
+
+This is a major release with a larger list of changes.
+For more information on the current version and the differences to previous versions, 
+please refer to [documentation](https://heroiclabs.com/docs/nakama/client-libraries/unreal/index.html) 
+and the [migration guide](https://heroiclabs.com/docs/nakama/client-libraries/unreal/migration-guide).
+
+
 ### [2.11.2] - 2026-04-27
 ### Added
 - Server-side Satori events: #165

IntegrationTests/.editorconfig

@@ -0,0 +1,91 @@
+[*.{cpp,h}]
+
+# Naming convention rules (note: currently need to be ordered from more to less specific)
+
+cpp_naming_rule.aactor_prefixed.symbols                    = aactor_class
+cpp_naming_rule.aactor_prefixed.style                      = aactor_style
+
+cpp_naming_rule.swidget_prefixed.symbols                   = swidget_class
+cpp_naming_rule.swidget_prefixed.style                     = swidget_style
+
+cpp_naming_rule.uobject_prefixed.symbols                   = uobject_class
+cpp_naming_rule.uobject_prefixed.style                     = uobject_style
+
+cpp_naming_rule.booleans_prefixed.symbols                 = boolean_vars
+cpp_naming_rule.booleans_prefixed.style                   = boolean_style
+
+cpp_naming_rule.structs_prefixed.symbols                   = structs
+cpp_naming_rule.structs_prefixed.style                     = unreal_engine_structs
+
+cpp_naming_rule.enums_prefixed.symbols                     = enums
+cpp_naming_rule.enums_prefixed.style                       = unreal_engine_enums
+
+cpp_naming_rule.templates_prefixed.symbols                 = templates
+cpp_naming_rule.templates_prefixed.style                   = unreal_engine_templates
+
+cpp_naming_rule.general_names.symbols                      = all_symbols
+cpp_naming_rule.general_names.style                        = unreal_engine_default
+
+# Naming convention symbols         
+
+cpp_naming_symbols.aactor_class.applicable_kinds           = class
+cpp_naming_symbols.aactor_class.applicable_type            = AActor
+
+cpp_naming_symbols.swidget_class.applicable_kinds          = class
+cpp_naming_symbols.swidget_class.applicable_type           = SWidget
+
+cpp_naming_symbols.uobject_class.applicable_kinds          = class
+cpp_naming_symbols.uobject_class.applicable_type           = UObject
+
+cpp_naming_symbols.boolean_vars.applicable_kinds          = local,parameter,field
+cpp_naming_symbols.boolean_vars.applicable_type           = bool
+
+cpp_naming_symbols.enums.applicable_kinds                  = enum
+
+cpp_naming_symbols.templates.applicable_kinds              = template_class
+
+cpp_naming_symbols.structs.applicable_kinds                = struct
+
+cpp_naming_symbols.all_symbols.applicable_kinds            = *
+
+# Naming convention styles
+
+cpp_naming_style.unreal_engine_default.capitalization      = pascal_case
+cpp_naming_style.unreal_engine_default.required_prefix     =
+cpp_naming_style.unreal_engine_default.required_suffix     =
+cpp_naming_style.unreal_engine_default.word_separator      =
+
+cpp_naming_style.unreal_engine_enums.capitalization        = pascal_case
+cpp_naming_style.unreal_engine_enums.required_prefix       = E
+cpp_naming_style.unreal_engine_enums.required_suffix       =
+cpp_naming_style.unreal_engine_enums.word_separator        =
+
+cpp_naming_style.unreal_engine_templates.capitalization    = pascal_case
+cpp_naming_style.unreal_engine_templates.required_prefix   = T
+cpp_naming_style.unreal_engine_templates.required_suffix   =
+cpp_naming_style.unreal_engine_templates.word_separator    =
+
+cpp_naming_style.unreal_engine_structs.capitalization      = pascal_case
+cpp_naming_style.unreal_engine_structs.required_prefix     = F
+cpp_naming_style.unreal_engine_structs.required_suffix     =
+cpp_naming_style.unreal_engine_structs.word_separator      =
+
+cpp_naming_style.uobject_style.capitalization              = pascal_case
+cpp_naming_style.uobject_style.required_prefix             = U
+cpp_naming_style.uobject_style.required_suffix             =
+cpp_naming_style.uobject_style.word_separator              =
+
+cpp_naming_style.aactor_style.capitalization               = pascal_case
+cpp_naming_style.aactor_style.required_prefix              = A
+cpp_naming_style.aactor_style.required_suffix              =
+cpp_naming_style.aactor_style.word_separator               =
+
+cpp_naming_style.swidget_style.capitalization              = pascal_case
+cpp_naming_style.swidget_style.required_prefix             = S
+cpp_naming_style.swidget_style.required_suffix             =
+cpp_naming_style.swidget_style.word_separator              =
+
+cpp_naming_style.boolean_style.capitalization              = pascal_case
+cpp_naming_style.boolean_style.required_prefix             = b
+cpp_naming_style.boolean_style.required_suffix             =
+cpp_naming_style.boolean_style.word_separator              =

IntegrationTests/Config/DefaultEngine.ini

@@ -2,8 +2,8 @@
 
 [/Script/EngineSettings.GameMapsSettings]
 GameInstanceClass=/Script/Engine.GameInstance
-EditorStartupMap=/Game/Maps/EmptyMap
-GameDefaultMap=/Game/Maps/EmptyMap
+EditorStartupMap=/Game/Maps/menu.menu
+GameDefaultMap=/Game/Maps/menu.menu
 
 [/Script/HardwareTargeting.HardwareTargetingSettings]
 TargetedHardwareClass=Desktop

IntegrationTests/IntegrationTests.uproject

@@ -1,6 +1,6 @@
 {
 	"FileVersion": 3,
-	"EngineAssociation": "{A3A5E785-4C17-39B0-8BE8-0F814BEA5348}",
+	"EngineAssociation": "{7BBEE08C-471E-1AB2-A872-B7AFBBC9FC79}",
 	"Category": "",
 	"Description": "",
 	"Modules": [

IntegrationTests/Source/IntegrationTests/IntegrationTests.Build.cs

@@ -9,7 +9,6 @@ public class IntegrationTests : ModuleRules
 	public IntegrationTests(ReadOnlyTargetRules Target) : base(Target)
 	{
 		PCHUsage = PCHUsageMode.UseExplicitOrSharedPCHs;
-		CppStandard = CppStandardVersion.Cpp20;
-		PrivateDependencyModuleNames.AddRange(new string[] { "Core", "CoreUObject", "Engine", "FieldNotification", "InputCore", "Json", "HTTP", "NakamaUnreal", "SatoriUnreal", "WebSockets", "Slate", "SlateCore", "UMG", "ModelViewViewModel" });
+		PrivateDependencyModuleNames.AddRange(new string[] { "Core", "CoreUObject", "Engine", "FieldNotification", "InputCore", "Json", "HTTP", "NakamaApi", "Nakama", "NakamaBlueprints", "SatoriApi", "Satori", "SatoriBlueprints", "WebSockets", "Slate", "SlateCore", "UMG", "ModelViewViewModel" });
 	}
 }

IntegrationTests/Source/IntegrationTests/Tests/FutureThreadingTests.cpp

@@ -0,0 +1,121 @@
+/**
+ * Future Threading Tests
+ *
+ * Demonstrates bug: TSatoriFuture terminal .Next() callbacks ran on the UE
+ * background task thread pool instead of the game thread.
+ *
+ * Root cause (Satori.h, old TSatoriFuture:169-179): the terminal Next() overload
+ * passed the user callback directly to UE::Tasks::Launch without any
+ * AsyncTask(ENamedThreads::GameThread, ...) dispatch. Callers that touched
+ * UObject*, fired delegates, or updated UI would therefore hit non-thread-safe
+ * access and intermittent crashes.
+ *
+ * Fix: both TNakamaFuture and TSatoriFuture are now aliases for the shared
+ * TAsyncFuture<> template (AsyncFuture.h / NakamaApi module), which dispatches
+ * every user-visible callback — chaining and terminal — to the game thread.
+ *
+ * The Satori test below verifies the fix. The Nakama control test was already
+ * passing before the consolidation.
+ */
+
+#include <atomic>
+#include "Misc/AutomationTest.h"
+#include "AsyncFuture.h"
+
+// ============================================================================
+// Satori: terminal .Next() must run on the game thread
+// ============================================================================
+
+IMPLEMENT_SIMPLE_AUTOMATION_TEST(
+	FSatoriTerminalNextOnGameThreadTest,
+	"IntegrationTests.Threading.Satori.TerminalNextMustRunOnGameThread",
+	EAutomationTestFlags::EditorContext | EAutomationTestFlags::ClientContext | EAutomationTestFlags::EngineFilter
+)
+
+struct FSatoriThreadingTestResult
+{
+	bool bIsError = false;
+};
+
+bool FSatoriTerminalNextOnGameThreadTest::RunTest(const FString& Parameters)
+{
+	TSharedRef<std::atomic<bool>> bCallbackRanOnGameThread = MakeShared<std::atomic<bool>>(false);
+	TSharedRef<std::atomic<bool>> bCallbackInvoked        = MakeShared<std::atomic<bool>>(false);
+
+	MakeCompletedAsyncFuture(FSatoriThreadingTestResult{}).Next(
+		[bCallbackRanOnGameThread, bCallbackInvoked](FSatoriThreadingTestResult)
+		{
+			bCallbackRanOnGameThread->store(IsInGameThread());
+			bCallbackInvoked->store(true);
+		});
+
+	// Spin-wait up to 5 s, pumping the game-thread task queue each iteration
+	// so the AsyncTask dispatch can actually execute.
+	constexpr double TimeoutSeconds = 5.0;
+	const double Deadline = FPlatformTime::Seconds() + TimeoutSeconds;
+	while (!bCallbackInvoked->load())
+	{
+		FTaskGraphInterface::Get().ProcessThreadUntilIdle(ENamedThreads::GameThread);
+		if (FPlatformTime::Seconds() > Deadline)
+		{
+			AddError(TEXT("Timed out waiting for TSatoriFuture terminal .Next() callback"));
+			return false;
+		}
+		FPlatformProcess::Sleep(0.01f);
+	}
+
+	TestTrue(
+		TEXT("TSatoriFuture terminal .Next() callback must run on the game thread"),
+		bCallbackRanOnGameThread->load()
+	);
+
+	return true;
+}
+
+// ============================================================================
+// Nakama: same guarantee, kept as a control / regression test
+// ============================================================================
+
+struct FNakamaThreadingTestResult
+{
+	bool bIsError = false;
+};
+
+IMPLEMENT_SIMPLE_AUTOMATION_TEST(
+	FNakamaTerminalNextOnGameThreadTest,
+	"IntegrationTests.Threading.Nakama.TerminalNextMustRunOnGameThread",
+	EAutomationTestFlags::EditorContext | EAutomationTestFlags::ClientContext | EAutomationTestFlags::EngineFilter
+)
+
+bool FNakamaTerminalNextOnGameThreadTest::RunTest(const FString& Parameters)
+{
+	TSharedRef<std::atomic<bool>> bCallbackRanOnGameThread = MakeShared<std::atomic<bool>>(false);
+	TSharedRef<std::atomic<bool>> bCallbackInvoked        = MakeShared<std::atomic<bool>>(false);
+
+	MakeCompletedAsyncFuture(FNakamaThreadingTestResult{}).Next(
+		[bCallbackRanOnGameThread, bCallbackInvoked](FNakamaThreadingTestResult)
+		{
+			bCallbackRanOnGameThread->store(IsInGameThread());
+			bCallbackInvoked->store(true);
+		});
+
+	constexpr double TimeoutSeconds = 5.0;
+	const double Deadline = FPlatformTime::Seconds() + TimeoutSeconds;
+	while (!bCallbackInvoked->load())
+	{
+		FTaskGraphInterface::Get().ProcessThreadUntilIdle(ENamedThreads::GameThread);
+		if (FPlatformTime::Seconds() > Deadline)
+		{
+			AddError(TEXT("Timed out waiting for TNakamaFuture terminal .Next() callback"));
+			return false;
+		}
+		FPlatformProcess::Sleep(0.01f);
+	}
+
+	TestTrue(
+		TEXT("TNakamaFuture terminal .Next() callback must run on the game thread"),
+		bCallbackRanOnGameThread->load()
+	);
+
+	return true;
+}