| Both sides previous revision Previous revision Next revision | Previous revision |
| emulators:lightgun_games [2025/03/17 00:29] – typo tovarichtch | emulators:lightgun_games [2026/04/28 04:38] (current) – [Table] tovarichtch |
|---|
| |
| {{:emulators:es_showing_guns2.png?460|}} {{:emulators:gun_icon_game_list.png?400|}} | {{:emulators:es_showing_guns2.png?460|}} {{:emulators:gun_icon_game_list.png?400|}} |
| |
| <WRAP center round info> | |
| You might come across few games that are not gun games with the light gun icon anyway in Batocera **v35**. These games have optional light gun support for an easter egg, specific scene, mini-game, etc. They are not configured automatically by the system. However, it is possible to manually configure them if you know what you are doing. | |
| </WRAP> | |
| |
| ===== Light gun comparison ===== | ===== Light gun comparison ===== |
| |
| <WRAP center round info> | <WRAP center round info> |
| All prices are subject to differ based on local availability and are only estimates; listed in USD. | Want your light gun added to the list? Join our **Discord** and ask for assistance in **#lightguns** channel. |
| </WRAP> | </WRAP> |
| |
| ^ Light gun ^ Tracking method ^ Precision ^ Minimum distance required ( x * display size) ^ Connectivity ^ Estimated price ($US) ^ Notes ^ | ^ Light gun ^ Tracking method ^ Precision ^ Minimum distance required ( x * display size) ^ Connectivity ^ Estimated price ($US) ^ Notes ^ |
| | [[#ae_lightgun|AE Lightgun]]\\ {{:emulators:aelightgun.jpg?250|AE Lightgun.}} | Infrared | ★★☆☆☆ | 3x to 3.5x | USB cable (290 cm) | [[https://www.aelightgun.com/product-page|$125]] | Requires at least nine feet/three metres of space to use. Has calibration issues, requiring multiple attempts before it will apply. | | | [[#ae_lightgun|AE Lightgun]]\\ {{:emulators:aelightgun.jpg?250|AE Lightgun.}} | Infrared | ★★☆☆☆ | 3x to 3.5x | USB cable (290 cm) | [[https://www.aelightgun.com/product-page|$125]] | Requires at least nine feet/three metres of space to use. Has calibration issues, requiring multiple attempts before it will apply. | |
| | [[#ultimarc_aimtrak|Ultimarc Aimtrak]]\\ [[#ultimarc_aimtrak|{{:emulators:aimtrakred_qyws-ao.jpg?200}}]] | Infrared\\ {{:emulators:aimtrak_ir_bar.png?200|The Aimtrak IR bar, thicker than the Wii's IR bar.}} | ★★☆☆☆ | 2x to 2.5x | USB cable (370 cm) | $95 (w/o recoil)/$120 (w/ recoil) | Has calibration issues, requiring multiple attempts before it will apply. | | | [[#ultimarc_aimtrak|Ultimarc Aimtrak]]\\ [[#ultimarc_aimtrak|{{:emulators:aimtrakred_qyws-ao.jpg?200}}]] | Infrared\\ {{:emulators:aimtrak_ir_bar.png?200|The Aimtrak IR bar, thicker than the Wii's IR bar.}} | ★★☆☆☆ | 2x to 2.5x | USB cable (370 cm) | $95 (w/o recoil)/$120 (w/ recoil) | Has calibration issues, requiring multiple attempts before it will apply. | |
| | [[https://blamcon.com/|Blamcon Light Gun]]\\ [[#blamcon|{{:emulators:blamcon_vyper_borderlandstorgue_1000x1600.png?200|Blamcon Light Gun.}}]] | Infrared | :?: | :?: | USB cable | :?: | Larger displays require more physical distance (or wide/fish lens). Full support starting v42. | | | [[https://blamcon.com/|Blamcon Light Gun]]\\ [[#blamcon|{{:emulators:blamcon_vyper_borderlandstorgue_1000x1600.png?200|Blamcon Light Gun.}}]] | Infrared | ★★★⯪☆ | 1x (with fisheye lens) to 2x (without lens) | USB cable | $60 (DIY)/Up to 600$ (pre-assembled with custom preferences) | Larger displays require more physical distance (or wide/fish lens). Full support starting v42. Must manually adjust offset in calibration for best resultst. | |
| | [[#mayflash_dolphinbar|Mayflash Dolphinbar]] with Wiimote gun\\ [[#mayflash_dolphinbar|{{:emulators:wiigun.jpg?170|Wiimote in a gun-shaped holster.}}]] | Infrared\\ {{:emulators:dolphinbar.jpg?200|The Mayflash Dolphinbar in all its old glory.}} | ★☆☆☆☆ | 1.5x | Connect Dolphinbar to machine via USB cable, then Wiimotes to Dolphinbar via Bluetooth | $10-20 second-hand Wiimote + [[https://www.amazon.com/dp/B00HZWEB74?ref=myi_title_dp|$35]] Dolphinbar | Works universally across machines and Wiimotes, but tends to jitter. **No calibration possible, crosshair is mandatory**. This is the only option on **v34** and lower. Also, the Wiimote itself is wireless (most other light guns are wired). | | | [[#mayflash_dolphinbar|Mayflash Dolphinbar]] with Wiimote gun\\ [[#mayflash_dolphinbar|{{:emulators:wiigun.jpg?170|Wiimote in a gun-shaped holster.}}]] | Infrared\\ {{:emulators:dolphinbar.jpg?200|The Mayflash Dolphinbar in all its old glory.}} | ★☆☆☆☆ | 1.5x | Connect Dolphinbar to machine via USB cable, then Wiimotes to Dolphinbar via Bluetooth | $10-20 second-hand Wiimote + [[https://www.amazon.com/dp/B00HZWEB74?ref=myi_title_dp|$35]] Dolphinbar | Works universally across machines and Wiimotes, but tends to jitter. **No calibration possible, crosshair is mandatory**. This is the only option on **v34** and lower. Also, the Wiimote itself is wireless (most other light guns are wired). __**NOT RECOMMENDED, UNSUPPORTED AND OBSOLETE.**__ | |
| | [[#direct_wiimote_gun_with_ir_bar|Direct Wiimote gun with IR bar]]\\ [[#direct_wiimote_with_ir_bar|{{:emulators:wiigun.jpg?170|Wiimote in a gun-shaped holster.}}]] | Infrared\\ {{:emulators:wiibar.jpg?250|USB-powered IR LED bar.}} | ★★★☆☆ | 2.5x | Bluetooth | $10-20 second-hand Wiimote + $3-$10 IR bar | Need to have a powered IR sensor bar, but is far more accurate than using the Dolphinbar. Also, the Wiimote itself is wireless (most other light guns are wired).\\ It is possible to convert the Mayflash Dolphinbar into a regular IR sensor bar with a firmware update, to use it as if though it were just a regular IR bar (this disables the Dolphinbar's Bluetooth connection, the Wiimote must be connected to a different device). | | | [[#direct_wiimote_gun_with_ir_bar|Direct Wiimote gun with IR bar]]\\ [[#direct_wiimote_with_ir_bar|{{:emulators:wiigun.jpg?170|Wiimote in a gun-shaped holster.}}]] | Infrared\\ {{:emulators:wiibar.jpg?250|USB-powered IR LED bar.}} | ★★★☆☆ | 2.5x | Bluetooth | $10-20 second-hand Wiimote + $3-$10 IR bar | Need to have a powered IR sensor bar, but is far more accurate than using the Dolphinbar. Also, the Wiimote itself is wireless (most other light guns are wired).\\ It is possible to convert the Mayflash Dolphinbar into a regular IR sensor bar with a firmware update, to use it as if though it were just a regular IR bar (this disables the Dolphinbar's Bluetooth connection, the Wiimote must be connected to a different device). | |
| | [[https://github.com/Fusion-Lightguns/P.I.G.S--Pico-Infared-Gun-System|Fusion Lightgun]]\\ {{https://user-images.githubusercontent.com/118452807/244064839-cd7d0198-27b7-4fd1-953c-83e2e4c0cd6b.png?200|Fusion Lightgun}} | Infrared | ★★★☆☆ | 2.5x | USB cable | $80 (DIY)/$200 (pre-assembled) | Larger displays require more physical distance (or wide/fish lens). Using SAMCO technology. | | | [[https://github.com/Fusion-Lightguns/P.I.G.S--Pico-Infared-Gun-System|Fusion Lightgun]]\\ {{https://user-images.githubusercontent.com/118452807/244064839-cd7d0198-27b7-4fd1-953c-83e2e4c0cd6b.png?200|Fusion Lightgun}} | Infrared | ★★★☆☆ | 2.5x | USB cable | $80 (DIY)/$200 (pre-assembled) | Larger displays require more physical distance (or wide/fish lens). Using SAMCO technology. | |
| | [[#namco_guncon|Namco GunCon2/G-Con2]]\\ [[#namco_guncon|{{:emulators:gcon2_1.jpg?200|Original Namco GunCon.}}]] | Cathode ray timing\\ {{:emulators:toshiba_crt_tv.jpg?200|An old CRT TV.}} | ★★★★★ | 0.2x to 1x | Composite/component cable | $25-$50 second-hand, low availability | Limited to [[:batocera-and-crt|analogue displays]] which supports composite/component input. <wrap em>This cannot be used on a modern digital display.</wrap> | | | [[#namco_guncon|Namco GunCon2/G-Con2]]\\ [[#namco_guncon|{{:emulators:gcon2_1.jpg?200|Original Namco GunCon.}}]] | Cathode ray timing\\ {{:emulators:toshiba_crt_tv.jpg?200|An old CRT TV.}} | ★★★★★ | 0.2x to 1x | Composite/component cable | $25-$50 second-hand, low availability | Limited to [[:batocera-and-crt|analogue displays]] which supports composite/component input. <wrap em>This cannot be used on a modern digital display.</wrap> | |
| | [[https://en.wikipedia.org/wiki/GunCon#GunCon_3|GunCon3]]\\ {{https://static.wikia.nocookie.net/timecrisispedia/images/0/05/Guncon_3.jpg?200|GunCon3}} | Infrared | ★★★☆☆ | 1.5x to 2x | USB cable | :?: | Larger displays require more physical distance (or wide/fish lens). Full support starting v38. | | | [[https://en.wikipedia.org/wiki/GunCon#GunCon_3|GunCon3]]\\ {{https://static.wikia.nocookie.net/timecrisispedia/images/0/05/Guncon_3.jpg?200|GunCon3}} | Infrared | ★★★☆☆ | 1.5x to 2x | USB cable | :?: | Larger displays require more physical distance (or wide/fish lens). Full support starting v38. | |
| | OneHit (AimTrak clone) | Infrared | :?: | :?: | USB cable | :?: | Full support starting v42. | | | [[#onehit_lightgun|OneHit (AimTrak clone)]]\\ [[#onehit_lightgun|{{:emulators:onehit.png?250|OneHit light gun}}]] | Infrared | :?: | :?: | USB cable | :?: | Full support starting v42. | |
| | [[#openfire_lightgun|OpenFIRE light gun]]\\ [[#openfire_lightgun|{{:emulators:openfire.jpg?250|OpenFIRE light gun}}]] | Infrared | :?: | :?: | USB cable | :?: | Full support starting v42. | | | [[#openfire_lightgun|OpenFIRE light gun]]\\ [[#openfire_lightgun|{{:emulators:openfire.jpg?250|OpenFIRE light gun}}]] | Infrared | :?: | :?: | USB cable | :?: | Full support starting v42. | |
| | [[#retro_shooter_lightgun|Retro Shooter]]\\ [[#retro_shooter_lightgun|{{https://retroshooter.com/wp-content/uploads/2023/07/Retro-Shooter-guns.png?200|Retro Shooter Lightguns.}}]] | Infrared | ★★☆☆☆ (2 IR)\\ ★★★☆☆ (4 IR) | 2.5x to 3x (2 IR)\\ 2x (4 IR) | USB cable | [[https://retroshooter.com/shop|185$ including a pedal and hub for recoil]] | Recoil can optionally be disabled or put to single shot. Two IR requires massive distance or fish lens. Full support for RS1 & RS2 starting v39; full support for RS3 Reapers starting v42. | | | [[#retro_shooter_lightgun|Retro Shooter]]\\ [[#retro_shooter_lightgun|{{https://retroshooter.com/wp-content/uploads/2023/07/Retro-Shooter-guns.png?200|Retro Shooter Lightguns.}}]] | Infrared | ★★☆☆☆ (2 IR)\\ ★★★☆☆ (4 IR) | 2.5x to 3x (2 IR)\\ 2x (4 IR) | USB cable | [[https://retroshooter.com/shop|185$ including a pedal and hub for recoil]] | Recoil can optionally be disabled or put to single shot. Two IR requires massive distance or fish lens. Full support for RS1 & RS2 starting v39; full support for RS3 Reapers starting v42. | |
| ===== Global calibration ===== | ===== Global calibration ===== |
| |
| When a light gun is connected, a light gun symbol will appear in place of the controller activity icons (if that is enabled and the theme supports it). In addition, a new menu item will appear in the **CONTROLLERS & BLUETOOTH SETTINGS** menu specific to the light guns that are currently connected. This can be used to adjust settings specific to that light gun. | When a light gun is connected, a light gun symbol will appear in place of the controller activity icons (if that is enabled and the theme supports it). In addition, a new menu item might appear in the **CONTROLLERS & BLUETOOTH SETTINGS** menu specific to the light guns that are currently connected. This can be used to adjust settings specific to that light gun. |
| |
| Depending on the light gun, global calibration may be required. All global calibration can be performed at any time, even during gameplay, however this sort of calibration will **always** be for global calibration (it is not saved per-game, it's only needed to be done once). Refer to the section relevant to your light gun below for instructions. | One global calibration is required and is saved within the light gun itself. All global calibration can be performed at any time, even during gameplay, however this sort of calibration will **always** be for global calibration (it is not saved per-game, it's only needed to be done once). Refer to the section relevant to your light gun below for instructions. |
| |
| <WRAP center round important> | <WRAP center round important> |
| </WRAP> | </WRAP> |
| |
| ===== Direct Wiimote gun with IR bar ===== | ===== AE Lightgun ===== |
| |
| {{:emulators:wiigun.jpg?170|Wiimote in a gun-shaped holster.}} {{:emulators:wiibar.jpg?250|USB-powered IR LED bar.}} | {{:emulators:aelightgun.jpg?250|AE Lightgun.}} |
| |
| The Wii was revolutionary for its motion-based controls when it released back in 2006. This technology can now be used to emulate a light gun in Batocera, useful if you happen to have an old Wiimote and sensor bar laying around that is unused (though for convenience, buying a USB-powered sensor bar may be necessary). This is recommended over using the Mayflash Dolphinbar as the direct connection has far superior accuracy. | The [[https://www.aelightgun.com/|AE Lightgun]] comes with its own IR bar which can be mounted on the top of or at the bottom of the display, much like the Wiimote and Ultimarc AimTrak. |
| |
| This is a special mode for the Wiimote when connected to Batocera. This will be referred to as the Wiimote gun from now on. Requires Batocera **v35** or higher. | ==== AE Lightgun setup ==== |
| |
| <WRAP center round alert> | Connect both the light gun and the IR bar via USB. Then, press the button in front of the main trigger to launch the global calibration process. Shoot the middle, top-right and bottom-left targets as they appear. |
| **v35 to v38**: most third-party remotes won't work as they don't respect the correct bluetooth connection process, requiring the Mayflash Dolphinbar Bluetooth module. | |
| |
| **v39+**: enable the wiimote3rdparty option in ''SYSTEM SETTINGS'' → ''SERVICES'' to use your third-party wiimote. | ===== Ultimarc AimTrak ===== |
| </WRAP> | |
| |
| | {{:emulators:aimtrak.jpg?170|Aimtrak Light gun.}} {{:emulators:aimtrak_ir_bar.png?200|The Aimtrak IR bar, thicker than the Wii's IR bar.}} |
| |
| <WRAP center round info> | The [[https://www.ultimarc.com/light-guns/aimtrak-light-gun/aim-trak-light-gun/|Ultimarc Aimtrak]] comes with its own IR bar which can be mounted on the top of or at the bottom of the display, much like the Wiimote. Requires Batocera **v35** or higher. |
| The Wiimote's face buttons have no function in Batocera **v35**, however this was fixed in Batocera **v36**. | |
| </WRAP> | |
| |
| ==== Direct Wiimote gun setup ==== | ==== Ultimarc AimTrak setup ==== |
| |
| Set up the powered IR bar by taping over one side with solid tape and positioning the remaining LED at the bottom/top center of the display. Counter-intuitively, this setup works best when only one IR LED is visible (otherwise the cursor on-screen may "jump" when aiming at the edges). | Connect both the light gun and the IR bar via USB. Then, hold main trigger for five seconds to launch the global calibration process. Shoot the top-left, top-right and bottom-center targets as they appear. |
| |
| {{:emulators:wii_tv_bad.jpg?400|Image showing how the regularly set-up IR bar is not good for Batocera.}} {{:emulators:wii_tv_good.jpg?400|The IR bar being set up correctly. The IR LEDs are normally invisible to the human eye, but can be seen by cameras.}} | ==== Ultimarc AimTrak recoil ==== |
| |
| [[:supported_controllers#wii_controllers|Connect the Wiimote directly as a regular Bluetooth device]]. A notification will appear indicating that the Wiimote has connected in its gun mode, with a little light gun icon appearing (if the theme supports it). Once connected, **press and hold the ''[Home]'' button for three seconds**. A target will appear in the center of the screen, aim the Wiimote at it from your neutral shooting position and press ''[B]''. Then a target will appear at the top-left; aim at that and press ''[B]'' again. | If using a recoil model, a separate power supply is required. This is **not** bundled with the light gun. More info can be found on its [[https://www.ultimarc.com/light-guns/aimtrak-light-gun/aim-trak-light-gun/|store page]]. Scroll to ''Recoil Power Requirement (Guns with recoil option only)'' section. |
| |
| If the second target cannot be shot at, move further away from the display and repeat the process from the start. It may also help to put the IR bar above the monitor instead of below. | ===== GUN4IR ===== |
| |
| <WRAP center round tip> | {{:emulators:gun4ir.png?200|GUN4IR light gun.}} {{:emulators:gun4ir_leds.png?200|Various IR LEDs needed for the GUN4IR.}} |
| Dolphin can emulate the pairing function of the emulated Wii system, allowing for direct connections to the Wiimote. This is independent of what Wiimote gun settings are used in EmulationStation. | |
| </WRAP> | |
| |
| ==== Mayflash Dolphinbar ==== | ==== GUN4IR setup ==== |
| |
| {{:emulators:wiigun.jpg?170|Wiimote in a gun-shaped holster.}} {{:emulators:dolphinbar.jpg?200|}} | For the time being, any custom and manual settings must be done inside Windows with GUN4IR tool and burned into the light gun. |
| |
| The [[https://www.mayflash.com/product/showproduct.php?id=6|Mayflash Dolphinbar]] is a third-party accessory that was initially designed to allow Wiimotes to be used as a cursor for PCs, or to allow for direct passthrough of the Wiimote to the Dolphin emulator (hence the colloquial name). Batocera can use it to emulate a light gun. | If you have the calibration button, press it and shoot all targets in turn. |
| | |
| Unlike the direct Wiimote connection method, modes 1 and 2 do not utilize any special Wiimote gun mode in EmulationStation to function, instead the Dolphinbar itself emulates being a mouse and keyboard to the machine. When in these modes, it does not allow for global calibration, meaning that it will not likely match your display one-to-one (just like the original Wii did). It is also the only available option for light gun play on **v34** and lower. | |
| | |
| Certain third-party remotes that don't work over native Bluetooth may work with the Dolphinbar, as it uses its own Bluetooth stack separate from the host machine. | |
| | |
| <WRAP center round important> | |
| Until recently, the Mayflash Dolphinbar could not be used as a regular IR sensor bar if intending to use the [[#direct_wiimote_with_ir_bar|direct Wiimote connection method]] since the LEDs shut down after some inactivity if no Wiimote is connected to it. A firmware update from [[https://forums.dolphin-emu.org/Thread-dolphinbar-and-bluetooth-passthrough|Mayflash]] is required to unlock a new mode by pressing and holding ''[MODE]'' on the Dolphinbar (as shown in this [[https://www.youtube.com/watch?v=g-P58zCYR9U|short tutorial]]). The LEDs will remain powered on for 4 hours before shutting down. It is possible to directly connect a Wiimote to the bar to use it regularly though. | |
| </WRAP> | |
| | |
| <WRAP center round tip> | |
| Dolphin can emulate the pairing function of the emulated Wii system, allowing for direct connections to the Wiimote. This is independent of what Wiimote gun settings are used in EmulationStation. | |
| </WRAP> | |
| | |
| ==== Mayflash Dolphinbar setup ==== | |
| | |
| The Mayflash Dolphinbar requires manual action, compared to other solutions which automate //most// of the process. Because of this, [[hardware:dolphinbar|it has its own page.]] | |
| |
| ===== Namco GunCon 2 ===== | ===== Namco GunCon 2 ===== |
| {{:emulators:gcon2_1.jpg?200|Original Namco GunCon 2.}} {{:emulators:toshiba_crt_tv.jpg?200|An old CRT TV.}} | {{:emulators:gcon2_1.jpg?200|Original Namco GunCon 2.}} {{:emulators:toshiba_crt_tv.jpg?200|An old CRT TV.}} |
| |
| The [[wp>GunCon|Namco GunCon]] (known as G-Con in Europe) is a PlayStation peripheral first released in 1994, with the GunCon 2 for the PlayStation 2 following it up in 2001. If you have a GunCon 2 and a compatible analogue TV, you may be able to utilise it with Batocera. <wrap em>This cannot be used on a modern digital display.</wrap> Requires Batocera **v36** or higher. | The [[wp>GunCon|Namco GunCon]] (known as G-Con in Europe) is a PlayStation peripheral first released in 1994, with the GunCon 2 for the PlayStation 2 following it up in 2001. If you have a GunCon 2 and a compatible analogue TV, you may be able to utilise it with Batocera. <wrap em>This cannot be used on a modern digital display.</wrap> |
| |
| ==== Namco GunCon 2 setup ==== | ==== Namco GunCon 2 setup ==== |
| |
| </WRAP> | </WRAP> |
| |
| |
| <code bash| GunCon2_Calibration.sh> | <code bash| GunCon2_Calibration.sh> |
| **V39:** to start calibration, press and hold ''B2'' button, then proceed to shoot each target. | **V39:** to start calibration, press and hold ''B2'' button, then proceed to shoot each target. |
| |
| **V40 or higher:** to start calibration, press and hold ''C2'' button. | **V40+** to start calibration, press and hold ''C2'' button. |
| ===== Ultimarc AimTrak ===== | |
| |
| {{:emulators:aimtrak.jpg?170|Aimtrak Light gun.}} {{:emulators:aimtrak_ir_bar.png?200|The Aimtrak IR bar, thicker than the Wii's IR bar.}} | ===== Retro Shooter Lightgun ===== |
| |
| The [[https://www.ultimarc.com/light-guns/aimtrak-light-gun/aim-trak-light-gun/|Ultimarc Aimtrak]] comes with its own IR bar which can be mounted on the top of or at the bottom of the display, much like the Wiimote. Requires Batocera **v35** or higher. | {{https://retroshooter.com/wp-content/uploads/2023/07/Retro-Shooter-guns.png?300|Retro Shooter Lightgun}} |
| |
| ==== Ultimarc AimTrak setup ==== | The [[https://www.retroshooter.com/|Retro Shooter]] comes with its own IR leds (two on older models; four since october 2023). They are mounted at top corners (2IR) or all four corners (4IR) of the display, similar to SAMCO and Fusion Lightgun. |
| |
| Connect both the light gun and the IR bar via USB. Then, hold main trigger for five seconds to launch the global calibration process. Shoot the top-left, top-right and bottom-center targets as they appear. | First model of Retro shooter requires Batocera **v39** minimum. |
| | RS3 Reaper model requires Batocera **v42** minimum. |
| |
| <WRAP center round info> | ==== Retro Shooter setup ==== |
| The calibration information is saved to the gun itself, so a recalibration may be required if moving to a different display. | |
| </WRAP> | |
| |
| ==== Ultimarc AimTrak recoil ==== | Place IR leds as shown below : |
| |
| If using a recoil model, a separate power supply is required. This is **not** bundled with the light gun. More info can be found on its [[https://www.ultimarc.com/light-guns/aimtrak-light-gun/aim-trak-light-gun/|store page]]. Scroll to ''Recoil Power Requirement (Guns with recoil option only)'' section. | {{:emulators:retroshooterir.png?800|}} |
| |
| ===== AE Lightgun ===== | To calibrate the light gun, press and hold 3 seconds the rear left button, then proceed on shooting target. Make sure you are far enough from your display and sunlight is out. If you are with 2IR leds, you need to double that distance. |
| |
| {{:emulators:aelightgun.jpg?250|AE Lightgun.}} | The light gun will reboot with updated values once calibration is done. |
| |
| The [[https://www.aelightgun.com/|AE Lightgun]] comes with its own IR bar which can be mounted on the top of or at the bottom of the display, much like the Wiimote and Ultimarc AimTrak. Requires Batocera **v35** or higher. | ==== Retro Shooter recoil ==== |
| |
| ==== AE Lightgun setup ==== | * To switch between single shot or automatic, press and hold stick button 3 seconds to change its mode. |
| | * To turn off the recoil, unplug the recoil cable or press and hold stick button while powering it. |
| Connect both the light gun and the IR bar via USB. Then, press the button in front of the main trigger to launch the global calibration process. Shoot the middle, top-right and bottom-left targets as they appear. | |
| |
| ===== Sinden Lightgun ===== | ===== Sinden Lightgun ===== |
| {{:emulators:sinden_options_1.png?400|}} {{:emulators:sinden_options_2.png?300|}} | {{:emulators:sinden_options_1.png?400|}} {{:emulators:sinden_options_2.png?300|}} |
| |
| ===== GUN4IR ===== | ===== Direct Wiimote gun with IR bar ===== |
| | <WRAP center round important 60%> |
| | Connection with Mayflash Dolphinbar in modes 1 and 2 is unsupported and obsolete. NOT RECOMMENDED. |
| | </WRAP> |
| |
| {{:emulators:gun4ir.png?200|GUN4IR light gun.}} {{:emulators:gun4ir_leds.png?200|Various IR LEDs needed for the GUN4IR.}} | {{:emulators:wiigun.jpg?170|Wiimote in a gun-shaped holster.}} {{:emulators:wiibar.jpg?250|USB-powered IR LED bar.}} |
| |
| ==== GUN4IR setup ==== | The Wii was revolutionary for its motion-based controls when it released back in 2006. This technology can now be used to emulate a light gun in Batocera, useful if you happen to have an old Wiimote and sensor bar laying around that is unused (though for convenience, buying a USB-powered sensor bar may be necessary). This is recommended over using the Mayflash Dolphinbar as the direct connection has far superior accuracy. This is a special mode for the Wiimote when connected to Batocera. This will be referred to as the Wiimote gun from now on. |
| |
| For the time being, any custom and manual settings must be done inside Windows with GUN4IR tool and burned into the light gun. | Unlike the direct Wiimote connection method, modes 1 and 2 do not utilize any special Wiimote gun mode in EmulationStation to function, instead the Dolphinbar itself emulates being a mouse and keyboard to the machine. You are unable to calibrate or use more than ''A'' and ''B'' buttons. However, if you wish to use your Mayflash Dolphinbar as a regular IR sensor bar in addition to your own BT module, a firmware update from [[https://forums.dolphin-emu.org/Thread-dolphinbar-and-bluetooth-passthrough|Mayflash]] is required to unlock a new mode by pressing and holding ''[MODE]'' on the Dolphinbar (as shown in this [[https://www.youtube.com/watch?v=g-P58zCYR9U|short tutorial]]). The LEDs will remain powered on for 4 hours before shutting down. |
| |
| If you have the calibration button, press it and shoot all targets in turn. | <WRAP center round alert> |
| | Most third-party remotes won't work as they don't respect the correct bluetooth connection process, requiring the Mayflash Dolphinbar Bluetooth module. |
| |
| ===== Retro Shooter Lightgun ===== | However, starting **v39**, you can enable the ''wiimote3rdparty'' service in ''SYSTEM SETTINGS'' → ''SERVICES'' to use your third-party wiimote. |
| | </WRAP> |
| |
| {{https://retroshooter.com/wp-content/uploads/2023/07/Retro-Shooter-guns.png?300|Retro Shooter Lightgun}} | ==== Direct Wiimote gun setup ==== |
| |
| The [[https://www.retroshooter.com/|Retro Shooter]] comes with its own IR leds (two on older models; four since october 2023). They are mounted at top corners (2IR) or all four corners (4IR) of the display, similar to SAMCO and Fusion Lightgun. | Set up the powered IR bar by taping over one side with solid tape and positioning the remaining LED at the bottom/top center of the display. Counter-intuitively, this setup works best when only one IR LED is visible (otherwise the cursor on-screen may "jump" when aiming at the edges). |
| |
| First model of Retro shooter requires Batocera **v39** minimum. | {{:emulators:wii_tv_bad.jpg?400|Image showing how the regularly set-up IR bar is not good for Batocera.}} {{:emulators:wii_tv_good.jpg?400|The IR bar being set up correctly. The IR LEDs are normally invisible to the human eye, but can be seen by cameras.}} |
| RS3 Reaper model requires Batocera **v42** minimum. | |
| |
| ==== Retro Shooter setup ==== | [[:supported_controllers#wii_controllers|Connect the Wiimote directly as a regular Bluetooth device]]. A notification will appear indicating that the Wiimote has connected in its gun mode, with a little light gun icon appearing (if the theme supports it). Once connected, **press and hold the ''[Home]'' button for three seconds**. A target will appear in the center of the screen, aim the Wiimote at it from your neutral shooting position and press ''[B]''. Then a target will appear at the top-left; aim at that and press ''[B]'' again. |
| |
| Place IR leds as shown below : | If the second target cannot be shot at, move further away from the display and repeat the process from the start. It may also help to put the IR bar above the monitor instead of below. |
| |
| {{:emulators:retroshooterir.png?800|}} | <WRAP center round tip> |
| | Dolphin can emulate the pairing function of the emulated Wii system, allowing for direct connections to the Wiimote. This is independent of what Wiimote gun settings are used in EmulationStation. |
| To calibrate the light gun, press and hold 3 seconds the rear left button, then proceed on shooting target. Make sure you are far enough from your display and sunlight is out. If you are with 2IR leds, you need to double that distance. | </WRAP> |
| | |
| The light gun will reboot with updated values once calibration is done. | |
| | |
| ==== Retro Shooter recoil ==== | |
| | |
| * To switch between single shot or automatic, press and hold stick button 3 seconds to change its mode. | |
| * To turn off the recoil, unplug the recoil cable or press and hold stick button while powering it. | |
| |
| ===== XGunner ===== | ===== XGunner ===== |
| | [[systems:atari7800|atari7800]] | mame | ✘ | | | | | | [[systems:atari7800|atari7800]] | mame | ✘ | | | | |
| | [[systems:atomiswave|atomiswave]] | retroarch/flycast | 35 | ✔ | ✔ | | | | [[systems:atomiswave|atomiswave]] | retroarch/flycast | 35 | ✔ | ✔ | | |
| | | flycast | 35 | ✔ | ✘ | Not out of the box, multiplayer unsupported for now | | | | flycast | 43 | ✔ | ✘ | Not out of the box, multiplayer unsupported for now | |
| | [[systems:c64|c64]] | libretro/vice_x64 | 35 | ✔ | | | | | [[systems:c64|c64]] | libretro/vice_x64 | 35 | ✔ | | | |
| | | vice/x64 | 35 | | ✔ | | | | | vice/x64 | 35 | | ✔ | | |
| | [[systems:singe|hypseus singe]] | hypseus singe | 35 | ✔ | ✘ | | | | [[systems:singe|hypseus singe]] | hypseus singe | 36 | ✔ | ✔ | | |
| | [[systems:dreamcast|dreamcast]] | retroarch/flycast | 35 | ✔ | ✔ | | | | [[systems:dreamcast|dreamcast]] | retroarch/flycast | 35 | ✔ | ✔ | | |
| | | redream | 35 | ✔ | ✘ | | | | | redream | 35 | ✔ | ✘ | | |
| | | flycast | 35 | ✔ | ✘ | Multiplayer unsupported for now | | | | flycast | 35 | ✔ | ✘ | Multiplayer unsupported for now | |
| | [[systems:gx4000|gx4000]] | retroarch/cap32 | 37 :!: | ✔ | | Supported but not out of the box | | | [[systems:gx4000|gx4000]] | retroarch/cap32 | 37 :!: | ✔ | | Supported but not out of the box | |
| | [[systems:lindbergh|lindbergh]] | lindbergh | 42 | ✘ | ✔ | | | | [[systems:lindbergh|lindbergh]] | lindbergh | 42 | 43 | ✔ | | |
| | [[systems:mastersystem|master system]] | retroarch/genesisplusgx | 35 | ✔ | :!: | ~((2P only with Gangster Town)) | | | [[systems:mastersystem|master system]] | retroarch/genesisplusgx | 35 | ✔ | :!: | ~((2P only with Gangster Town)) | |
| | [[systems:megadrive|megadrive]] | retroarch/genesisplusgx | 35 | ✔ | ✘ | | | | [[systems:megadrive|megadrive]] | retroarch/genesisplusgx | 35 | ✔ | ✘ | | |
| | [[systems:model2|model2]] | model2emu | 35 | ✔ | ✘ | Multiplayer unsupported for now | | | [[systems:model2|model2]] | model2emu | 37 | ✔ | ✘ | Multiplayer unsupported for now | |
| | [[systems:model3|model3]] | supermodel | 35 | ✔ | 37 | | | | [[systems:model3|model3]] | supermodel | 37 | ✔ | 37 | | |
| | [[systems:naomi|naomi]] | flycast | 35 | ✔ | ✘ | Multiplayer unsupported for now | | | [[systems:naomi|naomi]] | flycast | 35 | ✔ | ✘ | Multiplayer unsupported for now | |
| | | retroarch/flycast | 35 | ✔ | ✔ | | | | | retroarch/flycast | 35 | ✔ | ✔ | | |
| | [[systems:namco2x6|namco2x6]] | Play! | 35 | ✘ | ✘ | Namco 2x6 emulation is very early | | | [[systems:namco2x6|namco2x6]] | Play! | 43 | ✘ | ✘ | One light gun only | |
| | [[systems:nes|nes]] | retroarch/nestopia | 35 | ✔ | | | | | [[systems:nes|nes]] | retroarch/nestopia | 35 | ✔ | | | |
| | | retroarch/fceumm | 35 | ✔ | | | | | | retroarch/fceumm | 35 | ✔ | | | |
| | | retroarch/mesen | 35 | ✘ | | | | | | retroarch/mesen | 35 | ✘ | | | |
| | [[systems:psx|psx]] | duckstation | 40 | ✔ | ✘ | Multiplayer unsupported for now | | | [[systems:psx|psx]] | duckstation | 40 | ✔ | ✔ | | |
| | | retroarch/mednafenpsx | 35 :!: | ✘ | ✘ | Only works with software renderer | | | | retroarch/mednafenpsx | 35 :!: | ✘ | ✘ | Only works with software renderer | |
| | | retroarch/PCSXrearmed | 35 | 40 | ✔ | | | | | retroarch/PCSXrearmed | 35 | 40 | ✔ | | |
| | [[systems:saturn|saturn]] | retroarch/beetle-saturn | 35 | ✔ | ✔ | | | | [[systems:saturn|saturn]] | retroarch/beetle-saturn | 35 | ✔ | ✔ | | |
| | | retroarch/kronos | ✘ | | | | | | | retroarch/kronos | ✘ | | | | |
| | [[systems:segacd|segacd]] | retroarch/picodrive | ✘ | | | | | | [[systems:megacd|segacd]] | retroarch/picodrive | ✘ | | | | |
| | | retroarch/genesisplusgx | 35 | ✔ | | | | | | retroarch/genesisplusgx | 35 | ✔ | | | |
| | [[systems:snes|snes]] | retroarch/snes9x_next | ✘ | | | | | | [[systems:snes|snes]] | retroarch/snes9x_next | ✘ | | | | |
| | [[systems:steam|steam]] | steam | 35 | | ✘ | | | | [[systems:steam|steam]] | steam | 35 | | ✘ | | |
| | [[systems:wii|wii]] | dolphin | 36 | ✔ | ✔ | | | | [[systems:wii|wii]] | dolphin | 36 | ✔ | ✔ | | |
| | | retroarch/dolphin | ✘ | ✔ | :!: | //Kind of supported// but not out of the box | | | | retroarch/dolphin | 43 | ✔ | ✔ | | |
| | [[systems:windows|windows(wine)]] | wine/lutris | Untested | | ✘ | | | | [[systems:windows|windows(wine)]] | wine/lutris | Untested | | ✘ | | |
| | | wine/proton | 35 | | ✘ | | | | | wine/proton | ✘ | | ✘ | | |
| | [[systems:xbox|xbox]] | xemu | ✘ | | | | | | [[systems:xbox|xbox]] | xemu | ✘ | | | | |
| | [[systems:zxspectrum|zxspectrum]] | retroarch/fuse | ✘ | | | | | | [[systems:zxspectrum|zxspectrum]] | retroarch/fuse | ✘ | | | | |
| | Trigger | //BTN_LEFT// | FIRE | TRIGGER | TRIGGER | TRIGGER | TRIGGER | TRIGGER | Trigger | T | TRIGGER | B | TRIGGER | TRIGGER | | | Trigger | //BTN_LEFT// | FIRE | TRIGGER | TRIGGER | TRIGGER | TRIGGER | TRIGGER | Trigger | T | TRIGGER | B | TRIGGER | TRIGGER | |
| | Action | //BTN_RIGHT// | CURSOR | 1 | RELOAD | A/SPECIAL | SECONDARY | SECONDARY/B | C | MOVE (∼) | SECONDARY | A | RELOAD | RELOAD | | | Action | //BTN_RIGHT// | CURSOR | 1 | RELOAD | A/SPECIAL | SECONDARY | SECONDARY/B | C | MOVE (∼) | SECONDARY | A | RELOAD | RELOAD | |
| | Start | //BTN_MIDDLE// | TURBO | 2 | START | B/START | START | START | A | START | START | PLUS | COIN | COIN | | | Start | //BTN_MIDDLE// | TURBO | 2 | START | B/START | START | START | Start | START | START | PLUS | COIN | COIN | |
| | Select | //BTN_1// | PAUSE | PAUSE | | | COIN | COIN | B | CROSS (X) | COIN | MINUS | START | EVENT/START | | | Select | //BTN_1// | PAUSE | PAUSE | | | COIN | COIN | B | SELECT | COIN | MINUS | START | EVENT/START | |
| | SUB1 | //BTN_2// | | | | | | | Recalibrate shot | CIRCLE (O) | | 1 | | | | | SUB1 | //BTN_2// | | | | | | | Recalibrate shot | | | 1 | | | |
| | SUB2 | //BTN_3// | | | | | | | Start | | | 2 | | | | | SUB2 | //BTN_3// | | | | | | | A | | | 2 | | | |
| | SUB3 | //BTN_4// | | | | | | | Select | | | HOME | | | | | SUB3 | //BTN_4// | | | | | | | Select | | | HOME | | | |
| | Up | //BTN_5// | | | | | | D-Pad Up | D-Pad Up | TRIANGLE (△) | | D-Pad/Up | | | | | Up | //BTN_5// | | | | | | D-Pad Up | D-Pad Up | TRIANGLE (△) | | D-Pad/Up | | | |
| | Down | //BTN_6// | | | | | | D-Pad Down | D-Pad Down | SQUARE (□) | | D-Pad/Down | | | | | Down | //BTN_6// | | | | | | D-Pad Down | D-Pad Down | CROSS (X) | | D-Pad/Down | | | |
| | Left | //BTN_7// | | | | | | D-Pad Left | D-Pad Left | SELECT | | D-Pad/Left | | | | | Left | //BTN_7// | | | | | | D-Pad Left | D-Pad Left | SQUARE (□) | | D-Pad/Left | | | |
| | Right | //BTN_8// | | | | | | D-Pad Right | D-Pad Right | | | D-Pad/Right | | | | | Right | //BTN_8// | | | | | | D-Pad Right | D-Pad Right | CIRCLE (O) | | D-Pad/Right | | | |
| |
| ==== Default global mapping ==== | ==== Default global mapping ==== |
| |
| The current accuracy is not perfectly 1:1, caused by a fake and forced 4:3 ratio. This will be fixed in the future. | The current accuracy is not perfectly 1:1, caused by a fake and forced 4:3 ratio. This will be fixed in the future. |
| |
| === Redream === | |
| |
| Configure the emulator first (controller to Lightgun, map missing buttons) (FIXME how? step-by-step) | |
| |
| ==== Commodore 64 ==== | ==== Commodore 64 ==== |
| ==== Model 2 (model2emu) ==== | ==== Model 2 (model2emu) ==== |
| |
| <WRAP center round info> | Model2emu crosshair does not follow where the light gun is actually pointing. Keep it disabled to best accuracy. |
| If updating Batocera from a version previous to **v38**, it is mandatory to delete your ''/userdata/saves/model2'' folder. Model2emu package was rehauled and can't overwrite what's already existing. You might need to save any custom input located in ''/userdata/saves/model2/model2emu/CFG/''. | |
| </WRAP> | |
| | |
| By default, the crosshair is on in Batocera from v35 to v37. This crosshair does not follow where the light gun is actually pointing. | |
| | |
| To disable it, open ''/SHARE/saves/model2/model2emu/EMULATOR.ini'' and search for the line ''DrawCross = 1''. Change the value to ''0'' and save the file. | |
| | |
| <WRAP center round help> | |
| In Batocera **v35** to **v37**, default bezels are broken for the Sinden Lightgun for this emulator. This can be worked around: | |
| | |
| - If it is not done yet, run for the first time a model2 rom to download the required files. | |
| - Download the [[https://www.sindenwiki.org/wiki/Model2#Downloads|Model 2 Sinden Bezel Pack]]. | |
| - Open the archive file and extract ''artwork'' and ''scripts'' folders from either 720p or 1080p into ''/userdata/saves/model2/model2emu''. Overwrite existing files if prompted to do so. | |
| - Play! | |
| | |
| This is fixed in Batocera since v38. | |
| </WRAP> | |
| |
| ==== Model 3 (Supermodel) ==== | ==== Model 3 (Supermodel) ==== |
| |
| Supermodel white border for Sinden Lightguns is currently **disabled** on rpi4 and rpi5. This will be added in the future. | Supermodel white border for Sinden Lightguns is enabled on rpi4 and rpi5 starting v41. |
| |
| ==== PSX (all) ==== | ==== PSX (all) ==== |
| |
| Starting v39, all gun games are compatible with both Justifier and GunCon light gun controller type in PCSX-reARMed core. If a GunCon conversion patch was applied to the ROM, you will need to force GunCon controller type in EmulationStation. | Starting v39, all gun games are compatible with both Justifier and GunCon light gun controller type in PCSX-reARMed core. If a GunCon conversion patch was applied to the ROM, you will need to force GunCon controller type in EmulationStation. Starting v40, DuckStation is compatible with Justifier and GunCon light gun controller type. |
| | |
| In v35 to v38 however, all PSX emulators are only compatible with GunCon ROMs (with exception to libretro: mednafen, which should be compatible with all ROMs but a bug prevents the use of any light guns), so any non-GunCon ROMs require the Nuvee patch in order to function with light guns in the emulators: [[https://forums.pcsx2.net/Thread-Nuvee-PS1-PS2-input-plugin-supporting-lightguns-by-Shalma]]. Instructions are in the .7z file, respectively for each patchable ROM. | |
| | |
| Otherwise, light gun games with justifiers are playable with ''libretro: mednafen psx'' core, but need to have the following settings adjusted: | |
| | |
| - Open RetroArch quick menu with ''[HOTKEY]'' + {{:wiki:south.png?nolink&20|South button (B SNES)}} | |
| - Select **Core Options** | |
| - Change **Renderer (Restart Required)** to "Software" | |
| - Go back and select **Controls** option | |
| - In **Port # controls** change the **Device Type** to "Justifier" | |
| - Restart the game in the RetroArch quick menu | |
| |
| <WRAP center round important> | <WRAP center round important> |