Merge pull request #96 from pinapelz/master

Add maimai DX troubleshooting and controller section, add insert credit issue to ONGEKI troubleshooting, add games
This commit is contained in:
Akitake 2025-04-06 20:53:03 +00:00 committed by GitHub
commit 96899b4472
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
22 changed files with 971 additions and 720 deletions

View File

@ -0,0 +1,85 @@
!!! danger "Please make sure you downloaded your data from an appropriate source.<br>This guide is unable to troubleshoot any problems related to bad or poorly managed data."
---
!!! tip ""
segatools, by default, only accepts keyboard input and does not recognize any
controllers. However, it can be configured with IO DLLs to add support for controllers.
The controller you plan on using should also be provided with these IO DLLs. If unsure,
check the support section for your controller, or contact the vendor directly. Alternate
options for the most common controllers are listed below.
These IO DLLs should be copied to your game's `App\Package` folder and referenced in
`segatools.ini` under the `[mai2io]` section.
!!! tip ""
If you have a single DLL, uncomment the `path=` line by removing the leading semicolon (`;`),
then add your DLL's file name after the `=`:
```ini hl_lines="5"
[mai2io]
; To use a custom maimai DX IO DLL enter its path here.
; Leave empty if you want to use Segatools built-in keyboard input.
;(1)!
path=controller.dll
```
1. Note that there is no leading semicolon.
### Keyboard/Touchscreen
!!! tip ""
Keyboard/Touchscreen is the default input method
The default layout uses `QWEDCXZA` for physical buttons (each key representing the physical button's location relative to the center screen)
If you wish to change the default keybinds, an explanation on how to set these is included
above the `[io4]` section in your `segatools.ini`.
Touch input should automatically work after connecting a touch-screen display
---
### ADX Controller
!!! tip ""
First, you will need to purchase a compatible monitor if your controller did not come with one. A list of compatible monitors can be found on [this spreadsheet](https://docs.google.com/spreadsheets/d/1WN50pyJEPpXR32UTsEzsKe4Qm-EUAQgwmkCBX3kWB1Q)
Plug your controller in and open `Device Manager`.
Under the `Ports (COM & LPT)` section, ensure the correct ports are set for both the Touch Panel and Button LED.
- (Touch Panel) USB Serial Device: `COM3`
- (Button LED) USB-SERIAL CH340: `COM21`
If they are different change the port of the device by `Right Clicking on the Device -> Properties -> Port Settings -> COM Port Number`
Finally ensure the `mai2.ini` file in your data's `App/Package` folder has the following values set under the `[AM]` section
```
[AM]
Target=0
DummyTouchPanel=0
DummyLED=0
```
This gets your controller working with keyboard inputs. Its highly recommended that you also view [this setup guide](https://github.com/maimai-dx/ADX-Controller-Guide/blob/master/document/Setup.md) which provides more detailed instructions, improved drivers, and help with adjusting touch panel sensitivity.
!!! warning
You **DO NOT** need to follow the Network Setup steps in the linked guide above if you've already done so while setting up game data
You **DO NOT** need to follow the Aime Reader setup in the linked guide above if you do not own one.
### Arcade hardware and other controllers
!!! tip ""
If you're interested in using a cabinet, or possibly even
making your own controller, the [Cons&Stuff website](https://consandstuff.github.io/)
and Discord community is a great place to start!

346
docs/games/mai2/setup.md Normal file
View File

@ -0,0 +1,346 @@
!!! danger "Please make sure you downloaded your data from an appropriate source.<br>This guide is unable to troubleshoot any problems related to bad or poorly managed data."
!!! danger "If you're coming from a previous version of maimai DX"
Create a new folder for the game and start from scratch.
maimai DX **DOES NOT** like being extracted over old data!
---
### Preparing data
!!! danger "There are currently issues with running game data in the `E:\` or `Y:\` drive.<br>Please extract the data into other drives."
!!! tip ""
After downloading and extracting your data, we need to make sure your files
are not set to `Read-only`.
- Right click the folder containing your data, then click on `Properties`.
- In the `General` tab go down to `Attributes`, untick `Read-only` and click `Apply`.
- A popup will appear, select `Apply changes to this folder, subfolder and files`and press `OK`.
- Finally, click `OK` again to exit out of properties.
You should end up with a file structure as follows.
<img width="500" src="/img/maimaidx/setup/rootdir.png">
Create two new empty folders named `appdata` and `amfs` (and the folder `option` if not present) next to them as shown below:
<img width="500" src="/img/maimaidx/setup/rootdir2.png">
The `App` folder should have a file structure as follows.
<img width="500" src="/img/maimaidx/setup/appdir.png">
??? warning "If your data doesn't look like this"
If your data looks like the third image:
- Create an `App` folder and move all files and folders from the image inside of it.
- Create empty folders named `amfs`, `Option` and `AppData` next to the `App` folder.
If extra files are present next to your folders, such as executables, scripts, etc..
**remove them. This also means your data was tampered with and we strongly recommend
getting new data from somewhere else.**
#### Installing ICFs
!!! tip ""
Install Configuration Files (ICFs) tell the game what version it is.
**Without this your game cannot go online!**
If your `amfs` folder already has files`ICF1` and `ICF2`, skip this step.
Otherwise, obtain copies of `ICF1` for your game version and place it in
the `amfs` folder. If it is named something else, rename it to exactly
`ICF1` **without any file extensions.** `ICF2` is a copy of `ICF1`.
??? info "Showing File Extensions"
By default, file extensions on Windows are hidden. Enable them by navigating to
the `View` tab in File Explorer and select `File name extensions`.
#### Installing Unprotected Executables
!!! tip ""
maimai DX executables are protected and will not run on a regular computer.
Obtain unprotected (also called "unpacked" or "decrypted" by the community)
copies of the following files and the associated configuration file:
- amdaemon.exe
- Sinmai.exe
- Sinmai_Data/Plugins/amdaemon_api.dll
- Sinmai_Data/Plugins/Cake.dll
- Sinmai_Data/Managed/AMDaemon.NET.dll
- Sinmai_Data/Managed/Assembly-CSharp.dll
- mai2.ini or maimaiDX.ini
Copy the files and folders into the `App/Package` folder of your game data. Agree to overwrite
when asked.
!!! Warning "Assembly-CSharp Notes"
`Assembly-CSharp.dll` **must** match your game version. All others can be
reused from other game versions.
`Assembly-CSharp.dll` **must** also contain `mai2.ini` or `maimaiDX.ini`. These configuration
files are specific to the unprotected `Assembly-CSharp.dll`. If your package does not
contain a configuration file, please create one with the following to bypass hardware
checks on game startup:
```ini
[AM]
Target=0
IgnoreError=1
DummyTouchPanel=1
DummyLED=1
DummyCodeCamera=1
DummyPhotoCamera=1
[Sound]
Sound8Ch=0
[Patches]
EnablePatchLog=1
```
!!! tip "If the assembly supports it, `App/Package/dpPatchLog.log` lists supported patches after the first run. Otherwise see [Custom Mods](#custom-mods)"
---
### Installing Segatools
!!! tip ""
- Head over to [segatools releases](https://gitea.tendokyu.moe/Dniel97/segatools/releases/latest)
and download the latest `segatools.zip`. **Do not download the source code.**
- Extracting the archive should give you a few more zip files. Find `mai2.zip`
and extract it to the `App/Package` folder in your game data.
You should now have a few more files inside the `App/Package` folder, as highlighted:
<img width="500" src="/img/maimaidx/setup/segatools.png">
---
### Configuring Segatools
!!! tip ""
Since there is no graphical configuration tool for segatools, you will have to edit the
configuration file by hand. It is found in `App/Package/segatools.ini`.
It is recommended that you follow along using a text editor with syntax highlighting such as [Notepad++](https://notepad-plus-plus.org/).
Each following sub-section will correspond to a section in `segatools.ini`. If any
section is not mentioned, you can skip them.
!!! warning
If a key already exists in the section, delete everything after `=` and replace it with your
setting. Do not add another key. Example:
```ini
[system]
dipsw2=1
dipsw2=1 ; WRONG!
```
#### `[vfs]`
!!! tip ""
If you've been matching the file structure as described in the [Preparing data](#preparing-data)
section, you can fill in this section with the values below:
```ini
[vfs]
amfs=../../amfs
option=../../option
appdata=../../appdata
```
#### `[dns]`
!!! tip ""
Game will not pass checks unless you modify the dns:
```ini
[dns]
default=YOUR_IPv4_ADDRESS
```
??? tip "Finding Your IPv4 Address"
Open a command promt. Type `ipconfig` and look for the IPv4 Address.
Place those digits here otherwise you will get stuck on the DNS(LAN) check.
---
### Pre-launch requirements
!!! info "These steps are required, otherwise your game won't run."
#### VCRedist & DirectX
!!! tip ""
- Download and install the latest [VCRedist](https://github.com/abbodi1406/vcredist/releases/latest) (`VisualCppRedist_AIO_x86_x64.exe`)
- Download and install the [DirectX End-User Runtimes](https://www.microsoft.com/en-us/download/details.aspx?id=8109)
#### Audio
!!! tip ""
- Right-click on the volume setting in your taskbar and select `Sounds`.
- Navigate to the `Playback` tab, right click on your default audio device, and click on `Properties`.
- Go to the `Advanced` tab.
- Check both boxes under `Exclusive Mode`.
- Open the `Default Format` dropdown.
- Pick either `16 bit, 48000Hz (DVD Quality)` or `24 bit, 48000Hz (Studio Quality)`, click `Apply`, then `OK`.
<img src="/img/maimaidx/setup/audio.png">
#### Fixing OpenSSL on Intel 10th Gen and newer CPUs
!!! tip ""
If you have an Intel 10th Gen CPU or newer, right click `App/Package/start.bat`, select `Edit`, and add the
highlighted line to the top of the file.
```batch hl_lines="2"
@echo off
set OPENSSL_ia32cap=:~0x20000000
pushd %~dp0
...
```
---
### Test Launch
!!! danger "If you have any issues running the game, refer to the [Troubleshooting](troubleshooting.md) page."
!!! warning "Please Disconnect any Hardware including Controllers or Card Readers at this time."
!!! tip
Without an English patch, the service menu will be in Japanese. If you don't know Japanese, [Google Lens](https://lens.google/)
is a handy tool for navigating this menu.
#### Game Settings
!!! tip ""
If you've followed all instructions correctly, you are ready to launch the game!
Start the game by running `App/Package/start.bat`. You should see a terminal pop-up with the following:
<img src="/img/maimaidx/setup/cmd.png">
Another window titled `Sinmai` is the actual game. It should pause on `Search for Distribution Servers`:
<img src="/img/maimaidx/setup/distribution_servers_check.png">
!!! tip ""
Use the following keyboard controls `F1` = `Test/Enter` and `c` = `down` to do the following:
- Press `F1` to enter the service menu
- Press `c` a few times to navigate to `Game Settings` or `ゲーム設定` as shown below:
<img src="/img/maimaidx/setup/service_menu.png">
- Press `F1` to enter the menu. Press `c` to navigate to the top option and toggle to `OFF` using `F1`. You should see the following:
<img src="/img/maimaidx/setup/service_game_settings.png">
- Press `ESC` to exit. Close all associated windows including `CMD`, `AMDaemon`, and `Sinmai`. Relaunch with `start.bat` and the game should boot into guest mode.
---
### Connecting to a Network
!!! danger "Please choose one of the two solutions, not both!"
??? tip "Remote (Online Network)"
Head to the `[dns]` section inside `segatools.ini`. Set `default` to the address
provided by your network. **Do not add `http://` or `https://` to the address!**
```ini
[dns]
default=network.example
```
Then, head to the `[keychip]` section and add & set `id` to the keychip ID provided by your network:
```ini
[keychip]
subnet=192.168.172.0
id=A69E-XXXXXXXXXXX
```
Finally, you need a card number. Create a file named `aime.txt` inside `App/Package/DEVICE` and type in
your 20-digit access code if you already have one, or make one up if you don't. If you're making one
up, the access code **MUST NOT** start with a 3.
<img src="/img/maimaidx/setup/access_code.png">
??? tip "Local (ARTEMiS/AquaDX)"
Both of these options require non-trivial setup. Refer to the official guides for [ARTEMiS](https://gitea.tendokyu.moe/Hay1tsme/artemis/src/branch/develop/docs/INSTALL_WINDOWS.md)
and [AquaDX](https://github.com/hykilpikonna/AquaDX?tab=readme-ov-file#usage-v1-developmental-preview)
to set up a local server.
---
### Further Configuration
#### Updating the Base Game
!!! tip ""
Extract your patch's files to your existing data in a way that matches its
file structure. Agree to overwrite files if necessary.
!!! Warning "Only update if an unencrypted `Assembly-CSharp.dll` is available"
#### Installing Option Data
!!! tip ""
maimai DX content updates are distributed through option folders instead of patching
the base game.
Options are named with a letter followed by three numbers.
For JPN data, each new release of maimai DX increments the first letter of the Option (ie. BUDDiES is `H???` and BUDDiES+ is `I???`).
For EXPORT data, Options will always begin with the letter `A` (i.e `A???`)
Extract any options you've downloaded into the `Option` folder. You should end up with
a file structure as follows. **Do not be worried if you have fewer or more option folders.**
<img width="500" src="/img/maimaidx/setup/options.png">
!!! warning "Do not mix option data between versions"
---
### Custom Mods
!!! info "Mods are covered on the [Unity modding](../../../extras/unity.md) page."
### Controllers and Troubleshooting
!!! info "Input methods and controllers are covered in the [Controllers](controllers.md) page."
!!! warning "Have any other issues?"
Check out the [Troubleshooting](troubleshooting.md) and [Error Codes](../../../errorcodes/sega.md) pages.

View File

@ -0,0 +1,74 @@
!!! danger "Please make sure you downloaded your data from an appropriate source.<br>This guide is unable to troubleshoot any problems related to bad or poorly managed data."
---
### My game crashes on launch/stuck on "Starting System Process"
!!! tip ""
Could be due to **many** things, the most common of which are:
- `amdaemon` crashing in the background. Make sure that the `config_*.json` files
have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
??? info "Capturing logs from `amdaemon` for troubleshooting"
To assist with troubleshooting, a script can be used to capture logs from `amdaemon`. Create a file named
`amdaemontest.bat` in `App\bin`, then paste the code block below into the file.
```batch
@echo off
cls
echo Attempting to run AM Daemon ...
echo Window should close after 30 seconds
echo Log will be generated at amdaemontest.txt
call :sub >amdaemontest.txt
exit /b
:sub
set OPENSSL_ia32cap=:~0x20000000
pushd %~dp0
start /b "AM Daemon" /min inject -d -k mu3hook.dll amdaemon.exe -f -c config_common.json config_server.json
ping 127.0.0.1 -n 31 > nul && taskkill /F /im amdaemon.exe
```
Double-click it to run. The script should run for 30 seconds, and you will get a file
named `amdaemontest.txt` in `App\bin`, which you can send to help people troubleshoot your issue.
---
### My game is stuck on a black screen at launch!
!!! tip ""
This could also be due to **many** things, the most common of which are:
- You have one or more incorrect/broken DLL(s) in `App\Package\Sinmai_Data\Managed`
This is likely to be `Assembly-CSharp.dll`, `Assembly-CSharp-firstpass.dll`, and/or `AMDaemon.NET.dll`.
You can try replacing the DLLs or re-downloading data from elsewhere.
- An ill-formed keychip is defined in `segatools.ini`
- You need to app the OpenSSL fix on Intel Core 10th Gen CPUs and newer.
---
### My game is stuck on a blue and black screen!
You need to run the data using unprotected/unpacked files. Please refer to the setup guide to find which ones you need and obtain them.
If you belive you've already done this. You might be missing a try installing the latest [vcredist](https://github.com/abbodi1406/vcredist/releases)
---
### My game is running too slow/fast or the notes are out of sync!
!!! tip ""
The game could be running under or over its required refresh rate.
- Make sure V-Sync isn't disabled in your graphics settings (called "Vertical sync"
in NVIDIA Control Panel and "Wait for Vertical Refresh" in AMD Control Panel.)
- Limit `Sinmai.exe` to run at 60 FPS using a tool like [RivaTuner](https://www.guru3d.com/download/rtss-rivatuner-statistics-server-download) or a patch.
It could also be that your computer's performance isn't good enough to keep
a steady framerate.

View File

@ -1,7 +1,4 @@
# maimai DX BUDDiES
<img src="/img/maimaidx/buddies.png">
---
### Coming Soon
--8<-- "docs/games/mai2/controllers.md"

View File

@ -1,345 +1,4 @@
# maimai DX BUDDiES
<img src="/img/maimaidx/buddies.png">
!!! danger "Please make sure you downloaded your data from an appropriate source.<br>This guide is unable to troubleshoot any problems related to bad or poorly managed data."
!!! danger "If you're coming from a previous version of maimai DX"
Create a new folder for the game and start from scratch.
maimai DX **DOES NOT** like being extracted over old data!
---
### Preparing data
!!! danger "There are currently issues with running game data in the `E:\` or `Y:\` drive.<br>Please extract the data into other drives."
!!! tip ""
After downloading and extracting your data, we need to make sure your files
are not set to `Read-only`.
- Right click the folder containing your data, then click on `Properties`.
- In the `General` tab go down to `Attributes`, untick `Read-only` and click `Apply`.
- A popup will appear, select `Apply changes to this folder, subfolder and files`and press `OK`.
- Finally, click `OK` again to exit out of properties.
You should end up with a file structure as follows.
<img width="500" src="/img/maimaidx/setup/rootdir.png">
Create two new empty folders named `appdata` and `amfs` (and the folder `option` if not present) next to them as shown below:
<img width="500" src="/img/maimaidx/setup/rootdir2.png">
The `App` folder should have a file structure as follows.
<img width="500" src="/img/maimaidx/setup/appdir.png">
??? warning "If your data doesn't look like this"
If your data looks like the third image:
- Create an `App` folder and move all files and folders from the image inside of it.
- Create empty folders named `amfs`, `Option` and `AppData` next to the `App` folder.
If extra files are present next to your folders, such as executables, scripts, etc..
**remove them. This also means your data was tampered with and we strongly recommend
getting new data from somewhere else.**
#### Installing ICFs
!!! tip ""
Install Configuration Files (ICFs) tell the game what version it is.
**Without this your game cannot go online!**
If your `amfs` folder already has files`ICF1` and `ICF2`, skip this step.
Otherwise, obtain copies of `ICF1` for your game version and place it in
the `amfs` folder. If it is named something else, rename it to exactly
`ICF1` **without any file extensions.** `ICF2` is a copy of `ICF1`.
??? info "Showing File Extensions"
By default, file extensions on Windows are hidden. Enable them by navigating to
the `View` tab in File Explorer and select `File name extensions`.
#### Installing Unprotected Executables
!!! tip ""
maimai DX executables are protected and will not run on a regular computer.
Obtain unprotected (also called "unpacked" or "decrypted" by the community)
copies of the following files and the associated configuration file:
- amdaemon.exe
- Sinmai.exe
- Sinmai_Data/Plugins/amdaemon_api.dll
- Sinmai_Data/Plugins/Cake.dll
- Sinmai_Data/Managed/AMDaemon.NET.dll
- Sinmai_Data/Managed/Assembly-CSharp.dll
- mai2.ini or maimaiDX.ini
Copy the files and folders into the `App/Package` folder of your game data. Agree to overwrite
when asked.
!!! Warning "Assembly-CSharp Notes"
`Assembly-CSharp.dll` **must** match your game version. All others can be
reused from other game versions.
`Assembly-CSharp.dll` **must** also contain `mai2.ini` or `maimaiDX.ini`. These configuration
files are specific to the unprotected `Assembly-CSharp.dll`. If your package does not
contain a configuration file, please create one with the following to bypass hardware
checks on game startup:
```ini
[AM]
Target=0
IgnoreError=1
DummyTouchPanel=1
DummyLED=1
DummyCodeCamera=1
DummyPhotoCamera=1
[Sound]
Sound8Ch=0
[Patches]
EnablePatchLog=1
```
!!! tip "If the assembly supports it, `App/Package/dpPatchLog.log` lists supported patches after the first run. Otherwise see [Custom Mods](#custom-mods)"
---
### Installing Segatools
!!! tip ""
- Head over to [segatools releases](https://gitea.tendokyu.moe/Dniel97/segatools/releases/latest)
and download the latest `segatools.zip`. **Do not download the source code.**
- Extracting the archive should give you a few more zip files. Find `mai2.zip`
and extract it to the `App/Package` folder in your game data.
You should now have a few more files inside the `App/Package` folder, as highlighted:
<img width="500" src="/img/maimaidx/setup/segatools.png">
---
### Configuring Segatools
!!! tip ""
Since there is no graphical configuration tool for segatools, you will have to edit the
configuration file by hand. It is found in `App/Package/segatools.ini`.
It is recommended that you follow along using a text editor with syntax highlighting such as [Notepad++](https://notepad-plus-plus.org/).
Each following sub-section will correspond to a section in `segatools.ini`. If any
section is not mentioned, you can skip them.
!!! warning
If a key already exists in the section, delete everything after `=` and replace it with your
setting. Do not add another key. Example:
```ini
[system]
dipsw2=1
dipsw2=1 ; WRONG!
```
#### `[vfs]`
!!! tip ""
If you've been matching the file structure as described in the [Preparing data](#preparing-data)
section, you can fill in this section with the values below:
```ini
[vfs]
amfs=../../amfs
option=../../option
appdata=../../appdata
```
#### `[dns]`
!!! tip ""
Game will not pass checks unless you modify the dns:
```ini
[dns]
default=YOUR_IPv4_ADDRESS
```
??? tip "Finding Your IPv4 Address"
Open a command promt. Type `ipconfig` and look for the IPv4 Address.
Place those digits here otherwise you will get stuck on the DNS(LAN) check.
---
### Pre-launch requirements
!!! info "These steps are required, otherwise your game won't run."
#### VCRedist & DirectX
!!! tip ""
- Download and install the latest [VCRedist](https://github.com/abbodi1406/vcredist/releases/latest) (`VisualCppRedist_AIO_x86_x64.exe`)
- Download and install the [DirectX End-User Runtimes](https://www.microsoft.com/en-us/download/details.aspx?id=8109)
#### Audio
!!! tip ""
- Right-click on the volume setting in your taskbar and select `Sounds`.
- Navigate to the `Playback` tab, right click on your default audio device, and click on `Properties`.
- Go to the `Advanced` tab.
- Check both boxes under `Exclusive Mode`.
- Open the `Default Format` dropdown.
- Pick either `16 bit, 48000Hz (DVD Quality)` or `24 bit, 48000Hz (Studio Quality)`, click `Apply`, then `OK`.
<img src="/img/maimaidx/setup/audio.png">
#### Fixing OpenSSL on Intel 10th Gen and newer CPUs
!!! tip ""
If you have an Intel 10th Gen CPU or newer, right click `App/Package/start.bat`, select `Edit`, and add the
highlighted line to the top of the file.
```batch hl_lines="2"
@echo off
set OPENSSL_ia32cap=:~0x20000000
pushd %~dp0
...
```
---
### Test Launch
!!! danger "If you have any issues running the game, refer to the [Troubleshooting](troubleshooting.md) page."
!!! warning "Please Disconnect any Hardware including Controllers or Card Readers at this time."
!!! tip
Without an English patch, the service menu will be in Japanese. If you don't know Japanese, [Google Lens](https://lens.google/)
is a handy tool for navigating this menu.
#### Game Settings
!!! tip ""
If you've followed all instructions correctly, you are ready to launch the game!
Start the game by running `App/Package/start.bat`. You should see a terminal pop-up with the following:
<img src="/img/maimaidx/setup/cmd.png">
Another window titled `Sinmai` is the actual game. It should pause on `Search for Distribution Servers`:
<img src="/img/maimaidx/setup/distribution_servers_check.png">
!!! tip ""
Use the following keyboard controls `F1` = `Test/Enter` and `c` = `down` to do the following:
- Press `F1` to enter the service menu
- Press `c` a few times to navigate to `Game Settings` or `ゲーム設定` as shown below:
<img src="/img/maimaidx/setup/service_menu.png">
- Press `F1` to enter the menu. Press `c` to navigate to the top option and toggle to `OFF` using `F1`. You should see the following:
<img src="/img/maimaidx/setup/service_game_settings.png">
- Press `ESC` to exit. Close all associated windows including `CMD`, `AMDaemon`, and `Sinmai`. Relaunch with `start.bat` and the game should boot into guest mode.
---
### Connecting to a Network
!!! danger "Please choose one of the two solutions, not both!"
??? tip "Remote (Online Network)"
Head to the `[dns]` section inside `segatools.ini`. Set `default` to the address
provided by your network. **Do not add `http://` or `https://` to the address!**
```ini
[dns]
default=network.example
```
Then, head to the `[keychip]` section and add & set `id` to the keychip ID provided by your network:
```ini
[keychip]
subnet=192.168.172.0
id=A69E-XXXXXXXXXXX
```
Finally, you need a card number. Create a file named `aime.txt` inside `App/Package/DEVICE` and type in
your 20-digit access code if you already have one, or make one up if you don't. If you're making one
up, the access code **MUST NOT** start with a 3.
<img src="/img/maimaidx/setup/access_code.png">
??? tip "Local (ARTEMiS/AquaDX)"
Both of these options require non-trivial setup. Refer to the official guides for [ARTEMiS](https://gitea.tendokyu.moe/Hay1tsme/artemis/src/branch/develop/docs/INSTALL_WINDOWS.md)
and [AquaDX](https://github.com/hykilpikonna/AquaDX?tab=readme-ov-file#usage-v1-developmental-preview)
to set up a local server.
---
### Further Configuration
#### Updating the Base Game
!!! tip ""
Extract your patch's files to your existing data in a way that matches its
file structure. Agree to overwrite files if necessary.
!!! Warning "Only update if an unencrypted `Assembly-CSharp.dll` is available"
#### Installing Option Data
!!! tip ""
maimai DX content updates are distributed through option folders instead of patching
the base game. They are named with a letter followed by three numbers. Each release
increments the letter (ie. BUDDiES is `H???` and BUDDiES+ is `I???`).
Extract any options you've downloaded into the `option` folder. You should end up with
a file structure as follows. **Do not be worried if you have fewer or more option folders.**
<img width="500" src="/img/maimaidx/setup/options.png">
!!! warning "Do not mix option data between versions"
---
### Custom Mods
!!! info "Mods are covered on the [Unity modding](../../../extras/unity.md) page."
### Controllers and Troubleshooting
!!! info "Input methods and controllers are covered in the [Controllers](controllers.md) page."
!!! warning "Have any other issues?"
Check out the [Troubleshooting](troubleshooting.md) and [Error Codes](../../../errorcodes/sega.md) pages.
--8<-- "docs/games/mai2/setup.md"

View File

@ -1,7 +1,4 @@
# maimai DX BUDDiES
<img src="/img/maimaidx/buddies.png">
---
### Coming Soon
--8<-- "docs/games/mai2/troubleshooting.md"

View File

@ -0,0 +1,6 @@
# maimai DX PRiSM
<div style="text-align: center;">
<img src="/img/maimaidx/prism.png" width="50%">
</div>
--8<-- "docs/games/mai2/controllers.md"

View File

@ -0,0 +1,6 @@
# maimai DX PRiSM
<div style="text-align: center;">
<img src="/img/maimaidx/prism.png" width="50%">
</div>
--8<-- "docs/games/mai2/setup.md"

View File

@ -0,0 +1,6 @@
# maimai DX PRiSM
<div style="text-align: center;">
<img src="/img/maimaidx/prism.png" width="50%">
</div>
--8<-- "docs/games/mai2/troubleshooting.md"

View File

@ -0,0 +1,6 @@
# maimai DX PRiSM PLUS
<div style="text-align: center;">
<img src="/img/maimaidx/prismplus.png" width="50%">
</div>
--8<-- "docs/games/mai2/controllers.md"

View File

@ -0,0 +1,6 @@
# maimai DX PRiSM PLUS
<div style="text-align: center;">
<img src="/img/maimaidx/prismplus.png" width="50%">
</div>
--8<-- "docs/games/mai2/setup.md"

View File

@ -0,0 +1,6 @@
# maimai DX PRiSM PLUS
<div style="text-align: center;">
<img src="/img/maimaidx/prismplus.png" width="50%">
</div>
--8<-- "docs/games/mai2/troubleshooting.md"

363
docs/games/mu3/setup.md Normal file
View File

@ -0,0 +1,363 @@
!!! danger "Please make sure you downloaded your data from an appropriate source.<br>This guide is unable to troubleshoot any problems related to bad or poorly managed data."
!!! danger "If you're coming from a previous version of O.N.G.E.K.I."
You'll want to create a new folder for the game and start from scratch.
O.N.G.E.K.I. **DOES NOT** like being extracted over old data!
---
### Preparing data
!!! danger "There are currently issues with running game data in the `E:\` or `Y:\` drive.<br>Please extract the data into other drives."
!!! tip ""
After downloading and extracting your data, we need to make sure your files
aren't set to `Read-only`.
- Right click the folder containing your data, then click on `Properties`.
- In the `General` tab go down to `Attributes`, untick `Read-only` and click `Apply`.
- A popup will appear, select `Apply changes to this folder, subfolder and files`
and press `OK`.
- Finally, click `OK` again to exit out of properties.
You should end up with a file structure as follows.
<img width="500" src="/img/ongeki/sddt/setup/0_ongekidata.png">
Create another empty folder named `AppData` next to them. It should now look like below.
<img width="500" src="/img/ongeki/sddt/setup/0_ongekidata_withappdata.png">
The `App` folder should have a file structure as follows.
<img width="500" src="/img/ongeki/sddt/setup/1_ongekiapp.png">
??? warning "If your data doesn't look like this"
If your data looks like the third image:
- Create an `App` folder and move all files and folders from the image inside of it.
- Create empty folders named `amfs`, `Option` and `AppData` next to the `App` folder.
If extra files are present next to your folders, such as executables, scripts, etc..
**remove them. This also means your data was tampered with and we strongly recommend
getting new data from somewhere else.**
#### Updating the base game
!!! tip ""
Extract your patch's files to your existing data in a way that matches its
file structure. Agree to overwrite files if necessary.
#### Installing option data
!!! tip ""
O.N.G.E.K.I. content updates are distributed through option folders instead of patching
the base game. They are named `A???`, with each `?` being a number. Custom options
distributed by the community might use letters instead, to distinguish them from
official ones.
Extract any options you've downloaded into the `Option` folder. You should end up with
a file structure as follows. **Do not be worried if you have fewer or more option folders.**
In some cases, your data may have options in `App\package\option`. If so, move
all contents inside to the `Option` folder where `App` and `AppData` are and delete the `App\package\option` folder.
<img width="500" src="/img/ongeki/sddt/setup/2_ongekioption.png">
#### Installing ICFs
!!! tip ""
Install Configuration Files (ICFs) tell the game what version it is.
**Without this your game cannot go online!**
If your `amfs` folder already has a file named `ICF1`, skip this step.
In some cases, your data may have a folder containing ICFs in `App\package\amfs`.
If so, move all contents inside to the `amfs` folder where `App` and `AppData`,
delete the `App\package\amfs` folder, and skip this step.
Otherwise, obtain copies of `ICF1` for your game version and place it in
the `amfs` folder. If it is named something else, rename it to exactly
`ICF1` **without any file extensions.**
!!! info "Showing file extensions"
By default, file extensions on Windows are hidden. Enable them by navigating to
the `View` tab in File Explorer and select `File name extensions`.
#### Installing unprotected executables
!!! tip ""
O.N.G.E.K.I. executables are protected and will not run on a regular computer.
Obtain unprotected (also called "unpacked" or "decrypted" by the community)
copies of the following files:
- `amdaemon.exe`
- `mu3.exe`
- `mu3_Data\Plugins\amdaemon_api.dll`
- `mu3_Data\Managed\AMDaemon.NET.dll`
- `mu3_Data\Managed\Assembly-CSharp-firstpass.dll`
- `mu3_Data\Managed\Assembly-CSharp.dll`
Copy the files and folders into the `App/Package` folder of your game data. Agree to overwrite
when asked.
!!! Warning "Assembly-CSharp Note"
`Assembly-CSharp.dll` **must** match your game version.
---
### Installing segatools
!!! tip ""
- Head over to [segatools releases](https://gitea.tendokyu.moe/Dniel97/segatools/releases)
and download `segatools.zip`. **Do not download the source code.**
- Extracting the archive should give you a few more zip files. Find **`mu3.zip`**
and extract it to the `App\package` folder in your game data.
You should now have a few more files inside the folder, as highlighted:
<img width="500" src="/img/ongeki/sddt/setup/3_ongeki_segatools_installed.png">
---
### Configuring segatools
!!! tip ""
Since there is no graphical configuration tool for segatools, you will have to edit the
configuration file by hand. It is found in `App\package\segatools.ini`.
It is recommended that you follow along using a text editor with syntax highlighting such as [Notepad++](https://notepad-plus-plus.org/).
Each following sub-section will correspond to a section in `segatools.ini`. If any
section is not mentioned, you can skip them.
!!! warning
If a key already exists in the section, delete everything after `=` and replace it with your
setting. Do not add another key.
```ini
[system]
dipsw1=1
dipsw1=1 ; WRONG!
```
#### `[vfs]`
!!! tip ""
If you've been matching the file structure as described in the [Preparing data](#preparing-data)
section, you can fill in this section with the values below:
```ini
[vfs]
amfs=../../amfs
option=../../Option
appdata=../../AppData
```
---
### Setting launch options
!!! tip ""
Right click `App\package\start.bat`, select `Edit`. Locate the line that launches `mu3` and edit it according to your preferences:
```bat hl_lines="6"
@echo off
pushd %~dp0
start "AM Daemon" /min inject -d -k mu3hook.dll amdaemon.exe -f -c config_common.json config_server.json config_client.json
inject -d -k mu3hook.dll mu3 -screen-fullscreen 0 -popupwindow -screen-width 1080 -screen-height 1920
taskkill /f /im amdaemon.exe > nul 2>&1
echo.
echo Game processes have terminated
pause
```
??? tip "Launch options"
* `-screen-fullscreen 0`: windowed
* `-screen-fullscreen 0 -popupwindow`: borderless windowed
* `-screen-fullscreen 1`: exclusive fullscreen
* `-screen-width <W> -screen-height <H>`: resolution
??? warning "Note about resolution"
- The service menu will only render correctly at 1080x1920.
- This can be fixed with a patch.
* `-monitor <N>`: the monitor to run the game on
??? info "Getting the monitor index"
Navigate to Windows display settings. Each monitor should be assigned a number.
The monitor index is that number. For example, monitor 2 means `-monitor 2`.
---
### Connecting to a network
!!! danger "Please choose one of the two solutions, not both!"
??? tip "Remote (Online Network)"
Head to the `[dns]` section inside `segatools.ini`. Set `default` to the address
provided by your network. **Do not add `http://` or `https://` to the address!**
```ini
[dns]
default=network.example
```
Then, head to the `[keychip]` section and add & set `id` to the keychip ID provided by your network:
```ini
[keychip]
subnet=192.168.139.0
id=A69E-XXXXXXXXXXX
```
Finally, you need a card number. Create a file named `aime.txt` inside `App\package\DEVICE` and type in
your 20-digit access code if you already have one, or make one up if you don't. If you're making one
up, the access code **MUST NOT** start with a 3.
<img src="/img/ongeki/sddt/setup/4_access_code.png">
??? warning "Local (ARTEMiS/AquaDX)"
Both of these options require non-trivial setup. Refer to the official guides for [ARTEMiS](https://gitea.tendokyu.moe/Hay1tsme/artemis/src/branch/develop/docs/INSTALL_WINDOWS.md)
and [AquaDX](https://github.com/hykilpikonna/AquaDX?tab=readme-ov-file#usage-v1-developmental-preview)
to set up a local server.
---
### Pre-launch requirements
!!! info "These steps are required, otherwise your game won't run."
#### VCRedist & DirectX
!!! tip ""
- Download and install the latest [VCRedist](https://github.com/abbodi1406/vcredist/releases/latest) (`VisualCppRedist_AIO_x86_x64.exe`)
- Download and install the [DirectX End-User Runtimes](https://www.microsoft.com/en-us/download/details.aspx?id=8109)
#### Audio
!!! tip ""
- Open `App\package\mu3.ini` (or create it if it doesn't exist).
- Set `WasapiExclusive` in the `Sound` section to `0` (create the key if it doesn't exist):
```ini
[Sound]
WasapiExclusive=0
```
#### Fixing OpenSSL on Intel 10th Gen and newer CPUs
!!! tip ""
If you have an Intel 10th Gen CPU or newer, right click `App\package\start.bat`, select `Edit`, and add the
highlighted line to the top of the file.
```batch hl_lines="2"
@echo off
set OPENSSL_ia32cap=:~0x20000000
pushd %~dp0
...
```
---
### First launch
!!! danger "If you have any issues running the game, refer to the [Troubleshooting](../ongekibrightmemory/troubleshooting.md) page."
!!! tip
Without an English patch, the service menu will be in Japanese. If you don't know Japanese, [Google Lens](https://lens.google/)
is a handy tool for navigating this menu.
#### GAME ASSIGNMENTS
!!! tip ""
If you've followed all instructions correctly, you're now finally ready to launch the game!
Start the game by running `App\package\start.bat`. Let the game load until you reach a screen with the message below.
<img src="/img/ongeki/sddt/setup/4_ongeki_groupcheck.png">
!!! tip ""
Press your `Test` button (default `F1`) to enter the service menu. Use the `Service` button
(default `F2`) to navigate the menu, and `Test` button to select an option.
Navigate to **ゲーム設定** (`GAME ASSIGNMENTS`, the 6th option).
<img src="/img/ongeki/sddt/setup/servicemenu/1_gamesettings.png">
!!! tip ""
Select **グループ内基準機の設定** (`SET STANDARD IN GROUP`, the second option)
and toggle this setting to **基準機** (`STANDARD`).
<img src="/img/ongeki/sddt/setup/servicemenu/2_reference.png">
!!! tip ""
Select **終了** (`EXIT`, the last option) to exit to the main service menu.
#### CLOSE SETTING
!!! tip ""
Navigate to **閉店設定** (`CLOSE SETTING`, the 10th option).
<img src="/img/ongeki/sddt/setup/servicemenu/3_closesetting.png">
!!! tip ""
Navigate to **時** (`HOUR`, the 2nd option) and use the `Service` button
to toggle the setting until it says **全時刻** (`ALL TIME`).
<img src="/img/ongeki/sddt/setup/servicemenu/4_alltime.png">
!!! tip ""
Select **終了** (`EXIT`, the last option) to exit to the main service menu, then select **終了**
(also the last option) in the main menu to exit the service menu.
!!! tip ""
You're all done! The game should load up properly now.
You can add coins using the `Coin` key (default `F3`) and card in by holding the `Enter` key.
---
### Custom Mods
!!! info "Mods are covered on the [Unity modding](../../extras/unity.md) page."
### Controllers and Troubleshooting
!!! info "Input methods and controllers are covered on the [Controllers](../ongekibrightmemory/controllers.md) page."
!!! warning "Have any other issues?"
Check out the [Troubleshooting](../mu3/troubleshooting.md) and [Error Codes](../../errorcodes/sega.md) pages.

View File

@ -7,10 +7,10 @@
!!! tip ""
Could be due to **many** things, the most common of which are:
- `amdaemon` crashing in the background. Make sure that the `config_*.json` files
have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
??? info "Capturing logs from `amdaemon` for troubleshooting"
To assist with troubleshooting, a script can be used to capture logs from `amdaemon`. Create a file named
@ -28,7 +28,7 @@
:sub
set OPENSSL_ia32cap=:~0x20000000
pushd %~dp0
start /b "AM Daemon" /min inject -d -k mu3hook.dll amdaemon.exe -f -c config_common.json config_server.json
start /b "AM Daemon" /min inject -d -k mu3hook.dll amdaemon.exe -f -c config_common.json config_server.json
ping 127.0.0.1 -n 31 > nul && taskkill /F /im amdaemon.exe
```
@ -41,9 +41,9 @@
!!! tip ""
This could also be due to **many** things, the most common of which are:
- You have one or more incorrect/broken DLL(s) in `App\package\mu3_Data\Managed`
This is likely to be `Assembly-CSharp.dll`, `Assembly-CSharp-firstpass.dll`, and/or `AMDaemon.NET.dll`.
You can try replacing the DLLs or re-downloading data from elsewhere.
- An ill-formed keychip is defined in `segatools.ini`
@ -55,7 +55,7 @@
!!! tip ""
The game could be running under or over its required refresh rate.
- Make sure V-Sync isn't disabled in your graphics settings (called "Vertical sync"
in NVIDIA Control Panel and "Wait for Vertical Refresh" in AMD Control Panel.)
- Limit `mu3.exe` to run at 60 FPS using a tool like [RivaTuner](https://www.guru3d.com/download/rtss-rivatuner-statistics-server-download) or a patch.
@ -83,3 +83,32 @@
For NVIDIA users, create an override for `mu3.exe` in NVIDIA Control Panel
and change "Power management mode" to "**Prefer maximum performance**".
---
### I can't insert credits!
!!! tip ""
Open `App\package\config_common.json` and find the `credit` section. From here, set `freeplay` to `true`
```json hl_lines="8"
"credit" :
{
"max_credit" : 24,
"config" :
{
"coin_chute_type_common" : true,
"service_type_common" : true,
"freeplay" : true,
"coin_chute_multiplier" : [ 1, 1 ],
"coin_to_credit" : 1,
"bonus_adder" : 0,
"game_cost" : [ 1 ]
}
},
```
Then delete the `amfs\sysfile.dat` folder and the `AppData\SDDT` folder
After re-launching the game, you should be able to play by purchasing GP

View File

@ -2,367 +2,4 @@
<div style="text-align: center;">
<img src="/img/ongeki/sddt/brightmemory.png" width="50%">
</div>
!!! danger "Please make sure you downloaded your data from an appropriate source.<br>This guide is unable to troubleshoot any problems related to bad or poorly managed data."
!!! danger "If you're coming from a previous version of O.N.G.E.K.I."
You'll want to create a new folder for the game and start from scratch.
O.N.G.E.K.I. **DOES NOT** like being extracted over old data!
---
### Preparing data
!!! danger "There are currently issues with running game data in the `E:\` or `Y:\` drive.<br>Please extract the data into other drives."
!!! tip ""
After downloading and extracting your data, we need to make sure your files
aren't set to `Read-only`.
- Right click the folder containing your data, then click on `Properties`.
- In the `General` tab go down to `Attributes`, untick `Read-only` and click `Apply`.
- A popup will appear, select `Apply changes to this folder, subfolder and files`
and press `OK`.
- Finally, click `OK` again to exit out of properties.
You should end up with a file structure as follows.
<img width="500" src="/img/ongeki/sddt/setup/0_ongekidata.png">
Create another empty folder named `AppData` next to them. It should now look like below.
<img width="500" src="/img/ongeki/sddt/setup/0_ongekidata_withappdata.png">
The `App` folder should have a file structure as follows.
<img width="500" src="/img/ongeki/sddt/setup/1_ongekiapp.png">
??? warning "If your data doesn't look like this"
If your data looks like the third image:
- Create an `App` folder and move all files and folders from the image inside of it.
- Create empty folders named `amfs`, `Option` and `AppData` next to the `App` folder.
If extra files are present next to your folders, such as executables, scripts, etc..
**remove them. This also means your data was tampered with and we strongly recommend
getting new data from somewhere else.**
#### Updating the base game
!!! tip ""
Extract your patch's files to your existing data in a way that matches its
file structure. Agree to overwrite files if necessary.
#### Installing option data
!!! tip ""
O.N.G.E.K.I. content updates are distributed through option folders instead of patching
the base game. They are named `A???`, with each `?` being a number. Custom options
distributed by the community might use letters instead, to distinguish them from
official ones.
Extract any options you've downloaded into the `Option` folder. You should end up with
a file structure as follows. **Do not be worried if you have fewer or more option folders.**
In some cases, your data may have options in `App\package\option`. If so, move
all contents inside to the `Option` folder where `App` and `AppData` are and delete the `App\package\option` folder.
<img width="500" src="/img/ongeki/sddt/setup/2_ongekioption.png">
#### Installing ICFs
!!! tip ""
Install Configuration Files (ICFs) tell the game what version it is.
**Without this your game cannot go online!**
If your `amfs` folder already has a file named `ICF1`, skip this step.
In some cases, your data may have a folder containing ICFs in `App\package\amfs`.
If so, move all contents inside to the `amfs` folder where `App` and `AppData`,
delete the `App\package\amfs` folder, and skip this step.
Otherwise, obtain copies of `ICF1` for your game version and place it in
the `amfs` folder. If it is named something else, rename it to exactly
`ICF1` **without any file extensions.**
!!! info "Showing file extensions"
By default, file extensions on Windows are hidden. Enable them by navigating to
the `View` tab in File Explorer and select `File name extensions`.
#### Installing unprotected executables
!!! tip ""
O.N.G.E.K.I. executables are protected and will not run on a regular computer.
Obtain unprotected (also called "unpacked" or "decrypted" by the community)
copies of the following files:
- `amdaemon.exe`
- `mu3.exe`
- `mu3_Data\Plugins\amdaemon_api.dll`
- `mu3_Data\Managed\AMDaemon.NET.dll`
- `mu3_Data\Managed\Assembly-CSharp-firstpass.dll`
- `mu3_Data\Managed\Assembly-CSharp.dll`
Copy the files and folders into the `App/Package` folder of your game data. Agree to overwrite
when asked.
!!! Warning "Assembly-CSharp Note"
`Assembly-CSharp.dll` **must** match your game version.
---
### Installing segatools
!!! tip ""
- Head over to [segatools releases](https://gitea.tendokyu.moe/Dniel97/segatools/releases)
and download `segatools.zip`. **Do not download the source code.**
- Extracting the archive should give you a few more zip files. Find **`mu3.zip`**
and extract it to the `App\package` folder in your game data.
You should now have a few more files inside the folder, as highlighted:
<img width="500" src="/img/ongeki/sddt/setup/3_ongeki_segatools_installed.png">
---
### Configuring segatools
!!! tip ""
Since there is no graphical configuration tool for segatools, you will have to edit the
configuration file by hand. It is found in `App\package\segatools.ini`.
It is recommended that you follow along using a text editor with syntax highlighting such as [Notepad++](https://notepad-plus-plus.org/).
Each following sub-section will correspond to a section in `segatools.ini`. If any
section is not mentioned, you can skip them.
!!! warning
If a key already exists in the section, delete everything after `=` and replace it with your
setting. Do not add another key.
```ini
[system]
dipsw1=1
dipsw1=1 ; WRONG!
```
#### `[vfs]`
!!! tip ""
If you've been matching the file structure as described in the [Preparing data](#preparing-data)
section, you can fill in this section with the values below:
```ini
[vfs]
amfs=../../amfs
option=../../Option
appdata=../../AppData
```
---
### Setting launch options
!!! tip ""
Right click `App\package\start.bat`, select `Edit`. Locate the line that launches `mu3` and edit it according to your preferences:
```bat hl_lines="6"
@echo off
pushd %~dp0
start "AM Daemon" /min inject -d -k mu3hook.dll amdaemon.exe -f -c config_common.json config_server.json config_client.json
inject -d -k mu3hook.dll mu3 -screen-fullscreen 0 -popupwindow -screen-width 1080 -screen-height 1920
taskkill /f /im amdaemon.exe > nul 2>&1
echo.
echo Game processes have terminated
pause
```
??? tip "Launch options"
* `-screen-fullscreen 0`: windowed
* `-screen-fullscreen 0 -popupwindow`: borderless windowed
* `-screen-fullscreen 1`: exclusive fullscreen
* `-screen-width <W> -screen-height <H>`: resolution
??? warning "Note about resolution"
- The service menu will only render correctly at 1080x1920.
- This can be fixed with a patch.
* `-monitor <N>`: the monitor to run the game on
??? info "Getting the monitor index"
Navigate to Windows display settings. Each monitor should be assigned a number.
The monitor index is that number. For example, monitor 2 means `-monitor 2`.
---
### Connecting to a network
!!! danger "Please choose one of the two solutions, not both!"
??? tip "Remote (Online Network)"
Head to the `[dns]` section inside `segatools.ini`. Set `default` to the address
provided by your network. **Do not add `http://` or `https://` to the address!**
```ini
[dns]
default=network.example
```
Then, head to the `[keychip]` section and add & set `id` to the keychip ID provided by your network:
```ini
[keychip]
subnet=192.168.139.0
id=A69E-XXXXXXXXXXX
```
Finally, you need a card number. Create a file named `aime.txt` inside `App\package\DEVICE` and type in
your 20-digit access code if you already have one, or make one up if you don't. If you're making one
up, the access code **MUST NOT** start with a 3.
<img src="/img/ongeki/sddt/setup/4_access_code.png">
??? warning "Local (ARTEMiS/AquaDX)"
Both of these options require non-trivial setup. Refer to the official guides for [ARTEMiS](https://gitea.tendokyu.moe/Hay1tsme/artemis/src/branch/develop/docs/INSTALL_WINDOWS.md)
and [AquaDX](https://github.com/hykilpikonna/AquaDX?tab=readme-ov-file#usage-v1-developmental-preview)
to set up a local server.
---
### Pre-launch requirements
!!! info "These steps are required, otherwise your game won't run."
#### VCRedist & DirectX
!!! tip ""
- Download and install the latest [VCRedist](https://github.com/abbodi1406/vcredist/releases/latest) (`VisualCppRedist_AIO_x86_x64.exe`)
- Download and install the [DirectX End-User Runtimes](https://www.microsoft.com/en-us/download/details.aspx?id=8109)
#### Audio
!!! tip ""
- Open `App\package\mu3.ini` (or create it if it doesn't exist).
- Set `WasapiExclusive` in the `Sound` section to `0` (create the key if it doesn't exist):
```ini
[Sound]
WasapiExclusive=0
```
#### Fixing OpenSSL on Intel 10th Gen and newer CPUs
!!! tip ""
If you have an Intel 10th Gen CPU or newer, right click `App\package\start.bat`, select `Edit`, and add the
highlighted line to the top of the file.
```batch hl_lines="2"
@echo off
set OPENSSL_ia32cap=:~0x20000000
pushd %~dp0
...
```
---
### First launch
!!! danger "If you have any issues running the game, refer to the [Troubleshooting](../ongekibrightmemory/troubleshooting.md) page."
!!! tip
Without an English patch, the service menu will be in Japanese. If you don't know Japanese, [Google Lens](https://lens.google/)
is a handy tool for navigating this menu.
#### GAME ASSIGNMENTS
!!! tip ""
If you've followed all instructions correctly, you're now finally ready to launch the game!
Start the game by running `App\package\start.bat`. Let the game load until you reach a screen with the message below.
<img src="/img/ongeki/sddt/setup/4_ongeki_groupcheck.png">
!!! tip ""
Press your `Test` button (default `F1`) to enter the service menu. Use the `Service` button
(default `F2`) to navigate the menu, and `Test` button to select an option.
Navigate to **ゲーム設定** (`GAME ASSIGNMENTS`, the 6th option).
<img src="/img/ongeki/sddt/setup/servicemenu/1_gamesettings.png">
!!! tip ""
Select **グループ内基準機の設定** (`SET STANDARD IN GROUP`, the second option)
and toggle this setting to **基準機** (`STANDARD`).
<img src="/img/ongeki/sddt/setup/servicemenu/2_reference.png">
!!! tip ""
Select **終了** (`EXIT`, the last option) to exit to the main service menu.
#### CLOSE SETTING
!!! tip ""
Navigate to **閉店設定** (`CLOSE SETTING`, the 10th option).
<img src="/img/ongeki/sddt/setup/servicemenu/3_closesetting.png">
!!! tip ""
Navigate to **時** (`HOUR`, the 2nd option) and use the `Service` button
to toggle the setting until it says **全時刻** (`ALL TIME`).
<img src="/img/ongeki/sddt/setup/servicemenu/4_alltime.png">
!!! tip ""
Select **終了** (`EXIT`, the last option) to exit to the main service menu, then select **終了**
(also the last option) in the main menu to exit the service menu.
!!! tip ""
You're all done! The game should load up properly now.
You can add coins using the `Coin` key (default `F3`) and card in by holding the `Enter` key.
---
### Custom Mods
!!! info "Mods are covered on the [Unity modding](../../extras/unity.md) page."
### Controllers and Troubleshooting
!!! info "Input methods and controllers are covered on the [Controllers](../ongekibrightmemory/controllers.md) page."
!!! warning "Have any other issues?"
Check out the [Troubleshooting](../mu3/troubleshooting.md) and [Error Codes](../../errorcodes/sega.md) pages.
--8<-- "docs/games/mu3/setup.md"

View File

@ -0,0 +1,5 @@
# Controllers (O.N.G.E.K.I. Re:Fresh)
<div style="text-align: center;">
<img src="/img/ongeki/sddt/refresh.png" width="50%">
</div>
--8<-- "docs/games/mu3/controllers.md"

View File

@ -0,0 +1,5 @@
# Game Setup (O.N.G.E.K.I. Re:Fresh)
<div style="text-align: center;">
<img src="/img/ongeki/sddt/refresh.png" width="50%">
</div>
--8<-- "docs/games/mu3/setup.md"

View File

@ -0,0 +1,5 @@
# Troubleshooting (O.N.G.E.K.I. Re:Fresh)
<div style="text-align: center;">
<img src="/img/ongeki/sddt/refresh.png" width="50%">
</div>
--8<-- "docs/games/mu3/troubleshooting.md"

BIN
docs/img/maimaidx/prism.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 75 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 239 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 56 KiB

View File

@ -151,11 +151,23 @@ nav:
- "Game Setup": "games/maimaidx/buddies/setup.md"
- "Controllers": "games/maimaidx/buddies/controllers.md"
- "Troubleshooting": "games/maimaidx/buddies/troubleshooting.md"
- "PRiSM":
- "Game Setup": "games/maimaidx/prism/setup.md"
- "Controllers": "games/maimaidx/prism/controllers.md"
- "Troubleshooting": "games/maimaidx/prism/troubleshooting.md"
- "PRiSM PLUS":
- "Game Setup": "games/maimaidx/prismplus/setup.md"
- "Controllers": "games/maimaidx/prismplus/controllers.md"
- "Troubleshooting": "games/maimaidx/prismplus/troubleshooting.md"
- "O.N.G.E.K.I.":
- "bright MEMORY":
- "Game Setup": "games/ongekibrightmemory/setup.md"
- "Controllers": "games/ongekibrightmemory/controllers.md"
- "Troubleshooting": "games/ongekibrightmemory/troubleshooting.md"
- "Re:Fresh":
- "Game Setup": "games/ongekirefresh/setup.md"
- "Controllers": "games/ongekirefresh/controllers.md"
- "Troubleshooting": "games/ongekirefresh/troubleshooting.md"
- "WACCA":
- "WACCA Lily R":
- "Game Setup": "games/waccalilyr/setup.md"
@ -190,6 +202,7 @@ not_in_nav: |
games/chusan
games/mu3
games/mercury
games/mai2
theme:
name: material