troubleshooting section mostly complete

docs/games/chunithmsunplus/controllers.md

@@ -1,3 +1,7 @@
+# CHUNITHM SUN PLUS Controller Setup
+
+<img src="/img/chunithmsunplus/sunplus.png">
+
 Keyboard (sucks)
 
 Brokenithm  

docs/games/chunithmsunplus/networks.md

@@ -1,3 +1,7 @@
+# CHUNITHM SUN PLUS Network Setup
+
+<img src="/img/chunithmsunplus/sunplus.png">
+
 ARTEMiS  
 -harder to setup, works better once setup.
 

docs/games/chunithmsunplus/problems.md

@@ -1,20 +1,72 @@
-60hz CVT mode hex
+# CHUNITHM SUN PLUS Common Problems/Tips
 
-audio stuff
--game uses exclusive audio by default. can patch shared audio but need to set sound card default format (different from konami games). also increases latency.
+<img src="/img/chunithmsunplus/sunplus.png">
 
-English Patch (not sure if/how distribution?)
+### I'm having audio issues
 
-Card reader setup?  
--aic pico/real aime reader (ez)  
--cardio (dlls)
+!!! tip ""
+    CHUNITHM expects a specific Default Format from your sound card.  
+    In Windows, go to `Playback Devices` and then right click on your default device and go to `Properties`. From there, hit the `Advanced` tab and set your `Default Format` to `16bit, 48000 Hz (DVD Quality)` and check both of the options inside `Exclusive Mode` as pictured.  
 
-multiplayer setup instructions  
--zerotier pain in the ass, but works.
+    By default, CHUNITHM uses Exclusive Audio. This means you won't be able to hear any other sounds from your PC while the game is running. A Shared Audio mode can be enabled via the chusanApp.exe Patcher website, though it should be noted that this can increase audio latency.
 
-DXVK (run game on vulkan)  
--lets you tab out of fullscreen without crash  
--possibly runs better for some people
+<img src="/img/gen/sega480.png">
 
-slow boot times  
--add entire game folder to defender exceptions
+### My game takes a long time to boot
+
+!!! tip ""
+    The game files for CHUNITHM consists of thousands of small .xml files, and Windows Defender is known to spend a long time scanning through them during game boot up.  
+    One way to massively speed up boot times is to add the entire game folder as a Windows Defender Exception.
+
+!!! danger "Warning:"
+    Doing this will prevent Defender from scanning your game folder for viruses. Only do this if you trust the source of your data.
+
+!!! tip ""
+    Open `Virus & threat protection`.  
+    Under `Virus & threat protection settings` click the `Manage Settings` button.  
+    Scroll down to `Exclusions` and click on `Add or remove exclusions`.  
+    Click the `Add an exclusion` button, select the `folder` option, navigate to the base of your game install and click `Select Folder`.
+
+<img src="/img/chunithmsunplus/defender.png">
+
+### My game crashes when I alt-tab out of fullscreen
+
+!!! tip ""
+    As the game is intended to run on dedicated hardware, if it detects it has lost focus it will force-close itself. On real hardware it would then try and restart.  
+    One work-around for this is to use [DXVK](https://github.com/doitsujin/dxvk/) to run the game with Vulkan rather than Direct3D. This has the added benefit of smoother frame rates for some hardware configurations.  
+
+    Download the latest version of DXVK from the [releases tab](https://github.com/doitsujin/dxvk/releases). This will be a `dxvk-x.x.tar.gz` file. Open the file with `7zip` and navigate to the `x32` folder.  
+    Extract the `d3d9.dll` file to your `\CHUNITHMSUNPLUS\App\bin\` folder, alongside your `chusanApp.exe`.  
+    You should now be able to tab out of fullscreeen, leaving the game running.
+
+!!! note "Additional DXVK configuration:"
+    DXVK has other options that can be changed by adding a `dxvk.conf` file next to the `d3d9.dll` file. The most common use for this is to add an FPS counter to the game.  
+    If you wish to have an FPS counter, create a `dxvk.conf` file and open it with Notepad++. Add the following line.  
+    ```json
+    dxvk.hud = fps
+    ```
+    You can learn more about the available options at the [DXVK Configuration Wiki page](https://github.com/doitsujin/dxvk/wiki/Configuration).
+
+!!! note "Controller inputs whilst minimised:"
+    As the game was never designed to be minimised, it will not ignore inputs when not focused. This means any controller inputs will be accepted, so try not to lean on your slider while tabbed out!  
+    The most common issue this causes is when typing the number `1` with the game minimised, as by default this will enter the test menu. If you were mid-credit, your scores will be lost.  
+    If you wish to change the keyboard keys assigned to the Test, Service and Coin buttons, this can be configured in the `[io3]` section of `segatools.ini`.
+
+### My game occasionally drops frames/stutters
+
+!!! tip ""
+    While frame drops can be caused by running the game on under-powered hardware, it is also common for this to happen when running on hardware that is too over-powered!  
+    As a lot of the game consists of mostly 2D assets, your GPU is unlikely to be being pushed very hard. Modern GPUs attempt to be as energy efficient as possible by changing power-states when under-utilised. If these power-state changes happen mid song, this can lead to slight frame drops and stutters.  
+    This can be solved by forcing the GPU to stay in its maximum power-state while the game is running.
+
+!!! note "NVIDIA:"
+    In the Windows Taskbar Icon Tray, right click the NVIDIA Settings icon, and select `NVIDIA Control Panel`.  
+    On the left, select `Manage 3D settings`.  
+    On the right, click on the `Program Settings` tab.  
+    Click the add button, and navigate to your `\CHUNITHMSUNPLUS\App\bin\` folder, and select `chusanApp.exe`.  
+    In the `Feature` list, scroll down to `Power management mode` and select `Prefer maximum performance`.  
+    Save your settings and close `NVIDIA Control Panel`. Your game will now always run in the highest power-state!
+
+<img src="/img/chunithmsunplus/nvidiaperf.png">
+
+!!! note "AMD:"

docs/games/chunithmsunplus/setup.md

@@ -3,9 +3,9 @@
 <img src="/img/chunithmsunplus/sunplus.png">
 
 !!! note "Author Note:"
-	Last updated: 03.02.2024 (Currently using `SDHD 2.16.00`)
+	Last updated: 08.02.2024 (Currently using `SDHD 2.16.00`)
 	
-	For hex edits: Go to [Missless Patcher](https://patcher.missless.net/chunisunplus.html) (should probably find a patcher host who's happy to be featured here)
+	For hex edits: Go to the CHUNITHM section of your prefered patcher host, or use the Offline Patcher included with the unpacked binaries.
 
 !!! danger "Warning:"
 	Please make sure your data is from an appropriate source and unmodified before proceeding, this guide is unable to troubleshoot any problems related to bad or poorly managed data.
@@ -56,7 +56,7 @@
 	The update folder should only contain an `App` folder.
 
 !!! note "Other Data Formats:"
-	SEGA data is also commonly distributed as single `.app` and `.opt` files. These files are useful for archive purposes, but are not required to run the game. Always download the unpacked data for home use.
+	SEGA data is also commonly distributed as single `.app` and `.opt` files. These files are useful for archival purposes, but are not required to run the game. Always download the unpacked data for home use.
 
 ### Setting Up the Game Data
 
@@ -107,7 +107,7 @@
 	`option=` should point to the `Option` folder, which contains game data update folders, with A**XXX** names. This should also be in the root of your game folder, next to `amfs`.  
 	`appdata=` is a new folder created for the games appdata. You can either create a folder somewhere to point this too, or simply enter `appdata=appdata` to have a folder created within your `App/bin` folder.
 
-	The example image below was created, with a base game folder of `C:\CHUNITHMSUNPLUS\`.
+	The example image below was created with a base game folder of `C:\CHUNITHMSUNPLUS\`.
 
 <img src="/img/chunithmsunplus/vfs.png">
 
@@ -143,7 +143,7 @@
     	}
 	}
 	```
-	This is only needed to boot the game in offline mode, as any correctly configured server should handle the default settings correctly.
+	This is only needed to boot the game in offline mode, as any correctly configured server should handle the default settings properly.
 
 ### Service Menu settings
 
@@ -182,8 +182,13 @@
 <img src="/img/chunithmsunplus/alltime.png">
 
 !!! tip ""
-	Select the last option from the menu to return to the previous menu, and then select the last option of the main menu to save your settings and boot the game.  
+	Select the last option from the menu to return to the previous menu, and then select the last option of the main menu to save your settings and continue booting the game.  
 
+	If you get stuck at a `Waiting for Distribution Server` message, shown below, close the game and relaunch. This is caused by dipswitch settings not setting themselves correctly the very first time the game is launched.
+
+<img src="/img/chunithmsunplus/distserver.png">
+
+!!! tip ""
 	If everything has been set up correctly, you should now be at the games Attract Screen.  
 	Now we know the game is working, we can move on to configuring controllers and network access.