Embleo is a WIP server emulator for a vertical mobile anime game.

How to play

Download this server (Code > Download ZIP) and extract the archive.

Running the Game Server

1. Install Python
2. Download UV package manager for you platform
3. Extract the archive and copy uv into the Embleo folder (where README.md file is)
4. Open src folder
5. Double-click run_setup.py (uv will download necessary Python dependencies)
6. Type in (copy-paste) Asset Server URL into the newly open window and press Enter.

The script will then download necessary files from the specified Asset Server. Wait for it to finish.

(TODO: write a guide for self-hosting assets)

6. Double-click run_server.py to start the Game Server.

Patching APK

A phone or emulator with Android 9-12 is required to install the game. Android 11 is recommended as it is confirmed working.

Game APK v.1.6.0 (not XAPK) is required.

1. Install Java
2. Download uber-apk-signer-1.3.0.jar
3. Put uber-apk-signer-1.3.0.jar in /src/scripts/ folder (this folder will also have "apk_patcher.py")
4. Drag-and-drop the game APK onto the apk_patcher.py file.

• You can also put the APK in the same folder as apk_patcher.py and double-click the script.

6. Type in Game Server URL and press Enter

• You can find the URL in the " * Running on http://192..." line after double-clicking the server.py. (Example URL: http://192.168.0.50:5001)

6. 2 patched APKs will appear in the same folder as your original APK.
7. Install the APK with edited-aligned-debugSigned.apk at the end

Since the Game Server is hosted locally, your phone needs to be in the same network as your computer.

Success

Finally, if:

1. Game Server is running (/src/run_server.py)
2. Your smartphone/emulator is in the same network as your computer that runs the Game Server
3. Asset Server is running and reachable
4. Patched APK was installed without errors
5. The entered Game Server URL is correct

You will see a disclaimer and the title screen after opening the game.

Congradulations!

During play

Account system doesn't work yet, you have to enter a nickname each time you start the game. Shortest nickname is any 2 letters and it is not saved by the game.

The in-game saving system is also not functional. Instead, /src/checkpoint.txt is created and updated each time you reach a checkpoint during an episode. Starting an episode again will put you at the last in-game checkpoint, most of the time the UI will be hidden, except the control pad. You can delete the /src/checkpoint.txt file to start the episode from the beginning.

If you encounter any problems with episode progression or other things, open a new issue or comment under existing one.

Emulator Settings

For Bluestacks, go to Settings > Screen and set Pixel Density to 320 DPI (High). Resolution should be set to 1080x810, 1440x1080 or 1920x1440 for wider view.