Differences

This shows you the differences between two versions of the page.

--- systems:gbc2players [2021/10/03 05:03] – added pretty picture atari
+++ systems:gbc2players [2022/05/31 11:52] (current) – atari
@@ Line 1: / Line 1: @@
-====== Nintendo Game Boy Color - 2-Player ======
+<WRAP group>
+<WRAP round box twothirds column>
+{{ https://raw.githubusercontent.com/fabricecaruso/es-theme-carbon/master/art/logos/gbc2players.svg?nolink&420 }}
-{{ :systems:gbc2players.jpg?nolink&400|Two Game Boy Colors connected via the link cable.}}
+====== Nintendo Game Boy Color (2 Players) ======
 The link cable for the Game Boy allows two people to play two-player games. The requirement is that both players insert a Game Pak into their Game Boy, and the Game Pak must feature a two-player mode (the packaging of these games is marked with the appropriate symbol). The link cable is connected to the left side of Game Boy through the sockets specially provided for this, as illustrated on the right.
-^ shortname | ''gbc2players'' |
+This system scrapes metadata for the "gbc" group(s) and loads the ''gbc2players'' set from the currently selected theme, if available.
-^ emulator/core(s) | libretro/tgbdual |
+</WRAP>
-^ rom format(s) | ''.gbc'' ''.gb2'' ''.gbc2'' ''.zip'' ''.7z'' |
-===== Emulators =====
+<WRAP third column>
+{{ https://raw.githubusercontent.com/fabricecaruso/es-theme-carbon/master/art/consoles/gbc2players.png?nolink&350 |}}
+</WRAP>
+</WRAP>
-==== Libretro/TGBDual ====
+==== Quick reference ====
-TGB Dual is an open source (GPLv2) GB/GBC emulator with game link cable support.
+  * **Emulator:** [[#retroarch|RetroArch]]
+  * **Core:** [[#libretro:_tgbdual|libretro: TGBDual]]
+  * **Folder:** ''/userdata/roms/gbc2players''
+  * **Accepted ROM formats:** ''.gbc'', ''.gb2'', ''.gbc2'', ''.zip'', ''.7z''
+===== BIOS =====
-We use the latest [[https://github.com/libretro/tgbdual-libretro|Libretro]] core. See the [[https://docs.libretro.com/library/tgb_dual/|official documentation]] for more information.
+No Game Boy Color (2 players) emulator in Batocera needs a BIOS file to run.
 ===== ROMs =====
@@ Line 23: / Line 32: @@
 </WRAP>
-ROMs can ordinarily be put into the ''roms/gbc2players/'' folder. This will use a single save file between the linked games, stored in ''saves/gbc2player''. Player 2 will use a temporary blank save file that is removed when the session ends. Great for PVP games that don't rely on user save files such as Mario Tennis or Tetris DX.
+{{ :systems:gbc2players.jpg?nolink&400 |Two Game Boy Colors connected via the link cable.}}
+ROMs can ordinarily be put into the ''roms/gbc2players/'' folder. This will use a single ROM for both players in the linked game instances (Player 1's saves are stored in ''saves/gbc2player''). Player 2 will use a temporary blank save file that is removed when the session ends. Great for PVP games that don't rely on user save files such as Mario Tennis or Tetris DX.
 This is the only available way to use GBC2Player on Batocera **v31** and lower.
@@ Line 100: / Line 111: @@
 If you use a .gb2 playlist that calls the same ROM twice, the file that's ultimately saved will be from Player 2!
 </WRAP>
+===== Emulators =====
+==== RetroArch ====
+[[https://docs.libretro.com/|RetroArch]] (formerly SSNES), is a ubiquitous frontend that can run multiple "cores", which are essentially the emulators themselves. The most common cores use the [[https://www.libretro.com/|libretro]] API, so that's why cores run in RetroArch in Batocera are referred to as "libretro: (core name)". RetroArch aims to unify the feature set of all libretro cores and offer a universal, familiar interface independent of platform.
+=== RetroArch configuration ===
+RetroArch offers a **Quick Menu** accessed by pressing ''[HOTKEY]'' + {{:wiki:south.png?nolink&20|South button (B SNES)}} which can be used to alter various things like [[:advanced_retroarch_settings|RetroArch and core options]], and [[:remapping_controls_per_emulator|controller mapping]]. Most RetroArch related settings can be altered from Batocera's EmulationStation.
+Standardized features available to all libretro cores: ''gbc2players.videomode'', ''gbc2players.ratio'', ''gbc2players.smooth'', ''gbc2players.shaders'', ''gbc2players.pixel_perfect'', ''gbc2players.decoration'', ''gbc2players.game_translation''
+^ ES setting name ''batocera.conf_key'' ^ Description => ES option ''key_value'' ^
+^ Settings that apply to all cores of this emulator ||
+| **GRAPHICS BACKEND ''gbc2players.gfxbackend''** | Choose your graphics rendering\\ => OpenGL ''opengl'', Vulkan ''vulkan''. |
+| **AUDIO LATENCY ''gbc2players.audio_latency''** | Audio latency in milliseconds, turn it up if you hear crackles\\ => 256 ''256'', 192 ''192'', 128 ''128'', 64 ''64'', 32 ''32'', 16 ''16'', 8 ''8''. |
+| **THREADED VIDEO ''gbc2players.video_threaded''** | Improves performance at the cost of latency and more video stuttering. Use only if full speed cannot be obtained otherwise.\\ => On ''true'', Off ''false''. |
+=== libretro: TGBDual ===
+TGB Dual is an open source (GPLv2) GB/GBC emulator with game link cable support.
+We use the latest [[https://github.com/libretro/tgbdual-libretro|libretro]] core. See the [[https://docs.libretro.com/library/tgb_dual/|official documentation]] for more information.
+== libretro: TGBDual configuration ==
+^ ES setting name ''batocera.conf_key'' ^ Description => ES option ''key_value'' ^
+^ Settings that apply to all systems this core supports ||
+| **SYNC SAVE FILES ''global.sync_saves''** | Sync 2 player saves with single player versions (default is off)\\ => On ''1'', Off ''0''. |
 ===== Controls =====
-The default button mapping to the Game Boy Color is as following:
+Here are the default Game Boy Color (2 players)'s controls shown on a [[:configure_a_controller|Batocera Retropad]]:
+{{ https://raw.githubusercontent.com/batocera-linux/batocera-controller-overlays/master/solid-4k/nes.png }}
+===== Troubleshooting =====
+==== Further troubleshooting ====
-{{ :systems:gbc_controller_mapping.png?nolink&750 |}}
+For further troubleshooting, refer to the [[:support|generic support pages]].