> For the complete documentation index, see [llms.txt](https://gakumas.natsume.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gakumas.natsume.io/localify/android-mobile-emulator.md).

# Android (Mobile/Emulator)

***

### Prerequisites

{% hint style="danger" %}
Before continuing, please ensure your **Gakumas** account is linked to your **BNID** account.
{% endhint %}

***

### Distinctions

| Method                  | Installing with Original Game | In-App Purchases |
| ----------------------- | :---------------------------: | :--------------: |
| Cloned Embedded APK 👍  |               ✅               |         ❌        |
| Embedded APK            |               ❌               |         ❌        |
| Localify                |               ❌               |         ❌        |
| LSPatch                 |               ❌               |         ❌        |
| LSPosed (Root Required) |               ✅               |         ✅        |

{% hint style="info" %}
Please use the **Webstore** or install the **Original Game** if you wish to make **In-App Purchases**.
{% endhint %}

***

## **Cloned Embedded** APK Method 👍

{% hint style="success" %}
Recommended Installation Method.
{% endhint %}

1. Download and Install **Localify.apk**

{% embed url="<https://github.com/Kajaqq/gaku-patcher/releases/latest>" %}

2. Download and Install **Gaku\_x.x.x\_embedded\_cloned.apk**

{% embed url="<https://github.com/Kajaqq/gaku-patcher/releases/latest>" %}

3. Launch **Localify** to Download the **Translation Data**.
4. Enable Use `Cloned App Name` in `Debug Settings`

{% hint style="info" %}
**Set Up Translation Data** Section is for other Methods.
{% endhint %}

***

## **Embedded** APK Method

{% hint style="info" %}
Alternative Installation Method.
{% endhint %}

{% hint style="warning" %}
Please uninstall any official **Gakumas** installations from your device before continuing.
{% endhint %}

1. Download and Install **Localify.apk**

{% embed url="<https://github.com/Kajaqq/gaku-patcher/releases/latest>" %}

2. Download and Install **Gaku\_x.x.x\_embedded.apk**

{% embed url="<https://github.com/Kajaqq/gaku-patcher/releases/latest>" %}

3. Launch **Localify** to Download the **Translation Data**.

{% hint style="info" %}
**Set Up Translation Data** Section is for other Methods.
{% endhint %}

***

## **Localify Method**

{% hint style="info" %}
Alternative Installation Method.
{% endhint %}

{% hint style="warning" %}
Please uninstall any official **Gakumas** installations from your device before continuing.
{% endhint %}

1. Download and Install **Localify.**

{% embed url="<https://github.com/chinosk6/gakuen-imas-localify/releases/latest>" %}

2. Install **Shizuku**.

{% embed url="<https://play.google.com/store/apps/details?id=moe.shizuku.privileged.api>" %}

3. Open **Shizuku** and follow the setup instructions.
4. Use built-in patching in **Localify.**
5. Set Up Translation Data

{% embed url="<https://gakumas.natsume.io/localify/android-mobile-emulator#set-up-translation-data>" %}
Go to Set Up Translation Data Section
{% endembed %}

***

## LSPatch Method

{% hint style="info" %}
Alternative Installation Method.
{% endhint %}

{% hint style="warning" %}
Please uninstall any official **Gakumas** installations from your device before continuing.
{% endhint %}

### **Step 1: Install Shizuku**

1. Install **Shizuku**.

{% embed url="<https://play.google.com/store/apps/details?id=moe.shizuku.privileged.api>" %}

2. Open **Shizuku** and follow the setup instructions.

### **Step 2: Install LSPatch**

1. Download and Install **LSPatch**.

{% embed url="<https://github.com/JingMatrix/LSPatch/releases/latest>" %}

### **Step 3: Configure LSPatch with Shizuku**

1. Open **Shizuku** and ensure the service is running.
2. Launch **LSPatch** and grant **Shizuku** permissions.

### **Step 4: Use LSPatch**

1. Download and Install **Localify.**

{% embed url="<https://github.com/chinosk6/gakuen-imas-localify/releases/latest>" %}

2. Open **LSPatch** → Navigate to the second tab → Add new patch.
3. Select `学マス` and apply the patch.
4. Enable **Local Patch Mode**.
5. Ensure the module is enabled in **LSPatch**.
6. Verify that **`学マス`** is enabled in **Module Scopes**.

### **Step 5:** Set Up Translation Data

{% embed url="<https://gakumas.natsume.io/localify/android-mobile-emulator#set-up-translation-data>" %}
Go to Set Up Translation Data Section
{% endembed %}

***

## LSPosed Method (Root Required)

{% hint style="info" %}
Alternative Installation Method.
{% endhint %}

{% hint style="danger" %}
Since LSPosed setup differs by device, we do not provide specific instructions here.
{% endhint %}

{% embed url="<https://github.com/JingMatrix/LSPosed/releases/latest>" %}

***

## Set Up Translation Data

### Step 1: Configure Localify

1. Enable `Enable Plugin` in `Basic Settings`
2. Disable `Fast Initialization` in `Basic Settings`
3. Disable `Replace Font` in `Basic Settings`
4. Disable **`Check Built-in Assets Update`** in `Resource Settings`
5. Launch the game once with `Delete Plugin Resource` **enabled** in `Resource Settings`

{% hint style="warning" %}
This step is essential for clearing the existing **Translation Data** bundled with **Localify**.
{% endhint %}

### Step 2: Download Translation Data

1. Enable `Check Resource Update From API` in `Resource Settings`
2. Enter `https://api.github.com/repos/NatsumeLS/Gakumas-Translation-Data-EN/releases/latest`
3. Download the **Translation Data**.

{% hint style="info" %}
By **tapping** or **clicking** on **Check** button.
{% endhint %}

4. Enable `MasterDB Localization` in the `Advanced` tab.

***

## **Troubleshooting**

{% hint style="warning" %}

### Translations are partially in Chinese

1. Launch the game with `Delete Plugin Resource` **enabled** in `Resource Settings`
2. Relaunch the game with `Check Resource Update From API` **enabled** in `Resource Settings`
   {% endhint %}

{% hint style="warning" %}

### Translations not working even with Localify Loaded

1. `Clear Data` of **Localify** App
2. Launch the game with `Delete Plugin Resource` **enabled** in `Resource Settings`
3. Relaunch the game with `Check Resource Update From API` **enabled** in `Resource Settings`
   {% endhint %}

{% hint style="warning" %}

### Translations Data infinitely downloading

1. `Clear Cache` of **Localify** App
   {% endhint %}