feat: IL2CPP types translation, Mod overlay API, file logging, build script, bilingual docs

Added:
- Il2Cpp/: Core/Types/Reflection/Unity/Coroutine/RuntimeInvokeHook C# translation
- IModPlugin: OnBackgroundGUI/OnForegroundGUI(ImDrawListPtr) overlay draw API
- Managed.cs: file logging (manager.log) + Benchmark startup timing
- AndroidUtils: GetInternalFilesDir/GetExternalFilesDir
- Scripts/build_release.sh: one-shot AAR + modmanager.tar.gz build
- ModManagerJsonContext: STJ source-gen context (AOT-compatible)

Docs:
- GET_STARTED.md: bilingual 3-step guide (inject APK → deploy manager → write mod)
- README.md: updated structure reflecting Il2Cpp/Native/Runtime/Manager
- .gitignore: added /release/ output dir
- XML doc comments on all public members (37 items)

Fixes:
- Benchmark: stack-based to fix nested timing overwrite
- ModManagerUI.Panels: migrated to STJ source-gen serialization
- build script: exclude runtimes/ dir (native libs already in AAR)

Author: StArraySharp

.github/workflows/build.yml

@@ -14,6 +14,8 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
+        with:
+          submodules: recursive
 
       - name: Set up JDK 17
         uses: actions/setup-java@v4
@@ -47,6 +49,8 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
+        with:
+          submodules: recursive
 
       - name: Set up .NET 10
         uses: actions/setup-dotnet@v4

.gitignore

@@ -8,6 +8,9 @@
 *.aab
 *.ap_
 
+# Release artifacts
+/release/
+
 # IDE
 .idea/
 *.suo

Android/library/src/main/cpp/core/unity_resolve.cpp

@@ -245,6 +245,16 @@ const char *modmanager_resolve_method_get_param_name(void *method, int index) {
     return m->args[index]->name.c_str();
 }
 
+/**
+ * 获取方法参数类型名（按索引）。
+ */
+const char *modmanager_resolve_method_get_param_type_name(void *method, int index) {
+    if (!method) return "";
+    auto *m = static_cast<UnityResolve::Method*>(method);
+    if (index < 0 || index >= (int)m->args.size()) return "";
+    return m->args[index]->pType ? m->args[index]->pType->name.c_str() : "";
+}
+
 /**
  * 获取方法返回类型名。
  */

GET_STARTED.md

@@ -1,50 +1,123 @@
-# Getting Started
+# Getting Started / 快速开始
 
-## Build
+## 1. Inject into APK / 注入 APK
 
-```bash
-cd Android
-./gradlew :library:assembleRelease
-cd ../StArray.ModManager
-dotnet build -c Release
+Download `library-release.aar` from [Releases](https://github.com/StArraySharp/StArray.ModManager/releases).  
+从 [Releases](https://github.com/StArraySharp/StArray.ModManager/releases) 下载 `library-release.aar`。
+
+⚠️ **Add INTERNET permission in `AndroidManifest.xml`** (required for OTA updates & mod networking)  
+⚠️ **在 `AndroidManifest.xml` 添加网络权限**（OTA 更新和 Mod 联网需要）：
+
+```xml
+<uses-permission android:name="android.permission.INTERNET" />
 ```
 
-Output:
-- `Android/library/build/outputs/aar/library-release.aar`
-- `StArray.ModManager/bin/Release/net10.0/StArray.ModManager.dll`
+```bash
+unzip library-release.aar -d aar_content
+apktool d target.apk -o target_src
+
+# Copy .so → lib/
+cp aar_content/jni/arm64-v8a/*.so target_src/lib/arm64-v8a/
+
+# Copy CoreCLR runtime DLLs → assets/
+cp aar_content/assets/runtime/*.dll target_src/assets/
 
-## Deploy to Device
+# Decompile classes.jar → smali
+java -jar baksmali.jar d aar_content/classes.jar -o target_src/smali/starray/
 
+# Add to UnityPlayerActivity.onCreate:
+#   invoke-static {}, Lstarray/android/modmanager/ModManager;->launch()V
+#
+# ⚠️ launch() defaults to /sdcard/ModManager/. Paths are hardcoded in
+#   ModManager.smali. Modify smali constants if your layout differs,
+#   or use ModManagerUpdater (configurable paths + OTA auto-update).
+#
+# ⚠️ launch() 默认加载 /sdcard/ModManager/。路径硬编码在 ModManager.smali，
+#   如需自定义请修改 smali 内常量，或使用 ModManagerUpdater。
+
+# Repack & sign
+apktool b target_src -o repacked.apk
+uber-apk-signer --apks repacked.apk
 ```
-/sdcard/ModManager/manager/
-  StArray.ModManager.dll        built managed mod
-  *.dll                          deps (ImGui.NET, OpenTK, etc.)
 
-/sdcard/ModManager/runtime/
-  *.dll                          .NET runtime assemblies
+## 2. Deploy Manager / 部署管理器
+
+Place manager DLL and dependencies in `/sdcard/ModManager/manager/`.  
+将管理器 DLL 及依赖放入 `/sdcard/ModManager/manager/`。
+
+| File | From / 来源 |
+|---|---|
+| `StArray.ModManager.dll` | [Releases](https://github.com/StArraySharp/StArray.ModManager/releases) → `modmanager.zip` |
+| `ImGui.NET.dll` | Same dir as StArray.ModManager build output |
+| `OpenTK.Graphics.dll` | 同上 |
+
+Final layout / 最终目录：
+
+```
+/sdcard/ModManager/
+├── manager/
+│   ├── StArray.ModManager.dll
+│   ├── ImGui.NET.dll
+│   ├── OpenTK.Graphics.dll
+│   └── modmanager_config.json    （auto-generated / 自动生成）
+└── mods/
+    └── {YourModName}/
+        ├── {YourModName}.dll
+        └── ...
 ```
 
-Runtime DLLs: [runtime-references release](https://github.com/StArraySharp/StArray.ModManager/releases/tag/0)
+## 3. Write a Mod / 写一个 Mod
 
-## Inject into APK
+Reference `StArray.ModManager.dll` → implement `IModPlugin` → build DLL → drop into `mods/{ModName}/`.  
+引用 `StArray.ModManager.dll` → 实现 `IModPlugin` → 编译 DLL → 放入 `mods/{ModName}/`。
 
-```bash
-apktool d target.apk -o target_src
+```csharp
+using StArray.ModManager.Runtime;
+using System.Numerics;
+using ImGuiNET;
+
+public class HelloMod : IModPlugin
+{
+    public string Id => "com.example.hello";
+    public string Name => "Hello";
+    public string Version => "1.0.0";
+    public string Author => "you";
+    public string Description => "demo";
+    public IReadOnlyList<string> Dependencies => Array.Empty<string>();
+
+    public void OnLoad() { }
+    public void OnUnload() { }
+
+    // Draw HUD overlay on game screen / 在游戏画面上叠加 HUD
+    public void OnForegroundGUI(ImDrawListPtr drawList)
+    {
+        drawList.AddText(new Vector2(10, 10), 0xFFFFFFFF, $"FPS: {ImGui.GetIO().Framerate:F0}");
+    }
+}
 ```
 
-Copy `.so` files to `target_src/lib/arm64-v8a/`:
-- From AAR: `libmodmanager.so`, `libmonodroid.so`, `libcimgui.so`
-- CoreCLR: `libcoreclr.so`, `libclrjit.so`, `libSystem.Native.so`, etc.
+### Optional interfaces / 可选接口
 
-Add to `UnityPlayerActivity.smali` onCreate:
+```csharp
+interface IModSettings { void OnGui(); }                    // Custom settings tab / 自定义设置页
+interface IModSettingCustomDraw { void DrawInspector(); }   // Custom inspector / 自定义检查器
+```
+
+### Field attributes / 设置特性
+
+```csharp
+[ModSettingLabel("Health Multiplier / 血量倍率")]
+[ModSettingRange(0.1f, 10f)]
+public float HealthMultiplier = 1f;
 
-```smali
-invoke-static {}, Lstarray/android/modmanager/ModManager;->launch()V
+[ModSettingLabelSide(ModInspector.LabelSide.Left)]
+[ModSettingJson(Lines = 10)]
+public string JsonConfig = "{}";
 ```
 
-Add `smali/starray/android/modmanager/ModManager.smali` and `ModManager$1.smali` from the AAR.
+### Overlay drawing / Overlay 绘制
 
-```bash
-apktool b target_src -o repacked.apk
-uber-apk-signer --apks repacked.apk
+```csharp
+void OnBackgroundGUI(ImDrawListPtr d) { }  // Behind ImGui windows / 窗口下方 (watermark / 水印)
+void OnForegroundGUI(ImDrawListPtr d) { }  // Above ImGui windows / 窗口上方 (HUD)
 ```

README.md

@@ -13,58 +13,48 @@ Android IL2CPP Unity mod manager with CoreCLR runtime embedding and ImGui overla
 ## Project Structure
 
 ```
-StArray.ModManager/          C# mod manager (.NET 10)
-  UI/
-    ImGuiRender.cs           EGL rendering + GL debug panel + rainbow shader
-    ImGuiEGLRender.cs        EGL renderer (IImGuiRenderer, split architecture)
-    ImGuiInputHandler.cs     Touch/key hooks + IME callback bridge
-    ImGuiVulkanRenderer.cs   Vulkan renderer (experimental)
-    ModManagerUI.cs          ImGui mod manager UI
-    IImGuiRenderer.cs        Renderer interface
-    FontAwesome7.cs          FA7 icon codepoints
-  PInvoke/
-    Dobby.cs                 Inline hook wrapper
-    DL.cs                    dlopen/dlsym
-    JniHelperNative.cs       JNI ↔ C data bridge
-    ImGuiBackends.cs         cimgui P/Invoke (OpenGL3, Android, Vulkan)
-    Misc.cs                  C callback registration
-    AndroidLog.cs            Logcat logging
-    UnityResolve.cs          IL2CPP reflection engine
-  Manager/
-    MotionEventHook.cs       InputConsumer hook
-    AndroidIME.cs            IME manager
-  Unity/
-    UnitySurfaceHelper.cs    ANativeWindow from Unity SurfaceView
-  Mono.cs                    CoreCLR entry point (old)
-  Managed.cs                 CoreCLR entry with argc/argv
-
-Android/library/             Native library (libmodmanager.so)
-  src/main/cpp/core/
-    dobby_hook.cpp           Dobby inline hook
-    mono_droid_coreclr.c     CoreCLR embedding + args delegate
-    jni_helper.c             JNI helpers, data bridge, C callback dispatch
-    unity_resolve.cpp        Unity symbol resolution
+StArray.ModManager/              C# mod manager (.NET 10)
+  Managed.cs                     CoreCLR entry – Logger桥接 → 扫描Mod → 启动ImGui
+  Il2Cpp/                        IL2CPP 内部类型 C# 翻译
+    Core.cs / Types.cs           Vector2/3/4, Quaternion, Il2CppString, Il2CppArray<T> 等
+    Reflection.cs                Il2CppAssembly, Il2CppClass, Il2CppMethod, Il2CppField
+    Unity.cs                     UnityObject, Component, Transform, GameObject, Camera
+    Coroutine.cs
+  Inspector/                     ImGui 自动检查器 + 设置特性（[ModSettingRange] 等）
+  Manager/                       核心逻辑
+    ModLoader.cs                 Mod 扫描/加载/卸载/状态管理
+    ModManagerUI.cs              ImGui 主面板 + 设置窗口 + Overlay 背景/前景渲染
+    ModManagerConfig.cs          全局配置 JSON 持久化（STJ 源生成）
+    Logger.cs                    统一日志 → logcat + 文件双写
+    Benchmark.cs                 栈式嵌套计时
+  Native/                        原生绑定（Dobby, DL, JNI, AndroidUtils, UnityResolve）
+  Runtime/                       Mod 接口
+    IModPlugin.cs                OnLoad/OnUnload/OnBackgroundGUI/OnForegroundGUI
+    IModSettings.cs / IModSettingCustomDraw.cs
+  UI/                            ImGui EGL/Vulkan 渲染器 + 输入处理 + FA7 图标
+
+Android/library/                 原生库 (libmodmanager.so)
+  src/main/cpp/core/             Dobby hook / CoreCLR 嵌入 / JNI helper / UnityResolve
   src/main/java/
-    MonoRunner.java          CoreCLR launcher (supports args)
-    ModManagerUtils.java     KeyboardView IME + InputConnection bridge
-
-Android/launcher/            Smali launcher module
-  src/main/smali/            ModManager.smali, ModManager$1.smali
-
-TestAndroidProject/          Test Unity app (IL2CPP, arm64-v8a)
+    ModManager.java              CoreCLR 启动器
+    ModManagerUpdater.java       OTA 自动更新（CompletableFuture + AlertDialog）
+    ModManagerUtils.java         IME KeyboardView + InputConnection
 ```
 
 ## Features
 
 - **EGL SwapBuffers hook** with Dobby — renders ImGui overlay every frame
 - **Touch & key input** via InputConsumer hooks + cimgui Android backend
 - **IME support** (Chinese/Japanese) via custom KeyboardView + InputConnection bridge
-- **C→C# callback pipeline** — Java `commitText` → native `nativeSendChar` → C# `AddInputCharacter` in real time
-- **GL debug panel** — caps toggles (depth, blend, cull, etc.), blend/depth func selectors, GL state queries, viewport info
-- **Rainbow text shader** — custom GLSL shader applied via ImDrawList callbacks
+- **Mod system** — scan/load/unload with dependency resolution + auto-enable on restart
+- **Mod overlay API** — `OnBackgroundGUI` / `OnForegroundGUI` for direct game-screen drawing
+- **Auto-update** — OTA version check + download + SHA-256 verification + restart
+- **Config persistence** — STJ source-gen JSON, AOT-compatible
+- **File logging** — dual-write to logcat + `manager.log`
+- **GL debug panel** — caps toggles, blend/depth func selectors, GL state queries
 - **FontAwesome 7** icon support via embedded resource
 - **IImGuiRenderer** interface — swap between EGL, Vulkan backends
-- **CoreCLR args** — pass `string[]` from Java `MonoRunner.run()` to managed `Entry(int, IntPtr)`
+- **CoreCLR args** — pass `string[]` from Java to managed `Entry(int, IntPtr)`
 
 ## Build
 

Scripts/build_release.sh

@@ -0,0 +1,41 @@
+#!/bin/bash
+set -e
+
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+echo "=== Build Release ==="
+echo "Root: $ROOT"
+
+# 1. Build native library (AAR)
+echo ""
+echo "--- [1/3] Android AAR ---"
+cd "$ROOT/Android"
+./gradlew :library:assembleRelease -q
+AAR_SRC="$ROOT/Android/library/build/outputs/aar/library-release.aar"
+AAR_DST="$ROOT/release/library-release.aar"
+mkdir -p "$ROOT/release"
+cp "$AAR_SRC" "$AAR_DST"
+echo "  → $AAR_DST"
+
+# 2. Build .NET mod manager
+echo ""
+echo "--- [2/3] .NET ModManager ---"
+cd "$ROOT/StArray.ModManager"
+dotnet build -c Release
+DLL_DIR="$ROOT/StArray.ModManager/bin/Release/net10.0"
+echo "  DLLs in: $DLL_DIR"
+ls -1 "$DLL_DIR"/*.dll | while read f; do echo "    $(basename "$f")"; done
+
+# 3. Package manager tar (exclude runtimes/)
+echo ""
+echo "--- [3/3] modmanager.tar ---"
+TAR_DST="$ROOT/release/modmanager.tar"
+rm -f "$TAR_DST"
+cd "$DLL_DIR"
+tar cf "$TAR_DST" --exclude='runtimes' *.dll
+gzip -f "$TAR_DST"
+echo "  → ${TAR_DST}.gz ($(du -h "${TAR_DST}.gz" | cut -f1))"
+
+echo ""
+echo "=== Done ==="
+echo "  AAR:    $AAR_DST"
+echo "  TAR:    $TAR_DST.gz"