Merge pull request #55 from misteraddons/main

Light gun info

Author: birdybro

docs/basics/faq.md

@@ -32,6 +32,16 @@ Yes, there are many USB adapters for original console controllers available, see
 
 Light guns such as the NES Zapper are too timing sensitive to work over USB, but will work fine on supported cores via the IO board as detailed below. 
 
+MiSTer supports several USB light guns, such as GunCon2, GunCon3, Gun4IR, Sinden, etc.
+
+GunCon2 requires a CRT and a way to tap into the sync signal. GunCon3, and Gun4IR work on all displays. Sinden requires a modern display and dedicated files for MiSTer.
+
+Reflex Adapt supports overclocked GunCon1, with better performance than GunCon2, when 1ms (1000Hz) polling is enabled.
+
+Each core requires calibration. Calibrate your guns from the distance you plan to play. For best results, use a white screen to calibrate.
+
+Never allow the calibration value to be less than 0. If you save a calibration with a negative value, it will likely cause the core to crash. To fix this, remove the core's light gun calibration file from the "config" folder of your MiSTer's micro SD card. 
+
 ## Any USB controller recommendations?
 
 Almost any controller that uses USB will work with MiSTer. You can also use a Bluetooth or 2.4ghz USB adapter for wireless. Good controllers that many users seem to like and have low input latency are:

docs/basics/hotkey.md

@@ -45,6 +45,18 @@ Some computer cores make use of the Windows key (++win++) on your keyboard.
 | ----------- | ------------ |
 | ++win+f12++ | Open the OSD |
 
+### Light gun cores
+
+Some consoles cores make use of USB/BT light guns, such as the Guncon2, Guncon3, Gun4IR, Sinden, etc.
+
+[Read this guide](./faq.md){target=_blank} for more information.
+
+[More calibration info here.](https://github.com/NolanNicholson/GunCon2-MiSTer?tab=readme-ov-file#calibration-instructions){target=_blank}
+
+| Hotkey             | Description                                                              |
+| ------------------ | ------------------------------------------------------------------------ |
+| OSD Open + ++f10++ | Enters light gun calibration. For best results, use a white/bright image |
+
 ### Cores that support savestates
 
 Very few cores support savestates (NES, PSX, GameBoy, GBA, WonderSwan, AtariLynx). There are 4 savestate slots available. In those cores there is a standard savestate button you can assign on your controller (we'll call that SaveStateBtn here):