feat(windows): multi-backend D3D hook with CMake + kiero2

- Replace vcxproj with CMake + MinGW build for native DLL
- Add kiero2 & minhook as git submodules (D3D9/11/12/GL/VK support)
- Implement C# bridge via ImGuiRenderer + NativeApi with P/Invoke callbacks
- Use cimgui.dll for ImGui backend calls (no ImGui .cpp compiled in)
- D3D12: descriptor heap + cmdList rendering
- D3D11: Device + Context rendering
- D3D9: Device rendering
- GL/VK: detection only, C# render without GPU submit
- CI: switch to windows-latest + MSYS2 MinGW, single dotnet build step
- csproj: auto-invoke CMake before build, remove test copy targets
- Remove all debug Log() calls, cleanup unused typedefs
- Update README with multi-backend arch, third-party libs, Corehold guide
- Update GET_STARTED with Windows DLL hijack instructions via Corehold

Author: StArraySharp

.github/workflows/build.yml

@@ -43,24 +43,38 @@ jobs:
           name: library-release.aar
           path: Android/library/build/outputs/aar/library-release.aar
 
-  # ──── Windows .NET DLL ────
+  # ──── Windows Native + .NET DLL ────
   windows:
-    name: Windows DLL
-    runs-on: ubuntu-latest
+    name: Windows
+    runs-on: windows-latest
+    defaults:
+      run:
+        shell: bash
     steps:
       - uses: actions/checkout@v4
         with:
           submodules: recursive
 
+      - name: Set up MSYS2 (MinGW)
+        uses: msys2/setup-msys2@v2
+        with:
+          msystem: mingw64
+          update: true
+          install: >-
+            mingw-w64-x86_64-gcc
+            mingw-w64-x86_64-cmake
+            mingw-w64-x86_64-toolchain
+
       - name: Set up .NET 10
         uses: actions/setup-dotnet@v4
         with:
           dotnet-version: '10.0.x'
 
-      - name: Build Windows
+      - name: Build (native + C#)
+        shell: msys2 {0}
         run: dotnet build StArray.ModManager.Windows/StArray.ModManager.Windows.csproj -c Release
 
-      - name: Package output (exclude runtimes)
+      - name: Package
         run: |
           src="StArray.ModManager.Windows/bin/Release/net10.0"
           dst="artifacts"
@@ -69,7 +83,7 @@ jobs:
           rm -rf "$dst/runtimes"
           cd "$dst" && zip -r ../windows-dll.zip . && cd ..
 
-      - name: Upload Windows DLL
+      - name: Upload
         uses: actions/upload-artifact@v4
         with:
           name: windows-dll.zip

.gitignore

@@ -8,6 +8,11 @@
 *.aab
 *.ap_
 
+# Native generated
+StArray.ModManager.Windows/Native/build/
+StArray.ModManager.Windows/Native/cimgui.def
+StArray.ModManager.Windows/Native/libcimgui.a
+
 # Release artifacts
 /release/
 

.gitmodules

@@ -1,3 +1,9 @@
 [submodule "Android/library/src/main/cpp/libs/cimgui"]
 	path = Android/library/src/main/cpp/libs/cimgui
 	url = https://github.com/cimgui/cimgui.git
+[submodule "StArray.ModManager.Windows/Native/kiero2"]
+	path = StArray.ModManager.Windows/Native/kiero2
+	url = https://github.com/kirchesz/kiero2.git
+[submodule "StArray.ModManager.Windows/Native/minhook"]
+	path = StArray.ModManager.Windows/Native/minhook
+	url = https://github.com/TsudaKageyu/minhook

GET_STARTED.md

@@ -1,6 +1,58 @@
 # Getting Started / 快速开始
 
-## 1. Inject into APK / 注入 APK
+## Windows / Windows 注入
+
+通过 [Corehold](https://github.com/StArraySharp/Corehold) 的 `winmm.dll` 代理劫持自动加载 CoreCLR。
+
+### 构建
+
+```bash
+git clone --recurse-submodules https://github.com/StArraySharp/StArray.ModManager.git
+dotnet build StArray.ModManager.Windows -c Release
+```
+
+### 部署
+
+```bash
+# 1. 下载 Corehold 的 winmm.dll + Corehold/ 模板
+#    https://github.com/StArraySharp/Corehold/releases
+
+# 2. 放入游戏 .exe 同目录
+GameFolder/
+├── Game.exe
+├── winmm.dll                          # Corehold 代理 DLL
+└── Corehold/
+    ├── corehold.json
+    ├── managed/                        # 放入我们的 DLL
+    │   ├── StArray.ModManager.dll
+    │   ├── StArray.ModManager.Windows.dll
+    │   ├── StArray.ModManager.Windows.Native.dll
+    │   ├── cimgui.dll
+    │   └── ImGui.NET.dll
+    └── runtime/                        # 首次启动自动下载 .NET
+```
+
+### corehold.json
+
+```json
+{
+    "enabled": true,
+    "console_enabled": true,
+    "runtime_path": "Corehold/runtime/",
+    "coreclr_path": "Corehold/runtime/coreclr.dll",
+    "target_assembly_path": "Corehold/managed/StArray.ModManager.Windows.dll",
+    "entry_point_method": "StArray.ModManager.Windows.Managed.Entry",
+    "entrypoint_string_args": ["Corehold/mods"]
+}
+```
+
+### 运行
+
+启动游戏 → `winmm.dll` 被加载 → Corehold 初始化 CoreCLR →
+`Managed.Entry` 调用 `NativeApi.Init` → kiero 检测 D3D9/11/12 →
+MinHook 钩 `Present` → C# 回调渲染 ImGui → 按 `INSERT` 打开菜单
+
+## Android (IL2CPP Unity) / Android 注入
 
 Download `library-release.aar` from [Releases](https://github.com/StArraySharp/StArray.ModManager/releases).  
 从 [Releases](https://github.com/StArraySharp/StArray.ModManager/releases) 下载 `library-release.aar`。
@@ -40,7 +92,7 @@ apktool b target_src -o repacked.apk
 uber-apk-signer --apks repacked.apk
 ```
 
-## 2. Deploy Manager / 部署管理器
+## 2. Deploy Manager (Android) / 部署管理器
 
 Place manager DLL and dependencies in `/sdcard/ModManager/manager/`.  
 将管理器 DLL 及依赖放入 `/sdcard/ModManager/manager/`。
@@ -66,7 +118,7 @@ Final layout / 最终目录：
         └── ...
 ```
 
-## 3. Write a Mod / 写一个 Mod
+## 3. Write a Mod / 写 Mod (跨平台)
 
 Reference `StArray.ModManager.dll` → implement `IModPlugin` → build DLL → drop into `mods/{ModName}/`.  
 引用 `StArray.ModManager.dll` → 实现 `IModPlugin` → 编译 DLL → 放入 `mods/{ModName}/`。

README.md

@@ -56,28 +56,70 @@ Android/library/                 原生库 (libmodmanager.so)
 - **IImGuiRenderer** interface — swap between EGL, Vulkan backends
 - **CoreCLR args** — pass `string[]` from Java to managed `Entry(int, IntPtr)`
 
+## Third-Party Libraries
+
+| Library | License | Used In |
+|---------|---------|---------|
+| [Dear ImGui](https://github.com/ocornut/imgui) | MIT | UI rendering |
+| [cimgui](https://github.com/cimgui/cimgui) | MIT | ImGui C API bindings |
+| [ImGui.NET](https://github.com/ImGuiNET/ImGui.NET) | MIT | C# ImGui bindings |
+| [kiero2](https://github.com/kirchesz/kiero2) | MIT | Graphics API detection (D3D9/11/12/GL/VK) |
+| [MinHook](https://github.com/TsudaKageyu/minhook) | BSD-2 | API hooking |
+| [Corehold](https://github.com/StArraySharp/Corehold) | MIT | winmm proxy DLL + CoreCLR hosting |
+| [Dobby](https://github.com/jmpews/Dobby) | Apache-2.0 | Android inline hook |
+| [CoreCLR](https://github.com/dotnet/runtime) | MIT | .NET runtime |
+| [FontAwesome 7](https://fontawesome.com) | OFL/SIL | Icon font |
+
 ## Build
 
-Requires .NET 10 SDK and Android NDK 27+.
+Requires .NET 10 SDK + MinGW (gcc/cmake on PATH).
 
 ```bash
-# Build C# mod manager
-cd StArray.ModManager
-dotnet build -c Release
+# Windows (native + C#, one command)
+dotnet build StArray.ModManager.Windows -c Release
+
+# Android
+cd Android && ./gradlew :library:assembleRelease
+```
 
-# Build Android native library
-cd Android
-./gradlew :library:assembleRelease
+## Windows Architecture
+
+The Windows native DLL (`StArray.ModManager.Windows.Native.dll`) uses
+[kiero2](https://github.com/kirchesz/kiero2) + [MinHook](https://github.com/TsudaKageyu/minhook) to
+detect and hook the game's graphics API at runtime.
+
+| Backend | Support |
+|---------|---------|
+| D3D12 | Descriptor heap + Command list |
+| D3D11 | Device + Context |
+| D3D9  | Device |
+| OpenGL / Vulkan | Detected only |
+
+The C# side (`ImGuiRenderer`) is backend-agnostic — it provides init/shutdown/render callbacks and
+the native DLL handles all platform-specific `ImGui_Impl*` setup.
+
+```mermaid
+flowchart LR
+    CSharp[C# ImGuiRenderer] -->|P/Invoke Init| Native[Native DLL]
+    Native -->|kiero| API[D3D9/11/12]
+    API -->|MinHook| Present[Present Hook]
+    Present -->|callback| CSharp
+    CSharp -->|ImGui.NET| cimgui[cimgui.dll]
 ```
 
 ## Target
 
-- Android arm64-v8a
-- IL2CPP Unity games (API 26+)
+- Windows x64 (D3D9/11/12) — DLL injection or CoreCLR hosting
+- Android arm64-v8a (OpenGL ES) — IL2CPP Unity games (API 26+)
 - CoreCLR .NET 10 runtime
 
 ## Getting Started
 
+```bash
+git clone --recurse-submodules https://github.com/StArraySharp/StArray.ModManager.git
+dotnet build StArray.ModManager.Windows -c Release
+```
+
 See [GET_STARTED.md](GET_STARTED.md) for injection and build instructions.
 
 Runtime assemblies can be downloaded from the [runtime-references release](https://github.com/StArraySharp/StArray.ModManager/releases/tag/0).

StArray.ModManager.Windows/Managed.cs

@@ -66,8 +66,10 @@ public static int Entry(int argc, IntPtr argv)
         Logger.Info($"{nameof(Managed)}-Benchmark", $"Path resolve: {Benchmark.End():F3}s");
         Il2CppFunctions.SetIl2CppLibraryPath(Path.Combine(new DirectoryInfo(modsPath).Parent.Parent.FullName,"GameAssembly.dll"));
         ModManagerUI modManagerUI = new(new ModLoader(modsPath), Path.GetDirectoryName(AssemblyPath));
-        ImGUIGLRenderer.OnRender += modManagerUI.Render;
-        ImGUIGLRenderer.Install();
+
+        // Use DX12 renderer — hooks IDXGISwapChain::Present via vtable + MinHook
+        ImGuiRenderer.OnRender += modManagerUI.Render;
+        ImGuiRenderer.Install();
         totalSw.Stop();
         Logger.Info($"{nameof(Managed)}-Benchmark", $"=== Startup total: {totalSw.Elapsed.TotalSeconds:F3}s ===");
         return 0;

StArray.ModManager.Windows/Native/CMakeLists.txt

@@ -0,0 +1,45 @@
+cmake_minimum_required(VERSION 3.20)
+project(StArray.ModManager.Windows.Native LANGUAGES C CXX)
+
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+
+if(MSVC)
+    set(CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")
+endif()
+
+# ---- MinHook (submodule, static lib) ----
+add_library(MinHook STATIC
+    minhook/src/buffer.c
+    minhook/src/hook.c
+    minhook/src/trampoline.c
+    minhook/src/hde/hde32.c
+    minhook/src/hde/hde64.c
+)
+target_include_directories(MinHook PUBLIC minhook/include)
+target_compile_definitions(MinHook PRIVATE _CRT_SECURE_NO_WARNINGS)
+
+# ---- kiero2 (submodule, static lib, all backends except D3D10) ----
+add_library(kiero STATIC
+    kiero2/kiero_intern.cpp
+    kiero2/kiero_d3d9.cpp
+    kiero2/kiero_d3d11.cpp
+    kiero2/kiero_d3d12.cpp
+    kiero2/kiero_opengl.cpp
+    kiero2/kiero_vulkan.cpp
+)
+target_include_directories(kiero PUBLIC kiero2)
+target_compile_definitions(kiero PRIVATE KIERO_BUILD_D3D9 KIERO_BUILD_D3D11 KIERO_BUILD_D3D12 KIERO_BUILD_OPENGL KIERO_BUILD_VULKAN)
+
+# ---- Main hook DLL ----
+add_library(${PROJECT_NAME} SHARED main.cpp)
+set_target_properties(${PROJECT_NAME} PROPERTIES PREFIX "")  # no "lib" prefix
+target_include_directories(${PROJECT_NAME} PRIVATE . kiero2 minhook/include)
+target_link_libraries(${PROJECT_NAME} PRIVATE kiero MinHook d3d12 dxgi ${CMAKE_CURRENT_SOURCE_DIR}/libcimgui.a)
+
+# Copy DLL to C# build output
+add_custom_command(TARGET ${PROJECT_NAME} POST_BUILD
+    COMMAND ${CMAKE_COMMAND} -E copy_if_different
+        "$<TARGET_FILE:${PROJECT_NAME}>"
+        "${CMAKE_CURRENT_SOURCE_DIR}/../bin/${CMAKE_BUILD_TYPE}/net10.0/"
+)

StArray.ModManager.Windows/Native/cimconfig.h

@@ -0,0 +1 @@
+#undef NDEBUG