hhugboy v1.4.1 a Game Boy/Game Boy Color emulator for Windows by taizou (cactusgunman@gmail.com) http://hhug.me/ https://github.com/tzlion/hhugboy
hhugboy is based on GEST v1.1.1 by TM (http://koti.mbnet.fi/gest_emu/) with the following additions:
Bunch of minor tweaks/fixes
Requires DirectX runtime 7+
[ UNLICENSED COMPATIBILITY MODES ] - - - - - - - - - - - - - - - - - - - - - - -
Auto For unlicensed publishers with unique boot logos, the emulator will attempt to automatically determine which mapper to use based on the logo present in the ROM.
"V.fame", "SOUL", "DIGI" -> Vast Fame This is not always a 100% reliable indicator though! e.g. some Li Cheng games do not have the "Niutoude" logo. If a game doesn't work, try selecting the mode manually. Sachen and Wisdom Tree games will also be detected by other means.
For other games and multicarts, the detection is currently done
based on the ROM title and size, meaning only certain predefined
carts can be autodetected for now:
- Vast Fame 12-in-1
- Vast Fame 18-in-1
- SL 36-in-1 with Chinese Pokemon Gold & Silver
- 23-in-1 CR2011 with Super Mario Special 3
- 25-in-1 NT-9920 with Rockman 8
- 24-in-1 CY2060 with Donkey Kong 5, Sonic 8
- 24-in-1 CY2061/CR2020 with Rockman X4, Sonic 8
- Super Mario Special 3
- Super Donkey Kong 5
- Rockman 8
- Rockman X4
- Sonic Adventure 8
Li Cheng For games released by Li Cheng, also known as Xing Xing, Niutoude, Winsen or Yongsheng.
Sintax For games by Sintax. Please note this mode will definitely not work for anything other than a raw Sintax dump from a game using their own mapper! If the game is hacked to work on other emulators or a generic release from another company, it won't work. (However these roms SHOULD now be picked up by Auto mode)
BBD For games by BBD using their own mapper. Support isn't complete yet but works with known dumps.
Hitek For games by Hitek.
NT old type 1/2 Earlier carts released by NT, including older Makon games and some multicarts. Type 1: Rockman 8 Type 2: Super Mario 3, Donkey Kong 5, rumble carts
NT new Later carts released by NT, specifically Makon single carts. No multicart support yet.
Liebao Technology Currently only known to support 'Dragon Ball Z 3', the pirate English translation of DBZ Goku Gekitouden. Other games may use this too, especially Chinese translations.
Pokémon Jade/Diamond For the original protected versions of the Telefang translations. Currently only verified working with Jade. (Not necessary for most common dumps which are hacks/reprints)
New GB Color Pokémon hacks Protection found on carts released under the "New GB Color" brand with HKxxxx PCBs. Known games are both Pokémon platformer hacks: 'Pokémon Action Chapter', 'Monster Go! Go! II' (translated names)
Vast Fame (Taiwan releases) Original Taiwanese releases of Vast Fame games (from about 2000 onwards)
Vast Fame (SL releases) Mainland China releases of Vast Fame games with "SL" codes
Vast Fame (KongFeng/other releases) Certain mainland China and English versions of Vast Fame games. Known so far: 'Harvest Moon 6', 'Lord of the Rings Legend', 'Digimon Pocket' (Chinese), 'Digimon Sapphire' (English). The Chinese releases have DSHGGB-81 PCB code.
'Last Bible' multicart A type of multicart using menu music taken from 'Megami Tensei Gaiden: Last Bible' aka 'Revelations: The Demon Slayer'. This notably covers all of Vast Fame's multicarts, in addition to a number of more generic carts.
MBC1/3/5 compatible For unknown carts that fake their header value but are actually compatible with common mappers.
Disabled No compatibility mode
[ KEYS ] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Default Gameboy Controls Up Up Down Down Left Left Right Right X A Z B S Turbo A A Turbo B Q L (stretch in GBA mode) W R (unstretch in GBA mode) Enter Start Backspace Select Numpad Tilt sensor controls
Emulator Controls Esc Exit Ctrl+P Pause Ctrl+R Hard Reset Ctrl+F Soft Reset Spacebar Speedup F2 Save state F3 Change state slot F4 Load state F5 Toggle BG layer F6 Toggle WIN layer F7 Toggle sprite layer F12 Screenshot GB1 Ctrl+F12 Screenshot GB2 0~9, /, = Change GBC palette for mono games
[ CHEATS ] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Cheats are supported in two formats:
Game Genie xxx-xxx-xxx or xxx-xxx Same as the Game Genie cheat device. Codes and documentation undoubtedly available online somewhere
Address/Value xxxx=yy xxxx = address, yy = value, in hexadecimal. e.g. 1234=1F
The Memory Search functionality can assist in finding memory addresses to use with the address/value format. It allows you to search for specific values in memory, and by checking the "in previous result set" option, you can then search only in the results of the previous search, allowing you to narrow down memory locations that may contain something of interest (lives, time, etc).
[ COMPATIBILITY ]- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
This emulator was primarily designed for Windows, but it will also run on Linux or macOS using Wine. However it has not been extensively tested in this environment - your mileage may vary.
Tip thanks to codeman38: For anyone trying to run hhugboy on macOS or Linux via anything Wine-based (Wineskin, Crossover, PlayOnMac) and getting a black screen, go into the Wine registry editor, find HKEY_CURRENT_USER\Software\Wine\Direct3D, and create a string value OffscreenRenderingMode with the value backbuffer.
[ ISSUES ] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
[ FUTURE DEVELOPMENTS? ] - - - - - - - - - - - - - - - - - - - - - - - - - - - -
If I ever have the time/skill/motivation
[ RELEASE HISTORY ]- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
v1.4.1 26th August 2024
Support additional BBD bit scramble mode & logo detection for SKOB-published Pocket Monsters Crystal game (thanks to JS7457)
v1.4.0 21st March 2022
A bunch of behind-the-scenes changes to how mappers & saving work. This should mostly have no perceptible effect but might've fixed some obscure bugs around loading savestates using multicarts. However it will also mean old savestates for Tamagotchi 3 won't load in this version. Sorry if anyone was playing that :(
v1.3.2 22nd February 2022
Fix logo swap behaviour for GGB-81 PCB when using bootstrap & implement GBX support for PCB variants that do not swap the logo
v1.3.1 6th December 2021
Allow undersized save files to be read (to avoid saves being wiped when an "unlicensed compatibility mode" change results in a RAM size change)
v1.3.0 29th October 2020
Don't activate menus when pressing Alt alone so it can be used as an input
v1.2.8 27th July 2020
Add debug logging for Sintax & BBD protection initialisation modes (to work with Sintaxinator in hhugtools)
v1.2.7 31st October 2018 (BOO)
Some refactoring of graphics code which should hopefully have no effect
v1.2.6 11th March 2018
Fix MBC5 RAM banking bug observed to affect unlicensed games e.g. Fengkuang Dafuweng (V.Fame), Digimon Pocket (Makon)
v1.2.5 5th March 2018
Refactored UI code & added secret debug window, which is a secret
v1.2.1 24th August 2017
Tidy up detection code a bit
v1.2 13th August 2017
"Realistic" colour mode is now off by default
v1.1.8 7th January 2017
Add 25% and 50% volume options
v1.1.6 23rd October 2016
Auto-detection support for fixed/hacked/decrypted Sintax games
v1.1.5 2nd October 2016
More code refactoring mostly around rom type detection
v1.1.1 4th September 2016
Fixes window layer issue affecting Sanguozhi Wudai
v1.1 30th August 2016
Way more code refactoring to make it easier to add new mappers in future
v1.0.5 3rd January 2016
A bunch of code refactoring to facilitate future changes - should have no effect from a user's perspective!
v1.0 18th February 2013
[ COPYRIGHT/LICENSE ]- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
hhugboy Game Boy emulator copyright 2013-2022 taizou
Based on GEST Copyright (C) 2003-2010 TM Incorporates code from VisualBoyAdvance Copyright (C) 1999-2004 by Forgotten
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
[ SPECIAL THANKS! ]- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Massive contributions by NewRisingSun PCPaint Bold font by codeman38 (http://www.zone38.net/) Testers - MLX, Robyn, KingPepe, JP, bawkers
Dedicated to Near