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:
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.
- Download the translation patch here
- Plug your phone into your computer (choosing to browse files in explorer when prompted)
- 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
- Open the app, and you should see the translation in the game!
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 ^^
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 ^^
- Open Termux. You should see a terminal.
- 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.) - 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, thecd
command is used to go to a folder. You can also press the tab key to auto complete any commands if you get lazy!
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.
-
Following off from step 3, run the command
mkdir Translation
to create a new folder named 'Translation'. -
Go into the new folder by running the command
cd Translation
-
Login to Github by running the command
gh auth login
and then following the prompted steps. You may need to installgit
andgh
etc on Termux if prompted. -
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 calledSuccubus-Duel-English-Translation
.
You can cd into this folder and run
git checkout develop
,git fetch
andgit pull
to pull the latest translation updates from git at anytime! It's super handy.
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!
-
Open Shizuku and follow the steps under
Wireless Debugging
. -
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.
-
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 ~
andmv rish_shizuku.dex ~
-
Go back to the home folder by running the command
cd ~
, then run the commandls
to check if 'rish' and 'rish_shizuku.dex' are in your home folder. -
Give
rish
execute privlages by running the commandchmod +x rish
. -
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!
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!
- 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!
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.
-
Run the command
nano .bashrc
-
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!)
- 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 ^^