Okku 3DS

Okku
General
Author	Team Papafox
Type	Hack Utilities
Version	1.0.4
License	Mixed
Last Updated	2020/09/20
Links
1.0.4 & Guide Download
Website

Okku is a public TJA to FUMAN converter, which allows you to import TJA files to taiko 3DS, and possibly other games.

Features

• Handle DELAY commands.
• Handle SCROLL commands.
• Handle BPMCHANGE commands.
• Handle MEASURE commands.
• Automatically reencode songs to NAAC format.
• Convert TJA to FUMEN.

User guide

How to use

This process works by replacing existing songs in the game (not by adding them as DLC). As this is done via LayeredFS, the replacement can be removed at any time. Note that song names displayed in the game are not handled by this converter, since they are images.

Usage instruction can be found in the PDF guide. Below tutorial is based on this guide by lily.

Prerequisites:

• A modded 3DS running a modern CFW environment (Luma3DS 7.0+ with LayeredFS support).
• A digital or cartridge copy of Taiko 3DS3 (Taiko no Tatsujin: Dokodon! Mystery Adventure).
• The TJA file that you would like to convert.
• A computer or virtual machine running a modern version of Windows (tested on Windows 10 and 11).

Extract and convert TJA files:

• Make sure you extract your TJA files with a computer set to Japanese locale, or else mojibake will be generated in its places.
• Okku requires that TJA files be encoded as UTF-8.
  • You can do this in bulk with a tool like KanjiTranslator.
  • Or you can manually re-encode the file with Notepad (click Save as, change Save as type to UTF-8, then save).
• After that, open Okku_converter.exe:
  • If Okku fails to launch, you may not have the VC Redistributable pack installed.
  • Double-click on the VC_redist.x86.exe file in the same directory and follow its installation instructions, then try again.
• Select the TJA file you want to convert:
  • Okku will display the song name, its subtitle, and its list of difficulties.
  • Verify that the information corresponds with the TJA you are trying to convert.
  • Then select the difficulty that you want converted.
• Okku will show a few boxes, then output Done! once it has succeded.
• At this point, Okku can be closed and the converted files will be in the same directory as the original TJA and audio file.

Converting multiple difficulties:

• If you're converting multiple difficulties for one song, keep in mind that Okku will constantly overwrite the last converted file.
• Therefore, you should move the generated files elsewhere between each convert (ideally in a seperate folder so you don't mix them up).
• Also there is no need to convert audio multiple times. Okku will warn you for further charts that the audio is missing, accept the warning and it'll convert the chart quickly as there is no audio to convert.

Song replacement - Song files:

• Open 3ds_Folder_structure.7z and extract its contents to the root of your SD card.
• Navigate to SD:/luma/titles/0004000000190E00/romfs/_data/sound/song/.
• This is the hard part - Rename your converted NAAC file to the name of an actual, existing song and place them into the song folder. The smaller file (!!audio_s.naac) is the song sample that plays in the song select screen, while the larger file (!!audio.naac) is the full song.
  • For a list of base song IDs in Taiko 3DS3, see base song ID section.
  • For a list of song IDs by where they show up on the song select screen, see song ID order section.
  • For other cases, see the song ID list on wikihouse.
  • Using ハッピーシンセサイザ (Happy Synthesizer) as example, whose song ID is hapsyn.
  • So you will be renaming the converted NAAC files to hapsyn_3ds.naac and hapsyn_3ds_s.naac.
  • (Note: There are a number of songs require you to add _remst or _remst2 to the file name. For example, ymyrp2_remst.naac).

Song replacement - Fumen chart files:

• Navigate to SD:luma/titles/0004000000190E00/romfs/_data/fumen/<song ID of the song that you replaced>/solo/.
• Rename your fumen file (!!fumen_.bin) to <SONG ID>_<e/n/h/m>.bin, and place it into the solo folder.
  • e = easy (かんたん)
  • n = normal (ふつう)
  • h = hard (むずかしい)
  • m = master (おに)
  • if applicable, ex = extra (裏)
  • _remst/_remst2 logic does not apply for these file names (e.g. the master chart fumen for ymyrp2 would still be ymyrp2_m.bin).
• Take out your SD card and put it into your 3DS.

Your song replacement should now appear for the song that you have replaced.

Remember to enable game patching in the Luma3DS configuration menu (hold Select on boot) so that LayeredFS can apply.

Taiko 3DS3 base song ID

Taiko 3DS3 song ID order

Song indicators:

• REMST indicates that you must append _remst to the audio file name (for example, himyak_remst.naac).
• REMST2 indicates that you must append _remst2 to the audio file name (for example, lost1g_remst2.naac).
• [URA] indicates that the song has an Ura (extra) chart, so you may want to reserve it for any of your charts that have an Ura.
• [LOCK] indicates that the song is locked by default, so you may not want to use it unless you have a completed save file.

J-POP	Vocaloid	Variety
1. nedari 2. kimuso 3. geswat 4. kekka2 5. himyak REMST 6. dora36 7. koiama REMST 8. xjapa2 REMST [URA]	1. gumis2 [URA] 2. hapsyn 3. lost1g REMST2 4. rlngig REMST [URA] 5. iachil REMST	1. nameko 2. honnou REMST 3. th7171 BRANCH 4. thchil [URA] 5. thmhrb
Namco Original	Game Music	Classical
1. 3d3op 2. hoslin 3. dietft 4. w3at1x 5. alexan REMST2 6. ymyrp2 REMST 7. exgoth [URA] 8. siuryu [URA] 9. gunsln 10. adk 11. shoto9 12. yamata 13. 83noma REMST 14. mahojn 15. fltlnd [LOCK] 16. kagu27 [LOCK] 17. sora3x REMST [LOCK] 18. sora6x [LOCK] 19. akanos 20. souryu [URA] 21. hvride [LOCK] 22. rot4 [LOCK] 23. 3d3hex 24. 3d3b1x [LOCK] 25. 3d3b2x [LOCK]	1. kirby 2. monhnx 3. gyak31 4. makaim 5. sphang 6. dariub 7. wblade 8. wangan 9. syclsn 10. mscl4 REMST 11. drsb REMST2 12. Soul Calibur III ??? [LOCK] 13. imedrv 14. namcot REMST [LOCK]	1. clsdnu REMST [URA] 2. clsw REMST2 3. valk REMST 4. clsmrs REMST 5. clsbut REMST2 6. clstic

Limitations

• It cannot parse TJA files with branching data.
• It cannot replicate NAMCO's scoring algorithm.
• It cannot handle TJA specific scrolling commands(like BM/HBSCROLL) due to FUMEN limitations.
• Does not display the song title in-game. A song can be recognized in song select using song preview or by recalling which song you replaced.
• Balloons will be shorter than expected if they happen to end at a different bar than they started from (fumen engine limitation).

Screenshots

Known issues

• Fumen with 300 bars or more will crash.
• Fumen with more than 13000 notes may crash.
• If the converter fails to parse a song file, try changing the name of the song file and changing WAVE in the tja to the song file.

External links

• Official website - https://www.teampapafox.org/projects/okku3ds.html
• Reddit - https://www.reddit.com/r/3dshacks/comments/ivy95a/release_import_custom_tjas_to_taiko_3ds_and
• Reddit - https://www.reddit.com/r/taikonotatsujin/comments/ivwjtq/release_import_custom_tjas_to_taiko_3ds_and