Hacking [WIP] Mahouka Koukou no Retousei: Out of Order - English Translation [Out-of-English]

master801 · Apr 27, 2019

English translation project for the PS Vita game Mahouka Koukou no Retousei: Out of Order

Update:

Text can now be injected during runtime on physical copies of the game using the kuio plugin. Although it takes a long time for the game to start up now due to how kuio works, text injection is finally the last hurdle of this project.

The last issue to tackle now, is for the game to actually be translated into English.

Sub-Projects:

OoE-Plugin
- Description: A plugin to replace the Japanese text in the game's eboot.bin file. (This should technically support other games as well, although with a couple of tweaks.)
- Link: https://github.com/master801/OoE-Plugin
- State: Experimental

Out-of-Bin:
- Description: Parses json to bin for text embedded inside the game's eboot.bin file.
- Link: https://github.com/master801/Out-of-Bin
- State: Complete

Out-of-Py:
- Description: Contains scripts to convert binary files containing Japanese text to .json files. - Makes translating binary files streamlined and clean. No need to mess with files in a hex editor anymore.
- Link: https://github.com/master801/Out-of-Py
- State: Complete

Out-of-Translation:
- Description: Contains .json files that were deconstructed from binary files.
- Link: https://github.com/master801/Out-of-Translation
- State: Incomplete

Out-of-Textures:
- Description: Script to make converting .dds/.tga texture files into .dds.phyre files streamlined and clean. No need to mess with files in a hex editor anymore.
- Link: https://github.com/master801/Out-of-Textures
- State: Complete

Credits:

Neoaga - For translating some Japanese text into English in the project's immature state.
xyz - For giving me help and pointers when I was creating OoE-Plugin
Rinnegatamante
Davee

Want to help? Send me a message.

froid_san · Apr 28, 2019

that OoE-Plugin is quite interesting, can't wait to try it on other games

master801 · Apr 28, 2019

froid_san said:
that OoE-Plugin is quite interesting, can't wait to try it on other games

Yes, but the plugin only works for Vitamin dumps currently, since I guess that user modules cannot be loaded while NoNpDrm is present. Or at least that's what happened when I tried using the plugin on the NoNpDrm dump.

I poked around and eventually found this repo https://github.com/hz86/mask_of_truth stating that sadly, NoNpDrm cannot be modified.

Support for Vitamin dumps is complete and is pushed to the repo. Support for NoNpDrm is currently being worked on.

froid_san · Apr 29, 2019

Not really a dev here but didn't we already have a way to do NoNpDrm modification of eboot/modules/asset via repatch plugin? though you still need to hex edit the eboot, but maybe you can use the decrypted eboot on the repatch folder to do memory editing of the eboot?

[edit]
wait... I was wrong just remembered NoNpDrm eboot usually have dynamic memory address right?

master801 · Apr 29, 2019

froid_san said:
Not really a dev here but didn't we already have a way to do NoNpDrm modification of eboot/modules/asset via repatch plugin? though you still need to hex edit the eboot, but maybe you can use the decrypted eboot on the repatch folder to do memory editing of the eboot?

[edit]
wait... I was wrong just remembered NoNpDrm eboot usually have dynamic memory address right?

It seems that NoNpDrm does not allow for modules to be loaded, even if the eboot.bin file is decrypted using FAGDec and put it in the rePatch directory. You still end up at square-one with modules not being properly loaded.

The suggested way (from here) is to decrypt the eboot.bin, patch it and put it in rePatch's directory.

master801 · Aug 21, 2019

Thanks to some help by Davee, I've managed to solve the issue with text not being injected on encrypted versions (physical copies).

Turns out, encrypted games do not have permissions to read/write from any other storage device (ex: ux0) if they have not already been given permission and plugins use the same permissions as the parent process (the encrypted game). To sum it up, encrypted games do not have permissions to read/write from/to ux0, our target storage device. So, to work around this issue, Davee recommended I use the kuio plugin or something of that nature which bypasses the game's limited permissions.

Due to how kuio works, there is a large overhead when reading/writing files. Currently with 98% eboot text translated to english, the game takes almost 5 minutes to boot up. There are of course other ways to work around this (use an unencrypted version of the game and avoid kuio's overhead entirely), but that would mean limiting it only for that specific platform, which I don't plan on supporting.

froid_san · Aug 21, 2019

Correct me on this one, I think ioplus by dots-tb fuction similarly to kuio since I've seen dev post bout advising the dev of forcelang plugin to use ioplus instead of kuio since i believe it has better fuctionality and more recent.

you may also want to look into that.

master801 · Oct 6, 2019

The plugin and tools are now finished.

I consider the project complete and at an entire standstill until the game's text is translated into English.

raxioncelestial · May 6, 2020

Where i can find the plugins sir? i already check the realease at your git

master801 · May 6, 2020

raxioncelestial said:
Where i can find the plugins sir? i already check the realease at your git

I've published the releases.

https://github.com/master801/OoE-Plugin/releases/tag/Alpha-1
https://github.com/master801/Out-of-Bin/releases/tag/Alpha-1

Remember to use either the official game that comes on a cartridge or NoNpDrm and the most updated version of the game.

Using the vpk or mai versions of the game will not work due to how games are loaded and since both loaders modify the eboot.

raxioncelestial · May 8, 2020

thanks sir

master801 · Jan 20, 2021

If any translators want to help, please join the Discord server.

https://discord.gg/Trf6ZTqRj8

Yukugurl357 · Mar 11, 2022

HI ppl im confused on this topic. Do these plugins work on other games or just this Mahouka Koukou no Rettousei
i read in the comments that it only works on vitamin then i read that it works or does not work on nonpdrm. Which type should i install?

master801 · Mar 11, 2022

Yukugurl357 said:
HI ppl im confused on this topic. Do these plugins work on other games or just this Mahouka Koukou no Rettousei
i read in the comments that it only works on vitamin then i read that it works or does not work on nonpdrm. Which type should i install?

Should work with other games, but I can't guarantee it'll work at all, or even well enough.

I haven't test it with vitamin yet, but it should be compatible, since the plugin works with nonpdrm.

The plugin is experimental, it has issues I'm aware of, use it at your own risk.

Yukugurl357 · Mar 11, 2022

ok so when will it be released as stable? how would i install it with nonpdrm?

master801 · Mar 11, 2022

Yukugurl357 said:
ok so when will it be released as stable? how would i install it with nonpdrm?

No idea when.

https://github.com/master801/OoE-Plugin#how-to-install

Yukugurl357 · Mar 11, 2022

for the directions do i add the plugin to ux0 or ur0? i dont have urx0. then do i edit the config.txt in ur0 or ux0?

master801 · Mar 11, 2022

Yukugurl357 said:
for the directions do i add the plugin to ux0 or ur0? i dont have urx0. then do i edit the config.txt in ur0 or ux0?

Plugin only works on ux0

Yukugurl357 · Mar 11, 2022

master801 said:
Plugin only works on ux0

oh ok so i put 0oE-plugin in ux0:tai? but i dont have anything in that folder do i put the 0oE-plugin in that folder create config.txt
Add lines:
*PCSG00456
uX0:data/OoE-Plugin.suprx
How about the kuio.skprx? does this plugin only work in ux0 too?
The directions say to put in ur0 and edit the config.txt there
sorry I really want to get the best out of this to see if it will work.
Can I to test it out?
btw i love what you have done already.

Neoaga · May 25, 2023

master801 said:
If any translators want to help, please join the Discord server.

https://discord.gg/Trf6ZTqRj8

Can i have the link again? It's expired

Hacking [WIP] Mahouka Koukou no Retousei: Out of Order - English Translation [Out-of-English]

Well-Known Member

Well-Known Member

Well-Known Member

Well-Known Member

Well-Known Member

Well-Known Member

Well-Known Member

Well-Known Member

New Member

Well-Known Member

New Member

Well-Known Member

Active Member

Well-Known Member

Active Member

Well-Known Member

Active Member

Well-Known Member

Active Member

Member

Similar threads

Popular threads in this forum