https://github.com/lonedev6/garagedoor
First translation hack for the Japanese videogame GARAGE: Bad Dream Adventure ｢ガラージュ｣
https://github.com/lonedev6/garagedoor
game reverse-engineering translation
Last synced: 8 months ago
JSON representation
First translation hack for the Japanese videogame GARAGE: Bad Dream Adventure ｢ガラージュ｣
- Host: GitHub
- URL: https://github.com/lonedev6/garagedoor
- Owner: LoneDev6
- License: other
- Created: 2020-03-31T21:23:56.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-11-07T09:56:47.000Z (over 1 year ago)
- Last Synced: 2024-11-07T10:41:50.482Z (over 1 year ago)
- Topics: game, reverse-engineering, translation
- Language: C++
- Homepage:
- Size: 35.9 MB
- Stars: 15
- Watchers: 2
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
  
# GarageDoor
First translation hack for the Japanese videogame [GARAGE: Bad Dream Adventure ｢ガラージュ｣](https://lostmediaarchive.fandom.com/wiki/Garage:_Bad_Dream_Adventure_(Limited_Release_1999_Japanese_Point-and-Click_Game) "GARAGE: Bad Dream Adventure ｢ガラージュ｣")
[Join the Discord server](https://discord.gg/AWtvKs4)
### Features
- Intercept and translate game text at runtime
- Dump game texts to a file at runtime
- Translate text without restarting the game
- Game images recognition and replace at runtime
# :warning:**Only compatible with**
- Windows 7
- Windows 8
- Windows 10
# 💿 How to install the original game
1. Download [7zip](https://www.7-zip.org/download.html)
2. Download and open [`garage.7z`](https://archive.org/download/GarageBadDreamAdventure/garage.7z)
3. Extract `garage.img.ecm`
4. Download [ECM Tools](https://archive.org/download/ECMToolsV1.0/ECM%20Tools%20v1.0.zip)
5. Drag and drop `garage.img.ecm` into `unecm.exe`
7. Wait the program to finish and obtain `garage.img` from the same folder
8. Download [WinCDEmu Portable](https://wincdemu.sysprogs.org/portable/) and run it
9. Drag and drop `garage.img` into the program
10. Find the mounted virtual CD Drive in "*Computer*" and open "*CD Drive (D:) GARAGE*"
11. Highlight everything in the file, then copy it to a new folder called `Garage` (you can create it anywhere you want)
12. Click on "*Uninstall Driver*" and close **WinCDEmu**
13. You can delete all previously downloaded files except the `Garage` folder
# 💾 How to install the english patch
1. Download [latest GarageEnglishPatch](https://github.com/LoneDev6/GarageDoor/releases/download/0.0.3/GarageEnglishPatch_v1.0.1.7z) from the [releases](https://github.com/LoneDev6/GarageDoor/releases).
2. Extract contents into the root of your **Garage** game folder
3. Run `GarageOpener.exe`
### Changing the games aspect ratio for Windows OS (optional, may cause issues)
1. Right click on `Garage.exe`
2. Click on Properties
3. Click on Compatibility
4. Check the "Run in 640x480 screen resolution" & "Disable fullscreen optimizations" options
5. Click Apply
-------
# How to contribute
###### Skip this if you're not interested
#### Texts
- Run `GarageOpener.exe` and check `Developer/translator mode`
- Play the game and when you find an untraslated text the program will copy it and add it to the file `translation.ini`
- Edit the file `translation.ini` (no need to restart or close the game) and translate the new text (default value `NOT_TRANSLATED_TEXT`)
- Be sure not to break the .ini file removing `=` symbol, `[Phrases] `and `[Settings]`
- If you want you can submit a pull request so I can merge your translations with the main ones
#### Images
- open `assets_new` folder
- create your own folder to organize everything better, for example name it `various`, or use the `unknown` folder which already exists.
- take a COMPLETE screenshot of the scene, must be `642x482` PRECISELY with no X-Y shifting.
- open it using `GIMP`, remove as much details as possible and keep only the details that caracterize the scene, to allow my tool to recognize that scene.
- **IMPORTANT:** be sure not to keep the 1 pixel borders in the image (make them transparent), I mean the gray borders.
- for this image you can use transparent or green (0, 255, 0) background, but transparent is better
- save the png file
- create a new folder inside your own folder (`various` or `unknown` or...) and call it `translated`
- create a new png file with the same name of your previous file
- edit the initial screenshot translating the parts you want
- delete the useless parts which are not translated and keep only the texts areas
- save it in the `translated` folder (as I said before it must have the same name as the first file)
###### NOTES:
1. if you set the game to run with lower colors please disable it in properties of `Garage.exe` file.
2. this tool was highly tested and works on `Windows 10 19041.264`, I don't know if it works fine on other Windows versions. Tested on `i7 4790k CPU`.
3. I know the image replace has 5-6ms of delay, don't report that since I cannot fix this
4. there is no need to restart the game each time you edit images. You can just switch back to the game and wait 30 seconds as the tool will rescan the folder for new or edited images.
#### Intro
- Intro texts are images stored in `dir_data\open.swf` file
- You have to edit it file using an extractor like "Flash Decompiler Trillix"
-------
## Contributors
### 💻Development and reverse engineering
- [LoneDev](https://github.com/LoneDev6 "LoneDev")
### 📕Translations
- [LoneDev](https://github.com/LoneDev6 "LoneDev")
- [Morgan](https://www.youtube.com/channel/UClroPL_xY9RGlMbQJIMiiIw)
- FELON
- Saint
### 🎥Director 6 images patch
###### (not used anymore by the patch)
- [LoneDev](https://github.com/LoneDev6 "LoneDev")
- TOMYSSHADOW
- nosamu