Romhacking.net

Romhacking => Personal Projects => Topic started by: Grungi on April 29, 2020, 08:39:46 am

Title: Jungle Wars (GB) - English Translation - v0.2.0
Post by: Grungi on April 29, 2020, 08:39:46 am
LATEST RELEASE : 0.2.0 - Sasuke joins the party! (https://github.com/grungi-ankhfire/gbromhack/releases/tag/0.2.0)


If you find an issue, or have remarks, please comment on this thread, or open an issue on GitHub (https://github.com/grungi-ankhfire/gbromhack/issues/new)!

Previous releases (https://github.com/grungi-ankhfire/gbromhack/releases/)



Hi all!

Long time lurker, first real post (outside of asking what was up with another attempt at this game in 2017 ^^; )

I have been working on and off on understanding the GameBoy RPG Jungle Wars, with the aim of finally being able to translate this game. It was one of my very first JRPGs, and beating it without understanding a word was quite the challenge at the time.

I figured a thread was in order, as I know KingMike had plans to translate the game (at the time when I asked), and so thought that posting updates could be interesting! I am not trying to step on anyone's toes, I just really want this one game translated. Also, I am not a native English speaker, nor am I good in Japanese, so for now my bar is set at "understandable meaning", but I will be looking at editing the script and polishing the translation down the line.

Anyway, on to the status of the project:

Here are some gifs and screens of the project at time of writing (courtesy of PyBoy (https://github.com/Baekalfen/PyBoy)):

(https://i.imgur.com/D3BOsEE.gif)                    (https://i.imgur.com/KqDYoUO.gif)                    (https://i.imgur.com/z4CbsOa.gif)                    (https://i.imgur.com/NjGDqPg.gif)
(https://i.imgur.com/PZ8xSy1.png)  (https://i.imgur.com/VTKGJa8.png)


My plan as far as next steps are:

Cannot wait to make progress on this!
Title: Re: Jungle Wars (GB) - English Translation
Post by: ArkthePieKing on April 29, 2020, 05:38:23 pm
I totally mean this as a compliment, there's no way you're not a native English speaker. Your English is *excellent*. Also this game looks cute and I look forward to a translation! Best of luck!
Title: Re: Jungle Wars (GB) - English Translation
Post by: Grungi on April 30, 2020, 06:14:43 am
Thank you so much, that means a lot! ^^
Title: Re: Jungle Wars (GB) - English Translation
Post by: Pennywise on April 30, 2020, 03:51:01 pm
Looks good, keep it up.

One of the issues you've probably run into is space restrictions in the menus. You'll probably want to expand those menus as necessary and rework everything.

(http://www.romhacking.net/translations/gameboy/images/3365screenshot2.png)

That's how I handled text with speaker names, which I think worked out well.
Title: Re: Jungle Wars (GB) - English Translation
Post by: Grungi on April 30, 2020, 05:34:18 pm
@Pennywise : Thanks for the encouragement! It is true that menus are by far the most complex part, I am still working on understanding the code behind them, and actually your screenshot gave me an idea to maybe help with some of the space issues: there is indeed a blank row of tile between each text (for aesthetic reasons, and apparently that is where they add the diacritic marks, I suppose it must have been pretty common in Japanese games).

So as you did with the speaker name, I might be able to fit item or enemy names on two lines... Thanks for the heads-up in any case!
Title: Re: Jungle Wars (GB) - English Translation
Post by: PurpleFrog on May 01, 2020, 08:37:31 pm
Just wanted to chime in and say best of luck! It's always nice to see gameboy games being translated nowadays :)
Title: Re: Jungle Wars (GB) - English Translation
Post by: Grungi on May 03, 2020, 04:44:58 am
Thanks a lot PurpleFrog! :)

And small status update:

I have been working on the menu system, reading the code and seeing how windows are loaded. I succeeded in repointing windows in a crude way, but it is not yet sufficient to properly rework the systems to accommodate longer names and such. But it is progress, and hopefully I am one or two breakthroughs away from figuring this out.

In the meantime, script translation has been progressing, as I also got some help from a fellow forum member. So that is good too :)

I will post some additional screenshots once I can get a cool shot of a remodeled menu or something!
Title: Re: Jungle Wars (GB) - English Translation
Post by: cccmar on May 03, 2020, 08:58:24 am
If you end up needing testers or additional script editing, I'd love to help. Actually, you kinda beat me and someone else to this project, since we were planning to potentially translate Jungle Wars after some other pending projects - but now that you're on it, I guess I can mostly offer that kind of help/support. :laugh:
Title: Re: Jungle Wars (GB) - English Translation
Post by: Grungi on May 03, 2020, 10:19:41 am
@ccmar This is great to read! And sorry for beating you to the punch then ^^;

I will definitely want/need/greatly appreciate any and all help with this. While I am realizing that the technical aspect might be hard to share (I am writing a lot of relatively niche Python scripts...), I am trying to document a lot of what I am finding about the game, and I would happily share that, in addition to help on the script itself.

As I said in the original post, I am making sure at least a couple of things are fixed before I make it easy to share what I already have in a more user-friendly form, so if you have any pointers on how to do that in a way that is easy and relatively standard (do people usually just post an IPS/other patch? Something else?), I am also listening. :D
Title: Re: Jungle Wars (GB) - English Translation
Post by: cccmar on May 03, 2020, 11:22:49 am
Yup, usually it's an IPS/BPS (look up the "beat" patcher) patch for games from that general era, though of course it depends on the system. I'd also come up with a readme file to document some of the more interesting aspects of the translation/hacking process for sure, but it seems that you've got that covered. Not everyone reads those, but I personally like doing that. It's always interesting to see what trials and tribulations the author/s had to go through to get the game out. :D Either way, good luck to you, and if you end up needing help with what I'd mentioned I should be around here somewhere. :thumbsup:
Title: Re: Jungle Wars (GB) - English Translation
Post by: Grungi on May 05, 2020, 04:49:06 pm
Some good news!

The script is progressing at a very good pace, and in the meantime, as I had said I am working to understand the game's UI system.

And on that front, after a breakthrough today, here are two comparison shots between the first attempt at translating some of the UI and the most recent changes. On the surface, not much difference, buuuut...

(https://i.imgur.com/ptEbA9r.png)(https://i.imgur.com/23qluOh.png)

(https://i.imgur.com/mGolueF.png)(https://i.imgur.com/KxrxJQu.png)

So now, the size of the boxes can be changed, it takes only a few guesses to adapt the choice cursor's position, and more text can be added to the boxes. This is all really nice to see, and only two things remain to be done, as far as I can see (aka, before some weird issue shows up):


Even if the second issue subsist, once the main interfaces have been adapted to fit English text better, it will probably be a good time to release a first public patch to let people try the beginning of the game. Looking forward to that!
Title: Re: Jungle Wars (GB) - English Translation
Post by: ArkthePieKing on May 05, 2020, 06:48:05 pm
Dang, you're blazing through this! Keep up the good work!
Title: Re: Jungle Wars (GB) - English Translation
Post by: stratoform on May 05, 2020, 06:57:15 pm
Your self-progress is encouraging! With a good project like this one is turning out, there's always someone around to ask for help when it counts. Looking forward to the news. That's satisfying to read itself. ;)
Title: Re: Jungle Wars (GB) - English Translation
Post by: Grungi on May 06, 2020, 08:10:08 am
@ArkthePieKing

Thanks! I do anticipate some tricky edge cases, but hopefully by that point I understand enough to solve them :D

@stratoform

Thank you as well for the kind words! Hopefully this stays entertaining, and I will definitely ask for help if I do get stumped ;)
Title: Re: Jungle Wars (GB) - English Translation
Post by: Mattiac on May 06, 2020, 04:08:06 pm
Great progress, Grungi-san! ^_^ There should be a comma sign after "morning" so it should read "Good morning, Boy!". Will you then translate Jungle Wars 2 for SNES?
Title: Re: Jungle Wars (GB) - English Translation
Post by: Grungi on May 06, 2020, 04:19:15 pm
@Mattiac Thanks! I added the comma, good catch!

As far as JW2 goes, it will be worth at least looking at what could be done, but I am still very new, so while the GameBoy, and more specifically this game are super familiar, SNES hacking would be a totally different beast. So we will see, I do really want to play the second game as well :D
Title: Re: Jungle Wars (GB) - English Translation
Post by: i.m.gibbon on May 06, 2020, 05:25:50 pm
Oh my goodness I own this game! It's one of a handful of RPGs done by the poorly-documented team that made Lufia: Ruins of Lore. They also did a rather interesting SFC RPG titled The Last Battle which I also own and have found basically zero info on online.

Thanks so much for translating this! I'm only just getting into romhacking myself but this was one of the titles I wanted to tackle some day and it warms my heart to see that someone else has heard of this and cares enough to work on it :D
Title: Re: Jungle Wars (GB) - English Translation
Post by: goldenband on May 06, 2020, 09:43:25 pm
Great to see such high-quality work, and always great to see more Game Boy hackers/localizers (I hope you keep working with the system once this is done, since there are so many intriguing games yet to be translated). Kudos!
Title: Re: Jungle Wars (GB) - English Translation
Post by: Grungi on May 07, 2020, 07:54:13 am
@goldenband Thanks a lot! All the encouraging messages in the thread really mean a lot :) As far as continuing on with GameBoy hacking, I am not ruling anything out at this point since I am having a lot of fun. But I also managed to progress on this game based on a lot of years of picking it apart bit by bit, so I am not sure how much transferable knowledge I actually am amassing :D

Anyway, some more updates!

(https://i.imgur.com/Sxxtya0.png)

Since last time, I have still been mainly occupied by the UI modifications. As the game starts with you having to use most of it pretty quickly (the game starts by asking you to use your inventory, and then there is a story battle), it makes it important to get right from the get go.

The issue I mentioned in a previous post with windows not clearing their area of the screen when their dimensions had been changed, is now fixed! I figured that the code somehow checks the original data instead of the re-pointed one at some point, so the current fix is to also update the original location of the window. If someone is interested I can describe a bit more what the current modifications entails, but suffice to say that I just redirect the data reads to empty banks to have more room, and do not try to reuse the space of the original data for now.

I also had to trial-and-error my way through a few weird sorting issues (the dialog window would display behind sprites for some reason), but I can manually fix those on a case by case basis, so it is not too bad. Finally, the combat UI is almost usable now, and I need to make a second pass on the text because the game crashes in very specific circumstances. I think it happens when it tries to load some text that is not translated yet, so I will check that out. In the meantime, here are some more shots of the UI, as well as the original menu for comparison (hopefully soon I can switch back to the script for a while ^^).

Thanks everyone for your kind words and interest!

(https://i.imgur.com/fwE5eX0.png) (https://i.imgur.com/Ke2rC8j.png) (https://i.imgur.com/IvqxdF7.png)

May 12, 2020, 05:45:08 pm - (Auto Merged - Double Posts are not allowed before 7 days.)
Small status update :

(https://i.imgur.com/IxnhjBZ.png)

While this does not look much different from the previous batch of shots, this amounted to quite a bit of work. The long-form enemy names are now translatable, and can use the current maximum length of 8 characters thanks to good ol' repointing.

The plan is to check what the longest translation would be before seeing what needs to change on the UI windows front.

The combat system is proving to be the trickiest bit yet, as depending on the context the game seems to load the enemy names differently. During the resolution of combat turns for instance, it seems to pull shorter names from somewhere I still need to find. Hopefully the next two things I know can be tricky (the spell names and the various items) are less spread out...

I will report back soon, I hope with some news about the combat system working perfectly ;)
Title: Re: Jungle Wars (GB) - English Translation
Post by: Grungi on June 01, 2020, 05:55:08 am
Good news!

After being sick (nothing major, at least!) for few days, and having all my time snatched away by work, here is some Progress.

I managed to fix a bunch of outstanding problems, from the hardest to the easiest :


(https://i.imgur.com/aevughM.png)

The combat system has seen some major work, all the messages that can appear in the first "tutorial" fight are translated (including rare occurrences like dodges and critical strikes). A big part of that was locating a table with pointers to all the attack messages. Another was finding a way to extend the names of NPCs that join your party at several points in the story. This turned out to be tricky, but hopefully the method used works, even if it is a bit dirty.

(https://i.imgur.com/88sO0qC.png)

There are wooden signs scattered around the world, and they use a specific text storage : they do not have a termination byte like almost all other data blocks in the game, but instead are three lines always, each prefixed by a byte telling the game how long is the text on said line. Finding that out let me finally translate these signs, which is good!

(https://i.imgur.com/Kzap9nL.png)

I decided to, for a first pass, translate item names in-place, which makes it hard since most items are super short in Japanese, but at least it works for now, before I can properly repoint the data to an empty memory bank...

All that brings us to a point where the first village is "fully translated", which means I feel now is a good time to release a first version of the patch if anyone is curious to try it out! I will also update the main post to put the links there.

Get the 0.1.0 patch on GitHub! (https://github.com/grungi-ankhfire/gbromhack/releases/tag/0.1.0)

Feel free to open an issue on GitHub (https://github.com/grungi-ankhfire/gbromhack/issues) or post in this thread if you spot errors or find that something could be improved!


@i.m.gibbon : Sorry I missed your message earlier, but so glad you are excited by the project :D The Last Battle indeed looks interesting! Always cool to see what other games these developers made!
Title: Re: Jungle Wars (GB) - English Translation - v0.1.0
Post by: midget35 on June 01, 2020, 09:48:09 am
Congratulations on your progress, Grungy!

I am watching this thread very closely. You are a star for making your tools open source :) I can't wait to play a final / release candidate version. WELL DONE, my friend!
Title: Re: Jungle Wars (GB) - English Translation - v0.1.0
Post by: Grungi on June 01, 2020, 10:01:10 am
Thank you :thumbsup:

And glad you enjoy the open-sourcing of the code! Just do not look too closely at how crudely it is cobbled together :p
Title: Re: Jungle Wars (GB) - English Translation - v0.1.0
Post by: midget35 on June 01, 2020, 10:19:58 am
Haha! I love that, but - honestly - keep doing what you're doing :) It is a great gift to this community :)
Title: Re: Jungle Wars (GB) - English Translation - v0.1.0
Post by: aqualung on June 02, 2020, 09:02:00 pm
Hello! I've tested this preliminary version and it looks great! I've yearned to see this game in English for around 30 years now.

I'd like to let everybody know that I'm actually helping Grungi with the translation of this game's texts and dialogs. I didn't want to say anything until I had a fair amount of it already translated and I was sure I was up to the task. Despite my limited knowledge of Japanese (a little below N4, more or less), using the DeepL translator and a Japanese text editor in which I "kanjified" the texts for DeepL to parse them better, Grungi and I have managed to grasp the general meaning of most of the dialogs and translate them. I'm not a native English speaker, but in that regard Grungi (apart from doing all the hacking work, which that alone isn't a menial task) is also helping correct any awkward phrasing I might do from time to time.

From what I've played so far, I've seen one word spelled as "daugther" in the dialog that a npc in the first town says. Also, when talking to the fortune teller, after the first sentence the game tends to hang or crash, I suppose some memory overflow or unhandled exception must occur. Some garbled text have also appeared when I tried to use the pants (not equip, just use them to see which text was shown).

But the result's looking really good! I'm finishing some dialogs from the end of the game, but I think the majority of the city related text has yet to be translated. There's also some pivotal points' dialogs that we'll have in a draft state and will have to review as they contain relevant info of important events in the game. I'm committed to complete this translation, as I've wanted to see this and its sequel games in English for decades. Who could have guessed that I'd take part on it?  ;D ;D

Thanks a lot to Grungi for starting this project and giving me the opportunity to collaborate.
Title: Re: Jungle Wars (GB) - English Translation - v0.1.0
Post by: Grungi on June 07, 2020, 05:04:01 pm
@aqualung : I am the one that should thank you, as the work you are doing helps tremendously!!

So, yeah, here are some exciting (at least for me :D) tidbits since last update :


(https://i.imgur.com/97wep77.png)    (https://i.imgur.com/FYCInzg.png)

And lastly, a quick question for those of you with more experience : do you just backup various emulator save files to help debug games like this? As I know I will have to go back to several spots to polish UI/double-check stuff, do you keep a lot of files around? Or do people usually have another solution for this? (If that helps, I use BGB as my main emulator.) Thanks in advance for any insight anyone might have!

See you soon with more progress!
Title: Re: Jungle Wars (GB) - English Translation - v0.1.0
Post by: ProstatePunch on June 22, 2020, 09:44:20 am
Wow!  Looks awesome.

I'm looking into starting GB Hacking myself.  Do you have any recommendations on where to start?  What tools you used?
Title: Re: Jungle Wars (GB) - English Translation - v0.1.0
Post by: stratoform on June 22, 2020, 10:16:50 am
Quote
And lastly, a quick question for those of you with more experience : do you just backup various emulator save files to help debug games like this? As I know I will have to go back to several spots to polish UI/double-check stuff, do you keep a lot of files around? Or do people usually have another solution for this? (If that helps, I use BGB as my main emulator.) Thanks in advance for any insight anyone might have!

I have lots of save states and organize them into folders. Like chapter 1,2.. Special npc events that take too much time to get to. Although sometimes loadstates can use stale, rusty data that'll blow your work. So I timestamp the folders with version also.

And try to make cheat codes. Free roam. 1-hits. Fast move. Super stats, items. Anything to replay or retest easier.


You're doing a great job so far! As you progress more, you'll likely go back and redo stuff because learning from others' memories and experiences gets you fresh ideas.

Like the "Digimon: Tag Tamers translation", I'm kinda jealous I didn't think of that status screen remap - I think it's gorgeous. But chefs "borrow" from each other all the time anyway without often mentioning. :lol:


@Stories8106
BGB is your preferred debugger. Although what was that ... VBA-Tracer? I like the tracelogs it puts out.
Title: Re: Jungle Wars (GB) - English Translation - v0.1.0
Post by: Grungi on June 22, 2020, 12:15:09 pm
@Stories8106

Thanks a lot! As stratoform said, BGB is awesome as it lets you see memory as well as code!
For me, I use a combination an Hex Editor for initial research (I use WH32EX, as it supports "tables" which associate hexadecimal values to characters). I also used mgbdis (https://github.com/mattcurrie/mgbdis) to disassemble the ROM and check the code out, slowly creating labels and such when I start understanding parts of the ROM. I also read a bunch of documents from this site, and from there it was a lot of poking around the ROM!

@stratoform

Thanks a whole bunch for the pointers. I would have definitely missed the timestamping using version numbers! Lately I also have been thinking about splitting my huge YAML file that holds the whole script + battle text + other stuff into smaller ones by chapters to make it easier to handle (altough then I have to think about handling duplicates).

And I checked out that Digimon translation. It makes me much more confident in wanting to change some of the layouts of screens to make them work better! Thanks for the encouragements in any case, really appreciated!
Title: Re: Jungle Wars (GB) - English Translation - v0.1.0
Post by: Pennywise on June 23, 2020, 10:17:12 am
Looking good. If you run into space issues in shops etc, one thing you can do is store the item price on the bottom line. Like this:

(http://yojimbo.eludevisibility.org/Stardust_Crusaders_Files/complete/GB/heraclesgbfiles/19.png)

You could probably do the same thing with the enemy names as well.
Title: Re: Jungle Wars (GB) - English Translation - v0.2.0
Post by: Grungi on June 24, 2020, 05:37:06 pm
@Pennywise : This looks super good! What game is that? (It is the same one you posted a screen of earlier too, right?)
I know they have a way to access the "middle lines" because of how the original game handles diacritic marks, so I am sure it is doable, but I will need to understand the text code better! Thanks for the inspiration anyway!

In other news, I have a new version of the patch to show :)
This ones covers more actual gameplay, up to where you get your first extra party member. This means you can start actually seeing how the game plays.

As before, get the 0.2.0 patch on GitHub! (https://github.com/grungi-ankhfire/gbromhack/releases/tag/0.2.0)

Feel free to open an issue on GitHub (https://github.com/grungi-ankhfire/gbromhack/issues) or post in this thread if you spot errors or find that something could be improved!

There are a bunch of known issues, like names of monsters not translated, or some attacks not showing up correctly, so there might be a 0.2.1 to fix those. I do think the best approach would be to better study the combat system code to make intelligent choices on handling a bunch of stuff, hence why I did not get too caught up in having every permutation working, since this takes a lot of time to test when relying on RNG.

Anyway, enjoy :)
Title: Re: Jungle Wars (GB) - English Translation - v0.2.0
Post by: Pennywise on June 24, 2020, 08:37:41 pm
Yes, it's from my Glory of Heracles translation.

You'll probably have to modify the code to shift the items/prices up/down, but it should be a simple hack.
Title: Re: Jungle Wars (GB) - English Translation - v0.2.0
Post by: jerodoalle13 on May 05, 2021, 02:49:02 pm
 ::)thnks a lot for your work ......
thare are news ??