Difference between revisions of "Dolphin"

From Sinden Lightgun
Jump to navigation Jump to search
(Format contents headings)
 
(44 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{emuinfobox
+
'''''Dolphin''''' is a GameCube and Wii emulator first developed as closed source in 2003, and as open source since 2008.{{emuinfobox
 
|title = Dolphin
 
|title = Dolphin
 
|logo = dolphin_logo1.png
 
|logo = dolphin_logo1.png
Line 10: Line 10:
 
}}  
 
}}  
  
=Download=
+
==Download==
First Download and extract the zip file for the latest Dolphin beta from the official site. [https://dolphin-emu.org/download/ Dolphin website]
+
Download the latest Dolphin beta version zip file from the [https://dolphin-emu.org/download/ Dolphin website]
  
''Please note that you will want to download the latest Beta NOT the latest stable versions as they are very out of date!''
+
''Please note that you will want to download the latest Beta version and NOT the latest stable versions which are very out of date.''
  
=Limitations=
+
==Limitations==
** Sadly, there are no lightgun games for Gamecube, but there are some for the Wii!
+
* There are no lightgun games for the Gamecube, but there are some for the Wii.
** As of making this video, I cannot enable 2x lightguns for 2-player action. Hopefully, that will change in the not-so-distant future, and I will do an update video then :)
+
* The latest versions of Dolphin only support 1 lightgun.
 +
* The older stable Dolphin v5.0 supports 2 lightguns using additional 3rd-party apps. See [[Dolphin#Dolphin_2-Player_Setup|'''guide below''']].
  
=Installation=
+
==Installation==
Simply extract the file to a location of your choice and double click the <code>Dolphin.exe</code> to load it up.
+
Extract the downloaded Dolphin zip file into a folder of your choosing. (eg. D:\Dolphin)
  
==Portable Install==
+
====Portable Install====
If you don't want to have the user files in '''Windows>User folder''' you can create a text file in the '''Dolphin folder''' and name it to <code>portable.txt</code>  
+
Create a blank text file inside of the '''Dolphin folder''' (where Dolphin.exe is located) and name it <code>portable.txt</code> (eg. D:\Dolphin\portable.txt)
  
The user folder will then be generated in the root of Dolphin.  
+
* This MUST be done prior to launching Dolphin.exe for the 1st time.
 +
** If you launch Dolphin.exe without the portable.txt file present, the user config folder will be created in the Windows Documents folder.  The portable install method will no longer work and you will have to start over.
 +
* The user config folder will be generated inside of the root of the Dolphin folder.
 +
* Having that file in there tells Dolphin it's a portable version and can be moved between systems. ''(Thanks to Gigapig for this tip!)'' <br>
 +
 
 +
Double-click the <code>Dolphin.exe</code> file to launch the emulator.
 +
 
 +
* Download & install the latest Visual C++ Redistributable (x64) if you receive error messages stating that VC_.dll files are missing.
 +
* Select “No” for the ''Allow Usage Statistics Reporting'' popup message.
 +
 
 +
==Settings==
 +
The following are common settings.  The rest are dependent on your personal preferences and on your hardware.  Set them accordingly.
 +
 
 +
===Import Games===
 +
Create a roms folder and place the Wii games inside  (eg. D:\Dolphin\roms)
 +
 
 +
* [https://dolphin-emu.org/docs/faq/#what-dump-formats-are-supported-dolphin Supported file types:] iso, ciso, gcm, gcz, rvz, wad, wbfs.
 +
 
 +
Double-click and point to the game directory (roms folder).  Your Wii games should now be listed.
 +
[[File:Dolphin1.png|none|thumb]]
 +
 
 +
=== Configuration ===
 +
'''Config'''  > ''Interface'' > Mouse Cursor Visibility = ''Never''
 +
[[File:Dolphin2.png|none|thumb]]
 +
 
 +
=== Graphics Settings ===
 +
'''Graphics''' > ''General'' > Enable ''Start in Fullscreen''
 +
 
 +
* <u>Note</u>: You can use [[Reshade|'''ReShade''']] to apply a border if you have issues with the Sinden border showing on top. Use a ReShade API that matches the ''Backend'' setting.
 +
 
 +
'''Advanced''' > Enable ''Borderless Fullscreen'' (allows the Sinden border to show on top)
 +
[[File:Dolphin3.png|none|thumb]]
 +
 
 +
=== Controls ===
 +
'''Controllers''' (icon):
 +
 
 +
* Enable ''Background Input''
 +
* Set Wii Remote 1 = ''Emulatated Wii Remote'' and click on ''Configure'' button.
 +
 
 +
'''Map the Buttons'''
 +
 
 +
* Button B = Click 0 ''(left mouse button)''
 +
* Button A = Click 1 ''(right mouse button)''
 +
* Click on ''Save'' after you finish mapping the buttons.
 +
* '''<u>Note</u>:'''  Each game has it's own button layout.  Refer to the game's manual and map the buttons accordingly.
 +
 
 +
[[File:Dolphin4.png|none|thumb]]
 +
 
 +
== Sample AHK Script ==
 +
<syntaxhighlight lang="ahk">
 +
#NoEnv  ; Recommended for performance and compatibility with future AutoHotkey releases.
 +
; #Warn  ; Enable warnings to assist with detecting common errors.
 +
SendMode Input  ; Recommended for new scripts due to its superior speed and reliability.
 +
SetWorkingDir %A_ScriptDir%  ; Ensures a consistent starting directory.
 +
 
 +
#SingleInstance Force
 +
 
 +
Run, "D:\Dolphin\Dolphin.exe" "D:\Dolphin\roms\Ghost Squad (USA).wbfs"
 +
 
 +
~Esc:: 
 +
    Process,Close,Dolphin.exe
 +
    Run,taskkill /im "Dolphin.exe" /F
 +
    ExitApp
 +
return
 +
</syntaxhighlight>
 +
 
 +
==Accuracy Settings==
 +
If you want to improve the accuracy of your aim and remove crosshairs, Prof_gLX, PiperCalls, Ego_Bizarro and Tovarichtch has made a pack of ini files you can download with instructions from [https://github.com/ProfgLX/Sinden-Dolphin-Accuracy-Inis Prof_gLX's GitHub page]
 +
 
 +
'''<u>Note</u>''': USA versions of Wii games are required.
 +
 
 +
===Demo Video===
 +
<youtube>https://youtu.be/MEse3czKi-Q</youtube>
  
So having that file in there tells Dolphin it's a portable version and can be moved between systems. ''(Thanks to Gigapig for this tip!)''
 
 
<br>
 
<br>
  
=Configuration=
+
== Dolphin 2-Player Setup ==
==Import Games==
+
 
The first configuration step is to add your game files, they need to be in ISO format and to add them you do the following:
+
=== Required Files ===
 +
Download the older [https://dl-mirror.dolphin-emu.org/5.0/dolphin-x64-5.0.exe Stable Version Dolphin 5.0]
 +
 
 +
* This method will '''only work''' with the older Dolphin 5.0 stable version.
 +
* ''Aim Accuracy Pack'' will '''not work''' with this version of Dolphin.
 +
* Games must be in the wbfs or wad file formats.
 +
 
 +
Download [https://www.rewasd.com/ reWASD] with ''Advanced Mapping'' add-on feature.
 +
 
 +
Download DemulShooter from [https://github.com/argonlefou/DemulShooter/releases Argonlefu’s GitHub].
 +
* Follow the [[Demulshooter|'''DemulShooter wiki''']] and configure your lightguns if you do not already have it installed.
 +
 
 +
=== Dolphin v5.0 ===
 +
1 - Extract the Dolphin v5.0 zip file into a folder of your choosing.
 +
 
 +
2 - Create a blank text file inside of the Dolphin folder and name it <code>portable.txt</code>.
 +
 
 +
3 - Launch Dolphin 5.0 and follow the [[Dolphin#Installation|'''guide above''']] to setup & configure the emulator.
 +
 
 +
* DemulShooter requires the following Graphics Settings:
 +
** ''Options'' > '''''Graphics Settings'''''
 +
** Aspect Ratio = Stretch to Window
 +
** Use Fullscreen = Enabled (checked)
 +
** Render to Window = Enabled (checked)
 +
 
 +
[[File:Dolphin5.0 GraphicsSettings.png|none|thumb]]
 +
4 - Configure the Buttons for P1 and P2 lightguns.
 +
* These buttons configurations are meant to get you up and running and will not work for all games.  Each game has their own button layout.  You can change later them to suit your preferences.
 +
 
 +
* '''NOTE:''' DemulShooter maps the P2 mouse buttons to keyboard keys.  These keys (instead of mouse clicks) must be mapped for P2 in Dolphin. The default keys can be found in DemulShooter's<span style="font-family:Courier;"> config.ini </span>file.<syntaxhighlight lang="batch">
 +
;Dolphin Keyboard keys configuration for P2 buttons
 +
DOLPHIN_P2_LCLICK = DIK_S
 +
DOLPHIN_P2_MCLICK = DIK_D
 +
DOLPHIN_P2_RCLICK = DIK_F
 +
</syntaxhighlight>
 +
 
 +
* Click on the '''''Controllers''''' icon.
 +
* Set Wiimote 1 and Wiimote 2 to ''Emulated Wiimote'' and click OK.
 +
** The <code>WiimoteNew.ini</code> file will be generated in the User\Config file folder.
 +
** D:\Dolphin\User\Config\WiimoteNew.ini
 +
 
 +
[[File:Dolphin5.0-1.png|none|thumb]]
 +
 
 +
* Close Dolphin and open the <code>WiimoteNew.ini</code> file.
 +
* Copy and paste the following into the <code>WiimoteNew.ini</code> file, overwriting all of the existing configs.
 +
* Then click on ''File'' > ''Save''.
 +
<syntaxhighlight lang="ini">
 +
[Wiimote1]
 +
Device = DInput/0/Keyboard Mouse
 +
Source = 1
 +
Buttons/A = `Click 1`
 +
Buttons/B = `Click 0`
 +
Buttons/1 = SPACE
 +
Buttons/2 = RETURN
 +
Buttons/- = `5`
 +
Buttons/+ = `1`
 +
IR/Up = `Cursor Y-`
 +
IR/Down = `Cursor Y+`
 +
IR/Left = `Cursor X-`
 +
IR/Right = `Cursor X+`
 +
Swing/Down = `Click 2`
 +
Extension = Nunchuk
 +
Nunchuk/Buttons/C = `C`
 +
Nunchuk/Buttons/Z = `Z`
 +
D-Pad/Up = UP
 +
D-Pad/Down = DOWN
 +
D-Pad/Left = LEFT
 +
D-Pad/Right = RIGHT
 +
[Wiimote2]
 +
Device = DInput/0/Keyboard Mouse
 +
Source = 1
 +
Buttons/A = F
 +
Buttons/B = S
 +
Buttons/1 = SPACE
 +
Buttons/2 = RETURN
 +
Buttons/- = `6`
 +
Buttons/+ = `2`
 +
IR/Up = `DInput/0/Wireless Controller:Axis Y-`
 +
IR/Down = `DInput/0/Wireless Controller:Axis Y+`
 +
IR/Left = `DInput/0/Wireless Controller:Axis X-`
 +
IR/Right = `DInput/0/Wireless Controller:Axis X+`
 +
Swing/Down = D
 +
Extension = Nunchuk
 +
Nunchuk/Buttons/C = `C`
 +
Nunchuk/Buttons/Z = `Z`
 +
D-Pad/Up = UP
 +
D-Pad/Down = DOWN
 +
D-Pad/Left = LEFT
 +
D-Pad/Right = RIGHT
 +
[Wiimote3]
 +
Source = 0
 +
[Wiimote4]
 +
Source = 0
 +
[BalanceBoard]
 +
Source = 0
 +
</syntaxhighlight>
 +
 
 +
 
 +
5 - Launch Dolphin and test P1 Lightgun with a game to ensure that you have properly configured Dolphin.
 +
 
 +
* '''NOTE:'''  Make sure that Lightgun 1 works before moving on to setting up reWASD.
 +
 
 +
=== reWASD ===
 +
 
 +
 
 +
1 - Unplug P1 Lightgun and '''ONLY''' have P2 Lightgun plugged in.
 +
 
 +
2 - Launch reWASD.
 +
 
 +
* Select your P2 Lightgun from one of the devices at the bottom of the screen.
 +
* Select ''Gaming keyboard or Keyboard with touchpad'' and click on '''Submit'''.
 +
[[File:ReWASD1.png|none|thumb]]
 +
 
 +
 
 +
3 - Click on ''Fortnite'' and delete all if the existing button mappings by clicking on “X”.
 +
[[File:ReWASD2.png|none|thumb]]
 +
 
 +
 
 +
4 - Click on the ''Add'' button to create a new dummy button mapping. 
 +
 
 +
* At least 1 button mapping is required.  
 +
* This guide maps “CapsLock” to “CapsLock”.
 +
* After mapping CapsLock, click on the ''Apply to Slot 1'' button.
 +
 
 +
[[File:ReWASD3.png|none|thumb]]
 +
 
 +
 
 +
5 - Select “No” if you get the pop-up warning message to ''mute the native behavior of the control''.
 +
[[File:ReWASD4.jpg|none|thumb]]
 +
 
 +
 
 +
6 - Click on the “Eye” icon and then click on the ''Mouse'' icon.
 +
 
 +
* Click on the Direction icon on the mouse and map it to “Left Stick”.
 +
* Click on ''Apply to Slot 1''.
 +
 
 +
[[File:ReWASD5.png|none|thumb]]
 +
 
 +
 
 +
7 - Click on the Sony PlayStation icon at the top of the screen and make sure this option is set to “Virtual DS4”.
 +
[[File:ReWASD6.png|none|thumb]]
 +
 
 +
 
 +
8 - Verify that reWASD is working.
 +
 
 +
* Plug in both P1 & P2 Lightguns and launch Dolphin.  Make sure reWASD is running in the background.
 +
* Click on the ''Controllers'' icon and then click on the Wiimote 1 ''Configure'' button.
 +
* <span style="font-family:Courier;">DInput/0/Wireless Controller </span>should show up on the Device pulldown list which indicates that reWASD is working.
 +
* Take note of the order that<span style="font-family:Courier;"> DInput/0/Wireless Controller </span>is listed, which will be used in the DemulShooter script.
 +
* Only one<span style="font-family:Courier;"> DInput/0/Wireless Controller </span>will be shown in the Device pulldown list.  If it is missing, go back and reconfigure reWASD.
 +
 
 +
[[File:Dolphin5.0-2.png|none|thumb]]
 +
 
  
You will see a message saying to click to point to game directory, Click that message and set it to the folder where you are storing your games.
+
9 - '''DemulShooter Script:'''
  
The emulator will then automatically load the games you have in the location.
+
* The [[Demulshooter|DemulShooter]] script will change depending on the order that the<span style="font-family:Courier;"> DInput/0/Wireless Controller </span>shows up in Dolphin’s device list.  Change the <code>-ddinumber</code> in your script accordingly.
 +
* <span style="font-family:Courier;">DInput/0/Wireless Controller </span>shows up '''4th''' on the list in the picture above.
 +
* The DemulShooter script should then be: <code>Run, DemulShooter.exe -target=dolphin5 -ddinumber='''<big>4</big>'''</code>
 +
* Launch the game and [[Demulshooter|DemulShooter]] with an [[AHK|AutoHotKey (AHK)]] script.
 +
*If you have issues with DemulShooter hooking (green icon in the system tray), make sure that DemulShooter.exe is set to run as [https://github.com/argonlefou/DemulShooter/wiki/Usage#warning- Administrator].
  
If you need to rescan for games added later you can by pressing the "Refresh" button at the top of the screen.
+
=== Sample AHK Script ===
 +
<syntaxhighlight lang="ahk">
 +
#NoEnv  ; Recommended for performance and compatibility with future AutoHotkey releases.
 +
; #Warn  ; Enable warnings to assist with detecting common errors.
 +
SendMode Input  ; Recommended for new scripts due to its superior speed and reliability.
 +
SetWorkingDir %A_ScriptDir%  ; Ensures a consistent starting directory.
  
==Graphics==
+
#SingleInstance Force
  
Next you need to set your Graphics settings, To do this you can select the "Graphics" button on the top menu.
+
Run, "D:\Demulshooter\DemulShooter.exe" -target=dolphin5 -ddinumber=4
 +
sleep, 3000
  
This emulator can be demanding so its hard to recommend settings that will suit everyone so it is best to play with settings to see what will work best for you.
+
Run, "D:\Dolphin\Dolphin.exe" /b /e "D:\Dolphin\roms\Ghost Squad (USA).wbfs"
  
Make use of the FPS counter in the settings bellow which you can turn on or off to help tune your settings.
+
~Esc:: 
 +
    Process,Close,Dolphin.exe
 +
    Run,taskkill /im "Dolphin.exe" /F
 +
    sleep, 500
 +
    ExitApp
 +
return
 +
</syntaxhighlight>
  
Aspect Ratio should be set to "stretch to window" make sure to enable the "use fullscreen" tick box and lastly make sure "render to main window" is enabled.
+
=== Optional: Creating Game-Specific Button Configurations ===
 +
Each Wii game has it’s own button layout.  Refer to the game’s user manual or menu settings.
  
On the "Enhancements" tab along the top you can further tune your graphical settings if desred including upping resolutions and enabling anti aliasing.
+
This section will show you how to create game-specific button mapping configs.
  
Once done you can press the "Close" button in the bottom corner.
 
  
==Controls==
+
Click on the ''Controllers'' icon and then click on the Wiimote 1 ''Configure'' button.
  
Now you can setup the controller, to do so first click the "controllers" button along the top menu.
+
* Set the Device = Dinput/0/Keyboard Mouse
 +
* Map the player 1 buttons.
 +
* Type in the name the Profile = GHOSTSQUAD_P1
 +
* Click on the ''Save'' button and then click on OK.
  
Set all gamecube controllers to "None".
+
[[File:Dolphin5.0-3.png|none|thumb]]
  
Under Wii Remotes make sure the "emulate wii's bluetooth adapter" option is selected then next to "Wii Remote 1" select "emulated wii remote" from the drop down.
 
  
 +
Click on the ''Controllers'' icon and then click on the Wiimote 2 ''Configure'' button.
  
Next press the "Configure" button to setup the button mappings.
+
* Set the Device = Dinput/0/Keyboard Mouse
 +
* Map the player 2 buttons.  (Demulshooter sets LMouse = S, MMouse = D, RMouse = F)
 +
* Type in the name the Profile = GHOSTSQUAD_P2
 +
* Click on the ''Save'' button and then click on OK.
  
Set button "A" to Click 1
+
[[File:Dolphin5.0-4.png|none|thumb]]
  
Set Button "B" to Click 0
 
  
The other buttons you can set to any button you wish by clicking on the grey button next to it and then pressing the button you want to map it to.
+
Right click on Ghost Squad and select ''Properties''.
  
 +
* In the GameConfig tab, click on ''Edit Config'' and type in the following, and the click on ''File'' > ''Save''.
 +
<syntaxhighlight lang="batch">
 +
[Controls]
 +
WiimoteProfile1 = GHOSTSQUAD_P1
 +
WiimoteProfile2 = GHOSTSQUAD_P2
 +
</syntaxhighlight>Ghost Squad will now load with the P1 and P2 button mappings.
 +
[[File:Dolphin5.0-5.png|none|thumb]]
  
Once you have configured them how you wish Press the Close button on this screen and the previous one to return back to the main screen of dolphin.
+
=== Troubleshooting:  LaunchBox / BigBox Conflict ===
 +
reWASD may conflict with LaunchBox/BigBox, causing LB/BB to freeze.
  
==Hide Mouse Cursor==
+
This is a workaround to launch and close reWASD using an AHK script.
  
Next we are going to hide the mouse cursor while playing.
+
* Press CTRL+SHIFT+ESC to open the ''Task Manager''.
 +
* Go to the ''Startup'' tab and right-click on reWASD and select ''Disable''.
  
To do the press the "Config" Button on the main menu and then select the "interface" tab.
+
[[File:ReWASDTaskManager.png|none|thumb]]
  
At the bottom you will see a option to "always hide mouse cursor" just make sure that's enabled.
 
  
That's it! You can now run a game from the selection and play!
+
'''Sample AHK Script to Launch & Close reWASD:'''
  
 +
''If you have issues closing reWASD, compile the script and run as Administrator.''<syntaxhighlight lang="ahk">
 +
#NoEnv  ; Recommended for performance and compatibility with future AutoHotkey releases.
 +
; #Warn  ; Enable warnings to assist with detecting common errors.
 +
SendMode Input  ; Recommended for new scripts due to its superior speed and reliability.
 +
SetWorkingDir %A_ScriptDir%  ; Ensures a consistent starting directory.
  
=Accuracy Settings=
+
#SingleInstance Force
If you want to improve the accuracy of your games and remove crosshairs easily, PiperCalls and Prof_gLX made a pack of ini files you can download with instructions from [https://github.com/ProfgLX/Sinden-Dolphin-Accuracy-Inis Prof_gLX's GitHub page]
 
  
After applying the ''Aim Accuracy Pack'', fine-tune your aim for each game using these [https://raw.githubusercontent.com/ProfgLX/Sinden-Dolphin-Accuracy-Inis/main/Dolphin_Aim_Enhancement_Adjustments.txt instructions].
+
Run, D:\reWASD\reWASD.exe, ,Min
 +
sleep, 2000
  
==Demo Video:==
+
Run, "D:\DemulShooter\DemulShooter.exe" -target=dolphin5 -ddinumber=4
<youtube>https://youtu.be/MEse3czKi-Q</youtube>
+
sleep, 2000
 +
 
 +
Run, "D:\Dolphin\Dolphin.exe" /b /e "D:\Dolphin\roms\Ghost Squad (USA).wbfs"
 +
 
 +
~Esc:: 
 +
    Process,Close,Dolphin.exe
 +
    Run,taskkill /im "Dolphin.exe" /F
 +
    Process,Close,reWASD.exe
 +
    Run,taskkill /im "reWASD.exe" /F
 +
    Process,Close,reWASDEngine.exe
 +
    Run,taskkill /im "reWASDEngine.exe" /F
 +
    sleep, 1000
 +
    ExitApp
 +
return
 +
</syntaxhighlight>
 +
<br>
 +
'''AHK script to launch Dolphin 2P'''
 +
 
 +
''If you have issues closing reWASD, compile the script and run as Administrator.''
 +
 
 +
<syntaxhighlight lang="ahk">
 +
#Requires Autohotkey v2.0-beta.1+
 +
#Warn ; Enable warnings to assist with detecting common errors.
 +
#SingleInstance Force
 +
SendMode("Input") ; Recommended for new scripts due to its superior speed and reliability.
 +
SetWorkingDir(A_ScriptDir) ; Ensures a consistent starting directory.
 +
 
 +
if(!A_Args.Has(1))
 +
{
 +
MsgBox("Commandline: `"-rom=[ROMPATH]`"", "Syntax Error", "")
 +
ExitApp()
 +
}
 +
 
 +
For i, x in A_Args
 +
{
 +
Arg := StrLower(x)
 +
 +
if (SubStr(Arg, 1, 5) = "-rom=")
 +
{
 +
ROM := Trim(SubStr(Arg, 6), "")
 +
}
 +
}
 +
 
 +
run("C:\Program Files\reWASD\reWASD.exe", ".\", , &reWASDPID)
 +
WinWait("ahk_pid" reWASDPID)
 +
 
 +
Run(".\Applications\Demulshooter\DemulShooter.exe -target=dolphin5 -ddinumber=[Replace with ddinumber]", ".\", , &DEmulPID)
 +
;WinWait("ahk_pid" DEmulPID)
 +
Sleep(5000)
 +
 
 +
ROM := "`"" . ROM . "`""
 +
 
 +
Run(".\Dolphin.exe /b /e " . ROM)
 +
 
 +
$Esc::
 +
{
 +
    ProcessClose("Dolphin.exe")
 +
    Run("taskkill /im `"Dolphin.exe`" /F")
 +
ProcessClose("reWASD.exe")
 +
Run("taskkill /im `"reWASD.exe`" /F")
 +
ProcessClose("reWASDEngine.exe")
 +
Run("taskkill /im `"reWASDEngine.exe`" /F")
 +
    ExitApp
 +
}
 +
</syntaxhighlight>
  
 
[[Category:Emulators PC]]
 
[[Category:Emulators PC]]

Latest revision as of 20:41, 14 September 2023

Dolphin is a GameCube and Wii emulator first developed as closed source in 2003, and as open source since 2008.


Emulator
Emulates: Wii, Gamecube
Download: Dolphin website
License: Free (GPLv2+)
Dolphin gameplay.jpg

Download

Download the latest Dolphin beta version zip file from the Dolphin website

Please note that you will want to download the latest Beta version and NOT the latest stable versions which are very out of date.

Limitations

  • There are no lightgun games for the Gamecube, but there are some for the Wii.
  • The latest versions of Dolphin only support 1 lightgun.
  • The older stable Dolphin v5.0 supports 2 lightguns using additional 3rd-party apps. See guide below.

Installation

Extract the downloaded Dolphin zip file into a folder of your choosing. (eg. D:\Dolphin)

Portable Install

Create a blank text file inside of the Dolphin folder (where Dolphin.exe is located) and name it portable.txt (eg. D:\Dolphin\portable.txt)

  • This MUST be done prior to launching Dolphin.exe for the 1st time.
    • If you launch Dolphin.exe without the portable.txt file present, the user config folder will be created in the Windows Documents folder. The portable install method will no longer work and you will have to start over.
  • The user config folder will be generated inside of the root of the Dolphin folder.
  • Having that file in there tells Dolphin it's a portable version and can be moved between systems. (Thanks to Gigapig for this tip!)

Double-click the Dolphin.exe file to launch the emulator.

  • Download & install the latest Visual C++ Redistributable (x64) if you receive error messages stating that VC_.dll files are missing.
  • Select “No” for the Allow Usage Statistics Reporting popup message.

Settings

The following are common settings.  The rest are dependent on your personal preferences and on your hardware.  Set them accordingly.

Import Games

Create a roms folder and place the Wii games inside (eg. D:\Dolphin\roms)

Double-click and point to the game directory (roms folder).  Your Wii games should now be listed.

Dolphin1.png

Configuration

Config  > Interface > Mouse Cursor Visibility = Never

Dolphin2.png

Graphics Settings

Graphics > General > Enable Start in Fullscreen

  • Note: You can use ReShade to apply a border if you have issues with the Sinden border showing on top. Use a ReShade API that matches the Backend setting.

Advanced > Enable Borderless Fullscreen (allows the Sinden border to show on top)

Dolphin3.png

Controls

Controllers (icon):

  • Enable Background Input
  • Set Wii Remote 1 = Emulatated Wii Remote and click on Configure button.

Map the Buttons

  • Button B = Click 0 (left mouse button)
  • Button A = Click 1 (right mouse button)
  • Click on Save after you finish mapping the buttons.
  • Note: Each game has it's own button layout. Refer to the game's manual and map the buttons accordingly.
Dolphin4.png

Sample AHK Script

#NoEnv  ; Recommended for performance and compatibility with future AutoHotkey releases.
; #Warn  ; Enable warnings to assist with detecting common errors.
SendMode Input  ; Recommended for new scripts due to its superior speed and reliability.
SetWorkingDir %A_ScriptDir%  ; Ensures a consistent starting directory.

#SingleInstance Force

Run, "D:\Dolphin\Dolphin.exe" "D:\Dolphin\roms\Ghost Squad (USA).wbfs"

~Esc::  
    Process,Close,Dolphin.exe
    Run,taskkill /im "Dolphin.exe" /F
    ExitApp
return

Accuracy Settings

If you want to improve the accuracy of your aim and remove crosshairs, Prof_gLX, PiperCalls, Ego_Bizarro and Tovarichtch has made a pack of ini files you can download with instructions from Prof_gLX's GitHub page

Note: USA versions of Wii games are required.

Demo Video


Dolphin 2-Player Setup

Required Files

Download the older Stable Version Dolphin 5.0

  • This method will only work with the older Dolphin 5.0 stable version.
  • Aim Accuracy Pack will not work with this version of Dolphin.
  • Games must be in the wbfs or wad file formats.

Download reWASD with Advanced Mapping add-on feature.

Download DemulShooter from Argonlefu’s GitHub.

  • Follow the DemulShooter wiki and configure your lightguns if you do not already have it installed.

Dolphin v5.0

1 - Extract the Dolphin v5.0 zip file into a folder of your choosing.

2 - Create a blank text file inside of the Dolphin folder and name it portable.txt.

3 - Launch Dolphin 5.0 and follow the guide above to setup & configure the emulator.

  • DemulShooter requires the following Graphics Settings:
    • Options > Graphics Settings
    • Aspect Ratio = Stretch to Window
    • Use Fullscreen = Enabled (checked)
    • Render to Window = Enabled (checked)
Dolphin5.0 GraphicsSettings.png

4 - Configure the Buttons for P1 and P2 lightguns.

  • These buttons configurations are meant to get you up and running and will not work for all games.  Each game has their own button layout.  You can change later them to suit your preferences.
  • NOTE: DemulShooter maps the P2 mouse buttons to keyboard keys. These keys (instead of mouse clicks) must be mapped for P2 in Dolphin. The default keys can be found in DemulShooter's config.ini file.
    ;Dolphin Keyboard keys configuration for P2 buttons
    DOLPHIN_P2_LCLICK = DIK_S 
    DOLPHIN_P2_MCLICK = DIK_D
    DOLPHIN_P2_RCLICK = DIK_F
    
  • Click on the Controllers icon.
  • Set Wiimote 1 and Wiimote 2 to Emulated Wiimote and click OK.
    • The WiimoteNew.ini file will be generated in the User\Config file folder.
    • D:\Dolphin\User\Config\WiimoteNew.ini
Dolphin5.0-1.png
  • Close Dolphin and open the WiimoteNew.ini file.
  • Copy and paste the following into the WiimoteNew.ini file, overwriting all of the existing configs.
  • Then click on File > Save.
[Wiimote1]
Device = DInput/0/Keyboard Mouse
Source = 1
Buttons/A = `Click 1`
Buttons/B = `Click 0`
Buttons/1 = SPACE
Buttons/2 = RETURN
Buttons/- = `5`
Buttons/+ = `1`
IR/Up = `Cursor Y-`
IR/Down = `Cursor Y+`
IR/Left = `Cursor X-`
IR/Right = `Cursor X+`
Swing/Down = `Click 2`
Extension = Nunchuk
Nunchuk/Buttons/C = `C`
Nunchuk/Buttons/Z = `Z`
D-Pad/Up = UP
D-Pad/Down = DOWN
D-Pad/Left = LEFT
D-Pad/Right = RIGHT
[Wiimote2]
Device = DInput/0/Keyboard Mouse
Source = 1
Buttons/A = F
Buttons/B = S
Buttons/1 = SPACE
Buttons/2 = RETURN
Buttons/- = `6`
Buttons/+ = `2`
IR/Up = `DInput/0/Wireless Controller:Axis Y-`
IR/Down = `DInput/0/Wireless Controller:Axis Y+`
IR/Left = `DInput/0/Wireless Controller:Axis X-`
IR/Right = `DInput/0/Wireless Controller:Axis X+`
Swing/Down = D
Extension = Nunchuk
Nunchuk/Buttons/C = `C`
Nunchuk/Buttons/Z = `Z`
D-Pad/Up = UP
D-Pad/Down = DOWN
D-Pad/Left = LEFT
D-Pad/Right = RIGHT
[Wiimote3]
Source = 0
[Wiimote4]
Source = 0
[BalanceBoard]
Source = 0


5 - Launch Dolphin and test P1 Lightgun with a game to ensure that you have properly configured Dolphin.

  • NOTE:  Make sure that Lightgun 1 works before moving on to setting up reWASD.

reWASD

1 - Unplug P1 Lightgun and ONLY have P2 Lightgun plugged in.

2 - Launch reWASD.

  • Select your P2 Lightgun from one of the devices at the bottom of the screen.
  • Select Gaming keyboard or Keyboard with touchpad and click on Submit.
ReWASD1.png


3 - Click on Fortnite and delete all if the existing button mappings by clicking on “X”.

ReWASD2.png


4 - Click on the Add button to create a new dummy button mapping. 

  • At least 1 button mapping is required.  
  • This guide maps “CapsLock” to “CapsLock”.
  • After mapping CapsLock, click on the Apply to Slot 1 button.
ReWASD3.png


5 - Select “No” if you get the pop-up warning message to mute the native behavior of the control.

ReWASD4.jpg


6 - Click on the “Eye” icon and then click on the Mouse icon.

  • Click on the Direction icon on the mouse and map it to “Left Stick”.
  • Click on Apply to Slot 1.
ReWASD5.png


7 - Click on the Sony PlayStation icon at the top of the screen and make sure this option is set to “Virtual DS4”.

ReWASD6.png


8 - Verify that reWASD is working.

  • Plug in both P1 & P2 Lightguns and launch Dolphin.  Make sure reWASD is running in the background.
  • Click on the Controllers icon and then click on the Wiimote 1 Configure button.
  • DInput/0/Wireless Controller should show up on the Device pulldown list which indicates that reWASD is working.
  • Take note of the order that DInput/0/Wireless Controller is listed, which will be used in the DemulShooter script.
  • Only one DInput/0/Wireless Controller will be shown in the Device pulldown list. If it is missing, go back and reconfigure reWASD.
Dolphin5.0-2.png


9 - DemulShooter Script:

  • The DemulShooter script will change depending on the order that the DInput/0/Wireless Controller shows up in Dolphin’s device list.  Change the -ddinumber in your script accordingly.
  • DInput/0/Wireless Controller shows up 4th on the list in the picture above.
  • The DemulShooter script should then be: Run, DemulShooter.exe -target=dolphin5 -ddinumber=4
  • Launch the game and DemulShooter with an AutoHotKey (AHK) script.
  • If you have issues with DemulShooter hooking (green icon in the system tray), make sure that DemulShooter.exe is set to run as Administrator.

Sample AHK Script

#NoEnv  ; Recommended for performance and compatibility with future AutoHotkey releases.
; #Warn  ; Enable warnings to assist with detecting common errors.
SendMode Input  ; Recommended for new scripts due to its superior speed and reliability.
SetWorkingDir %A_ScriptDir%  ; Ensures a consistent starting directory.

#SingleInstance Force 

Run, "D:\Demulshooter\DemulShooter.exe" -target=dolphin5 -ddinumber=4
sleep, 3000

Run, "D:\Dolphin\Dolphin.exe" /b /e "D:\Dolphin\roms\Ghost Squad (USA).wbfs"

~Esc::  
    Process,Close,Dolphin.exe
    Run,taskkill /im "Dolphin.exe" /F
    sleep, 500
    ExitApp
return

Optional: Creating Game-Specific Button Configurations

Each Wii game has it’s own button layout.  Refer to the game’s user manual or menu settings.

This section will show you how to create game-specific button mapping configs.


Click on the Controllers icon and then click on the Wiimote 1 Configure button.

  • Set the Device = Dinput/0/Keyboard Mouse
  • Map the player 1 buttons.
  • Type in the name the Profile = GHOSTSQUAD_P1
  • Click on the Save button and then click on OK.
Dolphin5.0-3.png


Click on the Controllers icon and then click on the Wiimote 2 Configure button.

  • Set the Device = Dinput/0/Keyboard Mouse
  • Map the player 2 buttons.  (Demulshooter sets LMouse = S, MMouse = D, RMouse = F)
  • Type in the name the Profile = GHOSTSQUAD_P2
  • Click on the Save button and then click on OK.
Dolphin5.0-4.png


Right click on Ghost Squad and select Properties.

  • In the GameConfig tab, click on Edit Config and type in the following, and the click on File > Save.
[Controls]
WiimoteProfile1 = GHOSTSQUAD_P1
WiimoteProfile2 = GHOSTSQUAD_P2

Ghost Squad will now load with the P1 and P2 button mappings.

Dolphin5.0-5.png

Troubleshooting: LaunchBox / BigBox Conflict

reWASD may conflict with LaunchBox/BigBox, causing LB/BB to freeze.

This is a workaround to launch and close reWASD using an AHK script.

  • Press CTRL+SHIFT+ESC to open the Task Manager.
  • Go to the Startup tab and right-click on reWASD and select Disable.
ReWASDTaskManager.png


Sample AHK Script to Launch & Close reWASD:

If you have issues closing reWASD, compile the script and run as Administrator.

#NoEnv  ; Recommended for performance and compatibility with future AutoHotkey releases.
; #Warn  ; Enable warnings to assist with detecting common errors.
SendMode Input  ; Recommended for new scripts due to its superior speed and reliability.
SetWorkingDir %A_ScriptDir%  ; Ensures a consistent starting directory.

#SingleInstance Force 

Run, D:\reWASD\reWASD.exe, ,Min
sleep, 2000

Run, "D:\DemulShooter\DemulShooter.exe" -target=dolphin5 -ddinumber=4
sleep, 2000

Run, "D:\Dolphin\Dolphin.exe" /b /e "D:\Dolphin\roms\Ghost Squad (USA).wbfs"

~Esc::  
    Process,Close,Dolphin.exe
    Run,taskkill /im "Dolphin.exe" /F
    Process,Close,reWASD.exe
    Run,taskkill /im "reWASD.exe" /F
    Process,Close,reWASDEngine.exe
    Run,taskkill /im "reWASDEngine.exe" /F
    sleep, 1000
    ExitApp
return


AHK script to launch Dolphin 2P

If you have issues closing reWASD, compile the script and run as Administrator.

#Requires Autohotkey v2.0-beta.1+
#Warn ; Enable warnings to assist with detecting common errors.
#SingleInstance Force
SendMode("Input") ; Recommended for new scripts due to its superior speed and reliability.
SetWorkingDir(A_ScriptDir) ; Ensures a consistent starting directory.

if(!A_Args.Has(1))
{
	MsgBox("Commandline: `"-rom=[ROMPATH]`"", "Syntax Error", "")
	ExitApp()
}

For i, x in A_Args
{
	Arg := StrLower(x)
	
	if (SubStr(Arg, 1, 5) = "-rom=")
	{
		ROM := Trim(SubStr(Arg, 6), "")
	}
}

run("C:\Program Files\reWASD\reWASD.exe", ".\", , &reWASDPID)
WinWait("ahk_pid" reWASDPID)

Run(".\Applications\Demulshooter\DemulShooter.exe -target=dolphin5 -ddinumber=[Replace with ddinumber]", ".\", , &DEmulPID)
;WinWait("ahk_pid" DEmulPID)
Sleep(5000)

ROM := "`"" . ROM . "`""

Run(".\Dolphin.exe /b /e " . ROM)

$Esc::
{
    ProcessClose("Dolphin.exe")
    Run("taskkill /im `"Dolphin.exe`" /F")
	ProcessClose("reWASD.exe")
	Run("taskkill /im `"reWASD.exe`" /F")
	ProcessClose("reWASDEngine.exe")
	Run("taskkill /im `"reWASDEngine.exe`" /F")
    ExitApp
}