Jump to content

How to dump Il2Cpp-based Unity Games to find functions + offsets to hack (iOS)


28 posts in this topic

Recommended Posts

Updated (edited)

yPzDzQO.png

As requested, here is the tutorial how to dump il2cpp of iOS Unity games. With Il2CppDumper, it will be much easier to find useful functions and offsets to hack. No need to waste your time debugging the game.

Requirements:

- ARM/ASM knowledge

- IDA hacking experience

- IDA Pro. Download link

- Notepad++. Download link

- Il2CppDumper (Windows). Download link

- Clutch or Rasticrac for jailbroken devices or visit appvn.com to download latest cracked free games

- Winrar or 7-zip to open .ipa file

 

Instructions:

Download Il2CppDumper released version by Perfare and extract the program

 

To open .ipa file, simply rename file extension to .zip and open it

If you are using 7-zip, right click -> 7-zip -> Open Archive to open .ipa file directly

ySZdlPx.png

 

Navigate to \Payload\<app or game name>.app\ and extract the big binary file that doesn't have file extension

Navigate to \Payload\iosfps.app\Data\Managed\Metadata\ and extract global-metadata.dat

 

32-bit:

Press 1 for 32-bit and press 2 for auto. Please use Auto mode to get the program to find offsets and dump code for you because looking for 2 required pointers (CodeRegistration and MetadataRegistration) in IDA Pro to dump is too complicated and Unity already stripped all names of functions which means it will be harder to find,

As you used auto mode, the program will tell the pointers, but you do not need to know it if you have no idea what it is.

 

Skip 64-bit steps if you are working with 32-bit

 

64-bit:

Auto mode does not work on 64-bit binary yet. Here is dev's response

"I have to say, these same questions will make me feel that adding auto feature is a bad decision

We have to find 2 required offsets (CodeRegistration and MetadataRegistration) in IDA to dump. Open IDA Pro 64-bit (idaq64.exe), and disassemble the binary in 64-bit. Search function name InitFunc_1.

Above InitFunc_1, there is sub function that contains 2 pointers we need.

sub_100C46D8C                           ; DATA XREF: InitFunc_1+8o

                 ADRP            X0, #unk_101D48FE8@PAGE

                 ADD             X0, X0, #unk_101D48FE8@PAGEOFF

                 ADRP            X1, #dword_101D948C8@PAGE

sSkslSi.png

In Il2CppDumper, Press 2 for 64-bit and Press 1 for manual. Input your pointers:

Input CodeRegistration(X0): your first pointer

Input MetadataRegistration(X1): your second pointer

 

The dump.cs file should be created at the location where Il2CppDumper.exe is located

 

Open dump.cs with Notepad++ by right click and select Edit with Notepad++

Inside dump.cs, you'll see C# codes. Method bodies are not dumped but it's a very simple code that tells you function names and offsets to mod.

 

 

launch Il2CppDumper.exe. It will open the dialog twice to select file. For ELF file or Mach-O file, select the binary file. For global-metadata.dat, select global-metadata.dat

 

It will ask you to select platform, 32-bit or 64-bit. Press 1 for 32-bit or press 2 for 64-bit. Now for Mode, Press 1 for manual and press 2 for auto. Please use Auto mode to get the program to find offsets and dump code for you because looking for 2 required offsets (CodeRegistration and MetadataRegistration) in IDA Pro to dump is too complicated and Unity already stripped all names of functions which means it will be harder to find, and I haven't find out where to find 2 offsets in 64-bit binary yet. As you used auto mode, the program will tell the offsets, but you do not need to know it if you have no idea what it is.

 

The dump.cs file should be created at the location where Il2CppDumper.exe is located

 

Open dump.cs with Notepad++ by right click and select Edit with Notepad++

Inside dump.cs, you'll see C# codes. Method bodies are not dumped but it's a very simple code that tells you function names and offsets to mod.

 

To search, click Search -> Find...

To find all keyword, click on Find All in Current Document

 lnwqXUy.png

If you never seen C# code before, I'll explain a bit what the codes mean. I'm bad at explaining what these code means but I hope it goes well

This comment you see on top is just a list .dll files that are been converted into il2cpp

// Image 0: mscorlib.dll - 0

// Image 1: System.Security.dll - xxxx

// Image xx: Assembly-CSharp.dll - xxxx

The Assembly-CSharp.dll (Android users know this) is a game logic thing and it is what we looking for. The full code of "Assembly-CSharp.dll" thingy is always located somewhere at the bottom of the dumped file

 

This class body is like a group to make programmers easier to find codes. For example PlayerAntiHack class contains anti-hack code related.

// Namespace:

public class PlayerScript : MonoBehaviour // TypeDefIndex: 4303

{

}

 

In IDA you'll probarly see function names like

Player::Get_Gold…

Player::Get_Cash…

Player::Isbanned…

….

 

I'll bring this better details for you:

A class is a construct that enables you to create your own custom types by grouping together variables of other types, methods and events. A class is like a blueprint. It defines the data and behavior of a type. ... Unlike structs, classes support inheritance, a fundamental characteristic of object-oriented programming.

 

In the class, you'll see something like this:

// Fields

private int primaryWeaponIndex; // 0x10

private float minSpread; // 0x820

private float spread; // 0x824

private float visualSpread; // 0x828

….

 

Fields is not what we looking for so let's look into Methods.

 

// Methods

private int findNextAvailableWeapon(int currentWeaponIndex); // 1e704c

private bool IsLookingAtPlayer(PlayerScript player); // 1f3894

public bool HasBeenVisible(); // 1f2fa0

….

public int get_Gold_Example(); // 1a2b3c

public float float_example(); // 1a2b3d

….

 

This is what we looking for. These simple codes explains the name of the methods/functions, what type and the REAL IDA OFFSETS are written in the green commenented text.

 

public, private, protected etc, are access modifier. It's not important to know

static is a static modified to declare a static member. It's not important to know

int, float, double, boolean etc are data type.

 

If you look up the offset in IDA, you will see a sub_xxxxxx

vePK7YP.png

 

Write down all useful functions + offsets you found inside the dumped .cs file and start writing your code injection.

 

Note: It is suggested that you disassemble the binary file and look up the offsets to see if there are enough spaces to replace the instructions to hack.

 

That's all. Good luck hacking iOS games!

Credits:

AndnixSH#

Perfare (Il2CppDumper https://github.com/Perfare/Il2CppDumper)

 

If you have any issues with Il2CppDumper, please report the issue at: https://github.com/Perfare/Il2CppDumper/issues/

Updated by AndnixSH
  • Like 11
  • Winner 2
  • Thanks 1
  • Informative 2
Posted (edited)

First of all, thank you very very much for this tutorial.
I was wondering if you have an example Tweak.xm for a game with how to hook the class functions.

I have found the following info for the game I am trying to 'hack'

// Namespace: IAS.Proto
public class ItemDefinition : IExtensible // TypeDefIndex: 3153
{

	// Methods
	public void .ctor(); // 100dbd3f8
	public int get_water(); // 100dbd5c0
	public void set_water(int value); // 100dbd5c8
	public int get_premium(); // 100dbd600
	public void set_premium(int value); // 100dbd608
}

In IDA I have the following code on offset 100dbd5c0:
__text:0000000100DBD5C0 sub_100DBD5C0                           ; CODE XREF: sub_1002E1114+378↑p
__text:0000000100DBD5C0                                         ; sub_100DD1FF8+A88↓p
__text:0000000100DBD5C0                                         ; DATA XREF: ...
__text:0000000100DBD5C0                 LDR             W0, [X0,#0x70]
__text:0000000100DBD5C4                 RET
__text:0000000100DBD5C4 ; End of function sub_100DBD5C0

Which translates to the following pseudocode:
__int64 __fastcall sub_100DBD5C0(__int64 a1)
{
  return *(unsigned int *)(a1 + 112);
}

What I want is to display the current value (so I know I am in the right place) and then hook the set_ functions to set a new value.

I am hoping you can help me.
If you need more info please let me know.

 

[edit]

In my search of more tools I stumbled across something interesting.

https://github.com/nevermoe/unity_metadata_loader

This little tool lets you add the strings from the global*.dat file directly into IDA which makes searching easiere :)

Updated by QuasaR
Posted (edited)
19 hours ago, QuasaR said:

First of all, thank you very very much for this tutorial.
I was wondering if you have an example Tweak.xm for a game with how to hook the class functions.

I have found the following info for the game I am trying to 'hack'

What I want is to display the current value (so I know I am in the right place) and then hook the set_ functions to set a new value.

I am hoping you can help me.
If you need more info please let me know

[edit]

In my search of more tools I stumbled across something interesting.

https://github.com/nevermoe/unity_metadata_loader

This little tool lets you add the strings from the global*.dat file directly into IDA which makes searching easiere :)

If there is no class names in ida, you can't hook the class function. do code injection instead. 

There are lot of tutorials in iosgods. Just search and search

Nevermoe's loader is unstable

Updated by evildog1
Posted (edited)

Ok, but code injection mostly assumes it's a mov /add instruction and about R registers, not W or X and not an STR instructionlike in the following example (set_water):

__text:0000000100DBD5C0                 LDR             W0, [X0,#0x70]
__text:0000000100DBD5C4                 RET
__text:0000000100DBD5C4 ; End of function ItemDefinition$$get_water
__text:0000000100DBD5C4
__text:0000000100DBD5C8
__text:0000000100DBD5C8 ; =============== S U B R O U T I N E =======================================
__text:0000000100DBD5C8
__text:0000000100DBD5C8
__text:0000000100DBD5C8 ItemDefinition$$set_water               ; CODE XREF: ProtoSerializer$$Read_85953+C5C↓p
__text:0000000100DBD5C8                                         ; DATA XREF: __const:00000001022EB878↓o
__text:0000000100DBD5C8                 STR             W1, [X0,#0x70]
__text:0000000100DBD5CC                 RET
__text:0000000100DBD5CC ; End of function ItemDefinition$$set_water
__text:0000000100DBD5CC

 

The set_water is called from the following code:

__text:0000000100DDF618 loc_100DDF618                           ; CODE XREF: ProtoSerializer$$Read_85953+698↑j
__text:0000000100DDF618                 MOV             X0, X21
__text:0000000100DDF61C                 MOV             X2, #0
__text:0000000100DDF620                 BL              ItemDefinition$$set_water
__text:0000000100DDF624                 B               loc_100DDFB00
__text:0000000100DDF628 ; ---------------------------------------------------------------------------

 

Updated by QuasaR
Posted
51 minutes ago, QuasaR said:

Ok, but code injection mostly assumes it's a mov /add instruction and about R registers, not W or X and not an STR instructionlike in the following example (set_water)

The set_water is called from the following code:

 

Sorry but I'm not familiar with code injection. Please create a new thread to ask question. Thank you

Create an account or sign in to comment

You need to be a member in order to leave a comment

Create an account

Sign up for a new account in our community. It's easy!

Register a new account

Sign in

Already have an account? Sign in here.

Sign In Now
  • Our picks

    • DEAD TARGET: FPS Zombie Games v6.153.0 [ +10 Cheats ] Currency Max
      Modded/Hacked App: DEAD TARGET: FPS Zombie Games By VNG SINGAPORE PTE LTD
      Bundle ID: com.vng.g6.a.zombie
      iTunes Store Link: https://apps.apple.com/us/app/dead-target-fps-zombie-games/id901793885?uo=4
       

      Hack Features

      - Unlimited Gold
      - Unlimited Cash

      - Unlimited Diamonds
      - Unlimited Grenades
      - Unlimited MedKits
      - Unlimited Ammo
      - One Hit Kill
      - God Mode
      - High Accuracy

      - ADS NO
      • 17 replies
    • DEAD TARGET: FPS Zombie Games v6.153.0 [ +10 Jailed ] Currency Max
      Modded/Hacked App: DEAD TARGET: FPS Zombie Games By VNG SINGAPORE PTE LTD
      Bundle ID: com.vng.g6.a.zombie
      iTunes Store Link: https://apps.apple.com/us/app/dead-target-fps-zombie-games/id901793885?uo=4
       

      Hack Features

      - Unlimited Gold
      - Unlimited Cash

      - Unlimited Diamonds
      - Unlimited Grenades
      - Unlimited MedKits
      - Unlimited Ammo
      - One Hit Kill
      - God Mode
      - High Accuracy

      - ADS NO
      • 29 replies
    • Run! Goddess v1.0.22 [+4 Jailed Cheats]
      Modded/Hacked App: Run! Goddess By TOP GAMES INC.
      Bundle ID: com.topgamesinc.rg
      iTunes Store Link: https://apps.apple.com/us/app/run-goddess/id6667111749?uo=4



      🤩 Hack Features

      - No Skill Cooldown
      - Slow Enemy
      - Enemy Can't Attack (Enemy Can't Do Damage)
      • 94 replies
    • Run! Goddess v1.0.22 [+4 Cheats]
      Modded/Hacked App: Run! Goddess By TOP GAMES INC.
      Bundle ID: com.topgamesinc.rg
      iTunes Store Link: https://apps.apple.com/us/app/run-goddess/id6667111749?uo=4

       

      🤩 Hack Features

      - No Skill Cooldown
      - Slow Enemy
      - Enemy Can't Attack (Enemy Can't Do Damage)
       
      • 80 replies
    • Alien Survivor: Survival Arena v1.38.1 [ +7 Cheats ] Currency Max
      Modded/Hacked App: Alien Survivor: Survival Arena By IMPONILOX LIMITED
      Bundle ID: world.playme.x
      iTunes Store Link: https://apps.apple.com/us/app/alien-survivor-survival-arena/id1669761844?uo=4
       

      🚀 Hack Features

      - ADS NO [ Rewards Free ]

      - Gems [ Achievements Rewards Only One Get ]

      - Energy [ Just Buy ]

      - HP [ Just Equip & Unequip ]

      - ATK [ Just Equip & Unequip ]

      - DEF [ Just Equip & Unequip ]

      - Skill CD [ First Get Then Use ]


      🍏 For Non-Jailbroken & No Jailbreak required hacks: https://iosgods.com/forum/79-no-jailbreak-section/
      🤖 Modded Android APK(s): https://iosgods.com/forum/68-android-section/
      • 15 replies
    • Alien Survivor: Survival Arena v1.38.1 [ +7 Jailed ] Currency Max
      Modded/Hacked App: Alien Survivor: Survival Arena By IMPONILOX LIMITED
      Bundle ID: world.playme.x
      iTunes Store Link: https://apps.apple.com/us/app/alien-survivor-survival-arena/id1669761844?uo=4


      🚀 Hack Features

      - ADS NO [ Rewards Free ]

      - Gems [ Achievements Rewards Only One Get ]

      - Energy [ Just Buy ]

      - HP [ Just Equip & Unequip ]

      - ATK [ Just Equip & Unequip ]

      - DEF [ Just Equip & Unequip ]

      - Skill CD [ First Get Then Use ]


      🍏 Jailbreak iOS hacks: https://iosgods.com/forum/5-game-cheats-hack-requests/
      🤖 Modded Android APKs: https://iosgods.com/forum/68-android-section/
      • 27 replies
    • Legend of Survivors V1.2.8 [ +17 Jailed ] Currency Max
      Modded/Hacked App: Legend of Survivors By ABI GLOBAL LTD.
      Bundle ID: com.abi.legendofsurvivors
      iTunes Store Link: https://apps.apple.com/us/app/legend-of-survivors/id6489580730?uo=4


      Hack Features:

      - NO ADS

      - Gems 

      - Gold

      - Energy 

      - Material

      - Health Max [ Equip & Upgrade ]

      - Damage [ Equip & Upgrade ]

      - Skill Cooldown

      - EXP + Level [ Patrol Reward ]

      - Patrol Reward [ Claim Unlimited ]

      - Growth Pack Unlock

      - Growth Pack [ Claim Unlimited ]

      - Monthly card Pack Unlock

      - Monthly card Pack [ Claim Unlimited ]


      Jailbreak required hack(s): https://iosgods.com/forum/5-game-cheats-hack-requests/
      Modded Android APK(s): https://iosgods.com/forum/68-android-section/
      For more fun, check out the Club(s): https://iosgods.com/clubs/
      • 49 replies
    • Legend of Survivors V1.2.8 [ +17 Cheats ] Currency Max
      Modded/Hacked App: Legend of Survivors By ABI GLOBAL LTD.
      Bundle ID: com.abi.legendofsurvivors
      iTunes Store Link: https://apps.apple.com/us/app/legend-of-survivors/id6489580730?uo=4


      Hack Features:
      - IAP Free [ Buy Anything - Gems Gold Ads Premium Packs ]

      - NO ADS

      - Gems 

      - Gold

      - Energy 

      - Material

      - Health Max [ Equip & Upgrade ]

      - Damage [ Equip & Upgrade ]

      - Skill Cooldown

      - EXP + Level [ Patrol Reward ]

      - Patrol Reward [ Claim Unlimited ]

      - Growth Pack Unlock

      - Growth Pack [ Claim Unlimited ]

      - Monthly card Pack Unlock

      - Monthly card Pack [ Claim Unlimited ]
      • 132 replies
    • Kitchen Masters v15.0.0 [ +4 Cheats ] Currency Max
      Modded/Hacked App: Kitchen Masters By Bigger Oyun Yazilim ve Pazarlama Anonim Sirketi
      Bundle ID: com.bigger.kitchenmasters
      iTunes Store Link: https://apps.apple.com/ph/app/kitchen-masters/id6474870266?uo=4


      🤩 Hack Features

      - Coins

      - Cash

      - Lives

      - Tile Cost 0
      • 6 replies
    • Kitchen Masters v15.0.0 [ +4 Jailed ] Currency Max
      Modded/Hacked App: Kitchen Masters By Bigger Oyun Yazilim ve Pazarlama Anonim Sirketi
      Bundle ID: com.bigger.kitchenmasters
      iTunes Store Link: https://apps.apple.com/ph/app/kitchen-masters/id6474870266?uo=4
       

      🤩 Hack Features

      - Coins

      - Cash

      - Lives

      - Tile Cost 0
      • 11 replies
    • Score Masters v2.2 [ +7 Jailed ] Always Win
      Modded/Hacked App: Score Masters By SKYLOFT YAZILIM BILISIM VE TICARET ANONIM SIRKETI
      Bundle ID: com.bh.hypergoal
      iTunes Store Link: https://apps.apple.com/us/app/score-masters/id6473402760?uo=4


      🚀 Hack Features

      - Auto ADS Disable

      - Gems [ Mission Rewards ]

      - Coins [ Mission Rewards ]

      - Player Score 20 Max

      - Always Win Player

      - AI Score 0

      - AI Miss
      • 5 replies
    • Score Masters v2.2 [ +7 Cheats ] Always Win
      Modded/Hacked App: Score Masters By SKYLOFT YAZILIM BILISIM VE TICARET ANONIM SIRKETI
      Bundle ID: com.bh.hypergoal
      iTunes Store Link: https://apps.apple.com/us/app/score-masters/id6473402760?uo=4


      🚀 Hack Features

      - Auto ADS Disable

      - Gems [ Mission Rewards ]

      - Coins [ Mission Rewards ]

      - Player Score 20 Max

      - Always Win Player

      - AI Score 0

      - AI Miss
      • 8 replies
×
  • Create New...

Important Information

We would like to place cookies on your device to help make this website better. The website cannot give you the best user experience without cookies. You can accept or decline our cookies. You may also adjust your cookie settings. Privacy Policy - Guidelines