Bully-Board

Bully Modding Section => Bully Modding => TUTORIALS => Topic started by: Shotgun on April 03, 2012, 04:41:54 AM

Title: [PC][Tutorial] Editing language files with ease!
Post by: Shotgun on April 03, 2012, 04:41:54 AM
Hey there guys!
As the title suggests, this tutorial will contain information regarding the editing of language files in Bully: Scholarship Edition’s PC version.
As you may know, the game uses similar extension to GTA, to store numerous files in one, rather than having folders with thousands of different files. The same method goes for the game’s text files, which can be found in C:\Program Files\Rockstar Games\Bully: Scholarship Edition\config\text\*.img. The * is the name of the .img file you’d like to edit, as there are eight different languages installed with the stock game.
Now, the editing of the .IMG files is a piece of cake, but when doing this, you are going to see that the language files in the archives are actually .bin files, which cannot be edited with anything yet, but a program I’ve got from one of my friends.
So what you’ll need to edit language files? Here’s a short list.

-   The IMG decompiler which decodes the .bin files. (http://data.hu/get/4935145/Bullydecompiler.zip)
-   A proper text editor.

After making sure you have the tools to edit the text files, here’s a step-by-step tutorial on how to use the decompiler:

1.   Step

Select the .img and .dir of the language you’d like to edit, then drag it on top of the decompiler. After you have done that, there will be a new folder, which will have the same name as the .img you’ve chosen to edit.

2.   Step

Go to the newly created folder. The files from the archive will be there, but with a .txt extension, which can be edited in notepad, or notepad++, or any other text editing utilities. Don’t edit the numbers on the left, only the text on the right.

3.   Step

After you are done editing the files, go back to the folder where the decompiler is, then drag the folder of your language (like American) on top of the bullydecompiler.exe. If that’s done, you’ll get two files with the name of the language you’ve edited, with a .gv extension.
Rename those files so they’ll only have the .img extension.

4.   Step

We are almost done. The next thing you’d have to do is open up notepad++ and open the newly created .img file, and then use the replace function. In the “Find what” textbox, paste “yy” (without the “) and replace it with “˙˙” (again, without the “).
Click on replace all, and when it’s done, save the file.

5.   Step

Put both the .img and .dir files back to the games config/text folder, replacing the original ones, and voila, you are done!

If pictures are needed for better understanding of this tutorial, just post in here and say it. :)
Title: Re: [PC][Tutorial] Editing language files with ease!
Post by: Evolution on April 03, 2012, 06:43:30 AM
Nice tutorial mate, I think some members will be thankful cause of this tut.

Keep it up!  ;)
Title: Re: [PC][Tutorial] Editing language files with ease!
Post by: MadmaN on April 04, 2012, 02:07:04 PM
Very good tutorial m8.

I will add this tutorial with screenshots of my own to the Bully Modding Bible when I get to that chapter if it is ok with you m8.
Title: Re: [PC][Tutorial] Editing language files with ease!
Post by: Al Arlington on April 04, 2012, 06:25:58 PM
I reckon this should be pinned.

This'll be useful for people with wide imagination, who want to rename characters like bullymodder123, it'll come in handy for his Future mod.
Title: Re: [PC][Tutorial] Editing language files with ease!
Post by: Shotgun on April 05, 2012, 12:50:51 PM
Very good tutorial m8.

I will add this tutorial with screenshots of my own to the Bully Modding Bible when I get to that chapter if it is ok with you m8.

Thanks mate!

I'd be happy if you'd include this in your Bully Modding Bible, as I really like it so far. :) Good luck with that.

About renaming characters: Yep, that's not hard at all. Although my main goal was to help modders translate the game to their own language. Might aswell extend this with a tutorial for editing the characters sets of the game, since not every language has the same character sets. :)
Title: Re: [PC][Tutorial] Editing language files with ease!
Post by: bluboks on August 19, 2012, 03:41:48 AM
Would you mind if I asked you if it is your friend who made the decompiler? I am currently making Korean localization patch for Bully, and I intend to do that by modifying Japanese files.

Thus I'm in need of much proper and easier way to edit language files. I thought that your post would be very helpful, but unfortunately the decompiler seems not to support UTF-8 encoding at all. Unpacking doesn't work properly but that's not a problem, for I can use other the western language files such as Spanish or German instead. It is repacking. Every time I try to rebuild .img file with texts encoded in UTF-8(Bully uses that for Unicode support), the program stands still and the memory usage suddenly soars up to 3GB. seems it falls into some kinda infinite loop.

Currently I've been using hex editor since I found the decomplier doesn't work, but it's a really painful and cumbersome way to handle all the text files(there are 256 text files inside the each of language files.)

It would be much appreciated if you ask him/her whether he could do me a favor and fix the problem, if your friend is the one who made the program. Or it would be also welcome if he or she can just show me the details for the file structure of Language files.

And please excuse my bad English. I hope it wouldn't disturb you reading this post.
Title: Re: [PC][Tutorial] Editing language files with ease!
Post by: SWEGTA on August 19, 2012, 06:04:06 AM
Great tutorial!
Title: Re: [PC][Tutorial] Editing language files with ease!
Post by: leodeepak26 on May 20, 2016, 05:49:06 AM
I did what you mentioned but a new folder is not created,instead the decompiler closes what to do?
Title: Re: [PC][Tutorial] Editing language files with ease!
Post by: fastman92 on June 01, 2016, 07:35:40 PM
I have my own CGameText class made in C++ that works with the following formats :
GTA 2
GTA III
GTA SA
GTA IV
Bully SE

My code fully allows to take control of game text, multi-byte charmap supported.
Title: Re: [PC][Tutorial] Editing language files with ease!
Post by: 57 PixeLz on June 17, 2016, 11:25:27 AM
I didn't get the post.
Will this make my bully in any language I want for example French . From English to French?
Title: Re: [PC][Tutorial] Editing language files with ease!
Post by: fastman92 on June 17, 2016, 04:04:00 PM
You still have no translate the language, because no one will do that for you.
Follow my productions at http://fastman92.ml
Title: Re: [PC][Tutorial] Editing language files with ease!
Post by: 57 PixeLz on June 20, 2016, 08:58:15 AM
You still have no translate the language, because no one will do that for you.
Follow my productions at http://fastman92.ml
i don't get you ? pls little more explanation
Title: Re: [PC][Tutorial] Editing language files with ease!
Post by: RBS ID on October 10, 2021, 11:51:02 AM
Hey there guys!
As the title suggests, this tutorial will contain information regarding the editing of language files in Bully: Scholarship Edition’s PC version.
As you may know, the game uses similar extension to GTA, to store numerous files in one, rather than having folders with thousands of different files. The same method goes for the game’s text files, which can be found in C:\Program Files\Rockstar Games\Bully: Scholarship Edition\config\text\*.img. The * is the name of the .img file you’d like to edit, as there are eight different languages installed with the stock game.
Now, the editing of the .IMG files is a piece of cake, but when doing this, you are going to see that the language files in the archives are actually .bin files, which cannot be edited with anything yet, but a program I’ve got from one of my friends.
So what you’ll need to edit language files? Here’s a short list.

-   The IMG decompiler which decodes the .bin files. (http://data.hu/get/4935145/Bullydecompiler.zip)
-   A proper text editor.

After making sure you have the tools to edit the text files, here’s a step-by-step tutorial on how to use the decompiler:

1.   Step

Select the .img and .dir of the language you’d like to edit, then drag it on top of the decompiler. After you have done that, there will be a new folder, which will have the same name as the .img you’ve chosen to edit.

2.   Step

Go to the newly created folder. The files from the archive will be there, but with a .txt extension, which can be edited in notepad, or notepad++, or any other text editing utilities. Don’t edit the numbers on the left, only the text on the right.

3.   Step

After you are done editing the files, go back to the folder where the decompiler is, then drag the folder of your language (like American) on top of the bullydecompiler.exe. If that’s done, you’ll get two files with the name of the language you’ve edited, with a .gv extension.
Rename those files so they’ll only have the .img extension.

4.   Step

We are almost done. The next thing you’d have to do is open up notepad++ and open the newly created .img file, and then use the replace function. In the “Find what” textbox, paste “yy” (without the “) and replace it with “˙˙” (again, without the “).
Click on replace all, and when it’s done, save the file.

5.   Step

Put both the .img and .dir files back to the games config/text folder, replacing the original ones, and voila, you are done!

If pictures are needed for better understanding of this tutorial, just post in here and say it. :)

Can someone share the img decompiler link? The file in that link is unavailable.
Title: Re: [PC][Tutorial] Editing language files with ease!
Post by: SimonBestia on October 10, 2021, 03:36:08 PM
I still happen to have it.
https://www.mediafire.com/file/56jkp5lq8x0duhb/Bullydecompiler.zip/file
Title: Re: [PC][Tutorial] Editing language files with ease!
Post by: RBS ID on October 18, 2021, 01:32:25 AM
I still happen to have it.
https://www.mediafire.com/file/56jkp5lq8x0duhb/Bullydecompiler.zip/file
Thank you so much, SimonBestia. :D
Title: Re: [PC][Tutorial] Editing language files with ease!
Post by: TEMPE95 on January 24, 2023, 05:46:26 PM
Good evening guys, I thank everyone for the tutorial, especially Shotgun and Simonbestia, your tutorial has been helpful, but I lost several hours because despite your guide the game does not change the language absolutely, so in case someone has the same one problem can do as follows:
1. Unload Simonbestia's decominator above and the program to rename the 256 files quickly from here https://www.bulkrenameutility.co.uk/download.php.
2. I enter the Config/Text game folder, I copy Simonbestia's decomposeer and extract it.
3. I move the two files of the language (in my case it is the Italian language so I will make the example with this) above the program, then I drag the Italian.dir and Italian.img files above the Simonbestia program.
4. A new folder will be created called Italian (name of the language you have chosen) inside there will be 256 files to rename with bin.bin extension.
5. I open the Bulk Rename program downloaded first, select all the files to be renamed, below in box 11 of the program I enter .bin and click on Rename.
6. Renamed the files, I take the Italian folder created before and move it again on the decomposeer of Simonbestia, where two new files will be created. Italian.dir.gv and Italian.IMG.GV.
7. Card all the files inside the Text folder and I leave only the last ones just created.
8. Rename the files in American (which is the only language that apparently likes the game). So from Italian.dir.gv/Italian.img.gv Rename in
American.img and American.dir. END
P.S. Sorry if there are language errors but I created this guide using a translator, thanks again to everyone  :D :D :D