diff --git a/docs/games/mai2/controllers.md b/docs/games/mai2/controllers.md
new file mode 100644
index 00000000..8e60c5fe
--- /dev/null
+++ b/docs/games/mai2/controllers.md
@@ -0,0 +1,85 @@
+!!! 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
+
+!!! 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!
diff --git a/docs/games/mai2/setup.md b/docs/games/mai2/setup.md
new file mode 100644
index 00000000..dacc40f1
--- /dev/null
+++ b/docs/games/mai2/setup.md
@@ -0,0 +1,346 @@
+!!! 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.
+
+ 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.**
+
+ 
+
+ !!! 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/docs/games/maimaidx/prism/controllers.md b/docs/games/maimaidx/prism/controllers.md
new file mode 100644
index 00000000..0976227c
--- /dev/null
+++ b/docs/games/maimaidx/prism/controllers.md
@@ -0,0 +1,6 @@
+# maimai DX PRiSM
+
+
+
+
+
+
+
+
+
+
+
+
+
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.
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.
+
+ 
+
+ Create another empty folder named `AppData` next to them. It should now look like 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.**
+
+#### 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.
+
+ 
+
+
+#### 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:
+
+ 
+
+---
+
+### 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 -screen-height `: resolution
+ ??? warning "Note about resolution"
+ - The service menu will only render correctly at 1080x1920.
+ - This can be fixed with a patch.
+ * `-monitor `: 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.
+
+ 
+
+??? 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.
+
+
+
+!!! 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).
+
+
+
+!!! tip ""
+
+ Select **グループ内基準機の設定** (`SET STANDARD IN GROUP`, the second option)
+ and toggle this setting to **基準機** (`STANDARD`).
+
+
+
+!!! tip ""
+
+ Select **終了** (`EXIT`, the last option) to exit to the main service menu.
+
+#### CLOSE SETTING
+
+!!! tip ""
+
+ Navigate to **閉店設定** (`CLOSE SETTING`, the 10th option).
+
+
+
+!!! tip ""
+
+ Navigate to **時** (`HOUR`, the 2nd option) and use the `Service` button
+ to toggle the setting until it says **全時刻** (`ALL TIME`).
+
+
+
+!!! 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.
diff --git a/docs/games/mu3/troubleshooting.md b/docs/games/mu3/troubleshooting.md
index 3c0970d3..8a58a77b 100644
--- a/docs/games/mu3/troubleshooting.md
+++ b/docs/games/mu3/troubleshooting.md
@@ -7,10 +7,10 @@
!!! tip ""
Could be due to **many** things, the most common of which are:
-
+
- `amdaemon` crashing in the background. Make sure that the `config_*.json` files
have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
-
+
??? info "Capturing logs from `amdaemon` for troubleshooting"
To assist with troubleshooting, a script can be used to capture logs from `amdaemon`. Create a file named
@@ -28,7 +28,7 @@
:sub
set OPENSSL_ia32cap=:~0x20000000
pushd %~dp0
- start /b "AM Daemon" /min inject -d -k mu3hook.dll amdaemon.exe -f -c config_common.json config_server.json
+ start /b "AM Daemon" /min inject -d -k mu3hook.dll amdaemon.exe -f -c config_common.json config_server.json
ping 127.0.0.1 -n 31 > nul && taskkill /F /im amdaemon.exe
```
@@ -41,9 +41,9 @@
!!! tip ""
This could also be due to **many** things, the most common of which are:
-
+
- You have one or more incorrect/broken DLL(s) in `App\package\mu3_Data\Managed`
-
+
This is likely to be `Assembly-CSharp.dll`, `Assembly-CSharp-firstpass.dll`, and/or `AMDaemon.NET.dll`.
You can try replacing the DLLs or re-downloading data from elsewhere.
- An ill-formed keychip is defined in `segatools.ini`
@@ -55,7 +55,7 @@
!!! tip ""
The game could be running under or over its required refresh rate.
-
+
- Make sure V-Sync isn't disabled in your graphics settings (called "Vertical sync"
in NVIDIA Control Panel and "Wait for Vertical Refresh" in AMD Control Panel.)
- Limit `mu3.exe` to run at 60 FPS using a tool like [RivaTuner](https://www.guru3d.com/download/rtss-rivatuner-statistics-server-download) or a patch.
@@ -83,3 +83,32 @@
For NVIDIA users, create an override for `mu3.exe` in NVIDIA Control Panel
and change "Power management mode" to "**Prefer maximum performance**".
+
+---
+
+### I can't insert credits!
+
+!!! tip ""
+
+ Open `App\package\config_common.json` and find the `credit` section. From here, set `freeplay` to `true`
+
+ ```json hl_lines="8"
+ "credit" :
+ {
+ "max_credit" : 24,
+ "config" :
+ {
+ "coin_chute_type_common" : true,
+ "service_type_common" : true,
+ "freeplay" : true,
+ "coin_chute_multiplier" : [ 1, 1 ],
+ "coin_to_credit" : 1,
+ "bonus_adder" : 0,
+ "game_cost" : [ 1 ]
+ }
+ },
+ ```
+
+ Then delete the `amfs\sysfile.dat` folder and the `AppData\SDDT` folder
+
+ After re-launching the game, you should be able to play by purchasing GP
diff --git a/docs/games/ongekibrightmemory/setup.md b/docs/games/ongekibrightmemory/setup.md
index 7694f916..a65196de 100644
--- a/docs/games/ongekibrightmemory/setup.md
+++ b/docs/games/ongekibrightmemory/setup.md
@@ -2,367 +2,4 @@
-
-!!! 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 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.
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.
-
-
-
- Create another empty folder named `AppData` next to them. It should now look like 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.**
-
-#### 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.
-
-
-
-
-#### 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:
-
-
-
----
-
-### 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 -screen-height `: resolution
- ??? warning "Note about resolution"
- - The service menu will only render correctly at 1080x1920.
- - This can be fixed with a patch.
- * `-monitor `: 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.
-
-
-
-??? 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.
-
-
-
-!!! 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).
-
-
-
-!!! tip ""
-
- Select **グループ内基準機の設定** (`SET STANDARD IN GROUP`, the second option)
- and toggle this setting to **基準機** (`STANDARD`).
-
-
-
-!!! tip ""
-
- Select **終了** (`EXIT`, the last option) to exit to the main service menu.
-
-#### CLOSE SETTING
-
-!!! tip ""
-
- Navigate to **閉店設定** (`CLOSE SETTING`, the 10th option).
-
-
-
-!!! tip ""
-
- Navigate to **時** (`HOUR`, the 2nd option) and use the `Service` button
- to toggle the setting until it says **全時刻** (`ALL TIME`).
-
-
-
-!!! tip ""
-
- Select **終了** (`EXIT`, the last option) to exit to the main service menu, then select **終了**
- (also the last option) in the main menu to exit the service menu.
-
-!!! tip ""
-
- You're all done! The game should load up properly now.
-
- You can add coins using the `Coin` key (default `F3`) and card in by holding the `Enter` key.
-
----
-
-### Custom Mods
-
-!!! info "Mods are covered on the [Unity modding](../../extras/unity.md) page."
-
-### Controllers and Troubleshooting
-
-!!! info "Input methods and controllers are covered on the [Controllers](../ongekibrightmemory/controllers.md) page."
-
-!!! warning "Have any other issues?"
-
- Check out the [Troubleshooting](../mu3/troubleshooting.md) and [Error Codes](../../errorcodes/sega.md) pages.
+--8<-- "docs/games/mu3/setup.md"
diff --git a/docs/games/ongekirefresh/controllers.md b/docs/games/ongekirefresh/controllers.md
new file mode 100644
index 00000000..926602fe
--- /dev/null
+++ b/docs/games/ongekirefresh/controllers.md
@@ -0,0 +1,5 @@
+# Controllers (O.N.G.E.K.I. Re:Fresh)
+
+
+
+
+
+
+