Jump to content

[Tutorial] Logos + Objective-C


8 posts in this topic

Recommended Posts

Updated (edited)

VN5E5KT.png

 
 
 
Logos - Definition
The syntax provided by Logos greatly simplifies the development of MobileSubstrate extensions ("tweaks") which can hook other methods throughout the OS. In this context, "method hooking" refers to a technique used to replace or modify methods of classes found in other applications on the phone. They can also be used for replacing original values which is called cheating. That's what we do.
 
 
 
Logos - Directives
 
Block-Principle
Logos are written in code blocks. They must be closed by %end. You can't have a block within a second one. Each block has to be assigned with a unique name in order to work.
 
 
 
%group

%group Groupname

Begin a hook group with the name Groupname. All ungrouped hooks are in the implicit "_ungrouped" group by default. %group is very useful to organize your code and structure it.
 
 
 
 
%hook

%hook Classname

Open a hook block for the class named Classname.
Can be inside a %group block.
Here is an example:


%hook SpringBoard
- (BOOL)homeScreenRotationStyleWantsUIKitRotation {
     return true;
}
-(BOOL)homeScreenSupportsRotation {
     return true;
}
%end

%hook SBIconLabelImageParameters {
     (id)text {
     %orig; //This calls the original implementation of a method
     return;
}
%end

PS: There is a Tweak for custom enabling screen rotation for all iDevices inside ;)
 
 
 
 
%subclass

%subclass Classname: Superclass <Protocol, Protocol>

Subclass block - the class is created at runtime and populated with methods. ivars are not yet supported (use associated objects). The %new specifier is needed for a method that doesn't exist in the superclass. To instantiate an object of the new class, you can use the %c operator.
Can be inside a %group block.
 
 
 
%new

%new
%new(signature)

Add a new method to a hooked class or subclass. signature is the Objective-C type encoding for the new method. If it is omitted, one will be automatically generated. %new generates a new instance subclass independent from a block. more than one subclasses can persist at a time.
Can be inside a %group block.
 
 
 
 
%end

%end

Close a group/hook/subclass block.
 
 
 
Top Level
The directives in this category should not exist within a group/hook/subclass block.
 
 

 

%config

%config(X=Y);

Set a logos configuration flag.
Configuration Flags

  • generator
    • MobileSubstrate generate code that uses MobileSubstrate for hooking. internal generate code that uses only internal Objective-C runtime methods for hooking.
  • warnings
    • none suppress all warnings default non-fatal warnings error make all warnings fatal
  • dump
    • yaml dump the internal parse tree in YAML format

 

 

%ctor

%ctor { … }

Generate an anonymous constructor (of default priority). You may already know that "__attribute__((constructor)) void DylibMain(){...}"
 
 
 
 
Function level
The directives in this category should only exist within a function block.
 

 
%init

%init;
%init([<class>=<expr>, …]);
%init(Group[, [+|-]<class>=<expr>, …]);

Initialize a group (or the default group). Passing no group name will initialize "_ungrouped", and passing class=expr arguments will substitute the given expressions for those classes at initialization time. The + sigil (as in class methods in Objective-C) can be prepended to the classname to substitute an expression for the metaclass. If not specified, the sigil defaults to -, to substitute the class itself. If not specified, the metaclass is derived from the class.
 
 
 
 
 
%class

%class Class;

Ambox-warning.png %class is deprecated. Do not use it in new code.
Forward-declare a class. Outmoded by %c, but still exists. Creates a $Class variable, and initializes it with the "_ungrouped" group. %class initialzizes a new class. (Also fixes mismatch with %hook Level)
 
 
 
 
%c

%c([+|-]Class)

Evaluates to Class at runtime. If the + sigil is specified, it evaluates to MetaClass instead of Class. If not specified, the sigil defaults to -, evaluating to Class.
 
 
 
 
%orig

%orig
%orig(arg1, …)

Call the original hooked method. Doesn't function in a %new'd method. Works in subclasses, strangely enough, because
MobileSubstrate will generate a supercall closure at hook time.
(If the hooked method doesn't exist in the class we're hooking, it creates a stub that just calls the superclass implementation.) args
is passed to the original function - don't include self and _cmd, Logos does this for you.


 
 
  %log

%log;
%log([(<type>)<expr>, …]);

Dump the method arguments to syslog. Typed arguments included in %log will be logged as well.

 
 
  File Extensions for Logos
Extension Process order .x will be processed by Logos, then preprocessed and compiled as objective-c. .xm will be processed by Logos, then preprocessed and compiled as objective-c++. .xi will be preprocessed as objective-c first, then Logos will process the result, and then it will be compiled. .xmi will be preprocessed as objective-c++ first, then Logos will process the result, and then it will be compiled. xi or xmi files can use Logos directives in #define macros.
 
 
 
 
  Splitting Logos Hooking Code Across Multiple Files
By default, the Logos pre-processor will only process one .xm file at build time. However, it is possible to split the Logos hooking code into multiple files.
First, the main file has to be renamed to an .xmi file. Then, other .xm files can be included in it using the #include directive. The Logos pre-processor will add those files to the main file before processing it.

 
 
Special thanks to KennyTMÍ    for his explanations and contributions to iphonedevwiki

Updated by castix
  • Like 1
Posted

Is this all from iPhoneDevWiki or did you add some modifications yourself? :)

Posted
  On 3/3/2015 at 6:29 PM, DiDA said:

Is this all from iPhoneDevWiki or did you add some modifications yourself? :)

 

I added explanations and additional info to some Logos as well. Mainly to those which are often used by users here (Refer to %hook, %new, %ctor). I also simplified things

Posted

You should add a section in this thread for the "essential"/"common" terms

The only thing that most ms hackers need to know are:

%hook

%ctor

%new

%orig

%end

 

It'll be easier for people to find the explanation for the commonly used terms :)

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

    • Injustice: Gods Among Us v3.5 +6++ Jailed Cheats [Unlimited Currencies + More]
      Modded/Hacked App: Injustice: Gods Among Us by Warner Bros. Entertainment
      Bundle ID: com.wb.Injustice.Brawler2013
      iTunes Store Link: https://itunes.apple.com/us/app/injustice-gods-among-us/id575658129?mt=8&uo=4&at=1010lce4


      Mod Requirements:
      - Non-Jailbroken/Jailed or Jailbroken iPhone/iPad/iPod Touch.
      - Cydia Impactor.
      - A Computer Running Windows/Mac/Linux.


      Hack Features:
      - Unlimited Currencies - Earn some to receive an unlimited amount of that specific currency.
      - Unlimited Stamina - Will increase instead of decrease.
      - Godmode
      - One-Hit Kill
      - Max Player Level - Play a battle with that specific character to get it max level.
      - Anti-Ban - Untested. Might be useless since the game's old now, and I wasn't banned testing this hack without this enabled anyway.
      • 1,971 replies
    • Injustice: Gods Among Us v3.5 - [ Unlimited Currencies & More ]
      Modded/Hacked App: Injustice: Gods Among Us by Warner Bros. Entertainment
      Bundle ID: com.wb.Injustice.Brawler2013
      iTunes Store Link: https://itunes.apple.com/us/app/injustice-gods-among-us/id575658129?mt=8&uo=4&at=1010lce4


      Mod Requirements:
      - Jailbroken iPhone/iPad/iPod Touch.
      - iFile / Filza / iFunBox / iTools or any other file managers for iOS.
      - Cydia Substrate (from Cydia).
      - PreferenceLoader (from Cydia).


      Hack Features:
      - Unlimited Currencies - Earn some to receive an unlimited amount of that specific currency.
      - Unlimited Stamina - Will increase instead of decrease.
      - Godmode
      - One-Hit Kill
      - Increased Critical Chance
      - Increased Critical Damage
      - Unlimited Gear Score
      - Max Player Level - Play a battle with that specific character to get it max level.
      - Survival Mode Unlocked
      - Hacked Saved Data Check Bypassed
      - Anti-Ban - Untested. Might be useless since the game's old now, and I wasn't banned testing this hack without this enabled anyway.

      This hack is an In-Game Mod Menu (iGMM). In order to activate the Mod Menu, tap on the iOSGods button found inside the app. This hack works on the latest x64 or ARM64 iDevices: iPhone 5s, 6, 6 Plus, 6s, 6s Plus, 7, 7 Plus, 8, 8 Plus, X, Xr, Xs, Xs Max, SE, iPod Touch 6G, iPad Air, Air 2, Pro & iPad Mini 2, 3, 4 and later.
      • 2,991 replies
    • [ViP Hack] WarFriends v5.11.0 +6 Cheats
      Modded/Hacked App: WarFriends: PvP Shooter Game By Chillingo Ltd
      Bundle ID: com.chillingo.warfriends
      iTunes Link: https://itunes.apple.com/us/app/warfriends-pvp-shooter-game/id979873043


      Hack Features:
      - Debug Menu -> Most/Everything from previous hack has been patched/removed. However, it will still show you some in-game stuff.
      - Free Weapon Upgrades. Instant Weapon Upgrade Delivery Times!
      - Unlimited Clips/Ammo -> Works online & offline
      - No Weapon Reload / Unlimited Ammo in Clip -> Works online & offline
      - One Hit Kill Enemies / High Damage -> Buggy Online, works well offline. Linked with enemy, so hit them first.
      - Gun Fire Rate x1000 -> Shoot bullets really, really fast. Works online too, linked to enemy. One Hit Kill Alternative if you can aim.
      This hack is an In-Game Mod Menu (iGMM). In order to activate the Mod Menu, tap your screen with 3 fingers simultaneously.

       

      Non-Jailbroken Version of this hack: https://iosgods.com/topic/44193-warfriends-v140-3-cheats-ios-10/
      • 1,767 replies
    • Fishing Clash v1.0.358 +3 Cheats
      Modded/Hacked App: Fishing Clash: Fish Game 2019 by Ten Square Games S.A.
      Bundle ID: com.tensquaregames.letsfish2
      iTunes Store Link: https://apps.apple.com/us/app/fishing-clash-fish-game-2019/id1151811380


      Hack Features:
      - Combo Always Active
      - Centered Line -> The line is always in the center zone. I didn't test enough but worked for 20 games. Duels too.
      - Line Never Breaks
      • 1,334 replies
    • Yu-Gi-Oh! Duel Links v9.8.0 - [ Always Best Tactics & More ]
      Modded/Hacked App: Yu-Gi-Oh! Duel Links By KONAMI
      Bundle ID: jp.konami.yugiohmobile
      iTunes Store Link: https://itunes.apple.com/us/app/yu-gi-oh-duel-links/id1068378177


      Mod Requirements:
      - Non-Jailbroken/Jailed or Jailbroken iPhone/iPad/iPod Touch.
      - Cydia Impactor.
      - A Computer Running Windows/Mac/Linux.


      Hack Features:
      -- Always The Best Tactics
      - Shows
      -- Enemies Hand Card Show
      - Show Monster And Status
      -- Enemies Deck Card Shows
      • 1,406 replies
    • Yu-Gi-Oh! Duel Links v9.8.0 - [ Auto-Play & More ]
      Modded/Hacked App: Yu-Gi-Oh! Duel Links By KONAMI
      Bundle ID: jp.konami.yugiohmobile
      iTunes Store Link: https://itunes.apple.com/us/app/yu-gi-oh-duel-links/id1068378177
       

      Mod Requirements:
      - Jailbroken iPhone/iPad/iPod Touch.
      - iFile / Filza / iFunBox / iTools or any other file managers for iOS.
      - Cydia Substrate (from Cydia).
      - PreferenceLoader (from Cydia).


      Hack Features:
      - Auto-Play - Don't Work In PVP 
      -- Always The Best Tactics
      - Face Up Card
      -- Enemies Hand Card Show
      - Show Monster And Status
      -- Enemies Deck Card Shows
      • 1,850 replies
    • Towerlands - tower defense TD v3.6.2 +2 Cheats
      Modded/Hacked App: Towerlands - tower defense TD By CHERNYE MEDVEDI, OOO
      Bundle ID: mobi.blackbears.ios.towerlands
      iTunes Store Link: https://apps.apple.com/us/app/towerlands-tower-defense-td/id1491901979?uo=4



      Hack Features:
      - Unlimited Gold
      - Unlimited Gems


      Non-Jailbroken & No Jailbreak required hack(s): https://iosgods.com/forum/79-no-jailbreak-section/
      Modded Android APK(s): https://iosgods.com/forum/68-android-section/
      For more fun, check out the Club(s): https://iosgods.com/clubs/
      • 344 replies
    • Slay Quest v1.2.6 [+3 Cheats]
      Modded/Hacked App: Slay Quest By Quest Lab Games Korlatolt Felelossegu Tarsasag
      Bundle ID: com.questlab.slayquest
      App Store Link: https://apps.apple.com/us/app/slay-quest/id6670221918?uo=4



      🤩 Hack Features

      - Unlimited Resources
      - Never Die
      - One Hit Kill
       
      • 4 replies
    • Slay Quest v1.2.6 [+3 Jailed Cheats]
      Modded/Hacked App: Slay Quest By Quest Lab Games Korlatolt Felelossegu Tarsasag
      Bundle ID: com.questlab.slayquest
      App Store Link: https://apps.apple.com/us/app/slay-quest/id6670221918?uo=4

       

      🤩 Hack Features

      - Unlimited Resources
      - Never Die
      - One Hit Kill
      • 1 reply
    • The Virus: Zombie Hunter v0.2.1 [+3 Cheats]
      Modded/Hacked App: The Virus: Zombie Hunter By Marek Penicka
      Bundle ID: cz.marekpenicka.viruszombiehunter
      iTunes Store Link: https://apps.apple.com/us/app/the-virus-zombie-hunter/id6474558910?uo=4

       

      🤩 Hack Features

      - Enemy Can't Attack
      - Unlimited Resources (Will Increase Instead of Decrease)
      - Unlimited Ammo
      • 8 replies
    • The Virus: Zombie Hunter v0.2.1 [+3 Jailed Cheats]
      Modded/Hacked App: The Virus: Zombie Hunter By Marek Penicka
      Bundle ID: cz.marekpenicka.viruszombiehunter
      iTunes Store Link: https://apps.apple.com/us/app/the-virus-zombie-hunter/id6474558910?uo=4



      🤩 Hack Features

      - Enemy Can't Attack
      - Unlimited Resources (Will Increase Instead of Decrease)
      - Unlimited Ammo
      • 11 replies
    • Office Cat: Idle Tycoon Game v1.0.52 +1 Jailed Cheat
      Modded/Hacked App: Office Cat: Idle Tycoon Game By treeplla Inc.
      Bundle ID: com.tree.idle.cat.office
      iTunes Store Link: https://apps.apple.com/us/app/office-cat-idle-tycoon-game/id6471960010?uo=4


      Mod Requirements:
      - Non-Jailbroken/Jailed or Jailbroken iPhone/iPad/iPod Touch.
      - Sideloadly / Cydia Impactor or alternatives.
      - A Computer Running Windows/macOS/Linux with iTunes installed.


      Hack Features:
      - Reward Multiplier*

      *Turn Off When You Get Enough Currencies Otherwise It'll Go Negative


      Jailbreak required hack(s): 


      iOS Hack Download IPA Link:

      Hidden Content

      Download via the iOSGods App








      PC Installation Instructions:
      STEP 1: If necessary, uninstall the app if you have it installed on your iDevice. Some hacked IPAs will install as a duplicate app. Make sure to back it up so you don't lose your progress.
      STEP 2: Download the pre-hacked .IPA file from the link above to your computer. To download from the iOSGods App, see this tutorial topic.
      STEP 3: Download Sideloadly and install it on your PC.
      STEP 4: Open/Run Sideloadly on your computer, connect your iOS Device, and wait until your device name shows up.
      STEP 5: Once your iDevice appears, drag the modded .IPA file you downloaded and drop it inside the Sideloadly application.
      STEP 6: You will now have to enter your iTunes/Apple ID email login, press "Start" & then you will be asked to enter your password. Go ahead and enter the required information.
      STEP 7: Wait for Sideloadly to finish sideloading/installing the hacked IPA. If there are issues during installation, please read the note below.
      STEP 8: Once the installation is complete and you see the app on your Home Screen, you will need to go to Settings -> General -> Profiles/VPN & Device Management. Once there, tap on the email you entered from step 6, and then tap on 'Trust email@iosgods.com'.
      STEP 9: Now go to your Home Screen and open the newly installed app and everything should work fine. You may need to follow further per app instructions inside the hack's popup in-game.

      NOTE: iOS/iPadOS 16 and later, you must enable Developer Mode. For free Apple Developer accounts, you will need to repeat this process every 7 days. Jailbroken iDevices can also use Sideloadly/Filza/IPA Installer to normally install the IPA with AppSync. If you have any questions or problems, read our Sideloadly FAQ section of the topic and if you don't find a solution, please post your issue down below and we'll do our best to help! If the hack does work for you, post your feedback below and help out other fellow members that are encountering issues.


      Credits:
      - AlyssaX64


      Cheat Video/Screenshots:

      N/A
      • 105 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