Add IIDX31 guide

docs/games/iidx31/hexedits.md

@@ -0,0 +1,16 @@
+# beatmania IIDX 31 Hex Edits
+
+<img src="/img/iidx31/epolis.png">
+	
+??? info "Want a quick drag and drop solution?"
+	Use _mon's [BemaniPatcher](https://mon.im/bemanipatcher)._ Simply select the game you'd like to edit and drop the corresponding game `.dll` into it and select what changes you'd like!
+
+??? warning "Unsure how to apply hex edits?"
+
+	Check out the [Beginner's Guide to Hex Editing](https://guide.fumo.photos/extras/hexguide/) for assistance.
+
+### List of Known Edits For LDJ-2020092900
+
+!!! tip ""
+	Hello I know I left this page up thank you.
+

docs/games/iidx31/lightning.md

@@ -0,0 +1,54 @@
+# beatmania IIDX 31 Lighting Mode (TDJ) Information
+
+<img src="/img/iidx31/epolis.png">
+	
+### Setting up TDJ (Subscreen & 120FPS)
+
+!!! tip ""
+	As of right now, for EPOLIS, you'll have to use a hex edit if you'd like to have TDJ working. First, locate your `bm2dx.dll` which is located inside the `\modules` folder and make a backup of it in case something goes wrong. Next, head over to [EGRS's Patcher](https://egrspatcher.pages.dev/epolis) and drag & drop your `bm2dx.dll` into the website.
+
+	At the very bottom, you'll see `Force TDJ Mode`. Enable it and press `Save Patched File`. Replace the file inside of `\modules`.
+
+	Next, open up your `spicecfg.exe`, head to the `Options` tab and enable `IIDX TDJ Mode`, otherwise it won't properly work.
+
+<img src="/img/iidx31/tdj_mode.png">	
+
+!!! warning "Be warned that to make TDJ work as intended, the game requires you to have 2 monitors with one being a touchscreen and the other one being 120Hz. It also disables the Keypad buttons/functionality requiring you to use the subscreen to enter your PIN."
+
+### Setting up Single Monitor TDJ
+
+!!! tip ""
+	If you do not have a second monitor but atleast one that is 120Hz, you can set up Single Monitor TDJ mode.
+	
+	In `spicecfg.exe` under the `Options` tab, head down to `Graphics (Common)` and enable `Only Use One Monitor`. 
+
+<img src="/img/iidx31/tdj_single_monitor.png">	
+	
+!!! tip ""
+	This will enable you to switch (or open) the subscreen with a press of a button which you have to bind first. Inside of the `Buttons` tab, head to the `Overlay Button` section and bind `Toggle Sub Screen` to a button that feels comfortable for you to use. You can also change the subscreen size if you don't like it fullscreen. Simply head back to the `Options` tab and look for `IIDX TDJ Subscreen Size` and change to your preferred size.
+
+### Lightning-specific Troubleshooting
+
+!!! tip ""
+	Below is a pretty common issue that has occured for users utilizing this guide and general startup practices.
+
+### Audio Related Crash
+
+!!! tip ""
+	If you get a stack trace in your `log.txt` that looks like this...
+
+	`exception raised: EXCEPTION_ACCESS_VIOLATION`
+
+	`[2020/10/22 18:20:21] I:signal: printing callstack`
+
+	`[2020/10/22 18:20:21] I:stackwalker: 000000018026E906 (bm2dx): (unknown): (unknown)`
+
+	For cab type 1 (LDJ), change your audio device to motherboard audio and/or use -audiobackend asio `-asiodriverid ... -audiodummy`
+
+	For cab type 2 (TDJ, with `-iidxtdj` or another means), you have a few options:
+
+	1) Use `-iidxasio "Driver Name Here"` to set the ASIO driver used by IIDX's own ASIO handler. (Does not work with all ASIO drivers, they designed it to work best with a specific revision of the XONAR SOUNCARD(64))
+
+	2) Use `-iidxsounddevice wasapi` to set IIDX to use WASAPI instead of its own ASIO handler.
+
+	3) Use `-iidxsounddevice wasapi` along with `-audiobackend asio ...` to have the game pipe audio through Spice's own ASIO handler which is more compatible with various ASIO drivers

docs/games/iidx31/problems.md

@@ -0,0 +1,48 @@
+# IIDX 31 Common Problems/Tips
+
+<img src="/img/iidx31/epolis.png">
+
+!!! note "Author Note:"
+	For lightning specific issues, see [lightning cab notes](lightning.md#lightning-specific-troubleshooting)
+
+### My Game Is Running Crazy Fast!
+
+!!! tip ""
+	The most common reason for this is the game is running over its required 60hz or 120hz framerate, depending on if you're in LDJ or TDJ mode. The game is hardcoded to run at these specific framerates and this cannot be changed. To solve this, set your monitor's refresh rate to match if you're in LDJ 60hz or TDJ 120hz mode. You can always check on the game's monitor check if the game is fluctuating around 59.94hz, the NTSC standard or around 120.00hz. If it's not around there and your monitor is indeed set correctly for the given mode, consider trying a different panel or forcing vsync on in your GPU's graphics settings.
+
+### Occasional Game Stutters During Play
+
+!!! tip ""
+	Sometimes you might have occasional stutters during play, while solutions can vary wildly from general performance issues to bad hard drives, try adding SpiceTools `-realtime` parameter to your .bat file.
+
+### My Inputs Aren't Working / I Can't Get Past The Error Messages
+
+!!! tip ""
+	If *none* of your inputs are working, try updating [spice2x](https://spice2x.github.io/), you can also try using the beta versions if the stable releases don't work for you.
+
+### My Game Audio Sounds Like A PS1 Horror Game
+
+!!! tip ""
+	If you decided to use `WASAPI`, make sure your `Playback Device` is set to `48000 Hz`. You can read up on it [here.](setup.md#getting-started)
+
+### My Game Audio Is Super Quiet!
+
+!!! tip ""
+	When using `TDJ mode` the audio is very quiet by default. To mitigate this, you can use the `Increase Game Volume` [hex edit](https://egrspatcher.pages.dev/epolis).
+
+### Which Offset Is Which?
+
+!!! tip ""
+	If you're getting too many fasts, increase your offset (+). If you're getting too many slows, decrease your offset (-).
+
+### When I Run This Game All Other Background Audio Is Gone! What's Going On?
+
+!!! tip ""
+	64-bit versions of IIDX are now utilizing a feature in Windows called [WASAPI exclusive mode](https://docs.microsoft.com/en-us/windows/win32/coreaudio/exclusive-mode-streams) to obtain less audio latency than the former 32-bit versions of the games which used [DirectSound](https://en.wikipedia.org/wiki/DirectSound). You can use the `WASAPI Shared Mode` [hex edit](https://egrspatcher.pages.dev/epolis) which is found at the very bottom to avoid this issue.
+
+### I'm Not Getting Any Audio/My Audio Is Completely Wrecked and I'm Using an External Dac!
+
+!!! tip ""
+	Several external DACs have issues with [WASAPI exclusive mode](https://docs.microsoft.com/en-us/windows/win32/coreaudio/exclusive-mode-streams) and are unable to be used entirely, it's likely you'll be forced to use your motherboard's sound chip, or find a compatible DAC.
+
+

docs/games/iidx31/setup.md

@@ -0,0 +1,164 @@
+# beatmania IIDX 31 EPOLIS
+
+<img src="/img/iidx31/epolis.png">
+
+!!! note "Author Note:"
+
+	Last updated: 16.11.2023 (Currently using `2023101800`)
+	
+	For hex edits: Go to [EGRS's Patcher](https://egrspatcher.pages.dev/epolis) (provided by the EGRS Community)
+
+	For lightning mode specifics: they are found [here](lightning.md)
+
+!!! danger "Warning:"
+	Please make sure your data is from an appropriate source and unmodified before proceeding, this guide is unable to troubleshoot any problems related to bad or poorly managed data.
+
+	If you obtained data from a torrent file, make sure you're not seeding the data before proceeding as well.
+
+	This guide will use [spice2x](https://spice2x.github.io/) which is a fork of SpiceTools that gets regular updates and will be needed to get the game running.
+
+	This guide will try to accommodate for both an Upgrade Kit and a whole file set.
+
+
+### Getting Started
+
+!!! tip ""
+	Before we even touch the game, let's fiddle with our audio settings to minimize any potential crashing on startup. In Windows, go to `Playback Devices` and then right click on your default device and go to `Properties`. From there, hit the `Advanced` tab and set your `Default Format` to `48000 Hz` and check both of the options inside `Exclusive Mode` as pictured.
+
+	Using the "usual" `44100 Hz` will result in crackling and desync.
+
+<img src="/img/gen/480.png">
+
+!!! tip ""
+	Once that's done, it's time to work on setting up your data.
+
+	After downloading your data, the first thing to do is make sure your files aren't set to READ ONLY, make sure to uncheck it from the main folder in the Windows Properties tab if so. Then, put your `spice2x` **64-bit** tools inside the game's `contents` folder. Pictured below is what your folder should look like.
+
+<img src="/img/iidx31/1.png">
+
+!!! info "If you have gotten a complete data set, you are done and can head over to [Configuring for an Online Network](setup.md#configuring-for-an-online-network)"
+
+### Merging LDJ-2023090500 (RESIDENT final) with EPOLIS
+
+!!! tip ""
+	If you have downloaded an upgrade, the contents of it should look like this:
+
+<img src="/img/iidx31/upgrade.png">
+
+!!! tip ""
+	Next, unpack the contents of the archive and drag & drop all files into your `contents` folder of `LDJ-2023090500`. Make sure to confirm if it prompts you to replace files in the destination, this is normal.
+
+	Lastly, head over to `\contents\prop` and open up `ea3-config.xml` with a text editor of your choice. We'll be using [Notepad++](https://notepad-plus-plus.org/) for that. In this example, we'll use `2023101800`.
+
+	Look for these lines which should be at the top:
+	```
+	<soft>
+    	<model __type="str">LDJ</model>
+    	<dest __type="str">J</dest>
+    	<spec __type="str">A</spec>
+        <rev __type="str">A</rev>
+        <ext __type="str">2023101800</ext>
+    </soft>
+	```
+	If `<ext __type="str">2023101800</ext>` already has `2023101800` then you're good to go. If it has anything other than that, change it to `2023101800`.
+	This is the games datacode, basically telling the game what version it is on.
+
+
+### Configuring for an Online Network
+
+!!! tip ""
+	Now that you have your files ready, open up `spicecfg.exe` and head to the `Options` where we'll set our desired parameters.
+	
+	On the `Service URL: -url` parameter, we're going to input our chosen network URL like so: `http://yoururlhere.com/`
+
+	To go alongside this, we'll also be inputting into the `PCBID: -p` parameter, the PCBID given to us from our network, like so: `XXXXXXXXXXXXXXXXXXXX`
+
+	Lastly, we'll click on the `Windowed Mode: -w` parameter.
+
+	What do these different parameters do?
+
+	- `-url` allows you to specify a custom service URL to connect with, simply replace `http://yoururlhere.com/` with your chosen network's URL.
+	- `-p` takes your PCBID on your network of choice, simply replace `XXXXXXXXXXXXXXXXXXXX` with your PCBID.
+	- `-w` will boot the game in windowed mode which will ease our initial setup and testing later, make sure to remove `-w` to run the game fullscreen once you're done setting up!
+
+	Pictured below, the selected options inside the `Options` tab in `spicecfg.exe`.
+
+<img src="/img/iidx31/cfg_on.png">
+
+!!! tip ""
+	One final note, since you're playing on a network, you will have one additional step of setting up your card file if you do not already have one.
+	For this, simply head to the `Cards` tab and press `Generate`.
+
+	I highly recommend that you copy your `Card Number`, create a `.txt`, paste the `Card Number` and store the `.txt` file somewhere safe where you won't lose it. It doesn't matter how you name it. **For the purpose of this guide, I've chosen the root of my `D:\` drive for easy access and called the text file `guidecard.txt`.**
+
+	Next, click on the three dots (`...`) next to `Card Path` and locate your card text file. Keep in mind that `Player 1` refers to 1P **side** and will log you in on the **left**, Player 2 does the opposite respectively.
+	If you have done everything correctly, it should look like this:
+
+<img src="/img/iidx31/card.png">
+
+### Audio & Keybinds
+
+!!! tip ""
+	Before we go over the keybinds, we'll change our `IIDX Sound Output Device` to `WASAPI`. This has (from my experience) the highest chance of working. If it doesn't for you, try using `ASIO`. It really comes down to your own hardware setup. 
+	
+	If you're still having issues, feel free to join our [Discord server](https://discord.gg/yAtdhvee79) and ask away in the troubleshooting section as this could be something very specific. Keep in mind that if you're using `WASAPI`, IIDX will go into WASAPI exclusive mode which means that only IIDX will output it's audio and nothing else [(this can be changed with a hex edit if you'd like).](problems.md#when-i-run-this-game-all-other-background-audio-is-gone-whats-going-on)
+
+	Below is an example of how it looks like using `WASAPI`.
+
+<img src="/img/iidx31/wasapi.png">
+
+!!! tip ""
+	The last steps you'll have to do is simply setting up your desired keybinds inside the `Buttons` and `Analogs` tabs. If you'd like an example, I've shown my keybindings below on a Keyboard from the 1P side. Make sure you setup the `Test` keybind as it will be critical for setting up the game. 
+
+<img src="/img/iidx31/iidx_bind.png">
+
+### Disabling Cameras
+
+!!! tip ""
+	Go back to the `Options` tab and make sure to enable `IIDX Disable Cameras` or else you will encounter an error and you will be unable to proceed otherwise.
+
+<img src="/img/iidx31/disable_cam.png">
+
+### Setting up the game
+
+!!! tip ""
+	Finally we're ready to start the game. Go ahead and start `spice64.exe`.
+
+	If it's your first time running the game, you'll immediately be greeted with this screen.
+
+<img src="/img/iidx31/2.png">
+
+!!! tip ""
+	Hit the `Test` keybinding to initialize the backup data, a message will pop up stating it's been initialized.
+
+<img src="/img/iidx31/3.png">
+
+!!! tip ""
+	You'll also run into this error message as well. Let the game run for a bit until the monitor check is complete and you should be taken to the service menu pictured below.
+
+<img src="/img/iidx31/4.png">
+
+!!! tip ""
+	Start by navigating up to `CLOCK` and entering that menu.
+
+<img src="/img/iidx31/5.png">
+
+!!! tip ""
+	Simply hit save and exit and leave, the clock will be saved. Then, back in the service menu head to `NETWORK OPTIONS` from back inside the service menu.
+
+<img src="/img/iidx25/11.png">
+
+!!! tip ""
+	The final thing we need to set is here inside `NETWORK OPTIONS`, we will need to set a shop name to play, so select the `SHOP NAME SETTING` option. Once inside, name your shop to whatever you'd like. For the purpose of the guide, we named it `Guide`. Once that's done go to `EXIT` and then `SAVE AND EXIT` inside of `NETWORK OPTIONS` once you've chosen your desired name, as pictured below.
+
+<img src="/img/iidx25/12.png">
+
+<img src="/img/iidx25/13.png">
+
+!!! tip ""
+	You're all done! From the service menu select `GAME MODE` and the game should load ready to be played! Have fun!
+
+!!! warning "Have any other errors?"
+	Check out the [Common Problems/Tips](problems.md) section and [Error Code](/errorcodes/) section to resolve any issues not seen in this guide to greater depth.
+
+	Lightning Mode specifics can be found: [here](lightning.md#lightning-specific-troubleshooting)

docs/index.md

@@ -6,9 +6,13 @@ description: A compendium of information and guides written to ease headaches.
 
 A compendium of information and guides written to ease headaches.
 
-Last Updated: [November 11th, 2023.](changelog.md)
+Last Updated: November 16th, 2023.
 
 We now have a [Discord server!](https://discord.gg/cZRUmEPK78)
+
+Changelogs will now be posted on the Discord in much greater detail.
+
+We also have a new troubleshooting section available for the Discord server.
  
 
 !!! danger "Important"

mkdocs.yml

@@ -40,6 +40,10 @@ nav:
                 - 'First Time Setup': 'games/iidx27/setup.md'
                 - 'Common Problems/Tips': 'games/iidx27/problems.md'
                 - 'Lightning Mode Specifics': 'games/iidx27/lightning.md'
+            - 'IIDX 31 EPOLIS':
+                - 'First Time Setup': 'games/iidx31/setup.md'
+                - 'Common Problems/Tips': 'games/iidx31/problems.md'
+                - 'Lightning Mode (TDJ)': 'games/iidx31/lightning.md'
         - 'SDVX':
             - 'SDVX IV HEAVENLY HAVEN':
                 - 'First Time Setup': 'games/sdvx4/setup.md'