nitro/G-Earth
1
0
Fork 0
mirror of https://github.com/sirjonasxx/G-Earth.git synced 2024-11-23 08:50:52 +01:00
Code Issues Packages Projects Releases Wiki Activity
c06c4d41bb
G-Earth/docs/wiki/macOs-Installation-guide.md
dorving c06c4d41bb
Added link to guide for disabling SIP
2023-03-30 15:08:26 +02:00

4.1 KiB
Raw Blame History

NOTE: Currently supported browsers: ONLY Firefox and Chromium, works on Habbo AIR too

MacOS Installation Guide

G-Earth depends on an application named G-Mem, this application scans the memory contents of the Habbo client applicaton and extracts a cipher key that is used to decrypt packets coming from the Habbo server.

There is a few steps u have to complete in order to get it to work on MacOS.

Code-Sign G-Mem file and make it executable

Certificate Creation

  1. Open Keychain Access (press ⌘ + Enter, type KeyChain Access to open it from spotlight)
  2. Navigate from the top menu to Keychain Access > Certificate Assistant > Create Certificate... Screenshot 2023-03-30 at 14 36 47
  3. In the Create Your Certificate do the following:
  • Set Name: to gmem-cert
  • Set Cerificate Type: to Code Signing
  • Toggle the Let me override default button

Screenshot 2023-03-30 at 14 40 28

  1. Press Continue until you treach the Specify a Location For The Certificate, now do the following:
  • Set Keychain: to System

Screenshot 2023-03-30 at 14 42 50

  1. Enter your login credentials when prompted and press Done

Signing of G-Mem

  1. Open Terminal (press ⌘ + Enter, type Terminal to open it from spotlight)
  2. Type codesign -fs "gmem-cert" (do not press enter yet)
  3. Drag the G-Mem file into your terminal window (this will append the path to the file)

Your terminal window should now resemble the following:

Screenshot 2023-03-30 at 14 49 28

  1. Now press enter and enter your login credentials when prompted.

Making G-Mem executable

  1. Open Terminal (press ⌘ + Enter, type Terminal to open it from spotlight)
  2. Type chmod 755 (do not press enter yet)
  3. Drag the G-Mem file into your terminal window (this will append the path to the file)

Your terminal window should now resemble the following:

Screenshot 2023-03-30 at 14 52 29

  1. Now press enter and verify the Kind of the G-Mem file is not Unix Executable File

Screenshot 2023-03-30 at 14 54 15

Disabling SIP

Modern machines running MacOS have a security feature that shields of the memory of processes from other processes. Depending on your machine you may have to disable SIP.

For M1 macs it is required to disable SIP.

⚠️ CAUTION ⚠️

Turning off SIP allows any program with sudo privileges to modify memory contents of other processes. If you use pirated software, or other unverified apps, DO NOT DO THIS for your own safety! See the following stackoverflow post for some more info: https://apple.stackexchange.com/a/412281.

A guide for disabling SIP can be found here: https://developer.apple.com/documentation/security/disabling_and_enabling_system_integrity_protection

Launching G-Earth

  1. Open Terminal (press ⌘ + Enter, type Terminal to open it from spotlight)
  2. Type sudo java -jar
  3. Drag the G-Earth.jar file into your terminal window (this will append the path to the file)

Your terminal window should now resemble the following:

Screenshot 2023-03-30 at 15 00 59

  1. Press enter and fill in your password if prompted

Troubleshooting

If you experience any other issues and the Troubleshooting Page doesn't help,

it might be useful to have a look at the following issues: #67 #10