Skip to content

libretro gameboy core with up to 16 players support and buildtin Pokemon Distribution Events

Notifications You must be signed in to change notification settings

TimOelrichs/doublecherryGB-libretro

 
 

Repository files navigation

DoubleCherryGB

author: Tim Oelrichs
email: timoelrichs@gmail.com
website: timoelrichs.is-a.dev
https://patreon.com/double_cherry_projects
https://www.buymeacoffee.com/timoelrichs

DoubleCherryGB is an open source (GPLv2) GB/GBC emulator with up to 16 Player support, based on the TGBDual libretro core by GIGO and Hii. It emulates the GAMEBOY 4 PLAYER ADAPTER (DMG-07) and also adds 3-16 Player Link Hacks for two-player games. It's named after the Double Cherry Item from Super Mario 3D World.

Check my website for more information, planned features and compatibility list.


Features

Pokemon Stuff

Multiplayer

  • GAMEBOY 4 PLAYER ADAPTER (DMG-07) emulation (F1-Race, Wave Race, Yoshi's Cookie...) compatibility list

  • up to 16-Player Faceball 2000 emulation (1-15 without bugfix-patch, 16 players needs patched rom)

  • up to 16-Player Tetris Battle Royal Hack (virtual link device, no modified rom needed)

  • up to 16-Player Kwirk Multiplayer Hack (virtual link device, no modified rom needed)

  • up to 16 Player 4x4Player Adapter

  • Of course up to 16 Player Singleplayer for speedrun-battles or if you have arguing kids :D

  • local splitscreen

  • netplay support


Gameboy Addon Emulation

  • BARCODE BOY Emulation full support (all barcodes are hardcoded, use the numkeys 0-9 for selection)
  • POWER ANTENNA/BUGSENSOR Emulation (LED via led driver overlay & controller rumble on led flash)

Netplay is working. Make sure to have all the same amount of emulated gameboys in your core options.


How to

You can download the core via RetroArch Online-Updater on Windows, Linux, Android and IOS. For Android make sure to use the retroarch APK from retroarch.com and not the GooglePlay Version.

For Multiplayer you have to increase the amount of emulated Gameboy in the core options in your frontend and reload.


Builtin Mew Maschine and weekly GEN1 Pokemon Distributions

DoubleCherryGB has a buildin virtual linkcable device that can trade Pokemon. I called it the PKMBuddy Boy.

  • If you don't own a Mew it will trade you a Lv 5 Mew.
  • If you already own a Mew it will give you weekly custom Distribution Events.

You can uses the Numkeys on your keyboard or the SELECT Button to change Pokemon you want to get.

Weekly Gen1 Pokemon Distribution List https://docs.google.com/spreadsheets/d/1SMcpTz_4Mwo1eVAKWB3AbaLHJNthkB5sKHlOPnQw2UI/edit?gid=0#gid=0


Link Cable Trading over network

Easy gen1/gen2 pokemon online trading

Why is this easier? No setup and no workarounds. No need to own the same roms (region, edition). Should work cross platform. You can find trading partners over the netplay lobby (netplay -> refresh Host List), and can use the netplay text-chat by pressing ^ on your keyboard. Also works in LAN.

I recommend to use the RetroArch Discord server to find players and use voice-chats.

Atleast Retroarch 1.17 is needed for the netpacket api. Only the linkcable data is transfered over network, so you won't see the others player's screen.

  • make sure emulated gameboys is set to 1 in the Core Options
  • load your rom
  • start or join a netplay (a second player can join any time)

The netpacket api is activated when you set emulated gameboys to 1. This is only meant for trading purposes and may be too slow for actual Multiplayer. For Multiplayer-sessions please set the amount of emulated gameboys to 2 or higher, because this will activate the old savestate sync for lagfree netplay.

Trading should work with other GB/GBC Games as well:

  • Pokemon R/B/Y/S/G/C
  • Pokemon Trading Card Game 1 and 2
  • RoboPon Sun/Star
  • Medarot 1/2/3 Kabuto/Kuwagata/Parts Collection
  • Telefang Speed/Power
  • Network Adventure Bugsite Alpha/Beta
  • Dragon Warrior (Quest) Monster
  • Dragon Warrior (Quest) Monster 2 Tara's Adventure / Cobi's Journey
  • Monster Rancher Battle Card Game
  • Zelda OoA / OoS ring trade
  • ...

Infrared over network is currently not supported (GBE+ does) but maybe in a future release.

Have fun!


BARCODE BOY

The BARCODE BOY is a japan exclusive peripheral (See https://shonumi.github.io/articles/art7.html).

The following games have support or even need the BARCODE BOY to be played:

  • BATTLE SPACE (needed)
  • Monster Maker Barcode Saga (needed)
  • Kattobi Road (additional content)
  • Family Jockey 2 (additional content)
  • Famista 3 (additional content)

All Barcode Cards are hardcoded. You can select different cards with the Numkeys 0-9. If you don't have a keyboard, the the barcode cards will be changed randomly.


POWER ANTENNA and BUGSENSOR

These are devices, that came with the games Keitai Denjuu Telefang and Network Adventure Bugsite and are plugged into the linkport. It's simply a led that flashes when, something special happens ingame. DoubleCherryGB uses the controller rumble and the retroarch led api to simulate the led flashing on an overlay.

Here is the example overlay i used over the mega-bezels gbc shader. But you can also make your own.

You need to edit your retroarch.cfg file the get the overlay to work. (See https://docs.libretro.com/guides/led-drivers/)

led_driver = "overlay"
led1_map = "1"


If you like to support me https://patreon.com/double_cherry_projects
https://www.buymeacoffee.com/timoelrichs

Thanks to

  • Shonumi for doing the research and technical documentation for Gameboy and many peripherals/accessories/add-ons https://shonumi.github.io/index.html
  • PSYRaven for the netpacket api and davidgf for his implemtation on gpSP
  • Ninoh-Fox for his work on Koriki cfw
  • GIGO and Hii for making TGBDual and the libretro port

Original sources from

About

libretro gameboy core with up to 16 players support and buildtin Pokemon Distribution Events

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C++ 52.5%
  • C 44.7%
  • Makefile 2.8%