codm/dumper/README.md

# Dumping libil2cpp.so

In order to use il2cppdumper we need to first dump the libil2cpp.so shared object out of memory using game guardian. Simply install game guardian and run it.

<img src="https://imgur.com/TeKK7xv.png"/>

After starting game guardian go into the game and open game guardian menu. Then go to the following tab and click the following button:

<img src="https://imgur.com/NC0vyq7.png"/>

After that click on the following button (do not change any values!)

<img src="https://imgur.com/qkGIZvK.png"/>

Now that we dumped all of the games memory to disk, we are going to transfer those files to your computer! if you are using LDPlayer copy the dump folder into your `Pictures` folder.

<img src="https://imgur.com/KJLW9i5.png"/>

After the dump folder has been moved to the `Pictures` folder simply click the following button to view the files on your pc:

<img src="https://imgur.com/RK1wImb.png"/>

Now that we have the dump files we are going to need to cut the desired shared object file out of the `.bin` memory range that contains our shared object.

As you can see the dump generates a text file that gives you all of the memory ranges + lib names.

<img src="https://imgur.com/loFpzH1.png"/>

Now find the `.bin` that contains your ENTIRE `.so` memory range. Not just one of them. For this dump the range is: `92154000` - `98495000`. In the dump folder we can see a `.bin` that contains
this memory range.

<img src="https://imgur.com/L8pR07E.png"/>

Open the .bin in hxd and search for "ELF" if you scroll down to the bottom you will see an ELF header! This is the header for the il2cpp.so! now calculate the size of the .so by taking the end address
and subtracting it with the start address. (`0x98495000` - `0x92154000` = `0x6341000`).

<img src="https://imgur.com/FWhDB73.png"/>

Now that we have the memory selected, click file->new then paste, save as `il2cpp.so`.

# Using il2cppdumper

Take the dumped `il2cpp.so` and `global-metadata.dat` file, put together in a new folder + make a folder inside of that new folder called `output`.

<img src="https://imgur.com/ptkc0Rd.png"/>

now that we have the dumped il2cpp.so, global-metadata.dat we can run il2cppdumper.exe and this will generate a few files for us inside of `output` folder.

<img src="https://imgur.com/VNneDN5.png"/>

you will be asked to provide the base address of the dump. Simply add the base address of the dump.bin and the offset into the dump file itself, this will give you the address
in memory of where the `.so` was when we dumped it! (this is called a linear virtual address).

<img src="https://imgur.com/1k2XAXr.png"/>

After you enter the base address `il2cppdumper` will do its job and generate a dummy dll that we will use with `dll2sdk`.

<img src="https://imgur.com/TFeDbpL.png"/>

# Using Dll2SDK

Now that we have generated all dummy dll's and il2cpp.h we can use dll2sdk to make a c++ sdk for the game :)

<img src="https://imgur.com/PgOm9MY.png"/>

Now simply run dll2sdk and it will create all of the c++ files you need!

<img src="https://imgur.com/FHqzYs9.png"/>

Now you have a full c++ sdk for the game!

<img src="https://imgur.com/aRvc1hK.png"/>