Merge branch 'dev'

Author: mrbindraw

CheckAppInstance.uplugin

@@ -1,7 +1,7 @@
 {
 	"FileVersion": 3,
-	"Version": 4,
-	"VersionName": "2.1.3",
+	"Version": 5,
+	"VersionName": "2.2.0",
 	"FriendlyName": "CheckAppInstance",
 	"Description": "This plugin makes it possible only one instance of your game can be run at the same time",
 	"Category": "Other",

README.md

@@ -1,18 +1,37 @@
-# CheckAppInstance
-Plugin for UE4/5 project.  
-This plugin makes it possible only one instance of your game can be run at the same time.  
-This can be controlled with the launch argument  
--checkinst=<0/1|false/true> it's useful for testing multiplayer game on a single pc.  
-Example: game.exe -checkinst=0
+# CheckAppInstance 
+This plugin allows you to run only one instance of your game at the same time.  
+You can enable/disable check instance from the launch argument to the game binary file  
+`-checkinst=<0/1|false/true>`, this is useful for testing multiplayer game on a single pc.  
+Example: `game -checkinst=0`
 
 **C++/Blueprints functions:**
 - CheckAnotherAppInstance(bool IsEnabled = true)
 
 ProjectSettings -> Maps&Modes -> Game Instance Class: BP_GameInstance
 <img src="Example.png"/>
 
-# Install
-You can install manually by extracting archive (CheckAppInstance-X.X.X...zip) from
+# Install into Project
+You can install manually by extracting archive `CheckAppInstance-X.X.X-UE-X.X.zip` from
 [Releases](https://github.com/mrbindraw/CheckAppInstance/releases) to your project plugins folder  
-or build example project (ExamplePrj-UEX.X-CheckAppInstance-X.X.X.zip).  
+or build example project `ExamplePrj-UE-X.X-CheckAppInstance-X.X.X.zip`.  
+
+# Install into Unreal Engine  
 You can install it from the marketplace [CheckAppInstance](https://www.fab.com/listings/c17f1eb9-dfd8-4f41-ba30-e6c6c43d7c98)
+
+Manual:   
+1. Download and extracting archive `CheckAppInstance-X.X.X-UE-X.X.zip` from [Releases](https://github.com/mrbindraw/ProjectVersionFromGit/releases) to any disk path, for example: `D:\Plugins`  
+2. Than open any terminal (cmd, powershell) in `D:\Plugins` folder  
+3. Launch `RunUAT` in the terminal with arguments, for example:
+
+Windows:
+```  
+D:\EpicGames\UE_5.4\Engine\Build\BatchFiles\RunUAT.bat BuildPlugin -Plugin=D:\Plugins\CheckAppInstance\CheckAppInstance.uplugin -Package=D:\Plugins\UE_5.4\CheckAppInstance -Rocket
+```
+Mac:
+```
+sh "/Users/Shared/Epic Games/UE_5.4/Engine/Build/BatchFiles/RunUAT.sh" BuildPlugin -Plugin="$PWD/CheckAppInstance/CheckAppInstance.uplugin" -Package="$PWD/5.4/CheckAppInstance" -Rocket
+```
+4. If you see the message `BUILD SUCCESSFUL` in the terminal after the build is complete,  
+copy the `CheckAppInstance` folder from `D:\Plugins\UE_5.4` to `D:\EpicGames\UE_5.4\Engine\Plugins\Marketplace`  
+> [!IMPORTANT]
+> **The engine path and folder names may differ on your system.**

Source/CheckAppInstance/Private/CheckAppInstanceBPLibrary.cpp

@@ -3,6 +3,8 @@
 #include "CheckAppInstanceBPLibrary.h"
 #include "CheckAppInstance.h"
 
+DEFINE_LOG_CATEGORY(LogCheckAppInstanceBPLibrary)
+
 UCheckAppInstanceBPLibrary::UCheckAppInstanceBPLibrary(const FObjectInitializer& ObjectInitializer)
 : Super(ObjectInitializer)
 {
@@ -18,17 +20,41 @@ void UCheckAppInstanceBPLibrary::CheckAnotherAppInstance(bool bIsEnabled)
 		bIsEnabled = ParseValue.ToBool();
 	}
 
-	FCoreDelegates::OnAllModuleLoadingPhasesComplete.AddLambda([bIsEnabled]() 
+	if(!bIsEnabled)
+	{
+		return;
+	}
+
+	FCoreDelegates::OnAllModuleLoadingPhasesComplete.AddLambda([]() 
 	{	
 		// Only one instance of the game can be initialized!
 		const UGeneralProjectSettings& ProjectSettings = *GetDefault<UGeneralProjectSettings>();
 		const FString LockFilePath = FPlatformProcess::UserTempDir() + ProjectSettings.ProjectID.ToString();
-		if (!IFileManager::Get().CreateFileWriter(*LockFilePath, 0) && bIsEnabled)
+		bool bIsAppInstLaunched = false;
+
+#if PLATFORM_WINDOWS
+		bIsAppInstLaunched = (IFileManager::Get().CreateFileWriter(*LockFilePath, 0) == nullptr ? true : false);
+#else
+		int FileDescriptor = open(TCHAR_TO_UTF8(*LockFilePath), O_CREAT | O_RDWR, 0666); // 0644
+		if(FileDescriptor >= 0)
+		{
+			int CodeFlock = flock(FileDescriptor, LOCK_EX | LOCK_NB);
+			if (CodeFlock && errno == EWOULDBLOCK)
+			{
+				flock(FileDescriptor, LOCK_UN);
+				close(FileDescriptor);
+
+				bIsAppInstLaunched = true;
+			}
+		}
+#endif
+		UE_LOG(LogCheckAppInstanceBPLibrary, Log, TEXT("LockFilePath: %s, bIsAppInstLaunched: %s"), *LockFilePath, bIsAppInstLaunched ? TEXT("true") : TEXT("false"));
+		if (bIsAppInstLaunched)
 		{
 			FPlatformApplicationMisc::RequestMinimize();
 			FPlatformMisc::RequestExit(0);
 		}
 	});
-#endif
+#endif // !UE_EDITOR
 }
 

Source/CheckAppInstance/Public/CheckAppInstanceBPLibrary.h

@@ -8,8 +8,18 @@
 #include "GeneralProjectSettings.h"
 #include "Misc/CoreDelegates.h"
 #include "Misc/CommandLine.h"
+
+#if PLATFORM_UNIX
+#include <unistd.h>		// close
+#include <fcntl.h>		// open
+#include <sys/file.h>	// flock
+#include <errno.h>
+#endif
+
 #include "CheckAppInstanceBPLibrary.generated.h"
 
+DECLARE_LOG_CATEGORY_EXTERN(LogCheckAppInstanceBPLibrary, Log, All);
+
 UCLASS()
 class UCheckAppInstanceBPLibrary : public UBlueprintFunctionLibrary
 {