mirror of
https://github.com/two-torial/two-torial.git
synced 2026-09-12 18:25:56 -05:00
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
85
docs/games/mai2/controllers.md
Normal file
85
docs/games/mai2/controllers.md
Normal 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
346
docs/games/mai2/setup.md
Normal 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.
|
||||||
74
docs/games/mai2/troubleshooting.md
Normal file
74
docs/games/mai2/troubleshooting.md
Normal 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.
|
||||||
@@ -1,7 +1,4 @@
|
|||||||
# maimai DX BUDDiES
|
# maimai DX BUDDiES
|
||||||
|
|
||||||
<img src="/img/maimaidx/buddies.png">
|
<img src="/img/maimaidx/buddies.png">
|
||||||
|
|
||||||
---
|
--8<-- "docs/games/mai2/controllers.md"
|
||||||
|
|
||||||
### Coming Soon
|
|
||||||
|
|||||||
@@ -1,345 +1,4 @@
|
|||||||
# maimai DX BUDDiES
|
# maimai DX BUDDiES
|
||||||
|
|
||||||
<img src="/img/maimaidx/buddies.png">
|
<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."
|
--8<-- "docs/games/mai2/setup.md"
|
||||||
|
|
||||||
!!! 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.
|
|
||||||
|
|||||||
@@ -1,7 +1,4 @@
|
|||||||
# maimai DX BUDDiES
|
# maimai DX BUDDiES
|
||||||
|
|
||||||
<img src="/img/maimaidx/buddies.png">
|
<img src="/img/maimaidx/buddies.png">
|
||||||
|
|
||||||
---
|
--8<-- "docs/games/mai2/troubleshooting.md"
|
||||||
|
|
||||||
### Coming Soon
|
|
||||||
|
|||||||
6
docs/games/maimaidx/prism/controllers.md
Normal file
6
docs/games/maimaidx/prism/controllers.md
Normal 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"
|
||||||
6
docs/games/maimaidx/prism/setup.md
Normal file
6
docs/games/maimaidx/prism/setup.md
Normal 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"
|
||||||
6
docs/games/maimaidx/prism/troubleshooting.md
Normal file
6
docs/games/maimaidx/prism/troubleshooting.md
Normal 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"
|
||||||
6
docs/games/maimaidx/prismplus/controllers.md
Normal file
6
docs/games/maimaidx/prismplus/controllers.md
Normal 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"
|
||||||
6
docs/games/maimaidx/prismplus/setup.md
Normal file
6
docs/games/maimaidx/prismplus/setup.md
Normal 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"
|
||||||
6
docs/games/maimaidx/prismplus/troubleshooting.md
Normal file
6
docs/games/maimaidx/prismplus/troubleshooting.md
Normal 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
363
docs/games/mu3/setup.md
Normal 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.
|
||||||
@@ -83,3 +83,32 @@
|
|||||||
|
|
||||||
For NVIDIA users, create an override for `mu3.exe` in NVIDIA Control Panel
|
For NVIDIA users, create an override for `mu3.exe` in NVIDIA Control Panel
|
||||||
and change "Power management mode" to "**Prefer maximum performance**".
|
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
|
||||||
|
|||||||
@@ -2,367 +2,4 @@
|
|||||||
<div style="text-align: center;">
|
<div style="text-align: center;">
|
||||||
<img src="/img/ongeki/sddt/brightmemory.png" width="50%">
|
<img src="/img/ongeki/sddt/brightmemory.png" width="50%">
|
||||||
</div>
|
</div>
|
||||||
|
--8<-- "docs/games/mu3/setup.md"
|
||||||
!!! 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.
|
|
||||||
|
|||||||
5
docs/games/ongekirefresh/controllers.md
Normal file
5
docs/games/ongekirefresh/controllers.md
Normal 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"
|
||||||
5
docs/games/ongekirefresh/setup.md
Normal file
5
docs/games/ongekirefresh/setup.md
Normal 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"
|
||||||
5
docs/games/ongekirefresh/troubleshooting.md
Normal file
5
docs/games/ongekirefresh/troubleshooting.md
Normal 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
BIN
docs/img/maimaidx/prism.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 75 KiB |
BIN
docs/img/maimaidx/prismplus.png
Normal file
BIN
docs/img/maimaidx/prismplus.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 239 KiB |
BIN
docs/img/ongeki/sddt/refresh.png
Normal file
BIN
docs/img/ongeki/sddt/refresh.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 56 KiB |
13
mkdocs.yml
13
mkdocs.yml
@@ -151,11 +151,23 @@ nav:
|
|||||||
- "Game Setup": "games/maimaidx/buddies/setup.md"
|
- "Game Setup": "games/maimaidx/buddies/setup.md"
|
||||||
- "Controllers": "games/maimaidx/buddies/controllers.md"
|
- "Controllers": "games/maimaidx/buddies/controllers.md"
|
||||||
- "Troubleshooting": "games/maimaidx/buddies/troubleshooting.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.":
|
- "O.N.G.E.K.I.":
|
||||||
- "bright MEMORY":
|
- "bright MEMORY":
|
||||||
- "Game Setup": "games/ongekibrightmemory/setup.md"
|
- "Game Setup": "games/ongekibrightmemory/setup.md"
|
||||||
- "Controllers": "games/ongekibrightmemory/controllers.md"
|
- "Controllers": "games/ongekibrightmemory/controllers.md"
|
||||||
- "Troubleshooting": "games/ongekibrightmemory/troubleshooting.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":
|
||||||
- "WACCA Lily R":
|
- "WACCA Lily R":
|
||||||
- "Game Setup": "games/waccalilyr/setup.md"
|
- "Game Setup": "games/waccalilyr/setup.md"
|
||||||
@@ -190,6 +202,7 @@ not_in_nav: |
|
|||||||
games/chusan
|
games/chusan
|
||||||
games/mu3
|
games/mu3
|
||||||
games/mercury
|
games/mercury
|
||||||
|
games/mai2
|
||||||
|
|
||||||
theme:
|
theme:
|
||||||
name: material
|
name: material
|
||||||
|
|||||||
Reference in New Issue
Block a user