more doc updates

docs/games/chunithmsunplus/controllers.md

@@ -0,0 +1,17 @@
+Keyboard (sucks)
+
+Brokenithm  
+-iPad  
+-Android
+
+Tasoller  
+-AMD  
+-Intel
+
+Yubideck
+
+chuni-hands (?)  
+-webcam airs, does anyone actually use this seriously.
+
+chusan-touch (?)
+-like brokenithm but you block your view of the game.

docs/games/chunithmsunplus/networks.md

@@ -0,0 +1,8 @@
+ARTEMiS  
+-harder to setup, works better once setup.
+
+AquaDX  
+-ez mode setup, requires messing with game files to actually work. relys on updates from devs for future content.
+
+Online Options (?)  
+-duno if anyone would want their all.net server referenced here lol.

docs/games/chunithmsunplus/problems.md

@@ -0,0 +1,20 @@
+60hz CVT mode hex
+
+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.
+
+English Patch (not sure if/how distribution?)
+
+Card reader setup?  
+-aic pico/real aime reader (ez)  
+-cardio (dlls)
+
+multiplayer setup instructions  
+-zerotier pain in the ass, but works.
+
+DXVK (run game on vulkan)  
+-lets you tab out of fullscreen without crash  
+-possibly runs better for some people
+
+slow boot times  
+-add entire game folder to defender exceptions

docs/games/chunithmsunplus/setup.md

@@ -3,7 +3,7 @@
 <img src="/img/chunithmsunplus/sunplus.png">
 
 !!! note "Author Note:"
-	Last updated: 25.01.2024 (Currently using `SDHD 2.16.00`)
+	Last updated: 03.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)
 
@@ -19,9 +19,9 @@
 !!! tip ""
 	Before we even touch the game, there are some prerequisites we should install to minimise issues.
 
-	First off we should make sure our <a href="https://github.com/abbodi1406/vcredist">Microsoft Visual C++ Runtimes</a> are up to date.
+	First off we should make sure our [Microsoft Visual C++ Runtimes](https://github.com/abbodi1406/vcredist) are up to date.
 
-	Grab the latest version of the AIO installer from the <a href="https://github.com/abbodi1406/vcredist/releases">releases tab</a>. Make sure to get the version that installs both x86 and x64 versions.
+	Grab the latest version of the AIO installer from the [releases tab](https://github.com/abbodi1406/vcredist/releases). Make sure to get the version that installs both x86 and x64 versions.
 
 	Run the downloaded `VisualCppRedist_AIO_x86_x64.exe` and press next. The installer will proceed to download and install the required files. This may take some time.
 
@@ -30,7 +30,7 @@
 !!! tip ""
 	Next we should make sure we have all the required DirectX files.
 
-	Download the DirectX Redist (June 2010) from the <a href="https://www.microsoft.com/en-gb/download/details.aspx?id=8109">Microsoft Website</a>.
+	Download the DirectX Redist (June 2010) from the [Microsoft Website](https://www.microsoft.com/en-gb/download/details.aspx?id=8109).
 
 	Run the downloaded `directx_Jun2010_redist.exe` and accept the License Agreement. You will be asked to pick a location to extract the installer too, it's recommended you create a new folder somewhere as it will extract a lot of files.
 
@@ -72,16 +72,16 @@
 
 !!! tip ""
 	Next we need to replace the protected executables with copys that will run on a regular PC.  
-	Obtain unpacked copies of `chusanApp.exe` and `amdaemon.exe`. If these weren't provided with your data, join the <a href="https://discord.gg/cZRUmEPK78">Discord</a> for assistance.  
+	Obtain unpacked copies of `chusanApp.exe` and `amdaemon.exe`. If these weren't provided with your data, join the [Discord](https://discord.gg/cZRUmEPK78) for assistance.  
 	Copy `chusanApp.exe` and `amdaemon.exe` to the `App\bin\` folder of your game data. When asked, overwrite the existing files.
 
-### Setting up segatools
+### Installing segatools
 
 !!! note "segatools:"
-	`segatools` is a loader and hardware emulator for SEGA arcade games. It will allow us to launch the game, as well as configure inputs and network settings. More information can be found at the <a href="https://gitea.tendokyu.moe/Dniel97/segatools"> segatools gitea page</a>.
+	`segatools` is a loader and hardware emulator for SEGA arcade games. It will allow us to launch the game, as well as configure inputs and network settings. More information can be found at the [segatools gitea page](https://gitea.tendokyu.moe/Dniel97/segatools).
 
 !!! tip ""
-	Download the latest version of segatools from <a href="https://gitea.tendokyu.moe/Dniel97/segatools/releases">the release tab</a> of the segatools page. This will be a file named `segatools.zip`.   
+	Download the latest version of segatools from [the release tab](https://gitea.tendokyu.moe/Dniel97/segatools/releases) of the segatools page. This will be a file named `segatools.zip`.   
 	As segatools supports many games, the `segatools.zip` file will contain several more zip files. For CHUNITHM SUN PLUS, we will need to open the `chusan.zip`.
 
 <img src="/img/chunithmsunplus/chusanzip.png">
@@ -92,14 +92,108 @@
 
 <img src="/img/chunithmsunplus/appbincomplete.png">
 
-!!! tip ""
+### Configuring segatools.ini
-	Open segatools.ini with a text editor  
-	Configure `[vfs]`  
 
 !!! tip ""
-	120hz vs 60hz  
+	The configuration information for segatools is all stored within `segatools.ini`.  
-	dipswitches  
+	Open up `segatools.ini` with a text editor of your choice. We'll be using [Notepad++](https://notepad-plus-plus.org/).  
-	patch exe for 60hz  
+	`segatools.ini` is seperated into several sections, indicated by the section name in `[square brackets]`.  
+	Most options will have comments describing their function and how to configure them. We will go over the most important ones below.  
+
+!!! tip ""
+	The `[vfs]` section contains paths to important game files. You can use either relative or absoloute paths, however if your path name has spaces in it, you must wrap the path in "quotations marks".  
+
+	`amfs=` should point to the `amfs` folder, which should be in the root of your game folder. This folder should contain an ICF1 file.  
+	`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\`.
+
+<img src="/img/chunithmsunplus/vfs.png">
+
+!!! tip ""
+	The `[dns]` section is for connecting to a server, however this will also need to be changed for offline play. In most cases this will be set to your local IPv4 Address.  
+	Open your Command Prompt from the start menu, and type `ipconfig`.  
+	Find the line that says `IPv4 Address. . . .` and copy the address. This will normally be in the format of **192.168.x.x**, though this may vary.  
+	Replace `127.0.0.1` with the IP address you copied from Command Prompt.
+
+<img src="/img/chunithmsunplus/dns.png">
+
+!!! tip ""
+	The `[gpio]` section is where we can change between 60 FPS and 120 FPS.  
+	For 60 FPS, leave the settings as they are.  
+	For 120 FPS, change `dipsw2` and `dipsw3` from `1` to `0`.
+
+<img src="/img/chunithmsunplus/gpio.png">
+
+!!! tip ""
+	Save and close `segatools.ini`.  
+
+	Before we can test the game offline, we need to open `config_hook.json` in a text editor, and replace its content with the following:
+	```json
+	{
+    	"allnet_auth": {
+    	    "type": "1.0"
+    	},
+    	"allnet_accounting": {
+    	    "enable": false
+    	},
+    	"emoney": {
+     	   "enable": false
+    	}
+	}
+	```
+	This is only needed to boot the game in offline mode, as any correctly configured server should handle the default settings correctly.
+
+### Service Menu settings
+
+!!! note "Service Menu:"
+	Without an English patch the Service Menu will be in Japanese. [Google Lens](https://lens.google/) is a very handy tool for navigating this menu.
+
+!!! tip ""
+	We are now ready to test our game setup.  
+	Start the game by launching `start.bat` from the games `App/bin` folder.  
+	Let the game load until it gets to the following screen.
+
+<img src="/img/chunithmsunplus/asettings.png">
+
+!!! tip ""
+	Press `1` on your keyboard to enter the Service Menu.  
+	Use `D` and `F` to navigate the menu, and L to select an option.  
+
+	Navigate to `Game Settings`, the 4th option from the top.
+
+<img src="/img/chunithmsunplus/gamesettings.png">
+
+!!! tip ""
+	Select the second option, `reference machine settings` and toggle this setting to `follow the reference machine`, as shown below.
+
+<img src="/img/chunithmsunplus/followreference.png">
+
+!!! tip ""
+	Select the last option from the menu, to return to the previous menu.  
+	Once back to the main Service Menu, select the 10th option in the list, `closing setting`.
+
+<img src="/img/chunithmsunplus/closingsetting.png">
+
+!!! tip ""
+	Select the second option, `hour`, and toggle with `L` until the option `all time` is selected.
+
+<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.  
+
+	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.
+
+### Further Configuration
+
+!!! note "Controllers:"
+	As there are several different input methods, each with different setup procedures, these will be covered in the [Controllers](controllers.md) section.
+
+!!! note "Networks:"
+	Local Network options will be covered in the [Networks](networks.md) section.
 
 !!! warning "Have any other errors?"
 	Check out the [Common Problems/Tips](problems.md) section.

mkdocs.yml

@@ -122,6 +122,8 @@ nav:
             - 'CHUNITHM':
                 - 'SUN PLUS':
                     - 'First Time Setup': 'games/chunithmsunplus/setup.md'
+                    - 'Controllers': 'games/chunithmsunplus/controllers.md'
+                    - 'Networks': 'games/chunithmsunplus/networks.md'
                     - 'Common Problems/Tips': 'games/chunithmsunplus/problems.md'
     - Error Codes: errorcodes.md
     - Extras: