# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://gakumas.natsume.io/localify/android-mobile-emulator.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.