Introduced ModLoader plugin and support

cleolibrary · Jun 14, 2024 · ba4d7bc · ba4d7bc
1 parent 64c5f78
commit ba4d7bc
Show file tree

Hide file tree

Showing 34 changed files with 1,625 additions and 88 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,6 +1,7 @@
 ## 5.0.0
 
 - support for CLEO modules feature https://github.com/sannybuilder/dev/issues/264
+- improved ModLoader support with CLEO plugin
 - new [Audio](https://github.com/cleolibrary/CLEO5/tree/master/cleo_plugins/Audio) plugin
   - audio related opcodes moved from CLEO core into separated plugin
   - CLEO's audio now obey game's volume settings

diff --git a/CLEO5.vcxproj b/CLEO5.vcxproj
@@ -45,6 +45,7 @@
     <ClCompile Include="source\CGameMenu.cpp" />
     <ClCompile Include="source\CGameVersionManager.cpp" />
     <ClCompile Include="source\CleoBase.cpp" />
+    <ClCompile Include="source\CModLoaderSystem.cpp" />
     <ClCompile Include="source\CModuleSystem.cpp" />
     <ClCompile Include="source\CPluginSystem.cpp" />
     <ClCompile Include="source\crc32.cpp" />
@@ -83,6 +84,7 @@
     <ClInclude Include="source\CGameMenu.h" />
     <ClInclude Include="source\CGameVersionManager.h" />
     <ClInclude Include="source\CleoBase.h" />
+    <ClInclude Include="source\CModLoaderSystem.h" />
     <ClInclude Include="source\CModuleSystem.h" />
     <ClInclude Include="source\CPluginSystem.h" />
     <ClInclude Include="source\crc32.h" />

diff --git a/CLEO5.vcxproj.filters b/CLEO5.vcxproj.filters
@@ -105,6 +105,9 @@
     <ClCompile Include="source\CPluginSystem.cpp">
       <Filter>source\extensions</Filter>
     </ClCompile>
+    <ClCompile Include="source\CModLoaderSystem.cpp">
+      <Filter>source\extensions</Filter>
+    </ClCompile>
     <ClCompile Include="$(PLUGIN_SDK_DIR)\plugin_sa\game_sa\CModelInfo.cpp">
       <Filter>plugin_sdk</Filter>
     </ClCompile>
@@ -173,6 +176,9 @@
     <ClInclude Include="source\OpcodeInfoDatabase.h">
       <Filter>source\utils</Filter>
     </ClInclude>
+    <ClInclude Include="source\CModLoaderSystem.h">
+      <Filter>source\extensions</Filter>
+    </ClInclude>
   </ItemGroup>
   <ItemGroup>
     <None Include="source\cleo.def">

diff --git a/README.md b/README.md
@@ -13,15 +13,16 @@ CLEO itself does not replace any game file, however the following files and fold
 
 - cleo\ (CLEO script directory)
 - cleo\\.config\sa.json (opcodes info file)
-- cleo\cleo_plugins\SA.Audio.cleo (audio playback utilities powered by BASS.dll library)
-- cleo\cleo_plugins\SA.DebugUtils.cleo (script debugging utilities plugin)
-- cleo\cleo_plugins\SA.FileSystemOperations.cleo (disk drive files related operations plugin)
-- cleo\cleo_plugins\SA.IniFiles.cleo (.ini config files handling plugin)
-- cleo\cleo_plugins\SA.Math.cleo (additional math operations plugin)
-- cleo\cleo_plugins\SA.MemoryOperations.cleo (memory and .dll libraries utilities plugin)
-- cleo\cleo_plugins\SA.Text.cleo (text processing plugin)
+- cleo\cleo_plugins\SA.Audio.cleo5 (audio playback utilities powered by BASS.dll library)
+- cleo\cleo_plugins\SA.DebugUtils.cleo5 (script debugging utilities plugin)
+- cleo\cleo_plugins\SA.FileSystemOperations.cleo5 (disk drive files related operations plugin)
+- cleo\cleo_plugins\SA.IniFiles.cleo5 (.ini config files handling plugin)
+- cleo\cleo_plugins\SA.Math.cleo5 (additional math operations plugin)
+- cleo\cleo_plugins\SA.MemoryOperations.cleo5 (memory and .dll libraries utilities plugin)
+- cleo\cleo_plugins\SA.Text.cleo5 (text processing plugin)
 - cleo\cleo_saves\ (CLEO save directory)
 - cleo\cleo_text\ (CLEO text directory)
+- modloader\.data\plugins\CLEO5_Provider.dll (CLEO5 ModLoader plugin)
 - cleo.asi (core library)
 - bass.dll (audio engine library)
 

diff --git a/cleo_plugins/Audio/Audio.vcxproj b/cleo_plugins/Audio/Audio.vcxproj
@@ -46,14 +46,14 @@
     <OutDir>$(SolutionDir).output\</OutDir>
     <IntDir>$(ProjectDir).obj\$(Configuration)\</IntDir>
     <TargetName>SA.Audio</TargetName>
-    <TargetExt>.cleo</TargetExt>
+    <TargetExt>.cleo5</TargetExt>
     <LibraryPath>$(ProjectDir)bass;$(LibraryPath)</LibraryPath>
   </PropertyGroup>
   <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">
     <OutDir>$(SolutionDir).output\</OutDir>
     <IntDir>$(ProjectDir).obj\$(Configuration)\</IntDir>
     <TargetName>SA.Audio</TargetName>
-    <TargetExt>.cleo</TargetExt>
+    <TargetExt>.cleo5</TargetExt>
     <LibraryPath>$(ProjectDir)bass;$(LibraryPath)</LibraryPath>
   </PropertyGroup>
   <PropertyGroup>

diff --git a/cleo_plugins/DebugUtils/DebugUtils.vcxproj b/cleo_plugins/DebugUtils/DebugUtils.vcxproj
@@ -45,13 +45,13 @@
     <OutDir>$(SolutionDir).output\</OutDir>
     <IntDir>$(ProjectDir).obj\$(Configuration)\</IntDir>
     <TargetName>SA.DebugUtils</TargetName>
-    <TargetExt>.cleo</TargetExt>
+    <TargetExt>.cleo5</TargetExt>
   </PropertyGroup>
   <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">
     <OutDir>$(SolutionDir).output\</OutDir>
     <IntDir>$(ProjectDir).obj\$(Configuration)\</IntDir>
     <TargetName>SA.DebugUtils</TargetName>
-    <TargetExt>.cleo</TargetExt>
+    <TargetExt>.cleo5</TargetExt>
   </PropertyGroup>
   <PropertyGroup>
     <LocalDebuggerCommand>$(GTA_SA_DIR)\gta_sa.exe</LocalDebuggerCommand>

diff --git a/cleo_plugins/FileSystemOperations/FileSystemOperations.vcxproj b/cleo_plugins/FileSystemOperations/FileSystemOperations.vcxproj
@@ -45,13 +45,13 @@
     <OutDir>$(SolutionDir).output\</OutDir>
     <IntDir>$(ProjectDir).obj\$(Configuration)\</IntDir>
     <TargetName>SA.FileSystemOperations</TargetName>
-    <TargetExt>.cleo</TargetExt>
+    <TargetExt>.cleo5</TargetExt>
   </PropertyGroup>
   <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">
     <OutDir>$(SolutionDir).output\</OutDir>
     <IntDir>$(ProjectDir).obj\$(Configuration)\</IntDir>
     <TargetName>SA.FileSystemOperations</TargetName>
-    <TargetExt>.cleo</TargetExt>
+    <TargetExt>.cleo5</TargetExt>
   </PropertyGroup>
   <PropertyGroup>
     <LocalDebuggerCommand>$(GTA_SA_DIR)\gta_sa.exe</LocalDebuggerCommand>

diff --git a/cleo_plugins/IniFiles/IniFiles.vcxproj b/cleo_plugins/IniFiles/IniFiles.vcxproj
@@ -45,13 +45,13 @@
     <OutDir>$(SolutionDir).output\</OutDir>
     <IntDir>$(ProjectDir).obj\$(Configuration)\</IntDir>
     <TargetName>SA.IniFiles</TargetName>
-    <TargetExt>.cleo</TargetExt>
+    <TargetExt>.cleo5</TargetExt>
   </PropertyGroup>
   <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">
     <OutDir>$(SolutionDir).output\</OutDir>
     <IntDir>$(ProjectDir).obj\$(Configuration)\</IntDir>
     <TargetName>SA.IniFiles</TargetName>
-    <TargetExt>.cleo</TargetExt>
+    <TargetExt>.cleo5</TargetExt>
   </PropertyGroup>
   <PropertyGroup>
     <LocalDebuggerCommand>$(GTA_SA_DIR)\gta_sa.exe</LocalDebuggerCommand>

diff --git a/cleo_plugins/Math/Math.vcxproj b/cleo_plugins/Math/Math.vcxproj
@@ -45,13 +45,13 @@
     <OutDir>$(SolutionDir).output\</OutDir>
     <IntDir>$(ProjectDir).obj\$(Configuration)\</IntDir>
     <TargetName>SA.Math</TargetName>
-    <TargetExt>.cleo</TargetExt>
+    <TargetExt>.cleo5</TargetExt>
   </PropertyGroup>
   <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">
     <OutDir>$(SolutionDir).output\</OutDir>
     <IntDir>$(ProjectDir).obj\$(Configuration)\</IntDir>
     <TargetName>SA.Math</TargetName>
-    <TargetExt>.cleo</TargetExt>
+    <TargetExt>.cleo5</TargetExt>
   </PropertyGroup>
   <PropertyGroup>
     <LocalDebuggerCommand>$(GTA_SA_DIR)\gta_sa.exe</LocalDebuggerCommand>

diff --git a/cleo_plugins/MemoryOperations/AntiHacks.h b/cleo_plugins/MemoryOperations/AntiHacks.h
@@ -0,0 +1,32 @@
+#pragma once
+#include "CLEO.h"
+//#include "CFileMgr.h"
+#include <string>
+
+namespace AntiHacks
+{
+	// checks if specific function call should be allowed. Performs replacement action if needed
+	static bool CheckCall(CLEO::CRunningScript* thread, void* function, void* object, CLEO::SCRIPT_VAR* args, size_t argCount, DWORD& result)
+	{
+		switch ((size_t)function)
+		{
+			case 0x005387D0: // CFileMgr::SetDir(const char* relPath) // TODO: get the address from Plugin SDK
+			{
+				// some older mods use CFileMgr::SetDir directly instead of 0A99 opcode. In older CLEO versions 0A99 supported only few predefined locations
+				auto resolved = std::string(args[0].pcParam);
+				resolved.resize(511);
+				CLEO_ResolvePath(thread, resolved.data(), resolved.size());
+
+				CLEO::CLEO_SetScriptWorkDir(thread, resolved.c_str());
+				return false;
+			}
+			break;
+
+			default:
+				break;
+		}
+
+		return true; // allow
+	}
+};
+
diff --git a/cleo_plugins/MemoryOperations/MemoryOperations.cpp b/cleo_plugins/MemoryOperations/MemoryOperations.cpp
@@ -1,5 +1,6 @@
 #include "CLEO.h"
 #include "CLEO_Utils.h"
+#include "AntiHacks.h"
 #include "plugin.h"
 #include "CTheScripts.h"
 #include <filesystem>
@@ -152,25 +153,28 @@ class MemoryOperations
             }
         }
 
-        DWORD result;
-        _asm
-        {
-            // transfer args to stack
-            lea ecx, arguments
-            call_func_loop :
-            cmp ecx, arguments_end
-                jae call_func_loop_end
-                push[ecx]
-                add ecx, 0x4
-                jmp call_func_loop
-                call_func_loop_end :
-
-            // call function
-            mov ecx, obj
-                xor eax, eax
-                call func
-                mov result, eax // get result
-                add esp, numPop // cleanup stack
+        DWORD result = 0;
+        if (AntiHacks::CheckCall(thread, func, obj, scriptParams, numArg, result))
+        {
+            _asm
+            {
+                // transfer args to stack
+                lea ecx, arguments
+                call_func_loop :
+                cmp ecx, arguments_end
+                    jae call_func_loop_end
+                    push[ecx]
+                    add ecx, 0x4
+                    jmp call_func_loop
+                    call_func_loop_end :
+
+                // call function
+                mov ecx, obj
+                    xor eax, eax
+                    call func
+                    mov result, eax // get result
+                    add esp, numPop // cleanup stack
+            }
         }
 
         if (returnArg)

diff --git a/cleo_plugins/MemoryOperations/MemoryOperations.vcxproj b/cleo_plugins/MemoryOperations/MemoryOperations.vcxproj
@@ -46,13 +46,13 @@
     <OutDir>$(SolutionDir).output\</OutDir>
     <IntDir>$(ProjectDir).obj\$(Configuration)\</IntDir>
     <TargetName>SA.MemoryOperations</TargetName>
-    <TargetExt>.cleo</TargetExt>
+    <TargetExt>.cleo5</TargetExt>
   </PropertyGroup>
   <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">
     <OutDir>$(SolutionDir).output\</OutDir>
     <IntDir>$(ProjectDir).obj\$(Configuration)\</IntDir>
     <TargetName>SA.MemoryOperations</TargetName>
-    <TargetExt>.cleo</TargetExt>
+    <TargetExt>.cleo5</TargetExt>
   </PropertyGroup>
   <PropertyGroup>
     <LocalDebuggerCommand>$(GTA_SA_DIR)\gta_sa.exe</LocalDebuggerCommand>
@@ -148,6 +148,7 @@ if defined GTA_SA_DIR (
   <ItemGroup>
     <ClInclude Include="..\..\cleo_sdk\CLEO.h" />
     <ClInclude Include="..\..\cleo_sdk\CLEO_Utils.h" />
+    <ClInclude Include="AntiHacks.h" />
   </ItemGroup>
   <ItemGroup>
     <ResourceCompile Include="..\Resource.rc" />

diff --git a/cleo_plugins/MemoryOperations/MemoryOperations.vcxproj.filters b/cleo_plugins/MemoryOperations/MemoryOperations.vcxproj.filters
@@ -39,6 +39,7 @@
     <ClInclude Include="..\..\cleo_sdk\CLEO_Utils.h">
       <Filter>cleo_sdk</Filter>
     </ClInclude>
+    <ClInclude Include="AntiHacks.h" />
   </ItemGroup>
   <ItemGroup>
     <ResourceCompile Include="..\Resource.rc" />

diff --git a/cleo_plugins/Text/Text.vcxproj b/cleo_plugins/Text/Text.vcxproj
@@ -45,13 +45,13 @@
     <OutDir>$(SolutionDir).output\</OutDir>
     <IntDir>$(ProjectDir).obj\$(Configuration)\</IntDir>
     <TargetName>SA.Text</TargetName>
-    <TargetExt>.cleo</TargetExt>
+    <TargetExt>.cleo5</TargetExt>
   </PropertyGroup>
   <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">
     <OutDir>$(SolutionDir).output\</OutDir>
     <IntDir>$(ProjectDir).obj\$(Configuration)\</IntDir>
     <TargetName>SA.Text</TargetName>
-    <TargetExt>.cleo</TargetExt>
+    <TargetExt>.cleo5</TargetExt>
   </PropertyGroup>
   <PropertyGroup>
     <LocalDebuggerCommand>$(GTA_SA_DIR)\gta_sa.exe</LocalDebuggerCommand>

diff --git a/modloader_plugin/CLEO_ModLoader_Plugin.sln b/modloader_plugin/CLEO_ModLoader_Plugin.sln
@@ -0,0 +1,25 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 17
+VisualStudioVersion = 17.4.33213.308
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "CLEO_ModLoader_Plugin", "CLEO_ModLoader_Plugin.vcxproj", "{E04BB51D-A37D-491E-BAA0-D95D0D5C1563}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|x86 = Debug|x86
+		Release|x86 = Release|x86
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{E04BB51D-A37D-491E-BAA0-D95D0D5C1563}.Debug|x86.ActiveCfg = Debug|Win32
+		{E04BB51D-A37D-491E-BAA0-D95D0D5C1563}.Debug|x86.Build.0 = Debug|Win32
+		{E04BB51D-A37D-491E-BAA0-D95D0D5C1563}.Release|x86.ActiveCfg = Release|Win32
+		{E04BB51D-A37D-491E-BAA0-D95D0D5C1563}.Release|x86.Build.0 = Release|Win32
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(ExtensibilityGlobals) = postSolution
+		SolutionGuid = {27E214E3-AE89-40E1-9B76-0C5C9DB3452C}
+	EndGlobalSection
+EndGlobal