Info
-An alternative to TrollDecrypt for devices that is not supported by TrollStore. **May not work with rootless jailbreaks (e.g. Dopamine, palera1n).
+An alternative to TrollDecrypt for devices that is not supported by TrollStore. May not work with rootless jailbreaks (e.g. Dopamine, palera1n).
Open Sileo or any package managers that you like, add this repository: https://repo.tuandb.name.vn. After that, install DumpDecrypter from it.
Open DumpDecrypter, switch to the Settings tab and enable all available options. Then return to the AppList tab and select Arcaea, press Continue when prompted and wait for the decryption process to complete. Arcaea will automatically open and then close shortly after. When it finishes, press Go to Filza to view (Filza must be installed from the BigBoss repository beforehand) then copy the resulting IPA to your PC and you are done!
diff --git a/private-server.html b/private-server.html index 6e60c1e..cb6b703 100755 --- a/private-server.html +++ b/private-server.html @@ -653,7 +653,7 @@This is a (work-in-progress) centralized wiki for everything Arcaea modding related!
Disclaimer
Everything present in this wiki is made purely for educational and research purposes. By following anything in this wiki, you acknowledge that under no circumstances shall we be held legally responsible or liable for any consequences that may arise from your actions. No proprietary and paid assets, resources and files will be provided and must be individually obtained through official means.
Looking for contributors!
Arcaea Modding Wiki is looking for contributors! The wiki still needs much polishing and improving such as better reference images and such. If you want to contribute, visit the GitHub repository!
"},{"location":"arc-dump.html","title":"Obtaining Arcaea APK/IPA","text":"Work in progress
This page is being actively worked on. Contributions of any kind are much appreciated.
Before proceeding with modding Arcaea, its APK/IPA file must be dumped from your device. Depending on your operating system, dumping procedure will be different.
"},{"location":"arc-dump.html#ios","title":"iOS","text":"Before starting
Either TrollStore or a jailbroken device is required. As a result, you will not be able to perform anything listed in here if you are using any devices that were updated to iOS 16.6.1 or newer and is not checkm8-vulnerable.
Before proceeding, make sure you have Arcaea installed and have opened at least once.
"},{"location":"arc-dump.html#using-trolldecrypt","title":"Using TrollDecrypt","text":"Info
The recommended method. Works for all versions that are supported by TrollStore.
Install TrollDecrypt onto your device using TrollStore, then open it. All apps that can be decrypted will be listed, select Arcaea and choose Yes when prompted. The decryption process will take a while. When it finishes, the resulting IPA will be available form within the app, copy it to your PC and you are done!
"},{"location":"arc-dump.html#using-dumpdecrypter","title":"Using DumpDecrypter","text":"Info
An alternative to TrollDecrypt for devices that is not supported by TrollStore. **May not work with rootless jailbreaks (e.g. Dopamine, palera1n).
Open Sileo or any package managers that you like, add this repository: https://repo.tuandb.name.vn. After that, install DumpDecrypter from it.
Open DumpDecrypter, switch to the Settings tab and enable all available options. Then return to the AppList tab and select Arcaea, press Continue when prompted and wait for the decryption process to complete. Arcaea will automatically open and then close shortly after. When it finishes, press Go to Filza to view (Filza must be installed from the BigBoss repository beforehand) then copy the resulting IPA to your PC and you are done!
"},{"location":"arc-dump.html#android","title":"Android","text":"Work in progress
This section is being worked on.
"},{"location":"custom-charts-packs.html","title":"Adding custom charts/packs","text":"Work in progress
This page is being actively worked on. Contributions of any kind are much appreciated. The content below are unfinished.
Before starting
This guide requires a functional private server already set up and running.
"},{"location":"custom-charts-packs.html#unpacking-the-content-bundle","title":"Unpacking the content bundle","text":"Note
Only for Arcaea 5.4.0 or newer and non-Chinese versions.
"},{"location":"custom-charts-packs.html#songlistpacklist-files","title":"songlist/packlist files","text":""},{"location":"custom-charts-packs.html#private-server-database","title":"Private server database","text":""},{"location":"custom-charts-packs.html#custom-packs","title":"Custom packs","text":""},{"location":"custom-charts-packs.html#custom-charts","title":"Custom charts","text":""},{"location":"custom-charts-packs.html#repacking-the-content-bundle","title":"Repacking the content bundle","text":""},{"location":"offline-mod.html","title":"Reverse Engineering Arcaea","text":"Before starting
This page is being rewritten. There will be no precise ETAs on the completion date.
This guide is NOT beginner-friendly and you will have to figure out a lot of things yourself. Only proceed if you know what you are doing.
"},{"location":"offline-mod.html#removing-hash-verification","title":"Removing hash verification","text":"Info
Allows making changes to the game files. Only for pre-5.4.0 and Chinese versions.
"},{"location":"offline-mod.html#removing-lock-icon","title":"Removing lock icon","text":"Info
Remove the lock icon on locked packs. Purely for aesthetic purposes.
"},{"location":"offline-mod.html#removing-beyond-locks","title":"Removing beyond locks","text":"Info
Allows playing Beyond (BYD) difficulty on charts that have it.
"},{"location":"offline-mod.html#patching-scenecontrol","title":"Patching scenecontrol","text":"Info
Only if you want to experience the April Fools charts to its fullest.
"},{"location":"offline-mod.html#removing-world-mode-restrictions","title":"Removing world mode restrictions","text":"Info
Unlocks all world mode charts.
"},{"location":"private-server.html","title":"Setting up your own Arcaea server","text":"Before starting
Make sure you have dumped Arcaea APK/IPA from your device before proceeding.
"},{"location":"private-server.html#obtaining-content-bundle","title":"Obtaining content bundle","text":"Note
Only for Arcaea 5.4.0+ and non-Chinese versions.
Starting from Arcaea 5.4.0, the game now uses content bundle to deliver base contents such as characters and songs. You must obtain this before proceeding.
Obtaining the content bundle will requires you to install Arcaea once and let it finish downloading the bundle (~491 MB).
Tip
Force quit the game AFTER the content bundle is downloaded (before file verification).
After downloading it, steps to get the files will be different depending on your operating system
For Android, the content bundle is stored in /data/data/moe.low.arc/files. Root/custom recoveries (e.g. TWRP) is required to access this directory. Shizuku will not work.
For iOS, the content bundle is stored in /var/mobile/Containers/Data/Application/<Arcaea data container ID>/Library/Application Support. Filza or an unsandboxed file manager is required to access this directory.
Copy the dltemp folder to your computer. Inside it should contain 2 files with the same filename: one with .bundle and one with .json.
Note
If you had already patched Arcaea, feel free to skip this section and proceed to Setting up private server.
"},{"location":"private-server.html#using-binary-patches","title":"Using Binary Patches","text":"Before starting
You will need a software that allows applying .xdelta binary patches. DeltaPatcher is used in this guide.
Warning
Android will receive patches for newer versions slower than iOS. As an alternative, try patching it yourself or wait until Android patches is made.
Download the appropriate patch for your version:
iOSAndroid 5.6.3Being updated, please come back later!
5.6.1Download
5.6.3Being updated, please come back later!
Now open DeltaPatcher, you will be presented with an interface like this:
Select the appropriate unmodified executable, and the appropriate patch, then press Apply patch.
After that, you are done!
"},{"location":"private-server.html#manual-patching-advanced","title":"Manual patching (Advanced)","text":"Before starting
This section requires basic knowledge of disassembling as well as Googling. You will also need a disassembler with support for ELF/Mach-O arm64 executables and pseudo-code decompilation for this section. IDA Pro is used here.
About NOP
1F 20 03 D5 is the hex equivalent of ARM64 nop instruction. Overwrite a hex address with it when you want to remove a specific instruction call.
Open the appropriate executable file for your operating system, and wait for the initial auto-analysis to complete (indicated by the status bar at the bottom showing Idle.) This process may take a while depending on your computer so please be patient.
After the initial auto-analysis, Press SHIFT + F12 and wait for the string list to be generated (again, this may take a while.)
In the Strings sub-window, press ALT + T and search for cookieFiIe.txt until you found exactly this.
Double-click it, and while highlighting this part, press X to perform xref (cross-reference.)
Choose the second xref (for Android) or the only present xref (for iOS) and press ENTER.
Press F5 or View > Open subviews > Generate pseudocode (this will not work if IDA is still analyzing the binary), wait for the decompilation to complete (may take a while) until you see something like this (may differ depending on version used but the general structure should be the same):
Scroll to bottom until you see this part, then highlight it by clicking onto it (names may be different but the structure should remain the same.)
Now switch to the Hex View sub-window, make sure it synchronizes with the Pseudo Code sub-window, and NOP it.
After that, make sure the entire code line is absent when re-decompiled.
Now return to the Strings sub-window, and this time search for vtvtvt.
xref it, and choose the first xref entry for iOS, or the one with @PAGE for Android.
Decompile it again, and scroll down a little bit until you see this part:
Highlight this part, and NOP it like above:
After that, apply the patches and you are done!
After patching the executable, save the file and recompress the APK/IPA file. For Android, you must resign the APK file before installing it onto your device. You may now sideload it onto your device using ADB, AppSync Unified (not recommended due to potential crashes and issues.), AltStore (& friends) or TrollStore (recommended for supported devices.)
"},{"location":"private-server.html#setting-up-private-server","title":"Setting up private server","text":"For this section, you will need:
Python 3.6 or newer.
Charles (recommended), Fiddler Classic or any programs that allows redirecting HTTP requests through a proxy.
Time and patience.
Warning
Using any other OSes other than Windows for this may or may not work. You may need to figure stuff out on your own.
First, you need to obtain the server software. We will be using Lost-MSth's Arcaea-server for this purpose. You may obtain it using git like this git clone https://github.com/Lost-MSth/Arcaea-server -b dev or by downloading the ZIP file of the dev branch.
After obtaining the server software, navigate to its directory (<Arcaea-server>/latest version), and with Python 3.6 or newer installed, run pip install -m requirements.txt.
From here, certain steps may differ depending on your operating system and the proxy software you picked. We will be using iOS and Charles in this case but the same can also be done for other similarly functioning software.
"},{"location":"private-server.html#proxy-setup","title":"Proxy setup","text":"Open Charles and you will be presented with an interface like this:
Press CTRL + SHIFT + L or Proxy > SSL Proxying Settings and tick the Enable SSL Proxying box. After that, click Add, fill * for both Host and Port then press OK, after that untick the newly added box. In the end, the SSL Proxying Settings window should look like this:
Close that window, go to Proxy > Proxy Settings and tweak it exactly like this image:
Navigate to the Windows tab and tick all checkboxes:
Close that window, and go to Help > Local IP Addresses. It will look something like this:
Your local IP address will most likely be the first item in the list (in this case, since I am using Ethernet connection, it will be the first one.) Copy that IP address or memorize it.
About local IP addresses
This is your local IP address, meaning it can only be accessed by devices that are connected to the same network.
You may now close that window and press CTRL + ALT + M or Tools > Map Remote..., tick Enable Map Remote and press Add. Tweak it like this:
In the Map To section, the Host textbox needs to be your local IP address that you got from above, and the Port textbox is a 4 digit number that your server will be running on. Pick any numbers you want except for ports like 8888 or 8889 and memorize it along with your local IP address. Press OK. The map remote interface should look like this in the end:
You may now close that window. At this point, the proxy is now ready.
"},{"location":"private-server.html#server-software","title":"Server software","text":"The server software directory will look like this:
Copy the config.example.py file into a file named config.py and open it with your favorite text editor.
Most of the config properties should already be self-explanatory. Below is guide for a few important parts.
Remember that local IP address and port that you memorized not long ago? Well enter it here:
HOST is your local IP address and PORT is the port you have choosen earlier.
For GAME_API_PREFIX, this will differ depending on your Arcaea version. Refer to the table below.
Version Prefix 5.5.6 -> 5.6.1/hanami/29 For ALLOW_APPVERSION, remove everything inside. You may add a version to the list (e.g. `5.6.1) if you want to restrict the server to (a) specific server.
For this part:
If you want to use link play functionality, the only variables you need to care about are LINKPLAY_HOST and LINKPLAY_AUTHENTICATION.
LINKPLAY_HOST needs to be the same as the IP address you have set in the HOST variable earlier unless the SET_LINKPLAY_SERVER_AS_SUB_PROCESS variable is set to False, at which you will need to specify a separate IP address for the link play server.
For LINKPLAY_AUTHENTICATION, you can leave it as-is or type in anything you want.
If you do not want to use link play functionality, the LINKPLAY_HOST variable needs to be an empty string.
For SSL_CERT and SSL_KEY, if you want to have the server running under HTTPS, you may supply an SSL certificate here if you have one (.pem and .key file).
Warning
Running the server under HTTPS may cause issues with downloading packs/songs.
Adjust the rest of the config file to your own likings. Save the file after finished.
Now go to the database folder and it will look like this:
Run the database_initialize.py file to generate the database. Make sure you have installed all dependencies prior to running it in order for it to work. A file named arcaea_database.db will be created if successful. After that, do all of these:
bundle folder. The actual bundle must have the .cb extension and the meta file must have the .json extension. Both must have the same filename (e.g. 5.6.0).Note
The content bundle in the server must be the same as the one existing in your Arcaea client (the metadata and content MUST match) as otherwise you will encounter issues when trying to login. If you change the content bundle in the server, the one on the client should be redownloaded.
To avoid issues, use the content bundle that you have obtained earlier.
Put any songs you have into the songs folder. A song is a folder containing multiple .aff files (every difficulties of the song), base.jpg files (the jacket art), the song itself, the PV video for Terminal songs, and any additional files for that song.
Make any adjustments you want to make.
At this point, the server software is now ready.
"},{"location":"private-server.html#on-device-setup","title":"On device setup","text":"Note
Your phone and your computer (the one that runs the server) MUST be connected to the same network for the server to work.
iOSAndroidOpen the Settings app, go to Wi-Fi settings, press the ! icon on the connected network, scroll down until you found the HTTP Proxy settings. In the Configure Proxy settings, select Manual and fill in the Server field which is your local IP address and the Port field which is 8888. Now press Save and (optionally) turn off and reconnect to your Wi-Fi network.
Now on your computer, return to Charles and go to Help > SSL Proxying > Install Charles Root Certificate on a Mobile Device or Remote Browser. A window like this will show up:
Follow the steps listed in it to install the Charles certificate onto your device. You will also need to go to Settings > General > About > Certificate Trust Settings and enable full trust for the newly added certificate for it to take affect.
Warning
From limited testing, Android is finicky when it comes to maintaining connection to proxy server. Things may not work correctly or even at all. If you have a way to fix this, feel free to contribute!
Go back to Charles and go to Help > SSL Proxying > Save Charles Root Certificate... Save the .pem file somewhere. Rename the .pem extension to .crt. Now transfer this file to your Android device and install it to both categories.
On Android, you will need to rely on a proxifier app such as VProxid or RProxid (requires root, recommended). You need to connect through the SOCKS5 proxy server.
After installing either of the proxifier app, open it and press the + icon, for Server IP, enter your local IP address; for Server Port, enter 8889. Scroll down a little bit and press Click to select application(s) then tick Arcaea. Now return and press the play button to start the VPN. Wait until it shows all good.
Now your device is ready to connect to the private server!
Note
Disable the proxy when you have finished playing to prevent connectivity issues. The proxy will need to be re-enabled everytime you want to use the server. A dedicated 24/7 server such as a Raspberry Pi, a spare phone/computer with working shell, or a cloud server (VPS) is recommended for always-on server hosting.
"},{"location":"private-server.html#playing","title":"Playing","text":"Return to the root directory of your server and run the run.bat file. It may take a while to start depending on the amount of songs you added. If the server console shows this:
Congratulations! Your server is now up and running! Now all that left is open Arcaea and play!
If you see something like this, it means the server is working as intended.
At this point, you are basically done! Enjoy your new server!
"},{"location":"private-server.html#fixes-for-notable-issues","title":"Fixes for notable issues","text":"The game kept prompting to update a pack despite having already downloaded it.
-> Check the song folders to see if they are named correctly and that all files (plus PV videos and audios if exists) are inside.
Cannot download any songs.
-> Make sure the server is running under HTTP connection. For iOS, you may need to edit the Info.plist file using a plist editor to allow HTTP connection without a jailbreak by setting NSAllowsArbitraryLoads property to true.
Nothing works, even logging in.
-> Check if the GAME_API_PREFIX variable in the config.py file is set correctly. If that did not work, make sure you have set up the proxy correctly (refer to the Proxy setup and On device proxy setup section.)
This is a (work-in-progress) centralized wiki for everything Arcaea modding related!
Disclaimer
Everything present in this wiki is made purely for educational and research purposes. By following anything in this wiki, you acknowledge that under no circumstances shall we be held legally responsible or liable for any consequences that may arise from your actions. No proprietary and paid assets, resources and files will be provided and must be individually obtained through official means.
Looking for contributors!
Arcaea Modding Wiki is looking for contributors! The wiki still needs much polishing and improving such as better reference images and such. If you want to contribute, visit the GitHub repository!
"},{"location":"arc-dump.html","title":"Obtaining Arcaea APK/IPA","text":"Work in progress
This page is being actively worked on. Contributions of any kind are much appreciated.
Before proceeding with modding Arcaea, its APK/IPA file must be dumped from your device. Depending on your operating system, dumping procedure will be different.
"},{"location":"arc-dump.html#ios","title":"iOS","text":"Before starting
Either TrollStore or a jailbroken device is required. As a result, you will not be able to perform anything listed in here if you are using any devices that were updated to iOS 16.6.1 or newer and is not checkm8-vulnerable.
Before proceeding, make sure you have Arcaea installed and have opened at least once.
"},{"location":"arc-dump.html#using-trolldecrypt","title":"Using TrollDecrypt","text":"Info
The recommended method. Works for all versions that are supported by TrollStore.
Install TrollDecrypt onto your device using TrollStore, then open it. All apps that can be decrypted will be listed, select Arcaea and choose Yes when prompted. The decryption process will take a while. When it finishes, the resulting IPA will be available form within the app, copy it to your PC and you are done!
"},{"location":"arc-dump.html#using-dumpdecrypter","title":"Using DumpDecrypter","text":"Info
An alternative to TrollDecrypt for devices that is not supported by TrollStore. May not work with rootless jailbreaks (e.g. Dopamine, palera1n).
Open Sileo or any package managers that you like, add this repository: https://repo.tuandb.name.vn. After that, install DumpDecrypter from it.
Open DumpDecrypter, switch to the Settings tab and enable all available options. Then return to the AppList tab and select Arcaea, press Continue when prompted and wait for the decryption process to complete. Arcaea will automatically open and then close shortly after. When it finishes, press Go to Filza to view (Filza must be installed from the BigBoss repository beforehand) then copy the resulting IPA to your PC and you are done!
"},{"location":"arc-dump.html#android","title":"Android","text":"Work in progress
This section is being worked on.
"},{"location":"custom-charts-packs.html","title":"Adding custom charts/packs","text":"Work in progress
This page is being actively worked on. Contributions of any kind are much appreciated. The content below are unfinished.
Before starting
This guide requires a functional private server already set up and running.
"},{"location":"custom-charts-packs.html#unpacking-the-content-bundle","title":"Unpacking the content bundle","text":"Note
Only for Arcaea 5.4.0 or newer and non-Chinese versions.
"},{"location":"custom-charts-packs.html#songlistpacklist-files","title":"songlist/packlist files","text":""},{"location":"custom-charts-packs.html#private-server-database","title":"Private server database","text":""},{"location":"custom-charts-packs.html#custom-packs","title":"Custom packs","text":""},{"location":"custom-charts-packs.html#custom-charts","title":"Custom charts","text":""},{"location":"custom-charts-packs.html#repacking-the-content-bundle","title":"Repacking the content bundle","text":""},{"location":"offline-mod.html","title":"Reverse Engineering Arcaea","text":"Before starting
This page is being rewritten. There will be no precise ETAs on the completion date.
This guide is NOT beginner-friendly and you will have to figure out a lot of things yourself. Only proceed if you know what you are doing.
"},{"location":"offline-mod.html#removing-hash-verification","title":"Removing hash verification","text":"Info
Allows making changes to the game files. Only for pre-5.4.0 and Chinese versions.
"},{"location":"offline-mod.html#removing-lock-icon","title":"Removing lock icon","text":"Info
Remove the lock icon on locked packs. Purely for aesthetic purposes.
"},{"location":"offline-mod.html#removing-beyond-locks","title":"Removing beyond locks","text":"Info
Allows playing Beyond (BYD) difficulty on charts that have it.
"},{"location":"offline-mod.html#patching-scenecontrol","title":"Patching scenecontrol","text":"Info
Only if you want to experience the April Fools charts to its fullest.
"},{"location":"offline-mod.html#removing-world-mode-restrictions","title":"Removing world mode restrictions","text":"Info
Unlocks all world mode charts.
"},{"location":"private-server.html","title":"Setting up your own Arcaea server","text":"Before starting
Make sure you have dumped Arcaea APK/IPA from your device before proceeding.
"},{"location":"private-server.html#obtaining-content-bundle","title":"Obtaining content bundle","text":"Note
Only for Arcaea 5.4.0+ and non-Chinese versions.
Starting from Arcaea 5.4.0, the game now uses content bundle to deliver base contents such as characters and songs. You must obtain this before proceeding.
Obtaining the content bundle will requires you to install Arcaea once and let it finish downloading the bundle (~491 MB).
Tip
Force quit the game AFTER the content bundle is downloaded (before file verification).
After downloading it, steps to get the files will be different depending on your operating system
For Android, the content bundle is stored in /data/data/moe.low.arc/files. Root/custom recoveries (e.g. TWRP) is required to access this directory. Shizuku will not work.
For iOS, the content bundle is stored in /var/mobile/Containers/Data/Application/<Arcaea data container ID>/Library/Application Support. Filza or an unsandboxed file manager is required to access this directory.
Copy the dltemp folder to your computer. Inside it should contain 2 files with the same filename: one with .bundle and one with .json.
Note
If you had already patched Arcaea, feel free to skip this section and proceed to Setting up private server.
"},{"location":"private-server.html#using-binary-patches","title":"Using Binary Patches","text":"Before starting
You will need a software that allows applying .xdelta binary patches. DeltaPatcher is used in this guide.
Warning
Android will receive patches for newer versions slower than iOS. As an alternative, try patching it yourself or wait until Android patches is made.
Download the appropriate patch for your version:
iOSAndroid 5.6.3Download
5.6.1Download
5.6.3Being updated, please come back later!
Now open DeltaPatcher, you will be presented with an interface like this:
Select the appropriate unmodified executable, and the appropriate patch, then press Apply patch.
After that, you are done!
"},{"location":"private-server.html#manual-patching-advanced","title":"Manual patching (Advanced)","text":"Before starting
This section requires basic knowledge of disassembling as well as Googling. You will also need a disassembler with support for ELF/Mach-O arm64 executables and pseudo-code decompilation for this section. IDA Pro is used here.
About NOP
1F 20 03 D5 is the hex equivalent of ARM64 nop instruction. Overwrite a hex address with it when you want to remove a specific instruction call.
Open the appropriate executable file for your operating system, and wait for the initial auto-analysis to complete (indicated by the status bar at the bottom showing Idle.) This process may take a while depending on your computer so please be patient.
After the initial auto-analysis, Press SHIFT + F12 and wait for the string list to be generated (again, this may take a while.)
In the Strings sub-window, press ALT + T and search for cookieFiIe.txt until you found exactly this.
Double-click it, and while highlighting this part, press X to perform xref (cross-reference.)
Choose the second xref (for Android) or the only present xref (for iOS) and press ENTER.
Press F5 or View > Open subviews > Generate pseudocode (this will not work if IDA is still analyzing the binary), wait for the decompilation to complete (may take a while) until you see something like this (may differ depending on version used but the general structure should be the same):
Scroll to bottom until you see this part, then highlight it by clicking onto it (names may be different but the structure should remain the same.)
Now switch to the Hex View sub-window, make sure it synchronizes with the Pseudo Code sub-window, and NOP it.
After that, make sure the entire code line is absent when re-decompiled.
Now return to the Strings sub-window, and this time search for vtvtvt.
xref it, and choose the first xref entry for iOS, or the one with @PAGE for Android.
Decompile it again, and scroll down a little bit until you see this part:
Highlight this part, and NOP it like above:
After that, apply the patches and you are done!
After patching the executable, save the file and recompress the APK/IPA file. For Android, you must resign the APK file before installing it onto your device. You may now sideload it onto your device using ADB, AppSync Unified (not recommended due to potential crashes and issues.), AltStore (& friends) or TrollStore (recommended for supported devices.)
"},{"location":"private-server.html#setting-up-private-server","title":"Setting up private server","text":"For this section, you will need:
Python 3.6 or newer.
Charles (recommended), Fiddler Classic or any programs that allows redirecting HTTP requests through a proxy.
Time and patience.
Warning
Using any other OSes other than Windows for this may or may not work. You may need to figure stuff out on your own.
First, you need to obtain the server software. We will be using Lost-MSth's Arcaea-server for this purpose. You may obtain it using git like this git clone https://github.com/Lost-MSth/Arcaea-server -b dev or by downloading the ZIP file of the dev branch.
After obtaining the server software, navigate to its directory (<Arcaea-server>/latest version), and with Python 3.6 or newer installed, run pip install -m requirements.txt.
From here, certain steps may differ depending on your operating system and the proxy software you picked. We will be using iOS and Charles in this case but the same can also be done for other similarly functioning software.
"},{"location":"private-server.html#proxy-setup","title":"Proxy setup","text":"Open Charles and you will be presented with an interface like this:
Press CTRL + SHIFT + L or Proxy > SSL Proxying Settings and tick the Enable SSL Proxying box. After that, click Add, fill * for both Host and Port then press OK, after that untick the newly added box. In the end, the SSL Proxying Settings window should look like this:
Close that window, go to Proxy > Proxy Settings and tweak it exactly like this image:
Navigate to the Windows tab and tick all checkboxes:
Close that window, and go to Help > Local IP Addresses. It will look something like this:
Your local IP address will most likely be the first item in the list (in this case, since I am using Ethernet connection, it will be the first one.) Copy that IP address or memorize it.
About local IP addresses
This is your local IP address, meaning it can only be accessed by devices that are connected to the same network.
You may now close that window and press CTRL + ALT + M or Tools > Map Remote..., tick Enable Map Remote and press Add. Tweak it like this:
In the Map To section, the Host textbox needs to be your local IP address that you got from above, and the Port textbox is a 4 digit number that your server will be running on. Pick any numbers you want except for ports like 8888 or 8889 and memorize it along with your local IP address. Press OK. The map remote interface should look like this in the end:
You may now close that window. At this point, the proxy is now ready.
"},{"location":"private-server.html#server-software","title":"Server software","text":"The server software directory will look like this:
Copy the config.example.py file into a file named config.py and open it with your favorite text editor.
Most of the config properties should already be self-explanatory. Below is guide for a few important parts.
Remember that local IP address and port that you memorized not long ago? Well enter it here:
HOST is your local IP address and PORT is the port you have choosen earlier.
For GAME_API_PREFIX, this will differ depending on your Arcaea version. Refer to the table below.
Version Prefix 5.5.6 -> 5.6.1/hanami/29 For ALLOW_APPVERSION, remove everything inside. You may add a version to the list (e.g. `5.6.1) if you want to restrict the server to (a) specific server.
For this part:
If you want to use link play functionality, the only variables you need to care about are LINKPLAY_HOST and LINKPLAY_AUTHENTICATION.
LINKPLAY_HOST needs to be the same as the IP address you have set in the HOST variable earlier unless the SET_LINKPLAY_SERVER_AS_SUB_PROCESS variable is set to False, at which you will need to specify a separate IP address for the link play server.
For LINKPLAY_AUTHENTICATION, you can leave it as-is or type in anything you want.
If you do not want to use link play functionality, the LINKPLAY_HOST variable needs to be an empty string.
For SSL_CERT and SSL_KEY, if you want to have the server running under HTTPS, you may supply an SSL certificate here if you have one (.pem and .key file).
Warning
Running the server under HTTPS may cause issues with downloading packs/songs.
Adjust the rest of the config file to your own likings. Save the file after finished.
Now go to the database folder and it will look like this:
Run the database_initialize.py file to generate the database. Make sure you have installed all dependencies prior to running it in order for it to work. A file named arcaea_database.db will be created if successful. After that, do all of these:
bundle folder. The actual bundle must have the .cb extension and the meta file must have the .json extension. Both must have the same filename (e.g. 5.6.0).Note
The content bundle in the server must be the same as the one existing in your Arcaea client (the metadata and content MUST match) as otherwise you will encounter issues when trying to login. If you change the content bundle in the server, the one on the client should be redownloaded.
To avoid issues, use the content bundle that you have obtained earlier.
Put any songs you have into the songs folder. A song is a folder containing multiple .aff files (every difficulties of the song), base.jpg files (the jacket art), the song itself, the PV video for Terminal songs, and any additional files for that song.
Make any adjustments you want to make.
At this point, the server software is now ready.
"},{"location":"private-server.html#on-device-setup","title":"On device setup","text":"Note
Your phone and your computer (the one that runs the server) MUST be connected to the same network for the server to work.
iOSAndroidOpen the Settings app, go to Wi-Fi settings, press the ! icon on the connected network, scroll down until you found the HTTP Proxy settings. In the Configure Proxy settings, select Manual and fill in the Server field which is your local IP address and the Port field which is 8888. Now press Save and (optionally) turn off and reconnect to your Wi-Fi network.
Now on your computer, return to Charles and go to Help > SSL Proxying > Install Charles Root Certificate on a Mobile Device or Remote Browser. A window like this will show up:
Follow the steps listed in it to install the Charles certificate onto your device. You will also need to go to Settings > General > About > Certificate Trust Settings and enable full trust for the newly added certificate for it to take affect.
Warning
From limited testing, Android is finicky when it comes to maintaining connection to proxy server. Things may not work correctly or even at all. If you have a way to fix this, feel free to contribute!
Go back to Charles and go to Help > SSL Proxying > Save Charles Root Certificate... Save the .pem file somewhere. Rename the .pem extension to .crt. Now transfer this file to your Android device and install it to both categories.
On Android, you will need to rely on a proxifier app such as VProxid or RProxid (requires root, recommended). You need to connect through the SOCKS5 proxy server.
After installing either of the proxifier app, open it and press the + icon, for Server IP, enter your local IP address; for Server Port, enter 8889. Scroll down a little bit and press Click to select application(s) then tick Arcaea. Now return and press the play button to start the VPN. Wait until it shows all good.
Now your device is ready to connect to the private server!
Note
Disable the proxy when you have finished playing to prevent connectivity issues. The proxy will need to be re-enabled everytime you want to use the server. A dedicated 24/7 server such as a Raspberry Pi, a spare phone/computer with working shell, or a cloud server (VPS) is recommended for always-on server hosting.
"},{"location":"private-server.html#playing","title":"Playing","text":"Return to the root directory of your server and run the run.bat file. It may take a while to start depending on the amount of songs you added. If the server console shows this:
Congratulations! Your server is now up and running! Now all that left is open Arcaea and play!
If you see something like this, it means the server is working as intended.
At this point, you are basically done! Enjoy your new server!
"},{"location":"private-server.html#fixes-for-notable-issues","title":"Fixes for notable issues","text":"The game kept prompting to update a pack despite having already downloaded it.
-> Check the song folders to see if they are named correctly and that all files (plus PV videos and audios if exists) are inside.
Cannot download any songs.
-> Make sure the server is running under HTTP connection. For iOS, you may need to edit the Info.plist file using a plist editor to allow HTTP connection without a jailbreak by setting NSAllowsArbitraryLoads property to true.
Nothing works, even logging in.
-> Check if the GAME_API_PREFIX variable in the config.py file is set correctly. If that did not work, make sure you have set up the proxy correctly (refer to the Proxy setup and On device proxy setup section.)
This is a (work-in-progress) centralized wiki for everything Arcaea modding related!
Disclaimer
Everything present in this wiki is made purely for educational and research purposes. By following anything in this wiki, you acknowledge that under no circumstances shall we be held legally responsible or liable for any consequences that may arise from your actions. No proprietary and paid assets, resources and files will be provided and must be individually obtained through official means.
Looking for contributors!
Arcaea Modding Wiki is looking for contributors! The wiki still needs much polishing and improving such as better reference images and such. If you want to contribute, visit the GitHub repository!
"},{"location":"arc-dump.html","title":"Obtaining Arcaea APK/IPA","text":"Work in progress
This page is being actively worked on. Contributions of any kind are much appreciated.
Before proceeding with modding Arcaea, its APK/IPA file must be dumped from your device. Depending on your operating system, dumping procedure will be different.
"},{"location":"arc-dump.html#ios","title":"iOS","text":"Before starting
Either TrollStore or a jailbroken device is required. As a result, you will not be able to perform anything listed in here if you are using any devices that were updated to iOS 16.6.1 or newer and is not checkm8-vulnerable.
Before proceeding, make sure you have Arcaea installed and have opened at least once.
"},{"location":"arc-dump.html#using-trolldecrypt","title":"Using TrollDecrypt","text":"Info
The recommended method. Works for all versions that are supported by TrollStore.
Install TrollDecrypt onto your device using TrollStore, then open it. All apps that can be decrypted will be listed, select Arcaea and choose Yes when prompted. The decryption process will take a while. When it finishes, the resulting IPA will be available form within the app, copy it to your PC and you are done!
"},{"location":"arc-dump.html#using-dumpdecrypter","title":"Using DumpDecrypter","text":"Info
An alternative to TrollDecrypt for devices that is not supported by TrollStore. **May not work with rootless jailbreaks (e.g. Dopamine, palera1n).
Open Sileo or any package managers that you like, add this repository: https://repo.tuandb.name.vn. After that, install DumpDecrypter from it.
Open DumpDecrypter, switch to the Settings tab and enable all available options. Then return to the AppList tab and select Arcaea, press Continue when prompted and wait for the decryption process to complete. Arcaea will automatically open and then close shortly after. When it finishes, press Go to Filza to view (Filza must be installed from the BigBoss repository beforehand) then copy the resulting IPA to your PC and you are done!
"},{"location":"arc-dump.html#android","title":"Android","text":"Work in progress
This section is being worked on.
"},{"location":"custom-charts-packs.html","title":"Adding custom charts/packs","text":"Work in progress
This page is being actively worked on. Contributions of any kind are much appreciated. The content below are unfinished.
Before starting
This guide requires a functional private server already set up and running.
"},{"location":"custom-charts-packs.html#unpacking-the-content-bundle","title":"Unpacking the content bundle","text":"Note
Only for Arcaea 5.4.0 or newer and non-Chinese versions.
"},{"location":"custom-charts-packs.html#songlistpacklist-files","title":"songlist/packlist files","text":""},{"location":"custom-charts-packs.html#private-server-database","title":"Private server database","text":""},{"location":"custom-charts-packs.html#custom-packs","title":"Custom packs","text":""},{"location":"custom-charts-packs.html#custom-charts","title":"Custom charts","text":""},{"location":"custom-charts-packs.html#repacking-the-content-bundle","title":"Repacking the content bundle","text":""},{"location":"offline-mod.html","title":"Reverse Engineering Arcaea","text":"Before starting
This page is being rewritten. There will be no precise ETAs on the completion date.
This guide is NOT beginner-friendly and you will have to figure out a lot of things yourself. Only proceed if you know what you are doing.
"},{"location":"offline-mod.html#removing-hash-verification","title":"Removing hash verification","text":"Info
Allows making changes to the game files. Only for pre-5.4.0 and Chinese versions.
"},{"location":"offline-mod.html#removing-lock-icon","title":"Removing lock icon","text":"Info
Remove the lock icon on locked packs. Purely for aesthetic purposes.
"},{"location":"offline-mod.html#removing-beyond-locks","title":"Removing beyond locks","text":"Info
Allows playing Beyond (BYD) difficulty on charts that have it.
"},{"location":"offline-mod.html#patching-scenecontrol","title":"Patching scenecontrol","text":"Info
Only if you want to experience the April Fools charts to its fullest.
"},{"location":"offline-mod.html#removing-world-mode-restrictions","title":"Removing world mode restrictions","text":"Info
Unlocks all world mode charts.
"},{"location":"private-server.html","title":"Setting up your own Arcaea server","text":"Before starting
Make sure you have dumped Arcaea APK/IPA from your device before proceeding.
"},{"location":"private-server.html#obtaining-content-bundle","title":"Obtaining content bundle","text":"Note
Only for Arcaea 5.4.0+ and non-Chinese versions.
Starting from Arcaea 5.4.0, the game now uses content bundle to deliver base contents such as characters and songs. You must obtain this before proceeding.
Obtaining the content bundle will requires you to install Arcaea once and let it finish downloading the bundle (~491 MB).
Tip
Force quit the game AFTER the content bundle is downloaded (before file verification).
After downloading it, steps to get the files will be different depending on your operating system
For Android, the content bundle is stored in /data/data/moe.low.arc/files. Root/custom recoveries (e.g. TWRP) is required to access this directory. Shizuku will not work.
For iOS, the content bundle is stored in /var/mobile/Containers/Data/Application/<Arcaea data container ID>/Library/Application Support. Filza or an unsandboxed file manager is required to access this directory.
Copy the dltemp folder to your computer. Inside it should contain 2 files with the same filename: one with .bundle and one with .json.
Note
If you had already patched Arcaea, feel free to skip this section and proceed to Setting up private server.
"},{"location":"private-server.html#using-binary-patches","title":"Using Binary Patches","text":"Before starting
You will need a software that allows applying .xdelta binary patches. DeltaPatcher is used in this guide.
Warning
Android will receive patches for newer versions slower than iOS. As an alternative, try patching it yourself or wait until Android patches is made.
Download the appropriate patch for your version:
iOSAndroid 5.6.3Being updated, please come back later!
5.6.1Download
5.6.3Being updated, please come back later!
Now open DeltaPatcher, you will be presented with an interface like this:
Select the appropriate unmodified executable, and the appropriate patch, then press Apply patch.
After that, you are done!
"},{"location":"private-server.html#manual-patching-advanced","title":"Manual patching (Advanced)","text":"Before starting
This section requires basic knowledge of disassembling as well as Googling. You will also need a disassembler with support for ELF/Mach-O arm64 executables and pseudo-code decompilation for this section. IDA Pro is used here.
About NOP
1F 20 03 D5 is the hex equivalent of ARM64 nop instruction. Overwrite a hex address with it when you want to remove a specific instruction call.
Open the appropriate executable file for your operating system, and wait for the initial auto-analysis to complete (indicated by the status bar at the bottom showing Idle.) This process may take a while depending on your computer so please be patient.
After the initial auto-analysis, Press SHIFT + F12 and wait for the string list to be generated (again, this may take a while.)
In the Strings sub-window, press ALT + T and search for cookieFiIe.txt until you found exactly this.
Double-click it, and while highlighting this part, press X to perform xref (cross-reference.)
Choose the second xref (for Android) or the only present xref (for iOS) and press ENTER.
Press F5 or View > Open subviews > Generate pseudocode (this will not work if IDA is still analyzing the binary), wait for the decompilation to complete (may take a while) until you see something like this (may differ depending on version used but the general structure should be the same):
Scroll to bottom until you see this part, then highlight it by clicking onto it (names may be different but the structure should remain the same.)
Now switch to the Hex View sub-window, make sure it synchronizes with the Pseudo Code sub-window, and NOP it.
After that, make sure the entire code line is absent when re-decompiled.
Now return to the Strings sub-window, and this time search for vtvtvt.
xref it, and choose the first xref entry for iOS, or the one with @PAGE for Android.
Decompile it again, and scroll down a little bit until you see this part:
Highlight this part, and NOP it like above:
After that, apply the patches and you are done!
After patching the executable, save the file and recompress the APK/IPA file. For Android, you must resign the APK file before installing it onto your device. You may now sideload it onto your device using ADB, AppSync Unified (not recommended due to potential crashes and issues.), AltStore (& friends) or TrollStore (recommended for supported devices.)
"},{"location":"private-server.html#setting-up-private-server","title":"Setting up private server","text":"For this section, you will need:
Python 3.6 or newer.
Charles (recommended), Fiddler Classic or any programs that allows redirecting HTTP requests through a proxy.
Time and patience.
Warning
Using any other OSes other than Windows for this may or may not work. You may need to figure stuff out on your own.
First, you need to obtain the server software. We will be using Lost-MSth's Arcaea-server for this purpose. You may obtain it using git like this git clone https://github.com/Lost-MSth/Arcaea-server -b dev or by downloading the ZIP file of the dev branch.
After obtaining the server software, navigate to its directory (<Arcaea-server>/latest version), and with Python 3.6 or newer installed, run pip install -m requirements.txt.
From here, certain steps may differ depending on your operating system and the proxy software you picked. We will be using iOS and Charles in this case but the same can also be done for other similarly functioning software.
"},{"location":"private-server.html#proxy-setup","title":"Proxy setup","text":"Open Charles and you will be presented with an interface like this:
Press CTRL + SHIFT + L or Proxy > SSL Proxying Settings and tick the Enable SSL Proxying box. After that, click Add, fill * for both Host and Port then press OK, after that untick the newly added box. In the end, the SSL Proxying Settings window should look like this:
Close that window, go to Proxy > Proxy Settings and tweak it exactly like this image:
Navigate to the Windows tab and tick all checkboxes:
Close that window, and go to Help > Local IP Addresses. It will look something like this:
Your local IP address will most likely be the first item in the list (in this case, since I am using Ethernet connection, it will be the first one.) Copy that IP address or memorize it.
About local IP addresses
This is your local IP address, meaning it can only be accessed by devices that are connected to the same network.
You may now close that window and press CTRL + ALT + M or Tools > Map Remote..., tick Enable Map Remote and press Add. Tweak it like this:
In the Map To section, the Host textbox needs to be your local IP address that you got from above, and the Port textbox is a 4 digit number that your server will be running on. Pick any numbers you want except for ports like 8888 or 8889 and memorize it along with your local IP address. Press OK. The map remote interface should look like this in the end:
You may now close that window. At this point, the proxy is now ready.
"},{"location":"private-server.html#server-software","title":"Server software","text":"The server software directory will look like this:
Copy the config.example.py file into a file named config.py and open it with your favorite text editor.
Most of the config properties should already be self-explanatory. Below is guide for a few important parts.
Remember that local IP address and port that you memorized not long ago? Well enter it here:
HOST is your local IP address and PORT is the port you have choosen earlier.
For GAME_API_PREFIX, this will differ depending on your Arcaea version. Refer to the table below.
Version Prefix 5.5.6 -> 5.6.1/hanami/29 For ALLOW_APPVERSION, remove everything inside. You may add a version to the list (e.g. `5.6.1) if you want to restrict the server to (a) specific server.
For this part:
If you want to use link play functionality, the only variables you need to care about are LINKPLAY_HOST and LINKPLAY_AUTHENTICATION.
LINKPLAY_HOST needs to be the same as the IP address you have set in the HOST variable earlier unless the SET_LINKPLAY_SERVER_AS_SUB_PROCESS variable is set to False, at which you will need to specify a separate IP address for the link play server.
For LINKPLAY_AUTHENTICATION, you can leave it as-is or type in anything you want.
If you do not want to use link play functionality, the LINKPLAY_HOST variable needs to be an empty string.
For SSL_CERT and SSL_KEY, if you want to have the server running under HTTPS, you may supply an SSL certificate here if you have one (.pem and .key file).
Warning
Running the server under HTTPS may cause issues with downloading packs/songs.
Adjust the rest of the config file to your own likings. Save the file after finished.
Now go to the database folder and it will look like this:
Run the database_initialize.py file to generate the database. Make sure you have installed all dependencies prior to running it in order for it to work. A file named arcaea_database.db will be created if successful. After that, do all of these:
bundle folder. The actual bundle must have the .cb extension and the meta file must have the .json extension. Both must have the same filename (e.g. 5.6.0).Note
The content bundle in the server must be the same as the one existing in your Arcaea client (the metadata and content MUST match) as otherwise you will encounter issues when trying to login. If you change the content bundle in the server, the one on the client should be redownloaded.
To avoid issues, use the content bundle that you have obtained earlier.
Put any songs you have into the songs folder. A song is a folder containing multiple .aff files (every difficulties of the song), base.jpg files (the jacket art), the song itself, the PV video for Terminal songs, and any additional files for that song.
Make any adjustments you want to make.
At this point, the server software is now ready.
"},{"location":"private-server.html#on-device-setup","title":"On device setup","text":"Note
Your phone and your computer (the one that runs the server) MUST be connected to the same network for the server to work.
iOSAndroidOpen the Settings app, go to Wi-Fi settings, press the ! icon on the connected network, scroll down until you found the HTTP Proxy settings. In the Configure Proxy settings, select Manual and fill in the Server field which is your local IP address and the Port field which is 8888. Now press Save and (optionally) turn off and reconnect to your Wi-Fi network.
Now on your computer, return to Charles and go to Help > SSL Proxying > Install Charles Root Certificate on a Mobile Device or Remote Browser. A window like this will show up:
Follow the steps listed in it to install the Charles certificate onto your device. You will also need to go to Settings > General > About > Certificate Trust Settings and enable full trust for the newly added certificate for it to take affect.
Warning
From limited testing, Android is finicky when it comes to maintaining connection to proxy server. Things may not work correctly or even at all. If you have a way to fix this, feel free to contribute!
Go back to Charles and go to Help > SSL Proxying > Save Charles Root Certificate... Save the .pem file somewhere. Rename the .pem extension to .crt. Now transfer this file to your Android device and install it to both categories.
On Android, you will need to rely on a proxifier app such as VProxid or RProxid (requires root, recommended). You need to connect through the SOCKS5 proxy server.
After installing either of the proxifier app, open it and press the + icon, for Server IP, enter your local IP address; for Server Port, enter 8889. Scroll down a little bit and press Click to select application(s) then tick Arcaea. Now return and press the play button to start the VPN. Wait until it shows all good.
Now your device is ready to connect to the private server!
Note
Disable the proxy when you have finished playing to prevent connectivity issues. The proxy will need to be re-enabled everytime you want to use the server. A dedicated 24/7 server such as a Raspberry Pi, a spare phone/computer with working shell, or a cloud server (VPS) is recommended for always-on server hosting.
"},{"location":"private-server.html#playing","title":"Playing","text":"Return to the root directory of your server and run the run.bat file. It may take a while to start depending on the amount of songs you added. If the server console shows this:
Congratulations! Your server is now up and running! Now all that left is open Arcaea and play!
If you see something like this, it means the server is working as intended.
At this point, you are basically done! Enjoy your new server!
"},{"location":"private-server.html#fixes-for-notable-issues","title":"Fixes for notable issues","text":"The game kept prompting to update a pack despite having already downloaded it.
-> Check the song folders to see if they are named correctly and that all files (plus PV videos and audios if exists) are inside.
Cannot download any songs.
-> Make sure the server is running under HTTP connection. For iOS, you may need to edit the Info.plist file using a plist editor to allow HTTP connection without a jailbreak by setting NSAllowsArbitraryLoads property to true.
Nothing works, even logging in.
-> Check if the GAME_API_PREFIX variable in the config.py file is set correctly. If that did not work, make sure you have set up the proxy correctly (refer to the Proxy setup and On device proxy setup section.)
This is a (work-in-progress) centralized wiki for everything Arcaea modding related!
Disclaimer
Everything present in this wiki is made purely for educational and research purposes. By following anything in this wiki, you acknowledge that under no circumstances shall we be held legally responsible or liable for any consequences that may arise from your actions. No proprietary and paid assets, resources and files will be provided and must be individually obtained through official means.
Looking for contributors!
Arcaea Modding Wiki is looking for contributors! The wiki still needs much polishing and improving such as better reference images and such. If you want to contribute, visit the GitHub repository!
"},{"location":"arc-dump.html","title":"Obtaining Arcaea APK/IPA","text":"Work in progress
This page is being actively worked on. Contributions of any kind are much appreciated.
Before proceeding with modding Arcaea, its APK/IPA file must be dumped from your device. Depending on your operating system, dumping procedure will be different.
"},{"location":"arc-dump.html#ios","title":"iOS","text":"Before starting
Either TrollStore or a jailbroken device is required. As a result, you will not be able to perform anything listed in here if you are using any devices that were updated to iOS 16.6.1 or newer and is not checkm8-vulnerable.
Before proceeding, make sure you have Arcaea installed and have opened at least once.
"},{"location":"arc-dump.html#using-trolldecrypt","title":"Using TrollDecrypt","text":"Info
The recommended method. Works for all versions that are supported by TrollStore.
Install TrollDecrypt onto your device using TrollStore, then open it. All apps that can be decrypted will be listed, select Arcaea and choose Yes when prompted. The decryption process will take a while. When it finishes, the resulting IPA will be available form within the app, copy it to your PC and you are done!
"},{"location":"arc-dump.html#using-dumpdecrypter","title":"Using DumpDecrypter","text":"Info
An alternative to TrollDecrypt for devices that is not supported by TrollStore. May not work with rootless jailbreaks (e.g. Dopamine, palera1n).
Open Sileo or any package managers that you like, add this repository: https://repo.tuandb.name.vn. After that, install DumpDecrypter from it.
Open DumpDecrypter, switch to the Settings tab and enable all available options. Then return to the AppList tab and select Arcaea, press Continue when prompted and wait for the decryption process to complete. Arcaea will automatically open and then close shortly after. When it finishes, press Go to Filza to view (Filza must be installed from the BigBoss repository beforehand) then copy the resulting IPA to your PC and you are done!
"},{"location":"arc-dump.html#android","title":"Android","text":"Work in progress
This section is being worked on.
"},{"location":"custom-charts-packs.html","title":"Adding custom charts/packs","text":"Work in progress
This page is being actively worked on. Contributions of any kind are much appreciated. The content below are unfinished.
Before starting
This guide requires a functional private server already set up and running.
"},{"location":"custom-charts-packs.html#unpacking-the-content-bundle","title":"Unpacking the content bundle","text":"Note
Only for Arcaea 5.4.0 or newer and non-Chinese versions.
"},{"location":"custom-charts-packs.html#songlistpacklist-files","title":"songlist/packlist files","text":""},{"location":"custom-charts-packs.html#private-server-database","title":"Private server database","text":""},{"location":"custom-charts-packs.html#custom-packs","title":"Custom packs","text":""},{"location":"custom-charts-packs.html#custom-charts","title":"Custom charts","text":""},{"location":"custom-charts-packs.html#repacking-the-content-bundle","title":"Repacking the content bundle","text":""},{"location":"offline-mod.html","title":"Reverse Engineering Arcaea","text":"Before starting
This page is being rewritten. There will be no precise ETAs on the completion date.
This guide is NOT beginner-friendly and you will have to figure out a lot of things yourself. Only proceed if you know what you are doing.
"},{"location":"offline-mod.html#removing-hash-verification","title":"Removing hash verification","text":"Info
Allows making changes to the game files. Only for pre-5.4.0 and Chinese versions.
"},{"location":"offline-mod.html#removing-lock-icon","title":"Removing lock icon","text":"Info
Remove the lock icon on locked packs. Purely for aesthetic purposes.
"},{"location":"offline-mod.html#removing-beyond-locks","title":"Removing beyond locks","text":"Info
Allows playing Beyond (BYD) difficulty on charts that have it.
"},{"location":"offline-mod.html#patching-scenecontrol","title":"Patching scenecontrol","text":"Info
Only if you want to experience the April Fools charts to its fullest.
"},{"location":"offline-mod.html#removing-world-mode-restrictions","title":"Removing world mode restrictions","text":"Info
Unlocks all world mode charts.
"},{"location":"private-server.html","title":"Setting up your own Arcaea server","text":"Before starting
Make sure you have dumped Arcaea APK/IPA from your device before proceeding.
"},{"location":"private-server.html#obtaining-content-bundle","title":"Obtaining content bundle","text":"Note
Only for Arcaea 5.4.0+ and non-Chinese versions.
Starting from Arcaea 5.4.0, the game now uses content bundle to deliver base contents such as characters and songs. You must obtain this before proceeding.
Obtaining the content bundle will requires you to install Arcaea once and let it finish downloading the bundle (~491 MB).
Tip
Force quit the game AFTER the content bundle is downloaded (before file verification).
After downloading it, steps to get the files will be different depending on your operating system
For Android, the content bundle is stored in /data/data/moe.low.arc/files. Root/custom recoveries (e.g. TWRP) is required to access this directory. Shizuku will not work.
For iOS, the content bundle is stored in /var/mobile/Containers/Data/Application/<Arcaea data container ID>/Library/Application Support. Filza or an unsandboxed file manager is required to access this directory.
Copy the dltemp folder to your computer. Inside it should contain 2 files with the same filename: one with .bundle and one with .json.
Note
If you had already patched Arcaea, feel free to skip this section and proceed to Setting up private server.
"},{"location":"private-server.html#using-binary-patches","title":"Using Binary Patches","text":"Before starting
You will need a software that allows applying .xdelta binary patches. DeltaPatcher is used in this guide.
Warning
Android will receive patches for newer versions slower than iOS. As an alternative, try patching it yourself or wait until Android patches is made.
Download the appropriate patch for your version:
iOSAndroid 5.6.3Download
5.6.1Download
5.6.3Being updated, please come back later!
Now open DeltaPatcher, you will be presented with an interface like this:
Select the appropriate unmodified executable, and the appropriate patch, then press Apply patch.
After that, you are done!
"},{"location":"private-server.html#manual-patching-advanced","title":"Manual patching (Advanced)","text":"Before starting
This section requires basic knowledge of disassembling as well as Googling. You will also need a disassembler with support for ELF/Mach-O arm64 executables and pseudo-code decompilation for this section. IDA Pro is used here.
About NOP
1F 20 03 D5 is the hex equivalent of ARM64 nop instruction. Overwrite a hex address with it when you want to remove a specific instruction call.
Open the appropriate executable file for your operating system, and wait for the initial auto-analysis to complete (indicated by the status bar at the bottom showing Idle.) This process may take a while depending on your computer so please be patient.
After the initial auto-analysis, Press SHIFT + F12 and wait for the string list to be generated (again, this may take a while.)
In the Strings sub-window, press ALT + T and search for cookieFiIe.txt until you found exactly this.
Double-click it, and while highlighting this part, press X to perform xref (cross-reference.)
Choose the second xref (for Android) or the only present xref (for iOS) and press ENTER.
Press F5 or View > Open subviews > Generate pseudocode (this will not work if IDA is still analyzing the binary), wait for the decompilation to complete (may take a while) until you see something like this (may differ depending on version used but the general structure should be the same):
Scroll to bottom until you see this part, then highlight it by clicking onto it (names may be different but the structure should remain the same.)
Now switch to the Hex View sub-window, make sure it synchronizes with the Pseudo Code sub-window, and NOP it.
After that, make sure the entire code line is absent when re-decompiled.
Now return to the Strings sub-window, and this time search for vtvtvt.
xref it, and choose the first xref entry for iOS, or the one with @PAGE for Android.
Decompile it again, and scroll down a little bit until you see this part:
Highlight this part, and NOP it like above:
After that, apply the patches and you are done!
After patching the executable, save the file and recompress the APK/IPA file. For Android, you must resign the APK file before installing it onto your device. You may now sideload it onto your device using ADB, AppSync Unified (not recommended due to potential crashes and issues.), AltStore (& friends) or TrollStore (recommended for supported devices.)
"},{"location":"private-server.html#setting-up-private-server","title":"Setting up private server","text":"For this section, you will need:
Python 3.6 or newer.
Charles (recommended), Fiddler Classic or any programs that allows redirecting HTTP requests through a proxy.
Time and patience.
Warning
Using any other OSes other than Windows for this may or may not work. You may need to figure stuff out on your own.
First, you need to obtain the server software. We will be using Lost-MSth's Arcaea-server for this purpose. You may obtain it using git like this git clone https://github.com/Lost-MSth/Arcaea-server -b dev or by downloading the ZIP file of the dev branch.
After obtaining the server software, navigate to its directory (<Arcaea-server>/latest version), and with Python 3.6 or newer installed, run pip install -m requirements.txt.
From here, certain steps may differ depending on your operating system and the proxy software you picked. We will be using iOS and Charles in this case but the same can also be done for other similarly functioning software.
"},{"location":"private-server.html#proxy-setup","title":"Proxy setup","text":"Open Charles and you will be presented with an interface like this:
Press CTRL + SHIFT + L or Proxy > SSL Proxying Settings and tick the Enable SSL Proxying box. After that, click Add, fill * for both Host and Port then press OK, after that untick the newly added box. In the end, the SSL Proxying Settings window should look like this:
Close that window, go to Proxy > Proxy Settings and tweak it exactly like this image:
Navigate to the Windows tab and tick all checkboxes:
Close that window, and go to Help > Local IP Addresses. It will look something like this:
Your local IP address will most likely be the first item in the list (in this case, since I am using Ethernet connection, it will be the first one.) Copy that IP address or memorize it.
About local IP addresses
This is your local IP address, meaning it can only be accessed by devices that are connected to the same network.
You may now close that window and press CTRL + ALT + M or Tools > Map Remote..., tick Enable Map Remote and press Add. Tweak it like this:
In the Map To section, the Host textbox needs to be your local IP address that you got from above, and the Port textbox is a 4 digit number that your server will be running on. Pick any numbers you want except for ports like 8888 or 8889 and memorize it along with your local IP address. Press OK. The map remote interface should look like this in the end:
You may now close that window. At this point, the proxy is now ready.
"},{"location":"private-server.html#server-software","title":"Server software","text":"The server software directory will look like this:
Copy the config.example.py file into a file named config.py and open it with your favorite text editor.
Most of the config properties should already be self-explanatory. Below is guide for a few important parts.
Remember that local IP address and port that you memorized not long ago? Well enter it here:
HOST is your local IP address and PORT is the port you have choosen earlier.
For GAME_API_PREFIX, this will differ depending on your Arcaea version. Refer to the table below.
Version Prefix 5.5.6 -> 5.6.1/hanami/29 For ALLOW_APPVERSION, remove everything inside. You may add a version to the list (e.g. `5.6.1) if you want to restrict the server to (a) specific server.
For this part:
If you want to use link play functionality, the only variables you need to care about are LINKPLAY_HOST and LINKPLAY_AUTHENTICATION.
LINKPLAY_HOST needs to be the same as the IP address you have set in the HOST variable earlier unless the SET_LINKPLAY_SERVER_AS_SUB_PROCESS variable is set to False, at which you will need to specify a separate IP address for the link play server.
For LINKPLAY_AUTHENTICATION, you can leave it as-is or type in anything you want.
If you do not want to use link play functionality, the LINKPLAY_HOST variable needs to be an empty string.
For SSL_CERT and SSL_KEY, if you want to have the server running under HTTPS, you may supply an SSL certificate here if you have one (.pem and .key file).
Warning
Running the server under HTTPS may cause issues with downloading packs/songs.
Adjust the rest of the config file to your own likings. Save the file after finished.
Now go to the database folder and it will look like this:
Run the database_initialize.py file to generate the database. Make sure you have installed all dependencies prior to running it in order for it to work. A file named arcaea_database.db will be created if successful. After that, do all of these:
bundle folder. The actual bundle must have the .cb extension and the meta file must have the .json extension. Both must have the same filename (e.g. 5.6.0).Note
The content bundle in the server must be the same as the one existing in your Arcaea client (the metadata and content MUST match) as otherwise you will encounter issues when trying to login. If you change the content bundle in the server, the one on the client should be redownloaded.
To avoid issues, use the content bundle that you have obtained earlier.
Put any songs you have into the songs folder. A song is a folder containing multiple .aff files (every difficulties of the song), base.jpg files (the jacket art), the song itself, the PV video for Terminal songs, and any additional files for that song.
Make any adjustments you want to make.
At this point, the server software is now ready.
"},{"location":"private-server.html#on-device-setup","title":"On device setup","text":"Note
Your phone and your computer (the one that runs the server) MUST be connected to the same network for the server to work.
iOSAndroidOpen the Settings app, go to Wi-Fi settings, press the ! icon on the connected network, scroll down until you found the HTTP Proxy settings. In the Configure Proxy settings, select Manual and fill in the Server field which is your local IP address and the Port field which is 8888. Now press Save and (optionally) turn off and reconnect to your Wi-Fi network.
Now on your computer, return to Charles and go to Help > SSL Proxying > Install Charles Root Certificate on a Mobile Device or Remote Browser. A window like this will show up:
Follow the steps listed in it to install the Charles certificate onto your device. You will also need to go to Settings > General > About > Certificate Trust Settings and enable full trust for the newly added certificate for it to take affect.
Warning
From limited testing, Android is finicky when it comes to maintaining connection to proxy server. Things may not work correctly or even at all. If you have a way to fix this, feel free to contribute!
Go back to Charles and go to Help > SSL Proxying > Save Charles Root Certificate... Save the .pem file somewhere. Rename the .pem extension to .crt. Now transfer this file to your Android device and install it to both categories.
On Android, you will need to rely on a proxifier app such as VProxid or RProxid (requires root, recommended). You need to connect through the SOCKS5 proxy server.
After installing either of the proxifier app, open it and press the + icon, for Server IP, enter your local IP address; for Server Port, enter 8889. Scroll down a little bit and press Click to select application(s) then tick Arcaea. Now return and press the play button to start the VPN. Wait until it shows all good.
Now your device is ready to connect to the private server!
Note
Disable the proxy when you have finished playing to prevent connectivity issues. The proxy will need to be re-enabled everytime you want to use the server. A dedicated 24/7 server such as a Raspberry Pi, a spare phone/computer with working shell, or a cloud server (VPS) is recommended for always-on server hosting.
"},{"location":"private-server.html#playing","title":"Playing","text":"Return to the root directory of your server and run the run.bat file. It may take a while to start depending on the amount of songs you added. If the server console shows this:
Congratulations! Your server is now up and running! Now all that left is open Arcaea and play!
If you see something like this, it means the server is working as intended.
At this point, you are basically done! Enjoy your new server!
"},{"location":"private-server.html#fixes-for-notable-issues","title":"Fixes for notable issues","text":"The game kept prompting to update a pack despite having already downloaded it.
-> Check the song folders to see if they are named correctly and that all files (plus PV videos and audios if exists) are inside.
Cannot download any songs.
-> Make sure the server is running under HTTP connection. For iOS, you may need to edit the Info.plist file using a plist editor to allow HTTP connection without a jailbreak by setting NSAllowsArbitraryLoads property to true.
Nothing works, even logging in.
-> Check if the GAME_API_PREFIX variable in the config.py file is set correctly. If that did not work, make sure you have set up the proxy correctly (refer to the Proxy setup and On device proxy setup section.)