Translating the Android version of the game - Giratena/Succubus-Duel-English-Translation GitHub Wiki

Because android normally limits you from accessing the scoped storage of apps (which is where the CSV folder is located), translating the mobile version of the app can be a little tricky, and to be honest, took me a good while to work things out too.

In this section, I'll do my best teach you how to easily patch the android version of Succubus Duel ^^

There are two ways:

The Easy Way

Pros Cons
Requires no technical knowlege and is pretty basic to perform The process can be quite tedious to repeat and may also take a while
You'll need to repeat this process anytime you want to update the translation
Requires you connect your phone to a computer

Prerequisites:

  • A PC
  • A USB Cable

This way is the most straight forward way. Though copying the files in this way can take some time. Because Android normally limits accessing the android/data folder, you'll need to plug your phone into your computer to do this step.

Manually copying the translation over via PC

  1. Download the translation patch here
  2. Plug your phone into your computer (choosing to browse files in explorer when prompted)
  3. Copy and paste the translation patch files into the English folder of the app. This folder will usually be something like: Android/data/com.IrojikakeMatomeBlog.SuccubusDuel/Files/CSV/Language/English
  4. Open the app, and you should see the translation in the game!

The Hard Way

Pros Cons
No Computer Required Takes a while to set up
Quick and repeatable once set up Requires following some advanced instructions
Always have the latest translation Not for the short attention spans
Once set up, never need to repeat the process again

Prerequisites:

This way is basically setting up a way to automate patching the game without the need of a computer. It's also repeatable, and easy to quickly patch the game with the latest version of the translation at any point. This is the method I have set up so I can quickly translate things in the game and then test it on mobile ^^

It is however a little tricky and will require some technical steps that I expect many may be unfamiliar with. Still, I'll do my very best to explain how to do it! I hope you learn some cool things ^^

Installing and setting up Termux

Termux is basically a little terminal for your phone. You can use termux to do almost anything linux can do, which will be very helpful for us in this guide ^^

  1. Open Termux. You should see a terminal.
  2. In Termux, enter the command termux-setup-storage to allow termux to access the storage on your phone. (for more information about termux-setup-storage click here.)
  3. After that's done, enter the command cd storage/shared to go to your phone folder

Type ls to see what folders you can navigate to, the cd command is used to go to a folder. You can also press the tab key to auto complete any commands if you get lazy!

Getting a copy of the translation onto your phone

Now let's clone the translation files onto your phone so you can copy them into the game later! In this guide I'll explain how to do this using git.

  1. Following off from step 3, run the command mkdir Translation to create a new folder named 'Translation'.

  2. Go into the new folder by running the command cd Translation

  3. Login to Github by running the command gh auth login and then following the prompted steps. You may need to install git and gh etc on Termux if prompted.

  4. Clone the repo by running the command gh repo clone Giratena/Succubus-Duel-English-Translation. This will create a copy of all the translation files into a new folder called Succubus-Duel-English-Translation.

You can cd into this folder and run git checkout develop, git fetch and git pull to pull the latest translation updates from git at anytime! It's super handy.

Setting up the ability to use ADB commands without a computer using Shizuku

Normally you can't just copy files in the android/data folder without a computer, but by using Shizku, we can host a debug server and copy things over as if we were on a computer!

  1. Open Shizuku and follow the steps under Wireless Debugging.

  2. Once wireless debugging is connected, click the option 'Use Shizuku in Terminal Apps' and follow the instructions listed in the app.

You'll be prompted to download two files, 'rish' and 'rish_shizuku.dex'. Open rish in a text editor and replace PKG with com.termux as reccomended in the guide.

  1. Copy the 'rish' file you modified and 'rish_shizuku.dex' and place them in your termux home folder. If you downloaded the two files to the 'Translation' folder you recently created, then you can move them easily by running the command mv rish ~ and mv rish_shizuku.dex ~

  2. Go back to the home folder by running the command cd ~, then run the command ls to check if 'rish' and 'rish_shizuku.dex' are in your home folder.

  3. Give rish execute privlages by running the command chmod +x rish.

  4. Check rish is running by running the command ./rish -c "ls". If it is then congrats you can now run adb commands on your phone!

Using Shizuku to copy the translation files over into the game.

Congradulations on getting this far! Now we can finally use rish to transfer the files into the game withou using a computer to do so!

  1. If you were following this guide exactly, you can copy the files by running the command:
~/rish -c "cp -rf /storage/emulated/0/Translation/Succubus-Duel-English-Translation/CSV/Language/English/* storage/emulated/0/Android/data/com.IrojikakeMatomeBlog.SuccubusDuel/files/CSV/Language/English/"'

This will quickly copy all the transltion files over and boom! Your game is translated! You did it!

Aliasing commands in .bashrc

You're probably thinking, "Gira, those commands are way too long. I don't want to write them all the time!" And you're absolutely right xD So, I'll explain one last thing on how you can make things way easier by condensing the commands into an alias.

  1. Run the command nano .bashrc

  2. Type out the following:

alias goToSuccubusDuelTranslation="cd ~/storage/shared/Translation/Succubus-Duel-English-Translation/;git fetch;git pull;git status"
alias translationExport='~/rish -c "cp -rf /storage/emulated/0/Translation/Succubus-Duel-English-Translation/CSV/Language/English/* storage/emulated/0/Android/data/com.IrojikakeMatomeBlog.SuccubusDuel/files/CSV/Language/English/"'

(Note: You can also create a .bashrc file and copy it and then transfer it to your phone if you don't want to write it out!)

  1. Restart Termux by clicking 'exit' on the drop down notifcation, and open it again!
  • You can update the translation (and go to the translation folder) by running the command goToSuccubusDuelTranslation
  • You can copy the translation files to the game by running the command translationExport. (Keep in mind Shizuku must be running for you to do this).

And that's it! Congradulations you made it! Give yourself a pat on your back ^^

⚠️ **GitHub.com Fallback** ⚠️