Troubleshooting - Revision history

AdamB: Added demulshooter to output hooking

2025-10-14T18:26:43Z

Added demulshooter to output hooking

← Older revision		Revision as of 14:26, 14 October 2025
Line 38:		Line 38:

	=== Light Guns do not respond to HookOfTheReaper/MameHooker ===		=== Light Guns do not respond to HookOfTheReaper/MameHooker ===

			==== DemulShooter ====
			DemulShooter is used for most games/emulators to provide output data to HoTR and MameHooker. DemulShooter needs to be running and have properly "hooked" a game to provide the outputs that Hook of The Reaper/Mamehooker turn into feedback with your lightguns.

			Validate that DemulShooter is running and hooked properly by running a game and than minimizing it. In your system tray, if DemulShooter is red, than it is not hooking properly:
			[[File:Demulshooter not hooked.png\|none\|thumb]]
			If the icon does not change to green, the game is not hooking. The game may be using the wrong profile or the game may have known issues with hooking that are hard to automate around. Review the DemulShooter wiki or reach out to the Discord

	==== Hook Of The Reaper ====		==== Hook Of The Reaper ====

AdamB: Updating instructions

2025-10-02T03:31:08Z

Updating instructions

← Older revision		Revision as of 23:31, 1 October 2025
Line 22:		Line 22:
	# Right Click on any game and select Edit -> Edit metadata/media		# Right Click on any game and select Edit -> Edit metadata/media
	# In the window that appears, select Additional Apps[[File:Launchbox-Additional Apps.png\|none\|thumb]]		# In the window that appears, select Additional Apps[[File:Launchbox-Additional Apps.png\|none\|thumb]]
	~~ToDo - more here~~

	== Troubleshooting Tips ==		== Troubleshooting Tips ==
Line 54:		Line 53:

	==== MameHooker ====		==== MameHooker ====
	~~ToDo~~		MameHooker is a tool that takes output signals from a game to trigger additional effects on your light gun.

			It is triggered to run with games launched through the MameHooker system in Launchbox. It takes outputs and is configured by the automation tools to send commands to specific COM ports based on your config

			Double check that your COM ports are set correctly. If they are, than the automation tools may be missing your guns when running. Reach out to the discord to get help
	=== Light Gun aim is off ===		=== Light Gun aim is off ===
	Light Gun calibration is game independent. While your aim may be perfect in one game, it can be broken in others until you recalibrate the aim		Light Gun calibration is game independent. While your aim may be perfect in one game, it can be broken in others until you recalibrate the aim
Line 62:		Line 64:

	NOTE - Until emulator pages are populated, documenting common controls below<syntaxhighlight>		NOTE - Until emulator pages are populated, documenting common controls below<syntaxhighlight>
	~~ToDo~~		Sega Model 2 Games - hit F2 to open the system config menu, each game is different but navigate to a menu that looks similar to calibrate

			TeknoParrot - configured per game. Open TeknoParrot emulator, click a game and configure controls. Look for a setting like Test/Service/System. Set a key here and use it to open the games menu and navigate to the calibration

	~~Teknoparrot~~
	~~Sega~~
	</syntaxhighlight>		</syntaxhighlight>

Line 88:		Line 90:

	=== Game X Doesn't Work ===		=== Game X Doesn't Work ===
	~~todo~~		When a game doesnt work, couple things to try:


			# Try to run the game directly from the emulator in question, instead of from Launchbox. This validates if the game is working and not just a config issue in Launchbox
			# Validate that the files actually exist. Due to issues with Antivirus deleting files, files becoming corrupted during the extraction process, etc, not uncommon for the game to not exist
			# Validate if there is any commonality. Do other games from the same system (ie Model 2 games) work?
			# If there is any error output, reach out to the Discord

	=== When launching games I get an error ===		=== When launching games I get an error ===

AdamB: Reshade borders not showing with retroarch

2025-09-24T17:05:26Z

Reshade borders not showing with retroarch

← Older revision		Revision as of 13:05, 24 September 2025
Line 134:		Line 134:
	# Write up instructions on using bordeless gaming		# Write up instructions on using bordeless gaming

			=== Reshade Borders do not show when launching games using Retroarch ===
			You can manually force borders for retroarch if this is happening for you

			# Navigate to \Launchbox\Emulators\Retroarch\overlays\LightGunBezels
			# Backup the images_other folder (you can do that by moving the folder to a different location or zipping it in that same folder or renaming it).
			# It also also recommended to backup the images folder in that location as well.
			# Next go inside the images folder click into any platform there like "Arcade" and confirm that when opening one of the .png files that they have the white sinden border
			# If they do as long as \Launchbox\Emulators\Retroarch\overlays\LightGunBezels just has the images folder with the borders it should force retroarch to use those.
			# An important note if you use any new guns in the future this location would need to be restored to add support back for other lightguns

	== Known Issues ==		== Known Issues ==

AdamB: Formatting. Added both players controlled by player 1

2025-09-03T05:55:30Z

Formatting. Added both players controlled by player 1

@@ Line 52: / Line 52: @@
 You can manually try adding or editing a light gun by selecting the appropriate option in the system tray icon.
 === Light Gun aim is off ===
@@ Line 64: / Line 67: @@
 Sega
 </syntaxhighlight>
 === Games have a white border around them ===

AdamB: Fixing spelling

2025-09-03T05:35:41Z

Fixing spelling

← Older revision		Revision as of 01:35, 3 September 2025
Line 30:		Line 30:

	Verify that your light gun is detected and acts as a standard mouse in Windows - aiming your light gun should move the mouse to the correct location. If this does not work, start with troubleshooting the light gun itself.		Verify that your light gun is detected and acts as a standard mouse in Windows - aiming your light gun should move the mouse to the correct location. If this does not work, start with troubleshooting the light gun itself.

	A subset of games means the general config is working, but generally one of the tools or emulators has not responded to the automation. See if you can find a commonality between the games that do not work.

	==== DemulShooter ====		==== DemulShooter ====

AdamB: Added a lot of info

2025-09-03T05:33:54Z

Added a lot of info

← Older revision		Revision as of 01:33, 3 September 2025
Line 7:		Line 7:

	* Setup.exe - Installs required software (such as AutoHotKey) and does an initial run of some games to generate required files		* Setup.exe - Installs required software (such as AutoHotKey) and does an initial run of some games to generate required files
	* SetMameHooker/SetHookofTheReaper - Configures the specific app (such as setting player assignments in Hook of the Reaper) and sets the ''Start Mamehooker ~~value~~'' (This name is used for both .exe's, but does not affect the software run) in ~~Launchboxes additional app~~'s to run the specific software		* SetMameHooker/SetHookofTheReaper - Configures the specific app (such as setting player assignments in Hook of the Reaper) and sets the ''Start Mamehooker'' value (This name is used for both .exe's, but does not affect the software run) in Launchbox's Additional App menu to run the specific software
	* Launchbox - Games are sorted and configured to run based on their platform (~~ie.~~ what emulator they use)		* Launchbox - Games are sorted and configured to run based on their platform (which in general can help to determine what emulator they use)
	* Launchbox - Contains a set of scripts/.exe files that runs before a game launches (to configure/set states) and after a game exits (to return everything back to the default state)		* Launchbox - Contains a set of scripts/.exe files that runs before a game launches (to configure/set states) and after a game exits (to return everything back to the default state)
			* The capabilities of the game and emulation determines what additional tools/modifications are used. These include tools like demulshooter, which enables emulators to use raw input devices

	=== Navigate Launchbox ===		=== Navigate Launchbox ===
Line 17:		Line 18:
	# In the window that appears, select Launching - This shows which rom is being run and its relative path location		# In the window that appears, select Launching - This shows which rom is being run and its relative path location
	# Select Launching -> Emulation - This shows which emulator is running the game		# Select Launching -> Emulation - This shows which emulator is running the game
	~~When troubleshooting it can be helpful to try launching the game directly from the emulator to narrow down where the issue is~~

	Launchbox is configured to run a set of scripts or .exe files with each game to change settings, enable features, etc. You can see what is configured to run by:		Launchbox is configured to run a set of scripts or .exe files with each game to change settings, enable features, etc. You can see what is configured to run by:

	# Right Click on any game and select Edit -> Edit metadata/media		# Right Click on any game and select Edit -> Edit metadata/media
	# In the window that appears, select Additional Apps[[File:Launchbox-Additional Apps.png\|none\|thumb]]		# In the window that appears, select Additional Apps[[File:Launchbox-Additional Apps.png\|none\|thumb]]
			ToDo - more here

			== Troubleshooting Tips ==

	=== ~~Narrow Down the Problem~~ ===		=== Light Guns do not respond to moving/aiming ===
			Most light guns by default act as a HID device (the same as a computer mouse). They provide ''raw data''. Some light guns have a secondary mode that acts as a Direct Input device (the same as a standard game controller).

	~~== Troubleshooting Tips ==~~		Verify that your light gun is detected and acts as a standard mouse in Windows - aiming your light gun should move the mouse to the correct location. If this does not work, start with troubleshooting the light gun itself.

	~~=== Light Guns do~~ not ~~move/aim/respond~~ to ~~pulling~~ the ~~trigger ===~~		A subset of games means the general config is working, but generally one of the tools or emulators has not responded to the automation. See if you can find a commonality between the games that do not work.
	~~ToDo~~

			==== DemulShooter ====
			DemulShooter is a tool used to interface with emulators that do not support raw input by default. You can see the list of games and emulators supported [https://github.com/argonlefou/DemulShooter/wiki here!]

			We can validate that it is configured correctly by running the GUI version located here: \install location\Launchbox\Emulators\DemulShooter\DemulShooter_GUI.exe
			[[File:DemulShooter GUI.png\|none\|thumb]]
			Start with the P1 Configuration. Validate that the P1 Device is populated with your Light Gun. Click the drop down to select a different device and save the config. Repeat for any additional guns (P2 - P4)

	=== Light Guns do not respond to HookOfTheReaper/MameHooker ===		=== Light Guns do not respond to HookOfTheReaper/MameHooker ===
	~~ToDo~~

			==== Hook Of The Reaper ====
			Hook Of the Reaper is a tool that takes output signals from a game to trigger additional effects on your light gun. You can read about it here!

			Validate that it is configured correctly by running the tool located here: \Launchbox\Emulators\Hook Of The Reaper\HookOfTheReaper.exe

			The software starts minimized in your system tray. Right click on the icon and select Player Assignment:
			[[File:Hookofthereaper system tray.png\|none\|thumb]]
			Validate that the light guns you are using show up in the correct player slots:
			[[File:Hookofthereaper Player Assignments.png\|none\|thumb]]
			If not select the drop down, and select your light gun. If your light gun does not show in the drop down, some part of the build automation has failed.

			You can manually try adding or editing a light gun by selecting the appropriate option in the system tray icon.

	=== Light Gun aim is off ===		=== Light Gun aim is off ===
Line 42:		Line 59:

	How to calibrate is Emulator or Game Specific. Navigate to the appropriate Emulator or Game page to find specific instructions on how to re-calibrate the aim		How to calibrate is Emulator or Game Specific. Navigate to the appropriate Emulator or Game page to find specific instructions on how to re-calibrate the aim

			NOTE - Until emulator pages are populated, documenting common controls below<syntaxhighlight>
			ToDo

			Teknoparrot
			Sega
			</syntaxhighlight>

	=== Games have a white border around them ===		=== Games have a white border around them ===
Line 78:		Line 102:
	# Scroll down until you see WMIC. Check the box next to it and Click Next		# Scroll down until you see WMIC. Check the box next to it and Click Next
	# Confirm your selection in the next window by clicking Add		# Confirm your selection in the next window by clicking Add



	=== Game Doesnt Run Fullscreen ===		=== Game Doesnt Run Fullscreen ===

AdamB: More troubleshooting guide

2025-09-02T19:32:14Z

More troubleshooting guide

← Older revision		Revision as of 15:32, 2 September 2025
Line 17:		Line 17:
	# In the window that appears, select Launching - This shows which rom is being run and its relative path location		# In the window that appears, select Launching - This shows which rom is being run and its relative path location
	# Select Launching -> Emulation - This shows which emulator is running the game		# Select Launching -> Emulation - This shows which emulator is running the game
			When troubleshooting it can be helpful to try launching the game directly from the emulator to narrow down where the issue is

	Launchbox is configured to run a set of scripts or .exe files with each game to change settings, enable features, etc. You can see what is configured to run by:		Launchbox is configured to run a set of scripts or .exe files with each game to change settings, enable features, etc. You can see what is configured to run by:
Line 22:		Line 23:
	# Right Click on any game and select Edit -> Edit metadata/media		# Right Click on any game and select Edit -> Edit metadata/media
	# In the window that appears, select Additional Apps[[File:Launchbox-Additional Apps.png\|none\|thumb]]		# In the window that appears, select Additional Apps[[File:Launchbox-Additional Apps.png\|none\|thumb]]

			=== Narrow Down the Problem ===

	== Troubleshooting Tips ==		== Troubleshooting Tips ==

AdamB: Start of troubleshooting guide

2025-09-02T19:01:13Z

Start of troubleshooting guide

@@ Line 1: / Line 1: @@
-TODO - write a general guide on troubleshooting - how games launch - what tools do - etc
+To start troubleshooting, it is helpful to have a general understanding of what the automation is doing and how the build works. Understanding what scripts and tools should be running, ensuring they are configured correctly, all helps to find the problem
 == Troubleshooting Tips ==
@@ Line 58: / Line 80: @@
 === Game Doesnt Run Fullscreen ===
 When you run a game, the game doesnt fill the screen
 There are a wide range of emulators and games with individual settings and compatibility issues, Some of which are outside the scope of this build to fix. Common solutions are listed below

AdamB at 06:17, 31 August 2025

2025-08-31T06:17:15Z

← Older revision		Revision as of 02:17, 31 August 2025
Line 1:		Line 1:
			TODO - write a general guide on troubleshooting - how games launch - what tools do - etc

	== Troubleshooting Tips ==		== Troubleshooting Tips ==

AdamB: teknoparrot.dll error

2025-08-31T06:13:30Z

teknoparrot.dll error

← Older revision		Revision as of 02:13, 31 August 2025
Line 33:		Line 33:
	[[File:RPCS3 Fatal Error.png\|none\|thumb]]		[[File:RPCS3 Fatal Error.png\|none\|thumb]]

			==== Teknoparrot.dll Serial has expired ====
			When running games that use the Teknoparrot emulator, you see: (need to grab image)

			To play these games, you need a active subscription to Teknoparrot. You can purchase a subscription from the Teknoparrot website or wait for the dev team to make the game free.

	=== When exiting games I get an error ===		=== When exiting games I get an error ===