From 2dfbace1f1f4c1480a2a25842b810eda933a631d Mon Sep 17 00:00:00 2001 From: Pinapelz Date: Sat, 5 Apr 2025 15:52:26 -0700 Subject: [PATCH] centralize maimaidx setup guide and add maimaidx troubleshooting and controllers guide --- docs/games/mai2/controllers.md | 82 +++++ docs/games/mai2/setup.md | 341 +++++++++++++++++ docs/games/mai2/troubleshooting.md | 74 ++++ docs/games/maimaidx/buddies/controllers.md | 5 +- docs/games/maimaidx/buddies/setup.md | 343 +----------------- .../games/maimaidx/buddies/troubleshooting.md | 5 +- mkdocs.yml | 1 + 7 files changed, 501 insertions(+), 350 deletions(-) create mode 100644 docs/games/mai2/controllers.md create mode 100644 docs/games/mai2/setup.md create mode 100644 docs/games/mai2/troubleshooting.md diff --git a/docs/games/mai2/controllers.md b/docs/games/mai2/controllers.md new file mode 100644 index 00000000..e90573d8 --- /dev/null +++ b/docs/games/mai2/controllers.md @@ -0,0 +1,82 @@ +!!! danger "Please make sure you downloaded your data from an appropriate source.
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 +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 `Windows 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 to working with keyboard inputs at a basically level. 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! diff --git a/docs/games/mai2/setup.md b/docs/games/mai2/setup.md new file mode 100644 index 00000000..4fd6b3f8 --- /dev/null +++ b/docs/games/mai2/setup.md @@ -0,0 +1,341 @@ +!!! danger "Please make sure you downloaded your data from an appropriate source.
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.
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. + + + + Create two new empty folders named `appdata` and `amfs` (and the folder `option` if not present) next to them as shown below: + + + + The `App` folder should have a file structure as follows. + + + +??? 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: + + + +--- + +### 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`. + + + +#### 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: + + + + Another window titled `Sinmai` is the actual game. It should pause on `Search for Distribution Servers`: + + + +!!! 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: + + + + - 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: + + + + - 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. + + + +??? 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.** + + + + !!! 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. diff --git a/docs/games/mai2/troubleshooting.md b/docs/games/mai2/troubleshooting.md new file mode 100644 index 00000000..9e149a35 --- /dev/null +++ b/docs/games/mai2/troubleshooting.md @@ -0,0 +1,74 @@ +!!! danger "Please make sure you downloaded your data from an appropriate source.
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. diff --git a/docs/games/maimaidx/buddies/controllers.md b/docs/games/maimaidx/buddies/controllers.md index 8207287a..ebf07ef2 100644 --- a/docs/games/maimaidx/buddies/controllers.md +++ b/docs/games/maimaidx/buddies/controllers.md @@ -1,7 +1,4 @@ # maimai DX BUDDiES - ---- - -### Coming Soon +--8<-- "docs/games/mai2/controllers.md" diff --git a/docs/games/maimaidx/buddies/setup.md b/docs/games/maimaidx/buddies/setup.md index 2f7aff5a..74026168 100644 --- a/docs/games/maimaidx/buddies/setup.md +++ b/docs/games/maimaidx/buddies/setup.md @@ -1,345 +1,4 @@ # maimai DX BUDDiES - -!!! danger "Please make sure you downloaded your data from an appropriate source.
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.
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. - - - - Create two new empty folders named `appdata` and `amfs` (and the folder `option` if not present) next to them as shown below: - - - - The `App` folder should have a file structure as follows. - - - -??? 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: - - - ---- - -### 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`. - - - -#### 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: - - - - Another window titled `Sinmai` is the actual game. It should pause on `Search for Distribution Servers`: - - - -!!! 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: - - - - - 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: - - - - - 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. - - - -??? 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.** - - - - !!! 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" diff --git a/docs/games/maimaidx/buddies/troubleshooting.md b/docs/games/maimaidx/buddies/troubleshooting.md index 8207287a..880226d8 100644 --- a/docs/games/maimaidx/buddies/troubleshooting.md +++ b/docs/games/maimaidx/buddies/troubleshooting.md @@ -1,7 +1,4 @@ # maimai DX BUDDiES - ---- - -### Coming Soon +--8<-- "docs/games/mai2/troubleshooting.md" diff --git a/mkdocs.yml b/mkdocs.yml index 27a81e08..e5b3fc14 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -190,6 +190,7 @@ not_in_nav: | games/chusan games/mu3 games/mercury + games/mai2 theme: name: material