Cool_Tools/two-torial
1
0
Fork 0
mirror of https://github.com/yxrei/two-torial.git synced 2024-09-23 19:08:23 +02:00
Code Issues Packages Projects Releases Wiki Activity

Initial push of existing project

Browse Source
This commit is contained in:
Vodes 2023-08-30 17:14:11 +02:00
commit 7a8444126f
379 changed files with 86317 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
.gitignore vendored Normal file
View File

@ -0,0 +1 @@
.idea

17
.travis.yml Normal file
View File

@ -0,0 +1,17 @@
language: python
python: 3.6.7
install:
- pip install -r requirements.txt
script:
- mkdocs build --verbose --clean --strict
deploy:
provider: pages
skip_cleanup: true
github_token: $github_token
local_dir: site
on:
branch: master

13
LICENSE Normal file
View File

@ -0,0 +1,13 @@
Copyright 2023-202x fumo.photos Team & contributors
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

3
README.md Normal file
View File

@ -0,0 +1,3 @@
# bemani.guide
bemani.guide, a compendium of information and guides written to ease headaches for a certain enigmatic place.

36
docs/about.md Normal file
View File

@ -0,0 +1,36 @@
<a href="https://www.youtube.com/watch?t=82&v=ct1S-7mddyQ" target="_blank"><img style="float: right;" src="../img/icon.png"></a>
# About this site
This site was written by a IIDX player with the help of a few prominent friends. One day I hope to match their intellect, wish me luck.
The philosophy behind writing these guides and the information contained within is to remove repetitive troubleshooting. By this point, every server has answered the same questions over and over again, hundreds of times. Maddening to see over the years, don't you think?
While a search function may be present across several communities, it is often unused by users, something I have never found an answer as to why, but my hope is that I can confidently link specific sections of this site to resolve 99% of issues people bring up until it becomes the norm. Each beginner setup guide is built to minimalize user interaction with the data itself, and to keep things simple via hand-holding. For example, with modern improvements to tools, games can now be ran successfully without the user ever touching a single file from the game's data. Days have long past for users incorrectly modifying their ea3-config.
Still, as long as this website helps even 1 user enjoy these games, then its goal has been met. Whether it be within the first hour of its posting, or years later, I will be satisfied if I meet that goal.
&nbsp;
### Credits
!!! tip ""
- Friends that wished to remain anonymous: motivation, technical assistance, inspiration.
- Passionate rhythm game players worldwide that allow these games to exist, thank you for making it a lot of fun to be involved in the scene and around you all.
- Contributors for taking the time to add improvements to the site.
### Contact
!!! tip ""
**Please do not contact me to troubleshoot your problems, I will not respond.**
In the time thinking about this site I have wondered how best to open contact for the betterment of the site and overall community. I wish to remain largely private because I do not want credit for this work, but if you wish to contact me regarding wanting to contribute, or even site inaccuracies, improvements, and solutions that worked for you but aren't listed...
Feel free to email me at: <bemaniguide@protonmail.com>
I now run a private discord to accept user contributions from, feel free to email to gain access if you are looking to contribute to the site (also include what you'd like to contribute in the email, of course)
I can't promise I'll respond, but if you see some changes relating to what you emailed, I certainly read what you sent.

115
docs/changelog.md Normal file
View File

@ -0,0 +1,115 @@
# Changelog
### What's New:
!!! tip "April 8th, 2021"
- Added Hello Pop'n Music Guide
- Added Pop'n Peace guide
- Various fixes and error code improvements for IIDX
- Added new guide to extras section: Exclusive Audio Workarounds
!!! tip "March 24th, 2021"
- Added Nostalgia Op. 2 guide
- Updated Forte guide
- Added more external resources
!!! tip "March 21st, 2021"
- Added misc small improvements
- Added jubeat rubber part information (Immense delay on this, apologies)
- Added information about VW final hex edits
!!! tip "December 21st, 2020"
- HTTPS fixed
- robots.txt changes
- Cleaned up some Heroic Verse related content
- Actually updated content I said I would update 2 months ago (sorry!)
!!! tip "October 27th, 2020"
- Added IIDX 27: Heroic Verse setup/faq/etc
!!! tip "July 27th, 2020"
- Updated Arcade Parts List
- Added an External Resources Section (sorry for delay to those that submitted resources, busy time)
- Updates to all main guides/SpiceTools coming soon.
!!! tip "April 23rd, 2020"
- Added some minor info about WASAPI shared mode for SDVX V
!!! tip "April 11th, 2020"
- Adjusted some troubleshooting
- Added user contributed polling rate
- Misc bits and pieces
!!! tip "April 1st, 2020"
- Added SDVX V guides
!!! tip "March 14th, 2020"
- Site back online (hello everyone)
- Pop'n Usaneko setup/faq/hex edits
- Spice pages updated
!!! tip "March 11th, 2020"
- Formatting fixes for hex edits
- Minor tinkering with ASC/Parts sections
- DDR Ace cleanup
- Museca cleanup + faq/hex edits
- Beatstream cleanup
- Misc changes
!!! tip "March 10th, 2020"
- Add DDR ACE setup/faq/hex edits
- Add IIDX 26: ROOTAGE setup/faq/hex edits
- Additional cleanup
!!! tip "March 7th, 2020"
- Add GITADORA EXCHAIN setup/faq/hex edits
!!! tip "March 6th, 2020"
- Add Parts Documentation
- Add to part considerations to ASC section
- CSS changes, formatting, cleanup
&nbsp;
!!! tip "March 5th, 2020"
- Revive project (sorry it was dead for so long!)

274
docs/css/base.css Normal file
View File

@ -0,0 +1,274 @@
html {
/* The nav header is 3.5rem high, plus 20px for the margin-top of the
main container. */
scroll-padding-top: calc(3.5rem + 20px);
}
body > .container {
margin-top: 20px;
}
.navbar.fixed-top {
position: -webkit-sticky;
position: sticky;
}
.source-links {
float: right;
}
.col-md-9 img {
max-width: 100%;
}
pre, code {
background: #202020;
color: #959595;
border: 1px solid rgba(0,0,0,0.125);
border-radius: 0.25rem;
}
pre {
padding: 0.5em;
}
code {
padding: 1px 3px;
}
pre code {
border: none;
/* Override styles from hljs theme */
background: transparent !important;
padding: 0 !important;
}
a code {
color: #2a9fd6;
}
a:hover code {
color: #1d7097;
}
kbd {
padding: 2px 4px;
font-size: 90%;
color: #fff;
background-color: #333;
border-radius: 3px;
-webkit-box-shadow: inset 0 -1px 0 rgba(0,0,0,.25);
box-shadow: inset 0 -1px 0 rgba(0,0,0,.25);
}
footer {
margin-top: 10px;
margin-bottom: 10px;
text-align: center;
font-weight: 200;
}
.modal-dialog {
margin-top: 60px;
}
/* Style the admonitions. */
.admonition {
margin-bottom: 1em;
border: 1px solid rgba(0, 0, 0, 0.125);
border-radius: 0.25rem;
background-color: #131313;
line-height: 1.55;
}
.admonition > .admonition-title {
margin: 0;
padding: 0.25rem 1rem;
background: rgba(0, 0, 0, 0.03);
border-bottom: 1px solid rgba(0, 0, 0, 0.125);
border-radius: calc(0.25rem - 1px) calc(0.25rem - 1px) 0 0;
font-size: 1rem;
}
.admonition > * {
margin-left: 1rem;
margin-right: 1rem;
}
.admonition > *:not(.admonition-title):first-of-type,
.admonition > .admonition-title + * {
margin-top: 1rem;
}
.admonition > *:last-child {
margin-bottom: 1rem;
}
/* Style each kind of admonition. */
.admonition.note, .admonition.note > .admonition-title {
border-color: #6e2caf;
}
.admonition.note > .admonition-title {
color: #fff;
background-color: #9933cc;
}
.admonition.warning, .admonition.warning > .admonition-title {
border-color: #9d5b02;
}
.admonition.warning > .admonition-title {
color: #fff;
background-color: #9d5b02;
}
.admonition.danger, .admonition.danger > .admonition-title {
border-color: #cc00008a;
}
.admonition.danger > .admonition-title {
color: #fff;
background-color: #cc00008a;
}
/*
* Side navigation
*
* Scrollspy and affixed enhanced navigation to highlight sections and secondary
* sections of docs content.
*/
.bs-sidebar.affix {
position: -webkit-sticky;
position: sticky;
/* The nav header is 3.5rem high, plus 20px for the margin-top of the
main container. */
top: calc(3.5rem + 20px);
}
.bs-sidebar.card {
padding: 0;
}
/* Toggle (vertically flip) sidebar collapse icon */
.bs-sidebar .navbar-toggler span {
-moz-transform: scale(1, -1);
-webkit-transform: scale(1, -1);
-o-transform: scale(1, -1);
-ms-transform: scale(1, -1);
transform: scale(1, -1);
}
.bs-sidebar .navbar-toggler.collapsed span {
-moz-transform: scale(1, 1);
-webkit-transform: scale(1, 1);
-o-transform: scale(1, 1);
-ms-transform: scale(1, 1);
transform: scale(1, 1);
}
/* First level of nav */
.bs-sidebar > .navbar-collapse > .nav {
padding-top: 10px;
padding-bottom: 10px;
border-radius: 5px;
width: 100%;
}
/* All levels of nav */
.bs-sidebar .nav > li > a {
display: block;
padding: 5px 20px;
z-index: 1;
}
.bs-sidebar .nav > li > a:hover,
.bs-sidebar .nav > li > a:focus {
text-decoration: none;
border-right: 1px solid;
}
.bs-sidebar .nav > li > a.active,
.bs-sidebar .nav > li > a.active:hover,
.bs-sidebar .nav > li > a.active:focus {
font-weight: bold;
background-color: transparent;
border-right: 1px solid;
}
.bs-sidebar .nav .nav .nav {
margin-left: 1em;
}
.bs-sidebar .nav > li > a {
font-weight: bold;
}
.bs-sidebar .nav .nav > li > a {
font-weight: normal;
}
.headerlink {
display: none;
padding-left: .5em;
}
h1:hover .headerlink, h2:hover .headerlink, h3:hover .headerlink, h4:hover .headerlink, h5:hover .headerlink, h6:hover .headerlink{
display:inline-block;
}
@media (max-width: 991.98px) {
.navbar-collapse.show {
overflow-y: auto;
max-height: calc(100vh - 3.5rem);
}
}
.dropdown-item.open {
color: #fff;
background-color: #2A9FD6;
}
.dropdown-submenu > .dropdown-menu {
margin: 0 0 0 1.5rem;
padding: 0;
border-width: 0;
}
.dropdown-submenu > a::after {
display: block;
content: " ";
float: right;
width: 0;
height: 0;
border-color: transparent;
border-style: solid;
border-width: 5px 0 5px 5px;
border-left-color: #999999;
margin-top: 5px;
margin-right: -10px;
}
.dropdown-submenu:hover > a::after {
border-left-color: #fff;
}
@media (min-width: 992px) {
.dropdown-menu {
overflow-y: auto;
max-height: calc(100vh - 3.5rem);
}
.dropdown-submenu {
position: relative;
}
.dropdown-submenu > .dropdown-menu {
position: fixed !important;
margin-top: -9px;
margin-left: -2px;
border-width: 1px;
padding: 0.5rem 0;
}
}

11410
docs/css/bootstrap.min.css vendored Normal file
View File

File diff suppressed because it is too large Load Diff

173
docs/errorcodes.md Normal file
View File

@ -0,0 +1,173 @@
# BEMANI Error Codes
!!! warning "Before reading:"
This section contains various gamecode errors that a user may run across. There is an innumerable amount of these and I sometimes wonder if it's truly possible to have them all listed.
Nonetheless, dozens, if not hundreds are currently missing. This list is a massive work in progress and will be updated with time.
Furthermore, not every solution listed can be the definitive solution to your error, sometimes various odd software and hardware nuances occur to create yet unseen issues.
I encourage you to be vocal about your solutions so that they can be added to the guide by [contacting me.](/about/#contact)
## Universal Error Codes
### 5-0000-0000
!!! tip ""
This error can appear across any game, it's a generic critical error with several possible solutions.
It is usually caused by network adapters that are enabled, other than the primary one used for network service. Try to disable some network adapters in Windows Device Manager, including hidden adapters.
It can also be caused by game files being set to read only, especially the dev folder. Uncheck read only property in file explorer for all game files.
### 5-2000-0000
!!! tip ""
This error can appear across any game, it's a standard network error with several possible solutions.
First, make sure you have correctly entered your network service's URL properly with the `-url` parameter, that your internet connection is fine, and that the service is not down.
Also make sure you have correctly entered your PCBID with the ``-p`` parameter.
One other thing to check is that the data is supported by the service, and that the datecode used by the game
is not invalid. Don't modify things if you don't need to! If the data is from a clean, trusted source, then this is extremely unlikely to be the cause.
### 5-2002-0915
!!! tip ""
This error can appear across any game, it's a standard network error with several possible solutions.
First, make sure you have correctly entered your network service's URL properly with the `-url` parameter, that your internet connection is fine, and that the service is not down.
Also make sure you have correctly entered your PCBID with the ``-p`` parameter.
One other thing to check is that the data is supported by the service, and that the datecode used by the game
is not invalid. Don't modify things if you don't need to! If the data is from a clean, trusted source, then this is extremely unlikely to be the cause.
### 5-2600-0000
!!! tip ""
This error can appear across any game, it's a standard network error with several possible solutions.
First, make sure you have correctly entered your network service's URL properly with the `-url` parameter, that your internet connection is fine, and that the service is not down.
Also make sure you have correctly entered your PCBID with the ``-p`` parameter.
One other thing to check is that the data is supported by the service, and that the datecode used by the game
is not invalid. Don't modify things if you don't need to! If the data is from a clean, trusted source, then this is extremely unlikely to be the cause.
&nbsp;
## IIDX Error Codes
### 5-1500-0002
!!! tip "SOUND DATA CREATE ERROR"
This error occured from a corrupted installation. If your data came from a trusted source and you're having this issue, consider redownloading the files and making sure your installation was done properly. Or, perhaps your hard drive is failing.
### 5-1503-0004
!!! tip "USBIO ERROR (NO ANSWER...)"
This error occurs when the game times out trying to communicate with the I/O board.
When using tools, this typically happens because I/O emulation in tools takes too long, which can be caused by long-running background services on your computer. Usual offenders are: file-syncing software (GDrive, OneDrive, back up service, etc), anti-virus / malware scans, Windows Updates, or possibly bad hardware. Try to see if you can run tools at elevated process priority (SpiceTools already does this, but you can also try -realtime as last resort).
On a real cabinet this would typically be a hardware error with the I/O board. Check cable connection and the power supply to the I/O board.
### 5-1505-0001
!!! tip "SSD DATA ERROR"
This error occurs when the data is horribly corrupt, incomplete, or modified incorrectly. Please redownload your data from a reliable source.
### 5-1503-0042
!!! tip "CAMERA DEVICE ERROR"
This error occurs when camera devices are missing/not functional. To resolve either have two cameras connected to your machine or apply a [hex edit](/extras/hexguide/) for your game's specific version and date code to simply not have this error occur on startup. It can be bypassed by hitting the `Test` button so it is not a critical error.
### 5-1506-0001
!!! tip "CLOCK ERROR"
This error occurs when the clock is not set. To resolve, set the `CLOCK` in the service menu by hitting `SAVE AND EXIT` inside of the menu.
&nbsp;
## Sound Voltex Error Codes
### 5-1506-0000
!!! tip "ACIO ERROR"
A user had this error when they downloaded the game from an unreliable source, they redownloaded `libacio.dll` from a clean, trusted source and had no issues. If the error persists, consider redownloading the data from a reliable source entirely.
### 5-2009-0000
!!! tip ""
This error was seen on Sound Voltex Booth, a user had messed up their dll files. Thus, the solution would be to leave files unmodified and do not needlessly tamper. If your data came from a trusted source and you're having this issue, consider redownloading the files and making sure your installation was done properly.
&nbsp;
## Pop&apos;n Error Codes
### 5-1509-0000
!!! tip ""
A user experienced this error every few minutes or so during play. If this issue occurs, make sure you have correctly inputted your chosen network's service URL and your PCBID correctly.
### 5-2002-2400
!!! tip ""
This error was seen on Pop&apos;n Usaneko due to improper setup and bad parameter usage in SpiceTools, make sure to follow [the first time setup](/games/popnusaneko/setup/) and utilize the `-url` and `-p` parameters in SpiceTools
so that you're not needlessly risking making mistakes in modifying the game's files.
&nbsp;
## Jubeat Error Codes
### 5-2500-0000
!!! tip "BACKUP DATA ERROR"
Follow the steps listed [here](/games/jubeatclan/setup/#final-steps-and-setting-up-the-game)
&nbsp;
## GITADORA Error Codes
### 5-1698-0000
!!! tip ""
This was seen in GITADORA Tri-Boost Re:EVOLVE. To resolve, uncheck the `Read Only` attribute on the following `contents` folders.
- \contents\data\product\aep_x64\
- \contents\data\product\aep\
Also, remove the following files from these folders.
- battle_matching_3.bin
- beargarden_3.bin
- common_3.bin
- custom_3.bin
- entry_3.bin
- game_combo_3.bin
- game_common_3.bin
- game_dm_3.bin
- game_gf_3.bin
- game_session.bin
- home.bin
- mission_result.bin
- record_3.bin
- select_music_3.bin
- tab_3.bin
- title_3.bin
- warning_3.bin
### 5-1506-0000
!!! tip ""
Disable all the unused network adapters inside device manager (make sure to view the hidden ones as well and disable those too!)
### 5-2500-0001
!!! tip "BACKUP DATA ERROR"
Follow the steps listed [here](/games/gitamatixx/setup/#final-steps-and-setting-up-the-game)
### 5-2501-0000
!!! tip "GROUP ID ERROR"
The Group ID Error is caused when it finds another cab of the same kind (GF or DM) with the same Group ID on the network. In most cases for users, this means the computer is connected to BOTH Ethernet and Wi-fi so the game sees 2 instances of itself. Thus to resolve, make sure you do not have 2 devices on the same subnet like this by checking your connections accordingly.
&nbsp;
## NOSTALGIA Error Codes
### 5-1501-0000
!!! tip ""
This error was seen in NOSTALGIA Op. 2 when a user had a bad AVS config, make sure your data is from a reliable source and consider redownloading or replacing the file.

53
docs/externalresources.md Normal file
View File

@ -0,0 +1,53 @@
# External Resources
!!! warning "Before reading:"
This section contains a variety of external resources outside of this website, some even submitted by users!
I'll try to keep this pertaining primarily to resources useful to home-play like the rest of the site.
It might get a bit messy with time, but that's half the fun!
## General
!!! tip ""
- [Remywiki](https://remywiki.com/Main_Page) - Generalized BEMANI content wiki
- [GameRepair.info](https://gamerepair.info/) - Repository of arcade part repair & misc information
- [Cons&Stuff](https://consandstuff.github.io/) - Community resource for DIY controllers
- [BemaniPatcher](https://mon.im/bemanipatcher/) - Drag and drop hex edit solution for a myriad of games
### IIDX
!!! tip ""
- [sp12](https://sp12.iidx.app/) - IIDX SP☆12 reference site/difficulty tier list
- [iidx.insane.pe.kr](https://iidx.insane.pe.kr/!/) - IIDX difficulty tier list
- [Statistik](http://statistik.benhgreen.com/) - IIDX difficulty tier list
- [atwiki](https://w.atwiki.jp/bemani2sp/sp/) - IIDX wiki in JP (includes tier lists)
- [textage.cc](https://textage.cc/score/) - Chart viewing resource
- [DJ DAO IIDX troubleshooting guide](https://github.com/minsang-github/rhythmgame-docs/wiki/DJ-DAO-IIDX-controller-troubleshooting) - Step-by-step guide for FPS, FP7, PEE, RES, RED controllers.
### SDVX
!!! tip ""
- [sdvx.in](https://sdvx.in/) - SDVX chart reference
- [SDVX Progress Chart](https://docs.google.com/spreadsheets/d/1cFltguBvPplBem-x1STHnG3k4TZzFfyNEZ-RwsQszoo/edit#gid=0) - Functions as a generalized tier list
- [SDVX Unlock Guide](https://docs.google.com/spreadsheets/d/1VBYWSUaKqHUOyfCtvkHFYBSnEPwxhTh8-m4UlU8zUL0/) - Translated guide for unlocks
### GITADORA
!!! tip ""
- [573Controller](https://github.com/limyz/573controller) - DIY guitar solution for converting official cab guitars to USB home-use
- [Drummania English Menu Translation](https://twitter.com/approvedtx/status/1174028743989317632?s=21) - Handy for beginners, lots of options!

363
docs/extras/ascs.md Normal file
View File

@ -0,0 +1,363 @@
# Notes on the Most Common ASCs and Vendors
!!! warning "Before proceeding, please read:"
This section is a compilation of several of the most popular ASCs (arcade-style controllers) along with their respective vendors. Alongside this, this guide includes any aspects worth noting from usage over the years to help potential buyers make an educated purchase. For the most part, this section aims to inform buyers more of negatives and problems above all else, so expect the focus to be more negative as it's important to note all the potential problems one may come across with ownership over the years.
Lastly, certain bits will repeat across controller categories. Please treat each controller's section as its own individual list of noteworthy elements.
# IIDX
### DJ DAO FP7 EMP
<img src="/img/ascs/fp7.png">
!!! tip ""
This controller works really well, the spacing is [accurate](/img/ascs/dao_comp.png) to the arcade between buttons and the turntable, obviously the turntable size is reduced which is often noticed as a minor nuisance to players that play both at home and on cabs.
One minor aspect that's appreciated are the feet of the controller, which hold up really well on all kinds of surfaces with a stable grip, alongside the fairly hefty weight of the controller it's rather unlikely it's going to budge even a little bit during play.
This controller is not without fault though, one of the first things to go is the turntable sticker in the middle, it starts to peel pretty much instantly for several people. While some people have kept it on despite the peeling, some have ended up scratching their pinky fairly significantly on it, so it's worth considering its removal or finding a better adhesive.
The rubberized turntable grip itself is also susceptible to peeling, but it's far more reliable, perhaps miscare or improper installations from Dao lead to problems sooner, but for many it will last several years without a problem.
Another concern is in only in having a `START` and `EFFECT` at the top of the controller. IIDX utilizes 3 buttons in menu navigation, namely `START`, `EFFECT`, and `VEFX` so the limited option is a bit troublesome. However, the solution to this problem DJ DAO utilizes is the ability for the `EFFECT` button to take multiple inputs as separate bindings. To simplify this further, enabling this option allows single, double, and triple taps of the `EFFECT` button in rapid succession to be 3 different bindings, alleviating the need for another button.
Unfortunately though, this does add latency to the button, it also doesn't feel too natural, and many owners use more responsive custom firmware over DJ DAO's firmware that, at the time of writing, doesn't support this multiselect feature anyways, meaning the problem is still present. Many users choose to upgrade from the default USB board to a custom one (Arduino, Arcin) since the button lights can't be controlled via software and it's only polling at the default 250hz. Of course that also means you can't use the original board's PS2 connector anymore.
One thing to note with the rubberized turntable grip, this controller gets gross. Dead skin will build up around the edges of the turntable itself on the metal and along the edges of the rubber grip. Regular cleaning is required.
All in all, this controller has a few minor problems but is often regarded as the best balance between price and performance, as it matches arcade play at a great price.
### PHOENIXWAN
<img src="/img/ascs/wan.png">
!!! tip ""
The Phoenixwan, sometimes jokingly referred to as the wang, or phoenixwang, is a rather odd controller. It fills a niche that wasn't needed (Gamo2's site was already selling 6 different IIDX controllers) but still manages to be the smallest full-sized beatmania controller offered on the site.
As expected, the spacing between the buttons and turntable is arcade accurate, and the turntable is full sized unlike the FP7. Moreover, 4 buttons are present for menu navigation this time around.
The controller is also very flashy, with a customizable turntable LED that emits 16 million different colors, turntable sensitivity adjustment, and an audio light mode that tries its best to "dance with the music" in fanciful fashion, it's a neat gimmick. Lastly for maximum portability, this controller is very light and even features wire storage at the bottom.
However, with the flashy style this controller brings it unfortunately takes a few steps backwards in other areas. One of the most perplexing areas are the feet, there's no other way to put it, some surfaces it's great and some it sucks. With the reduced weight, this controller will slide across some surfaces with ease leading to a really unpleasant experience. It would not be surprising if with improper play that the controller could be moved very easily by accident.
Onto one of the more defining features though, the turntable grip. Gamo2's site says it's made of liquid silicone and space aluminum. The grip is fantastic, it's incredibly grippy and a lot of fun to stop on a dime back and forth on your hand. But this material doesn't come without some faults unfortunately, it gets turned into a fingerprint magnet right out of the box, and some users have reported the grip wears off and becomes flat after heavy usage. One could also argue that making a controller trying to replicate an arcade experience (hence arcade-style) that it's a bit backwards to deviate away from the arcade experience as well, but that's more semantics than anything.
Lastly and most critically, a fair batch of buyers reported PCB problems where the board seemed to flat out die after just a few months. Apparently a firmware update can be pushed to work around some issues, but there's not much that's definitive as a solution in regards to this issue at the time of writing.
Overall, the Phoenixwan is probably the best option in terms of portability and style, it's a very flashy device and great to take over to a friend's for some fun. But, with it comes a heftier price tag that might not be worth it for people looking to simply enjoy the game. With some critical issues, this controller might just be style over substance.
### YuanCon IIDX
<img src="/img/ascs/yuaniidx.png">
!!! tip ""
YuanCon's IIDX controller looks rather plain, doesn't it? But the controller works really well, the spacing is of course accurate to arcade, and the turntable is full size as well. Obviously, it features 4 buttons for menu navigation too, which is incredibly convenient.
The cost is very reasonable too, by default it comes with dubious microswitches labeled "Chinese" on the site, it's important to note that if a buyer upgrades to Omron switches on the site, it's a bit cheaper than buying Omrons separately later down the line. The "Chinese" switches are definitely not recommended and feel bad.
This controller oddly uses an acrylic turntable as well, while it's a nice attempt it's somewhat disappointing overall. At the very least, it's fairly easy to modify the turntable and place something more proper such as an EMP mat on it for a better experience. Just note that the screws are not countersunk around the center of the turntable.
Some people may be dissatisfied that the turntable has no lights too, an obvious cost cutting decision.
The default buttons are typical cheap Chinese ones, these risk occasionally getting stuck around the enclosure's corners but it's less common than Chinese buttons for use on other games such as Pop'n and some users don't end up with any problems at all. Depending on a buyer's level of tolerance they may find these buttons fine or desperately yearn for an upgrade.
One big positive for many is the detachable USB cable, it uses just one USB port which is quite handy. This comes at some costs though. The biggest issue is the lack of PS2 support, the lights are also dimmer than Dao's offerings which utilize 2 USB ports.
Yuan's IIDX attempt is solid, but it's not without fault. Regardless, just about any buyer would be more than satisfied playing and enjoying the game on this controller regardless of the few minor faults it has.
### IIDX Arcade Parts to Consider
!!! tip ""
IIDX controllers have a lot of options to choose from and it can be daunting, especially if you've never played before. I'll try to cover springs, microswitches, and buttons to the best of my ability.
I've also documented many of the parts that I talk about and where to buy them [here](/extras/parts)
!!! tip ""
- Buttons/Keys
The most commonly used buttons are Sanwa, Gersung, and DJ DAO/Yuan Chinese buttons.
I can't really speak for every arcade in Japan, but both in Japan and US almost all arcades use Sanwa buttons. The Samduck buttons are a Korean variant that can be found in Korean arcades, but are still superceded by Sanwa buttons. The DJ Dao/Yuancon buttons are cheap Chinese clones that feel less satisfying both in physical feedback and audio feedback. Some players find them servicable, but I ultimately recommend upgrading when possible. The travel distance is different on Dao buttons for example due to the inaccurate construction having a different height than official parts like Sanwa, so the feeling will be significantly different in using them.
- Microswitches and Springs
If you buy the keys sepearately it's worth noting what spring and microswitch setups they come with:
- Sanwa keys come with 100g springs and 100g Omron switches.
- Samduck keys come with 20g springs and 65g Gersung switches.
- DJ DAO keys come with 40g springs and 20g Honeywell switches.
&nbsp;
There are also many other cheap Chinese variants that I won't bother listing because I insist you do not play on them. Please stick to Omron or Gersung microswitches for an enjoyable play experience! The Honeywell microswitches for example are an incredibly cheap feeling switch that often breaks easily.
With this in mind, the most common switch and spring setups are 50g/20g, 50g/60g, and 50g/100g setups (microswitch listed first, then springs in this case). However, you will find arcades around the world using a myriad of setups.
By default for a new or inexperienced player, I would recommend a 50g/60g setup as it's a safe setup that won't require frequent maintenance, has a nice weighted feeling that will help build stamina, and isn't too light for charts with heavy amounts of jacks. That said, it ultimately comes down to user preference, with lighter setups running the risk of more maintenance, but being easier on one's hands especially for dense charts, and heavier setups being more sturdy, but easily tiring out one's hands, 100g/100g for example however, is too extreme for the grand majority of players and simply exhausting and painful to play on.
One thing worth noting is many tournaments in Japan have utilized a 25g/60g setup as well, with the heavy springs being beneficial for jacks, just as one example.
Your springs will also naturally lose resistance over time, so if you played at an arcade with a heavily worn setup I'm sure you'll find it feels very different to your brand new home setup even if you have the same weight ratings.
Experimentation is strongly recommended regardless as you become a more developed and experienced player. If you love the game, don't be afraid of traveling to try out different setups or dropping some more cash on parts to experiment.
# Sound Voltex
### DJ DAO SVSE5
<img src="/img/ascs/svse5.png">
!!! tip ""
The SVSE5 is a pretty straightforward controller without much to worry about, the sizing is very compact while retaining proper arcade spacing between the knobs and buttons at a very reasonable price, most of the gripes with this controller will come based on what parts are used. It uses the same firmware/board as the SVRE9 and also lacks HID-controlled lights.
Dao's SDVX buttons are especially prone to sticking and getting stuck under their holders, notably more than their IIDX counterparts. Thankfully, this problem can be alleviated by sanding down the corners of the buttons but they still obviously do not feel as nice as Sanwa buttons and it requires taking apart the controller, which while simple, is a minor inconvenience.
The default encoders (listed as `Knobs Structure` on the site) are horrendous, there's no nice way to put it. Please avoid these at all costs if you wish to enjoy the game or upgrade to Copals ASAP. But, it's worth noting that paying the upgrade cost when buying your controller ($30 at the time of writing) is cheaper than buying a set of Copal encoders separately (around $60+).
Dao's SVSE5 is honestly somewhat odd to write on solely because there's not much to say, it's about as standard as it gets. The SVSE5 functions well and when avoiding the default encoders buyers will end up with a controller that's able to be enjoyed just as well as any other with minimal problems.
### YuanCon SDVX
<img src="/img/ascs/yuansdvx.png">
!!! tip ""
YuanCon's SDVX controller has quickly become the most popular option for Sound Voltex players and is inarguably their best controller yet. The controller feels great in your hands thanks to its light weight and good sizing. Like the SVSE5, it matches arcade dimensions perfectly as well, so anyone can transfer their skills from home to the arcade 1 to 1. One other noteworthy convenience is the detachable USB cable, making transportation and storage a little more enjoyable.
One of aspects people comment on a fair bit is the metal casing, after years of Dao's tacky glossy acrylic designs a lot of buyers have welcomed this addition with open arms. Yuan's SDVX controller is as durable and sturdy as any other out there.
Yuan's stock SDVX buttons suffer the same problems as Dao's and are especially prone to sticking and getting stuck under their holders. While some people don't end up with any issues at all, others do, it's a mixed bag presumably based on luck on how the plastic mold came out. Thankfully, this problem can be alleviated by sanding down the corners of the buttons but they still obviously do not feel as nice as Sanwa buttons and it requires taking apart the controller, which while simple, is a minor inconvenience.
The stock encoders on this controller are interesting to note too, they're a surprisingly decent option to use, they feel very smooth and function well during play, but it's worth noting not everyone likes how they feel. Of course they don't feel like the arcade experience, but they're more than suitable for enjoyment.
Overall, YuanCon's SDVX is a very enticing option for many, it's a great controller with minimal issues. There's little negative outside of some minor gripes to say, and at this price range, buyers would be hard pressed to find a controller that's definitively superior.
### DJ DAO SVRE9
<img src="/img/ascs/svre9.png">
!!! tip ""
The crown jewel for many Sound Voltex players, the SVRE9 is designed to match the dimensions of an arcade cab as best as possible, providing both maximum luxury and performance. This controller includes arcade knobs out of the box, offering no alternative and is no doubt a part of the heftier price tag.
This controller is a monster, both in size and weight, it is probably one of the most inconvenient Sound Voltex controllers to transport but even still it's not honestly not that bad, make sure you have enough space to safely place the controller on any surface before playing. One positive about the greater size and weight is that there's almost no risk of it moving around when accidentally bumped.
Dao uses a custom harness for the arcade knobs to connect with the encoders, it's an odd contraption but it works well enough. However, it is worth noting that the encoders themselves have a plastic shaft, if tightening the inner screws holding them in place make sure to not tighten them too much as the screws will end up actually drilling into the plastic and destroying the encoder beyond repair.
The knobs unfortunately risk shipping damage wherein the knob will have a grinding feeling when being rotated, it's extremely unpleasant but thankfully solution is simple, it requires lubricating the inner parts of the knobs by taking apart a bit of the controller, a minor inconvenience.
Dao's SDVX buttons are especially prone to sticking and getting stuck under their holders, notably more than their IIDX counterparts. Thankfully, this problem can be alleviated by sanding down the corners of the buttons but they still obviously do not feel as nice as Sanwa buttons and it requires taking apart the controller, which while simple, is a minor inconvenience. One could argue that in choosing to purchase a luxury product like this, it's questionable to skimp on button quality however.
Another thing to note is that the default firmware registers itself as keyboard (buttons) and mouse (x/y for knob movement. This, the fact that it doesn't support HID-controlled lights and that it polls at 250hz is enough for many to replace it's internal control board with a custom one like the Arcin or Arduino.
Overall, this controller is widely considered the "best" option solely based on the luxury factor alone. However, the cheaper options provide the same arcade-exact dimensions, parts, and experience. It's a fantastic controller, but not for those with tighter wallets as the vastly increased cost ultimately provides nothing different in terms of play experience.
### SDVX Arcade Parts to Consider
!!! tip ""
Sound Voltex controllers have a lot of options to choose from and it can be daunting, especially if you've never played before. I'll try to cover springs, microswitches, and encoders to the best of my ability.
I've also documented many of the parts that I talk about and where to buy them [here](/extras/parts)
!!! tip ""
- Springs and Microswitches
For springs and microswitches, most [vendor](#vendors) options consist of 20g, 60g, and 100g springs. Alongside 25g, 50g, and 100g microswitches. Cabs around the world use a variety of setups but two of the most common setups are 20g springs with 100g microswitches, and 100g springs with 100g microswitches. Commonly referenced as 20g/100g and 100g/100g, though sometimes interchangably used as 100g/20g for example. (there's really no definitive order and people put the spring weight or switch weight first on a whim constantly.)
There are also various manufacturers of these parts, arcades use Sanwa parts. Some Korean arcades use Gersung Samduck parts however, a good Korean-made alternative. There are also various Chinese parts of equally garbage quality. If you order a controller with the stock Chinese buttons, they are including the cheap Chinese springs. These are fine, it's only a spring after all! But for the microswitches, please never use Chinese microswitches, they are of garbage quality and make playing the game horrendously unfun, I am adamant you do not believe the lies of those who say otherwise.
An incredibly light setup such as 20g/25g can result in an extremely dissatisfying feedback on button press, making it hard to get the feeling of actuation on button press. Not many people go for this setup.
Lots of home users default to 50g/60g setups for their first time around, it's a nice balance until they become more comfortable with the game and begin to branch out a bit more and figure out their preferences.
Furthermore, lots of Round1 arcade locations in the US use 20g spring 100g microswitch setups, so if you played at one of those, you probably felt this setting. Just keep in mind that as the springs/switches wear down the feeling will be a little different than a fresh set!
- Encoders
As for the encoders, they're the things that turn with the knob internally, they dictate the feeling of the rotation. The default encoders on most of the Dao controllers is the Alps 801 set, the Chinese default ones. These are beyond unplayable, with a clicky angle-snapping experience over a smooth twist. The grand majority of players opt for copal encoders, which are both incredibly smooth and sensitive. However, they are prone to breaking within about a year of moderate player.
The YuanCon controllers use encoders that many feel are superior to copals both in feeling and durability, so they're a very worthwhile option as well.
Lastly, the arcade encoders are extremely durable, reliable, and stiffer to turn than the other options, they're also more expensive as well.
I've documented many of the parts and where to buy them [here](/extras/parts)
# Pop'n Music
### DJ DAO POP ASC
<img src="/img/ascs/daopop.png">
!!! tip ""
Gamo2's Pop'n offering is a controller that results in a project for a lot of players. While it is a playable experience, for many, it will be dissatisfying out of the box. However, with a bit of knowledge one can turn it into a fantastic controller.
One of the biggest issues with Pop'n controllers are the buttons. The Chinese default buttons are simply unacceptable, these things stick [like crazy](https://www.youtube.com/watch?v=lC7G8P-sGXY) and getting [Samduck buttons](http://istmall.eumshop.com/us/?menuType=product&mode=view&act=list&prodCode=2016062400008), a Korean alternative, is considered almost mandatory for a lot of players. It is possible to sand down the stock Chinese Dao buttons or get lucky and only have a few with problems, but the odds are heavily stacked against the buyer's favor here. The primary problem here and why Sanwas are not offered are their extreme cost, at around $40 a button it's simply out of reach for many. At the very least, one nice addition is that by default the controller comes with Omron microswitches.
Dao's controller design here also isn't the best, it's big and bulky which has its pros and cons depending on preferences, but unlike Gamo2's other options providing magnetic bottoms that are easy to remove, the Pop'n ASC has *20* screws to gain access to the internals. While buyers hopefully won't need to be digging inside all that often, it's still a tedious process.
This controller is notably loud too, any form of play is going to generate substantial noise that will annoy others in your household. Pop'n is naturally a loud game, but many attempts can be made to alleviate some of the noise. Some people play with a towel over the controller which is called toweling, but in the more desperate cases some people have [filled the internals to brim with cotton balls](/img/ascs/cotton.jpg) and other various materials.
Many users choose to upgrade from the default USB board to a custom one (Arduino, Arcin) since the button lights can't be controlled via software and it's only polling at the default 250hz. Of course that also means you can't use the original board's PS2 connector anymore.
The pricing on this controller is a bit rough for many, due to the size and weight the shipping charges can be a significant problem notably more than other game's options as well, at least US buyers benefit from free shipping when it's in stock at the US storehouse. This controller is a good option, but it requires a bit of time, work, and funds to be truly great.
### YuanCon Pop'n
<img src="/img/ascs/yuanpop.png">
!!! tip ""
YuanCon's Pop'n controller arrived on the scene many years after Dao's controller and seemingly has managed to address some of the more notable difficulties of its competitor at an expected competitive price point and with a sleek design.
Right away it should be noted that this controller is a significantly smaller size than the Dao while retaining the expected arcade spacing between buttons. It's also in a metal shell for added durability yet it has notably less weight than the Dao.
One big positive for many is the detachable USB cable, it uses just one USB port which is quite handy. This comes at some costs though. The biggest issue is the lack of PS2 support, the lights are also dimmer than Dao's offerings which utilize 2 USB ports. Like it's competitor, it also doesn't seem to support HID-controlled button lights currently.
One of the biggest issues with Pop'n controllers are the buttons. Yuan's stock Chinese buttons are notably better than Dao's, but [Samduck buttons](http://istmall.eumshop.com/us/?menuType=product&mode=view&act=list&prodCode=2016062400008), a Korean alternative, are still preferred as the stock Chinese buttons don't always feel satisfying depending on preferences. Sanwa buttons are incredibly expensive at around $40 a pop for Pop'n controllers, so they're simply out of the question for many players.
It's also worth noting that this controller comes with Chinese microswitches, which is a disappointment. Many players vastly prefer Omron microswitches over the Chinese clones.
This controller is notably loud too, any form of play is going to generate substantial noise that will annoy others in your household. Pop'n is naturally a loud game and this applies to any controller, but many attempts can be made to alleviate some of the noise. Some people play with a towel over the controller which is called toweling, but in the more desperate cases some people have [filled the internals to brim with cotton balls](/img/ascs/cotton.jpg) and other various materials.
Yuan's Pop'n controller and its pricing is very good, perhaps due to the known dissatisfaction with Chinese Pop'n buttons, the controller is offered to come with no buttons and switches to save further on cost, making it an extremely enticing option for anyone that would rather buy their buttons and switches separately. Compared to alternatives, the pricing on this Pop'n ASC is best in class by a significant margin and it functions just as well as any other out there.
# jubeat
### DJ DAO FB9
<img src='/img/ascs/fb9.png'>
!!! tip ""
Gamo2's jubeat controller is a very fun contraption, buyers actually slide their own monitor under it in order to play. While neat, the pricing on this thing isn't for the faint of heart and unfortunately it doesn't come without some problems.
Right away the need to buy your own monitor separately should be addressed, as it adds to the already high cost and the requirements for the monitor are somewhat specific as well, further complicating things.
Dao's jubeat board is also laughably bad and skilled players notice difficulties with timing and accuracy issues compared to a cab, many FB9 owners actually swap out the board for [a P4IO alternative](https://zhousensor.world.taobao.com/) that matches arcade play far better for a more accurate and enjoyable experience. The biggest difference is in [how multiple buttons are pressed](https://www.youtube.com/watch?v=Q2ptgzlEmWE) so the issue is less prominent and earlier stages in the game.
The rubbers for the buttons are also less than desirable, with a gummy and dissatisfying feeling that's prompted many to switch. [Zhousensor](https://zhousensor.world.taobao.com/) provides better replacements ([resold by YubiParts for US and international buyers](https://www.yubiparts.com/)) and official ones can be bought on sites like [Yahoo Auctions Japan](https://auctions.yahoo.co.jp/) for a reasonable price.
The controller can also slide around a bit on some less than desirable surfaces and with inexperienced play, creating a need to readjust it fairly often after songs.
Dao's buttons also have a slight rainbow effect going on around the edges inside the plastic on certain screens, some people may find it moderately distracting to see.
Gamo2's jubeat offering isn't terrible, but it's not great either. The controller is for many people essentially a project that has a far greater pricetag than the notable one their site already lists. Buyers can end up going a few hundred over the controller's individual price just to get the controller to feel like a truly enjoyable experience. With the problems listed above, it's hard to fully recommend it. But ultimately, options are scarce for jubeat players.
# DDR
### StepManiaX Stage
<img src="/img/ascs/smx.gif">
!!! tip ""
Dance games have the luxury of many pads functioning the same across a wide variety of games so while it's not specifically for DDR, this is simply the apex beyond buying your own arcade cab. At an extreme price tag, Kyle Ward spares no expense to create the ultimate controller. It's even hard to label this thing as a true ASC, as it's not styled like an arcade controller, it IS one!
Getting into the important details though, a couple of changes on the latest model feature a new sleek design, superior FSR sensors that help to minimalize maintenance, and a fleet of sleek LED customization to really help a buyer individual their product and make it look and feel like theirs.
There's really only two "problems" present. Firstly, the cost, it's a premium and then some. However, the experience is also the best of any option short of owning a cab or official arcade pads. Yet even then, there's a strong argument to be had that the newer technology present trumps some of the dated arcade parts and design.
Second, the weight. While the pad is on wheels for easy movement the listed weight on the side is 220 pounds, getting the pad up and down staircases won't be fun.
Purists might argue using the StepManiaX Stage on DDR isn't an authentic experience without brackets and no doubt the feeling is slightly different as well with the different sensors. But many prominent players prefer bracketless pads anyways and consider the design outdated. FSRs are undoubtedly superior technology as well.
Overall, it's borderline impossible to find fault with the StepManiaX Stage beyond purist nitpicking, the controller is is simply the best. An entire separate page could be written on the difficulties DDR ASCs over the years have had with numerous disasters in regards of shipping challenges and historically bad controllers to the point that this is the best option short of building your own pad, buying a cab, or buying pads off a cab. Yet even then, the experience might be found superior here.
### L-Tek pads (AKA Polish Dance Pads)
<img src="/img/ascs/ltek.jpg">
!!! tip ""
In terms of functionality, these pads are totally fine for beginner to intermediate play. Compared to the pads listed above they are obviously more "home grown" feeling, but they are perfectly functional and with regular maintenance will carry you well into the DDR 15/ITG 12 range before needing to think about modifications.
Pads are availble in an array of configurations (4 panel or 5 panel variants are available) and prices, they have recently added a pad that has a bar pre installed and also offer it seperate if you would like to add it to an exsisting pad.
In terms of pricing, they are relatively affordable coming in at 184.58USD+shipping.
All in all, I'd say they are a totally acceptable pad for someone wanting to get back into the game or starting out and wanting something that will last with little upkeep.
# Vendors
<a href="https://www.gamo2.com" target="_blank"><img style="float: right;" src="/img/ascs/g2.jpg"></a>
### Gamo2
&nbsp;
!!! tip ""
- Website: <https://www.gamo2.com>
- Social Media: <https://twitter.com/gamotwo>
Gamo2 has been around for a rather long time and is still one of, if not the most popular choice for people looking to buy an ASC. Dao sells a wide variety of controllers and occasionally squeezes out a new one here and there.
Buyers can expect their controllers to arrive in secure and snug packaging, shipping time varies but is often prompt. Alongside this, Gamo2's shipping is incredibly expensive, they only ship with EMS and charge a premium for it, it's not fun. However, Gamo2 provides a US storehouse for buyers in the US to enjoy free shipping and get packages sooner as well. Keep an eye on their social media as the US storehouse offerings only happen a few times a year and sell out quick!
Some buyers have noted lengthy delays when buying from Gamo2 so it's not all good news, seemingly randomly as well without any communication too. It's worth checking if there's any Chinese holidays going on or coming up before making a purchase, as they will certainly add to the wait. Most people might be surprised how many of those holidays seem to arise at just the worst time.
Gamo2's in-house buttons flat out suck across every controller, these buttons are cheapo Chinese knock offs of Sanwa buttons and it shows. Depending on a buyer's level of tolerance they may find these buttons fine or desperately yearn for an upgrade. Sanwa buttons may seem overpriced, but they are well worth the investment for those looking for arcade accuracy. Sound Voltex and [Pop'n Music](https://www.youtube.com/watch?v=lC7G8P-sGXY) Dao buttons are especially prone to getting stuck within the controller.
Gamo2 also provides Honeywell switches by default while charging additional for Omron switches. Sadly, Honeywell switches are laughably bad compared to Omron and the almost unanimous consensus is to not even bother with Honeywell switches, they are far too sensitive and break far too easily. Upgrading to Omron switches should be an *immediate* decision for anyone unable to buy them right away alongside their controller, or simply holding out until the upgrade can be included with the purchase, it's that extreme of a difference.
Finally, Gamo2's tech support is good. Dao's English isn't the best, but he is very patient and understanding, willing to work with buyers on almost any issue or question they could have.
<a href="https://yuancon.store" target="_blank"><img style="float: right;" src="/img/ascs/yuan.png"></a>
### YuanCon
&nbsp;
!!! tip ""
- Website: <https://yuancon.store>
- Social Media: <https://twitter.com/yuancontop>
YuanCon has grown immensely in popularity in just a short amount of time, if Gamo2 is no longer on top, then look to YuanCon as they self-report they're currently ranked first in Chinese sales! YuanCon's approach so far has been fantastic communication and utilizing their Discord server and Twitter to get their name out there as much as possible, even partnering with prominent rhythm game players.
Buyers can expect their controllers to arrive within a moderate timeframe and in fancy Yuan-branded packaging that's more than suitable. On top of this, the pricing is extremely competitive and shipping prices are more fair than Gamo2. With this however, comes a lack of availability. Controllers often go out of stock so it's important to keep up with when pre-orders and restocks are going up.
Default Yuan buttons are the typical cheap Chinese buttons that are not ideal for play, some users report less trouble with the buttons than Dao's default buttons, but Sanwas are always preferable. Yuan thankfully doesn't even bother with Honeywell switches, only offering Omron microswitches instead, a welcomed decision.
Perhaps due to inexperience or quality control issues, there has been a notable minority of people with issues that have to be acknowledged below.
Shipping times have varied widely, the grand majority of buyers get their packages promptly within 1-2 weeks, but there have been reports of some extreme cases well over 4+ weeks. This situation however was met promptly with an [official statement](https://yuancon.store/official/aboutpcb.pdf) from Yuan and his team. However, at the time of writing, I am aware of someone that has been waiting for their controller to ship for over 3 months.
Some controllers have also arrived damaged or with missing elements. One prominent example was a [large number of broken panels](https://twitter.com/yuancontop/status/1150695358688899072) prompting refunds and a manufacturing change.
Also worth noting that again at the time of writing, YuanCon's RGB offerings literally have LEDs that brown out and their engineer "does not want to add HID lighting." Both a comical and egregious negative.
It's worth noting that despite these negatives, Yuan and his team have made great efforts to stay very communicative and ensure that nobody ends up with a faulty product they're dissatisfied with, as shown in the above links. YuanCon's support and communication is top notch, and the future remains promising. Even if there's a small risk of initial hassle through slow shipping or quality control, buyers will ultimately end up with a fully functioning product that they can be satisfied with one way or another.
<a href="https://shop.steprevolution.com/" target="_blank"><img style="float: right;" src="/img/ascs/Stepmaniax Logo.png"></a>
### StepRevolution (StepManiaX)
&nbsp;
!!! tip ""
- Website: <https://shop.steprevolution.com/>
- Social Media: <https://twitter.com/smxgame>
Premium pads, spare parts and full cabinets that are designed to either play StepmaniaX or have other games run on them are for sale, there is official support for setting up a normal computer for use with stepmania or if you have the right configuration you can use Pump it up simulators with the cabinet aswell, and Kyle Ward is always very helpful for anyone who has questions!
Only downside is the pads/cabs sell out usually within minutes of them going on sale and the shipping time can be multiple months some times as they are done made to order. Buyers can expect their pads to arrive in secure pallet packaging and the few times things have arrived either damaged or non working, customer support has been excellent and issues are always resolved quickly.
American based company and every person who has purchased a pad or cabinet has been nothing short of ecstatic with it, if you have the money and don't mind waiting, this is the best option on the market, in or out of the arcade!
<a href="https://maty-taneczne.pl/" target="_blank"><img style="float: right;" src="/img/ascs/L-tek Logo.png"></a>
### L-Tek
&nbsp;
!!! tip ""
- Website: <https://maty-taneczne.pl/>
- Social Media: <https://www.facebook.com/maty-tanecznepl-106162192775436/>
Pads are good starting points and most customers who've purchased them have been happy with them. Shipping is usually reasonably quick (upto a month depending on where in the world you are).
They offer a range of products, both 4-panel and 5-panel pads, acecssories (replacement panels, sensors, bar attachment) to suit most people's dance pad needs.
I have heard of cases of panels cracking under heavy use, but every case of this (I can recall one) has been resolved quickly and at no extra cost to the customer who had the pad.
If you're in the market for a dance pad, and don't want to spend SMX money or hunt down an old arcade cabinet, I'd say they're worth the money.

52
docs/extras/hexguide.md Normal file
View File

@ -0,0 +1,52 @@
# Beginner's Guide to Hex Editing
!!! warning "Before reading:"
This section is for users that have never hex edited their game before, if you already know how to do this, nothing here will be of any use to you.
### Before Beginning
!!! tip ""
There's several ways to apply hex edits to games, for the sake of this guide we'll demonstrate the manual way of doing edits to games in the event that the sites/services that simplify the process ever go down.
We'll be using HxD to edit beatmania IIDX 25 CANNON BALLERS, the process is the same for any other game so this guide can work universally.
Here's what you'll need:
- Your favorite hex editor, such as [HxD](https://mh-nexus.de/en/hxd/).
- A clean copy of your desired BEMANI game.
- A backup of your original `.dll` before editing in the event of any mistakes.
### Getting Started
!!! tip ""
So after downloading HxD or your preferred editor and deciding on what hex edits you want to apply, it's time to load it up for the first time. If you're using HxD, you'll be greeted with the screen below.
<img src="/img/hexguide/1.png">
!!! tip ""
Open up the appropriate `.dll` file inside HxD that you wish to edit, for the grand majority of hex edits, this is the main game file, such as `bm2dx.dll`, `soundvoltex.dll`, and so on. Pictured below, I've opened up `bm2dx.dll` inside of HxD.
<img src="/img/hexguide/2.png">
!!! warning "Please note:"
For demonstrative purposes, we're going to apply 1 edit to the game. The edit we'll be applying is EXCLUSIVE to this version of the game, meaning that it will not work on any other version of the game, nor any other games, because it's modifying specific addresses in memory that only apply to this specific version of the game.
!!! tip ""
The edit we've chosen to apply is `Unlock All Songs` and its edit is `0xB60B2: 74 10 -> 90 90` so to start in HxD we're going to hit `Ctrl+G` to open the `Goto` window. From here, we'll input the offset `B60B2` inside the `Offset` section, as pictured, and hit OK.
<img src="/img/hexguide/3.png">
!!! tip ""
Your cursor should be taken to the offset at the exact location you're ready to edit. As you can see, the numbers in front of you are `74` and `10` the same exact ones we need to replace! If they're not, it's likely you put in the wrong offset so be sure to double check.
<img src="/img/hexguide/4.png">
!!! tip ""
From here, all we need to do is mouse over `74 10` and replace it with `90 90` you can do this by either manually typing `90 90` or by copy and pasting, it should look as it does below.
<img src="/img/hexguide/5.png">
!!! tip ""
Once that's done, all you need to do is save the changes and repeat for every additional edit you want to do! The whole process is merely repeating by going to whichever offsets an edit requires and replacing the values in each location just as we did! Simple, right?

265
docs/extras/parts.md Normal file
View File

@ -0,0 +1,265 @@
# Arcade Part Documentation
!!! warning "Before proceeding, please read:"
This section is a list of various arcade part manufacturers with part model numbers and misc documentation concerning said parts as needed, alongside links on where to purchase parts from the most trusted locations (not every link to purchase will be included, there's too many parts sellers, only ones I've personally found reliable are listed.)
I'm not confident this will be all-encompassing of every part ever, but it will be sufficient for those purchasing arcade style controllers (ASCs) and those in need of maintenance for said controllers. I'm omitting things like 400g springs, or 10g microswitches because no one really uses these products for regular play, but they exist nonetheless!
One last thing, if there's for example, multiple model numbers of say, 25g microswitches, you can assume they have different internals and thus provide different feedback. I'm not aware of anyone qualified and experienced enough to give exact logistics on how these parts may feel different, so I've omitted any details and will simply specify what the most common [vendors](/extras/ascs#vendors) provide alongside these variants.
!!! danger "7/26/2020 IMPORTANT Notice:"
Rakuten has switched to separate services, namely Rakuten Ichiba and Rakuten Global Express, they have provided an FAQ [here.](https://global.rakuten.com/en/store/sanwadenshi/close/) Essentially, some vendors will continue to offer international shipping, but the proxy service now exists for those that do not. If Sanwa Denshi does not ship to your region, simply sign up for their proxy service, or another of your choosing that is willing to provide for you.
Alongside this, Sanwa Denshi seemingly no longer provides the typical lamps in many of the old-model button types that has been custom for many years. Given I am unfamiliar with anyone currently using these new lamps in their controllers, at the time of writing, I will provide links to buttons with the lamp and lamp-less buttons. On some listings, they allow the option to select the LED voltage and on others, they do not.
- Just for reference:
- DJ DAO boards: 5V
- YuanCon boards: 12V
- Arcin: 5V (or 12V if you only hook up the negative side)
So, if you're overly concerned as a new buyer, you can choose to buy lamps at a later date. I apologize for the inconvenience and current inability to provide more detailed information, and will be working to update this ASAP.
Lastly, I have to remove IST Mall (Korean seller) from many of the listings at this time because their Sanwa options seemingly have now begun to use the new-style connectors that are not compatible with provided connectors from existing ASC vendors. I apologize for this inconvenience, but feel free to buy this new style if you understand JST connectors and can wire things up with basic electronics skills.
## IIDX Buttons
### Sanwa
!!! tip "Rectangular Gameplay Keys"
- Both OBSA-45UK-W and OBSA-45UK-B come with 100N springs and 100g switches (Omron V-10-1A4).
- OBSA-45UK-W (White keys)
- Where to buy:
- [Sanwa Rakuten (Official JP Store) - With Lamp](https://item.rakuten.co.jp/sanwadenshi/ilumb_099/)
- [Sanwa Rakuten (Official JP Store) - Lamp-less](https://item.rakuten.co.jp/sanwadenshi/ilumb_100/)
- [Buyee (Rakuten Proxy) - Old Lamp Holder With Lamp](https://buyee.jp/rakuten/detail/sanwadenshi%3A10000151)
- [Buyee (Rakuten Proxy) - Old Lamp Holder Lamp-less](https://buyee.jp/rakuten/detail/sanwadenshi%3A10000152)
- [IST MALL (KR Seller)](http://istmall.co.kr/us/goods/goods_view.php?goodsNo=1009992239)
- OBSA-45UK-B (Black keys)
- Where to buy:
- [Sanwa Rakuten (Official JP Store) - With Lamp](https://item.rakuten.co.jp/sanwadenshi/ilumb_097/)
- [Sanwa Rakuten (Official JP Store) - Lamp-less](https://item.rakuten.co.jp/sanwadenshi/ilumb_098/)
- [Buyee (Rakuten Proxy) - Old Lamp Holder With Lamp](https://buyee.jp/rakuten/detail/sanwadenshi%3A10000148)
- [Buyee (Rakuten Proxy) - Old Lamp Holder Lamp-less](https://buyee.jp/rakuten/detail/sanwadenshi%3A10000149)
- [IST MALL (KR Seller)](http://istmall.co.kr/us/goods/goods_view.php?goodsNo=1009992239)
!!! tip "Square Menu/Option Buttons"
- OBSA-30UK
- Where to buy:
- [Sanwa Rakuten (Official JP Store - With Lamp)](https://item.rakuten.co.jp/sanwadenshi/ilumb_237/)
- [Sanwa Rakuten (Official JP Store - Lamp-less)](https://item.rakuten.co.jp/sanwadenshi/ilumb_239/)
### Samduck
!!! tip "Rectangular Gameplay Keys"
- CWB 405
- Comes with Gersung switches (45g) and springs (20-30N)
- Does not come with lights but compatible with Dao lamps and ISTMall lamps.
- Can use the same switches and springs as Sanwa OBSA-45UK buttons.
- Where to buy:
- [IST MALL (KR Seller)](http://istmall.co.kr/us/goods/goods_view.php?goodsNo=1009992351)
!!! tip "Square Menu/Option Buttons"
- CWB 406
- Does not come with lights but compatible with Dao lamps and ISTMall lamps.
- Where to buy:
- [IST MALL (KR Seller)](https://istmall.co.kr/us/goods/goods_view.php?goodsNo=1009992352)
&nbsp;
## SDVX Buttons
### Sanwa
!!! tip "Square BT Gameplay Buttons"
- Sanwa OBSA-60UK
- Where to buy:
- [Sanwa Rakuten (Official JP Store)](https://item.rakuten.co.jp/sanwadenshi/ilumb_078/)
- [Buyee (Rakuten Proxy) - Old Lamp Holder With Lamp](https://buyee.jp/rakuten/detail/sanwadenshi%3A10000121)
- [Buyee (Rakuten Proxy) - Old Lamp Holder Without Lamp](https://buyee.jp/rakuten/detail/sanwadenshi%3A10000123)
!!! tip "Rectangular FX Gameplay Buttons"
- OBSA-45UK-B (Black FX keys)
- Where to buy:
- [Sanwa Rakuten (Official JP Store - With Lamp)](https://item.rakuten.co.jp/sanwadenshi/ilumb_237/)
- [Sanwa Rakuten (Official JP Store - Lamp-less)](https://item.rakuten.co.jp/sanwadenshi/ilumb_239/)
- [Buyee (Rakuten Proxy) - Old Lamp Holder With Lamp](https://buyee.jp/rakuten/detail/sanwadenshi%3A10000148)
- [Buyee (Rakuten Proxy) - Old Lamp Holder Lamp-less](https://buyee.jp/rakuten/detail/sanwadenshi%3A10000149)
!!! tip "Start Button"
- OBSA-30UK
- Where to buy:
- [Sanwa Rakuten (Official JP Store - With Lamp)](https://item.rakuten.co.jp/sanwadenshi/ilumb_237/)
- [Sanwa Rakuten (Official JP Store - Lamp-less)](https://item.rakuten.co.jp/sanwadenshi/ilumb_239/)
### Samduck
!!! tip "Rectangular FX Gameplay Buttons"
- CWB 405
- Where to buy:
- [IST MALL (KR Seller)](http://istmall.co.kr/us/goods/goods_view.php?goodsNo=1009992351)
!!! tip "Start Button"
- CWB 406
- Where to buy:
- [IST MALL (KR Seller)](https://istmall.co.kr/us/goods/goods_view.php?goodsNo=1009992352)
&nbsp;
## SDVX Encoders
### Options
!!! tip "Copal Encoders"
- RES20D-50-201-1
- Where to buy:
- [Octopart (Lists Multiple Sellers)](https://octopart.com/res20d-50-201-1-nidec+copal-87192281)
- [GAMO2 (Upgrade set from stock Chinese, CN seller)](https://www.gamo2.com/en/index.php?dispatch=products.view&product_id=316)
!!! tip "YuanCon's Encoders"
- Where to buy:
- [Tabobao (CN Seller)](https://item.taobao.com/item.htm?spm=a1z10.1-c.w4023-4332278748.12.6619558dDKUwMr&id=545099516240)
!!! tip "Sensatec Encoders (Arcade)"
- ELV-24Y36A-K (GAMO2 Arcade Encoders)
- Where to buy:
- [Sensatec (JP Seller)](https://www.sensatec.co.jp/e/products/detail.php?product_id=47)
- [Metro Electric (JP Seller)](http://www.e-metro.jp/quick/ELV-24.html)
- ELV-24M36A-K
- Where to buy:
- [Sensatec (JP Seller)](https://www.sensatec.co.jp/e/products/detail.php?product_id=336)
&nbsp;
## Pop&apos;n Buttons
### Sanwa
!!! tip "Circular Dome Gameplay Buttons"
- OBSA-100UMQ
- Comes with 200N springs and 200g Omron switches.
- Where to buy:
- [Sanwa Rakuten (Official JP Store) - With Lamp](https://item.rakuten.co.jp/sanwadenshi/ilumb_133/)
- [Sanwa Rakuten (Official JP Store) - Lamp-less](https://item.rakuten.co.jp/sanwadenshi/ilumb_135/)
- [Buyee (Rakuten Proxy) - Old Lamp Holder With Lamp](https://buyee.jp/rakuten/detail/sanwadenshi%3A10000193)
- [Buyee (Rakuten Proxy) - Old Lamp Holder Lamp-less](https://buyee.jp/rakuten/detail/sanwadenshi%3A10000195)
### Samduck
!!! tip "Circular Dome Gameplay Buttons"
- CWB 401
- IST Mall incorrectly claims to ship these with 40N springs and 45g Gersung switches, but in reality the springs are much, much heavier (suspected to be 200-300N springs). Recommended to separately purchase springs and switches.
- Where to buy:
- [IST MALL (KR Seller)](https://istmall.co.kr/us/goods/goods_view.php?goodsNo=1009992353)
&nbsp;
## Jubeat Rubbers
### Options
!!! tip "ZhouSensor"
- Where to buy:
- [ZhouSensor Taobao Store(CN)](https://item.taobao.com/item.htm?id=44786039741)
- [YubiParts (US-based, ships internationally)](https://www.yubiparts.com/)
&nbsp;
## Microswitches
### Omron
!!! tip "25g Microswitches"
- D2MV-01-1C2 (GAMO2 and YuanCon provided)
- Where to buy:
- [Digikey (US Seller)](https://www.digikey.com/product-detail/en/omron-electronics-inc-emc-div/D2MV-01-1C2/Z4707-ND/5236583)
- [Sanwa Rakuten (Official JP Store)](https://item.rakuten.co.jp/sanwadenshi/ilumb_222/)
- [IST MALL (KR Seller)](http://istmall.co.kr/us/goods/goods_view.php?goodsNo=1009992803)
- [Buyee (Rakuten Proxy)](https://buyee.jp/rakuten/detail/sanwadenshi%3A10000320)
- VX-01-1C22
- Where to buy:
- [Digikey (US Seller)](https://www.digikey.com/product-detail/en/omron-electronics-inc-emc-div/VX-01-1C22/Z4644-ND/369961)
- [Mouser (US Seller)](https://www.mouser.com/ProductDetail/Omron-Electronics/VX-01-1C22?qs=1tDaWCEHQQ6vTHtQABSaag%3D%3D)
!!! tip "50g Microswitches"
- D2MV-01-1C3 (GAMO2 provided)
- Where to buy:
- [Digikey (US Seller)](https://www.digikey.com/product-detail/en/omron-electronics-inc-emc-div/D2MV-01-1C3/Z4708-ND/5236584)
- [Sanwa Rakuten (Official JP Store)](https://item.rakuten.co.jp/sanwadenshi/ilumb_223/)
- [IST MALL (KR Seller)](http://istmall.co.kr/us/goods/goods_view.php?goodsNo=1009992804)
- [Buyee (Rakuten Proxy)](https://buyee.jp/rakuten/detail/sanwadenshi%3A10000321)
- VX-01-1C23
- Where to buy:
- [Digikey (US Seller)](https://www.digikey.com/product-detail/en/omron-electronics-inc-emc-div/D2MV-01-1C3/Z4708-ND/5236584)
- [Mouser (US Seller)](https://www.mouser.com/ProductDetail/Omron-Electronics/D2MV-01-1C3?qs=HDDQUw%2F3Phqm1Y5wA%2Fdz9w%3D%3D)
!!! tip "100g Microswitches"
- V-10-1A4 (Arcade default, GAMO2 provided)
- Where to buy:
- [Digikey (US Seller)](https://www.digikey.com/product-detail/en/omron-electronics-inc-emc-div/V-10-1A4/Z4588-ND/1828942)
- [IST MALL (KR Seller)](http://istmall.co.kr/us/goods/goods_view.php?goodsNo=1009992411)
- [Buyee (Rakuten Proxy)](https://buyee.jp/rakuten/detail/sanwadenshi%3A10000283)
### Gersung
!!! tip "60g Microswitches"
- GSM-V0303A06
- Advertised as "between 50g and 100g".
- Where to buy:
- [IST MALL (KR Seller)](http://istmall.co.kr/us/goods/goods_view.php?goodsNo=1009992526)
&nbsp;
## Springs
### Options
!!! tip "20g Springs"
- OBSA-SP-20
- Where to buy:
- [Sanwa Rakuten (Official JP Store)](https://item.rakuten.co.jp/sanwadenshi/ilumb_218/)
- [IST MALL (KR Seller)](https://istmall.co.kr/us/goods/goods_view.php?goodsNo=1009992953)
- [Buyee (Rakuten Proxy)](https://buyee.jp/rakuten/detail/sanwadenshi%3A10000291)
- IST Spring
- Where to buy:
- [IST MALL (KR Seller)](https://istmall.co.kr/us/goods/goods_view.php?goodsNo=1009992332)
!!! tip "40g Springs"
- OBSA-SP-40
- Where to buy:
- [Sanwa Rakuten (Official JP Store)](https://item.rakuten.co.jp/sanwadenshi/ilumb_303/)
- [IST MALL (KR Seller)](https://istmall.co.kr/us/goods/goods_view.php?goodsNo=1009992953)
- [Buyee (Rakuten Proxy)](https://buyee.jp/rakuten/detail/sanwadenshi%3A10000442)
!!! tip "50g Springs"
- OBSA-SP-50
- Where to buy:
- [Sanwa Rakuten (Official JP Store)](https://item.rakuten.co.jp/sanwadenshi/ilumb_500/)
- [Buyee (Rakuten Proxy)](https://buyee.jp/rakuten/detail/sanwadenshi%3A10000449)
!!! tip "60g Springs"
- OBSA-SP-60-K
- Where to buy:
- [Sanwa Rakuten (Official JP Store)](https://item.rakuten.co.jp/sanwadenshi/ilumb_300/)
- [IST MALL (KR Seller)](https://istmall.co.kr/us/goods/goods_view.php?goodsNo=1009992953)
- [Buyee (Rakuten Proxy)](https://buyee.jp/rakuten/detail/sanwadenshi%3A10000392)
- IST Spring
- Where to buy:
- [IST MALL (KR Seller)](https://istmall.co.kr/us/goods/goods_view.php?goodsNo=1009992332)
!!! tip "100g Springs"
- OBSA-SP-100
- Where to buy:
- [Sanwa Rakuten (Official JP Store)](https://item.rakuten.co.jp/sanwadenshi/ilumb_217/)
- [IST MALL (KR Seller)](https://istmall.co.kr/us/goods/goods_view.php?goodsNo=1009992953)
- IST Spring
- Where to buy:
- [IST MALL (KR Seller)](https://istmall.co.kr/us/goods/goods_view.php?goodsNo=1009992332)
## LED Lamps
### Options
!!! tip "ISTMall lamps"
- Where to buy:
- [IST MALL (KR Seller)](https://istmall.co.kr/us/goods/goods_view.php?goodsNo=1009992273)

52
docs/extras/pollingrates.md Normal file
View File

@ -0,0 +1,52 @@
# List of Touchscreen Monitors and their Polling Rates
!!! warning "Before reading:"
This section contains a few touchscreen monitors tested by community members over the years and their respective polling rates. Please note that a polling rate is **NOT THE REFRESH RATE** of a monitor, but is the critical factor in determining how responsive a touchscreen is and is unfortunately something every major retailer omits from their product listings due to lack of consumer awareness.
At higher levels of gameplay, rapid button presses may fail to be acknowledged by touchscreen monitors with a low polling rate, making good scores impossible and creating a frustrating experience.
Every BEMANI game with a touchscreen polls at 250hz, and some use an IR grid to achieve this. Thus, I am defining viable as 180hz or more, but I will include some monitors and manufacturer dates under this to help curious buyers be aware, as sometimes different manufacturer dates result in different polling rates and it's always good to document cruddy monitors to save people money.
One thing to note is, this is not to say that monitors with low polling rates are unusable, they can still provide enjoyment and are often cheap enough to be a great option to see how far one may want to get into a certain touchscreen based game. But, the goal is to provide a potential buyer information to make an educated choice, and monitors with low polling rates will run the risk of needing to be replaced as higher levels of play, potentially causing frustration and wasted money.
If you want to check your touch screen monitor's polling rate simply download [Mouse Rate Checker](https://www.softpedia.com/get/System/System-Miscellaneous/Mouse-Rate-Checker.shtml) and move your finger across the window at a reasonable pace, but not too fast! After you get your results, maybe even consider [contacting me with your monitor type, manufacturing date, and result](/about/#contact) so that I can include your results where applicable.
### Dell S2240T
!!! tip ""
- 2013 Manufacturing Date:
- <span style="color: #04ca04;">200hz **GREAT!**</span>
- 2014 Manufacturing Date:
- <span style="color: #04ca04;">May: 200hz **GREAT!**</span>
- <span style="color: green;">September: 180hz</span>
- 2015 Manufacturing Date:
- <span style="color: #04ca04;">March: 200hz **GREAT!**</span>
- <span style="color: #04ca04;">September: 200hz **GREAT!**</span>
- Late 2016 Manufacturing Date:
- <span style="color: #d57b00;">140hz **AVOID**</span>
- Early 2017 Manufacturing Date:
- <span style="color: green;">180hz</span>
- Mid 2017 Manufacturing Date:
- <span style="color: #d57b00;">140hz **AVOID**</span>
- February 2018 Manufacturing Date:
- <span style="color: green;">180hz</span>
### Dell P2314T
!!! tip ""
- November 2015 Manufacturing Date:
- <span style="color: #b70e25;">60hz **DO NOT BUY!**</span>
### Dell P2418HT
!!! tip ""
- May 2018 Manufacturing Date:
- <span style="color: #b70e25;">60hz **DO NOT BUY!**</span>
### Iiyama T2336MSC
!!! tip ""
- Revision B1:
- <span style="color: green;">180hz</span>

55
docs/extras/spiceerrors.md Normal file
View File

@ -0,0 +1,55 @@
# SpiceTools Error Messages
!!! warning "Before reading:"
This section contains common errors that users may come across when utilizing SpiceTools that DO NOT pertain to [Error Codes.](/errorcodes/) While it's virtually impossible to write on every solution for every error, there's a small handful that arise from time to time. Consider this one of the weaker sections on the site due to the infinitely varying amounts of hardware and game-specific problems that may arise. Nonetheless, this section may be helpful as a last resort or for overly specific issues. Errors are listed in potpourri fashion with game specific notes inside said sections as applicable.
### Initial Checklist
!!! tip ""
There's always a couple quick things to check before even running SpiceTools, namely...
- Your data comes from a clean and trusted source, ideally unmodified.
- You are not currently seeding your data and it's not already opened.
- You have specified within Windows that SpiceTools should be ran as an administrator.
- You're using the latest SpiceTools
- You've correctly followed the `First Time Setup` and `Common Problems/Tips` section of your desired game and your `.bat` file contains no errors.
### Failed to Read /dev/nvram/coin.xml.
!!! tip ""
Copy `coin.xml` from `prop` to `dev/nvram` or alternatively, update to a SpiceTools as new as 03/04/2020 or later.
### Failed to Read /dev/nvram/eacoin.xml.
!!! tip ""
Copy `eacoin.xml` from `prop` to `dev/nvram` or alternatively, update to a SpiceTools as new as 03/04/2020 or later.
### Cannot create property: prop/ea3-config.xml
!!! tip ""
Firstly make sure your `ea3-config.xml` is clean and that it is not set to `Read-only`.
If it's been modified, common problems that might arise may be having `https` under `<services __type="str">urlhere</services>` or anywhere else a custom services URL has been added. Use `http` instead.
Don't use notepad when modifying any of the .xml files, it can break the encoding and cause issues.
Ideally just use SpiceTools `-url` and `-p` parameters to avoid modifying this file in most use cases.
### XYZ Couldn't be loaded: Specified module cannot be found.
!!! tip ""
Firstly, make sure what is attempting to load is indeed present.
If the file is `libavs-win64.dll` then you're using 64-bit SpiceTools when the game is 32-bit, please switch to 32-bit instead. SpiceTools should also tell you do this!
However, more often than not this error is more the user missing specific dependencies. Below are the most common ones that are missing on a fresh installation or older hardware.
- [Microsoft Visual C++ 2010 Redistributable Package (x64)](https://www.microsoft.com/en-us/download/confirmation.aspx?id=14632)
- [DirectX 9.0c End-User Runtime](https://www.microsoft.com/en-us/download/details.aspx?id=34429)
### Crashing Upon Startup
!!! tip ""
This issue has numerous reasons all pertaining to the user, most commonly the game is not able to run at its specified resolution, say a game requiring portrait mode while running in landscape for example. This might also occur if installation was not done properly, or key files are missing as well.
SpiceTools does a good job documenting what errors are occurring, make sure to read near the bottom of `log.txt` after a crash to try and better understand what might be wrong.

199
docs/extras/spiceguide.md Normal file
View File

@ -0,0 +1,199 @@
# SpiceTools Usage, Parameters, and Functionality
- **Last Update: March 14th, 2020.**
- **Version Covered: March 3rd, 2020.**
!!! warning "Before reading:"
This section contains a myriad of information regarding SpiceTools including the games supported, various parameters, and its functionality. Feel free to consult this section anytime you are confused or simply want to learn more. However, SpiceTools is consistently updated and updates to this section may fall behind, to combat this, the above information in bold will cover the latest revision of SpiceTools this guide covers and along the latest update to this section.
### What is SpiceTools?
!!! tip ""
SpiceTools is a toolkit allowing users to play several Konami games on their PC, typically of the arcade variety with the focus being on BEMANI games. The idea behind SpiceTools is to provide a simple to use toolkit that consists of just the executable and its configuration, allowing users to have minimal interaction with game files and thus minimizing user error.
### Why SpiceTools
!!! tip ""
The reason this guide utilizes SpiceTools exclusively is because it's capable of running games without the user ever touching a single file, minimizes any potential user error. On top of this, SpiceTools has a few exclusive features that benefit new and experienced players alike. The combination of simplicity and advanced features makes it an ideal choice.
### SpiceOverlay
!!! tip ""
One of the newest features SpiceTools has is an included overlay called SpiceOverlay, it contains a number of useful options such as a patch manager to enable/disable hex edits on the fly, and virtual keypads, its keybinds are as follows below:
``F5 - Keypad P1``
``F6 - Keypad P2``
``F7 - Card Manager``
``F8 - Log``
``F9 - Control``
``F10 - Patch Manager``
``F12 - Overlay/FPS toggle``
### SpiceOptions
!!! tip ""
SpiceTools now features an options tab that allows you to set parameters inside the game with the ability to restart the game after you make your desired changes.
<img src="/img/spice/options.png">
Note that the purple highlighted options are tied to the specific game you are running, you do not need to check them in most cases as oftentimes they are loaded automatically for most setups.
### SpiceCompanion
!!! tip ""
SpiceTools also has a companion app on android called [SpiceCompanion](https://play.google.com/store/apps/details?id=spicedev.spicecompanion) this guide won't go over all of its features and functionalities, perhaps a separate page would be more appropriate. Just note it shares many similarities with SpiceOverlay and is yet another powerful tool to aid in playing these arcade games. One fan favorite feature is the ability to utilize your phone as a card reader, allowing friends to easily card-in and play alongside you.
### Supported Games
!!! tip ""
SpiceTools at the time of writing supports the following games, if no specific denotation is listed, assume all recent versions of said game):
- beatmania IIDX (Tricoro and newer)
- Sound Voltex
- jubeat (knit and newer)
- Reflec Beat
- Dance Evolution Arcade
- DanceDanceRevolution
- Beatstream
- Road Fighters 3D
- Pop'n Music
- MÚSECA
- Metal Gear Arcade
- GITADORA (XG3 and newer)
- NOSTALGIA
- BISHI BASHI CHANNEL
- QUIZ MAGIC ACADEMY
- MAHJONG FIGHT CLUB
- FutureTomTom
- SCOTTO
- HELLO! Pop'n Music
- LovePlus
- DANCERUSH STARDOM
- Steel Chronicle
- Tenkaichi Shogikai
- Otoca D'or
- Winning Eleven 2012
### Coins
!!! tip ""
There's a coin emulation working for most games, simply press F1 to insert a single coin.
Some games have an additional/different coin key.
### Readers
!!! tip ""
If you have an original Wavepass reader and have it connected to a COM port on your computer, SpiceTools should be able to use it. It was being created and tested with the newer readers also used in the newer Pop'n Music games.
Example for one reader on COM3: -reader COM3
Example for two readers for P1/2 on COM3 and COM4: -reader COM3 -reader COM4
Example for one reader with P1/2 toggle on NumLock: -togglereader COM3
### SpiceTools API
!!! tip ""
SpiceTools has its own API with a custom protocol. The main goals were simplicity, portability and extensibility, so TCP/JSON was chosen, allowing fast access over network.
It optionally supports passwords/encryption and its response time on LAN was tested to be below 1ms (as long as extended API logging isn't enabled manually).
For details and how to use it, check out README.md in the included source. Additionally, python and dart libraries are provided for easy communication.
Key features are card/coin insertions, read/write access for keypads/analogs/buttons/lights, status information and memory read/write via raw addresses and signatures.
### Bemanitools 5 API Compatibility
!!! tip ""
There is basic BT5 API integration as of 03/13/2018.
This feature can be enabled with `-bt5api` and currently makes use of eamio.dll only.
Currently, this can be used for applications such as the popular NFCeamuse app which can be found elsewhere.
### Keybindings/Analogs
!!! tip ""
As of beta, buttons can be bound via either RawInput (the default) or "Naive" (GetAsyncKeyState).
RawInput supports all kinds of HID controllers (your FP7 is one, your XBOX360 Controller as well), however it's bound to a device.
If you plug your controller into another USB slot, SpiceTools does not have a way to detect it and will report the device as "missing", until you plug it back into where you originally configured it.
Using the "naive" approach, only keyboard buttons can be detected, however this will then work with any keyboard attached, it's not bound to a device.
Since May 2018 you can also bind MIDI devices for "one-shot" types like drums and hold types like piano keys and launchpads.
### Usage
!!! tip ""
Utilizing SpiceTools is very straightforward, it typically involves simply dropping SpiceTools 32-bit or 64-bit (depending on game requirements) into your chosen game's content folder, creating a `.bat` file that initializes SpiceTools and desired parameters. For the grand majority of user installations, I've documented how to best utilize SpiceTools in the first time setup section of your respective game, so please read over it. One of the easiest and classic examples of a `.bat` file's contents would be along the lines of `spice64.exe -ea -w` which would boot SpiceTools with the `-ea` and `-w` parameters, more on parameters below.
### Parameters
!!! tip ""
SpiceTools consists of several dozen parameters for users to utilize to fill their needs. Ideally, these parameters are initialized using a user created `.bat` file as described above. If you open up `spicecfg.exe` and head on over to the options tab, you can hover over the far left `?` with your mouse to get an idea as to what a parameter does!
The grand majority of parameters are for advanced users, but don't be scared if you don't understand what most do.
&nbsp;
## Notes on Functionality for Several Games
### beatmania IIDX
!!! tip ""
For using your own cameras in IIDX 25 or newer, just plug them in (and hopefully your camera isn't incompatible with the game) and they shall work.
It's also possible to use one camera only instead of the two the game wants, just dismiss the camera error on game boot as you would with no cameras connected, and your camera should be registered in-game as CAMERA A. If you're not happy with the order of the automatic camera detection, just use -iidxflipcams and CAMERA B will be CAMERA A, etc.
You can bind the effectors as analog inputs if you want, this is especially interesting for IIDX 25 and newer, where the effects are software based and not tied to specific sound cards anymore. When not bound, they will stay on the maximum value.
### Sound Voltex
!!! tip ""
Printer fully supported as of 03/13/2018, can save prints in PNG/BMP/TGA to a customizable output path.
Optionally able to clean up saved images on game boot time.
Keyboard play should be perfectly working. If you don't want to use the mouse for the knobs, you can make use of native knob emulation, which works just as it works in Keyshoot-Mania.
### jubeat
!!! tip ""
This makes use of the SpiceTools touch module, which makes you able to play any version of the game just fine with both mouse and HID compliant touch devices on Windows 7 or newer.
The Dell ST2240T touch screen seems to work well, especially the new 2017 revision.
Card insert button available and enabled by default.
Touch the area to insert a card in attract mode.
### GITADORA
!!! tip ""
To switch between Guitar/Drum you need to specify the specific eamuse config to load. By default, SpiceTools first tries to load ea3-config.xml, then eamuse-config.xml.
Since the latter one is the default for the drums, for the guitar you have to override the path setting like so: `spice64.exe -e prop\eamuse-config2.xml`
Additionally, since GitaDora uses 4 channels by default, you can specify -2ch to run it with 2 channel audio instead. If you don't and have a normal 2 channel setup, the game will refuse to play sound/tracks.
### Reflec Beat
!!! tip ""
Including emulation of the real IR touch screen device so the game should just act like the real one.
This makes use of the SpiceTools Touch module, which makes you able to play any version of the game just fine with both mouse and HID compliant touch devices.
Card insert button available and enabled by default.
For this game it's not visible in fullscreen but still works just as fine.
Touch the area to insert a card in attract mode.
### NOSTALGIA
!!! tip ""
Spicetools will auto-detect whether or not a compatible touch device is present. If a touch device is detected, the mouse cursor will disappear. If no touch device is detected, the mouse cursor will be visible in-game. During boot-up process, do not click or else the game may pre-maturely crash. You may safely click after the monitor check is completed. It's been found that Virtual HID Touch devices commonly found with remote access software may cause detection issues, take note of that.
Some people have had issues with crashing on startup while having multiple monitors while using windowed mode, consider disabling the other monitors to see if this alleviates the issue.

209
docs/extras/streamaudio.md Normal file
View File

@ -0,0 +1,209 @@
# Workarounds for exclusive audio
!!! warning "Before reading:"
This section describes various workarounds and tips for dealing with games that use exclusive mode audio.
In the recent years, BEMANI games started using WASAPI exclusive mode and ASIO to output game audio. While these provide great benefit when it comes to audio latency perceived by the player, they present additional challenges when trying to use other audio applications at the same time (e.g. a Discord voice call) or when capturing game audio for recording and streaming. This page explains how you can work around these issues. Read on carefully, as there are many things that can go wrong when dealing with audio.
**Remember, don't stream or upload recordings to public places! Privately among friends only!**
## Setting up audio
There are advantages and disadvantages to each of the methods, so read carefully.
### Option 1 - force shared audio
- Enables: audio device sharing (voice calls while playing), recording, streaming
- Advantage: very easy to set up, as seen below.
- Disadvantages: may add significant audio latency to your game, depending on the game and your hardware, to a point where it becomes unplayable.
!!! tip "Sound Voltex"
- Enable "Shared mode WASAPI" hex edit.
- If you run into any issues, change the audio playback device to output at 44.1khz and 16 bit.
!!! tip "IIDX"
- For TDJ mode, ensure that the sound output device is set to WASAPI.
- In SpiceTools, set -iidxsounddevice to wasapi.
- Enable "Force shared audio" hex edit.
- If you run into any issues, change the audio playback device to output at 44.1khz and 16 bit.
- That's really all there is. If you use OBS or Discord to capture the game, you will not have any issues recording audio with this configuration.
### Option 2 - Stereo Mix
- Enables: recording, streaming
- Does NOT enable: audio device sharing (voice calls while playing)
- Advantages: nothing to set up, no added latency to audio playback
- Disadvantages: only works with some audio cards (most Realtek devices should work), recorded audio may be delayed or off-sync
Some sound cards have a thing called Stereo Mix, which presents itself as a recording device that mirrors everything that is being outputted from the sound card. Conveniently this can be captured even when a game has exclusive control of the audio device.
!!! tip "Enabling stereo mix"
1. Ensure that you have the latest audio drivers.
- For example, if you have a Realtek audio device, use a Realtek driver and not the generic Windows HD Audio driver.
1. Go to Windows Sound device settings. In the Playback tab, make sure the default audio device is set to the sound card output (speakers or headphones).
1. Go to Recording devices tab.
1. Look for Stereo Mix. If you don't see it, right click and check "Show Disabled Devices" and try again.
- <img src="/img/voicemeeter/stereomix.png">
!!! tip "Capturing audio in OBS with Stereo Mix"
1. Add a new Audio Input Capture source.
1. Set the device as Stereo Mix.
1. You can now capture audio.
1. You'll probably want to set to "Monitor Off" so you don't get duplicated audio.
### Option 3 - audio splitter cable (lo-tech method)
- Enables: recording, streaming
- Does NOT enable: audio device sharing (voice calls while playing)
- Advantages: easy one-time set up, no added latency to audio playback
- Disadvantages: costs money, recorded audio may be delayed or off-sync, audio may become quieter
!!! tip "Equipment"
1. Buy an audio splitter cable, and a headphone extension cable.
1. Split the audio coming out of your computer into two: one into speakers/headphones, another into the extension cable, which then goes into the "line in" port of your PC.
!!! tip "Capturing audio in OBS"
- Add "Line In" as an audio input source.
### Option 4 - FlexASIO
- Enables: audio device sharing (voice calls while playing), recording, streaming
- Advantages: one-time set up, does not affect other audio configuration
- Disadvantages: not as flexible as Voicemeeter when it comes to recording, adds a small latency
FlexASIO is a virtual ASIO service that can redirect output to various backends, including shared mode WASAPI.
!!! tip "FlexASIO set up"
1. Install [FlexASIO](https://github.com/dechamps/FlexASIO/releases)
1. Create a FlexASIO.toml configuration file in your user folder (C:\Users\Your Name)
1. Insert these lines inside your configuration file:
backend = "Windows WASAPI"
bufferSizeSamples = 386
channels = 2
wasapiExclusiveMode = false
[output]
suggestedLatencySeconds = 0.0
Try to lower bufferSizeSamples for minimal latency - recommended value is 128. If you hear audio crackling, increase bufferSizeSamples.
!!! tip "Sound Voltex"
- Disable "Shared mode WASAPI" hex edit. You want the game to output in exclusive mode for lower overall latency.
!!! tip "IIDX"
- For TDJ mode, ensure that the sound output device is set to WASAPI.
- In SpiceTools, set -iidxsounddevice to wasapi.
- Disable "Force shared audio" hex edit. You want the game to output in exclusive mode for lower overall latency.
!!! tip "SpiceTools set up to use ASIO"
1. Under the options tab, set -audiobackend to asio
1. If you have more than one ASIO driver installed, launch the game and look through the logs for something like this:
---------------
[YYYY/MM/DD HH:MM:SS] I:audio::asio: Driver 0
[YYYY/MM/DD HH:MM:SS] I:audio::asio: ... Name : FlexASIO
[YYYY/MM/DD HH:MM:SS] I:audio::asio: Driver 1
[YYYY/MM/DD HH:MM:SS] I:audio::asio: ... Name : Voicemeeter Virtual ASIO
---------------
Find the number attached to the ASIO driver of your choice and use -asiodriverid [deviceid] to make the game use the driver. In the example above, Voicemeeter's ID is 1, and FlexASIO is 0.
- To capture audio, you can capture desktop audio as you normally would in OBS.
### Option 5 - Voicemeeter
- Enables: audio device sharing (voice calls while playing), recording, streaming
- Advantages: highly configurable, adds very little latency
- Disadvantages: can be a challenge to set up, difficult to troubleshoot when things go wrong, need to run Voicemeeter every time
Voicemeeter is free virtual audio mixer for Windows. It allows you to "mux" audio input streams into audio output streams; here, we take advantage of this application to redirect the game audio so that you enable audio capture & simultaneously enable other audio streams like voice calls.
!!! tip "Initial Voicemeeter set up"
1. Download [Voicemeeter Potato](https://vb-audio.com/Voicemeeter/banana.htm).
- Potato comes with all three versions - regular Voicemeeter, Banana, and Potato.
- Regular Voicemeeter is not good enough if you are following this guide. Banana is good enough if you want to mux two audio sources (say, game audio and Discord). Potato is recommended if you want to stream to Discord via OBS using instructions in the next section.
1. Install and **REBOOT YOUR COMPUTER** when prompted.
1. Launch Voicemeeter Banana or Potato, whichever one you prefer.
1. On the right hand side, you will see flashing red text that says "Select Main Output Device (A1). Look immediately to the left, click on A1 with a down arrow, and choose your output device. Typically you want the one that starts with "WDM:", but if your audio device supports it, "ASIO:" option will provide lower latency.
- <img src="/img/voicemeeter/a1.png">
1. In Windows sound settings, set your default audio playback device to Voicemeeter Input (and not Voicemeeter AUX Input!)
!!! tip "Discord or other voice applications"
- Configure the output device to Voicemeeter AUX Input.
!!! tip "Sound Voltex"
- Disable "Shared mode WASAPI" hex edit. You want the game to output in exclusive mode for lower overall latency.
!!! tip "IIDX"
- Disable "Force shared audio" hex edit. You want the game to output in exclusive mode for lower overall latency.
- For TDJ mode, ensure that the sound output device is set to WASAPI.
- In SpiceTools, set -iidxsounddevice to wasapi.
- (Optionally, you can output the game audio using SpiceTools -audiobackend asio and outputting to Voicemeeter ASIO instead of doing it over WASAPI, but probably provides negligible benefit to latency)
At this point, you may want to look up various tutorials on YouTube to learn the basics of Voicemeeter. It may be daunting at first, but once you understand the concepts, it can be a very powerful tool. Plus, you can go beyond what I demonstrate below and instead do more complicated things on your own!
!!! tip "Muxing with Voicemeeter"
1. Launch the game.
1. In Voicemeeter, you'll notice that the VU meter under Voicemeeter VAIO is showing that it is receiving game audio. You'll want to ensure "A1" box is green so that you route the game audio to your main output device, so you can hear the game in your ears.
- <img src="/img/voicemeeter/vumeter.png">
1. (Similarly, audio from the voice chat would come through Voicemeeter AUX column.)
1. At this point, you are able to hear both the game & listen to voice chat - success!
!!! tip "Capturing audio in OBS with Voicemeeter"
1. Now, how do you capture this audio for recording? The basic idea is to route game audio to Voicemeeter's virtual output device, and capturing that output device in OBS.
1. In the Voicemeeter VAIO column, click on B1 to make it turn green. This connects game audio to B1 channel, which is Voicemeeter Output virtual audio device.
1. In OBS, create a new Audio Input Capture source.
1. Double click on the new source and select VoiceMeeter Output (VB-Audio VoiceMeeter VAIO) from the drop-down.
1. Click on the gear icon on the audio source, click on Advanced Audio Properties. In the "Audio Monitoring" column, set it to Monitor Off. This way, you can avoid double audio in your headphones when recording.
- (Note that if you want to stream to Discord, you'll be doing something else instead; see the steps below.)
1. You are done. You should see the game audio come through to OBS.
## Streaming to Discord
!!! danger "Important"
**To reiterate, do NOT stream in public places! Privately among friends only!**
If you followed Option 1 (force shared mode audio), as previously mentioned, all you need is to capture the game window and stream to Discord.
If you followed other options, a bit more work is involved to stream both video and audio at the same time. One method is to capture audio and video in OBS, and screen sharing OBS to Discord. Follow these instructions:
### Setting up Virtual Audio Monitor in OBS
We are going to make OBS capture audio and redirect the result to a virtual monitor device. In other words, OBS will be "outputting" audio to a fake speaker. Since it's still outputting audio, Discord is able to capture it, but you can avoid duplicated game audio this way.
!!! tip "Option 1 - Using Virtual Audio Cable"
1. Download and install [Virtual Audio Cable](https://vb-audio.com/Cable/index.htm).
1. Go to OBS Settings, Audio, Advanced, Monitoring Device - set to CABLE Input.
1. Go to Edit, Advanced Audio Properties. For any audio channels you want to stream, turn on monitor to "Monitor and Output".
!!! tip "Option 2 - Using Voicemeeter Potato"
1. We are going to make use of an unused virtual input device which is only available in Potato. In Banana this feature is not present.
1. Go to OBS Settings, Audio, Advanced, Monitoring Device - set to VoiceMeeter VAIO3 Input.
- <img src="/img/voicemeeter/obsvaio3.png">
1. Go to Edit, Advanced Audio Properties. For any audio channels you want to stream, turn on monitor to "Monitor and Output".
1. In VoiceMeeter Potato, prevent VAIO3 output so that you don't hear the OBS monitor audio in your ears. You can do this by disabling A1, B1, and so on in the VAIO3 column.
### Streaming OBS Windowed Preview to Discord
!!! tip ""
1. Add the game window capture as a scene, as you normally would in OBS.
1. Right click on OBS stage and click on Windows Projector (Preview).
- <img src="/img/voicemeeter/projector.png">
1. Resize the new window as needed.
1. Use Discord to screen share this Windowed Projector.
- <img src="/img/voicemeeter/golive.png">
1. You're done! The screen share should include both the OBS scene and the audio.
## Troubleshooting
!!! tip "General"
- Game is too quiet!
- IIDX in TDJ mode is especially quiet. Try LDJ mode if you don't have a way to amplify things.
!!! tip "Voicemeeter"
- Use the right version - Banana or Potato is recommended. Regular Voicemeeter lacks features so you can't follow the steps in this guide.
- If you hear crackling, or if you feel the latency is too high, you'll need to adjust the buffer size. This is highly dependent on your set up; it's recommended that you search "how to fix crackling audio voicemeeter" or "how to reduce latency in voicemeeter" and you'll get lots of helpful guides.
!!! tip "Discord"
- If Discord fails to capture audio, go to Discord settings, Voice & Video, and enable "Use an experimental method to capture audio from applications". This should already be checked by default.

BIN
docs/files/usaneko-unlock.zip Normal file
View File

Binary file not shown.

22
docs/games/beatstreamfinal/hexedits.md Normal file
View File

@ -0,0 +1,22 @@
# BeatStream アニムトライヴ Hex Edits
!!! warning "Unsure how to apply hex edits?"
Check out the [Beginner's Guide to Hex Editing](http://www.bemani.guide/extras/hexguide/) for assistance.
### List of Known Edits For NBT-2016111400
!!! tip ""
All below edits are applied to `beatstream.dll`
E:/ Drive Fix
- `8645FC: 65 3A 2F -> 64 65 76`
Unlock All Songs
- `16CCB1: 48 83 FD 10 72 03 48 8B 09 41 -> BE 00 00 00 00 E9 3A 01 00 00`
Nightmare Difficulty Unlock
- `16EADE: 8B CB E8 DB B4 0E 00 -> B0 01 E9 AD 00 00 00`

39
docs/games/beatstreamfinal/problems.md Normal file
View File

@ -0,0 +1,39 @@
# BeatStream アニムトライヴ
### Hardware Specs
!!! tip ""
Bemani PC Type 6 (ADE-704A)
Based on an AMD Embedded R Series SoC.
CPU: Intel Celeron B810
GPU: AMD Radeon E4690
OS: Windows 7 Embedded
### My Game Doesn't Boot After Following the Guide!
!!! tip ""
The most common problem present here is if you do not have an E:/ drive. To resolve this issue, you must apply the `E:/drive fix` hex edit found [here.](hexedits.md)
### My Touchscreen Monitor Isn't Working
!!! tip ""
Try adding the `-wintouch` parameter to your `.bat` file, if that doesn't work, check the log and make sure it works with windows. SpiceTools at this point works with the grand majority of touchscreen monitors but no doubt some outliers are out there!
### My Game Is Running Slow/Lagging
!!! tip ""
Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.
### My Game Is Running Crazy Fast!
!!! tip ""
The most common reason for this is the game is running over its required 60hz, the game is hardcoded to run at 60hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60hz. You can always check on the game's monitor check if the game is fluctuating around 59.94hz, the NTSC standard. If it's not around there and your monitor is indeed set to 60hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.
### 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 (-).

71
docs/games/beatstreamfinal/setup.md Normal file
View File

@ -0,0 +1,71 @@
# BeatStream アニムトライヴ
!!! 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.
Lastly, for demonstrative purposes, this guide uses SpiceTools, you should consult appropriate documentation and requirements of your desired tools as the setup process is likely to be extremely similar.
### Getting Started
!!! tip ""
Before we even touch the game, let's fiddle with our audio settings to minimize any potential audio issues 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 `44100 Hz` and check both of the options inside `Exclusive Mode` as pictured.
<img src="/img/gen/441.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 desired 64-bit tools inside the game's `contents` folder, and to create a `.bat` file. Pictured below is what your folder should look like, feel free to name your `.bat` file whatever you desire, for the sake of convenience we've named ours `gamestart.bat`.
<img src="/img/bst/1.png">
### Configuring Your Tools
!!! tip ""
Now that you have your files ready, open up your `.bat` file in your desired text editor (we're using [Notepad++](https://notepad-plus-plus.org/)) and edit it with your desired parameters, for the purpose of this guide we will demonstrate both a local network configuration and an online example below with SpiceTools, skip to whichever you're in need of accordingly and please keep in mind you can add whatever additional parameters you desire.
!!! warning "If you're not using SpiceTools:"
The overall structure of your .bat file will differ from the guide, namely the initialization of SpiceTools won't be present and potential parameters may differ. As stated above, make sure to check the documentation of your tools to ensure you're using the correct parameters for your needs.
### Configuring for a Local Network
!!! tip ""
For our local network configuration example, on a single line in the `.bat` file we're going to type `spice64.exe -ea -w` and save the file.
What do these different parameters do?
- `-ea` enables an integrated e-amusement server within SpiceTools.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/iidx25/2.png">
### Configuring for an Online Network
!!! tip ""
For our online network example we're simply doing the above but with different parameters! On our single line, we're going to type `spice64.exe -p XXXXXXXXXXXXXXXXXXXX -url http://yoururlhere.com/ -w` and save the file.
What do these different parameters do?
- `-p` takes your PCBID on your network of choice, simply replace `XXXXXXXXXXXXXXXXXXXX` with your PCBID.
- `-url` allows you to specify a custom service URL to connect with, simply replace `http://yoururlhere.com/` with your chosen network's URL.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/iidx25/3.png">
### Final Steps and Setting up the Game
!!! tip ""
The last steps you'll have to do with your chosen tools is simply setting up your desired keybinds! Make sure you setup the `Test` keybind as it will be critical for setting up the game. Once you've done that, launch your game for the first time by double clicking the `.bat` you setup and the game should load.
!!! tip ""
You're all done! If you have a touchscreen monitor make sure it's plugged in, it should work automatically, if it doesn't check out the advertised `Common Problems/Tips` section at the link below.
!!! 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.

13
docs/games/danevo/hexedits.md Normal file
View File

@ -0,0 +1,13 @@
# DanceEvolution Arcade Hex Edits
!!! warning "Unsure how to apply hex edits?"
Check out the [Beginner's Guide to Hex Editing](http://www.bemani.guide/extras/hexguide/) for assistance.
### List of Known Edits For KDM-2016021900
!!! tip ""
Song Difficulties Unlocked
- `gamekdm.dll - 0x544A2: 18 74 2F -> 18 90 90`

5
docs/games/danevo/problems.md Normal file
View File

@ -0,0 +1,5 @@
# to be added
!!! warning "to be added"
to be added

5
docs/games/danevo/setup.md Normal file
View File

@ -0,0 +1,5 @@
# to be added
!!! warning "to be added"
to be added

57
docs/games/ddrace/hexedits.md Normal file
View File

@ -0,0 +1,57 @@
# DanceDanceRevolution Ace Hex Edits
!!! warning "Unsure how to apply hex edits?"
Check out the [Beginner's Guide to Hex Editing](http://www.bemani.guide/extras/hexguide/) for assistance.
### List of Known Edits For MDX-2019042200
!!! tip ""
All edits below are for `gamemdx.dll` unless otherwise specified.
Force Enable Fast/Slow
- gamemdx.dll: `0x97C60: 8B 41 44 -> 31 C0 40`
Force Background Judgement
- gamemdx.dll: `0x97C50: 8B 41 -> 31 C0`
Force Darkest Background
- gamemdx.dll: `0x98A0E: 75 03 33 C0 -> 33 C0 B0 03`
Song Unlock (Incomplete - Unlocks All the Event Mode Songs but Still Requires Editing the Music Database)
- gamemdx.dll: `0x846D1: 45 F4 -> 90 E9, 0x8D007: 32 C0 -> B0 01`
Tutorial Skip
- gamemdx.dll: `0x49D33: 75 -> EB`
Timer Freeze
- gamemdx.dll: `0x275D7: 74 -> EB`
Unlock Options
- gamemdx.dll: `0x82733: 75 -> EB`
Force Cabinet Type 6 (A20 Gold Theme)
- gamemdx.dll: `0xDE18: FF 24 -> EB 71`
Force ENDYMION Menu Background
- gamemdx.dll: `0x1F98D: EC -> F0`
Skip a20 Menu Background Loading
- gamemdx.dll: `0x1F944: 75 -> EB`
Make Notes Possible to Read When Using Darkest Setting (Sets to 99%)
- gamemdx.dll: `0x1C9F6: 33 33 33 3F -> A4 70 7D 3F`

65
docs/games/ddrace/problems.md Normal file
View File

@ -0,0 +1,65 @@
# DDR Ace Common Problems/Tips
### Hardware Specs
!!! tip ""
Bemani PC Type 4
CPU: Celeron M 440 1.86GHz
GPU: ATI Radeon HD 2400
RAM: 2 GB
OS: Windows XP Embedded
### My Game Is Running Slow/Lagging
!!! tip ""
Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.
### Ddr a's Video Background Are Missing in the Menus And/Or Some Songs Soft-Lock the Game on the Nth/Final/Extra Stage Screen
!!! tip ""
DDR's Video backgrounds rely on two DLLs in the game's "com" folder. However, unlike most other Bemani AC Games, these DLLs must be registered (Windows must know that these files exist, and where to point to when they are called). Without these, the game will run, but songs that rely on FMV backgrounds will break and the menu's backgrounds will be blank.
There are two ways to fix this: You can either install the [K-lite Codec Pack](https://codecguide.com/download_kl.htm) (which gives the added bonus of enabling playback of weird esoteric video formats outside of the game) or register the DLLs for the game manually, if you wish to save space and aren't afraid of the command prompt.
You can download the K-lite codec pack from here: https://www.codecguide.com/download_kl.htm
The basic installer is all you need. Simply install the pack and then run DDR A.
To register the DLLs with Windows:
1. Open an elevated command prompt (Right click Command Prompt -> Run As Administrator)
2. Navigate to your Windows directory (Typically C:/ Windows), then to SysWOW64 (Or System32 if on a 32-bit version of Windows) by typing `cd C:/windows` inside the command prompt
3. Type `regsvr32 [path to one of the two DLLs in your DDR A's "content/com/" folder]`
Ex: `regsvsr32 D:\MDX-2019042200\contents\com k-clvsd.dll`
4. Repeat the command for the other DLL in the folder, and then close command prompt
Ex: `regvsr32 D:\MDX-2019042200\contents\com xactengine2_10.dll`
5. If everything went smoothly, run the game again with your desired tools and enjoy a properly working DDR A!
### I Want to Play in 4:3 (SD) Mode!
!!! tip ""
If you're using SpiceTools, you can add `-ddrsd` to your `gamestart.bat` file and the game will boot into 4:3 mode.
### Where Is the Option For Dancers/Shading/Measure lines/Fast-Slow/Layering?
!!! tip ""
These options are locked behind network requirements and they will not show unless connected to a network that has written support for these options. There are some [hex edits](hexedits.md) for some of these options, however
### Why Is My Game Not in English?
!!! tip ""
English text is built in, change `<dest>J</dest>` in the `eamuse-config.xml` file inside `contents/prop` to `<dest>A</dest>`, then you can change language to English in the service menu's `GAME OPTIONS` (accessed via Spice's `Test` button). If English is not automatically set as pictured below. Make sure the code at the top left upon booting indicates `A:A:A` as desired.
<img src="/img/ddrace/eng.png">

74
docs/games/ddrace/setup.md Normal file
View File

@ -0,0 +1,74 @@
# DANCE DANCE REVOLUTION ACE
!!! 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.
Lastly, for demonstrative purposes, this guide uses SpiceTools, you should consult appropriate documentation and requirements of your desired tools as the setup process is likely to be extremely similar.
### Getting Started
!!! tip ""
This game still uses DirectSound so we can skip audio related setup needed for other games. 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 desired 32-bit tools inside the game's `contents` folder, and to create a `.bat` file. Pictured below is what your folder should look like, feel free to name your `.bat` file anything you desire, for the sake of convenience we've named ours `gamestart.bat`.
<img src="/img/ddrace/1.png">
### Configuring Your Tools
!!! tip ""
Now that you have your files ready, open up your `.bat` file in your desired text editor (we're using [Notepad++](https://notepad-plus-plus.org/)) and edit it with your desired parameters, for the purpose of this guide we will demonstrate both a local network configuration and an online example below with SpiceTools, skip to whichever you're in need of accordingly and please keep in mind you can add whatever additional parameters you desire.
!!! warning "If you're not using SpiceTools:"
The overall structure of your .bat file will differ from the guide, namely the initialization of SpiceTools won't be present and potential parameters may differ. As stated above, make sure to check the documentation of your tools to ensure you're using the correct parameters for your needs.
### Configuring for a Local Network
!!! tip ""
For our local network configuration example, on a single line in the `.bat` file we're going to type `spice.exe -ea -w` and save the file.
What do these different parameters do?
- `-ea` enables an integrated e-amusement server within SpiceTools.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/ddrace/2.png">
### Configuring for an Online Network
!!! tip ""
For our online network example we're simply doing the above but with different parameters! On our single line, we're going to type `spice.exe -p XXXXXXXXXXXXXXXXXXXX -url http://yoururlhere.com/ -w` and save the file.
What do these different parameters do?
- `-p` takes your PCBID on your network of choice, simply replace `XXXXXXXXXXXXXXXXXXXX` with your PCBID.
- `-url` allows you to specify a custom service URL to connect with, simply replace `http://yoururlhere.com/` with your chosen network's URL.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/ddrace/3.png">
!!! tip ""
One final note, since you're playing on a network, you will have one additional step of setting up your card file within your chosen tools, make sure to check your server's information on how to setup a card file.
### Final Steps and Setting up the Game
!!! tip ""
One last important note before booting the game is that you should install K-Lite Mega Codec (See [Common Problems/Tips](problems.md#ddr-as-video-background-are-missing-in-the-menus-andor-some-songs-soft-lock-the-game-on-the-nthfinalextra-stage-screen) for a guide!) before booting, the game will run without it, but some songs will lock up and the game will crash and all background videos will be black on most setups.
With that, you're all done! The final step you'll have to do with your chosen tools is simply setting up your desired keybinds! Once you've done that, Boot the game with your `gamestart.bat` and the game should load and be ready to be enjoyed! 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.

16
docs/games/exchain/hexedits.md Normal file
View File

@ -0,0 +1,16 @@
# GITADORA EXCHAIN Hex Edits
!!! warning "Unsure how to apply hex edits?"
Check out the [Beginner's Guide to Hex Editing](http://www.bemani.guide/extras/hexguide/) for assistance.
###List of Known Edits For M32-2019092400
!!! tip ""
Timer Freeze
- game.dll: `0xBC27: 0F 85 AA 01 00 00 -> E9 AB 01 00 00 90`
Fix IP change error
- libshare-pj.dll: `0x23305: 74 -> EB`

69
docs/games/exchain/problems.md Normal file
View File

@ -0,0 +1,69 @@
# GITADORA EXCHAIN Common Problems/Tips
### Hardware Specs
!!! tip ""
Bemani PC Type 4
CPU: AMD Athlon 64 X2 4400
GPU: ATI Radeon HD 2400
RAM: 1 GB
OS: Windows 7 Embedded
### My Game Is Running Slow/Lagging
!!! tip ""
Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.
### My Game Is Running Crazy Fast!
!!! tip ""
The most common reason for this is the game is running over its required 60hz, the game is hardcoded to run at 60hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60hz. You can always check on the game's monitor check if the game is fluctuating around 59.94hz, the NTSC standard. If it's not around there and your monitor is indeed set to 60hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.
### Game Stuck On Title Screen (AMD Ryzen 3900X)
!!! tip ""
If you have AMD Ryzen 3900X-series processor and the game gets stuck on the title screen (or a black screen) you are running into a known processor bug for games using Media Foundation to play videos. The workaround is to disable simultaneous multithreading (SMT) in the system's BIOS settings. See [this GitHub issue for Proton](https://github.com/ValveSoftware/Proton/issues/838#issuecomment-557081962)
### Occasional Graphical Stuttering During Gameplay
!!! tip ""
Disable fullscreen optimizations for spice64.exe instance. Right click on spice64.exe, click on Properties. Click on Compatibility tab, "Change settings for all users", and check "Disable fullscreen optimizations".
### I get an IP Change Error!
!!! tip ""
Apply the [Fix IP Change Error Hex Edit](/games/exchain/hexedits/)
### 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 (-). Gitadora features BOTH a visual offset and an audio based one, so experiment accordingly.
### Why Are My Videos Freezing (Usually Towards the End of the Song)?
!!! tip ""
If you're using Windows 10, there is a bug that is caused by the difference between the ASF stream decoder between Windows 7 and Windows 10 wherein it fails to properly detect the end of file of the video stream which causes the video decoder to throw an exception, which is why the video freezes. At the time of writing, SpiceTools does not have a fix for this, but there are hooks available to resolve this issue.
### I Tried Switching to SpiceTools to Follow the Guide and It Crashes!
!!! tip ""
This is a known issue, make sure to replace all of the `.dll` files from the ``contents`` folder of the game with ones from a fresh install, other tools currently modify these files in a way that SpiceTools cannot deal with.
### My Drum Pedal Isn't Working!
!!! tip ""
Some drum kits utilize hi-hat control with the pedal resulting in different MIDI addresses that require additional bindings, make sure to follow your drum kit's manual to see these other bindings and bind them in your desired tool's accordingly. Gitadora does not do this, so the game utilizes just 1 binding for every level of sensitivity on the pedal and multiple bindings are typically required with most drum kits.
### When I Run This Game All Other Background Audio Is Gone! What's Going On?
!!! tip ""
Gitadora is a 64-bit game that utilizes 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 BEMANI games which used [DirectSound](https://en.wikipedia.org/wiki/DirectSound). Unfortunately, this cannot be changed.
### Note on 2-channel and 4-channel Audio
!!! tip ""
For most setups, the `-2ch` parameter will be mandatory to hear any functional audio. 4-channel setups aren't really working in general and there's buffer issues, please avoid using it.

142
docs/games/exchain/setup.md Normal file
View File

@ -0,0 +1,142 @@
# GITADORA EXCHAIN
!!! 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.
Lastly, for demonstrative purposes, this guide uses SpiceTools, you should consult appropriate documentation and requirements of your desired tools as the setup process is likely to be extremely similar.
### Getting Started.
!!! tip ""
Before we even touch the game, let's fiddle with our audio settings to minimize any potential audio issues 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 `44100 Hz` and check both of the options inside `Exclusive Mode` as pictured.
<img src="/img/gen/441.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, the first thing to do is put your desired 64-bit tools inside the game's `contents` folder, and to create a `.bat` file. Pictured below is what your folder should look like, feel free to name your `.bat` file whatever you desire, for the sake of convenience we've named ours `gamestart.bat`.
<img src="/img/exchain/1.png">
!!! tip ""
Why does this look different than the usual? This installation includes a `modules` folder that Spice automatically detects, keeping things clean and simple.
### Configuring Your Tools
!!! tip ""
Now that you have your files ready, open up your `.bat` file in your desired text editor (we're using [Notepad++](https://notepad-plus-plus.org/)) and edit it with your desired parameters, for the purpose of this guide we will demonstrate both a local network configuration and an online example below for both launching the guitar version and drum version using SpiceTools, skip to whichever you're in need of accordingly and please keep in mind you can add whatever additional parameters you desire.
!!! warning "If you're not using SpiceTools:"
The overall structure of your .bat file will differ from the guide, namely the initialization of SpiceTools won't be present and potential parameters may differ. As stated above, make sure to check the documentation of your tools to ensure you're using the correct parameters for your needs.
### Configuring for a Local Network
!!! tip ""
**FOR GUITAR**
For our guitar local network configuration example, on a single line in the `.bat` file we're going to type `spice64.exe -e prop\eamuse-config2.xml -2ch -ea -w` and save the file.
What do these different parameters do?
- `-e` sets a custom path for the eamuse config to boot the proper one (in this case, guitar via `prop\eamuse-config2.xml`)
- `-2ch` enables 2-channel audio for GITADORA
- `-ea` enables an integrated e-amusement server within SpiceTools.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/matixx/2g.png">
!!! tip ""
**FOR DRUM**
For our drum local network configuration example, on a single line in the `.bat` file we're going to type `spice64.exe -2ch -ea -w` and save the file.
What do these different parameters do?
- `-2ch` enables 2-channel audio for GITADORA
- `-ea` enables an integrated e-amusement server within SpiceTools.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/matixx/2d.png">
### Configuring for an Online Network
!!! tip ""
**FOR GUITAR**
For our guitar online network example we're simply doing the above but with different parameters! On our single line, we're going to type `spice64.exe -e prop\eamuse-config2.xml -2ch -p XXXXXXXXXXXXXXXXXXXX -url http://yoururlhere.com/ -w` and save the file.
What do these different parameters do?
- `-e` sets a custom path for the eamuse config to boot the proper one (in this case, guitar via `prop\eamuse-config2.xml`)
- `-2ch` enables 2-channel audio for GITADORA
- `-p` takes your PCBID on your network of choice, simply replace `XXXXXXXXXXXXXXXXXXXX` with your PCBID.
- `-url` allows you to specify a custom service URL to connect with, simply replace `http://yoururlhere.com/` with your chosen network's URL.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/matixx/3g.png">
!!! tip ""
**FOR DRUM**
For our drum online network example we're simply doing the above but with different parameters! On our single line, we're going to type `spice64.exe -2ch -p XXXXXXXXXXXXXXXXXXXX -url http://yoururlhere.com/ -w` and save the file.
What do these different parameters do?
- `-2ch` enables 2-channel audio for GITADORA
- `-p` takes your PCBID on your network of choice, simply replace `XXXXXXXXXXXXXXXXXXXX` with your PCBID.
- `-url` allows you to specify a custom service URL to connect with, simply replace `http://yoururlhere.com/` with your chosen network's URL.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/matixx/3d.png">
!!! tip ""
One final note, since you're playing on a network, you will have one additional step of setting up your card file within your chosen tools, make sure to check your server's information on how to setup a card file.
### Final Steps and Setting up the Game
!!! tip ""
The last steps you'll have to do with your chosen tools is simply setting up your desired keybinds! Make sure you setup the `Test` keybind as it will be critical for setting up the game. Once you've done that, launch your game for the first time by double clicking the `.bat` you setup and the game should load.
If it's your first time running the game, you'll immediately be greeted with this screen, oh no!
<img src="/img/matixx/4.png">
!!! tip ""
This is normal, simply hit your `Test` keybind and continue on to this.
<img src="/img/matixx/5.png">
!!! tip ""
From here, we will need to set a shop name to play, so select the `GAME OPTIONS` option.
<img src="/img/matixx/6.png">
!!! tip ""
Then, select `SHOP SETTINGS`.
<img src="/img/matixx/7.png">
!!! tip ""
Once inside, select `SHOP NAME SETTINGS` and name your shop whatever you desire! For the purpose of the guide, we named it `Guide` but highly encourage fun and/or lazy names. Once that's done, go down to `PREFECTURE` and set it to whatever you desire as well. Finally, go to `SAVE AND EXIT` to get back to the main menu.
<img src="/img/matixx/8.png">
!!! tip ""
The last menu we'll go inside from the service menu is the clock menu. Go inside `CLOCK` and simply set the clock by hitting `SAVE AND EXIT` as pictured below.
<img src="/img/matixx/9.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.

30
docs/games/gitamatixx/hexedits.md Normal file
View File

@ -0,0 +1,30 @@
# GITADORA Matixx Hex Edits
!!! warning "Unsure how to apply hex edits?"
Check out the [Beginner's Guide to Hex Editing](http://www.bemani.guide/extras/hexguide/) for assistance.
###List of Known Edits For M32-2018071700
!!! tip ""
Timer Freeze
- game.dll: `0xBC37: 0F 85 AA 01 00 00 -> E9 AB 01 00 00 90`
Stage Freeze (NOT compatible with usage on networks due to how the game saves user plays)
- game.dll: `0x1595E1 0F 85 FB 01 00 00 -> E9 FC 01 00 00 90`
Unlock all music
- game.dll: `0x1EAEFA: 71 00 -> 4D 01`
- game.dll: `0x1EAF12: 73 00 -> 4D 01`
- game.dll: `0x162FF4: 75 16 -> EB 23`
Enable Long music
- game.dll: `0x163134: 75 03 -> 90 90`
Fix IP change error
- libshare-pj.dll: `0x23375: 74 -> EB`

69
docs/games/gitamatixx/problems.md Normal file
View File

@ -0,0 +1,69 @@
# GITADORA Matixx Common Problems/Tips
### Hardware Specs
!!! tip ""
Bemani PC Type 4
CPU: AMD Athlon 64 X2 4400
GPU: ATI Radeon HD 2400
RAM: 1 GB
OS: Windows 7 Embedded
### My Game Is Running Slow/Lagging
!!! tip ""
Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.
### My Game Is Running Crazy Fast!
!!! tip ""
The most common reason for this is the game is running over its required 60hz, the game is hardcoded to run at 60hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60hz. You can always check on the game's monitor check if the game is fluctuating around 59.94hz, the NTSC standard. If it's not around there and your monitor is indeed set to 60hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.
### Game Stuck On Title Screen (AMD Ryzen 3900X)
!!! tip ""
If you have AMD Ryzen 3900X-series processor and the game gets stuck on the title screen (or a black screen) you are running into a known processor bug for games using Media Foundation to play videos. The workaround is to disable simultaneous multithreading (SMT) in the system's BIOS settings. See [this GitHub issue for Proton](https://github.com/ValveSoftware/Proton/issues/838#issuecomment-557081962)
### Occasional Graphical Stuttering During Gameplay
!!! tip ""
Disable fullscreen optimizations for spice64.exe instance. Right click on spice64.exe, click on Properties. Click on Compatibility tab, "Change settings for all users", and check "Disable fullscreen optimizations".
### I get an IP Change Error!
!!! tip ""
Apply the [Fix IP Change Error Hex Edit](/games/gitamatixx/hexedits/)
### 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 (-). Gitadora features BOTH a visual offset and an audio based one, so experiment accordingly.
### Why Are My Videos Freezing (Usually Towards the End of the Song)?
!!! tip ""
If you're using Windows 10, there is a bug that is caused by the difference between the ASF stream decoder between Windows 7 and Windows 10 wherein it fails to properly detect the end of file of the video stream which causes the video decoder to throw an exception, which is why the video freezes. At the time of writing, SpiceTools does not have a fix for this, but there are hooks available to resolve this issue.
### I Tried Switching to SpiceTools to Follow the Guide and It Crashes!
!!! tip ""
This is a known issue, make sure to replace all of the `.dll` files from the ``contents`` folder of the game with ones from a fresh install, other tools currently modify these files in a way that SpiceTools cannot deal with.
### My Drum Pedal Isn't Working!
!!! tip ""
Some drum kits utilize hi-hat control with the pedal resulting in different MIDI addresses that require additional bindings, make sure to follow your drum kit's manual to see these other bindings and bind them in your desired tool's accordingly. Gitadora does not do this, so the game utilizes just 1 binding for every level of sensitivity on the pedal and multiple bindings are typically required with most drum kits.
### When I Run This Game All Other Background Audio Is Gone! What's Going On?
!!! tip ""
Gitadora is a 64-bit game that utilizes 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 BEMANI games which used [DirectSound](https://en.wikipedia.org/wiki/DirectSound). Unfortunately, this cannot be changed.
### Note on 2-channel and 4-channel Audio
!!! tip ""
For most setups, the `-2ch` parameter will be mandatory to hear any functional audio. 4-channel setups aren't really working in general and there's buffer issues, please avoid using it.

139
docs/games/gitamatixx/setup.md Normal file
View File

@ -0,0 +1,139 @@
# GITADORA Matixx
!!! 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.
Lastly, for demonstrative purposes, this guide uses SpiceTools, you should consult appropriate documentation and requirements of your desired tools as the setup process is likely to be extremely similar.
### Getting Started.
!!! tip ""
Before we even touch the game, let's fiddle with our audio settings to minimize any potential audio issues 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 `44100 Hz` and check both of the options inside `Exclusive Mode` as pictured.
<img src="/img/gen/441.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, the first thing to do is put your desired 64-bit tools inside the game's `contents` folder, and to create a `.bat` file. Pictured below is what your folder should look like, feel free to name your `.bat` file whatever you desire, for the sake of convenience we've named ours `gamestart.bat`.
<img src="/img/matixx/1.png">
### Configuring Your Tools
!!! tip ""
Now that you have your files ready, open up your `.bat` file in your desired text editor (we're using [Notepad++](https://notepad-plus-plus.org/)) and edit it with your desired parameters, for the purpose of this guide we will demonstrate both a local network configuration and an online example below for both launching the guitar version and drum version using SpiceTools, skip to whichever you're in need of accordingly and please keep in mind you can add whatever additional parameters you desire.
!!! warning "If you're not using SpiceTools:"
The overall structure of your .bat file will differ from the guide, namely the initialization of SpiceTools won't be present and potential parameters may differ. As stated above, make sure to check the documentation of your tools to ensure you're using the correct parameters for your needs.
### Configuring for a Local Network
!!! tip ""
**FOR GUITAR**
For our guitar local network configuration example, on a single line in the `.bat` file we're going to type `spice64.exe -e prop\eamuse-config2.xml -2ch -ea -w` and save the file.
What do these different parameters do?
- `-e` sets a custom path for the eamuse config to boot the proper one (in this case, guitar via `prop\eamuse-config2.xml`)
- `-2ch` enables 2-channel audio for GITADORA
- `-ea` enables an integrated e-amusement server within SpiceTools.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/matixx/2g.png">
!!! tip ""
**FOR DRUM**
For our drum local network configuration example, on a single line in the `.bat` file we're going to type `spice64.exe -2ch -ea -w` and save the file.
What do these different parameters do?
- `-2ch` enables 2-channel audio for GITADORA
- `-ea` enables an integrated e-amusement server within SpiceTools.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/matixx/2d.png">
### Configuring for an Online Network
!!! tip ""
**FOR GUITAR**
For our guitar online network example we're simply doing the above but with different parameters! On our single line, we're going to type `spice64.exe -e prop\eamuse-config2.xml -2ch -p XXXXXXXXXXXXXXXXXXXX -url http://yoururlhere.com/ -w` and save the file.
What do these different parameters do?
- `-e` sets a custom path for the eamuse config to boot the proper one (in this case, guitar via `prop\eamuse-config2.xml`)
- `-2ch` enables 2-channel audio for GITADORA
- `-p` takes your PCBID on your network of choice, simply replace `XXXXXXXXXXXXXXXXXXXX` with your PCBID.
- `-url` allows you to specify a custom service URL to connect with, simply replace `http://yoururlhere.com/` with your chosen network's URL.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/matixx/3g.png">
!!! tip ""
**FOR DRUM**
For our drum online network example we're simply doing the above but with different parameters! On our single line, we're going to type `spice64.exe -2ch -p XXXXXXXXXXXXXXXXXXXX -url http://yoururlhere.com/ -w` and save the file.
What do these different parameters do?
- `-2ch` enables 2-channel audio for GITADORA
- `-p` takes your PCBID on your network of choice, simply replace `XXXXXXXXXXXXXXXXXXXX` with your PCBID.
- `-url` allows you to specify a custom service URL to connect with, simply replace `http://yoururlhere.com/` with your chosen network's URL.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/matixx/3d.png">
!!! tip ""
One final note, since you're playing on a network, you will have one additional step of setting up your card file within your chosen tools, make sure to check your server's information on how to setup a card file.
### Final Steps and Setting up the Game
!!! tip ""
The last steps you'll have to do with your chosen tools is simply setting up your desired keybinds! Make sure you setup the `Test` keybind as it will be critical for setting up the game. Once you've done that, launch your game for the first time by double clicking the `.bat` you setup and the game should load.
If it's your first time running the game, you'll immediately be greeted with this screen, oh no!
<img src="/img/matixx/4.png">
!!! tip ""
This is normal, simply hit your `Test` keybind and continue on to this.
<img src="/img/matixx/5.png">
!!! tip ""
From here, we will need to set a shop name to play, so select the `GAME OPTIONS` option.
<img src="/img/matixx/6.png">
!!! tip ""
Then, select `SHOP SETTINGS`.
<img src="/img/matixx/7.png">
!!! tip ""
Once inside, select `SHOP NAME SETTINGS` and name your shop whatever you desire! For the purpose of the guide, we named it `Guide` but highly encourage fun and/or lazy names. Once that's done, go down to `PREFECTURE` and set it to whatever you desire as well. Finally, go to `SAVE AND EXIT` to get back to the main menu.
<img src="/img/matixx/8.png">
!!! tip ""
The last menu we'll go inside from the service menu is the clock menu. Go inside `CLOCK` and simply set the clock by hitting `SAVE AND EXIT` as pictured below.
<img src="/img/matixx/9.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.

21
docs/games/hellopopn/problems.md Normal file
View File

@ -0,0 +1,21 @@
HELLO Pop'n Common Problems/Tips
### My Game Is Running Slow/Lagging
!!! tip ""
Try to eliminate any unnecessary background processes during play.
### My Game Is Running Crazy Fast/After Finishing a Song Loading Is Stuck
!!! tip ""
The most common reason for this is the game is running over its required 60hz, the game is hardcoded to run at 60hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60hz. You can always check on the game's monitor check if the game is fluctuating around 59.94hz, the NTSC standard. If it's not around there and your monitor is indeed set to 60hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.
### The game crashes fullscreen!
!!! tip ""
Some monitors and display adapters may not support the odd resolution the game runs at, which is 1360x768 versus the occasionally seen 1366x768. To resolve, setup a custom resolution inside your appropriate graphics card settings, or enable GPU resolution scaling.
### Other Crashes
!!! tip ""
This game may fail in the case of using HDMI audio. Even if you're not using HDMI audio however, some failures to boot have been noted. Please update to the latest SpiceTools which fixes this issue.

94
docs/games/hellopopn/setup.md Normal file
View File

@ -0,0 +1,94 @@
# HELLO Pop'n
!!! 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.
Lastly, for demonstrative purposes, this guide uses SpiceTools, you should consult appropriate documentation and requirements of your desired tools as the setup process is likely to be extremely similar.
### Getting Started
!!! tip ""
This game still uses DirectSound so we can skip audio related setup needed for other games. 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 desired 32-bit tools inside the game's `contents` folder. Pictured below is what your folder should look like.
<img src="/img/popn/hello1.png">
### Configuring Your Tools
!!! tip ""
Now that you have your files ready, open up `spicecfg.exe` and head to the `Options` tab. Here you can configure all of the various options that SpiceTools has, but for the purpose of this guide we'll demonstrate how to set up a local server and an online server. You can skip over the parts that you don't need, and feel free to set any other options that you might like.
!!! warning "If you're not using SpiceTools:"
It's most likely that your toolkit doesn't have an options interface, so you'll have to create a `.bat` file. Consult the appropriate documentation for this as this isn't covered in this guide.
### Configuring for a Local Network
!!! tip ""
For our local network configuration example, in the `Options` tab enable the following options: `E-Amusement Emulation: -ea` and `Windowed Mode: -w`.
What do these different parameters do?
- `-ea` enables an integrated e-amusement server within SpiceTools.
- `-w` will boot the game in windowed mode which will ease our initial setup and testing later, make sure to disable `-w` to run the game fullscreen once you're done setting up!
Pictured below, the selected options in `spicecfg.exe`.
<img src="/img/popn/hello2.png">
### Configuring for an Online Network
!!! tip ""
For our online network example we're simply doing the above but with different options!
We're going to use the option `PCBID: -pcbid` for our PCBID, with `XXXXXXXXXXXXXXXXXXXX` as the value.
For the network URL we're going to use the option `Service URL: -url`, with `http://yoururlhere.com/` as the value.
We'll also enable windowed mode by enabling the option `Windowed Mode: -w`.
What do these different parameters do?
- `-p` takes your PCBID on your network of choice, simply replace `XXXXXXXXXXXXXXXXXXXX` with your PCBID.
- `-url` allows you to specify a custom service URL to connect with, simply replace `http://yoururlhere.com/` with your chosen network's URL.
- `-w` will boot the game in windowed mode which will ease our initial setup and testing later, make sure to disable `-w` to run the game fullscreen once you're done setting up!
Pictured below, the enabled options in `spicecfg.exe`.
<img src="/img/popn/hello3.png">
!!! tip ""
One final note, since you're playing on a network, you will have one additional step of setting up your card file within your chosen tools, make sure to check your server's information on how to setup a card file.
### Configuring Keybinds
!!! tip ""
While we're still in `spicecfg.exe`, why not set up the keybinds? To do this you'll have to head on over to the `Buttons` tab. Here you simply click `Bind` and press the button on your controller (or keyboard). Below are my keybinds for a keyboard. Notice that I've also bound the `Service`, `Test` and `Coin Mech` buttons to my keyboard. This might come in handy but shouldn't be necessary to play the game.
<img src="/img/popn/hello4.png">
### Final Steps and Setting up the Game
!!! tip ""
Boot the game by double-clicking `spice.exe`.
The boot sequence may have a very light blue background. Press any overlay hotkey (F12, for example) to make it display normally.
<img src="/img/popn/helloboot1.png">
<img src="/img/popn/helloboot2.png">
!!! tip ""
Simply follow the on-screen text in the bottom left corner to continue. On the first boot, the game may tell you to press `Test`, and then `Service`.
HELLO Pop'n has the ability to run offline, so the network error can be safely ignored.
You're all done! The game takes a couple of seconds to load all of the data.
!!! 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.

108
docs/games/iidx25/hexedits.md Normal file
View File

@ -0,0 +1,108 @@
# beatmania IIDX 25 Hex Edits
!!! warning "Unsure how to apply hex edits?"
Check out the [Beginner's Guide to Hex Editing](http://www.bemani.guide/extras/hexguide/) for assistance.
### List of Known Edits For LDJ-2019100700
!!! tip ""
All below edits are for `bm2dx.dll` unless otherwise specified.
SSE4.2 Fix (Allows the game to run on processors which do not support the SSE4.2 instruction set. If you can successfully boot the game already, DO NOT USE THIS EDIT!)
- 0x3F8CF7: `F3 45 0F → 90 90 90`
Unlock All Songs
- 0x16D7B2: `74 10 → 90 90`
Unlock All 12s
- 0x16D660: `83 FF 02 74 05 83 FF 05 → 90 90 90 90 90 90 90 90`
Skip CAMERA DEVICE ERROR prompt
- 0x36F3FB: `84 → 81`
1P Premium Free
- 0x32F5C7: `75 → EB`
2P Premium Free
- 0x32F765: `74 55 → 90 90`
- 0x32F77B: `74 3F → 90 90`
Premium Free Timer Freeze
- 0x16FCAD: `FF C8 → 90 90`
Standard/Menu Timer Freeze
- 0x387F37: `74 → EB`
Cursor lock
- 0x334914: `74 1D → 90 90`
CS-Style Song Start Delay
- 0x3539EA: `7D 25 → 90 90`
Play video preview on all songs (Normally only some beginner songs do this)
- 0x11CA4C: `0F B6 → EB 2F`
- 0x11FDFE: `74 0E → 90 90`
Hide INSERT COIN[S] text
- 0x107279: `3B → 3A`
Hide CREDIT %d text
- 0x106DF8: `0C → 0B`
Hide CREDIT %d COIN %d / %d text
- 0x106DCD: `17 → 16`
Hide EXTRA PASELI: %d text
- 0x106EE9: `43 → 42`
Hide PASELI: %d text
- 0x1070B8: `A4 → A3`
Hide PASELI: NO ACCOUNT text
- 0x10717B: `21 → 20`
Hide PASELI: ****** text
- 0x1070DD: `9F → 9E`
Free play text to LED ticker (Bottom Right)
- 0x106F9F: `35 2F 35 00 → D9 68 44 02`
LED Ticker (Top Left)
- 0x36D780: `FC B9 1C 00 → 98 01 3A 02`
- 0x36D958 `74 3C → 90 90`
Quick Retry (Guest and non-VIP card players can hold VEFX and Effect during a song to quickly restart)
- 0x1583BF: `32 C0 → B0 01`
Expert Course Force Open (In offline or local mode)
- 0x32F711: `75 → EB`
Shorter monitor check (Runs for 2 seconds instead of 20, only use if your framerate is extremely stable or you will have issues)
- 0x366E6C: `B0 04 → 78 00`

67
docs/games/iidx25/problems.md Normal file
View File

@ -0,0 +1,67 @@
# IIDX 25 Common Problems/Tips
### Hardware Specs
!!! tip ""
Bemani PC (ADE-6291)
Konami (2018)
Based on an AMD Embedded R Series SoC.
CPU: AMD RX-421BD
GPU: Radeon R7
RAM: 4 GB
OS: Windows 7 Embedded
### My Game Is Running Slow/Lagging
!!! tip ""
Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.
### My Game Is Running Crazy Fast!
!!! tip ""
The most common reason for this is the game is running over its required 60hz, the game is hardcoded to run at 60hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60hz. You can always check on the game's monitor check if the game is fluctuating around 59.94hz, the NTSC standard. If it's not around there and your monitor is indeed set to 60hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.
### Camera Device Error Message
!!! tip ""
The game released with two USB cameras and naturally it's looking for them, if you do not have two cameras plugged into your computer then the game outputs this error, which can be ignored simply by hitting `Test` or waiting 60 seconds for it to be auto-dismissed.
But if you're tired of this message every time you start up the game, the `CAMERA DEVICE ERROR` message can be removed via a hex edit, check out the [Hex Edits](hexedits.md) section for an easy drag and drop solution.
### 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.
### HD and HD*
!!! tip ""
This version of IIDX has two HD mode options, `HD` and `HD*` neither is inherently better than the other, the only difference is HD* is an additional + 1.0 offset in-game, the official reasoning is to account for a different set of monitors on arcade cabs. In beatmania IIDX 26 ROOTAGE this option is removed entirely and only HD is present.
### 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 (-).
### A Note About SSE 4.2
!!! tip ""
In the rare case you are running this game on *very* old hardware, IIDX 25 requires a processor supporting the [SSE 4.2 instruction set](https://en.wikipedia.org/wiki/SSE4#SSE4.2). But, in the event your processor does not have this, there is a [hex edit](hexedits.md) available to bypass this.
### 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). Unfortunately, this cannot be changed.
### 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.

120
docs/games/iidx25/setup.md Normal file
View File

@ -0,0 +1,120 @@
# beatmania IIDX 25 CANNON BALLERS
!!! 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.
Lastly, for demonstrative purposes, this guide uses SpiceTools, you should consult appropriate documentation and requirements of your desired tools as the setup process is likely to be extremely similar.
### 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 `44100 Hz` and check both of the options inside `Exclusive Mode` as pictured.
<img src="/img/gen/441.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 desired 64-bit tools inside the game's `contents` folder, and to create a `.bat` file. Pictured below is what your folder should look like, feel free to name your `.bat` file whatever you desire, for the sake of convenience we've named ours `gamestart.bat`.
<img src="/img/iidx25/1.png">
### Configuring Your Tools
!!! tip ""
Now that you have your files ready, open up your `.bat` file in your desired text editor (we're using [Notepad++](https://notepad-plus-plus.org/)) and edit it with your desired parameters, for the purpose of this guide we will demonstrate both a local network configuration and an online example below with SpiceTools, skip to whichever you're in need of accordingly and please keep in mind you can add whatever additional parameters you desire.
!!! warning "If you're not using SpiceTools:"
The overall structure of your .bat file will differ from the guide, namely the initialization of SpiceTools won't be present and potential parameters may differ. As stated above, make sure to check the documentation of your tools to ensure you're using the correct parameters for your needs.
### Configuring for a Local Network
!!! tip ""
For our local network configuration example, on a single line in the `.bat` file we're going to type `spice64.exe -ea -w` and save the file.
What do these different parameters do?
- `-ea` enables an integrated e-amusement server within SpiceTools.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/iidx25/2.png">
### Configuring for an Online Network
!!! tip ""
For our online network example we're simply doing the above but with different parameters! On our single line, we're going to type `spice64.exe -p XXXXXXXXXXXXXXXXXXXX -url http://yoururlhere.com/ -w` and save the file.
What do these different parameters do?
- `-p` takes your PCBID on your network of choice, simply replace `XXXXXXXXXXXXXXXXXXXX` with your PCBID.
- `-url` allows you to specify a custom service URL to connect with, simply replace `http://yoururlhere.com/` with your chosen network's URL.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/iidx25/3.png">
!!! tip ""
One final note, since you're playing on a network, you will have one additional step of setting up your card file within your chosen tools, make sure to check your server's information on how to setup a card file.
### Final Steps and Setting up the Game
!!! tip ""
The last steps you'll have to do with your chosen tools is simply setting up your desired keybinds! Make sure you setup the `Test` keybind as it will be critical for setting up the game. Once you've done that, launch your game for the first time by double clicking the `.bat` you setup and the game should load.
If it's your first time running the game, you'll immediately be greeted with this screen, oh no!
<img src="/img/iidx25/4.png">
!!! tip ""
Ignore this message, simply hit your `Test` keybind and continue onto this.
<img src="/img/iidx25/5.png">
!!! tip ""
Hit the `Test` keybinding again to initialize the backup data, a message will pop up stating it's been initialized.
<img src="/img/iidx25/6.png">
!!! tip ""
Lastly, you'll run into this error message as well, let's work on eliminating these messages. 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/iidx25/7.png">
!!! tip ""
Start by navigating up to `CLOCK` and entering that menu.
<img src="/img/iidx25/8.png">
!!! tip ""
Simply hit save and exit and leave, the clock will be saved. Then, back in the service menu, go up to `GAME OPTIONS`
<img src="/img/iidx25/9.png">
!!! tip ""
Once inside that menu, navigate your way up to `DEFINITION TYPE` and choose either `HD` or `HD*` depending on your preferences, both run the game at 720p but have a timing difference addressed on the FAQ page. It might be worth noting that the `HD*` option is no longer present as of beatmania IIDX 26 ROOTAGE.
<img src="/img/iidx25/10.png">
!!! tip ""
The game will then count down asking you to confirm the selection before reverting, just hit `YES` assuming it loaded just fine on your computer. Then, exit out of that menu and head to `NETWORK OPTIONS` from back inside the service menu.
<img src="/img/iidx25/11.png">
!!! tip ""
From here, we will need to set a shop name to play, so select the `SHOP NAME SETTING` option. Once inside, name your shop whatever you desire! For the purpose of the guide, we named it `Guide` but highly encourage fun and/or lazy names. 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.

107
docs/games/iidx26/hexedits.md Normal file
View File

@ -0,0 +1,107 @@
# beatmania IIDX 26 Hex Edits
!!! warning "Unsure how to apply hex edits?"
Check out the [Beginner's Guide to Hex Editing](http://www.bemani.guide/extras/hexguide/) for assistance.
### List of Known Edits For LDJ-2019100700
!!! tip ""
All below edits are for `bm2dx.dll` unless otherwise specified.
SSE4.2 Fix (Allows the game to run on processors which do not support the SSE4.2 instruction set. If you can successfully boot the game already, DO NOT USE THIS EDIT!)
- 0x3F8CF7: `F3 45 0F → 90 90 90`
Unlock All Songs
- 0x16D7B2: `74 10 → 90 90`
Unlock All 12s
- 0x16D660: `83 FF 02 74 05 83 FF 05 → 90 90 90 90 90 90 90 90`
Skip CAMERA DEVICE ERROR prompt
- 0x36F3FB: `84 → 81`
1P Premium Free
- 0x32F5C7: `75 → EB`
2P Premium Free
- 0x32F765: `74 55 → 90 90`
- 0x32F77B: `74 3F → 90 90`
Premium Free Timer Freeze
- 0x16FCAD: `FF C8 → 90 90`
Standard/Menu Timer Freeze
- 0x387F37: `74 → EB`
Cursor lock
- 0x334914: `74 1D → 90 90`
CS-Style Song Start Delay
- 0x3539EA: `7D 25 → 90 90`
Play video preview on all songs (Normally only some beginner songs do this)
- 0x11CA4C: `0F B6 → EB 2F`
- 0x11FDFE: `74 0E → 90 90`
Hide INSERT COIN[S] text
- 0x107279: `3B → 3A`
Hide CREDIT %d text
- 0x106DF8: `0C → 0B`
Hide CREDIT %d COIN %d / %d text
- 0x106DCD: `17 → 16`
Hide EXTRA PASELI: %d text
- 0x106EE9: `43 → 42`
Hide PASELI: %d text
- 0x1070B8: `A4 → A3`
Hide PASELI: NO ACCOUNT text
- 0x10717B: `21 → 20`
Hide PASELI: ****** text
- 0x1070DD: `9F → 9E`
Free play text to LED ticker (Bottom Right)
- 0x106F9F: `35 2F 35 00 → D9 68 44 02`
LED Ticker (Top Left)
- 0x36D780: `FC B9 1C 00 → 98 01 3A 02`
- 0x36D958 `74 3C → 90 90`
Quick Retry (Guest and non-VIP card players can hold VEFX and Effect during a song to quickly restart)
- 0x1583BF: `32 C0 → B0 01`
Expert Course Force Open (In offline or local mode)
- 0x32F711: `75 → EB`
Shorter monitor check (Runs for 2 seconds instead of 20, only use if your framerate is extremely stable or you will have issues)
- 0x366E6C: `B0 04 → 78 00`

67
docs/games/iidx26/problems.md Normal file
View File

@ -0,0 +1,67 @@
# IIDX 26 Common Problems/Tips
### Hardware Specs
!!! tip ""
Bemani PC (ADE-6291)
Konami (2018)
Based on an AMD Embedded R Series SoC.
CPU: AMD RX-421BD
GPU: Radeon R7
RAM: 4 GB
OS: Windows 7 Embedded
### My Game Is Running Slow/Lagging
!!! tip ""
Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.
### My Game Is Running Crazy Fast!
!!! tip ""
The most common reason for this is the game is running over its required 60hz, the game is hardcoded to run at 60hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60hz. You can always check on the game's monitor check if the game is fluctuating around 59.94hz, the NTSC standard. If it's not around there and your monitor is indeed set to 60hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.
### Camera Device Error Message
!!! tip ""
The game released with two USB cameras and naturally it's looking for them, if you do not have two cameras plugged into your computer then the game outputs this error, which can be ignored simply by hitting `Test` or waiting 60 seconds for it to be auto-dismissed.
But if you're tired of this message every time you start up the game, the `CAMERA DEVICE ERROR` message can be removed via a hex edit, check out the [Hex Edits](hexedits.md) section for an easy drag and drop solution.
### 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.
### HD and HD*
!!! tip ""
This version of IIDX has removed having two HD mode options, leaving only HD. `HD` and `HD*` neither is inherently better than the other, the only difference is HD* is an additional + 1.0 offset in-game, now applied to the lone `HD` mode. The official reasoning is to account for a different set of monitors on arcade cabs.
### 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 (-).
### A Note About SSE 4.2
!!! tip ""
In the rare case you are running this game on *very* old hardware, IIDX 26 requires a processor supporting the [SSE 4.2 instruction set](https://en.wikipedia.org/wiki/SSE4#SSE4.2). But, in the event your processor does not have this, there is a [hex edit](hexedits.md) available to bypass this.
### 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). Unfortunately, this cannot be changed.
### 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.

120
docs/games/iidx26/setup.md Normal file
View File

@ -0,0 +1,120 @@
# beatmania IIDX 26 Rootage
!!! 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.
Lastly, for demonstrative purposes, this guide uses SpiceTools, you should consult appropriate documentation and requirements of your desired tools as the setup process is likely to be extremely similar.
### 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 `44100 Hz` and check both of the options inside `Exclusive Mode` as pictured.
<img src="/img/gen/441.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 desired 64-bit tools inside the game's `contents` folder, and to create a `.bat` file. Pictured below is what your folder should look like, feel free to name your `.bat` file whatever you desire, for the sake of convenience we've named ours `gamestart.bat`.
<img src="/img/iidx25/1.png">
### Configuring Your Tools
!!! tip ""
Now that you have your files ready, open up your `.bat` file in your desired text editor (we're using [Notepad++](https://notepad-plus-plus.org/)) and edit it with your desired parameters, for the purpose of this guide we will demonstrate both a local network configuration and an online example below with SpiceTools, skip to whichever you're in need of accordingly and please keep in mind you can add whatever additional parameters you desire.
!!! warning "If you're not using SpiceTools:"
The overall structure of your .bat file will differ from the guide, namely the initialization of SpiceTools won't be present and potential parameters may differ. As stated above, make sure to check the documentation of your tools to ensure you're using the correct parameters for your needs.
### Configuring for a Local Network
!!! tip ""
For our local network configuration example, on a single line in the `.bat` file we're going to type `spice64.exe -ea -w` and save the file.
What do these different parameters do?
- `-ea` enables an integrated e-amusement server within SpiceTools.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/iidx25/2.png">
### Configuring for an Online Network
!!! tip ""
For our online network example we're simply doing the above but with different parameters! On our single line, we're going to type `spice64.exe -p XXXXXXXXXXXXXXXXXXXX -url http://yoururlhere.com/ -w` and save the file.
What do these different parameters do?
- `-p` takes your PCBID on your network of choice, simply replace `XXXXXXXXXXXXXXXXXXXX` with your PCBID.
- `-url` allows you to specify a custom service URL to connect with, simply replace `http://yoururlhere.com/` with your chosen network's URL.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/iidx25/3.png">
!!! tip ""
One final note, since you're playing on a network, you will have one additional step of setting up your card file within your chosen tools, make sure to check your server's information on how to setup a card file.
### Final Steps and Setting up the Game
!!! tip ""
The last steps you'll have to do with your chosen tools is simply setting up your desired keybinds! Make sure you setup the `Test` keybind as it will be critical for setting up the game. Once you've done that, launch your game for the first time by double clicking the `.bat` you setup and the game should load.
If it's your first time running the game, you'll immediately be greeted with this screen, oh no!
<img src="/img/iidx25/4.png">
!!! tip ""
Ignore this message, simply hit your `Test` keybind and continue onto this.
<img src="/img/iidx25/5.png">
!!! tip ""
Hit the `Test` keybinding again to initialize the backup data, a message will pop up stating it's been initialized.
<img src="/img/iidx25/6.png">
!!! tip ""
Lastly, you'll run into this error message as well, let's work on eliminating these messages. 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/iidx25/7.png">
!!! tip ""
Start by navigating up to `CLOCK` and entering that menu.
<img src="/img/iidx25/8.png">
!!! tip ""
Simply hit save and exit and leave, the clock will be saved. Then, back in the service menu, go up to `GAME OPTIONS`
<img src="/img/iidx25/9.png">
!!! tip ""
Once inside that menu, navigate your way up to `DEFINITION TYPE` and choose either `SD` or `HD` depending on your preferences.
<img src="/img/iidx26/1.png">
!!! tip ""
The game will then count down asking you to confirm the selection before reverting, just hit `YES` assuming it loaded just fine on your computer. Then, exit out of that menu and head to `NETWORK OPTIONS` from back inside the service menu.
<img src="/img/iidx25/11.png">
!!! tip ""
From here, we will need to set a shop name to play, so select the `SHOP NAME SETTING` option. Once inside, name your shop whatever you desire! For the purpose of the guide, we named it `Guide` but highly encourage fun and/or lazy names. 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.

11
docs/games/iidx27/hexedits.md Normal file
View File

@ -0,0 +1,11 @@
# beatmania IIDX 27 Hex Edits
!!! warning "Unsure how to apply hex edits?"
Check out the [Beginner's Guide to Hex Editing](http://www.bemani.guide/extras/hexguide/) for assistance.
### List of Known Edits For LDJ-2020092900
!!! tip ""
Hello I know I left this page up thank you.

69
docs/games/iidx27/lightning.md Normal file
View File

@ -0,0 +1,69 @@
# beatmania IIDX 27 Lighting Mode Information
### Notes
!!! tip ""
Booting the game in Lightning Mode requires a few things. To start off with, you will need to enable the `-iidxtdj` option in SpiceTools and you will also need to enable the `Enable Lightning Mode` hex edit inside of SpiceTools and SpiceCompanion's patches tab.
In doing so, and subsequently every time you choose to switch between the two modes, you will want to delete everything inside your `dev/nvram` folder, and redo the setup process again with initializing the backup date, setting the clock, shop name, and the definition type.
SpiceTools as of 10/26/2020 has some updated features to work with this as well. Namely, the ability to toggle the Lightning Model subscreen via the `Toggle Subscreen` option in the Buttons tab. You can use your mouse to navigate the touchscreen as desired. Enter your pin, toggle buttons, etc.
SpiceCompanion has also as of 10/26/2020 added a brand new Screen feature as well. Using SpiceCompanion, you can receive the subscreen on your phone/tablet/etc and then use your device as a touch device for the subscreen. Do note that at this time it will not work while the game is running in windowed mode. If you run into performance issues, go to the settings tab to adjust things like the Screen Quality, Screen Threads, and Screen Divide, this feature is heavily dependent on connection and you will notice as you bump up the quality that the ping will increase as well. It may take some fiddling to find the most ideal settings for your setup.
### Lightning-specific Troubleshooting
!!! tip ""
Below are the two main issues that have arisen for users utilizing this guide and general startup practices.
### Hardware Specs
!!! tip ""
Bemani PC Type 11 (ARESPEAR C300)
Konami (2019)
Based on KONAMI ARESPEAR C300 gaming PC.
CPU: Intel i5-9400F 2.9Ghz
GPU: GIGABYTE GeForce GTX 1650 1530Mhz 4GB
RAM: 8 GB DDR4
STORAGE: Innodisk 2.5" 3ME3 SATA SSD 256GB
AUDIO: ASUS Xonar AE
OS: Windows 10 IoT Enterprise
### Enabling Lighting Mode Patch
!!! tip ""
If you get a stack trace in your `log.txt` with the following line...
`I:stackwalker: 00000001805FC970 (bm2dx): (unknown): dll_entry_main`
Please enable the lightning mode patch in SpiceTool's patch manager.
### 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

63
docs/games/iidx27/problems.md Normal file
View File

@ -0,0 +1,63 @@
# IIDX 27 Common Problems/Tips
!!! note "Author Note:"
For lightning specific issues, see [lightning cab notes](lightning.md#lightning-specific-troubleshooting)
### Hardware Specs
!!! tip ""
(These are the specs for non-lightning model cab running Heroic Verse)
Bemani PC Type 9 (ADE-6291)
Konami (2017)
Based on an AMD Embedded R Series SoC.
CPU: AMD RX-421BD 2.1/3.4GHz APU
GPU: Radeon R7 800Mhz
RAM: 4 GB
STORAGE: innodisk 3ME2 mSATA SSD 256GB
OS: Windows 7 Embedded
### My Game Is Running Slow/Lagging
!!! tip ""
Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.
### 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.
### 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 (-).
### A Note About SSE 4.2
!!! tip ""
In the rare case you are running this game on *very* old hardware, IIDX 27 requires a processor supporting the [SSE 4.2 instruction set](https://en.wikipedia.org/wiki/SSE4#SSE4.2). But, in the event your processor does not have this, there is a [hex edit](hexedits.md) available to bypass this.
### 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). Unfortunately, this cannot be changed.
### 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.

140
docs/games/iidx27/setup.md Normal file
View File

@ -0,0 +1,140 @@
# beatmania IIDX 27 Heroic Verse
!!! note "Author Note:"
For hex edits: Use the Patches tab in SpiceTools or SpiceCompanion.
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.
Lastly, for demonstrative purposes, this guide uses SpiceTools, you should consult appropriate documentation and requirements of your desired tools as the setup process is likely to be extremely similar.
### 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 `44100 Hz` and check both of the options inside `Exclusive Mode` as pictured.
<img src="/img/gen/441.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 desired 64-bit tools inside the game's `contents` folder, Pictured below is what your folder should look like.
<img src="/img/iidx27/1.png">
### Configuring Your Tools
!!! tip ""
Now that you have your files ready, open up `spicecfg.exe` and head to the `Options` where we'll set our desired parameters. For the purpose of this guide, we will demonstrate both a local network configuration and an online example below with SpiceTools, skip to whichever you're in need of accordingly and please keep in mind you can add whatever additional parameters you desire.
!!! warning "If you're not using SpiceTools:"
You will have to likely generate a .bat file given your existing tool's documentation. As stated above, make sure to check the documentation of your tools to ensure you're using the correct parameters for your needs and to consult appropriate support if you're unsure how to do this.
### Configuring for a Local Network
!!! tip ""
For our local network configuration example, inside `Options` tab we're going to click on the following: `E-Amusement Emulation: -ea` and `Windowed Mode: -w` to enable them.
What do these different parameters do?
- `-ea` enables an integrated e-amusement server within SpiceTools.
- `-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/iidx27/cfg_ea.png">
### Configuring for an Online Network
!!! tip ""
For our online network example we're simply doing the above but with different 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/iidx27/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 within your chosen tools, make sure to check your server's information on how to setup a card file.
### Final Steps and Setting up the Game
!!! tip ""
The last steps you'll have to do with your chosen tools 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 DJ DAO FP7 from the 1P side. Make sure you setup the `Test` keybind as it will be critical for setting up the game.
<img src="/img/gen/bind_iidx.png">
!!! tip ""
Once you've done that, launch your game for the first time by double clicking the `spice64.exe` and the game should load with your chosen parameters from `spicecfg.exe`.
If it's your first time running the game, you'll immediately be greeted with this screen, oh no!
<img src="/img/iidx25/4.png">
!!! tip ""
Ignore this message, simply hit your `Test` keybind and continue onto this.
<img src="/img/iidx25/5.png">
!!! tip ""
Hit the `Test` keybinding to initialize the backup data, a message will pop up stating it's been initialized.
<img src="/img/iidx25/6.png">
!!! tip ""
You'll also run into this error message as well, let's work on eliminating these messages. 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/iidx25/7.png">
!!! tip ""
Start by navigating up to `CLOCK` and entering that menu.
<img src="/img/iidx25/8.png">
!!! tip ""
Simply hit save and exit and leave, the clock will be saved. Then, back in the service menu, go up to `GAME OPTIONS`
<img src="/img/iidx25/9.png">
!!! tip ""
Once inside that menu, navigate your way up to `DEFINITION TYPE` and choose either `SD` or `HD` depending on your preferences.
<img src="/img/iidx26/1.png">
!!! tip ""
The game will then count down asking you to confirm the selection before reverting, just hit `YES` assuming it loaded just fine on your computer. Then, exit out of that menu and head to `NETWORK OPTIONS` from back inside the service menu.
If it doesn't transition to HD, after you've saved, you can simply reboot the game and all should be well.
<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 whatever you desire! For the purpose of the guide, we named it `Guide` but highly encourage fun and/or lazy names. 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)

29
docs/games/jubeatclan/hexedits.md Normal file
View File

@ -0,0 +1,29 @@
# jubeat clan Hex Edits
!!! warning "Unsure how to apply hex edits?"
Check out the [Beginner's Guide to Hex Editing](http://www.bemani.guide/extras/hexguide/) for assistance.
### List of Known Edits For L44-2018070901
!!! tip ""
Disable Tutorial
- jubeat.dll: `0xCFFC7: 75 4A 57 68 00 -> E9 90 00 00 00`
Song Select Timer Freeze
- jubeat.dll: `0xA5A49: 75 -> EB`
Expert Options Lock (Toggling on expert option keeps it on for every future play)
- jubeat.dll: `0xD4699: 89 1D -> EB 0B`
Online Matching Skip
- jubeat.dll: `0xBCDCE: 7D -> EB`
Unlock All Songs
- music_db.dll `0x1B8F: 74 09 -> 90 90`

34
docs/games/jubeatclan/problems.md Normal file
View File

@ -0,0 +1,34 @@
# jubeat clan Common Problems/Tips
### Hardware Specs
!!! tip ""
Bemani PC (ADE-704A)
This board has a E4690 Radeon MXM card.
CPU: Intel Celeron B810
GPU: AMD Radeon E4690
Chipset: Intel HM65
### My Game Is Running Slow/Lagging
!!! tip ""
Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.
### My Game Is Running Crazy Fast!
!!! tip ""
The most common reason for this is the game is running over its required 60hz, the game is hardcoded to run at 60hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60hz. You can always check on the game's monitor check if the game is fluctuating around 59.94hz, the NTSC standard. If it's not around there and your monitor is indeed set to 60hz, 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 Touchscreen Isn't Working!
!!! tip ""
There's a myriad of reasons for this. With SpiceTools in most cases, try using the `-wintouch` parameter if rawinput is not working for your monitor.

83
docs/games/jubeatclan/setup.md Normal file
View File

@ -0,0 +1,83 @@
# jubeat clan
!!! 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.
Lastly, for demonstrative purposes, this guide uses SpiceTools, you should consult appropriate documentation and requirements of your desired tools as the setup process is likely to be extremely similar.
### Getting Started
!!! tip ""
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 desired 32-bit tools inside the game's main folder and to create a `.bat` file. Pictured below is what your folder should look like, feel free to name your `.bat` file whatever you desire, for the sake of convenience we've named ours `gamestart.bat`.
<img src="/img/clan/1.png">
### Configuring Your Tools
!!! tip ""
Now that you have your files ready, open up your `.bat` file in your desired text editor (we're using [Notepad++](https://notepad-plus-plus.org/)) and edit it with your desired parameters, for the purpose of this guide we will demonstrate both a local network configuration and an online example below with SpiceTools, skip to whichever you're in need of accordingly and please keep in mind you can add whatever additional parameters you desire.
!!! warning "If you're not using SpiceTools:"
The overall structure of your .bat file will differ from the guide, namely the initialization of SpiceTools won't be present and potential parameters may differ. As stated above, make sure to check the documentation of your tools to ensure you're using the correct parameters for your needs.
### Configuring for a Local Network
!!! tip ""
For our local network configuration example, on a single line in the `.bat` file we're going to type `spice.exe -ea` and save the file.
What do these different parameters do?
- `-ea` enables an integrated e-amusement server within SpiceTools.
Pictured below, the contents of our `gamestart.bat` file in Notepad++.
<img src="/img/clan/2.png">
### Configuring for an Online Network
!!! tip ""
For our online network example we're simply doing the above but with different parameters! On our single line, we're going to type `spice.exe -p XXXXXXXXXXXXXXXXXXXX -url http://yoururlhere.com/` and save the file.
What do these different parameters do?
- `-p` takes your PCBID on your network of choice, simply replace `XXXXXXXXXXXXXXXXXXXX` with your PCBID.
- `-url` allows you to specify a custom service URL to connect with, simply replace `http://yoururlhere.com/` with your chosen network's URL.
Pictured below, the contents of our `gamestart.bat` file in Notepad++.
<img src="/img/clan/3.png">
!!! tip ""
One final note, since you're playing on a network, you will have one additional step of setting up your card file within your chosen tools, make sure to check your server's information on how to setup a card file.
### Final Steps and Setting up the Game
!!! tip ""
The last steps you'll have to do with your chosen tools is simply setting up your desired keybinds! Make sure you setup the `Test` keybind as it will be critical for setting up the game. Once you've done that, launch your game for the first time by double clicking the `.bat` you setup and the game should load.
If it's your first time running the game, you'll immediately be greeted with this screen (cropped to save your sanity with scrolling repeatedly on the page), oh no!
<img src="/img/clan/5.png">
!!! tip ""
This is okay, you can use your mouse or touchscreen to simply hit `TEST` to initialize the backup data, the game will prompt you to reboot, but let's save ourselves some time and instead go into the `GAME OPTIONS` menu instead, as shown below. If you rebooted, you will see a message telling you to set the "Shop Settings" which is what we're going to now do, as shown below.
<img src="/img/clan/7.png">
!!! tip ""
Enter the `GAME OPTIONS` menu and proceed to the `SHOP SETTINGS` menu.
<img src="/img/clan/8.png">
!!! tip ""
From here, we will need to set the `SHOP NAME SETTINGS`. This is a simple process, simply navigate using the controls in the menu to set any name you desire! For the purpose of the guide, we named it `Guide` but highly encourage fun and/or lazy names. Lastly, if you're not connected to an online network, you'll need to set the `SHOP AREA` as well, navigate to any option you prefer, they're all predefined so you can't get creative here, pictured below is what we set ours to.
<img src="/img/clan/9.png">
!!! tip ""
With that, you're all done! Simply exit the service menu or reboot then enjoy the game, 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.

20
docs/games/musecafinal/hexedits.md Normal file
View File

@ -0,0 +1,20 @@
# MUSECA 1+1/2 Hex Edits
!!! warning "Unsure how to apply hex edits?"
Check out the [Beginner's Guide to Hex Editing](http://www.bemani.guide/extras/hexguide/) for assistance.
### List of Known Edits for PIX-2018073002
!!! tip ""
All edits below are for `museca.dll` unless otherwise specified.
Infinite Final Layer
- 0x17E587: `FF 83 48 14 00 00 -> 90 90 90 90 90 90`
- 0x17E4DF: `7F 08 -> 90 90`
- 0x17E060: `8B 81 48 14 00 00 -> B8 03 00 00 00 90`
Auto Event Mode Toggled (Freeplay (Coin Options) Must be "ON" for this to Work Efficiently)
- 0x196431: `89 01 88 41 10 C7 41 14 01 00 00 00 C3 CC CC CC CC -> C7 01 01 00 00 00 88 41 10 C7 41 14 01 00 00 00 C3`

53
docs/games/musecafinal/problems.md Normal file
View File

@ -0,0 +1,53 @@
# MUSECA 1+1/2 Common Problems/Tips
### Hardware Specs
!!! tip ""
Bemani PC (ADE-6291)
Konami (2018)
Based on an AMD Embedded R Series SoC.
CPU: AMD RX-421BD
GPU: Radeon R7
RAM: 4 GB
OS: Windows 7 Embedded
### My Game Is Running Slow/Lagging
!!! tip ""
Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.
### My Game Is Running Crazy Fast!
!!! tip ""
The most common reason for this is the game is running over its required 60hz, the game is hardcoded to run at 60hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60hz. You can always check on the game's monitor check if the game is fluctuating around 59.94hz, the NTSC standard. If it's not around there and your monitor is indeed set to 60hz, 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.
### 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 (-).
### Booting the Game in Offline Mode
!!! tip ""
If your game version is PIX-2018073002, this version supports turning off E-Amusement. In order to do that, change the game code to `J:B:A` (`<spec>B</spec>` in `prop/ea3-config.xml`), disable/disconnect all network adapters and turn set the E-Amusement setting in the game's operator menu to OFF.
### When I Run This Game All Other Background Audio Is Gone! What's Going On?
!!! tip ""
Museca is a 64-bit game 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. Unfortunately, this cannot be changed.
### 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.

78
docs/games/musecafinal/setup.md Normal file
View File

@ -0,0 +1,78 @@
# MUSECA 1+1/2
!!! 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.
Lastly, for demonstrative purposes, this guide uses SpiceTools, you should consult appropriate documentation and requirements of your desired tools as the setup process is likely to be extremely similar.
### Getting Started
!!! tip ""
Before we even touch the game, let's fiddle with our audio settings to minimize any potential audio issues 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 `44100 Hz` and check both of the options inside `Exclusive Mode` as pictured.
<img src="/img/gen/441.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 desired 64-bit tools inside the game's `contents` folder, and to create a `.bat` file. Pictured below is what your folder should look like, feel free to name your `.bat` file whatever you desire, for the sake of convenience we've named ours `gamestart.bat`.
<img src="/img/museca/1.png">
### Configuring Your Tools
!!! tip ""
Now that you have your files ready, open up your `.bat` file in your desired text editor (we're using [Notepad++](https://notepad-plus-plus.org/)) and edit it with your desired parameters, for the purpose of this guide we will demonstrate both a local network configuration and an online example below with SpiceTools, skip to whichever you're in need of accordingly and please keep in mind you can add whatever additional parameters you desire.
!!! warning "If you're not using SpiceTools:"
The overall structure of your .bat file will differ from the guide, namely the initialization of SpiceTools won't be present and potential parameters may differ. As stated above, make sure to check the documentation of your tools to ensure you're using the correct parameters for your needs.
### Configuring for a Local Network
!!! tip ""
For our local network configuration example, on a single line in the `.bat` file we're going to type `spice64.exe -ea -w` and save the file.
What do these different parameters do?
- `-ea` enables an integrated e-amusement server within SpiceTools.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/iidx25/2.png">
### Configuring for an Online Network
!!! tip ""
For our online network example we're simply doing the above but with different parameters! On our single line, we're going to type `spice64.exe -p XXXXXXXXXXXXXXXXXXXX -url http://yoururlhere.com/ -w` and save the file.
What do these different parameters do?
- `-p` takes your PCBID on your network of choice, simply replace `XXXXXXXXXXXXXXXXXXXX` with your PCBID.
- `-url` allows you to specify a custom service URL to connect with, simply replace `http://yoururlhere.com/` with your chosen network's URL.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/iidx25/3.png">
!!! tip ""
One final note, since you're playing on a network, you will have one additional step of setting up your card file within your chosen tools, make sure to check your server's information on how to setup a card file.
### Final Steps and Setting up the Game
!!! tip ""
It's important to note before booting the game that Museca uses portrait mode and attempting to boot the game fullscreen in most landscape environments will result in a crash. To alleviate this, we must set our *main* monitor to portrait mode and be ready to rotate it! To do so, right click on your desktop and go into `Display Settings`, then simply set the orientation to `Portrait` as pictured.
In the event that you do not have the means to run the game in portrait mode and cannot rotate your monitor, it is recommended you boot the game in windowed mode. In SpiceTools, simply add the windowed mode parameter, this parameter is `-w` and can be placed right after any other desired parameters chosen in our `gamestart.bat`
<img src="/img/sdvxiv/4.png">
The last steps you'll have to do with your chosen tools is simply setting up your desired keybinds! Make sure you setup the `Test` keybind as it will be critical for setting up the game. Once you've done that, launch your game for the first time by double clicking the `.bat` you setup and the game should load and be ready to be enjoyed! 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.

10
docs/games/nostforte/hexedits.md Normal file
View File

@ -0,0 +1,10 @@
# NOSTALGIA FORTE Hex Edits
!!! warning "Unsure how to apply hex edits?"
Check out the [Beginner's Guide to Hex Editing](http://www.bemani.guide/extras/hexguide/) for assistance.
### List of Known Edits For PAN-2018062002
!!! tip ""
At the time of writing, no hex edits have been worked on for Nostalgia.

41
docs/games/nostforte/problems.md Normal file
View File

@ -0,0 +1,41 @@
# NOSTALGIA FORTE Common Problems/Tips
### Hardware Specs
!!! tip ""
Bemani PC Type 6 (ADE-704A)
Based on an AMD Embedded R Series SoC.
CPU: Intel Celeron B810
GPU: AMD Radeon E4690
OS: Windows 7 Embedded
### My Game Is Running Slow/Lagging
!!! tip ""
Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.
### My Game Is Running Crazy Fast!
!!! tip ""
The most common reason for this is the game is running over its required 60hz, the game is hardcoded to run at 60hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60hz. You can always check on the game's monitor check if the game is fluctuating around 59.94hz, the NTSC standard. If it's not around there and your monitor is indeed set to 60hz, 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.
### 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 (-).
### No Matter What I Do, the Game Crashes and I Have Multiple Monitors!
!!! tip ""
This problem is somewhat irregular, but sometimes Nostalgia has issues booting with multiple monitors present, particularly when trying to boot the game windowed. Make sure you're running the latest SpiceTools which has attempted to resolve all instances of this issue.

101
docs/games/nostforte/setup.md Normal file
View File

@ -0,0 +1,101 @@
# NOSTALGIA FORTE
!!! 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.
Lastly, for demonstrative purposes, this guide uses SpiceTools, you should consult appropriate documentation and requirements of your desired tools as the setup process is likely to be extremely similar.
### Getting Started
!!! tip ""
Before we even touch the game, let's fiddle with our audio settings to minimize any potential audio issues 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 `44100 Hz` and check both of the options inside `Exclusive Mode` as pictured.
<img src="/img/gen/441.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 desired 64-bit tools inside the game's main folder and to create a `.bat` file. Pictured below is what your folder should look like, feel free to name your `.bat` file whatever you desire, for the sake of convenience we've named ours `gamestart.bat`.
<img src="/img/nost/1.png">
### Configuring Your Tools
!!! tip ""
Now that you have your files ready, open up your `.bat` file in your desired text editor (we're using [Notepad++](https://notepad-plus-plus.org/)) and edit it with your desired parameters, for the purpose of this guide we will demonstrate ONLY a local network configuration with SpiceTools. Why only local? Because none of the most typical places currently support Nostalgia. Regardless, please keep in mind you can add whatever additional parameters you desire.
!!! warning "If you're not using SpiceTools:"
The overall structure of your .bat file will differ from the guide, namely the initialization of SpiceTools won't be present and potential parameters may differ. As stated above, make sure to check the documentation of your tools to ensure you're using the correct parameters for your needs.
### Configuring for a Local Network
!!! tip ""
For our local network configuration example, on a single line in the `.bat` file we're going to type `spice64.exe -ea -w` and save the file.
What do these different parameters do?
- `-ea` enables an integrated e-amusement server within SpiceTools.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/iidx25/2.png">
### Configuring for an Online Network
!!! tip ""
For our online network example we're simply doing the above but with different parameters! On our single line, we're going to type `spice64.exe -p XXXXXXXXXXXXXXXXXXXX -url http://yoururlhere.com/ -w` and save the file.
What do these different parameters do?
- `-p` takes your PCBID on your network of choice, simply replace `XXXXXXXXXXXXXXXXXXXX` with your PCBID.
- `-url` allows you to specify a custom service URL to connect with, simply replace `http://yoururlhere.com/` with your chosen network's URL.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/iidx25/3.png">
### Final Steps and Setting up the Game
!!! tip ""
The last steps you'll have to do with your chosen tools is simply setting up your desired keybinds! Make sure you setup the `Test` keybind as it will be critical for setting up the game. Once you've done that, launch your game for the first time by double clicking the `.bat` you setup and the game should load.
If it's your first time running the game, you should be automatically forced into the service menu with lots of scary flashing notifications as pictured below, let's work through them.
<img src="/img/nost/2.png">
!!! tip ""
Interestingly, only the red flashing ones really take any effort to deal with. You can start by entering and exiting the following menus: `SOUND OPTIONS`, `GAME OPTIONS`, `COIN OPTIONS`, `ECOMODE OPTIONS`, and `NETWORK OPTIONS`.
Once you've done that, enter `CLOCK` and set the clock by hitting `SAVE AND EXIT` as pictured below.
<img src="/img/nost/3.png">
!!! tip ""
The final menu we must deal with is `VIRTUAL COIN`, enter the menu and select `OPERATION SETTINGS` as seen below.
<img src="/img/nost/4.png">
!!! tip ""
Once inside this menu, we'll need to deal with all 4 blinking options, let's start by entering the `TAX RATE SETTING` menu, shown below.
<img src="/img/nost/5.png">
!!! tip ""
Set the tax rate by simply selecting `SAVE AND EXIT` while will take us back into the `OPERATING SETTINGS`. Pictured below is the `TAX RATE SETTING` menu.
<img src="/img/nost/6.png">
!!! tip ""
Once back inside the `TAX RATE SETTING` menu, we must deal with the three blinking `PATTERN` options. Doing so is effortless, simply enter all three menus one by one and hit `SAVE AND EXIT` just as we did for the `TAX RATE SETTING` in the previous step. Pictured below is the inside of `PATTERN 1`.
<img src="/img/nost/6.png">
!!! tip ""
After saving and exiting all three `PATTERN` options, 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.

33
docs/games/nostop2/hexedits.md Normal file
View File

@ -0,0 +1,33 @@
# NOSTALGIA OP.2 Hex Edits
!!! warning "Unsure how to apply hex edits?"
Check out the [Beginner's Guide to Hex Editing](http://www.bemani.guide/extras/hexguide/) for assistance.
### List of Known Edits For PAN-20191002/PAN-2019112700
!!! tip ""
Menu Timer Freeze
- nostalgia.dll: `0x303D33: 41 FF C8 -> 90 90 90`
Shorter Monitor Check
- nostalgia.dll: `0x21A6FA: 1E -> 00`
Hide "EXTRA PASELI: %d"
- nostalgia.dll: `0x307BD2: CA 2F 2A -> 04 72 26`
- nostalgia.dll: `0x307BEE: 7E 2F 2A -> E8 71 26`
Hide "PASELI: *****"
- nostalgia.dll: `0x307A6E: FF 15 14 42 09 00 -> E9 A0 01 00 00 90`
Hide Credit Count
- nostalgia.dll: `0x307E31: BB 2B 2A -> A5 6F 26`
- nostalgia.dll: `0x307E4D: 7F 2B 2A -> 89 6F 26`

41
docs/games/nostop2/problems.md Normal file
View File

@ -0,0 +1,41 @@
# NOSTALGIA OP.2 Common Problems/Tips
### Hardware Specs
!!! tip ""
Bemani PC Type 6 (ADE-704A)
Based on an AMD Embedded R Series SoC.
CPU: Intel Celeron B810
GPU: AMD Radeon E4690
OS: Windows 7 Embedded
### My Game Is Running Slow/Lagging
!!! tip ""
Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.
### My Game Is Running Crazy Fast!
!!! tip ""
The most common reason for this is the game is running over its required 60hz, the game is hardcoded to run at 60hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60hz. You can always check on the game's monitor check if the game is fluctuating around 59.94hz, the NTSC standard. If it's not around there and your monitor is indeed set to 60hz, 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.
### 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 (-).
### No Matter What I Do, the Game Crashes and I Have Multiple Monitors!
!!! tip ""
This problem is somewhat irregular, but sometimes Nostalgia has issues booting with multiple monitors present, particularly when trying to boot the game windowed. Make sure you're running the latest SpiceTools which has attempted to resolve all instances of this issue.

101
docs/games/nostop2/setup.md Normal file
View File

@ -0,0 +1,101 @@
# NOSTALGIA OP.2
!!! 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.
Lastly, for demonstrative purposes, this guide uses SpiceTools, you should consult appropriate documentation and requirements of your desired tools as the setup process is likely to be extremely similar.
### Getting Started
!!! tip ""
Before we even touch the game, let's fiddle with our audio settings to minimize any potential audio issues 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 `44100 Hz` and check both of the options inside `Exclusive Mode` as pictured.
<img src="/img/gen/441.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 desired 64-bit tools inside the game's main folder and to create a `.bat` file. Pictured below is what your folder should look like, feel free to name your `.bat` file whatever you desire, for the sake of convenience we've named ours `gamestart.bat`.
<img src="/img/nost/8.png">
### Configuring Your Tools
!!! tip ""
Now that you have your files ready, open up your `.bat` file in your desired text editor (we're using [Notepad++](https://notepad-plus-plus.org/)) and edit it with your desired parameters, for the purpose of this guide we will demonstrate ONLY a local network configuration with SpiceTools. Why only local? Because none of the most typical places currently support Nostalgia. Regardless, please keep in mind you can add whatever additional parameters you desire.
!!! warning "If you're not using SpiceTools:"
The overall structure of your .bat file will differ from the guide, namely the initialization of SpiceTools won't be present and potential parameters may differ. As stated above, make sure to check the documentation of your tools to ensure you're using the correct parameters for your needs.
### Configuring for a Local Network
!!! tip ""
For our local network configuration example, on a single line in the `.bat` file we're going to type `spice64.exe -ea -w` and save the file.
What do these different parameters do?
- `-ea` enables an integrated e-amusement server within SpiceTools.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/iidx25/2.png">
### Configuring for an Online Network
!!! tip ""
For our online network example we're simply doing the above but with different parameters! On our single line, we're going to type `spice64.exe -p XXXXXXXXXXXXXXXXXXXX -url http://yoururlhere.com/ -w` and save the file.
What do these different parameters do?
- `-p` takes your PCBID on your network of choice, simply replace `XXXXXXXXXXXXXXXXXXXX` with your PCBID.
- `-url` allows you to specify a custom service URL to connect with, simply replace `http://yoururlhere.com/` with your chosen network's URL.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/iidx25/3.png">
### Final Steps and Setting up the Game
!!! tip ""
The last steps you'll have to do with your chosen tools is simply setting up your desired keybinds! Make sure you setup the `Test` keybind as it will be critical for setting up the game. Once you've done that, launch your game for the first time by double clicking the `.bat` you setup and the game should load.
If it's your first time running the game, you should be automatically forced into the service menu with lots of scary flashing notifications as pictured below, let's work through them.
<img src="/img/nost/2.png">
!!! tip ""
Interestingly, only the red flashing ones really take any effort to deal with. You can start by entering and exiting the following menus: `SOUND OPTIONS`, `GAME OPTIONS`, `COIN OPTIONS`, `ECOMODE OPTIONS`, and `NETWORK OPTIONS`.
Once you've done that, enter `CLOCK` and set the clock by hitting `SAVE AND EXIT` as pictured below.
<img src="/img/nost/3.png">
!!! tip ""
The final menu we must deal with is `VIRTUAL COIN`, enter the menu and select `OPERATION SETTINGS` as seen below.
<img src="/img/nost/4.png">
!!! tip ""
Once inside this menu, we'll need to deal with all 4 blinking options, let's start by entering the `TAX RATE SETTING` menu, shown below.
<img src="/img/nost/5.png">
!!! tip ""
Set the tax rate by simply selecting `SAVE AND EXIT` while will take us back into the `OPERATING SETTINGS`. Pictured below is the `TAX RATE SETTING` menu.
<img src="/img/nost/6.png">
!!! tip ""
Once back inside the `TAX RATE SETTING` menu, we must deal with the three blinking `PATTERN` options. Doing so is effortless, simply enter all three menus one by one and hit `SAVE AND EXIT` just as we did for the `TAX RATE SETTING` in the previous step. Pictured below is the inside of `PATTERN 1`.
<img src="/img/nost/6.png">
!!! tip ""
After saving and exiting all three `PATTERN` options, 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.

42
docs/games/popnpeace/hexedits.md Normal file
View File

@ -0,0 +1,42 @@
# Pop'n Peace Hex Edits
!!! warning "Unsure how to apply hex edits?"
Check out the [Beginner's Guide to Hex Editing](http://www.bemani.guide/extras/hexguide/) for assistance.
### List of Known Edits For M39-2020092800
!!! tip ""
E: Drive fix
- popn22.dll: `0x286AA8: 65 3A 2F -> 64 65 76`
HDMI Audio Fix
- popn22.dll `0x13442C: 85 C0 75 96 -> 90 90 90 90`
Prevent Windows volume change on boot
- popn22.dll: `0x137030: 83 -> C3`
Boot to Event Mode
- popn22.dll `0x108DC0: 8B 00 C3 CC -> 31 C0 40 C3`
Timer Freeze
- popn22.dll `0xE294C: 0F 85 -> 0x90 E9`
Skip Menu and Long Note Tutorials
- popn22.dll `0x28E0B: 74 -> EB`
- popn22.dll `0x28DE7: 75 -> EB`
- popn22.dll `0x8AE71: 75 -> EB`
Unlock All Songs
- popn22.dll `0x10D2E2: 74 -> EB`
- popn22.dll `0x10D2FB: 75 46 -> 90 90`
- popn22.dll `0x10D318: 74 3A -> 90 90`
- popn22.dll `0x10D33B: 84 C0 -> B0 01`

39
docs/games/popnpeace/problems.md Normal file
View File

@ -0,0 +1,39 @@
Pop&apos;n Peace Common Problems/Tips
### Hardware Specs
!!! tip ""
Bemani PC Type 4
CPU: Intel Celeron B810 1.6GHz
GPU: ATI Radeon E4690 MXM
OS: Windows XP Embedded
### My Game Is Running Slow/Lagging
!!! tip ""
Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.
### My Game Is Running Crazy Fast/After Finishing a Song Loading Is Stuck
!!! tip ""
The most common reason for this is the game is running over its required 60hz, the game is hardcoded to run at 60hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60hz. You can always check on the game's monitor check if the game is fluctuating around 59.94hz, the NTSC standard. If it's not around there and your monitor is indeed set to 60hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.
### Why Is the In-Game Text Garbled?
!!! tip ""
The in-game text requires a Japanese locale to display the Japanese characters correctly, look up a guide for your specific operating system on how to switch your operating system's locale to Japanese.
### The game crashes fullscreen!
!!! tip ""
Some monitors and display adapters may not support the odd resolution the game runs at, which is 1360x768 versus the occasionally seen 1366x768. To resolve, setup a custom resolution inside your appropriate graphic's card settings, or enable GPU resolution scaling.
### Other Crashes
!!! tip ""
This game requires an E: drive to be named by the computer. If you do not have one, make sure to apply the `E: Drive fix` [hex edit](hexedits.md)
It may also fail to boot regardless of this, such as in the case of using HDMI audio. Even if you're not using HDMI audio however, some failures to boot have been noted. For safety, make sure to also apply the `HDMI Audio Fix` [hex edit](hexedits.md) unless you're using the latest SpiceTools which fixes this issue.

83
docs/games/popnpeace/setup.md Normal file
View File

@ -0,0 +1,83 @@
# Pop&apos;n Peace
!!! 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.
Lastly, for demonstrative purposes, this guide uses SpiceTools, you should consult appropriate documentation and requirements of your desired tools as the setup process is likely to be extremely similar.
### Getting Started
!!! tip ""
This game still uses DirectSound so we can skip audio related setup needed for other games. 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 desired 32-bit tools inside the game's `contents` folder. Pictured below is what your folder should look like.
<img src="/img/popn/2.png">
### Configuring Your Tools
!!! tip ""
Now that you have your files ready, open up `spicecfg.exe` and head to the `Options` tab. Here you can configure all of the various options that SpiceTools has, but for the purpose of this guide we'll demonstrate how to set up a local server and an online server. You can skip over the parts that you don't need, and feel free to set any other options that you might like.
!!! warning "If you're not using SpiceTools:"
It's most likely that your toolkit doesn't have an options interface, so you'll have to create a `.bat` file. Consult the appropriate documentation for this as this isn't covered in this guide.
### Configuring for a Local Network
!!! tip ""
For our local network configuration example, in the `Options` tab enable the following options: `E-Amusement Emulation: -ea` and `Windowed Mode: -w`.
What do these different parameters do?
- `-ea` enables an integrated e-amusement server within SpiceTools.
- `-w` will boot the game in windowed mode which will ease our initial setup and testing later, make sure to disable `-w` to run the game fullscreen once you're done setting up!
Pictured below, the selected options in `spicecfg.exe`.
<img src="/img/popn/3.png">
### Configuring for an Online Network
!!! tip ""
For our online network example we're simply doing the above but with different options!
We're going to use the option `PCBID: -pcbid` for our PCBID, with `XXXXXXXXXXXXXXXXXXXX` as the value.
For the network URL we're going to use the option `Service URL: -url`, with `http://yoururlhere.com/` as the value.
We'll also enable windowed mode by enabling the option `Windowed Mode: -w`.
What do these different parameters do?
- `-p` takes your PCBID on your network of choice, simply replace `XXXXXXXXXXXXXXXXXXXX` with your PCBID.
- `-url` allows you to specify a custom service URL to connect with, simply replace `http://yoururlhere.com/` with your chosen network's URL.
- `-w` will boot the game in windowed mode which will ease our initial setup and testing later, make sure to disable `-w` to run the game fullscreen once you're done setting up!
Pictured below, the enabled options in `spicecfg.exe`.
<img src="/img/popn/4.png">
!!! tip ""
One final note, since you're playing on a network, you will have one additional step of setting up your card file within your chosen tools, make sure to check your server's information on how to setup a card file.
### Configuring Keybinds
!!! tip ""
While we're still in `spicecfg.exe`, why not set up the keybinds? To do this you'll have to head on over to the `Buttons` tab. Here you simply click `Bind` and press the button on your controller (or keyboard). Below are my keybinds of an arduino based controller. Notice that I've also bound the `Service`, `Test` and `Coin Mech` buttons to my keyboard. This might come in handy but shouldn't be necessary to play the game.
<img src="/img/popn/5.png">
### Booting
!!! tip ""
With that, you're all done! Boot the game by double-clicking `spice.exe` and the game should load and be ready to be enjoyed! 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.

50
docs/games/popnusaneko/hexedits.md Normal file
View File

@ -0,0 +1,50 @@
# Pop'n Usaneko Hex Edits
!!! warning "Unsure how to apply hex edits?"
Check out the [Beginner's Guide to Hex Editing](http://www.bemani.guide/extras/hexguide/) for assistance.
### List of Known Edits For M39-2018082100
!!! tip ""
E: Drive fix
- popn22.dll: `0x25A5D0: 65 3A 2F -> 64 65 76`
HDMI Audio Fix
- popn22.dll `0x12C26C: 85 C0 75 96 -> 90 90 90 90`
Prevent Windows volume change on boot
- popn22.dll: `0x12EE70: 83 -> C3`
Boot to Event Mode
- popn22.dll `0x100A10: 8B 00 C3 CC -> 31 C0 40 C3`
Timer Freeze
- popn22.dll `0xDB3F2: C7 45 38 09 00 00 00 -> 90 90 90 90 90 90 90`
Partial Song Unlock (NOTE: This does not unlock all songs, see the notes below.
- popn22.dll `0x1E0524 - 0x1E073F: fill with zeros (00)`
Unlock Classic 8 EX as a 49
- popn22.dll `0x2AC1DB: 05 -> 07`
- popn22.dll `0x2AC1EB: 01 -> 31`
Network Adapter Fix (for matching online/local)
- libavs-win32.dll: '0x3A13D: 8B 7C 24 08 8B D5 8B -> BA 01 00 00 00 EB B5'
### Notes
!!! tip ""
Since we don't have hex edits to unlock songs that are both new and old (eclale songs, SDVX FLOOR INFECTION, etc.) [Here is an unlocked DLL with both the HDMI audio fix and E: drive fix already done.](/files/usaneko-unlock.zip)
This will unlock all songs in pop'n 24, 23 and the floor infection songs in pop'n 23 and 22. This also takes away the hold note identifier on the menus, so you don't have to have that annoying hold note tutorial if you play without a card or offline.

46
docs/games/popnusaneko/problems.md Normal file
View File

@ -0,0 +1,46 @@
Pop&apos;n Usaneko Common Problems/Tips
### Hardware Specs
!!! tip ""
Bemani PC Type 4
CPU: Intel Celeron B810 1.6GHz
GPU: ATI Radeon E4690 MXM
OS: Windows XP Embedded
### My Game Is Running Slow/Lagging
!!! tip ""
Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.
### My Game Is Running Crazy Fast/After Finishing a Song Loading Is Stuck
!!! tip ""
The most common reason for this is the game is running over its required 60hz, the game is hardcoded to run at 60hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60hz. You can always check on the game's monitor check if the game is fluctuating around 59.94hz, the NTSC standard. If it's not around there and your monitor is indeed set to 60hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.
### Why Is the In-Game Text Garbled?
!!! tip ""
The in-game text requires a Japanese locale to display the Japanese characters correctly, look up a guide for your specific operating system on how to switch your operating system's locale to Japanese.
### The game crashes fullscreen!
!!! tip ""
Some monitors and display adapters may not support the odd resolution the game runs at, which is 1360x768 versus the occasionally seen 1366x768. To resolve, setup a custom resolution inside your appropriate graphic's card settings, or enable GPU resolution scaling.
### Other Crashes
!!! tip ""
This game requires an E: drive to be named by the computer. If you do not have one, make sure to apply the `E: Drive fix` [hex edit](hexedits.md)
It may also fail to boot regardless of this, such as in the case of using HDMI audio. Even if you're not using HDMI audio however, some failures to boot have been noted. For safety, make sure to also apply the `HDMI Audio Fix` [hex edit](hexedits.md) unless you're using the latest SpiceTools which fixes this issue.
### How to Unlock Songs
!!! tip ""
Without an appropriate hex edit available, the game is missing song unlocks. To resolve this, I've provided an unlocked DLL with BOTH the HDMI audio fix and E: drive fix already applied. You can download it [here](/files/usaneko-unlock.zip)
Simply replace it with your existing one inside the `contents` folder of your game installation. When asked to replace, hit yes.

71
docs/games/popnusaneko/setup.md Normal file
View File

@ -0,0 +1,71 @@
# Pop&apos;n Usaneko
!!! 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.
Lastly, for demonstrative purposes, this guide uses SpiceTools, you should consult appropriate documentation and requirements of your desired tools as the setup process is likely to be extremely similar.
### Getting Started
!!! tip ""
This game still uses DirectSound so we can skip audio related setup needed for other games. 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 desired 32-bit tools inside the game's `contents` folder, and to create a `.bat` file. Pictured below is what your folder should look like, feel free to name your `.bat` file anything you desire, for the sake of convenience we've named ours `gamestart.bat`.
<img src="/img/popn/1.png">
### Configuring Your Tools
!!! tip ""
Now that you have your files ready, open up your `.bat` file in your desired text editor (we're using [Notepad++](https://notepad-plus-plus.org/)) and edit it with your desired parameters, for the purpose of this guide we will demonstrate both a local network configuration and an online example below with SpiceTools, skip to whichever you're in need of accordingly and please keep in mind you can add whatever additional parameters you desire.
!!! warning "If you're not using SpiceTools:"
The overall structure of your .bat file will differ from the guide, namely the initialization of SpiceTools won't be present and potential parameters may differ. As stated above, make sure to check the documentation of your tools to ensure you're using the correct parameters for your needs.
### Configuring for a Local Network
!!! tip ""
For our local network configuration example, on a single line in the `.bat` file we're going to type `spice.exe -ea -w` and save the file.
What do these different parameters do?
- `-ea` enables an integrated e-amusement server within SpiceTools.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/sdvxiv/2.png">
### Configuring for an Online Network
!!! tip ""
For our online network example we're simply doing the above but with different parameters! On our single line, we're going to type `spice.exe -p XXXXXXXXXXXXXXXXXXXX -url http://yoururlhere.com/ -w` and save the file.
What do these different parameters do?
- `-p` takes your PCBID on your network of choice, simply replace `XXXXXXXXXXXXXXXXXXXX` with your PCBID.
- `-url` allows you to specify a custom service URL to connect with, simply replace `http://yoururlhere.com/` with your chosen network's URL.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/sdvxiv/3.png">
!!! tip ""
One final note, since you're playing on a network, you will have one additional step of setting up your card file within your chosen tools, make sure to check your server's information on how to setup a card file.
### Final Steps and Setting up the Game
!!! tip ""
With that, you're all done! The final step you'll have to do with your chosen tools is simply setting up your desired keybinds! Once you've done that, Boot the game with your `gamestart.bat` and the game should load and be ready to be enjoyed! 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.

13
docs/games/reflesia/hexedits.md Normal file
View File

@ -0,0 +1,13 @@
# Reflec Beat Reflesia Hex Edits
!!! warning "Unsure how to apply hex edits?"
Check out the [Beginner's Guide to Hex Editing](http://www.bemani.guide/extras/hexguide/) for assistance.
### List of Known Edits For MBR-2018121100
!!! tip ""
E:\ drive fix
- reflecbeat.dll: `0x28B0FC: 65 3A 2F -> 64 65 76`

42
docs/games/reflesia/problems.md Normal file
View File

@ -0,0 +1,42 @@
# REFLEC BEAT: Reflesia Common Problems/Tips
### Hardware Specs
!!! tip ""
Bemani PC (ADE-704A)
CPU: Intel Celeron B810 1.6GHz
GPU: E4690 Radeon MXM
OS: Windows XP Embedded
### My Game Doesn't Boot After Following the Guide!
!!! tip ""
The most common problem present here is if you do not have an E:/ drive. To resolve this issue, you must apply the `E:/drive fix` hex edit found [here.](hexedits.md)
### My Game Is Running Slow/Lagging
!!! tip ""
Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.
### My Game Is Running Crazy Fast/After Finishing a Song Loading Is Stuck
!!! tip ""
The most common reason for this is the game is running over its required 60hz, the game is hardcoded to run at 60hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60hz. You can always check on the game's monitor check if the game is fluctuating around 59.94hz, the NTSC standard. If it's not around there and your monitor is indeed set to 60hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.
### 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 (-).
### Failed to Create Texture Error in SpiceTools
!!! tip ""
If your error is along the lines of a failure to create a texture W:afputils: CTexture::create_texture テクスチャの作成に失敗しました。 then boot the game without touching anything, even your mouse, maybe give it a few tries, it's admittedly a strange issue with no exact science behind it discovered.
### I Get a White Screen That Silently Closes After a Few Seconds
!!! tip ""
Reflesia runs at 768x1360 opposed to more common resolutions. If your monitor doesn't have support for this, try making a custom resolution in your graphic's cards options. Also, make sure your monitor is in portrait mode as opposed to landscape.

85
docs/games/reflesia/setup.md Normal file
View File

@ -0,0 +1,85 @@
# REFLEC BEAT: The Reflesia of Eternity
!!! 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.
One other thing, make sure your game folder isn't set to `Read Only` and that you don't have horribly wonky security permissions in Windows.
Lastly, for demonstrative purposes, this guide uses SpiceTools, you should consult appropriate documentation and requirements of your desired tools as the setup process is likely to be extremely similar.
### Getting Started
!!! tip ""
This game still uses DirectSound so we can skip audio related setup needed for other games. After downloading your data, the first thing to do is put your desired 32-bit tools inside the game's `contents` folder, and to create a `.bat` file. Pictured below is what your folder should look like, feel free to name your `.bat` file anything you desire, for the sake of convenience we've named ours `gamestart.bat`.
<img src="/img/reflesia/reflesia.png">
### Configuring Your Tools
!!! tip ""
Now that you have your files ready, open up your `.bat` file in your desired text editor (we're using [Notepad++](https://notepad-plus-plus.org/)) and edit it with your desired parameters, for the purpose of this guide we will demonstrate both a local network configuration and an online example below with SpiceTools, skip to whichever you're in need of accordingly and please keep in mind you can add whatever additional parameters you desire.
!!! warning "If you're not using SpiceTools:"
The overall structure of your .bat file will differ from the guide, namely the initialization of SpiceTools won't be present and potential parameters may differ. As stated above, make sure to check the documentation of your tools to ensure you're using the correct parameters for your needs.
### Configuring for a Local Network
!!! tip ""
For our local network configuration example, on a single line in the `.bat` file we're going to type `spice.exe -ea -w` and save the file.
What do these different parameters do?
- `-ea` enables an integrated e-amusement server within SpiceTools.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/sdvxiv/2.png">
### Configuring for an Online Network
!!! tip ""
For our online network example we're simply doing the above but with different parameters! On our single line, we're going to type `spice.exe -p XXXXXXXXXXXXXXXXXXXX -url http://yoururlhere.com/ -w` and save the file.
What do these different parameters do?
- `-p` takes your PCBID on your network of choice, simply replace `XXXXXXXXXXXXXXXXXXXX` with your PCBID.
- `-url` allows you to specify a custom service URL to connect with, simply replace `http://yoururlhere.com/` with your chosen network's URL.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/sdvxiv/3.png">
!!! tip ""
One final note, since you're playing on a network, you will have one additional step of setting up your card file within your chosen tools, make sure to check your server's information on how to setup a card file.
### Final Steps and Setting up the Game
!!! tip ""
It's important to note before booting the game that Reflec Beat uses portrait mode and attempting to boot the game fullscreen in most landscape environments will result in a crash. To alleviate this, we must set our *main* monitor to portrait mode and be ready to rotate it! To do so, right click on your desktop and go into `Display Settings`, then simply set the orientation to `Portrait` as pictured.
<img src="/img/sdvxiv/4.png">
In the event that you do not have the means to run the game in portrait mode and cannot rotate your monitor, it is recommended you boot the game in windowed mode. In SpiceTools, simply add the windowed mode parameter, this parameter is `-w` and can be placed right after any other desired parameters chosen in our `gamestart.bat`
As for the touch stuff, by default SpiceTools should detect your mouse just fine, you can use the `-s` parameter to have your cursor show at all times above the game window. For touchscreen monitors, it's a bit tricky to write something encompassing them all. Many should be detected automatically, however some may require adding the `-wintouch` parameter for support.
You can check out some documented touchscreen monitors [here.](/extras/pollingrates/)
With that, you're all done! The final step you'll have to do with your chosen tools is simply setting up your desired keybinds! Once you've done that, Boot the game with your `gamestart.bat` and the game should load and be ready to be enjoyed! 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.

144
docs/games/sdvx4/hexedits.md Normal file
View File

@ -0,0 +1,144 @@
# Sound Voltex IV: Heavenly Haven Hex Edits
!!! warning "Unsure how to apply hex edits?"
Check out the [Beginner's Guide to Hex Editing](http://www.bemani.guide/extras/hexguide/) for assistance.
### List of Known Edits For KFC-2019020600
!!! tip ""
Auto Event Mode Toggled (Freeplay (Coin Options) must be "ON" for this to work efficiently)
- soundvoltex.dll: `0x19EAD2: 00 > 01`
Difficulty Unlock
- soundvoltex.dll: `0x158D42: E8 69 5D 02 -> B8 0D 00 00`
Song Unlock
- soundvoltex.dll: `0x1BF579: 8B 44 24 20 E8 3E EB FF FF -> B8 03 00 00 00 90 90 90 90`
2 Song Safe
- soundvoltex.dll: `0x17A153: 32 C0 -> B0 01`
Premium Free Hack (Combine with 2 Song Safe Hex above for full effect)
- soundvoltex.dll: `0x1D6B8F: 00 -> 02`
- soundvoltex.dll: `0x1D6D76: 8B 83 64 10 00 00 8D 48 01 83 F9 04 56 57 7F 52 -> B8 01 00 00 00 89 83 64 10 00 00 90 56 57 90 90`
Safe Banner Removal
- soundvoltex.dll `0x2FB684: 73 -> 00`
Prevent Windows volume change on boot
- soundvoltex.dll: `0x2550CA: E8 21 03 00 00 -> 90 90 90 90 90`
Disable EVENT MODE/FREE PLAY text
- soundvoltex.dll: `0xBF9E0: E8 DB -> EB 03`
Allow ARS (Alternative Rate System) Option (At gauge select, goto excessive and press BT-D to enable)
- soundvoltex.dll `0x179864: 74 -> EB`
Non-effective rate gauges start at 0%
- soundvoltex.dll: `0x120730: 10 27 -> 01 00`
Non-effective rate gauges do not recover
- soundvoltex.dll: `0x120BAA: 01 50 48 -> 90 90 90`
Enable MUSECA cards in generator start
- soundvoltex.dll: `0x31F3BA: 6D 75 73 65 63 61 -> 90 90 90 90 90 90`
Disable chain display
- soundvoltex.dll: `0x128241 8B 45 08 -> 90 90 90`
Disable gold chain color
- soundvoltex.dll: `0x12822F 00 -> FF`
Disable UC,PUC fanfare
- soundvoltex.dll: `0x1285D2 80 -> 81`
- soundvoltex.dll: `0x128614 00 -> FF`
Unlock blaster barrier rank 5
- soundvoltex.dll: `0x9DAA6 08 -> 0A`
- soundvoltex.dll: `0x9DAB7 08 -> 0A`
### List of Known Edits For KFC-2017112800
!!! tip ""
Auto Event Mode Toggled (Freeplay (Coin Options) must be "ON" for this to work efficiently)
- soundvoltex.dll: `0x196562 : 00 > 01`
Song & Difficulty Unlock
- soundvoltex.dll: `0x152142: E8 F9 41 02 -> B8 0D 00 00 (Difficulty Unlock)`
- soundvoltex.dll: `0x1B4A31: 8B 44 24 20 E8 A6 EC FF FF -> B8 03 00 00 00 90 90 90 90 (Song Unlock)`
2 Song Safe
- soundvoltex.dll: `0x171B07: 32 C0 -> B0 01`
Premium Free Hack (Combine with 2 Song Safe Hex above for full effect)
- soundvoltex.dll: `0x1CAAFF: 00 -> 02`
- soundvoltex.dll: `0x1CACC6: 8B 83 64 10 00 00 8D 48 01 83 F9 04 56 57 7F 52 -> B8 01 00 00 00 89 83 64 10 00 00 90 56 57 90 90`
Safe Banner Removal
- soundvoltex.dll: `0x2E9C44: 73 -> 00`
Prevent Windows volume change on boot
- soundvoltex.dll: `0x2451EA: E8 21 03 00 00 -> 90 90 90 90 90`
Disable EVENT MODE/FREE PLAY text
- soundvoltex.dll: `0xBC920: E8 6B -> EB 03`
Hispeed values from 0.1 to 20.0
- soundvoltex.dll: `0x12198B: DD 05 F8 87 2D 10 -> D9 05 A0 89 2D 10`
- soundvoltex.dll: `0x1219A0: DD 05 00 88 2D 10 -> D9 05 E4 86 2D 10`
- soundvoltex.dll: `0x1211C1: DD 05 F8 87 2D 10 -> D9 05 A0 89 2D 10`
- soundvoltex.dll: `0x1211BB: DD 05 00 88 2D 10 -> D9 05 E4 86 2D 10`
Allow ARS (Alternative Rate System) Option (At gauge select, goto excessive and press BT-D to enable)
- soundvoltex.dll: `0x171274: 74 -> EB`
Non-effective rate gauges start at 0%
- soundvoltex.dll: `0x11ACD0: 10 27 -> 01 00`
Non-effective rate gauges do not recover
- soundvoltex.dll: `0x11B14A: 01 50 48 -> 90 90 90`
Remove combo/chain display
- soundvoltex.dll: `0x1220B1: 8B 45 08 -> 90 90 90`
Omega Dimension semi-conversion
- soundvoltex.dll: 0x358B40: DC 5F 30 10 -> 38 54 30 10
- data/sound/sys_sd_ver04.2dx
- sys_sd_ver04.2dx: `0x4C: 0A D5 0B 00 -> B6 1D 52 00`
- sys_sd_ver04.2dx: `0x5C: D2 6B 3D 00 -> 28 10 68 00`
- sys_sd_ver04.2dx `0x50: 7C 0E 15 00 -> 9A 01 7A 00`

39
docs/games/sdvx4/problems.md Normal file
View File

@ -0,0 +1,39 @@
# SDVX IV Common Problems/Tips
### Hardware Specs
!!! tip ""
Bemani PC Type 4
CPU: Celeron M 440 1.86GHz
GPU: ATI Radeon HD 2400
RAM: 2 GB
OS: Windows XP Embedded
### My Game Is Running Slow/Lagging
!!! tip ""
Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.
### My Game Is Running Crazy Fast/After Finishing a Song Loading Is Stuck
!!! tip ""
The most common reason for this is the game is running over its required 60hz, the game is hardcoded to run at 60hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60hz. You can always check on the game's monitor check if the game is fluctuating around 59.94hz, the NTSC standard. If it's not around there and your monitor is indeed set to 60hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.
### 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 (-). Please note that Sound Voltex IV's offset is *purely visual* and the game does not have an audio-based offset adjustment. Sound Voltex V however, does.
### Running the Game Windowed and Borderless
!!! tip ""
Some players utilizing windowed mode use 3rd party software called [Borderless Gaming](https://github.com/Codeusa/Borderless-Gaming/releases) in order to achieve this, follow the program's instructions accordingly.
### Where Are All the Navigators?
!!! tip ""
Many navigators are locked behind network requirements and they will not show unless connected to a network that has written support for the events that they're typically locked behind.

79
docs/games/sdvx4/setup.md Normal file
View File

@ -0,0 +1,79 @@
# SOUND VOLTEX IV: HEAVENLY HAVEN
!!! 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.
Lastly, for demonstrative purposes, this guide uses SpiceTools, you should consult appropriate documentation and requirements of your desired tools as the setup process is likely to be extremely similar.
### Getting Started
!!! tip ""
This game still uses DirectSound so we can skip audio related setup needed for other games. 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 desired 32-bit tools inside the game's `contents` folder, and to create a `.bat` file. Pictured below is what your folder should look like, feel free to name your `.bat` file anything you desire, for the sake of convenience we've named ours `gamestart.bat`.
<img src="/img/sdvxiv/1.png">
### Configuring Your Tools
!!! tip ""
Now that you have your files ready, open up your `.bat` file in your desired text editor (we're using [Notepad++](https://notepad-plus-plus.org/)) and edit it with your desired parameters, for the purpose of this guide we will demonstrate both a local network configuration and an online example below with SpiceTools, skip to whichever you're in need of accordingly and please keep in mind you can add whatever additional parameters you desire.
!!! warning "If you're not using SpiceTools:"
The overall structure of your .bat file will differ from the guide, namely the initialization of SpiceTools won't be present and potential parameters may differ. As stated above, make sure to check the documentation of your tools to ensure you're using the correct parameters for your needs.
### Configuring for a Local Network
!!! tip ""
For our local network configuration example, on a single line in the `.bat` file we're going to type `spice.exe -ea -w` and save the file.
What do these different parameters do?
- `-ea` enables an integrated e-amusement server within SpiceTools.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/sdvxiv/2.png">
### Configuring for an Online Network
!!! tip ""
For our online network example we're simply doing the above but with different parameters! On our single line, we're going to type `spice.exe -p XXXXXXXXXXXXXXXXXXXX -url http://yoururlhere.com/ -w` and save the file.
What do these different parameters do?
- `-p` takes your PCBID on your network of choice, simply replace `XXXXXXXXXXXXXXXXXXXX` with your PCBID.
- `-url` allows you to specify a custom service URL to connect with, simply replace `http://yoururlhere.com/` with your chosen network's URL.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/sdvxiv/3.png">
!!! tip ""
One final note, since you're playing on a network, you will have one additional step of setting up your card file within your chosen tools, make sure to check your server's information on how to setup a card file.
### Final Steps and Setting up the Game
!!! tip ""
It's important to note before booting the game that Sound Voltex uses portrait mode and attempting to boot the game fullscreen in most landscape environments will result in a crash. To alleviate this, we must set our *main* monitor to portrait mode and be ready to rotate it! To do so, right click on your desktop and go into `Display Settings`, then simply set the orientation to `Portrait` as pictured.
<img src="/img/sdvxiv/4.png">
In the event that you do not have the means to run the game in portrait mode and cannot rotate your monitor, it is recommended you boot the game in windowed mode. In SpiceTools, simply add the windowed mode parameter, this parameter is `-w` and can be placed right after any other desired parameters chosen in our `gamestart.bat`
With that, you're all done! The final step you'll have to do with your chosen tools is simply setting up your desired keybinds! Once you've done that, Boot the game with your `gamestart.bat` and the game should load and be ready to be enjoyed! 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.

78
docs/games/sdvx5/hexedits.md Normal file
View File

@ -0,0 +1,78 @@
# Sound Voltex V: Vivid Wave
!!! warning "Unsure how to apply hex edits?"
Check out the [Beginner's Guide to Hex Editing](http://www.bemani.guide/extras/hexguide/) for assistance.
### List of Known Edits For KFC-2020122200
!!! tip ""
These are included inside of SpiceTools now by default! Check the `Patches` tab inside of the overlay and apply whichever you desire by clicking the check boxes and hitting apply.
### List of Known Edits For KFC-2020011500
!!! tip ""
Boot Into Event Mode (Not compatible with premium free mode)
- soundvoltex.dll: `0x4C4830: 33 C0 C7 41 08 64 05 00 00 48 89 01 C3 CC CC CC CC -> 31 C0 67 8D 40 01 C7 41 08 64 05 00 00 48 89 01 C3`
All Songs/Difficulties Unlocked (Do not use when connected to online servers, will break automation paradise favoriting)
- soundvoltex.dll: `0x4D2D75: 8B 4C 24 34 E8 C2 09 00 00 -> B8 03 00 00 00 90 90 90 90`
- soundvoltex.dll: `0x55F4A2: E8 C9 A2 08 00 -> B8 0D 00 00 00`
Infinite Premium Time
- soundvoltex.dll: `0x2F4A15: FF 15 6D 5B 38 00 48 8B 44 24 30 -> 48 C7 C0 01 00 00 00 90 90 90 90`
All Songs SAFE (You will not be forced out of your session for failing a song)
- soundvoltex.dll: `0x5E2424: 06 -> 13`
- soundvoltex.dll: `0x5E2433: A4 -> 00`
No Safe Banner on Jackets
- soundvoltex.dll: `0x4FFF2B: 07 -> 45`
Enable ARS (Alternative Rate System) Globally
- soundvoltex.dll: `0x5E2A3D: 85 C9 74 08 -> B1 01 75 08`
Freeze Non-Premium Timer
- soundvoltex.dll: `0x406C8D: 8B 53 68 -> 90 90 90`
Non-Effective Rate Gauges Start At 0%
- soundvoltex.dll: `0x52E535: 10 27 -> 01 00`
Non-Effective Rate Gauges Do Not Recover
- soundvoltex.dll `0x52F003: 41 01 41 6C -> 90 90 90 90`
Skip Global Matching Screen
- soundvoltex.dll: `0x726A30: 4D -> 4E`
All Appeal Cards Unlocked
- soundvoltex.dll: `0x4D7E22: 16 -> 00`
All Crew Unlocked
- soundvoltex.dll `0x4D890B: 95 -> 91`
SSE4.2 Fix (Allows the game to run on processors which do not support the SSE4.2 instruction set. If you can successfully boot the game already, DO NOT USE THIS EDIT!)
- soundvoltex.dll: `0x25280D: F3 45 0F B8 C8 -> 67 45 8D 48 FF`
- soundvoltex.dll: `0x26CCC6: F3 45 0F B8 CA -> 44 8D 4E 02 90`
Bypass Camera Error
- soundvoltex.dll: `0x61FBF0: 74 24 -> 90 90`
Shared Mode WASAPI (Replaces the first audio device initilization attempt)
- soundvoltex.dll: `0x638EC5: BA 03 00 00 00 -> BA 00 00 00 00`

58
docs/games/sdvx5/problems.md Normal file
View File

@ -0,0 +1,58 @@
# SDVX V Common Problems/Tips
### Hardware Specs
!!! tip ""
Bemani PC Type 4
CPU: Intel i3-4300 3.5GHz
GPU: Nvidia GeForce GTX 1050 2GB
RAM: 8GB DDR3L PC3-12800 (4GB*2)
OS: Windows 7 Embedded
### My Game Is Running Slow/Lagging
!!! tip ""
Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.
At the time of writing, some individuals with more than capable PCs have had framerate issues, most notably with Ryzen CPUs. There's really no fix as the issues seem largely random, but it's worth noting regardless to consider trying different computers if you have them available.
### My Game Is Running Crazy Fast/After Finishing a Song Loading Is Stuck
!!! tip ""
The most common reason for this is the game is running over its required 60hz, the game is hardcoded to run at 60hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60hz. You can always check on the game's monitor check if the game is fluctuating around 59.94hz, the NTSC standard. If it's not around there and your monitor is indeed set to 60hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.
### 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 (-). Sound Voltex V has two types of offset adjustments, visual and audio based, so be sure to fiddle with both to find desirable settings.
### Running the Game Windowed and Borderless
!!! tip ""
Some players utilizing windowed mode use 3rd party software called [Borderless Gaming](https://github.com/Codeusa/Borderless-Gaming/releases) in order to achieve this, follow the program's instructions accordingly.
### Where Are All the Navigators?
!!! tip ""
Many navigators are locked behind network requirements and they will not show unless connected to a network that has written support for the events that they're typically locked behind.
### A Note About SSE 4.2
!!! tip ""
In the rare case you are running this game on *very* old hardware, SDVX V requires a processor supporting the [SSE 4.2 instruction set](https://en.wikipedia.org/wiki/SSE4#SSE4.2). But, in the event your processor does not have this, there is a [hex edit](hexedits.md) available to bypass this.
### When I Run This Game All Other Background Audio Is Gone! What's Going On?
!!! tip ""
64-bit versions of SDVX 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 [Shared Mode WASAPI hex edit](hexedits.md) to deal with some hardware issues, it can also be used to hear background audio outside the game so that the game does not take total control. Many have reported that this edit only works when the audio is set to either 16-bit 44100Hz or 24-bit 44100Hz.
### 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.
Alongside this, many setups have found some difficulty with audio due to various equipment being used. Consider applying the [Shared Mode WASAPI hex edit](hexedits.md)

85
docs/games/sdvx5/setup.md Normal file
View File

@ -0,0 +1,85 @@
# SOUND VOLTEX V: VIVID WAVE
!!! 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.
Lastly, for demonstrative purposes, this guide uses SpiceTools, you should consult appropriate documentation and requirements of your desired tools as the setup process is likely to be extremely similar.
### 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 `44100 Hz` and check both of the options inside `Exclusive Mode` as pictured.
<img src="/img/gen/441.png">
!!! tip ""
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 desired 64-bit tools inside the game's `contents` folder, and to create a `.bat` file. Pictured below is what your folder should look like, feel free to name your `.bat` file anything you desire, for the sake of convenience we've named ours `gamestart.bat`.
<img src="/img/sdvxv/1.png">
!!! tip ""
Why does this look different than the usual? This installation includes a `modules` folder that Spice automatically detects, keeping things clean and simple. If your version of the game doesn't have this, it probably has the `contents` folder populated with many different dll files such as the main `soundvoltex.dll`. You should still place your tools here if so!
### Configuring Your Tools
!!! tip ""
Now that you have your files ready, open up your `.bat` file in your desired text editor (we're using [Notepad++](https://notepad-plus-plus.org/)) and edit it with your desired parameters, for the purpose of this guide we will demonstrate both a local network configuration and an online example below with SpiceTools, skip to whichever you're in need of accordingly and please keep in mind you can add whatever additional parameters you desire.
!!! warning "If you're not using SpiceTools:"
The overall structure of your .bat file will differ from the guide, namely the initialization of SpiceTools won't be present and potential parameters may differ. As stated above, make sure to check the documentation of your tools to ensure you're using the correct parameters for your needs.
### Configuring for a Local Network
!!! tip ""
For our local network configuration example, on a single line in the `.bat` file we're going to type `spice64.exe -ea -w` and save the file.
What do these different parameters do?
- `-ea` enables an integrated e-amusement server within SpiceTools.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/iidx25/2.png">
### Configuring for an Online Network
!!! tip ""
For our online network example we're simply doing the above but with different parameters! On our single line, we're going to type `spice64.exe -p XXXXXXXXXXXXXXXXXXXX -url http://yoururlhere.com/ -w` and save the file.
What do these different parameters do?
- `-p` takes your PCBID on your network of choice, simply replace `XXXXXXXXXXXXXXXXXXXX` with your PCBID.
- `-url` allows you to specify a custom service URL to connect with, simply replace `http://yoururlhere.com/` with your chosen network's URL.
- `-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 contents of our `gamestart.bat` file in Notepad++.
<img src="/img/iidx25/3.png">
!!! tip ""
One final note, since you're playing on a network, you will have one additional step of setting up your card file within your chosen tools, make sure to check your server's information on how to setup a card file.
### Final Steps and Setting up the Game
!!! tip ""
It's important to note before booting the game that Sound Voltex uses portrait mode and attempting to boot the game fullscreen in most landscape environments will result in a crash. To alleviate this, we must set our *main* monitor to portrait mode and be ready to rotate it! To do so, right click on your desktop and go into `Display Settings`, then simply set the orientation to `Portrait` as pictured.
<img src="/img/sdvxiv/4.png">
In the event that you do not have the means to run the game in portrait mode and cannot rotate your monitor, it is recommended you boot the game in windowed mode. In SpiceTools, simply add the windowed mode parameter, this parameter is `-w` and can be placed right after any other desired parameters chosen in our `gamestart.bat`
With that, you're all done! The final step you'll have to do with your chosen tools is simply setting up your desired keybinds! Once you've done that, Boot the game with your `gamestart.bat` and the game should load and be ready to be enjoyed! 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.

BIN
docs/img/ascs/L-tek Logo.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 7.3 KiB

BIN
docs/img/ascs/Stepmaniax Logo.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 5.2 KiB

BIN
docs/img/ascs/cotton.jpg Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 592 KiB

BIN
docs/img/ascs/dao_comp.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 112 KiB

BIN
docs/img/ascs/daopop.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 206 KiB

BIN
docs/img/ascs/fb9.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 133 KiB

BIN
docs/img/ascs/fp7.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 110 KiB

BIN
docs/img/ascs/g2.jpg Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 11 KiB

BIN
docs/img/ascs/ltek.jpg Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 72 KiB

BIN
docs/img/ascs/smx.gif Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.6 MiB

BIN
docs/img/ascs/svre9.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 166 KiB

BIN
docs/img/ascs/svse5.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 165 KiB

BIN
docs/img/ascs/wan.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 175 KiB

BIN
docs/img/ascs/yuan.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 23 KiB

BIN
docs/img/ascs/yuaniidx.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 243 KiB

BIN
docs/img/ascs/yuanpop.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 242 KiB

BIN
docs/img/ascs/yuansdvx.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 329 KiB

BIN
docs/img/bst/1.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 33 KiB

BIN
docs/img/clan/1.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 26 KiB

BIN
docs/img/clan/10.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 11 KiB

BIN
docs/img/clan/2.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.9 KiB

BIN
docs/img/clan/3.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.8 KiB

BIN
docs/img/clan/5.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 18 KiB

BIN
docs/img/clan/6.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 17 KiB

BIN
docs/img/clan/7.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 16 KiB

BIN
docs/img/clan/8.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 9.9 KiB

BIN
docs/img/clan/9.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 11 KiB

BIN
docs/img/ddrace/1.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 44 KiB

Some files were not shown because too many files have changed in this diff Show More