Difference between revisions of "Dolphin"

From Sinden Lightgun
Jump to navigation Jump to search
 
(13 intermediate revisions by 3 users not shown)
Line 24: Line 24:
  
 
====Portable Install====
 
====Portable Install====
Create a blank text file inside of the '''Dolphin folder''' and name it  <code>portable.txt</code>  (eg. D:\Dolphin\portable.txt)
+
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)
  
 
* This MUST be done prior to launching Dolphin.exe for the 1st time.
 
* 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.
 
* 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>
 
* 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>
Line 41: Line 42:
 
Create a roms folder and place the Wii games inside  (eg. D:\Dolphin\roms)
 
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, wad, wbfs.
+
* [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.
 
Double-click and point to the game directory (roms folder).  Your Wii games should now be listed.
Line 53: Line 54:
 
'''Graphics''' > ''General'' > Enable ''Start in Fullscreen''
 
'''Graphics''' > ''General'' > Enable ''Start in Fullscreen''
  
* Note: If you are using ReShade for the border, use an API that matches the ''Backend'' setting.
+
* <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)
 
'''Advanced''' > Enable ''Borderless Fullscreen'' (allows the Sinden border to show on top)
Line 92: Line 93:
  
 
==Accuracy Settings==
 
==Accuracy Settings==
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]
+
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]
  
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].
+
'''<u>Note</u>''': USA versions of Wii games are required.
  
 
===Demo Video===
 
===Demo Video===
Line 122: Line 123:
 
3 - Launch Dolphin 5.0 and follow the [[Dolphin#Installation|'''guide above''']] to setup & configure the emulator.
 
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.
 
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.
 
* 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.
  
Line 141: Line 148:
  
 
* Close Dolphin and open the <code>WiimoteNew.ini</code> file.
 
* Close Dolphin and open the <code>WiimoteNew.ini</code> file.
* Copy and paste the following into the <code>WiimoteNew.ini</code> file, overwriting the existing configs.
+
* Copy and paste the following into the <code>WiimoteNew.ini</code> file, overwriting all of the existing configs.
 
* Then click on ''File'' > ''Save''.
 
* Then click on ''File'' > ''Save''.
 
<syntaxhighlight lang="ini">
 
<syntaxhighlight lang="ini">
Line 358: Line 365:
 
</syntaxhighlight>
 
</syntaxhighlight>
 
<br>
 
<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
}