two-torial/docs/games/chunithmsunplus/setup.md

10 KiB

CHUNITHM SUN PLUS

!!! 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.

If you obtained data from a torrent file, make sure you're not seeding the data before proceeding as well.

This guide will use [Dniel97's segatools](https://gitea.tendokyu.moe/Dniel97/segatools/releases), which is a fork of segatools that gets regular updates and will be needed to get the game running.

Getting Started

!!! tip "" Before we even touch the game, there are some prerequisites we should install to minimise issues.

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 [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.

!!! tip "" Next we should make sure we have all the required DirectX files.

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.

Go to the folder you extracted the installer to, find the `DXSETUP.exe` and run it. Accept the License Agreement and start the installation. Once it's complete, press Finish.

You can delete the folder you extracted the installer to once the install is complete.

Verifying your Game Data

!!! tip "" SEGA games are generally distributed as a base game folder and sequential update folders. For SUN PLUS, this will be a base SDHD 2.15.00 and an SDHD 2.16.00 update.

!!! tip "" The base game folder should contain an amfs, App and Option folder.

!!! tip "" 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 archival purposes, but are not required to run the game. Always download the unpacked data for home use.

Setting Up the Game Data

!!! danger "Warning:" segatools is currently unable to be run from the E:\ drive. Please ensure your data is setup on another drive letter.

!!! tip "" Choose a location for your game data, for example, C:\CHUNITHMSUNPLUS\.
Copy/move the amfs, App and Option folders from CHUNITHM SUN PLUS (SDHD 2.15.00) to this new folder.
Copy the App folder from CHUNITHM SUN PLUS (SDHD 2.16.00) to your new game folder. When asked, choose to replace the existing files with the newly copied files.

!!! tip "" Next we need to replace the protected executables with copies 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 Discord for assistance.
Copy chusanApp.exe and amdaemon.exe to the App\bin\ folder of your game data. When asked, overwrite the existing files.

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 segatools gitea page.

!!! tip "" Download the latest version of segatools from the release tab 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.

!!! tip "" Copy the files from chusan.zip to your App/bin folder.
Here is how your App/bin folder should look after everything has been copied correctly.

Configuring segatools.ini

!!! tip "" The configuration information for segatools is all stored within segatools.ini.
Open up segatools.ini with a text editor of your choice. We'll be using Notepad++.
segatools.ini is separated 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 absolute 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\`.

!!! 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.

!!! 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.

!!! 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 properly.

!!! danger "Intel 10th Gen and higher:" If your PC has a 10th Gen or newer Intel CPU, there is one last step before running the game. Due to an issue with OpenSSL, AMDaemon will fail to launch without the following changes.

!!! tip "" Find the start.bat file in your games bin folder, and open it with a text editor.
At the very top of the file, above the @echo off line, add the following. bat set OPENSSL_ia32cap=:~0x20000000
Save and close start.bat.

Service Menu settings

!!! note "Service Menu:" Without an English patch the Service Menu will be in Japanese. Google Lens 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.

!!! tip "" Press F1 on your keyboard to enter the Service Menu (1 on older versions of segatools).
Use D and F to navigate the menu, and L to select an option.

Navigate to `Game Settings`, the 4th option from the top.

!!! tip "" Select the second option, reference machine settings and toggle this setting to reference machine, as shown below.

!!! 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.

!!! tip "" Select the second option, hour, and toggle with L until the option all time is selected.

!!! 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 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.

!!! tip "" If everything has been set up correctly, you should now be at the game's Attract Screen.
F2 and F3 will let you insert service/coin credits (1 and 2 on older versions of segatools). Now that we know the game is working, we can move on to configuring controllers and network access.

!!! note "Dipswitch Settings:" The dipswitch settings, dipsw1, dipsw2 and dipsw3, are not set the very first time you run the game, as some system files still need to be created. If the game is running at the wrong frame rate, you may need to exit and re-open the game for these settings to apply.

Further Configuration

!!! note "Controllers:" As there are several different input methods, each with different setup procedures, these will be covered in the Controllers section.

!!! note "Networks:" Local Network options will be covered in the Networks section.

!!! warning "Have any other errors?" Check out the Common Problems/Tips and Error Codes section.