https://github.com/raphaklaus/gameboy-text-tools

Set of tools for text manipulation and translation of Game Boy ROMs
https://github.com/raphaklaus/gameboy-text-tools

Last synced: 2 months ago
JSON representation

Set of tools for text manipulation and translation of Game Boy ROMs

• Host: GitHub
• URL: https://github.com/raphaklaus/gameboy-text-tools
• Owner: raphaklaus
• Created: 2017-11-25T00:46:11.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2017-12-02T23:01:42.000Z (over 6 years ago)
• Last Synced: 2024-01-24T13:07:26.006Z (5 months ago)
• Language: JavaScript
• Homepage:
• Size: 3.91 KB
• Stars: 9
• Watchers: 3
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Lists

• awesome-gbdev - Game Boy Text Tools - Set of tools for text manipulation and translation of Game Boy ROMs written in Node.js. (Software Development / Tools)
• awesome-gb-dev-zh - Game Boy 文本工具 - 一套用于文本操作和翻译 Node.js 中编写的 Game Boy ROMs 的工具 (软件开发 / 工具)

README

        
# Game Boy Text Tools

## Running

* Clone this project

* Make sure you have NodeJS >= 9.1.0

### Relative Search

It'll search through the ROM looking for the relative distance between the bytes' characters.

**Don't mix upper and lower case characters. Choose a case and keep it for each search**

`node relativeSearch.js path-to-rom 'what you are searching'`

Output:

```

Found!

hexSentence: C7 BE C6 C2 BE CC

Byte for a: BA

```

### Translator

Once you know the byte representation of lower and upper case 'a' (first letter of the alphabet in the sequential table) you can pass it to the translator function:

`node translator.js 'Your sentence here' lowerCaseAByte upperCaseAByte`

* lowerCaseAByte - 0x80

* upperCaseAByte - 0xA0

*Values above for using with Pokemon Red, change it accordingly to the game*

Output:

```

A7 8E 89 84 EF 8E EF 83 88 80 EF 85 8E 88 EF 8B 8E 94 82 8E

```