refactor: input system overhaul, GL debug panel, IME callback bridge

- Add FontAwesome embedded resource (fa-solid-900.ttf)
- Implement KeyboardView-based IME with nativeSendChar/nativeSendKey callbacks
- Remove initializeKeyEvent hook; key events now flow through C→C# callback
- Add GL debug panel with caps toggles, blend/depth/cull params, Info tab
- Add rainbow text shader (HSL gradient, merges with font atlas)
- Add UI scale / scrollbar width / slider size controls
- Fix UnmanagedCallersOnly out/ref parameter violations
- Fix SIGBUS from per-frame FindViaClassLoader (cache JavaClass singleton)
- Update GET_STARTED.md: Runtime/ directory not in repo, document external deps

Author: StArraySharp

.gitignore

@@ -46,7 +46,7 @@ TestAndroidProject/
 TestAndroidProject2/
 
 # Runtime data (mods, etc — user-managed)
-Runtime/
+/Runtime/
 
 # Gradle-copied assets (generated by build)
 **/src/main/assets/*.dll

Android/build.gradle

@@ -1,4 +1,4 @@
-// Top-level build file for StArray.ModLoader Android AAR library
+// Top-level build file for StArray.ModManager Android AAR library
 plugins {
     id 'com.android.library' version '8.10.0' apply false
 }

Android/library/build.gradle

@@ -3,7 +3,7 @@ plugins {
 }
 
 android {
-    namespace 'starray.android.modloader'
+    namespace 'starray.android.modmanager'
     compileSdk 35
     ndkVersion "27.2.12479018"
 

Android/library/consumer-rules.pro

@@ -1,11 +1,11 @@
-# Consumer ProGuard rules for StArray.ModLoader AAR library.
+# Consumer ProGuard rules for StArray.ModManager AAR library.
 # These rules are included when the AAR is consumed by an application.
 # See https://developer.android.com/studio/projects/android-library#considerations
 
-# Keep ModLoader public API
--keep class starray.android.modloader.ModLoader {
+# Keep ModManager public API
+-keep class starray.android.modmanager.ModManager {
     public *;
 }
--keep class starray.android.modloader.ModLoaderNative {
+-keep class starray.android.modmanager.ModManagerNative {
     native <methods>;
 }

Android/library/proguard-rules.pro

@@ -7,5 +7,5 @@
     native <methods>;
 }
 
-# Keep ModLoader API
--keep class starray.android.modloader.** { *; }
+# Keep ModManager API
+-keep class starray.android.modmanager.** { *; }

Android/library/src/main/AndroidManifest.xml

@@ -5,7 +5,7 @@
 
     <application>
         <meta-data
-            android:name="starray.modloader.version"
+            android:name="starray.modmanager.version"
             android:value="1.0.0" />
     </application>
 

Android/library/src/main/cpp/CMakeLists.txt

@@ -2,7 +2,7 @@
 cmake_minimum_required(VERSION 3.22.1)
 
 # Project name and version
-project("modloader" VERSION 1.0.0 LANGUAGES C CXX)
+project("modmanager" VERSION 1.0.0 LANGUAGES C CXX)
 
 # ---- Build options ----
 set(CMAKE_C_STANDARD 11)
@@ -21,7 +21,7 @@ endif()
 add_compile_options(-Wno-deprecated-declarations)
 
 # ---- Source files ----
-set(MODLOADER_SOURCES
+set(MODMANAGER_SOURCES
     core/dobby_hook.cpp
     core/unity_resolve.cpp
     core/jni_helper.c
@@ -31,8 +31,8 @@ set(MONODROID_SOURCES
     core/mono_droid_coreclr.c
 )
 
-# ---- libmodloader.so (Dobby + UnityResolve + log_write) ----
-add_library(modloader SHARED ${MODLOADER_SOURCES})
+# ---- libmodmanager.so (Dobby + UnityResolve + log_write) ----
+add_library(modmanager SHARED ${MODMANAGER_SOURCES})
 
 # ---- libmonodroid.so (CoreCLR JNI host) ----
 add_library(monodroid SHARED ${MONODROID_SOURCES})
@@ -84,8 +84,8 @@ set_property(DIRECTORY APPEND PROPERTY ADDITIONAL_CLEAN_FILES
     "${CIMGUI_DIR}/.backends_patched"
 )
 
-# ---- Include directories (modloader) ----
-target_include_directories(modloader
+# ---- Include directories (modmanager) ----
+target_include_directories(modmanager
     PRIVATE
         ${CMAKE_CURRENT_SOURCE_DIR}
         ${CMAKE_CURRENT_SOURCE_DIR}/core
@@ -102,22 +102,22 @@ target_include_directories(monodroid
         ${CMAKE_CURRENT_SOURCE_DIR}/libs/coreclr/include
 )
 
-# ---- Link libraries (modloader) ----
+# ---- Link libraries (modmanager) ----
 find_library(log-lib log)
 
-target_link_libraries(modloader
+target_link_libraries(modmanager
     ${log-lib}
     dobby
     cimgui
     android
 )
 
-# ---- Post-build: copy libcimgui.so alongside libmodloader.so ----
-add_custom_command(TARGET modloader POST_BUILD
+# ---- Post-build: copy libcimgui.so alongside libmodmanager.so ----
+add_custom_command(TARGET modmanager POST_BUILD
     COMMAND ${CMAKE_COMMAND} -E copy_if_different
         "$<TARGET_FILE:cimgui>"
-        "$<TARGET_FILE_DIR:modloader>/libcimgui.so"
-    COMMENT "Copying libcimgui.so to modloader output"
+        "$<TARGET_FILE_DIR:modmanager>/libcimgui.so"
+    COMMENT "Copying libcimgui.so to modmanager output"
 )
 
 # ---- Link libraries (monodroid) ----

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

@@ -4,14 +4,14 @@
 
 #include <dobby.h>
 
-#define LOG_TAG "StArray.ModLoader.Dobby"
+#define LOG_TAG "StArray.ModManager.Dobby"
 #define LOGI(...) __android_log_print(ANDROID_LOG_INFO,  LOG_TAG, __VA_ARGS__)
 #define LOGE(...) __android_log_print(ANDROID_LOG_ERROR, LOG_TAG, __VA_ARGS__)
 
 // ============================================================================
 // C ABI exports for P/Invoke from C# (Mono)
-// 命名规范: modloader_dobby_xxx
-// C# 通过 [DllImport("modloader")] 直接调用
+// 命名规范: modmanager_dobby_xxx
+// C# 通过 [DllImport("modmanager")] 直接调用
 // ============================================================================
 extern "C" {
 
@@ -22,7 +22,7 @@ extern "C" {
  * @param origin_func    [out] 保存原函数地址的指针
  * @return 0 成功，非 0 失败
  */
-int modloader_dobby_hook(void *address, void *replace_func, void **origin_func) {
+int modmanager_dobby_hook(void *address, void *replace_func, void **origin_func) {
     LOGI("DobbyHook at %p, replace=%p", address, replace_func);
     int ret = DobbyHook(address, (dobby_dummy_func_t)replace_func, (dobby_dummy_func_t *)origin_func);
     if (ret != 0) LOGE("DobbyHook failed at %p, ret=%d", address, ret);
@@ -35,7 +35,7 @@ int modloader_dobby_hook(void *address, void *replace_func, void **origin_func)
  * @param pre_handler  前置回调 (dobby_instrument_callback_t)
  * @return 0 成功
  */
-int modloader_dobby_instrument(void *address, void *pre_handler) {
+int modmanager_dobby_instrument(void *address, void *pre_handler) {
     LOGI("DobbyInstrument at %p, handler=%p", address, pre_handler);
     return DobbyInstrument(address, (dobby_instrument_callback_t)pre_handler);
 }
@@ -45,7 +45,7 @@ int modloader_dobby_instrument(void *address, void *pre_handler) {
  * @param address  被 hook 的函数地址
  * @return 0 成功
  */
-int modloader_dobby_destroy(void *address) {
+int modmanager_dobby_destroy(void *address) {
     LOGI("DobbyDestroy at %p", address);
     return DobbyDestroy(address);
 }
@@ -56,7 +56,7 @@ int modloader_dobby_destroy(void *address) {
  * @param symbol_name   符号名
  * @return 符号地址，失败返回 nullptr
  */
-void *modloader_dobby_symbol_resolver(const char *image_name, const char *symbol_name) {
+void *modmanager_dobby_symbol_resolver(const char *image_name, const char *symbol_name) {
     void *addr = DobbySymbolResolver(image_name, symbol_name);
     LOGI("DobbySymbolResolver(%s, %s) = %p", image_name, symbol_name, addr);
     return addr;
@@ -69,24 +69,24 @@ void *modloader_dobby_symbol_resolver(const char *image_name, const char *symbol
  * @param buffer_size  补丁数据大小
  * @return 0 成功
  */
-int modloader_dobby_code_patch(void *address, const uint8_t *buffer, uint32_t buffer_size) {
+int modmanager_dobby_code_patch(void *address, const uint8_t *buffer, uint32_t buffer_size) {
     LOGI("DobbyCodePatch at %p, size=%u", address, buffer_size);
     return DobbyCodePatch(address, (uint8_t *)buffer, buffer_size);
 }
 
 /**
  * DobbyGetVersion — 获取 Dobby 版本字符串。
  */
-const char *modloader_dobby_get_version(void) {
+const char *modmanager_dobby_get_version(void) {
     return DobbyGetVersion();
 }
 
 /**
- * modloader_log_write — write a line to Android logcat.
- * Called from C# via [DllImport("modloader")].
+ * modmanager_log_write — write a line to Android logcat.
+ * Called from C# via [DllImport("modmanager")].
  */
-void modloader_log_write(int prio, const char *tag, const char *msg) {
-    __android_log_write(prio, tag ? tag : "ModLoader", msg ? msg : "");
+void modmanager_log_write(int prio, const char *tag, const char *msg) {
+    __android_log_write(prio, tag ? tag : "ModManager", msg ? msg : "");
 }
 
 } // extern "C"

Android/library/src/main/cpp/core/jni_helper.c

@@ -644,7 +644,7 @@ static DataSlot* find_slot(const char *key) {
 
 /** Java → C: nativeSetData(String key, int[] data) */
 JNIEXPORT void JNICALL
-Java_starray_android_modloader_ModManagerUtils_nativeSetData(
+Java_starray_android_modmanager_ModManagerUtils_nativeSetData(
     JNIEnv *env, jclass unused, jstring key, jintArray data) {
     const char *k = (*env)->GetStringUTFChars(env, key, NULL);
     DataSlot *s = find_slot(k);
@@ -664,7 +664,7 @@ Java_starray_android_modloader_ModManagerUtils_nativeSetData(
 
 /** Java ← C: nativeGetData(String key) → int[] */
 JNIEXPORT jintArray JNICALL
-Java_starray_android_modloader_ModManagerUtils_nativeGetData(
+Java_starray_android_modmanager_ModManagerUtils_nativeGetData(
     JNIEnv *env, jclass unused, jstring key) {
     const char *k = (*env)->GetStringUTFChars(env, key, NULL);
     DataSlot *s = find_slot(k);
@@ -701,6 +701,52 @@ jint* jnihelper_get_data_buf(const char *key) {
     return s ? s->buf : NULL;
 }
 
+// ===== C# 回调注册（Java nativeSendChar → C → C# callback） =====
+
+typedef void (*onAcceptChar_cb)(unsigned int codepoint);
+static onAcceptChar_cb g_onAcceptChar;
+
+void modmanager_set_OnAcceptCharCallback(onAcceptChar_cb callback) {
+    g_onAcceptChar = callback;
+}
+
+typedef void (*onAcceptKey_cb)(int keyCode);
+static onAcceptKey_cb g_onAcceptKey;
+
+void modmanager_set_OnAcceptKeyCallback(onAcceptKey_cb callback) {
+    g_onAcceptKey = callback;
+}
+
+// === 实时 IME 字符注入 (KeyboardView → commitText → nativeSendChar) ===
+
+JNIEXPORT void JNICALL
+Java_starray_android_modmanager_ModManagerUtils_nativeSendChar(
+    JNIEnv *env, jclass unused, jint unicode) {
+    // 优先走 C# 回调（实时），未注册时回退到 buffer
+    if (g_onAcceptChar) {
+        g_onAcceptChar((unsigned int)unicode);
+        return;
+    }
+    DataSlot *s = find_slot("ime_text");
+    if (!s) return;
+    if (s->len >= DATA_BUF_SIZE) return;
+    s->buf[s->len++] = unicode;
+}
+
+JNIEXPORT void JNICALL
+Java_starray_android_modmanager_ModManagerUtils_nativeSendKey(
+    JNIEnv *env, jclass unused, jint keyCode) {
+    // 优先走 C# 回调（实时），未注册时回退到 buffer
+    if (g_onAcceptKey) {
+        g_onAcceptKey(keyCode);
+        return;
+    }
+    DataSlot *s = find_slot("ime_text");
+    if (!s) return;
+    if (s->len >= DATA_BUF_SIZE) return;
+    s->buf[s->len++] = -keyCode;
+}
+
 /**
  * JNI_OnLoad - 库加载时的入口点
  */