Instructions on how to install Umineko Project on Android (and other devices)

Frequently Encountered Issues

1. Android 14 Incompatible App

   Note from the future: It depends on what version of Android. As of now in 2026, I believe it's just a permissions check, one button press. USB Debugging is in Developer Options without needing ADB (AFAIK). If you can't get it to install, just sideload it, theres guides for it.

   Android 14 has blocked older apps from installing. You'll need to sideload the app using ADB. Following this article can help you.

   In general; Enable developer mode, install ADB onto your PC, connect your phone to your PC, Enable USB debugging, then sideload the ONScripter-RU APK onto your phone using ADB.

2. Invalid Launch Directory when launching the app

   This is the case when you do not have the game files in a folder named ONScripter-RU which would be located in the root of your internal storage.

   Another cause is due to a corrupt or incorrect default.cfg file. When editing the file, make sure it has kept its Unix (LF) UTF-8 format. Some text editors tend to change it, however Windows Notepad will keep it if you Save-As and change the encoding to UTF-8 which is what I recommend.

3. What are the controls for mobile devices?

   The controls can be found at the bottom of this text file here with the 2 main controls being:

   • Single finger tap for left click
   • Double finger tap for right click

4. Missing Files/Other In-game error codes

   Usually, these arise when you have not overwritten the files with the updates. The game performs a checksum test on the files when launching, which would explain these issues. Just grab the resource updates and base scripts and overwrite them in the folder.

   Another cause is because you have not downloaded/extracted all the files. This can be the case if you have a corrupt torrent or failed to extract all files to the directory, which an obvious sign is that you have the error code "Unable to initialise Font System". The folder should be roughly 11-12gb, anything significantly less means you don't have all the files. Try re-checking or downloading the torrent again.

5. Errors when extracting the torrent and/or missing files

   If the errors are the files with the missing UTF-8 character (square block), do not worry about them and use this checksum. Make sure to right click the link - save as and rename the file to game.hash to overwrite the existing hash file in the main directory. Some sounds might not play but there is no workaround for Android AFAIK.

6. Black screen during successful start-up

   If the game has passed its checksum and is seemingly hanging on a black screen, just start finger mashing the screen until it starts working.

7. Lag and low performance

   You can limit the FPS, change hardware decoder settings, etc., in the ons.cfg file. More details can be found in the spoiler of this forum and more such as controls and other options.

   To paraphrase, appending force-fps=30 will limit the FPS to 30fps, and hwdecoder=on will switch on hardware decoding. I will keep a text file just in case of the forum 404'ing. Here

8. Installing to a SD Card

   You need to edit the default.cfg file and point towards the path you are wanting eg: an SD card like /storage/####-####/ONScripterRU. Once you have the path of ONScripterRU on your SD card, add a line root=/your/path/here to default.cfg. Once you have done that, copy and paste that file and the en.file into the root folder where ONScripterRU should be located, your internal root storage. This is because ONScripterRU checks the root internal storage like how it should be installed by default, but as soon as it reads default.cfg, it'll point to the SD Card. Email me if you need more help with this.

9. Cut off screen/unaligned touchscreen

   If your screen has been cut off however your touchscreen is fine (eg: where you press is where it registers), you can set an offset in ons.cfg like system-offset-x=180 -x being the axis and 180 being the amount of pixels. Change them until you have a centred screen.

   If however your screen is fine but your touchscreen is unaligned, changing window-width in default.cfg to your phone's screen resolution (width) will align it. Eg: S22 Ultra has a screen resolution of 3088x1440, so the window width in default.cfg will be window-width=3088