- Removed force requirement of s_GlobalMetadata & s_GlobalMetadataHeader.

- Added comments support in preset.prop
- Updated README.md

Author: MhmRdd

README.md

@@ -2,7 +2,7 @@
 [![Android CI status](https://github.com/MhmRdd/Il2Dump/actions/workflows/build.yml/badge.svg?branch=master)](https://github.com/MhmRdd/Il2Dump/actions/workflows/build.yml)
 [![License: CC BY-NC-SA 4.0](https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by-nc-sa/4.0/)
 
-A Zygisk Module to dump il2cpp/unity games based on `GlobalMetadata` & `GlobalMetadataHeader` & `MetadataRegistration` & `CodeRegistration` offsets.
+A Zygisk Module to dump il2cpp/unity games based on `GlobalMetadata` (optional) & `GlobalMetadataHeader` (optional) & `MetadataRegistration` & `CodeRegistration` offsets.
 
 > [!WARNING]
 > This module breaks SELinux policy of `untrusted_app` by allowing `write` on `unix_stream_socket` class to `zygote`.<br/>
@@ -20,11 +20,11 @@ A Zygisk Module to dump il2cpp/unity games based on `GlobalMetadata` & `GlobalMe
 **All configuration files & folders will take effect immediately.**
 
 ## Creating `preset.prop`
-All offsets should be filled, format:
+format:
 ```properties
 library=libil2cpp.so
-s_GlobalMetadata=ABCD0D0
-s_GlobalMetadataHeader=ABCD0D0
+#s_GlobalMetadata=ABCD0D0
+#s_GlobalMetadataHeader=ABCD0D0
 s_Il2CppCodeRegistration=ABCD0B0
 s_Il2CppMetadataRegistration=ABCD0B8
 ```
@@ -60,6 +60,8 @@ void MetadataCache::Initialize()
     /* ... */
 }
 ```
+> [!TIP]
+> `s_GlobalMetadata` can be obtained automatically by Il2Dump (if not inputted manually), whereas `s_GlobalMetadataHeader` is set to default (as `s_GlobalMetadata`) when not specified.
 
 ## Acknowledgement
 

build.gradle.kts

@@ -34,7 +34,7 @@ val gitCommitHash = "git rev-parse --verify --short HEAD".execute()
 // also the soname
 val moduleId by extra("zygisk_il2dump")
 val moduleName by extra("Zygisk Il2Dump")
-val verName by extra("v1.0.2")
+val verName by extra("v1.0.3")
 val verCode by extra(gitCommitCount)
 val commitHash by extra(gitCommitHash)
 val abiList by extra(listOf("arm64-v8a", "armeabi-v7a"))
@@ -53,7 +53,7 @@ tasks.register("Delete", Delete::class) {
 
 fun Project.configureBaseExtension() {
     extensions.findByType(AppExtension::class)?.run {
-        namespace = "io.github.a13e300.zygisk.module.sample"
+        namespace = "io.github.mhmrdd.zygisk.module.il2dump"
         compileSdkVersion(androidCompileSdkVersion)
         ndkVersion = androidCompileNdkVersion
         buildToolsVersion = androidBuildToolsVersion

module/src/main/cpp/il2dump.cpp

@@ -76,10 +76,6 @@ class Il2Dump : public zygisk::ModuleBase {
 	int fd = -1;
 
     void preSpecialize(const char* process) {
-		/*if (strcmp(process, "com.activision.callofduty.shooter") != 0) {
-			api->setOption(zygisk::Option::DLCLOSE_MODULE_LIBRARY);
-			return;
-		}*/
 		fd = api->connectCompanion();
 		xwrite(fd, process);
 		auto pstatus = xread<bool>(fd);
@@ -191,6 +187,8 @@ static void Il2Comp(int fd) {
 				std::string library;
 				uintptr_t GlobalMetadata = 0, GlobalMetadataHeader = 0, Il2CppCodeRegistration = 0, Il2CppMetadataRegistration = 0;
 				while (std::getline(presetFile, prop)) {
+					if (prop.starts_with('#'))
+						continue;
 					size_t eqpos = prop.find('=');
 					if (eqpos == std::string::npos)
 						continue;
@@ -240,7 +238,9 @@ static void Il2Comp(int fd) {
 						}
 					}
 				}
-				if (GlobalMetadata && GlobalMetadataHeader && Il2CppCodeRegistration && Il2CppMetadataRegistration) {
+				if (!GlobalMetadataHeader)
+					GlobalMetadataHeader = GlobalMetadata;
+				if (Il2CppCodeRegistration && Il2CppMetadataRegistration) {
 					status = true;
 					xwrite(fd, status);
 					xwrite(fd, library);
@@ -262,7 +262,7 @@ static void Il2Comp(int fd) {
 							if (dumpPtr) {
 								dump << *dumpPtr;
 							} else {
-								dump << "// [Il2Dump]: Failed to transact vector `" << i << "`!" << std::endl;
+								dump << std::endl << "// [Il2Dump]: Failed to transact vector[" << i << "]!";
 							}
 						}
 						dump.close();

module/src/main/cpp/utils.cpp

@@ -564,7 +564,7 @@ std::unique_ptr<uintptr_t> xread<uintptr_t>(int fd) {
 	return std::make_unique<uintptr_t>(data);
 }
 
-bool monitorIl2Addr() {
+static bool monitorIl2Addr() {
 	if (il2Name.empty()) {
 		LOGE("Invalid library name to dump, abort!");
 		return false;
@@ -607,6 +607,40 @@ bool monitorIl2Addr() {
 	return false;
 }
 
+static void *getGlobalMetadata() {
+	if (s_GlobalMetadata)
+		return (void*) getPointer(il2Addr + (uintptr_t) s_GlobalMetadata);
+	std::ifstream maps("/proc/self/maps");
+	std::string line;
+	if (!maps) {
+		LOGF("Unable to open `/proc/self/maps`, abort!");
+		return nullptr;
+	} else if (!maps.is_open()) {
+		LOGE("Unable to open `/proc/self/maps`, abort!");
+		return nullptr;
+	}
+	while (std::getline(maps, line)) {
+		std::istringstream iss(line);
+		std::string addr_range, perms, offset, dev, inode, path;
+		uintptr_t start;
+		if (!(iss >> addr_range >> perms >> offset >> dev >> inode)) continue;
+		std::getline(iss >> std::ws, path);
+		if (perms[0] == 'r' || perms[1] == 'w') {
+			size_t dash = addr_range.find('-');
+			if (dash == std::string::npos) continue;
+			start = std::stoul(addr_range.substr(0, dash), nullptr, 16);
+			if (path.find(il2Package) != std::string::npos &&
+				path.ends_with("/il2cpp/Metadata/global-metadata.dat")
+				) {
+				maps.close();
+				return (void*) start;
+			}
+		}
+	}
+	maps.close();
+	return nullptr;
+}
+
 void dumpIl2(int fd, zygisk::Api* api) {
 	if (!monitorIl2Addr()) {
 		error:
@@ -620,26 +654,29 @@ void dumpIl2(int fd, zygisk::Api* api) {
 	}
 	std::this_thread::sleep_for(std::chrono::seconds(2));
 	MountGuard rodata((void*) (il2Addr + (uintptr_t) s_GlobalMetadata), PROT_READ);
-	s_GlobalMetadata = reinterpret_cast<void *>(
-			getPointer(il2Addr + (uintptr_t) s_GlobalMetadata));
-	s_GlobalMetadataHeader = ReadPointer<Il2CppGlobalMetadataHeader>(
-			getPointer(il2Addr + (uintptr_t) s_GlobalMetadataHeader));
-	s_Il2CppMetadataRegistration = ReadPointer<Il2CppMetadataRegistration>(
-			getPointer(il2Addr + (uintptr_t) s_Il2CppMetadataRegistration));
-	s_Il2CppCodeRegistration = ReadPointer<Il2CppCodeRegistration>(
-			getPointer(il2Addr + (uintptr_t) s_Il2CppCodeRegistration));
+	s_GlobalMetadata = getGlobalMetadata();
 	if (!s_GlobalMetadata) {
 		LOGE("Invalid pointer dereference at `GlobalMetadata`!");
 		goto error;
 	}
+	s_GlobalMetadataHeader = s_GlobalMetadataHeader ?
+			ReadPointer<Il2CppGlobalMetadataHeader>(
+			 getPointer(il2Addr + (uintptr_t) s_GlobalMetadataHeader)
+			 ) : ReadPointer<Il2CppGlobalMetadataHeader>(
+			 (uintptr_t ) s_GlobalMetadata
+			);
 	if (!s_GlobalMetadataHeader) {
 		LOGE("Invalid pointer dereference at `GlobalMetadataHeader`!");
 		goto error;
 	}
+	s_Il2CppMetadataRegistration = ReadPointer<Il2CppMetadataRegistration>(
+			getPointer(il2Addr + (uintptr_t) s_Il2CppMetadataRegistration));
 	if (!s_Il2CppMetadataRegistration) {
 		LOGE("Invalid pointer dereference at `Il2CppMetadataRegistration`!");
 		goto error;
 	}
+	s_Il2CppCodeRegistration = ReadPointer<Il2CppCodeRegistration>(
+			getPointer(il2Addr + (uintptr_t) s_Il2CppCodeRegistration));
 	if (!s_Il2CppCodeRegistration) {
 		LOGE("Invalid pointer dereference at `Il2CppCodeRegistration`!");
 		goto error;