From b2e0209976e9f1ee0dcfd5b0eb1492799dc4d83e Mon Sep 17 00:00:00 2001 From: <> Date: Sat, 26 Apr 2025 07:49:13 +0000 Subject: [PATCH] Deployed ce7fc1f7 with MkDocs version: 1.6.1 --- extras/asphyxia/index.html | 12 +++++++----- img/extras/asphyxia/5.png | Bin 0 -> 10929 bytes img/extras/asphyxia/6.png | Bin 0 -> 51852 bytes search/search_index.json | 2 +- sitemap.xml.gz | Bin 127 -> 127 bytes 5 files changed, 8 insertions(+), 6 deletions(-) create mode 100644 img/extras/asphyxia/5.png create mode 100644 img/extras/asphyxia/6.png diff --git a/extras/asphyxia/index.html b/extras/asphyxia/index.html index d83cf003..6a8fcea4 100644 --- a/extras/asphyxia/index.html +++ b/extras/asphyxia/index.html @@ -6906,14 +6906,16 @@

Setting up SDVX

-

On the WebUI, click on SDVX on the left-hand bar and click on Import Assets. In here, paste the path of your contents folder.

+

On the WebUI, click on SDVX on the left-hand bar and on the right side under Plugin Settings, you should see an option named Exceed Gear Data Directory. In here, paste the path of your contents folder and press enter. In my case, it looks like this:

+

-

In my case, it's D:\BEMANI\SDVX\guide\KFC-2021083100\contents. Make sure you're using the correct path as it won't work otherwise. When you've done that, click on Submit. After a few seconds, a pop-up should appear saying Imported successfully!

+

Next, click on Update Webui Assets on the left-hand bar. Make sure you're using the correct path as it won't work otherwise. When you've done that, click on Update and confirm that you've updated the datacode in your ea3-config.xml file. After a few seconds, the text console should say Done and say Successfully extracted textures if you input your path correctly.

+

-

Go to SDVX on the left-hand bar, then Profiles and click on the green Detail button on your preferred profile. Click on Setting on the top bar and try changing some customization settings at the bottom. If they are working, head over to Changing Service URL. If they appear broken, completely close Asphyxia and continue reading.

-

Head to the contents folder of your game again. If you have inserted the correct path when Importing and everything worked without any errors, you will have a folder called webui. Copy this folder and paste it into plugins\sdvx@asphyxia. Overwrite any files if prompted to. Now close then re-run asphyxia-core-x64.exe and everything should function as intended.

+

Next, launch the game and card in. Go through the process of creating a profile, then close the game. After that, go to SDVX on the left-hand bar, then Profiles and click on the green Detail button on your preferred profile. Click on Setting on the top bar and try changing some customization settings at the bottom. If they are working, you're done and everything should function as intended if you set everything correctly.

+

If they appear broken, completely close Asphyxia and head to the contents folder of your game again. If you have inserted the correct path when Importing and everything worked without any errors, you will have a folder called webui. Copy this folder and paste it into plugins\sdvx@asphyxia. Overwrite any files if prompted to. Now close then re-run asphyxia-core-x64.exe and everything should function as intended.

Setting up IIDX

@@ -6942,7 +6944,7 @@ - April 7, 2025 + April 26, 2025 diff --git a/img/extras/asphyxia/5.png b/img/extras/asphyxia/5.png new file mode 100644 index 0000000000000000000000000000000000000000..ce05d2aeea9ba2e6558a00cc836e52027b78fe23 GIT binary patch literal 10929 zcmch7WmHsQ+b&WLLw9#~hafd{$I#uf(X(QXXE>Q zYn`9xob|2q1BShs{p{!N>%Q(MN?TJ28%zO4LPEk;QI^+5LPDVd{!RiR1Ha{aV+?_h zC!V@W5Txp_RQtdM>I+#7StO*o1k77&G~gQJrLwUn5)w||Sh-iVB&M>aub2?B!O@KIaikm&=eR+G@F&so3L$hqWU)xmxOKM+gCfHmGOROB z^4?i29_P#rtp5ENW*32a8lbT=-nMpm(=oa9_Ymu5T3Gr%4_~_dy!k}9ucrO9oPO=^ z{bkM7>gDaO^uzUJ;QgPxhg-uRxFcaNAyV{(iMpV2+IvT_z);25+r>E1)!V@8j)Q2< zYBJYY{y{R^Hmp+&d{_!ZTg4o^&Gz=e#E{$;_=gv687J!8Z(7TQHVUu1^9NgV`^T@( zxIM0yx8n0h_?v~O<3cShya!k$mcQ7Pu5@tKcc@AD!Fvif97m(?-|Fh0WwciUhRlWg z0tNOCXm9DT1^<101zA@3{wqeB!M`i!p!~K!)lq$cu1^1Xi!Gj>_uVm*8t3CyG6?n( z4ZfM0{M*+V(SO}U)HVt{KFp5&e}03_*rfAxl+%>(Ws&T^7o&tH!RI#mBD&SSd_dQC z_}=WMO6BO{;^OM6cj!4OsWe<~Kel~D11(l}a(2#o=IL;7EU+~g=i=n_%yS3JP0ah( za)De#ZotjHP_=-tu<%$qFRRCa)+l}0%Xbkt)NRgl<-2)-78Z|Um^q}-Rk3Jfh52Xl zS@$ltdcqZuo?0MBG00|}`Nz{ps*c|Mz5JPv`88KkZ8(~kGg2XBeFqxVK6G>blRa#5 zc1^fgD=+>d!`5o2-yGk0MQiIb4V~cd@No5PQIA#i;mv`VA5~RV@a_3|gLiR&tvoYz zLK>I4-b)-5fSHt&a}$d66RCqhjN7wi&=$211}k!s?B@n$}s>6uv1eh@qArMI51GzJfSK!1NpjRAHGR5YPyF{rW70GT}T;Hr95 zTlSes@7v!Y%YK)?1~j-GKcGCtQI6j$<+23T(KB20Yv>NXt2C;Eu$!8g;K3LbW0e^R zyxQ^T73d}29)78MIz~ZBnLzanq9_$*Qg5dMh0cs5vtkq|h2=+V#_M@#rD|$q39-)v zg+9gQNPmo~o3vb2&eF27o&ywTI&9TMv7q00-smb7SZv|sf)04!6`bIuf-k=2j}tX{ z?rK6fR5(GC0XgDtz`Pr$gNe*iF!5KL{g}KR`D`m&m_usk=jT4O0aw<`uih|t%JKbD zPQ73&*DYbg78TIb!SYbNeT4}M@WrEM# z^is3icOv)4=l7g^%;#*zyzVIIw6_dwW_ZzLY~3WNewt2YD74`^$}9nEd_^{AiOlFLru_o$t2){q6ND%JR=8swJSFxUbOf0U za&!uCP9Y`u!c`|mQ2z8!bhg&&YWKCS_ro{}*pd&DXuj2E983?VXq{IwuHT#E&|_(( zrOv&z0k>IL@Ht%IPgSAt8gF!(LF{e+zzk!%INP6L!WmL))WC(nqVe8Rq@Dl#wrkm? zT_&k7F6=O#aiww6KX@D{`e+DR-H^uU*8D&(C<&k?oKbWj@RU$`Uwva9wO?chRI*cF zV&^o+`jC6QH~r}`PP1>J6f1NR-oMP?eYI+^v3lrZgxhP4Aj-8efIN18_ZOc5LEFL` z`Z?J$E$1<-^7!#Q{jXH4_5YA(|0f@bdr+;QH?)+zist;^3*5IOX;giVDxj2=Tla;V z`yDk21N#P~N0ybRhvVs$HQuaVb_f1QHN+tgS@>5e_({o zrT3gwh~1k16s*ht$<6;?)TaNp*Yep7C+d7sjC*tqbg~TTSSx27wI0N1ZIO{_UpO|U z9Uv4IA73C@kHB0iJXN;V^s&5?*IJ?S!^(6HpQRa~H|6s10E%;v31L@{vze@G6!=$_ z(Z$jXiq*NQ9v67YRi&P3^jLt&*Nsdv1%U4ik_mnRKJ0BC-NYft*2#XfA2AB}719u5 zG$jh23Pk>scz7y%a(&U+6(|ls)Zr$=Mu-wVZ$WYkcj*-Pg8wfem&OexvK}u zS2UqCB+3wWAtA^71iIbH_Sl)oX7$)9TzcPr{(74~~b`u@X`9Epj-cOrdwf-2qpX?pimhYytCI=$40!>)#$pwzpk4A@*_Vx$Qa`q%13mY(MUj5JX-G7#9(# zFD?$pZ@FCcyF6SZRAU}g!f4bbL^+yHhsnqr7v_%Y%BMegJ<hi+-xX{SN`?z<4S%CM15Q)-Jq<5R$Im7aZJEU5my&wZHbt{rMIpjb|mo!?};jTd~YJ8Z#Tv> z1?!e0dgHaJgOx?g^DkDv%ap=jZvMxY(hQ6h{~^CYc=pXxTz5yu^`*qUOac2*px&G$ zT`ttwdhUMJ&jLcRt^`k+XbmwKOaAFM0H>=>npAf;h{n##URtsL{2gVqoLV&3_U0#O zt=?YkfVWVWTj*13YbIWAFiAY6sHTpqsn8oBAy@`nGwU!xeQ@{nOim_}eE&GGd?D3t z=A%0FD#B_v+PFtMk&2P}{@KG4@$DFg<~iA~lJ%)hB=GIkR>I;k@jVdY^jhT60DA5k zAP6z+8-B5{$S(b$f6gF-V)KgpQfTK(Fp8`=U#(Zz@x0f@&zf!=QOh8(cycDFOt#kd{0=j5B3cNvV%;;-Fj8hKMsoC1wT%S!0G^yL)ed^4Lurxdcyg7H;(0++0*Q$Spa$Zs7fHjyD5sI*<8iB+N75w0;f&^}SrMP1v9jb|&Hs zlhsC!bc-dy9SxUlKWhF?_C$4u!aAQV?-k~JNQyixDGKNfSvIl+M9zS|U?%s+Sb9Wn zu&?cRV=?bce5>LX-96F~A_BQl$Of@@c}zuQ_%x|FF>-LM-4H%086&fvk1dR5U<-?@ zHy>rsP)#jnnY@=xzg#bo1u7NRkvbLfg1LWXT)Wd^O6FCaww}Mh*&wAy?dPIghW`Yp zUA1^Co{gi?dG=1ug-(S28IkCO18j`@l-m0J>y5Cuc+?Yg$krdj&BvN3u^+o%owpM(+->|XNXlPZUFyn^G2q|7E8A+zYMu`G6NJ%um6$15&l4e1Q$5?%B6 zJm`+BWsKnF{pEx;k!Jj(orUoWP1VbVMyKQpZv|LQZE&JtzlfsWs|Ei>XF-cher!!M z0di&vA^W<4!Z1Er@<(&wB_LUG^C>XxfbD0xAMXFoM1G9JD21B!wzStrL;3`Uo)z5s zqzLFaqbTsJin9ids}D52$me(YRz08t*UkTM@*E5qCXl1te7Yga3fl-`N;sIvAKFGq zczy~BrWA2izQcfNL{FR9S!oiR!cS7eD|F+w<5=w{b0s&ElQHV|q_#kQKduX15r^oecN+OyWj+$we&(nw( zr&yV!AxgG~;5gqV6LtSMOFYK!$f80xQb`7T@kLYSAd2qQFaaj}nKp~Oon}?BdSy`Z75(EAv_C{*Q2VEcaj!B!ah1rE1QZ6IB z3*mk!;`q;$$dKZA{3pAhvc43WXRo(`=KbymZ(wFP3*Fb7ZT?9kvq8x?*&*d0wJR@Z zGVI;>g2cR_>cRZvE=A`0p~+F@+d0oXi^GK!kH)o(pRdflf^F(FSFmJpXz zQ{f3m;<3(2n8AUqMNO^SV2O5S{FJMRXAUtMncajfpntdM*fQ2&=AP2cVJ)6HSV8;> zQM_pA!I3Y0t>2~lPP|%ub8|DImv64Fkpum%U$I8$@Ef?2r>e!Lg#ek5RWoJp*}GFa zij=9TDZKiAh^j6-Z&k}GXj0k*PViE%49#3Y&&8zzd5eRo3i55V5b88QGxQa4J|;|M zVpZo@i)_nh2*jegWGMQ|+wX25#;zFX*cflOI>>MS?{RmYyB~&if+ zC5`O>DB><#rE^?By~Sy;x6v= zmPTcmW?mDZ?NK2tQN$B96-Dj=pA?(fwFUH{z4r`WtYU~rDc|{M8*&mo#`8jDa5{-z zjp$cOu-@!I;CwU}`5T6eW!3$5fo9jk{v92QVec?W)=#O6GD5PQ+*MZ$ITm5mj^=MV z@p`<~>VHcTN(}227Zi^fnGoZ}R~l5A4A>)ywI0j`jYuc$+HS@NKA+@T#V5wg@0kT(O&_n zwf|DaxUZmb+`?>RY*;S~Sup{js|9(!u8%G~o-+mFW4!hzRasCmnf5VBYW*O~6Af0Z z;H+R<;|r&LBCA*x0a2@rJ|!edR$mvP2yM~~B@ha~o|ZW}nS&J9)gojv;xqh}kj3LL z$FlJwJ>C!M)ujLGXSGP7Bj@ng2%>BE+ae7)fh7h-eTyFBpg76)(7m!5p}{pHH7W47jFnI3xfWIHB+ zUO5FP0JOmnOpYNIxs?5Uuv(4|!A5na-WK5b`Q-+ru*j;`B8+fM^dEzTxshK8GIV<9 zgeLAsmu4Q@FT(>FE<{arwkBk~1xkJxVGQMsfyt9^d~px!p}1!a?=IMzi6M=I0||8~ z&B^Z0#}3~4E+?ijUH3OGgYxWsp}X??&$RC@G{QZBrWAF4b~ceZsx1A9L-TQh^nFGe zT};`px*;0IbeaLYnvPS|gSHl+I-3&R7+s0eh7q9<(AeUBDlfg-SWITsil-1(^*aG7 zl$tLxbC8x++}Ipv!`6x#O0vJU!4iz+gfb^!uu8EDWSod*0AZoUOWx3*q7wYM!) zzXf8?V2N}ffmDa#@%UkHc_MIG>;hP?ESc1OsZ6fh?vX+%*?C zp$mFzb8}i8{3XQJ$cLPoYtw@WMqQAAg)^cX_?icvM?zu|rEAOehD3xjS&h+d@-d%e zLi}rt8x-C1Nd_%pe@50DJ`t>*L+%0ABZA$QwLmD`P^b7OmYI|OzT06eNbMsmqxh$` z$jyYg&j|8*q-7VL#puhMv;DzA#T@#RC{vR-mu#UTJra3J%OMQbG-k~?vEC7A`1tn) zm8dqGPy<)E3FsR-wpruE#6*7~byQ&}YJE2oT8g4!5wV@c^Ee4A<(K3QCBxjkb=YAg z8Nv5SM%gV^yUuQI%+b{Y-Q+u__3ncB3U68THWoaNBp@TR9AMm$emPvplr|n7S+mgq zRFECz1l4vTmhmT^shROH(#_H-39KY!fJyE3bx837ot=*H4r!ep41F(Sy_`o^l;V<} zO;Dt12S>=$S6g>WDvY`JFSsqIz=HS12m_;ZH% zci_*AC`M8@3}q8nj@)Rab+v`h%?8Ak#*FK6B87^y%vC7rC}+;QN8A9f9e+(v8y?BCP z1Z4z&0ho(F;7TrSX-QHUIFU`*BbBn6_&6^aXMVgO{5SSMp;F_7vi#2yHUOW5O)0`< zZua;tBoxNT|K^3{!m(tlOwAu@pdhPzzL1RGS+)yc11MbVs1hz?0R2X;ZFN67t3MTi zaGowySj(9NN)3?I^`X$@;!^NP8n304`*O?dnmrD!)W`YsmpkK`0IeVmz;maw^&Ws6 zf|E~5KlmT;hL+?7h*$SMGJ5H(@7byndD*go*mpky2$(oLsS@?fB$je@IXRRlcBXUh z%(s%~E8gvIk96UC@7fBIG8m`&Erjhh~rh@4(f$@Bl9mGl)lr+j1xU&ANia~DV7 zp@F>za}^lR{jXjg)Wp_%o0@3kNlBjL(mZ!x7AtE5niRM!9AZx7{*MVYyFU|kLSxm+ zWx72Xq8*a7A5BS1O9ME3yw|^$TLHdkc6K(F>e(rPHo{PW)s;4HZf=N860;g;xjRtWeU$YtAY(b37Y&zDt;|FzFuB1t{p_w!srgZi|HW4-IO;Mm zL1OqgznLN8w)8be;shN;D;?1B>sh(XXhGvkO0R)v;-Z3&yxq4+3p+bIZr_`yX-wd# z0JxCJQb}fk2LQ4To)O*@G%j_#6Wn0KS}p~r3<1L=>Xj zw-uZ=<~&U-{ZG)`y>bhkot+gEXyO>5`5k~!Qqqw1DCpJFxO%vq6qF;e_kYYiG4&A` ze{`U`$bbN6*h?oTr|D4bC(L7NoI(?IwnJZ;CyQbr8}QQD#)Gq24iNQRwrppjL=l!9 zI7KW*qFU(`p2k!aB1K3Wc*`G*umFiI?Y9R5F`*tE~4$9bin;0?hKbj)C#t@2>NC(^L0_+9w{QaQz+9kU4m2*fih=(7@MQ zTHH*SI@gpTk=(s~RqCmhci~owCcy|Q>41+~w8rP6ESev$ZhqE$3W9c%`v6oVH=xKr zyOUaX%={j!&(r3$0&iw!J!1DC&RQEG)ED0x)37Z_{Jf(KUA__$cWoLR2_ZJB*l}6?(lrtVwG- zsm7UO_{25|J+(iEx9jSG;O+713If644FsePz$#n-+)rxdrO#2*H(f(Cpy#*-Hhv3G zv&63pI)3+JcE0%dt7R+xaxL&--qd4))+lXQE8vu{%g6EUl_J02g)6c#Yo!ocz|}^C zN7psW2q^HNtmOWzM4I{f9&?F$Wzx#x&78i|)Oruo)~Sjl27nr^$&u`f@jHVYM8cc7 zExSH;g)Pl}3i#Ue&7$3YEDfO2YSA4%ae4DB?+y%o?fDxTTo>yF9-0C@Rv393J_ zO*P zp8qL^J5|3fuRFX%G7~xP-46LmCNVZP_T{pt)`3bsuiaC`%n-nt*WE=5JQL3ne^ZWl ze$r2P4LL;-czbAc&i3|&Z;8>DZ0T;5l(}~$(Ag#c?@|fTVM(mxXcYRtwr+4z=^DQk zcmx-Y*+gXfBjZ0Gp z#VoMBbtq>TTAvZD6-n25+Zf5q?3lkml1tCtFi`lE%N(-$ZZ`)=#~*SFd&?}~sgtDi zzKuY)IIszf-dHwdv$h2ZAl%?qfc^fiwjX4H7th$>E{K_sc=g(4GBc5uWZ1CeQ;!(- zr*gBDNyit?xY|-MHu#QYplq47ot~4O_1(}V-X7*R5K47xdSV)x^JTPN!TGrT@2~bnLSjy~;3NINQX&DX9q+`H)#>~g zegU0^A?v%tY}c%maETgHj1uwGPq z@kYLcY7EI~%+;rI+EF4n-@S}`q*gF@8Z3^*z<2GOxzA>nzR#9wYQ9(-H7 zKCBlJhMfRk1ytc*Pm#`TT8!r)yD2A3o`kEj;7zQQlUYC!t-Nz}S@(6Y!>mWYc>+MWLg_ zOXg*grYlg=UTDW6?&&xR6 zTYr$`{7N+EJWzCpA66!L_E(qMt=_9 z*5YN9#ZSw;o#~;QVV9nt@r|=AmDCnHzQ&9W|6w|&A7qjg8iTAv*4V;my^Z+-`}8}E z{|-lulhEo9LXj%+(qN!IxgL{~Ny`k193f4jO`Kw6J2YozODxynxGt}=AmaI~Nu;c<=H*DwmS+~` zy3~jP`w;#XPs;{tqkgCbQ^VDeg+VZ=;I9o3)nWUF;d_-)H&vnG#Mn@fwO-W>qTVV;yirXD6juAM{a-6YaM~NI#01O zWvhkoH-t6|B4`+xQHC>0VF3P+;l@(fLtdPd6({(m@yHxT^R1$84rt5?u~a5vF+u5x z#)d2YiaBE8l(XB!-%>|B3`rU^VS{F3wm0TbRYKE+1hmv>~y0^#JKz?#NThz#BON>;-sOW@yZu5{KXE8>KkXA zI#~#5zBvC{ z?WFw6dJG)8`c`F1dWo5w*7{lDNJz!L7Z`=A@GKRZr6gn{{|Pk{!v{D!3qN48rhOTN zpI8IP;d|EU4PRy+4vil*cm5E`BNCHb31%J4%tz!@h=*TDk-2 zZo5Lx1eQn2w=`OMnyTm>y;Z@YZNG}~4Q&7<_|=!|F2{QngSv#X^ z0VF(`tk#pv4gfd^gS8>2T-AvYK$+Wf<# z)tH}pjr%szc{9|Ifadkob)`-C`R=rvDtrGK6;~ThsnnrQgAB#A<+c70ryQ>iIAO*L zn6(3KpQdDvj+o0t>kw_+e!{gR7;g4qw05tCO|NTZV(6z@>2s?KGXB<`|?$XRf zR{|$~M8H!wz`MG%BCZQ`0KD(S{mb26JvV0`Q#6-Q^Y8%Tp?hbn#-0P5C`D3H(3G!+ HScUvAX1=}6 literal 0 HcmV?d00001 diff --git a/img/extras/asphyxia/6.png b/img/extras/asphyxia/6.png new file mode 100644 index 0000000000000000000000000000000000000000..61f63b44bb0400b7eca850a91bf053d2814c5220 GIT binary patch literal 51852 zcmd?RbySsK*ETAll%#}$NOuVm64KqV=@JAa6r>xZyE~NbE@6|>-7N^xAuV0|Tj29P zzxO-u8RMMyobQkGjkAXiHtfCEz3#QC)w!-Ky>cszOxe!$r(O9($G9eTb6enEUMBq#LXK}7`GwZTL1JIW_XP1^?#Fxv0_ z!*yHb8-YLK*okS_saToVIU3j)Kaj97Hny}iwX)MwMFt<~Ly!^`f;j2z+$>r_G#fTh z;wQLDE=a`fN4e|;k{g) zrZ(exyO}AM`{aFe_j+BxsRao}_g40l%sYo7lm;yn$&QMh&NdipMuwX6DhJoNrq?!$@!j{9d!fySk*chAg( z7;VGup2?yaCRu{0*xqif?sw)^St zqsK$h&-<7Ebu}VJTcU%6&i?x;HgajKbN*rpNw~j1XRGpokKgtGJ@DJ4xz8<(diSHO zH?^|W!g>CCBJKMuwlwMlFo&%T9WqbYp}{kp8VA(mnI=4SEs zwB^ck@s?A)ZsVW9GN5c{o}OF7*K4S@o}Mk=2J}lKTc*qO9f#%DQ5|otj`vH)Bd2wo z_x4+^EktfE?@Q$am+imNA?%s434ef_nzWSdpp~$g=!@3}>_rSsEeC~jE`VTDKyfz-j<;xhb87ndjYj4S`G}?omc{Yc3nNuav(m$3OSfg%W)o~TJFS6KGvK zvHshY@woHg7QOocx!&MXA;FH`pmbP1&s>azzV_MHoplK^$-&CZN*%bVZE5C4N~H+@ zKMZnXWw|IgLH=4{td zCQ{{<%!e+F^`>NwU(YuPVBaLymoH%DN3SbSZvV0SFesy|X|hOX$@S!)U3PoGc6I~% zXUzXKE1tY+`^`oRD)3x!|8^;m80ekD`x8CnY3wOV_iyKtPi+hP<9Vuo?tAa* z#A5&Lul&u~2u40x4Q*-d#KUgv38E^x?p?35z^vF`uln>4+5bJ4`~TW|XHzF#_0pu- z+1XuN+&kEJ{8$daR*%zeRnY$W`ai7|Ap>z;H|nr${hLYfPXM+7yMFSocOwFKjv=$6 z_3Ljqzzi{GQ_r)3ZI|8B7yS(y14zOgNmuKc{+>5w?(~0yh1;hcX4|UZdtck-_WJ)M znEcl}>(MjXyS~2u?VG@&A08Iwez}!5Yw&j#9#*I1w)=}Mo>!+Ib1PU&lBoyw}yvY*j%)0i)I50JAUs&WJfQH1zuNcbRmS%f|Zpx7u3$7LTU- zdY9{S>p1;-J2PwR!{yG9iPe$uJOxZ*o@^1bm^9B@?!Nob7&?o99s~8f98Xis_q<*q zks2Nz23NJWx38(G`3bdsZ(;HKSF2B~ev=EHS4i+jD=UFdzrK%+;cO}Y=8}VyQup`w z({tS~g9#?P#`@8Z+1Ub7hhH%YU*EVo{8^X7>6uqA)9a*aoG#VX*4L-WppI@cw6#?U zp1qG~iEl>EtDp(Yy5v!D@#(kM*L)~O%+cz8f@&O-loFk#e1 z{CCMt1>YH2Udo`=!!K=)X7M0yiJ{>cTVB{>{N0mAw0(Np6-Qfjb@i3ZIr`dk)mUgc zb$2*%JMyD6e)r36fm`g7#^z?ri@%$^ZOp<(AQjAq-k0VrUcZUdIZ`PtqOZT$)#X2C z_5?K`Ab^g~c732oy(~YM=kFyZz=r-s8m#-=|8=|nAH$IUjfbivNa7U`5P0<}#@M0G zZfk6L*)aZMHAX?;=J<4XPFq{M3>fFh_T<=@vZG@yMw8n`beql8)YR)fi}*#aOLNnE zvz86p5nEqq@gzBM2JdCm_ui>`KO8H*lBqU5J+1JCN36c7iMTgpW{~4zJnhz(Sg*il;&sS7bgoU9amR2sW52mn7p)vgn6~@eD4K%r5 zah3ra)*PK)^b3^QH^{lsG&2_4SUTK>tk1b>+k( zOxOYDEbCtzHedN-#N2^bi_Vwgy3!R!f%5U=$A4baHD-?VgRDoJp4a@vxLp(S2u6Du zA_3pNeS5+0_LS`m+|XJ}wcr!jnD;#-oFyS7wav)OLuw^tBVcN%uh+V5fNmA&)FP}drR#B5zo1!jR)r3fFnfAYifGaPxNjepnZ9Hc_Yp9t1+S6`}gnp zM*oO(Tb*>V>#fVn$_@+V=5p0L zmF=7r@^ALINj`H}=yrP2FHO`vn8HPXk6$@}@rtTa7S2r4!obq9v_PTU>QwutA^m;& zQSw?*WvyrZ;@MzhS((+eXKzze)>I{~ob-zE-tJs2hyrQGsK4a46+ACh;tRaAK0Ioa zDk(0WIB|$USUh-nE3&TpIeRv~DAFKrMc9MgImV{T#5&nA~%V0E$|cpG8vR`qjEKzH{v z1rEE*i&5qK!h({8W-xWmLt{%b^u}@Wo*Sg8$*U_&k)rb#(~)QV-;j0%NoZU4c~?rW zo3Eb0koRf*KQ$NFm}8#)CWh<{8l(w%g@uI~Cpl8MlbHUU&YwTS0tx*i;u*s@Yww>~ z%&G-1XnC?EU#h{vCr&)8!79FCHzO5&iUd~L)m5Uzm@YYXy>EVLX$c&7>J+YUC=~j- zUAnh3gaG(_>E&sC&nAc6i3a zQB!qYWg>##TLuq3);s~T4yn*X`;K(ndh&dgYBp<;H+>9`>Aw+DTrpE22H^R{)X}4D zJyy%kw2JKzPw{BzejXMc-uK$CqWbd(r~KD>%*JsGUuUbi4f32dFrKw;+BJI#W1t9^ zWK~c*hiTA}+I5gSA8$sXK77@Wm0y6;Ic$gLezjYxbNd5YidZ$v~ zy2;+oj?d{pFpE?g)xJ~c;W_^4$>LxUJ=(%^`s9bVT#Ig1uV0B=b4&9bicVE~K*DCi zLqj2{in3;$<4JAuoe@#2a*FJ6LVNC?%hiLlM`32tqgQU7WU&&eYZdW@!x$%9VtLii z=n&MoPgMnO1lqLSa{04|)KRcAG&D8IMyIB7zd;g{lU=eHgU@P?BGrm>*M(fTbviXh zDZSI0*Uarz=c7A#nbcz_o zRM6yNp>B-g$K|w1*$7A&2W5Es)C0?ZHikjq>TJ}5+W1|>2pWvOijsWNr|^}px5c+l zB?a<=kdR!?7GLv%;8_mG!5sNprApCH4xC%D$(qLj@GAn1l298pCcftEb`|HRqk+5Vn zcA63qvC;47w;NjtHtSKQ6mh09tB0a8`G&sFJe~%;dOt+_8V~{9$b+msU0Ij{Vi3)w zZ0C(O}MyE zt1-%mN7cs?i48FBubY3>qAu5<_#FGHUW07Q9Bzto%2YU6eQfM`vfV>6$9);gHwQ4` zyyKpXa`AZesR#V|s$v>2LbP{$4m&d|-4V`3boy3@YTvseU;&sU)Hj1%iye)tkK)=U z4g>-PDg|D@mNeiYR_y%Xo1B!>8$+XDsG3*QwCs!D6!0=4w#Dp%bBjHPbG%?ch`S`V z6sJ~qvF20F@|D{t7QHz5Nwjq|O9sCs$>Ey`%i6ZO#S`gB&Q`$@{d`&3`~6vnp)$Lk zq=;6ImY{?|m0>Zm$2J1LiVAuXi*)&bQrA$*t2J(A&oN2yd5tc-#ch?sV?Qf;q&A`r z9s2m+Bs2?d$C#zCEM3R=c>!XSHq}FSMn7u%-q6@YLLsf$c~9v}j4rbJ?~G<82G5Sz59mKmMsxz(+XjDK}QK|vvn052Ah=wYJdCrC{F zRkV82X1b8xJGt=j54=qNAdTOQWetw|g?tiwY4o-Dqs+w+oEa(m?1e%}h+U=a#x=s&utSn}JEHbh`|e^@pN+dp+k$(R z0*N*S1cX}y-cDc!(E|%=R3^h=;s{hH)a^vBQc`+KBlPZEW87^L9zR%(+DecfkzdC5 z9h9}QwiEZ|_X(Iyu$zpwS$Q8$s-1aPSC`>s{*&=OEE{IJ>`-zygzYMmSowAg*%)~n zMVk6_;cPFCBu=uDGvnl6vZ=w6qZx^gd>wF5xj8#18@stllJu&H=-a|&7X}*PWFiQv z{c^QMq`U;Tn2F{BHbaSdPJxQG@T82TpHJVrD5Nd+D9H_~Ts9;JTxZ%~?XZ0F9 zG+bK72=mb^?Tek4`xWx9v&j@ou3`C?DV|D!8j+1LroXm~N7$ucj^0mMvdIRc)X*}^ z4U1QO;$yxenHdx28U!)XNo*_p@b&ErS=d$yzNG(g8{D@QQmcXokI}J-EPV1s>@Y|X z;!GlwAvK!f%#@W95w)Qmx<)ZntW8c zBsVuVZqnl$oPjoDTb?XdtjQnvEAvg#zc7BNEL2lhXO%=rYhPez_DLSa-jCaAp^cm* zqD3hgvax|dwgO4xsU230`rfCxtBv*od}Pdl)7LIzK=`cECfYGrIb<>M>(|^=N4E=c zj)_ot>%+24&z1>@;M`NE(1+xtVpZRjLdW~p`V%fRG|i9kp>=R_ZTyir@L<~|H^d&r z`6mWu8e>_pyI4(X`!K(BI$G@wBjP&e(=F6M{+V-|#}LyDL7s_7hO#ajXuW#>QXBX2}JD&95*<(2$W<$HmbUQ5!)(kO* zMxDz*yI-(Kj=#of+cpZ^ zp07moyj~!5^68OwbgDvhpr5{#Pl&$C>pOWN6Vq{d>9TH$;_gUiBX3?|a^lcaNWDrf zq9z~xihrgCI;;xF}~(<3D#G@UGWqEQA8DddgAsSe~? z#Qn#9ZTSjcpf0{oD)RNm&zDzRbAQnn@L)};Q@Hc2c77+7PB$plc;SWF1x#tz>edL4 zT)fpcI-i!6qjdX9E3xDSev~#PRAbj?fJ*6DjRf~ZEOQy`ir(QMjhc-vuT0!oMQk<7 z4*e_T^0e^e>dJF!3ZYTnr)JL;levwT)2c1JQy=zFc>L6?Y}g7wY|S#p#yJ2X7}NH4}1 z$L99k%N+zw`pA5oFgv~c^vle6Y#pd#bj$m7j&?9mBZ}RNs_fUyPT`jy66(MvWEut^b?` zMs__R{BRuuX@ceBC?Y))qsps(2ssx8`E*Ua3XeFVM8u1*Piv1Jx7l~KXx0);n&0>YxgczsAiWMM^pPIQ=6HNJlGMIF-otIZ|hA^2ndP}+wD z0%pWG^kr)$&G}`SyJh)&(+SHe&DHdKj9RBk(7r1TRJrZwXLOHMrcIFX3zK_xGaX-Q z6+D+zi4h&TIQHc8MiGNqsK#d&M0rL_{g7_V8ZdUz*sGUMRUc#JlASB%x~#6Pt=io( zKQ8Cy=jZ3*a@?6=9RqA!p3TKiyou28&#-6TMEFbLg3bwoJx_wm9WD;??2ehoa_Cm- zP25aPCG&6qAp7(Dgzo)>+oy=D$I3Qn$;GLwx|qE6<}c7@@(3oE!XiWttrQ+sX1MgD zq(p{O!7H<)g@&^#OH!gpLVF%8q>txEV_XTwFT^nii}SEJ;hbc|8-GvfnVM2_q1NVV zT7LCaL0;ZG9Qj8JV35`Dls7G>=Xu$Gz6?5UZ`Amii;D#X~*qiW*R! z?)gkyPImcGxSijh!ZMf1Lc>i%#^7j6lRkSnaCQd<$`^QecmNnxlW}~*0Nm|EjrLs2 z;5L4b?KvFD#pl5TU0Qf%P6b$cN_y79A!>E(9VzivF&KQiXg#@TY;V;~dg*kjEE}3F z@S29zp9?ENLKYTns@h>v?$UA1xC`@le%Bov>mF3SRy3IYLUohZ zpG3}h$RF>0Q*R{R_x<|=`>yL71V)^jJsq3mV#!CPS^V+t==-61N@h%aj!LvE*o z;|=TMW$_4EY&Aa(1dkQtnMC!PXdavruMIp&gC>b#C@lewl^&^2^EkGO@CBdK_gf)@ z8KY!p-Vu1it&VyHgB2+Sv=O^V}aFdKgvjF$pK~~$WHrM4F2cOpJOC~!YwfG7$a3O zzdZoDWQ1GJ+l!iYrmkcxL!A~u1leo`?kCnI1xIIF7R3*GA`7-JemXI@#N>sS8{|V;TI4rEtk;wo zN5L6B^BNjT&{Esqa@JXFDnaeorSs{CClz#_MgqJCrzs*)v-2t9gbQ}6ub9<5WKEBi ztJ|Cj#AN8cMBmwoA-!z};nh+ANn!WLX~z;|WQ3rzi(rv_oJkFt*t~r!R$iQN4MlFO zH@!6gjT0_j*iq52%aF{Z*UR~F8bC-I4@5n|(C9tjYu$1%}8 zRB?4JQYaWx@7yhu=7v)O&|5yjMZ3uOeb8HJ3H+vroVQ`-HT|K_wVVWn(LM`L5fw4J zBguFwGA^_}eaI2i()Z3lG41HsQ?6+w*lrZ2HL5H-9bF*2VqAKW_-xi$aCHA6?4r>) z+tolUUr~vBGO+pUl&f9Xh*8E4N@gzduDNvWr%mDfNn~qDfjKuw`hf7;pp%o6`b>4= z4xP?ngh3z7xq@=eeSv7GW|teO#(J{2P5JQ?B(Z6k9fUJf4{@gM%}rC6A$#>lNJz7W zCpYS@uDn|=lYD6{<4+{1yDUjhfV+<`I%sBgf(hFDQ*y|%OO)tPz$(+Rv~gjw5O z9-Hx-d(v%2*29=rVJykW~?kiKu6se}z^l?7N@%d;0R!jV=1lkpkL7-`$<+hI@9n;2I@MUn3e>oUV9 zy`$691el|N>_st{&&1ufkPI%j*O$^>ADexzyq-g8t46w<47mzdxWxbM8 zF=EDHaxY&9=m#9%_?v=Rn!G5Eh!=0hSXL=C67TwCysgAe=DEcSRST`upZP*uXSfC_pz1odnLZLDFkdfRi8TqCkRk5p45KiS6uX z*o2s)qod31)2OiHVYZWz$cM9(N!p@KY_)n%Wq4BEZ_|Emz>4X2{#?b~Ni23~fKzyGBf)Ec=?;_ zKf}nxk|ZKE-@b9ad?^^Tz1Zj+(+0RTu+KT z^eS0V^wI+ueyHKwShC^)G}r?=`*0#}%>mVjr;agud+QN5j>cTT2GK#O&Md)yP*N^s zKyP~(skXLw^y+&~4%Nw!*&|vN;htFK7%M79t=*bQ;fXZ_qHndk!0#S&VooHWL(vJYb`Tj zo?mhlP3#Z3KKXwa-kvPQ_Md+!c^E;Rq+R`^{iEJwcHh-gzlKuOccB+OW|y-%r;i<4 zOG}v-&agi=3ITdQ(q>`LIZIz(zva`C@SX?VLieot%(|Hkz&YOx7Jk!pW9+XZNk@_v zU49@+?8Ml=5)lzO_E;ZyHa64ZaZ|tjePUvw$@NS!ojc!idxCDP+AwWo#lSegoJKx% zq`9pt^{Wd?1?|Qm+_3c{V-YQTcD?!V!`zJlMC`Yp>!b;}X14ntK1oLCCJ)_uI-Dk; zz=QV$?p;DaBoE2gcUV=GwnwW{JLx+BJ%tKan4lzH&FRLbSrTDb<<>_0u`lI(wm5m(r#31KS|t7&X3 zK8h{(v0j$qa3ej+m!(#>SAHr}&-NQ#NxJ^^3Q6PJ zS@1d?>`4DshS3&xtSPMY@Kt}Te>@NVi1Z8LZ8sAcy-o+#sYHeiaSxfvz&EsZeJeLN&UN2I<`RxJdo7G;Nxw zSMB2@|IO&&iZPr)bjq&8A$1;(;~Y<{R0Azl+dVSVa}5OL6T3Wv;B%znN=ap!qQ@`iX)_J|>T^|Lp@%R0-W@^vh~&etOcG*L->By80-HW?a4MJH-xIwziGfdexT$Vl8l_QfNS)^0$C#ilo^wkoN z&cecCYp&^SR^KEI(Gldzm$Ybo2X069$4q2sg{q>)(G6E_ULM`>tk=8;KAz1`Oeb>C z(P3q0E^pJ@GA&(Q_lqN{Q`_kkVOQ6yC<+N?ox0Ddgg-AT{8Ftx>_Wp4{gjyO`IDb$ zZ)Zyq*u<8TzG2aCo>%*Xh7s59WEsxBrCLoe!ii335ap-CO-iV|axNkW^2-Vha)uI7 zu#yEtSO^7mIDIrqv|qRAdY`Y!u*V&3ktHc7H?I-}A+tor6CKe=TnJG6Rr(y-_2#(e zDAJVR4?diwCsY3N;HqH5h+`XA-kbI5-a6ypeO?GlhqoD+x_5oEZ9aTDz`SA_OYY$em|# ztHykzqOgTC?1pOJfSPDsEP6wS*B9Pnsd82pCZ@G-bEF*2X>43?Tgql+6w5$v-i#A` zj1}*Bu|~k3`pdcV!bKuUyVPdYA1BF^H(y?QruDp({BeGaTFAQhhd8VP`Oh~Kwv~kT zKw5SA;Np3pr2FCW!>F?JH3etCVE+B8fhOla)MyIn^Hj|a6}SV^o7tw)6~7D$7Eo(bE(k+k&%76DWC9D?RYqEEp46}lgG5)cs) z(R4kZx6sMQj}cxZ?!4ZsgC>> z>;+3wc%($aAFPC-`ky zIYVBHY5L9>`ml>+B2{DVO`!|!=$Qz8Rbam2boH3k4_iLAH7OV1;>w#_vUL#D)=d=&M&;h(ana<0TgRuoF zAuEsPo?cCzo}Nxj#8&?-P{}hTLdf8)Jh~vZ5(=5gEZmZJOsR0kKu1@S{9s*|sbMt! zWgbe+vGYseM0>=LYSmkug^+j+G3mu&z{04wMmuAGV$4AEUdS@7eH;8_pJ#fO>Dnry zkZ6G^Rd&p4KE7fGssl9@sip00dOXQUxlx=+LCKECM^X{;K`)7Qp*CxPx@3(!U`iz$ zEMi8dSG^b{NlxQ+EM0yRVnB0^yTvAHaHClIT7;dzs3?H;A#WjLkNLz?MlDJxtT-4{ z}bKoiam$$ilvw{282+n`JU>5KmNEQ2=s>AIlNK5aXH+{0C;z z3p4aexBP0XrrDaQW+Gsv69GVr(~(h7FCR1=Ucce;coV?2Jj2=7dxH`64USXn<5NNM zQ^}odtKU0%TMj)L6C|yrU3=tL01}NcaPxX+*-3DWDUofsfv}!x+&X!T)M*2jyde<9 zvIAe{lWCC+y3X2n{=Tk(d~Q*{V@1@dWj8z`rjt1N0Q`zhjGv%zr#Q2?SSCC#|1M>0 zeEd)5@%UST>jQ+@;1;|%1Pihr8=-eG@tX!K@9nnAsyfNZ5;dk|*Pe^4#9N@{*V!m@ zk%lRE#zksZ2jZa~;-|@kEkNET#WA?fgLEmhAfhKSPDorRFQY6yAcgNM;}056a=KfT)Np;S!~TdZr$el=qQK!K&ynB88J_N!JE5r2T&6 z;XQiv$OzFoNxWARFijE zLTXpPPK?d|LeuQ*EaM*x(yg&4CMCW`mhlBiSrQSM_w41>S_|8qm?-fE zXm4BX934SEl4(Wn@u%*+%_3SY&LtsNzuT|lv$HI_Bp3IHdF`zvgF9)-EXjW}9s1u` zAOuu_gi?RQCjZUxI3oeIo1U^18UV(D%Ht zH!xVbQ&Ol+xM|ooF!RBS)m6%>YJ>qH62H^I+juLi8pe0jo0CQAvhMMBLbid13WB6N zncZBi)%zsky@VdN8n36q%8&%nLLc~^qZ;dzZB;GfB+N*y>-VTYyHqLr5eW83WjMS5 z9f}h+H#HT%b{3+A{{k=amu4Hzwz8H&>EHLHsspW zIUO!fP2sPBpp^Yie}8k+>EKuE=_w}_i(cdA?rzQ}OUv*NKugGt3Utwx-2EW^h*d1L zpqDg4!ns?1kdB>ryXGmRsgV&Ee6qLaX#Ux3w}q1%`{;vsd>_y+y>0~3huK-FC+P7u zvYl}Sb$P8_frW~zo}QipdQlHWXMh-qHnw&dIM7(g=Vl=oMMwJlxfYdI|FNOm+ zMTsMzAh7ctqd=g3-tgnc-F}vq)TAUb(Mxjv%vKB8RPWHr4)|L|lEtUglk^UVApL`+ zv&rS==8pMs@$oUjxC?{M+evN@y7Gu$2zbcW1d~179zOv2VRrw<-kep7u_7z9I@5bO zC=H@wjQ=P+hsKhD`CVI4`qC#^e9e2cf36a{*m|Y5famS?M1hK_H-ma9DX}77>~A+b z!tf)I2xkr(>XVR=bgu(Vl9cD4K`zNuF8@Ax>nOqJI(46f@JF6ix`9o18THF+lopKD zYV6$EVU%8*sdy(zML7!G2W@IvT3&fkQAiueG~cQum>9l#^CrkOs`K>_g)C4x3FGJ3 z{GMXcX=4*M|MV$R81Z>7GQ1g-@&*z`e@mek;O~#|{Pky7OcH)0WO{`gugnLzqLfMj zGBPqVh+1Hu6mV^jNemr6c^DdIPVAMS7-vHmT3k3bFwGc8MuVQvn2NEF!A0l#RzH%T zdG>R*>b+E1S(%C#bxceQocmQ!7IdHLtS>{RO|!PEq%lEKBHb$q|rnrt#i zDz8qa{;bqEHdiq=*LB2eB%|@R-_vDPChUk)25xSd^6e~WoZx8iYb8_JN{EZc`U4%o z7M6>5HL8&Q;0B^s;8807clbVWvvdMoTWDir=q7~h*NYN>;_DkW2a;ZCHv6KgkO;p} zO@Q_g=6HR$po*)DeFRr4!V#|$0*kDVjfvy7@xf8*u_Gl{eTp@gD3o5Nn8Z$5#Ex3F z>|}cz+3b2|8Bd2EiK>|k(MNK zboDz0Vv%_sb_ z9&Nk4tVdni``JL&qnu!KebmpQ%*35gsIuy5d5%1O;KdW=4-OQB@i{TESbh}gH>ixX z@@xVpW&bE+l?W76lO82D(EH%vOh{?7LRnF19qX3GsI_nsmm^Wh)QBSk**~hFVJlx! z!P7G)^M2{ep$NyRexqLrZdQ{D2s*=&I8(}bHqqT5wVp{suV+sqS` zEw-r$v&|QEy}eSoK7bSd*x!8*dzwJtMC+lej+%IS#l`a(otIZlnFi<*@Bm-#;S!Y9 z)YPOQ_(d`N>-Y3+6{I)V0==T~!WdGNoe_GYr$E5zlxe=`aaB@ifYjvuFfMNdt+ems zu|8lVoeeJQ7+0hEDtc*`!<~%e>LhHlBkI>VRL$61(c>sY#-NNr+qQ+!2hS=!Hj^(J>BF9z7aTi;@3N)o^wN77XDqG17SM=~jjs1j zN|A;b8;7$=iDkO%ZT0|fz*9nb9K?|f4SJ`xc>}pM?9@A4%7j@!$uD$2Q7Un{z zSc{1$?Fv^NWayHj9Rh4_Fh>mYJN&Qw!Get3!oipxsL9|Mj?q zl193j?bp#$#@%%s)fJJy-Qv`v>#f38-XX>4j z8DufTZ2Minx4K*$t$|{`ySw{O+dcqz$GpeNCWFiedtu&_f-(u|q?17Z)w-x4!_89zx%phuT6I&O}4Q!frrUPAm&EGnim>4@T@? z9NU3mQ*5{jTOzq7i)(X|_d7ha=D-cT8OxEei&ec`ec}?zXh4?Tk$T8RjOXeV{0HgHmCd=gMyp(x+b^S=5k;{JMCJ%f@|wnu%3o%mBKYnpz|W<$~_Iv^=qM%FYZ;S}LD2&a-16RRHGi zAI|sb*MmYkGc%My8t%Ap?~}gye~Gse)?Mgox@V8$sf1Yb^ zZ$I=wXt}+#xR$mSQy8-uQ?(T8=T>7q%J^9z$c<+h8n{*WGWnq(!N5cNQXS~g(OQ2n z8^Lz6{-QUaue%bPDiT8Q>l+$CRWDt81WOR4j9W3)fS{s9#M#U^-(rT45<&tbH)B6_ z3Qs6p|H7rm_sbJ5E>O`EF}o9-NPK-Ov}ot(;4sGbMnPv4kE$MKw!E8{K8l~Btc4ep zcG&i;I774|64jWI^u#WSZfJ!lE{)Gwn3D%@vxk61?-Oooz;jXfLcXwez^)poa~JAb zM+P&UiB8_Je5zR%1IiL>bllza;$O=}tKq!DXFV@iU{qTN*8wCRq#>qi+8>rxFMSMq zEORmpS#Z@-7eU4N0;%&ZC{-a5+J3bBt#s(v@i#^VcpF<9)8B?C-UY?b3&rw*l7Z79 zTl{~$`rmB0%hqJ8Ei2mxu1zzSdq;#|@Ga<+1Pv#{Y*#}_gw^7sz@@JCV8fnQg3JA3 z9brrYF5h)y=nJEYumbf8N54A!jrCnXts+{}Wse84*-nIBo0pNG+laq^0-@a#WHFac z-mTnxLe91kcsM(A_ctP# z(oHZ~J_v&Bk{OLU#{&`g2-2C-x^GAn~(-`_ExE->r=IoYyC{X8LIN`?kq}#Oz z;77KlpqeHDKa2quE7Y(CMiI z)hU_jm6YxiyQ|Y(|6vocdsvxx<_nM}W#?UeSf|m++QI^DsivYrh==lnghV%p+JH@^ zb3R-av$A6G1L6TAA5ioMU0H(z1L*@jM=rZRYPhCkL0>z#U7e};%T_@FQ$2Q}Oa#M~Hx4!I-&;cF2r{ar8KA=uWxgtv`Kg zl!Wu-$rJVu!WPOqW7qNri~8-OgUgp>V*-g6U-+DX zBS6^ErWRfV{gsvd@R7(W%EB{xm`gqn-@>s^lGopOf~oQ zUayO4XpS#-OZoDJ%B$Y+S18(KqPg6|5*OOUT+o?GArT%)^-Uue0}Clsq9$+#6zc;& zmvS;EPm$aF%y0zM*d|&x)?R}{x5lThzU<5|lrtvCDd-=BizTl=&0rZz6w8}pfJ>rd zd?|6D#yQNMllD9a^S?R7rDkjbO&S z$j)OwO=#<9yaXvg5ngyI}Y?D!;3T^_f4A7TZ?*n!p6p;*-JD>vxB^%WiqQ5!-;i0%J6xzzHX~oLV8t*byBwhwAn!n|T50S>p<*DO~ z6G13A*An?5^KGOIRnSsRD?43xW?%}5Q}0;VYMYK%vd9^v-=a+?{KBhs-mO7qndpVu zZWvMajq`l|0@{r;GRRaze!i*C*Ijpr_vp1SHf~Yit;Jh`4xg@Ny_!%TAor z@oKsWhjOgSaYo`32$eQvrdlCA zsw2*W;7pIizZN|Rsb9gv#4aB2hL7_>HSk@^u0lD#0QL4UI{d!j9X0*ceOlXg)`=4S z-AxLtlNx$u!$$~zd2oF2B?CpDbp+u^vn3Ne&4^q-?sP|bpfJ#3U9k?f!^bO8K9y?7 z_Zan#^;O*0q=vG=(X!N=X7mX6gv{5ruN|MBE|Z}&j%liT)n#0Vur!aD@l`Z7rWVGK z);|eNHt=T~&!?mO3Gi0T)~t@dNQ>D>VF0;z*^D>~of!uy!&z`{O<*;A5IZj?Cw?o- zcDVZXuchT>@}v4|csx}_!fx^}!nTwqdkZzX1&5h_kSgUKcDfQeBA}g`?It`iD{_`? zwdEUNGbUilXAx369A=WyuYP-Hu-UC_3FsUhh;#Hjbe657>Z?C2-kX?!Z27M^+0NE| zr}YD@z8TB3p{8c?=g$)D^zyFUuMTiCOObmx6hiL1#|0g5xO%VK8MYvEWYKm3Dtq|V z6MqeNRV=jP;|6{;$ebVqRP}M@Ha5!2CdS5Ma`4hm8Byu_TioA0nOX;5>QjV0s++Df z?k6tC$*ag?ArrrTTpG1(L|DC@5g7D2kSQ0a5QJma3Zvp&RdZ{|p{N5tzwkO9NY^g< zwTt~cEaYKN0(As#-I!d9-l_Zt1p`!t9r0LEz%lb-kI+s2a8A%3L6nZoV!bMSjxF8~ z0I$V_(-03C+kpKAlj*ih6HR?;%2oOKg``Vz;_1u`^iijl0tilC>d|O7-Mp6zD|A1Rw49$gxu(E3= ziVipTCyMwWZ8-|%*psAVZ~t~S@lUcX)r$Nqcp_dk$6QF61n9oB1$^r00aQSB}vX8If~>gIVd0~2#90~ zkf4~!h=`zwqQ6sxc59E_W6zzLb>Da0`D<1$Nl#Th&;IVS_ve&XC`qt>)ORhk>n)cf z?tkXq;)Wl5IsPVE*mlWjHn~nD=4s%bT(A|-N9Q)yp5-EMN-&-C$n7nUkf9kc3qE+= zDL$Y~f}_NEb>HY!I%nL?T84f>n){Eq>RH{hgT>8|-Tos)ka_$#3@w^ZQ|0YJXNTh_ zF!1iMwq)*qn>c$v<&Lja_~|qL+t2pDZ1o@g04HwWsB{&cTh3fQ@y+1j`CdnOoCMdm z@P){J)UEbea9T5Hh?Y&_=b}3;y?(6D167N4`;8lF+S*h^ykwR3Ww421arcj757EbY zY~lBdwheV4#qY)Kr(ZEw{ByrVA5o~cbcU%Z9L?*_xJ`xgWOjTj+P}*t610uYZ)@A_ zO<)@QsErA~SY_Cbl}U@%49QZ&Z|I7c@mAs=EdBkj z)o^iftv(!Pe(jV!zI6^h#XaeaFkJ#;%l!1eMfKCP0TbG6(*NZxm!+=CMm z62d;Io!%hyh(092sO^KJ-;jNn;LZxXF5Wv$(~=L*mY-20KGt12dei&jMmtH{q^$85 zETpn#&u15S45|ewsF_hh=w zm-mxaH&MEGb@Q9WrWme)^O?wE0U= zeyK)pxv2+#3Z_aZW31j5i;96t{A?HT2`Y@FIEeqj1s~WC6bc@tWG8Z#z%vQn2OVpd z=CeuXnhC_^Bf=Jg1`TnwO*L&OZ9cMAu06NZCS2~~QEh~LUlDqahk`3}a*}EmJKZ(D z9%4N79yc39tdxXuW@1mc&2l6U+YDW0h&`nwCg}uLZhUSlvT{s(;jG00^OLuNmHLlVs*DlBn}uV0@tFhD3;DKr{y;;io4r`JoQW-4j&oQ3-zf*&sg z|AqHn;}tRH7^AB@s3f4IZFJjTjF~r-Wzs*GP5tmJ?kQf8tbWc)cS1e2{IPrz!BQ5o zE**JI@sF$ZM&G29Q7D*!rwW^A+W4TPq^gK~g|+r&sKDZ!}hD*@ew z3OM&!a?Ey*9ey@z#Y3+W79Q?`Jy(9LuKD5ZwG{fmo>+XUnkxdS;TWRH@?QCUjm@{h zk{G+xeiyp$=f4xW^y0nkzoc{{LFtlcC%|9$JP%_jL~Jzo1yo! zk;W7nL&!4kc^uDk2cz6ui-#UF;wLAubWrv48YnEidetpWdQsMj9HTsKgSUO#+`@v1 zlLP9OV-k!g87!b@C1h{x3&fDWse`3ze%HZo2M1N$O;W1~uFH;~^}FH<5*LlRE;G4_ ziim8#qzGk)hh(%k$(&SRLX`U8hj^*%medCE58L@z@a*OWjk9*=j>Kw#W6xq?)Qw#5 zR&4uUFE1kow`$7@rm9{&qEa;!l!Qp4b6_XUA-5SU({SmQqA<*@B3xHdkwce|I(Vvk zi7r9wjemAjCK?;7GGotFlNqL#`vrep2 z9W##}UG*1YY{3__Zy71QZ@pj1#_9gD31ci7>sYQfk?a{v8ApC0K|!*pQ@XL&A5{oc zlHb=hT?1P*Shr=Dhn5G<1rvGq!HXSS$`mwKZj!@Nu;Ni?X$pzh{P1=mQlfm_KF=gW z+3!&j@uU#BSP>NB!@RhJ|wPSEX9M~ z^r?^2NOCgtkkKo4uzv^{-Xx3BWu0O9(VWkMO8^u(iKX0*VRzd^GaFl@~qyyMHZOL+$l^v zIBhnD8L=+PV`sdQh;&NQiIRX{x@+U-C+6>{eXgTKxA;M4s{@86*1YU{)gr!g$S-(T zQwT2l!0odT{VOSomfJp!K!Mr@!u$90y1^Vxz2*E6ar?Tndx_2=0Z{v#AVdWaT8 zSlFi{uU<(J!rOY@?*)iuq=w_~Nw)YUpeyvoVAct9`96U`vm-6G*wN9^kOaDvI_)Js zk}DJiBN_0Yd<~XxdywDPjvo{#K&M_mYEH6JLej8apTerd*}Ml{Tm67@ve&4d>y;QK zGx{f&zxbt=?GO91v$gUlY51K)N=dHdDMPq7IygFVX?qM3&iHFs1$Aw2pCsuOC|Z~% zO$`kVwf=HO0DW@oW8E#JrRPtyCwJXW^ImC^xTvj5Rj&EstbZ!}5WqR@Kmd{J?QtLf zmX6-u-i-~{)Jyy0y-E!qp^=u&NcZNyQq2|#oqFy8S6$5S;hvw&7Lj2-ZfhiVs<~`) zbMqEghtg0KQl`H386nH?0gH=SHg!7BGsCbgu5?P)qD)qH0za|gu?@-x(Ry z$<+ELW30zy|6uVh9_ZsWZfUrAGh%LHLOXki_VD2z0{eFFt*CaXqlvrA71i*W&0LY? zz`HSrM*e&zps`VCl@pp}c8%SE5M<2g7K`Qa<2w|-xYGK%o$2VPXs*hORu6C8E=Dd1 zuTnj!S`@|Ugs||3^=Hy_q?YW=l9=TY%{T_?Z0pS>CE;ax1#sTkL_`=hQVDfXQ&Fj1 z>b9$ts%nL**U{*vc#}x=abpg*va7055fwBq6V*!J5D?urkFQBCpX})B!W>J0qfLl= zX6Uj2Wi`}ssF*y~xjk}iYt~=gc+#WsGUWVf4J+$LF4!W4B8MGnY{%kE25^Mt-fOT85wk3a<|r^=san@^Lh89y_DNloK%sx zMb~Pr#XV%4k`mGc@-m(t9_kUfGENob)^-ZK=|ypPW?)_|C%t)o`dWOClly^piepi( zMEtPHWy;aY5sy%Bf;774||a*NS|*6Oia;xv>F zwNwG9%cy&>kL<-d-1HT7jbfKf^$!(Jgy^0lgL+TTDoUqn`5Y6FT~^5zo=TVQES9+h zpgjp%1tU31oO>ha0T>bnp#$AoS4jpE`pC*-V`A6{wy#U;-MPqC;xJj2N0&l)mWpXv zDfCaI>H!roNppbC{ZXpAll~}GnOna~)m(1>k>(=?fS%+#3p!G5ZzZcyWjYPUI|1S#&Gn|{Du-|_CAW_#RgkU0()Gn+KJKR zVeyY#x&*y_ZTWWGjJkQPt%r#0s+veX841cYX?h~f7hH0DMHI){mi;YfhI!9 zO{R~N(fPgTEUGWZm{9&edCnIGCkf;!?dfqfg)g;83ar!f1_bT#6yI-cJ+t&ap7w0y zJj!%@%GorktYq-*C90HQ9Gq{zS3N~nJ>GG*yIc09#|JEq@?60expdjq$V%eUl5|LHLEu)NaA=LbR6h-O-&D=+cYsz zl(k~vAYa>ko^Hg`!J(qH)$oRdSuFSIR~R*S^FW3cO{iUbcA&aY(n#}a6|*& zQd&=q=M9O4lq6y==CJ839r{RbjY=Z{Ovd^`|6+ z7q4P@1nE4@yQ^eYu^1L$6bhu3k{U|M>;Q&LMuIYaobXK{c|~R~U$A>y#Q-wA^TJx@ z6tI}MZOQkq7>*#tj<;RS089d7-(Cu!85uqfLr1tBQ@+YS809ztGII3NxLMW}!`b^9 zy$tVM>)2R5y=e0Hso^@lYvv(r+YL4^C7>&^=J-s{H6|qVB1lyUKA2 zD#R9+^j%4{Oi$PqIn{#BD;=D`A$eflvm(WLP=VOcL_5xEptzS>e0?NsncfW&yX2gY z6iSM1Ymhp4Oi5}E^%zqCE44iT@j;6%jkaj0&Ya}eVd@QCW~F;Vx2a=${Yj`_dKzP& z)e-v4`nyM1dX2IRW{>UUqC_K=X5>GJMvU@`X@U0^VVCZ&y;L%7uY<1v(-c`jIzqL1 z2+1#a;nwfyT6P1ep87sKwQ`0Mf|Bk6&I^=ts^WO2Ub1k$N@|+i*fuYk0_Mz$3sr&0 ze|#p6$mA=RS~KpKmIHwI`3~l#Fz)Ub4EI~ir{?0}@&Ei`LErkx2Z`VZY~ZCstpE8F zHa__F;@Eq#ajfK>w2jTeyCKbyD2dBP$fC-s+$G9bmiO_MWY`j`x)Lo1>?6_1CniZm;Opx%k$s)Sj(}TSfUsD?RQw1qZcK2WQPl*zK z=ASNUURTW#uWUNWCnm;Sf3sw?h{*Z{v7g`jS+6c;@BIySzBg1~N9l!NEfSI|vw@NO zacAc!E9((RGf4+=g)&D-kn>YYa^hi$zu(;C6LKG)p3X3#NvNPGIC>K9lN{A2E46z) z()?%7-X?jKzowC)Jm;<CgZ79tgU{-Od!a7d9>8{yHTN7LiD-ri>|9CN(0xS0P* zitZK-H8s!^yKjsK=67`7c;bIZIpM6p_yFqFFD8X62O%j1;_N;e$WZ;52zd3IGkPfv zoY8qkO*JC#xYHj+!ln32!4<`R3C-o!b|$$l1wn8{;Vl56rKgJ!!3J_Ib9Pzesi^w$ zbidD^n%n1YyUyVys{XPq`lo?_dq1~DpZz^s^zp>x?#ZwVPZ~vgg5EM0y1a?UE25xQ zN58;@5WI)um(asiUiBH+n*5o&x+3i$ye;msU#6n{y1|%qv*o zO~A(~8Qb>(1DENkQm4r#c74%#0MBN6ei@Au|^bv zGfwL6g)HV{tl7m#9thWsSCtag7$PPc#xW@CKL1iG&{8*Z%GueOgFvvb`KR;#KlMDZ z2_9pL-N(!B8#I<+TxZ_R?ew1VsJTwSeOU4!;a#4g^&3m5n}XVLSTYHB2c zvJVO6N-3~F2=3wLrXUB$nX*%r`yAgoE<`AYXE5LJNo3w?S_WJ zF;n7}5cf@-UVWhfeR^e;BK9;^IP)%1VYP&~h+W!v*%Nzce`3}IRkh3&=7PdkFcOm9 z(9m;zbs~avZZ!MOTPcmt1tPn?%Lb8INOpy6$Ig`5(M&U%j^+%k@EDL!AQP37-TpL&j zNj~MTUF?>|&|FXZU12 zdj6wQN|3ucoOp*bTbsPpr0@3j^JsuBUoYM4c9(TZ)|CA_WBja-hi{w1tFxbol9DoE za*ndJGzf8$Vu>shs#Ei8#t+G_7v%^dQ`YWzjIB(DB&W(;N2R(uc2F*5u?Y>A+kR|p z^SjnJ!2o+G@Dt8^A?Cxss@h0FKiO-^01s zoAoL%u7K&VZ0lkOqoL4Fq^tX3kE!_=I$m{Tt`TilVN5@p9kz(3g^}e~6)k=KOD>hY zw0v1c)M=c4ca_1Lxk-tiKY!lFEg_y3#s}jo?=4$eJVuXf^9(}h`#Jr5ArXw}z0Oj# z9VF1VSS@A48(YIHuqK9Q zCA=6d?fW#ZT4U^lfY-%~dbORg?)FjG_)A1l{FTgF&PZ_`1q&qdIhMuvb$BOQf#)1~ z&_XE4sMH_vW>#`Hq-V!?D*O^VMuL2Z+y6<*|GcDZz&doFMpN=SJ2};korjPYA@0M`(Kj&qMUvZ**mwD~!NI`d|zWU#L1(SwI^@7_K3+o)|8jH$3s#6!gG;zg#-+== z4mckB`oWShNpua`Y@Ru8_x!vyBr{&VdxB6@rj4no#2k4^BVO|wqWa^~iG1TKI8=G?rYDO~^JPNr~@%V7>+KHngVH&-o zJ^<+?DB=eeD8z<_Vkz3#GhTUqox?ik^yRAaAF7R-g9^to)b(**L@a%L|GENqa6%L> zWhaKD9*%iFpSJmpVL(bpGCeUN%Me7`SgDg<#L#A%D#8&`R>od-wkP__MJbvaqx@5> zDx7^~a%{G7hniO$?)Tk*8VafHNij6)e;zVTHbTY-R|wlg1qEf!{j#dOZc28uYoUrO zCl}W$%4Hk8gF?=#9(T}N2>Z^8&spPL$m1C~;5=j_?a#{MT}=uB4}!83Kj9q=~2gmgf%jxzD?0_@TrLA++WQIH54G8;abS_mGa%WxaL@q zE1;2r+35_iv(Vp#rNY2}L0Epid-~J9cj#|o?T3{P{@3N@V!C?_hH>Z3ujOW~IX)9( zAArZ1ZZwNr`7}!rf9{pV(;OR@=O!()QaTurR}|TRFeA;b`&3d zd(dbL(p<%|v(zXKw6Uq=KL;z??x0_D0&@NZRtD6RcDGA`%k2NSxu1g-efpLKzWl{J zRk*dVGO1sCfWGSJ4-I|5OdOm>tLFb21Z^&S?upMooKX;c(;zDxC*gr6egDut~K{fA^EQo5$OY|a82lIq9XpGPgH97uBrE%NQ9bl@mOMmDE90S_Z&(Iy0E?xrj?Or9 zZb(PIF4TZ-P@6e9JFDKNA(_RZ5i+(Nx2)e+RNrK2r}~slFbCRW^e#PInS!=PBqjnb#=y33CW4A2{MhRK-19MJi-#mO_Z;$g@psLL_N zYa@k=6b(_qTimut3#<*a6^yrfKAe&uSo}8sM&&`9>>&>tfwo*TcyBKc>LaZ0zOPl3 zU=+O+^Y}+2%J9dZCHcq0;xvwtUnWjn%FJ|;WMzTS;+uo240Uc4J3Bj43+g-!STWJA zjYSS&VLWNQ`$*xboL2WTJ`;!QsoUB$zP&)Gy7Ipq2z~WKAT;6i9|ECyDY(oL+|?W< zOqKgbRx7R&o!TrC{Fj90`Ot4dQ&KU+E%yu3hx|Y9@?Z2W%`W>N&CoA??|u0sYL8TG zzP^B$o7-EUzzhhmj8NcIFXKsj*nc8_xWPly4-lRlpj%iywjMrvf{GgE#3n-muhG6s zd5%v2EllmkEf5zaCFisDa-~@OnlUu772&L}iJ-7z!+-n5*bwr@TyOJdj->+P7ahw( z;#t}^Jzvq}h;7H1p&|#LOrR{q$PTm#`RCB1ga#o_HSq2c3}z6`fiWyHw|gIS=jI}y z;DqZsAaFG^GXsS@HEYXDvLd%?O&D8Fx-X8v3O(|gupj`(0C}e56NIoJo1kZ6Y&@|v z08fHPx%0rZMT9FP{Nv;sjqHps_5Z@bx0RHT;G+sQw>S2dmLdGl(S$Vj!vPPF4o+OM z;`h~#iK0@zN^t#nczNqvSH@SrO}~MU$jq4$O={(E8fYa;=i5Jo4YrQ+Ts}^j5#&AM z_GxDLu5Vtc>R~3?ybbHimd`?-XeQ;m?(6@t|45t-2xr~CrwY4%XT@>w#Z_-H@f^Sm02QY!A-Fb%pZ+fX2@|e@1Hxv zrWtb==J~9~E<(j%YsKpvG}(Gmcob=%mnk6AnqQ~jHBajK!$VXeH?9s0lH@bANSq8K zL?c5(a9HvbKaVku(<)X|$(Q-QqvWaela3Os8Y@*3&k=SD6BH2K!i*H==a&pxTYKDA zA$3PAmOtXzIvzsNR=$rq=sC3{XXAFP5nKGK(!qxiSStz)6V&~h)`WA5l_nc+rc#1u z+P;r521|c20vDa$Bo+%>U{5YNqNPXl%y1O+mBFc?qqKb}6hIjgP2jmfzW(&7sZPs2 zDJL_tKupmShV6I^DK&eYq|#EpB8Vr}4Ay5e@sI?SAH^a@c9M?#*hvbOv?W1|GSS;i z@Yw`%38fSpUAtacS!6-BNZPXnA&f&OoM{!Dbu4bR*y|*!Bi_NggW(c8SM$3=GLajL zs!uPCP8*rn6}jCBBF(0V&6VWNqi+()+?ck>nJY(!r?_CH>`M;dzP(@=oH!noQz54_ z`$ox15SD)4B19Q|nT&%!GcOzJ&g=rs%r~`H#VDS$g#2IAnDjJIFVP}stH>7rV+U!5 z3E4q1t_nC-dN4a-aQ3rDH72g0v(cRZzvS9eWK(%iy3(#1oD;fA#?Z@XD-;$KhH2yx zQY9DAKog(hBRggwQ-$$HvIZHiZt7xyBpO}y#RyX?3bImKEgYr;tl27ehGG42f@-ar zzx9nB#w(?Gh`#5zYjYC(6$bHHYJ2@7YC#AnzQp**FBK)2&zgeah^P&%9}E{cW$;a7 z<{d`+Er9vIX&5fc4_$eQqp`}loueyk*4p^%g?+GZbpJ{;vV4r13e!1zEf|qTHb5Gg_aU7sWyE757 z$TL#9Bvo)Ui;gY3kww|fds4wgfWTl&txHCti$W7ng?YUY9PVr57&AyPg8d$E!hb1o z8NfqdM)zEiQ%5Ml40}n$JYDJvzY7wr_b5g|SS89?vf`xPULAd085Od0ygIyZJixzc z2|N&h{@7Axt65gaomP(iU&19R7$6#bhFp4E8^4gx{vcSBzsf<7OR)e2RPx-PNz4xdD zY;tp(xS%Ic+t;AOY=Z>z>EO@s{AI|J(jY@3Xlf&qPGKZUJM&+cm@B_|nMjGb=VdPG zKW@t-;@I0YnqpfsFnjsIGiviz$-Xa$ypQq<>Kl{@^PgD|3|4E{<14hPM{hIKh0l-*U zxx-$Aof%SyFFGvvPMDYaE5)RyxsJC2$4jwFQ%&=0*iTk|c>c2I3EytNpK%fpeM44hm{0bXP6a<)ME$UqOn&dyrv>j=e7Lff%z=j_MiwK(`A zbR4N_kl}&v;N;Z8G4=5ji32&zd4hDv@O;;nmdxxIOY7^8wFxrna?7b)06?pj ziHku+{7TjB+d231xeIm8$vo2fj5tb?7@wD8H#3vj``(qVqhjVNTK3@M=kIVwfqk;A zv5c?8#PAV&cLX-1<&$(E$KETkS2(|oy;b-6Kne6BLLj%JPKm(G5ejMdm7uFVy#@Tl zz4YWc-f!v2P1?&%zJ%RHZOcKJ<`^u%bf~I+O~Q{jNZY*%2iH)1%9Gx}%>0j8lnE#Q zCl=-3>cOi$_}E}`z1tiOVW(sJAYJ~J2=qpmqLg{)Nbmz1GS|y5QwyP{p>3#Yd!rMR zX5nMZ%wRE5W=Eyu1xsf__uwuo_rMDWBGDrD6>9eyo$03Tpe;L-H`Ci2fe07|VsA{i zYYQBQX4IF~L-_Nnw5Uu^c{ORPQI{!UnB73a=s);E&KS`!S!ZlB#j#I@EDt{^1GzcTRa=Yz-FP1*u-pML?w`@6N zXN(C~!#TK@RXx(pd-{pZi-X2-?#48v>R;NOQ4GdDA9T$UYqlsyE`8Hjz6)ank3{g9 z+TOf38@PwX=g^4=39XAn>Br$Vp-@v+fUSj77UJ}MY!VIYj_Q@0GC1X#U6SsBcn6l~ z*>p?Fx=6s>fRC1lGh$_llYeNjE6OQ81U^jo z%c7c>Gv|p}pw%6?AZz1xsVHR#9bd`aK=9XV>=67BNrrAWb4v5|3J61ooqcvciB&tj zV282943j{iL_Z-*NC&Gp`KY>!3|BxyWP3;No>ETw2P<;Y!t2khNJjcU*NHfk|23Ux zr}NT!5LwQRnYN+v9mQ}BtfXO(r5R0H+g*K9+ggAoMYntpU2Djp98F^@z={l44#86n z_{Bb&t!q|^oCgCo@}nuDxI%)=V&(wX{#{Fbxd_=(2X0z#l+qJ@c|8r+ph)#&18UYZ zLZO8aFnjy-^N9-efNLZxoIkzoyl-?&(Kn_~`+<(~YJk zaHKu($sVZfLkU8dgL7Agb>iDxWXZM{l}TLN-!~hSYCwM|GuU-0k;>xX5VtM#h)a2t z+&L#;KX=F~v^6p@llk-t&!k@dNXUF0ezhfCruvW??gOLbMpPl7Ux^zf02@$%>M7C zB;Wl~N|ODhCIPlKdWI+v<^x7_X};u>NCL`efDShWrNWQ_2X*qTYg83!%f{EQU+)sG zr;$|DI=!^LmV4umt(s>Kurey#8hqq(SCW`BPqFFl0aQ61Aym>(2T)*gfg9F@3mngG}(I-^V8ZWY|6a$7apNQ%MKr7Zz~) zJ3FN`FCT5Ltb7G@nhCmNNUbIgw5HbPW{94gv(6y3#ShW_g-JGfC~A@&#qpPuY}sIr zhs+>wwsAIr!DEd2d1vYY#wq4Df98XA6h*KV$G-|i4ep-_#eAtBXW5A(zdXx+ zmH+cuHi^xj3q`EdUj`<<1P|z+0h3TdaXx4(x7YLoKtcNmlNCO4v(l+6^mM-Hg9WLlCaz8IstvW;S(P63eLZEK^FGU?SWs(mCObtbI!XB&4HQJM=O{xrd1H z7~J^D7w*C~<`9fOiAeG{CRT_FR9o7Uv3ZrdN^H zV)H?;7Tvrd7-_&G^tE84L9O9LDTc8jMc_u!tD$MvH+O$##y~_a5XZs@3favrFM0xB zS_}15R9Lf6vlvyKyL~t@tuxW#wq!E2P%y7iW)IG#=!op+VjHy^#i1D|#WSxcV9)V; zr(gA(0Vn0c9>$cbqi`VA9w)mm~dhK7e%)Cf63613*)s$k1AwRkABd9=*pmZNF= z&rm!D`a*`fO_3=4<-r~9CtIs-z!8z1q{|)kgup{?6fXL{U_)={KgAy8|mnpfm$OstQ*|Gbg+hus_B!u-zV`@L; zhbDtWImH~PD^kIs)|PyEZ`Y5$`ci%?-_b|3dvRQ&b_6_P6y>XTVw-UcOA790*!o!*rVd@U_WJKAV>yg@kaBqZv$`@@Qh z(P?13&zu+DJ~!z-c8?UrGU`EDXi(mEoKQIEuF-8cf*c)T?+M2WXxK>K%S9HreN-O; za%ydDZC??RW%M{_k7YE&Ah`>C$V%d&btRDr&j@ILV`?YUA^%4Ho~CTW5m*zcZk+s- zC=^x$kk%<26vAaQt66O3Iwx{Iyb<6SPjP=F8D;lzS$VW3%0(riU`|Id7@N`oO@SwS z4czTDZDg~AgU`!r?NP@swQT6g6Ba)!?`SJSu~#~TOa%4BYD}t zedI#caL3*zlydGmjseKe$H!-sM2_FTR~u zdC9cFGTEJX1J=#FI` z8EXQDn|(SLvu%56EaV@krF+7QUU27Vyuw*a1U?O6KUD|+E<)Xc8AL3FGzdm`TFC zk-`^-G+)x+2Utme073A4{|UD1UTq{(u(Ky!38lWQb>R|Bm#q92g&ZX>Z492-i$Zq% zZXbS-TWce5OwryX`j?4?IzoY)%oqmn|r=5WhC~fv9TD`$6hX5OF%95n;-`mfklu=weoL;5H&BjBfn=c3#d$JTeZ0@sHU=yPER+ty(Md4 z9618?+982f^~bUn_r+2;LIZuj?7r78K1}r)PT+25#UJj|z7~XyWS~nA{e-!BFpx{r z+mgpjUr*2W@h~$H5z)P|Q5fCkhEE|6FY{h`s3G;S_xSH@@teNvO{ld;e{DjI+Gq9i z3H3v*S>a>Hq#K5_Mdf*67r>dQBlnTu{7-Q(61^tuhOL-jS^l#aWx%K97N@Y7%cdMA_a@0SI zKpxwb%4nBLi2uj&^gkfET!wBaz2DzZj(8nGhGTy1blE zEE(yk&N+aHH{nyJBkzRZ*f{Hp?#rhbVjo5vTTLn^pVML@6TBDuXsgk3?jbCv!4F7BfO=H^9iY;Ma*Va3Ul{Zqw_X1wew~b7B-w@{~-C0REi8K`07QsfuI;JXZd_b-Rgq9IaAapy_CMCl$|3GVwh$j5x)|C5jZ-;s}Rp>P1_v=L>%5GFmB-#|i1 zZ!>|=1H7K3hGhmFKrsFl{}H&B^WeUyp1lg3^(9DR?j;dEssiOF@%iI6A7&ntTQ?gU zL)TG|OVXx-f)`L22CjHAY)p~5!UOmSrbAa@YieaBa^IDeTPN;xiC?mt)CtGTWh5VaZG+^OmaLq`0v&gA?l?@cR zim)?Q*~cqO<@KC6#T+f!sZnmSKO`uCn1bu+TX2}`_u<~W2RkG&Dmki7R8B>$#I8kX z*c~>hJpejn(KsBQjZ~Un2|qr!R0kmhRHq0l6Mh4>+eSmpC+YKi*7>PPWhAhDdV6{t z`4B@gpJ=0$eI~GQ-47&|g1|rbgvq?n;AGS^oaEp||8sIB7E9h&WcwRB!N2U%{O|A| zH;updA6EmO-(%UdO+Bj+uIbm7pmR|CmRT&8oMk!*MKEtT60zV}gluVZFa#l?l&jAj z*MDniYw}4kwn!WaSwwf=C&hq_I{NAnE{CY){>jifi~^VMn&?B0(wI|>fi;Ez8Oie% zcbh+8XKA~P8zd(Z`D4^kL;WXF$4$$^KVh=}Sw~yiOT^EF@Q4Q=A)MgKr?A484bGpT zRcVmIjAkuHC8K4(A6eIg@^W#-OK2DVGaK@c)O8MN6m{L?kJNQyvzQeaA)j!5bTaBUD7}i z=Cv|9nF0SPKeF=Q;74*|B>WI_bT!aKLN>3uA4flZ`O_PDk#4CEc9USTZlm3`;S=ZP z>t0&L^iA)W*yv|)y^CV%S!BxW^=Vf2`ZR-j51Wo(YB%#D zEp<<{IZMUwyEH+k$y8NUm3kRf_Np`sb-qit=pOJG-3(yWgQv?_wVaGspqvUNO`~P1 zn$8VQyT2y?cr6Uk-9o(bdUiqG>sC3T3JeSFR3{6U4C;h9Bskn6IciyC3Sq7KSxgNQ zeSFj%{`uL>2-462QG5yf$XsKA3u<`z#a*ErqtYDHqz4Z^wlaOouOB6t5V#q)k0Z99GuQ5w|xB>4kGGO*-l5J}QY zKR_hoG)IFTM}}SJ_p~Gkwet#6KZfUs5xFUIv@Q2pO$-U`7%zA7uyVJWDfe!o*q;O( ze@$Cn4m%q!9jZ3HvNaW z_7$SAFL5g>l=+sZWiw=O0b9QS`}y9L%4N>&&AxGii(b=a<#%pbdbzRyE%MowD`MAg zKz*pb3B<)|ZsXAo#z_<`GN!EakFZEdL9H*&v+3A%;akQ1rnbF|PabMhAiW3qUihb| z9Z)gs_fX*y{+l zh=VaG9FF-v=c8X!`cppojq@uEHa|%=MoOfziwUHm=;(Kcna8j+UmPh%je_9+zF6EQ?LiFz!PEvHU` zjM&_Cst<0;(aOlBw~kUTaM@aaX)XOSBf(g=6=~!Gw-^<2j3?XM2E_e5_xEi;zh0V= zJ)^4n`1a)|s4I_JRVl0SsMYIAS9dfeWL~CTpMXjBy`Cq3*2tcG@BqkS!2(SE4m;~5 zzn*o>ua1xWNgvx3>X#pta{g}IF)tsvwd`+jekPwh8MYjyKydO$wJ2Nhq>L$&xM&9( zk>UxpKV#58K$@ztB|=Yz8B$}4o^$2M>1%XsemHsfpPs47W++!gt*CG|J@+mU&DY8d z*X2Ue)V(JekX{SfC|O1;Y*oe_{b8IfaNPepPx8>aEmST0xc~7jp0=!>Zlmp2*A7T6kkCgwBbB=^Zj{Jmku0{55f=8l8+O)~{#>ohB zHd-DWIw*gzlDOk}Bs=nEafSp&yGy!vAStH5MCkYoi8NOuubm5S2tEG!?^%-}7)y&J z@sxjrn#)jqgPIdEpQzwB$zDjZOuo?Uzw7;zMLz#l+7H(;{fj;yHmu|-rE~~aB<*s| zx}Podc^RKi<1yA?j95Zuwa<{lQ2(LwX>pFa{E!^4wYok+XsPE~)LKn*rz_ z*(@%xG3Vv~!qy&oahwN#gqcg(4w7+%kc1@-9euiR<@9HT58A+;90vwqR6WrfLE(<#`rrj+35iVkNJj7X`To19YLt?~F>^ zW!>av+t3SPx`?tSX=d$PET#FYXnpq+Blw$MJqkL0@?^wvKIUb%t4NTfY-XvV1a7eG zu+;~|CDH4~H!q-{tpSo-$+_5wHH_Fy9zpy2TzS`>brFAEmsx{4|HYz*uREUszDb)d zb6|LQ>}r+bSfizbR)E$#skXUtgaYs_uHh6i)=}VKp)+uGKqmg(->-+fvk z{0kB}-a%k6(fSz25#o_&ivF`IlCt9H|6&#Cefa#EFde-9F?Nc3)X2Yrjh`+0t7=Sq zJw!l&1gkY6wAWW5g*AyX^!>?)GnA3ln9SW{_kl~}4?8Nmx@1yMz)uBgH>xLNy+*k@ z`dj<@-!R*T_Vo#Jv1^&^3OQAdAX(CPOZN8cC`579O9M{Ln@+tpx#DtaST{ zbZlDwJqal)$oTXd(&ybrly<~KZ~Y8WECpl>|2N<`!8hReORT>E9B173D*vxH==>=v za^&Zz$d)}+*M=9eN z9(lcrt9^P3c2a7QMSZ_LCr|(Nn3orw9eGBUp>9jB%(bx)=_uiqaP6+b3hhx5A#%`FmvXN+T!w&i_tDMmzqG6`3a@^mhQ>R>Ljnf9WvGt#*HAv5eitB%7(#(s$4z* zFsG(xW+33EA+%Ywsq#lu&sDigfa>YZMNO@nm;V|C`D5f!)cc=A9wh@&t1B-crZGQ# zdUNl{5*hxSjb{b#hOxZ;9(iJIPXu-nLdKCjerWRKxW8d`W@dS9?Saz?J!yhM zV>Hi`TK*2I94=^~lwT8$%(KsuTd}wsQSUtj%g<7duzt#(RISr=)J?zL9iQeqM{#!Z z7Zx@q0EG0{7B(_a2mS~YAF5&+y#MH`?m#O>|K=M8%;B;-44GQV&BShb)K|WK43R;< z`mtHcKdQj->2h|P+a-iPo_mGqJdfUdRyBsNTWRv*R~X+*D>LwxMhd9Wk$g|(@zMT{ z%5xv%cPh_j;Frrj3-1v+4?>@PslFU>V&4(BgXiUv5fAWv80^aERi%p`ARaUm_xGL= zCEhPt$QaC&Z)zw`onOFa<``zAu=HMVsBnqmfMQwuu;*9{?bwhYHPleEv0Jn-!i zWpyfqd|xqth)P4add4>4IW5X|wSfhU&h)W3H-->mslrj4jOg-3PqXWWb;h)GbPO1Y zN;dR#b(D0xMBe>deUxTsZxgYDHj*BFJP|Q(`F4xR$YL$yFzSn+x4;*RUbJt_yzMx_ z(-H1f?1@p%c|OA@+stHDxRQ9DbJ}-zQDxrb^GQl69EPex=h_Ci)B4%a44F0^HjPP) z4^lGf=KFAqyxh3gOe}@tGP}KORR#YCez8i0c|7Fr7r_}}x%Z!L2L0qey<~AyE<(VH zv_vKG19xN(YgJ4DCYvQC@NLS`%5!9Rp`iN~Md^^=@@69ZV=&d=IG3oD1pL&u(bc&{ zfuApa{&Y#>18pVGj&e_Q4plFdpc9o&@O=W~N$#BZN?=TNZpZR+xu03ZsI3-9irU0n zc7x=`^a(d^UfzfDy)m=1#)vwo?>=!zge}Z)VB-GpX~t$4es`QVvc1al4_3BdS366} zQCs|>-D$kLJMP;Q4|OPaSzZWz7P~xaYG=0uJ8#R3Fra3g$`>G2imF)y?XST3L*<11 zvkj-miieo9eQi2yz=#z6f3=-?IFxH2$CD)tPAb`QEM+|sV_(V=V~H6Yq?s`yGE=r9 zQ}$$QkY&m?D5Ok>sIeQ{6q)9jFk%qdlf8~KT6FH|yyyM%{qLQ>=X&nvdhYxFJ>Tno ze&5eGyVRpk2-*Q$!~i&Q4FrssEArt;+|hK-Ue0a?eM5GH`K@D3o2Zn9p-ZN~^ z9L~C*_XGBax`B6jg~jXV%OE`3ZfbM0E(j`|lprCHRcAT)nh(UHZN(U%0Eh?fdf{nf zV`FP8$?fNLJ;8PD2*3s<4AfkZo{V4(82zP|k1Y%~Nxc>p8w+QE+g&BX!HK_HF6{Os&G6cdd`9}$U+Tv5nQ&C(FCKSha>3^#IJ z@V|KRH!}LHi_SnSIwLc4`~m2&JKyX|&iBumGDes(lfWco!?d8EH#YVP`JSSH@G;24 zB|4oRx3it{h>m9VW7D{3%Z~{2@6Wf}o4u)pX$n(SA$jott1vp(xK#)dRudSqD0Qx7 zd`^}6{b*o!V6_Jb1ovMC2JhC6j*!8ElHSAK?%gXOSt;oBHuoFbk>cv~LVm+rz3lOE ziWhr=TJHS*m6T4@J7zIBmfsJgKh?q-OcN2tr+i_2i>7Hh!%x|K0=xSCOFbY&p895O zRZuIg$A0)HrjC{2R%_~G{dvT-p1s%ofV0<@kEh$Y%1%w(DEVw*))~MTaHAj1ea}1B zC4tI+0+2-+BJ7DC9IFsECpK+lZk~B;H-z7}(6q;DSJOuU7}12;^9Nb4%+kb3chikQ@$&OJ0vTU4dJx z`i0vNnegiNe$Wt!X?RvuANQ(GPW{EMIMp17T`mLWCfJ~OpR6gymh{g$r#QH1vyhw@ z54s(4>M-%n6pE?p%7$a$7;UJtzrX*>7ZZ(_PG_RndyI<91;z7cxt-*WrqOEwx3CSs)fJ5)N1=y}!vH*o`j~=os+`SX^;kNq`o&lc60(-$> zBZ#}womusf?-WD&#Kumxl;WM&vRD!p)mA}i=h4Gk4#j2+O7>^&q$R_h%(m}^!&w>b+@`;|(G~0f_B28E-OS*~$fxfzm zQQ_f!twwd)o||abkP`{X^?*UE)HTLr-a78IzII4fUn_9PjVRjZj(W6m3ool~nQYI1 zCn5N*2J7gXo39hhmSC@GjQrsSYq|VZfRZbF`eNN|N)P`HDIf8K#24x$J)(kY<8AWe zd+HFpI`0iiUe)#y1SnOi!<_ zxfw@)H*z9Mg)3r@S%Evm)R==t0kWPYDs=6Yht%-HXN~NJmc?VzH6PZumj%H29bnPe z&+k)McWzANIbc`jfM;EMdi?(* z0}G0Z937k@NJk{NPfa8j4cZ%h0S$=;4*6s=1Zc}EE9p;9u|dGNVaOz)GqOJJe2@Bi zpT%T~xd)s-uhPOtt*zalNAAb#n3+X~hFa_ajBpnTki}AG9<^14toGgJaM-!JAQD07 zMhVz#op}uFM?iC*IDR~Xnom#)gv5)*hIG>DLR;0}rn-2?^L7EyQ=jJa=pyYGk0(Oj zTo|J2nq2>b*dV#}Tpa{t3PjInEPaY3yCG4isIObqLD0%UyXzu;sm2H-QX{q5QxmFh z1Y%%BLo!lZwkz$KAcD2Nv3OWS2|s_ifbQ!pxc=NOO!6h#B!%e9@e)0l<3m<4P`XdB z92{Jk7aNT;pW!th3M!v1^@!6&A8*xtx4p2b#3gD7I&_<-ZXtM?@)te U_$hzR-35O3HgN05R%a9b2CyiECIA2c literal 0 HcmV?d00001 diff --git a/search/search_index.json b/search/search_index.json index b4211c3d..3933e927 100644 --- a/search/search_index.json +++ b/search/search_index.json @@ -1 +1 @@ -{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Home","text":"

A compendium of information and guides about arcade games. By the community, for the community.

Join our Discord server!

Troubleshooting forums are available on our Discord server if you need direct help!

This site is by no means all-encompassing

We're only a group of volunteers aiming to bring you the most up-to-date information.

But we're only humans, we make mistakes, and therefore:

  • Please use a certain degree of caution while manipulating your game files and make backups.
  • Don't tamper with things if you don't know what you're doing.

If you can do that, these guides will probably be of use to you. If not, don't tell us we didn't warn you!

How to use the site?

On the left side is a navigation bar containing every guide:

  • Games category for game-specific guides on how to setup data, troubleshoot issues, etc..
  • Error Codes for a listing of known errors and what to do about them.
  • Game Patching category for ways to patch/modify your game.
  • Extras for anything that doesn't fit in the above categories.
  • Other Resources for links to useful sites such as patchers, external guides, etc..

Do you want to help us out?

Please check out our GitHub Repo by clicking the link at the top of right of the page. Information on how to contribute is available there.

"},{"location":"resources/","title":"Other Resources","text":""},{"location":"resources/#spice2x-patchers","title":"Spice2x Patchers","text":"

See Spice2x Patching.

  • TWO-TORIAL - https://sp2x.two-torial.xyz/ - Our open-source patcher for Spice2x compatible games.
  • DJTrackers - https://djtrackers.com/bemanipatcher/2x - Recommended for anything we don't yet support. Our IIDX patches are based off of theirs for the most part.
"},{"location":"resources/#web-patchers","title":"Web Patchers","text":"

See Web Patching.

  • TWO-TORIAL - Our open-source web patcher (based on mon's) for games incompatible with Spice2x. Also integrates Scribbler's patches for chunithm.
  • mon's - The longest lasting web patcher, supports a variety of n-1 and older games.
  • Scribbler's Chuni Only Patcher - Has every version of Chunithm available.
"},{"location":"resources/#general","title":"General","text":"
  • Spice2x Wiki - The best resource for Spice2x
  • Bemaniwiki - A bemani wiki written in japanese
  • wikiwiki - A japanese game wiki, good for comparing against SilentBlue
  • Namuwiki - A korean wiki for bemani and more
  • RemyWiki - Bemani arcade games wiki with lots of useful info
  • SilentBlue - By RemyWiki's creators, but for SEGA games
"},{"location":"resources/#cons-cabs","title":"Cons & Cabs","text":"
  • GameRepair.info - Repository of arcade part repair & misc information
  • Cons&Stuff - Community resource for DIY controllers
  • Rhythm Game Cabs - Discord server for arcade cabs
"},{"location":"resources/#iidx","title":"IIDX","text":"
  • iidx.org - The go to guide for mechanics and skill related things
  • sp12 - IIDX SP\u260612 reference site/difficulty tier list
  • beatmania.app - IIDX INFINITAS difficulty tier list
  • Statistik - IIDX difficulty tier list
  • atwiki - IIDX wiki in JP (includes tier lists)
  • textage.cc - Chart viewing resource
  • DJ DAO IIDX troubleshooting guide - Step-by-step guide for FPS, FP7, PEE, RES, RED controllers.
"},{"location":"resources/#sdvx","title":"SDVX","text":"
  • sdvx.org - The go to guide for mechanics and skill related things
  • SDVX Index - SDVX chart viewer and reference
  • sdvx.in - worse alternative to SDVX Index (but can be used for Chunithm and Ongeki too)
  • SDVX Progress Chart - Functions as a generalized tier list
  • SDVX Unlock Guide - Translated guide for unlocks
"},{"location":"resources/#gitadora","title":"GITADORA","text":"
  • 573Controller - DIY guitar solution for converting official cab guitars to USB home-use
  • Drummania English Menu Translation - Handy for beginners, lots of options!
"},{"location":"resources/#chunithm","title":"CHUNITHM","text":"
  • sdvx.in - Chart viewer for CHUNITHM
  • CHUNITHM Humen - Screen captures of all CHUNITHM charts
  • Codex's English Chunithm Guide - Handy CHUNITHM resource for players of all skill levels
"},{"location":"resources/#ongeki","title":"O.N.G.E.K.I.","text":"
  • sdvx.in \u2013 Chart viewer for O.N.G.E.K.I.
  • O.N.G.E.K.I. Humen and MLN Rev \u2013 Screen captures of all O.N.G.E.K.I. charts
  • Lilyshy's English O.N.G.E.K.I. Guide \u2013 Handy O.N.G.E.K.I. resource for players of all skill levels
"},{"location":"errorcodes/bemani/","title":"BEMANI Error Codes","text":"

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.

"},{"location":"errorcodes/bemani/#universal-error-codes","title":"Universal Error Codes","text":""},{"location":"errorcodes/bemani/#5-0000-0000","title":"5-0000-0000","text":"

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.

"},{"location":"errorcodes/bemani/#5-2000-0000","title":"5-2000-0000","text":"

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.

"},{"location":"errorcodes/bemani/#5-2002-0915","title":"5-2002-0915","text":"

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.

"},{"location":"errorcodes/bemani/#5-2600-0000","title":"5-2600-0000","text":"

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.

"},{"location":"errorcodes/bemani/#iidx-error-codes","title":"IIDX Error Codes","text":""},{"location":"errorcodes/bemani/#5-1500-0002","title":"5-1500-0002","text":"

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.

"},{"location":"errorcodes/bemani/#5-1503-0004","title":"5-1503-0004","text":"

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.

"},{"location":"errorcodes/bemani/#5-1505-0001","title":"5-1505-0001","text":"

SSD DATA ERROR

This error occurs when the data is horribly corrupt, incomplete, or modified incorrectly. Please redownload your data from a reliable source.

"},{"location":"errorcodes/bemani/#5-1503-0042","title":"5-1503-0042","text":"

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 patch 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.

"},{"location":"errorcodes/bemani/#5-1506-0001","title":"5-1506-0001","text":"

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.

"},{"location":"errorcodes/bemani/#sound-voltex-error-codes","title":"Sound Voltex Error Codes","text":""},{"location":"errorcodes/bemani/#5-1506-0000","title":"5-1506-0000","text":"

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.

"},{"location":"errorcodes/bemani/#5-2009-0000","title":"5-2009-0000","text":"

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.

"},{"location":"errorcodes/bemani/#popn-error-codes","title":"Pop'n Error Codes","text":""},{"location":"errorcodes/bemani/#5-1509-0000","title":"5-1509-0000","text":"

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.

"},{"location":"errorcodes/bemani/#5-2002-2400","title":"5-2002-2400","text":"

This error was seen on Pop'n Usaneko due to improper setup and bad parameter usage in SpiceTools, make sure to follow the Game 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.

"},{"location":"errorcodes/bemani/#jubeat-error-codes","title":"Jubeat Error Codes","text":""},{"location":"errorcodes/bemani/#5-2500-0000","title":"5-2500-0000","text":"

BACKUP DATA ERROR

Follow the steps listed here

"},{"location":"errorcodes/bemani/#gitadora-error-codes","title":"GITADORA Error Codes","text":""},{"location":"errorcodes/bemani/#5-1698-0000","title":"5-1698-0000","text":"

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\\\n- \\contents\\data\\product\\aep\\\n

Also, remove the following files from these folders.

- battle_matching_3.bin\n- beargarden_3.bin\n- common_3.bin\n- custom_3.bin\n- entry_3.bin\n- game_combo_3.bin\n- game_common_3.bin\n- game_dm_3.bin\n- game_gf_3.bin\n- game_session.bin\n- home.bin\n- mission_result.bin\n- record_3.bin\n- select_music_3.bin\n- tab_3.bin\n- title_3.bin\n- warning_3.bin\n
"},{"location":"errorcodes/bemani/#5-1506-0000_1","title":"5-1506-0000","text":"

Disable all the unused network adapters inside device manager (make sure to view the hidden ones as well and disable those too!)

"},{"location":"errorcodes/bemani/#5-2500-0001","title":"5-2500-0001","text":"

BACKUP DATA ERROR

Follow the steps listed here

"},{"location":"errorcodes/bemani/#5-2501-0000","title":"5-2501-0000","text":"

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.

"},{"location":"errorcodes/bemani/#nostalgia-error-codes","title":"NOSTALGIA Error Codes","text":""},{"location":"errorcodes/bemani/#5-1501-0000","title":"5-1501-0000","text":"

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.

"},{"location":"errorcodes/sega/","title":"SEGA Error Codes","text":"

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.

"},{"location":"errorcodes/sega/#universal-game-error-codes","title":"Universal Game Error Codes","text":""},{"location":"errorcodes/sega/#0000","title":"0000","text":"

Unexpected Error Occured

This error occurs when the data is horribly corrupt, incomplete, or modified incorrectly. Please redownload your data from a reliable source.

"},{"location":"errorcodes/sega/#0032","title":"0032","text":"

Unexpected Error Occured

Generic network error with multiple symptoms, the most typical of which being enabling DHCP in Windows while the game expects a static IP. Try adding this to config_hook.json:

{\n    \"network\": {\n        \"property\": {\n            \"dhcp\": true\n        }\n    }\n}\n

Tip

If you're copying into an existing config_hook.json, remove the outer braces and add a comma to the previous item, like so:

{\n    \"emoney\": {\n        \"enable\": false\n    },// (1)!\n    \"network\": {\n        \"property\": {\n            \"dhcp\": true\n        }\n    }\n}\n
  1. Notice the comma here.

Tip

If your game files does not include config_hook.json, it is OK to create a new file, then edit the launch script (usually start.bat) to tell the game about it:

amdaemon.exe -f -c config_common.json config_server.json config_client.json config_hook.json\n
"},{"location":"errorcodes/sega/#0800","title":"0800","text":"

Unknown Error

Generic network error usually thrown because the game is not able to connect to a server.

Make sure that you have correctly entered your network's address in segatools.ini under the [dns] section: 

[dns]\n; Can also be an IP address:\n; default=192.168.34.23\ndefault=example.com\n

"},{"location":"errorcodes/sega/#0919","title":"0919","text":"

DVD Drive Remain Error

This error occurs if the game detects an enabled DVD drive on the system. To resolve, either disable your computer's DVD drive, or enable DVD drive emulation in segatools.ini:

[dvd]\nenable=1\n
"},{"location":"errorcodes/sega/#0949","title":"0949","text":"

Keychip Not Found

Enable keychip emulation in segatools.ini:

[keychip]\nenable=1\n

If on a real cabinet using a real keychip, confirm that the keychip is connected properly and working.

"},{"location":"errorcodes/sega/#4104","title":"4104","text":"

Unexpected Error Occured

Make sure that the game files are not on the E: or Y: drive. If that is already the case, check if the config files passed to AM Daemon exists and are valid JSON files:

Runtime exception occurred.\nFile: D:\\Jenkins\\workspace\\amdaemon_all_build\\libs\\amdproc\\src\\ConfigFileLoader.cpp\nLine: 79\nFunction: enum amdaemon::process::ConfigFileLoader::Result __cdecl `anonymous-namespace'::parse(const class std::basic_string<wchar_t,struct std::char_traits<wchar_t>,class std::allocator<wchar_t> > &,class picojson::value &)\nMessage: Cannot open \"config_nonexistent.json\".\n
Runtime exception occurred.\nFile: D:\\Jenkins\\workspace\\amdaemon_all_build\\libs\\amdproc\\src\\ConfigFileLoader.cpp\nLine: 89\nFunction: enum amdaemon::process::ConfigFileLoader::Result __cdecl `anonymous-namespace'::parse(const class std::basic_string<wchar_t,struct std::char_traits<wchar_t>,class std::allocator<wchar_t> > &,class picojson::value &)\nMessage: Cannot parse \".\\config_hook.json\".\nsyntax error at line 6 near: }\n
"},{"location":"errorcodes/sega/#4105","title":"4105","text":"

Unexpected Error Occured

Check the AM Daemon window for any \"runtime exception\" messages, such as

amsGfetcherThreadContextInit: Line1345  Error: load Icf failed.\nRuntime exception occurred.\nFile: D:\\Jenkins\\workspace\\amdaemon_all_build\\libs\\libamw\\src\\amw_netdeliver_context.cpp\nLine: 91\nFunction: enum am::util::ModuleContext<3>::Status __cdecl am::netdeliver::Context::initialize(void)\nMessage: amGfetcherInit(). ErrCode -1.\n

Then continue by checking AMDaemon error codes.

"},{"location":"errorcodes/sega/#6401","title":"6401","text":"

I/O board is not connected to main board

This error occurs when the game times out trying to communicate with the I/O board.

When using segatools, this happens because I/O emulation took too long, which is usually caused by long-running background tasks (e.g. Windows Defender, Windows Update, file-syncing software). Try to see if this can be fixed by setting the game process and/or amdaemon.exe to high/realtime priority.

"},{"location":"errorcodes/sega/#6501","title":"6501","text":"

Aime Card Reader Not Found

This error occurs when an Aime card reader is not found. Make sure you enabled Aime card reader emulation in segatools.ini if you don't have a physical reader connected:

[aime]\nenable=1\n
"},{"location":"errorcodes/sega/#6503","title":"6503","text":"

Failed to read Aime card

This error occurs when the Aime card cannot be read. Make sure your connection to the ALL.Net server is good (the network icon in the bottom corner is green).

"},{"location":"errorcodes/sega/#8114","title":"8114","text":"

ALL.Net System error (RTC)

Make sure you're connected to an ALL.Net server for the first boot, or disable accounting by editing config_hook.json:

{\n    \"allnet_accounting\": {\n        \"enable\": false\n    }\n}\n

Tip

If you're copying into an existing config_hook.json, remove the outer braces and add a comma to the previous item, like so:

{\n    \"emoney\": {\n        \"enable\": false\n    },// (1)!\n    \"allnet_accounting\": {\n        \"enable\": false\n    }\n}\n
  1. Notice the comma here.

Tip

If your game files does not include config_hook.json, it is OK to create a new file, then edit the launch script (usually start.bat) to tell the game about it:

amdaemon.exe -f -c config_common.json config_server.json config_client.json config_hook.json\n
"},{"location":"errorcodes/sega/#chunithm-error-codes","title":"CHUNITHM Error Codes","text":""},{"location":"errorcodes/sega/#3101","title":"3101","text":"

An unexpected error has occurred with the main device

This error occurs when the game fails to communicate with the controller. Check if your controller is connected properly and if ChuniIO DLLs are working.

"},{"location":"errorcodes/sega/#3102","title":"3102","text":"

Initialization failure with the main device

This error occurs when the game fails to communicate with the controller. Check if your controller is connected properly and if IO DLLs are working.

"},{"location":"errorcodes/sega/#3201-3202-3203-3204-3205-3206","title":"3201, 3202, 3203, 3204, 3205, 3206","text":"

Cannot confirm the connection with the side device sensor 1/2/3/4/5/6

This error occurs if the air sensors are not functional or blocked during system test. To resolve this, enter and exit Test mode by pressing the F1 key (or 1 on older segatools) then stay clear of your controller. If the error still happens, your air sensors may be faulty.

"},{"location":"errorcodes/sega/#3300","title":"3300","text":"

Duplicate servers in the same network

If multiple CHUNITHM machines are on the same LAN network, only one of them can be the server (dip switch 1 ON). Set all other machines to dip switch 1 OFF:

[system]\ndipsw1=0\n

Warning

As of 2024-08-20, the [gpio] section in segatools has been renamed to [system].

"},{"location":"errorcodes/sega/#3301","title":"3301","text":"

Duplicate STANDARD in the same group

If multiple CHUNITHM machines are on the same LAN network and cabinet group (A/B/C/D), one of them should set reference machine settings to STANDARD and the rest to FOLLOW THE STANDARD. Change this by going to Test menu -> Game Settings (4th option) -> Reference machine settings (2nd option).

"},{"location":"errorcodes/sega/#3400","title":"3400","text":"

Monitor Not Supported 120fps

This error occurs if you're running the game in SP mode but the monitor is not 1920x1080@120Hz in 32-bit color mode. Adjust display settings and try again.

"},{"location":"errorcodes/sega/#3401","title":"3401","text":"

Machine Not Supported 120fps

This error occurs if you're running the game in CVT mode at 120fps. Use SP mode (dip switch 3 OFF) to run the game in 120fps. In segatools.ini this would be:

[system]\ndipsw3=0\n

Warning

As of 2024-08-20, the [gpio] section in segatools has been renamed to [system].

"},{"location":"errorcodes/sega/#amdaemon-error-codes","title":"AMDaemon Error Codes","text":""},{"location":"errorcodes/sega/#ampdgd1232a01ainit-errcode-4","title":"ampdGd1232a01aInit(). ErrCode -4","text":"

This error occurs because of a VFD port number mismatch. Update segatools, or if you're using a real VFD, confirm that the VFD uses the same port as specified in config_common.json or config_sp.json (CHUNITHM) under emoney.display_port:

\"emoney\" :\n{        \n    \"display_port\" : 2 // (1)!\n}\n
  1. This should match the COM port that your real VFD is connected to.
"},{"location":"errorcodes/sega/#amappimageinit-errcode-5","title":"amAppImageInit(). ErrCode -5","text":"

Path to the configured AMFS directory is too long. Ensure that the path is shorter than 16 characters (32 bytes).

"},{"location":"errorcodes/sega/#regcreatekeyexw-errorcode-5","title":"RegCreateKeyExW(). ErrorCode -5","text":"

This error occurs because the Windows registry cannot be written to as a normal user. Start the game as administrator once, or update segatools.

"},{"location":"errorcodes/sega/#amsysfileinitex-errcode-5","title":"amSysFileInitEx(). ErrCode -5","text":"

The AMFS folder is read only. Uncheck the read only property in File Explorer for the AMFS folder.

"},{"location":"errorcodes/sega/#amgfetcherinit-errcode-1","title":"amGfetcherInit(). ErrCode -1","text":"

ICF1 is missing in the configured AMFS directory. Get the correct ICF for your game (the game ID in the ICF must be correct).

"},{"location":"extras/ascs/","title":"Most Common ASCs and Vendors","text":"

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.

"},{"location":"extras/ascs/#iidx","title":"IIDX","text":""},{"location":"extras/ascs/#dj-dao-fp7-emp","title":"DJ DAO FP7 EMP","text":"

This controller works really well, the spacing is accurate 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.

"},{"location":"extras/ascs/#phoenixwan","title":"PHOENIXWAN","text":"

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.

"},{"location":"extras/ascs/#yuancon-iidx","title":"YuanCon IIDX","text":"

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.

"},{"location":"extras/ascs/#iidx-arcade-parts-to-consider","title":"IIDX Arcade Parts to Consider","text":"

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

  • 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.

    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.

"},{"location":"extras/ascs/#sound-voltex","title":"Sound Voltex","text":""},{"location":"extras/ascs/#dj-dao-svse5","title":"DJ DAO SVSE5","text":"

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.

"},{"location":"extras/ascs/#yuancon-sdvx","title":"YuanCon SDVX","text":"

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.

"},{"location":"extras/ascs/#dj-dao-svre9","title":"DJ DAO SVRE9","text":"

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.

"},{"location":"extras/ascs/#sdvx-arcade-parts-to-consider","title":"SDVX Arcade Parts to Consider","text":"

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

  • Springs and Microswitches

    For springs and microswitches, most vendor 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

"},{"location":"extras/ascs/#popn-music","title":"Pop'n Music","text":""},{"location":"extras/ascs/#dj-dao-pop-asc","title":"DJ DAO POP ASC","text":"

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 and getting Samduck buttons, 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 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.

"},{"location":"extras/ascs/#yuancon-popn","title":"YuanCon Pop'n","text":"

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, 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 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.

"},{"location":"extras/ascs/#jubeat","title":"jubeat","text":""},{"location":"extras/ascs/#dj-dao-fb9","title":"DJ DAO FB9","text":"

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 that matches arcade play far better for a more accurate and enjoyable experience. The biggest difference is in how multiple buttons are pressed 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 provides better replacements and official ones can be bought on sites like Yahoo Auctions Japan 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.

"},{"location":"extras/ascs/#ddr","title":"DDR","text":""},{"location":"extras/ascs/#stepmaniax-stage","title":"StepManiaX Stage","text":"

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.

"},{"location":"extras/ascs/#l-tek-pads-aka-polish-dance-pads","title":"L-Tek pads (AKA Polish Dance Pads)","text":"

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.

"},{"location":"extras/ascs/#vendors","title":"Vendors","text":""},{"location":"extras/ascs/#gamo2","title":"Gamo2","text":"
  • Website: https://www.gamo2.com

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 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.

"},{"location":"extras/ascs/#yuancon","title":"YuanCon","text":"
  • Website: https://yuancon.store

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 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 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.

"},{"location":"extras/ascs/#steprevolution-stepmaniax","title":"StepRevolution (StepManiaX)","text":"
  • Website: https://shop.steprevolution.com/

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!

"},{"location":"extras/ascs/#l-tek-iamats","title":"L-Tek / iamats","text":"
  • Website: https://www.iamats.com//

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.

"},{"location":"extras/asphyxia/","title":"How to setup Asphyxia CORE","text":"

If this isn't your first time setting up Asphyxia, make sure to backup your savedata folder and place it somewhere safe.

"},{"location":"extras/asphyxia/#what-is-asphyxia-core","title":"What is Asphyxia CORE?","text":"

Asphyxia CORE is a local e-amuse emulator which includes score saving and customization. The software itself does not support any game out of the box. For this, you need plugins.

"},{"location":"extras/asphyxia/#configuring-asphyxia","title":"Configuring Asphyxia","text":"

First, grab the latest release here. In almost all cases, you will use the asphyxia-core-win-x64.zip. Next, open the .zip file and extract the plugins folder and asphyxia-core-x64.exe into the contents folder of your desired game. We will use SDVX EG for this example.

Your contents folder should look like this then:

For Asphyxia to run properly, you will need a plugin for each game you want to use it with.

  • Join our Discord server.
  • Look for your game's channel, then the pinned Resources post.
  • Download the plugin archive and open it.
  • It should contain a folder such as sdvx@asphyxia or iidx@asphyxia.
  • Put that folder in your Asphyxia plugins folder, typically contents\\plugins\\ and overwrite files if needed.

Note: We do NOT provide plugins for every game.

Run asphyxia-core-x64.exe to start the server. It will automatically open a browser tab. This is your WebUI.

"},{"location":"extras/asphyxia/#changing-service-url","title":"Changing Service URL","text":"

Run spicecfg.exe, head over to the Options tab and look for EA Service URL. In there, you need to input what is displayed on the Asphyxia WebUI on the Dashboard at the right side.

For me, it's localhost:8083 and should look like this:

"},{"location":"extras/asphyxia/#setting-up-sdvx","title":"Setting up SDVX","text":"

On the WebUI, click on SDVX on the left-hand bar and click on Import Assets. In here, paste the path of your contents folder.

In my case, it's D:\\BEMANI\\SDVX\\guide\\KFC-2021083100\\contents. Make sure you're using the correct path as it won't work otherwise. When you've done that, click on Submit. After a few seconds, a pop-up should appear saying Imported successfully!

Go to SDVX on the left-hand bar, then Profiles and click on the green Detail button on your preferred profile. Click on Setting on the top bar and try changing some customization settings at the bottom. If they are working, head over to Changing Service URL. If they appear broken, completely close Asphyxia and continue reading.

Head to the contents folder of your game again. If you have inserted the correct path when Importing and everything worked without any errors, you will have a folder called webui. Copy this folder and paste it into plugins\\sdvx@asphyxia. Overwrite any files if prompted to. Now close then re-run asphyxia-core-x64.exe and everything should function as intended.

"},{"location":"extras/asphyxia/#setting-up-iidx","title":"Setting up IIDX","text":"

You have already done all the step required to have it working. Simply create a profile and it will be visible on the WebUI.

You're all done! Enjoy your game!

"},{"location":"extras/audio/","title":"What is WASAPI & ASIO?","text":"

WASAPI and ASIO are audio systems that manage how your applications like games, music, and others interact with your audio hardware. Without these core systems you would not be able to hear anything. This is a basic explanation on what they are and will not go into detail on how they function. There are 3 types that I'll cover here with pros and cons for each one.

I would personally recommend using WASAPI Shared as this has in most cases the highest chance of working and requires the least amount of work. You can enable it by using a patch.

If you would like to use WASAPI Exclusive, you can read more about it here.

"},{"location":"extras/audio/#wasapi-shared","title":"WASAPI Shared","text":"

WASAPI Shared mode is the standard mode that Windows uses. This allows you to hear multiple audio sources at once and allows programs to capture audio with programs like OBS and Discord. While this is nice for using windows and playing most games, this has a negative side effect of increasing audio latency.

Pros:

  • Multiple audio sources can be sent to one audio device.
  • Can capture audio using OBS or Discord.
  • Supports almost all audio hardware as this is the standard for Windows.
  • Easy to set up.

Cons:

  • Higher Latency.
  • Poor/Hard to configure for low latency.
  • USB audio devices are not supported (DAC).
"},{"location":"extras/audio/#wasapi-exclusive","title":"WASAPI Exclusive","text":"

WASAPI Exclusive mode is a secondary mode which allows one program to take complete control over an audio device. This allows an application to do anything to your audio device including changing settings like change volume, sample rates, and buffer size. With this in mind, this also bypasses a lot of latency that is introduced with multiple applications playing their own audio.

The main downside is that you can only hear one audio source (the program that has control). In this case for example, beatmaniaIIDX would take complete control and you would not be able to hear applications like Discord. You cannot capture audio while running this mode without special software.

Pros:

  • Low Latency (Real Time Latency)
  • Supports almost all audio hardware as this is the standard for Windows.

Cons:

  • Application controls the hardware.
  • Not easily configurable.
  • Can not capture audio with OBS or Discord (Can be done, but requires a lot of configuration and can introduce latency. Switching to WASAPI Shared mode is recommended for this use case).
  • USB audio devices are not supported (DAC).
"},{"location":"extras/audio/#asio","title":"ASIO","text":"

ASIO stands for Audio Stream Input/Output. This is an audio driver designed for Audio Interfaces on Windows that is very similar to WASAPI Exclusive.

The biggest difference between ASIO and WASAPI Exclusive is software/hardware support and age. In order to use ASIO, both your hardware and the application you are using must support ASIO. For example, Sound Voltex supports ASIO natively but it does take a bit to set up compared to WASAPI Exclusive. ASIO also has higher configurability.

Pros:

  • Low Latency (Real Time Latency)
  • Highly Configurable
  • Industry standard for musicians means tons of support documentation.

Cons:

  • Limited Hardware Support
  • Application controls hardware.
  • Can not capture audio with OBS or Discord (Can be done, but requires a lot of configuration and can introduce latency. Switching to WASAPI Shared mode is recommended for this use case).
  • Requires a powerful CPU.
"},{"location":"extras/datamods/","title":"Data Mods and Omnimix","text":"

This guide will cover how to mod your BEMANI game's data folder in a non-destructive way.No files will be removed or overwritten.

"},{"location":"extras/datamods/#pre-requisites","title":"Pre-requisites","text":"
  • A fully working and unmodified game.
  • The data to mod your game with.

ATTENTION

  • Please make sure the mod you're installing is compatible with YOUR specific game and game version.
  • If connecting to an online network, make sure they explicitly allow the mod you're about to install.
  • TWO-TORIAL will NOT provide support with issues caused by mods besides Omnimix for beatmania IIDX.
"},{"location":"extras/datamods/#preparing-data_mods","title":"Preparing data_mods","text":"

Let's place your mod files in the right folder.

  • Create a data_mods folder next to the others in your game files.

Depending on how your mod is packaged, you may or may not need to create another folder to contain it. Inside that folder, the structure should follow the one in data/.

  • Place your files inside that data_mods/mod_folder/.

If you're confused, the following may help you understand what this means.

\u251c\u2500 data/\n\u251c\u2500\u2500\u2500 graphic/\n\u251c\u2500\u2500\u2500 info/\n\u251c\u2500\u2500\u2500 movie/\n\u251c\u2500\u2500\u2500 sound/\n\u251c\u2500\u2500\u2500 etc...\n\u251c\u2500 data_mods/  \n\u251c\u2500\u2500\u2500 mod_folder/\n\u251c\u2500\u2500\u2500\u2500\u2500 graphic/ <- files that mod the /data/graphic/ folder go here\n\u251c\u2500\u2500\u2500\u2500\u2500 info/ <- files that mod the /data/info/ folder go here\n\u251c\u2500\u2500\u2500\u2500\u2500 movie/ <- files that mod the /data/movie/ folder go here\n\u251c\u2500\u2500\u2500\u2500\u2500 sound/ <- files that mod the /data/sound/ folder go here\n\u251c\u2500\u2500\u2500\u2500\u2500 etc...\n\u251c\u2500 dev/ \n\u251c\u2500 modules/  \n\u251c\u2500 prop/  \n

Example: Omnimix for beatmania IIDX 31 EPOLIS

Directory: contents/data_mods/

Directory: contents/data_mods/omnimix_31

"},{"location":"extras/datamods/#loading-data_mods","title":"Loading data_mods","text":""},{"location":"extras/datamods/#installing-ifs_layeredfs","title":"Installing ifs_layeredfs","text":"

We now need a way for our game to load our mods.

  • Download the most recent release of ifs_layeredfs.

  • Open the archive.

What we're interested in are the 64bit and 32bit folders:

  • Your game is 32bit (spice.exe to launch): go in the 32bit folder.
  • Your game is 64bit (spice64.exe to launch): go in the 64bit folder.

  • Copy the ifs_hook.dll file to your game's modules folder.

"},{"location":"extras/datamods/#loading-ifs_layeredfs","title":"Loading ifs_layeredfs","text":"

All that should be left to do is tell spice2x to load ifs_hook.dll.

  • Open your game's spicecfg.exe.
  • Head to the options tab.
  • Find the Inject DLL Hooks option under Common and type in ifs_hook.dll then press Enter.

Note: If you have other DLL hooks, simply add more by having a space in between them.. Example: ifs_hook.dll somehook.dll

Assuming your data_mods folder has been made properly, that's it!

Extra step for beatmania IIDX Omnimix

You also need to patch your game's DLL with the Omnimix patch.

For more information on how to patch your game, head over to the Spice2x Patching page!

"},{"location":"extras/hexguide/","title":"Manual DLL Hex Editing","text":"

Before proceeding

This guide should ONLY be used as a last resort if all other methods fail. It has a high chance of breaking your game, make backups.

"},{"location":"extras/hexguide/#preamble","title":"Preamble","text":"

We're going to patch Beatmania IIDX 25 CANNON BALLERS, however the process is similar for other BEMANI games.

Here's what you'll need:

  • Your favorite hex editor, here we'll be using HxD.
  • A clean copy of your desired BEMANI game.
  • A backup of your original .dll before editing.
"},{"location":"extras/hexguide/#getting-started","title":"Getting Started","text":"

Decide on what hex edits you want to apply, you may find that information from the community or our Resources.

It's time to open our hex editor. If you're using HxD, you'll be greeted with the screen below.

Open your game's .dll file in the hex editor.

For the grand majority of hex edits, this is the main game file, such as bm2dx.dll, soundvoltex.dll, etc..

Pictured below, we've opened up bm2dx.dll inside HxD.

Attention

The edit we'll be applying is EXCLUSIVE to this version of the game and serves as an example.

This means it will not work on any other version of the game, nor any other game! Hex edits modify specific memory addresses that only apply to very specific game versions.

We'll be editing our game to Unlock All Songs and its edit is:

  • Offset: 0xB60B2
  • Original: 74 10
  • Modified: 90 90

In HxD we're going to hit Ctrl+G to open the Goto window.

From here, we'll input the offset B60B2 in the Offset section as shown below, and hit OK.

Our cursor should be taken to the offset at the exact location you want to edit.

As you can see, the numbers in front of the cursor are 74 and 10 which corresponds to what we need to replace.

If there's a mismatch, it's likely the offset you've put in was wrong, so be sure to double check!

Now all we need to do is select 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 now look as shown below.

Lastly, simply save your file and repeat these steps for any other edits you want to apply!

If at any point your game has issues due to your edits, restore your backup.

"},{"location":"extras/parts/","title":"Arcade Part Documentation","text":"

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 provide alongside these variants.

7/26/2020 IMPORTANT Notice:

Rakuten has switched to separate services, namely Rakuten Ichiba and Rakuten Global Express, they have provided an FAQ here. 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.

"},{"location":"extras/parts/#iidx-buttons","title":"IIDX Buttons","text":""},{"location":"extras/parts/#sanwa","title":"Sanwa","text":"

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
      • Sanwa Rakuten (Official JP Store) - Lamp-less
      • Buyee (Rakuten Proxy) - Old Lamp Holder With Lamp
      • Buyee (Rakuten Proxy) - Old Lamp Holder Lamp-less
      • IST MALL (KR Seller)
  • OBSA-45UK-B (Black keys)
    • Where to buy:
      • Sanwa Rakuten (Official JP Store) - With Lamp
      • Sanwa Rakuten (Official JP Store) - Lamp-less
      • Buyee (Rakuten Proxy) - Old Lamp Holder With Lamp
      • Buyee (Rakuten Proxy) - Old Lamp Holder Lamp-less
      • IST MALL (KR Seller)

Square Menu/Option Buttons

  • OBSA-30UK
    • Where to buy:
      • Sanwa Rakuten (Official JP Store - With Lamp)
      • Sanwa Rakuten (Official JP Store - Lamp-less)
"},{"location":"extras/parts/#samduck","title":"Samduck","text":"

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)

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)

"},{"location":"extras/parts/#sdvx-buttons","title":"SDVX Buttons","text":""},{"location":"extras/parts/#sanwa_1","title":"Sanwa","text":"

Square BT Gameplay Buttons

  • Sanwa OBSA-60UK
    • Where to buy:
      • Sanwa Rakuten (Official JP Store)
      • Buyee (Rakuten Proxy) - Old Lamp Holder With Lamp
      • Buyee (Rakuten Proxy) - Old Lamp Holder Without Lamp

Rectangular FX Gameplay Buttons

  • OBSA-45UK-B (Black FX keys)
    • Where to buy:
      • Sanwa Rakuten (Official JP Store - With Lamp)
      • Sanwa Rakuten (Official JP Store - Lamp-less)
      • Buyee (Rakuten Proxy) - Old Lamp Holder With Lamp
      • Buyee (Rakuten Proxy) - Old Lamp Holder Lamp-less

Start Button

  • OBSA-30UK
    • Where to buy:
      • Sanwa Rakuten (Official JP Store - With Lamp)
      • Sanwa Rakuten (Official JP Store - Lamp-less)
"},{"location":"extras/parts/#samduck_1","title":"Samduck","text":"

Rectangular FX Gameplay Buttons

  • CWB 405
    • Where to buy:
      • IST MALL (KR Seller)

Start Button

  • CWB 406
    • Where to buy:
      • IST MALL (KR Seller)

"},{"location":"extras/parts/#sdvx-encoders","title":"SDVX Encoders","text":""},{"location":"extras/parts/#options","title":"Options","text":"

Copal Encoders

  • RES20D-50-201-1
    • Where to buy:
      • Octopart (Lists Multiple Sellers)
      • GAMO2 (Upgrade set from stock Chinese, CN seller)

YuanCon's Encoders

  • Where to buy:
    • Tabobao (CN Seller)

Sensatec Encoders (Arcade)

  • ELV-24Y36A-K (GAMO2 Arcade Encoders)
    • Where to buy:
      • Sensatec (JP Seller)
      • Metro Electric (JP Seller)
  • ELV-24M36A-K
    • Where to buy:
      • Sensatec (JP Seller)

"},{"location":"extras/parts/#popn-buttons","title":"Pop'n Buttons","text":""},{"location":"extras/parts/#sanwa_2","title":"Sanwa","text":"

Circular Dome Gameplay Buttons

  • OBSA-100UMQ
    • Comes with 200N springs and 200g Omron switches.
    • Where to buy:
      • Sanwa Rakuten (Official JP Store) - With Lamp
      • Sanwa Rakuten (Official JP Store) - Lamp-less
      • Buyee (Rakuten Proxy) - Old Lamp Holder With Lamp
      • Buyee (Rakuten Proxy) - Old Lamp Holder Lamp-less
"},{"location":"extras/parts/#samduck_2","title":"Samduck","text":"

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)

"},{"location":"extras/parts/#jubeat-rubbers","title":"Jubeat Rubbers","text":""},{"location":"extras/parts/#options_1","title":"Options","text":"

ZhouSensor

  • Where to buy:
    • ZhouSensor Taobao Store(CN)

"},{"location":"extras/parts/#microswitches","title":"Microswitches","text":""},{"location":"extras/parts/#omron","title":"Omron","text":"

25g Microswitches

- D2MV-01-1C2 (GAMO2 and YuanCon provided)\n    - Where to buy:\n        - [Digikey (US Seller)](https://www.digikey.com/product-detail/en/omron-electronics-inc-emc-div/D2MV-01-1C2/Z4707-ND/5236583)\n        - [Sanwa Rakuten (Official JP Store)](https://item.rakuten.co.jp/sanwadenshi/ilumb_222/)\n        - [IST MALL (KR Seller)](http://istmall.co.kr/us/goods/goods_view.php?goodsNo=1009992803)\n        - [Buyee (Rakuten Proxy)](https://buyee.jp/rakuten/detail/sanwadenshi%3A10000320)\n\n- VX-01-1C22\n    - Where to buy:\n        - [Digikey (US Seller)](https://www.digikey.com/product-detail/en/omron-electronics-inc-emc-div/VX-01-1C22/Z4644-ND/369961)\n        - [Mouser (US Seller)](https://www.mouser.com/ProductDetail/Omron-Electronics/VX-01-1C22?qs=1tDaWCEHQQ6vTHtQABSaag%3D%3D)\n

50g Microswitches

- D2MV-01-1C3 (GAMO2 provided)\n    - Where to buy:\n        - [Digikey (US Seller)](https://www.digikey.com/product-detail/en/omron-electronics-inc-emc-div/D2MV-01-1C3/Z4708-ND/5236584)\n        - [Sanwa Rakuten (Official JP Store)](https://item.rakuten.co.jp/sanwadenshi/ilumb_223/)\n        - [IST MALL (KR Seller)](http://istmall.co.kr/us/goods/goods_view.php?goodsNo=1009992804)\n        - [Buyee (Rakuten Proxy)](https://buyee.jp/rakuten/detail/sanwadenshi%3A10000321)\n- VX-01-1C23\n    - Where to buy:\n        - [Digikey (US Seller)](https://www.digikey.com/product-detail/en/omron-electronics-inc-emc-div/D2MV-01-1C3/Z4708-ND/5236584)\n        - [Mouser (US Seller)](https://www.mouser.com/ProductDetail/Omron-Electronics/D2MV-01-1C3?qs=HDDQUw%2F3Phqm1Y5wA%2Fdz9w%3D%3D)\n

100g Microswitches

- V-10-1A4 (Arcade default, GAMO2 provided)\n    - Where to buy:\n        - [Digikey (US Seller)](https://www.digikey.com/product-detail/en/omron-electronics-inc-emc-div/V-10-1A4/Z4588-ND/1828942)\n        - [IST MALL (KR Seller)](http://istmall.co.kr/us/goods/goods_view.php?goodsNo=1009992411)\n        - [Buyee (Rakuten Proxy)](https://buyee.jp/rakuten/detail/sanwadenshi%3A10000283)\n
"},{"location":"extras/parts/#gersung","title":"Gersung","text":"

60g Microswitches

  • GSM-V0303A06
    • Advertised as \"between 50g and 100g\".
    • Where to buy:
      • IST MALL (KR Seller)

"},{"location":"extras/parts/#springs","title":"Springs","text":""},{"location":"extras/parts/#options_2","title":"Options","text":"

20g Springs

  • OBSA-SP-20
    • Where to buy:
      • Sanwa Rakuten (Official JP Store)
      • IST MALL (KR Seller)
      • Buyee (Rakuten Proxy)
  • IST Spring
    • Where to buy:
      • IST MALL (KR Seller)

40g Springs

  • OBSA-SP-40
    • Where to buy:
      • Sanwa Rakuten (Official JP Store)
      • IST MALL (KR Seller)
      • Buyee (Rakuten Proxy)

50g Springs

  • OBSA-SP-50
    • Where to buy:
      • Sanwa Rakuten (Official JP Store)
      • Buyee (Rakuten Proxy)

60g Springs

  • OBSA-SP-60-K
    • Where to buy:
      • Sanwa Rakuten (Official JP Store)
      • IST MALL (KR Seller)
      • Buyee (Rakuten Proxy)
  • IST Spring
    • Where to buy:
      • IST MALL (KR Seller)

100g Springs

  • OBSA-SP-100

    • Where to buy:
      • Sanwa Rakuten (Official JP Store)
      • IST MALL (KR Seller)

  • IST Spring

    • Where to buy:
      • IST MALL (KR Seller)
"},{"location":"extras/parts/#led-lamps","title":"LED Lamps","text":""},{"location":"extras/parts/#options_3","title":"Options","text":"

ISTMall lamps

- Where to buy:\n    - [IST MALL (KR Seller)](https://istmall.co.kr/us/goods/goods_view.php?goodsNo=1009992273)\n
"},{"location":"extras/patchsp2x/","title":"Spice2x DLL Patching","text":"

TWO-TORIAL Patcher

URL: https://sp2x.two-torial.xyz GitHub Repo Supported Games Contributing

Known spice2x patchers

Compatibility

This patching method only is for spice2x supported games.

Please make sure you're using the latest release for spice2x as the feature is fairly new.

Before proceeding

It is highly recommended to use an unpatched DLL as your base!

If you've already patched your game through other methods (web patching or hex editing), Please replace your game's DLL with the original.

"},{"location":"extras/patchsp2x/#getting-started","title":"Getting Started","text":"

The following guide works the same regardless of which spice2x compatible game you're using.

In this case we will be using a clean SDVX installation as a reference, with the following folder structure.

"},{"location":"extras/patchsp2x/#importing-patches-from-url","title":"Importing Patches from URL","text":"

Open spicecfg.exe and head to the Patches tab.

By default no patches will be available, we need to import some.

  • Click on Import from URL.
  • Paste your preferred patcher's URL.

Note: Check the Resources page for a list of recommended patchers.

  • Click on Import.

If patching fails, it most likely is because the URL you provided doesn't support your game's version.

"},{"location":"extras/patchsp2x/#picking-patches","title":"Picking Patches","text":"

Important

As a general rule of thumb, if you're not sure what a patch does or you're not absolutely certain you need it, leave it alone.

After a successful import, your patches should now show up inside spice2x.

A new Patches folder has also been created, containing a .json file with your available patches for offline use.

Now you may pick and choose desired patches!

For game-specific instructions, refer to their respective dedicated pages.

"},{"location":"extras/patchsp2x/#auto-apply-overwrite-game-files","title":"Auto apply / Overwrite game files","text":"

Auto apply (recommended)

After picking your patches, it is strongly recommended to tick the Auto apply patches on game start box.

Doing so will keep your game files intact until you start it, at which point your selected patches will apply. Upon closing the game your game's files will be restored.

Overwrite game files

You also have the option to Overwrite game files, which will permanently modify your game files.

This is NOT recommended unless you have a good reason to do so. A backup of your original dll will be created, however it is recommended to make your own!

"},{"location":"extras/patchweb/","title":"Website DLL Patching","text":"

Known web patchers: Resources

For BEMANI games consider Spice2x Patching

This patching method is outdated for BEMANI games.

However spice2x patching is still very new and might not support your game yet, in this case follow this guide.

Before proceeding

It is highly recommended to use an unpatched DLL as your base!

If you've already patched your game through other methods (spice2x patching or hex editing), Please replace your game's DLL with the original.

"},{"location":"extras/patchweb/#getting-started","title":"Getting started","text":"

We'll be using mon's BemaniPatcher. Almost every other patcher is based off of this and functions exactly the same.

If your game is recent, please check Resources and use another web patcher.

Go to your chosen patcher's website, you'll get something similar to this:

Click on any game you'd like the patches for. In this case, we'll use Beatmania IIDX 30 Resident.

Here, either:

  • Drag and drop the .dll file the site prompts you to use.
  • OR click on Choose a file and select it that way.

If you've used the correct file and the site is compatible, it will tell you.

X of X patches matched (100%) means the patcher is compatible with your game. If this shows any less than 100%, DO NOT use it. Your .dll file might not be clean. Only proceed with a clean one.

Please keep in mind that some patchers may not support the most recent versions of your game right away.

Now, you can select the patches you'd like to apply.

If you're unsure on what to do, refer to your specific game's guide as it might have more information there. Otherwise feel free to join our Discord server, the link is at the top of the home page, and ask the community!

When you're done selecting patches, click on Save Patched File and your new .dll file will start downloading.

Backup your original .dll file first!

Now you may replace your data's .dll file with the patched one you just downloaded.

Once you've done that, you're done. Enjoy!

"},{"location":"extras/pollingrates/","title":"List of Touchscreen Monitors and their Polling Rates","text":"

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 and move your finger across the window at a reasonable pace, but not too fast!

"},{"location":"extras/pollingrates/#dell-s2240t","title":"Dell S2240T","text":"
  • 2013 Manufacturing Date:
    • 200hz GREAT!
  • 2014 Manufacturing Date:
    • May: 200hz GREAT!
    • September: 180hz
  • 2015 Manufacturing Date:
    • March: 200hz GREAT!
    • September: 200hz GREAT!
  • Late 2016 Manufacturing Date:
    • 140hz AVOID
  • Early 2017 Manufacturing Date:
    • 180hz
  • Mid 2017 Manufacturing Date:
    • 140hz AVOID
  • February 2018 Manufacturing Date:
    • 180hz
"},{"location":"extras/pollingrates/#dell-p2314t","title":"Dell P2314T","text":"
  • November 2015 Manufacturing Date:
    • 60hz DO NOT BUY!
"},{"location":"extras/pollingrates/#dell-p2418ht","title":"Dell P2418HT","text":"
  • May 2018 Manufacturing Date:
    • 60hz DO NOT BUY!
"},{"location":"extras/pollingrates/#iiyama-t2336msc","title":"Iiyama T2336MSC","text":"
  • Revision B1:
    • 180hz
"},{"location":"extras/softether/","title":"Setting Up SoftEther VPN for Cabinet-to-Cabinet Play","text":""},{"location":"extras/softether/#what-is-softether-vpn","title":"What is SoftEther VPN?","text":"

SoftEther VPN is a free tool we use to create Virtual Hubs and connect multiple machines to the same virtual network, allowing the ability to perform Cabinet-to-Cabinet link even when the machines are on physically different networks.

"},{"location":"extras/softether/#configuring-softether-server","title":"Configuring SoftEther Server","text":"

This part of the guide is for hosting a hub! If you only wish to connect to a hub, refer to Connecting to a SoftEther Hub.

While this guide is mainly focused on setting up link-play for arcade games, theoretically this should also work with other PC games that supports link-playing over LAN.

"},{"location":"extras/softether/#setting-up-the-server-and-creating-a-hub","title":"Setting up the Server, and Creating a Hub","text":"

First, go to the SoftEther VPN Download Center. In the Select Component section, choose SoftEther VPN Server. Choose the Operating System and CPU based on your own machine, and grab the latest rtm build. This guide will be using Windows as an example, the layout for other OS might vary.

Run the installer and choose to install SoftEther VPN Server. Press Next to finish the installation, and start the Server Manager.

When running the Server Manager for the first time, you should be greeted with the window below. Click on the Connect button.

If prompted to setup a root password, set a password that you will remember. If prompted with the Easy Setup wizard, click Close on the bottom right of the window.

Click on Create a Virtual Hub on the window below.

Give your hub a name, and set an admin password. In this example, we will use Two-Torial.

If you wish to limit the maximum amount of sessions that can be connected to your hub at a time, you can enable Limit Max VPN Sessions. Most arcade games support up to 4-way link, so we will set the limit to 4 in this example.

Your hub is now created! You should see the hub show up on your Virtual Hub list. Click on the hub to highlight it, and click Manage Virtual Hub.

"},{"location":"extras/softether/#adding-users-to-your-virtual-hub","title":"Adding Users to your Virtual Hub","text":"

You will need to add User Accounts into the Virtual Hub before anyone can connect. Click on Manage Users, then click New at the bottom left of the window.

Set a Username and Password for the user account, then check the Set Security Policy box on the top right, and click Security Policy.

Scroll down and find Unlimited Number of Broadcasts and Filter all IPv6 Packets, then enable the 2 options. Leave everything else as defaults and click OK.

Click on OK, and your user account should be created. Click on Exit to go back to the Hub Management page.

You can either create one user account and give everyone the same credentials to connect to your hub under the same user, or you can also create individual user accounts for all the players that wish to connect to your hub. I recommend creating an user account for each player so you can have an easier time to manage the hub if needed.

"},{"location":"extras/softether/#configuring-securenat","title":"Configuring SecureNAT","text":"

We will use the SecureNAT option to assign a custom subnet to each connected machines. Some games like Chunithm requires you to be on a specific subnet or cab-to-cab link will not work. Click on Virtual NAT and Virtual DHCP Server (SecureNAT), then enable SecureNAT, and click on SecureNAT Configuration.

  • In the SecureNAT Configration window, set the IP Address under Virtual Host Network Interface Settings to the subnet you wish to use. In this exmaple, we will be using 192.168.139.x as this is the subnet required by Chunithm for cab-to-cab play.
  • Under Virtual DHCP Server Settings, set the IP Address range you wish to distribute to the connected machines. We will use a suffix of 11 to 14 in this example.
  • IMPORTANT: LEAVE THE Options Applied to Clients SECTION BLANK!!! Once everything is set, click on OK and Exit.

"},{"location":"extras/softether/#setting-a-dynamic-dns-for-your-softether-server","title":"Setting a Dynamic DNS for your SoftEther Server","text":"

You can set a custom DDNS Hostname for your SoftEther Server to allow people to remember your Server Hostname more easily. You can also just leave the hostname as default if you wish.

Click Dynamic DNS Setting on the bottom left.

  • Under Change the Dynamic DNS Hostname section, set your preferred hostname. In this example, we will use twotorial.
  • Click Set to Above Hostname when done, and click Exit.

If a prompt shows up and ask if you want to regenerate a new Server Certificate, click on No.

If done correctly, the bottom left of your Virtual Hub management window should show your updated Hostname.

The server setup is done! User(s) should be able to connect to your hub now.

"},{"location":"extras/softether/#connecting-to-a-softether-hub","title":"Connecting to a SoftEther Hub","text":""},{"location":"extras/softether/#setting-up-the-vpn-client","title":"Setting up the VPN Client","text":"

If you already have a hub created / you have a hub ready to connect, keep reading.

Go to the SoftEther VPN Download Center. In the Select Component section, choose SoftEther VPN Client. Choose the Operating System and CPU based on your own machine, and grab the latest rtm build. This guide will be using Windows as an example, the layout for other OS might vary.

Run the installer and choose to install SoftEther VPN Client. Press Next to finish the installation, and start the VPN Client.

In the VPN Client window, click on Add VPN Connection.

If a prompt shows up saying that you need to create a Virtual Network Adapter first, click Yes.

Leave the adapter name as default, and press OK. Wait for the creation process to finish.

"},{"location":"extras/softether/#connecting-to-a-virtual-hub","title":"Connecting to a Virtual Hub","text":"

After you have created a Virtual Network Adapter, you should be able to add a VPN Hub. Click on Add VPN Connection again.

  • Name the Hub whatever you prefer. In this example, we will use Twotorial.
  • In the Destination VPN Server section, input the server Hostname and port. The hostname should usually be [your_hostname].softether.net
  • If the Hostname is correct and the client is able to establish a connection, the Virtual Hub Name should auto-fill when you click on the dropdown box.

If the Virtual Hub Name shows a blank list even after clicking the dropdown box multiple times, it usually means your client is unable to establish a connection. Double check if the hostname, and your hub config is correct.

  • Under User Authentication Setting, input your username and password.
  • If you are connecting to another person's hub, ask the person for your login credentials.

  • Under Advanced Setting of Communication, UNCHECK THE RECONNECTS AUTOMATICALLY AFTER DISCONNECTED BOX. If this option is enabled, your VPN Client will always try to reconnect to the hub when it is running, taking up a spot in the hub. Please do not do this, it's just annoying when you're AFK in someone's hub and hogging up a spot.
  • Click Advanced Settings....

  • In the Advanced Settings window, you can set the Number of TCP Connections you wish to use. The higher you set, the more connections will be used, resulting in a potentially better link-play experience especially for real-time PVP games like Wangan Midnight Maximum Tune or Initial D: The Arcade.

If you set this to a very high value and your connection speed is unable to keep up with the requests, your connection quality may be negatively impacted. I recommend setting this to 8 for a good balance.

  • If you find yourself desyncing a lot when in game, you can also enable Use Data Compression to improve the connection stability.
  • Click on OK once everything is set.

Double click on the VPN hub to connect. If it shows you your assigned IP address, congratulations! You are now connected to the Virtual Hub and is ready for some cab-to-cab action!

"},{"location":"extras/softether/#tips","title":"Tips","text":"
  • If you need to fetch your assigned IP address because the notification window disappeared too fast or if you forgot your IP, you can do so with the ipconfig command in CMD.
  • The Virtual Adapter name will usually be Unknown adapter VPN - VPN Client.
  • If you already have your hub setup and want to share the config with other users, you can Export your VPN profile and send it to them. Right click on the VPN Hub you wish to share and click Export VPN Connection Setting....
  • If you wish to include your username and password in the exported config, click on No. If the hub you are connecting to have different accounts setup for individual users, click on Yes to remove all sensitive information from the config.
"},{"location":"extras/streamaudio/","title":"Workarounds for exclusive audio","text":"

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!

"},{"location":"extras/streamaudio/#setting-up-audio","title":"Setting up audio","text":"

There are advantages and disadvantages to each of the methods, so read carefully.

"},{"location":"extras/streamaudio/#option-1-force-shared-audio","title":"Option 1 - force shared audio","text":"
  • 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.

Sound Voltex

  • Enable Shared mode WASAPI patch.
  • If you run into any issues, change the audio playback device to output at 44.1khz and 16 bit.

IIDX

  • For TDJ mode, ensure that the sound output device is set to WASAPI.
    • In SpiceTools, set -iidxsounddevice to wasapi.
  • Enable Force shared audio patch.
  • 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.
"},{"location":"extras/streamaudio/#option-2-stereo-mix","title":"Option 2 - Stereo Mix","text":"
  • 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.

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.
  2. 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).
  3. Go to Recording devices tab.
  4. Look for Stereo Mix. If you don't see it, right click and check \"Show Disabled Devices\" and try again.

Capturing audio in OBS with Stereo Mix

  1. Add a new Audio Input Capture source.
  2. Set the device as Stereo Mix.
  3. You can now capture audio.
  4. You'll probably want to set to \"Monitor Off\" so you don't get duplicated audio.
"},{"location":"extras/streamaudio/#option-3-audio-splitter-cable-lo-tech-method","title":"Option 3 - audio splitter cable (lo-tech method)","text":"
  • 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

Equipment

  1. Buy an audio splitter cable, and a headphone extension cable.
  2. 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.

Capturing audio in OBS

  • Add \"Line In\" as an audio input source.
"},{"location":"extras/streamaudio/#option-4-flexasio","title":"Option 4 - FlexASIO","text":"
  • 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.

FlexASIO set up

  1. Install FlexASIO
  2. Create a FlexASIO.toml configuration file in your user folder (C:\\Users\\Your Name)

  3. Insert these lines inside your configuration file:

    backend = \"Windows WASAPI\"\nbufferSizeSamples = 386\nchannels = 2\nwasapiExclusiveMode = false\n\n[output]\nsuggestedLatencySeconds = 0.0\n

Try to lower bufferSizeSamples for minimal latency - recommended value is 128. If you hear audio crackling, increase bufferSizeSamples.

Sound Voltex

  • Disable Shared mode WASAPI patch. You want the game to output in exclusive mode for lower overall latency.

IIDX

  • For TDJ mode, ensure that the sound output device is set to WASAPI.
    • In SpiceTools, set -iidxsounddevice to wasapi.
  • Disable Force shared audio patch. You want the game to output in exclusive mode for lower overall latency.

SpiceTools set up to use ASIO

  1. Under the options tab, make sure that IIDX Sound Output Device is set to default.
  2. Directly below it is an option called IIDX ASIO Driver. Type FlexASIO into it.

Taiko no Tatsujin Nijiiro

  1. Disable wasapi_shared in config.toml.
  2. Enable asio in config.toml.
  3. Set asio_driver to FlexASIO.
  • To capture audio, you can capture desktop audio as you normally would in OBS.
"},{"location":"extras/streamaudio/#option-5-voicemeeter","title":"Option 5 - Voicemeeter","text":"
  • 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.

Initial Voicemeeter set up

  1. Download Voicemeeter Potato.
    • 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.
  2. Install and REBOOT YOUR COMPUTER when prompted.
  3. Launch Voicemeeter Banana or Potato, whichever one you prefer.
  4. 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.
  5. In Windows sound settings, set your default audio playback device to Voicemeeter Input (and not Voicemeeter AUX Input!)

Discord or other voice applications

  • Configure the output device to Voicemeeter AUX Input.

Sound Voltex

  • Disable Shared mode WASAPI patch. You want the game to output in exclusive mode for lower overall latency.

IIDX

  • Disable Force shared audio patch. 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!

Muxing with Voicemeeter

  1. Launch the game.
  2. 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.
  3. (Similarly, audio from the voice chat would come through Voicemeeter AUX column.)
  4. At this point, you are able to hear both the game & listen to voice chat - success!

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.
  2. 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.
  3. In OBS, create a new Audio Input Capture source.
  4. Double click on the new source and select VoiceMeeter Output (VB-Audio VoiceMeeter VAIO) from the drop-down.
  5. 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.)
  6. You are done. You should see the game audio come through to OBS.
"},{"location":"extras/streamaudio/#streaming-to-discord","title":"Streaming to Discord","text":"

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:

"},{"location":"extras/streamaudio/#setting-up-virtual-audio-monitor-in-obs","title":"Setting up Virtual Audio Monitor in OBS","text":"

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.

Option 1 - Using Virtual Audio Cable

  1. Download and install Virtual Audio Cable.
  2. Go to OBS Settings, Audio, Advanced, Monitoring Device - set to CABLE Input.
  3. Go to Edit, Advanced Audio Properties. For any audio channels you want to stream, turn on monitor to \"Monitor and Output\".

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.
  2. Go to OBS Settings, Audio, Advanced, Monitoring Device - set to VoiceMeeter VAIO3 Input.
  3. Go to Edit, Advanced Audio Properties. For any audio channels you want to stream, turn on monitor to \"Monitor and Output\".
  4. 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.
"},{"location":"extras/streamaudio/#streaming-obs-windowed-preview-to-discord","title":"Streaming OBS Windowed Preview to Discord","text":"
  1. Add the game window capture as a scene, as you normally would in OBS.
  2. Right click on OBS stage and click on Windows Projector (Preview).
  3. Resize the new window as needed.
  4. Use Discord to screen share this Windowed Projector.
  5. You're done! The screen share should include both the OBS scene and the audio.
"},{"location":"extras/streamaudio/#troubleshooting","title":"Troubleshooting","text":"

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.

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.

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.
"},{"location":"extras/unity/","title":"Modding Unity-based games","text":"

Before proceeding

This guide applies to games made in the Unity engine, such as maimai DX, O.N.G.E.K.I. and Card Maker.

It is highly recommended to use an unpatched Assembly DLL as your base!

Patches have historically been hardcoded into the unprotected Assembly-CSharp.dll

The modern approach is to use BepInEx to load custom patches without tampering with Assembly-CSharp.BepInEx can be used to load all mods, including those made for MelonLoader and MonoMod

"},{"location":"extras/unity/#installing-bepinex","title":"Installing BepInEx","text":"
  • Download the BepInEx 5 stable release (BepInEx_win_x64_5.x.y.z.zip).

Some maimai DX mods are only compatible with BepInEx 5.4.22

  • Extract the BepInEx folder to the App\\package folder (ignore other files such as .doorstop_version)

  • Modify segatools.ini with the following:

[unity]\nenable=1\ntargetAssembly=BepInEx\\core\\BepInEx.Preloader.dll\n
"},{"location":"extras/unity/#installing-mods","title":"Installing mods","text":"

BepInEx plugins

Place them in BepInEx\\plugins.

Melonloader mods and plugins

  • Download MLLoader-UnityMono-BepInEx5 of the latest BepInEx.MelonLoader.Loader.
  • Extract it into App\\package.
  • Place mods in MLLoader\\Mods.

MonoMod patches

These patches always follow the naming pattern: Assembly-CSharp.Name.mm.dll.

  • Extract BepInEx.MonoMod.Loader into App\\package.
  • Place patches in BepInEx\\monomod.
"},{"location":"extras/unity/#available-mods","title":"Available mods","text":"
  • mu3-mods open source BepInEx mods for O.N.G.E.K.I., includes many fixes and QOL changes that can be added selectively.
  • AquaMai open source MelonLoader mod for maimai, includes fixes, QOL, and cheats that can be configured from a toml or gui.
  • worldlinkd open source MelonLoader mod for maimai, which adds cross-network online c2c similar to online matching in CHUNITHM.

AquaMai & worldlinkd

These mods may not work with the MelonLoader compatiblity layer for BepInEx, and as such it's recommended to follow their respective guides.

"},{"location":"games/bemani/beatstream/animutribe/setup/","title":"BeatStream \u30a2\u30cb\u30e0\u30c8\u30e9\u30a4\u30f4","text":"

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.

"},{"location":"games/bemani/beatstream/animutribe/setup/#getting-started","title":"Getting Started","text":"

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.

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.

"},{"location":"games/bemani/beatstream/animutribe/setup/#configuring-your-tools","title":"Configuring Your Tools","text":"

Now that you have your files ready, open up your .bat file in your desired text editor (we're using Notepad++) 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.

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.

"},{"location":"games/bemani/beatstream/animutribe/setup/#configuring-for-a-local-network","title":"Configuring for a Local Network","text":"

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!
"},{"location":"games/bemani/beatstream/animutribe/setup/#configuring-for-an-online-network","title":"Configuring for an Online Network","text":"

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!
"},{"location":"games/bemani/beatstream/animutribe/setup/#final-steps-and-setting-up-the-game","title":"Final Steps and Setting up the Game","text":"

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.

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 Troubleshooting section at the link below.

Have any other errors?

Check out the Troubleshooting section and Error Code section to resolve any issues not seen in this guide to greater depth.

"},{"location":"games/bemani/beatstream/animutribe/troubleshooting/","title":"BeatStream \u30a2\u30cb\u30e0\u30c8\u30e9\u30a4\u30f4","text":""},{"location":"games/bemani/beatstream/animutribe/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

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

"},{"location":"games/bemani/beatstream/animutribe/troubleshooting/#my-game-doesnt-boot-after-following-the-guide","title":"My Game Doesn't Boot After Following the Guide!","text":"

The most common problem present here is if you do not have an E:/ drive. To resolve this issue, you must modify your game with the E:/drive fix patch.

"},{"location":"games/bemani/beatstream/animutribe/troubleshooting/#my-touchscreen-monitor-isnt-working","title":"My Touchscreen Monitor Isn't Working","text":"

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!

"},{"location":"games/bemani/beatstream/animutribe/troubleshooting/#my-game-is-running-slowlagging","title":"My Game Is Running Slow/Lagging","text":"

Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.

"},{"location":"games/bemani/beatstream/animutribe/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

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.

"},{"location":"games/bemani/beatstream/animutribe/troubleshooting/#which-offset-is-which","title":"Which Offset Is Which?","text":"

If you're getting too many fasts, increase your offset (+). If you're getting too many slows, decrease your offset (-).

"},{"location":"games/bemani/ddr/a20/setup/","title":"Game Setup (DDR A2O)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/ddr/a20/setup/#about-data","title":"About data","text":"

The full game should be around 20-25gb in size.

Please keep the following in mind as you're going through this guide.

DDR's codename is MDX. Starting with DDR A20 this would be either:

  • MDX-001 (Other cabs, 32 bits)
  • MDX-003 (Gold cab, 64 bits)

The gold cab version contains more features, such as exclusive songs or the \"GOLDEN LEAGUE\" mode.

"},{"location":"games/bemani/ddr/a20/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure with a few folders only, as follows.

If your data doesn't look like this

If you're missing the modules folder and instead have bunch of .dll files next to your folders:

  • Create a modules folder.
  • Move all .dll files inside of it so you end up with a structure as shown above.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/bemani/ddr/a20/setup/#updating-data","title":"Updating data","text":"Please make sure you're using the right update for your current data.

DDR Patches re-uploaded by the community tend to be appropriately named MDX-DATECODE-to-DATECODE.

For example MDX-2024091000-to-2024101500.

  • 2024091000 being your current data's version.
  • 2024101500 being the one you would arrive at.
  • Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.
  • Open prop\\ea3-config.xml in a text editor and find the following lines near the top.
    <soft>\n        <model __type=\"str\">MDX</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">A</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024101500</ext>\n    </soft>\n

On the line with <ext __type=\"str\"> the datecode needs to match your new version.

  • If that's already the case then great! Don't touch anything.
  • If it instead corresponds to your pre-patch datecode, replace it with the new one and save the file.
"},{"location":"games/bemani/ddr/a20/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

For MDX-001 (32 bits)
  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice.exe and spicecfg.exe files from the archive to your game's directory.

For MDX-003 (64 bits)
  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice64.exe and spicecfg.exe files from the archive to your game's directory.

"},{"location":"games/bemani/ddr/a20/setup/#configuring-spice2x","title":"Configuring Spice2x","text":"

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/ddr/a20/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • P1 Panel buttons: Up, Down, Left, Right
  • P1 Menu buttons: Start, Up, Down, Left, Right
  • P1 Keypad: 1 to 9, Keypad Insert Card
"},{"location":"games/bemani/ddr/a20/setup/#overlay","title":"Overlay","text":"

Modifying buttons in this section is not required but you are free to change what you want.

Click on Bind then press the key you want associated with the action.

"},{"location":"games/bemani/ddr/a20/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through spice2x.

If it does, here's how you may link different actions to your lights:

  • Click Bind.
  • In Device, pick your controller.
  • In Light Control, select the corresponding light.
  • Click Close.
  • Repeat for your other lights.
"},{"location":"games/bemani/ddr/a20/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section.

"},{"location":"games/bemani/ddr/a20/setup/#patches","title":"Patches","text":"

Go through the Spice2x Patching page to import patches.

To prevent issues, avoid patching things you don't need or understand.

"},{"location":"games/bemani/ddr/a20/setup/#api","title":"API","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/ddr/a20/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the question mark at the very left.

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Network EA Service URL -url Covered in Connecting to a network

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/ddr/a20/setup/#advanced-development","title":"Advanced & Development","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/ddr/a20/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/ddr/a20/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/bemani/ddr/a20/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/bemani/ddr/a20/setup/#k-lite-codec-pack","title":"K-lite Codec Pack","text":"
  • Download and install the K-lite Codec Pack (the Standard version is enough)
"},{"location":"games/bemani/ddr/a20/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/bemani/ddr/a20/troubleshooting/","title":"Troubleshooting (DDR A20)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/ddr/a20/troubleshooting/#clock-error","title":"Clock error","text":"

In the test menu, navigate to CLOCK, and set it to match your computer's time.

"},{"location":"games/bemani/ddr/a20/troubleshooting/#my-game-is-running-slowlagging","title":"My game is running slow/lagging","text":"

Try to eliminate any unnecessary background processes during play.

"},{"location":"games/bemani/ddr/a20/troubleshooting/#unable-to-login-eamuse-error-network-error","title":"Unable to login / Eamuse error / Network error","text":"

Get the proper Asphyxia plugin from our Discord server in the #ddr channel > Resources post. Make sure you didn't enable -smartea in spicecfg's options.

"},{"location":"games/bemani/ddr/a20/troubleshooting/#where-are-the-option-for-dancersshadingmeasure-linesfast-slowlayering","title":"Where are the option for Dancers/Shading/Measure lines/Fast-Slow/Layering?","text":"

These options are locked behind network requirements and will not be displayed unless you are connected to a network that has written support for these options. Patches are available to mitigate this (see Patches).

"},{"location":"games/bemani/ddr/a20plus/setup/","title":"Game Setup (DDR A2O PLUS)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/ddr/a20plus/setup/#about-data","title":"About data","text":"

The full game should be around 20-25gb in size.

Please keep the following in mind as you're going through this guide.

DDR's codename is MDX. Starting with DDR A20 this would be either:

  • MDX-001 (Other cabs, 32 bits)
  • MDX-003 (Gold cab, 64 bits)

The gold cab version contains more features, such as exclusive songs or the \"GOLDEN LEAGUE\" mode.

"},{"location":"games/bemani/ddr/a20plus/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure with a few folders only, as follows.

If your data doesn't look like this

If you're missing the modules folder and instead have bunch of .dll files next to your folders:

  • Create a modules folder.
  • Move all .dll files inside of it so you end up with a structure as shown above.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/bemani/ddr/a20plus/setup/#updating-data","title":"Updating data","text":"Please make sure you're using the right update for your current data.

DDR Patches re-uploaded by the community tend to be appropriately named MDX-DATECODE-to-DATECODE.

For example MDX-2024091000-to-2024101500.

  • 2024091000 being your current data's version.
  • 2024101500 being the one you would arrive at.
  • Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.
  • Open prop\\ea3-config.xml in a text editor and find the following lines near the top.
    <soft>\n        <model __type=\"str\">MDX</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">A</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024101500</ext>\n    </soft>\n

On the line with <ext __type=\"str\"> the datecode needs to match your new version.

  • If that's already the case then great! Don't touch anything.
  • If it instead corresponds to your pre-patch datecode, replace it with the new one and save the file.
"},{"location":"games/bemani/ddr/a20plus/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

For MDX-001 (32 bits)
  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice.exe and spicecfg.exe files from the archive to your game's directory.

For MDX-003 (64 bits)
  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice64.exe and spicecfg.exe files from the archive to your game's directory.

"},{"location":"games/bemani/ddr/a20plus/setup/#configuring-spice2x","title":"Configuring Spice2x","text":"

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/ddr/a20plus/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • P1 Panel buttons: Up, Down, Left, Right
  • P1 Menu buttons: Start, Up, Down, Left, Right
  • P1 Keypad: 1 to 9, Keypad Insert Card
"},{"location":"games/bemani/ddr/a20plus/setup/#overlay","title":"Overlay","text":"

Modifying buttons in this section is not required but you are free to change what you want.

Click on Bind then press the key you want associated with the action.

"},{"location":"games/bemani/ddr/a20plus/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through spice2x.

If it does, here's how you may link different actions to your lights:

  • Click Bind.
  • In Device, pick your controller.
  • In Light Control, select the corresponding light.
  • Click Close.
  • Repeat for your other lights.
"},{"location":"games/bemani/ddr/a20plus/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section.

"},{"location":"games/bemani/ddr/a20plus/setup/#patches","title":"Patches","text":"

Go through the Spice2x Patching page to import patches.

To prevent issues, avoid patching things you don't need or understand.

"},{"location":"games/bemani/ddr/a20plus/setup/#api","title":"API","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/ddr/a20plus/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the question mark at the very left.

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Network EA Service URL -url Covered in Connecting to a network

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/ddr/a20plus/setup/#advanced-development","title":"Advanced & Development","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/ddr/a20plus/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/ddr/a20plus/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/bemani/ddr/a20plus/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/bemani/ddr/a20plus/setup/#k-lite-codec-pack","title":"K-lite Codec Pack","text":"
  • Download and install the K-lite Codec Pack (the Standard version is enough)
"},{"location":"games/bemani/ddr/a20plus/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/bemani/ddr/a20plus/troubleshooting/","title":"Troubleshooting (DDR A20 PLUS)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/ddr/a20plus/troubleshooting/#clock-error","title":"Clock error","text":"

In the test menu, navigate to CLOCK, and set it to match your computer's time.

"},{"location":"games/bemani/ddr/a20plus/troubleshooting/#my-game-is-running-slowlagging","title":"My game is running slow/lagging","text":"

Try to eliminate any unnecessary background processes during play.

"},{"location":"games/bemani/ddr/a20plus/troubleshooting/#unable-to-login-eamuse-error-network-error","title":"Unable to login / Eamuse error / Network error","text":"

Get the proper Asphyxia plugin from our Discord server in the #ddr channel > Resources post. Make sure you didn't enable -smartea in spicecfg's options.

"},{"location":"games/bemani/ddr/a20plus/troubleshooting/#where-are-the-option-for-dancersshadingmeasure-linesfast-slowlayering","title":"Where are the option for Dancers/Shading/Measure lines/Fast-Slow/Layering?","text":"

These options are locked behind network requirements and will not be displayed unless you are connected to a network that has written support for these options. Patches are available to mitigate this (see Patches).

"},{"location":"games/bemani/ddr/a3/setup/","title":"Game Setup (DDR A3)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/ddr/a3/setup/#about-data","title":"About data","text":"

The full game should be around 20-25gb in size.

Please keep the following in mind as you're going through this guide.

DDR's codename is MDX. Starting with DDR A20 this would be either:

  • MDX-001 (Other cabs, 32 bits)
  • MDX-003 (Gold cab, 64 bits)

The gold cab version contains more features, such as exclusive songs or the \"GOLDEN LEAGUE\" mode.

"},{"location":"games/bemani/ddr/a3/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure with a few folders only, as follows.

If your data doesn't look like this

If you're missing the modules folder and instead have bunch of .dll files next to your folders:

  • Create a modules folder.
  • Move all .dll files inside of it so you end up with a structure as shown above.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/bemani/ddr/a3/setup/#updating-data","title":"Updating data","text":"Please make sure you're using the right update for your current data.

DDR Patches re-uploaded by the community tend to be appropriately named MDX-DATECODE-to-DATECODE.

For example MDX-2024091000-to-2024101500.

  • 2024091000 being your current data's version.
  • 2024101500 being the one you would arrive at.
  • Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.
  • Open prop\\ea3-config.xml in a text editor and find the following lines near the top.
    <soft>\n        <model __type=\"str\">MDX</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">A</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024101500</ext>\n    </soft>\n

On the line with <ext __type=\"str\"> the datecode needs to match your new version.

  • If that's already the case then great! Don't touch anything.
  • If it instead corresponds to your pre-patch datecode, replace it with the new one and save the file.
"},{"location":"games/bemani/ddr/a3/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

For MDX-001 (32 bits)
  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice.exe and spicecfg.exe files from the archive to your game's directory.

For MDX-003 (64 bits)
  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice64.exe and spicecfg.exe files from the archive to your game's directory.

"},{"location":"games/bemani/ddr/a3/setup/#configuring-spice2x","title":"Configuring Spice2x","text":"

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/ddr/a3/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • P1 Panel buttons: Up, Down, Left, Right
  • P1 Menu buttons: Start, Up, Down, Left, Right
  • P1 Keypad: 1 to 9, Keypad Insert Card
"},{"location":"games/bemani/ddr/a3/setup/#overlay","title":"Overlay","text":"

Modifying buttons in this section is not required but you are free to change what you want.

Click on Bind then press the key you want associated with the action.

"},{"location":"games/bemani/ddr/a3/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through spice2x.

If it does, here's how you may link different actions to your lights:

  • Click Bind.
  • In Device, pick your controller.
  • In Light Control, select the corresponding light.
  • Click Close.
  • Repeat for your other lights.
"},{"location":"games/bemani/ddr/a3/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section.

"},{"location":"games/bemani/ddr/a3/setup/#patches","title":"Patches","text":"

Go through the Spice2x Patching page to import patches.

To prevent issues, avoid patching things you don't need or understand.

"},{"location":"games/bemani/ddr/a3/setup/#api","title":"API","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/ddr/a3/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the question mark at the very left.

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Network EA Service URL -url Covered in Connecting to a network

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/ddr/a3/setup/#advanced-development","title":"Advanced & Development","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/ddr/a3/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/ddr/a3/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/bemani/ddr/a3/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/bemani/ddr/a3/setup/#k-lite-codec-pack","title":"K-lite Codec Pack","text":"
  • Download and install the K-lite Codec Pack (the Standard version is enough)
"},{"location":"games/bemani/ddr/a3/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/bemani/ddr/a3/troubleshooting/","title":"Troubleshooting (DDR A3)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/ddr/a3/troubleshooting/#clock-error","title":"Clock error","text":"

In the test menu, navigate to CLOCK, and set it to match your computer's time.

"},{"location":"games/bemani/ddr/a3/troubleshooting/#my-game-is-running-slowlagging","title":"My game is running slow/lagging","text":"

Try to eliminate any unnecessary background processes during play.

"},{"location":"games/bemani/ddr/a3/troubleshooting/#unable-to-login-eamuse-error-network-error","title":"Unable to login / Eamuse error / Network error","text":"

Get the proper Asphyxia plugin from our Discord server in the #ddr channel > Resources post. Make sure you didn't enable -smartea in spicecfg's options.

"},{"location":"games/bemani/ddr/a3/troubleshooting/#where-are-the-option-for-dancersshadingmeasure-linesfast-slowlayering","title":"Where are the option for Dancers/Shading/Measure lines/Fast-Slow/Layering?","text":"

These options are locked behind network requirements and will not be displayed unless you are connected to a network that has written support for these options. Patches are available to mitigate this (see Patches).

"},{"location":"games/bemani/ddr/common/setup/","title":"Setup","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/ddr/common/setup/#about-data","title":"About data","text":"

The full game should be around 20-25gb in size.

Please keep the following in mind as you're going through this guide.

DDR's codename is MDX. Starting with DDR A20 this would be either:

  • MDX-001 (Other cabs, 32 bits)
  • MDX-003 (Gold cab, 64 bits)

The gold cab version contains more features, such as exclusive songs or the \"GOLDEN LEAGUE\" mode.

"},{"location":"games/bemani/ddr/common/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure with a few folders only, as follows.

If your data doesn't look like this

If you're missing the modules folder and instead have bunch of .dll files next to your folders:

  • Create a modules folder.
  • Move all .dll files inside of it so you end up with a structure as shown above.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/bemani/ddr/common/setup/#updating-data","title":"Updating data","text":"Please make sure you're using the right update for your current data.

DDR Patches re-uploaded by the community tend to be appropriately named MDX-DATECODE-to-DATECODE.

For example MDX-2024091000-to-2024101500.

  • 2024091000 being your current data's version.
  • 2024101500 being the one you would arrive at.
  • Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.
  • Open prop\\ea3-config.xml in a text editor and find the following lines near the top.
    <soft>\n        <model __type=\"str\">MDX</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">A</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024101500</ext>\n    </soft>\n

On the line with <ext __type=\"str\"> the datecode needs to match your new version.

  • If that's already the case then great! Don't touch anything.
  • If it instead corresponds to your pre-patch datecode, replace it with the new one and save the file.
"},{"location":"games/bemani/ddr/common/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

For MDX-001 (32 bits)
  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice.exe and spicecfg.exe files from the archive to your game's directory.

For MDX-003 (64 bits)
  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice64.exe and spicecfg.exe files from the archive to your game's directory.

"},{"location":"games/bemani/ddr/common/setup/#configuring-spice2x","title":"Configuring Spice2x","text":"

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/ddr/common/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • P1 Panel buttons: Up, Down, Left, Right
  • P1 Menu buttons: Start, Up, Down, Left, Right
  • P1 Keypad: 1 to 9, Keypad Insert Card
"},{"location":"games/bemani/ddr/common/setup/#overlay","title":"Overlay","text":"

Modifying buttons in this section is not required but you are free to change what you want.

Click on Bind then press the key you want associated with the action.

"},{"location":"games/bemani/ddr/common/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through spice2x.

If it does, here's how you may link different actions to your lights:

  • Click Bind.
  • In Device, pick your controller.
  • In Light Control, select the corresponding light.
  • Click Close.
  • Repeat for your other lights.
"},{"location":"games/bemani/ddr/common/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section.

"},{"location":"games/bemani/ddr/common/setup/#patches","title":"Patches","text":"

Go through the Spice2x Patching page to import patches.

To prevent issues, avoid patching things you don't need or understand.

"},{"location":"games/bemani/ddr/common/setup/#api","title":"API","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/ddr/common/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the question mark at the very left.

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Network EA Service URL -url Covered in Connecting to a network

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/ddr/common/setup/#advanced-development","title":"Advanced & Development","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/ddr/common/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/ddr/common/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/bemani/ddr/common/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/bemani/ddr/common/setup/#k-lite-codec-pack","title":"K-lite Codec Pack","text":"
  • Download and install the K-lite Codec Pack (the Standard version is enough)
"},{"location":"games/bemani/ddr/common/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/bemani/ddr/common/troubleshooting/","title":"Troubleshooting","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/ddr/common/troubleshooting/#clock-error","title":"Clock error","text":"

In the test menu, navigate to CLOCK, and set it to match your computer's time.

"},{"location":"games/bemani/ddr/common/troubleshooting/#my-game-is-running-slowlagging","title":"My game is running slow/lagging","text":"

Try to eliminate any unnecessary background processes during play.

"},{"location":"games/bemani/ddr/common/troubleshooting/#unable-to-login-eamuse-error-network-error","title":"Unable to login / Eamuse error / Network error","text":"

Get the proper Asphyxia plugin from our Discord server in the #ddr channel > Resources post. Make sure you didn't enable -smartea in spicecfg's options.

"},{"location":"games/bemani/ddr/common/troubleshooting/#where-are-the-option-for-dancersshadingmeasure-linesfast-slowlayering","title":"Where are the option for Dancers/Shading/Measure lines/Fast-Slow/Layering?","text":"

These options are locked behind network requirements and will not be displayed unless you are connected to a network that has written support for these options. Patches are available to mitigate this (see Patches).

"},{"location":"games/bemani/ddr/world/setup/","title":"Game Setup (DDR WORLD)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/ddr/world/setup/#about-data","title":"About data","text":"

The full game should be around 20-25gb in size.

Please keep the following in mind as you're going through this guide.

DDR's codename is MDX. Starting with DDR A20 this would be either:

  • MDX-001 (Other cabs, 32 bits)
  • MDX-003 (Gold cab, 64 bits)

The gold cab version contains more features, such as exclusive songs or the \"GOLDEN LEAGUE\" mode.

"},{"location":"games/bemani/ddr/world/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure with a few folders only, as follows.

If your data doesn't look like this

If you're missing the modules folder and instead have bunch of .dll files next to your folders:

  • Create a modules folder.
  • Move all .dll files inside of it so you end up with a structure as shown above.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/bemani/ddr/world/setup/#updating-data","title":"Updating data","text":"Please make sure you're using the right update for your current data.

DDR Patches re-uploaded by the community tend to be appropriately named MDX-DATECODE-to-DATECODE.

For example MDX-2024091000-to-2024101500.

  • 2024091000 being your current data's version.
  • 2024101500 being the one you would arrive at.
  • Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.
  • Open prop\\ea3-config.xml in a text editor and find the following lines near the top.
    <soft>\n        <model __type=\"str\">MDX</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">A</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024101500</ext>\n    </soft>\n

On the line with <ext __type=\"str\"> the datecode needs to match your new version.

  • If that's already the case then great! Don't touch anything.
  • If it instead corresponds to your pre-patch datecode, replace it with the new one and save the file.
"},{"location":"games/bemani/ddr/world/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

For MDX-001 (32 bits)
  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice.exe and spicecfg.exe files from the archive to your game's directory.

For MDX-003 (64 bits)
  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice64.exe and spicecfg.exe files from the archive to your game's directory.

"},{"location":"games/bemani/ddr/world/setup/#configuring-spice2x","title":"Configuring Spice2x","text":"

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/ddr/world/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • P1 Panel buttons: Up, Down, Left, Right
  • P1 Menu buttons: Start, Up, Down, Left, Right
  • P1 Keypad: 1 to 9, Keypad Insert Card
"},{"location":"games/bemani/ddr/world/setup/#overlay","title":"Overlay","text":"

Modifying buttons in this section is not required but you are free to change what you want.

Click on Bind then press the key you want associated with the action.

"},{"location":"games/bemani/ddr/world/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through spice2x.

If it does, here's how you may link different actions to your lights:

  • Click Bind.
  • In Device, pick your controller.
  • In Light Control, select the corresponding light.
  • Click Close.
  • Repeat for your other lights.
"},{"location":"games/bemani/ddr/world/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section.

"},{"location":"games/bemani/ddr/world/setup/#patches","title":"Patches","text":"

Go through the Spice2x Patching page to import patches.

To prevent issues, avoid patching things you don't need or understand.

"},{"location":"games/bemani/ddr/world/setup/#api","title":"API","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/ddr/world/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the question mark at the very left.

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Network EA Service URL -url Covered in Connecting to a network

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/ddr/world/setup/#advanced-development","title":"Advanced & Development","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/ddr/world/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/ddr/world/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/bemani/ddr/world/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/bemani/ddr/world/setup/#k-lite-codec-pack","title":"K-lite Codec Pack","text":"
  • Download and install the K-lite Codec Pack (the Standard version is enough)
"},{"location":"games/bemani/ddr/world/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/bemani/ddr/world/troubleshooting/","title":"Troubleshooting (DDR WORLD)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/ddr/world/troubleshooting/#clock-error","title":"Clock error","text":"

In the test menu, navigate to CLOCK, and set it to match your computer's time.

"},{"location":"games/bemani/ddr/world/troubleshooting/#my-game-is-running-slowlagging","title":"My game is running slow/lagging","text":"

Try to eliminate any unnecessary background processes during play.

"},{"location":"games/bemani/ddr/world/troubleshooting/#unable-to-login-eamuse-error-network-error","title":"Unable to login / Eamuse error / Network error","text":"

Get the proper Asphyxia plugin from our Discord server in the #ddr channel > Resources post. Make sure you didn't enable -smartea in spicecfg's options.

"},{"location":"games/bemani/ddr/world/troubleshooting/#where-are-the-option-for-dancersshadingmeasure-linesfast-slowlayering","title":"Where are the option for Dancers/Shading/Measure lines/Fast-Slow/Layering?","text":"

These options are locked behind network requirements and will not be displayed unless you are connected to a network that has written support for these options. Patches are available to mitigate this (see Patches).

"},{"location":"games/bemani/gitadora/exchain/setup/","title":"GITADORA EXCHAIN","text":"

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.

"},{"location":"games/bemani/gitadora/exchain/setup/#getting-started","title":"Getting Started.","text":"

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.

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.

Why does this look different than the usual? This installation includes a modules folder that Spice automatically detects, keeping things clean and simple.

"},{"location":"games/bemani/gitadora/exchain/setup/#configuring-your-tools","title":"Configuring Your Tools","text":"

Now that you have your files ready, open up your .bat file in your desired text editor (we're using Notepad++) 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.

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.

"},{"location":"games/bemani/gitadora/exchain/setup/#configuring-for-a-local-network","title":"Configuring for a Local Network","text":"

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++.

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++.

"},{"location":"games/bemani/gitadora/exchain/setup/#configuring-for-an-online-network","title":"Configuring for an Online Network","text":"

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++.

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++.

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.

"},{"location":"games/bemani/gitadora/exchain/setup/#final-steps-and-setting-up-the-game","title":"Final Steps and Setting up the Game","text":"

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!

This is normal, simply hit your Test keybind and continue on to this.

From here, we will need to set a shop name to play, so select the GAME OPTIONS option.

Then, select SHOP SETTINGS.

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.

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.

You're all done! From the service menu select GAME MODE and the game should load ready to be played! Have fun!

Have any other errors?

Check out the Troubleshooting section and Error Code section to resolve any issues not seen in this guide to greater depth.

"},{"location":"games/bemani/gitadora/exchain/troubleshooting/","title":"GITADORA EXCHAIN","text":""},{"location":"games/bemani/gitadora/exchain/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

Bemani PC Type 4

CPU: AMD Athlon 64 X2 4400

GPU: ATI Radeon HD 2400

RAM: 1 GB

OS: Windows 7 Embedded

"},{"location":"games/bemani/gitadora/exchain/troubleshooting/#my-game-is-running-slowlagging","title":"My Game Is Running Slow/Lagging","text":"

Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.

"},{"location":"games/bemani/gitadora/exchain/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

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.

"},{"location":"games/bemani/gitadora/exchain/troubleshooting/#game-stuck-on-title-screen-amd-ryzen-3900x","title":"Game Stuck On Title Screen (AMD Ryzen 3900X)","text":"

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

"},{"location":"games/bemani/gitadora/exchain/troubleshooting/#occasional-graphical-stuttering-during-gameplay","title":"Occasional Graphical Stuttering During Gameplay","text":"

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\".

"},{"location":"games/bemani/gitadora/exchain/troubleshooting/#i-get-an-ip-change-error","title":"I get an IP Change Error!","text":"

Apply the Fix IP Change Error patch.

"},{"location":"games/bemani/gitadora/exchain/troubleshooting/#which-offset-is-which","title":"Which Offset Is Which?","text":"

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.

"},{"location":"games/bemani/gitadora/exchain/troubleshooting/#why-are-my-videos-freezing-usually-towards-the-end-of-the-song","title":"Why Are My Videos Freezing (Usually Towards the End of the Song)?","text":"

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.

"},{"location":"games/bemani/gitadora/exchain/troubleshooting/#i-tried-switching-to-spicetools-to-follow-the-guide-and-it-crashes","title":"I Tried Switching to SpiceTools to Follow the Guide and It Crashes!","text":"

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.

"},{"location":"games/bemani/gitadora/exchain/troubleshooting/#my-drum-pedal-isnt-working","title":"My Drum Pedal Isn't Working!","text":"

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.

"},{"location":"games/bemani/gitadora/exchain/troubleshooting/#when-i-run-this-game-all-other-background-audio-is-gone-whats-going-on","title":"When I Run This Game All Other Background Audio Is Gone! What's Going On?","text":"

Gitadora is a 64-bit game that utilizes a feature in Windows called WASAPI exclusive mode to obtain less audio latency than the former 32-bit versions of BEMANI games which used DirectSound. Unfortunately, this cannot be changed.

"},{"location":"games/bemani/gitadora/exchain/troubleshooting/#note-on-2-channel-and-4-channel-audio","title":"Note on 2-channel and 4-channel Audio","text":"

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.

"},{"location":"games/bemani/gitadora/fuzzup/setup/","title":"GITADORA FUZZ-UP","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/gitadora/fuzzup/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice64.exe and spicecfg.exe files from the archive to your game's directory.

"},{"location":"games/bemani/gitadora/fuzzup/setup/#general-configuration","title":"General Configuration","text":"

Since GITADORA has a separate mode for both Guitar and Drums, the configuration will be split into three sections.This section will cover the general configuration that is not specific to either mode.

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/gitadora/fuzzup/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your keyboard, configure your keys for:

  • Maintenance: Test
  • P1 Keypad: Keypad 0 to 9, Keypad Insert Card
"},{"location":"games/bemani/gitadora/fuzzup/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a Network section.

"},{"location":"games/bemani/gitadora/fuzzup/setup/#patches","title":"Patches","text":"

Go through the Spice2x Patching page to import patches.

To prevent issues, avoid patching things you don't need or understand.

"},{"location":"games/bemani/gitadora/fuzzup/setup/#options","title":"Options","text":"

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Game Options GitaDora Two Channel Audio -2ch ON Network EA Service URL -url Covered in Connecting to a Network

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (Common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/gitadora/fuzzup/setup/#guitarfreaks-configuration","title":"GuitarFreaks Configuration","text":"

This section will cover the configuration specific to the Guitar mode.If you are wanting to configure drums, skip to the DrumMania Configuration section.

"},{"location":"games/bemani/gitadora/fuzzup/setup/#buttons_1","title":"Buttons","text":"

Set up your guitar as right-handed. Lefty mode is software-based.

Click on Bind then press the key you want associated with the action.

With your keyboard and controller plugged in, configure your keys for:

  • Guitar P1 IO Panel: Guitar P1 Start, Up, Down, Left, Right, Help
  • Guitar P1 Controls: Guitar P1 Pick Up, Pick Down, R, G, B, Y, P
"},{"location":"games/bemani/gitadora/fuzzup/setup/#analogs","title":"Analogs","text":"

Rather than setting your Wail to buttons, you should:

  • Find the Guitar P1 Wail X, Y, and Z analogs.
  • Click Bind.
  • In Device, pick your guitar.
  • In Control, pick the corresponding axis.
  • Move your guitar and ensure the Preview visualizer shows movement.
  • Repeat for other applicable axes your guitar has.
"},{"location":"games/bemani/gitadora/fuzzup/setup/#advanced","title":"Advanced","text":"

Not setting these values will cause the game to not boot into either mode.

Required

Category Option Parameter Setting Paths Path to ea3-config.xml -e prop/ea3-config2.xml Paths Path to avs-config.xml -v prop/avs-config-jb.xml"},{"location":"games/bemani/gitadora/fuzzup/setup/#drummania-configuration","title":"DrumMania Configuration","text":"

This section will cover the configuration specific to the Drums mode.If you are wanting to configure guitar, refer to the GuitarFreaks Configuration section.

"},{"location":"games/bemani/gitadora/fuzzup/setup/#buttons_2","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your keyboard and controller plugged in, configure your keys for:

  • Drum IO Panel: Drum Start, Up, Down, Left, Right, Help
  • Drum Controls: Drum Hi-Hat, Snare, Hi-Tom, Low-Tom, Right Cymbal, Bass Pedal, Left Cytmbal, Left Pedal, Floor Tom
"},{"location":"games/bemani/gitadora/fuzzup/setup/#advanced_1","title":"Advanced","text":"

Not setting these values will cause the game to not boot into either mode.

Required

Category Option Parameter Setting Paths Path to ea3-config.xml -e prop/ea3-config.xml Paths Path to avs-config.xml -v prop/avs-config-ja.xml"},{"location":"games/bemani/gitadora/fuzzup/setup/#connecting-to-a-network","title":"Connecting to a Network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/gitadora/fuzzup/setup/#pre-launch-requirements","title":"Pre-launch Requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/bemani/gitadora/fuzzup/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/bemani/gitadora/fuzzup/setup/#audio","title":"Audio","text":"

GITADORA FUZZ-UP currently only supports WASAPI exclusive mode.

  • Open spicecfg.exe.
  • At the very top, click on Shortcuts then Audio Playback Devices.
  • In the popup window, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick the 24 bit, 44100 Hz (Studio Quality) option and click Apply then OK.

"},{"location":"games/bemani/gitadora/fuzzup/setup/#first-launch","title":"First Launch","text":"

If you have any issues running the game at this point, refer to the Troubleshooting page.

If you've followed all instructions correctly, you're finally ready to launch the game!

First, ensure your guitar or drumkit is connected and run spice64.exe. Press Yes when it asks for elevated privileges.

Upon launching your game, you will be greeted with this BACKUP DATA ERROR screen.

This is normal, simply hit your Test keybind to enter test mode.

From here, we will need to set a shop name to play, so select the GAME OPTIONS option.

Then, select SHOP SETTINGS.

Once inside, select SHOP NAME SETTINGS and name your shop whatever you desire! 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 test menu.

The last menu we'll go inside from the test menu is the clock menu. Go inside CLOCK and simply set the clock by hitting SAVE AND EXIT as pictured below.

You're all done! From the test menu, select GAME MODE and the game should boot up!

"},{"location":"games/bemani/gitadora/fuzzup/setup/#carding-in","title":"Carding In","text":"

Once the game is done loading, you need to card in.

  • Press your Keypad Insert Card button.
  • Enter your code using your keypad binds.
"},{"location":"games/bemani/gitadora/fuzzup/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/bemani/gitadora/fuzzup/troubleshooting/","title":"GITADORA FUZZ-UP","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/gitadora/fuzzup/troubleshooting/#im-having-performance-issues","title":"I'm having performance issues!","text":"

If you're having performance issues of some kind, spice2x's PC optimization guide is worth looking at.

"},{"location":"games/bemani/gitadora/fuzzup/troubleshooting/#my-game-is-running-too-fast","title":"My game is running too fast!","text":"

The most common reason for this is the game is running over its required refresh rate.

To solve this, ensure the monitor running GITADORA FUZZ-UP is set to 60Hz. This is a requirement for the game to run at the correct speed. The game is hardcoded to run at 60Hz and there is no way to change this.

In addition, make sure v-sync isn't disabled in your graphics card's settings.

For NVIDIA users, enable NVIDIA profile optimization (-nvprofile) in the Options tab.

"},{"location":"games/bemani/gitadora/fuzzup/troubleshooting/#theres-occasional-graphical-stuttering-during-gameplay","title":"There's occasional graphical stuttering during gameplay!","text":"

To fix this, you need to disable fullscreen optimizations for spice64.exe.

  1. Right click on spice64.exe and select Properties.
  2. Go to the Compatibility tab.
  3. Click the box at the bottom that says Change settings for all users.
  4. Check the box that says Disable fullscreen optimizations.
  5. Click Apply and then OK.
"},{"location":"games/bemani/gitadora/fuzzup/troubleshooting/#how-do-i-adjust-my-offset","title":"How do I adjust my offset?","text":"

Play through a chart you're comfortable with.

If you're getting too many Fast, increase your offset (+). If you're getting too many Slow, decrease your offset (-).

GITADORA FUZZ-UP has two types of offset adjustments, visual and audio based, so be sure to fiddle with both to find desirable settings.

"},{"location":"games/bemani/gitadora/fuzzup/troubleshooting/#when-i-run-the-game-all-other-audio-is-gone","title":"When I run the game, all other audio is gone!","text":"

GITADORA FUZZ-UP uses WASAPI exclusive mode for better audio latency.

There is currently no patch available to run the game in shared mode, so you will need to use a separate audio device for the game if you want to hear other audio sources while playing.

"},{"location":"games/bemani/gitadora/fuzzup/troubleshooting/#i-want-to-use-4-channel-audio-why-isnt-it-working","title":"I want to use 4-channel audio! Why isn't it working?","text":"

Unfortunately, most setups do not properly function with GITADORA FUZZ-UP's 4-channel audio, and the -2ch parameter will be mandatory to hear any audio. There are not many setups working with 4-channel audio, and there are buffer issues related to it. Please avoid using it.

"},{"location":"games/bemani/gitadora/matixx/setup/","title":"GITADORA Matixx","text":"

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.

"},{"location":"games/bemani/gitadora/matixx/setup/#getting-started","title":"Getting Started.","text":"

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.

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.

"},{"location":"games/bemani/gitadora/matixx/setup/#configuring-your-tools","title":"Configuring Your Tools","text":"

Now that you have your files ready, open up your .bat file in your desired text editor (we're using Notepad++) 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.

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.

"},{"location":"games/bemani/gitadora/matixx/setup/#configuring-for-a-local-network","title":"Configuring for a Local Network","text":"

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++.

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++.

"},{"location":"games/bemani/gitadora/matixx/setup/#configuring-for-an-online-network","title":"Configuring for an Online Network","text":"

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++.

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++.

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.

"},{"location":"games/bemani/gitadora/matixx/setup/#final-steps-and-setting-up-the-game","title":"Final Steps and Setting up the Game","text":"

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!

This is normal, simply hit your Test keybind and continue on to this.

From here, we will need to set a shop name to play, so select the GAME OPTIONS option.

Then, select SHOP SETTINGS.

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.

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.

You're all done! From the service menu select GAME MODE and the game should load ready to be played! Have fun!

Have any other errors?

Check out the Troubleshooting section and Error Code section to resolve any issues not seen in this guide to greater depth.

"},{"location":"games/bemani/gitadora/matixx/troubleshooting/","title":"GITADORA Matixx","text":""},{"location":"games/bemani/gitadora/matixx/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

Bemani PC Type 4

CPU: AMD Athlon 64 X2 4400

GPU: ATI Radeon HD 2400

RAM: 1 GB

OS: Windows 7 Embedded

"},{"location":"games/bemani/gitadora/matixx/troubleshooting/#my-game-is-running-slowlagging","title":"My Game Is Running Slow/Lagging","text":"

Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.

"},{"location":"games/bemani/gitadora/matixx/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

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.

"},{"location":"games/bemani/gitadora/matixx/troubleshooting/#game-stuck-on-title-screen-amd-ryzen-3900x","title":"Game Stuck On Title Screen (AMD Ryzen 3900X)","text":"

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

"},{"location":"games/bemani/gitadora/matixx/troubleshooting/#occasional-graphical-stuttering-during-gameplay","title":"Occasional Graphical Stuttering During Gameplay","text":"

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\".

"},{"location":"games/bemani/gitadora/matixx/troubleshooting/#i-get-an-ip-change-error","title":"I get an IP Change Error!","text":"

Apply the Fix IP Change Error patch.

"},{"location":"games/bemani/gitadora/matixx/troubleshooting/#which-offset-is-which","title":"Which Offset Is Which?","text":"

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.

"},{"location":"games/bemani/gitadora/matixx/troubleshooting/#why-are-my-videos-freezing-usually-towards-the-end-of-the-song","title":"Why Are My Videos Freezing (Usually Towards the End of the Song)?","text":"

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.

"},{"location":"games/bemani/gitadora/matixx/troubleshooting/#i-tried-switching-to-spicetools-to-follow-the-guide-and-it-crashes","title":"I Tried Switching to SpiceTools to Follow the Guide and It Crashes!","text":"

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.

"},{"location":"games/bemani/gitadora/matixx/troubleshooting/#my-drum-pedal-isnt-working","title":"My Drum Pedal Isn't Working!","text":"

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.

"},{"location":"games/bemani/gitadora/matixx/troubleshooting/#when-i-run-this-game-all-other-background-audio-is-gone-whats-going-on","title":"When I Run This Game All Other Background Audio Is Gone! What's Going On?","text":"

Gitadora is a 64-bit game that utilizes a feature in Windows called WASAPI exclusive mode to obtain less audio latency than the former 32-bit versions of BEMANI games which used DirectSound. Unfortunately, this cannot be changed.

"},{"location":"games/bemani/gitadora/matixx/troubleshooting/#note-on-2-channel-and-4-channel-audio","title":"Note on 2-channel and 4-channel Audio","text":"

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.

"},{"location":"games/bemani/iidx/10thstyle/setup/","title":"beatmania IIDX 10th style","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/iidx/10thstyle/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.
"},{"location":"games/bemani/iidx/10thstyle/setup/#installing-bemanitools","title":"Installing Bemanitools","text":"

  • Download Bemanitools.

  • Inside bemanitools-5.48.zip locate iidx-09-to-12.zip.

  • Extract everything inside the folder that contains the bm2dx.exe which is located in \\D01\\JAE.

Pictured below is what your folder should look like. We've removed any files not necessary for 10th style.

"},{"location":"games/bemani/iidx/10thstyle/setup/#using-iidxhook-10conf-rteffectdll","title":"Using iidxhook-10.conf & RtEffect.dll","text":"

  • Download the Bemanitools supplements

  • Open bemanitools-supplement-v1.6.zip and navigate inside misc.zip

  • Inside misc\\d3d8to9, extract d3d8.dll to \\D01\\JAE.

This enables us to use the graphic options inside iidxhook-10.conf which we will take advantage of.

  • Open bemanitools-supplement-v1.6.zip and navigate inside iidx.zip

  • Inside iidx/misc, extract RtEffect_stub.dll to \\D01\\JAE.

  • Delete the already existing RtEffect.dll and rename RtEffect_stub.dll to RtEffect.dll.

This will eliminate any immediate crashes relating to needing specific old hardware.

"},{"location":"games/bemani/iidx/10thstyle/setup/#replacing-bm2dxexe","title":"Replacing bm2dx.exe","text":"

  • Go to D01\\util and copy bm2dx_D01_JAE_no_checksum.exe to D01\\JAE

  • Delete the original bm2dx.exe

  • Rename bm2dx_D01_JAE_no_checksum.exe to bm2dx.exe

If you don't do this, you will end up getting a HDD DATA ERROR (PROG CHKSUM) which will result in the game not being able to run.

"},{"location":"games/bemani/iidx/10thstyle/setup/#configuring-bemanitools","title":"Configuring Bemanitools","text":"

To configure your keybinds, open your config.bat file.

"},{"location":"games/bemani/iidx/10thstyle/setup/#buttons","title":"Buttons","text":"

Double click on the right on a button that you wish to bind, then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • P1 Game buttons: 1 to 7, Start, EFFECT, VEFX
  • P1 Keypad: Keypad Insert Card

Only if you're playing using a keyboard:

  • Turntable: TT+, TT- and optionally TT+/- which alternates between TT+ and TT- on each press.
"},{"location":"games/bemani/iidx/10thstyle/setup/#analogs-controllercab-only","title":"Analogs (controller/cab only)","text":"

With a controller rather than binding buttons to TT+ and TT-, you need to:

  • Head to the Analogs tab at the top.
  • In Device, pick your controller.
  • In Control, pick whichever one corresponds to the turntable.
  • Turn your turntable ensuring that the preview turns along with it.
  • Click OK, leaving the rest of the settings alone.
"},{"location":"games/bemani/iidx/10thstyle/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through bemanitools.

If it does, here's how you may link different actions to your lights:

  • In Device, pick your controller.
  • In Game Light, select the corresponding button that will be used for that light.
  • Repeat for your other lights.
"},{"location":"games/bemani/iidx/10thstyle/setup/#configuring-bemanitools-for-a-network","title":"Configuring Bemanitools for a network","text":"

Head over to the Network tab.

Now we will set up our PIN pad and card.

  • Click on Keyboard device
  • You may or may not have more than one option. To figure out which one is your actual keyboard, select a device inside that list and press a button on the numpad.
  • Once you have found your correct device, the Keyboard status will change (the number and location of the number does not matter, it only matters that it changed).
  • Grab your card, create a .txt and name it however you like. In this example it's called card.txt
  • Place the file in a location that is easily accessible and you won't forget. In this case it's in a seperate folder.

If you don't have a numpad, make sure to tick Use top keyboard row for PIN pad input. This will also change the Card In button to Backspace.

"},{"location":"games/bemani/iidx/10thstyle/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

  • Locate your iidxhook-10.conf

  • Open it with your desired text editor (we're using Notepad++)

  • Replace the eamuse.server=localhost:80 with your desired network URL

  • Replace eamuse.pcbid=XXXXXXXXXXXXXXXXXXXX and eamuse.eamid=XXXXXXXXXXXXXXXXXXXX with your PCBID of your network of choice.

# URL (e.g. http://my.eamuse.server:80/whatever) or IPV4 (e.g. 127.0.0.1:80) of the target eamuse server. The port is optional but defaults to 80.\neamuse.server=localhost:80\n\n# PCBID\neamuse.pcbid=XXXXXXXXXXXXXXXXXXXX\n\n# EAMID\neamuse.eamid=XXXXXXXXXXXXXXXXXXXX\n
"},{"location":"games/bemani/iidx/10thstyle/setup/#game-resolution-and-locking-fps","title":"Game resolution and locking FPS","text":"

We'd like to mention that there are two options when it comes to how the game renders. You can choose between Linear and Point.

Below is an example of how both look like.

Linear

Point

It comes down to your own prefrence what you decide on, Linear is less sharp but doesn't have pixel perfect edges. Point is sharp and is pixel perfect.

Next up, we'll setup borderless window and configure the proper resolution. We're using a 1920x1080 monitor so we will use that.

Repeat the previous step and open your iidxhook-10.conf. We want to find these lines:

# Run the game windowed\ngfx.windowed=false\n\n# Windowed width, 0 for default size\ngfx.window_width=0\n\n# Windowed height, 0 for default size\ngfx.window_height=0\n\n# Up-/downscale the back buffer's width. This does not change the game's rendering resolution but scales the final frame. Use this to target the native resolution of your monitor/TV, e.g. to avoid over-/underscan, bad image quality or latency caused by the monitors internal upscaler. 0 to disable this feature. Must be set in combination with the corresponding height parameter.\ngfx.scale_back_buffer_width=0\n\n# Up-/downscale the back buffer's height. This does not change the game's rendering resolution but scales the final frame. Use this to target the native resolution of your monitor/TV, e.g. to avoid over-/underscan, bad image quality or latency caused by the monitors internal upscaler. 0 to disable this feature. Must be set in combination with the corresponding width parameter.\ngfx.scale_back_buffer_height=0\n\n# Filter type to use for up-/downscaling the back buffer. Only used if scaling feature was enabled by setting the scaling width and height parameters. Available types: none, linear, point (refer to D3DTEXTUREFILTERTYPE  for explanation).\ngfx.scale_back_buffer_filter=none\n

If you can't seem to find them, press CTRL + F and search for gfx.frame_rate_limit=0.0. This will bring you to the first line we want to edit.

Listed below are the values we want to change them to.

gfx.frame_rate_limit=59.95\ngfx.windowed=true\ngfx.window_width=1920\ngfx.window_height=1080\ngfx.scale_back_buffer_width=1920\ngfx.scale_back_buffer_height=1080\ngfx.scale_back_buffer_filter=point\n
Unless you'd like to have the game properly windowed you can safely ignore gfx.framed=false.

Make sure to decide on whether you want Linear or Point rendering.

gfx.scale_back_buffer_filter=linear\ngfx.scale_back_buffer_filter=point\n
"},{"location":"games/bemani/iidx/10thstyle/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

"},{"location":"games/bemani/iidx/10thstyle/setup/#backup-data","title":"BACKUP DATA","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run gamestart.bat.

If it's your first time running the game, you'll immediately be greeted with this screen.

Press your Start key to confirm to get to the next error message.

"},{"location":"games/bemani/iidx/10thstyle/setup/#clock-error","title":"CLOCK ERROR","text":"

Press your Start key to confirm. This will bring you into it's service menu.

Instructions on how to navigate the menu are shown at the bottom of the screen.

  • Press 1 and 2 to go up and down.
  • Press 6 to select/execute.

Navigate to CLOCK. You do not need to manually change it. Navigate to SAVE AND EXIT.

"},{"location":"games/bemani/iidx/10thstyle/setup/#enabling-e-amusement-for-online-play","title":"Enabling e-AMUSEMENT for Online Play","text":"

From the service menu, go to e-AMUSEMENT OPTIONS then e-AMUSEMENT SETTINGS.

It'll bring you to this screen, change it so that e-AMUSEMENT switches to ON and it will look like this:

We will need to set a SHOP NAME SETTING and change our PREFECTURE otherwise the game will throw errors at us.

  • Name your shop to whatever you'd like. Instructions on how to navigate are at the bottom of the screen.
  • Navigate to EXIT and select it.
  • Change your prefecture once or how many times you'd like, it doesn't matter as long as it's not the default one.

Select SAVE AND EXIT. The game will now give you a message, which translated means:

e-AMUSEMENT settings have been changed. Please turn the power off and on again.

So, close the game and open it again.

"},{"location":"games/bemani/iidx/10thstyle/setup/#final-notes","title":"Final Notes","text":"

You're all done! Make sure to insert two credits by pressing your SERVICE key. Have fun!

Have any other errors?

Check out the Troubleshooting section.

"},{"location":"games/bemani/iidx/10thstyle/troubleshooting/","title":"IIDX 10 Troubleshooting","text":""},{"location":"games/bemani/iidx/10thstyle/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

The most common reason for this is the game is running over its required 59.95hz, the game is hardcoded to run at 59.95hz and this cannot be changed. To solve this, check Game resolution and locking FPS again.

"},{"location":"games/bemani/iidx/10thstyle/troubleshooting/#im-getting-network-warning-instead-of-network-ok","title":"I'm getting \"NETWORK WARNING\" instead of \"NETWORK OK\"","text":"

This can be caused by:

  • Invalid PCBID
  • Firewall blocking connections
  • Invalid eamuse url or port specified
  • Game is not run using the Administrator account
"},{"location":"games/bemani/iidx/10thstyle/troubleshooting/#my-background-videos-arent-working","title":"My background videos aren't working!","text":"

You need to install a codec.

  • Open bemanitools-supplement-v1.6.zip and navigate to \\iidx.zip\\iidx\\misc\\ where CLVSD.ax is located.

  • Extract CLVSD.ax inside a folder that you know won't be moved or renamed.

  • Open the command prompt as administrator. Now type regsvr32 \"<location of the file>\\CLVSD.ax\" into the command prompt.

As an example, it could look like this: regsvr32 \"D:\\BEMANI\\IIDX\\CLVSD.ax\"

A prompt should appear telling you that it has been installed successfully. This applies for all styles that require this codec, not just 10th style.

If an error occurs, you didn't run the command prompt as administrator or you messed up the location of the file.

You can not move or delete CLVSD.ax at all, otherwise it will revert the changes and you have to install it again.

"},{"location":"games/bemani/iidx/10thstyle/troubleshooting/#my-game-crashes-immediately","title":"My game crashes immediately!","text":"

This can have multiple reasons. These fixes shouldn't be needed for 10th style since we're addressing them in the guide. We'll add them anyway just in case.

"},{"location":"games/bemani/iidx/10thstyle/troubleshooting/#fix-1-wrong-data-structure","title":"Fix #1 (Wrong data structure)","text":"

Make sure that your unpacked data looks like this:

  • JAx (Game binary revision folder where 'x' can be A, B, C, D, E, F, G)
  • data
  • sidcode.txt

Any other files are optional and don't have to be removed as these are not required to run the game.

"},{"location":"games/bemani/iidx/10thstyle/troubleshooting/#fix-2-rteffectsdll-didnt-get-replaced","title":"Fix #2 (RtEffects.dll didn't get replaced)","text":"

Refer to Using iidxhook-10.conf & RtEffect.dll again and check if you have followed all the instructions explained in it.

"},{"location":"games/bemani/iidx/11_red/setup/","title":"beatmania IIDX 11 IIDX RED","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/iidx/11_red/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.
"},{"location":"games/bemani/iidx/11_red/setup/#installing-bemanitools","title":"Installing Bemanitools","text":"

  • Download Bemanitools.

  • Inside bemanitools-5.48.zip locate iidx-09-to-12.zip.

  • Extract everything inside the folder that contains the bm2dx.exe which is located in \\E11\\JAA.

Pictured below is what your folder should look like. We've removed any files not necessary for IIDX RED.

"},{"location":"games/bemani/iidx/11_red/setup/#using-iidxhook-11conf-rteffectdll","title":"Using iidxhook-11.conf & RtEffect.dll","text":"

  • Download the Bemanitools supplements

  • Open bemanitools-supplement-v1.6.zip and navigate inside misc.zip

  • Inside misc\\d3d8to9, extract d3d8.dll to \\E11\\JAA.

This enables us to use the graphic options inside iidxhook-11.conf which we will take advantage of.

  • Open bemanitools-supplement-v1.6.zip and navigate inside iidx.zip

  • Inside iidx/misc, extract RtEffect_stub.dll to \\E11\\JAA.

  • Delete the already existing RtEffect.dll and rename RtEffect_stub.dll to RtEffect.dll.

This will eliminate any immediate crashes relating to needing specific old hardware.

"},{"location":"games/bemani/iidx/11_red/setup/#configuring-bemanitools","title":"Configuring Bemanitools","text":"

To configure your keybinds, open your config.bat file.

"},{"location":"games/bemani/iidx/11_red/setup/#buttons","title":"Buttons","text":"

Double click on the right on a button that you wish to bind, then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • P1 Game buttons: 1 to 7, Start, EFFECT, VEFX
  • P1 Keypad: Keypad Insert Card

Only if you're playing using a keyboard:

  • Turntable: TT+, TT- and optionally TT+/- which alternates between TT+ and TT- on each press.
"},{"location":"games/bemani/iidx/11_red/setup/#analogs-controllercab-only","title":"Analogs (controller/cab only)","text":"

With a controller rather than binding buttons to TT+ and TT-, you need to:

  • Head to the Analogs tab at the top.
  • In Device, pick your controller.
  • In Control, pick whichever one corresponds to the turntable.
  • Turn your turntable ensuring that the preview turns along with it.
  • Click OK, leaving the rest of the settings alone.
"},{"location":"games/bemani/iidx/11_red/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through bemanitools.

If it does, here's how you may link different actions to your lights:

  • In Device, pick your controller.
  • In Game Light, select the corresponding button that will be used for that light.
  • Repeat for your other lights.
"},{"location":"games/bemani/iidx/11_red/setup/#configuring-bemanitools-for-a-network","title":"Configuring Bemanitools for a network","text":"

Head over to the Network tab.

Now we will set up our PIN pad and card.

  • Click on Keyboard device
  • You may or may not have more than one option. To figure out which one is your actual keyboard, select a device inside that list and press a button on the numpad.
  • Once you have found your correct device, the Keyboard status will change (the number and location of the number does not matter, it only matters that it changed).
  • Grab your card, create a .txt and name it however you like. In this example it's called card.txt
  • Place the file in a location that is easily accessible and you won't forget. In this case it's in a seperate folder.

If you don't have a numpad, make sure to tick Use top keyboard row for PIN pad input. This will also change the Card In button to Backspace.

"},{"location":"games/bemani/iidx/11_red/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

  • Locate your iidxhook-11.conf

  • Open it with your desired text editor (we're using Notepad++)

  • Replace the eamuse.server=localhost:80 with your desired network URL

  • Replace eamuse.pcbid=XXXXXXXXXXXXXXXXXXXX and eamuse.eamid=XXXXXXXXXXXXXXXXXXXX with your PCBID of your network of choice.

# URL (e.g. http://my.eamuse.server:80/whatever) or IPV4 (e.g. 127.0.0.1:80) of the target eamuse server. The port is optional but defaults to 80.\neamuse.server=localhost:80\n\n# PCBID\neamuse.pcbid=XXXXXXXXXXXXXXXXXXXX\n\n# EAMID\neamuse.eamid=XXXXXXXXXXXXXXXXXXXX\n
"},{"location":"games/bemani/iidx/11_red/setup/#game-resolution-and-locking-fps","title":"Game resolution and locking FPS","text":"

We'd like to mention that there are two options when it comes to how the game renders. You can choose between Linear and Point.

Below is an example of how both look like.

Linear

Point

It comes down to your own prefrence what you decide on, Linear is less sharp but doesn't have pixel perfect edges. Point is sharp and is pixel perfect.

Next up, we'll setup borderless window and configure the proper resolution. We're using a 1920x1080 monitor so we will use that.

Repeat the previous step and open your iidxhook-11.conf. We want to find these lines:

# Software limit the frame rate of the rendering loop in hz, e.g. 60 or 59.95 (0.0 = no software limit)\ngfx.frame_rate_limit=0.0\n\n# Run the game windowed\ngfx.windowed=false\n\n# Windowed width, 0 for default size\ngfx.window_width=0\n\n# Windowed height, 0 for default size\ngfx.window_height=0\n\n# Up-/downscale the back buffer's width. This does not change the game's rendering resolution but scales the final frame. Use this to target the native resolution of your monitor/TV, e.g. to avoid over-/underscan, bad image quality or latency caused by the monitors internal upscaler. 0 to disable this feature. Must be set in combination with the corresponding height parameter.\ngfx.scale_back_buffer_width=0\n\n# Up-/downscale the back buffer's height. This does not change the game's rendering resolution but scales the final frame. Use this to target the native resolution of your monitor/TV, e.g. to avoid over-/underscan, bad image quality or latency caused by the monitors internal upscaler. 0 to disable this feature. Must be set in combination with the corresponding width parameter.\ngfx.scale_back_buffer_height=0\n\n# Filter type to use for up-/downscaling the back buffer. Only used if scaling feature was enabled by setting the scaling width and height parameters. Available types: none, linear, point (refer to D3DTEXTUREFILTERTYPE  for explanation).\ngfx.scale_back_buffer_filter=none\n

If you can't seem to find them, press CTRL + F and search for gfx.frame_rate_limit=0.0. This will bring you to the first line we want to edit.

Listed below are the values we want to change them to.

gfx.frame_rate_limit=59.95\ngfx.windowed=true\ngfx.window_width=1920\ngfx.window_height=1080\ngfx.scale_back_buffer_width=1920\ngfx.scale_back_buffer_height=1080\ngfx.scale_back_buffer_filter=point\n
Unless you'd like to have the game properly windowed you can safely ignore gfx.framed=false.

Make sure to decide on whether you want Linear or Point rendering.

gfx.scale_back_buffer_filter=linear\ngfx.scale_back_buffer_filter=point\n
"},{"location":"games/bemani/iidx/11_red/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

"},{"location":"games/bemani/iidx/11_red/setup/#backup-data","title":"BACKUP DATA","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run gamestart.bat.

If it's your first time running the game, you'll immediately be greeted with this screen.

Press your Start key to confirm to get to the next error message.

"},{"location":"games/bemani/iidx/11_red/setup/#clock-error","title":"CLOCK ERROR","text":"

Press your Start key to confirm. This will bring you into it's service menu.

Instructions on how to navigate the menu are shown at the bottom of the screen.

  • Press 1 and 2 to go up and down.
  • Press 6 to select/execute.

Navigate to CLOCK. You do not need to manually change it. Navigate to SAVE AND EXIT.

"},{"location":"games/bemani/iidx/11_red/setup/#enabling-e-amusement-for-online-play","title":"Enabling e-AMUSEMENT for Online Play","text":"

From the service menu, go to NETWORK OPTIONS then e-AMUSEMENT SETTINGS.

It'll bring you to this screen, change it so that e-AMUSEMENT switches to ON and it will look like this:

We will need to set a SHOP NAME SETTING and change our PREFECTURE otherwise the game will throw errors at us.

  • Name your shop to whatever you'd like. Instructions on how to navigate are at the bottom of the screen.
  • Navigate to EXIT and select it.
  • Change your prefecture once or how many times you'd like, it doesn't matter as long as it's not the default one.

Select SAVE AND EXIT. The game will now give you a message, which translated means:

e-AMUSEMENT settings have been changed. Please turn the power off and on again.

So, close the game and open it again.

"},{"location":"games/bemani/iidx/11_red/setup/#final-notes","title":"Final Notes","text":"

You're all done! Make sure to insert two credits by pressing your SERVICE key. Have fun!

Have any other errors?

Check out the Troubleshooting section.

"},{"location":"games/bemani/iidx/11_red/troubleshooting/","title":"beatmania IIDX 11 IIDX RED","text":""},{"location":"games/bemani/iidx/11_red/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

The most common reason for this is the game is running over its required 59.95hz, the game is hardcoded to run at 59.95hz and this cannot be changed. To solve this, check Game resolution and locking FPS of the guide again.

"},{"location":"games/bemani/iidx/11_red/troubleshooting/#im-getting-network-warning-instead-of-network-ok","title":"I'm getting \"NETWORK WARNING\" instead of \"NETWORK OK\"","text":"

This can be caused by:

  • Invalid PCBID
  • Firewall blocking connections
  • Invalid eamuse url or port specified
  • Game is not run using the Administrator account
"},{"location":"games/bemani/iidx/11_red/troubleshooting/#my-background-videos-arent-working","title":"My background videos aren't working!","text":"

You need to install a codec.

  • Open bemanitools-supplement-v1.6.zip and navigate to \\iidx.zip\\iidx\\misc\\ where CLVSD.ax is located.

  • Extract CLVSD.ax inside a folder that you know won't be moved or renamed.

  • Open the command prompt as administrator. Now type regsvr32 \"<location of the file>\\CLVSD.ax\" into the command prompt.

As an example, it could look like this: regsvr32 \"D:\\BEMANI\\IIDX\\CLVSD.ax\"

A prompt should appear telling you that it has been installed successfully. This applies for all styles that require this codec, not just IIDX RED.

If an error occurs, you didn't run the command prompt as administrator or you messed up the location of the file.

You can not move or delete CLVSD.ax at all, otherwise it will revert the changes and you have to install it again.

"},{"location":"games/bemani/iidx/11_red/troubleshooting/#my-game-crashes-immediately","title":"My game crashes immediately!","text":"

This can have multiple reasons. These fixes shouldn't be needed for IIDX RED since we're addressing them in the guide. We'll add them anyway just in case.

"},{"location":"games/bemani/iidx/11_red/troubleshooting/#fix-1-wrong-data-structure","title":"Fix #1 (Wrong data structure)","text":"

Make sure that your unpacked data looks like this:

  • JAx (Game binary revision folder where 'x' can be A, B, C, D, E, F, G)
  • data
  • sidcode.txt

Any other files are optional and don't have to be removed as these are not required to run the game.

"},{"location":"games/bemani/iidx/11_red/troubleshooting/#fix-2-rteffectsdll-didnt-get-replaced","title":"Fix #2 (RtEffects.dll didn't get replaced)","text":"

Refer to Using iidxhook-11.conf & RtEffect.dll again and check if you have followed all the instructions explained in it.

"},{"location":"games/bemani/iidx/12_happysky/setup/","title":"beatmania IIDX 12 HAPPY SKY","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/iidx/12_happysky/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.
"},{"location":"games/bemani/iidx/12_happysky/setup/#installing-bemanitools","title":"Installing Bemanitools","text":"

  • Download Bemanitools.

  • Inside bemanitools-5.48.zip locate iidx-09-to-12.zip.

  • Extract everything inside the folder that contains the bm2dx.exe which is located in \\ECO\\JAD.

Pictured below is what your folder should look like. We've removed any files not necessary for HAPPY SKY.

"},{"location":"games/bemani/iidx/12_happysky/setup/#using-iidxhook-12conf-rteffectdll","title":"Using iidxhook-12.conf & RtEffect.dll","text":"

  • Download the Bemanitools supplements

  • Open bemanitools-supplement-v1.6.zip and navigate inside misc.zip

  • Inside misc\\d3d8to9, extract d3d8.dll to \\ECO\\JAD.

This enables us to use the graphic options inside iidxhook-12.conf which we will take advantage of.

  • Open bemanitools-supplement-v1.6.zip and navigate inside iidx.zip

  • Inside iidx/misc, extract RtEffect_stub.dll to \\ECO\\JAD.

  • Delete the already existing RtEffect.dll and rename RtEffect_stub.dll to RtEffect.dll.

This will eliminate any immediate crashes relating to needing specific old hardware.

"},{"location":"games/bemani/iidx/12_happysky/setup/#installing-clvsdax","title":"Installing CLVSD.ax","text":"

We need to install a codec so that background videos will work and won't cause an error.

  • Open bemanitools-supplement-v1.6.zip and navigate to \\iidx.zip\\iidx\\misc\\ where CLVSD.ax is located.

  • Extract CLVSD.ax inside a folder that you know won't be moved or renamed.

  • Open the command prompt as administrator. Now type regsvr32 \"<location of the file>\\CLVSD.ax\" into the command prompt.

As an example, it could look like this: regsvr32 \"D:\\BEMANI\\IIDX\\CLVSD.ax\"

A prompt should appear telling you that it has been installed successfully. This applies for all styles that require this codec, not just HAPPY SKY.

If an error occurs, you didn't run the command prompt as administrator or you messed up the location of the file.

You can not move or delete CLVSD.ax at all, otherwise it will revert the changes and you have to install it again.

"},{"location":"games/bemani/iidx/12_happysky/setup/#configuring-bemanitools","title":"Configuring Bemanitools","text":"

To configure your keybinds, open your config.bat file.

"},{"location":"games/bemani/iidx/12_happysky/setup/#buttons","title":"Buttons","text":"

Double click on the right on a button that you wish to bind, then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • P1 Game buttons: 1 to 7, Start, EFFECT, VEFX
  • P1 Keypad: Keypad Insert Card

Only if you're playing using a keyboard:

  • Turntable: TT+, TT- and optionally TT+/- which alternates between TT+ and TT- on each press.
"},{"location":"games/bemani/iidx/12_happysky/setup/#analogs-controllercab-only","title":"Analogs (controller/cab only)","text":"

With a controller rather than binding buttons to TT+ and TT-, you need to:

  • Head to the Analogs tab at the top.
  • In Device, pick your controller.
  • In Control, pick whichever one corresponds to the turntable.
  • Turn your turntable ensuring that the preview turns along with it.
  • Click OK, leaving the rest of the settings alone.
"},{"location":"games/bemani/iidx/12_happysky/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through bemanitools.

If it does, here's how you may link different actions to your lights:

  • In Device, pick your controller.
  • In Game Light, select the corresponding button that will be used for that light.
  • Repeat for your other lights.
"},{"location":"games/bemani/iidx/12_happysky/setup/#configuring-bemanitools-for-a-network","title":"Configuring Bemanitools for a network","text":"

Head over to the Network tab.

Now we will set up our PIN pad and card.

  • Click on Keyboard device
  • You may or may not have more than one option. To figure out which one is your actual keyboard, select a device inside that list and press a button on the numpad.
  • Once you have found your correct device, the Keyboard status will change (the number and location of the number does not matter, it only matters that it changed).
  • Grab your card, create a .txt and name it however you like. In this example it's called card.txt
  • Place the file in a location that is easily accessible and you won't forget. In this case it's in a seperate folder.

If you don't have a numpad, make sure to tick Use top keyboard row for PIN pad input. This will also change the Card In button to Backspace.

"},{"location":"games/bemani/iidx/12_happysky/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

  • Locate your iidxhook-12.conf

  • Open it with your desired text editor (we're using Notepad++)

  • Replace the eamuse.server=localhost:80 with your desired network URL

  • Replace eamuse.pcbid=XXXXXXXXXXXXXXXXXXXX and eamuse.eamid=XXXXXXXXXXXXXXXXXXXX with your PCBID of your network of choice.

# URL (e.g. http://my.eamuse.server:80/whatever) or IPV4 (e.g. 127.0.0.1:80) of the target eamuse server. The port is optional but defaults to 80.\neamuse.server=localhost:80\n\n# PCBID\neamuse.pcbid=XXXXXXXXXXXXXXXXXXXX\n\n# EAMID\neamuse.eamid=XXXXXXXXXXXXXXXXXXXX\n
"},{"location":"games/bemani/iidx/12_happysky/setup/#game-resolution-and-locking-fps","title":"Game resolution and locking FPS","text":"

We'd like to mention that there are two options when it comes to how the game renders. You can choose between Linear and Point.

Below is an example of how both look like.

Linear

Point

It comes down to your own prefrence what you decide on, Linear is less sharp but doesn't have pixel perfect edges. Point is sharp and is pixel perfect.

Next up, we'll setup borderless window and configure the proper resolution. We're using a 1920x1080 monitor so we will use that.

Repeat the previous step and open your iidxhook-12.conf. We want to find these lines:

# Software limit the frame rate of the rendering loop in hz, e.g. 60 or 59.95 (0.0 = no software limit)\ngfx.frame_rate_limit=0.0\n\n# Run the game windowed\ngfx.windowed=false\n\n# Windowed width, 0 for default size\ngfx.window_width=0\n\n# Windowed height, 0 for default size\ngfx.window_height=0\n\n# Up-/downscale the back buffer's width. This does not change the game's rendering resolution but scales the final frame. Use this to target the native resolution of your monitor/TV, e.g. to avoid over-/underscan, bad image quality or latency caused by the monitors internal upscaler. 0 to disable this feature. Must be set in combination with the corresponding height parameter.\ngfx.scale_back_buffer_width=0\n\n# Up-/downscale the back buffer's height. This does not change the game's rendering resolution but scales the final frame. Use this to target the native resolution of your monitor/TV, e.g. to avoid over-/underscan, bad image quality or latency caused by the monitors internal upscaler. 0 to disable this feature. Must be set in combination with the corresponding width parameter.\ngfx.scale_back_buffer_height=0\n\n# Filter type to use for up-/downscaling the back buffer. Only used if scaling feature was enabled by setting the scaling width and height parameters. Available types: none, linear, point (refer to D3DTEXTUREFILTERTYPE  for explanation).\ngfx.scale_back_buffer_filter=none\n

If you can't seem to find them, press CTRL + F and search for gfx.frame_rate_limit=0.0. This will bring you to the first line we want to edit.

Listed below are the values we want to change them to.

gfx.frame_rate_limit=59.95\ngfx.windowed=true\ngfx.window_width=1920\ngfx.window_height=1080\ngfx.scale_back_buffer_width=1920\ngfx.scale_back_buffer_height=1080\ngfx.scale_back_buffer_filter=point\n
Unless you'd like to have the game properly windowed you can safely ignore gfx.framed=false.

Make sure to decide on whether you want Linear or Point rendering.

gfx.scale_back_buffer_filter=linear\ngfx.scale_back_buffer_filter=point\n
"},{"location":"games/bemani/iidx/12_happysky/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

"},{"location":"games/bemani/iidx/12_happysky/setup/#backup-data","title":"BACKUP DATA","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run gamestart.bat.

If it's your first time running the game, you'll immediately be greeted with this screen.

Press your Start key to confirm to get to the next error message.

"},{"location":"games/bemani/iidx/12_happysky/setup/#clock-error","title":"CLOCK ERROR","text":"

Press your Start key to confirm. This will bring you into it's service menu.

Instructions on how to navigate the menu are shown at the bottom of the screen.

  • Press 1 and 2 to go up and down.
  • Press 6 to select/execute.

Navigate to CLOCK. You do not need to manually change it. Navigate to SAVE AND EXIT.

"},{"location":"games/bemani/iidx/12_happysky/setup/#enabling-e-amusement-for-online-play","title":"Enabling e-AMUSEMENT for Online Play","text":"

From the service menu, go to NETWORK OPTIONS then e-AMUSEMENT SETTINGS.

It'll bring you to this screen, change it so that e-AMUSEMENT switches to ON and it will look like this:

We will need to set a SHOP NAME SETTING and change our PREFECTURE otherwise the game will throw errors at us.

  • Name your shop to whatever you'd like. Instructions on how to navigate are at the bottom of the screen.
  • Navigate to EXIT and select it.
  • Change your prefecture once or how many times you'd like, it doesn't matter as long as it's not the default one.

Select SAVE AND EXIT. The game will now give you a message, which translated means:

e-AMUSEMENT settings have been changed. Please turn the power off and on again.

So, close the game and open it again.

"},{"location":"games/bemani/iidx/12_happysky/setup/#final-notes","title":"Final Notes","text":"

You're all done! Make sure to insert two credits by pressing your SERVICE key. Have fun!

Have any other errors?

Check out the Troubleshooting section.

"},{"location":"games/bemani/iidx/12_happysky/troubleshooting/","title":"beatmania IIDX 12 HAPPY SKY","text":""},{"location":"games/bemani/iidx/12_happysky/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

The most common reason for this is the game is running over its required 59.95hz, the game is hardcoded to run at 59.95hz and this cannot be changed. To solve this, check Game resolution and locking FPS of the guide again.

"},{"location":"games/bemani/iidx/12_happysky/troubleshooting/#im-getting-network-warning-instead-of-network-ok","title":"I'm getting \"NETWORK WARNING\" instead of \"NETWORK OK\"","text":"

This can be caused by:

  • Invalid PCBID
  • Firewall blocking connections
  • Invalid eamuse url or port specified
  • Game is not run using the Administrator account
"},{"location":"games/bemani/iidx/12_happysky/troubleshooting/#my-background-videos-arent-working","title":"My background videos aren't working!","text":"

You need to install a codec.

  • Open bemanitools-supplement-v1.6.zip and navigate to \\iidx.zip\\iidx\\misc\\ where CLVSD.ax is located.

  • Extract CLVSD.ax inside a folder that you know won't be moved or renamed.

  • Open the command prompt as administrator. Now type regsvr32 \"<location of the file>\\CLVSD.ax\" into the command prompt.

As an example, it could look like this: regsvr32 \"D:\\BEMANI\\IIDX\\CLVSD.ax\"

A prompt should appear telling you that it has been installed successfully. This applies for all styles that require this codec, not just HAPPY SKY.

If an error occurs, you didn't run the command prompt as administrator or you messed up the location of the file.

You can not move or delete CLVSD.ax at all, otherwise it will revert the changes and you have to install it again.

"},{"location":"games/bemani/iidx/12_happysky/troubleshooting/#my-game-crashes-immediately","title":"My game crashes immediately!","text":"

This can have multiple reasons. These fixes shouldn't be needed for HAPPY SKY since we're addressing them in the guide. We'll add them anyway just in case.

"},{"location":"games/bemani/iidx/12_happysky/troubleshooting/#fix-1-wrong-data-structure","title":"Fix #1 (Wrong data structure)","text":"

Make sure that your unpacked data looks like this:

  • JAx (Game binary revision folder where 'x' can be A, B, C, D, E, F, G)
  • data
  • sidcode.txt

Any other files are optional and don't have to be removed as these are not required to run the game.

"},{"location":"games/bemani/iidx/12_happysky/troubleshooting/#fix-2-rteffectsdll-didnt-get-replaced","title":"Fix #2 (RtEffects.dll didn't get replaced)","text":"

Refer to Using iidxhook-12.conf & RtEffect.dll again and check if you have followed all the instructions explained in it.

"},{"location":"games/bemani/iidx/13_distorted/setup/","title":"beatmania IIDX 13 DistorteD","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/iidx/13_distorted/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.
"},{"location":"games/bemani/iidx/13_distorted/setup/#installing-bemanitools","title":"Installing Bemanitools","text":"

  • Download Bemanitools.

  • Inside bemanitools-5.48.zip locate iidx-13.zip.

  • Extract everything inside the folder that contains the bm2dx.exe which is located in \\FDD\\JAG.

Pictured below is what your folder should look like. We've removed any files not necessary for DistorteD.

"},{"location":"games/bemani/iidx/13_distorted/setup/#using-iidxhook-13conf-rteffectdll","title":"Using iidxhook-13.conf & RtEffect.dll","text":"

  • Download the Bemanitools supplements

  • Open bemanitools-supplement-v1.6.zip and navigate inside misc.zip

  • Inside misc\\d3d8to9, extract d3d8.dll to \\FDD\\JAG.

This enables us to use the graphic options inside iidxhook-13.conf which we will take advantage of.

  • Open bemanitools-supplement-v1.6.zip and navigate inside iidx.zip

  • Inside iidx/misc, extract RtEffect_stub.dll to \\FDD\\JAG.

  • Delete the already existing RtEffect.dll and rename RtEffect_stub.dll to RtEffect.dll.

This will eliminate any immediate crashes relating to needing specific old hardware.

"},{"location":"games/bemani/iidx/13_distorted/setup/#installing-clvsdax","title":"Installing CLVSD.ax","text":"

We need to install a codec so that background videos will work and won't cause an error.

  • Open bemanitools-supplement-v1.6.zip and navigate to \\iidx.zip\\iidx\\misc\\ where CLVSD.ax is located.

  • Extract CLVSD.ax inside a folder that you know won't be moved or renamed.

  • Open the command prompt as administrator. Now type regsvr32 \"<location of the file>\\CLVSD.ax\" into the command prompt.

As an example, it could look like this: regsvr32 \"D:\\BEMANI\\IIDX\\CLVSD.ax\"

A prompt should appear telling you that it has been installed successfully. This applies for all styles that require this codec, not just DistorteD.

If an error occurs, you didn't run the command prompt as administrator or you messed up the location of the file.

You can not move or delete CLVSD.ax at all, otherwise it will revert the changes and you have to install it again.

"},{"location":"games/bemani/iidx/13_distorted/setup/#configuring-bemanitools","title":"Configuring Bemanitools","text":"

To configure your keybinds, open your config.bat file.

"},{"location":"games/bemani/iidx/13_distorted/setup/#buttons","title":"Buttons","text":"

Double click on the right on a button that you wish to bind, then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • P1 Game buttons: 1 to 7, Start, EFFECT, VEFX
  • P1 Keypad: Keypad Insert Card

Only if you're playing using a keyboard:

  • Turntable: TT+, TT- and optionally TT+/- which alternates between TT+ and TT- on each press.
"},{"location":"games/bemani/iidx/13_distorted/setup/#analogs-controllercab-only","title":"Analogs (controller/cab only)","text":"

With a controller rather than binding buttons to TT+ and TT-, you need to:

  • Head to the Analogs tab at the top.
  • In Device, pick your controller.
  • In Control, pick whichever one corresponds to the turntable.
  • Turn your turntable ensuring that the preview turns along with it.
  • Click OK, leaving the rest of the settings alone.
"},{"location":"games/bemani/iidx/13_distorted/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through bemanitools.

If it does, here's how you may link different actions to your lights:

  • In Device, pick your controller.
  • In Game Light, select the corresponding button that will be used for that light.
  • Repeat for your other lights.
"},{"location":"games/bemani/iidx/13_distorted/setup/#configuring-bemanitools-for-a-network","title":"Configuring Bemanitools for a network","text":"

Head over to the Network tab.

Now we will set up our PIN pad and card.

  • Click on Keyboard device
  • You may or may not have more than one option. To figure out which one is your actual keyboard, select a device inside that list and press a button on the numpad.
  • Once you have found your correct device, the Keyboard status will change (the number and location of the number does not matter, it only matters that it changed).
  • Grab your card, create a .txt and name it however you like. In this example it's called card.txt
  • Place the file in a location that is easily accessible and you won't forget. In this case it's in a seperate folder.

If you don't have a numpad, make sure to tick Use top keyboard row for PIN pad input. This will also change the Card In button to Backspace.

"},{"location":"games/bemani/iidx/13_distorted/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

  • Locate your iidxhook-13.conf

  • Open it with your desired text editor (we're using Notepad++)

  • Replace the eamuse.server=localhost:80 with your desired network URL

  • Replace eamuse.pcbid=XXXXXXXXXXXXXXXXXXXX and eamuse.eamid=XXXXXXXXXXXXXXXXXXXX with your PCBID of your network of choice.

# URL (e.g. http://my.eamuse.server:80/whatever) or IPV4 (e.g. 127.0.0.1:80) of the target eamuse server. The port is optional but defaults to 80.\neamuse.server=localhost:80\n\n# PCBID\neamuse.pcbid=XXXXXXXXXXXXXXXXXXXX\n\n# EAMID\neamuse.eamid=XXXXXXXXXXXXXXXXXXXX\n
"},{"location":"games/bemani/iidx/13_distorted/setup/#game-resolution-and-locking-fps","title":"Game resolution and locking FPS","text":"

We'd like to mention that there are two options when it comes to how the game renders. You can choose between Linear and Point.

Below is an example of how both look like.

Linear

Point

It comes down to your own prefrence what you decide on, Linear is less sharp but doesn't have pixel perfect edges. Point is sharp and is pixel perfect.

Next up, we'll setup borderless window and configure the proper resolution. We're using a 1920x1080 monitor so we will use that.

Repeat the previous step and open your iidxhook-12.conf. We want to find these lines:

# Software limit the frame rate of the rendering loop in hz, e.g. 60 or 59.95 (0.0 = no software limit)\ngfx.frame_rate_limit=0.0\n\n# Run the game windowed\ngfx.windowed=false\n\n# Windowed width, 0 for default size\ngfx.window_width=0\n\n# Windowed height, 0 for default size\ngfx.window_height=0\n\n# Up-/downscale the back buffer's width. This does not change the game's rendering resolution but scales the final frame. Use this to target the native resolution of your monitor/TV, e.g. to avoid over-/underscan, bad image quality or latency caused by the monitors internal upscaler. 0 to disable this feature. Must be set in combination with the corresponding height parameter.\ngfx.scale_back_buffer_width=0\n\n# Up-/downscale the back buffer's height. This does not change the game's rendering resolution but scales the final frame. Use this to target the native resolution of your monitor/TV, e.g. to avoid over-/underscan, bad image quality or latency caused by the monitors internal upscaler. 0 to disable this feature. Must be set in combination with the corresponding width parameter.\ngfx.scale_back_buffer_height=0\n\n# Filter type to use for up-/downscaling the back buffer. Only used if scaling feature was enabled by setting the scaling width and height parameters. Available types: none, linear, point (refer to D3DTEXTUREFILTERTYPE  for explanation).\ngfx.scale_back_buffer_filter=none\n

If you can't seem to find them, press CTRL + F and search for gfx.frame_rate_limit=0.0. This will bring you to the first line we want to edit.

Listed below are the values we want to change them to.

gfx.frame_rate_limit=59.95\ngfx.windowed=true\ngfx.window_width=1920\ngfx.window_height=1080\ngfx.scale_back_buffer_width=1920\ngfx.scale_back_buffer_height=1080\ngfx.scale_back_buffer_filter=linear\n
Unless you'd like to have the game properly windowed you can safely ignore gfx.framed=false.

Make sure to decide on whether you want Linear or Point rendering.

gfx.scale_back_buffer_filter=linear\ngfx.scale_back_buffer_filter=point\n
"},{"location":"games/bemani/iidx/13_distorted/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

"},{"location":"games/bemani/iidx/13_distorted/setup/#backup-data","title":"BACKUP DATA","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run gamestart.bat.

If it's your first time running the game, you'll immediately be greeted with this screen.

Press your Test key to confirm to get to the next error message.

"},{"location":"games/bemani/iidx/13_distorted/setup/#clock-error","title":"CLOCK ERROR","text":"

Press your Test key to confirm. This will bring you into it's service menu.

Instructions on how to navigate the menu are shown at the bottom of the screen.

  • Press 1 and 2 to go up and down.
  • Press 6 to select/execute.

Navigate to CLOCK. You do not need to manually change it. Navigate to SAVE AND EXIT.

"},{"location":"games/bemani/iidx/13_distorted/setup/#enabling-e-amusement-for-online-play","title":"Enabling e-AMUSEMENT for Online Play","text":"

From the service menu, go to NETWORK OPTIONS then e-AMUSEMENT SETTINGS.

It'll bring you to this screen, change it so that e-AMUSEMENT switches to ON and it will look like this:

We will need to set a SHOP NAME SETTING and change our PREFECTURE otherwise the game will throw errors at us.

  • Name your shop to whatever you'd like. Instructions on how to navigate are at the bottom of the screen.
  • Navigate to EXIT and select it.
  • Change your prefecture once or how many times you'd like, it doesn't matter as long as it's not the default one.

Select SAVE AND EXIT. The game will now give you a message, which translated means:

e-AMUSEMENT settings have been changed. Please turn the power off and on again.

So, close the game and open it again.

"},{"location":"games/bemani/iidx/13_distorted/setup/#final-notes","title":"Final Notes","text":"

You're all done! Make sure to insert two credits by pressing your SERVICE key. Have fun!

Have any other errors?

Check out the Troubleshooting section.

"},{"location":"games/bemani/iidx/13_distorted/troubleshooting/","title":"beatmania IIDX 13 DistorteD","text":""},{"location":"games/bemani/iidx/13_distorted/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

The most common reason for this is the game is running over its required 59.95hz, the game is hardcoded to run at 59.95hz and this cannot be changed. To solve this, check Game resolution and locking FPS of the guide again.

"},{"location":"games/bemani/iidx/13_distorted/troubleshooting/#im-getting-network-warning-instead-of-network-ok","title":"I'm getting \"NETWORK WARNING\" instead of \"NETWORK OK\"","text":"

This can be caused by:

  • Invalid PCBID
  • Firewall blocking connections
  • Invalid eamuse url or port specified
  • Game is not run using the Administrator account
"},{"location":"games/bemani/iidx/13_distorted/troubleshooting/#my-background-videos-arent-working","title":"My background videos aren't working!","text":"

You need to install a codec.

  • Open bemanitools-supplement-v1.6.zip and navigate to \\iidx.zip\\iidx\\misc\\ where CLVSD.ax is located.

  • Extract CLVSD.ax inside a folder that you know won't be moved or renamed.

  • Open the command prompt as administrator. Now type regsvr32 \"<location of the file>\\CLVSD.ax\" into the command prompt.

As an example, it could look like this: regsvr32 \"D:\\BEMANI\\IIDX\\CLVSD.ax\"

A prompt should appear telling you that it has been installed successfully. This applies for all styles that require this codec, not just DistorteD.

If an error occurs, you didn't run the command prompt as administrator or you messed up the location of the file.

You can not move or delete CLVSD.ax at all, otherwise it will revert the changes and you have to install it again.

"},{"location":"games/bemani/iidx/13_distorted/troubleshooting/#my-game-crashes-immediately","title":"My game crashes immediately!","text":"

This can have multiple reasons. These fixes shouldn't be needed for DistorteD since we're addressing them in the guide. We'll add them anyway just in case.

"},{"location":"games/bemani/iidx/13_distorted/troubleshooting/#fix-1-wrong-data-structure","title":"Fix #1 (Wrong data structure)","text":"

Make sure that your unpacked data looks like this:

  • JAx (Game binary revision folder where 'x' can be A, B, C, D, E, F, G)
  • data
  • sidcode.txt

Any other files are optional and don't have to be removed as these are not required to run the game.

"},{"location":"games/bemani/iidx/13_distorted/troubleshooting/#fix-2-rteffectsdll-didnt-get-replaced","title":"Fix #2 (RtEffects.dll didn't get replaced)","text":"

Refer to Using iidxhook-13.conf & RtEffect.dll again and check if you have followed all the instructions explained in it.

"},{"location":"games/bemani/iidx/14_gold/setup/","title":"beatmania IIDX 14 GOLD","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/iidx/14_gold/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.
"},{"location":"games/bemani/iidx/14_gold/setup/#installing-bemanitools","title":"Installing Bemanitools","text":"

  • Download Bemanitools.

  • Inside bemanitools-5.48.zip locate iidx-14-to-17.zip.

  • Extract everything inside the folder that contains the bm2dx.exe which is located in \\GLD\\2007072301.

Pictured below is what your folder should look like. We've removed any files not necessary for GOLD.

"},{"location":"games/bemani/iidx/14_gold/setup/#using-iidxhook-14conf","title":"Using iidxhook-14.conf","text":"

  • Download the Bemanitools supplements

  • Open bemanitools-supplement-v1.6.zip and navigate inside misc.zip

  • Inside misc\\d3d8to9, extract d3d8.dll to \\GLD\\2007072301.

This enables us to use the graphic options inside iidxhook-14.conf which we will take advantage of.

"},{"location":"games/bemani/iidx/14_gold/setup/#installing-clvsdax","title":"Installing CLVSD.ax","text":"

We need to install a codec so that background videos will work and won't cause an error.

  • Open bemanitools-supplement-v1.6.zip and navigate to \\iidx.zip\\iidx\\misc\\ where CLVSD.ax is located.

  • Extract CLVSD.ax inside a folder that you know won't be moved or renamed.

  • Open the command prompt as administrator. Now type regsvr32 \"<location of the file>\\CLVSD.ax\" into the command prompt.

As an example, it could look like this: regsvr32 \"D:\\BEMANI\\IIDX\\CLVSD.ax\"

A prompt should appear telling you that it has been installed successfully. This applies for all styles that require this codec, not just GOLD.

If an error occurs, you didn't run the command prompt as administrator or you messed up the location of the file.

You can not move or delete CLVSD.ax at all, otherwise it will revert the changes and you have to install it again.

"},{"location":"games/bemani/iidx/14_gold/setup/#configuring-bemanitools","title":"Configuring Bemanitools","text":"

To configure your keybinds, open your config.bat file.

"},{"location":"games/bemani/iidx/14_gold/setup/#buttons","title":"Buttons","text":"

Double click on the right on a button that you wish to bind, then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • P1 Game buttons: 1 to 7, Start, EFFECT, VEFX
  • P1 Keypad: Keypad Insert Card

Only if you're playing using a keyboard:

  • Turntable: TT+, TT- and optionally TT+/- which alternates between TT+ and TT- on each press.
"},{"location":"games/bemani/iidx/14_gold/setup/#analogs-controllercab-only","title":"Analogs (controller/cab only)","text":"

With a controller rather than binding buttons to TT+ and TT-, you need to:

  • Head to the Analogs tab at the top.
  • In Device, pick your controller.
  • In Control, pick whichever one corresponds to the turntable.
  • Turn your turntable ensuring that the preview turns along with it.
  • Click OK, leaving the rest of the settings alone.
"},{"location":"games/bemani/iidx/14_gold/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through bemanitools.

If it does, here's how you may link different actions to your lights:

  • In Device, pick your controller.
  • In Game Light, select the corresponding button that will be used for that light.
  • Repeat for your other lights.
"},{"location":"games/bemani/iidx/14_gold/setup/#configuring-bemanitools-for-a-network","title":"Configuring Bemanitools for a network","text":"

Head over to the Network tab.

Now we will set up our PIN pad and card.

  • Click on Keyboard device
  • You may or may not have more than one option. To figure out which one is your actual keyboard, select a device inside that list and press a button on the numpad.
  • Once you have found your correct device, the Keyboard status will change (the number and location of the number does not matter, it only matters that it changed).
  • Grab your card, create a .txt and name it however you like. In this example it's called card.txt
  • Place the file in a location that is easily accessible and you won't forget. In this case it's in a seperate folder.

If you don't have a numpad, make sure to tick Use top keyboard row for PIN pad input. This will also change the Card In button to Backspace.

"},{"location":"games/bemani/iidx/14_gold/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

  • Locate your iidxhook-14.conf

  • Open it with your desired text editor (we're using Notepad++)

  • Replace the eamuse.server=localhost:80 with your desired network URL

  • Replace eamuse.pcbid=XXXXXXXXXXXXXXXXXXXX and eamuse.eamid=XXXXXXXXXXXXXXXXXXXX with your PCBID of your network of choice.

# URL (e.g. http://my.eamuse.server:80/whatever) or IPV4 (e.g. 127.0.0.1:80) of the target eamuse server. The port is optional but defaults to 80.\neamuse.server=localhost:80\n\n# PCBID\neamuse.pcbid=XXXXXXXXXXXXXXXXXXXX\n\n# EAMID\neamuse.eamid=XXXXXXXXXXXXXXXXXXXX\n
"},{"location":"games/bemani/iidx/14_gold/setup/#game-resolution-and-locking-fps","title":"Game resolution and locking FPS","text":"

We'd like to mention that there are two options when it comes to how the game renders. You can choose between Linear and Point.

Below is an example of how both look like.

Linear

Point

It comes down to your own prefrence what you decide on, Linear is less sharp but doesn't have pixel perfect edges. Point is sharp and is pixel perfect.

Next up, we'll setup borderless window and configure the proper resolution. We're using a 1920x1080 monitor so we will use that.

Repeat the previous step and open your iidxhook-14.conf. We want to find these lines:

# Software limit the frame rate of the rendering loop in hz, e.g. 60 or 59.95 (0.0 = no software limit)\ngfx.frame_rate_limit=0.0\n\n# Run the game windowed\ngfx.windowed=false\n\n# Windowed width, 0 for default size\ngfx.window_width=0\n\n# Windowed height, 0 for default size\ngfx.window_height=0\n\n# Up-/downscale the back buffer's width. This does not change the game's rendering resolution but scales the final frame. Use this to target the native resolution of your monitor/TV, e.g. to avoid over-/underscan, bad image quality or latency caused by the monitors internal upscaler. 0 to disable this feature. Must be set in combination with the corresponding height parameter.\ngfx.scale_back_buffer_width=0\n\n# Up-/downscale the back buffer's height. This does not change the game's rendering resolution but scales the final frame. Use this to target the native resolution of your monitor/TV, e.g. to avoid over-/underscan, bad image quality or latency caused by the monitors internal upscaler. 0 to disable this feature. Must be set in combination with the corresponding width parameter.\ngfx.scale_back_buffer_height=0\n\n# Filter type to use for up-/downscaling the back buffer. Only used if scaling feature was enabled by setting the scaling width and height parameters. Available types: none, linear, point (refer to D3DTEXTUREFILTERTYPE  for explanation).\ngfx.scale_back_buffer_filter=none\n

If you can't seem to find them, press CTRL + F and search for gfx.frame_rate_limit=0.0. This will bring you to the first line we want to edit.

Listed below are the values we want to change them to.

gfx.frame_rate_limit=59.95\ngfx.windowed=true\ngfx.window_width=1920\ngfx.window_height=1080\ngfx.scale_back_buffer_width=1920\ngfx.scale_back_buffer_height=1080\ngfx.scale_back_buffer_filter=linear\n
Unless you'd like to have the game properly windowed you can safely ignore gfx.framed=false.

Make sure to decide on whether you want Linear or Point rendering.

gfx.scale_back_buffer_filter=linear\ngfx.scale_back_buffer_filter=point\n
"},{"location":"games/bemani/iidx/14_gold/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

"},{"location":"games/bemani/iidx/14_gold/setup/#backup-data","title":"BACKUP DATA","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run gamestart.bat.

If it's your first time running the game, you'll immediately be greeted with this screen.

If you get USB I/O ERROR ERROR(FM TRNS-OUT) or USB I/O ERROR ERROR(FM-DL TIMEOUT)

Reboot the game and it should get fixed.

Press your Test key to confirm to get to the next error message.

"},{"location":"games/bemani/iidx/14_gold/setup/#clock-error","title":"CLOCK ERROR","text":"

Press your Test key to confirm. The game will then perform a MONITOR CHECK.

After the monitor check, the game will bring you into it's service menu.

Instructions on how to navigate the menu are shown at the bottom of the screen.

  • Press 1 and 2 to go up and down.
  • Press 6 to select/execute.

Navigate to CLOCK. You do not need to manually change it. Navigate to SAVE AND EXIT.

"},{"location":"games/bemani/iidx/14_gold/setup/#enabling-e-amusement-for-online-play","title":"Enabling e-AMUSEMENT for Online Play","text":"

From the service menu, go to NETWORK OPTIONS then e-AMUSEMENT SETTINGS.

We will need to set a SHOP NAME SETTING and change our SETTING AREA otherwise the game will throw errors at us.

  • Name your shop to whatever you'd like. Instructions on how to navigate are at the bottom of the screen.
  • Navigate to EXIT and select it.
  • Change your SETTING AREA once or how many times you'd like, it doesn't matter as long as it's not the default one.

Select SAVE AND EXIT.

"},{"location":"games/bemani/iidx/14_gold/setup/#final-notes","title":"Final Notes","text":"

You're all done! From the service menu select GAMEMODE and the game should load ready to be played. Make sure to insert two credits by pressing your SERVICE key. Have fun!

Have any other errors?

Check out the Troubleshooting section.

"},{"location":"games/bemani/iidx/14_gold/troubleshooting/","title":"beatmania IIDX 14 GOLD","text":""},{"location":"games/bemani/iidx/14_gold/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

The most common reason for this is the game is running over its required 59.95hz, the game is hardcoded to run at 59.95hz and this cannot be changed. To solve this, check Game resolution and locking FPS of the guide again.

"},{"location":"games/bemani/iidx/14_gold/troubleshooting/#im-getting-network-warning-instead-of-network-ok","title":"I'm getting \"NETWORK WARNING\" instead of \"NETWORK OK\"","text":"

This can be caused by:

  • Invalid PCBID
  • Firewall blocking connections
  • Invalid eamuse url or port specified
  • Game is not run using the Administrator account
"},{"location":"games/bemani/iidx/14_gold/troubleshooting/#my-background-videos-arent-working","title":"My background videos aren't working!","text":"

You need to install a codec.

  • Open bemanitools-supplement-v1.6.zip and navigate to \\iidx.zip\\iidx\\misc\\ where CLVSD.ax is located.

  • Extract CLVSD.ax inside a folder that you know won't be moved or renamed.

  • Open the command prompt as administrator. Now type regsvr32 \"<location of the file>\\CLVSD.ax\" into the command prompt.

As an example, it could look like this: regsvr32 \"D:\\BEMANI\\IIDX\\CLVSD.ax\"

A prompt should appear telling you that it has been installed successfully. This applies for all styles that require this codec, not just GOLD.

If an error occurs, you didn't run the command prompt as administrator or you messed up the location of the file.

You can not move or delete CLVSD.ax at all, otherwise it will revert the changes and you have to install it again.

"},{"location":"games/bemani/iidx/14_gold/troubleshooting/#my-game-crashes-immediately","title":"My game crashes immediately!","text":"

This can have multiple reasons. This fix shouldn't be needed for GOLD since we're addressing them in the guide. We'll add it anyway just in case.

"},{"location":"games/bemani/iidx/14_gold/troubleshooting/#wrong-data-structure","title":"Wrong data structure","text":"

Make sure that your unpacked data looks like this:

  • yyyymmddrr (y = year digit, m = month digit, d = day digit, r = revision digit) revision folder containing game binary and libraries
  • data
  • sidcode.txt

Any other files are optional and don't have to be removed as these are not required to run the game.

"},{"location":"games/bemani/iidx/24_sinobuz/setup/","title":"beatmania IIDX 24 SINOBUZ","text":"

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.

Note:

This game uses 32-bit tools!

"},{"location":"games/bemani/iidx/24_sinobuz/setup/#getting-started","title":"Getting Started","text":"

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 whatever you desire, for the sake of convenience we've named ours gamestart.bat.

"},{"location":"games/bemani/iidx/24_sinobuz/setup/#configuring-your-tools","title":"Configuring Your Tools","text":"

Now that you have your files ready, open up your .bat file in your desired text editor (we're using Notepad++) 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.

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.

"},{"location":"games/bemani/iidx/24_sinobuz/setup/#configuring-for-a-local-network","title":"Configuring for a Local Network","text":"

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++.

"},{"location":"games/bemani/iidx/24_sinobuz/setup/#configuring-for-an-online-network","title":"Configuring for an Online Network","text":"

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++.

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.

"},{"location":"games/bemani/iidx/24_sinobuz/setup/#final-steps-and-setting-up-the-game","title":"Final Steps and Setting up the Game","text":"

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.

Hit the Test keybinding to initialize the backup data, a message will pop up stating it's been initialized.

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.

Start by navigating up to CLOCK and entering that menu.

Simply hit save and exit and leave, the clock will be saved. Then, back in the service menu, go up to GAME OPTIONS

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.

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.

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.

You're all done! From the service menu select GAME MODE and the game should load ready to be played! Have fun!

Have any other errors?

Check out the Troubleshooting section and Error Code section to resolve any issues not seen in this guide to greater depth.

"},{"location":"games/bemani/iidx/24_sinobuz/troubleshooting/","title":"beatmania IIDX 24 SINOBUZ","text":""},{"location":"games/bemani/iidx/24_sinobuz/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

Warning:

The specs may not be correct. If something isn't correct or it's fine, let me know.

Bemani PC (ADE-704A)

Konami (2012-2017)

This board has a E4690 Radeon MXM card.

CPU: Intel Celeron B810

GPU: AMD Radeon E4690

NIC: Realtek RTL8168/8111

Chipset: Intel HM65

RAM: 4 GB

OS: Windows XP Embedded with Service Pack 2

"},{"location":"games/bemani/iidx/24_sinobuz/troubleshooting/#my-game-is-running-slowlagging","title":"My Game Is Running Slow/Lagging","text":"

Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.

"},{"location":"games/bemani/iidx/24_sinobuz/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

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.

"},{"location":"games/bemani/iidx/24_sinobuz/troubleshooting/#occasional-game-stutters-during-play","title":"Occasional Game Stutters During Play","text":"

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.

"},{"location":"games/bemani/iidx/24_sinobuz/troubleshooting/#hd-and-hd","title":"HD and HD*","text":"

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.

"},{"location":"games/bemani/iidx/24_sinobuz/troubleshooting/#which-offset-is-which","title":"Which Offset Is Which?","text":"

If you're getting too many fasts, increase your offset (+). If you're getting too many slows, decrease your offset (-).

"},{"location":"games/bemani/iidx/25_cannonballers/setup/","title":"beatmania IIDX 25 CANNON BALLERS","text":"

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.

"},{"location":"games/bemani/iidx/25_cannonballers/setup/#getting-started","title":"Getting Started","text":"

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.

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.

"},{"location":"games/bemani/iidx/25_cannonballers/setup/#configuring-your-tools","title":"Configuring Your Tools","text":"

Now that you have your files ready, open up your .bat file in your desired text editor (we're using Notepad++) 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.

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.

"},{"location":"games/bemani/iidx/25_cannonballers/setup/#configuring-for-a-local-network","title":"Configuring for a Local Network","text":"

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++.

"},{"location":"games/bemani/iidx/25_cannonballers/setup/#configuring-for-an-online-network","title":"Configuring for an Online Network","text":"

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++.

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.

"},{"location":"games/bemani/iidx/25_cannonballers/setup/#final-steps-and-setting-up-the-game","title":"Final Steps and Setting up the Game","text":"

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!

Ignore this message, simply hit your Test keybind and continue onto this.

Hit the Test keybinding again to initialize the backup data, a message will pop up stating it's been initialized.

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.

Start by navigating up to CLOCK and entering that menu.

Simply hit save and exit and leave, the clock will be saved. Then, back in the service menu, go up to GAME OPTIONS

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.

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.

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.

You're all done! From the service menu select GAME MODE and the game should load ready to be played! Have fun!

Have any other errors?

Check out the Troubleshooting section and Error Code section to resolve any issues not seen in this guide to greater depth.

"},{"location":"games/bemani/iidx/25_cannonballers/troubleshooting/","title":"beatmania IIDX 25 CANNON BALLERS","text":""},{"location":"games/bemani/iidx/25_cannonballers/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

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

"},{"location":"games/bemani/iidx/25_cannonballers/troubleshooting/#my-game-is-running-slowlagging","title":"My Game Is Running Slow/Lagging","text":"

Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.

"},{"location":"games/bemani/iidx/25_cannonballers/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

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.

"},{"location":"games/bemani/iidx/25_cannonballers/troubleshooting/#camera-device-error-message","title":"Camera Device Error Message","text":"

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 patch.

"},{"location":"games/bemani/iidx/25_cannonballers/troubleshooting/#occasional-game-stutters-during-play","title":"Occasional Game Stutters During Play","text":"

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.

"},{"location":"games/bemani/iidx/25_cannonballers/troubleshooting/#hd-and-hd","title":"HD and HD*","text":"

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.

"},{"location":"games/bemani/iidx/25_cannonballers/troubleshooting/#which-offset-is-which","title":"Which Offset Is Which?","text":"

If you're getting too many fasts, increase your offset (+). If you're getting too many slows, decrease your offset (-).

"},{"location":"games/bemani/iidx/25_cannonballers/troubleshooting/#a-note-about-sse-42","title":"A Note About SSE 4.2","text":"

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. But, in the event your processor does not have this, there is a patch available to bypass this.

"},{"location":"games/bemani/iidx/25_cannonballers/troubleshooting/#when-i-run-this-game-all-other-background-audio-is-gone-whats-going-on","title":"When I Run This Game All Other Background Audio Is Gone! What's Going On?","text":"

64-bit versions of IIDX are now utilizing a feature in Windows called WASAPI exclusive mode to obtain less audio latency than the former 32-bit versions of the games which used DirectSound. Unfortunately, this cannot be changed.

"},{"location":"games/bemani/iidx/25_cannonballers/troubleshooting/#im-not-getting-any-audiomy-audio-is-completely-wrecked-and-im-using-an-external-dac","title":"I'm Not Getting Any Audio/My Audio Is Completely Wrecked and I'm Using an External Dac!","text":"

Several external DACs have issues with WASAPI exclusive mode 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.

"},{"location":"games/bemani/iidx/26_rootage/setup/","title":"beatmania IIDX 26 Rootage","text":"

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.

"},{"location":"games/bemani/iidx/26_rootage/setup/#getting-started","title":"Getting Started","text":"

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.

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.

"},{"location":"games/bemani/iidx/26_rootage/setup/#configuring-your-tools","title":"Configuring Your Tools","text":"

Now that you have your files ready, open up your .bat file in your desired text editor (we're using Notepad++) 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.

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.

"},{"location":"games/bemani/iidx/26_rootage/setup/#configuring-for-a-local-network","title":"Configuring for a Local Network","text":"

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++.

"},{"location":"games/bemani/iidx/26_rootage/setup/#configuring-for-an-online-network","title":"Configuring for an Online Network","text":"

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++.

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.

"},{"location":"games/bemani/iidx/26_rootage/setup/#final-steps-and-setting-up-the-game","title":"Final Steps and Setting up the Game","text":"

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!

Ignore this message, simply hit your Test keybind and continue onto this.

Hit the Test keybinding again to initialize the backup data, a message will pop up stating it's been initialized.

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.

Start by navigating up to CLOCK and entering that menu.

Simply hit save and exit and leave, the clock will be saved. Then, back in the service menu, go up to GAME OPTIONS

Once inside that menu, navigate your way up to DEFINITION TYPE and choose either SD or HD depending on your preferences.

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.

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.

You're all done! From the service menu select GAME MODE and the game should load ready to be played! Have fun!

Have any other errors?

Check out the Troubleshooting section and Error Code section to resolve any issues not seen in this guide to greater depth.

"},{"location":"games/bemani/iidx/26_rootage/troubleshooting/","title":"beatmania IIDX 26 Rootage","text":""},{"location":"games/bemani/iidx/26_rootage/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

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

"},{"location":"games/bemani/iidx/26_rootage/troubleshooting/#my-game-is-running-slowlagging","title":"My Game Is Running Slow/Lagging","text":"

Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.

"},{"location":"games/bemani/iidx/26_rootage/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

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.

"},{"location":"games/bemani/iidx/26_rootage/troubleshooting/#camera-device-error-message","title":"Camera Device Error Message","text":"

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 patch.

"},{"location":"games/bemani/iidx/26_rootage/troubleshooting/#occasional-game-stutters-during-play","title":"Occasional Game Stutters During Play","text":"

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.

"},{"location":"games/bemani/iidx/26_rootage/troubleshooting/#hd-and-hd","title":"HD and HD*","text":"

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.

"},{"location":"games/bemani/iidx/26_rootage/troubleshooting/#which-offset-is-which","title":"Which Offset Is Which?","text":"

If you're getting too many fasts, increase your offset (+). If you're getting too many slows, decrease your offset (-).

"},{"location":"games/bemani/iidx/26_rootage/troubleshooting/#a-note-about-sse-42","title":"A Note About SSE 4.2","text":"

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. But, in the event your processor does not have this, there is a patch available to bypass this.

"},{"location":"games/bemani/iidx/26_rootage/troubleshooting/#when-i-run-this-game-all-other-background-audio-is-gone-whats-going-on","title":"When I Run This Game All Other Background Audio Is Gone! What's Going On?","text":"

64-bit versions of IIDX are now utilizing a feature in Windows called WASAPI exclusive mode to obtain less audio latency than the former 32-bit versions of the games which used DirectSound. Unfortunately, this cannot be changed.

"},{"location":"games/bemani/iidx/26_rootage/troubleshooting/#im-not-getting-any-audiomy-audio-is-completely-wrecked-and-im-using-an-external-dac","title":"I'm Not Getting Any Audio/My Audio Is Completely Wrecked and I'm Using an External Dac!","text":"

Several external DACs have issues with WASAPI exclusive mode 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.

"},{"location":"games/bemani/iidx/27_heroicverse/lightning/","title":"beatmania IIDX 27 Heroic Verse","text":""},{"location":"games/bemani/iidx/27_heroicverse/lightning/#notes","title":"Notes","text":"

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 patch.

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.

"},{"location":"games/bemani/iidx/27_heroicverse/lightning/#lightning-specific-troubleshooting","title":"Lightning-specific Troubleshooting","text":"

Below are the two main issues that have arisen for users utilizing this guide and general startup practices.

"},{"location":"games/bemani/iidx/27_heroicverse/lightning/#hardware-specs","title":"Hardware Specs","text":"

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

"},{"location":"games/bemani/iidx/27_heroicverse/lightning/#enabling-lighting-mode-patch","title":"Enabling Lighting Mode Patch","text":"

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.

"},{"location":"games/bemani/iidx/27_heroicverse/lightning/#audio-related-crash","title":"Audio Related Crash","text":"

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

"},{"location":"games/bemani/iidx/27_heroicverse/setup/","title":"beatmania IIDX 27 Heroic Verse","text":"

Author Note:

Lightning mode specifics: they are found here

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.

"},{"location":"games/bemani/iidx/27_heroicverse/setup/#getting-started","title":"Getting Started","text":"

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.

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.

"},{"location":"games/bemani/iidx/27_heroicverse/setup/#configuring-your-tools","title":"Configuring Your Tools","text":"

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.

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.

"},{"location":"games/bemani/iidx/27_heroicverse/setup/#configuring-for-a-local-network","title":"Configuring for a Local Network","text":"

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.

"},{"location":"games/bemani/iidx/27_heroicverse/setup/#configuring-for-an-online-network","title":"Configuring for an Online Network","text":"

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.

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.

"},{"location":"games/bemani/iidx/27_heroicverse/setup/#final-steps-and-setting-up-the-game","title":"Final Steps and Setting up the Game","text":"

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! 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 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!

Ignore this message, simply hit your Test keybind and continue onto this.

Hit the Test keybinding to initialize the backup data, a message will pop up stating it's been initialized.

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.

Start by navigating up to CLOCK and entering that menu.

Simply hit save and exit and leave, the clock will be saved. Then, back in the service menu, go up to GAME OPTIONS

Once inside that menu, navigate your way up to DEFINITION TYPE and choose either SD or HD depending on your preferences.

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.

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.

You're all done! From the service menu select GAME MODE and the game should load ready to be played! Have fun!

Have any other errors?

Check out the Troubleshooting section and Error Code section to resolve any issues not seen in this guide to greater depth.

Lightning Mode specifics can be found: here

"},{"location":"games/bemani/iidx/27_heroicverse/troubleshooting/","title":"beatmania IIDX 27 Heroic Verse","text":"

Author Note:

For lightning specific issues, see lightning cab notes

"},{"location":"games/bemani/iidx/27_heroicverse/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

(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

"},{"location":"games/bemani/iidx/27_heroicverse/troubleshooting/#my-game-is-running-slowlagging","title":"My Game Is Running Slow/Lagging","text":"

Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.

"},{"location":"games/bemani/iidx/27_heroicverse/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

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.

"},{"location":"games/bemani/iidx/27_heroicverse/troubleshooting/#occasional-game-stutters-during-play","title":"Occasional Game Stutters During Play","text":"

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.

"},{"location":"games/bemani/iidx/27_heroicverse/troubleshooting/#which-offset-is-which","title":"Which Offset Is Which?","text":"

If you're getting too many fasts, increase your offset (+). If you're getting too many slows, decrease your offset (-).

"},{"location":"games/bemani/iidx/27_heroicverse/troubleshooting/#a-note-about-sse-42","title":"A Note About SSE 4.2","text":"

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. But, in the event your processor does not have this, there is a patch available to bypass this.

"},{"location":"games/bemani/iidx/27_heroicverse/troubleshooting/#when-i-run-this-game-all-other-background-audio-is-gone-whats-going-on","title":"When I Run This Game All Other Background Audio Is Gone! What's Going On?","text":"

64-bit versions of IIDX are now utilizing a feature in Windows called WASAPI exclusive mode to obtain less audio latency than the former 32-bit versions of the games which used DirectSound. Unfortunately, this cannot be changed.

"},{"location":"games/bemani/iidx/27_heroicverse/troubleshooting/#im-not-getting-any-audiomy-audio-is-completely-wrecked-and-im-using-an-external-dac","title":"I'm Not Getting Any Audio/My Audio Is Completely Wrecked and I'm Using an External Dac!","text":"

Several external DACs have issues with WASAPI exclusive mode 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.

"},{"location":"games/bemani/iidx/30_resident/extras/","title":"beatmania IIDX 30 RESIDENT","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/iidx/30_resident/extras/#standard-lightning-modes","title":"Standard & Lightning modes","text":"

Lightning mode requires a 120hz capable monitor.

To make use of the Lightning Mode, which unlocks the subscreen and 120FPS, we need to go to the contents\\prop folder and edit the ea3-config.xml file.

We're interested in these lines:

    <soft>\n        <model __type=\"str\">LDJ</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">A</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2023090500</ext>\n    </soft>\n

This is the line that determines if the game will run in Standard (60 FPS) or Lightning (120 FPS) mode.

<spec __type=\"str\">A</spec>\n
  • A for Standard (LDJ-003, LDJ, 60hz)
  • D for Lightning (LDJ-010, TDJ, 120hz)
"},{"location":"games/bemani/iidx/30_resident/extras/#changing-the-games-language","title":"Changing the game's language","text":"

This is done in-game before card-in by pressing your EFFECT key.

"},{"location":"games/bemani/iidx/30_resident/extras/#more-about-ea3-configxml","title":"More about ea3-config.xml","text":"

The ea3-config.xml file is located inside the prop folder.

Below is an explanation on what different sections of this file do.

The following lines change the PCBID and HARDID that your system reports to your e-amusement server. There is no need to manually change this as spice2x will do it for us.

<pcbid __type=\"str\">00010203040506070809</pcbid>\n<hardid __type=\"str\">00010203040506070809</hardid>\n

The following line determines what version of the game you are running. You should never change this. It should always say LDJ.

<model __type=\"str\">LDJ</model>\n

The following line determines the game's region. You should never change this. As you can change the language in-game.

<dest __type=\"str\">J</dest>\n

You should never change this. It should always say A for Resident.

<rev __type=\"str\">A</rev>\n

The following line determines your datecode. Always keep it up to date with your game's current version.

<ext __type=\"str\">2024052100</ext>\n

The following line determine what remote service URL spice2x is supposed to connect to. There is no need to manually change this as spice2x will do it for us.

<services __type=\"str\">http://localhost:8083</services>\n
"},{"location":"games/bemani/iidx/30_resident/setup/","title":"beatmania IIDX 30 RESIDENT","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/iidx/30_resident/setup/#about-data","title":"About data","text":"

Standard (LDJ) / Lightning (TDJ)

Please keep the following in mind as you're going through this guide.

IIDX's codename is LDJ. For IIDX 30 Resident it typically is LDJ-003.

Two versions of the game exist:

  • TDJ expects a 120hz compatible monitor for its main screen, and a second 60hz touchscreen compatible monitor called a subscreen. The second monitor isn't mandatory, we can get around that using spice2x.
  • LDJ expects 60hz monitor for its main screen, and no subscreen.

We'll be using the terms TDJ for Lightning, and LDJ for Standard throughout the guide.

"},{"location":"games/bemani/iidx/30_resident/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure with a few folders only, as follows.

If your data doesn't look like this

If you're missing the modules folder and instead have bunch of .dll files next to your folders:

  • Create a modules folder.
  • Move all .dll files inside of it so you end up with a structure as shown above.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

If you don't need to update your data, you can skip over to the Installing Spice2x section.

"},{"location":"games/bemani/iidx/30_resident/setup/#updating-data","title":"Updating data","text":"Please make sure you're using the right update for your current data.

Patches re-uploaded by the community tend to be named LDJ-DATECODE-to-DATECODE.

For example LDJ-2022120800-to-2023090500.

  • 2022120800 being your current data's version.
  • 2023090500 being the version you would arrive at.
  • Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.
  • Open prop\\ea3-config.xml in a text editor and find the following lines near the top.
    <soft>\n        <model __type=\"str\">LDJ</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">A</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2023090500</ext>\n    </soft>\n

On the line with <ext __type=\"str\"> the datecode needs to match your new version.

  • If that's already the case then great! Don't touch anything.
  • If it instead corresponds to our pre-patch datecode, replace it with the new one.

Now save the file.

"},{"location":"games/bemani/iidx/30_resident/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice64.exe and spicecfg.exe files from the archive to your game's directory.

"},{"location":"games/bemani/iidx/30_resident/setup/#configuring-spice2x","title":"Configuring Spice2x","text":"

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/iidx/30_resident/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • P1 Game buttons: 1 to 7, Start, EFFECT, VEFX
  • P1 Keypad: Keypad Insert Card

Only if you're using LDJ:

  • P1 Keypad: 1 to 9

Only if you're playing using a keyboard:

  • Turntable: TT+, TT- and optionally TT+/- which alternates between TT+ and TT- on each press.
"},{"location":"games/bemani/iidx/30_resident/setup/#analogs-controllercab-only","title":"Analogs (controller/cab only)","text":"

With a controller rather than binding buttons to TT+ and TT-, you need to:

  • For Turntable P1, click Bind.
  • In Device, pick your controller.
  • In Control, pick whichever one corresponds to the turntable.
  • Turn your turntable ensuring that the Preview turns along with it.
  • Click Close, leaving the rest of the settings alone.
"},{"location":"games/bemani/iidx/30_resident/setup/#overlay","title":"Overlay","text":"

Modifying buttons in this section is not required but you are free to change what you want.

Click on Bind then press the key you want associated with the action.

"},{"location":"games/bemani/iidx/30_resident/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through spice2x.

If it does, here's how you may link different actions to your lights:

  • Click Bind.
  • In Device, pick your controller.
  • In Light Control, select the corresponding light.
  • Click Close.
  • Repeat for your other lights.
"},{"location":"games/bemani/iidx/30_resident/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section.

"},{"location":"games/bemani/iidx/30_resident/setup/#patches","title":"Patches","text":"

As of writing, web patching is recommended for IIDX 30 Resident as opposed to spice2x patching.

Spice2x patching is fairly new and the game's latest releases are prioritized for conversion.

For now use Mon's BemaniPatcher, more info can be found in the web patching page.

As a general rule of thumb, if you're not sure what a patch does or you're not absolutely certain you need it, leave it alone, regardless of recommendations below.

General patches Patch Recommendation Description Standard/Menu Timer Freeze Either Freezes the timer in all non-premium environments. Premium Free Timer Freeze Either Freezes the timer in Premium Free mode. Cursor Lock Either In song select, always returns to the previously selected song. CS-style Song Start Delay Either At the start of a song, holding Start will pause it until you release it. Increase Game Volume Either Ignores in-game settings and keeps the volume at a maximum, helpful for TDJ which tends to be quiet. Hide all bottom text Either Hides text at the bottom of the screen such as Credits or Paseli."},{"location":"games/bemani/iidx/30_resident/setup/#api","title":"API","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/iidx/30_resident/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the question mark at the very left.

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Game Options IIDX Disable Cameras -iidxdisablecams ON Network EA Service URL -url Covered in Connecting to a network

Required For TDJ

Category Option Parameter Setting Game Options IIDX TDJ Mode -iidxtdj ON

If you only have a single 120hz monitor, and not another 60hz touchscreen:

Category Option Parameter Setting Game Options IIDX TDJ Mode -graphics-force-single-adapter ON

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/iidx/30_resident/setup/#advanced-development","title":"Advanced & Development","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/iidx/30_resident/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/iidx/30_resident/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/bemani/iidx/30_resident/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/bemani/iidx/30_resident/setup/#audio","title":"Audio","text":"
  • Open spicecfg.exe.
  • At the very top, click on Shortcuts then Audio Playback Devices.
  • In the popup window, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick the 24 bit, 44100 Hz (CD Quality) option and click Apply then OK.
"},{"location":"games/bemani/iidx/30_resident/setup/#standard-lightning-language-settings","title":"Standard / Lightning / Language settings","text":"

Read through the Extra Information page and edit your prop\\ea3-config.xml file if necessary.

"},{"location":"games/bemani/iidx/30_resident/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

"},{"location":"games/bemani/iidx/30_resident/setup/#backup-data","title":"BACKUP DATA","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run spice64.exe, press Yes when it asks for elevated privileges.

If it's your first time running the game, you'll immediately be greeted with this screen.

"},{"location":"games/bemani/iidx/30_resident/setup/#clock-error","title":"CLOCK ERROR","text":"

Press your Test key to initialize the backup data, a message will pop up stating it's been initialized.

Next, you'll get another error.

Let the game run for a bit until the monitor check is complete and you should be taken to the service menu.

Instructions on how to navigate the menu are shown at the bottom of the screen.

  • Press 1 and 2 to go up and down.
  • Press 6 to select/execute.

Start by going up to CLOCK.

Here, simply select SAVE AND EXIT and the clock will be set.

You'll be back in the service menu.

"},{"location":"games/bemani/iidx/30_resident/setup/#network-options","title":"NETWORK OPTIONS","text":"

Go to NETWORK OPTIONS then SHOP NAME SETTING.

We will need to set a shop name.

  • Name your shop to whatever you'd like. Instructions on how to navigate are at the bottom of the screen.
  • Go to EXIT then SAVE AND EXIT.

Select GAME MODE.

You're all done! The game should load up properly now.

"},{"location":"games/bemani/iidx/30_resident/setup/#carding-in","title":"Carding in","text":"

Before carding in, you have the option of changing the game's language by pressing your EFFECT key.

For LDJ (Standard)

LDJ should accept keypad number binds:

  • Press your Keypad Insert Card button.
  • Enter your code using your keypad binds.
For TDJ (Lightning)

TDJ will ignore keypad number binds, you need to:

  • Press your Keypad Insert Card button.
  • Press your Toggle Sub Screen overlay button (PgUp by default) to bring up the sub screen.
  • Enter your code by clicking on the subscreen's keypad.
  • If your code is accepted, you may now close the overlay.
"},{"location":"games/bemani/iidx/30_resident/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

For any more game-specific information, check out Extra Information.

"},{"location":"games/bemani/iidx/30_resident/troubleshooting/","title":"beatmania IIDX 30 RESIDENT","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/iidx/30_resident/troubleshooting/#im-having-performance-issues","title":"I'm having performance issues!","text":"

If you're having performance issues of some kind, spice2x's PC optimization guide is worth looking at.

"},{"location":"games/bemani/iidx/30_resident/troubleshooting/#my-game-is-running-slowfast-after-finishing-a-song-the-game-gets-stuck-loading","title":"My game is running slow/fast, After finishing a song the game gets stuck loading!","text":"

The most common reason for this is the game is running over its required refresh rate. To solve this, make sure v-sync isn't disabled in your graphics card's settings.

For NVIDIA users, enable NVIDIA profile optimization (-nvprofile) in the Options tab.

"},{"location":"games/bemani/iidx/30_resident/troubleshooting/#how-do-i-set-my-offset","title":"How do I set my offset?","text":"

Play through a chart you're comfortable with.

If you're getting too many Fast, increase your offset (+). If you're getting too many Slow, decrease your offset (-).

"},{"location":"games/bemani/iidx/30_resident/troubleshooting/#my-inputs-arent-working-i-cant-get-past-error-messages","title":"My inputs aren't working / I can't get past error messages!","text":"

If none of your inputs are working, try updating spice2x, you can also try using the beta versions if the stable releases don't work for you.

"},{"location":"games/bemani/iidx/30_resident/troubleshooting/#my-game-audio-is-super-quiet","title":"My game audio is super quiet!","text":"

When using TDJ mode the audio is very quiet by default. To mitigate this, you can use the Increase Game Volume patch.

"},{"location":"games/bemani/iidx/30_resident/troubleshooting/#when-i-run-the-game-all-other-audio-is-gone","title":"When I run the game all other audio is gone!","text":"

IIDX uses WASAPI exclusive mode for audio to get better audio latency. Unlike former versions of the games which used DirectSound.

You can use the Shared Mode WASAPI patch to deal with some hardware issues, it can also be used to hear audio outside the game at the cost of audio latency.

"},{"location":"games/bemani/iidx/30_resident/troubleshooting/#im-not-getting-any-audio-or-my-audio-is-completely-wrecked-and-im-using-an-external-dac","title":"I'm not getting any audio, or my audio is completely wrecked and I'm using an External Dac!","text":"

Many setups have found some difficulty with audio due to various equipment being used. Consider using the Shared Mode WASAPI patch.

"},{"location":"games/bemani/iidx/31_epolis/extras/","title":"beatmania IIDX 31 EPOLIS","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/iidx/31_epolis/extras/#standard-lightning-modes","title":"Standard & Lightning modes","text":"

Lightning mode requires a 120hz capable monitor.

To make use of the Lightning Mode, which unlocks the subscreen and 120FPS, we need to go to the contents\\prop folder and edit the ea3-config.xml file.

We're interested in these lines:

    <soft>\n        <model __type=\"str\">LDJ</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">E</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024050700</ext>\n    </soft>\n

This is the line that determines if the game will run in Standard (60 FPS) or Lightning (120 FPS) mode.

<spec __type=\"str\">E</spec>\n
  • E for Standard (LDJ-012, LDJ, 60hz)
  • D for Lightning (LDJ-010, TDJ, 120hz)
"},{"location":"games/bemani/iidx/31_epolis/extras/#changing-the-games-language","title":"Changing the game's language","text":"

This is done in-game before card-in by pressing your EFFECT key.

"},{"location":"games/bemani/iidx/31_epolis/extras/#more-about-ea3-configxml","title":"More about ea3-config.xml","text":"

The ea3-config.xml file is located inside the prop folder.

Below is an explanation on what different sections of this file do.

The following lines change the PCBID and HARDID that your system reports to your e-amusement server. There is no need to manually change this as spice2x will do it for us.

<pcbid __type=\"str\">00010203040506070809</pcbid>\n<hardid __type=\"str\">00010203040506070809</hardid>\n

The following line determines what version of the game you are running. You should never change this. It should always say LDJ.

<model __type=\"str\">LDJ</model>\n

The following line determines the game's region. You should never change this. As you can change the language in-game.

<dest __type=\"str\">J</dest>\n

You should never change this. It should always say A for Epolis.

<rev __type=\"str\">A</rev>\n

The following line determines your datecode. Always keep it up to date with your game's current version.

<ext __type=\"str\">2024052100</ext>\n

The following line determine what remote service URL spice2x is supposed to connect to. There is no need to manually change this as spice2x will do it for us.

<services __type=\"str\">http://localhost:8083</services>\n
"},{"location":"games/bemani/iidx/31_epolis/setup/","title":"beatmania IIDX 31 EPOLIS","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

Reasonably modern CPU required

beatmania IIDX 31 and above require an AVX2 capable CPU.

If your CPU is too old, the game will crash with an EXCEPTION_ILLEGAL_INSTRUCTION error.

A known workaround is renaming/deleting the movies folder to prevent the game from loading them altogether.

"},{"location":"games/bemani/iidx/31_epolis/setup/#about-data","title":"About data","text":"

The full game should be around 100gb while updates are only around 2-5gb in size.

Standard (LDJ) / Lightning (TDJ)

Please keep the following in mind as you're going through this guide.

IIDX's codename is LDJ. For IIDX 31 Epolis this would be either:

  • LDJ-010 (TDJ, Lightning cab, 120 FPS)
  • LDJ-012 (LDJ, Standard cab, 60 FPS)

The main difference between 010 and 012 is the game's main .dll file, bm2dx.dll.

This changes which features the game offers, and which conditions the game expects to run under.

  • TDJ expects a 120hz compatible monitor for its main screen, and a second 60hz touchscreen compatible monitor called a subscreen. The second monitor isn't mandatory, we can get around that using spice2x.
  • LDJ expects 60hz monitor for its main screen, and no subscreen.

We'll be using the terms TDJ for Lightning, and LDJ for Standard throughout the guide.

If you're coming from IIDX 30 Resident

You'll want to update your data from LDJ-003 to LDJ-010 or LDJ-012 FIRST then follow this guide as normal.

"},{"location":"games/bemani/iidx/31_epolis/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure with a few folders only, as follows.

If your data doesn't look like this

If you're missing the modules folder and instead have bunch of .dll files next to your folders:

  • Create a modules folder.
  • Move all .dll files inside of it so you end up with a structure as shown above.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

If you don't need to update your data, you can skip over to the Installing Spice2x section.

"},{"location":"games/bemani/iidx/31_epolis/setup/#updating-data","title":"Updating data","text":"Please make sure you're using the right update for your current data.

As we've seen in the About data section, the main difference between LDJ and TDJ is the bm2dx.dll file. When updating from a previous version to the next, our current .dll will be overwritten.

Knowing that, patches re-uploaded by the community tend to be named LDJ-DATECODE-to-LDJ-010/012-DATECODE. Note: If updating from IIDX 30 Resident, it will be LDJ-003-DATECODE-to-LDJ-010/012-DATECODE.

For example LDJ-2024032500-to-LDJ-010-2024050700.

  • 2024032500 being your current data's version, no matter if it's using a TDJ or LDJ .dll file.
  • 2024050700 being the version you would arrive at.
  • 010 meaning you would end up with a TDJ (Lightning Cab) bm2dx.dll file.
  • Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.
  • Open prop\\ea3-config.xml in a text editor and find the following lines near the top.
    <soft>\n        <model __type=\"str\">LDJ</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">E</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024050700</ext>\n    </soft>\n

On the line with <spec __type=\"str\"> the letter needs to match your data type:

  • E for Standard (LDJ-012, LDJ, 60hz)
  • D for Lightning (LDJ-010, TDJ, 120hz)

Replace the letter accordingly if necessary.

On the line with <ext __type=\"str\"> the datecode needs to match your new version.

  • If that's already the case then great! Don't touch anything.
  • If it instead corresponds to our pre-patch datecode, replace it with the new one.

Now save the file.

"},{"location":"games/bemani/iidx/31_epolis/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice64.exe and spicecfg.exe files from the archive to your game's directory.

"},{"location":"games/bemani/iidx/31_epolis/setup/#configuring-spice2x","title":"Configuring Spice2x","text":"

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/iidx/31_epolis/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • P1 Game buttons: 1 to 7, Start, EFFECT, VEFX
  • P1 Keypad: Keypad Insert Card

Only if you're using LDJ:

  • P1 Keypad: 1 to 9

Only if you're playing using a keyboard:

  • Turntable: TT+, TT- and optionally TT+/- which alternates between TT+ and TT- on each press.
"},{"location":"games/bemani/iidx/31_epolis/setup/#analogs-controllercab-only","title":"Analogs (controller/cab only)","text":"

With a controller rather than binding buttons to TT+ and TT-, you need to:

  • For Turntable P1, click Bind.
  • In Device, pick your controller.
  • In Control, pick whichever one corresponds to the turntable.
  • Turn your turntable ensuring that the Preview turns along with it.
  • Click Close, leaving the rest of the settings alone.
"},{"location":"games/bemani/iidx/31_epolis/setup/#overlay","title":"Overlay","text":"

Modifying buttons in this section is not required but you are free to change what you want.

Click on Bind then press the key you want associated with the action.

"},{"location":"games/bemani/iidx/31_epolis/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through spice2x.

If it does, here's how you may link different actions to your lights:

  • Click Bind.
  • In Device, pick your controller.
  • In Light Control, select the corresponding light.
  • Click Close.
  • Repeat for your other lights.
"},{"location":"games/bemani/iidx/31_epolis/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section.

"},{"location":"games/bemani/iidx/31_epolis/setup/#patches","title":"Patches","text":"

Go through the Spice2x Patching page to import patches.

Ever since EPOLIS final (2024-08-26), patches have a description built-in to them.

To view it, hover-over the (?) or (!) to the left of each patch's name.

To prevent issues, avoid patching things you don't need or understand.

"},{"location":"games/bemani/iidx/31_epolis/setup/#api","title":"API","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/iidx/31_epolis/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the question mark at the very left.

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Game Options IIDX Disable Cameras -iidxdisablecams ON Network EA Service URL -url Covered in Connecting to a network

Required For TDJ

Category Option Parameter Setting Game Options IIDX TDJ Mode -iidxtdj ON

If you only have a single 120hz monitor, and not another 60hz touchscreen:

Category Option Parameter Setting Graphics (common) Only Use One Monitor -graphics-force-single-adapter ON

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/iidx/31_epolis/setup/#advanced-development","title":"Advanced & Development","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/iidx/31_epolis/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/iidx/31_epolis/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/bemani/iidx/31_epolis/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/bemani/iidx/31_epolis/setup/#audio","title":"Audio","text":"
  • Open spicecfg.exe.
  • At the very top, click on Shortcuts then Audio Playback Devices.
  • In the popup window, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick the 16 (or 24) bit, 44100 Hz option, click Apply then OK.
"},{"location":"games/bemani/iidx/31_epolis/setup/#standard-lightning-language-settings","title":"Standard / Lightning / Language settings","text":"

Read through the Extra Information page and edit your prop\\ea3-config.xml file if necessary.

"},{"location":"games/bemani/iidx/31_epolis/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

"},{"location":"games/bemani/iidx/31_epolis/setup/#backup-data","title":"BACKUP DATA","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run spice64.exe, press Yes when it asks for elevated privileges.

If it's your first time running the game, you'll immediately be greeted with this screen.

"},{"location":"games/bemani/iidx/31_epolis/setup/#clock-error","title":"CLOCK ERROR","text":"

Press your Test key to initialize the backup data, a message will pop up stating it's been initialized.

Next, you'll get another error.

Let the game run for a bit until the monitor check is complete and you should be taken to the service menu.

Instructions on how to navigate the menu are shown at the bottom of the screen.

  • Press 1 and 2 to go up and down.
  • Press 6 to select/execute.

Start by going up to CLOCK.

Here, simply select SAVE AND EXIT and the clock will be set.

You'll be back in the service menu.

"},{"location":"games/bemani/iidx/31_epolis/setup/#network-options","title":"NETWORK OPTIONS","text":"

Go to NETWORK OPTIONS then SHOP NAME SETTING.

We will need to set a shop name.

  • Name your shop to whatever you'd like. Instructions on how to navigate are at the bottom of the screen.
  • Go to EXIT then SAVE AND EXIT.

Select GAME MODE.

You're all done! The game should load up properly now.

"},{"location":"games/bemani/iidx/31_epolis/setup/#carding-in","title":"Carding in","text":"

Before carding in, you have the option of changing the game's language by pressing your EFFECT key.

For LDJ (Standard)

LDJ should accept keypad number binds:

  • Press your Keypad Insert Card button.
  • Enter your code using your keypad binds.
For TDJ (Lightning)

TDJ will ignore keypad number binds, you need to:

  • Press your Keypad Insert Card button.
  • Press your Toggle Sub Screen overlay button (PgUp by default) to bring up the sub screen.
  • Enter your code by clicking on the subscreen's keypad.
  • If your code is accepted, you may now close the overlay.
"},{"location":"games/bemani/iidx/31_epolis/setup/#optional-installing-omnimix","title":"(optional) Installing Omnimix","text":"

Check out the Data Mods and Omnimix guide.

"},{"location":"games/bemani/iidx/31_epolis/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

For any more game-specific information, check out Extra Information.

"},{"location":"games/bemani/iidx/31_epolis/troubleshooting/","title":"beatmania IIDX 31 EPOLIS","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/iidx/31_epolis/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch!","text":"

This could be due to many things.

Start by checking the audio section in the setup guide.

beatmania IIDX 31 and above require an AVX2 capable CPU. If your CPU is too old, the game will crash with an EXCEPTION_ILLEGAL_INSTRUCTION error. A known workaround is renaming/deleting the movies folder to prevent the game from loading them altogether.

"},{"location":"games/bemani/iidx/31_epolis/troubleshooting/#my-game-is-running-too-slowfast-game-gets-stuck-monitor-error-at-boot-error-5-1503-0043","title":"My game is running too slow/fast / Game gets stuck / Monitor error at boot / Error 5-1503-0043","text":"

Potential causes:

  1. The game could be running over/under its required refresh rate (60 for LDJ, 120 for TDJ) To solve this, make sure v-sync isn't disabled in your graphics card's settings. For NVIDIA users, enable NVIDIA profile optimization (-nvprofile) in the Options tab.
  2. It could be that your computer's performance isn't good enough to keep a steady framerate.
"},{"location":"games/bemani/iidx/31_epolis/troubleshooting/#im-having-performance-issues-my-fps-fluctates","title":"I'm having performance issues / my FPS fluctates!","text":"

If you're having performance issues of some kind, spice2x's PC optimization guide is worth looking at. If none of that works, your PC probably isn't good enough to run the game, sorry.

"},{"location":"games/bemani/iidx/31_epolis/troubleshooting/#unable-to-login-eamuse-error-network-error","title":"Unable to login / Eamuse error / Network error","text":"

Get the proper Asphyxia plugin from our Discord server in the #iidx channel > Resources post. Make sure you didn't enable -smartea in spicecfg's options.

"},{"location":"games/bemani/iidx/31_epolis/troubleshooting/#how-do-i-set-my-offset","title":"How do I set my offset?","text":"

Play through a chart you're comfortable with.

If you're getting too many Fast, increase your offset (+). If you're getting too many Slow, decrease your offset (-).

"},{"location":"games/bemani/iidx/31_epolis/troubleshooting/#my-inputs-arent-working-i-cant-get-past-error-messages","title":"My inputs aren't working / I can't get past error messages!","text":"

If none of your inputs are working, try updating spice2x, you can also try using the beta versions if the stable releases don't work for you.

"},{"location":"games/bemani/iidx/31_epolis/troubleshooting/#my-game-audio-is-super-quiet","title":"My game audio is super quiet!","text":"

When using TDJ mode the audio is very quiet by default. To mitigate this, you can use the Increase Game Volume patch.

"},{"location":"games/bemani/iidx/31_epolis/troubleshooting/#when-i-run-the-game-all-other-audio-is-gone","title":"When I run the game all other audio is gone!","text":"

IIDX uses WASAPI exclusive mode for audio to get better audio latency. Unlike former versions of the games which used DirectSound.

You can use the Shared Mode WASAPI patch to hear other apps while the game is running, at the cost of some audio latency.

"},{"location":"games/bemani/iidx/31_epolis/troubleshooting/#im-not-getting-any-audio-or-my-audio-is-completely-wrecked-and-im-using-an-external-dac","title":"I'm not getting any audio, or my audio is completely wrecked and I'm using an External Dac!","text":"

Many setups have found some difficulty with audio due to various equipment being used. Consider using the Shared Mode WASAPI patch.

"},{"location":"games/bemani/iidx/31_epolis/troubleshooting/#my-audio-is-sloweddistorted-and-im-using-the-shared-mode-wasapi-patch","title":"My audio is slowed/distorted and I'm using the Shared Mode WASAPI patch.","text":"

When using this patch, you must set your audio device's sample rate to 48000 Hz. See audio for more details.

"},{"location":"games/bemani/iidx/32_pinkycrush/extras/","title":"beatmania IIDX 32 Pinky Crush","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/iidx/32_pinkycrush/extras/#standard-lightning-modes","title":"Standard & Lightning modes","text":"

Lightning mode requires a 120hz capable monitor.

To make use of the Lightning Mode, which unlocks the subscreen and 120FPS, we need to go to the contents\\prop folder and edit the ea3-config.xml file.

We're interested in these lines:

    <soft>\n        <model __type=\"str\">LDJ</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">E</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024100900</ext>\n    </soft>\n

This is the line that determines if the game will run in Standard (60 FPS) or Lightning (120 FPS) mode.

<spec __type=\"str\">E</spec>\n
  • E for Standard (LDJ-012, LDJ, 60hz)
  • D for Lightning (LDJ-010, TDJ, 120hz)
"},{"location":"games/bemani/iidx/32_pinkycrush/extras/#changing-the-games-language","title":"Changing the game's language","text":"

This is done in-game before card-in by pressing your EFFECT key.

"},{"location":"games/bemani/iidx/32_pinkycrush/extras/#more-about-ea3-configxml","title":"More about ea3-config.xml","text":"

The ea3-config.xml file is located inside the prop folder.

Below is an explanation on what different sections of this file do.

The following lines change the PCBID and HARDID that your system reports to your e-amusement server. There is no need to manually change this as spice2x will do it for us.

<pcbid __type=\"str\">00010203040506070809</pcbid>\n<hardid __type=\"str\">00010203040506070809</hardid>\n

The following line determines what version of the game you are running. You should never change this. It should always say LDJ.

<model __type=\"str\">LDJ</model>\n

The following line determines the game's region. You should never change this. As you can change the language in-game.

<dest __type=\"str\">J</dest>\n

You should never change this. It should always say A for Pinky Crush.

<rev __type=\"str\">A</rev>\n

The following line determines your datecode. Always keep it up to date with your game's current version.

<ext __type=\"str\">2024100900</ext>\n

The following line determine what remote service URL spice2x is supposed to connect to. There is no need to manually change this as spice2x will do it for us.

<services __type=\"str\">http://localhost:8083</services>\n
"},{"location":"games/bemani/iidx/32_pinkycrush/setup/","title":"beatmania IIDX 32 Pinky Crush","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

Reasonably modern CPU required

beatmania IIDX 31 and above require an AVX2 capable CPU.

If your CPU is too old, the game will crash with an EXCEPTION_ILLEGAL_INSTRUCTION error.

A known workaround is renaming/deleting the movies folder to prevent the game from loading them altogether.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#about-data","title":"About data","text":"

The full game should be around 100gb while updates are only around 2-5gb in size.

Standard (LDJ) / Lightning (TDJ)

Please keep the following in mind as you're going through this guide.

IIDX's codename is LDJ. For IIDX 32 Pinky Crush this would be either:

  • LDJ-010 (TDJ, Lightning cab, 120 FPS)
  • LDJ-012 (LDJ, Standard cab, 60 FPS)

The main difference between 010 and 012 is the game's main .dll file, bm2dx.dll.

This changes which features the game offers, and which conditions the game expects to run under.

  • TDJ expects a 120hz compatible monitor for its main screen, and a second 60hz touchscreen compatible monitor called a subscreen. The second monitor isn't mandatory, we can get around that using spice2x.
  • LDJ expects 60hz monitor for its main screen, and no subscreen.

We'll be using the terms TDJ for Lightning, and LDJ for Standard throughout the guide.

If you're coming from IIDX 30 Resident

You'll want to update your data from LDJ-003 to LDJ-010 or LDJ-012 FIRST then follow this guide as normal.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure with a few folders only, as follows.

If your data doesn't look like this

If you're missing the modules folder and instead have bunch of .dll files next to your folders:

  • Create a modules folder.
  • Move all .dll files inside of it so you end up with a structure as shown above.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

If you don't need to update your data, you can skip over to the Installing Spice2x section.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#updating-data","title":"Updating data","text":"Please make sure you're using the right update for your current data.

As we've seen in the About data section, the main difference between LDJ and TDJ is the bm2dx.dll file. When updating from a previous version to the next, our current .dll will be overwritten.

Knowing that, patches re-uploaded by the community tend to be named LDJ-DATECODE-to-LDJ-010/012-DATECODE. Note: If updating from IIDX 30 Resident, it will be LDJ-003-DATECODE-to-LDJ-010/012-DATECODE.

For example LDJ-2024082600-to-LDJ-010-2024100900.

  • 2024082600 being your current data's version, no matter if it's using a TDJ or LDJ .dll file.
  • 2024100900 being the version you would arrive at.
  • 010 meaning you would end up with a TDJ (Lightning Cab) bm2dx.dll file.
  • Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.
  • Open prop\\ea3-config.xml in a text editor and find the following lines near the top.
    <soft>\n        <model __type=\"str\">LDJ</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">E</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024100900</ext>\n    </soft>\n

On the line with <spec __type=\"str\"> the letter needs to match your data type:

  • E for Standard (LDJ-012, LDJ, 60hz)
  • D for Lightning (LDJ-010, TDJ, 120hz)

Replace the letter accordingly if necessary.

On the line with <ext __type=\"str\"> the datecode needs to match your new version.

  • If that's already the case then great! Don't touch anything.
  • If it instead corresponds to our pre-patch datecode, replace it with the new one.

Now save the file.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice64.exe and spicecfg.exe files from the archive to your game's directory.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#configuring-spice2x","title":"Configuring Spice2x","text":"

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • P1 Game buttons: 1 to 7, Start, EFFECT, VEFX
  • P1 Keypad: Keypad Insert Card

Only if you're using LDJ:

  • P1 Keypad: 1 to 9

Only if you're playing using a keyboard:

  • Turntable: TT+, TT- and optionally TT+/- which alternates between TT+ and TT- on each press.
"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#analogs-controllercab-only","title":"Analogs (controller/cab only)","text":"

With a controller rather than binding buttons to TT+ and TT-, you need to:

  • For Turntable P1, click Bind.
  • In Device, pick your controller.
  • In Control, pick whichever one corresponds to the turntable.
  • Turn your turntable ensuring that the Preview turns along with it.
  • Click Close, leaving the rest of the settings alone.
"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#overlay","title":"Overlay","text":"

Modifying buttons in this section is not required but you are free to change what you want.

Click on Bind then press the key you want associated with the action.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through spice2x.

If it does, here's how you may link different actions to your lights:

  • Click Bind.
  • In Device, pick your controller.
  • In Light Control, select the corresponding light.
  • Click Close.
  • Repeat for your other lights.
"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#patches","title":"Patches","text":"

Go through the Spice2x Patching page to import patches.

Ever since EPOLIS final (2024-08-26), patches have a description built-in to them.

To view it, hover-over the (?) or (!) to the left of each patch's name.

To prevent issues, avoid patching things you don't need or understand.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#api","title":"API","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the question mark at the very left.

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Game Options IIDX Disable Cameras -iidxdisablecams ON Network EA Service URL -url Covered in Connecting to a network

Required For TDJ

Category Option Parameter Setting Game Options IIDX TDJ Mode -iidxtdj ON

If you only have a single 120hz monitor, and not another 60hz touchscreen:

Category Option Parameter Setting Graphics (common) Only Use One Monitor -graphics-force-single-adapter ON

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#advanced-development","title":"Advanced & Development","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#audio","title":"Audio","text":"
  • Open spicecfg.exe.
  • At the very top, click on Shortcuts then Audio Playback Devices.
  • In the popup window, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick the 16 (or 24) bit, 44100 Hz option, click Apply then OK.
"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#standard-lightning-language-settings","title":"Standard / Lightning / Language settings","text":"

Read through the Extra Information page and edit your prop\\ea3-config.xml file if necessary.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#backup-data","title":"BACKUP DATA","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run spice64.exe, press Yes when it asks for elevated privileges.

If it's your first time running the game, you'll immediately be greeted with this screen.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#clock-error","title":"CLOCK ERROR","text":"

Press your Test key to initialize the backup data, a message will pop up stating it's been initialized.

Next, you'll get another error.

Let the game run for a bit until the monitor check is complete and you should be taken to the service menu.

Instructions on how to navigate the menu are shown at the bottom of the screen.

  • Press 1 and 2 to go up and down.
  • Press 6 to select/execute.

Start by going up to CLOCK.

Here, simply select SAVE AND EXIT and the clock will be set.

You'll be back in the service menu.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#network-options","title":"NETWORK OPTIONS","text":"

Go to NETWORK OPTIONS then SHOP NAME SETTING.

We will need to set a shop name.

  • Name your shop to whatever you'd like. Instructions on how to navigate are at the bottom of the screen.
  • Go to EXIT then SAVE AND EXIT.

Select GAME MODE.

You're all done! The game should load up properly now.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#carding-in","title":"Carding in","text":"

Before carding in, you have the option of changing the game's language by pressing your EFFECT key.

For LDJ (Standard)

LDJ should accept keypad number binds:

  • Press your Keypad Insert Card button.
  • Enter your code using your keypad binds.
For TDJ (Lightning)

TDJ will ignore keypad number binds, you need to:

  • Press your Keypad Insert Card button.
  • Press your Toggle Sub Screen overlay button (PgUp by default) to bring up the sub screen.
  • Enter your code by clicking on the subscreen's keypad.
  • If your code is accepted, you may now close the overlay.
"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

For any more game-specific information, check out Extra Information.

"},{"location":"games/bemani/iidx/32_pinkycrush/troubleshooting/","title":"beatmania IIDX 32 Pinky Crush","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/iidx/32_pinkycrush/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch!","text":"

This could be due to many things.

Start by checking the audio section in the setup guide.

beatmania IIDX 31 and above require an AVX2 capable CPU. If your CPU is too old, the game will crash with an EXCEPTION_ILLEGAL_INSTRUCTION error. A known workaround is renaming/deleting the movies folder to prevent the game from loading them altogether.

"},{"location":"games/bemani/iidx/32_pinkycrush/troubleshooting/#my-game-is-running-too-slowfast-game-gets-stuck-monitor-error-at-boot-error-5-1503-0043","title":"My game is running too slow/fast / Game gets stuck / Monitor error at boot / Error 5-1503-0043","text":"

Potential causes:

  1. The game could be running over/under its required refresh rate (60 for LDJ, 120 for TDJ) To solve this, make sure v-sync isn't disabled in your graphics card's settings. For NVIDIA users, enable NVIDIA profile optimization (-nvprofile) in the Options tab.
  2. It could be that your computer's performance isn't good enough to keep a steady framerate.
"},{"location":"games/bemani/iidx/32_pinkycrush/troubleshooting/#im-having-performance-issues-my-fps-fluctates","title":"I'm having performance issues / my FPS fluctates!","text":"

If you're having performance issues of some kind, spice2x's PC optimization guide is worth looking at. If none of that works, your PC probably isn't good enough to run the game, sorry.

"},{"location":"games/bemani/iidx/32_pinkycrush/troubleshooting/#unable-to-login-eamuse-error-network-error","title":"Unable to login / Eamuse error / Network error","text":"

Get the proper Asphyxia plugin from our Discord server in the #iidx channel > Resources post. Make sure you didn't enable -smartea in spicecfg's options.

"},{"location":"games/bemani/iidx/32_pinkycrush/troubleshooting/#how-do-i-set-my-offset","title":"How do I set my offset?","text":"

Play through a chart you're comfortable with.

If you're getting too many Fast, increase your offset (+). If you're getting too many Slow, decrease your offset (-).

"},{"location":"games/bemani/iidx/32_pinkycrush/troubleshooting/#my-inputs-arent-working-i-cant-get-past-error-messages","title":"My inputs aren't working / I can't get past error messages!","text":"

If none of your inputs are working, try updating spice2x, you can also try using the beta versions if the stable releases don't work for you.

"},{"location":"games/bemani/iidx/32_pinkycrush/troubleshooting/#my-game-audio-is-super-quiet","title":"My game audio is super quiet!","text":"

When using TDJ mode the audio is very quiet by default. To mitigate this, you can use the Increase Game Volume patch.

"},{"location":"games/bemani/iidx/32_pinkycrush/troubleshooting/#when-i-run-the-game-all-other-audio-is-gone","title":"When I run the game all other audio is gone!","text":"

IIDX uses WASAPI exclusive mode for audio to get better audio latency. Unlike former versions of the games which used DirectSound.

You can use the Shared Mode WASAPI patch to hear other apps while the game is running, at the cost of some audio latency.

"},{"location":"games/bemani/iidx/32_pinkycrush/troubleshooting/#im-not-getting-any-audio-or-my-audio-is-completely-wrecked-and-im-using-an-external-dac","title":"I'm not getting any audio, or my audio is completely wrecked and I'm using an External Dac!","text":"

Many setups have found some difficulty with audio due to various equipment being used. Consider using the Shared Mode WASAPI patch.

"},{"location":"games/bemani/iidx/32_pinkycrush/troubleshooting/#my-audio-is-sloweddistorted-and-im-using-the-shared-mode-wasapi-patch","title":"My audio is slowed/distorted and I'm using the Shared Mode WASAPI patch.","text":"

When using this patch, you must set your audio device's sample rate to 48000 Hz. See audio for more details.

"},{"location":"games/bemani/iidx/9thstyle/setup/","title":"beatmania IIDX 9th style","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/iidx/9thstyle/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.
"},{"location":"games/bemani/iidx/9thstyle/setup/#installing-bemanitools","title":"Installing Bemanitools","text":"

  • Download Bemanitools.

  • Inside bemanitools-5.48.zip locate iidx-09-to-12.zip.

  • Extract everything inside the folder that contains the bm2dx.exe which is located in \\C02\\D\\C02\\JAG.

Pictured below is what your folder should look like. We've removed any files not necessary for 9th style.

"},{"location":"games/bemani/iidx/9thstyle/setup/#using-iidxhook-09conf","title":"Using iidxhook-09.conf","text":"

  • Download the Bemanitools supplements

  • Open bemanitools-supplement-v1.6.zip and navigate inside misc.zip

  • Inside misc\\d3d8to9, extract d3d8.dll to \\C02\\D\\C02\\JAG.

This enables us to use the graphic options inside iidxhook-09.conf which we will take advantage of.

"},{"location":"games/bemani/iidx/9thstyle/setup/#configuring-bemanitools","title":"Configuring Bemanitools","text":"

To configure your keybinds, open your config.bat file.

"},{"location":"games/bemani/iidx/9thstyle/setup/#buttons","title":"Buttons","text":"

Double click on the right on a button that you wish to bind, then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • P1 Game buttons: 1 to 7, Start, EFFECT, VEFX
  • P1 Keypad: Keypad Insert Card

Only if you're playing using a keyboard:

  • Turntable: TT+, TT- and optionally TT+/- which alternates between TT+ and TT- on each press.
"},{"location":"games/bemani/iidx/9thstyle/setup/#analogs-controllercab-only","title":"Analogs (controller/cab only)","text":"

With a controller rather than binding buttons to TT+ and TT-, you need to:

  • Head to the Analogs tab at the top.
  • In Device, pick your controller.
  • In Control, pick whichever one corresponds to the turntable.
  • Turn your turntable ensuring that the preview turns along with it.
  • Click OK, leaving the rest of the settings alone.
"},{"location":"games/bemani/iidx/9thstyle/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through bemanitools.

If it does, here's how you may link different actions to your lights:

  • In Device, pick your controller.
  • In Game Light, select the corresponding button that will be used for that light.
  • Repeat for your other lights.

If you'd like to play offline, you can head straight to Game resolution and locking FPS

"},{"location":"games/bemani/iidx/9thstyle/setup/#configuring-bemanitools-for-a-network","title":"Configuring Bemanitools for a network","text":"

Head over to the Network tab.

Now we will set up our PIN pad and card.

  • Click on Keyboard device
  • You may or may not have more than one option. To figure out which one is your actual keyboard, select a device inside that list and press a button on the numpad.
  • Once you have found your correct device, the Keyboard status will change (the number and location of the number does not matter, it only matters that it changed).
  • Grab your card, create a .txt and name it however you like. In this example it's called card.txt
  • Place the file in a location that is easily accessible and you won't forget. In this case it's in a seperate folder.

If you don't have a numpad, make sure to tick Use top keyboard row for PIN pad input. This will also change the Card In button to Backspace.

"},{"location":"games/bemani/iidx/9thstyle/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

  • Locate your iidxhook-09.conf

  • Open it with your desired text editor (we're using Notepad++)

  • Replace the eamuse.server=localhost:80 with your desired network URL

  • Replace eamuse.pcbid=XXXXXXXXXXXXXXXXXXXX and eamuse.eamid=XXXXXXXXXXXXXXXXXXXX with your PCBID of your network of choice.

# URL (e.g. http://my.eamuse.server:80/whatever) or IPV4 (e.g. 127.0.0.1:80) of the target eamuse server. The port is optional but defaults to 80.\neamuse.server=localhost:80\n\n# PCBID\neamuse.pcbid=XXXXXXXXXXXXXXXXXXXX\n\n# EAMID\neamuse.eamid=XXXXXXXXXXXXXXXXXXXX\n
"},{"location":"games/bemani/iidx/9thstyle/setup/#game-resolution-and-locking-fps","title":"Game resolution and locking FPS","text":"

We'd like to mention that there are two options when it comes to how the game renders. You can choose between Linear and Point.

Below is an example of how both look like.

Linear

Point

It comes down to your own prefrence what you decide on, Linear is less sharp but doesn't have pixel perfect edges. Point is sharp and is pixel perfect.

Next up, we'll setup borderless window and configure the proper resolution. We're using a 1920x1080 monitor so we will use that.

Repeat the previous step and open your iidxhook-09.conf. We want to find these lines:

# Software limit the frame rate of the rendering loop in hz, e.g. 60 or 59.95 (0.0 = no software limit)\ngfx.frame_rate_limit=0.0\n\n# Run the game windowed\ngfx.windowed=false\n\n# Windowed width, 0 for default size\ngfx.window_width=0\n\n# Windowed height, 0 for default size\ngfx.window_height=0\n\n# Up-/downscale the back buffer's width. This does not change the game's rendering resolution but scales the final frame. Use this to target the native resolution of your monitor/TV, e.g. to avoid over-/underscan, bad image quality or latency caused by the monitors internal upscaler. 0 to disable this feature. Must be set in combination with the corresponding height parameter.\ngfx.scale_back_buffer_width=0\n\n# Up-/downscale the back buffer's height. This does not change the game's rendering resolution but scales the final frame. Use this to target the native resolution of your monitor/TV, e.g. to avoid over-/underscan, bad image quality or latency caused by the monitors internal upscaler. 0 to disable this feature. Must be set in combination with the corresponding width parameter.\ngfx.scale_back_buffer_height=0\n\n# Filter type to use for up-/downscaling the back buffer. Only used if scaling feature was enabled by setting the scaling width and height parameters. Available types: none, linear, point (refer to D3DTEXTUREFILTERTYPE  for explanation).\ngfx.scale_back_buffer_filter=none\n

If you can't seem to find them, press CTRL + F and search for gfx.frame_rate_limit=0.0. This will bring you to the first line we want to edit.

Listed below are the values we want to change them to.

gfx.frame_rate_limit=59.95\ngfx.windowed=true\ngfx.window_width=1920\ngfx.window_height=1080\ngfx.scale_back_buffer_width=1920\ngfx.scale_back_buffer_height=1080\ngfx.scale_back_buffer_filter=linear\n
Unless you'd like to have the game properly windowed you can safely ignore gfx.framed=false.

Make sure to decide on whether you want Linear or Point rendering.

gfx.scale_back_buffer_filter=linear\ngfx.scale_back_buffer_filter=point\n
"},{"location":"games/bemani/iidx/9thstyle/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

"},{"location":"games/bemani/iidx/9thstyle/setup/#clock-error","title":"CLOCK ERROR","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run gamestart.bat.

If it's your first time running the game, you'll immediately be greeted with this screen.

The game will automatically bring you into it's service menu.

Instructions on how to navigate the menu are shown at the bottom of the screen.

  • Press 1 and 2 to go up and down.
  • Press 6 to select/execute.

Navigate to CLOCK SETUP. You do not need to manually change it. Navigate to SAVE AND EXIT.

If you'd like to play offline, you can head straight to Final Notes

"},{"location":"games/bemani/iidx/9thstyle/setup/#enabling-e-amusement-for-online-play","title":"Enabling e-AMUSEMENT for Online Play","text":"

From the service menu, go to e-AMUSEMENT OPTIONS then e-AMUSEMENT SETTINGS.

It'll bring you to this screen, change it so that e-AMUSEMENT switches to ON and it will look like this:

We will need to set a SHOP NAME SETTING and change our PREFECTURE otherwise the game will throw errors at us.

  • Name your shop to whatever you'd like. Instructions on how to navigate are at the bottom of the screen.
  • Navigate to EXIT and select it.
  • Change your prefecture once or how many times you'd like, it doesn't matter as long as it's not the default one.

Select SAVE AND EXIT. The game will now give you a message, which translated means:

e-AMUSEMENT settings have been changed. Please turn the power off and on again.

So, close the game and open it again.

"},{"location":"games/bemani/iidx/9thstyle/setup/#final-notes","title":"Final Notes","text":"

You're all done! Make sure to insert two credits by pressing your SERVICE key. Have fun!

Have any other errors?

Check out the Troubleshooting section.

"},{"location":"games/bemani/iidx/9thstyle/troubleshooting/","title":"beatmania IIDX 9th style","text":""},{"location":"games/bemani/iidx/9thstyle/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

The most common reason for this is the game is running over its required 59.95hz, the game is hardcoded to run at 59.95hz and this cannot be changed. To solve this, check Game resolution and locking FPS again.

"},{"location":"games/bemani/iidx/9thstyle/troubleshooting/#im-getting-network-warning-instead-of-network-ok","title":"I'm getting \"NETWORK WARNING\" instead of \"NETWORK OK\"","text":"

This can be caused by:

  • Invalid PCBID
  • Firewall blocking connections
  • Invalid eamuse url or port specified
  • Game is not run using the Administrator account
"},{"location":"games/bemani/iidx/9thstyle/troubleshooting/#my-background-videos-arent-working","title":"My background videos aren't working!","text":"

You need to install a codec.

  • Open bemanitools-supplement-v1.6.zip and navigate to \\iidx.zip\\iidx\\misc\\ where CLVSD.ax is located.

  • Extract CLVSD.ax inside a folder that you know won't be moved or renamed.

  • Open the command prompt as administrator. Now type regsvr32 \"<location of the file>\\CLVSD.ax\" into the command prompt.

As an example, it could look like this: regsvr32 \"D:\\BEMANI\\IIDX\\CLVSD.ax\"

A prompt should appear telling you that it has been installed successfully. This applies for all styles that require this codec, not just 9th style.

If an error occurs, you didn't run the command prompt as administrator or you messed up the location of the file.

You can not move or delete CLVSD.ax at all, otherwise it will revert the changes and you have to install it again.

"},{"location":"games/bemani/iidx/9thstyle/troubleshooting/#my-game-crashes-immediately","title":"My game crashes immediately!","text":"

This can have multiple reasons. These fixes shouldn't be needed for 9th style since we're addressing them in the guide. We'll add them anyway just in case.

"},{"location":"games/bemani/iidx/9thstyle/troubleshooting/#fix-1-wrong-data-structure","title":"Fix #1 (Wrong data structure)","text":"

Make sure that your unpacked data looks like this:

  • JAx (Game binary revision folder where 'x' can be A, B, C, D, E, F, G)
  • data
  • sidcode.txt

Any other files are optional and don't have to be removed as these are not required to run the game.

"},{"location":"games/bemani/iidx/9thstyle/troubleshooting/#fix-2-rteffectsdll-didnt-get-replaced","title":"Fix #2 (RtEffects.dll didn't get replaced)","text":"

Refer to Preparing data again and check if you have followed all the instructions explained in it.

"},{"location":"games/bemani/jubeat/clan/setup/","title":"jubeat clan","text":"

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.

"},{"location":"games/bemani/jubeat/clan/setup/#getting-started","title":"Getting Started","text":"

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.

"},{"location":"games/bemani/jubeat/clan/setup/#configuring-your-tools","title":"Configuring Your Tools","text":"

Now that you have your files ready, open up your .bat file in your desired text editor (we're using Notepad++) 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.

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.

"},{"location":"games/bemani/jubeat/clan/setup/#configuring-for-a-local-network","title":"Configuring for a Local Network","text":"

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++.

"},{"location":"games/bemani/jubeat/clan/setup/#configuring-for-an-online-network","title":"Configuring for an Online Network","text":"

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++.

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.

"},{"location":"games/bemani/jubeat/clan/setup/#final-steps-and-setting-up-the-game","title":"Final Steps and Setting up the Game","text":"

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!

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.

Enter the GAME OPTIONS menu and proceed to the SHOP SETTINGS menu.

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.

With that, you're all done! Simply exit the service menu or reboot then enjoy the game, have fun!

Have any other errors?

Check out the Troubleshooting section and Error Code section to resolve any issues not seen in this guide to greater depth.

"},{"location":"games/bemani/jubeat/clan/troubleshooting/","title":"jubeat clan","text":""},{"location":"games/bemani/jubeat/clan/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

Bemani PC (ADE-704A)

This board has a E4690 Radeon MXM card.

CPU: Intel Celeron B810

GPU: AMD Radeon E4690

Chipset: Intel HM65

"},{"location":"games/bemani/jubeat/clan/troubleshooting/#my-game-is-running-slowlagging","title":"My Game Is Running Slow/Lagging","text":"

Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.

"},{"location":"games/bemani/jubeat/clan/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

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.

"},{"location":"games/bemani/jubeat/clan/troubleshooting/#occasional-game-stutters-during-play","title":"Occasional Game Stutters During Play","text":"

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.

"},{"location":"games/bemani/jubeat/clan/troubleshooting/#my-touchscreen-isnt-working","title":"My Touchscreen Isn't Working!","text":"

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.

"},{"location":"games/bemani/museca/1plushalf/setup/","title":"MUSECA 1+1/2","text":"

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.

"},{"location":"games/bemani/museca/1plushalf/setup/#getting-started","title":"Getting Started","text":"

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.

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.

"},{"location":"games/bemani/museca/1plushalf/setup/#configuring-your-tools","title":"Configuring Your Tools","text":"

Now that you have your files ready, open up your .bat file in your desired text editor (we're using Notepad++) 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.

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.

"},{"location":"games/bemani/museca/1plushalf/setup/#configuring-for-a-local-network","title":"Configuring for a Local Network","text":"

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!
"},{"location":"games/bemani/museca/1plushalf/setup/#configuring-for-an-online-network","title":"Configuring for an Online Network","text":"

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!

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.

"},{"location":"games/bemani/museca/1plushalf/setup/#final-steps-and-setting-up-the-game","title":"Final Steps and Setting up the Game","text":"

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.

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

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!

Have any other errors?

Check out the Troubleshooting and Error Code sections to resolve any issues not seen in this guide to greater depth.

"},{"location":"games/bemani/museca/1plushalf/troubleshooting/","title":"MUSECA 1+1/2","text":""},{"location":"games/bemani/museca/1plushalf/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

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

"},{"location":"games/bemani/museca/1plushalf/troubleshooting/#my-game-is-running-slowlagging","title":"My Game Is Running Slow/Lagging","text":"

Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.

"},{"location":"games/bemani/museca/1plushalf/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

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.

"},{"location":"games/bemani/museca/1plushalf/troubleshooting/#occasional-game-stutters-during-play","title":"Occasional Game Stutters During Play","text":"

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.

"},{"location":"games/bemani/museca/1plushalf/troubleshooting/#which-offset-is-which","title":"Which Offset Is Which?","text":"

If you're getting too many fasts, increase your offset (+). If you're getting too many slows, decrease your offset (-).

"},{"location":"games/bemani/museca/1plushalf/troubleshooting/#booting-the-game-in-offline-mode","title":"Booting the Game in Offline Mode","text":"

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.

"},{"location":"games/bemani/museca/1plushalf/troubleshooting/#when-i-run-this-game-all-other-background-audio-is-gone-whats-going-on","title":"When I Run This Game All Other Background Audio Is Gone! What's Going On?","text":"

Museca is a 64-bit game utilizing a feature in Windows called WASAPI exclusive mode to obtain less audio latency. Unfortunately, this cannot be changed.

"},{"location":"games/bemani/museca/1plushalf/troubleshooting/#im-not-getting-any-audiomy-audio-is-completely-wrecked-and-im-using-an-external-dac","title":"I'm Not Getting Any Audio/My Audio Is Completely Wrecked and I'm Using an External Dac!","text":"

Several external DACs have issues with WASAPI exclusive mode 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.

"},{"location":"games/bemani/nostalgia/forte/setup/","title":"NOSTALGIA FORTE","text":"

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.

"},{"location":"games/bemani/nostalgia/forte/setup/#getting-started","title":"Getting Started","text":"

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.

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.

"},{"location":"games/bemani/nostalgia/forte/setup/#configuring-your-tools","title":"Configuring Your Tools","text":"

Now that you have your files ready, open up your .bat file in your desired text editor (we're using Notepad++) 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.

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.

"},{"location":"games/bemani/nostalgia/forte/setup/#configuring-for-a-local-network","title":"Configuring for a Local Network","text":"

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!
"},{"location":"games/bemani/nostalgia/forte/setup/#configuring-for-an-online-network","title":"Configuring for an Online Network","text":"

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!
"},{"location":"games/bemani/nostalgia/forte/setup/#final-steps-and-setting-up-the-game","title":"Final Steps and Setting up the Game","text":"

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.

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.

The final menu we must deal with is VIRTUAL COIN, enter the menu and select OPERATION SETTINGS as seen below.

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.

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.

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.

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!

Have any other errors?

Check out the Troubleshooting section and Error Code section to resolve any issues not seen in this guide to greater depth.

"},{"location":"games/bemani/nostalgia/forte/troubleshooting/","title":"NOSTALGIA FORTE","text":""},{"location":"games/bemani/nostalgia/forte/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

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

"},{"location":"games/bemani/nostalgia/forte/troubleshooting/#my-game-is-running-slowlagging","title":"My Game Is Running Slow/Lagging","text":"

Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.

"},{"location":"games/bemani/nostalgia/forte/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

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.

"},{"location":"games/bemani/nostalgia/forte/troubleshooting/#occasional-game-stutters-during-play","title":"Occasional Game Stutters During Play","text":"

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.

"},{"location":"games/bemani/nostalgia/forte/troubleshooting/#which-offset-is-which","title":"Which Offset Is Which?","text":"

If you're getting too many fasts, increase your offset (+). If you're getting too many slows, decrease your offset (-).

"},{"location":"games/bemani/nostalgia/forte/troubleshooting/#no-matter-what-i-do-the-game-crashes-and-i-have-multiple-monitors","title":"No Matter What I Do, the Game Crashes and I Have Multiple Monitors!","text":"

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.

"},{"location":"games/bemani/nostalgia/op2/setup/","title":"NOSTALGIA OP.2","text":"

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.

"},{"location":"games/bemani/nostalgia/op2/setup/#getting-started","title":"Getting Started","text":"

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.

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.

"},{"location":"games/bemani/nostalgia/op2/setup/#configuring-your-tools","title":"Configuring Your Tools","text":"

Now that you have your files ready, open up your .bat file in your desired text editor (we're using Notepad++) 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.

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.

"},{"location":"games/bemani/nostalgia/op2/setup/#configuring-for-a-local-network","title":"Configuring for a Local Network","text":"

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!
"},{"location":"games/bemani/nostalgia/op2/setup/#configuring-for-an-online-network","title":"Configuring for an Online Network","text":"

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!
"},{"location":"games/bemani/nostalgia/op2/setup/#final-steps-and-setting-up-the-game","title":"Final Steps and Setting up the Game","text":"

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.

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.

The final menu we must deal with is VIRTUAL COIN, enter the menu and select OPERATION SETTINGS as seen below.

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.

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.

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.

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!

Have any other errors?

Check out the Troubleshooting section and Error Code section to resolve any issues not seen in this guide to greater depth.

"},{"location":"games/bemani/nostalgia/op2/troubleshooting/","title":"NOSTALGIA OP.2","text":""},{"location":"games/bemani/nostalgia/op2/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

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

"},{"location":"games/bemani/nostalgia/op2/troubleshooting/#my-game-is-running-slowlagging","title":"My Game Is Running Slow/Lagging","text":"

Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.

"},{"location":"games/bemani/nostalgia/op2/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

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.

"},{"location":"games/bemani/nostalgia/op2/troubleshooting/#occasional-game-stutters-during-play","title":"Occasional Game Stutters During Play","text":"

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.

"},{"location":"games/bemani/nostalgia/op2/troubleshooting/#which-offset-is-which","title":"Which Offset Is Which?","text":"

If you're getting too many fasts, increase your offset (+). If you're getting too many slows, decrease your offset (-).

"},{"location":"games/bemani/nostalgia/op2/troubleshooting/#no-matter-what-i-do-the-game-crashes-and-i-have-multiple-monitors","title":"No Matter What I Do, the Game Crashes and I Have Multiple Monitors!","text":"

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.

"},{"location":"games/bemani/popn/common/setup/","title":"Setup","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/popn/common/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure with a few folders only, as follows.

If your data doesn't look like this

If you're missing the dev folder, you can safely ignore it as it'll be created by spice2x automatically.

If you're missing the modules folder and instead have bunch of .dll files next to your folders:

  • Create a modules folder.
  • Move all .dll files inside of it so you end up with a structure as shown above.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

If you don't need to update your data, you can skip over to the Installing Spice2x section.

"},{"location":"games/bemani/popn/common/setup/#updating-data","title":"Updating data","text":"Please make sure you're using the right update for your current data.

pop'n music patches re-uploaded by the community tend to be appropriately named M39-DATECODE-to-DATECODE.

For example M39-2024073100-to-2024091700.

  • 2024073100 being your current data's version.
  • 2024091700 being the one you would arrive at.
  • Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.
  • Open prop\\ea3-config.xml in a text editor and find the following lines near the top.
    <soft>\n        <model __type=\"str\">M39</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">A</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024091700</ext>\n    </soft>\n

On the line with <ext __type=\"str\"> the datecode needs to match your new version.

  • If that's already the case then great! Don't touch anything.
  • If it instead corresponds to your pre-patch datecode, replace it with the new one and save the file.
"},{"location":"games/bemani/popn/common/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice.exe and spicecfg.exe files from the archive to your game's directory.

"},{"location":"games/bemani/popn/common/setup/#configuring-spice2x","title":"Configuring Spice2x","text":"

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/popn/common/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • Game buttons: 1 to 9
  • P1 Keypad: 1 to 9, Keypad Insert Card
"},{"location":"games/bemani/popn/common/setup/#overlay","title":"Overlay","text":"

Modifying buttons in this section is not required but you are free to change what you want.

Click on Bind then press the key you want associated with the action.

"},{"location":"games/bemani/popn/common/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through spice2x.

If it does, here's how you may link different actions to your lights:

  • Click Bind.
  • In Device, pick your controller.
  • In Light Control, select the corresponding light.
  • Click Close.
  • Repeat for your other lights.
"},{"location":"games/bemani/popn/common/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section.

"},{"location":"games/bemani/popn/common/setup/#patches","title":"Patches","text":"

Go through the Spice2x Patching page to import patches.

To prevent issues, avoid patching things you don't need or understand.

"},{"location":"games/bemani/popn/common/setup/#api","title":"API","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/popn/common/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the question mark at the very left.

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Network EA Service URL -url Covered in Connecting to a network

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/popn/common/setup/#advanced-development","title":"Advanced & Development","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/popn/common/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/popn/common/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run spice.exe, press Yes when it asks for elevated privileges.

The game will go through a series of checks, let it run, if you've done everything properly they'll pass.

"},{"location":"games/bemani/popn/common/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/bemani/popn/common/troubleshooting/","title":"Troubleshooting","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/popn/common/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch","text":"

Some monitors and display adapters may not support the odd resolution that the game runs at, which is 1360x768 as opposed to the occasionally seen 1366x768. To resolve this, set a custom resolution in your graphics card's settings, or enable GPU resolution scaling.

"},{"location":"games/bemani/popn/common/troubleshooting/#my-game-is-too-slowfast","title":"My game is too slow/fast","text":"

Potential causes:

  1. The game could be running over/under its required refresh rate (60) To solve this, make sure v-sync isn't disabled in your graphics card's settings. For NVIDIA users, enable NVIDIA profile optimization (-nvprofile) in the Options tab. You can also set Force Refresh Rate to 60.
  2. It could be that your computer's performance isn't good enough to keep a steady framerate.
"},{"location":"games/bemani/popn/common/troubleshooting/#my-game-doesnt-have-audio","title":"My game doesn't have audio","text":"

Enable the HDMI Audio Fix patch.

"},{"location":"games/bemani/popn/kaimei_riddles/setup/","title":"Game Setup (pop'n music Kaimei Riddles)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/popn/kaimei_riddles/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure with a few folders only, as follows.

If your data doesn't look like this

If you're missing the dev folder, you can safely ignore it as it'll be created by spice2x automatically.

If you're missing the modules folder and instead have bunch of .dll files next to your folders:

  • Create a modules folder.
  • Move all .dll files inside of it so you end up with a structure as shown above.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

If you don't need to update your data, you can skip over to the Installing Spice2x section.

"},{"location":"games/bemani/popn/kaimei_riddles/setup/#updating-data","title":"Updating data","text":"Please make sure you're using the right update for your current data.

pop'n music patches re-uploaded by the community tend to be appropriately named M39-DATECODE-to-DATECODE.

For example M39-2024073100-to-2024091700.

  • 2024073100 being your current data's version.
  • 2024091700 being the one you would arrive at.
  • Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.
  • Open prop\\ea3-config.xml in a text editor and find the following lines near the top.
    <soft>\n        <model __type=\"str\">M39</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">A</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024091700</ext>\n    </soft>\n

On the line with <ext __type=\"str\"> the datecode needs to match your new version.

  • If that's already the case then great! Don't touch anything.
  • If it instead corresponds to your pre-patch datecode, replace it with the new one and save the file.
"},{"location":"games/bemani/popn/kaimei_riddles/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice.exe and spicecfg.exe files from the archive to your game's directory.

"},{"location":"games/bemani/popn/kaimei_riddles/setup/#configuring-spice2x","title":"Configuring Spice2x","text":"

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/popn/kaimei_riddles/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • Game buttons: 1 to 9
  • P1 Keypad: 1 to 9, Keypad Insert Card
"},{"location":"games/bemani/popn/kaimei_riddles/setup/#overlay","title":"Overlay","text":"

Modifying buttons in this section is not required but you are free to change what you want.

Click on Bind then press the key you want associated with the action.

"},{"location":"games/bemani/popn/kaimei_riddles/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through spice2x.

If it does, here's how you may link different actions to your lights:

  • Click Bind.
  • In Device, pick your controller.
  • In Light Control, select the corresponding light.
  • Click Close.
  • Repeat for your other lights.
"},{"location":"games/bemani/popn/kaimei_riddles/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section.

"},{"location":"games/bemani/popn/kaimei_riddles/setup/#patches","title":"Patches","text":"

Go through the Spice2x Patching page to import patches.

To prevent issues, avoid patching things you don't need or understand.

"},{"location":"games/bemani/popn/kaimei_riddles/setup/#api","title":"API","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/popn/kaimei_riddles/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the question mark at the very left.

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Network EA Service URL -url Covered in Connecting to a network

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/popn/kaimei_riddles/setup/#advanced-development","title":"Advanced & Development","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/popn/kaimei_riddles/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/popn/kaimei_riddles/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run spice.exe, press Yes when it asks for elevated privileges.

The game will go through a series of checks, let it run, if you've done everything properly they'll pass.

"},{"location":"games/bemani/popn/kaimei_riddles/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/bemani/popn/kaimei_riddles/troubleshooting/","title":"Troubleshooting (pop'n music Kaimei Riddles)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/popn/kaimei_riddles/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch","text":"

Some monitors and display adapters may not support the odd resolution that the game runs at, which is 1360x768 as opposed to the occasionally seen 1366x768. To resolve this, set a custom resolution in your graphics card's settings, or enable GPU resolution scaling.

"},{"location":"games/bemani/popn/kaimei_riddles/troubleshooting/#my-game-is-too-slowfast","title":"My game is too slow/fast","text":"

Potential causes:

  1. The game could be running over/under its required refresh rate (60) To solve this, make sure v-sync isn't disabled in your graphics card's settings. For NVIDIA users, enable NVIDIA profile optimization (-nvprofile) in the Options tab. You can also set Force Refresh Rate to 60.
  2. It could be that your computer's performance isn't good enough to keep a steady framerate.
"},{"location":"games/bemani/popn/kaimei_riddles/troubleshooting/#my-game-doesnt-have-audio","title":"My game doesn't have audio","text":"

Enable the HDMI Audio Fix patch.

"},{"location":"games/bemani/popn/peace/setup/","title":"Game Setup (pop'n music peace)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/popn/peace/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure with a few folders only, as follows.

If your data doesn't look like this

If you're missing the dev folder, you can safely ignore it as it'll be created by spice2x automatically.

If you're missing the modules folder and instead have bunch of .dll files next to your folders:

  • Create a modules folder.
  • Move all .dll files inside of it so you end up with a structure as shown above.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

If you don't need to update your data, you can skip over to the Installing Spice2x section.

"},{"location":"games/bemani/popn/peace/setup/#updating-data","title":"Updating data","text":"Please make sure you're using the right update for your current data.

pop'n music patches re-uploaded by the community tend to be appropriately named M39-DATECODE-to-DATECODE.

For example M39-2024073100-to-2024091700.

  • 2024073100 being your current data's version.
  • 2024091700 being the one you would arrive at.
  • Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.
  • Open prop\\ea3-config.xml in a text editor and find the following lines near the top.
    <soft>\n        <model __type=\"str\">M39</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">A</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024091700</ext>\n    </soft>\n

On the line with <ext __type=\"str\"> the datecode needs to match your new version.

  • If that's already the case then great! Don't touch anything.
  • If it instead corresponds to your pre-patch datecode, replace it with the new one and save the file.
"},{"location":"games/bemani/popn/peace/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice.exe and spicecfg.exe files from the archive to your game's directory.

"},{"location":"games/bemani/popn/peace/setup/#configuring-spice2x","title":"Configuring Spice2x","text":"

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/popn/peace/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • Game buttons: 1 to 9
  • P1 Keypad: 1 to 9, Keypad Insert Card
"},{"location":"games/bemani/popn/peace/setup/#overlay","title":"Overlay","text":"

Modifying buttons in this section is not required but you are free to change what you want.

Click on Bind then press the key you want associated with the action.

"},{"location":"games/bemani/popn/peace/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through spice2x.

If it does, here's how you may link different actions to your lights:

  • Click Bind.
  • In Device, pick your controller.
  • In Light Control, select the corresponding light.
  • Click Close.
  • Repeat for your other lights.
"},{"location":"games/bemani/popn/peace/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section.

"},{"location":"games/bemani/popn/peace/setup/#patches","title":"Patches","text":"

Go through the Spice2x Patching page to import patches.

To prevent issues, avoid patching things you don't need or understand.

"},{"location":"games/bemani/popn/peace/setup/#api","title":"API","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/popn/peace/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the question mark at the very left.

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Network EA Service URL -url Covered in Connecting to a network

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/popn/peace/setup/#advanced-development","title":"Advanced & Development","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/popn/peace/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/popn/peace/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run spice.exe, press Yes when it asks for elevated privileges.

The game will go through a series of checks, let it run, if you've done everything properly they'll pass.

"},{"location":"games/bemani/popn/peace/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/bemani/popn/peace/troubleshooting/","title":"Troubleshooting (pop'n music peace)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/popn/peace/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch","text":"

Some monitors and display adapters may not support the odd resolution that the game runs at, which is 1360x768 as opposed to the occasionally seen 1366x768. To resolve this, set a custom resolution in your graphics card's settings, or enable GPU resolution scaling.

"},{"location":"games/bemani/popn/peace/troubleshooting/#my-game-is-too-slowfast","title":"My game is too slow/fast","text":"

Potential causes:

  1. The game could be running over/under its required refresh rate (60) To solve this, make sure v-sync isn't disabled in your graphics card's settings. For NVIDIA users, enable NVIDIA profile optimization (-nvprofile) in the Options tab. You can also set Force Refresh Rate to 60.
  2. It could be that your computer's performance isn't good enough to keep a steady framerate.
"},{"location":"games/bemani/popn/peace/troubleshooting/#my-game-doesnt-have-audio","title":"My game doesn't have audio","text":"

Enable the HDMI Audio Fix patch.

"},{"location":"games/bemani/popn/unilab/setup/","title":"Game Setup (pop'n music UniLab)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/popn/unilab/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure with a few folders only, as follows.

If your data doesn't look like this

If you're missing the dev folder, you can safely ignore it as it'll be created by spice2x automatically.

If you're missing the modules folder and instead have bunch of .dll files next to your folders:

  • Create a modules folder.
  • Move all .dll files inside of it so you end up with a structure as shown above.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

If you don't need to update your data, you can skip over to the Installing Spice2x section.

"},{"location":"games/bemani/popn/unilab/setup/#updating-data","title":"Updating data","text":"Please make sure you're using the right update for your current data.

pop'n music patches re-uploaded by the community tend to be appropriately named M39-DATECODE-to-DATECODE.

For example M39-2024073100-to-2024091700.

  • 2024073100 being your current data's version.
  • 2024091700 being the one you would arrive at.
  • Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.
  • Open prop\\ea3-config.xml in a text editor and find the following lines near the top.
    <soft>\n        <model __type=\"str\">M39</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">A</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024091700</ext>\n    </soft>\n

On the line with <ext __type=\"str\"> the datecode needs to match your new version.

  • If that's already the case then great! Don't touch anything.
  • If it instead corresponds to your pre-patch datecode, replace it with the new one and save the file.
"},{"location":"games/bemani/popn/unilab/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice.exe and spicecfg.exe files from the archive to your game's directory.

"},{"location":"games/bemani/popn/unilab/setup/#configuring-spice2x","title":"Configuring Spice2x","text":"

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/popn/unilab/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • Game buttons: 1 to 9
  • P1 Keypad: 1 to 9, Keypad Insert Card
"},{"location":"games/bemani/popn/unilab/setup/#overlay","title":"Overlay","text":"

Modifying buttons in this section is not required but you are free to change what you want.

Click on Bind then press the key you want associated with the action.

"},{"location":"games/bemani/popn/unilab/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through spice2x.

If it does, here's how you may link different actions to your lights:

  • Click Bind.
  • In Device, pick your controller.
  • In Light Control, select the corresponding light.
  • Click Close.
  • Repeat for your other lights.
"},{"location":"games/bemani/popn/unilab/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section.

"},{"location":"games/bemani/popn/unilab/setup/#patches","title":"Patches","text":"

Go through the Spice2x Patching page to import patches.

To prevent issues, avoid patching things you don't need or understand.

"},{"location":"games/bemani/popn/unilab/setup/#api","title":"API","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/popn/unilab/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the question mark at the very left.

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Network EA Service URL -url Covered in Connecting to a network

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/popn/unilab/setup/#advanced-development","title":"Advanced & Development","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/popn/unilab/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/popn/unilab/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run spice.exe, press Yes when it asks for elevated privileges.

The game will go through a series of checks, let it run, if you've done everything properly they'll pass.

"},{"location":"games/bemani/popn/unilab/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/bemani/popn/unilab/troubleshooting/","title":"Troubleshooting (pop'n music UniLab)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/popn/unilab/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch","text":"

Some monitors and display adapters may not support the odd resolution that the game runs at, which is 1360x768 as opposed to the occasionally seen 1366x768. To resolve this, set a custom resolution in your graphics card's settings, or enable GPU resolution scaling.

"},{"location":"games/bemani/popn/unilab/troubleshooting/#my-game-is-too-slowfast","title":"My game is too slow/fast","text":"

Potential causes:

  1. The game could be running over/under its required refresh rate (60) To solve this, make sure v-sync isn't disabled in your graphics card's settings. For NVIDIA users, enable NVIDIA profile optimization (-nvprofile) in the Options tab. You can also set Force Refresh Rate to 60.
  2. It could be that your computer's performance isn't good enough to keep a steady framerate.
"},{"location":"games/bemani/popn/unilab/troubleshooting/#my-game-doesnt-have-audio","title":"My game doesn't have audio","text":"

Enable the HDMI Audio Fix patch.

"},{"location":"games/bemani/popn/usaneko/setup/","title":"Game Setup (pop'n music Usaneko)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/popn/usaneko/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure with a few folders only, as follows.

If your data doesn't look like this

If you're missing the dev folder, you can safely ignore it as it'll be created by spice2x automatically.

If you're missing the modules folder and instead have bunch of .dll files next to your folders:

  • Create a modules folder.
  • Move all .dll files inside of it so you end up with a structure as shown above.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

If you don't need to update your data, you can skip over to the Installing Spice2x section.

"},{"location":"games/bemani/popn/usaneko/setup/#updating-data","title":"Updating data","text":"Please make sure you're using the right update for your current data.

pop'n music patches re-uploaded by the community tend to be appropriately named M39-DATECODE-to-DATECODE.

For example M39-2024073100-to-2024091700.

  • 2024073100 being your current data's version.
  • 2024091700 being the one you would arrive at.
  • Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.
  • Open prop\\ea3-config.xml in a text editor and find the following lines near the top.
    <soft>\n        <model __type=\"str\">M39</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">A</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024091700</ext>\n    </soft>\n

On the line with <ext __type=\"str\"> the datecode needs to match your new version.

  • If that's already the case then great! Don't touch anything.
  • If it instead corresponds to your pre-patch datecode, replace it with the new one and save the file.
"},{"location":"games/bemani/popn/usaneko/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice.exe and spicecfg.exe files from the archive to your game's directory.

"},{"location":"games/bemani/popn/usaneko/setup/#configuring-spice2x","title":"Configuring Spice2x","text":"

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/popn/usaneko/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • Game buttons: 1 to 9
  • P1 Keypad: 1 to 9, Keypad Insert Card
"},{"location":"games/bemani/popn/usaneko/setup/#overlay","title":"Overlay","text":"

Modifying buttons in this section is not required but you are free to change what you want.

Click on Bind then press the key you want associated with the action.

"},{"location":"games/bemani/popn/usaneko/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through spice2x.

If it does, here's how you may link different actions to your lights:

  • Click Bind.
  • In Device, pick your controller.
  • In Light Control, select the corresponding light.
  • Click Close.
  • Repeat for your other lights.
"},{"location":"games/bemani/popn/usaneko/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section.

"},{"location":"games/bemani/popn/usaneko/setup/#patches","title":"Patches","text":"

Go through the Spice2x Patching page to import patches.

To prevent issues, avoid patching things you don't need or understand.

"},{"location":"games/bemani/popn/usaneko/setup/#api","title":"API","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/popn/usaneko/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the question mark at the very left.

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Network EA Service URL -url Covered in Connecting to a network

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/popn/usaneko/setup/#advanced-development","title":"Advanced & Development","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/popn/usaneko/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/popn/usaneko/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run spice.exe, press Yes when it asks for elevated privileges.

The game will go through a series of checks, let it run, if you've done everything properly they'll pass.

"},{"location":"games/bemani/popn/usaneko/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/bemani/popn/usaneko/troubleshooting/","title":"Troubleshooting (pop'n music Usaneko)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/popn/usaneko/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch","text":"

Some monitors and display adapters may not support the odd resolution that the game runs at, which is 1360x768 as opposed to the occasionally seen 1366x768. To resolve this, set a custom resolution in your graphics card's settings, or enable GPU resolution scaling.

"},{"location":"games/bemani/popn/usaneko/troubleshooting/#my-game-is-too-slowfast","title":"My game is too slow/fast","text":"

Potential causes:

  1. The game could be running over/under its required refresh rate (60) To solve this, make sure v-sync isn't disabled in your graphics card's settings. For NVIDIA users, enable NVIDIA profile optimization (-nvprofile) in the Options tab. You can also set Force Refresh Rate to 60.
  2. It could be that your computer's performance isn't good enough to keep a steady framerate.
"},{"location":"games/bemani/popn/usaneko/troubleshooting/#my-game-doesnt-have-audio","title":"My game doesn't have audio","text":"

Enable the HDMI Audio Fix patch.

"},{"location":"games/bemani/reflecbeat/reflesia/setup/","title":"REFLEC BEAT: The Reflesia of Eternity","text":"

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.

"},{"location":"games/bemani/reflecbeat/reflesia/setup/#getting-started","title":"Getting Started","text":"

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.

"},{"location":"games/bemani/reflecbeat/reflesia/setup/#configuring-your-tools","title":"Configuring Your Tools","text":"

Now that you have your files ready, open up your .bat file in your desired text editor (we're using Notepad++) 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.

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.

"},{"location":"games/bemani/reflecbeat/reflesia/setup/#configuring-for-a-local-network","title":"Configuring for a Local Network","text":"

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!
"},{"location":"games/bemani/reflecbeat/reflesia/setup/#configuring-for-an-online-network","title":"Configuring for an Online Network","text":"

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!

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.

"},{"location":"games/bemani/reflecbeat/reflesia/setup/#final-steps-and-setting-up-the-game","title":"Final Steps and Setting up the Game","text":"

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.

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.

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!

Have any other errors?

Check out the Troubleshooting section and Error Code section to resolve any issues not seen in this guide to greater depth.

"},{"location":"games/bemani/reflecbeat/reflesia/troubleshooting/","title":"REFLEC BEAT: Reflesia","text":""},{"location":"games/bemani/reflecbeat/reflesia/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

Bemani PC (ADE-704A)

CPU: Intel Celeron B810 1.6GHz

GPU: E4690 Radeon MXM

OS: Windows XP Embedded

"},{"location":"games/bemani/reflecbeat/reflesia/troubleshooting/#my-game-doesnt-boot-after-following-the-guide","title":"My Game Doesn't Boot After Following the Guide!","text":"

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 patch.

"},{"location":"games/bemani/reflecbeat/reflesia/troubleshooting/#my-game-is-running-slowlagging","title":"My Game Is Running Slow/Lagging","text":"

Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.

"},{"location":"games/bemani/reflecbeat/reflesia/troubleshooting/#my-game-is-running-crazy-fastafter-finishing-a-song-loading-is-stuck","title":"My Game Is Running Crazy Fast/After Finishing a Song Loading Is Stuck","text":"

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.

"},{"location":"games/bemani/reflecbeat/reflesia/troubleshooting/#which-offset-is-which","title":"Which Offset Is Which?","text":"

If you're getting too many fasts, increase your offset (+). If you're getting too many slows, decrease your offset (-).

"},{"location":"games/bemani/reflecbeat/reflesia/troubleshooting/#failed-to-create-texture-error-in-spicetools","title":"Failed to Create Texture Error in SpiceTools","text":"

If your error is along the lines of a failure to create a texture W:afputils: CTexture::create_texture \u30c6\u30af\u30b9\u30c1\u30e3\u306e\u4f5c\u6210\u306b\u5931\u6557\u3057\u307e\u3057\u305f\u3002 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.

"},{"location":"games/bemani/reflecbeat/reflesia/troubleshooting/#i-get-a-white-screen-that-silently-closes-after-a-few-seconds","title":"I Get a White Screen That Silently Closes After a Few Seconds","text":"

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.

"},{"location":"games/bemani/sdvx/4_heavenlyhaven/setup/","title":"SOUND VOLTEX IV HEAVENLY HAVEN","text":"

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.

"},{"location":"games/bemani/sdvx/4_heavenlyhaven/setup/#getting-started","title":"Getting Started","text":"

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.

"},{"location":"games/bemani/sdvx/4_heavenlyhaven/setup/#configuring-your-tools","title":"Configuring Your Tools","text":"

Now that you have your files ready, open up your .bat file in your desired text editor (we're using Notepad++) 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.

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.

"},{"location":"games/bemani/sdvx/4_heavenlyhaven/setup/#configuring-for-a-local-network","title":"Configuring for a Local Network","text":"

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++.

"},{"location":"games/bemani/sdvx/4_heavenlyhaven/setup/#configuring-for-an-online-network","title":"Configuring for an Online Network","text":"

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++.

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.

"},{"location":"games/bemani/sdvx/4_heavenlyhaven/setup/#final-steps-and-setting-up-the-game","title":"Final Steps and Setting up the Game","text":"

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.

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!

Have any other errors?

Check out the Troubleshooting section and Error Code section to resolve any issues not seen in this guide to greater depth.

"},{"location":"games/bemani/sdvx/4_heavenlyhaven/troubleshooting/","title":"SDVX IV Troubleshooting","text":""},{"location":"games/bemani/sdvx/4_heavenlyhaven/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

Bemani PC Type 4

CPU: Celeron M 440 1.86GHz

GPU: ATI Radeon HD 2400

RAM: 2 GB

OS: Windows XP Embedded

"},{"location":"games/bemani/sdvx/4_heavenlyhaven/troubleshooting/#my-game-is-running-slowlagging","title":"My Game Is Running Slow/Lagging","text":"

Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.

"},{"location":"games/bemani/sdvx/4_heavenlyhaven/troubleshooting/#my-game-is-running-crazy-fastafter-finishing-a-song-loading-is-stuck","title":"My Game Is Running Crazy Fast/After Finishing a Song Loading Is Stuck","text":"

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.

"},{"location":"games/bemani/sdvx/4_heavenlyhaven/troubleshooting/#which-offset-is-which","title":"Which Offset Is Which?","text":"

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.

"},{"location":"games/bemani/sdvx/4_heavenlyhaven/troubleshooting/#running-the-game-windowed-and-borderless","title":"Running the Game Windowed and Borderless","text":"

Some players utilizing windowed mode use 3rd party software called Borderless Gaming in order to achieve this, follow the program's instructions accordingly.

"},{"location":"games/bemani/sdvx/4_heavenlyhaven/troubleshooting/#where-are-all-the-navigators","title":"Where Are All the Navigators?","text":"

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.

"},{"location":"games/bemani/sdvx/5_vividwave/setup/","title":"SOUND VOLTEX VIVID WAVE","text":"

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.

"},{"location":"games/bemani/sdvx/5_vividwave/setup/#getting-started","title":"Getting Started","text":"

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.

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.

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!

"},{"location":"games/bemani/sdvx/5_vividwave/setup/#configuring-your-tools","title":"Configuring Your Tools","text":"

Now that you have your files ready, open up your .bat file in your desired text editor (we're using Notepad++) 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.

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.

"},{"location":"games/bemani/sdvx/5_vividwave/setup/#configuring-for-a-local-network","title":"Configuring for a Local Network","text":"

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!
"},{"location":"games/bemani/sdvx/5_vividwave/setup/#configuring-for-an-online-network","title":"Configuring for an Online Network","text":"

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!

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.

"},{"location":"games/bemani/sdvx/5_vividwave/setup/#final-steps-and-setting-up-the-game","title":"Final Steps and Setting up the Game","text":"

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.

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!

Have any other errors?

Check out the Troubleshooting section and Error Code section to resolve any issues not seen in this guide to greater depth.

"},{"location":"games/bemani/sdvx/5_vividwave/troubleshooting/","title":"SDVX VW Troubleshooting","text":""},{"location":"games/bemani/sdvx/5_vividwave/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

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

"},{"location":"games/bemani/sdvx/5_vividwave/troubleshooting/#my-game-is-running-slowlagging","title":"My Game Is Running Slow/Lagging","text":"

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.

"},{"location":"games/bemani/sdvx/5_vividwave/troubleshooting/#my-game-is-running-crazy-fastafter-finishing-a-song-loading-is-stuck","title":"My Game Is Running Crazy Fast/After Finishing a Song Loading Is Stuck","text":"

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.

"},{"location":"games/bemani/sdvx/5_vividwave/troubleshooting/#which-offset-is-which","title":"Which Offset Is Which?","text":"

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.

"},{"location":"games/bemani/sdvx/5_vividwave/troubleshooting/#running-the-game-windowed-and-borderless","title":"Running the Game Windowed and Borderless","text":"

Some players utilizing windowed mode use 3rd party software called Borderless Gaming in order to achieve this, follow the program's instructions accordingly.

"},{"location":"games/bemani/sdvx/5_vividwave/troubleshooting/#where-are-all-the-navigators","title":"Where Are All the Navigators?","text":"

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.

"},{"location":"games/bemani/sdvx/5_vividwave/troubleshooting/#a-note-about-sse-42","title":"A Note About SSE 4.2","text":"

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. But, in the event your processor does not have this, there is a patch available to bypass this.

"},{"location":"games/bemani/sdvx/5_vividwave/troubleshooting/#when-i-run-this-game-all-other-background-audio-is-gone-whats-going-on","title":"When I Run This Game All Other Background Audio Is Gone! What's Going On?","text":"

64-bit versions of SDVX are now utilizing a feature in Windows called WASAPI exclusive mode to obtain less audio latency than the former 32-bit versions of the games which used DirectSound. You can use the Shared Mode WASAPI patch 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.

"},{"location":"games/bemani/sdvx/5_vividwave/troubleshooting/#im-not-getting-any-audiomy-audio-is-completely-wrecked-and-im-using-an-external-dac","title":"I'm Not Getting Any Audio/My Audio Is Completely Wrecked and I'm Using an External Dac!","text":"

Several external DACs have issues with WASAPI exclusive mode 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 patch.

"},{"location":"games/bemani/sdvx/6_exceedgear/extras/","title":"SOUND VOLTEX EXCEED GEAR","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/sdvx/6_exceedgear/extras/#nemsys-valkyrie-modes","title":"Nemsys & Valkyrie modes","text":"

Valkyrie mode requires a 120hz capable monitor, or to have patched your .dll with Valkyrie Mode 60hz.

To make use of the Valkyrie Mode (Subscreen, 120FPS, S-CRITICAL..) you need to go to the contents\\prop folder and edit the ea3-config.xml file.

We're interested in these lines:

    <soft>\n        <model __type=\"str\">KFC</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">G</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024052100</ext>\n    </soft>\n

This is the line that determines if the game will run in Nemsys (60 FPS) or Valkyrie (120 FPS) mode.

<spec __type=\"str\">G</spec>\n

Use:

  • F for Nemsys
  • G for Valkyrie
"},{"location":"games/bemani/sdvx/6_exceedgear/extras/#changing-the-games-language","title":"Changing the game's language","text":"

Go to the contents\\prop folder and edit the ea3-config.xml file.

We're interested in these lines:

    <soft>\n        <model __type=\"str\">KFC</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">G</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024052100</ext>\n    </soft>\n

This is the line that determines which region, and therefore which language the game will use.

<dest __type=\"str\">J</dest>\n

Use:

  • J for Japan (Japanese)
  • K for Korea (Korean + some censored jackets)
  • A for Asia/Australia (English)
  • U for America (English + some censoring in recent versions)
  • Y for Indonesia
"},{"location":"games/bemani/sdvx/6_exceedgear/extras/#more-about-ea3-configxml","title":"More about ea3-config.xml","text":"

The ea3-config.xml file is located inside the prop folder.

Below is an explanation on what different sections of this file do.

The following lines change the PCBID and HARDID that your system reports to your e-amusement server. There is no need to manually change this as spice2x will do it for us.

<pcbid __type=\"str\">00010203040506070809</pcbid>\n<hardid __type=\"str\">00010203040506070809</hardid>\n

The following line determines what version of the game you are running. You should never change this. It should always say KFC.

<model __type=\"str\">KFC</model>\n

You should never change this. It should always say A for Exceed Gear.

<rev __type=\"str\">A</rev>\n

The following line determines your datecode. Always keep it up to date with your game's current version.

<ext __type=\"str\">2024052100</ext>\n

The following line determine what remote service URL spice2x is supposed to connect to. There is no need to manually change this as spice2x will do it for us.

<services __type=\"str\">http://localhost:8083</services>\n
"},{"location":"games/bemani/sdvx/6_exceedgear/setup/","title":"SOUND VOLTEX EXCEED GEAR","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure with a few folders only, as follows.

If your data doesn't look like this

If you're missing the modules folder and instead have bunch of .dll files next to your folders:

  • Create a modules folder.
  • Move all .dll files inside of it so you end up with a structure as shown above.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

If you don't need to update your data, you can skip over to the Installing Spice2x section.

"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#updating-data","title":"Updating data","text":"Please make sure you're using the right update for your current data.

SDVX Patches re-uploaded by the community tend to be appropriately named KFC-DATECODE-to-DATECODE.

For example KFC-2024043000-to-2024052100.

  • 2024043000 being your current data's version.
  • 2024052100 being the one you would arrive at.
  • Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.
  • Open prop\\ea3-config.xml in a text editor and find the following lines near the top.
    <soft>\n        <model __type=\"str\">KFC</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">G</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024052100</ext>\n    </soft>\n

On the line with <ext __type=\"str\"> the datecode needs to match your new version.

  • If that's already the case then great! Don't touch anything.
  • If it instead corresponds to our pre-patch datecode, replace it with the new one and save the file.
"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice64.exe and spicecfg.exe files from the archive to your game's directory.

If you're using an AMD graphics card

A few more files are required to make your game work with AMD as the game was built for NVIDIA.

  • From the spice2x archive, extract the .dll files found in spice2x\\stubs\\64\\ to your data's modules folder.

"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#configuring-spice2x","title":"Configuring Spice2x","text":"

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • Game buttons: BT-A, BT-B, BT-C, BT-D, FX-L, FX-R, Start
  • P1 Keypad: Keypad 0 to 9, Keypad Insert Card

Only if you're playing using a keyboard:

  • Knobs: VOL-L Left, VOL-L Right, VOL-R Left, Vol-R Right
"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#analogs-controllercab-only","title":"Analogs (controller/cab only)","text":"

With a controller rather than binding buttons to VOL-L and VOL-R, you need to:

  • Click Bind.
  • In Device, pick your controller.
  • In Control, pick X for VOL-L or Y for VOL-R.
  • Turn your knob ensuring that the Preview knob turns along with it.
  • Click Close, leaving the rest of the settings alone.
  • Repeat for your other knob.
"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#overlay","title":"Overlay","text":"

Modifying buttons in this section is not required but you are free to change what you want.

Click on Bind then press the key you want associated with the action.

"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through spice2x.

If it does, here's how you may link different actions to your lights:

  • Click Bind.
  • In Device, pick your controller.
  • In Light Control, select the corresponding light.
  • Click Close.
  • Repeat for your other lights.
"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section.

"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#patches","title":"Patches","text":"

Go through the Spice2x Patching page to import patches.

Ever since the 2024-09-10 update, patches have a description built-in to them.

To view it, hover-over the (?) or (!) to the left of each patch's name.

To prevent issues, avoid patching things you don't need or understand.

"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#api","title":"API","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the question mark at the very left.

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Game Options SDVX Disable Cameras -sdvxdisablecams ON Network EA Service URL -url Covered in Connecting to a network

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#advanced-development","title":"Advanced & Development","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#audio","title":"Audio","text":"
  • Open spicecfg.exe.
  • At the very top, click on Shortcuts then Audio Playback Devices.
  • In the popup window, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick the 16 bit, 44100 Hz (CD Quality) option and click Apply then OK.
"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#monitor-orientation","title":"Monitor orientation","text":"

Before each play session, you will have to make sure your monitor is in Portrait or Portrait (flipped) mode.

To do so:

  • Right click on your desktop.
  • Click Display Options.
  • Look for Display orientation and set it to Portrait or Portrait (flipped).

  • Rotate your monitor vertically.
"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#valkyrie-nemsys-language-settings","title":"Valkyrie / Nemsys / Language settings","text":"

Read through the Extra Information page and edit your prop\\ea3-config.xml file if necessary.

"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run spice64.exe, press Yes when it asks for elevated privileges.

The game will go through a series of checks, let it run, if you've done everything properly they'll pass.

"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#calibration","title":"Calibration","text":"

If you're seeing this screen, it means you need to calibrate your knobs.

Press your Test key. The game will instruct you where to navigate inside the menu.

  • Press BT-A to go up.
  • Press BT-B to go down.
  • Press Start to select.

Select I/O CHECK and press Start.

Select CALIBRATION SETTINGS and press Start.

Select CALIBRATION and press Start.

First, your left knob (VOL-L for keyboard players)

  1. Slowly turn your LEFT knob counterclockwise (VOL-L Left) until the first line says COUNT = OK.
  2. Press Start.
  3. Slowly turn your LEFT knob clockwise (VOL-L Right) until the first line says COUNT = OK.
  4. Press Start.

Now same thing but for the right knob (VOL-R for keyboard players)

  1. Slowly turn your RIGHT knob counterclockwise (VOL-R Left) until the first line says COUNT = OK.
  2. Press Start.
  3. Slowly turn your RIGHT knob clockwise (VOL-R Right) until the first line says COUNT = OK.
  4. Press Start.

Select SAVE AND EXIT and press Start.

Select GAME MODE and press Start.

You're all done! The game should load up properly now.

"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#carding-in","title":"Carding in","text":"

Once the game is done loading, you need to card in.

  • Press your Keypad Insert Card button.
  • Enter your code using your keypad binds.
"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

For any more game-specific information, check out Extra Information.

"},{"location":"games/bemani/sdvx/6_exceedgear/troubleshooting/","title":"SOUND VOLTEX EXCEED GEAR","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/sdvx/6_exceedgear/troubleshooting/#im-having-performance-issues","title":"I'm having performance issues!","text":"

If you're having performance issues of some kind, spice2x's PC optimization guide is worth looking at.

"},{"location":"games/bemani/sdvx/6_exceedgear/troubleshooting/#my-game-is-running-slowfast-after-finishing-a-song-the-game-gets-stuck-loading","title":"My game is running slow/fast, After finishing a song the game gets stuck loading!","text":"

The most common reason for this is the game is running over its required refresh rate. To solve this, make sure v-sync isn't disabled in your graphics card's settings.

For NVIDIA users, enable NVIDIA profile optimization (-nvprofile) in the Options tab.

"},{"location":"games/bemani/sdvx/6_exceedgear/troubleshooting/#how-do-i-set-my-offset","title":"How do I set my offset?","text":"

Play through a chart you're comfortable with.

If you're getting too many Late, decrease your offset (-). If you're getting too many Early, increase your offset (+).

Sound Voltex Exceed Gear has two types of offset adjustments, visual and audio based, so be sure to fiddle with both to find desirable settings.

"},{"location":"games/bemani/sdvx/6_exceedgear/troubleshooting/#how-do-i-run-the-game-windowed-borderless","title":"How do I run the game windowed borderless?","text":"

Some players utilize windowed mode and use 3rd party software called Borderless Gaming in order to achieve this, follow the program's instructions accordingly.

"},{"location":"games/bemani/sdvx/6_exceedgear/troubleshooting/#where-are-all-the-navigators","title":"Where are all the navigators?","text":"

Many navigators are locked behind network requirements and they will not show unless connected to a network that has written support for the events they're typically locked behind.

"},{"location":"games/bemani/sdvx/6_exceedgear/troubleshooting/#my-game-audio-is-super-quiet","title":"My game audio is super quiet!","text":"

Press your Test key to enter its menu, go to SOUND OPTIONS and change the volume from 20 to 30.

"},{"location":"games/bemani/sdvx/6_exceedgear/troubleshooting/#when-i-run-the-game-all-other-audio-is-gone","title":"When I run the game all other audio is gone!","text":"

Sound Voltex Exceed Gear uses WASAPI exclusive mode for audio to get better audio latency. Unlike former versions of the games which used DirectSound.

You can use the Shared Mode WASAPI patch to deal with some hardware issues, it can also be used to hear audio outside the game at the cost of audio latency.

"},{"location":"games/bemani/sdvx/6_exceedgear/troubleshooting/#im-not-getting-any-audio-my-game-crashes-due-to-audio","title":"I'm not getting any audio / My game crashes due to audio","text":"

Many setups have found some difficulty with audio due to various equipment being used. Consider using the Shared Mode WASAPI patch.

"},{"location":"games/namco/taikonijiiro/setup/","title":"Taiko no Tatsujin Nijiiro","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/namco/taikonijiiro/setup/#preparing-data","title":"Preparing data","text":"

Taiko is generally distributed as a single folder. For Nijiiro, this will be SBWY 39.06. The game folder should contain an AMCUS, Data and Executable folder.

Nijiiro is a rolling release so please verify your game version by opening AMCUS\\AMConfig.ini and verifying that it says cacfg-game_ver=39.06

NAMCO data is also distributed as .VHDX and .VHD files. These files are useful for archival purposes, but are not required to run the game. Always download the unpacked data for home use.

"},{"location":"games/namco/taikonijiiro/setup/#installing-taikoarcadeloader-tal","title":"Installing TaikoArcadeLoader (TAL)","text":"

TaikoArcadeLoader:

TaikoArcadeLoader is a loader and hardware emulator for Nijiiro. It will allow us to launch the game, as well as configure inputs and network settings. More information can be found at the TAL github page.

  • Download the latest version of TAL from the actions tab of the TAL page. This will be a file named TaikoArcadeLoader. You will need to be logged into github to download this file.

  • Copy the files from TaikoArcadeLoader.zip to your Executable/Release folder. When asked, choose to replace the existing files with the newly copied files.

"},{"location":"games/namco/taikonijiiro/setup/#configuring-taikoarcadeloader","title":"Configuring TaikoArcadeLoader","text":"

The configuration information for TaikoArcadeLoader is stored within config.toml.

Open up config.toml with a text editor of your choice. We'll be using Notepad++.

config.toml is separated into several sections, indicated by the section name in [square brackets]

Information for this can be found at the TAL github page.

The [amauth] section contains network related config

  • server = can be left default if playing on a local server or offline but it is recommend to play on an online network.
  • port = do not change unless you know what you are doing.
  • chassis_id = do not change unless you know what you are doing.
  • shop_id = mostly visual. change if you want to.
  • game_ver = mostly visual. change if you want to.
  • country_code = do not change unless you know what you are doing. 
[amauth]\nserver = \"127.0.0.1\"\nport = \"54430\"\nchassis_id = \"284111080000\"\nshop_id = \"TWO-TORIAL\"\ngame_ver = \"39.06\"\ncountry_code = \"JPN\"\n

The [graphics] section contains patches

  • res = change to your display's resolution.
  • windowed = set to true if you want to run the game in windowed.
  • cursor = mostly visual. change if you want to.
  • vsync = set to true if your display is set to 120hz.
  • fpslimit = do not change unless you know what you are doing.
  • model_res_rate = do not change unless you know what you are doing.
[graphics]\nres = { x = 1920, y = 1080 }\nwindowed = false\ncursor = true\nvsync = false\n# fpslimit = 0\nmodel_res_rate = 1.0\n

The [keyboard] section contains keyboard related config

  • auto_ime = if set to true, changes your keyboard layout to Qwerty until the game is closed.
  • jp_layout = should be set to true for actual japanese keyboards.
[keyboard]\nauto_ime = false\njp_layout = false\n
"},{"location":"games/namco/taikonijiiro/setup/#configuring-inputs","title":"Configuring Inputs","text":"

Depending on the input method you choose, the configuration for them can change slightly. Below are all the input methods available and how to set them up.

Keyboard

Keyboard is the default input method.

The default layout uses:

  • DF JK for the P1 drum input
  • ZX CV for the P2 drum input
  • P to Insert Card
  • F2 to SERVICE
  • Enter to add coins

If you wish to view or change all the default keybinds, you can do so in keyconfig.toml

Controller

The setup for both drum and normal controllers is the same.

  • In config.toml set wait_period = to 0
  • If you are using a controller that does not use keyboard inputs, you need to set SDL keybinds in keyconfig.toml
  • When you're using an analog input for the drums, you need to set analog_input = false to true in config.toml

A list of valid SDL inputs can be found at the bottom of keyconfig.toml

If you're using 2 controllers, use JoyToKey and remove SDL inputs from keyconfig.toml

Physical Card Readers

You can insert your card with physical card readers. If you happen to have one, you can set them up to use them for Taiko no Tatsujin Nijiiro.

AIC Pico
  • In config.toml set card_reader = to false.
  • Update to the latest firmware
  • Inside AMFWConfig.ini change COM4 to the port of your AIC Pico
ACR122U
  • In config.toml set card_reader = to true.
  • Use AkaiiKitsune's tal-cardreader plugin

If you don't have a physical card reader, you can skip over to the Networks section

"},{"location":"games/namco/taikonijiiro/setup/#networks","title":"Networks","text":"

Please choose one of the two solutions, not both!

Online Hosted Servers (Recommended)

There are a few online hosted servers that support Nijiiro, however most of them are currently invite only. Ask your friends where they play, and maybe they'll invite you!

Elara Global Taiko Server

EGTS is the only public Nijiiro server that also comes with an Omnimix verison that includes custom songs and songs from other Taiko games.

Self Hosted Local Servers (Complex)

If you wish to run the game locally, but with the ability to create and save a profile, you can run a server on the same computer you are playing the game on. This server will need to be running before you launch the game, however it can be shut down when you are no longer playing.

Any provided setup instructions are likely to become outdated rather quickly.

Please refer to the included setup instructions on each projects respective web page.

  • TLS - A network service emulator for Nijiiro. Setup can be complex as you are required to build TLS from source using VisualStudio and .sln files.
"},{"location":"games/namco/taikonijiiro/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/namco/taikonijiiro/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/namco/taikonijiiro/setup/#first-launch","title":"First Launch","text":"

Run Taiko.exe to start the game.

Enter the I/O setup screen by pressing F1 on the Attract screen then using the arrow keys and Enter, navigate to I/O TEST -> TAIKO TEST. Adjust these settings to your liking as they vary between controllers and keyboards. If you are unsure just leave the defaults as is.

If you would like to adjust patch settings enter the test menu by pressing F1 on the Attract screen then using the arrow keys and Enter, navigate to MOD MANAGER.

You're all done! The game should load up properly now.

"},{"location":"games/namco/taikonijiiro/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting page.

"},{"location":"games/namco/taikonijiiro/troubleshooting/","title":"Taiko no Tatsujin Nijiiro Troubleshooting","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/namco/taikonijiiro/troubleshooting/#changing-the-language","title":"Changing the Language","text":"

Nijiiro supports changing the language from the test menu. The officially supported languages are:

  • Japanese (Default)
  • English
  • Chinese (zh-TW)
  • Korean

An unofficial mod allows you to change the language to Chinese (simplified), this can be found on the Discord.

Using F1, the arrow keys and Enter, navigate to OTHERS -> LANGUAGE

"},{"location":"games/namco/taikonijiiro/troubleshooting/#my-game-is-frozenblack-screen","title":"My game is frozen/black screen","text":"

You can fix this by running the game as admin. You can also try updating windows and gpu drivers.

"},{"location":"games/namco/taikonijiiro/troubleshooting/#my-game-takes-a-long-time-to-boot","title":"My game takes a long time to boot","text":"

First boot after connecting to a network will be very long (>90s)

The game files for Nijiiro consists of thousands of small .bin files and Windows Defender is known to spend a long time scanning through them during game boot up.

One way to massively speed up boot times is to add the entire game folder as a Windows Defender Exception.

Doing this will prevent Defender from scanning your game folder for viruses.

Only do this if you trust the source of your data!

  • Open Virus & threat protection.
  • Under Virus & threat protection settings click the Manage Settings button.
  • Scroll down to Exclusions and click on Add or remove exclusions.
  • Click the Add an exclusion button, select the folder option, navigate to the root of your game installation and click Select Folder.

"},{"location":"games/namco/taikonijiiro/troubleshooting/#my-game-is-running-crazy-fastslow","title":"My game is running crazy fast/slow","text":"

The game needs to be ran at 120 FPS or things will break.

If you have a display that supports 120hz or higher
  • Set your display to 120hz. You may need to make a custom resolution.
  • In config.toml set vsync = to true.
If you have a display that is less than 120hz
  • In config.toml set vsync = to false and windowed = to true.
"},{"location":"games/namco/taikonijiiro/troubleshooting/#my-game-is-not-connected-to-a-network-but-i-set-one-up","title":"My game is not connected to a network but I set one up","text":"

Disable shop close time or you won't always be able to connect to the network

Using F1 arrow keys and Enter navigate to GAME OPTIONS -> CLOCK/CLOSE TIME SETTING -> SCHEDULE TYPE.

If you are still unable to connect that means you have incorrectly configured your config.toml or your server.

"},{"location":"games/namco/taikonijiiro/troubleshooting/#my-game-is-still-too-bigsmall-after-setting-the-resolution-in-configtoml","title":"My game is still too big/small after setting the resolution in config.toml","text":"

This will happen if you incorrectly set your resolution or scale.

You can check your display resolution by right clicking your desktop and selecting Display settings.

You can set your scale to 100% right above where it says your resolution.

"},{"location":"games/namco/taikonijiiro/troubleshooting/#my-controller-is-dropping-inputs-i-cant-hit-good-drumrolls","title":"My controller is dropping inputs / I can't hit good drumrolls","text":"

This a common issue on some controllers.

In config.toml increase wait_period = by 1, then test it in-game and repeat until it feels correct.

"},{"location":"games/namco/taikonijiiro/troubleshooting/#best-settings-for-nvidia-gpus","title":"Best settings for Nvidia GPUs","text":"

This will help with latency and other issues

In NVIDIA Control Panel set the following settings for Taiko.exe.

  • Low Latency Mode Ultra
  • Power management mode Prefer maximum performance
  • Vertical sync Fast
"},{"location":"games/namco/taikonijiiro/troubleshooting/#audio","title":"Audio","text":"

By default the game will use WASAPI Shared

To use WASAPI exclusive:

  • Inside config.toml, set wasapi_shared = to false

To use ASIO in combination with FlexASIO:

  • Inside config.toml, set wasapi_shared = to false and set asio = to true.
  • Change asio_driver = to asio_driver = \"FlexASIO\"

To change FlexASIO settings refer to this.

"},{"location":"games/sega/chunithm/common/chusan/c2c/","title":"C2c","text":"

You are most likely to have success with Multiplayer when all users are using the SAME data and options, from the same sources. Verify that each person can run the game normally before attempting to network them together.

  • Chunithm expects the cabinets to be using specific IP addresses, 192.168.139.11/12/13/14
  • To achieve this over the internet, we can use SoftEther VPN. Refer to the Setting Up SoftEther VPN Guide for more information.
"},{"location":"games/sega/chunithm/common/chusan/c2c/#configuring-segatoolsini-game-assignments","title":"Configuring segatools.ini & Game Assignments","text":"

segatools.ini

[netnev]\nenable=1\naddrSuffix= last 2 digits of your SoftEther IP\n\n[keychip]\nenable=1\nsubnet=192.168.139.0\nid=(Everyone needs a seperate keychip. If you play on a remote network, chances are you already have your own keychip. If not, you can use the example keychips below.)\n;example keychips: A61E-01D02321145 ; A61E-01A30831145 ; A61E-01E38091145 ; A61E-01E46241145\n\n[system]\ndipsw1=1\n;This has changed since Luminous. Previously if you wish to perform cab-to-cab link, you need to set this to 1 on the Server machine, and 0 on all other client machines.\n;This change is no longer needed, just keep this set to 1 on all machines.\n

GAME ASSIGNMENTS

  • After saving your segatools.ini, launch the game and go into the Service Menu > and go to GAME ASSIGNMENTS.

  • Enable CABINET-TO-CABINET PLAY, and make sure all machine are on the same group (Group A for example).

  • Set one machine to STANDARD, and all other machines to FOLLOW THE STANDARD .

Exit the Service Menu and load into Attract Mode. If the game passes the Group Check then chances are you're good to go! You can now login to a credit and open a cab-to-cab link request to check if the connection is working properly!

"},{"location":"games/sega/chunithm/common/chusan/c2c/#how-to-link","title":"How to Link?","text":"

If you're new to Chunithm and have never tried link-play before and you have no idea how, keep reading.

  • Login to a credit.

  • If you're hosting a cab-to-cab session, choose a song first, then scroll to the far left and press Confirm. The cab-to-cab request is now open.

  • If you're connecting, navigate to the \"Cabinet-to-Cabinet Play\" tab and wait for other players to create a session.

If you are able to see each other's session, congrats! You can now enjoy some cab-to-cab chain action!

"},{"location":"games/sega/chunithm/common/chusan/c2c/#troubleshooting","title":"Troubleshooting","text":"

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/common/chusan/controllers/","title":"Controllers","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with IO DLLs to add support for controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\bin\\ folder and referenced in segatools.ini under the [chuniio] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; Uncomment this if you have custom chuniio implementation comprised of a single 32bit DLL.\n; (will use chu2to3 engine internally)\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.

If you have two DLLs, ending in _x86.dll and _x64.dll (or _chusan.dll and _amdaemon.dll), uncomment the path32= and path64= lines by removing the leading semicolon (;), then add your DLLs after the =:

[chuniio]\n; Uncomment both of these if you have custom chuniio implementation comprised of two DLLs.\n; x86 chuniio to path32, x64 to path64. Both are necessary.\n;(1)!\npath32=controller_x86.dll\npath64=controller_x64.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/common/chusan/controllers/#keyboard","title":"Keyboard","text":"

Keyboard is the default input method, and while not recommended for playing the game, it is useful for testing purposes.

The default layout uses SDFGHJKL for slider input, and Space Bar for the AIRs.

If you wish to change the default keybinds, an explanation on how to set these is included above the [io3] section in your segatools.ini.

"},{"location":"games/sega/chunithm/common/chusan/controllers/#brokenithm","title":"Brokenithm","text":"

Brokenithm allows you to use a mobile device as a CHUNITHM controller. It uses the bottom half of the screen as the ground slider, and sliding into the upper half activates the air sensors.

"},{"location":"games/sega/chunithm/common/chusan/controllers/#android","title":"Android","text":"

Warning

Your computer and your Android device must be on the same local network.

  • Download the latest version of Brokenithm-Android and install it on your Android device.
  • Download the latest version of Brokenithm-Android-Server and extract only brokenithm_server.exe to your App\\bin\\ folder.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run brokenithm_server.exe. A command prompt window should open, saying that it is waiting for a device on port 52468.
  • Open the Brokenithm app on your Android device. Enter your computer's IP address in the Address box on the top right, then tap Start.
  • Run the game as normal.
Getting your computer's IP address

Open Settings -> Network and Internet and select Properties. Scroll down to the bottom and check the address under the IPv4 address field:

That is your computer's IP address.

Automatically launching the Brokenithm server when starting the game

This will only work if you extracted brokenithm_server.exe to App\\bin\\ as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min brokenithm_server\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Improving latency

You can improve latency by running Brokenithm with your Android device tethered to your computer. However, this requires a little extra setup:

  • Connect your Android device to your computer with a USB cable.
  • If you haven't enabled Developer options on your device, do it by navigating to the \"About\" page in your phone's settings, then tap \"Build number\" seven times. This varies by device, so if unsure, look up the instructions for your specific one.
  • Navigate to Developer options and enable USB debugging.
  • On your computer, download and extract Android SDK Platform Tools to your App\\bin\\ folder.
  • Navigate to the App\\bin\\platform-tools folder in File Explorer, click on the address bar, type cmd, and hit Enter to open a command prompt.
  • In the command prompt, type the following command:
adb reverse tcp:52468 tcp:52468\n
  • Start brokenithm_server in TCP mode with the -T command line flag, brokenithm_server.exe -T.
  • On your Android device, open Brokenithm, and change the address to 0.0.0.0.
    • If the text box to the left of the \"SETTINGS\" button say \"UDP\", tap on it once to switch to \"TCP\" mode.
  • Tap on \"START\", and you will now be connected via the USB cable.
  • You can now start the game as normal.

The next time you play the game, you only need to run the adb reverse ... command again. To do this automatically when the game starts, add a line to the start.bat script before the brokenithm_server line:

@echo off\n\npushd %~dp0\n\nstart /min platform-tools\\adb reverse tcp:52468 tcp:52468\nstart /min brokenithm_server -T\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/common/chusan/controllers/#iosipados","title":"iOS/iPadOS","text":"
  • Install Brokenithm on your iOS/iPadOS device by joining the Brokenithm TestFlight (iOS 18 only).
    • If your iOS/iPadOS device doesn't have iOS 18, you will need to sideload a different IPA with Sideloadly.
  • If you have iTunes and/or iCloud installed from the Microsoft Store on your computer, uninstall it.
  • Install the non-Microsoft Store version of iTunes from the website.
  • Download the latest version of Brokenithm-Evolved-iOS server and extract it to App\\bin\\Brokenithm-Server.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run App\\bin\\Brokenithm-Server\\Brokenithm-Evolved-iOS.exe. A command prompt window should open, saying that it is waiting for a device.
  • On your iOS/iPadOS device, open Brokenithm, and connect it to your computer with a USB cable.
  • Run the game as normal.
Automatically launching the Brokenithm server when starting the game

This will only work if you extracted the server to App\\bin\\Brokenithm-Server as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min Brokenithm-Server\\Brokenithm-Evolved-iOS.exe\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/common/chusan/controllers/#tasoller","title":"TASOLLER","text":"

Warning

This guide only covers TASOLLERs running the v2.0 touch firmware. If you've purchased the controller after January 2022, the update should have already been applied.

If you've purchased the controller before then, you will need to update the touch firmware by following the instructions on DJ-DAO's support page.

  • Install the custom IO4 firmware to your controller.
  • Follow the segatools.ini config on the gitea page.
  • Connect the controller to your computer, and then start the game.
Legacy
  • Backup TASOLLER setup if IO4 cfw is not working.
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download TASOLLER IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_v2_x86.dll\npath64=chuniio_tasoller_v2_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/common/chusan/controllers/#tasoller-plus","title":"TASOLLER PLUS","text":"
  • Switch your TASOLLER PLUS to WINUSB mode. You can do so in TASOLLER Options found on the djdao support page.
  • Download TASOLLER PLUS IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_plus_x86.dll\npath64=chuniio_tasoller_plus_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/common/chusan/controllers/#yubideck","title":"YubiDeck","text":"
  • Switch your YubiDeck to HID output mode. Instructions on how to do so are provided in the YubiDeck manual.
  • Download the latest version of YubiDeck IO DLLs and extract it to your App\\bin folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_yubideck_chusan.dll\npath64=chuniio_yubideck_amdaemon.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/common/chusan/controllers/#laverita-3","title":"Laverita 3","text":"
  • Switch your Laverita to IO mode. You can do so in ConfigApp found in the yuancon discord.
  • Change the COM port of your controller. You can do so in Device manager by looking for USB Serial Device you may need to unplug and replug your controller to properly idetify which one is the Laverita.
  • Double click on it
  • Go to Port Settings
  • Click on Advanced
  • From the dropdown select COM1
  • Restart to ensure changes took effect and saved
  • Edit your App\\bin\\segatools.ini to disable io emulation and set led:
[led]\n; Output billboard LED strip data to a named pipe called \"\\\\.\\pipe\\chuni_led\"\ncabLedOutputPipe=0\n; Output billboard LED strip data to serial\ncabLedOutputSerial=1\n\n; Output slider LED data to the named pipe\ncontrollerLedOutputPipe=0\n; Output slider LED data to the serial port\ncontrollerLedOutputSerial=1\n; Use the OpeNITHM protocol for serial LED output\ncontrollerLedOutputOpeNITHM=0\n\n; Serial port to send data to if using serial output. Default is COM5.\nserialPort=COM1\n; Baud rate for serial data (set to 115200 if using OpeNITHM)\nserialBaud=9600\n\n[slider]\n; Enable slider emulation. If you have real AC slider, set this to 0.\n; Slider serial port must be COM1.\nenable=0\n\n[io4]\nenable=0\n
  • Then start the game.
Legacy
  • Backup Laverita 3 setup if IO4 cfw is not working.
  • Switch your Laverita to HID mode. You can do so in ConfigApp
  • Download Laverita IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_laverita_v3_x86.dll\npath64=chuniio_laverita_v3_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/common/chusan/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet slider and air sensors, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/chunithm/common/chusan/setup/","title":"Setup","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of CHUNITHM

You'll want to create a new folder for the game and start from scratch. CHUNITHM DOES NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/common/chusan/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create another empty folder named AppData next to them. It should now look like below.

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/chunithm/common/chusan/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/chunithm/common/chusan/setup/#installing-option-data","title":"Installing option data","text":"

CHUNITHM content updates are distributed through option folders instead of patching the base game. They are named A???, with each ? being a number. Custom options distributed by the community might use letters instead, to distinguish them from official ones.

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

If you plan to connect to a network (Hosted or Local), the A001 option folder for your specific game version is required. This option contains a special Event file that lets the game connect.

"},{"location":"games/sega/chunithm/common/chusan/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

CHUNITHM executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of chusanApp.exe and amdaemon.exe for your game version.

Copy chusanApp.exe and amdaemon.exe to the bin folder of your game data. Agree to overwrite when asked.

"},{"location":"games/sega/chunithm/common/chusan/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/chunithm/common/chusan/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher.

There are many patches for CHUNITHM.

We will only bring up the ones we think could be genuinely useful.

As a general rule of thumb, if you're not sure what a patch does or you're not absolutely certain you need it, leave it alone, regardless of recommendations below.

Patch Recommendation Description Force shared audio mode Either Force the game to use shared mode audio output, letting you listen to other audio sources while the game is running at the cost of audio latency. Force 2 channel audio output Either Try enabling this patch if you don't get audio output at all. Disable song select timer Either Disables the song select timer. No encryption ON Disable encrypting network requests. Required if you plan to run a local server. No TLS ON Disable checking if the server is HTTPS or not. Required if you plan to run a local server. Bypass 1080p monitor check Either Disable checking if the monitor is 1080p when enabling 120FPS. Enable if you cannot set your monitor to 1080p. Bypass 120Hz monitor check Either Disable checking if the monitor is exactly 120Hz when enabling 120FPS. Enable if you cannot set your monitor to 120Hz."},{"location":"games/sega/chunithm/common/chusan/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download segatools.zip. Do not download the source code.
  • Extracting the archive should give you a few more zip files. Find chusan.zip and extract it to the App\\bin folder in your game data.

You should now have a few more files inside the folder, as highlighted:

"},{"location":"games/sega/chunithm/common/chusan/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\bin\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[system]\ndipsw2=1\ndipsw2=1 ; WRONG!\n
"},{"location":"games/sega/chunithm/common/chusan/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

Relative Directories

The ../ in the above example represents the parent directory in a relative path. It is used to navigate up one level in the directory hierarchy.

For example, your segatools.ini is located at /App/bin/segatools.ini and your Option folder is located next to the App folder.

Since segatools.ini is in the /bin/ folder, typing ../ would move you up to the App folder. Since the Option folder is next to the App folder, the second ../ takes you to App's parent folder, which is the folder containing App, Option, etc.

The benefits of using this method include:

  • Avoiding issues that arise when folders have spaces in their names.

  • Being able to move your game folder without redefining the locations of your VFS folders.

  • A cleaner and easier to read segatools.ini, making spotting issues simpler.

"},{"location":"games/sega/chunithm/common/chusan/setup/#system","title":"[system]","text":"
  • If you have a 120Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n
"},{"location":"games/sega/chunithm/common/chusan/setup/#gfx","title":"[gfx]","text":"
  • Set windowed to 0 to run in fullscreen mode and 1 to run in windowed mode.
  • If you have multiple monitors and you're running in fullscreen mode (windowed=0), set monitor to the index of the monitor you want to run the game on.
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number minus one. For example, monitor 2 means monitor index 1.

"},{"location":"games/sega/chunithm/common/chusan/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.139.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\bin\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/common/chusan/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/chunithm/common/chusan/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/common/chusan/setup/#audio","title":"Audio","text":"
  • Right-click on the volume setting in your taskbar and select Sounds.
  • Navigate to the Playback tab, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick either 16 bit, 48000Hz (DVD Quality) or 24 bit, 48000Hz (Studio Quality), click Apply, then OK.
"},{"location":"games/sega/chunithm/common/chusan/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/chunithm/common/chusan/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/chunithm/common/chusan/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\bin\\start.bat. Let the game load until it reaches the screen below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 4th option).

Select \u30b0\u30eb\u30fc\u30d7\u5185\u57fa\u6e96\u6a5f\u8a2d\u5b9a (SET STANDARD IN GROUP, the second option) and toggle this setting to \u57fa\u6e96\u6a5f (STANDARD).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/chunithm/common/chusan/setup/#close-setting","title":"CLOSE SETTING","text":"

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the 10th option).

Navigate to \u6642 (HOUR, the 2nd option) and use the Service button to toggle the setting until it says \u5168\u6642\u523b (ALL TIME).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu, then select \u7d42\u4e86 (also the last option) in the main menu to exit the service menu.

"},{"location":"games/sega/chunithm/common/chusan/setup/#waiting-for-distribution-server","title":"Waiting for Distribution Server","text":"

If you're stuck at the Waiting for Distribution Server screen below, close the game and relaunch.

You're all done! The game should load up properly now.

You can add coins using the Coin key (default F3) and card in by holding the Enter key.

"},{"location":"games/sega/chunithm/common/chusan/setup/#further-configuration","title":"Further configuration","text":"

Input methods and controllers are covered in the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/common/chusan/troubleshooting/","title":"Troubleshooting","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/chunithm/common/chusan/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch!","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120Hz, apply the \"Bypass 120Hz monitor check\"/\"Bypass 1080p monitor check\" on a CHUNITHM web patcher (see Resources).
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\nping 127.0.0.1 -n 31 > nul && taskkill /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/chunithm/common/chusan/troubleshooting/#my-game-takes-a-long-time-to-boot","title":"My game takes a long time to boot!","text":"

CHUNITHM game files consist of thousands of small XML files, which Windows Defender takes a long time to scan through. Add your game folder to the Windows Defender exclusion list.

Danger

Doing this will prevent Windows Defender from scanning your game folder for viruses. Only do this if you trust the source of the data.

"},{"location":"games/sega/chunithm/common/chusan/troubleshooting/#my-game-is-running-too-slowfast","title":"My game is running too slow/fast","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Make sure your monitor's refresh rate is set to 60Hz or 120Hz.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/common/chusan/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chusanApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/common/chusan/troubleshooting/#my-game-crashes-when-i-tab-out-of-fullscreen","title":"My game crashes when I tab out of fullscreen!","text":"

As the game is intended to run on arcade hardware, it doesn't like being minimized.

One workaround for this is to use DXVK. Download the latest version from releases. This will be a dxvk-x.y.z.tar.gz file, which you can open using 7zip. Navigate to the x32 folder, and copy the d3d9.dll file to your game's App\\bin folder, agreeing to overwrite when asked.

You should now be able to tab out of fullscreen without crashing the game.

Warning

The game will not ignore inputs when out of focus.

This means any controller inputs will still be accepted, so try not to lean onto your slider whilst tabbed out!

This also means that you can accidentally enter the service menu by hitting your Test key even if the game is minimised. If you were in the middle of a credit, your scores will be lost.

"},{"location":"games/sega/chunithm/common/chusan/troubleshooting/#when-i-run-the-game-all-other-audio-is-gone","title":"When I run the game all other audio is gone!","text":"

CHUNITHM uses WASAPI exclusive mode for audio to get better latency.

You can apply the \"Shared Audio\" patch on a CHUNITHM web patcher (see Resources) to hear audio outside of the game at the cost of audio latency.

"},{"location":"games/sega/chunithm/common/chusan/troubleshooting/#cabinet-to-cabinetc2c-fixes","title":"Cabinet-to-Cabinet(c2c) Fixes","text":"

c2c can have many problems but you can fix most of them by applying the \"Patch for head-to-head play\" and disabling \"Set all timers to 999\" on a CHUNITHM web patcher (see Resources).

If the above does not work then please ensure both machines have the exact same data and can communicate with each other if they cannot then you can try disabling firewalls or changing the c2c group.

If clicking the c2c button does nothing, you can fix it by resetting the network settings in Windows.

"},{"location":"games/sega/chunithm/luminous/c2c/","title":"Cab-to-Cab Play over Internet (LUMINOUS)","text":"

You are most likely to have success with Multiplayer when all users are using the SAME data and options, from the same sources. Verify that each person can run the game normally before attempting to network them together.

  • Chunithm expects the cabinets to be using specific IP addresses, 192.168.139.11/12/13/14
  • To achieve this over the internet, we can use SoftEther VPN. Refer to the Setting Up SoftEther VPN Guide for more information.
"},{"location":"games/sega/chunithm/luminous/c2c/#configuring-segatoolsini-game-assignments","title":"Configuring segatools.ini & Game Assignments","text":"

segatools.ini

[netnev]\nenable=1\naddrSuffix= last 2 digits of your SoftEther IP\n\n[keychip]\nenable=1\nsubnet=192.168.139.0\nid=(Everyone needs a seperate keychip. If you play on a remote network, chances are you already have your own keychip. If not, you can use the example keychips below.)\n;example keychips: A61E-01D02321145 ; A61E-01A30831145 ; A61E-01E38091145 ; A61E-01E46241145\n\n[system]\ndipsw1=1\n;This has changed since Luminous. Previously if you wish to perform cab-to-cab link, you need to set this to 1 on the Server machine, and 0 on all other client machines.\n;This change is no longer needed, just keep this set to 1 on all machines.\n

GAME ASSIGNMENTS

  • After saving your segatools.ini, launch the game and go into the Service Menu > and go to GAME ASSIGNMENTS.

  • Enable CABINET-TO-CABINET PLAY, and make sure all machine are on the same group (Group A for example).

  • Set one machine to STANDARD, and all other machines to FOLLOW THE STANDARD .

Exit the Service Menu and load into Attract Mode. If the game passes the Group Check then chances are you're good to go! You can now login to a credit and open a cab-to-cab link request to check if the connection is working properly!

"},{"location":"games/sega/chunithm/luminous/c2c/#how-to-link","title":"How to Link?","text":"

If you're new to Chunithm and have never tried link-play before and you have no idea how, keep reading.

  • Login to a credit.

  • If you're hosting a cab-to-cab session, choose a song first, then scroll to the far left and press Confirm. The cab-to-cab request is now open.

  • If you're connecting, navigate to the \"Cabinet-to-Cabinet Play\" tab and wait for other players to create a session.

If you are able to see each other's session, congrats! You can now enjoy some cab-to-cab chain action!

"},{"location":"games/sega/chunithm/luminous/c2c/#troubleshooting","title":"Troubleshooting","text":"

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/luminous/controllers/","title":"Controllers (LUMINOUS)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with IO DLLs to add support for controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\bin\\ folder and referenced in segatools.ini under the [chuniio] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; Uncomment this if you have custom chuniio implementation comprised of a single 32bit DLL.\n; (will use chu2to3 engine internally)\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.

If you have two DLLs, ending in _x86.dll and _x64.dll (or _chusan.dll and _amdaemon.dll), uncomment the path32= and path64= lines by removing the leading semicolon (;), then add your DLLs after the =:

[chuniio]\n; Uncomment both of these if you have custom chuniio implementation comprised of two DLLs.\n; x86 chuniio to path32, x64 to path64. Both are necessary.\n;(1)!\npath32=controller_x86.dll\npath64=controller_x64.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/luminous/controllers/#keyboard","title":"Keyboard","text":"

Keyboard is the default input method, and while not recommended for playing the game, it is useful for testing purposes.

The default layout uses SDFGHJKL for slider input, and Space Bar for the AIRs.

If you wish to change the default keybinds, an explanation on how to set these is included above the [io3] section in your segatools.ini.

"},{"location":"games/sega/chunithm/luminous/controllers/#brokenithm","title":"Brokenithm","text":"

Brokenithm allows you to use a mobile device as a CHUNITHM controller. It uses the bottom half of the screen as the ground slider, and sliding into the upper half activates the air sensors.

"},{"location":"games/sega/chunithm/luminous/controllers/#android","title":"Android","text":"

Warning

Your computer and your Android device must be on the same local network.

  • Download the latest version of Brokenithm-Android and install it on your Android device.
  • Download the latest version of Brokenithm-Android-Server and extract only brokenithm_server.exe to your App\\bin\\ folder.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run brokenithm_server.exe. A command prompt window should open, saying that it is waiting for a device on port 52468.
  • Open the Brokenithm app on your Android device. Enter your computer's IP address in the Address box on the top right, then tap Start.
  • Run the game as normal.
Getting your computer's IP address

Open Settings -> Network and Internet and select Properties. Scroll down to the bottom and check the address under the IPv4 address field:

That is your computer's IP address.

Automatically launching the Brokenithm server when starting the game

This will only work if you extracted brokenithm_server.exe to App\\bin\\ as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min brokenithm_server\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Improving latency

You can improve latency by running Brokenithm with your Android device tethered to your computer. However, this requires a little extra setup:

  • Connect your Android device to your computer with a USB cable.
  • If you haven't enabled Developer options on your device, do it by navigating to the \"About\" page in your phone's settings, then tap \"Build number\" seven times. This varies by device, so if unsure, look up the instructions for your specific one.
  • Navigate to Developer options and enable USB debugging.
  • On your computer, download and extract Android SDK Platform Tools to your App\\bin\\ folder.
  • Navigate to the App\\bin\\platform-tools folder in File Explorer, click on the address bar, type cmd, and hit Enter to open a command prompt.
  • In the command prompt, type the following command:
adb reverse tcp:52468 tcp:52468\n
  • Start brokenithm_server in TCP mode with the -T command line flag, brokenithm_server.exe -T.
  • On your Android device, open Brokenithm, and change the address to 0.0.0.0.
    • If the text box to the left of the \"SETTINGS\" button say \"UDP\", tap on it once to switch to \"TCP\" mode.
  • Tap on \"START\", and you will now be connected via the USB cable.
  • You can now start the game as normal.

The next time you play the game, you only need to run the adb reverse ... command again. To do this automatically when the game starts, add a line to the start.bat script before the brokenithm_server line:

@echo off\n\npushd %~dp0\n\nstart /min platform-tools\\adb reverse tcp:52468 tcp:52468\nstart /min brokenithm_server -T\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/luminous/controllers/#iosipados","title":"iOS/iPadOS","text":"
  • Install Brokenithm on your iOS/iPadOS device by joining the Brokenithm TestFlight (iOS 18 only).
    • If your iOS/iPadOS device doesn't have iOS 18, you will need to sideload a different IPA with Sideloadly.
  • If you have iTunes and/or iCloud installed from the Microsoft Store on your computer, uninstall it.
  • Install the non-Microsoft Store version of iTunes from the website.
  • Download the latest version of Brokenithm-Evolved-iOS server and extract it to App\\bin\\Brokenithm-Server.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run App\\bin\\Brokenithm-Server\\Brokenithm-Evolved-iOS.exe. A command prompt window should open, saying that it is waiting for a device.
  • On your iOS/iPadOS device, open Brokenithm, and connect it to your computer with a USB cable.
  • Run the game as normal.
Automatically launching the Brokenithm server when starting the game

This will only work if you extracted the server to App\\bin\\Brokenithm-Server as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min Brokenithm-Server\\Brokenithm-Evolved-iOS.exe\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/luminous/controllers/#tasoller","title":"TASOLLER","text":"

Warning

This guide only covers TASOLLERs running the v2.0 touch firmware. If you've purchased the controller after January 2022, the update should have already been applied.

If you've purchased the controller before then, you will need to update the touch firmware by following the instructions on DJ-DAO's support page.

  • Install the custom IO4 firmware to your controller.
  • Follow the segatools.ini config on the gitea page.
  • Connect the controller to your computer, and then start the game.
Legacy
  • Backup TASOLLER setup if IO4 cfw is not working.
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download TASOLLER IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_v2_x86.dll\npath64=chuniio_tasoller_v2_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/luminous/controllers/#tasoller-plus","title":"TASOLLER PLUS","text":"
  • Switch your TASOLLER PLUS to WINUSB mode. You can do so in TASOLLER Options found on the djdao support page.
  • Download TASOLLER PLUS IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_plus_x86.dll\npath64=chuniio_tasoller_plus_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/luminous/controllers/#yubideck","title":"YubiDeck","text":"
  • Switch your YubiDeck to HID output mode. Instructions on how to do so are provided in the YubiDeck manual.
  • Download the latest version of YubiDeck IO DLLs and extract it to your App\\bin folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_yubideck_chusan.dll\npath64=chuniio_yubideck_amdaemon.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/luminous/controllers/#laverita-3","title":"Laverita 3","text":"
  • Switch your Laverita to IO mode. You can do so in ConfigApp found in the yuancon discord.
  • Change the COM port of your controller. You can do so in Device manager by looking for USB Serial Device you may need to unplug and replug your controller to properly idetify which one is the Laverita.
  • Double click on it
  • Go to Port Settings
  • Click on Advanced
  • From the dropdown select COM1
  • Restart to ensure changes took effect and saved
  • Edit your App\\bin\\segatools.ini to disable io emulation and set led:
[led]\n; Output billboard LED strip data to a named pipe called \"\\\\.\\pipe\\chuni_led\"\ncabLedOutputPipe=0\n; Output billboard LED strip data to serial\ncabLedOutputSerial=1\n\n; Output slider LED data to the named pipe\ncontrollerLedOutputPipe=0\n; Output slider LED data to the serial port\ncontrollerLedOutputSerial=1\n; Use the OpeNITHM protocol for serial LED output\ncontrollerLedOutputOpeNITHM=0\n\n; Serial port to send data to if using serial output. Default is COM5.\nserialPort=COM1\n; Baud rate for serial data (set to 115200 if using OpeNITHM)\nserialBaud=9600\n\n[slider]\n; Enable slider emulation. If you have real AC slider, set this to 0.\n; Slider serial port must be COM1.\nenable=0\n\n[io4]\nenable=0\n
  • Then start the game.
Legacy
  • Backup Laverita 3 setup if IO4 cfw is not working.
  • Switch your Laverita to HID mode. You can do so in ConfigApp
  • Download Laverita IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_laverita_v3_x86.dll\npath64=chuniio_laverita_v3_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/luminous/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet slider and air sensors, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/chunithm/luminous/setup/","title":"Game Setup (LUMINOUS)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of CHUNITHM

You'll want to create a new folder for the game and start from scratch. CHUNITHM DOES NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/luminous/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create another empty folder named AppData next to them. It should now look like below.

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/chunithm/luminous/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/chunithm/luminous/setup/#installing-option-data","title":"Installing option data","text":"

CHUNITHM content updates are distributed through option folders instead of patching the base game. They are named A???, with each ? being a number. Custom options distributed by the community might use letters instead, to distinguish them from official ones.

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

If you plan to connect to a network (Hosted or Local), the A001 option folder for your specific game version is required. This option contains a special Event file that lets the game connect.

"},{"location":"games/sega/chunithm/luminous/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

CHUNITHM executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of chusanApp.exe and amdaemon.exe for your game version.

Copy chusanApp.exe and amdaemon.exe to the bin folder of your game data. Agree to overwrite when asked.

"},{"location":"games/sega/chunithm/luminous/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/chunithm/luminous/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher.

There are many patches for CHUNITHM.

We will only bring up the ones we think could be genuinely useful.

As a general rule of thumb, if you're not sure what a patch does or you're not absolutely certain you need it, leave it alone, regardless of recommendations below.

Patch Recommendation Description Force shared audio mode Either Force the game to use shared mode audio output, letting you listen to other audio sources while the game is running at the cost of audio latency. Force 2 channel audio output Either Try enabling this patch if you don't get audio output at all. Disable song select timer Either Disables the song select timer. No encryption ON Disable encrypting network requests. Required if you plan to run a local server. No TLS ON Disable checking if the server is HTTPS or not. Required if you plan to run a local server. Bypass 1080p monitor check Either Disable checking if the monitor is 1080p when enabling 120FPS. Enable if you cannot set your monitor to 1080p. Bypass 120Hz monitor check Either Disable checking if the monitor is exactly 120Hz when enabling 120FPS. Enable if you cannot set your monitor to 120Hz."},{"location":"games/sega/chunithm/luminous/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download segatools.zip. Do not download the source code.
  • Extracting the archive should give you a few more zip files. Find chusan.zip and extract it to the App\\bin folder in your game data.

You should now have a few more files inside the folder, as highlighted:

"},{"location":"games/sega/chunithm/luminous/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\bin\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[system]\ndipsw2=1\ndipsw2=1 ; WRONG!\n
"},{"location":"games/sega/chunithm/luminous/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

Relative Directories

The ../ in the above example represents the parent directory in a relative path. It is used to navigate up one level in the directory hierarchy.

For example, your segatools.ini is located at /App/bin/segatools.ini and your Option folder is located next to the App folder.

Since segatools.ini is in the /bin/ folder, typing ../ would move you up to the App folder. Since the Option folder is next to the App folder, the second ../ takes you to App's parent folder, which is the folder containing App, Option, etc.

The benefits of using this method include:

  • Avoiding issues that arise when folders have spaces in their names.

  • Being able to move your game folder without redefining the locations of your VFS folders.

  • A cleaner and easier to read segatools.ini, making spotting issues simpler.

"},{"location":"games/sega/chunithm/luminous/setup/#system","title":"[system]","text":"
  • If you have a 120Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n
"},{"location":"games/sega/chunithm/luminous/setup/#gfx","title":"[gfx]","text":"
  • Set windowed to 0 to run in fullscreen mode and 1 to run in windowed mode.
  • If you have multiple monitors and you're running in fullscreen mode (windowed=0), set monitor to the index of the monitor you want to run the game on.
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number minus one. For example, monitor 2 means monitor index 1.

"},{"location":"games/sega/chunithm/luminous/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.139.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\bin\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/luminous/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/chunithm/luminous/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/luminous/setup/#audio","title":"Audio","text":"
  • Right-click on the volume setting in your taskbar and select Sounds.
  • Navigate to the Playback tab, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick either 16 bit, 48000Hz (DVD Quality) or 24 bit, 48000Hz (Studio Quality), click Apply, then OK.
"},{"location":"games/sega/chunithm/luminous/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/chunithm/luminous/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/chunithm/luminous/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\bin\\start.bat. Let the game load until it reaches the screen below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 4th option).

Select \u30b0\u30eb\u30fc\u30d7\u5185\u57fa\u6e96\u6a5f\u8a2d\u5b9a (SET STANDARD IN GROUP, the second option) and toggle this setting to \u57fa\u6e96\u6a5f (STANDARD).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/chunithm/luminous/setup/#close-setting","title":"CLOSE SETTING","text":"

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the 10th option).

Navigate to \u6642 (HOUR, the 2nd option) and use the Service button to toggle the setting until it says \u5168\u6642\u523b (ALL TIME).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu, then select \u7d42\u4e86 (also the last option) in the main menu to exit the service menu.

"},{"location":"games/sega/chunithm/luminous/setup/#waiting-for-distribution-server","title":"Waiting for Distribution Server","text":"

If you're stuck at the Waiting for Distribution Server screen below, close the game and relaunch.

You're all done! The game should load up properly now.

You can add coins using the Coin key (default F3) and card in by holding the Enter key.

"},{"location":"games/sega/chunithm/luminous/setup/#further-configuration","title":"Further configuration","text":"

Input methods and controllers are covered in the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/luminous/troubleshooting/","title":"Troubleshooting (LUMINOUS)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/chunithm/luminous/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch!","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120Hz, apply the \"Bypass 120Hz monitor check\"/\"Bypass 1080p monitor check\" on a CHUNITHM web patcher (see Resources).
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\nping 127.0.0.1 -n 31 > nul && taskkill /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/chunithm/luminous/troubleshooting/#my-game-takes-a-long-time-to-boot","title":"My game takes a long time to boot!","text":"

CHUNITHM game files consist of thousands of small XML files, which Windows Defender takes a long time to scan through. Add your game folder to the Windows Defender exclusion list.

Danger

Doing this will prevent Windows Defender from scanning your game folder for viruses. Only do this if you trust the source of the data.

"},{"location":"games/sega/chunithm/luminous/troubleshooting/#my-game-is-running-too-slowfast","title":"My game is running too slow/fast","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Make sure your monitor's refresh rate is set to 60Hz or 120Hz.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/luminous/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chusanApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/luminous/troubleshooting/#my-game-crashes-when-i-tab-out-of-fullscreen","title":"My game crashes when I tab out of fullscreen!","text":"

As the game is intended to run on arcade hardware, it doesn't like being minimized.

One workaround for this is to use DXVK. Download the latest version from releases. This will be a dxvk-x.y.z.tar.gz file, which you can open using 7zip. Navigate to the x32 folder, and copy the d3d9.dll file to your game's App\\bin folder, agreeing to overwrite when asked.

You should now be able to tab out of fullscreen without crashing the game.

Warning

The game will not ignore inputs when out of focus.

This means any controller inputs will still be accepted, so try not to lean onto your slider whilst tabbed out!

This also means that you can accidentally enter the service menu by hitting your Test key even if the game is minimised. If you were in the middle of a credit, your scores will be lost.

"},{"location":"games/sega/chunithm/luminous/troubleshooting/#when-i-run-the-game-all-other-audio-is-gone","title":"When I run the game all other audio is gone!","text":"

CHUNITHM uses WASAPI exclusive mode for audio to get better latency.

You can apply the \"Shared Audio\" patch on a CHUNITHM web patcher (see Resources) to hear audio outside of the game at the cost of audio latency.

"},{"location":"games/sega/chunithm/luminous/troubleshooting/#cabinet-to-cabinetc2c-fixes","title":"Cabinet-to-Cabinet(c2c) Fixes","text":"

c2c can have many problems but you can fix most of them by applying the \"Patch for head-to-head play\" and disabling \"Set all timers to 999\" on a CHUNITHM web patcher (see Resources).

If the above does not work then please ensure both machines have the exact same data and can communicate with each other if they cannot then you can try disabling firewalls or changing the c2c group.

If clicking the c2c button does nothing, you can fix it by resetting the network settings in Windows.

"},{"location":"games/sega/chunithm/luminousplus/c2c/","title":"Cab-to-Cab Play over Internet (LUMINOUS PLUS)","text":"

You are most likely to have success with Multiplayer when all users are using the SAME data and options, from the same sources. Verify that each person can run the game normally before attempting to network them together.

  • Chunithm expects the cabinets to be using specific IP addresses, 192.168.139.11/12/13/14
  • To achieve this over the internet, we can use SoftEther VPN. Refer to the Setting Up SoftEther VPN Guide for more information.
"},{"location":"games/sega/chunithm/luminousplus/c2c/#configuring-segatoolsini-game-assignments","title":"Configuring segatools.ini & Game Assignments","text":"

segatools.ini

[netnev]\nenable=1\naddrSuffix= last 2 digits of your SoftEther IP\n\n[keychip]\nenable=1\nsubnet=192.168.139.0\nid=(Everyone needs a seperate keychip. If you play on a remote network, chances are you already have your own keychip. If not, you can use the example keychips below.)\n;example keychips: A61E-01D02321145 ; A61E-01A30831145 ; A61E-01E38091145 ; A61E-01E46241145\n\n[system]\ndipsw1=1\n;This has changed since Luminous. Previously if you wish to perform cab-to-cab link, you need to set this to 1 on the Server machine, and 0 on all other client machines.\n;This change is no longer needed, just keep this set to 1 on all machines.\n

GAME ASSIGNMENTS

  • After saving your segatools.ini, launch the game and go into the Service Menu > and go to GAME ASSIGNMENTS.

  • Enable CABINET-TO-CABINET PLAY, and make sure all machine are on the same group (Group A for example).

  • Set one machine to STANDARD, and all other machines to FOLLOW THE STANDARD .

Exit the Service Menu and load into Attract Mode. If the game passes the Group Check then chances are you're good to go! You can now login to a credit and open a cab-to-cab link request to check if the connection is working properly!

"},{"location":"games/sega/chunithm/luminousplus/c2c/#how-to-link","title":"How to Link?","text":"

If you're new to Chunithm and have never tried link-play before and you have no idea how, keep reading.

  • Login to a credit.

  • If you're hosting a cab-to-cab session, choose a song first, then scroll to the far left and press Confirm. The cab-to-cab request is now open.

  • If you're connecting, navigate to the \"Cabinet-to-Cabinet Play\" tab and wait for other players to create a session.

If you are able to see each other's session, congrats! You can now enjoy some cab-to-cab chain action!

"},{"location":"games/sega/chunithm/luminousplus/c2c/#troubleshooting","title":"Troubleshooting","text":"

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/luminousplus/controllers/","title":"Controllers (LUMINOUS PLUS)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with IO DLLs to add support for controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\bin\\ folder and referenced in segatools.ini under the [chuniio] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; Uncomment this if you have custom chuniio implementation comprised of a single 32bit DLL.\n; (will use chu2to3 engine internally)\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.

If you have two DLLs, ending in _x86.dll and _x64.dll (or _chusan.dll and _amdaemon.dll), uncomment the path32= and path64= lines by removing the leading semicolon (;), then add your DLLs after the =:

[chuniio]\n; Uncomment both of these if you have custom chuniio implementation comprised of two DLLs.\n; x86 chuniio to path32, x64 to path64. Both are necessary.\n;(1)!\npath32=controller_x86.dll\npath64=controller_x64.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/luminousplus/controllers/#keyboard","title":"Keyboard","text":"

Keyboard is the default input method, and while not recommended for playing the game, it is useful for testing purposes.

The default layout uses SDFGHJKL for slider input, and Space Bar for the AIRs.

If you wish to change the default keybinds, an explanation on how to set these is included above the [io3] section in your segatools.ini.

"},{"location":"games/sega/chunithm/luminousplus/controllers/#brokenithm","title":"Brokenithm","text":"

Brokenithm allows you to use a mobile device as a CHUNITHM controller. It uses the bottom half of the screen as the ground slider, and sliding into the upper half activates the air sensors.

"},{"location":"games/sega/chunithm/luminousplus/controllers/#android","title":"Android","text":"

Warning

Your computer and your Android device must be on the same local network.

  • Download the latest version of Brokenithm-Android and install it on your Android device.
  • Download the latest version of Brokenithm-Android-Server and extract only brokenithm_server.exe to your App\\bin\\ folder.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run brokenithm_server.exe. A command prompt window should open, saying that it is waiting for a device on port 52468.
  • Open the Brokenithm app on your Android device. Enter your computer's IP address in the Address box on the top right, then tap Start.
  • Run the game as normal.
Getting your computer's IP address

Open Settings -> Network and Internet and select Properties. Scroll down to the bottom and check the address under the IPv4 address field:

That is your computer's IP address.

Automatically launching the Brokenithm server when starting the game

This will only work if you extracted brokenithm_server.exe to App\\bin\\ as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min brokenithm_server\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Improving latency

You can improve latency by running Brokenithm with your Android device tethered to your computer. However, this requires a little extra setup:

  • Connect your Android device to your computer with a USB cable.
  • If you haven't enabled Developer options on your device, do it by navigating to the \"About\" page in your phone's settings, then tap \"Build number\" seven times. This varies by device, so if unsure, look up the instructions for your specific one.
  • Navigate to Developer options and enable USB debugging.
  • On your computer, download and extract Android SDK Platform Tools to your App\\bin\\ folder.
  • Navigate to the App\\bin\\platform-tools folder in File Explorer, click on the address bar, type cmd, and hit Enter to open a command prompt.
  • In the command prompt, type the following command:
adb reverse tcp:52468 tcp:52468\n
  • Start brokenithm_server in TCP mode with the -T command line flag, brokenithm_server.exe -T.
  • On your Android device, open Brokenithm, and change the address to 0.0.0.0.
    • If the text box to the left of the \"SETTINGS\" button say \"UDP\", tap on it once to switch to \"TCP\" mode.
  • Tap on \"START\", and you will now be connected via the USB cable.
  • You can now start the game as normal.

The next time you play the game, you only need to run the adb reverse ... command again. To do this automatically when the game starts, add a line to the start.bat script before the brokenithm_server line:

@echo off\n\npushd %~dp0\n\nstart /min platform-tools\\adb reverse tcp:52468 tcp:52468\nstart /min brokenithm_server -T\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/luminousplus/controllers/#iosipados","title":"iOS/iPadOS","text":"
  • Install Brokenithm on your iOS/iPadOS device by joining the Brokenithm TestFlight (iOS 18 only).
    • If your iOS/iPadOS device doesn't have iOS 18, you will need to sideload a different IPA with Sideloadly.
  • If you have iTunes and/or iCloud installed from the Microsoft Store on your computer, uninstall it.
  • Install the non-Microsoft Store version of iTunes from the website.
  • Download the latest version of Brokenithm-Evolved-iOS server and extract it to App\\bin\\Brokenithm-Server.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run App\\bin\\Brokenithm-Server\\Brokenithm-Evolved-iOS.exe. A command prompt window should open, saying that it is waiting for a device.
  • On your iOS/iPadOS device, open Brokenithm, and connect it to your computer with a USB cable.
  • Run the game as normal.
Automatically launching the Brokenithm server when starting the game

This will only work if you extracted the server to App\\bin\\Brokenithm-Server as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min Brokenithm-Server\\Brokenithm-Evolved-iOS.exe\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/luminousplus/controllers/#tasoller","title":"TASOLLER","text":"

Warning

This guide only covers TASOLLERs running the v2.0 touch firmware. If you've purchased the controller after January 2022, the update should have already been applied.

If you've purchased the controller before then, you will need to update the touch firmware by following the instructions on DJ-DAO's support page.

  • Install the custom IO4 firmware to your controller.
  • Follow the segatools.ini config on the gitea page.
  • Connect the controller to your computer, and then start the game.
Legacy
  • Backup TASOLLER setup if IO4 cfw is not working.
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download TASOLLER IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_v2_x86.dll\npath64=chuniio_tasoller_v2_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/luminousplus/controllers/#tasoller-plus","title":"TASOLLER PLUS","text":"
  • Switch your TASOLLER PLUS to WINUSB mode. You can do so in TASOLLER Options found on the djdao support page.
  • Download TASOLLER PLUS IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_plus_x86.dll\npath64=chuniio_tasoller_plus_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/luminousplus/controllers/#yubideck","title":"YubiDeck","text":"
  • Switch your YubiDeck to HID output mode. Instructions on how to do so are provided in the YubiDeck manual.
  • Download the latest version of YubiDeck IO DLLs and extract it to your App\\bin folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_yubideck_chusan.dll\npath64=chuniio_yubideck_amdaemon.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/luminousplus/controllers/#laverita-3","title":"Laverita 3","text":"
  • Switch your Laverita to IO mode. You can do so in ConfigApp found in the yuancon discord.
  • Change the COM port of your controller. You can do so in Device manager by looking for USB Serial Device you may need to unplug and replug your controller to properly idetify which one is the Laverita.
  • Double click on it
  • Go to Port Settings
  • Click on Advanced
  • From the dropdown select COM1
  • Restart to ensure changes took effect and saved
  • Edit your App\\bin\\segatools.ini to disable io emulation and set led:
[led]\n; Output billboard LED strip data to a named pipe called \"\\\\.\\pipe\\chuni_led\"\ncabLedOutputPipe=0\n; Output billboard LED strip data to serial\ncabLedOutputSerial=1\n\n; Output slider LED data to the named pipe\ncontrollerLedOutputPipe=0\n; Output slider LED data to the serial port\ncontrollerLedOutputSerial=1\n; Use the OpeNITHM protocol for serial LED output\ncontrollerLedOutputOpeNITHM=0\n\n; Serial port to send data to if using serial output. Default is COM5.\nserialPort=COM1\n; Baud rate for serial data (set to 115200 if using OpeNITHM)\nserialBaud=9600\n\n[slider]\n; Enable slider emulation. If you have real AC slider, set this to 0.\n; Slider serial port must be COM1.\nenable=0\n\n[io4]\nenable=0\n
  • Then start the game.
Legacy
  • Backup Laverita 3 setup if IO4 cfw is not working.
  • Switch your Laverita to HID mode. You can do so in ConfigApp
  • Download Laverita IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_laverita_v3_x86.dll\npath64=chuniio_laverita_v3_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/luminousplus/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet slider and air sensors, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/chunithm/luminousplus/setup/","title":"Game Setup (LUMINOUS PLUS)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of CHUNITHM

You'll want to create a new folder for the game and start from scratch. CHUNITHM DOES NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/luminousplus/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create another empty folder named AppData next to them. It should now look like below.

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/chunithm/luminousplus/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/chunithm/luminousplus/setup/#installing-option-data","title":"Installing option data","text":"

CHUNITHM content updates are distributed through option folders instead of patching the base game. They are named A???, with each ? being a number. Custom options distributed by the community might use letters instead, to distinguish them from official ones.

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

If you plan to connect to a network (Hosted or Local), the A001 option folder for your specific game version is required. This option contains a special Event file that lets the game connect.

"},{"location":"games/sega/chunithm/luminousplus/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

CHUNITHM executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of chusanApp.exe and amdaemon.exe for your game version.

Copy chusanApp.exe and amdaemon.exe to the bin folder of your game data. Agree to overwrite when asked.

"},{"location":"games/sega/chunithm/luminousplus/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/chunithm/luminousplus/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher.

There are many patches for CHUNITHM.

We will only bring up the ones we think could be genuinely useful.

As a general rule of thumb, if you're not sure what a patch does or you're not absolutely certain you need it, leave it alone, regardless of recommendations below.

Patch Recommendation Description Force shared audio mode Either Force the game to use shared mode audio output, letting you listen to other audio sources while the game is running at the cost of audio latency. Force 2 channel audio output Either Try enabling this patch if you don't get audio output at all. Disable song select timer Either Disables the song select timer. No encryption ON Disable encrypting network requests. Required if you plan to run a local server. No TLS ON Disable checking if the server is HTTPS or not. Required if you plan to run a local server. Bypass 1080p monitor check Either Disable checking if the monitor is 1080p when enabling 120FPS. Enable if you cannot set your monitor to 1080p. Bypass 120Hz monitor check Either Disable checking if the monitor is exactly 120Hz when enabling 120FPS. Enable if you cannot set your monitor to 120Hz."},{"location":"games/sega/chunithm/luminousplus/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download segatools.zip. Do not download the source code.
  • Extracting the archive should give you a few more zip files. Find chusan.zip and extract it to the App\\bin folder in your game data.

You should now have a few more files inside the folder, as highlighted:

"},{"location":"games/sega/chunithm/luminousplus/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\bin\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[system]\ndipsw2=1\ndipsw2=1 ; WRONG!\n
"},{"location":"games/sega/chunithm/luminousplus/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

Relative Directories

The ../ in the above example represents the parent directory in a relative path. It is used to navigate up one level in the directory hierarchy.

For example, your segatools.ini is located at /App/bin/segatools.ini and your Option folder is located next to the App folder.

Since segatools.ini is in the /bin/ folder, typing ../ would move you up to the App folder. Since the Option folder is next to the App folder, the second ../ takes you to App's parent folder, which is the folder containing App, Option, etc.

The benefits of using this method include:

  • Avoiding issues that arise when folders have spaces in their names.

  • Being able to move your game folder without redefining the locations of your VFS folders.

  • A cleaner and easier to read segatools.ini, making spotting issues simpler.

"},{"location":"games/sega/chunithm/luminousplus/setup/#system","title":"[system]","text":"
  • If you have a 120Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n
"},{"location":"games/sega/chunithm/luminousplus/setup/#gfx","title":"[gfx]","text":"
  • Set windowed to 0 to run in fullscreen mode and 1 to run in windowed mode.
  • If you have multiple monitors and you're running in fullscreen mode (windowed=0), set monitor to the index of the monitor you want to run the game on.
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number minus one. For example, monitor 2 means monitor index 1.

"},{"location":"games/sega/chunithm/luminousplus/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.139.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\bin\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/luminousplus/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/chunithm/luminousplus/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/luminousplus/setup/#audio","title":"Audio","text":"
  • Right-click on the volume setting in your taskbar and select Sounds.
  • Navigate to the Playback tab, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick either 16 bit, 48000Hz (DVD Quality) or 24 bit, 48000Hz (Studio Quality), click Apply, then OK.
"},{"location":"games/sega/chunithm/luminousplus/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/chunithm/luminousplus/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/chunithm/luminousplus/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\bin\\start.bat. Let the game load until it reaches the screen below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 4th option).

Select \u30b0\u30eb\u30fc\u30d7\u5185\u57fa\u6e96\u6a5f\u8a2d\u5b9a (SET STANDARD IN GROUP, the second option) and toggle this setting to \u57fa\u6e96\u6a5f (STANDARD).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/chunithm/luminousplus/setup/#close-setting","title":"CLOSE SETTING","text":"

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the 10th option).

Navigate to \u6642 (HOUR, the 2nd option) and use the Service button to toggle the setting until it says \u5168\u6642\u523b (ALL TIME).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu, then select \u7d42\u4e86 (also the last option) in the main menu to exit the service menu.

"},{"location":"games/sega/chunithm/luminousplus/setup/#waiting-for-distribution-server","title":"Waiting for Distribution Server","text":"

If you're stuck at the Waiting for Distribution Server screen below, close the game and relaunch.

You're all done! The game should load up properly now.

You can add coins using the Coin key (default F3) and card in by holding the Enter key.

"},{"location":"games/sega/chunithm/luminousplus/setup/#further-configuration","title":"Further configuration","text":"

Input methods and controllers are covered in the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/luminousplus/troubleshooting/","title":"Troubleshooting (LUMINOUS PLUS)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/chunithm/luminousplus/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch!","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120Hz, apply the \"Bypass 120Hz monitor check\"/\"Bypass 1080p monitor check\" on a CHUNITHM web patcher (see Resources).
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\nping 127.0.0.1 -n 31 > nul && taskkill /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/chunithm/luminousplus/troubleshooting/#my-game-takes-a-long-time-to-boot","title":"My game takes a long time to boot!","text":"

CHUNITHM game files consist of thousands of small XML files, which Windows Defender takes a long time to scan through. Add your game folder to the Windows Defender exclusion list.

Danger

Doing this will prevent Windows Defender from scanning your game folder for viruses. Only do this if you trust the source of the data.

"},{"location":"games/sega/chunithm/luminousplus/troubleshooting/#my-game-is-running-too-slowfast","title":"My game is running too slow/fast","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Make sure your monitor's refresh rate is set to 60Hz or 120Hz.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/luminousplus/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chusanApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/luminousplus/troubleshooting/#my-game-crashes-when-i-tab-out-of-fullscreen","title":"My game crashes when I tab out of fullscreen!","text":"

As the game is intended to run on arcade hardware, it doesn't like being minimized.

One workaround for this is to use DXVK. Download the latest version from releases. This will be a dxvk-x.y.z.tar.gz file, which you can open using 7zip. Navigate to the x32 folder, and copy the d3d9.dll file to your game's App\\bin folder, agreeing to overwrite when asked.

You should now be able to tab out of fullscreen without crashing the game.

Warning

The game will not ignore inputs when out of focus.

This means any controller inputs will still be accepted, so try not to lean onto your slider whilst tabbed out!

This also means that you can accidentally enter the service menu by hitting your Test key even if the game is minimised. If you were in the middle of a credit, your scores will be lost.

"},{"location":"games/sega/chunithm/luminousplus/troubleshooting/#when-i-run-the-game-all-other-audio-is-gone","title":"When I run the game all other audio is gone!","text":"

CHUNITHM uses WASAPI exclusive mode for audio to get better latency.

You can apply the \"Shared Audio\" patch on a CHUNITHM web patcher (see Resources) to hear audio outside of the game at the cost of audio latency.

"},{"location":"games/sega/chunithm/luminousplus/troubleshooting/#cabinet-to-cabinetc2c-fixes","title":"Cabinet-to-Cabinet(c2c) Fixes","text":"

c2c can have many problems but you can fix most of them by applying the \"Patch for head-to-head play\" and disabling \"Set all timers to 999\" on a CHUNITHM web patcher (see Resources).

If the above does not work then please ensure both machines have the exact same data and can communicate with each other if they cannot then you can try disabling firewalls or changing the c2c group.

If clicking the c2c button does nothing, you can fix it by resetting the network settings in Windows.

"},{"location":"games/sega/chunithm/new/c2c/","title":"Cab-to-Cab Play over Internet (NEW)","text":"

You are most likely to have success with Multiplayer when all users are using the SAME data and options, from the same sources. Verify that each person can run the game normally before attempting to network them together.

  • Chunithm expects the cabinets to be using specific IP addresses, 192.168.139.11/12/13/14
  • To achieve this over the internet, we can use SoftEther VPN. Refer to the Setting Up SoftEther VPN Guide for more information.
"},{"location":"games/sega/chunithm/new/c2c/#configuring-segatoolsini-game-assignments","title":"Configuring segatools.ini & Game Assignments","text":"

segatools.ini

[netnev]\nenable=1\naddrSuffix= last 2 digits of your SoftEther IP\n\n[keychip]\nenable=1\nsubnet=192.168.139.0\nid=(Everyone needs a seperate keychip. If you play on a remote network, chances are you already have your own keychip. If not, you can use the example keychips below.)\n;example keychips: A61E-01D02321145 ; A61E-01A30831145 ; A61E-01E38091145 ; A61E-01E46241145\n\n[system]\ndipsw1=1\n;This has changed since Luminous. Previously if you wish to perform cab-to-cab link, you need to set this to 1 on the Server machine, and 0 on all other client machines.\n;This change is no longer needed, just keep this set to 1 on all machines.\n

GAME ASSIGNMENTS

  • After saving your segatools.ini, launch the game and go into the Service Menu > and go to GAME ASSIGNMENTS.

  • Enable CABINET-TO-CABINET PLAY, and make sure all machine are on the same group (Group A for example).

  • Set one machine to STANDARD, and all other machines to FOLLOW THE STANDARD .

Exit the Service Menu and load into Attract Mode. If the game passes the Group Check then chances are you're good to go! You can now login to a credit and open a cab-to-cab link request to check if the connection is working properly!

"},{"location":"games/sega/chunithm/new/c2c/#how-to-link","title":"How to Link?","text":"

If you're new to Chunithm and have never tried link-play before and you have no idea how, keep reading.

  • Login to a credit.

  • If you're hosting a cab-to-cab session, choose a song first, then scroll to the far left and press Confirm. The cab-to-cab request is now open.

  • If you're connecting, navigate to the \"Cabinet-to-Cabinet Play\" tab and wait for other players to create a session.

If you are able to see each other's session, congrats! You can now enjoy some cab-to-cab chain action!

"},{"location":"games/sega/chunithm/new/c2c/#troubleshooting","title":"Troubleshooting","text":"

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/new/controllers/","title":"Controllers (NEW)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with IO DLLs to add support for controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\bin\\ folder and referenced in segatools.ini under the [chuniio] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; Uncomment this if you have custom chuniio implementation comprised of a single 32bit DLL.\n; (will use chu2to3 engine internally)\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.

If you have two DLLs, ending in _x86.dll and _x64.dll (or _chusan.dll and _amdaemon.dll), uncomment the path32= and path64= lines by removing the leading semicolon (;), then add your DLLs after the =:

[chuniio]\n; Uncomment both of these if you have custom chuniio implementation comprised of two DLLs.\n; x86 chuniio to path32, x64 to path64. Both are necessary.\n;(1)!\npath32=controller_x86.dll\npath64=controller_x64.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/new/controllers/#keyboard","title":"Keyboard","text":"

Keyboard is the default input method, and while not recommended for playing the game, it is useful for testing purposes.

The default layout uses SDFGHJKL for slider input, and Space Bar for the AIRs.

If you wish to change the default keybinds, an explanation on how to set these is included above the [io3] section in your segatools.ini.

"},{"location":"games/sega/chunithm/new/controllers/#brokenithm","title":"Brokenithm","text":"

Brokenithm allows you to use a mobile device as a CHUNITHM controller. It uses the bottom half of the screen as the ground slider, and sliding into the upper half activates the air sensors.

"},{"location":"games/sega/chunithm/new/controllers/#android","title":"Android","text":"

Warning

Your computer and your Android device must be on the same local network.

  • Download the latest version of Brokenithm-Android and install it on your Android device.
  • Download the latest version of Brokenithm-Android-Server and extract only brokenithm_server.exe to your App\\bin\\ folder.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run brokenithm_server.exe. A command prompt window should open, saying that it is waiting for a device on port 52468.
  • Open the Brokenithm app on your Android device. Enter your computer's IP address in the Address box on the top right, then tap Start.
  • Run the game as normal.
Getting your computer's IP address

Open Settings -> Network and Internet and select Properties. Scroll down to the bottom and check the address under the IPv4 address field:

That is your computer's IP address.

Automatically launching the Brokenithm server when starting the game

This will only work if you extracted brokenithm_server.exe to App\\bin\\ as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min brokenithm_server\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Improving latency

You can improve latency by running Brokenithm with your Android device tethered to your computer. However, this requires a little extra setup:

  • Connect your Android device to your computer with a USB cable.
  • If you haven't enabled Developer options on your device, do it by navigating to the \"About\" page in your phone's settings, then tap \"Build number\" seven times. This varies by device, so if unsure, look up the instructions for your specific one.
  • Navigate to Developer options and enable USB debugging.
  • On your computer, download and extract Android SDK Platform Tools to your App\\bin\\ folder.
  • Navigate to the App\\bin\\platform-tools folder in File Explorer, click on the address bar, type cmd, and hit Enter to open a command prompt.
  • In the command prompt, type the following command:
adb reverse tcp:52468 tcp:52468\n
  • Start brokenithm_server in TCP mode with the -T command line flag, brokenithm_server.exe -T.
  • On your Android device, open Brokenithm, and change the address to 0.0.0.0.
    • If the text box to the left of the \"SETTINGS\" button say \"UDP\", tap on it once to switch to \"TCP\" mode.
  • Tap on \"START\", and you will now be connected via the USB cable.
  • You can now start the game as normal.

The next time you play the game, you only need to run the adb reverse ... command again. To do this automatically when the game starts, add a line to the start.bat script before the brokenithm_server line:

@echo off\n\npushd %~dp0\n\nstart /min platform-tools\\adb reverse tcp:52468 tcp:52468\nstart /min brokenithm_server -T\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/new/controllers/#iosipados","title":"iOS/iPadOS","text":"
  • Install Brokenithm on your iOS/iPadOS device by joining the Brokenithm TestFlight (iOS 18 only).
    • If your iOS/iPadOS device doesn't have iOS 18, you will need to sideload a different IPA with Sideloadly.
  • If you have iTunes and/or iCloud installed from the Microsoft Store on your computer, uninstall it.
  • Install the non-Microsoft Store version of iTunes from the website.
  • Download the latest version of Brokenithm-Evolved-iOS server and extract it to App\\bin\\Brokenithm-Server.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run App\\bin\\Brokenithm-Server\\Brokenithm-Evolved-iOS.exe. A command prompt window should open, saying that it is waiting for a device.
  • On your iOS/iPadOS device, open Brokenithm, and connect it to your computer with a USB cable.
  • Run the game as normal.
Automatically launching the Brokenithm server when starting the game

This will only work if you extracted the server to App\\bin\\Brokenithm-Server as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min Brokenithm-Server\\Brokenithm-Evolved-iOS.exe\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/new/controllers/#tasoller","title":"TASOLLER","text":"

Warning

This guide only covers TASOLLERs running the v2.0 touch firmware. If you've purchased the controller after January 2022, the update should have already been applied.

If you've purchased the controller before then, you will need to update the touch firmware by following the instructions on DJ-DAO's support page.

  • Install the custom IO4 firmware to your controller.
  • Follow the segatools.ini config on the gitea page.
  • Connect the controller to your computer, and then start the game.
Legacy
  • Backup TASOLLER setup if IO4 cfw is not working.
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download TASOLLER IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_v2_x86.dll\npath64=chuniio_tasoller_v2_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/new/controllers/#tasoller-plus","title":"TASOLLER PLUS","text":"
  • Switch your TASOLLER PLUS to WINUSB mode. You can do so in TASOLLER Options found on the djdao support page.
  • Download TASOLLER PLUS IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_plus_x86.dll\npath64=chuniio_tasoller_plus_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/new/controllers/#yubideck","title":"YubiDeck","text":"
  • Switch your YubiDeck to HID output mode. Instructions on how to do so are provided in the YubiDeck manual.
  • Download the latest version of YubiDeck IO DLLs and extract it to your App\\bin folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_yubideck_chusan.dll\npath64=chuniio_yubideck_amdaemon.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/new/controllers/#laverita-3","title":"Laverita 3","text":"
  • Switch your Laverita to IO mode. You can do so in ConfigApp found in the yuancon discord.
  • Change the COM port of your controller. You can do so in Device manager by looking for USB Serial Device you may need to unplug and replug your controller to properly idetify which one is the Laverita.
  • Double click on it
  • Go to Port Settings
  • Click on Advanced
  • From the dropdown select COM1
  • Restart to ensure changes took effect and saved
  • Edit your App\\bin\\segatools.ini to disable io emulation and set led:
[led]\n; Output billboard LED strip data to a named pipe called \"\\\\.\\pipe\\chuni_led\"\ncabLedOutputPipe=0\n; Output billboard LED strip data to serial\ncabLedOutputSerial=1\n\n; Output slider LED data to the named pipe\ncontrollerLedOutputPipe=0\n; Output slider LED data to the serial port\ncontrollerLedOutputSerial=1\n; Use the OpeNITHM protocol for serial LED output\ncontrollerLedOutputOpeNITHM=0\n\n; Serial port to send data to if using serial output. Default is COM5.\nserialPort=COM1\n; Baud rate for serial data (set to 115200 if using OpeNITHM)\nserialBaud=9600\n\n[slider]\n; Enable slider emulation. If you have real AC slider, set this to 0.\n; Slider serial port must be COM1.\nenable=0\n\n[io4]\nenable=0\n
  • Then start the game.
Legacy
  • Backup Laverita 3 setup if IO4 cfw is not working.
  • Switch your Laverita to HID mode. You can do so in ConfigApp
  • Download Laverita IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_laverita_v3_x86.dll\npath64=chuniio_laverita_v3_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/new/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet slider and air sensors, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/chunithm/new/setup/","title":"Game Setup (NEW)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of CHUNITHM

You'll want to create a new folder for the game and start from scratch. CHUNITHM DOES NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/new/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create another empty folder named AppData next to them. It should now look like below.

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/chunithm/new/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/chunithm/new/setup/#installing-option-data","title":"Installing option data","text":"

CHUNITHM content updates are distributed through option folders instead of patching the base game. They are named A???, with each ? being a number. Custom options distributed by the community might use letters instead, to distinguish them from official ones.

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

If you plan to connect to a network (Hosted or Local), the A001 option folder for your specific game version is required. This option contains a special Event file that lets the game connect.

"},{"location":"games/sega/chunithm/new/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

CHUNITHM executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of chusanApp.exe and amdaemon.exe for your game version.

Copy chusanApp.exe and amdaemon.exe to the bin folder of your game data. Agree to overwrite when asked.

"},{"location":"games/sega/chunithm/new/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/chunithm/new/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher.

There are many patches for CHUNITHM.

We will only bring up the ones we think could be genuinely useful.

As a general rule of thumb, if you're not sure what a patch does or you're not absolutely certain you need it, leave it alone, regardless of recommendations below.

Patch Recommendation Description Force shared audio mode Either Force the game to use shared mode audio output, letting you listen to other audio sources while the game is running at the cost of audio latency. Force 2 channel audio output Either Try enabling this patch if you don't get audio output at all. Disable song select timer Either Disables the song select timer. No encryption ON Disable encrypting network requests. Required if you plan to run a local server. No TLS ON Disable checking if the server is HTTPS or not. Required if you plan to run a local server. Bypass 1080p monitor check Either Disable checking if the monitor is 1080p when enabling 120FPS. Enable if you cannot set your monitor to 1080p. Bypass 120Hz monitor check Either Disable checking if the monitor is exactly 120Hz when enabling 120FPS. Enable if you cannot set your monitor to 120Hz."},{"location":"games/sega/chunithm/new/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download segatools.zip. Do not download the source code.
  • Extracting the archive should give you a few more zip files. Find chusan.zip and extract it to the App\\bin folder in your game data.

You should now have a few more files inside the folder, as highlighted:

"},{"location":"games/sega/chunithm/new/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\bin\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[system]\ndipsw2=1\ndipsw2=1 ; WRONG!\n
"},{"location":"games/sega/chunithm/new/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

Relative Directories

The ../ in the above example represents the parent directory in a relative path. It is used to navigate up one level in the directory hierarchy.

For example, your segatools.ini is located at /App/bin/segatools.ini and your Option folder is located next to the App folder.

Since segatools.ini is in the /bin/ folder, typing ../ would move you up to the App folder. Since the Option folder is next to the App folder, the second ../ takes you to App's parent folder, which is the folder containing App, Option, etc.

The benefits of using this method include:

  • Avoiding issues that arise when folders have spaces in their names.

  • Being able to move your game folder without redefining the locations of your VFS folders.

  • A cleaner and easier to read segatools.ini, making spotting issues simpler.

"},{"location":"games/sega/chunithm/new/setup/#system","title":"[system]","text":"
  • If you have a 120Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n
"},{"location":"games/sega/chunithm/new/setup/#gfx","title":"[gfx]","text":"
  • Set windowed to 0 to run in fullscreen mode and 1 to run in windowed mode.
  • If you have multiple monitors and you're running in fullscreen mode (windowed=0), set monitor to the index of the monitor you want to run the game on.
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number minus one. For example, monitor 2 means monitor index 1.

"},{"location":"games/sega/chunithm/new/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.139.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\bin\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/new/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/chunithm/new/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/new/setup/#audio","title":"Audio","text":"
  • Right-click on the volume setting in your taskbar and select Sounds.
  • Navigate to the Playback tab, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick either 16 bit, 48000Hz (DVD Quality) or 24 bit, 48000Hz (Studio Quality), click Apply, then OK.
"},{"location":"games/sega/chunithm/new/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/chunithm/new/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/chunithm/new/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\bin\\start.bat. Let the game load until it reaches the screen below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 4th option).

Select \u30b0\u30eb\u30fc\u30d7\u5185\u57fa\u6e96\u6a5f\u8a2d\u5b9a (SET STANDARD IN GROUP, the second option) and toggle this setting to \u57fa\u6e96\u6a5f (STANDARD).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/chunithm/new/setup/#close-setting","title":"CLOSE SETTING","text":"

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the 10th option).

Navigate to \u6642 (HOUR, the 2nd option) and use the Service button to toggle the setting until it says \u5168\u6642\u523b (ALL TIME).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu, then select \u7d42\u4e86 (also the last option) in the main menu to exit the service menu.

"},{"location":"games/sega/chunithm/new/setup/#waiting-for-distribution-server","title":"Waiting for Distribution Server","text":"

If you're stuck at the Waiting for Distribution Server screen below, close the game and relaunch.

You're all done! The game should load up properly now.

You can add coins using the Coin key (default F3) and card in by holding the Enter key.

"},{"location":"games/sega/chunithm/new/setup/#further-configuration","title":"Further configuration","text":"

Input methods and controllers are covered in the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/new/troubleshooting/","title":"Troubleshooting (NEW)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/chunithm/new/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch!","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120Hz, apply the \"Bypass 120Hz monitor check\"/\"Bypass 1080p monitor check\" on a CHUNITHM web patcher (see Resources).
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\nping 127.0.0.1 -n 31 > nul && taskkill /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/chunithm/new/troubleshooting/#my-game-takes-a-long-time-to-boot","title":"My game takes a long time to boot!","text":"

CHUNITHM game files consist of thousands of small XML files, which Windows Defender takes a long time to scan through. Add your game folder to the Windows Defender exclusion list.

Danger

Doing this will prevent Windows Defender from scanning your game folder for viruses. Only do this if you trust the source of the data.

"},{"location":"games/sega/chunithm/new/troubleshooting/#my-game-is-running-too-slowfast","title":"My game is running too slow/fast","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Make sure your monitor's refresh rate is set to 60Hz or 120Hz.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/new/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chusanApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/new/troubleshooting/#my-game-crashes-when-i-tab-out-of-fullscreen","title":"My game crashes when I tab out of fullscreen!","text":"

As the game is intended to run on arcade hardware, it doesn't like being minimized.

One workaround for this is to use DXVK. Download the latest version from releases. This will be a dxvk-x.y.z.tar.gz file, which you can open using 7zip. Navigate to the x32 folder, and copy the d3d9.dll file to your game's App\\bin folder, agreeing to overwrite when asked.

You should now be able to tab out of fullscreen without crashing the game.

Warning

The game will not ignore inputs when out of focus.

This means any controller inputs will still be accepted, so try not to lean onto your slider whilst tabbed out!

This also means that you can accidentally enter the service menu by hitting your Test key even if the game is minimised. If you were in the middle of a credit, your scores will be lost.

"},{"location":"games/sega/chunithm/new/troubleshooting/#when-i-run-the-game-all-other-audio-is-gone","title":"When I run the game all other audio is gone!","text":"

CHUNITHM uses WASAPI exclusive mode for audio to get better latency.

You can apply the \"Shared Audio\" patch on a CHUNITHM web patcher (see Resources) to hear audio outside of the game at the cost of audio latency.

"},{"location":"games/sega/chunithm/new/troubleshooting/#cabinet-to-cabinetc2c-fixes","title":"Cabinet-to-Cabinet(c2c) Fixes","text":"

c2c can have many problems but you can fix most of them by applying the \"Patch for head-to-head play\" and disabling \"Set all timers to 999\" on a CHUNITHM web patcher (see Resources).

If the above does not work then please ensure both machines have the exact same data and can communicate with each other if they cannot then you can try disabling firewalls or changing the c2c group.

If clicking the c2c button does nothing, you can fix it by resetting the network settings in Windows.

"},{"location":"games/sega/chunithm/newplus/c2c/","title":"Cab-to-Cab Play over Internet (NEW PLUS)","text":"

You are most likely to have success with Multiplayer when all users are using the SAME data and options, from the same sources. Verify that each person can run the game normally before attempting to network them together.

  • Chunithm expects the cabinets to be using specific IP addresses, 192.168.139.11/12/13/14
  • To achieve this over the internet, we can use SoftEther VPN. Refer to the Setting Up SoftEther VPN Guide for more information.
"},{"location":"games/sega/chunithm/newplus/c2c/#configuring-segatoolsini-game-assignments","title":"Configuring segatools.ini & Game Assignments","text":"

segatools.ini

[netnev]\nenable=1\naddrSuffix= last 2 digits of your SoftEther IP\n\n[keychip]\nenable=1\nsubnet=192.168.139.0\nid=(Everyone needs a seperate keychip. If you play on a remote network, chances are you already have your own keychip. If not, you can use the example keychips below.)\n;example keychips: A61E-01D02321145 ; A61E-01A30831145 ; A61E-01E38091145 ; A61E-01E46241145\n\n[system]\ndipsw1=1\n;This has changed since Luminous. Previously if you wish to perform cab-to-cab link, you need to set this to 1 on the Server machine, and 0 on all other client machines.\n;This change is no longer needed, just keep this set to 1 on all machines.\n

GAME ASSIGNMENTS

  • After saving your segatools.ini, launch the game and go into the Service Menu > and go to GAME ASSIGNMENTS.

  • Enable CABINET-TO-CABINET PLAY, and make sure all machine are on the same group (Group A for example).

  • Set one machine to STANDARD, and all other machines to FOLLOW THE STANDARD .

Exit the Service Menu and load into Attract Mode. If the game passes the Group Check then chances are you're good to go! You can now login to a credit and open a cab-to-cab link request to check if the connection is working properly!

"},{"location":"games/sega/chunithm/newplus/c2c/#how-to-link","title":"How to Link?","text":"

If you're new to Chunithm and have never tried link-play before and you have no idea how, keep reading.

  • Login to a credit.

  • If you're hosting a cab-to-cab session, choose a song first, then scroll to the far left and press Confirm. The cab-to-cab request is now open.

  • If you're connecting, navigate to the \"Cabinet-to-Cabinet Play\" tab and wait for other players to create a session.

If you are able to see each other's session, congrats! You can now enjoy some cab-to-cab chain action!

"},{"location":"games/sega/chunithm/newplus/c2c/#troubleshooting","title":"Troubleshooting","text":"

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/newplus/controllers/","title":"Controllers (NEW PLUS)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with IO DLLs to add support for controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\bin\\ folder and referenced in segatools.ini under the [chuniio] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; Uncomment this if you have custom chuniio implementation comprised of a single 32bit DLL.\n; (will use chu2to3 engine internally)\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.

If you have two DLLs, ending in _x86.dll and _x64.dll (or _chusan.dll and _amdaemon.dll), uncomment the path32= and path64= lines by removing the leading semicolon (;), then add your DLLs after the =:

[chuniio]\n; Uncomment both of these if you have custom chuniio implementation comprised of two DLLs.\n; x86 chuniio to path32, x64 to path64. Both are necessary.\n;(1)!\npath32=controller_x86.dll\npath64=controller_x64.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/newplus/controllers/#keyboard","title":"Keyboard","text":"

Keyboard is the default input method, and while not recommended for playing the game, it is useful for testing purposes.

The default layout uses SDFGHJKL for slider input, and Space Bar for the AIRs.

If you wish to change the default keybinds, an explanation on how to set these is included above the [io3] section in your segatools.ini.

"},{"location":"games/sega/chunithm/newplus/controllers/#brokenithm","title":"Brokenithm","text":"

Brokenithm allows you to use a mobile device as a CHUNITHM controller. It uses the bottom half of the screen as the ground slider, and sliding into the upper half activates the air sensors.

"},{"location":"games/sega/chunithm/newplus/controllers/#android","title":"Android","text":"

Warning

Your computer and your Android device must be on the same local network.

  • Download the latest version of Brokenithm-Android and install it on your Android device.
  • Download the latest version of Brokenithm-Android-Server and extract only brokenithm_server.exe to your App\\bin\\ folder.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run brokenithm_server.exe. A command prompt window should open, saying that it is waiting for a device on port 52468.
  • Open the Brokenithm app on your Android device. Enter your computer's IP address in the Address box on the top right, then tap Start.
  • Run the game as normal.
Getting your computer's IP address

Open Settings -> Network and Internet and select Properties. Scroll down to the bottom and check the address under the IPv4 address field:

That is your computer's IP address.

Automatically launching the Brokenithm server when starting the game

This will only work if you extracted brokenithm_server.exe to App\\bin\\ as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min brokenithm_server\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Improving latency

You can improve latency by running Brokenithm with your Android device tethered to your computer. However, this requires a little extra setup:

  • Connect your Android device to your computer with a USB cable.
  • If you haven't enabled Developer options on your device, do it by navigating to the \"About\" page in your phone's settings, then tap \"Build number\" seven times. This varies by device, so if unsure, look up the instructions for your specific one.
  • Navigate to Developer options and enable USB debugging.
  • On your computer, download and extract Android SDK Platform Tools to your App\\bin\\ folder.
  • Navigate to the App\\bin\\platform-tools folder in File Explorer, click on the address bar, type cmd, and hit Enter to open a command prompt.
  • In the command prompt, type the following command:
adb reverse tcp:52468 tcp:52468\n
  • Start brokenithm_server in TCP mode with the -T command line flag, brokenithm_server.exe -T.
  • On your Android device, open Brokenithm, and change the address to 0.0.0.0.
    • If the text box to the left of the \"SETTINGS\" button say \"UDP\", tap on it once to switch to \"TCP\" mode.
  • Tap on \"START\", and you will now be connected via the USB cable.
  • You can now start the game as normal.

The next time you play the game, you only need to run the adb reverse ... command again. To do this automatically when the game starts, add a line to the start.bat script before the brokenithm_server line:

@echo off\n\npushd %~dp0\n\nstart /min platform-tools\\adb reverse tcp:52468 tcp:52468\nstart /min brokenithm_server -T\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/newplus/controllers/#iosipados","title":"iOS/iPadOS","text":"
  • Install Brokenithm on your iOS/iPadOS device by joining the Brokenithm TestFlight (iOS 18 only).
    • If your iOS/iPadOS device doesn't have iOS 18, you will need to sideload a different IPA with Sideloadly.
  • If you have iTunes and/or iCloud installed from the Microsoft Store on your computer, uninstall it.
  • Install the non-Microsoft Store version of iTunes from the website.
  • Download the latest version of Brokenithm-Evolved-iOS server and extract it to App\\bin\\Brokenithm-Server.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run App\\bin\\Brokenithm-Server\\Brokenithm-Evolved-iOS.exe. A command prompt window should open, saying that it is waiting for a device.
  • On your iOS/iPadOS device, open Brokenithm, and connect it to your computer with a USB cable.
  • Run the game as normal.
Automatically launching the Brokenithm server when starting the game

This will only work if you extracted the server to App\\bin\\Brokenithm-Server as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min Brokenithm-Server\\Brokenithm-Evolved-iOS.exe\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/newplus/controllers/#tasoller","title":"TASOLLER","text":"

Warning

This guide only covers TASOLLERs running the v2.0 touch firmware. If you've purchased the controller after January 2022, the update should have already been applied.

If you've purchased the controller before then, you will need to update the touch firmware by following the instructions on DJ-DAO's support page.

  • Install the custom IO4 firmware to your controller.
  • Follow the segatools.ini config on the gitea page.
  • Connect the controller to your computer, and then start the game.
Legacy
  • Backup TASOLLER setup if IO4 cfw is not working.
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download TASOLLER IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_v2_x86.dll\npath64=chuniio_tasoller_v2_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/newplus/controllers/#tasoller-plus","title":"TASOLLER PLUS","text":"
  • Switch your TASOLLER PLUS to WINUSB mode. You can do so in TASOLLER Options found on the djdao support page.
  • Download TASOLLER PLUS IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_plus_x86.dll\npath64=chuniio_tasoller_plus_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/newplus/controllers/#yubideck","title":"YubiDeck","text":"
  • Switch your YubiDeck to HID output mode. Instructions on how to do so are provided in the YubiDeck manual.
  • Download the latest version of YubiDeck IO DLLs and extract it to your App\\bin folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_yubideck_chusan.dll\npath64=chuniio_yubideck_amdaemon.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/newplus/controllers/#laverita-3","title":"Laverita 3","text":"
  • Switch your Laverita to IO mode. You can do so in ConfigApp found in the yuancon discord.
  • Change the COM port of your controller. You can do so in Device manager by looking for USB Serial Device you may need to unplug and replug your controller to properly idetify which one is the Laverita.
  • Double click on it
  • Go to Port Settings
  • Click on Advanced
  • From the dropdown select COM1
  • Restart to ensure changes took effect and saved
  • Edit your App\\bin\\segatools.ini to disable io emulation and set led:
[led]\n; Output billboard LED strip data to a named pipe called \"\\\\.\\pipe\\chuni_led\"\ncabLedOutputPipe=0\n; Output billboard LED strip data to serial\ncabLedOutputSerial=1\n\n; Output slider LED data to the named pipe\ncontrollerLedOutputPipe=0\n; Output slider LED data to the serial port\ncontrollerLedOutputSerial=1\n; Use the OpeNITHM protocol for serial LED output\ncontrollerLedOutputOpeNITHM=0\n\n; Serial port to send data to if using serial output. Default is COM5.\nserialPort=COM1\n; Baud rate for serial data (set to 115200 if using OpeNITHM)\nserialBaud=9600\n\n[slider]\n; Enable slider emulation. If you have real AC slider, set this to 0.\n; Slider serial port must be COM1.\nenable=0\n\n[io4]\nenable=0\n
  • Then start the game.
Legacy
  • Backup Laverita 3 setup if IO4 cfw is not working.
  • Switch your Laverita to HID mode. You can do so in ConfigApp
  • Download Laverita IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_laverita_v3_x86.dll\npath64=chuniio_laverita_v3_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/newplus/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet slider and air sensors, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/chunithm/newplus/setup/","title":"Game Setup (NEW PLUS)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of CHUNITHM

You'll want to create a new folder for the game and start from scratch. CHUNITHM DOES NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/newplus/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create another empty folder named AppData next to them. It should now look like below.

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/chunithm/newplus/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/chunithm/newplus/setup/#installing-option-data","title":"Installing option data","text":"

CHUNITHM content updates are distributed through option folders instead of patching the base game. They are named A???, with each ? being a number. Custom options distributed by the community might use letters instead, to distinguish them from official ones.

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

If you plan to connect to a network (Hosted or Local), the A001 option folder for your specific game version is required. This option contains a special Event file that lets the game connect.

"},{"location":"games/sega/chunithm/newplus/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

CHUNITHM executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of chusanApp.exe and amdaemon.exe for your game version.

Copy chusanApp.exe and amdaemon.exe to the bin folder of your game data. Agree to overwrite when asked.

"},{"location":"games/sega/chunithm/newplus/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/chunithm/newplus/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher.

There are many patches for CHUNITHM.

We will only bring up the ones we think could be genuinely useful.

As a general rule of thumb, if you're not sure what a patch does or you're not absolutely certain you need it, leave it alone, regardless of recommendations below.

Patch Recommendation Description Force shared audio mode Either Force the game to use shared mode audio output, letting you listen to other audio sources while the game is running at the cost of audio latency. Force 2 channel audio output Either Try enabling this patch if you don't get audio output at all. Disable song select timer Either Disables the song select timer. No encryption ON Disable encrypting network requests. Required if you plan to run a local server. No TLS ON Disable checking if the server is HTTPS or not. Required if you plan to run a local server. Bypass 1080p monitor check Either Disable checking if the monitor is 1080p when enabling 120FPS. Enable if you cannot set your monitor to 1080p. Bypass 120Hz monitor check Either Disable checking if the monitor is exactly 120Hz when enabling 120FPS. Enable if you cannot set your monitor to 120Hz."},{"location":"games/sega/chunithm/newplus/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download segatools.zip. Do not download the source code.
  • Extracting the archive should give you a few more zip files. Find chusan.zip and extract it to the App\\bin folder in your game data.

You should now have a few more files inside the folder, as highlighted:

"},{"location":"games/sega/chunithm/newplus/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\bin\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[system]\ndipsw2=1\ndipsw2=1 ; WRONG!\n
"},{"location":"games/sega/chunithm/newplus/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

Relative Directories

The ../ in the above example represents the parent directory in a relative path. It is used to navigate up one level in the directory hierarchy.

For example, your segatools.ini is located at /App/bin/segatools.ini and your Option folder is located next to the App folder.

Since segatools.ini is in the /bin/ folder, typing ../ would move you up to the App folder. Since the Option folder is next to the App folder, the second ../ takes you to App's parent folder, which is the folder containing App, Option, etc.

The benefits of using this method include:

  • Avoiding issues that arise when folders have spaces in their names.

  • Being able to move your game folder without redefining the locations of your VFS folders.

  • A cleaner and easier to read segatools.ini, making spotting issues simpler.

"},{"location":"games/sega/chunithm/newplus/setup/#system","title":"[system]","text":"
  • If you have a 120Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n
"},{"location":"games/sega/chunithm/newplus/setup/#gfx","title":"[gfx]","text":"
  • Set windowed to 0 to run in fullscreen mode and 1 to run in windowed mode.
  • If you have multiple monitors and you're running in fullscreen mode (windowed=0), set monitor to the index of the monitor you want to run the game on.
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number minus one. For example, monitor 2 means monitor index 1.

"},{"location":"games/sega/chunithm/newplus/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.139.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\bin\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/newplus/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/chunithm/newplus/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/newplus/setup/#audio","title":"Audio","text":"
  • Right-click on the volume setting in your taskbar and select Sounds.
  • Navigate to the Playback tab, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick either 16 bit, 48000Hz (DVD Quality) or 24 bit, 48000Hz (Studio Quality), click Apply, then OK.
"},{"location":"games/sega/chunithm/newplus/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/chunithm/newplus/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/chunithm/newplus/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\bin\\start.bat. Let the game load until it reaches the screen below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 4th option).

Select \u30b0\u30eb\u30fc\u30d7\u5185\u57fa\u6e96\u6a5f\u8a2d\u5b9a (SET STANDARD IN GROUP, the second option) and toggle this setting to \u57fa\u6e96\u6a5f (STANDARD).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/chunithm/newplus/setup/#close-setting","title":"CLOSE SETTING","text":"

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the 10th option).

Navigate to \u6642 (HOUR, the 2nd option) and use the Service button to toggle the setting until it says \u5168\u6642\u523b (ALL TIME).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu, then select \u7d42\u4e86 (also the last option) in the main menu to exit the service menu.

"},{"location":"games/sega/chunithm/newplus/setup/#waiting-for-distribution-server","title":"Waiting for Distribution Server","text":"

If you're stuck at the Waiting for Distribution Server screen below, close the game and relaunch.

You're all done! The game should load up properly now.

You can add coins using the Coin key (default F3) and card in by holding the Enter key.

"},{"location":"games/sega/chunithm/newplus/setup/#further-configuration","title":"Further configuration","text":"

Input methods and controllers are covered in the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/newplus/troubleshooting/","title":"Troubleshooting (NEW PLUS)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/chunithm/newplus/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch!","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120Hz, apply the \"Bypass 120Hz monitor check\"/\"Bypass 1080p monitor check\" on a CHUNITHM web patcher (see Resources).
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\nping 127.0.0.1 -n 31 > nul && taskkill /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/chunithm/newplus/troubleshooting/#my-game-takes-a-long-time-to-boot","title":"My game takes a long time to boot!","text":"

CHUNITHM game files consist of thousands of small XML files, which Windows Defender takes a long time to scan through. Add your game folder to the Windows Defender exclusion list.

Danger

Doing this will prevent Windows Defender from scanning your game folder for viruses. Only do this if you trust the source of the data.

"},{"location":"games/sega/chunithm/newplus/troubleshooting/#my-game-is-running-too-slowfast","title":"My game is running too slow/fast","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Make sure your monitor's refresh rate is set to 60Hz or 120Hz.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/newplus/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chusanApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/newplus/troubleshooting/#my-game-crashes-when-i-tab-out-of-fullscreen","title":"My game crashes when I tab out of fullscreen!","text":"

As the game is intended to run on arcade hardware, it doesn't like being minimized.

One workaround for this is to use DXVK. Download the latest version from releases. This will be a dxvk-x.y.z.tar.gz file, which you can open using 7zip. Navigate to the x32 folder, and copy the d3d9.dll file to your game's App\\bin folder, agreeing to overwrite when asked.

You should now be able to tab out of fullscreen without crashing the game.

Warning

The game will not ignore inputs when out of focus.

This means any controller inputs will still be accepted, so try not to lean onto your slider whilst tabbed out!

This also means that you can accidentally enter the service menu by hitting your Test key even if the game is minimised. If you were in the middle of a credit, your scores will be lost.

"},{"location":"games/sega/chunithm/newplus/troubleshooting/#when-i-run-the-game-all-other-audio-is-gone","title":"When I run the game all other audio is gone!","text":"

CHUNITHM uses WASAPI exclusive mode for audio to get better latency.

You can apply the \"Shared Audio\" patch on a CHUNITHM web patcher (see Resources) to hear audio outside of the game at the cost of audio latency.

"},{"location":"games/sega/chunithm/newplus/troubleshooting/#cabinet-to-cabinetc2c-fixes","title":"Cabinet-to-Cabinet(c2c) Fixes","text":"

c2c can have many problems but you can fix most of them by applying the \"Patch for head-to-head play\" and disabling \"Set all timers to 999\" on a CHUNITHM web patcher (see Resources).

If the above does not work then please ensure both machines have the exact same data and can communicate with each other if they cannot then you can try disabling firewalls or changing the c2c group.

If clicking the c2c button does nothing, you can fix it by resetting the network settings in Windows.

"},{"location":"games/sega/chunithm/sun/c2c/","title":"Cab-to-Cab Play over Internet (SUN)","text":"

You are most likely to have success with Multiplayer when all users are using the SAME data and options, from the same sources. Verify that each person can run the game normally before attempting to network them together.

  • Chunithm expects the cabinets to be using specific IP addresses, 192.168.139.11/12/13/14
  • To achieve this over the internet, we can use SoftEther VPN. Refer to the Setting Up SoftEther VPN Guide for more information.
"},{"location":"games/sega/chunithm/sun/c2c/#configuring-segatoolsini-game-assignments","title":"Configuring segatools.ini & Game Assignments","text":"

segatools.ini

[netnev]\nenable=1\naddrSuffix= last 2 digits of your SoftEther IP\n\n[keychip]\nenable=1\nsubnet=192.168.139.0\nid=(Everyone needs a seperate keychip. If you play on a remote network, chances are you already have your own keychip. If not, you can use the example keychips below.)\n;example keychips: A61E-01D02321145 ; A61E-01A30831145 ; A61E-01E38091145 ; A61E-01E46241145\n\n[system]\ndipsw1=1\n;This has changed since Luminous. Previously if you wish to perform cab-to-cab link, you need to set this to 1 on the Server machine, and 0 on all other client machines.\n;This change is no longer needed, just keep this set to 1 on all machines.\n

GAME ASSIGNMENTS

  • After saving your segatools.ini, launch the game and go into the Service Menu > and go to GAME ASSIGNMENTS.

  • Enable CABINET-TO-CABINET PLAY, and make sure all machine are on the same group (Group A for example).

  • Set one machine to STANDARD, and all other machines to FOLLOW THE STANDARD .

Exit the Service Menu and load into Attract Mode. If the game passes the Group Check then chances are you're good to go! You can now login to a credit and open a cab-to-cab link request to check if the connection is working properly!

"},{"location":"games/sega/chunithm/sun/c2c/#how-to-link","title":"How to Link?","text":"

If you're new to Chunithm and have never tried link-play before and you have no idea how, keep reading.

  • Login to a credit.

  • If you're hosting a cab-to-cab session, choose a song first, then scroll to the far left and press Confirm. The cab-to-cab request is now open.

  • If you're connecting, navigate to the \"Cabinet-to-Cabinet Play\" tab and wait for other players to create a session.

If you are able to see each other's session, congrats! You can now enjoy some cab-to-cab chain action!

"},{"location":"games/sega/chunithm/sun/c2c/#troubleshooting","title":"Troubleshooting","text":"

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/sun/controllers/","title":"Controllers (SUN)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with IO DLLs to add support for controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\bin\\ folder and referenced in segatools.ini under the [chuniio] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; Uncomment this if you have custom chuniio implementation comprised of a single 32bit DLL.\n; (will use chu2to3 engine internally)\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.

If you have two DLLs, ending in _x86.dll and _x64.dll (or _chusan.dll and _amdaemon.dll), uncomment the path32= and path64= lines by removing the leading semicolon (;), then add your DLLs after the =:

[chuniio]\n; Uncomment both of these if you have custom chuniio implementation comprised of two DLLs.\n; x86 chuniio to path32, x64 to path64. Both are necessary.\n;(1)!\npath32=controller_x86.dll\npath64=controller_x64.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/sun/controllers/#keyboard","title":"Keyboard","text":"

Keyboard is the default input method, and while not recommended for playing the game, it is useful for testing purposes.

The default layout uses SDFGHJKL for slider input, and Space Bar for the AIRs.

If you wish to change the default keybinds, an explanation on how to set these is included above the [io3] section in your segatools.ini.

"},{"location":"games/sega/chunithm/sun/controllers/#brokenithm","title":"Brokenithm","text":"

Brokenithm allows you to use a mobile device as a CHUNITHM controller. It uses the bottom half of the screen as the ground slider, and sliding into the upper half activates the air sensors.

"},{"location":"games/sega/chunithm/sun/controllers/#android","title":"Android","text":"

Warning

Your computer and your Android device must be on the same local network.

  • Download the latest version of Brokenithm-Android and install it on your Android device.
  • Download the latest version of Brokenithm-Android-Server and extract only brokenithm_server.exe to your App\\bin\\ folder.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run brokenithm_server.exe. A command prompt window should open, saying that it is waiting for a device on port 52468.
  • Open the Brokenithm app on your Android device. Enter your computer's IP address in the Address box on the top right, then tap Start.
  • Run the game as normal.
Getting your computer's IP address

Open Settings -> Network and Internet and select Properties. Scroll down to the bottom and check the address under the IPv4 address field:

That is your computer's IP address.

Automatically launching the Brokenithm server when starting the game

This will only work if you extracted brokenithm_server.exe to App\\bin\\ as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min brokenithm_server\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Improving latency

You can improve latency by running Brokenithm with your Android device tethered to your computer. However, this requires a little extra setup:

  • Connect your Android device to your computer with a USB cable.
  • If you haven't enabled Developer options on your device, do it by navigating to the \"About\" page in your phone's settings, then tap \"Build number\" seven times. This varies by device, so if unsure, look up the instructions for your specific one.
  • Navigate to Developer options and enable USB debugging.
  • On your computer, download and extract Android SDK Platform Tools to your App\\bin\\ folder.
  • Navigate to the App\\bin\\platform-tools folder in File Explorer, click on the address bar, type cmd, and hit Enter to open a command prompt.
  • In the command prompt, type the following command:
adb reverse tcp:52468 tcp:52468\n
  • Start brokenithm_server in TCP mode with the -T command line flag, brokenithm_server.exe -T.
  • On your Android device, open Brokenithm, and change the address to 0.0.0.0.
    • If the text box to the left of the \"SETTINGS\" button say \"UDP\", tap on it once to switch to \"TCP\" mode.
  • Tap on \"START\", and you will now be connected via the USB cable.
  • You can now start the game as normal.

The next time you play the game, you only need to run the adb reverse ... command again. To do this automatically when the game starts, add a line to the start.bat script before the brokenithm_server line:

@echo off\n\npushd %~dp0\n\nstart /min platform-tools\\adb reverse tcp:52468 tcp:52468\nstart /min brokenithm_server -T\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/sun/controllers/#iosipados","title":"iOS/iPadOS","text":"
  • Install Brokenithm on your iOS/iPadOS device by joining the Brokenithm TestFlight (iOS 18 only).
    • If your iOS/iPadOS device doesn't have iOS 18, you will need to sideload a different IPA with Sideloadly.
  • If you have iTunes and/or iCloud installed from the Microsoft Store on your computer, uninstall it.
  • Install the non-Microsoft Store version of iTunes from the website.
  • Download the latest version of Brokenithm-Evolved-iOS server and extract it to App\\bin\\Brokenithm-Server.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run App\\bin\\Brokenithm-Server\\Brokenithm-Evolved-iOS.exe. A command prompt window should open, saying that it is waiting for a device.
  • On your iOS/iPadOS device, open Brokenithm, and connect it to your computer with a USB cable.
  • Run the game as normal.
Automatically launching the Brokenithm server when starting the game

This will only work if you extracted the server to App\\bin\\Brokenithm-Server as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min Brokenithm-Server\\Brokenithm-Evolved-iOS.exe\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/sun/controllers/#tasoller","title":"TASOLLER","text":"

Warning

This guide only covers TASOLLERs running the v2.0 touch firmware. If you've purchased the controller after January 2022, the update should have already been applied.

If you've purchased the controller before then, you will need to update the touch firmware by following the instructions on DJ-DAO's support page.

  • Install the custom IO4 firmware to your controller.
  • Follow the segatools.ini config on the gitea page.
  • Connect the controller to your computer, and then start the game.
Legacy
  • Backup TASOLLER setup if IO4 cfw is not working.
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download TASOLLER IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_v2_x86.dll\npath64=chuniio_tasoller_v2_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/sun/controllers/#tasoller-plus","title":"TASOLLER PLUS","text":"
  • Switch your TASOLLER PLUS to WINUSB mode. You can do so in TASOLLER Options found on the djdao support page.
  • Download TASOLLER PLUS IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_plus_x86.dll\npath64=chuniio_tasoller_plus_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/sun/controllers/#yubideck","title":"YubiDeck","text":"
  • Switch your YubiDeck to HID output mode. Instructions on how to do so are provided in the YubiDeck manual.
  • Download the latest version of YubiDeck IO DLLs and extract it to your App\\bin folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_yubideck_chusan.dll\npath64=chuniio_yubideck_amdaemon.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/sun/controllers/#laverita-3","title":"Laverita 3","text":"
  • Switch your Laverita to IO mode. You can do so in ConfigApp found in the yuancon discord.
  • Change the COM port of your controller. You can do so in Device manager by looking for USB Serial Device you may need to unplug and replug your controller to properly idetify which one is the Laverita.
  • Double click on it
  • Go to Port Settings
  • Click on Advanced
  • From the dropdown select COM1
  • Restart to ensure changes took effect and saved
  • Edit your App\\bin\\segatools.ini to disable io emulation and set led:
[led]\n; Output billboard LED strip data to a named pipe called \"\\\\.\\pipe\\chuni_led\"\ncabLedOutputPipe=0\n; Output billboard LED strip data to serial\ncabLedOutputSerial=1\n\n; Output slider LED data to the named pipe\ncontrollerLedOutputPipe=0\n; Output slider LED data to the serial port\ncontrollerLedOutputSerial=1\n; Use the OpeNITHM protocol for serial LED output\ncontrollerLedOutputOpeNITHM=0\n\n; Serial port to send data to if using serial output. Default is COM5.\nserialPort=COM1\n; Baud rate for serial data (set to 115200 if using OpeNITHM)\nserialBaud=9600\n\n[slider]\n; Enable slider emulation. If you have real AC slider, set this to 0.\n; Slider serial port must be COM1.\nenable=0\n\n[io4]\nenable=0\n
  • Then start the game.
Legacy
  • Backup Laverita 3 setup if IO4 cfw is not working.
  • Switch your Laverita to HID mode. You can do so in ConfigApp
  • Download Laverita IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_laverita_v3_x86.dll\npath64=chuniio_laverita_v3_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/sun/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet slider and air sensors, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/chunithm/sun/setup/","title":"Game Setup (SUN)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of CHUNITHM

You'll want to create a new folder for the game and start from scratch. CHUNITHM DOES NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/sun/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create another empty folder named AppData next to them. It should now look like below.

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/chunithm/sun/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/chunithm/sun/setup/#installing-option-data","title":"Installing option data","text":"

CHUNITHM content updates are distributed through option folders instead of patching the base game. They are named A???, with each ? being a number. Custom options distributed by the community might use letters instead, to distinguish them from official ones.

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

If you plan to connect to a network (Hosted or Local), the A001 option folder for your specific game version is required. This option contains a special Event file that lets the game connect.

"},{"location":"games/sega/chunithm/sun/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

CHUNITHM executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of chusanApp.exe and amdaemon.exe for your game version.

Copy chusanApp.exe and amdaemon.exe to the bin folder of your game data. Agree to overwrite when asked.

"},{"location":"games/sega/chunithm/sun/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/chunithm/sun/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher.

There are many patches for CHUNITHM.

We will only bring up the ones we think could be genuinely useful.

As a general rule of thumb, if you're not sure what a patch does or you're not absolutely certain you need it, leave it alone, regardless of recommendations below.

Patch Recommendation Description Force shared audio mode Either Force the game to use shared mode audio output, letting you listen to other audio sources while the game is running at the cost of audio latency. Force 2 channel audio output Either Try enabling this patch if you don't get audio output at all. Disable song select timer Either Disables the song select timer. No encryption ON Disable encrypting network requests. Required if you plan to run a local server. No TLS ON Disable checking if the server is HTTPS or not. Required if you plan to run a local server. Bypass 1080p monitor check Either Disable checking if the monitor is 1080p when enabling 120FPS. Enable if you cannot set your monitor to 1080p. Bypass 120Hz monitor check Either Disable checking if the monitor is exactly 120Hz when enabling 120FPS. Enable if you cannot set your monitor to 120Hz."},{"location":"games/sega/chunithm/sun/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download segatools.zip. Do not download the source code.
  • Extracting the archive should give you a few more zip files. Find chusan.zip and extract it to the App\\bin folder in your game data.

You should now have a few more files inside the folder, as highlighted:

"},{"location":"games/sega/chunithm/sun/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\bin\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[system]\ndipsw2=1\ndipsw2=1 ; WRONG!\n
"},{"location":"games/sega/chunithm/sun/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

Relative Directories

The ../ in the above example represents the parent directory in a relative path. It is used to navigate up one level in the directory hierarchy.

For example, your segatools.ini is located at /App/bin/segatools.ini and your Option folder is located next to the App folder.

Since segatools.ini is in the /bin/ folder, typing ../ would move you up to the App folder. Since the Option folder is next to the App folder, the second ../ takes you to App's parent folder, which is the folder containing App, Option, etc.

The benefits of using this method include:

  • Avoiding issues that arise when folders have spaces in their names.

  • Being able to move your game folder without redefining the locations of your VFS folders.

  • A cleaner and easier to read segatools.ini, making spotting issues simpler.

"},{"location":"games/sega/chunithm/sun/setup/#system","title":"[system]","text":"
  • If you have a 120Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n
"},{"location":"games/sega/chunithm/sun/setup/#gfx","title":"[gfx]","text":"
  • Set windowed to 0 to run in fullscreen mode and 1 to run in windowed mode.
  • If you have multiple monitors and you're running in fullscreen mode (windowed=0), set monitor to the index of the monitor you want to run the game on.
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number minus one. For example, monitor 2 means monitor index 1.

"},{"location":"games/sega/chunithm/sun/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.139.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\bin\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/sun/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/chunithm/sun/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/sun/setup/#audio","title":"Audio","text":"
  • Right-click on the volume setting in your taskbar and select Sounds.
  • Navigate to the Playback tab, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick either 16 bit, 48000Hz (DVD Quality) or 24 bit, 48000Hz (Studio Quality), click Apply, then OK.
"},{"location":"games/sega/chunithm/sun/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/chunithm/sun/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/chunithm/sun/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\bin\\start.bat. Let the game load until it reaches the screen below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 4th option).

Select \u30b0\u30eb\u30fc\u30d7\u5185\u57fa\u6e96\u6a5f\u8a2d\u5b9a (SET STANDARD IN GROUP, the second option) and toggle this setting to \u57fa\u6e96\u6a5f (STANDARD).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/chunithm/sun/setup/#close-setting","title":"CLOSE SETTING","text":"

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the 10th option).

Navigate to \u6642 (HOUR, the 2nd option) and use the Service button to toggle the setting until it says \u5168\u6642\u523b (ALL TIME).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu, then select \u7d42\u4e86 (also the last option) in the main menu to exit the service menu.

"},{"location":"games/sega/chunithm/sun/setup/#waiting-for-distribution-server","title":"Waiting for Distribution Server","text":"

If you're stuck at the Waiting for Distribution Server screen below, close the game and relaunch.

You're all done! The game should load up properly now.

You can add coins using the Coin key (default F3) and card in by holding the Enter key.

"},{"location":"games/sega/chunithm/sun/setup/#further-configuration","title":"Further configuration","text":"

Input methods and controllers are covered in the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/sun/troubleshooting/","title":"Troubleshooting (SUN)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/chunithm/sun/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch!","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120Hz, apply the \"Bypass 120Hz monitor check\"/\"Bypass 1080p monitor check\" on a CHUNITHM web patcher (see Resources).
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\nping 127.0.0.1 -n 31 > nul && taskkill /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/chunithm/sun/troubleshooting/#my-game-takes-a-long-time-to-boot","title":"My game takes a long time to boot!","text":"

CHUNITHM game files consist of thousands of small XML files, which Windows Defender takes a long time to scan through. Add your game folder to the Windows Defender exclusion list.

Danger

Doing this will prevent Windows Defender from scanning your game folder for viruses. Only do this if you trust the source of the data.

"},{"location":"games/sega/chunithm/sun/troubleshooting/#my-game-is-running-too-slowfast","title":"My game is running too slow/fast","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Make sure your monitor's refresh rate is set to 60Hz or 120Hz.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/sun/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chusanApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/sun/troubleshooting/#my-game-crashes-when-i-tab-out-of-fullscreen","title":"My game crashes when I tab out of fullscreen!","text":"

As the game is intended to run on arcade hardware, it doesn't like being minimized.

One workaround for this is to use DXVK. Download the latest version from releases. This will be a dxvk-x.y.z.tar.gz file, which you can open using 7zip. Navigate to the x32 folder, and copy the d3d9.dll file to your game's App\\bin folder, agreeing to overwrite when asked.

You should now be able to tab out of fullscreen without crashing the game.

Warning

The game will not ignore inputs when out of focus.

This means any controller inputs will still be accepted, so try not to lean onto your slider whilst tabbed out!

This also means that you can accidentally enter the service menu by hitting your Test key even if the game is minimised. If you were in the middle of a credit, your scores will be lost.

"},{"location":"games/sega/chunithm/sun/troubleshooting/#when-i-run-the-game-all-other-audio-is-gone","title":"When I run the game all other audio is gone!","text":"

CHUNITHM uses WASAPI exclusive mode for audio to get better latency.

You can apply the \"Shared Audio\" patch on a CHUNITHM web patcher (see Resources) to hear audio outside of the game at the cost of audio latency.

"},{"location":"games/sega/chunithm/sun/troubleshooting/#cabinet-to-cabinetc2c-fixes","title":"Cabinet-to-Cabinet(c2c) Fixes","text":"

c2c can have many problems but you can fix most of them by applying the \"Patch for head-to-head play\" and disabling \"Set all timers to 999\" on a CHUNITHM web patcher (see Resources).

If the above does not work then please ensure both machines have the exact same data and can communicate with each other if they cannot then you can try disabling firewalls or changing the c2c group.

If clicking the c2c button does nothing, you can fix it by resetting the network settings in Windows.

"},{"location":"games/sega/chunithm/sunplus/c2c/","title":"Cab-to-Cab Play over Internet (SUN PLUS)","text":"

You are most likely to have success with Multiplayer when all users are using the SAME data and options, from the same sources. Verify that each person can run the game normally before attempting to network them together.

  • Chunithm expects the cabinets to be using specific IP addresses, 192.168.139.11/12/13/14
  • To achieve this over the internet, we can use SoftEther VPN. Refer to the Setting Up SoftEther VPN Guide for more information.
"},{"location":"games/sega/chunithm/sunplus/c2c/#configuring-segatoolsini-game-assignments","title":"Configuring segatools.ini & Game Assignments","text":"

segatools.ini

[netnev]\nenable=1\naddrSuffix= last 2 digits of your SoftEther IP\n\n[keychip]\nenable=1\nsubnet=192.168.139.0\nid=(Everyone needs a seperate keychip. If you play on a remote network, chances are you already have your own keychip. If not, you can use the example keychips below.)\n;example keychips: A61E-01D02321145 ; A61E-01A30831145 ; A61E-01E38091145 ; A61E-01E46241145\n\n[system]\ndipsw1=1\n;This has changed since Luminous. Previously if you wish to perform cab-to-cab link, you need to set this to 1 on the Server machine, and 0 on all other client machines.\n;This change is no longer needed, just keep this set to 1 on all machines.\n

GAME ASSIGNMENTS

  • After saving your segatools.ini, launch the game and go into the Service Menu > and go to GAME ASSIGNMENTS.

  • Enable CABINET-TO-CABINET PLAY, and make sure all machine are on the same group (Group A for example).

  • Set one machine to STANDARD, and all other machines to FOLLOW THE STANDARD .

Exit the Service Menu and load into Attract Mode. If the game passes the Group Check then chances are you're good to go! You can now login to a credit and open a cab-to-cab link request to check if the connection is working properly!

"},{"location":"games/sega/chunithm/sunplus/c2c/#how-to-link","title":"How to Link?","text":"

If you're new to Chunithm and have never tried link-play before and you have no idea how, keep reading.

  • Login to a credit.

  • If you're hosting a cab-to-cab session, choose a song first, then scroll to the far left and press Confirm. The cab-to-cab request is now open.

  • If you're connecting, navigate to the \"Cabinet-to-Cabinet Play\" tab and wait for other players to create a session.

If you are able to see each other's session, congrats! You can now enjoy some cab-to-cab chain action!

"},{"location":"games/sega/chunithm/sunplus/c2c/#troubleshooting","title":"Troubleshooting","text":"

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/sunplus/controllers/","title":"Controllers (SUN PLUS)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with IO DLLs to add support for controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\bin\\ folder and referenced in segatools.ini under the [chuniio] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; Uncomment this if you have custom chuniio implementation comprised of a single 32bit DLL.\n; (will use chu2to3 engine internally)\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.

If you have two DLLs, ending in _x86.dll and _x64.dll (or _chusan.dll and _amdaemon.dll), uncomment the path32= and path64= lines by removing the leading semicolon (;), then add your DLLs after the =:

[chuniio]\n; Uncomment both of these if you have custom chuniio implementation comprised of two DLLs.\n; x86 chuniio to path32, x64 to path64. Both are necessary.\n;(1)!\npath32=controller_x86.dll\npath64=controller_x64.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/sunplus/controllers/#keyboard","title":"Keyboard","text":"

Keyboard is the default input method, and while not recommended for playing the game, it is useful for testing purposes.

The default layout uses SDFGHJKL for slider input, and Space Bar for the AIRs.

If you wish to change the default keybinds, an explanation on how to set these is included above the [io3] section in your segatools.ini.

"},{"location":"games/sega/chunithm/sunplus/controllers/#brokenithm","title":"Brokenithm","text":"

Brokenithm allows you to use a mobile device as a CHUNITHM controller. It uses the bottom half of the screen as the ground slider, and sliding into the upper half activates the air sensors.

"},{"location":"games/sega/chunithm/sunplus/controllers/#android","title":"Android","text":"

Warning

Your computer and your Android device must be on the same local network.

  • Download the latest version of Brokenithm-Android and install it on your Android device.
  • Download the latest version of Brokenithm-Android-Server and extract only brokenithm_server.exe to your App\\bin\\ folder.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run brokenithm_server.exe. A command prompt window should open, saying that it is waiting for a device on port 52468.
  • Open the Brokenithm app on your Android device. Enter your computer's IP address in the Address box on the top right, then tap Start.
  • Run the game as normal.
Getting your computer's IP address

Open Settings -> Network and Internet and select Properties. Scroll down to the bottom and check the address under the IPv4 address field:

That is your computer's IP address.

Automatically launching the Brokenithm server when starting the game

This will only work if you extracted brokenithm_server.exe to App\\bin\\ as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min brokenithm_server\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Improving latency

You can improve latency by running Brokenithm with your Android device tethered to your computer. However, this requires a little extra setup:

  • Connect your Android device to your computer with a USB cable.
  • If you haven't enabled Developer options on your device, do it by navigating to the \"About\" page in your phone's settings, then tap \"Build number\" seven times. This varies by device, so if unsure, look up the instructions for your specific one.
  • Navigate to Developer options and enable USB debugging.
  • On your computer, download and extract Android SDK Platform Tools to your App\\bin\\ folder.
  • Navigate to the App\\bin\\platform-tools folder in File Explorer, click on the address bar, type cmd, and hit Enter to open a command prompt.
  • In the command prompt, type the following command:
adb reverse tcp:52468 tcp:52468\n
  • Start brokenithm_server in TCP mode with the -T command line flag, brokenithm_server.exe -T.
  • On your Android device, open Brokenithm, and change the address to 0.0.0.0.
    • If the text box to the left of the \"SETTINGS\" button say \"UDP\", tap on it once to switch to \"TCP\" mode.
  • Tap on \"START\", and you will now be connected via the USB cable.
  • You can now start the game as normal.

The next time you play the game, you only need to run the adb reverse ... command again. To do this automatically when the game starts, add a line to the start.bat script before the brokenithm_server line:

@echo off\n\npushd %~dp0\n\nstart /min platform-tools\\adb reverse tcp:52468 tcp:52468\nstart /min brokenithm_server -T\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/sunplus/controllers/#iosipados","title":"iOS/iPadOS","text":"
  • Install Brokenithm on your iOS/iPadOS device by joining the Brokenithm TestFlight (iOS 18 only).
    • If your iOS/iPadOS device doesn't have iOS 18, you will need to sideload a different IPA with Sideloadly.
  • If you have iTunes and/or iCloud installed from the Microsoft Store on your computer, uninstall it.
  • Install the non-Microsoft Store version of iTunes from the website.
  • Download the latest version of Brokenithm-Evolved-iOS server and extract it to App\\bin\\Brokenithm-Server.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run App\\bin\\Brokenithm-Server\\Brokenithm-Evolved-iOS.exe. A command prompt window should open, saying that it is waiting for a device.
  • On your iOS/iPadOS device, open Brokenithm, and connect it to your computer with a USB cable.
  • Run the game as normal.
Automatically launching the Brokenithm server when starting the game

This will only work if you extracted the server to App\\bin\\Brokenithm-Server as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min Brokenithm-Server\\Brokenithm-Evolved-iOS.exe\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/sunplus/controllers/#tasoller","title":"TASOLLER","text":"

Warning

This guide only covers TASOLLERs running the v2.0 touch firmware. If you've purchased the controller after January 2022, the update should have already been applied.

If you've purchased the controller before then, you will need to update the touch firmware by following the instructions on DJ-DAO's support page.

  • Install the custom IO4 firmware to your controller.
  • Follow the segatools.ini config on the gitea page.
  • Connect the controller to your computer, and then start the game.
Legacy
  • Backup TASOLLER setup if IO4 cfw is not working.
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download TASOLLER IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_v2_x86.dll\npath64=chuniio_tasoller_v2_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/sunplus/controllers/#tasoller-plus","title":"TASOLLER PLUS","text":"
  • Switch your TASOLLER PLUS to WINUSB mode. You can do so in TASOLLER Options found on the djdao support page.
  • Download TASOLLER PLUS IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_plus_x86.dll\npath64=chuniio_tasoller_plus_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/sunplus/controllers/#yubideck","title":"YubiDeck","text":"
  • Switch your YubiDeck to HID output mode. Instructions on how to do so are provided in the YubiDeck manual.
  • Download the latest version of YubiDeck IO DLLs and extract it to your App\\bin folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_yubideck_chusan.dll\npath64=chuniio_yubideck_amdaemon.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/sunplus/controllers/#laverita-3","title":"Laverita 3","text":"
  • Switch your Laverita to IO mode. You can do so in ConfigApp found in the yuancon discord.
  • Change the COM port of your controller. You can do so in Device manager by looking for USB Serial Device you may need to unplug and replug your controller to properly idetify which one is the Laverita.
  • Double click on it
  • Go to Port Settings
  • Click on Advanced
  • From the dropdown select COM1
  • Restart to ensure changes took effect and saved
  • Edit your App\\bin\\segatools.ini to disable io emulation and set led:
[led]\n; Output billboard LED strip data to a named pipe called \"\\\\.\\pipe\\chuni_led\"\ncabLedOutputPipe=0\n; Output billboard LED strip data to serial\ncabLedOutputSerial=1\n\n; Output slider LED data to the named pipe\ncontrollerLedOutputPipe=0\n; Output slider LED data to the serial port\ncontrollerLedOutputSerial=1\n; Use the OpeNITHM protocol for serial LED output\ncontrollerLedOutputOpeNITHM=0\n\n; Serial port to send data to if using serial output. Default is COM5.\nserialPort=COM1\n; Baud rate for serial data (set to 115200 if using OpeNITHM)\nserialBaud=9600\n\n[slider]\n; Enable slider emulation. If you have real AC slider, set this to 0.\n; Slider serial port must be COM1.\nenable=0\n\n[io4]\nenable=0\n
  • Then start the game.
Legacy
  • Backup Laverita 3 setup if IO4 cfw is not working.
  • Switch your Laverita to HID mode. You can do so in ConfigApp
  • Download Laverita IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_laverita_v3_x86.dll\npath64=chuniio_laverita_v3_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/sunplus/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet slider and air sensors, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/chunithm/sunplus/setup/","title":"Game Setup (SUN PLUS)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of CHUNITHM

You'll want to create a new folder for the game and start from scratch. CHUNITHM DOES NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/sunplus/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create another empty folder named AppData next to them. It should now look like below.

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/chunithm/sunplus/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/chunithm/sunplus/setup/#installing-option-data","title":"Installing option data","text":"

CHUNITHM content updates are distributed through option folders instead of patching the base game. They are named A???, with each ? being a number. Custom options distributed by the community might use letters instead, to distinguish them from official ones.

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

If you plan to connect to a network (Hosted or Local), the A001 option folder for your specific game version is required. This option contains a special Event file that lets the game connect.

"},{"location":"games/sega/chunithm/sunplus/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

CHUNITHM executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of chusanApp.exe and amdaemon.exe for your game version.

Copy chusanApp.exe and amdaemon.exe to the bin folder of your game data. Agree to overwrite when asked.

"},{"location":"games/sega/chunithm/sunplus/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/chunithm/sunplus/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher.

There are many patches for CHUNITHM.

We will only bring up the ones we think could be genuinely useful.

As a general rule of thumb, if you're not sure what a patch does or you're not absolutely certain you need it, leave it alone, regardless of recommendations below.

Patch Recommendation Description Force shared audio mode Either Force the game to use shared mode audio output, letting you listen to other audio sources while the game is running at the cost of audio latency. Force 2 channel audio output Either Try enabling this patch if you don't get audio output at all. Disable song select timer Either Disables the song select timer. No encryption ON Disable encrypting network requests. Required if you plan to run a local server. No TLS ON Disable checking if the server is HTTPS or not. Required if you plan to run a local server. Bypass 1080p monitor check Either Disable checking if the monitor is 1080p when enabling 120FPS. Enable if you cannot set your monitor to 1080p. Bypass 120Hz monitor check Either Disable checking if the monitor is exactly 120Hz when enabling 120FPS. Enable if you cannot set your monitor to 120Hz."},{"location":"games/sega/chunithm/sunplus/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download segatools.zip. Do not download the source code.
  • Extracting the archive should give you a few more zip files. Find chusan.zip and extract it to the App\\bin folder in your game data.

You should now have a few more files inside the folder, as highlighted:

"},{"location":"games/sega/chunithm/sunplus/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\bin\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[system]\ndipsw2=1\ndipsw2=1 ; WRONG!\n
"},{"location":"games/sega/chunithm/sunplus/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

Relative Directories

The ../ in the above example represents the parent directory in a relative path. It is used to navigate up one level in the directory hierarchy.

For example, your segatools.ini is located at /App/bin/segatools.ini and your Option folder is located next to the App folder.

Since segatools.ini is in the /bin/ folder, typing ../ would move you up to the App folder. Since the Option folder is next to the App folder, the second ../ takes you to App's parent folder, which is the folder containing App, Option, etc.

The benefits of using this method include:

  • Avoiding issues that arise when folders have spaces in their names.

  • Being able to move your game folder without redefining the locations of your VFS folders.

  • A cleaner and easier to read segatools.ini, making spotting issues simpler.

"},{"location":"games/sega/chunithm/sunplus/setup/#system","title":"[system]","text":"
  • If you have a 120Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n
"},{"location":"games/sega/chunithm/sunplus/setup/#gfx","title":"[gfx]","text":"
  • Set windowed to 0 to run in fullscreen mode and 1 to run in windowed mode.
  • If you have multiple monitors and you're running in fullscreen mode (windowed=0), set monitor to the index of the monitor you want to run the game on.
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number minus one. For example, monitor 2 means monitor index 1.

"},{"location":"games/sega/chunithm/sunplus/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.139.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\bin\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/sunplus/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/chunithm/sunplus/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/sunplus/setup/#audio","title":"Audio","text":"
  • Right-click on the volume setting in your taskbar and select Sounds.
  • Navigate to the Playback tab, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick either 16 bit, 48000Hz (DVD Quality) or 24 bit, 48000Hz (Studio Quality), click Apply, then OK.
"},{"location":"games/sega/chunithm/sunplus/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/chunithm/sunplus/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/chunithm/sunplus/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\bin\\start.bat. Let the game load until it reaches the screen below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 4th option).

Select \u30b0\u30eb\u30fc\u30d7\u5185\u57fa\u6e96\u6a5f\u8a2d\u5b9a (SET STANDARD IN GROUP, the second option) and toggle this setting to \u57fa\u6e96\u6a5f (STANDARD).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/chunithm/sunplus/setup/#close-setting","title":"CLOSE SETTING","text":"

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the 10th option).

Navigate to \u6642 (HOUR, the 2nd option) and use the Service button to toggle the setting until it says \u5168\u6642\u523b (ALL TIME).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu, then select \u7d42\u4e86 (also the last option) in the main menu to exit the service menu.

"},{"location":"games/sega/chunithm/sunplus/setup/#waiting-for-distribution-server","title":"Waiting for Distribution Server","text":"

If you're stuck at the Waiting for Distribution Server screen below, close the game and relaunch.

You're all done! The game should load up properly now.

You can add coins using the Coin key (default F3) and card in by holding the Enter key.

"},{"location":"games/sega/chunithm/sunplus/setup/#further-configuration","title":"Further configuration","text":"

Input methods and controllers are covered in the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/sunplus/troubleshooting/","title":"Troubleshooting (SUN PLUS)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/chunithm/sunplus/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch!","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120Hz, apply the \"Bypass 120Hz monitor check\"/\"Bypass 1080p monitor check\" on a CHUNITHM web patcher (see Resources).
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\nping 127.0.0.1 -n 31 > nul && taskkill /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/chunithm/sunplus/troubleshooting/#my-game-takes-a-long-time-to-boot","title":"My game takes a long time to boot!","text":"

CHUNITHM game files consist of thousands of small XML files, which Windows Defender takes a long time to scan through. Add your game folder to the Windows Defender exclusion list.

Danger

Doing this will prevent Windows Defender from scanning your game folder for viruses. Only do this if you trust the source of the data.

"},{"location":"games/sega/chunithm/sunplus/troubleshooting/#my-game-is-running-too-slowfast","title":"My game is running too slow/fast","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Make sure your monitor's refresh rate is set to 60Hz or 120Hz.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/sunplus/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chusanApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/sunplus/troubleshooting/#my-game-crashes-when-i-tab-out-of-fullscreen","title":"My game crashes when I tab out of fullscreen!","text":"

As the game is intended to run on arcade hardware, it doesn't like being minimized.

One workaround for this is to use DXVK. Download the latest version from releases. This will be a dxvk-x.y.z.tar.gz file, which you can open using 7zip. Navigate to the x32 folder, and copy the d3d9.dll file to your game's App\\bin folder, agreeing to overwrite when asked.

You should now be able to tab out of fullscreen without crashing the game.

Warning

The game will not ignore inputs when out of focus.

This means any controller inputs will still be accepted, so try not to lean onto your slider whilst tabbed out!

This also means that you can accidentally enter the service menu by hitting your Test key even if the game is minimised. If you were in the middle of a credit, your scores will be lost.

"},{"location":"games/sega/chunithm/sunplus/troubleshooting/#when-i-run-the-game-all-other-audio-is-gone","title":"When I run the game all other audio is gone!","text":"

CHUNITHM uses WASAPI exclusive mode for audio to get better latency.

You can apply the \"Shared Audio\" patch on a CHUNITHM web patcher (see Resources) to hear audio outside of the game at the cost of audio latency.

"},{"location":"games/sega/chunithm/sunplus/troubleshooting/#cabinet-to-cabinetc2c-fixes","title":"Cabinet-to-Cabinet(c2c) Fixes","text":"

c2c can have many problems but you can fix most of them by applying the \"Patch for head-to-head play\" and disabling \"Set all timers to 999\" on a CHUNITHM web patcher (see Resources).

If the above does not work then please ensure both machines have the exact same data and can communicate with each other if they cannot then you can try disabling firewalls or changing the c2c group.

If clicking the c2c button does nothing, you can fix it by resetting the network settings in Windows.

"},{"location":"games/sega/chunithm/verse/c2c/","title":"Cab-to-Cab Play over Internet (VERSE)","text":"

You are most likely to have success with Multiplayer when all users are using the SAME data and options, from the same sources. Verify that each person can run the game normally before attempting to network them together.

  • Chunithm expects the cabinets to be using specific IP addresses, 192.168.139.11/12/13/14
  • To achieve this over the internet, we can use SoftEther VPN. Refer to the Setting Up SoftEther VPN Guide for more information.
"},{"location":"games/sega/chunithm/verse/c2c/#configuring-segatoolsini-game-assignments","title":"Configuring segatools.ini & Game Assignments","text":"

segatools.ini

[netnev]\nenable=1\naddrSuffix= last 2 digits of your SoftEther IP\n\n[keychip]\nenable=1\nsubnet=192.168.139.0\nid=(Everyone needs a seperate keychip. If you play on a remote network, chances are you already have your own keychip. If not, you can use the example keychips below.)\n;example keychips: A61E-01D02321145 ; A61E-01A30831145 ; A61E-01E38091145 ; A61E-01E46241145\n\n[system]\ndipsw1=1\n;This has changed since Luminous. Previously if you wish to perform cab-to-cab link, you need to set this to 1 on the Server machine, and 0 on all other client machines.\n;This change is no longer needed, just keep this set to 1 on all machines.\n

GAME ASSIGNMENTS

  • After saving your segatools.ini, launch the game and go into the Service Menu > and go to GAME ASSIGNMENTS.

  • Enable CABINET-TO-CABINET PLAY, and make sure all machine are on the same group (Group A for example).

  • Set one machine to STANDARD, and all other machines to FOLLOW THE STANDARD .

Exit the Service Menu and load into Attract Mode. If the game passes the Group Check then chances are you're good to go! You can now login to a credit and open a cab-to-cab link request to check if the connection is working properly!

"},{"location":"games/sega/chunithm/verse/c2c/#how-to-link","title":"How to Link?","text":"

If you're new to Chunithm and have never tried link-play before and you have no idea how, keep reading.

  • Login to a credit.

  • If you're hosting a cab-to-cab session, choose a song first, then scroll to the far left and press Confirm. The cab-to-cab request is now open.

  • If you're connecting, navigate to the \"Cabinet-to-Cabinet Play\" tab and wait for other players to create a session.

If you are able to see each other's session, congrats! You can now enjoy some cab-to-cab chain action!

"},{"location":"games/sega/chunithm/verse/c2c/#troubleshooting","title":"Troubleshooting","text":"

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/verse/controllers/","title":"Controllers (VERSE)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with IO DLLs to add support for controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\bin\\ folder and referenced in segatools.ini under the [chuniio] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; Uncomment this if you have custom chuniio implementation comprised of a single 32bit DLL.\n; (will use chu2to3 engine internally)\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.

If you have two DLLs, ending in _x86.dll and _x64.dll (or _chusan.dll and _amdaemon.dll), uncomment the path32= and path64= lines by removing the leading semicolon (;), then add your DLLs after the =:

[chuniio]\n; Uncomment both of these if you have custom chuniio implementation comprised of two DLLs.\n; x86 chuniio to path32, x64 to path64. Both are necessary.\n;(1)!\npath32=controller_x86.dll\npath64=controller_x64.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/verse/controllers/#keyboard","title":"Keyboard","text":"

Keyboard is the default input method, and while not recommended for playing the game, it is useful for testing purposes.

The default layout uses SDFGHJKL for slider input, and Space Bar for the AIRs.

If you wish to change the default keybinds, an explanation on how to set these is included above the [io3] section in your segatools.ini.

"},{"location":"games/sega/chunithm/verse/controllers/#brokenithm","title":"Brokenithm","text":"

Brokenithm allows you to use a mobile device as a CHUNITHM controller. It uses the bottom half of the screen as the ground slider, and sliding into the upper half activates the air sensors.

"},{"location":"games/sega/chunithm/verse/controllers/#android","title":"Android","text":"

Warning

Your computer and your Android device must be on the same local network.

  • Download the latest version of Brokenithm-Android and install it on your Android device.
  • Download the latest version of Brokenithm-Android-Server and extract only brokenithm_server.exe to your App\\bin\\ folder.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run brokenithm_server.exe. A command prompt window should open, saying that it is waiting for a device on port 52468.
  • Open the Brokenithm app on your Android device. Enter your computer's IP address in the Address box on the top right, then tap Start.
  • Run the game as normal.
Getting your computer's IP address

Open Settings -> Network and Internet and select Properties. Scroll down to the bottom and check the address under the IPv4 address field:

That is your computer's IP address.

Automatically launching the Brokenithm server when starting the game

This will only work if you extracted brokenithm_server.exe to App\\bin\\ as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min brokenithm_server\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Improving latency

You can improve latency by running Brokenithm with your Android device tethered to your computer. However, this requires a little extra setup:

  • Connect your Android device to your computer with a USB cable.
  • If you haven't enabled Developer options on your device, do it by navigating to the \"About\" page in your phone's settings, then tap \"Build number\" seven times. This varies by device, so if unsure, look up the instructions for your specific one.
  • Navigate to Developer options and enable USB debugging.
  • On your computer, download and extract Android SDK Platform Tools to your App\\bin\\ folder.
  • Navigate to the App\\bin\\platform-tools folder in File Explorer, click on the address bar, type cmd, and hit Enter to open a command prompt.
  • In the command prompt, type the following command:
adb reverse tcp:52468 tcp:52468\n
  • Start brokenithm_server in TCP mode with the -T command line flag, brokenithm_server.exe -T.
  • On your Android device, open Brokenithm, and change the address to 0.0.0.0.
    • If the text box to the left of the \"SETTINGS\" button say \"UDP\", tap on it once to switch to \"TCP\" mode.
  • Tap on \"START\", and you will now be connected via the USB cable.
  • You can now start the game as normal.

The next time you play the game, you only need to run the adb reverse ... command again. To do this automatically when the game starts, add a line to the start.bat script before the brokenithm_server line:

@echo off\n\npushd %~dp0\n\nstart /min platform-tools\\adb reverse tcp:52468 tcp:52468\nstart /min brokenithm_server -T\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/verse/controllers/#iosipados","title":"iOS/iPadOS","text":"
  • Install Brokenithm on your iOS/iPadOS device by joining the Brokenithm TestFlight (iOS 18 only).
    • If your iOS/iPadOS device doesn't have iOS 18, you will need to sideload a different IPA with Sideloadly.
  • If you have iTunes and/or iCloud installed from the Microsoft Store on your computer, uninstall it.
  • Install the non-Microsoft Store version of iTunes from the website.
  • Download the latest version of Brokenithm-Evolved-iOS server and extract it to App\\bin\\Brokenithm-Server.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run App\\bin\\Brokenithm-Server\\Brokenithm-Evolved-iOS.exe. A command prompt window should open, saying that it is waiting for a device.
  • On your iOS/iPadOS device, open Brokenithm, and connect it to your computer with a USB cable.
  • Run the game as normal.
Automatically launching the Brokenithm server when starting the game

This will only work if you extracted the server to App\\bin\\Brokenithm-Server as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min Brokenithm-Server\\Brokenithm-Evolved-iOS.exe\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/verse/controllers/#tasoller","title":"TASOLLER","text":"

Warning

This guide only covers TASOLLERs running the v2.0 touch firmware. If you've purchased the controller after January 2022, the update should have already been applied.

If you've purchased the controller before then, you will need to update the touch firmware by following the instructions on DJ-DAO's support page.

  • Install the custom IO4 firmware to your controller.
  • Follow the segatools.ini config on the gitea page.
  • Connect the controller to your computer, and then start the game.
Legacy
  • Backup TASOLLER setup if IO4 cfw is not working.
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download TASOLLER IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_v2_x86.dll\npath64=chuniio_tasoller_v2_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/verse/controllers/#tasoller-plus","title":"TASOLLER PLUS","text":"
  • Switch your TASOLLER PLUS to WINUSB mode. You can do so in TASOLLER Options found on the djdao support page.
  • Download TASOLLER PLUS IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_plus_x86.dll\npath64=chuniio_tasoller_plus_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/verse/controllers/#yubideck","title":"YubiDeck","text":"
  • Switch your YubiDeck to HID output mode. Instructions on how to do so are provided in the YubiDeck manual.
  • Download the latest version of YubiDeck IO DLLs and extract it to your App\\bin folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_yubideck_chusan.dll\npath64=chuniio_yubideck_amdaemon.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/verse/controllers/#laverita-3","title":"Laverita 3","text":"
  • Switch your Laverita to IO mode. You can do so in ConfigApp found in the yuancon discord.
  • Change the COM port of your controller. You can do so in Device manager by looking for USB Serial Device you may need to unplug and replug your controller to properly idetify which one is the Laverita.
  • Double click on it
  • Go to Port Settings
  • Click on Advanced
  • From the dropdown select COM1
  • Restart to ensure changes took effect and saved
  • Edit your App\\bin\\segatools.ini to disable io emulation and set led:
[led]\n; Output billboard LED strip data to a named pipe called \"\\\\.\\pipe\\chuni_led\"\ncabLedOutputPipe=0\n; Output billboard LED strip data to serial\ncabLedOutputSerial=1\n\n; Output slider LED data to the named pipe\ncontrollerLedOutputPipe=0\n; Output slider LED data to the serial port\ncontrollerLedOutputSerial=1\n; Use the OpeNITHM protocol for serial LED output\ncontrollerLedOutputOpeNITHM=0\n\n; Serial port to send data to if using serial output. Default is COM5.\nserialPort=COM1\n; Baud rate for serial data (set to 115200 if using OpeNITHM)\nserialBaud=9600\n\n[slider]\n; Enable slider emulation. If you have real AC slider, set this to 0.\n; Slider serial port must be COM1.\nenable=0\n\n[io4]\nenable=0\n
  • Then start the game.
Legacy
  • Backup Laverita 3 setup if IO4 cfw is not working.
  • Switch your Laverita to HID mode. You can do so in ConfigApp
  • Download Laverita IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_laverita_v3_x86.dll\npath64=chuniio_laverita_v3_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/verse/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet slider and air sensors, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/chunithm/verse/setup/","title":"Game Setup (VERSE)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of CHUNITHM

You'll want to create a new folder for the game and start from scratch. CHUNITHM DOES NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/verse/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create another empty folder named AppData next to them. It should now look like below.

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/chunithm/verse/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/chunithm/verse/setup/#installing-option-data","title":"Installing option data","text":"

CHUNITHM content updates are distributed through option folders instead of patching the base game. They are named A???, with each ? being a number. Custom options distributed by the community might use letters instead, to distinguish them from official ones.

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

If you plan to connect to a network (Hosted or Local), the A001 option folder for your specific game version is required. This option contains a special Event file that lets the game connect.

"},{"location":"games/sega/chunithm/verse/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

CHUNITHM executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of chusanApp.exe and amdaemon.exe for your game version.

Copy chusanApp.exe and amdaemon.exe to the bin folder of your game data. Agree to overwrite when asked.

"},{"location":"games/sega/chunithm/verse/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/chunithm/verse/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher.

There are many patches for CHUNITHM.

We will only bring up the ones we think could be genuinely useful.

As a general rule of thumb, if you're not sure what a patch does or you're not absolutely certain you need it, leave it alone, regardless of recommendations below.

Patch Recommendation Description Force shared audio mode Either Force the game to use shared mode audio output, letting you listen to other audio sources while the game is running at the cost of audio latency. Force 2 channel audio output Either Try enabling this patch if you don't get audio output at all. Disable song select timer Either Disables the song select timer. No encryption ON Disable encrypting network requests. Required if you plan to run a local server. No TLS ON Disable checking if the server is HTTPS or not. Required if you plan to run a local server. Bypass 1080p monitor check Either Disable checking if the monitor is 1080p when enabling 120FPS. Enable if you cannot set your monitor to 1080p. Bypass 120Hz monitor check Either Disable checking if the monitor is exactly 120Hz when enabling 120FPS. Enable if you cannot set your monitor to 120Hz."},{"location":"games/sega/chunithm/verse/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download segatools.zip. Do not download the source code.
  • Extracting the archive should give you a few more zip files. Find chusan.zip and extract it to the App\\bin folder in your game data.

You should now have a few more files inside the folder, as highlighted:

"},{"location":"games/sega/chunithm/verse/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\bin\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[system]\ndipsw2=1\ndipsw2=1 ; WRONG!\n
"},{"location":"games/sega/chunithm/verse/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

Relative Directories

The ../ in the above example represents the parent directory in a relative path. It is used to navigate up one level in the directory hierarchy.

For example, your segatools.ini is located at /App/bin/segatools.ini and your Option folder is located next to the App folder.

Since segatools.ini is in the /bin/ folder, typing ../ would move you up to the App folder. Since the Option folder is next to the App folder, the second ../ takes you to App's parent folder, which is the folder containing App, Option, etc.

The benefits of using this method include:

  • Avoiding issues that arise when folders have spaces in their names.

  • Being able to move your game folder without redefining the locations of your VFS folders.

  • A cleaner and easier to read segatools.ini, making spotting issues simpler.

"},{"location":"games/sega/chunithm/verse/setup/#system","title":"[system]","text":"
  • If you have a 120Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n
"},{"location":"games/sega/chunithm/verse/setup/#gfx","title":"[gfx]","text":"
  • Set windowed to 0 to run in fullscreen mode and 1 to run in windowed mode.
  • If you have multiple monitors and you're running in fullscreen mode (windowed=0), set monitor to the index of the monitor you want to run the game on.
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number minus one. For example, monitor 2 means monitor index 1.

"},{"location":"games/sega/chunithm/verse/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.139.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\bin\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/verse/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/chunithm/verse/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/verse/setup/#audio","title":"Audio","text":"
  • Right-click on the volume setting in your taskbar and select Sounds.
  • Navigate to the Playback tab, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick either 16 bit, 48000Hz (DVD Quality) or 24 bit, 48000Hz (Studio Quality), click Apply, then OK.
"},{"location":"games/sega/chunithm/verse/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/chunithm/verse/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/chunithm/verse/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\bin\\start.bat. Let the game load until it reaches the screen below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 4th option).

Select \u30b0\u30eb\u30fc\u30d7\u5185\u57fa\u6e96\u6a5f\u8a2d\u5b9a (SET STANDARD IN GROUP, the second option) and toggle this setting to \u57fa\u6e96\u6a5f (STANDARD).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/chunithm/verse/setup/#close-setting","title":"CLOSE SETTING","text":"

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the 10th option).

Navigate to \u6642 (HOUR, the 2nd option) and use the Service button to toggle the setting until it says \u5168\u6642\u523b (ALL TIME).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu, then select \u7d42\u4e86 (also the last option) in the main menu to exit the service menu.

"},{"location":"games/sega/chunithm/verse/setup/#waiting-for-distribution-server","title":"Waiting for Distribution Server","text":"

If you're stuck at the Waiting for Distribution Server screen below, close the game and relaunch.

You're all done! The game should load up properly now.

You can add coins using the Coin key (default F3) and card in by holding the Enter key.

"},{"location":"games/sega/chunithm/verse/setup/#further-configuration","title":"Further configuration","text":"

Input methods and controllers are covered in the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/verse/troubleshooting/","title":"Troubleshooting (VERSE)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/chunithm/verse/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch!","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120Hz, apply the \"Bypass 120Hz monitor check\"/\"Bypass 1080p monitor check\" on a CHUNITHM web patcher (see Resources).
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\nping 127.0.0.1 -n 31 > nul && taskkill /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/chunithm/verse/troubleshooting/#my-game-takes-a-long-time-to-boot","title":"My game takes a long time to boot!","text":"

CHUNITHM game files consist of thousands of small XML files, which Windows Defender takes a long time to scan through. Add your game folder to the Windows Defender exclusion list.

Danger

Doing this will prevent Windows Defender from scanning your game folder for viruses. Only do this if you trust the source of the data.

"},{"location":"games/sega/chunithm/verse/troubleshooting/#my-game-is-running-too-slowfast","title":"My game is running too slow/fast","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Make sure your monitor's refresh rate is set to 60Hz or 120Hz.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/verse/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chusanApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/verse/troubleshooting/#my-game-crashes-when-i-tab-out-of-fullscreen","title":"My game crashes when I tab out of fullscreen!","text":"

As the game is intended to run on arcade hardware, it doesn't like being minimized.

One workaround for this is to use DXVK. Download the latest version from releases. This will be a dxvk-x.y.z.tar.gz file, which you can open using 7zip. Navigate to the x32 folder, and copy the d3d9.dll file to your game's App\\bin folder, agreeing to overwrite when asked.

You should now be able to tab out of fullscreen without crashing the game.

Warning

The game will not ignore inputs when out of focus.

This means any controller inputs will still be accepted, so try not to lean onto your slider whilst tabbed out!

This also means that you can accidentally enter the service menu by hitting your Test key even if the game is minimised. If you were in the middle of a credit, your scores will be lost.

"},{"location":"games/sega/chunithm/verse/troubleshooting/#when-i-run-the-game-all-other-audio-is-gone","title":"When I run the game all other audio is gone!","text":"

CHUNITHM uses WASAPI exclusive mode for audio to get better latency.

You can apply the \"Shared Audio\" patch on a CHUNITHM web patcher (see Resources) to hear audio outside of the game at the cost of audio latency.

"},{"location":"games/sega/chunithm/verse/troubleshooting/#cabinet-to-cabinetc2c-fixes","title":"Cabinet-to-Cabinet(c2c) Fixes","text":"

c2c can have many problems but you can fix most of them by applying the \"Patch for head-to-head play\" and disabling \"Set all timers to 999\" on a CHUNITHM web patcher (see Resources).

If the above does not work then please ensure both machines have the exact same data and can communicate with each other if they cannot then you can try disabling firewalls or changing the c2c group.

If clicking the c2c button does nothing, you can fix it by resetting the network settings in Windows.

"},{"location":"games/sega/maimaidx/buddies/controllers/","title":"maimai DX BUDDiES","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with IO DLLs to add support for controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\Package folder and referenced in segatools.ini under the [mai2io] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[mai2io]\n; To use a custom maimai DX IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/maimaidx/buddies/controllers/#keyboardtouchscreen","title":"Keyboard/Touchscreen","text":"

Keyboard/Touchscreen is the default input method

The default layout uses QWEDCXZA for physical buttons (each key representing the physical button's location relative to the center screen)

If you wish to change the default keybinds, an explanation on how to set these is included above the [io4] section in your segatools.ini.

Touch input should automatically work after connecting a touch-screen display

"},{"location":"games/sega/maimaidx/buddies/controllers/#adx-controller","title":"ADX Controller","text":"

First, you will need to purchase a compatible monitor if your controller did not come with one. A list of compatible monitors can be found on this spreadsheet

Plug your controller in and open Device Manager.

Under the Ports (COM & LPT) section, ensure the correct ports are set for both the Touch Panel and Button LED.

  • (Touch Panel) USB Serial Device: COM3
  • (Button LED) USB-SERIAL CH340: COM21

If they are different change the port of the device by Right Clicking on the Device -> Properties -> Port Settings -> COM Port Number

Finally ensure the mai2.ini file in your data's App/Package folder has the following values set under the [AM] section 

[AM]\nTarget=0\nDummyTouchPanel=0\nDummyLED=0\n

This gets your controller working with keyboard inputs. Its highly recommended that you also view this setup guide which provides more detailed instructions, improved drivers, and help with adjusting touch panel sensitivity.

Warning

You DO NOT need to follow the Network Setup steps in the linked guide above if you've already done so while setting up game data

You DO NOT need to follow the Aime Reader setup in the linked guide above if you do not own one.

"},{"location":"games/sega/maimaidx/buddies/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/maimaidx/buddies/setup/","title":"maimai DX BUDDiES","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of maimai DX

Create a new folder for the game and start from scratch. maimai DX DOES NOT like being extracted over old data!

"},{"location":"games/sega/maimaidx/buddies/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files are not set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and filesand press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create two new empty folders named appdata and amfs (and the folder option if not present) next to them as shown below:

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/maimaidx/buddies/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/maimaidx/buddies/setup/#installing-option-data","title":"Installing option data","text":"

maimai DX content updates are distributed through option folders instead of patching the base game.

Options are named with a letter followed by three numbers.

For JPN(SDEZ) data, each new release of maimai DX increments the first letter of the Option (ie. BUDDiES is H??? and BUDDiES+ is I???).

For EXP(SDGA) data, Options will always begin with the letter A (i.e A???)

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

Do not mix option data between versions

"},{"location":"games/sega/maimaidx/buddies/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

maimai DX executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of the following files and the associated configuration file:

  • amdaemon.exe
  • Sinmai.exe
  • Sinmai_Data/Plugins/amdaemon_api.dll
  • Sinmai_Data/Plugins/Cake.dll (JPN/SDEZ only)
  • Sinmai_Data/Managed/AMDaemon.NET.dll
  • Sinmai_Data/Managed/Assembly-CSharp.dll
  • mai2.ini

Copy the files and folders into the App/Package folder of your game data. Agree to overwrite when asked.

Assembly-CSharp Notes

Assembly-CSharp.dll must match your game version. All others can be reused from other game versions.

"},{"location":"games/sega/maimaidx/buddies/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/maimaidx/buddies/setup/#mai2ini","title":"mai2.ini","text":"

Ensure that the App\\Package folder contains mai2.ini.

If this configuration file is missing, create one using the contents below.

[Debug]\nDebug=1\n\n[AM]\nTarget=0\nIgnoreError=1\nDummyTouchPanel=1\nDummyLED=1\nDummyCodeCamera=1\nDummyPhotoCamera=1\n\n[Sound]\nSound8Ch=0\n
"},{"location":"games/sega/maimaidx/buddies/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download the segatools.zip from 2024-03-13. Do not download the source code or latest release.
  • Extracting the archive should give you a few more zip files. Find mai2.zip and extract it to the App/Package folder in your game data.

You should now have a few more files inside the App/Package folder, as highlighted:

Warning

The latest release of segatools currently has issues with maimai, and for the time being an older version of segatools is preferred.

"},{"location":"games/sega/maimaidx/buddies/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\package\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[gpio]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
"},{"location":"games/sega/maimaidx/buddies/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n
AquaMai

It's strongly recommended to use MelonLoader mods to improve QOL. You can find info about the available mods for maimai here AquaMai. For general modding check Unity modding page.

"},{"location":"games/sega/maimaidx/buddies/setup/#setting-launch-options","title":"Setting launch options","text":"

Right click App\\package\\start.bat, select Edit. Locate the line that launches sinmai and edit it according to your preferences:

@echo off\n\npushd %~dp0\n\nstart \"AM Daemon\" /min inject -d -k mai2hook.dll amdaemon.exe -f -c config_common.json config_server.json config_client.json\ninject -d -k mai2hook.dll sinmai -screen-fullscreen 0 -popupwindow -screen-width 2160 -screen-height 1920  -silent-crashes\n\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Launch options
  • -screen-fullscreen 0: windowed
  • -screen-fullscreen 0 -popupwindow: borderless windowed
  • -screen-fullscreen 1: exclusive fullscreen
  • -screen-width <W> -screen-height <H>: resolution
  • -monitor <N>: the monitor to run the game on
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number. For example, monitor 2 means -monitor 2.

"},{"location":"games/sega/maimaidx/buddies/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.172.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\package\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/maimaidx/buddies/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/maimaidx/buddies/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/maimaidx/buddies/setup/#audio","title":"Audio","text":"
  • Right-click on the volume setting in your taskbar and select Sounds.
  • Navigate to the Playback tab, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick either 16 bit, 48000Hz (DVD Quality) or 24 bit, 48000Hz (Studio Quality), click Apply, then OK.
"},{"location":"games/sega/maimaidx/buddies/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/maimaidx/buddies/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/maimaidx/buddies/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\package\\start.bat. Let the game load until you reach a screen with the message below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 7th option).

Select \u5e97\u5185\u30de\u30c3\u30c1\u30f3\u30b0\u306e\u8a2d\u5b9a (IN-STORE MATCHING SETUP, the first option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/maimaidx/buddies/setup/#custom-mods","title":"Custom Mods","text":"

Mods are covered on the Unity modding page.

"},{"location":"games/sega/maimaidx/buddies/setup/#controllers-and-troubleshooting","title":"Controllers and Troubleshooting","text":"

Input methods and controllers are covered in the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/maimaidx/buddies/troubleshooting/","title":"maimai DX BUDDiES","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/maimaidx/buddies/troubleshooting/#my-game-crashes-on-launchstuck-on-starting-system-process","title":"My game crashes on launch/stuck on \"Starting System Process\"","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject -d -k mai2hook.dll amdaemon.exe -f -c config_common.json config_server.json\nping 127.0.0.1 -n 31 > nul && taskkill /F /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/maimaidx/buddies/troubleshooting/#my-game-is-stuck-on-a-black-screen-at-launch","title":"My game is stuck on a black screen at launch!","text":"

This could also be due to many things, the most common of which are:

  • You have one or more incorrect/broken DLL(s) in App\\Package\\Sinmai_Data\\Managed

    This is likely to be Assembly-CSharp.dll, Assembly-CSharp-firstpass.dll, and/or AMDaemon.NET.dll. You can try replacing the DLLs or re-downloading data from elsewhere.

  • An ill-formed keychip is defined in segatools.ini

  • You need to app the OpenSSL fix on Intel Core 10th Gen CPUs and newer.

"},{"location":"games/sega/maimaidx/buddies/troubleshooting/#my-game-is-stuck-on-a-blue-and-black-screen","title":"My game is stuck on a blue and black screen!","text":"

You need to run the data using unprotected/unpacked files. Please refer to the setup guide to find which ones you need and obtain them.

If you believe you've already done this. You might be missing a try installing the latest vcredist

"},{"location":"games/sega/maimaidx/buddies/troubleshooting/#my-game-is-running-too-slowfast-or-the-notes-are-out-of-sync","title":"My game is running too slow/fast or the notes are out of sync!","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Limit Sinmai.exe to run at 60 FPS using a tool like RivaTuner or a patch.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/maimaidx/buddiesplus/controllers/","title":"maimai DX BUDDiES","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with IO DLLs to add support for controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\Package folder and referenced in segatools.ini under the [mai2io] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[mai2io]\n; To use a custom maimai DX IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/maimaidx/buddiesplus/controllers/#keyboardtouchscreen","title":"Keyboard/Touchscreen","text":"

Keyboard/Touchscreen is the default input method

The default layout uses QWEDCXZA for physical buttons (each key representing the physical button's location relative to the center screen)

If you wish to change the default keybinds, an explanation on how to set these is included above the [io4] section in your segatools.ini.

Touch input should automatically work after connecting a touch-screen display

"},{"location":"games/sega/maimaidx/buddiesplus/controllers/#adx-controller","title":"ADX Controller","text":"

First, you will need to purchase a compatible monitor if your controller did not come with one. A list of compatible monitors can be found on this spreadsheet

Plug your controller in and open Device Manager.

Under the Ports (COM & LPT) section, ensure the correct ports are set for both the Touch Panel and Button LED.

  • (Touch Panel) USB Serial Device: COM3
  • (Button LED) USB-SERIAL CH340: COM21

If they are different change the port of the device by Right Clicking on the Device -> Properties -> Port Settings -> COM Port Number

Finally ensure the mai2.ini file in your data's App/Package folder has the following values set under the [AM] section 

[AM]\nTarget=0\nDummyTouchPanel=0\nDummyLED=0\n

This gets your controller working with keyboard inputs. Its highly recommended that you also view this setup guide which provides more detailed instructions, improved drivers, and help with adjusting touch panel sensitivity.

Warning

You DO NOT need to follow the Network Setup steps in the linked guide above if you've already done so while setting up game data

You DO NOT need to follow the Aime Reader setup in the linked guide above if you do not own one.

"},{"location":"games/sega/maimaidx/buddiesplus/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/maimaidx/buddiesplus/setup/","title":"maimai DX BUDDiES","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of maimai DX

Create a new folder for the game and start from scratch. maimai DX DOES NOT like being extracted over old data!

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files are not set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and filesand press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create two new empty folders named appdata and amfs (and the folder option if not present) next to them as shown below:

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#installing-option-data","title":"Installing option data","text":"

maimai DX content updates are distributed through option folders instead of patching the base game.

Options are named with a letter followed by three numbers.

For JPN(SDEZ) data, each new release of maimai DX increments the first letter of the Option (ie. BUDDiES is H??? and BUDDiES+ is I???).

For EXP(SDGA) data, Options will always begin with the letter A (i.e A???)

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

Do not mix option data between versions

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

maimai DX executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of the following files and the associated configuration file:

  • amdaemon.exe
  • Sinmai.exe
  • Sinmai_Data/Plugins/amdaemon_api.dll
  • Sinmai_Data/Plugins/Cake.dll (JPN/SDEZ only)
  • Sinmai_Data/Managed/AMDaemon.NET.dll
  • Sinmai_Data/Managed/Assembly-CSharp.dll
  • mai2.ini

Copy the files and folders into the App/Package folder of your game data. Agree to overwrite when asked.

Assembly-CSharp Notes

Assembly-CSharp.dll must match your game version. All others can be reused from other game versions.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#mai2ini","title":"mai2.ini","text":"

Ensure that the App\\Package folder contains mai2.ini.

If this configuration file is missing, create one using the contents below.

[Debug]\nDebug=1\n\n[AM]\nTarget=0\nIgnoreError=1\nDummyTouchPanel=1\nDummyLED=1\nDummyCodeCamera=1\nDummyPhotoCamera=1\n\n[Sound]\nSound8Ch=0\n
"},{"location":"games/sega/maimaidx/buddiesplus/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download the segatools.zip from 2024-03-13. Do not download the source code or latest release.
  • Extracting the archive should give you a few more zip files. Find mai2.zip and extract it to the App/Package folder in your game data.

You should now have a few more files inside the App/Package folder, as highlighted:

Warning

The latest release of segatools currently has issues with maimai, and for the time being an older version of segatools is preferred.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\package\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[gpio]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
"},{"location":"games/sega/maimaidx/buddiesplus/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n
AquaMai

It's strongly recommended to use MelonLoader mods to improve QOL. You can find info about the available mods for maimai here AquaMai. For general modding check Unity modding page.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#setting-launch-options","title":"Setting launch options","text":"

Right click App\\package\\start.bat, select Edit. Locate the line that launches sinmai and edit it according to your preferences:

@echo off\n\npushd %~dp0\n\nstart \"AM Daemon\" /min inject -d -k mai2hook.dll amdaemon.exe -f -c config_common.json config_server.json config_client.json\ninject -d -k mai2hook.dll sinmai -screen-fullscreen 0 -popupwindow -screen-width 2160 -screen-height 1920  -silent-crashes\n\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Launch options
  • -screen-fullscreen 0: windowed
  • -screen-fullscreen 0 -popupwindow: borderless windowed
  • -screen-fullscreen 1: exclusive fullscreen
  • -screen-width <W> -screen-height <H>: resolution
  • -monitor <N>: the monitor to run the game on
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number. For example, monitor 2 means -monitor 2.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.172.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\package\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/maimaidx/buddiesplus/setup/#audio","title":"Audio","text":"
  • Right-click on the volume setting in your taskbar and select Sounds.
  • Navigate to the Playback tab, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick either 16 bit, 48000Hz (DVD Quality) or 24 bit, 48000Hz (Studio Quality), click Apply, then OK.
"},{"location":"games/sega/maimaidx/buddiesplus/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\package\\start.bat. Let the game load until you reach a screen with the message below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 7th option).

Select \u5e97\u5185\u30de\u30c3\u30c1\u30f3\u30b0\u306e\u8a2d\u5b9a (IN-STORE MATCHING SETUP, the first option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#custom-mods","title":"Custom Mods","text":"

Mods are covered on the Unity modding page.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#controllers-and-troubleshooting","title":"Controllers and Troubleshooting","text":"

Input methods and controllers are covered in the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/maimaidx/buddiesplus/troubleshooting/","title":"maimai DX BUDDiES","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/maimaidx/buddiesplus/troubleshooting/#my-game-crashes-on-launchstuck-on-starting-system-process","title":"My game crashes on launch/stuck on \"Starting System Process\"","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject -d -k mai2hook.dll amdaemon.exe -f -c config_common.json config_server.json\nping 127.0.0.1 -n 31 > nul && taskkill /F /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/maimaidx/buddiesplus/troubleshooting/#my-game-is-stuck-on-a-black-screen-at-launch","title":"My game is stuck on a black screen at launch!","text":"

This could also be due to many things, the most common of which are:

  • You have one or more incorrect/broken DLL(s) in App\\Package\\Sinmai_Data\\Managed

    This is likely to be Assembly-CSharp.dll, Assembly-CSharp-firstpass.dll, and/or AMDaemon.NET.dll. You can try replacing the DLLs or re-downloading data from elsewhere.

  • An ill-formed keychip is defined in segatools.ini

  • You need to app the OpenSSL fix on Intel Core 10th Gen CPUs and newer.

"},{"location":"games/sega/maimaidx/buddiesplus/troubleshooting/#my-game-is-stuck-on-a-blue-and-black-screen","title":"My game is stuck on a blue and black screen!","text":"

You need to run the data using unprotected/unpacked files. Please refer to the setup guide to find which ones you need and obtain them.

If you believe you've already done this. You might be missing a try installing the latest vcredist

"},{"location":"games/sega/maimaidx/buddiesplus/troubleshooting/#my-game-is-running-too-slowfast-or-the-notes-are-out-of-sync","title":"My game is running too slow/fast or the notes are out of sync!","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Limit Sinmai.exe to run at 60 FPS using a tool like RivaTuner or a patch.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/maimaidx/common/controllers/","title":"Controllers","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with IO DLLs to add support for controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\Package folder and referenced in segatools.ini under the [mai2io] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[mai2io]\n; To use a custom maimai DX IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/maimaidx/common/controllers/#keyboardtouchscreen","title":"Keyboard/Touchscreen","text":"

Keyboard/Touchscreen is the default input method

The default layout uses QWEDCXZA for physical buttons (each key representing the physical button's location relative to the center screen)

If you wish to change the default keybinds, an explanation on how to set these is included above the [io4] section in your segatools.ini.

Touch input should automatically work after connecting a touch-screen display

"},{"location":"games/sega/maimaidx/common/controllers/#adx-controller","title":"ADX Controller","text":"

First, you will need to purchase a compatible monitor if your controller did not come with one. A list of compatible monitors can be found on this spreadsheet

Plug your controller in and open Device Manager.

Under the Ports (COM & LPT) section, ensure the correct ports are set for both the Touch Panel and Button LED.

  • (Touch Panel) USB Serial Device: COM3
  • (Button LED) USB-SERIAL CH340: COM21

If they are different change the port of the device by Right Clicking on the Device -> Properties -> Port Settings -> COM Port Number

Finally ensure the mai2.ini file in your data's App/Package folder has the following values set under the [AM] section 

[AM]\nTarget=0\nDummyTouchPanel=0\nDummyLED=0\n

This gets your controller working with keyboard inputs. Its highly recommended that you also view this setup guide which provides more detailed instructions, improved drivers, and help with adjusting touch panel sensitivity.

Warning

You DO NOT need to follow the Network Setup steps in the linked guide above if you've already done so while setting up game data

You DO NOT need to follow the Aime Reader setup in the linked guide above if you do not own one.

"},{"location":"games/sega/maimaidx/common/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/maimaidx/common/setup/","title":"Setup","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of maimai DX

Create a new folder for the game and start from scratch. maimai DX DOES NOT like being extracted over old data!

"},{"location":"games/sega/maimaidx/common/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files are not set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and filesand press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create two new empty folders named appdata and amfs (and the folder option if not present) next to them as shown below:

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/maimaidx/common/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/maimaidx/common/setup/#installing-option-data","title":"Installing option data","text":"

maimai DX content updates are distributed through option folders instead of patching the base game.

Options are named with a letter followed by three numbers.

For JPN(SDEZ) data, each new release of maimai DX increments the first letter of the Option (ie. BUDDiES is H??? and BUDDiES+ is I???).

For EXP(SDGA) data, Options will always begin with the letter A (i.e A???)

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

Do not mix option data between versions

"},{"location":"games/sega/maimaidx/common/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

maimai DX executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of the following files and the associated configuration file:

  • amdaemon.exe
  • Sinmai.exe
  • Sinmai_Data/Plugins/amdaemon_api.dll
  • Sinmai_Data/Plugins/Cake.dll (JPN/SDEZ only)
  • Sinmai_Data/Managed/AMDaemon.NET.dll
  • Sinmai_Data/Managed/Assembly-CSharp.dll
  • mai2.ini

Copy the files and folders into the App/Package folder of your game data. Agree to overwrite when asked.

Assembly-CSharp Notes

Assembly-CSharp.dll must match your game version. All others can be reused from other game versions.

"},{"location":"games/sega/maimaidx/common/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/maimaidx/common/setup/#mai2ini","title":"mai2.ini","text":"

Ensure that the App\\Package folder contains mai2.ini.

If this configuration file is missing, create one using the contents below.

[Debug]\nDebug=1\n\n[AM]\nTarget=0\nIgnoreError=1\nDummyTouchPanel=1\nDummyLED=1\nDummyCodeCamera=1\nDummyPhotoCamera=1\n\n[Sound]\nSound8Ch=0\n
"},{"location":"games/sega/maimaidx/common/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download the segatools.zip from 2024-03-13. Do not download the source code or latest release.
  • Extracting the archive should give you a few more zip files. Find mai2.zip and extract it to the App/Package folder in your game data.

You should now have a few more files inside the App/Package folder, as highlighted:

Warning

The latest release of segatools currently has issues with maimai, and for the time being an older version of segatools is preferred.

"},{"location":"games/sega/maimaidx/common/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\package\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[gpio]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
"},{"location":"games/sega/maimaidx/common/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n
AquaMai

It's strongly recommended to use MelonLoader mods to improve QOL. You can find info about the available mods for maimai here AquaMai. For general modding check Unity modding page.

"},{"location":"games/sega/maimaidx/common/setup/#setting-launch-options","title":"Setting launch options","text":"

Right click App\\package\\start.bat, select Edit. Locate the line that launches sinmai and edit it according to your preferences:

@echo off\n\npushd %~dp0\n\nstart \"AM Daemon\" /min inject -d -k mai2hook.dll amdaemon.exe -f -c config_common.json config_server.json config_client.json\ninject -d -k mai2hook.dll sinmai -screen-fullscreen 0 -popupwindow -screen-width 2160 -screen-height 1920  -silent-crashes\n\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Launch options
  • -screen-fullscreen 0: windowed
  • -screen-fullscreen 0 -popupwindow: borderless windowed
  • -screen-fullscreen 1: exclusive fullscreen
  • -screen-width <W> -screen-height <H>: resolution
  • -monitor <N>: the monitor to run the game on
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number. For example, monitor 2 means -monitor 2.

"},{"location":"games/sega/maimaidx/common/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.172.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\package\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/maimaidx/common/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/maimaidx/common/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/maimaidx/common/setup/#audio","title":"Audio","text":"
  • Right-click on the volume setting in your taskbar and select Sounds.
  • Navigate to the Playback tab, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick either 16 bit, 48000Hz (DVD Quality) or 24 bit, 48000Hz (Studio Quality), click Apply, then OK.
"},{"location":"games/sega/maimaidx/common/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/maimaidx/common/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/maimaidx/common/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\package\\start.bat. Let the game load until you reach a screen with the message below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 7th option).

Select \u5e97\u5185\u30de\u30c3\u30c1\u30f3\u30b0\u306e\u8a2d\u5b9a (IN-STORE MATCHING SETUP, the first option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/maimaidx/common/setup/#custom-mods","title":"Custom Mods","text":"

Mods are covered on the Unity modding page.

"},{"location":"games/sega/maimaidx/common/setup/#controllers-and-troubleshooting","title":"Controllers and Troubleshooting","text":"

Input methods and controllers are covered in the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/maimaidx/common/troubleshooting/","title":"Troubleshooting","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/maimaidx/common/troubleshooting/#my-game-crashes-on-launchstuck-on-starting-system-process","title":"My game crashes on launch/stuck on \"Starting System Process\"","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject -d -k mai2hook.dll amdaemon.exe -f -c config_common.json config_server.json\nping 127.0.0.1 -n 31 > nul && taskkill /F /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/maimaidx/common/troubleshooting/#my-game-is-stuck-on-a-black-screen-at-launch","title":"My game is stuck on a black screen at launch!","text":"

This could also be due to many things, the most common of which are:

  • You have one or more incorrect/broken DLL(s) in App\\Package\\Sinmai_Data\\Managed

    This is likely to be Assembly-CSharp.dll, Assembly-CSharp-firstpass.dll, and/or AMDaemon.NET.dll. You can try replacing the DLLs or re-downloading data from elsewhere.

  • An ill-formed keychip is defined in segatools.ini

  • You need to app the OpenSSL fix on Intel Core 10th Gen CPUs and newer.

"},{"location":"games/sega/maimaidx/common/troubleshooting/#my-game-is-stuck-on-a-blue-and-black-screen","title":"My game is stuck on a blue and black screen!","text":"

You need to run the data using unprotected/unpacked files. Please refer to the setup guide to find which ones you need and obtain them.

If you believe you've already done this. You might be missing a try installing the latest vcredist

"},{"location":"games/sega/maimaidx/common/troubleshooting/#my-game-is-running-too-slowfast-or-the-notes-are-out-of-sync","title":"My game is running too slow/fast or the notes are out of sync!","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Limit Sinmai.exe to run at 60 FPS using a tool like RivaTuner or a patch.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/maimaidx/prism/controllers/","title":"maimai DX PRiSM","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with IO DLLs to add support for controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\Package folder and referenced in segatools.ini under the [mai2io] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[mai2io]\n; To use a custom maimai DX IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/maimaidx/prism/controllers/#keyboardtouchscreen","title":"Keyboard/Touchscreen","text":"

Keyboard/Touchscreen is the default input method

The default layout uses QWEDCXZA for physical buttons (each key representing the physical button's location relative to the center screen)

If you wish to change the default keybinds, an explanation on how to set these is included above the [io4] section in your segatools.ini.

Touch input should automatically work after connecting a touch-screen display

"},{"location":"games/sega/maimaidx/prism/controllers/#adx-controller","title":"ADX Controller","text":"

First, you will need to purchase a compatible monitor if your controller did not come with one. A list of compatible monitors can be found on this spreadsheet

Plug your controller in and open Device Manager.

Under the Ports (COM & LPT) section, ensure the correct ports are set for both the Touch Panel and Button LED.

  • (Touch Panel) USB Serial Device: COM3
  • (Button LED) USB-SERIAL CH340: COM21

If they are different change the port of the device by Right Clicking on the Device -> Properties -> Port Settings -> COM Port Number

Finally ensure the mai2.ini file in your data's App/Package folder has the following values set under the [AM] section 

[AM]\nTarget=0\nDummyTouchPanel=0\nDummyLED=0\n

This gets your controller working with keyboard inputs. Its highly recommended that you also view this setup guide which provides more detailed instructions, improved drivers, and help with adjusting touch panel sensitivity.

Warning

You DO NOT need to follow the Network Setup steps in the linked guide above if you've already done so while setting up game data

You DO NOT need to follow the Aime Reader setup in the linked guide above if you do not own one.

"},{"location":"games/sega/maimaidx/prism/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/maimaidx/prism/setup/","title":"maimai DX PRiSM","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of maimai DX

Create a new folder for the game and start from scratch. maimai DX DOES NOT like being extracted over old data!

"},{"location":"games/sega/maimaidx/prism/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files are not set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and filesand press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create two new empty folders named appdata and amfs (and the folder option if not present) next to them as shown below:

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/maimaidx/prism/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/maimaidx/prism/setup/#installing-option-data","title":"Installing option data","text":"

maimai DX content updates are distributed through option folders instead of patching the base game.

Options are named with a letter followed by three numbers.

For JPN(SDEZ) data, each new release of maimai DX increments the first letter of the Option (ie. BUDDiES is H??? and BUDDiES+ is I???).

For EXP(SDGA) data, Options will always begin with the letter A (i.e A???)

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

Do not mix option data between versions

"},{"location":"games/sega/maimaidx/prism/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

maimai DX executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of the following files and the associated configuration file:

  • amdaemon.exe
  • Sinmai.exe
  • Sinmai_Data/Plugins/amdaemon_api.dll
  • Sinmai_Data/Plugins/Cake.dll (JPN/SDEZ only)
  • Sinmai_Data/Managed/AMDaemon.NET.dll
  • Sinmai_Data/Managed/Assembly-CSharp.dll
  • mai2.ini

Copy the files and folders into the App/Package folder of your game data. Agree to overwrite when asked.

Assembly-CSharp Notes

Assembly-CSharp.dll must match your game version. All others can be reused from other game versions.

"},{"location":"games/sega/maimaidx/prism/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/maimaidx/prism/setup/#mai2ini","title":"mai2.ini","text":"

Ensure that the App\\Package folder contains mai2.ini.

If this configuration file is missing, create one using the contents below.

[Debug]\nDebug=1\n\n[AM]\nTarget=0\nIgnoreError=1\nDummyTouchPanel=1\nDummyLED=1\nDummyCodeCamera=1\nDummyPhotoCamera=1\n\n[Sound]\nSound8Ch=0\n
"},{"location":"games/sega/maimaidx/prism/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download the segatools.zip from 2024-03-13. Do not download the source code or latest release.
  • Extracting the archive should give you a few more zip files. Find mai2.zip and extract it to the App/Package folder in your game data.

You should now have a few more files inside the App/Package folder, as highlighted:

Warning

The latest release of segatools currently has issues with maimai, and for the time being an older version of segatools is preferred.

"},{"location":"games/sega/maimaidx/prism/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\package\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[gpio]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
"},{"location":"games/sega/maimaidx/prism/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n
AquaMai

It's strongly recommended to use MelonLoader mods to improve QOL. You can find info about the available mods for maimai here AquaMai. For general modding check Unity modding page.

"},{"location":"games/sega/maimaidx/prism/setup/#setting-launch-options","title":"Setting launch options","text":"

Right click App\\package\\start.bat, select Edit. Locate the line that launches sinmai and edit it according to your preferences:

@echo off\n\npushd %~dp0\n\nstart \"AM Daemon\" /min inject -d -k mai2hook.dll amdaemon.exe -f -c config_common.json config_server.json config_client.json\ninject -d -k mai2hook.dll sinmai -screen-fullscreen 0 -popupwindow -screen-width 2160 -screen-height 1920  -silent-crashes\n\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Launch options
  • -screen-fullscreen 0: windowed
  • -screen-fullscreen 0 -popupwindow: borderless windowed
  • -screen-fullscreen 1: exclusive fullscreen
  • -screen-width <W> -screen-height <H>: resolution
  • -monitor <N>: the monitor to run the game on
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number. For example, monitor 2 means -monitor 2.

"},{"location":"games/sega/maimaidx/prism/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.172.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\package\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/maimaidx/prism/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/maimaidx/prism/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/maimaidx/prism/setup/#audio","title":"Audio","text":"
  • Right-click on the volume setting in your taskbar and select Sounds.
  • Navigate to the Playback tab, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick either 16 bit, 48000Hz (DVD Quality) or 24 bit, 48000Hz (Studio Quality), click Apply, then OK.
"},{"location":"games/sega/maimaidx/prism/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/maimaidx/prism/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/maimaidx/prism/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\package\\start.bat. Let the game load until you reach a screen with the message below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 7th option).

Select \u5e97\u5185\u30de\u30c3\u30c1\u30f3\u30b0\u306e\u8a2d\u5b9a (IN-STORE MATCHING SETUP, the first option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/maimaidx/prism/setup/#custom-mods","title":"Custom Mods","text":"

Mods are covered on the Unity modding page.

"},{"location":"games/sega/maimaidx/prism/setup/#controllers-and-troubleshooting","title":"Controllers and Troubleshooting","text":"

Input methods and controllers are covered in the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/maimaidx/prism/troubleshooting/","title":"maimai DX PRiSM","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/maimaidx/prism/troubleshooting/#my-game-crashes-on-launchstuck-on-starting-system-process","title":"My game crashes on launch/stuck on \"Starting System Process\"","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject -d -k mai2hook.dll amdaemon.exe -f -c config_common.json config_server.json\nping 127.0.0.1 -n 31 > nul && taskkill /F /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/maimaidx/prism/troubleshooting/#my-game-is-stuck-on-a-black-screen-at-launch","title":"My game is stuck on a black screen at launch!","text":"

This could also be due to many things, the most common of which are:

  • You have one or more incorrect/broken DLL(s) in App\\Package\\Sinmai_Data\\Managed

    This is likely to be Assembly-CSharp.dll, Assembly-CSharp-firstpass.dll, and/or AMDaemon.NET.dll. You can try replacing the DLLs or re-downloading data from elsewhere.

  • An ill-formed keychip is defined in segatools.ini

  • You need to app the OpenSSL fix on Intel Core 10th Gen CPUs and newer.

"},{"location":"games/sega/maimaidx/prism/troubleshooting/#my-game-is-stuck-on-a-blue-and-black-screen","title":"My game is stuck on a blue and black screen!","text":"

You need to run the data using unprotected/unpacked files. Please refer to the setup guide to find which ones you need and obtain them.

If you believe you've already done this. You might be missing a try installing the latest vcredist

"},{"location":"games/sega/maimaidx/prism/troubleshooting/#my-game-is-running-too-slowfast-or-the-notes-are-out-of-sync","title":"My game is running too slow/fast or the notes are out of sync!","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Limit Sinmai.exe to run at 60 FPS using a tool like RivaTuner or a patch.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/maimaidx/prismplus/controllers/","title":"maimai DX PRiSM PLUS","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with IO DLLs to add support for controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\Package folder and referenced in segatools.ini under the [mai2io] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[mai2io]\n; To use a custom maimai DX IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/maimaidx/prismplus/controllers/#keyboardtouchscreen","title":"Keyboard/Touchscreen","text":"

Keyboard/Touchscreen is the default input method

The default layout uses QWEDCXZA for physical buttons (each key representing the physical button's location relative to the center screen)

If you wish to change the default keybinds, an explanation on how to set these is included above the [io4] section in your segatools.ini.

Touch input should automatically work after connecting a touch-screen display

"},{"location":"games/sega/maimaidx/prismplus/controllers/#adx-controller","title":"ADX Controller","text":"

First, you will need to purchase a compatible monitor if your controller did not come with one. A list of compatible monitors can be found on this spreadsheet

Plug your controller in and open Device Manager.

Under the Ports (COM & LPT) section, ensure the correct ports are set for both the Touch Panel and Button LED.

  • (Touch Panel) USB Serial Device: COM3
  • (Button LED) USB-SERIAL CH340: COM21

If they are different change the port of the device by Right Clicking on the Device -> Properties -> Port Settings -> COM Port Number

Finally ensure the mai2.ini file in your data's App/Package folder has the following values set under the [AM] section 

[AM]\nTarget=0\nDummyTouchPanel=0\nDummyLED=0\n

This gets your controller working with keyboard inputs. Its highly recommended that you also view this setup guide which provides more detailed instructions, improved drivers, and help with adjusting touch panel sensitivity.

Warning

You DO NOT need to follow the Network Setup steps in the linked guide above if you've already done so while setting up game data

You DO NOT need to follow the Aime Reader setup in the linked guide above if you do not own one.

"},{"location":"games/sega/maimaidx/prismplus/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/maimaidx/prismplus/setup/","title":"maimai DX PRiSM PLUS","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of maimai DX

Create a new folder for the game and start from scratch. maimai DX DOES NOT like being extracted over old data!

"},{"location":"games/sega/maimaidx/prismplus/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files are not set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and filesand press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create two new empty folders named appdata and amfs (and the folder option if not present) next to them as shown below:

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/maimaidx/prismplus/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/maimaidx/prismplus/setup/#installing-option-data","title":"Installing option data","text":"

maimai DX content updates are distributed through option folders instead of patching the base game.

Options are named with a letter followed by three numbers.

For JPN(SDEZ) data, each new release of maimai DX increments the first letter of the Option (ie. BUDDiES is H??? and BUDDiES+ is I???).

For EXP(SDGA) data, Options will always begin with the letter A (i.e A???)

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

Do not mix option data between versions

"},{"location":"games/sega/maimaidx/prismplus/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

maimai DX executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of the following files and the associated configuration file:

  • amdaemon.exe
  • Sinmai.exe
  • Sinmai_Data/Plugins/amdaemon_api.dll
  • Sinmai_Data/Plugins/Cake.dll (JPN/SDEZ only)
  • Sinmai_Data/Managed/AMDaemon.NET.dll
  • Sinmai_Data/Managed/Assembly-CSharp.dll
  • mai2.ini

Copy the files and folders into the App/Package folder of your game data. Agree to overwrite when asked.

Assembly-CSharp Notes

Assembly-CSharp.dll must match your game version. All others can be reused from other game versions.

"},{"location":"games/sega/maimaidx/prismplus/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/maimaidx/prismplus/setup/#mai2ini","title":"mai2.ini","text":"

Ensure that the App\\Package folder contains mai2.ini.

If this configuration file is missing, create one using the contents below.

[Debug]\nDebug=1\n\n[AM]\nTarget=0\nIgnoreError=1\nDummyTouchPanel=1\nDummyLED=1\nDummyCodeCamera=1\nDummyPhotoCamera=1\n\n[Sound]\nSound8Ch=0\n
"},{"location":"games/sega/maimaidx/prismplus/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download the segatools.zip from 2024-03-13. Do not download the source code or latest release.
  • Extracting the archive should give you a few more zip files. Find mai2.zip and extract it to the App/Package folder in your game data.

You should now have a few more files inside the App/Package folder, as highlighted:

Warning

The latest release of segatools currently has issues with maimai, and for the time being an older version of segatools is preferred.

"},{"location":"games/sega/maimaidx/prismplus/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\package\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[gpio]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
"},{"location":"games/sega/maimaidx/prismplus/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n
AquaMai

It's strongly recommended to use MelonLoader mods to improve QOL. You can find info about the available mods for maimai here AquaMai. For general modding check Unity modding page.

"},{"location":"games/sega/maimaidx/prismplus/setup/#setting-launch-options","title":"Setting launch options","text":"

Right click App\\package\\start.bat, select Edit. Locate the line that launches sinmai and edit it according to your preferences:

@echo off\n\npushd %~dp0\n\nstart \"AM Daemon\" /min inject -d -k mai2hook.dll amdaemon.exe -f -c config_common.json config_server.json config_client.json\ninject -d -k mai2hook.dll sinmai -screen-fullscreen 0 -popupwindow -screen-width 2160 -screen-height 1920  -silent-crashes\n\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Launch options
  • -screen-fullscreen 0: windowed
  • -screen-fullscreen 0 -popupwindow: borderless windowed
  • -screen-fullscreen 1: exclusive fullscreen
  • -screen-width <W> -screen-height <H>: resolution
  • -monitor <N>: the monitor to run the game on
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number. For example, monitor 2 means -monitor 2.

"},{"location":"games/sega/maimaidx/prismplus/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.172.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\package\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/maimaidx/prismplus/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/maimaidx/prismplus/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/maimaidx/prismplus/setup/#audio","title":"Audio","text":"
  • Right-click on the volume setting in your taskbar and select Sounds.
  • Navigate to the Playback tab, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick either 16 bit, 48000Hz (DVD Quality) or 24 bit, 48000Hz (Studio Quality), click Apply, then OK.
"},{"location":"games/sega/maimaidx/prismplus/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/maimaidx/prismplus/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/maimaidx/prismplus/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\package\\start.bat. Let the game load until you reach a screen with the message below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 7th option).

Select \u5e97\u5185\u30de\u30c3\u30c1\u30f3\u30b0\u306e\u8a2d\u5b9a (IN-STORE MATCHING SETUP, the first option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/maimaidx/prismplus/setup/#custom-mods","title":"Custom Mods","text":"

Mods are covered on the Unity modding page.

"},{"location":"games/sega/maimaidx/prismplus/setup/#controllers-and-troubleshooting","title":"Controllers and Troubleshooting","text":"

Input methods and controllers are covered in the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/maimaidx/prismplus/troubleshooting/","title":"maimai DX PRiSM PLUS","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/maimaidx/prismplus/troubleshooting/#my-game-crashes-on-launchstuck-on-starting-system-process","title":"My game crashes on launch/stuck on \"Starting System Process\"","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject -d -k mai2hook.dll amdaemon.exe -f -c config_common.json config_server.json\nping 127.0.0.1 -n 31 > nul && taskkill /F /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/maimaidx/prismplus/troubleshooting/#my-game-is-stuck-on-a-black-screen-at-launch","title":"My game is stuck on a black screen at launch!","text":"

This could also be due to many things, the most common of which are:

  • You have one or more incorrect/broken DLL(s) in App\\Package\\Sinmai_Data\\Managed

    This is likely to be Assembly-CSharp.dll, Assembly-CSharp-firstpass.dll, and/or AMDaemon.NET.dll. You can try replacing the DLLs or re-downloading data from elsewhere.

  • An ill-formed keychip is defined in segatools.ini

  • You need to app the OpenSSL fix on Intel Core 10th Gen CPUs and newer.

"},{"location":"games/sega/maimaidx/prismplus/troubleshooting/#my-game-is-stuck-on-a-blue-and-black-screen","title":"My game is stuck on a blue and black screen!","text":"

You need to run the data using unprotected/unpacked files. Please refer to the setup guide to find which ones you need and obtain them.

If you believe you've already done this. You might be missing a try installing the latest vcredist

"},{"location":"games/sega/maimaidx/prismplus/troubleshooting/#my-game-is-running-too-slowfast-or-the-notes-are-out-of-sync","title":"My game is running too slow/fast or the notes are out of sync!","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Limit Sinmai.exe to run at 60 FPS using a tool like RivaTuner or a patch.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/ongeki/brightmemory/controllers/","title":"Controllers (O.N.G.E.K.I. bright MEMORY)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and XInput Controllers. However, it can be configured with IO DLLs to add support for other controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\package folder and referenced in segatools.ini under the [mu3io] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[mu3io]\n; To use a custom O.N.G.E.K.I. IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard/gamepad input.\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/ongeki/brightmemory/controllers/#keyboard-and-mouse","title":"Keyboard and Mouse","text":"

Keyboard and Mouse is the default input method.

To enable mouse lever emulation ensure that the mouse option is set to 1 in the [io4] section of your segatools.ini:

[io4]\n; Set \"1\" to enable mouse lever emulation, \"0\" to use XInput\nmouse=1\n

The default layout use ASD for the left 3 buttons, and JKL for the right 3 buttons. Mouse Left/Right Click are used for the left and right bumper buttons.

If you wish to change the default keybinds, an explanation on how to set these is included above the [io4] section in your segatools.ini.

"},{"location":"games/sega/ongeki/brightmemory/controllers/#xinput-controller","title":"XInput Controller","text":"

XInput controllers are supported by segatools. To enable XInput, ensure that the mouse option is set to 0 in the [io4] section of your segatools.ini:

[io4]\n; Set \"1\" to enable mouse lever emulation, \"0\" to use XInput\nmouse=0\n

If you wish to change the default keybinds, an explanation on how to set these is included above the [io4] section in your segatools.ini.

"},{"location":"games/sega/ongeki/brightmemory/controllers/#mageki","title":"Mageki","text":"

Mageki allows you to use a mobile device as a O.N.G.E.K.I. controller. It replicates the layout of an arcade O.N.G.E.K.I. controller on your mobile device.

Mageki supports both Android and iOS devices. For installation instructions, please refer to the English User Manual on the Mageki GitHub Repository.

Configuring ongeki-io and MU3-input.dll

When moving the zipped contents of MU3Input, move all folders EXCEPT the segatools.ini file into your App\\package folder in a way that matches its file structure. Modify the [mu3io] and [aimeio] sections of your existing segatools.ini file to look like the following:

[mu3io]\npath=MU3Input.dll\n\n[aimeio]\npath=MU3Input.dll\n
If these sections do not exist, add them to the end of your segatools.ini file.

IOConfig doesn't launch for me/This application requires the Windows App Runtime

Download and extract the contents of the Windows App Runtime Version 1.5 Redistributable In the WindowsAppSDK-Installer-x64 folder run WindowsAppRuntimeInstall-x64.exe

If IOConfig still fails to launch, try using the SelfContained version of ongeki-io

"},{"location":"games/sega/ongeki/brightmemory/controllers/#ontroller","title":"ONTROLLER","text":"
  • Navigate to Mu3IO.NET releases and download mu3io.dll. Put this file in your App\\package folder.
  • Edit your segatools.ini to reference the DLL:
[mu3io]\n; To use a custom O.N.G.E.K.I. IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard/gamepad input.\npath=mu3io.dll\n
"},{"location":"games/sega/ongeki/brightmemory/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet slider and air sensors, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/ongeki/brightmemory/setup/","title":"Game Setup (O.N.G.E.K.I. bright MEMORY)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of O.N.G.E.K.I.

You'll want to create a new folder for the game and start from scratch. O.N.G.E.K.I. DOES NOT like being extracted over old data!

"},{"location":"games/sega/ongeki/brightmemory/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create another empty folder named AppData next to them. It should now look like below.

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/ongeki/brightmemory/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/ongeki/brightmemory/setup/#installing-option-data","title":"Installing option data","text":"

O.N.G.E.K.I. content updates are distributed through option folders instead of patching the base game. They are named A???, with each ? being a number. Custom options distributed by the community might use letters instead, to distinguish them from official ones.

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

In some cases, your data may have options in App\\package\\option. If so, move all contents inside to the Option folder where App and AppData are and delete the App\\package\\option folder.

"},{"location":"games/sega/ongeki/brightmemory/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

O.N.G.E.K.I. executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of the following files and the associated configuration file:

  • amdaemon.exe
  • mu3.exe
  • mu3_Data\\Plugins\\amdaemon_api.dll
  • mu3_Data\\Plugins\\chiffre.dll
  • mu3_Data\\Plugins\\libhttp.dll
  • mu3_Data\\Plugins\\QR_Image.dll
  • mu3_Data\\Managed\\AMDaemon.NET.dll
  • mu3_Data\\Managed\\Assembly-CSharp-firstpass.dll
  • mu3_Data\\Managed\\Assembly-CSharp.dll
  • mu3.ini

Copy the files and folders into the App/Package folder of your game data. Agree to overwrite when asked.

Assembly-CSharp Note

Assembly-CSharp.dll must match your game version.

"},{"location":"games/sega/ongeki/brightmemory/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/ongeki/brightmemory/setup/#mu3ini","title":"mu3.ini","text":"

Ensure that the App\\package folder contains mu3.ini.

If this configuration file is missing, create one using the contents below.

[AM]\nIgnoreError=1\nOptionDev=0\nDummyAime=0\nDummyCredit=1\nDummyJVS=0\n\n[Sound]\nWasapiExclusive=0\n

Warning

If you are following the folder structure of this guide, you must ensure that OptionDev is set to 0 in your mu3.ini, or else your Option data will not load.

"},{"location":"games/sega/ongeki/brightmemory/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download segatools.zip. Do not download the source code.
  • Extracting the archive should give you a few more zip files. Find mu3.zip and extract it to the App\\package folder in your game data.

You should now have a few more files inside the folder, as highlighted:

"},{"location":"games/sega/ongeki/brightmemory/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\package\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
"},{"location":"games/sega/ongeki/brightmemory/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n
mu3-mods

It's strongly recommended to use BepInEx mods to improve QOL. You can find info about the available mods for O.N.G.E.K.I. here mu3-mods. For general modding check Unity modding page.

"},{"location":"games/sega/ongeki/brightmemory/setup/#setting-launch-options","title":"Setting launch options","text":"

Right click App\\package\\start.bat, select Edit. Locate the line that launches mu3 and edit it according to your preferences:

@echo off\n\npushd %~dp0\n\nstart \"AM Daemon\" /min inject -d -k mu3hook.dll amdaemon.exe -f -c config_common.json config_server.json config_client.json\ninject -d -k mu3hook.dll mu3 -screen-fullscreen 0 -popupwindow -screen-width 1080 -screen-height 1920\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Launch options
  • -screen-fullscreen 0: windowed
  • -screen-fullscreen 0 -popupwindow: borderless windowed
  • -screen-fullscreen 1: exclusive fullscreen
  • -screen-width <W> -screen-height <H>: resolution
Note about resolution
  • The service menu will only render correctly at 1080x1920.
  • This can be fixed with a patch.
  • -monitor <N>: the monitor to run the game on
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number. For example, monitor 2 means -monitor 2.

"},{"location":"games/sega/ongeki/brightmemory/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.162.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\package\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/ongeki/brightmemory/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/ongeki/brightmemory/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/ongeki/brightmemory/setup/#audio","title":"Audio","text":"
  • Open App\\package\\mu3.ini (or create it if it doesn't exist).
  • Set WasapiExclusive in the Sound section to 0 (create the key if it doesn't exist):
[Sound]\nWasapiExclusive=0\n
"},{"location":"games/sega/ongeki/brightmemory/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/ongeki/brightmemory/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/ongeki/brightmemory/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\package\\start.bat. Let the game load until you reach a screen with the message below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 6th option).

Select \u30b0\u30eb\u30fc\u30d7\u5185\u57fa\u6e96\u6a5f\u306e\u8a2d\u5b9a (SET STANDARD IN GROUP, the second option) and toggle this setting to \u57fa\u6e96\u6a5f (STANDARD).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/ongeki/brightmemory/setup/#close-setting","title":"CLOSE SETTING","text":"

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the 10th option).

Navigate to \u6642 (HOUR, the 2nd option) and use the Service button to toggle the setting until it says \u5168\u6642\u523b (ALL TIME).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu, then select \u7d42\u4e86 (also the last option) in the main menu to exit the service menu.

You're all done! The game should load up properly now.

You can add coins using the Coin key (default F3) and card in by holding the Enter key.

"},{"location":"games/sega/ongeki/brightmemory/setup/#custom-mods","title":"Custom Mods","text":"

Mods are covered on the Unity modding page.

"},{"location":"games/sega/ongeki/brightmemory/setup/#controllers-and-troubleshooting","title":"Controllers and Troubleshooting","text":"

Input methods and controllers are covered on the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/ongeki/brightmemory/troubleshooting/","title":"Troubleshooting (O.N.G.E.K.I. bright MEMORY)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/ongeki/brightmemory/troubleshooting/#my-game-crashes-on-launchstuck-on-starting-system-process","title":"My game crashes on launch/stuck on \"Starting System Process\"","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject -d -k mu3hook.dll amdaemon.exe -f -c config_common.json config_server.json\nping 127.0.0.1 -n 31 > nul && taskkill /F /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/ongeki/brightmemory/troubleshooting/#my-game-is-stuck-on-a-black-screen-at-launch","title":"My game is stuck on a black screen at launch!","text":"

This could also be due to many things, the most common of which are:

  • You have one or more incorrect/broken DLL(s) in App\\package\\mu3_Data\\Managed

    This is likely to be Assembly-CSharp.dll, Assembly-CSharp-firstpass.dll, and/or AMDaemon.NET.dll. You can try replacing the DLLs or re-downloading data from elsewhere.

  • An ill-formed keychip is defined in segatools.ini

"},{"location":"games/sega/ongeki/brightmemory/troubleshooting/#my-game-is-running-too-slowfast-or-the-notes-are-out-of-sync","title":"My game is running too slow/fast or the notes are out of sync!","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Limit mu3.exe to run at 60 FPS using a tool like RivaTuner or a patch.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/ongeki/brightmemory/troubleshooting/#my-lever-controls-arent-working","title":"My lever controls aren't working!","text":"

You may need to calibrate your lever.

From the TEST MENU select \u30ec\u30d0\u30fc\u8a2d\u5b9a (LEVER SETTINGS) and then move the lever left to right ensuring that the game detects the full range of motion.

Then save by selecting \u7d42\u4e86 (EXIT) and then \u4fdd\u5b58\u3059\u308b (SAVE).

"},{"location":"games/sega/ongeki/brightmemory/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for mu3.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/ongeki/common/controllers/","title":"Controllers","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and XInput Controllers. However, it can be configured with IO DLLs to add support for other controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\package folder and referenced in segatools.ini under the [mu3io] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[mu3io]\n; To use a custom O.N.G.E.K.I. IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard/gamepad input.\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/ongeki/common/controllers/#keyboard-and-mouse","title":"Keyboard and Mouse","text":"

Keyboard and Mouse is the default input method.

To enable mouse lever emulation ensure that the mouse option is set to 1 in the [io4] section of your segatools.ini:

[io4]\n; Set \"1\" to enable mouse lever emulation, \"0\" to use XInput\nmouse=1\n

The default layout use ASD for the left 3 buttons, and JKL for the right 3 buttons. Mouse Left/Right Click are used for the left and right bumper buttons.

If you wish to change the default keybinds, an explanation on how to set these is included above the [io4] section in your segatools.ini.

"},{"location":"games/sega/ongeki/common/controllers/#xinput-controller","title":"XInput Controller","text":"

XInput controllers are supported by segatools. To enable XInput, ensure that the mouse option is set to 0 in the [io4] section of your segatools.ini:

[io4]\n; Set \"1\" to enable mouse lever emulation, \"0\" to use XInput\nmouse=0\n

If you wish to change the default keybinds, an explanation on how to set these is included above the [io4] section in your segatools.ini.

"},{"location":"games/sega/ongeki/common/controllers/#mageki","title":"Mageki","text":"

Mageki allows you to use a mobile device as a O.N.G.E.K.I. controller. It replicates the layout of an arcade O.N.G.E.K.I. controller on your mobile device.

Mageki supports both Android and iOS devices. For installation instructions, please refer to the English User Manual on the Mageki GitHub Repository.

Configuring ongeki-io and MU3-input.dll

When moving the zipped contents of MU3Input, move all folders EXCEPT the segatools.ini file into your App\\package folder in a way that matches its file structure. Modify the [mu3io] and [aimeio] sections of your existing segatools.ini file to look like the following:

[mu3io]\npath=MU3Input.dll\n\n[aimeio]\npath=MU3Input.dll\n
If these sections do not exist, add them to the end of your segatools.ini file.

IOConfig doesn't launch for me/This application requires the Windows App Runtime

Download and extract the contents of the Windows App Runtime Version 1.5 Redistributable In the WindowsAppSDK-Installer-x64 folder run WindowsAppRuntimeInstall-x64.exe

If IOConfig still fails to launch, try using the SelfContained version of ongeki-io

"},{"location":"games/sega/ongeki/common/controllers/#ontroller","title":"ONTROLLER","text":"
  • Navigate to Mu3IO.NET releases and download mu3io.dll. Put this file in your App\\package folder.
  • Edit your segatools.ini to reference the DLL:
[mu3io]\n; To use a custom O.N.G.E.K.I. IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard/gamepad input.\npath=mu3io.dll\n
"},{"location":"games/sega/ongeki/common/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet slider and air sensors, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/ongeki/common/setup/","title":"Setup","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of O.N.G.E.K.I.

You'll want to create a new folder for the game and start from scratch. O.N.G.E.K.I. DOES NOT like being extracted over old data!

"},{"location":"games/sega/ongeki/common/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create another empty folder named AppData next to them. It should now look like below.

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/ongeki/common/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/ongeki/common/setup/#installing-option-data","title":"Installing option data","text":"

O.N.G.E.K.I. content updates are distributed through option folders instead of patching the base game. They are named A???, with each ? being a number. Custom options distributed by the community might use letters instead, to distinguish them from official ones.

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

In some cases, your data may have options in App\\package\\option. If so, move all contents inside to the Option folder where App and AppData are and delete the App\\package\\option folder.

"},{"location":"games/sega/ongeki/common/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

O.N.G.E.K.I. executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of the following files and the associated configuration file:

  • amdaemon.exe
  • mu3.exe
  • mu3_Data\\Plugins\\amdaemon_api.dll
  • mu3_Data\\Plugins\\chiffre.dll
  • mu3_Data\\Plugins\\libhttp.dll
  • mu3_Data\\Plugins\\QR_Image.dll
  • mu3_Data\\Managed\\AMDaemon.NET.dll
  • mu3_Data\\Managed\\Assembly-CSharp-firstpass.dll
  • mu3_Data\\Managed\\Assembly-CSharp.dll
  • mu3.ini

Copy the files and folders into the App/Package folder of your game data. Agree to overwrite when asked.

Assembly-CSharp Note

Assembly-CSharp.dll must match your game version.

"},{"location":"games/sega/ongeki/common/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/ongeki/common/setup/#mu3ini","title":"mu3.ini","text":"

Ensure that the App\\package folder contains mu3.ini.

If this configuration file is missing, create one using the contents below.

[AM]\nIgnoreError=1\nOptionDev=0\nDummyAime=0\nDummyCredit=1\nDummyJVS=0\n\n[Sound]\nWasapiExclusive=0\n

Warning

If you are following the folder structure of this guide, you must ensure that OptionDev is set to 0 in your mu3.ini, or else your Option data will not load.

"},{"location":"games/sega/ongeki/common/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download segatools.zip. Do not download the source code.
  • Extracting the archive should give you a few more zip files. Find mu3.zip and extract it to the App\\package folder in your game data.

You should now have a few more files inside the folder, as highlighted:

"},{"location":"games/sega/ongeki/common/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\package\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
"},{"location":"games/sega/ongeki/common/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n
mu3-mods

It's strongly recommended to use BepInEx mods to improve QOL. You can find info about the available mods for O.N.G.E.K.I. here mu3-mods. For general modding check Unity modding page.

"},{"location":"games/sega/ongeki/common/setup/#setting-launch-options","title":"Setting launch options","text":"

Right click App\\package\\start.bat, select Edit. Locate the line that launches mu3 and edit it according to your preferences:

@echo off\n\npushd %~dp0\n\nstart \"AM Daemon\" /min inject -d -k mu3hook.dll amdaemon.exe -f -c config_common.json config_server.json config_client.json\ninject -d -k mu3hook.dll mu3 -screen-fullscreen 0 -popupwindow -screen-width 1080 -screen-height 1920\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Launch options
  • -screen-fullscreen 0: windowed
  • -screen-fullscreen 0 -popupwindow: borderless windowed
  • -screen-fullscreen 1: exclusive fullscreen
  • -screen-width <W> -screen-height <H>: resolution
Note about resolution
  • The service menu will only render correctly at 1080x1920.
  • This can be fixed with a patch.
  • -monitor <N>: the monitor to run the game on
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number. For example, monitor 2 means -monitor 2.

"},{"location":"games/sega/ongeki/common/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.162.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\package\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/ongeki/common/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/ongeki/common/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/ongeki/common/setup/#audio","title":"Audio","text":"
  • Open App\\package\\mu3.ini (or create it if it doesn't exist).
  • Set WasapiExclusive in the Sound section to 0 (create the key if it doesn't exist):
[Sound]\nWasapiExclusive=0\n
"},{"location":"games/sega/ongeki/common/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/ongeki/common/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/ongeki/common/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\package\\start.bat. Let the game load until you reach a screen with the message below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 6th option).

Select \u30b0\u30eb\u30fc\u30d7\u5185\u57fa\u6e96\u6a5f\u306e\u8a2d\u5b9a (SET STANDARD IN GROUP, the second option) and toggle this setting to \u57fa\u6e96\u6a5f (STANDARD).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/ongeki/common/setup/#close-setting","title":"CLOSE SETTING","text":"

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the 10th option).

Navigate to \u6642 (HOUR, the 2nd option) and use the Service button to toggle the setting until it says \u5168\u6642\u523b (ALL TIME).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu, then select \u7d42\u4e86 (also the last option) in the main menu to exit the service menu.

You're all done! The game should load up properly now.

You can add coins using the Coin key (default F3) and card in by holding the Enter key.

"},{"location":"games/sega/ongeki/common/setup/#custom-mods","title":"Custom Mods","text":"

Mods are covered on the Unity modding page.

"},{"location":"games/sega/ongeki/common/setup/#controllers-and-troubleshooting","title":"Controllers and Troubleshooting","text":"

Input methods and controllers are covered on the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/ongeki/common/troubleshooting/","title":"Troubleshooting","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/ongeki/common/troubleshooting/#my-game-crashes-on-launchstuck-on-starting-system-process","title":"My game crashes on launch/stuck on \"Starting System Process\"","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject -d -k mu3hook.dll amdaemon.exe -f -c config_common.json config_server.json\nping 127.0.0.1 -n 31 > nul && taskkill /F /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/ongeki/common/troubleshooting/#my-game-is-stuck-on-a-black-screen-at-launch","title":"My game is stuck on a black screen at launch!","text":"

This could also be due to many things, the most common of which are:

  • You have one or more incorrect/broken DLL(s) in App\\package\\mu3_Data\\Managed

    This is likely to be Assembly-CSharp.dll, Assembly-CSharp-firstpass.dll, and/or AMDaemon.NET.dll. You can try replacing the DLLs or re-downloading data from elsewhere.

  • An ill-formed keychip is defined in segatools.ini

"},{"location":"games/sega/ongeki/common/troubleshooting/#my-game-is-running-too-slowfast-or-the-notes-are-out-of-sync","title":"My game is running too slow/fast or the notes are out of sync!","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Limit mu3.exe to run at 60 FPS using a tool like RivaTuner or a patch.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/ongeki/common/troubleshooting/#my-lever-controls-arent-working","title":"My lever controls aren't working!","text":"

You may need to calibrate your lever.

From the TEST MENU select \u30ec\u30d0\u30fc\u8a2d\u5b9a (LEVER SETTINGS) and then move the lever left to right ensuring that the game detects the full range of motion.

Then save by selecting \u7d42\u4e86 (EXIT) and then \u4fdd\u5b58\u3059\u308b (SAVE).

"},{"location":"games/sega/ongeki/common/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for mu3.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/ongeki/refresh/controllers/","title":"Controllers (O.N.G.E.K.I. Re:Fresh)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and XInput Controllers. However, it can be configured with IO DLLs to add support for other controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\package folder and referenced in segatools.ini under the [mu3io] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[mu3io]\n; To use a custom O.N.G.E.K.I. IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard/gamepad input.\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/ongeki/refresh/controllers/#keyboard-and-mouse","title":"Keyboard and Mouse","text":"

Keyboard and Mouse is the default input method.

To enable mouse lever emulation ensure that the mouse option is set to 1 in the [io4] section of your segatools.ini:

[io4]\n; Set \"1\" to enable mouse lever emulation, \"0\" to use XInput\nmouse=1\n

The default layout use ASD for the left 3 buttons, and JKL for the right 3 buttons. Mouse Left/Right Click are used for the left and right bumper buttons.

If you wish to change the default keybinds, an explanation on how to set these is included above the [io4] section in your segatools.ini.

"},{"location":"games/sega/ongeki/refresh/controllers/#xinput-controller","title":"XInput Controller","text":"

XInput controllers are supported by segatools. To enable XInput, ensure that the mouse option is set to 0 in the [io4] section of your segatools.ini:

[io4]\n; Set \"1\" to enable mouse lever emulation, \"0\" to use XInput\nmouse=0\n

If you wish to change the default keybinds, an explanation on how to set these is included above the [io4] section in your segatools.ini.

"},{"location":"games/sega/ongeki/refresh/controllers/#mageki","title":"Mageki","text":"

Mageki allows you to use a mobile device as a O.N.G.E.K.I. controller. It replicates the layout of an arcade O.N.G.E.K.I. controller on your mobile device.

Mageki supports both Android and iOS devices. For installation instructions, please refer to the English User Manual on the Mageki GitHub Repository.

Configuring ongeki-io and MU3-input.dll

When moving the zipped contents of MU3Input, move all folders EXCEPT the segatools.ini file into your App\\package folder in a way that matches its file structure. Modify the [mu3io] and [aimeio] sections of your existing segatools.ini file to look like the following:

[mu3io]\npath=MU3Input.dll\n\n[aimeio]\npath=MU3Input.dll\n
If these sections do not exist, add them to the end of your segatools.ini file.

IOConfig doesn't launch for me/This application requires the Windows App Runtime

Download and extract the contents of the Windows App Runtime Version 1.5 Redistributable In the WindowsAppSDK-Installer-x64 folder run WindowsAppRuntimeInstall-x64.exe

If IOConfig still fails to launch, try using the SelfContained version of ongeki-io

"},{"location":"games/sega/ongeki/refresh/controllers/#ontroller","title":"ONTROLLER","text":"
  • Navigate to Mu3IO.NET releases and download mu3io.dll. Put this file in your App\\package folder.
  • Edit your segatools.ini to reference the DLL:
[mu3io]\n; To use a custom O.N.G.E.K.I. IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard/gamepad input.\npath=mu3io.dll\n
"},{"location":"games/sega/ongeki/refresh/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet slider and air sensors, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/ongeki/refresh/setup/","title":"Game Setup (O.N.G.E.K.I. Re:Fresh)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of O.N.G.E.K.I.

You'll want to create a new folder for the game and start from scratch. O.N.G.E.K.I. DOES NOT like being extracted over old data!

"},{"location":"games/sega/ongeki/refresh/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create another empty folder named AppData next to them. It should now look like below.

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/ongeki/refresh/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/ongeki/refresh/setup/#installing-option-data","title":"Installing option data","text":"

O.N.G.E.K.I. content updates are distributed through option folders instead of patching the base game. They are named A???, with each ? being a number. Custom options distributed by the community might use letters instead, to distinguish them from official ones.

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

In some cases, your data may have options in App\\package\\option. If so, move all contents inside to the Option folder where App and AppData are and delete the App\\package\\option folder.

"},{"location":"games/sega/ongeki/refresh/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

O.N.G.E.K.I. executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of the following files and the associated configuration file:

  • amdaemon.exe
  • mu3.exe
  • mu3_Data\\Plugins\\amdaemon_api.dll
  • mu3_Data\\Plugins\\chiffre.dll
  • mu3_Data\\Plugins\\libhttp.dll
  • mu3_Data\\Plugins\\QR_Image.dll
  • mu3_Data\\Managed\\AMDaemon.NET.dll
  • mu3_Data\\Managed\\Assembly-CSharp-firstpass.dll
  • mu3_Data\\Managed\\Assembly-CSharp.dll
  • mu3.ini

Copy the files and folders into the App/Package folder of your game data. Agree to overwrite when asked.

Assembly-CSharp Note

Assembly-CSharp.dll must match your game version.

"},{"location":"games/sega/ongeki/refresh/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/ongeki/refresh/setup/#mu3ini","title":"mu3.ini","text":"

Ensure that the App\\package folder contains mu3.ini.

If this configuration file is missing, create one using the contents below.

[AM]\nIgnoreError=1\nOptionDev=0\nDummyAime=0\nDummyCredit=1\nDummyJVS=0\n\n[Sound]\nWasapiExclusive=0\n

Warning

If you are following the folder structure of this guide, you must ensure that OptionDev is set to 0 in your mu3.ini, or else your Option data will not load.

"},{"location":"games/sega/ongeki/refresh/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download segatools.zip. Do not download the source code.
  • Extracting the archive should give you a few more zip files. Find mu3.zip and extract it to the App\\package folder in your game data.

You should now have a few more files inside the folder, as highlighted:

"},{"location":"games/sega/ongeki/refresh/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\package\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
"},{"location":"games/sega/ongeki/refresh/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n
mu3-mods

It's strongly recommended to use BepInEx mods to improve QOL. You can find info about the available mods for O.N.G.E.K.I. here mu3-mods. For general modding check Unity modding page.

"},{"location":"games/sega/ongeki/refresh/setup/#setting-launch-options","title":"Setting launch options","text":"

Right click App\\package\\start.bat, select Edit. Locate the line that launches mu3 and edit it according to your preferences:

@echo off\n\npushd %~dp0\n\nstart \"AM Daemon\" /min inject -d -k mu3hook.dll amdaemon.exe -f -c config_common.json config_server.json config_client.json\ninject -d -k mu3hook.dll mu3 -screen-fullscreen 0 -popupwindow -screen-width 1080 -screen-height 1920\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Launch options
  • -screen-fullscreen 0: windowed
  • -screen-fullscreen 0 -popupwindow: borderless windowed
  • -screen-fullscreen 1: exclusive fullscreen
  • -screen-width <W> -screen-height <H>: resolution
Note about resolution
  • The service menu will only render correctly at 1080x1920.
  • This can be fixed with a patch.
  • -monitor <N>: the monitor to run the game on
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number. For example, monitor 2 means -monitor 2.

"},{"location":"games/sega/ongeki/refresh/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.162.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\package\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/ongeki/refresh/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/ongeki/refresh/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/ongeki/refresh/setup/#audio","title":"Audio","text":"
  • Open App\\package\\mu3.ini (or create it if it doesn't exist).
  • Set WasapiExclusive in the Sound section to 0 (create the key if it doesn't exist):
[Sound]\nWasapiExclusive=0\n
"},{"location":"games/sega/ongeki/refresh/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/ongeki/refresh/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/ongeki/refresh/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\package\\start.bat. Let the game load until you reach a screen with the message below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 6th option).

Select \u30b0\u30eb\u30fc\u30d7\u5185\u57fa\u6e96\u6a5f\u306e\u8a2d\u5b9a (SET STANDARD IN GROUP, the second option) and toggle this setting to \u57fa\u6e96\u6a5f (STANDARD).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/ongeki/refresh/setup/#close-setting","title":"CLOSE SETTING","text":"

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the 10th option).

Navigate to \u6642 (HOUR, the 2nd option) and use the Service button to toggle the setting until it says \u5168\u6642\u523b (ALL TIME).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu, then select \u7d42\u4e86 (also the last option) in the main menu to exit the service menu.

You're all done! The game should load up properly now.

You can add coins using the Coin key (default F3) and card in by holding the Enter key.

"},{"location":"games/sega/ongeki/refresh/setup/#custom-mods","title":"Custom Mods","text":"

Mods are covered on the Unity modding page.

"},{"location":"games/sega/ongeki/refresh/setup/#controllers-and-troubleshooting","title":"Controllers and Troubleshooting","text":"

Input methods and controllers are covered on the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/ongeki/refresh/troubleshooting/","title":"Troubleshooting (O.N.G.E.K.I. Re:Fresh)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/ongeki/refresh/troubleshooting/#my-game-crashes-on-launchstuck-on-starting-system-process","title":"My game crashes on launch/stuck on \"Starting System Process\"","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject -d -k mu3hook.dll amdaemon.exe -f -c config_common.json config_server.json\nping 127.0.0.1 -n 31 > nul && taskkill /F /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/ongeki/refresh/troubleshooting/#my-game-is-stuck-on-a-black-screen-at-launch","title":"My game is stuck on a black screen at launch!","text":"

This could also be due to many things, the most common of which are:

  • You have one or more incorrect/broken DLL(s) in App\\package\\mu3_Data\\Managed

    This is likely to be Assembly-CSharp.dll, Assembly-CSharp-firstpass.dll, and/or AMDaemon.NET.dll. You can try replacing the DLLs or re-downloading data from elsewhere.

  • An ill-formed keychip is defined in segatools.ini

"},{"location":"games/sega/ongeki/refresh/troubleshooting/#my-game-is-running-too-slowfast-or-the-notes-are-out-of-sync","title":"My game is running too slow/fast or the notes are out of sync!","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Limit mu3.exe to run at 60 FPS using a tool like RivaTuner or a patch.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/ongeki/refresh/troubleshooting/#my-lever-controls-arent-working","title":"My lever controls aren't working!","text":"

You may need to calibrate your lever.

From the TEST MENU select \u30ec\u30d0\u30fc\u8a2d\u5b9a (LEVER SETTINGS) and then move the lever left to right ensuring that the game detects the full range of motion.

Then save by selecting \u7d42\u4e86 (EXIT) and then \u4fdd\u5b58\u3059\u308b (SAVE).

"},{"location":"games/sega/ongeki/refresh/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for mu3.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/wacca/common/controllers/","title":"Controllers","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and XInput Controllers. However, it can be configured with IO DLLs to add support for other controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\bin folder and referenced in segatools.ini under the [mercuryio] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[mercuryio]\n; To use a custom WACCA IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/wacca/common/controllers/#touch-screen-mobile-device","title":"Touch screen / Mobile device","text":"

Both Any2WACCAi and Toucca allows you to use a touch screen or a mobile device as a WACCA controller. It replicates the layout of an arcade WACCA cab.

Installation instructions

Any2WACCAi

Toucca

"},{"location":"games/sega/wacca/common/controllers/#wacvr","title":"WACVR","text":"

WACVR allows you to use a VR Headset to replicate a WACCA cab and use it as a controller.

Setting up WACVR

Download WACVR from here and extract to a folder of your choice. Copy the mercuryio.dll file to the the App/bin folder in your data folder.

Edit your segatools.ini like this:

[mercuryio]\n; To use a custom WACCA IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=mercuryio.dll\n

Start up your VR software as well as SteamVR, then launch WACCA and WACVR.exe. WACVR should set up with WACCA automatically.

Warning

If you're experiencing a warped screen in WACVR, make sure your monitor is set to portrait mode and check the Full display capture box in WACVR.

"},{"location":"games/sega/wacca/common/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you want to run the game on a real cab, check the reDIVE World website

If you're interested in using a cabinet slider, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/wacca/common/setup/","title":"Setup","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/wacca/common/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/wacca/common/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract all updates in order. Agree to overwrite files if necessary.

For example, if you have 3.00.00; install 3.01.00, then 3.02.00, etc.

"},{"location":"games/sega/wacca/common/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your amfs folder already has a file named ICF1, skip this step.

In some cases, your data may have a folder containing ICFs in App\\bin\\amfs. If so, move all contents inside to the amfs folder where App and AppData, delete the App\\bin\\amfs folder, and skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/wacca/common/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher.

"},{"location":"games/sega/wacca/common/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download segatools.zip. Do not download the source code.
  • Extracting the archive should give you a few more zip files. Find mercury.zip and extract it to the App\\bin folder in your game data.

You should now have a few more files inside the folder, as highlighted:

"},{"location":"games/sega/wacca/common/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\bin\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
"},{"location":"games/sega/wacca/common/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\nappdata=../../AppData\n

Relative Directories

The ../ in the above example represents the parent directory in a relative path. It is used to navigate up one level in the directory hierarchy.

For example, your segatools.ini is located at /App/bin/segatools.ini and your amfs folder is located next to the App folder.

Since segatools.ini is in the /bin/ folder, typing ../ would move you up to the App folder. Since the amfs folder is next to the App folder, the second ../ takes you to App's parent folder, which is the folder containing App, amfs, etc.

The benefits of using this method include:

  • Avoiding issues that arise when folders have spaces in their names.

  • Being able to move your game folder without redefining the locations of your VFS folders.

  • A cleaner and easier to read segatools.ini, making spotting issues simpler.

"},{"location":"games/sega/wacca/common/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

This step is not needed if you plan on running the offline patch.

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.174.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\package\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/wacca/common/setup/#pre-launch-requirement","title":"Pre-launch requirement","text":"

This step is required, otherwise your game won't run.

"},{"location":"games/sega/wacca/common/setup/#install-ftdi-leds-driver","title":"Install FTDI LEDs driver","text":"

Download FTDI drivers from here and extract them to a folder of your choice, then copy CDM-v2.12.36.4-WHQL-Certified/amd64/ftd2xx64.dll to /App/WindowsNoEditor/Mercury/Binaries/Win64 and then rename the file to ftd2xx.dll.

"},{"location":"games/sega/wacca/common/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/wacca/common/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/wacca/common/setup/#first-launch","title":"First launch","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Set your display orientation to portrait mode.

Start the game by running App\\bin\\start.bat.

"},{"location":"games/sega/wacca/common/setup/#close-setting","title":"CLOSE SETTING","text":"

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

You can also use the Volume buttons (default UP and DOWN keys) to navigate and the ENTER key to select.

Navigate to SYSTEM SETTING.

Navigate to CLOSING TIME SETTINGS.

Navigate to ALL DAYS OF THE WEEK and use the Service button to toggle the setting until it says OFF.

Select APPLY SETTINGS AND RE-BOOT to save the settings.

Note that this will close your game and you will have to start it again with start.bat.

You're all done! The game should load up properly now.

You can add coins using the Coin key (default F3) and card in by holding the Enter key.

"},{"location":"games/sega/wacca/common/setup/#controllers-and-troubleshooting","title":"Controllers and Troubleshooting","text":"

Input methods and controllers are covered on the Controllers page.

Have any other issues?

Check out the Error Codes page.

"},{"location":"games/sega/wacca/lilyr/controllers/","title":"Controllers (WACCA Lily R)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and XInput Controllers. However, it can be configured with IO DLLs to add support for other controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\bin folder and referenced in segatools.ini under the [mercuryio] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[mercuryio]\n; To use a custom WACCA IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/wacca/lilyr/controllers/#touch-screen-mobile-device","title":"Touch screen / Mobile device","text":"

Both Any2WACCAi and Toucca allows you to use a touch screen or a mobile device as a WACCA controller. It replicates the layout of an arcade WACCA cab.

Installation instructions

Any2WACCAi

Toucca

"},{"location":"games/sega/wacca/lilyr/controllers/#wacvr","title":"WACVR","text":"

WACVR allows you to use a VR Headset to replicate a WACCA cab and use it as a controller.

Setting up WACVR

Download WACVR from here and extract to a folder of your choice. Copy the mercuryio.dll file to the the App/bin folder in your data folder.

Edit your segatools.ini like this:

[mercuryio]\n; To use a custom WACCA IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=mercuryio.dll\n

Start up your VR software as well as SteamVR, then launch WACCA and WACVR.exe. WACVR should set up with WACCA automatically.

Warning

If you're experiencing a warped screen in WACVR, make sure your monitor is set to portrait mode and check the Full display capture box in WACVR.

"},{"location":"games/sega/wacca/lilyr/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you want to run the game on a real cab, check the reDIVE World website

If you're interested in using a cabinet slider, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/wacca/lilyr/setup/","title":"Game Setup (WACCA Lily R)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/wacca/lilyr/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/wacca/lilyr/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract all updates in order. Agree to overwrite files if necessary.

For example, if you have 3.00.00; install 3.01.00, then 3.02.00, etc.

"},{"location":"games/sega/wacca/lilyr/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your amfs folder already has a file named ICF1, skip this step.

In some cases, your data may have a folder containing ICFs in App\\bin\\amfs. If so, move all contents inside to the amfs folder where App and AppData, delete the App\\bin\\amfs folder, and skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/wacca/lilyr/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher.

"},{"location":"games/sega/wacca/lilyr/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download segatools.zip. Do not download the source code.
  • Extracting the archive should give you a few more zip files. Find mercury.zip and extract it to the App\\bin folder in your game data.

You should now have a few more files inside the folder, as highlighted:

"},{"location":"games/sega/wacca/lilyr/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\bin\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
"},{"location":"games/sega/wacca/lilyr/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\nappdata=../../AppData\n

Relative Directories

The ../ in the above example represents the parent directory in a relative path. It is used to navigate up one level in the directory hierarchy.

For example, your segatools.ini is located at /App/bin/segatools.ini and your amfs folder is located next to the App folder.

Since segatools.ini is in the /bin/ folder, typing ../ would move you up to the App folder. Since the amfs folder is next to the App folder, the second ../ takes you to App's parent folder, which is the folder containing App, amfs, etc.

The benefits of using this method include:

  • Avoiding issues that arise when folders have spaces in their names.

  • Being able to move your game folder without redefining the locations of your VFS folders.

  • A cleaner and easier to read segatools.ini, making spotting issues simpler.

"},{"location":"games/sega/wacca/lilyr/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

This step is not needed if you plan on running the offline patch.

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.174.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\package\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/wacca/lilyr/setup/#pre-launch-requirement","title":"Pre-launch requirement","text":"

This step is required, otherwise your game won't run.

"},{"location":"games/sega/wacca/lilyr/setup/#install-ftdi-leds-driver","title":"Install FTDI LEDs driver","text":"

Download FTDI drivers from here and extract them to a folder of your choice, then copy CDM-v2.12.36.4-WHQL-Certified/amd64/ftd2xx64.dll to /App/WindowsNoEditor/Mercury/Binaries/Win64 and then rename the file to ftd2xx.dll.

"},{"location":"games/sega/wacca/lilyr/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/wacca/lilyr/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/wacca/lilyr/setup/#first-launch","title":"First launch","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Set your display orientation to portrait mode.

Start the game by running App\\bin\\start.bat.

"},{"location":"games/sega/wacca/lilyr/setup/#close-setting","title":"CLOSE SETTING","text":"

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

You can also use the Volume buttons (default UP and DOWN keys) to navigate and the ENTER key to select.

Navigate to SYSTEM SETTING.

Navigate to CLOSING TIME SETTINGS.

Navigate to ALL DAYS OF THE WEEK and use the Service button to toggle the setting until it says OFF.

Select APPLY SETTINGS AND RE-BOOT to save the settings.

Note that this will close your game and you will have to start it again with start.bat.

You're all done! The game should load up properly now.

You can add coins using the Coin key (default F3) and card in by holding the Enter key.

"},{"location":"games/sega/wacca/lilyr/setup/#controllers-and-troubleshooting","title":"Controllers and Troubleshooting","text":"

Input methods and controllers are covered on the Controllers page.

Have any other issues?

Check out the Error Codes page.

"},{"location":"games/sega/wacca/reverse/controllers/","title":"Controllers (WACCA Reverse)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and XInput Controllers. However, it can be configured with IO DLLs to add support for other controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\bin folder and referenced in segatools.ini under the [mercuryio] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[mercuryio]\n; To use a custom WACCA IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/wacca/reverse/controllers/#touch-screen-mobile-device","title":"Touch screen / Mobile device","text":"

Both Any2WACCAi and Toucca allows you to use a touch screen or a mobile device as a WACCA controller. It replicates the layout of an arcade WACCA cab.

Installation instructions

Any2WACCAi

Toucca

"},{"location":"games/sega/wacca/reverse/controllers/#wacvr","title":"WACVR","text":"

WACVR allows you to use a VR Headset to replicate a WACCA cab and use it as a controller.

Setting up WACVR

Download WACVR from here and extract to a folder of your choice. Copy the mercuryio.dll file to the the App/bin folder in your data folder.

Edit your segatools.ini like this:

[mercuryio]\n; To use a custom WACCA IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=mercuryio.dll\n

Start up your VR software as well as SteamVR, then launch WACCA and WACVR.exe. WACVR should set up with WACCA automatically.

Warning

If you're experiencing a warped screen in WACVR, make sure your monitor is set to portrait mode and check the Full display capture box in WACVR.

"},{"location":"games/sega/wacca/reverse/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you want to run the game on a real cab, check the reDIVE World website

If you're interested in using a cabinet slider, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/wacca/reverse/setup/","title":"Game Setup (WACCA Reverse)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/wacca/reverse/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/wacca/reverse/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract all updates in order. Agree to overwrite files if necessary.

For example, if you have 3.00.00; install 3.01.00, then 3.02.00, etc.

"},{"location":"games/sega/wacca/reverse/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your amfs folder already has a file named ICF1, skip this step.

In some cases, your data may have a folder containing ICFs in App\\bin\\amfs. If so, move all contents inside to the amfs folder where App and AppData, delete the App\\bin\\amfs folder, and skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/wacca/reverse/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher.

"},{"location":"games/sega/wacca/reverse/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download segatools.zip. Do not download the source code.
  • Extracting the archive should give you a few more zip files. Find mercury.zip and extract it to the App\\bin folder in your game data.

You should now have a few more files inside the folder, as highlighted:

"},{"location":"games/sega/wacca/reverse/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\bin\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
"},{"location":"games/sega/wacca/reverse/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\nappdata=../../AppData\n

Relative Directories

The ../ in the above example represents the parent directory in a relative path. It is used to navigate up one level in the directory hierarchy.

For example, your segatools.ini is located at /App/bin/segatools.ini and your amfs folder is located next to the App folder.

Since segatools.ini is in the /bin/ folder, typing ../ would move you up to the App folder. Since the amfs folder is next to the App folder, the second ../ takes you to App's parent folder, which is the folder containing App, amfs, etc.

The benefits of using this method include:

  • Avoiding issues that arise when folders have spaces in their names.

  • Being able to move your game folder without redefining the locations of your VFS folders.

  • A cleaner and easier to read segatools.ini, making spotting issues simpler.

"},{"location":"games/sega/wacca/reverse/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

This step is not needed if you plan on running the offline patch.

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.174.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\package\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/wacca/reverse/setup/#pre-launch-requirement","title":"Pre-launch requirement","text":"

This step is required, otherwise your game won't run.

"},{"location":"games/sega/wacca/reverse/setup/#install-ftdi-leds-driver","title":"Install FTDI LEDs driver","text":"

Download FTDI drivers from here and extract them to a folder of your choice, then copy CDM-v2.12.36.4-WHQL-Certified/amd64/ftd2xx64.dll to /App/WindowsNoEditor/Mercury/Binaries/Win64 and then rename the file to ftd2xx.dll.

"},{"location":"games/sega/wacca/reverse/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/wacca/reverse/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/wacca/reverse/setup/#first-launch","title":"First launch","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Set your display orientation to portrait mode.

Start the game by running App\\bin\\start.bat.

"},{"location":"games/sega/wacca/reverse/setup/#close-setting","title":"CLOSE SETTING","text":"

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

You can also use the Volume buttons (default UP and DOWN keys) to navigate and the ENTER key to select.

Navigate to SYSTEM SETTING.

Navigate to CLOSING TIME SETTINGS.

Navigate to ALL DAYS OF THE WEEK and use the Service button to toggle the setting until it says OFF.

Select APPLY SETTINGS AND RE-BOOT to save the settings.

Note that this will close your game and you will have to start it again with start.bat.

You're all done! The game should load up properly now.

You can add coins using the Coin key (default F3) and card in by holding the Enter key.

"},{"location":"games/sega/wacca/reverse/setup/#controllers-and-troubleshooting","title":"Controllers and Troubleshooting","text":"

Input methods and controllers are covered on the Controllers page.

Have any other issues?

Check out the Error Codes page.

"}]} \ No newline at end of file +{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Home","text":"

A compendium of information and guides about arcade games. By the community, for the community.

Join our Discord server!

Troubleshooting forums are available on our Discord server if you need direct help!

This site is by no means all-encompassing

We're only a group of volunteers aiming to bring you the most up-to-date information.

But we're only humans, we make mistakes, and therefore:

  • Please use a certain degree of caution while manipulating your game files and make backups.
  • Don't tamper with things if you don't know what you're doing.

If you can do that, these guides will probably be of use to you. If not, don't tell us we didn't warn you!

How to use the site?

On the left side is a navigation bar containing every guide:

  • Games category for game-specific guides on how to setup data, troubleshoot issues, etc..
  • Error Codes for a listing of known errors and what to do about them.
  • Game Patching category for ways to patch/modify your game.
  • Extras for anything that doesn't fit in the above categories.
  • Other Resources for links to useful sites such as patchers, external guides, etc..

Do you want to help us out?

Please check out our GitHub Repo by clicking the link at the top of right of the page. Information on how to contribute is available there.

"},{"location":"resources/","title":"Other Resources","text":""},{"location":"resources/#spice2x-patchers","title":"Spice2x Patchers","text":"

See Spice2x Patching.

  • TWO-TORIAL - https://sp2x.two-torial.xyz/ - Our open-source patcher for Spice2x compatible games.
  • DJTrackers - https://djtrackers.com/bemanipatcher/2x - Recommended for anything we don't yet support. Our IIDX patches are based off of theirs for the most part.
"},{"location":"resources/#web-patchers","title":"Web Patchers","text":"

See Web Patching.

  • TWO-TORIAL - Our open-source web patcher (based on mon's) for games incompatible with Spice2x. Also integrates Scribbler's patches for chunithm.
  • mon's - The longest lasting web patcher, supports a variety of n-1 and older games.
  • Scribbler's Chuni Only Patcher - Has every version of Chunithm available.
"},{"location":"resources/#general","title":"General","text":"
  • Spice2x Wiki - The best resource for Spice2x
  • Bemaniwiki - A bemani wiki written in japanese
  • wikiwiki - A japanese game wiki, good for comparing against SilentBlue
  • Namuwiki - A korean wiki for bemani and more
  • RemyWiki - Bemani arcade games wiki with lots of useful info
  • SilentBlue - By RemyWiki's creators, but for SEGA games
"},{"location":"resources/#cons-cabs","title":"Cons & Cabs","text":"
  • GameRepair.info - Repository of arcade part repair & misc information
  • Cons&Stuff - Community resource for DIY controllers
  • Rhythm Game Cabs - Discord server for arcade cabs
"},{"location":"resources/#iidx","title":"IIDX","text":"
  • iidx.org - The go to guide for mechanics and skill related things
  • sp12 - IIDX SP\u260612 reference site/difficulty tier list
  • beatmania.app - IIDX INFINITAS difficulty tier list
  • Statistik - IIDX difficulty tier list
  • atwiki - IIDX wiki in JP (includes tier lists)
  • textage.cc - Chart viewing resource
  • DJ DAO IIDX troubleshooting guide - Step-by-step guide for FPS, FP7, PEE, RES, RED controllers.
"},{"location":"resources/#sdvx","title":"SDVX","text":"
  • sdvx.org - The go to guide for mechanics and skill related things
  • SDVX Index - SDVX chart viewer and reference
  • sdvx.in - worse alternative to SDVX Index (but can be used for Chunithm and Ongeki too)
  • SDVX Progress Chart - Functions as a generalized tier list
  • SDVX Unlock Guide - Translated guide for unlocks
"},{"location":"resources/#gitadora","title":"GITADORA","text":"
  • 573Controller - DIY guitar solution for converting official cab guitars to USB home-use
  • Drummania English Menu Translation - Handy for beginners, lots of options!
"},{"location":"resources/#chunithm","title":"CHUNITHM","text":"
  • sdvx.in - Chart viewer for CHUNITHM
  • CHUNITHM Humen - Screen captures of all CHUNITHM charts
  • Codex's English Chunithm Guide - Handy CHUNITHM resource for players of all skill levels
"},{"location":"resources/#ongeki","title":"O.N.G.E.K.I.","text":"
  • sdvx.in \u2013 Chart viewer for O.N.G.E.K.I.
  • O.N.G.E.K.I. Humen and MLN Rev \u2013 Screen captures of all O.N.G.E.K.I. charts
  • Lilyshy's English O.N.G.E.K.I. Guide \u2013 Handy O.N.G.E.K.I. resource for players of all skill levels
"},{"location":"errorcodes/bemani/","title":"BEMANI Error Codes","text":"

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.

"},{"location":"errorcodes/bemani/#universal-error-codes","title":"Universal Error Codes","text":""},{"location":"errorcodes/bemani/#5-0000-0000","title":"5-0000-0000","text":"

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.

"},{"location":"errorcodes/bemani/#5-2000-0000","title":"5-2000-0000","text":"

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.

"},{"location":"errorcodes/bemani/#5-2002-0915","title":"5-2002-0915","text":"

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.

"},{"location":"errorcodes/bemani/#5-2600-0000","title":"5-2600-0000","text":"

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.

"},{"location":"errorcodes/bemani/#iidx-error-codes","title":"IIDX Error Codes","text":""},{"location":"errorcodes/bemani/#5-1500-0002","title":"5-1500-0002","text":"

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.

"},{"location":"errorcodes/bemani/#5-1503-0004","title":"5-1503-0004","text":"

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.

"},{"location":"errorcodes/bemani/#5-1505-0001","title":"5-1505-0001","text":"

SSD DATA ERROR

This error occurs when the data is horribly corrupt, incomplete, or modified incorrectly. Please redownload your data from a reliable source.

"},{"location":"errorcodes/bemani/#5-1503-0042","title":"5-1503-0042","text":"

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 patch 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.

"},{"location":"errorcodes/bemani/#5-1506-0001","title":"5-1506-0001","text":"

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.

"},{"location":"errorcodes/bemani/#sound-voltex-error-codes","title":"Sound Voltex Error Codes","text":""},{"location":"errorcodes/bemani/#5-1506-0000","title":"5-1506-0000","text":"

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.

"},{"location":"errorcodes/bemani/#5-2009-0000","title":"5-2009-0000","text":"

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.

"},{"location":"errorcodes/bemani/#popn-error-codes","title":"Pop'n Error Codes","text":""},{"location":"errorcodes/bemani/#5-1509-0000","title":"5-1509-0000","text":"

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.

"},{"location":"errorcodes/bemani/#5-2002-2400","title":"5-2002-2400","text":"

This error was seen on Pop'n Usaneko due to improper setup and bad parameter usage in SpiceTools, make sure to follow the Game 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.

"},{"location":"errorcodes/bemani/#jubeat-error-codes","title":"Jubeat Error Codes","text":""},{"location":"errorcodes/bemani/#5-2500-0000","title":"5-2500-0000","text":"

BACKUP DATA ERROR

Follow the steps listed here

"},{"location":"errorcodes/bemani/#gitadora-error-codes","title":"GITADORA Error Codes","text":""},{"location":"errorcodes/bemani/#5-1698-0000","title":"5-1698-0000","text":"

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\\\n- \\contents\\data\\product\\aep\\\n

Also, remove the following files from these folders.

- battle_matching_3.bin\n- beargarden_3.bin\n- common_3.bin\n- custom_3.bin\n- entry_3.bin\n- game_combo_3.bin\n- game_common_3.bin\n- game_dm_3.bin\n- game_gf_3.bin\n- game_session.bin\n- home.bin\n- mission_result.bin\n- record_3.bin\n- select_music_3.bin\n- tab_3.bin\n- title_3.bin\n- warning_3.bin\n
"},{"location":"errorcodes/bemani/#5-1506-0000_1","title":"5-1506-0000","text":"

Disable all the unused network adapters inside device manager (make sure to view the hidden ones as well and disable those too!)

"},{"location":"errorcodes/bemani/#5-2500-0001","title":"5-2500-0001","text":"

BACKUP DATA ERROR

Follow the steps listed here

"},{"location":"errorcodes/bemani/#5-2501-0000","title":"5-2501-0000","text":"

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.

"},{"location":"errorcodes/bemani/#nostalgia-error-codes","title":"NOSTALGIA Error Codes","text":""},{"location":"errorcodes/bemani/#5-1501-0000","title":"5-1501-0000","text":"

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.

"},{"location":"errorcodes/sega/","title":"SEGA Error Codes","text":"

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.

"},{"location":"errorcodes/sega/#universal-game-error-codes","title":"Universal Game Error Codes","text":""},{"location":"errorcodes/sega/#0000","title":"0000","text":"

Unexpected Error Occured

This error occurs when the data is horribly corrupt, incomplete, or modified incorrectly. Please redownload your data from a reliable source.

"},{"location":"errorcodes/sega/#0032","title":"0032","text":"

Unexpected Error Occured

Generic network error with multiple symptoms, the most typical of which being enabling DHCP in Windows while the game expects a static IP. Try adding this to config_hook.json:

{\n    \"network\": {\n        \"property\": {\n            \"dhcp\": true\n        }\n    }\n}\n

Tip

If you're copying into an existing config_hook.json, remove the outer braces and add a comma to the previous item, like so:

{\n    \"emoney\": {\n        \"enable\": false\n    },// (1)!\n    \"network\": {\n        \"property\": {\n            \"dhcp\": true\n        }\n    }\n}\n
  1. Notice the comma here.

Tip

If your game files does not include config_hook.json, it is OK to create a new file, then edit the launch script (usually start.bat) to tell the game about it:

amdaemon.exe -f -c config_common.json config_server.json config_client.json config_hook.json\n
"},{"location":"errorcodes/sega/#0800","title":"0800","text":"

Unknown Error

Generic network error usually thrown because the game is not able to connect to a server.

Make sure that you have correctly entered your network's address in segatools.ini under the [dns] section: 

[dns]\n; Can also be an IP address:\n; default=192.168.34.23\ndefault=example.com\n

"},{"location":"errorcodes/sega/#0919","title":"0919","text":"

DVD Drive Remain Error

This error occurs if the game detects an enabled DVD drive on the system. To resolve, either disable your computer's DVD drive, or enable DVD drive emulation in segatools.ini:

[dvd]\nenable=1\n
"},{"location":"errorcodes/sega/#0949","title":"0949","text":"

Keychip Not Found

Enable keychip emulation in segatools.ini:

[keychip]\nenable=1\n

If on a real cabinet using a real keychip, confirm that the keychip is connected properly and working.

"},{"location":"errorcodes/sega/#4104","title":"4104","text":"

Unexpected Error Occured

Make sure that the game files are not on the E: or Y: drive. If that is already the case, check if the config files passed to AM Daemon exists and are valid JSON files:

Runtime exception occurred.\nFile: D:\\Jenkins\\workspace\\amdaemon_all_build\\libs\\amdproc\\src\\ConfigFileLoader.cpp\nLine: 79\nFunction: enum amdaemon::process::ConfigFileLoader::Result __cdecl `anonymous-namespace'::parse(const class std::basic_string<wchar_t,struct std::char_traits<wchar_t>,class std::allocator<wchar_t> > &,class picojson::value &)\nMessage: Cannot open \"config_nonexistent.json\".\n
Runtime exception occurred.\nFile: D:\\Jenkins\\workspace\\amdaemon_all_build\\libs\\amdproc\\src\\ConfigFileLoader.cpp\nLine: 89\nFunction: enum amdaemon::process::ConfigFileLoader::Result __cdecl `anonymous-namespace'::parse(const class std::basic_string<wchar_t,struct std::char_traits<wchar_t>,class std::allocator<wchar_t> > &,class picojson::value &)\nMessage: Cannot parse \".\\config_hook.json\".\nsyntax error at line 6 near: }\n
"},{"location":"errorcodes/sega/#4105","title":"4105","text":"

Unexpected Error Occured

Check the AM Daemon window for any \"runtime exception\" messages, such as

amsGfetcherThreadContextInit: Line1345  Error: load Icf failed.\nRuntime exception occurred.\nFile: D:\\Jenkins\\workspace\\amdaemon_all_build\\libs\\libamw\\src\\amw_netdeliver_context.cpp\nLine: 91\nFunction: enum am::util::ModuleContext<3>::Status __cdecl am::netdeliver::Context::initialize(void)\nMessage: amGfetcherInit(). ErrCode -1.\n

Then continue by checking AMDaemon error codes.

"},{"location":"errorcodes/sega/#6401","title":"6401","text":"

I/O board is not connected to main board

This error occurs when the game times out trying to communicate with the I/O board.

When using segatools, this happens because I/O emulation took too long, which is usually caused by long-running background tasks (e.g. Windows Defender, Windows Update, file-syncing software). Try to see if this can be fixed by setting the game process and/or amdaemon.exe to high/realtime priority.

"},{"location":"errorcodes/sega/#6501","title":"6501","text":"

Aime Card Reader Not Found

This error occurs when an Aime card reader is not found. Make sure you enabled Aime card reader emulation in segatools.ini if you don't have a physical reader connected:

[aime]\nenable=1\n
"},{"location":"errorcodes/sega/#6503","title":"6503","text":"

Failed to read Aime card

This error occurs when the Aime card cannot be read. Make sure your connection to the ALL.Net server is good (the network icon in the bottom corner is green).

"},{"location":"errorcodes/sega/#8114","title":"8114","text":"

ALL.Net System error (RTC)

Make sure you're connected to an ALL.Net server for the first boot, or disable accounting by editing config_hook.json:

{\n    \"allnet_accounting\": {\n        \"enable\": false\n    }\n}\n

Tip

If you're copying into an existing config_hook.json, remove the outer braces and add a comma to the previous item, like so:

{\n    \"emoney\": {\n        \"enable\": false\n    },// (1)!\n    \"allnet_accounting\": {\n        \"enable\": false\n    }\n}\n
  1. Notice the comma here.

Tip

If your game files does not include config_hook.json, it is OK to create a new file, then edit the launch script (usually start.bat) to tell the game about it:

amdaemon.exe -f -c config_common.json config_server.json config_client.json config_hook.json\n
"},{"location":"errorcodes/sega/#chunithm-error-codes","title":"CHUNITHM Error Codes","text":""},{"location":"errorcodes/sega/#3101","title":"3101","text":"

An unexpected error has occurred with the main device

This error occurs when the game fails to communicate with the controller. Check if your controller is connected properly and if ChuniIO DLLs are working.

"},{"location":"errorcodes/sega/#3102","title":"3102","text":"

Initialization failure with the main device

This error occurs when the game fails to communicate with the controller. Check if your controller is connected properly and if IO DLLs are working.

"},{"location":"errorcodes/sega/#3201-3202-3203-3204-3205-3206","title":"3201, 3202, 3203, 3204, 3205, 3206","text":"

Cannot confirm the connection with the side device sensor 1/2/3/4/5/6

This error occurs if the air sensors are not functional or blocked during system test. To resolve this, enter and exit Test mode by pressing the F1 key (or 1 on older segatools) then stay clear of your controller. If the error still happens, your air sensors may be faulty.

"},{"location":"errorcodes/sega/#3300","title":"3300","text":"

Duplicate servers in the same network

If multiple CHUNITHM machines are on the same LAN network, only one of them can be the server (dip switch 1 ON). Set all other machines to dip switch 1 OFF:

[system]\ndipsw1=0\n

Warning

As of 2024-08-20, the [gpio] section in segatools has been renamed to [system].

"},{"location":"errorcodes/sega/#3301","title":"3301","text":"

Duplicate STANDARD in the same group

If multiple CHUNITHM machines are on the same LAN network and cabinet group (A/B/C/D), one of them should set reference machine settings to STANDARD and the rest to FOLLOW THE STANDARD. Change this by going to Test menu -> Game Settings (4th option) -> Reference machine settings (2nd option).

"},{"location":"errorcodes/sega/#3400","title":"3400","text":"

Monitor Not Supported 120fps

This error occurs if you're running the game in SP mode but the monitor is not 1920x1080@120Hz in 32-bit color mode. Adjust display settings and try again.

"},{"location":"errorcodes/sega/#3401","title":"3401","text":"

Machine Not Supported 120fps

This error occurs if you're running the game in CVT mode at 120fps. Use SP mode (dip switch 3 OFF) to run the game in 120fps. In segatools.ini this would be:

[system]\ndipsw3=0\n

Warning

As of 2024-08-20, the [gpio] section in segatools has been renamed to [system].

"},{"location":"errorcodes/sega/#amdaemon-error-codes","title":"AMDaemon Error Codes","text":""},{"location":"errorcodes/sega/#ampdgd1232a01ainit-errcode-4","title":"ampdGd1232a01aInit(). ErrCode -4","text":"

This error occurs because of a VFD port number mismatch. Update segatools, or if you're using a real VFD, confirm that the VFD uses the same port as specified in config_common.json or config_sp.json (CHUNITHM) under emoney.display_port:

\"emoney\" :\n{        \n    \"display_port\" : 2 // (1)!\n}\n
  1. This should match the COM port that your real VFD is connected to.
"},{"location":"errorcodes/sega/#amappimageinit-errcode-5","title":"amAppImageInit(). ErrCode -5","text":"

Path to the configured AMFS directory is too long. Ensure that the path is shorter than 16 characters (32 bytes).

"},{"location":"errorcodes/sega/#regcreatekeyexw-errorcode-5","title":"RegCreateKeyExW(). ErrorCode -5","text":"

This error occurs because the Windows registry cannot be written to as a normal user. Start the game as administrator once, or update segatools.

"},{"location":"errorcodes/sega/#amsysfileinitex-errcode-5","title":"amSysFileInitEx(). ErrCode -5","text":"

The AMFS folder is read only. Uncheck the read only property in File Explorer for the AMFS folder.

"},{"location":"errorcodes/sega/#amgfetcherinit-errcode-1","title":"amGfetcherInit(). ErrCode -1","text":"

ICF1 is missing in the configured AMFS directory. Get the correct ICF for your game (the game ID in the ICF must be correct).

"},{"location":"extras/ascs/","title":"Most Common ASCs and Vendors","text":"

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.

"},{"location":"extras/ascs/#iidx","title":"IIDX","text":""},{"location":"extras/ascs/#dj-dao-fp7-emp","title":"DJ DAO FP7 EMP","text":"

This controller works really well, the spacing is accurate 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.

"},{"location":"extras/ascs/#phoenixwan","title":"PHOENIXWAN","text":"

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.

"},{"location":"extras/ascs/#yuancon-iidx","title":"YuanCon IIDX","text":"

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.

"},{"location":"extras/ascs/#iidx-arcade-parts-to-consider","title":"IIDX Arcade Parts to Consider","text":"

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

  • 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.

    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.

"},{"location":"extras/ascs/#sound-voltex","title":"Sound Voltex","text":""},{"location":"extras/ascs/#dj-dao-svse5","title":"DJ DAO SVSE5","text":"

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.

"},{"location":"extras/ascs/#yuancon-sdvx","title":"YuanCon SDVX","text":"

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.

"},{"location":"extras/ascs/#dj-dao-svre9","title":"DJ DAO SVRE9","text":"

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.

"},{"location":"extras/ascs/#sdvx-arcade-parts-to-consider","title":"SDVX Arcade Parts to Consider","text":"

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

  • Springs and Microswitches

    For springs and microswitches, most vendor 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

"},{"location":"extras/ascs/#popn-music","title":"Pop'n Music","text":""},{"location":"extras/ascs/#dj-dao-pop-asc","title":"DJ DAO POP ASC","text":"

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 and getting Samduck buttons, 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 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.

"},{"location":"extras/ascs/#yuancon-popn","title":"YuanCon Pop'n","text":"

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, 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 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.

"},{"location":"extras/ascs/#jubeat","title":"jubeat","text":""},{"location":"extras/ascs/#dj-dao-fb9","title":"DJ DAO FB9","text":"

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 that matches arcade play far better for a more accurate and enjoyable experience. The biggest difference is in how multiple buttons are pressed 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 provides better replacements and official ones can be bought on sites like Yahoo Auctions Japan 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.

"},{"location":"extras/ascs/#ddr","title":"DDR","text":""},{"location":"extras/ascs/#stepmaniax-stage","title":"StepManiaX Stage","text":"

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.

"},{"location":"extras/ascs/#l-tek-pads-aka-polish-dance-pads","title":"L-Tek pads (AKA Polish Dance Pads)","text":"

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.

"},{"location":"extras/ascs/#vendors","title":"Vendors","text":""},{"location":"extras/ascs/#gamo2","title":"Gamo2","text":"
  • Website: https://www.gamo2.com

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 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.

"},{"location":"extras/ascs/#yuancon","title":"YuanCon","text":"
  • Website: https://yuancon.store

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 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 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.

"},{"location":"extras/ascs/#steprevolution-stepmaniax","title":"StepRevolution (StepManiaX)","text":"
  • Website: https://shop.steprevolution.com/

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!

"},{"location":"extras/ascs/#l-tek-iamats","title":"L-Tek / iamats","text":"
  • Website: https://www.iamats.com//

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.

"},{"location":"extras/asphyxia/","title":"How to setup Asphyxia CORE","text":"

If this isn't your first time setting up Asphyxia, make sure to backup your savedata folder and place it somewhere safe.

"},{"location":"extras/asphyxia/#what-is-asphyxia-core","title":"What is Asphyxia CORE?","text":"

Asphyxia CORE is a local e-amuse emulator which includes score saving and customization. The software itself does not support any game out of the box. For this, you need plugins.

"},{"location":"extras/asphyxia/#configuring-asphyxia","title":"Configuring Asphyxia","text":"

First, grab the latest release here. In almost all cases, you will use the asphyxia-core-win-x64.zip. Next, open the .zip file and extract the plugins folder and asphyxia-core-x64.exe into the contents folder of your desired game. We will use SDVX EG for this example.

Your contents folder should look like this then:

For Asphyxia to run properly, you will need a plugin for each game you want to use it with.

  • Join our Discord server.
  • Look for your game's channel, then the pinned Resources post.
  • Download the plugin archive and open it.
  • It should contain a folder such as sdvx@asphyxia or iidx@asphyxia.
  • Put that folder in your Asphyxia plugins folder, typically contents\\plugins\\ and overwrite files if needed.

Note: We do NOT provide plugins for every game.

Run asphyxia-core-x64.exe to start the server. It will automatically open a browser tab. This is your WebUI.

"},{"location":"extras/asphyxia/#changing-service-url","title":"Changing Service URL","text":"

Run spicecfg.exe, head over to the Options tab and look for EA Service URL. In there, you need to input what is displayed on the Asphyxia WebUI on the Dashboard at the right side.

For me, it's localhost:8083 and should look like this:

"},{"location":"extras/asphyxia/#setting-up-sdvx","title":"Setting up SDVX","text":"

On the WebUI, click on SDVX on the left-hand bar and on the right side under Plugin Settings, you should see an option named Exceed Gear Data Directory. In here, paste the path of your contents folder and press enter. In my case, it looks like this:

Next, click on Update Webui Assets on the left-hand bar. Make sure you're using the correct path as it won't work otherwise. When you've done that, click on Update and confirm that you've updated the datacode in your ea3-config.xml file. After a few seconds, the text console should say Done and say Successfully extracted textures if you input your path correctly.

Next, launch the game and card in. Go through the process of creating a profile, then close the game. After that, go to SDVX on the left-hand bar, then Profiles and click on the green Detail button on your preferred profile. Click on Setting on the top bar and try changing some customization settings at the bottom. If they are working, you're done and everything should function as intended if you set everything correctly.

If they appear broken, completely close Asphyxia and head to the contents folder of your game again. If you have inserted the correct path when Importing and everything worked without any errors, you will have a folder called webui. Copy this folder and paste it into plugins\\sdvx@asphyxia. Overwrite any files if prompted to. Now close then re-run asphyxia-core-x64.exe and everything should function as intended.

"},{"location":"extras/asphyxia/#setting-up-iidx","title":"Setting up IIDX","text":"

You have already done all the step required to have it working. Simply create a profile and it will be visible on the WebUI.

You're all done! Enjoy your game!

"},{"location":"extras/audio/","title":"What is WASAPI & ASIO?","text":"

WASAPI and ASIO are audio systems that manage how your applications like games, music, and others interact with your audio hardware. Without these core systems you would not be able to hear anything. This is a basic explanation on what they are and will not go into detail on how they function. There are 3 types that I'll cover here with pros and cons for each one.

I would personally recommend using WASAPI Shared as this has in most cases the highest chance of working and requires the least amount of work. You can enable it by using a patch.

If you would like to use WASAPI Exclusive, you can read more about it here.

"},{"location":"extras/audio/#wasapi-shared","title":"WASAPI Shared","text":"

WASAPI Shared mode is the standard mode that Windows uses. This allows you to hear multiple audio sources at once and allows programs to capture audio with programs like OBS and Discord. While this is nice for using windows and playing most games, this has a negative side effect of increasing audio latency.

Pros:

  • Multiple audio sources can be sent to one audio device.
  • Can capture audio using OBS or Discord.
  • Supports almost all audio hardware as this is the standard for Windows.
  • Easy to set up.

Cons:

  • Higher Latency.
  • Poor/Hard to configure for low latency.
  • USB audio devices are not supported (DAC).
"},{"location":"extras/audio/#wasapi-exclusive","title":"WASAPI Exclusive","text":"

WASAPI Exclusive mode is a secondary mode which allows one program to take complete control over an audio device. This allows an application to do anything to your audio device including changing settings like change volume, sample rates, and buffer size. With this in mind, this also bypasses a lot of latency that is introduced with multiple applications playing their own audio.

The main downside is that you can only hear one audio source (the program that has control). In this case for example, beatmaniaIIDX would take complete control and you would not be able to hear applications like Discord. You cannot capture audio while running this mode without special software.

Pros:

  • Low Latency (Real Time Latency)
  • Supports almost all audio hardware as this is the standard for Windows.

Cons:

  • Application controls the hardware.
  • Not easily configurable.
  • Can not capture audio with OBS or Discord (Can be done, but requires a lot of configuration and can introduce latency. Switching to WASAPI Shared mode is recommended for this use case).
  • USB audio devices are not supported (DAC).
"},{"location":"extras/audio/#asio","title":"ASIO","text":"

ASIO stands for Audio Stream Input/Output. This is an audio driver designed for Audio Interfaces on Windows that is very similar to WASAPI Exclusive.

The biggest difference between ASIO and WASAPI Exclusive is software/hardware support and age. In order to use ASIO, both your hardware and the application you are using must support ASIO. For example, Sound Voltex supports ASIO natively but it does take a bit to set up compared to WASAPI Exclusive. ASIO also has higher configurability.

Pros:

  • Low Latency (Real Time Latency)
  • Highly Configurable
  • Industry standard for musicians means tons of support documentation.

Cons:

  • Limited Hardware Support
  • Application controls hardware.
  • Can not capture audio with OBS or Discord (Can be done, but requires a lot of configuration and can introduce latency. Switching to WASAPI Shared mode is recommended for this use case).
  • Requires a powerful CPU.
"},{"location":"extras/datamods/","title":"Data Mods and Omnimix","text":"

This guide will cover how to mod your BEMANI game's data folder in a non-destructive way.No files will be removed or overwritten.

"},{"location":"extras/datamods/#pre-requisites","title":"Pre-requisites","text":"
  • A fully working and unmodified game.
  • The data to mod your game with.

ATTENTION

  • Please make sure the mod you're installing is compatible with YOUR specific game and game version.
  • If connecting to an online network, make sure they explicitly allow the mod you're about to install.
  • TWO-TORIAL will NOT provide support with issues caused by mods besides Omnimix for beatmania IIDX.
"},{"location":"extras/datamods/#preparing-data_mods","title":"Preparing data_mods","text":"

Let's place your mod files in the right folder.

  • Create a data_mods folder next to the others in your game files.

Depending on how your mod is packaged, you may or may not need to create another folder to contain it. Inside that folder, the structure should follow the one in data/.

  • Place your files inside that data_mods/mod_folder/.

If you're confused, the following may help you understand what this means.

\u251c\u2500 data/\n\u251c\u2500\u2500\u2500 graphic/\n\u251c\u2500\u2500\u2500 info/\n\u251c\u2500\u2500\u2500 movie/\n\u251c\u2500\u2500\u2500 sound/\n\u251c\u2500\u2500\u2500 etc...\n\u251c\u2500 data_mods/  \n\u251c\u2500\u2500\u2500 mod_folder/\n\u251c\u2500\u2500\u2500\u2500\u2500 graphic/ <- files that mod the /data/graphic/ folder go here\n\u251c\u2500\u2500\u2500\u2500\u2500 info/ <- files that mod the /data/info/ folder go here\n\u251c\u2500\u2500\u2500\u2500\u2500 movie/ <- files that mod the /data/movie/ folder go here\n\u251c\u2500\u2500\u2500\u2500\u2500 sound/ <- files that mod the /data/sound/ folder go here\n\u251c\u2500\u2500\u2500\u2500\u2500 etc...\n\u251c\u2500 dev/ \n\u251c\u2500 modules/  \n\u251c\u2500 prop/  \n

Example: Omnimix for beatmania IIDX 31 EPOLIS

Directory: contents/data_mods/

Directory: contents/data_mods/omnimix_31

"},{"location":"extras/datamods/#loading-data_mods","title":"Loading data_mods","text":""},{"location":"extras/datamods/#installing-ifs_layeredfs","title":"Installing ifs_layeredfs","text":"

We now need a way for our game to load our mods.

  • Download the most recent release of ifs_layeredfs.

  • Open the archive.

What we're interested in are the 64bit and 32bit folders:

  • Your game is 32bit (spice.exe to launch): go in the 32bit folder.
  • Your game is 64bit (spice64.exe to launch): go in the 64bit folder.

  • Copy the ifs_hook.dll file to your game's modules folder.

"},{"location":"extras/datamods/#loading-ifs_layeredfs","title":"Loading ifs_layeredfs","text":"

All that should be left to do is tell spice2x to load ifs_hook.dll.

  • Open your game's spicecfg.exe.
  • Head to the options tab.
  • Find the Inject DLL Hooks option under Common and type in ifs_hook.dll then press Enter.

Note: If you have other DLL hooks, simply add more by having a space in between them.. Example: ifs_hook.dll somehook.dll

Assuming your data_mods folder has been made properly, that's it!

Extra step for beatmania IIDX Omnimix

You also need to patch your game's DLL with the Omnimix patch.

For more information on how to patch your game, head over to the Spice2x Patching page!

"},{"location":"extras/hexguide/","title":"Manual DLL Hex Editing","text":"

Before proceeding

This guide should ONLY be used as a last resort if all other methods fail. It has a high chance of breaking your game, make backups.

"},{"location":"extras/hexguide/#preamble","title":"Preamble","text":"

We're going to patch Beatmania IIDX 25 CANNON BALLERS, however the process is similar for other BEMANI games.

Here's what you'll need:

  • Your favorite hex editor, here we'll be using HxD.
  • A clean copy of your desired BEMANI game.
  • A backup of your original .dll before editing.
"},{"location":"extras/hexguide/#getting-started","title":"Getting Started","text":"

Decide on what hex edits you want to apply, you may find that information from the community or our Resources.

It's time to open our hex editor. If you're using HxD, you'll be greeted with the screen below.

Open your game's .dll file in the hex editor.

For the grand majority of hex edits, this is the main game file, such as bm2dx.dll, soundvoltex.dll, etc..

Pictured below, we've opened up bm2dx.dll inside HxD.

Attention

The edit we'll be applying is EXCLUSIVE to this version of the game and serves as an example.

This means it will not work on any other version of the game, nor any other game! Hex edits modify specific memory addresses that only apply to very specific game versions.

We'll be editing our game to Unlock All Songs and its edit is:

  • Offset: 0xB60B2
  • Original: 74 10
  • Modified: 90 90

In HxD we're going to hit Ctrl+G to open the Goto window.

From here, we'll input the offset B60B2 in the Offset section as shown below, and hit OK.

Our cursor should be taken to the offset at the exact location you want to edit.

As you can see, the numbers in front of the cursor are 74 and 10 which corresponds to what we need to replace.

If there's a mismatch, it's likely the offset you've put in was wrong, so be sure to double check!

Now all we need to do is select 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 now look as shown below.

Lastly, simply save your file and repeat these steps for any other edits you want to apply!

If at any point your game has issues due to your edits, restore your backup.

"},{"location":"extras/parts/","title":"Arcade Part Documentation","text":"

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 provide alongside these variants.

7/26/2020 IMPORTANT Notice:

Rakuten has switched to separate services, namely Rakuten Ichiba and Rakuten Global Express, they have provided an FAQ here. 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.

"},{"location":"extras/parts/#iidx-buttons","title":"IIDX Buttons","text":""},{"location":"extras/parts/#sanwa","title":"Sanwa","text":"

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
      • Sanwa Rakuten (Official JP Store) - Lamp-less
      • Buyee (Rakuten Proxy) - Old Lamp Holder With Lamp
      • Buyee (Rakuten Proxy) - Old Lamp Holder Lamp-less
      • IST MALL (KR Seller)
  • OBSA-45UK-B (Black keys)
    • Where to buy:
      • Sanwa Rakuten (Official JP Store) - With Lamp
      • Sanwa Rakuten (Official JP Store) - Lamp-less
      • Buyee (Rakuten Proxy) - Old Lamp Holder With Lamp
      • Buyee (Rakuten Proxy) - Old Lamp Holder Lamp-less
      • IST MALL (KR Seller)

Square Menu/Option Buttons

  • OBSA-30UK
    • Where to buy:
      • Sanwa Rakuten (Official JP Store - With Lamp)
      • Sanwa Rakuten (Official JP Store - Lamp-less)
"},{"location":"extras/parts/#samduck","title":"Samduck","text":"

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)

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)

"},{"location":"extras/parts/#sdvx-buttons","title":"SDVX Buttons","text":""},{"location":"extras/parts/#sanwa_1","title":"Sanwa","text":"

Square BT Gameplay Buttons

  • Sanwa OBSA-60UK
    • Where to buy:
      • Sanwa Rakuten (Official JP Store)
      • Buyee (Rakuten Proxy) - Old Lamp Holder With Lamp
      • Buyee (Rakuten Proxy) - Old Lamp Holder Without Lamp

Rectangular FX Gameplay Buttons

  • OBSA-45UK-B (Black FX keys)
    • Where to buy:
      • Sanwa Rakuten (Official JP Store - With Lamp)
      • Sanwa Rakuten (Official JP Store - Lamp-less)
      • Buyee (Rakuten Proxy) - Old Lamp Holder With Lamp
      • Buyee (Rakuten Proxy) - Old Lamp Holder Lamp-less

Start Button

  • OBSA-30UK
    • Where to buy:
      • Sanwa Rakuten (Official JP Store - With Lamp)
      • Sanwa Rakuten (Official JP Store - Lamp-less)
"},{"location":"extras/parts/#samduck_1","title":"Samduck","text":"

Rectangular FX Gameplay Buttons

  • CWB 405
    • Where to buy:
      • IST MALL (KR Seller)

Start Button

  • CWB 406
    • Where to buy:
      • IST MALL (KR Seller)

"},{"location":"extras/parts/#sdvx-encoders","title":"SDVX Encoders","text":""},{"location":"extras/parts/#options","title":"Options","text":"

Copal Encoders

  • RES20D-50-201-1
    • Where to buy:
      • Octopart (Lists Multiple Sellers)
      • GAMO2 (Upgrade set from stock Chinese, CN seller)

YuanCon's Encoders

  • Where to buy:
    • Tabobao (CN Seller)

Sensatec Encoders (Arcade)

  • ELV-24Y36A-K (GAMO2 Arcade Encoders)
    • Where to buy:
      • Sensatec (JP Seller)
      • Metro Electric (JP Seller)
  • ELV-24M36A-K
    • Where to buy:
      • Sensatec (JP Seller)

"},{"location":"extras/parts/#popn-buttons","title":"Pop'n Buttons","text":""},{"location":"extras/parts/#sanwa_2","title":"Sanwa","text":"

Circular Dome Gameplay Buttons

  • OBSA-100UMQ
    • Comes with 200N springs and 200g Omron switches.
    • Where to buy:
      • Sanwa Rakuten (Official JP Store) - With Lamp
      • Sanwa Rakuten (Official JP Store) - Lamp-less
      • Buyee (Rakuten Proxy) - Old Lamp Holder With Lamp
      • Buyee (Rakuten Proxy) - Old Lamp Holder Lamp-less
"},{"location":"extras/parts/#samduck_2","title":"Samduck","text":"

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)

"},{"location":"extras/parts/#jubeat-rubbers","title":"Jubeat Rubbers","text":""},{"location":"extras/parts/#options_1","title":"Options","text":"

ZhouSensor

  • Where to buy:
    • ZhouSensor Taobao Store(CN)

"},{"location":"extras/parts/#microswitches","title":"Microswitches","text":""},{"location":"extras/parts/#omron","title":"Omron","text":"

25g Microswitches

- D2MV-01-1C2 (GAMO2 and YuanCon provided)\n    - Where to buy:\n        - [Digikey (US Seller)](https://www.digikey.com/product-detail/en/omron-electronics-inc-emc-div/D2MV-01-1C2/Z4707-ND/5236583)\n        - [Sanwa Rakuten (Official JP Store)](https://item.rakuten.co.jp/sanwadenshi/ilumb_222/)\n        - [IST MALL (KR Seller)](http://istmall.co.kr/us/goods/goods_view.php?goodsNo=1009992803)\n        - [Buyee (Rakuten Proxy)](https://buyee.jp/rakuten/detail/sanwadenshi%3A10000320)\n\n- VX-01-1C22\n    - Where to buy:\n        - [Digikey (US Seller)](https://www.digikey.com/product-detail/en/omron-electronics-inc-emc-div/VX-01-1C22/Z4644-ND/369961)\n        - [Mouser (US Seller)](https://www.mouser.com/ProductDetail/Omron-Electronics/VX-01-1C22?qs=1tDaWCEHQQ6vTHtQABSaag%3D%3D)\n

50g Microswitches

- D2MV-01-1C3 (GAMO2 provided)\n    - Where to buy:\n        - [Digikey (US Seller)](https://www.digikey.com/product-detail/en/omron-electronics-inc-emc-div/D2MV-01-1C3/Z4708-ND/5236584)\n        - [Sanwa Rakuten (Official JP Store)](https://item.rakuten.co.jp/sanwadenshi/ilumb_223/)\n        - [IST MALL (KR Seller)](http://istmall.co.kr/us/goods/goods_view.php?goodsNo=1009992804)\n        - [Buyee (Rakuten Proxy)](https://buyee.jp/rakuten/detail/sanwadenshi%3A10000321)\n- VX-01-1C23\n    - Where to buy:\n        - [Digikey (US Seller)](https://www.digikey.com/product-detail/en/omron-electronics-inc-emc-div/D2MV-01-1C3/Z4708-ND/5236584)\n        - [Mouser (US Seller)](https://www.mouser.com/ProductDetail/Omron-Electronics/D2MV-01-1C3?qs=HDDQUw%2F3Phqm1Y5wA%2Fdz9w%3D%3D)\n

100g Microswitches

- V-10-1A4 (Arcade default, GAMO2 provided)\n    - Where to buy:\n        - [Digikey (US Seller)](https://www.digikey.com/product-detail/en/omron-electronics-inc-emc-div/V-10-1A4/Z4588-ND/1828942)\n        - [IST MALL (KR Seller)](http://istmall.co.kr/us/goods/goods_view.php?goodsNo=1009992411)\n        - [Buyee (Rakuten Proxy)](https://buyee.jp/rakuten/detail/sanwadenshi%3A10000283)\n
"},{"location":"extras/parts/#gersung","title":"Gersung","text":"

60g Microswitches

  • GSM-V0303A06
    • Advertised as \"between 50g and 100g\".
    • Where to buy:
      • IST MALL (KR Seller)

"},{"location":"extras/parts/#springs","title":"Springs","text":""},{"location":"extras/parts/#options_2","title":"Options","text":"

20g Springs

  • OBSA-SP-20
    • Where to buy:
      • Sanwa Rakuten (Official JP Store)
      • IST MALL (KR Seller)
      • Buyee (Rakuten Proxy)
  • IST Spring
    • Where to buy:
      • IST MALL (KR Seller)

40g Springs

  • OBSA-SP-40
    • Where to buy:
      • Sanwa Rakuten (Official JP Store)
      • IST MALL (KR Seller)
      • Buyee (Rakuten Proxy)

50g Springs

  • OBSA-SP-50
    • Where to buy:
      • Sanwa Rakuten (Official JP Store)
      • Buyee (Rakuten Proxy)

60g Springs

  • OBSA-SP-60-K
    • Where to buy:
      • Sanwa Rakuten (Official JP Store)
      • IST MALL (KR Seller)
      • Buyee (Rakuten Proxy)
  • IST Spring
    • Where to buy:
      • IST MALL (KR Seller)

100g Springs

  • OBSA-SP-100

    • Where to buy:
      • Sanwa Rakuten (Official JP Store)
      • IST MALL (KR Seller)

  • IST Spring

    • Where to buy:
      • IST MALL (KR Seller)
"},{"location":"extras/parts/#led-lamps","title":"LED Lamps","text":""},{"location":"extras/parts/#options_3","title":"Options","text":"

ISTMall lamps

- Where to buy:\n    - [IST MALL (KR Seller)](https://istmall.co.kr/us/goods/goods_view.php?goodsNo=1009992273)\n
"},{"location":"extras/patchsp2x/","title":"Spice2x DLL Patching","text":"

TWO-TORIAL Patcher

URL: https://sp2x.two-torial.xyz GitHub Repo Supported Games Contributing

Known spice2x patchers

Compatibility

This patching method only is for spice2x supported games.

Please make sure you're using the latest release for spice2x as the feature is fairly new.

Before proceeding

It is highly recommended to use an unpatched DLL as your base!

If you've already patched your game through other methods (web patching or hex editing), Please replace your game's DLL with the original.

"},{"location":"extras/patchsp2x/#getting-started","title":"Getting Started","text":"

The following guide works the same regardless of which spice2x compatible game you're using.

In this case we will be using a clean SDVX installation as a reference, with the following folder structure.

"},{"location":"extras/patchsp2x/#importing-patches-from-url","title":"Importing Patches from URL","text":"

Open spicecfg.exe and head to the Patches tab.

By default no patches will be available, we need to import some.

  • Click on Import from URL.
  • Paste your preferred patcher's URL.

Note: Check the Resources page for a list of recommended patchers.

  • Click on Import.

If patching fails, it most likely is because the URL you provided doesn't support your game's version.

"},{"location":"extras/patchsp2x/#picking-patches","title":"Picking Patches","text":"

Important

As a general rule of thumb, if you're not sure what a patch does or you're not absolutely certain you need it, leave it alone.

After a successful import, your patches should now show up inside spice2x.

A new Patches folder has also been created, containing a .json file with your available patches for offline use.

Now you may pick and choose desired patches!

For game-specific instructions, refer to their respective dedicated pages.

"},{"location":"extras/patchsp2x/#auto-apply-overwrite-game-files","title":"Auto apply / Overwrite game files","text":"

Auto apply (recommended)

After picking your patches, it is strongly recommended to tick the Auto apply patches on game start box.

Doing so will keep your game files intact until you start it, at which point your selected patches will apply. Upon closing the game your game's files will be restored.

Overwrite game files

You also have the option to Overwrite game files, which will permanently modify your game files.

This is NOT recommended unless you have a good reason to do so. A backup of your original dll will be created, however it is recommended to make your own!

"},{"location":"extras/patchweb/","title":"Website DLL Patching","text":"

Known web patchers: Resources

For BEMANI games consider Spice2x Patching

This patching method is outdated for BEMANI games.

However spice2x patching is still very new and might not support your game yet, in this case follow this guide.

Before proceeding

It is highly recommended to use an unpatched DLL as your base!

If you've already patched your game through other methods (spice2x patching or hex editing), Please replace your game's DLL with the original.

"},{"location":"extras/patchweb/#getting-started","title":"Getting started","text":"

We'll be using mon's BemaniPatcher. Almost every other patcher is based off of this and functions exactly the same.

If your game is recent, please check Resources and use another web patcher.

Go to your chosen patcher's website, you'll get something similar to this:

Click on any game you'd like the patches for. In this case, we'll use Beatmania IIDX 30 Resident.

Here, either:

  • Drag and drop the .dll file the site prompts you to use.
  • OR click on Choose a file and select it that way.

If you've used the correct file and the site is compatible, it will tell you.

X of X patches matched (100%) means the patcher is compatible with your game. If this shows any less than 100%, DO NOT use it. Your .dll file might not be clean. Only proceed with a clean one.

Please keep in mind that some patchers may not support the most recent versions of your game right away.

Now, you can select the patches you'd like to apply.

If you're unsure on what to do, refer to your specific game's guide as it might have more information there. Otherwise feel free to join our Discord server, the link is at the top of the home page, and ask the community!

When you're done selecting patches, click on Save Patched File and your new .dll file will start downloading.

Backup your original .dll file first!

Now you may replace your data's .dll file with the patched one you just downloaded.

Once you've done that, you're done. Enjoy!

"},{"location":"extras/pollingrates/","title":"List of Touchscreen Monitors and their Polling Rates","text":"

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 and move your finger across the window at a reasonable pace, but not too fast!

"},{"location":"extras/pollingrates/#dell-s2240t","title":"Dell S2240T","text":"
  • 2013 Manufacturing Date:
    • 200hz GREAT!
  • 2014 Manufacturing Date:
    • May: 200hz GREAT!
    • September: 180hz
  • 2015 Manufacturing Date:
    • March: 200hz GREAT!
    • September: 200hz GREAT!
  • Late 2016 Manufacturing Date:
    • 140hz AVOID
  • Early 2017 Manufacturing Date:
    • 180hz
  • Mid 2017 Manufacturing Date:
    • 140hz AVOID
  • February 2018 Manufacturing Date:
    • 180hz
"},{"location":"extras/pollingrates/#dell-p2314t","title":"Dell P2314T","text":"
  • November 2015 Manufacturing Date:
    • 60hz DO NOT BUY!
"},{"location":"extras/pollingrates/#dell-p2418ht","title":"Dell P2418HT","text":"
  • May 2018 Manufacturing Date:
    • 60hz DO NOT BUY!
"},{"location":"extras/pollingrates/#iiyama-t2336msc","title":"Iiyama T2336MSC","text":"
  • Revision B1:
    • 180hz
"},{"location":"extras/softether/","title":"Setting Up SoftEther VPN for Cabinet-to-Cabinet Play","text":""},{"location":"extras/softether/#what-is-softether-vpn","title":"What is SoftEther VPN?","text":"

SoftEther VPN is a free tool we use to create Virtual Hubs and connect multiple machines to the same virtual network, allowing the ability to perform Cabinet-to-Cabinet link even when the machines are on physically different networks.

"},{"location":"extras/softether/#configuring-softether-server","title":"Configuring SoftEther Server","text":"

This part of the guide is for hosting a hub! If you only wish to connect to a hub, refer to Connecting to a SoftEther Hub.

While this guide is mainly focused on setting up link-play for arcade games, theoretically this should also work with other PC games that supports link-playing over LAN.

"},{"location":"extras/softether/#setting-up-the-server-and-creating-a-hub","title":"Setting up the Server, and Creating a Hub","text":"

First, go to the SoftEther VPN Download Center. In the Select Component section, choose SoftEther VPN Server. Choose the Operating System and CPU based on your own machine, and grab the latest rtm build. This guide will be using Windows as an example, the layout for other OS might vary.

Run the installer and choose to install SoftEther VPN Server. Press Next to finish the installation, and start the Server Manager.

When running the Server Manager for the first time, you should be greeted with the window below. Click on the Connect button.

If prompted to setup a root password, set a password that you will remember. If prompted with the Easy Setup wizard, click Close on the bottom right of the window.

Click on Create a Virtual Hub on the window below.

Give your hub a name, and set an admin password. In this example, we will use Two-Torial.

If you wish to limit the maximum amount of sessions that can be connected to your hub at a time, you can enable Limit Max VPN Sessions. Most arcade games support up to 4-way link, so we will set the limit to 4 in this example.

Your hub is now created! You should see the hub show up on your Virtual Hub list. Click on the hub to highlight it, and click Manage Virtual Hub.

"},{"location":"extras/softether/#adding-users-to-your-virtual-hub","title":"Adding Users to your Virtual Hub","text":"

You will need to add User Accounts into the Virtual Hub before anyone can connect. Click on Manage Users, then click New at the bottom left of the window.

Set a Username and Password for the user account, then check the Set Security Policy box on the top right, and click Security Policy.

Scroll down and find Unlimited Number of Broadcasts and Filter all IPv6 Packets, then enable the 2 options. Leave everything else as defaults and click OK.

Click on OK, and your user account should be created. Click on Exit to go back to the Hub Management page.

You can either create one user account and give everyone the same credentials to connect to your hub under the same user, or you can also create individual user accounts for all the players that wish to connect to your hub. I recommend creating an user account for each player so you can have an easier time to manage the hub if needed.

"},{"location":"extras/softether/#configuring-securenat","title":"Configuring SecureNAT","text":"

We will use the SecureNAT option to assign a custom subnet to each connected machines. Some games like Chunithm requires you to be on a specific subnet or cab-to-cab link will not work. Click on Virtual NAT and Virtual DHCP Server (SecureNAT), then enable SecureNAT, and click on SecureNAT Configuration.

  • In the SecureNAT Configration window, set the IP Address under Virtual Host Network Interface Settings to the subnet you wish to use. In this exmaple, we will be using 192.168.139.x as this is the subnet required by Chunithm for cab-to-cab play.
  • Under Virtual DHCP Server Settings, set the IP Address range you wish to distribute to the connected machines. We will use a suffix of 11 to 14 in this example.
  • IMPORTANT: LEAVE THE Options Applied to Clients SECTION BLANK!!! Once everything is set, click on OK and Exit.

"},{"location":"extras/softether/#setting-a-dynamic-dns-for-your-softether-server","title":"Setting a Dynamic DNS for your SoftEther Server","text":"

You can set a custom DDNS Hostname for your SoftEther Server to allow people to remember your Server Hostname more easily. You can also just leave the hostname as default if you wish.

Click Dynamic DNS Setting on the bottom left.

  • Under Change the Dynamic DNS Hostname section, set your preferred hostname. In this example, we will use twotorial.
  • Click Set to Above Hostname when done, and click Exit.

If a prompt shows up and ask if you want to regenerate a new Server Certificate, click on No.

If done correctly, the bottom left of your Virtual Hub management window should show your updated Hostname.

The server setup is done! User(s) should be able to connect to your hub now.

"},{"location":"extras/softether/#connecting-to-a-softether-hub","title":"Connecting to a SoftEther Hub","text":""},{"location":"extras/softether/#setting-up-the-vpn-client","title":"Setting up the VPN Client","text":"

If you already have a hub created / you have a hub ready to connect, keep reading.

Go to the SoftEther VPN Download Center. In the Select Component section, choose SoftEther VPN Client. Choose the Operating System and CPU based on your own machine, and grab the latest rtm build. This guide will be using Windows as an example, the layout for other OS might vary.

Run the installer and choose to install SoftEther VPN Client. Press Next to finish the installation, and start the VPN Client.

In the VPN Client window, click on Add VPN Connection.

If a prompt shows up saying that you need to create a Virtual Network Adapter first, click Yes.

Leave the adapter name as default, and press OK. Wait for the creation process to finish.

"},{"location":"extras/softether/#connecting-to-a-virtual-hub","title":"Connecting to a Virtual Hub","text":"

After you have created a Virtual Network Adapter, you should be able to add a VPN Hub. Click on Add VPN Connection again.

  • Name the Hub whatever you prefer. In this example, we will use Twotorial.
  • In the Destination VPN Server section, input the server Hostname and port. The hostname should usually be [your_hostname].softether.net
  • If the Hostname is correct and the client is able to establish a connection, the Virtual Hub Name should auto-fill when you click on the dropdown box.

If the Virtual Hub Name shows a blank list even after clicking the dropdown box multiple times, it usually means your client is unable to establish a connection. Double check if the hostname, and your hub config is correct.

  • Under User Authentication Setting, input your username and password.
  • If you are connecting to another person's hub, ask the person for your login credentials.

  • Under Advanced Setting of Communication, UNCHECK THE RECONNECTS AUTOMATICALLY AFTER DISCONNECTED BOX. If this option is enabled, your VPN Client will always try to reconnect to the hub when it is running, taking up a spot in the hub. Please do not do this, it's just annoying when you're AFK in someone's hub and hogging up a spot.
  • Click Advanced Settings....

  • In the Advanced Settings window, you can set the Number of TCP Connections you wish to use. The higher you set, the more connections will be used, resulting in a potentially better link-play experience especially for real-time PVP games like Wangan Midnight Maximum Tune or Initial D: The Arcade.

If you set this to a very high value and your connection speed is unable to keep up with the requests, your connection quality may be negatively impacted. I recommend setting this to 8 for a good balance.

  • If you find yourself desyncing a lot when in game, you can also enable Use Data Compression to improve the connection stability.
  • Click on OK once everything is set.

Double click on the VPN hub to connect. If it shows you your assigned IP address, congratulations! You are now connected to the Virtual Hub and is ready for some cab-to-cab action!

"},{"location":"extras/softether/#tips","title":"Tips","text":"
  • If you need to fetch your assigned IP address because the notification window disappeared too fast or if you forgot your IP, you can do so with the ipconfig command in CMD.
  • The Virtual Adapter name will usually be Unknown adapter VPN - VPN Client.
  • If you already have your hub setup and want to share the config with other users, you can Export your VPN profile and send it to them. Right click on the VPN Hub you wish to share and click Export VPN Connection Setting....
  • If you wish to include your username and password in the exported config, click on No. If the hub you are connecting to have different accounts setup for individual users, click on Yes to remove all sensitive information from the config.
"},{"location":"extras/streamaudio/","title":"Workarounds for exclusive audio","text":"

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!

"},{"location":"extras/streamaudio/#setting-up-audio","title":"Setting up audio","text":"

There are advantages and disadvantages to each of the methods, so read carefully.

"},{"location":"extras/streamaudio/#option-1-force-shared-audio","title":"Option 1 - force shared audio","text":"
  • 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.

Sound Voltex

  • Enable Shared mode WASAPI patch.
  • If you run into any issues, change the audio playback device to output at 44.1khz and 16 bit.

IIDX

  • For TDJ mode, ensure that the sound output device is set to WASAPI.
    • In SpiceTools, set -iidxsounddevice to wasapi.
  • Enable Force shared audio patch.
  • 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.
"},{"location":"extras/streamaudio/#option-2-stereo-mix","title":"Option 2 - Stereo Mix","text":"
  • 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.

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.
  2. 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).
  3. Go to Recording devices tab.
  4. Look for Stereo Mix. If you don't see it, right click and check \"Show Disabled Devices\" and try again.

Capturing audio in OBS with Stereo Mix

  1. Add a new Audio Input Capture source.
  2. Set the device as Stereo Mix.
  3. You can now capture audio.
  4. You'll probably want to set to \"Monitor Off\" so you don't get duplicated audio.
"},{"location":"extras/streamaudio/#option-3-audio-splitter-cable-lo-tech-method","title":"Option 3 - audio splitter cable (lo-tech method)","text":"
  • 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

Equipment

  1. Buy an audio splitter cable, and a headphone extension cable.
  2. 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.

Capturing audio in OBS

  • Add \"Line In\" as an audio input source.
"},{"location":"extras/streamaudio/#option-4-flexasio","title":"Option 4 - FlexASIO","text":"
  • 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.

FlexASIO set up

  1. Install FlexASIO
  2. Create a FlexASIO.toml configuration file in your user folder (C:\\Users\\Your Name)

  3. Insert these lines inside your configuration file:

    backend = \"Windows WASAPI\"\nbufferSizeSamples = 386\nchannels = 2\nwasapiExclusiveMode = false\n\n[output]\nsuggestedLatencySeconds = 0.0\n

Try to lower bufferSizeSamples for minimal latency - recommended value is 128. If you hear audio crackling, increase bufferSizeSamples.

Sound Voltex

  • Disable Shared mode WASAPI patch. You want the game to output in exclusive mode for lower overall latency.

IIDX

  • For TDJ mode, ensure that the sound output device is set to WASAPI.
    • In SpiceTools, set -iidxsounddevice to wasapi.
  • Disable Force shared audio patch. You want the game to output in exclusive mode for lower overall latency.

SpiceTools set up to use ASIO

  1. Under the options tab, make sure that IIDX Sound Output Device is set to default.
  2. Directly below it is an option called IIDX ASIO Driver. Type FlexASIO into it.

Taiko no Tatsujin Nijiiro

  1. Disable wasapi_shared in config.toml.
  2. Enable asio in config.toml.
  3. Set asio_driver to FlexASIO.
  • To capture audio, you can capture desktop audio as you normally would in OBS.
"},{"location":"extras/streamaudio/#option-5-voicemeeter","title":"Option 5 - Voicemeeter","text":"
  • 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.

Initial Voicemeeter set up

  1. Download Voicemeeter Potato.
    • 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.
  2. Install and REBOOT YOUR COMPUTER when prompted.
  3. Launch Voicemeeter Banana or Potato, whichever one you prefer.
  4. 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.
  5. In Windows sound settings, set your default audio playback device to Voicemeeter Input (and not Voicemeeter AUX Input!)

Discord or other voice applications

  • Configure the output device to Voicemeeter AUX Input.

Sound Voltex

  • Disable Shared mode WASAPI patch. You want the game to output in exclusive mode for lower overall latency.

IIDX

  • Disable Force shared audio patch. 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!

Muxing with Voicemeeter

  1. Launch the game.
  2. 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.
  3. (Similarly, audio from the voice chat would come through Voicemeeter AUX column.)
  4. At this point, you are able to hear both the game & listen to voice chat - success!

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.
  2. 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.
  3. In OBS, create a new Audio Input Capture source.
  4. Double click on the new source and select VoiceMeeter Output (VB-Audio VoiceMeeter VAIO) from the drop-down.
  5. 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.)
  6. You are done. You should see the game audio come through to OBS.
"},{"location":"extras/streamaudio/#streaming-to-discord","title":"Streaming to Discord","text":"

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:

"},{"location":"extras/streamaudio/#setting-up-virtual-audio-monitor-in-obs","title":"Setting up Virtual Audio Monitor in OBS","text":"

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.

Option 1 - Using Virtual Audio Cable

  1. Download and install Virtual Audio Cable.
  2. Go to OBS Settings, Audio, Advanced, Monitoring Device - set to CABLE Input.
  3. Go to Edit, Advanced Audio Properties. For any audio channels you want to stream, turn on monitor to \"Monitor and Output\".

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.
  2. Go to OBS Settings, Audio, Advanced, Monitoring Device - set to VoiceMeeter VAIO3 Input.
  3. Go to Edit, Advanced Audio Properties. For any audio channels you want to stream, turn on monitor to \"Monitor and Output\".
  4. 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.
"},{"location":"extras/streamaudio/#streaming-obs-windowed-preview-to-discord","title":"Streaming OBS Windowed Preview to Discord","text":"
  1. Add the game window capture as a scene, as you normally would in OBS.
  2. Right click on OBS stage and click on Windows Projector (Preview).
  3. Resize the new window as needed.
  4. Use Discord to screen share this Windowed Projector.
  5. You're done! The screen share should include both the OBS scene and the audio.
"},{"location":"extras/streamaudio/#troubleshooting","title":"Troubleshooting","text":"

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.

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.

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.
"},{"location":"extras/unity/","title":"Modding Unity-based games","text":"

Before proceeding

This guide applies to games made in the Unity engine, such as maimai DX, O.N.G.E.K.I. and Card Maker.

It is highly recommended to use an unpatched Assembly DLL as your base!

Patches have historically been hardcoded into the unprotected Assembly-CSharp.dll

The modern approach is to use BepInEx to load custom patches without tampering with Assembly-CSharp.BepInEx can be used to load all mods, including those made for MelonLoader and MonoMod

"},{"location":"extras/unity/#installing-bepinex","title":"Installing BepInEx","text":"
  • Download the BepInEx 5 stable release (BepInEx_win_x64_5.x.y.z.zip).

Some maimai DX mods are only compatible with BepInEx 5.4.22

  • Extract the BepInEx folder to the App\\package folder (ignore other files such as .doorstop_version)

  • Modify segatools.ini with the following:

[unity]\nenable=1\ntargetAssembly=BepInEx\\core\\BepInEx.Preloader.dll\n
"},{"location":"extras/unity/#installing-mods","title":"Installing mods","text":"

BepInEx plugins

Place them in BepInEx\\plugins.

Melonloader mods and plugins

  • Download MLLoader-UnityMono-BepInEx5 of the latest BepInEx.MelonLoader.Loader.
  • Extract it into App\\package.
  • Place mods in MLLoader\\Mods.

MonoMod patches

These patches always follow the naming pattern: Assembly-CSharp.Name.mm.dll.

  • Extract BepInEx.MonoMod.Loader into App\\package.
  • Place patches in BepInEx\\monomod.
"},{"location":"extras/unity/#available-mods","title":"Available mods","text":"
  • mu3-mods open source BepInEx mods for O.N.G.E.K.I., includes many fixes and QOL changes that can be added selectively.
  • AquaMai open source MelonLoader mod for maimai, includes fixes, QOL, and cheats that can be configured from a toml or gui.
  • worldlinkd open source MelonLoader mod for maimai, which adds cross-network online c2c similar to online matching in CHUNITHM.

AquaMai & worldlinkd

These mods may not work with the MelonLoader compatiblity layer for BepInEx, and as such it's recommended to follow their respective guides.

"},{"location":"games/bemani/beatstream/animutribe/setup/","title":"BeatStream \u30a2\u30cb\u30e0\u30c8\u30e9\u30a4\u30f4","text":"

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.

"},{"location":"games/bemani/beatstream/animutribe/setup/#getting-started","title":"Getting Started","text":"

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.

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.

"},{"location":"games/bemani/beatstream/animutribe/setup/#configuring-your-tools","title":"Configuring Your Tools","text":"

Now that you have your files ready, open up your .bat file in your desired text editor (we're using Notepad++) 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.

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.

"},{"location":"games/bemani/beatstream/animutribe/setup/#configuring-for-a-local-network","title":"Configuring for a Local Network","text":"

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!
"},{"location":"games/bemani/beatstream/animutribe/setup/#configuring-for-an-online-network","title":"Configuring for an Online Network","text":"

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!
"},{"location":"games/bemani/beatstream/animutribe/setup/#final-steps-and-setting-up-the-game","title":"Final Steps and Setting up the Game","text":"

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.

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 Troubleshooting section at the link below.

Have any other errors?

Check out the Troubleshooting section and Error Code section to resolve any issues not seen in this guide to greater depth.

"},{"location":"games/bemani/beatstream/animutribe/troubleshooting/","title":"BeatStream \u30a2\u30cb\u30e0\u30c8\u30e9\u30a4\u30f4","text":""},{"location":"games/bemani/beatstream/animutribe/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

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

"},{"location":"games/bemani/beatstream/animutribe/troubleshooting/#my-game-doesnt-boot-after-following-the-guide","title":"My Game Doesn't Boot After Following the Guide!","text":"

The most common problem present here is if you do not have an E:/ drive. To resolve this issue, you must modify your game with the E:/drive fix patch.

"},{"location":"games/bemani/beatstream/animutribe/troubleshooting/#my-touchscreen-monitor-isnt-working","title":"My Touchscreen Monitor Isn't Working","text":"

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!

"},{"location":"games/bemani/beatstream/animutribe/troubleshooting/#my-game-is-running-slowlagging","title":"My Game Is Running Slow/Lagging","text":"

Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.

"},{"location":"games/bemani/beatstream/animutribe/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

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.

"},{"location":"games/bemani/beatstream/animutribe/troubleshooting/#which-offset-is-which","title":"Which Offset Is Which?","text":"

If you're getting too many fasts, increase your offset (+). If you're getting too many slows, decrease your offset (-).

"},{"location":"games/bemani/ddr/a20/setup/","title":"Game Setup (DDR A2O)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/ddr/a20/setup/#about-data","title":"About data","text":"

The full game should be around 20-25gb in size.

Please keep the following in mind as you're going through this guide.

DDR's codename is MDX. Starting with DDR A20 this would be either:

  • MDX-001 (Other cabs, 32 bits)
  • MDX-003 (Gold cab, 64 bits)

The gold cab version contains more features, such as exclusive songs or the \"GOLDEN LEAGUE\" mode.

"},{"location":"games/bemani/ddr/a20/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure with a few folders only, as follows.

If your data doesn't look like this

If you're missing the modules folder and instead have bunch of .dll files next to your folders:

  • Create a modules folder.
  • Move all .dll files inside of it so you end up with a structure as shown above.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/bemani/ddr/a20/setup/#updating-data","title":"Updating data","text":"Please make sure you're using the right update for your current data.

DDR Patches re-uploaded by the community tend to be appropriately named MDX-DATECODE-to-DATECODE.

For example MDX-2024091000-to-2024101500.

  • 2024091000 being your current data's version.
  • 2024101500 being the one you would arrive at.
  • Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.
  • Open prop\\ea3-config.xml in a text editor and find the following lines near the top.
    <soft>\n        <model __type=\"str\">MDX</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">A</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024101500</ext>\n    </soft>\n

On the line with <ext __type=\"str\"> the datecode needs to match your new version.

  • If that's already the case then great! Don't touch anything.
  • If it instead corresponds to your pre-patch datecode, replace it with the new one and save the file.
"},{"location":"games/bemani/ddr/a20/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

For MDX-001 (32 bits)
  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice.exe and spicecfg.exe files from the archive to your game's directory.

For MDX-003 (64 bits)
  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice64.exe and spicecfg.exe files from the archive to your game's directory.

"},{"location":"games/bemani/ddr/a20/setup/#configuring-spice2x","title":"Configuring Spice2x","text":"

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/ddr/a20/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • P1 Panel buttons: Up, Down, Left, Right
  • P1 Menu buttons: Start, Up, Down, Left, Right
  • P1 Keypad: 1 to 9, Keypad Insert Card
"},{"location":"games/bemani/ddr/a20/setup/#overlay","title":"Overlay","text":"

Modifying buttons in this section is not required but you are free to change what you want.

Click on Bind then press the key you want associated with the action.

"},{"location":"games/bemani/ddr/a20/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through spice2x.

If it does, here's how you may link different actions to your lights:

  • Click Bind.
  • In Device, pick your controller.
  • In Light Control, select the corresponding light.
  • Click Close.
  • Repeat for your other lights.
"},{"location":"games/bemani/ddr/a20/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section.

"},{"location":"games/bemani/ddr/a20/setup/#patches","title":"Patches","text":"

Go through the Spice2x Patching page to import patches.

To prevent issues, avoid patching things you don't need or understand.

"},{"location":"games/bemani/ddr/a20/setup/#api","title":"API","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/ddr/a20/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the question mark at the very left.

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Network EA Service URL -url Covered in Connecting to a network

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/ddr/a20/setup/#advanced-development","title":"Advanced & Development","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/ddr/a20/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/ddr/a20/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/bemani/ddr/a20/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/bemani/ddr/a20/setup/#k-lite-codec-pack","title":"K-lite Codec Pack","text":"
  • Download and install the K-lite Codec Pack (the Standard version is enough)
"},{"location":"games/bemani/ddr/a20/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/bemani/ddr/a20/troubleshooting/","title":"Troubleshooting (DDR A20)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/ddr/a20/troubleshooting/#clock-error","title":"Clock error","text":"

In the test menu, navigate to CLOCK, and set it to match your computer's time.

"},{"location":"games/bemani/ddr/a20/troubleshooting/#my-game-is-running-slowlagging","title":"My game is running slow/lagging","text":"

Try to eliminate any unnecessary background processes during play.

"},{"location":"games/bemani/ddr/a20/troubleshooting/#unable-to-login-eamuse-error-network-error","title":"Unable to login / Eamuse error / Network error","text":"

Get the proper Asphyxia plugin from our Discord server in the #ddr channel > Resources post. Make sure you didn't enable -smartea in spicecfg's options.

"},{"location":"games/bemani/ddr/a20/troubleshooting/#where-are-the-option-for-dancersshadingmeasure-linesfast-slowlayering","title":"Where are the option for Dancers/Shading/Measure lines/Fast-Slow/Layering?","text":"

These options are locked behind network requirements and will not be displayed unless you are connected to a network that has written support for these options. Patches are available to mitigate this (see Patches).

"},{"location":"games/bemani/ddr/a20plus/setup/","title":"Game Setup (DDR A2O PLUS)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/ddr/a20plus/setup/#about-data","title":"About data","text":"

The full game should be around 20-25gb in size.

Please keep the following in mind as you're going through this guide.

DDR's codename is MDX. Starting with DDR A20 this would be either:

  • MDX-001 (Other cabs, 32 bits)
  • MDX-003 (Gold cab, 64 bits)

The gold cab version contains more features, such as exclusive songs or the \"GOLDEN LEAGUE\" mode.

"},{"location":"games/bemani/ddr/a20plus/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure with a few folders only, as follows.

If your data doesn't look like this

If you're missing the modules folder and instead have bunch of .dll files next to your folders:

  • Create a modules folder.
  • Move all .dll files inside of it so you end up with a structure as shown above.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/bemani/ddr/a20plus/setup/#updating-data","title":"Updating data","text":"Please make sure you're using the right update for your current data.

DDR Patches re-uploaded by the community tend to be appropriately named MDX-DATECODE-to-DATECODE.

For example MDX-2024091000-to-2024101500.

  • 2024091000 being your current data's version.
  • 2024101500 being the one you would arrive at.
  • Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.
  • Open prop\\ea3-config.xml in a text editor and find the following lines near the top.
    <soft>\n        <model __type=\"str\">MDX</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">A</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024101500</ext>\n    </soft>\n

On the line with <ext __type=\"str\"> the datecode needs to match your new version.

  • If that's already the case then great! Don't touch anything.
  • If it instead corresponds to your pre-patch datecode, replace it with the new one and save the file.
"},{"location":"games/bemani/ddr/a20plus/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

For MDX-001 (32 bits)
  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice.exe and spicecfg.exe files from the archive to your game's directory.

For MDX-003 (64 bits)
  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice64.exe and spicecfg.exe files from the archive to your game's directory.

"},{"location":"games/bemani/ddr/a20plus/setup/#configuring-spice2x","title":"Configuring Spice2x","text":"

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/ddr/a20plus/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • P1 Panel buttons: Up, Down, Left, Right
  • P1 Menu buttons: Start, Up, Down, Left, Right
  • P1 Keypad: 1 to 9, Keypad Insert Card
"},{"location":"games/bemani/ddr/a20plus/setup/#overlay","title":"Overlay","text":"

Modifying buttons in this section is not required but you are free to change what you want.

Click on Bind then press the key you want associated with the action.

"},{"location":"games/bemani/ddr/a20plus/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through spice2x.

If it does, here's how you may link different actions to your lights:

  • Click Bind.
  • In Device, pick your controller.
  • In Light Control, select the corresponding light.
  • Click Close.
  • Repeat for your other lights.
"},{"location":"games/bemani/ddr/a20plus/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section.

"},{"location":"games/bemani/ddr/a20plus/setup/#patches","title":"Patches","text":"

Go through the Spice2x Patching page to import patches.

To prevent issues, avoid patching things you don't need or understand.

"},{"location":"games/bemani/ddr/a20plus/setup/#api","title":"API","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/ddr/a20plus/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the question mark at the very left.

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Network EA Service URL -url Covered in Connecting to a network

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/ddr/a20plus/setup/#advanced-development","title":"Advanced & Development","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/ddr/a20plus/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/ddr/a20plus/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/bemani/ddr/a20plus/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/bemani/ddr/a20plus/setup/#k-lite-codec-pack","title":"K-lite Codec Pack","text":"
  • Download and install the K-lite Codec Pack (the Standard version is enough)
"},{"location":"games/bemani/ddr/a20plus/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/bemani/ddr/a20plus/troubleshooting/","title":"Troubleshooting (DDR A20 PLUS)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/ddr/a20plus/troubleshooting/#clock-error","title":"Clock error","text":"

In the test menu, navigate to CLOCK, and set it to match your computer's time.

"},{"location":"games/bemani/ddr/a20plus/troubleshooting/#my-game-is-running-slowlagging","title":"My game is running slow/lagging","text":"

Try to eliminate any unnecessary background processes during play.

"},{"location":"games/bemani/ddr/a20plus/troubleshooting/#unable-to-login-eamuse-error-network-error","title":"Unable to login / Eamuse error / Network error","text":"

Get the proper Asphyxia plugin from our Discord server in the #ddr channel > Resources post. Make sure you didn't enable -smartea in spicecfg's options.

"},{"location":"games/bemani/ddr/a20plus/troubleshooting/#where-are-the-option-for-dancersshadingmeasure-linesfast-slowlayering","title":"Where are the option for Dancers/Shading/Measure lines/Fast-Slow/Layering?","text":"

These options are locked behind network requirements and will not be displayed unless you are connected to a network that has written support for these options. Patches are available to mitigate this (see Patches).

"},{"location":"games/bemani/ddr/a3/setup/","title":"Game Setup (DDR A3)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/ddr/a3/setup/#about-data","title":"About data","text":"

The full game should be around 20-25gb in size.

Please keep the following in mind as you're going through this guide.

DDR's codename is MDX. Starting with DDR A20 this would be either:

  • MDX-001 (Other cabs, 32 bits)
  • MDX-003 (Gold cab, 64 bits)

The gold cab version contains more features, such as exclusive songs or the \"GOLDEN LEAGUE\" mode.

"},{"location":"games/bemani/ddr/a3/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure with a few folders only, as follows.

If your data doesn't look like this

If you're missing the modules folder and instead have bunch of .dll files next to your folders:

  • Create a modules folder.
  • Move all .dll files inside of it so you end up with a structure as shown above.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/bemani/ddr/a3/setup/#updating-data","title":"Updating data","text":"Please make sure you're using the right update for your current data.

DDR Patches re-uploaded by the community tend to be appropriately named MDX-DATECODE-to-DATECODE.

For example MDX-2024091000-to-2024101500.

  • 2024091000 being your current data's version.
  • 2024101500 being the one you would arrive at.
  • Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.
  • Open prop\\ea3-config.xml in a text editor and find the following lines near the top.
    <soft>\n        <model __type=\"str\">MDX</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">A</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024101500</ext>\n    </soft>\n

On the line with <ext __type=\"str\"> the datecode needs to match your new version.

  • If that's already the case then great! Don't touch anything.
  • If it instead corresponds to your pre-patch datecode, replace it with the new one and save the file.
"},{"location":"games/bemani/ddr/a3/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

For MDX-001 (32 bits)
  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice.exe and spicecfg.exe files from the archive to your game's directory.

For MDX-003 (64 bits)
  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice64.exe and spicecfg.exe files from the archive to your game's directory.

"},{"location":"games/bemani/ddr/a3/setup/#configuring-spice2x","title":"Configuring Spice2x","text":"

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/ddr/a3/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • P1 Panel buttons: Up, Down, Left, Right
  • P1 Menu buttons: Start, Up, Down, Left, Right
  • P1 Keypad: 1 to 9, Keypad Insert Card
"},{"location":"games/bemani/ddr/a3/setup/#overlay","title":"Overlay","text":"

Modifying buttons in this section is not required but you are free to change what you want.

Click on Bind then press the key you want associated with the action.

"},{"location":"games/bemani/ddr/a3/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through spice2x.

If it does, here's how you may link different actions to your lights:

  • Click Bind.
  • In Device, pick your controller.
  • In Light Control, select the corresponding light.
  • Click Close.
  • Repeat for your other lights.
"},{"location":"games/bemani/ddr/a3/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section.

"},{"location":"games/bemani/ddr/a3/setup/#patches","title":"Patches","text":"

Go through the Spice2x Patching page to import patches.

To prevent issues, avoid patching things you don't need or understand.

"},{"location":"games/bemani/ddr/a3/setup/#api","title":"API","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/ddr/a3/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the question mark at the very left.

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Network EA Service URL -url Covered in Connecting to a network

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/ddr/a3/setup/#advanced-development","title":"Advanced & Development","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/ddr/a3/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/ddr/a3/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/bemani/ddr/a3/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/bemani/ddr/a3/setup/#k-lite-codec-pack","title":"K-lite Codec Pack","text":"
  • Download and install the K-lite Codec Pack (the Standard version is enough)
"},{"location":"games/bemani/ddr/a3/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/bemani/ddr/a3/troubleshooting/","title":"Troubleshooting (DDR A3)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/ddr/a3/troubleshooting/#clock-error","title":"Clock error","text":"

In the test menu, navigate to CLOCK, and set it to match your computer's time.

"},{"location":"games/bemani/ddr/a3/troubleshooting/#my-game-is-running-slowlagging","title":"My game is running slow/lagging","text":"

Try to eliminate any unnecessary background processes during play.

"},{"location":"games/bemani/ddr/a3/troubleshooting/#unable-to-login-eamuse-error-network-error","title":"Unable to login / Eamuse error / Network error","text":"

Get the proper Asphyxia plugin from our Discord server in the #ddr channel > Resources post. Make sure you didn't enable -smartea in spicecfg's options.

"},{"location":"games/bemani/ddr/a3/troubleshooting/#where-are-the-option-for-dancersshadingmeasure-linesfast-slowlayering","title":"Where are the option for Dancers/Shading/Measure lines/Fast-Slow/Layering?","text":"

These options are locked behind network requirements and will not be displayed unless you are connected to a network that has written support for these options. Patches are available to mitigate this (see Patches).

"},{"location":"games/bemani/ddr/common/setup/","title":"Setup","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/ddr/common/setup/#about-data","title":"About data","text":"

The full game should be around 20-25gb in size.

Please keep the following in mind as you're going through this guide.

DDR's codename is MDX. Starting with DDR A20 this would be either:

  • MDX-001 (Other cabs, 32 bits)
  • MDX-003 (Gold cab, 64 bits)

The gold cab version contains more features, such as exclusive songs or the \"GOLDEN LEAGUE\" mode.

"},{"location":"games/bemani/ddr/common/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure with a few folders only, as follows.

If your data doesn't look like this

If you're missing the modules folder and instead have bunch of .dll files next to your folders:

  • Create a modules folder.
  • Move all .dll files inside of it so you end up with a structure as shown above.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/bemani/ddr/common/setup/#updating-data","title":"Updating data","text":"Please make sure you're using the right update for your current data.

DDR Patches re-uploaded by the community tend to be appropriately named MDX-DATECODE-to-DATECODE.

For example MDX-2024091000-to-2024101500.

  • 2024091000 being your current data's version.
  • 2024101500 being the one you would arrive at.
  • Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.
  • Open prop\\ea3-config.xml in a text editor and find the following lines near the top.
    <soft>\n        <model __type=\"str\">MDX</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">A</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024101500</ext>\n    </soft>\n

On the line with <ext __type=\"str\"> the datecode needs to match your new version.

  • If that's already the case then great! Don't touch anything.
  • If it instead corresponds to your pre-patch datecode, replace it with the new one and save the file.
"},{"location":"games/bemani/ddr/common/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

For MDX-001 (32 bits)
  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice.exe and spicecfg.exe files from the archive to your game's directory.

For MDX-003 (64 bits)
  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice64.exe and spicecfg.exe files from the archive to your game's directory.

"},{"location":"games/bemani/ddr/common/setup/#configuring-spice2x","title":"Configuring Spice2x","text":"

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/ddr/common/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • P1 Panel buttons: Up, Down, Left, Right
  • P1 Menu buttons: Start, Up, Down, Left, Right
  • P1 Keypad: 1 to 9, Keypad Insert Card
"},{"location":"games/bemani/ddr/common/setup/#overlay","title":"Overlay","text":"

Modifying buttons in this section is not required but you are free to change what you want.

Click on Bind then press the key you want associated with the action.

"},{"location":"games/bemani/ddr/common/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through spice2x.

If it does, here's how you may link different actions to your lights:

  • Click Bind.
  • In Device, pick your controller.
  • In Light Control, select the corresponding light.
  • Click Close.
  • Repeat for your other lights.
"},{"location":"games/bemani/ddr/common/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section.

"},{"location":"games/bemani/ddr/common/setup/#patches","title":"Patches","text":"

Go through the Spice2x Patching page to import patches.

To prevent issues, avoid patching things you don't need or understand.

"},{"location":"games/bemani/ddr/common/setup/#api","title":"API","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/ddr/common/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the question mark at the very left.

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Network EA Service URL -url Covered in Connecting to a network

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/ddr/common/setup/#advanced-development","title":"Advanced & Development","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/ddr/common/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/ddr/common/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/bemani/ddr/common/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/bemani/ddr/common/setup/#k-lite-codec-pack","title":"K-lite Codec Pack","text":"
  • Download and install the K-lite Codec Pack (the Standard version is enough)
"},{"location":"games/bemani/ddr/common/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/bemani/ddr/common/troubleshooting/","title":"Troubleshooting","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/ddr/common/troubleshooting/#clock-error","title":"Clock error","text":"

In the test menu, navigate to CLOCK, and set it to match your computer's time.

"},{"location":"games/bemani/ddr/common/troubleshooting/#my-game-is-running-slowlagging","title":"My game is running slow/lagging","text":"

Try to eliminate any unnecessary background processes during play.

"},{"location":"games/bemani/ddr/common/troubleshooting/#unable-to-login-eamuse-error-network-error","title":"Unable to login / Eamuse error / Network error","text":"

Get the proper Asphyxia plugin from our Discord server in the #ddr channel > Resources post. Make sure you didn't enable -smartea in spicecfg's options.

"},{"location":"games/bemani/ddr/common/troubleshooting/#where-are-the-option-for-dancersshadingmeasure-linesfast-slowlayering","title":"Where are the option for Dancers/Shading/Measure lines/Fast-Slow/Layering?","text":"

These options are locked behind network requirements and will not be displayed unless you are connected to a network that has written support for these options. Patches are available to mitigate this (see Patches).

"},{"location":"games/bemani/ddr/world/setup/","title":"Game Setup (DDR WORLD)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/ddr/world/setup/#about-data","title":"About data","text":"

The full game should be around 20-25gb in size.

Please keep the following in mind as you're going through this guide.

DDR's codename is MDX. Starting with DDR A20 this would be either:

  • MDX-001 (Other cabs, 32 bits)
  • MDX-003 (Gold cab, 64 bits)

The gold cab version contains more features, such as exclusive songs or the \"GOLDEN LEAGUE\" mode.

"},{"location":"games/bemani/ddr/world/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure with a few folders only, as follows.

If your data doesn't look like this

If you're missing the modules folder and instead have bunch of .dll files next to your folders:

  • Create a modules folder.
  • Move all .dll files inside of it so you end up with a structure as shown above.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/bemani/ddr/world/setup/#updating-data","title":"Updating data","text":"Please make sure you're using the right update for your current data.

DDR Patches re-uploaded by the community tend to be appropriately named MDX-DATECODE-to-DATECODE.

For example MDX-2024091000-to-2024101500.

  • 2024091000 being your current data's version.
  • 2024101500 being the one you would arrive at.
  • Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.
  • Open prop\\ea3-config.xml in a text editor and find the following lines near the top.
    <soft>\n        <model __type=\"str\">MDX</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">A</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024101500</ext>\n    </soft>\n

On the line with <ext __type=\"str\"> the datecode needs to match your new version.

  • If that's already the case then great! Don't touch anything.
  • If it instead corresponds to your pre-patch datecode, replace it with the new one and save the file.
"},{"location":"games/bemani/ddr/world/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

For MDX-001 (32 bits)
  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice.exe and spicecfg.exe files from the archive to your game's directory.

For MDX-003 (64 bits)
  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice64.exe and spicecfg.exe files from the archive to your game's directory.

"},{"location":"games/bemani/ddr/world/setup/#configuring-spice2x","title":"Configuring Spice2x","text":"

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/ddr/world/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • P1 Panel buttons: Up, Down, Left, Right
  • P1 Menu buttons: Start, Up, Down, Left, Right
  • P1 Keypad: 1 to 9, Keypad Insert Card
"},{"location":"games/bemani/ddr/world/setup/#overlay","title":"Overlay","text":"

Modifying buttons in this section is not required but you are free to change what you want.

Click on Bind then press the key you want associated with the action.

"},{"location":"games/bemani/ddr/world/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through spice2x.

If it does, here's how you may link different actions to your lights:

  • Click Bind.
  • In Device, pick your controller.
  • In Light Control, select the corresponding light.
  • Click Close.
  • Repeat for your other lights.
"},{"location":"games/bemani/ddr/world/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section.

"},{"location":"games/bemani/ddr/world/setup/#patches","title":"Patches","text":"

Go through the Spice2x Patching page to import patches.

To prevent issues, avoid patching things you don't need or understand.

"},{"location":"games/bemani/ddr/world/setup/#api","title":"API","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/ddr/world/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the question mark at the very left.

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Network EA Service URL -url Covered in Connecting to a network

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/ddr/world/setup/#advanced-development","title":"Advanced & Development","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/ddr/world/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/ddr/world/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/bemani/ddr/world/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/bemani/ddr/world/setup/#k-lite-codec-pack","title":"K-lite Codec Pack","text":"
  • Download and install the K-lite Codec Pack (the Standard version is enough)
"},{"location":"games/bemani/ddr/world/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/bemani/ddr/world/troubleshooting/","title":"Troubleshooting (DDR WORLD)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/ddr/world/troubleshooting/#clock-error","title":"Clock error","text":"

In the test menu, navigate to CLOCK, and set it to match your computer's time.

"},{"location":"games/bemani/ddr/world/troubleshooting/#my-game-is-running-slowlagging","title":"My game is running slow/lagging","text":"

Try to eliminate any unnecessary background processes during play.

"},{"location":"games/bemani/ddr/world/troubleshooting/#unable-to-login-eamuse-error-network-error","title":"Unable to login / Eamuse error / Network error","text":"

Get the proper Asphyxia plugin from our Discord server in the #ddr channel > Resources post. Make sure you didn't enable -smartea in spicecfg's options.

"},{"location":"games/bemani/ddr/world/troubleshooting/#where-are-the-option-for-dancersshadingmeasure-linesfast-slowlayering","title":"Where are the option for Dancers/Shading/Measure lines/Fast-Slow/Layering?","text":"

These options are locked behind network requirements and will not be displayed unless you are connected to a network that has written support for these options. Patches are available to mitigate this (see Patches).

"},{"location":"games/bemani/gitadora/exchain/setup/","title":"GITADORA EXCHAIN","text":"

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.

"},{"location":"games/bemani/gitadora/exchain/setup/#getting-started","title":"Getting Started.","text":"

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.

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.

Why does this look different than the usual? This installation includes a modules folder that Spice automatically detects, keeping things clean and simple.

"},{"location":"games/bemani/gitadora/exchain/setup/#configuring-your-tools","title":"Configuring Your Tools","text":"

Now that you have your files ready, open up your .bat file in your desired text editor (we're using Notepad++) 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.

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.

"},{"location":"games/bemani/gitadora/exchain/setup/#configuring-for-a-local-network","title":"Configuring for a Local Network","text":"

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++.

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++.

"},{"location":"games/bemani/gitadora/exchain/setup/#configuring-for-an-online-network","title":"Configuring for an Online Network","text":"

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++.

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++.

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.

"},{"location":"games/bemani/gitadora/exchain/setup/#final-steps-and-setting-up-the-game","title":"Final Steps and Setting up the Game","text":"

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!

This is normal, simply hit your Test keybind and continue on to this.

From here, we will need to set a shop name to play, so select the GAME OPTIONS option.

Then, select SHOP SETTINGS.

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.

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.

You're all done! From the service menu select GAME MODE and the game should load ready to be played! Have fun!

Have any other errors?

Check out the Troubleshooting section and Error Code section to resolve any issues not seen in this guide to greater depth.

"},{"location":"games/bemani/gitadora/exchain/troubleshooting/","title":"GITADORA EXCHAIN","text":""},{"location":"games/bemani/gitadora/exchain/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

Bemani PC Type 4

CPU: AMD Athlon 64 X2 4400

GPU: ATI Radeon HD 2400

RAM: 1 GB

OS: Windows 7 Embedded

"},{"location":"games/bemani/gitadora/exchain/troubleshooting/#my-game-is-running-slowlagging","title":"My Game Is Running Slow/Lagging","text":"

Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.

"},{"location":"games/bemani/gitadora/exchain/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

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.

"},{"location":"games/bemani/gitadora/exchain/troubleshooting/#game-stuck-on-title-screen-amd-ryzen-3900x","title":"Game Stuck On Title Screen (AMD Ryzen 3900X)","text":"

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

"},{"location":"games/bemani/gitadora/exchain/troubleshooting/#occasional-graphical-stuttering-during-gameplay","title":"Occasional Graphical Stuttering During Gameplay","text":"

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\".

"},{"location":"games/bemani/gitadora/exchain/troubleshooting/#i-get-an-ip-change-error","title":"I get an IP Change Error!","text":"

Apply the Fix IP Change Error patch.

"},{"location":"games/bemani/gitadora/exchain/troubleshooting/#which-offset-is-which","title":"Which Offset Is Which?","text":"

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.

"},{"location":"games/bemani/gitadora/exchain/troubleshooting/#why-are-my-videos-freezing-usually-towards-the-end-of-the-song","title":"Why Are My Videos Freezing (Usually Towards the End of the Song)?","text":"

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.

"},{"location":"games/bemani/gitadora/exchain/troubleshooting/#i-tried-switching-to-spicetools-to-follow-the-guide-and-it-crashes","title":"I Tried Switching to SpiceTools to Follow the Guide and It Crashes!","text":"

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.

"},{"location":"games/bemani/gitadora/exchain/troubleshooting/#my-drum-pedal-isnt-working","title":"My Drum Pedal Isn't Working!","text":"

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.

"},{"location":"games/bemani/gitadora/exchain/troubleshooting/#when-i-run-this-game-all-other-background-audio-is-gone-whats-going-on","title":"When I Run This Game All Other Background Audio Is Gone! What's Going On?","text":"

Gitadora is a 64-bit game that utilizes a feature in Windows called WASAPI exclusive mode to obtain less audio latency than the former 32-bit versions of BEMANI games which used DirectSound. Unfortunately, this cannot be changed.

"},{"location":"games/bemani/gitadora/exchain/troubleshooting/#note-on-2-channel-and-4-channel-audio","title":"Note on 2-channel and 4-channel Audio","text":"

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.

"},{"location":"games/bemani/gitadora/fuzzup/setup/","title":"GITADORA FUZZ-UP","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/gitadora/fuzzup/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice64.exe and spicecfg.exe files from the archive to your game's directory.

"},{"location":"games/bemani/gitadora/fuzzup/setup/#general-configuration","title":"General Configuration","text":"

Since GITADORA has a separate mode for both Guitar and Drums, the configuration will be split into three sections.This section will cover the general configuration that is not specific to either mode.

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/gitadora/fuzzup/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your keyboard, configure your keys for:

  • Maintenance: Test
  • P1 Keypad: Keypad 0 to 9, Keypad Insert Card
"},{"location":"games/bemani/gitadora/fuzzup/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a Network section.

"},{"location":"games/bemani/gitadora/fuzzup/setup/#patches","title":"Patches","text":"

Go through the Spice2x Patching page to import patches.

To prevent issues, avoid patching things you don't need or understand.

"},{"location":"games/bemani/gitadora/fuzzup/setup/#options","title":"Options","text":"

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Game Options GitaDora Two Channel Audio -2ch ON Network EA Service URL -url Covered in Connecting to a Network

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (Common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/gitadora/fuzzup/setup/#guitarfreaks-configuration","title":"GuitarFreaks Configuration","text":"

This section will cover the configuration specific to the Guitar mode.If you are wanting to configure drums, skip to the DrumMania Configuration section.

"},{"location":"games/bemani/gitadora/fuzzup/setup/#buttons_1","title":"Buttons","text":"

Set up your guitar as right-handed. Lefty mode is software-based.

Click on Bind then press the key you want associated with the action.

With your keyboard and controller plugged in, configure your keys for:

  • Guitar P1 IO Panel: Guitar P1 Start, Up, Down, Left, Right, Help
  • Guitar P1 Controls: Guitar P1 Pick Up, Pick Down, R, G, B, Y, P
"},{"location":"games/bemani/gitadora/fuzzup/setup/#analogs","title":"Analogs","text":"

Rather than setting your Wail to buttons, you should:

  • Find the Guitar P1 Wail X, Y, and Z analogs.
  • Click Bind.
  • In Device, pick your guitar.
  • In Control, pick the corresponding axis.
  • Move your guitar and ensure the Preview visualizer shows movement.
  • Repeat for other applicable axes your guitar has.
"},{"location":"games/bemani/gitadora/fuzzup/setup/#advanced","title":"Advanced","text":"

Not setting these values will cause the game to not boot into either mode.

Required

Category Option Parameter Setting Paths Path to ea3-config.xml -e prop/ea3-config2.xml Paths Path to avs-config.xml -v prop/avs-config-jb.xml"},{"location":"games/bemani/gitadora/fuzzup/setup/#drummania-configuration","title":"DrumMania Configuration","text":"

This section will cover the configuration specific to the Drums mode.If you are wanting to configure guitar, refer to the GuitarFreaks Configuration section.

"},{"location":"games/bemani/gitadora/fuzzup/setup/#buttons_2","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your keyboard and controller plugged in, configure your keys for:

  • Drum IO Panel: Drum Start, Up, Down, Left, Right, Help
  • Drum Controls: Drum Hi-Hat, Snare, Hi-Tom, Low-Tom, Right Cymbal, Bass Pedal, Left Cytmbal, Left Pedal, Floor Tom
"},{"location":"games/bemani/gitadora/fuzzup/setup/#advanced_1","title":"Advanced","text":"

Not setting these values will cause the game to not boot into either mode.

Required

Category Option Parameter Setting Paths Path to ea3-config.xml -e prop/ea3-config.xml Paths Path to avs-config.xml -v prop/avs-config-ja.xml"},{"location":"games/bemani/gitadora/fuzzup/setup/#connecting-to-a-network","title":"Connecting to a Network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/gitadora/fuzzup/setup/#pre-launch-requirements","title":"Pre-launch Requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/bemani/gitadora/fuzzup/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/bemani/gitadora/fuzzup/setup/#audio","title":"Audio","text":"

GITADORA FUZZ-UP currently only supports WASAPI exclusive mode.

  • Open spicecfg.exe.
  • At the very top, click on Shortcuts then Audio Playback Devices.
  • In the popup window, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick the 24 bit, 44100 Hz (Studio Quality) option and click Apply then OK.

"},{"location":"games/bemani/gitadora/fuzzup/setup/#first-launch","title":"First Launch","text":"

If you have any issues running the game at this point, refer to the Troubleshooting page.

If you've followed all instructions correctly, you're finally ready to launch the game!

First, ensure your guitar or drumkit is connected and run spice64.exe. Press Yes when it asks for elevated privileges.

Upon launching your game, you will be greeted with this BACKUP DATA ERROR screen.

This is normal, simply hit your Test keybind to enter test mode.

From here, we will need to set a shop name to play, so select the GAME OPTIONS option.

Then, select SHOP SETTINGS.

Once inside, select SHOP NAME SETTINGS and name your shop whatever you desire! 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 test menu.

The last menu we'll go inside from the test menu is the clock menu. Go inside CLOCK and simply set the clock by hitting SAVE AND EXIT as pictured below.

You're all done! From the test menu, select GAME MODE and the game should boot up!

"},{"location":"games/bemani/gitadora/fuzzup/setup/#carding-in","title":"Carding In","text":"

Once the game is done loading, you need to card in.

  • Press your Keypad Insert Card button.
  • Enter your code using your keypad binds.
"},{"location":"games/bemani/gitadora/fuzzup/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/bemani/gitadora/fuzzup/troubleshooting/","title":"GITADORA FUZZ-UP","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/gitadora/fuzzup/troubleshooting/#im-having-performance-issues","title":"I'm having performance issues!","text":"

If you're having performance issues of some kind, spice2x's PC optimization guide is worth looking at.

"},{"location":"games/bemani/gitadora/fuzzup/troubleshooting/#my-game-is-running-too-fast","title":"My game is running too fast!","text":"

The most common reason for this is the game is running over its required refresh rate.

To solve this, ensure the monitor running GITADORA FUZZ-UP is set to 60Hz. This is a requirement for the game to run at the correct speed. The game is hardcoded to run at 60Hz and there is no way to change this.

In addition, make sure v-sync isn't disabled in your graphics card's settings.

For NVIDIA users, enable NVIDIA profile optimization (-nvprofile) in the Options tab.

"},{"location":"games/bemani/gitadora/fuzzup/troubleshooting/#theres-occasional-graphical-stuttering-during-gameplay","title":"There's occasional graphical stuttering during gameplay!","text":"

To fix this, you need to disable fullscreen optimizations for spice64.exe.

  1. Right click on spice64.exe and select Properties.
  2. Go to the Compatibility tab.
  3. Click the box at the bottom that says Change settings for all users.
  4. Check the box that says Disable fullscreen optimizations.
  5. Click Apply and then OK.
"},{"location":"games/bemani/gitadora/fuzzup/troubleshooting/#how-do-i-adjust-my-offset","title":"How do I adjust my offset?","text":"

Play through a chart you're comfortable with.

If you're getting too many Fast, increase your offset (+). If you're getting too many Slow, decrease your offset (-).

GITADORA FUZZ-UP has two types of offset adjustments, visual and audio based, so be sure to fiddle with both to find desirable settings.

"},{"location":"games/bemani/gitadora/fuzzup/troubleshooting/#when-i-run-the-game-all-other-audio-is-gone","title":"When I run the game, all other audio is gone!","text":"

GITADORA FUZZ-UP uses WASAPI exclusive mode for better audio latency.

There is currently no patch available to run the game in shared mode, so you will need to use a separate audio device for the game if you want to hear other audio sources while playing.

"},{"location":"games/bemani/gitadora/fuzzup/troubleshooting/#i-want-to-use-4-channel-audio-why-isnt-it-working","title":"I want to use 4-channel audio! Why isn't it working?","text":"

Unfortunately, most setups do not properly function with GITADORA FUZZ-UP's 4-channel audio, and the -2ch parameter will be mandatory to hear any audio. There are not many setups working with 4-channel audio, and there are buffer issues related to it. Please avoid using it.

"},{"location":"games/bemani/gitadora/matixx/setup/","title":"GITADORA Matixx","text":"

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.

"},{"location":"games/bemani/gitadora/matixx/setup/#getting-started","title":"Getting Started.","text":"

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.

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.

"},{"location":"games/bemani/gitadora/matixx/setup/#configuring-your-tools","title":"Configuring Your Tools","text":"

Now that you have your files ready, open up your .bat file in your desired text editor (we're using Notepad++) 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.

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.

"},{"location":"games/bemani/gitadora/matixx/setup/#configuring-for-a-local-network","title":"Configuring for a Local Network","text":"

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++.

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++.

"},{"location":"games/bemani/gitadora/matixx/setup/#configuring-for-an-online-network","title":"Configuring for an Online Network","text":"

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++.

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++.

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.

"},{"location":"games/bemani/gitadora/matixx/setup/#final-steps-and-setting-up-the-game","title":"Final Steps and Setting up the Game","text":"

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!

This is normal, simply hit your Test keybind and continue on to this.

From here, we will need to set a shop name to play, so select the GAME OPTIONS option.

Then, select SHOP SETTINGS.

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.

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.

You're all done! From the service menu select GAME MODE and the game should load ready to be played! Have fun!

Have any other errors?

Check out the Troubleshooting section and Error Code section to resolve any issues not seen in this guide to greater depth.

"},{"location":"games/bemani/gitadora/matixx/troubleshooting/","title":"GITADORA Matixx","text":""},{"location":"games/bemani/gitadora/matixx/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

Bemani PC Type 4

CPU: AMD Athlon 64 X2 4400

GPU: ATI Radeon HD 2400

RAM: 1 GB

OS: Windows 7 Embedded

"},{"location":"games/bemani/gitadora/matixx/troubleshooting/#my-game-is-running-slowlagging","title":"My Game Is Running Slow/Lagging","text":"

Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.

"},{"location":"games/bemani/gitadora/matixx/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

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.

"},{"location":"games/bemani/gitadora/matixx/troubleshooting/#game-stuck-on-title-screen-amd-ryzen-3900x","title":"Game Stuck On Title Screen (AMD Ryzen 3900X)","text":"

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

"},{"location":"games/bemani/gitadora/matixx/troubleshooting/#occasional-graphical-stuttering-during-gameplay","title":"Occasional Graphical Stuttering During Gameplay","text":"

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\".

"},{"location":"games/bemani/gitadora/matixx/troubleshooting/#i-get-an-ip-change-error","title":"I get an IP Change Error!","text":"

Apply the Fix IP Change Error patch.

"},{"location":"games/bemani/gitadora/matixx/troubleshooting/#which-offset-is-which","title":"Which Offset Is Which?","text":"

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.

"},{"location":"games/bemani/gitadora/matixx/troubleshooting/#why-are-my-videos-freezing-usually-towards-the-end-of-the-song","title":"Why Are My Videos Freezing (Usually Towards the End of the Song)?","text":"

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.

"},{"location":"games/bemani/gitadora/matixx/troubleshooting/#i-tried-switching-to-spicetools-to-follow-the-guide-and-it-crashes","title":"I Tried Switching to SpiceTools to Follow the Guide and It Crashes!","text":"

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.

"},{"location":"games/bemani/gitadora/matixx/troubleshooting/#my-drum-pedal-isnt-working","title":"My Drum Pedal Isn't Working!","text":"

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.

"},{"location":"games/bemani/gitadora/matixx/troubleshooting/#when-i-run-this-game-all-other-background-audio-is-gone-whats-going-on","title":"When I Run This Game All Other Background Audio Is Gone! What's Going On?","text":"

Gitadora is a 64-bit game that utilizes a feature in Windows called WASAPI exclusive mode to obtain less audio latency than the former 32-bit versions of BEMANI games which used DirectSound. Unfortunately, this cannot be changed.

"},{"location":"games/bemani/gitadora/matixx/troubleshooting/#note-on-2-channel-and-4-channel-audio","title":"Note on 2-channel and 4-channel Audio","text":"

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.

"},{"location":"games/bemani/iidx/10thstyle/setup/","title":"beatmania IIDX 10th style","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/iidx/10thstyle/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.
"},{"location":"games/bemani/iidx/10thstyle/setup/#installing-bemanitools","title":"Installing Bemanitools","text":"

  • Download Bemanitools.

  • Inside bemanitools-5.48.zip locate iidx-09-to-12.zip.

  • Extract everything inside the folder that contains the bm2dx.exe which is located in \\D01\\JAE.

Pictured below is what your folder should look like. We've removed any files not necessary for 10th style.

"},{"location":"games/bemani/iidx/10thstyle/setup/#using-iidxhook-10conf-rteffectdll","title":"Using iidxhook-10.conf & RtEffect.dll","text":"

  • Download the Bemanitools supplements

  • Open bemanitools-supplement-v1.6.zip and navigate inside misc.zip

  • Inside misc\\d3d8to9, extract d3d8.dll to \\D01\\JAE.

This enables us to use the graphic options inside iidxhook-10.conf which we will take advantage of.

  • Open bemanitools-supplement-v1.6.zip and navigate inside iidx.zip

  • Inside iidx/misc, extract RtEffect_stub.dll to \\D01\\JAE.

  • Delete the already existing RtEffect.dll and rename RtEffect_stub.dll to RtEffect.dll.

This will eliminate any immediate crashes relating to needing specific old hardware.

"},{"location":"games/bemani/iidx/10thstyle/setup/#replacing-bm2dxexe","title":"Replacing bm2dx.exe","text":"

  • Go to D01\\util and copy bm2dx_D01_JAE_no_checksum.exe to D01\\JAE

  • Delete the original bm2dx.exe

  • Rename bm2dx_D01_JAE_no_checksum.exe to bm2dx.exe

If you don't do this, you will end up getting a HDD DATA ERROR (PROG CHKSUM) which will result in the game not being able to run.

"},{"location":"games/bemani/iidx/10thstyle/setup/#configuring-bemanitools","title":"Configuring Bemanitools","text":"

To configure your keybinds, open your config.bat file.

"},{"location":"games/bemani/iidx/10thstyle/setup/#buttons","title":"Buttons","text":"

Double click on the right on a button that you wish to bind, then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • P1 Game buttons: 1 to 7, Start, EFFECT, VEFX
  • P1 Keypad: Keypad Insert Card

Only if you're playing using a keyboard:

  • Turntable: TT+, TT- and optionally TT+/- which alternates between TT+ and TT- on each press.
"},{"location":"games/bemani/iidx/10thstyle/setup/#analogs-controllercab-only","title":"Analogs (controller/cab only)","text":"

With a controller rather than binding buttons to TT+ and TT-, you need to:

  • Head to the Analogs tab at the top.
  • In Device, pick your controller.
  • In Control, pick whichever one corresponds to the turntable.
  • Turn your turntable ensuring that the preview turns along with it.
  • Click OK, leaving the rest of the settings alone.
"},{"location":"games/bemani/iidx/10thstyle/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through bemanitools.

If it does, here's how you may link different actions to your lights:

  • In Device, pick your controller.
  • In Game Light, select the corresponding button that will be used for that light.
  • Repeat for your other lights.
"},{"location":"games/bemani/iidx/10thstyle/setup/#configuring-bemanitools-for-a-network","title":"Configuring Bemanitools for a network","text":"

Head over to the Network tab.

Now we will set up our PIN pad and card.

  • Click on Keyboard device
  • You may or may not have more than one option. To figure out which one is your actual keyboard, select a device inside that list and press a button on the numpad.
  • Once you have found your correct device, the Keyboard status will change (the number and location of the number does not matter, it only matters that it changed).
  • Grab your card, create a .txt and name it however you like. In this example it's called card.txt
  • Place the file in a location that is easily accessible and you won't forget. In this case it's in a seperate folder.

If you don't have a numpad, make sure to tick Use top keyboard row for PIN pad input. This will also change the Card In button to Backspace.

"},{"location":"games/bemani/iidx/10thstyle/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

  • Locate your iidxhook-10.conf

  • Open it with your desired text editor (we're using Notepad++)

  • Replace the eamuse.server=localhost:80 with your desired network URL

  • Replace eamuse.pcbid=XXXXXXXXXXXXXXXXXXXX and eamuse.eamid=XXXXXXXXXXXXXXXXXXXX with your PCBID of your network of choice.

# URL (e.g. http://my.eamuse.server:80/whatever) or IPV4 (e.g. 127.0.0.1:80) of the target eamuse server. The port is optional but defaults to 80.\neamuse.server=localhost:80\n\n# PCBID\neamuse.pcbid=XXXXXXXXXXXXXXXXXXXX\n\n# EAMID\neamuse.eamid=XXXXXXXXXXXXXXXXXXXX\n
"},{"location":"games/bemani/iidx/10thstyle/setup/#game-resolution-and-locking-fps","title":"Game resolution and locking FPS","text":"

We'd like to mention that there are two options when it comes to how the game renders. You can choose between Linear and Point.

Below is an example of how both look like.

Linear

Point

It comes down to your own prefrence what you decide on, Linear is less sharp but doesn't have pixel perfect edges. Point is sharp and is pixel perfect.

Next up, we'll setup borderless window and configure the proper resolution. We're using a 1920x1080 monitor so we will use that.

Repeat the previous step and open your iidxhook-10.conf. We want to find these lines:

# Run the game windowed\ngfx.windowed=false\n\n# Windowed width, 0 for default size\ngfx.window_width=0\n\n# Windowed height, 0 for default size\ngfx.window_height=0\n\n# Up-/downscale the back buffer's width. This does not change the game's rendering resolution but scales the final frame. Use this to target the native resolution of your monitor/TV, e.g. to avoid over-/underscan, bad image quality or latency caused by the monitors internal upscaler. 0 to disable this feature. Must be set in combination with the corresponding height parameter.\ngfx.scale_back_buffer_width=0\n\n# Up-/downscale the back buffer's height. This does not change the game's rendering resolution but scales the final frame. Use this to target the native resolution of your monitor/TV, e.g. to avoid over-/underscan, bad image quality or latency caused by the monitors internal upscaler. 0 to disable this feature. Must be set in combination with the corresponding width parameter.\ngfx.scale_back_buffer_height=0\n\n# Filter type to use for up-/downscaling the back buffer. Only used if scaling feature was enabled by setting the scaling width and height parameters. Available types: none, linear, point (refer to D3DTEXTUREFILTERTYPE  for explanation).\ngfx.scale_back_buffer_filter=none\n

If you can't seem to find them, press CTRL + F and search for gfx.frame_rate_limit=0.0. This will bring you to the first line we want to edit.

Listed below are the values we want to change them to.

gfx.frame_rate_limit=59.95\ngfx.windowed=true\ngfx.window_width=1920\ngfx.window_height=1080\ngfx.scale_back_buffer_width=1920\ngfx.scale_back_buffer_height=1080\ngfx.scale_back_buffer_filter=point\n
Unless you'd like to have the game properly windowed you can safely ignore gfx.framed=false.

Make sure to decide on whether you want Linear or Point rendering.

gfx.scale_back_buffer_filter=linear\ngfx.scale_back_buffer_filter=point\n
"},{"location":"games/bemani/iidx/10thstyle/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

"},{"location":"games/bemani/iidx/10thstyle/setup/#backup-data","title":"BACKUP DATA","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run gamestart.bat.

If it's your first time running the game, you'll immediately be greeted with this screen.

Press your Start key to confirm to get to the next error message.

"},{"location":"games/bemani/iidx/10thstyle/setup/#clock-error","title":"CLOCK ERROR","text":"

Press your Start key to confirm. This will bring you into it's service menu.

Instructions on how to navigate the menu are shown at the bottom of the screen.

  • Press 1 and 2 to go up and down.
  • Press 6 to select/execute.

Navigate to CLOCK. You do not need to manually change it. Navigate to SAVE AND EXIT.

"},{"location":"games/bemani/iidx/10thstyle/setup/#enabling-e-amusement-for-online-play","title":"Enabling e-AMUSEMENT for Online Play","text":"

From the service menu, go to e-AMUSEMENT OPTIONS then e-AMUSEMENT SETTINGS.

It'll bring you to this screen, change it so that e-AMUSEMENT switches to ON and it will look like this:

We will need to set a SHOP NAME SETTING and change our PREFECTURE otherwise the game will throw errors at us.

  • Name your shop to whatever you'd like. Instructions on how to navigate are at the bottom of the screen.
  • Navigate to EXIT and select it.
  • Change your prefecture once or how many times you'd like, it doesn't matter as long as it's not the default one.

Select SAVE AND EXIT. The game will now give you a message, which translated means:

e-AMUSEMENT settings have been changed. Please turn the power off and on again.

So, close the game and open it again.

"},{"location":"games/bemani/iidx/10thstyle/setup/#final-notes","title":"Final Notes","text":"

You're all done! Make sure to insert two credits by pressing your SERVICE key. Have fun!

Have any other errors?

Check out the Troubleshooting section.

"},{"location":"games/bemani/iidx/10thstyle/troubleshooting/","title":"IIDX 10 Troubleshooting","text":""},{"location":"games/bemani/iidx/10thstyle/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

The most common reason for this is the game is running over its required 59.95hz, the game is hardcoded to run at 59.95hz and this cannot be changed. To solve this, check Game resolution and locking FPS again.

"},{"location":"games/bemani/iidx/10thstyle/troubleshooting/#im-getting-network-warning-instead-of-network-ok","title":"I'm getting \"NETWORK WARNING\" instead of \"NETWORK OK\"","text":"

This can be caused by:

  • Invalid PCBID
  • Firewall blocking connections
  • Invalid eamuse url or port specified
  • Game is not run using the Administrator account
"},{"location":"games/bemani/iidx/10thstyle/troubleshooting/#my-background-videos-arent-working","title":"My background videos aren't working!","text":"

You need to install a codec.

  • Open bemanitools-supplement-v1.6.zip and navigate to \\iidx.zip\\iidx\\misc\\ where CLVSD.ax is located.

  • Extract CLVSD.ax inside a folder that you know won't be moved or renamed.

  • Open the command prompt as administrator. Now type regsvr32 \"<location of the file>\\CLVSD.ax\" into the command prompt.

As an example, it could look like this: regsvr32 \"D:\\BEMANI\\IIDX\\CLVSD.ax\"

A prompt should appear telling you that it has been installed successfully. This applies for all styles that require this codec, not just 10th style.

If an error occurs, you didn't run the command prompt as administrator or you messed up the location of the file.

You can not move or delete CLVSD.ax at all, otherwise it will revert the changes and you have to install it again.

"},{"location":"games/bemani/iidx/10thstyle/troubleshooting/#my-game-crashes-immediately","title":"My game crashes immediately!","text":"

This can have multiple reasons. These fixes shouldn't be needed for 10th style since we're addressing them in the guide. We'll add them anyway just in case.

"},{"location":"games/bemani/iidx/10thstyle/troubleshooting/#fix-1-wrong-data-structure","title":"Fix #1 (Wrong data structure)","text":"

Make sure that your unpacked data looks like this:

  • JAx (Game binary revision folder where 'x' can be A, B, C, D, E, F, G)
  • data
  • sidcode.txt

Any other files are optional and don't have to be removed as these are not required to run the game.

"},{"location":"games/bemani/iidx/10thstyle/troubleshooting/#fix-2-rteffectsdll-didnt-get-replaced","title":"Fix #2 (RtEffects.dll didn't get replaced)","text":"

Refer to Using iidxhook-10.conf & RtEffect.dll again and check if you have followed all the instructions explained in it.

"},{"location":"games/bemani/iidx/11_red/setup/","title":"beatmania IIDX 11 IIDX RED","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/iidx/11_red/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.
"},{"location":"games/bemani/iidx/11_red/setup/#installing-bemanitools","title":"Installing Bemanitools","text":"

  • Download Bemanitools.

  • Inside bemanitools-5.48.zip locate iidx-09-to-12.zip.

  • Extract everything inside the folder that contains the bm2dx.exe which is located in \\E11\\JAA.

Pictured below is what your folder should look like. We've removed any files not necessary for IIDX RED.

"},{"location":"games/bemani/iidx/11_red/setup/#using-iidxhook-11conf-rteffectdll","title":"Using iidxhook-11.conf & RtEffect.dll","text":"

  • Download the Bemanitools supplements

  • Open bemanitools-supplement-v1.6.zip and navigate inside misc.zip

  • Inside misc\\d3d8to9, extract d3d8.dll to \\E11\\JAA.

This enables us to use the graphic options inside iidxhook-11.conf which we will take advantage of.

  • Open bemanitools-supplement-v1.6.zip and navigate inside iidx.zip

  • Inside iidx/misc, extract RtEffect_stub.dll to \\E11\\JAA.

  • Delete the already existing RtEffect.dll and rename RtEffect_stub.dll to RtEffect.dll.

This will eliminate any immediate crashes relating to needing specific old hardware.

"},{"location":"games/bemani/iidx/11_red/setup/#configuring-bemanitools","title":"Configuring Bemanitools","text":"

To configure your keybinds, open your config.bat file.

"},{"location":"games/bemani/iidx/11_red/setup/#buttons","title":"Buttons","text":"

Double click on the right on a button that you wish to bind, then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • P1 Game buttons: 1 to 7, Start, EFFECT, VEFX
  • P1 Keypad: Keypad Insert Card

Only if you're playing using a keyboard:

  • Turntable: TT+, TT- and optionally TT+/- which alternates between TT+ and TT- on each press.
"},{"location":"games/bemani/iidx/11_red/setup/#analogs-controllercab-only","title":"Analogs (controller/cab only)","text":"

With a controller rather than binding buttons to TT+ and TT-, you need to:

  • Head to the Analogs tab at the top.
  • In Device, pick your controller.
  • In Control, pick whichever one corresponds to the turntable.
  • Turn your turntable ensuring that the preview turns along with it.
  • Click OK, leaving the rest of the settings alone.
"},{"location":"games/bemani/iidx/11_red/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through bemanitools.

If it does, here's how you may link different actions to your lights:

  • In Device, pick your controller.
  • In Game Light, select the corresponding button that will be used for that light.
  • Repeat for your other lights.
"},{"location":"games/bemani/iidx/11_red/setup/#configuring-bemanitools-for-a-network","title":"Configuring Bemanitools for a network","text":"

Head over to the Network tab.

Now we will set up our PIN pad and card.

  • Click on Keyboard device
  • You may or may not have more than one option. To figure out which one is your actual keyboard, select a device inside that list and press a button on the numpad.
  • Once you have found your correct device, the Keyboard status will change (the number and location of the number does not matter, it only matters that it changed).
  • Grab your card, create a .txt and name it however you like. In this example it's called card.txt
  • Place the file in a location that is easily accessible and you won't forget. In this case it's in a seperate folder.

If you don't have a numpad, make sure to tick Use top keyboard row for PIN pad input. This will also change the Card In button to Backspace.

"},{"location":"games/bemani/iidx/11_red/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

  • Locate your iidxhook-11.conf

  • Open it with your desired text editor (we're using Notepad++)

  • Replace the eamuse.server=localhost:80 with your desired network URL

  • Replace eamuse.pcbid=XXXXXXXXXXXXXXXXXXXX and eamuse.eamid=XXXXXXXXXXXXXXXXXXXX with your PCBID of your network of choice.

# URL (e.g. http://my.eamuse.server:80/whatever) or IPV4 (e.g. 127.0.0.1:80) of the target eamuse server. The port is optional but defaults to 80.\neamuse.server=localhost:80\n\n# PCBID\neamuse.pcbid=XXXXXXXXXXXXXXXXXXXX\n\n# EAMID\neamuse.eamid=XXXXXXXXXXXXXXXXXXXX\n
"},{"location":"games/bemani/iidx/11_red/setup/#game-resolution-and-locking-fps","title":"Game resolution and locking FPS","text":"

We'd like to mention that there are two options when it comes to how the game renders. You can choose between Linear and Point.

Below is an example of how both look like.

Linear

Point

It comes down to your own prefrence what you decide on, Linear is less sharp but doesn't have pixel perfect edges. Point is sharp and is pixel perfect.

Next up, we'll setup borderless window and configure the proper resolution. We're using a 1920x1080 monitor so we will use that.

Repeat the previous step and open your iidxhook-11.conf. We want to find these lines:

# Software limit the frame rate of the rendering loop in hz, e.g. 60 or 59.95 (0.0 = no software limit)\ngfx.frame_rate_limit=0.0\n\n# Run the game windowed\ngfx.windowed=false\n\n# Windowed width, 0 for default size\ngfx.window_width=0\n\n# Windowed height, 0 for default size\ngfx.window_height=0\n\n# Up-/downscale the back buffer's width. This does not change the game's rendering resolution but scales the final frame. Use this to target the native resolution of your monitor/TV, e.g. to avoid over-/underscan, bad image quality or latency caused by the monitors internal upscaler. 0 to disable this feature. Must be set in combination with the corresponding height parameter.\ngfx.scale_back_buffer_width=0\n\n# Up-/downscale the back buffer's height. This does not change the game's rendering resolution but scales the final frame. Use this to target the native resolution of your monitor/TV, e.g. to avoid over-/underscan, bad image quality or latency caused by the monitors internal upscaler. 0 to disable this feature. Must be set in combination with the corresponding width parameter.\ngfx.scale_back_buffer_height=0\n\n# Filter type to use for up-/downscaling the back buffer. Only used if scaling feature was enabled by setting the scaling width and height parameters. Available types: none, linear, point (refer to D3DTEXTUREFILTERTYPE  for explanation).\ngfx.scale_back_buffer_filter=none\n

If you can't seem to find them, press CTRL + F and search for gfx.frame_rate_limit=0.0. This will bring you to the first line we want to edit.

Listed below are the values we want to change them to.

gfx.frame_rate_limit=59.95\ngfx.windowed=true\ngfx.window_width=1920\ngfx.window_height=1080\ngfx.scale_back_buffer_width=1920\ngfx.scale_back_buffer_height=1080\ngfx.scale_back_buffer_filter=point\n
Unless you'd like to have the game properly windowed you can safely ignore gfx.framed=false.

Make sure to decide on whether you want Linear or Point rendering.

gfx.scale_back_buffer_filter=linear\ngfx.scale_back_buffer_filter=point\n
"},{"location":"games/bemani/iidx/11_red/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

"},{"location":"games/bemani/iidx/11_red/setup/#backup-data","title":"BACKUP DATA","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run gamestart.bat.

If it's your first time running the game, you'll immediately be greeted with this screen.

Press your Start key to confirm to get to the next error message.

"},{"location":"games/bemani/iidx/11_red/setup/#clock-error","title":"CLOCK ERROR","text":"

Press your Start key to confirm. This will bring you into it's service menu.

Instructions on how to navigate the menu are shown at the bottom of the screen.

  • Press 1 and 2 to go up and down.
  • Press 6 to select/execute.

Navigate to CLOCK. You do not need to manually change it. Navigate to SAVE AND EXIT.

"},{"location":"games/bemani/iidx/11_red/setup/#enabling-e-amusement-for-online-play","title":"Enabling e-AMUSEMENT for Online Play","text":"

From the service menu, go to NETWORK OPTIONS then e-AMUSEMENT SETTINGS.

It'll bring you to this screen, change it so that e-AMUSEMENT switches to ON and it will look like this:

We will need to set a SHOP NAME SETTING and change our PREFECTURE otherwise the game will throw errors at us.

  • Name your shop to whatever you'd like. Instructions on how to navigate are at the bottom of the screen.
  • Navigate to EXIT and select it.
  • Change your prefecture once or how many times you'd like, it doesn't matter as long as it's not the default one.

Select SAVE AND EXIT. The game will now give you a message, which translated means:

e-AMUSEMENT settings have been changed. Please turn the power off and on again.

So, close the game and open it again.

"},{"location":"games/bemani/iidx/11_red/setup/#final-notes","title":"Final Notes","text":"

You're all done! Make sure to insert two credits by pressing your SERVICE key. Have fun!

Have any other errors?

Check out the Troubleshooting section.

"},{"location":"games/bemani/iidx/11_red/troubleshooting/","title":"beatmania IIDX 11 IIDX RED","text":""},{"location":"games/bemani/iidx/11_red/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

The most common reason for this is the game is running over its required 59.95hz, the game is hardcoded to run at 59.95hz and this cannot be changed. To solve this, check Game resolution and locking FPS of the guide again.

"},{"location":"games/bemani/iidx/11_red/troubleshooting/#im-getting-network-warning-instead-of-network-ok","title":"I'm getting \"NETWORK WARNING\" instead of \"NETWORK OK\"","text":"

This can be caused by:

  • Invalid PCBID
  • Firewall blocking connections
  • Invalid eamuse url or port specified
  • Game is not run using the Administrator account
"},{"location":"games/bemani/iidx/11_red/troubleshooting/#my-background-videos-arent-working","title":"My background videos aren't working!","text":"

You need to install a codec.

  • Open bemanitools-supplement-v1.6.zip and navigate to \\iidx.zip\\iidx\\misc\\ where CLVSD.ax is located.

  • Extract CLVSD.ax inside a folder that you know won't be moved or renamed.

  • Open the command prompt as administrator. Now type regsvr32 \"<location of the file>\\CLVSD.ax\" into the command prompt.

As an example, it could look like this: regsvr32 \"D:\\BEMANI\\IIDX\\CLVSD.ax\"

A prompt should appear telling you that it has been installed successfully. This applies for all styles that require this codec, not just IIDX RED.

If an error occurs, you didn't run the command prompt as administrator or you messed up the location of the file.

You can not move or delete CLVSD.ax at all, otherwise it will revert the changes and you have to install it again.

"},{"location":"games/bemani/iidx/11_red/troubleshooting/#my-game-crashes-immediately","title":"My game crashes immediately!","text":"

This can have multiple reasons. These fixes shouldn't be needed for IIDX RED since we're addressing them in the guide. We'll add them anyway just in case.

"},{"location":"games/bemani/iidx/11_red/troubleshooting/#fix-1-wrong-data-structure","title":"Fix #1 (Wrong data structure)","text":"

Make sure that your unpacked data looks like this:

  • JAx (Game binary revision folder where 'x' can be A, B, C, D, E, F, G)
  • data
  • sidcode.txt

Any other files are optional and don't have to be removed as these are not required to run the game.

"},{"location":"games/bemani/iidx/11_red/troubleshooting/#fix-2-rteffectsdll-didnt-get-replaced","title":"Fix #2 (RtEffects.dll didn't get replaced)","text":"

Refer to Using iidxhook-11.conf & RtEffect.dll again and check if you have followed all the instructions explained in it.

"},{"location":"games/bemani/iidx/12_happysky/setup/","title":"beatmania IIDX 12 HAPPY SKY","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/iidx/12_happysky/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.
"},{"location":"games/bemani/iidx/12_happysky/setup/#installing-bemanitools","title":"Installing Bemanitools","text":"

  • Download Bemanitools.

  • Inside bemanitools-5.48.zip locate iidx-09-to-12.zip.

  • Extract everything inside the folder that contains the bm2dx.exe which is located in \\ECO\\JAD.

Pictured below is what your folder should look like. We've removed any files not necessary for HAPPY SKY.

"},{"location":"games/bemani/iidx/12_happysky/setup/#using-iidxhook-12conf-rteffectdll","title":"Using iidxhook-12.conf & RtEffect.dll","text":"

  • Download the Bemanitools supplements

  • Open bemanitools-supplement-v1.6.zip and navigate inside misc.zip

  • Inside misc\\d3d8to9, extract d3d8.dll to \\ECO\\JAD.

This enables us to use the graphic options inside iidxhook-12.conf which we will take advantage of.

  • Open bemanitools-supplement-v1.6.zip and navigate inside iidx.zip

  • Inside iidx/misc, extract RtEffect_stub.dll to \\ECO\\JAD.

  • Delete the already existing RtEffect.dll and rename RtEffect_stub.dll to RtEffect.dll.

This will eliminate any immediate crashes relating to needing specific old hardware.

"},{"location":"games/bemani/iidx/12_happysky/setup/#installing-clvsdax","title":"Installing CLVSD.ax","text":"

We need to install a codec so that background videos will work and won't cause an error.

  • Open bemanitools-supplement-v1.6.zip and navigate to \\iidx.zip\\iidx\\misc\\ where CLVSD.ax is located.

  • Extract CLVSD.ax inside a folder that you know won't be moved or renamed.

  • Open the command prompt as administrator. Now type regsvr32 \"<location of the file>\\CLVSD.ax\" into the command prompt.

As an example, it could look like this: regsvr32 \"D:\\BEMANI\\IIDX\\CLVSD.ax\"

A prompt should appear telling you that it has been installed successfully. This applies for all styles that require this codec, not just HAPPY SKY.

If an error occurs, you didn't run the command prompt as administrator or you messed up the location of the file.

You can not move or delete CLVSD.ax at all, otherwise it will revert the changes and you have to install it again.

"},{"location":"games/bemani/iidx/12_happysky/setup/#configuring-bemanitools","title":"Configuring Bemanitools","text":"

To configure your keybinds, open your config.bat file.

"},{"location":"games/bemani/iidx/12_happysky/setup/#buttons","title":"Buttons","text":"

Double click on the right on a button that you wish to bind, then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • P1 Game buttons: 1 to 7, Start, EFFECT, VEFX
  • P1 Keypad: Keypad Insert Card

Only if you're playing using a keyboard:

  • Turntable: TT+, TT- and optionally TT+/- which alternates between TT+ and TT- on each press.
"},{"location":"games/bemani/iidx/12_happysky/setup/#analogs-controllercab-only","title":"Analogs (controller/cab only)","text":"

With a controller rather than binding buttons to TT+ and TT-, you need to:

  • Head to the Analogs tab at the top.
  • In Device, pick your controller.
  • In Control, pick whichever one corresponds to the turntable.
  • Turn your turntable ensuring that the preview turns along with it.
  • Click OK, leaving the rest of the settings alone.
"},{"location":"games/bemani/iidx/12_happysky/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through bemanitools.

If it does, here's how you may link different actions to your lights:

  • In Device, pick your controller.
  • In Game Light, select the corresponding button that will be used for that light.
  • Repeat for your other lights.
"},{"location":"games/bemani/iidx/12_happysky/setup/#configuring-bemanitools-for-a-network","title":"Configuring Bemanitools for a network","text":"

Head over to the Network tab.

Now we will set up our PIN pad and card.

  • Click on Keyboard device
  • You may or may not have more than one option. To figure out which one is your actual keyboard, select a device inside that list and press a button on the numpad.
  • Once you have found your correct device, the Keyboard status will change (the number and location of the number does not matter, it only matters that it changed).
  • Grab your card, create a .txt and name it however you like. In this example it's called card.txt
  • Place the file in a location that is easily accessible and you won't forget. In this case it's in a seperate folder.

If you don't have a numpad, make sure to tick Use top keyboard row for PIN pad input. This will also change the Card In button to Backspace.

"},{"location":"games/bemani/iidx/12_happysky/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

  • Locate your iidxhook-12.conf

  • Open it with your desired text editor (we're using Notepad++)

  • Replace the eamuse.server=localhost:80 with your desired network URL

  • Replace eamuse.pcbid=XXXXXXXXXXXXXXXXXXXX and eamuse.eamid=XXXXXXXXXXXXXXXXXXXX with your PCBID of your network of choice.

# URL (e.g. http://my.eamuse.server:80/whatever) or IPV4 (e.g. 127.0.0.1:80) of the target eamuse server. The port is optional but defaults to 80.\neamuse.server=localhost:80\n\n# PCBID\neamuse.pcbid=XXXXXXXXXXXXXXXXXXXX\n\n# EAMID\neamuse.eamid=XXXXXXXXXXXXXXXXXXXX\n
"},{"location":"games/bemani/iidx/12_happysky/setup/#game-resolution-and-locking-fps","title":"Game resolution and locking FPS","text":"

We'd like to mention that there are two options when it comes to how the game renders. You can choose between Linear and Point.

Below is an example of how both look like.

Linear

Point

It comes down to your own prefrence what you decide on, Linear is less sharp but doesn't have pixel perfect edges. Point is sharp and is pixel perfect.

Next up, we'll setup borderless window and configure the proper resolution. We're using a 1920x1080 monitor so we will use that.

Repeat the previous step and open your iidxhook-12.conf. We want to find these lines:

# Software limit the frame rate of the rendering loop in hz, e.g. 60 or 59.95 (0.0 = no software limit)\ngfx.frame_rate_limit=0.0\n\n# Run the game windowed\ngfx.windowed=false\n\n# Windowed width, 0 for default size\ngfx.window_width=0\n\n# Windowed height, 0 for default size\ngfx.window_height=0\n\n# Up-/downscale the back buffer's width. This does not change the game's rendering resolution but scales the final frame. Use this to target the native resolution of your monitor/TV, e.g. to avoid over-/underscan, bad image quality or latency caused by the monitors internal upscaler. 0 to disable this feature. Must be set in combination with the corresponding height parameter.\ngfx.scale_back_buffer_width=0\n\n# Up-/downscale the back buffer's height. This does not change the game's rendering resolution but scales the final frame. Use this to target the native resolution of your monitor/TV, e.g. to avoid over-/underscan, bad image quality or latency caused by the monitors internal upscaler. 0 to disable this feature. Must be set in combination with the corresponding width parameter.\ngfx.scale_back_buffer_height=0\n\n# Filter type to use for up-/downscaling the back buffer. Only used if scaling feature was enabled by setting the scaling width and height parameters. Available types: none, linear, point (refer to D3DTEXTUREFILTERTYPE  for explanation).\ngfx.scale_back_buffer_filter=none\n

If you can't seem to find them, press CTRL + F and search for gfx.frame_rate_limit=0.0. This will bring you to the first line we want to edit.

Listed below are the values we want to change them to.

gfx.frame_rate_limit=59.95\ngfx.windowed=true\ngfx.window_width=1920\ngfx.window_height=1080\ngfx.scale_back_buffer_width=1920\ngfx.scale_back_buffer_height=1080\ngfx.scale_back_buffer_filter=point\n
Unless you'd like to have the game properly windowed you can safely ignore gfx.framed=false.

Make sure to decide on whether you want Linear or Point rendering.

gfx.scale_back_buffer_filter=linear\ngfx.scale_back_buffer_filter=point\n
"},{"location":"games/bemani/iidx/12_happysky/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

"},{"location":"games/bemani/iidx/12_happysky/setup/#backup-data","title":"BACKUP DATA","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run gamestart.bat.

If it's your first time running the game, you'll immediately be greeted with this screen.

Press your Start key to confirm to get to the next error message.

"},{"location":"games/bemani/iidx/12_happysky/setup/#clock-error","title":"CLOCK ERROR","text":"

Press your Start key to confirm. This will bring you into it's service menu.

Instructions on how to navigate the menu are shown at the bottom of the screen.

  • Press 1 and 2 to go up and down.
  • Press 6 to select/execute.

Navigate to CLOCK. You do not need to manually change it. Navigate to SAVE AND EXIT.

"},{"location":"games/bemani/iidx/12_happysky/setup/#enabling-e-amusement-for-online-play","title":"Enabling e-AMUSEMENT for Online Play","text":"

From the service menu, go to NETWORK OPTIONS then e-AMUSEMENT SETTINGS.

It'll bring you to this screen, change it so that e-AMUSEMENT switches to ON and it will look like this:

We will need to set a SHOP NAME SETTING and change our PREFECTURE otherwise the game will throw errors at us.

  • Name your shop to whatever you'd like. Instructions on how to navigate are at the bottom of the screen.
  • Navigate to EXIT and select it.
  • Change your prefecture once or how many times you'd like, it doesn't matter as long as it's not the default one.

Select SAVE AND EXIT. The game will now give you a message, which translated means:

e-AMUSEMENT settings have been changed. Please turn the power off and on again.

So, close the game and open it again.

"},{"location":"games/bemani/iidx/12_happysky/setup/#final-notes","title":"Final Notes","text":"

You're all done! Make sure to insert two credits by pressing your SERVICE key. Have fun!

Have any other errors?

Check out the Troubleshooting section.

"},{"location":"games/bemani/iidx/12_happysky/troubleshooting/","title":"beatmania IIDX 12 HAPPY SKY","text":""},{"location":"games/bemani/iidx/12_happysky/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

The most common reason for this is the game is running over its required 59.95hz, the game is hardcoded to run at 59.95hz and this cannot be changed. To solve this, check Game resolution and locking FPS of the guide again.

"},{"location":"games/bemani/iidx/12_happysky/troubleshooting/#im-getting-network-warning-instead-of-network-ok","title":"I'm getting \"NETWORK WARNING\" instead of \"NETWORK OK\"","text":"

This can be caused by:

  • Invalid PCBID
  • Firewall blocking connections
  • Invalid eamuse url or port specified
  • Game is not run using the Administrator account
"},{"location":"games/bemani/iidx/12_happysky/troubleshooting/#my-background-videos-arent-working","title":"My background videos aren't working!","text":"

You need to install a codec.

  • Open bemanitools-supplement-v1.6.zip and navigate to \\iidx.zip\\iidx\\misc\\ where CLVSD.ax is located.

  • Extract CLVSD.ax inside a folder that you know won't be moved or renamed.

  • Open the command prompt as administrator. Now type regsvr32 \"<location of the file>\\CLVSD.ax\" into the command prompt.

As an example, it could look like this: regsvr32 \"D:\\BEMANI\\IIDX\\CLVSD.ax\"

A prompt should appear telling you that it has been installed successfully. This applies for all styles that require this codec, not just HAPPY SKY.

If an error occurs, you didn't run the command prompt as administrator or you messed up the location of the file.

You can not move or delete CLVSD.ax at all, otherwise it will revert the changes and you have to install it again.

"},{"location":"games/bemani/iidx/12_happysky/troubleshooting/#my-game-crashes-immediately","title":"My game crashes immediately!","text":"

This can have multiple reasons. These fixes shouldn't be needed for HAPPY SKY since we're addressing them in the guide. We'll add them anyway just in case.

"},{"location":"games/bemani/iidx/12_happysky/troubleshooting/#fix-1-wrong-data-structure","title":"Fix #1 (Wrong data structure)","text":"

Make sure that your unpacked data looks like this:

  • JAx (Game binary revision folder where 'x' can be A, B, C, D, E, F, G)
  • data
  • sidcode.txt

Any other files are optional and don't have to be removed as these are not required to run the game.

"},{"location":"games/bemani/iidx/12_happysky/troubleshooting/#fix-2-rteffectsdll-didnt-get-replaced","title":"Fix #2 (RtEffects.dll didn't get replaced)","text":"

Refer to Using iidxhook-12.conf & RtEffect.dll again and check if you have followed all the instructions explained in it.

"},{"location":"games/bemani/iidx/13_distorted/setup/","title":"beatmania IIDX 13 DistorteD","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/iidx/13_distorted/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.
"},{"location":"games/bemani/iidx/13_distorted/setup/#installing-bemanitools","title":"Installing Bemanitools","text":"

  • Download Bemanitools.

  • Inside bemanitools-5.48.zip locate iidx-13.zip.

  • Extract everything inside the folder that contains the bm2dx.exe which is located in \\FDD\\JAG.

Pictured below is what your folder should look like. We've removed any files not necessary for DistorteD.

"},{"location":"games/bemani/iidx/13_distorted/setup/#using-iidxhook-13conf-rteffectdll","title":"Using iidxhook-13.conf & RtEffect.dll","text":"

  • Download the Bemanitools supplements

  • Open bemanitools-supplement-v1.6.zip and navigate inside misc.zip

  • Inside misc\\d3d8to9, extract d3d8.dll to \\FDD\\JAG.

This enables us to use the graphic options inside iidxhook-13.conf which we will take advantage of.

  • Open bemanitools-supplement-v1.6.zip and navigate inside iidx.zip

  • Inside iidx/misc, extract RtEffect_stub.dll to \\FDD\\JAG.

  • Delete the already existing RtEffect.dll and rename RtEffect_stub.dll to RtEffect.dll.

This will eliminate any immediate crashes relating to needing specific old hardware.

"},{"location":"games/bemani/iidx/13_distorted/setup/#installing-clvsdax","title":"Installing CLVSD.ax","text":"

We need to install a codec so that background videos will work and won't cause an error.

  • Open bemanitools-supplement-v1.6.zip and navigate to \\iidx.zip\\iidx\\misc\\ where CLVSD.ax is located.

  • Extract CLVSD.ax inside a folder that you know won't be moved or renamed.

  • Open the command prompt as administrator. Now type regsvr32 \"<location of the file>\\CLVSD.ax\" into the command prompt.

As an example, it could look like this: regsvr32 \"D:\\BEMANI\\IIDX\\CLVSD.ax\"

A prompt should appear telling you that it has been installed successfully. This applies for all styles that require this codec, not just DistorteD.

If an error occurs, you didn't run the command prompt as administrator or you messed up the location of the file.

You can not move or delete CLVSD.ax at all, otherwise it will revert the changes and you have to install it again.

"},{"location":"games/bemani/iidx/13_distorted/setup/#configuring-bemanitools","title":"Configuring Bemanitools","text":"

To configure your keybinds, open your config.bat file.

"},{"location":"games/bemani/iidx/13_distorted/setup/#buttons","title":"Buttons","text":"

Double click on the right on a button that you wish to bind, then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • P1 Game buttons: 1 to 7, Start, EFFECT, VEFX
  • P1 Keypad: Keypad Insert Card

Only if you're playing using a keyboard:

  • Turntable: TT+, TT- and optionally TT+/- which alternates between TT+ and TT- on each press.
"},{"location":"games/bemani/iidx/13_distorted/setup/#analogs-controllercab-only","title":"Analogs (controller/cab only)","text":"

With a controller rather than binding buttons to TT+ and TT-, you need to:

  • Head to the Analogs tab at the top.
  • In Device, pick your controller.
  • In Control, pick whichever one corresponds to the turntable.
  • Turn your turntable ensuring that the preview turns along with it.
  • Click OK, leaving the rest of the settings alone.
"},{"location":"games/bemani/iidx/13_distorted/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through bemanitools.

If it does, here's how you may link different actions to your lights:

  • In Device, pick your controller.
  • In Game Light, select the corresponding button that will be used for that light.
  • Repeat for your other lights.
"},{"location":"games/bemani/iidx/13_distorted/setup/#configuring-bemanitools-for-a-network","title":"Configuring Bemanitools for a network","text":"

Head over to the Network tab.

Now we will set up our PIN pad and card.

  • Click on Keyboard device
  • You may or may not have more than one option. To figure out which one is your actual keyboard, select a device inside that list and press a button on the numpad.
  • Once you have found your correct device, the Keyboard status will change (the number and location of the number does not matter, it only matters that it changed).
  • Grab your card, create a .txt and name it however you like. In this example it's called card.txt
  • Place the file in a location that is easily accessible and you won't forget. In this case it's in a seperate folder.

If you don't have a numpad, make sure to tick Use top keyboard row for PIN pad input. This will also change the Card In button to Backspace.

"},{"location":"games/bemani/iidx/13_distorted/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

  • Locate your iidxhook-13.conf

  • Open it with your desired text editor (we're using Notepad++)

  • Replace the eamuse.server=localhost:80 with your desired network URL

  • Replace eamuse.pcbid=XXXXXXXXXXXXXXXXXXXX and eamuse.eamid=XXXXXXXXXXXXXXXXXXXX with your PCBID of your network of choice.

# URL (e.g. http://my.eamuse.server:80/whatever) or IPV4 (e.g. 127.0.0.1:80) of the target eamuse server. The port is optional but defaults to 80.\neamuse.server=localhost:80\n\n# PCBID\neamuse.pcbid=XXXXXXXXXXXXXXXXXXXX\n\n# EAMID\neamuse.eamid=XXXXXXXXXXXXXXXXXXXX\n
"},{"location":"games/bemani/iidx/13_distorted/setup/#game-resolution-and-locking-fps","title":"Game resolution and locking FPS","text":"

We'd like to mention that there are two options when it comes to how the game renders. You can choose between Linear and Point.

Below is an example of how both look like.

Linear

Point

It comes down to your own prefrence what you decide on, Linear is less sharp but doesn't have pixel perfect edges. Point is sharp and is pixel perfect.

Next up, we'll setup borderless window and configure the proper resolution. We're using a 1920x1080 monitor so we will use that.

Repeat the previous step and open your iidxhook-12.conf. We want to find these lines:

# Software limit the frame rate of the rendering loop in hz, e.g. 60 or 59.95 (0.0 = no software limit)\ngfx.frame_rate_limit=0.0\n\n# Run the game windowed\ngfx.windowed=false\n\n# Windowed width, 0 for default size\ngfx.window_width=0\n\n# Windowed height, 0 for default size\ngfx.window_height=0\n\n# Up-/downscale the back buffer's width. This does not change the game's rendering resolution but scales the final frame. Use this to target the native resolution of your monitor/TV, e.g. to avoid over-/underscan, bad image quality or latency caused by the monitors internal upscaler. 0 to disable this feature. Must be set in combination with the corresponding height parameter.\ngfx.scale_back_buffer_width=0\n\n# Up-/downscale the back buffer's height. This does not change the game's rendering resolution but scales the final frame. Use this to target the native resolution of your monitor/TV, e.g. to avoid over-/underscan, bad image quality or latency caused by the monitors internal upscaler. 0 to disable this feature. Must be set in combination with the corresponding width parameter.\ngfx.scale_back_buffer_height=0\n\n# Filter type to use for up-/downscaling the back buffer. Only used if scaling feature was enabled by setting the scaling width and height parameters. Available types: none, linear, point (refer to D3DTEXTUREFILTERTYPE  for explanation).\ngfx.scale_back_buffer_filter=none\n

If you can't seem to find them, press CTRL + F and search for gfx.frame_rate_limit=0.0. This will bring you to the first line we want to edit.

Listed below are the values we want to change them to.

gfx.frame_rate_limit=59.95\ngfx.windowed=true\ngfx.window_width=1920\ngfx.window_height=1080\ngfx.scale_back_buffer_width=1920\ngfx.scale_back_buffer_height=1080\ngfx.scale_back_buffer_filter=linear\n
Unless you'd like to have the game properly windowed you can safely ignore gfx.framed=false.

Make sure to decide on whether you want Linear or Point rendering.

gfx.scale_back_buffer_filter=linear\ngfx.scale_back_buffer_filter=point\n
"},{"location":"games/bemani/iidx/13_distorted/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

"},{"location":"games/bemani/iidx/13_distorted/setup/#backup-data","title":"BACKUP DATA","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run gamestart.bat.

If it's your first time running the game, you'll immediately be greeted with this screen.

Press your Test key to confirm to get to the next error message.

"},{"location":"games/bemani/iidx/13_distorted/setup/#clock-error","title":"CLOCK ERROR","text":"

Press your Test key to confirm. This will bring you into it's service menu.

Instructions on how to navigate the menu are shown at the bottom of the screen.

  • Press 1 and 2 to go up and down.
  • Press 6 to select/execute.

Navigate to CLOCK. You do not need to manually change it. Navigate to SAVE AND EXIT.

"},{"location":"games/bemani/iidx/13_distorted/setup/#enabling-e-amusement-for-online-play","title":"Enabling e-AMUSEMENT for Online Play","text":"

From the service menu, go to NETWORK OPTIONS then e-AMUSEMENT SETTINGS.

It'll bring you to this screen, change it so that e-AMUSEMENT switches to ON and it will look like this:

We will need to set a SHOP NAME SETTING and change our PREFECTURE otherwise the game will throw errors at us.

  • Name your shop to whatever you'd like. Instructions on how to navigate are at the bottom of the screen.
  • Navigate to EXIT and select it.
  • Change your prefecture once or how many times you'd like, it doesn't matter as long as it's not the default one.

Select SAVE AND EXIT. The game will now give you a message, which translated means:

e-AMUSEMENT settings have been changed. Please turn the power off and on again.

So, close the game and open it again.

"},{"location":"games/bemani/iidx/13_distorted/setup/#final-notes","title":"Final Notes","text":"

You're all done! Make sure to insert two credits by pressing your SERVICE key. Have fun!

Have any other errors?

Check out the Troubleshooting section.

"},{"location":"games/bemani/iidx/13_distorted/troubleshooting/","title":"beatmania IIDX 13 DistorteD","text":""},{"location":"games/bemani/iidx/13_distorted/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

The most common reason for this is the game is running over its required 59.95hz, the game is hardcoded to run at 59.95hz and this cannot be changed. To solve this, check Game resolution and locking FPS of the guide again.

"},{"location":"games/bemani/iidx/13_distorted/troubleshooting/#im-getting-network-warning-instead-of-network-ok","title":"I'm getting \"NETWORK WARNING\" instead of \"NETWORK OK\"","text":"

This can be caused by:

  • Invalid PCBID
  • Firewall blocking connections
  • Invalid eamuse url or port specified
  • Game is not run using the Administrator account
"},{"location":"games/bemani/iidx/13_distorted/troubleshooting/#my-background-videos-arent-working","title":"My background videos aren't working!","text":"

You need to install a codec.

  • Open bemanitools-supplement-v1.6.zip and navigate to \\iidx.zip\\iidx\\misc\\ where CLVSD.ax is located.

  • Extract CLVSD.ax inside a folder that you know won't be moved or renamed.

  • Open the command prompt as administrator. Now type regsvr32 \"<location of the file>\\CLVSD.ax\" into the command prompt.

As an example, it could look like this: regsvr32 \"D:\\BEMANI\\IIDX\\CLVSD.ax\"

A prompt should appear telling you that it has been installed successfully. This applies for all styles that require this codec, not just DistorteD.

If an error occurs, you didn't run the command prompt as administrator or you messed up the location of the file.

You can not move or delete CLVSD.ax at all, otherwise it will revert the changes and you have to install it again.

"},{"location":"games/bemani/iidx/13_distorted/troubleshooting/#my-game-crashes-immediately","title":"My game crashes immediately!","text":"

This can have multiple reasons. These fixes shouldn't be needed for DistorteD since we're addressing them in the guide. We'll add them anyway just in case.

"},{"location":"games/bemani/iidx/13_distorted/troubleshooting/#fix-1-wrong-data-structure","title":"Fix #1 (Wrong data structure)","text":"

Make sure that your unpacked data looks like this:

  • JAx (Game binary revision folder where 'x' can be A, B, C, D, E, F, G)
  • data
  • sidcode.txt

Any other files are optional and don't have to be removed as these are not required to run the game.

"},{"location":"games/bemani/iidx/13_distorted/troubleshooting/#fix-2-rteffectsdll-didnt-get-replaced","title":"Fix #2 (RtEffects.dll didn't get replaced)","text":"

Refer to Using iidxhook-13.conf & RtEffect.dll again and check if you have followed all the instructions explained in it.

"},{"location":"games/bemani/iidx/14_gold/setup/","title":"beatmania IIDX 14 GOLD","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/iidx/14_gold/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.
"},{"location":"games/bemani/iidx/14_gold/setup/#installing-bemanitools","title":"Installing Bemanitools","text":"

  • Download Bemanitools.

  • Inside bemanitools-5.48.zip locate iidx-14-to-17.zip.

  • Extract everything inside the folder that contains the bm2dx.exe which is located in \\GLD\\2007072301.

Pictured below is what your folder should look like. We've removed any files not necessary for GOLD.

"},{"location":"games/bemani/iidx/14_gold/setup/#using-iidxhook-14conf","title":"Using iidxhook-14.conf","text":"

  • Download the Bemanitools supplements

  • Open bemanitools-supplement-v1.6.zip and navigate inside misc.zip

  • Inside misc\\d3d8to9, extract d3d8.dll to \\GLD\\2007072301.

This enables us to use the graphic options inside iidxhook-14.conf which we will take advantage of.

"},{"location":"games/bemani/iidx/14_gold/setup/#installing-clvsdax","title":"Installing CLVSD.ax","text":"

We need to install a codec so that background videos will work and won't cause an error.

  • Open bemanitools-supplement-v1.6.zip and navigate to \\iidx.zip\\iidx\\misc\\ where CLVSD.ax is located.

  • Extract CLVSD.ax inside a folder that you know won't be moved or renamed.

  • Open the command prompt as administrator. Now type regsvr32 \"<location of the file>\\CLVSD.ax\" into the command prompt.

As an example, it could look like this: regsvr32 \"D:\\BEMANI\\IIDX\\CLVSD.ax\"

A prompt should appear telling you that it has been installed successfully. This applies for all styles that require this codec, not just GOLD.

If an error occurs, you didn't run the command prompt as administrator or you messed up the location of the file.

You can not move or delete CLVSD.ax at all, otherwise it will revert the changes and you have to install it again.

"},{"location":"games/bemani/iidx/14_gold/setup/#configuring-bemanitools","title":"Configuring Bemanitools","text":"

To configure your keybinds, open your config.bat file.

"},{"location":"games/bemani/iidx/14_gold/setup/#buttons","title":"Buttons","text":"

Double click on the right on a button that you wish to bind, then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • P1 Game buttons: 1 to 7, Start, EFFECT, VEFX
  • P1 Keypad: Keypad Insert Card

Only if you're playing using a keyboard:

  • Turntable: TT+, TT- and optionally TT+/- which alternates between TT+ and TT- on each press.
"},{"location":"games/bemani/iidx/14_gold/setup/#analogs-controllercab-only","title":"Analogs (controller/cab only)","text":"

With a controller rather than binding buttons to TT+ and TT-, you need to:

  • Head to the Analogs tab at the top.
  • In Device, pick your controller.
  • In Control, pick whichever one corresponds to the turntable.
  • Turn your turntable ensuring that the preview turns along with it.
  • Click OK, leaving the rest of the settings alone.
"},{"location":"games/bemani/iidx/14_gold/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through bemanitools.

If it does, here's how you may link different actions to your lights:

  • In Device, pick your controller.
  • In Game Light, select the corresponding button that will be used for that light.
  • Repeat for your other lights.
"},{"location":"games/bemani/iidx/14_gold/setup/#configuring-bemanitools-for-a-network","title":"Configuring Bemanitools for a network","text":"

Head over to the Network tab.

Now we will set up our PIN pad and card.

  • Click on Keyboard device
  • You may or may not have more than one option. To figure out which one is your actual keyboard, select a device inside that list and press a button on the numpad.
  • Once you have found your correct device, the Keyboard status will change (the number and location of the number does not matter, it only matters that it changed).
  • Grab your card, create a .txt and name it however you like. In this example it's called card.txt
  • Place the file in a location that is easily accessible and you won't forget. In this case it's in a seperate folder.

If you don't have a numpad, make sure to tick Use top keyboard row for PIN pad input. This will also change the Card In button to Backspace.

"},{"location":"games/bemani/iidx/14_gold/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

  • Locate your iidxhook-14.conf

  • Open it with your desired text editor (we're using Notepad++)

  • Replace the eamuse.server=localhost:80 with your desired network URL

  • Replace eamuse.pcbid=XXXXXXXXXXXXXXXXXXXX and eamuse.eamid=XXXXXXXXXXXXXXXXXXXX with your PCBID of your network of choice.

# URL (e.g. http://my.eamuse.server:80/whatever) or IPV4 (e.g. 127.0.0.1:80) of the target eamuse server. The port is optional but defaults to 80.\neamuse.server=localhost:80\n\n# PCBID\neamuse.pcbid=XXXXXXXXXXXXXXXXXXXX\n\n# EAMID\neamuse.eamid=XXXXXXXXXXXXXXXXXXXX\n
"},{"location":"games/bemani/iidx/14_gold/setup/#game-resolution-and-locking-fps","title":"Game resolution and locking FPS","text":"

We'd like to mention that there are two options when it comes to how the game renders. You can choose between Linear and Point.

Below is an example of how both look like.

Linear

Point

It comes down to your own prefrence what you decide on, Linear is less sharp but doesn't have pixel perfect edges. Point is sharp and is pixel perfect.

Next up, we'll setup borderless window and configure the proper resolution. We're using a 1920x1080 monitor so we will use that.

Repeat the previous step and open your iidxhook-14.conf. We want to find these lines:

# Software limit the frame rate of the rendering loop in hz, e.g. 60 or 59.95 (0.0 = no software limit)\ngfx.frame_rate_limit=0.0\n\n# Run the game windowed\ngfx.windowed=false\n\n# Windowed width, 0 for default size\ngfx.window_width=0\n\n# Windowed height, 0 for default size\ngfx.window_height=0\n\n# Up-/downscale the back buffer's width. This does not change the game's rendering resolution but scales the final frame. Use this to target the native resolution of your monitor/TV, e.g. to avoid over-/underscan, bad image quality or latency caused by the monitors internal upscaler. 0 to disable this feature. Must be set in combination with the corresponding height parameter.\ngfx.scale_back_buffer_width=0\n\n# Up-/downscale the back buffer's height. This does not change the game's rendering resolution but scales the final frame. Use this to target the native resolution of your monitor/TV, e.g. to avoid over-/underscan, bad image quality or latency caused by the monitors internal upscaler. 0 to disable this feature. Must be set in combination with the corresponding width parameter.\ngfx.scale_back_buffer_height=0\n\n# Filter type to use for up-/downscaling the back buffer. Only used if scaling feature was enabled by setting the scaling width and height parameters. Available types: none, linear, point (refer to D3DTEXTUREFILTERTYPE  for explanation).\ngfx.scale_back_buffer_filter=none\n

If you can't seem to find them, press CTRL + F and search for gfx.frame_rate_limit=0.0. This will bring you to the first line we want to edit.

Listed below are the values we want to change them to.

gfx.frame_rate_limit=59.95\ngfx.windowed=true\ngfx.window_width=1920\ngfx.window_height=1080\ngfx.scale_back_buffer_width=1920\ngfx.scale_back_buffer_height=1080\ngfx.scale_back_buffer_filter=linear\n
Unless you'd like to have the game properly windowed you can safely ignore gfx.framed=false.

Make sure to decide on whether you want Linear or Point rendering.

gfx.scale_back_buffer_filter=linear\ngfx.scale_back_buffer_filter=point\n
"},{"location":"games/bemani/iidx/14_gold/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

"},{"location":"games/bemani/iidx/14_gold/setup/#backup-data","title":"BACKUP DATA","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run gamestart.bat.

If it's your first time running the game, you'll immediately be greeted with this screen.

If you get USB I/O ERROR ERROR(FM TRNS-OUT) or USB I/O ERROR ERROR(FM-DL TIMEOUT)

Reboot the game and it should get fixed.

Press your Test key to confirm to get to the next error message.

"},{"location":"games/bemani/iidx/14_gold/setup/#clock-error","title":"CLOCK ERROR","text":"

Press your Test key to confirm. The game will then perform a MONITOR CHECK.

After the monitor check, the game will bring you into it's service menu.

Instructions on how to navigate the menu are shown at the bottom of the screen.

  • Press 1 and 2 to go up and down.
  • Press 6 to select/execute.

Navigate to CLOCK. You do not need to manually change it. Navigate to SAVE AND EXIT.

"},{"location":"games/bemani/iidx/14_gold/setup/#enabling-e-amusement-for-online-play","title":"Enabling e-AMUSEMENT for Online Play","text":"

From the service menu, go to NETWORK OPTIONS then e-AMUSEMENT SETTINGS.

We will need to set a SHOP NAME SETTING and change our SETTING AREA otherwise the game will throw errors at us.

  • Name your shop to whatever you'd like. Instructions on how to navigate are at the bottom of the screen.
  • Navigate to EXIT and select it.
  • Change your SETTING AREA once or how many times you'd like, it doesn't matter as long as it's not the default one.

Select SAVE AND EXIT.

"},{"location":"games/bemani/iidx/14_gold/setup/#final-notes","title":"Final Notes","text":"

You're all done! From the service menu select GAMEMODE and the game should load ready to be played. Make sure to insert two credits by pressing your SERVICE key. Have fun!

Have any other errors?

Check out the Troubleshooting section.

"},{"location":"games/bemani/iidx/14_gold/troubleshooting/","title":"beatmania IIDX 14 GOLD","text":""},{"location":"games/bemani/iidx/14_gold/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

The most common reason for this is the game is running over its required 59.95hz, the game is hardcoded to run at 59.95hz and this cannot be changed. To solve this, check Game resolution and locking FPS of the guide again.

"},{"location":"games/bemani/iidx/14_gold/troubleshooting/#im-getting-network-warning-instead-of-network-ok","title":"I'm getting \"NETWORK WARNING\" instead of \"NETWORK OK\"","text":"

This can be caused by:

  • Invalid PCBID
  • Firewall blocking connections
  • Invalid eamuse url or port specified
  • Game is not run using the Administrator account
"},{"location":"games/bemani/iidx/14_gold/troubleshooting/#my-background-videos-arent-working","title":"My background videos aren't working!","text":"

You need to install a codec.

  • Open bemanitools-supplement-v1.6.zip and navigate to \\iidx.zip\\iidx\\misc\\ where CLVSD.ax is located.

  • Extract CLVSD.ax inside a folder that you know won't be moved or renamed.

  • Open the command prompt as administrator. Now type regsvr32 \"<location of the file>\\CLVSD.ax\" into the command prompt.

As an example, it could look like this: regsvr32 \"D:\\BEMANI\\IIDX\\CLVSD.ax\"

A prompt should appear telling you that it has been installed successfully. This applies for all styles that require this codec, not just GOLD.

If an error occurs, you didn't run the command prompt as administrator or you messed up the location of the file.

You can not move or delete CLVSD.ax at all, otherwise it will revert the changes and you have to install it again.

"},{"location":"games/bemani/iidx/14_gold/troubleshooting/#my-game-crashes-immediately","title":"My game crashes immediately!","text":"

This can have multiple reasons. This fix shouldn't be needed for GOLD since we're addressing them in the guide. We'll add it anyway just in case.

"},{"location":"games/bemani/iidx/14_gold/troubleshooting/#wrong-data-structure","title":"Wrong data structure","text":"

Make sure that your unpacked data looks like this:

  • yyyymmddrr (y = year digit, m = month digit, d = day digit, r = revision digit) revision folder containing game binary and libraries
  • data
  • sidcode.txt

Any other files are optional and don't have to be removed as these are not required to run the game.

"},{"location":"games/bemani/iidx/24_sinobuz/setup/","title":"beatmania IIDX 24 SINOBUZ","text":"

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.

Note:

This game uses 32-bit tools!

"},{"location":"games/bemani/iidx/24_sinobuz/setup/#getting-started","title":"Getting Started","text":"

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 whatever you desire, for the sake of convenience we've named ours gamestart.bat.

"},{"location":"games/bemani/iidx/24_sinobuz/setup/#configuring-your-tools","title":"Configuring Your Tools","text":"

Now that you have your files ready, open up your .bat file in your desired text editor (we're using Notepad++) 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.

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.

"},{"location":"games/bemani/iidx/24_sinobuz/setup/#configuring-for-a-local-network","title":"Configuring for a Local Network","text":"

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++.

"},{"location":"games/bemani/iidx/24_sinobuz/setup/#configuring-for-an-online-network","title":"Configuring for an Online Network","text":"

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++.

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.

"},{"location":"games/bemani/iidx/24_sinobuz/setup/#final-steps-and-setting-up-the-game","title":"Final Steps and Setting up the Game","text":"

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.

Hit the Test keybinding to initialize the backup data, a message will pop up stating it's been initialized.

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.

Start by navigating up to CLOCK and entering that menu.

Simply hit save and exit and leave, the clock will be saved. Then, back in the service menu, go up to GAME OPTIONS

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.

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.

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.

You're all done! From the service menu select GAME MODE and the game should load ready to be played! Have fun!

Have any other errors?

Check out the Troubleshooting section and Error Code section to resolve any issues not seen in this guide to greater depth.

"},{"location":"games/bemani/iidx/24_sinobuz/troubleshooting/","title":"beatmania IIDX 24 SINOBUZ","text":""},{"location":"games/bemani/iidx/24_sinobuz/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

Warning:

The specs may not be correct. If something isn't correct or it's fine, let me know.

Bemani PC (ADE-704A)

Konami (2012-2017)

This board has a E4690 Radeon MXM card.

CPU: Intel Celeron B810

GPU: AMD Radeon E4690

NIC: Realtek RTL8168/8111

Chipset: Intel HM65

RAM: 4 GB

OS: Windows XP Embedded with Service Pack 2

"},{"location":"games/bemani/iidx/24_sinobuz/troubleshooting/#my-game-is-running-slowlagging","title":"My Game Is Running Slow/Lagging","text":"

Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.

"},{"location":"games/bemani/iidx/24_sinobuz/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

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.

"},{"location":"games/bemani/iidx/24_sinobuz/troubleshooting/#occasional-game-stutters-during-play","title":"Occasional Game Stutters During Play","text":"

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.

"},{"location":"games/bemani/iidx/24_sinobuz/troubleshooting/#hd-and-hd","title":"HD and HD*","text":"

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.

"},{"location":"games/bemani/iidx/24_sinobuz/troubleshooting/#which-offset-is-which","title":"Which Offset Is Which?","text":"

If you're getting too many fasts, increase your offset (+). If you're getting too many slows, decrease your offset (-).

"},{"location":"games/bemani/iidx/25_cannonballers/setup/","title":"beatmania IIDX 25 CANNON BALLERS","text":"

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.

"},{"location":"games/bemani/iidx/25_cannonballers/setup/#getting-started","title":"Getting Started","text":"

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.

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.

"},{"location":"games/bemani/iidx/25_cannonballers/setup/#configuring-your-tools","title":"Configuring Your Tools","text":"

Now that you have your files ready, open up your .bat file in your desired text editor (we're using Notepad++) 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.

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.

"},{"location":"games/bemani/iidx/25_cannonballers/setup/#configuring-for-a-local-network","title":"Configuring for a Local Network","text":"

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++.

"},{"location":"games/bemani/iidx/25_cannonballers/setup/#configuring-for-an-online-network","title":"Configuring for an Online Network","text":"

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++.

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.

"},{"location":"games/bemani/iidx/25_cannonballers/setup/#final-steps-and-setting-up-the-game","title":"Final Steps and Setting up the Game","text":"

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!

Ignore this message, simply hit your Test keybind and continue onto this.

Hit the Test keybinding again to initialize the backup data, a message will pop up stating it's been initialized.

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.

Start by navigating up to CLOCK and entering that menu.

Simply hit save and exit and leave, the clock will be saved. Then, back in the service menu, go up to GAME OPTIONS

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.

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.

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.

You're all done! From the service menu select GAME MODE and the game should load ready to be played! Have fun!

Have any other errors?

Check out the Troubleshooting section and Error Code section to resolve any issues not seen in this guide to greater depth.

"},{"location":"games/bemani/iidx/25_cannonballers/troubleshooting/","title":"beatmania IIDX 25 CANNON BALLERS","text":""},{"location":"games/bemani/iidx/25_cannonballers/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

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

"},{"location":"games/bemani/iidx/25_cannonballers/troubleshooting/#my-game-is-running-slowlagging","title":"My Game Is Running Slow/Lagging","text":"

Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.

"},{"location":"games/bemani/iidx/25_cannonballers/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

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.

"},{"location":"games/bemani/iidx/25_cannonballers/troubleshooting/#camera-device-error-message","title":"Camera Device Error Message","text":"

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 patch.

"},{"location":"games/bemani/iidx/25_cannonballers/troubleshooting/#occasional-game-stutters-during-play","title":"Occasional Game Stutters During Play","text":"

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.

"},{"location":"games/bemani/iidx/25_cannonballers/troubleshooting/#hd-and-hd","title":"HD and HD*","text":"

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.

"},{"location":"games/bemani/iidx/25_cannonballers/troubleshooting/#which-offset-is-which","title":"Which Offset Is Which?","text":"

If you're getting too many fasts, increase your offset (+). If you're getting too many slows, decrease your offset (-).

"},{"location":"games/bemani/iidx/25_cannonballers/troubleshooting/#a-note-about-sse-42","title":"A Note About SSE 4.2","text":"

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. But, in the event your processor does not have this, there is a patch available to bypass this.

"},{"location":"games/bemani/iidx/25_cannonballers/troubleshooting/#when-i-run-this-game-all-other-background-audio-is-gone-whats-going-on","title":"When I Run This Game All Other Background Audio Is Gone! What's Going On?","text":"

64-bit versions of IIDX are now utilizing a feature in Windows called WASAPI exclusive mode to obtain less audio latency than the former 32-bit versions of the games which used DirectSound. Unfortunately, this cannot be changed.

"},{"location":"games/bemani/iidx/25_cannonballers/troubleshooting/#im-not-getting-any-audiomy-audio-is-completely-wrecked-and-im-using-an-external-dac","title":"I'm Not Getting Any Audio/My Audio Is Completely Wrecked and I'm Using an External Dac!","text":"

Several external DACs have issues with WASAPI exclusive mode 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.

"},{"location":"games/bemani/iidx/26_rootage/setup/","title":"beatmania IIDX 26 Rootage","text":"

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.

"},{"location":"games/bemani/iidx/26_rootage/setup/#getting-started","title":"Getting Started","text":"

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.

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.

"},{"location":"games/bemani/iidx/26_rootage/setup/#configuring-your-tools","title":"Configuring Your Tools","text":"

Now that you have your files ready, open up your .bat file in your desired text editor (we're using Notepad++) 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.

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.

"},{"location":"games/bemani/iidx/26_rootage/setup/#configuring-for-a-local-network","title":"Configuring for a Local Network","text":"

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++.

"},{"location":"games/bemani/iidx/26_rootage/setup/#configuring-for-an-online-network","title":"Configuring for an Online Network","text":"

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++.

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.

"},{"location":"games/bemani/iidx/26_rootage/setup/#final-steps-and-setting-up-the-game","title":"Final Steps and Setting up the Game","text":"

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!

Ignore this message, simply hit your Test keybind and continue onto this.

Hit the Test keybinding again to initialize the backup data, a message will pop up stating it's been initialized.

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.

Start by navigating up to CLOCK and entering that menu.

Simply hit save and exit and leave, the clock will be saved. Then, back in the service menu, go up to GAME OPTIONS

Once inside that menu, navigate your way up to DEFINITION TYPE and choose either SD or HD depending on your preferences.

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.

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.

You're all done! From the service menu select GAME MODE and the game should load ready to be played! Have fun!

Have any other errors?

Check out the Troubleshooting section and Error Code section to resolve any issues not seen in this guide to greater depth.

"},{"location":"games/bemani/iidx/26_rootage/troubleshooting/","title":"beatmania IIDX 26 Rootage","text":""},{"location":"games/bemani/iidx/26_rootage/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

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

"},{"location":"games/bemani/iidx/26_rootage/troubleshooting/#my-game-is-running-slowlagging","title":"My Game Is Running Slow/Lagging","text":"

Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.

"},{"location":"games/bemani/iidx/26_rootage/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

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.

"},{"location":"games/bemani/iidx/26_rootage/troubleshooting/#camera-device-error-message","title":"Camera Device Error Message","text":"

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 patch.

"},{"location":"games/bemani/iidx/26_rootage/troubleshooting/#occasional-game-stutters-during-play","title":"Occasional Game Stutters During Play","text":"

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.

"},{"location":"games/bemani/iidx/26_rootage/troubleshooting/#hd-and-hd","title":"HD and HD*","text":"

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.

"},{"location":"games/bemani/iidx/26_rootage/troubleshooting/#which-offset-is-which","title":"Which Offset Is Which?","text":"

If you're getting too many fasts, increase your offset (+). If you're getting too many slows, decrease your offset (-).

"},{"location":"games/bemani/iidx/26_rootage/troubleshooting/#a-note-about-sse-42","title":"A Note About SSE 4.2","text":"

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. But, in the event your processor does not have this, there is a patch available to bypass this.

"},{"location":"games/bemani/iidx/26_rootage/troubleshooting/#when-i-run-this-game-all-other-background-audio-is-gone-whats-going-on","title":"When I Run This Game All Other Background Audio Is Gone! What's Going On?","text":"

64-bit versions of IIDX are now utilizing a feature in Windows called WASAPI exclusive mode to obtain less audio latency than the former 32-bit versions of the games which used DirectSound. Unfortunately, this cannot be changed.

"},{"location":"games/bemani/iidx/26_rootage/troubleshooting/#im-not-getting-any-audiomy-audio-is-completely-wrecked-and-im-using-an-external-dac","title":"I'm Not Getting Any Audio/My Audio Is Completely Wrecked and I'm Using an External Dac!","text":"

Several external DACs have issues with WASAPI exclusive mode 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.

"},{"location":"games/bemani/iidx/27_heroicverse/lightning/","title":"beatmania IIDX 27 Heroic Verse","text":""},{"location":"games/bemani/iidx/27_heroicverse/lightning/#notes","title":"Notes","text":"

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 patch.

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.

"},{"location":"games/bemani/iidx/27_heroicverse/lightning/#lightning-specific-troubleshooting","title":"Lightning-specific Troubleshooting","text":"

Below are the two main issues that have arisen for users utilizing this guide and general startup practices.

"},{"location":"games/bemani/iidx/27_heroicverse/lightning/#hardware-specs","title":"Hardware Specs","text":"

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

"},{"location":"games/bemani/iidx/27_heroicverse/lightning/#enabling-lighting-mode-patch","title":"Enabling Lighting Mode Patch","text":"

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.

"},{"location":"games/bemani/iidx/27_heroicverse/lightning/#audio-related-crash","title":"Audio Related Crash","text":"

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

"},{"location":"games/bemani/iidx/27_heroicverse/setup/","title":"beatmania IIDX 27 Heroic Verse","text":"

Author Note:

Lightning mode specifics: they are found here

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.

"},{"location":"games/bemani/iidx/27_heroicverse/setup/#getting-started","title":"Getting Started","text":"

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.

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.

"},{"location":"games/bemani/iidx/27_heroicverse/setup/#configuring-your-tools","title":"Configuring Your Tools","text":"

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.

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.

"},{"location":"games/bemani/iidx/27_heroicverse/setup/#configuring-for-a-local-network","title":"Configuring for a Local Network","text":"

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.

"},{"location":"games/bemani/iidx/27_heroicverse/setup/#configuring-for-an-online-network","title":"Configuring for an Online Network","text":"

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.

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.

"},{"location":"games/bemani/iidx/27_heroicverse/setup/#final-steps-and-setting-up-the-game","title":"Final Steps and Setting up the Game","text":"

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! 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 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!

Ignore this message, simply hit your Test keybind and continue onto this.

Hit the Test keybinding to initialize the backup data, a message will pop up stating it's been initialized.

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.

Start by navigating up to CLOCK and entering that menu.

Simply hit save and exit and leave, the clock will be saved. Then, back in the service menu, go up to GAME OPTIONS

Once inside that menu, navigate your way up to DEFINITION TYPE and choose either SD or HD depending on your preferences.

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.

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.

You're all done! From the service menu select GAME MODE and the game should load ready to be played! Have fun!

Have any other errors?

Check out the Troubleshooting section and Error Code section to resolve any issues not seen in this guide to greater depth.

Lightning Mode specifics can be found: here

"},{"location":"games/bemani/iidx/27_heroicverse/troubleshooting/","title":"beatmania IIDX 27 Heroic Verse","text":"

Author Note:

For lightning specific issues, see lightning cab notes

"},{"location":"games/bemani/iidx/27_heroicverse/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

(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

"},{"location":"games/bemani/iidx/27_heroicverse/troubleshooting/#my-game-is-running-slowlagging","title":"My Game Is Running Slow/Lagging","text":"

Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.

"},{"location":"games/bemani/iidx/27_heroicverse/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

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.

"},{"location":"games/bemani/iidx/27_heroicverse/troubleshooting/#occasional-game-stutters-during-play","title":"Occasional Game Stutters During Play","text":"

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.

"},{"location":"games/bemani/iidx/27_heroicverse/troubleshooting/#which-offset-is-which","title":"Which Offset Is Which?","text":"

If you're getting too many fasts, increase your offset (+). If you're getting too many slows, decrease your offset (-).

"},{"location":"games/bemani/iidx/27_heroicverse/troubleshooting/#a-note-about-sse-42","title":"A Note About SSE 4.2","text":"

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. But, in the event your processor does not have this, there is a patch available to bypass this.

"},{"location":"games/bemani/iidx/27_heroicverse/troubleshooting/#when-i-run-this-game-all-other-background-audio-is-gone-whats-going-on","title":"When I Run This Game All Other Background Audio Is Gone! What's Going On?","text":"

64-bit versions of IIDX are now utilizing a feature in Windows called WASAPI exclusive mode to obtain less audio latency than the former 32-bit versions of the games which used DirectSound. Unfortunately, this cannot be changed.

"},{"location":"games/bemani/iidx/27_heroicverse/troubleshooting/#im-not-getting-any-audiomy-audio-is-completely-wrecked-and-im-using-an-external-dac","title":"I'm Not Getting Any Audio/My Audio Is Completely Wrecked and I'm Using an External Dac!","text":"

Several external DACs have issues with WASAPI exclusive mode 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.

"},{"location":"games/bemani/iidx/30_resident/extras/","title":"beatmania IIDX 30 RESIDENT","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/iidx/30_resident/extras/#standard-lightning-modes","title":"Standard & Lightning modes","text":"

Lightning mode requires a 120hz capable monitor.

To make use of the Lightning Mode, which unlocks the subscreen and 120FPS, we need to go to the contents\\prop folder and edit the ea3-config.xml file.

We're interested in these lines:

    <soft>\n        <model __type=\"str\">LDJ</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">A</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2023090500</ext>\n    </soft>\n

This is the line that determines if the game will run in Standard (60 FPS) or Lightning (120 FPS) mode.

<spec __type=\"str\">A</spec>\n
  • A for Standard (LDJ-003, LDJ, 60hz)
  • D for Lightning (LDJ-010, TDJ, 120hz)
"},{"location":"games/bemani/iidx/30_resident/extras/#changing-the-games-language","title":"Changing the game's language","text":"

This is done in-game before card-in by pressing your EFFECT key.

"},{"location":"games/bemani/iidx/30_resident/extras/#more-about-ea3-configxml","title":"More about ea3-config.xml","text":"

The ea3-config.xml file is located inside the prop folder.

Below is an explanation on what different sections of this file do.

The following lines change the PCBID and HARDID that your system reports to your e-amusement server. There is no need to manually change this as spice2x will do it for us.

<pcbid __type=\"str\">00010203040506070809</pcbid>\n<hardid __type=\"str\">00010203040506070809</hardid>\n

The following line determines what version of the game you are running. You should never change this. It should always say LDJ.

<model __type=\"str\">LDJ</model>\n

The following line determines the game's region. You should never change this. As you can change the language in-game.

<dest __type=\"str\">J</dest>\n

You should never change this. It should always say A for Resident.

<rev __type=\"str\">A</rev>\n

The following line determines your datecode. Always keep it up to date with your game's current version.

<ext __type=\"str\">2024052100</ext>\n

The following line determine what remote service URL spice2x is supposed to connect to. There is no need to manually change this as spice2x will do it for us.

<services __type=\"str\">http://localhost:8083</services>\n
"},{"location":"games/bemani/iidx/30_resident/setup/","title":"beatmania IIDX 30 RESIDENT","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/iidx/30_resident/setup/#about-data","title":"About data","text":"

Standard (LDJ) / Lightning (TDJ)

Please keep the following in mind as you're going through this guide.

IIDX's codename is LDJ. For IIDX 30 Resident it typically is LDJ-003.

Two versions of the game exist:

  • TDJ expects a 120hz compatible monitor for its main screen, and a second 60hz touchscreen compatible monitor called a subscreen. The second monitor isn't mandatory, we can get around that using spice2x.
  • LDJ expects 60hz monitor for its main screen, and no subscreen.

We'll be using the terms TDJ for Lightning, and LDJ for Standard throughout the guide.

"},{"location":"games/bemani/iidx/30_resident/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure with a few folders only, as follows.

If your data doesn't look like this

If you're missing the modules folder and instead have bunch of .dll files next to your folders:

  • Create a modules folder.
  • Move all .dll files inside of it so you end up with a structure as shown above.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

If you don't need to update your data, you can skip over to the Installing Spice2x section.

"},{"location":"games/bemani/iidx/30_resident/setup/#updating-data","title":"Updating data","text":"Please make sure you're using the right update for your current data.

Patches re-uploaded by the community tend to be named LDJ-DATECODE-to-DATECODE.

For example LDJ-2022120800-to-2023090500.

  • 2022120800 being your current data's version.
  • 2023090500 being the version you would arrive at.
  • Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.
  • Open prop\\ea3-config.xml in a text editor and find the following lines near the top.
    <soft>\n        <model __type=\"str\">LDJ</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">A</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2023090500</ext>\n    </soft>\n

On the line with <ext __type=\"str\"> the datecode needs to match your new version.

  • If that's already the case then great! Don't touch anything.
  • If it instead corresponds to our pre-patch datecode, replace it with the new one.

Now save the file.

"},{"location":"games/bemani/iidx/30_resident/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice64.exe and spicecfg.exe files from the archive to your game's directory.

"},{"location":"games/bemani/iidx/30_resident/setup/#configuring-spice2x","title":"Configuring Spice2x","text":"

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/iidx/30_resident/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • P1 Game buttons: 1 to 7, Start, EFFECT, VEFX
  • P1 Keypad: Keypad Insert Card

Only if you're using LDJ:

  • P1 Keypad: 1 to 9

Only if you're playing using a keyboard:

  • Turntable: TT+, TT- and optionally TT+/- which alternates between TT+ and TT- on each press.
"},{"location":"games/bemani/iidx/30_resident/setup/#analogs-controllercab-only","title":"Analogs (controller/cab only)","text":"

With a controller rather than binding buttons to TT+ and TT-, you need to:

  • For Turntable P1, click Bind.
  • In Device, pick your controller.
  • In Control, pick whichever one corresponds to the turntable.
  • Turn your turntable ensuring that the Preview turns along with it.
  • Click Close, leaving the rest of the settings alone.
"},{"location":"games/bemani/iidx/30_resident/setup/#overlay","title":"Overlay","text":"

Modifying buttons in this section is not required but you are free to change what you want.

Click on Bind then press the key you want associated with the action.

"},{"location":"games/bemani/iidx/30_resident/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through spice2x.

If it does, here's how you may link different actions to your lights:

  • Click Bind.
  • In Device, pick your controller.
  • In Light Control, select the corresponding light.
  • Click Close.
  • Repeat for your other lights.
"},{"location":"games/bemani/iidx/30_resident/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section.

"},{"location":"games/bemani/iidx/30_resident/setup/#patches","title":"Patches","text":"

As of writing, web patching is recommended for IIDX 30 Resident as opposed to spice2x patching.

Spice2x patching is fairly new and the game's latest releases are prioritized for conversion.

For now use Mon's BemaniPatcher, more info can be found in the web patching page.

As a general rule of thumb, if you're not sure what a patch does or you're not absolutely certain you need it, leave it alone, regardless of recommendations below.

General patches Patch Recommendation Description Standard/Menu Timer Freeze Either Freezes the timer in all non-premium environments. Premium Free Timer Freeze Either Freezes the timer in Premium Free mode. Cursor Lock Either In song select, always returns to the previously selected song. CS-style Song Start Delay Either At the start of a song, holding Start will pause it until you release it. Increase Game Volume Either Ignores in-game settings and keeps the volume at a maximum, helpful for TDJ which tends to be quiet. Hide all bottom text Either Hides text at the bottom of the screen such as Credits or Paseli."},{"location":"games/bemani/iidx/30_resident/setup/#api","title":"API","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/iidx/30_resident/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the question mark at the very left.

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Game Options IIDX Disable Cameras -iidxdisablecams ON Network EA Service URL -url Covered in Connecting to a network

Required For TDJ

Category Option Parameter Setting Game Options IIDX TDJ Mode -iidxtdj ON

If you only have a single 120hz monitor, and not another 60hz touchscreen:

Category Option Parameter Setting Game Options IIDX TDJ Mode -graphics-force-single-adapter ON

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/iidx/30_resident/setup/#advanced-development","title":"Advanced & Development","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/iidx/30_resident/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/iidx/30_resident/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/bemani/iidx/30_resident/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/bemani/iidx/30_resident/setup/#audio","title":"Audio","text":"
  • Open spicecfg.exe.
  • At the very top, click on Shortcuts then Audio Playback Devices.
  • In the popup window, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick the 24 bit, 44100 Hz (CD Quality) option and click Apply then OK.
"},{"location":"games/bemani/iidx/30_resident/setup/#standard-lightning-language-settings","title":"Standard / Lightning / Language settings","text":"

Read through the Extra Information page and edit your prop\\ea3-config.xml file if necessary.

"},{"location":"games/bemani/iidx/30_resident/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

"},{"location":"games/bemani/iidx/30_resident/setup/#backup-data","title":"BACKUP DATA","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run spice64.exe, press Yes when it asks for elevated privileges.

If it's your first time running the game, you'll immediately be greeted with this screen.

"},{"location":"games/bemani/iidx/30_resident/setup/#clock-error","title":"CLOCK ERROR","text":"

Press your Test key to initialize the backup data, a message will pop up stating it's been initialized.

Next, you'll get another error.

Let the game run for a bit until the monitor check is complete and you should be taken to the service menu.

Instructions on how to navigate the menu are shown at the bottom of the screen.

  • Press 1 and 2 to go up and down.
  • Press 6 to select/execute.

Start by going up to CLOCK.

Here, simply select SAVE AND EXIT and the clock will be set.

You'll be back in the service menu.

"},{"location":"games/bemani/iidx/30_resident/setup/#network-options","title":"NETWORK OPTIONS","text":"

Go to NETWORK OPTIONS then SHOP NAME SETTING.

We will need to set a shop name.

  • Name your shop to whatever you'd like. Instructions on how to navigate are at the bottom of the screen.
  • Go to EXIT then SAVE AND EXIT.

Select GAME MODE.

You're all done! The game should load up properly now.

"},{"location":"games/bemani/iidx/30_resident/setup/#carding-in","title":"Carding in","text":"

Before carding in, you have the option of changing the game's language by pressing your EFFECT key.

For LDJ (Standard)

LDJ should accept keypad number binds:

  • Press your Keypad Insert Card button.
  • Enter your code using your keypad binds.
For TDJ (Lightning)

TDJ will ignore keypad number binds, you need to:

  • Press your Keypad Insert Card button.
  • Press your Toggle Sub Screen overlay button (PgUp by default) to bring up the sub screen.
  • Enter your code by clicking on the subscreen's keypad.
  • If your code is accepted, you may now close the overlay.
"},{"location":"games/bemani/iidx/30_resident/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

For any more game-specific information, check out Extra Information.

"},{"location":"games/bemani/iidx/30_resident/troubleshooting/","title":"beatmania IIDX 30 RESIDENT","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/iidx/30_resident/troubleshooting/#im-having-performance-issues","title":"I'm having performance issues!","text":"

If you're having performance issues of some kind, spice2x's PC optimization guide is worth looking at.

"},{"location":"games/bemani/iidx/30_resident/troubleshooting/#my-game-is-running-slowfast-after-finishing-a-song-the-game-gets-stuck-loading","title":"My game is running slow/fast, After finishing a song the game gets stuck loading!","text":"

The most common reason for this is the game is running over its required refresh rate. To solve this, make sure v-sync isn't disabled in your graphics card's settings.

For NVIDIA users, enable NVIDIA profile optimization (-nvprofile) in the Options tab.

"},{"location":"games/bemani/iidx/30_resident/troubleshooting/#how-do-i-set-my-offset","title":"How do I set my offset?","text":"

Play through a chart you're comfortable with.

If you're getting too many Fast, increase your offset (+). If you're getting too many Slow, decrease your offset (-).

"},{"location":"games/bemani/iidx/30_resident/troubleshooting/#my-inputs-arent-working-i-cant-get-past-error-messages","title":"My inputs aren't working / I can't get past error messages!","text":"

If none of your inputs are working, try updating spice2x, you can also try using the beta versions if the stable releases don't work for you.

"},{"location":"games/bemani/iidx/30_resident/troubleshooting/#my-game-audio-is-super-quiet","title":"My game audio is super quiet!","text":"

When using TDJ mode the audio is very quiet by default. To mitigate this, you can use the Increase Game Volume patch.

"},{"location":"games/bemani/iidx/30_resident/troubleshooting/#when-i-run-the-game-all-other-audio-is-gone","title":"When I run the game all other audio is gone!","text":"

IIDX uses WASAPI exclusive mode for audio to get better audio latency. Unlike former versions of the games which used DirectSound.

You can use the Shared Mode WASAPI patch to deal with some hardware issues, it can also be used to hear audio outside the game at the cost of audio latency.

"},{"location":"games/bemani/iidx/30_resident/troubleshooting/#im-not-getting-any-audio-or-my-audio-is-completely-wrecked-and-im-using-an-external-dac","title":"I'm not getting any audio, or my audio is completely wrecked and I'm using an External Dac!","text":"

Many setups have found some difficulty with audio due to various equipment being used. Consider using the Shared Mode WASAPI patch.

"},{"location":"games/bemani/iidx/31_epolis/extras/","title":"beatmania IIDX 31 EPOLIS","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/iidx/31_epolis/extras/#standard-lightning-modes","title":"Standard & Lightning modes","text":"

Lightning mode requires a 120hz capable monitor.

To make use of the Lightning Mode, which unlocks the subscreen and 120FPS, we need to go to the contents\\prop folder and edit the ea3-config.xml file.

We're interested in these lines:

    <soft>\n        <model __type=\"str\">LDJ</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">E</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024050700</ext>\n    </soft>\n

This is the line that determines if the game will run in Standard (60 FPS) or Lightning (120 FPS) mode.

<spec __type=\"str\">E</spec>\n
  • E for Standard (LDJ-012, LDJ, 60hz)
  • D for Lightning (LDJ-010, TDJ, 120hz)
"},{"location":"games/bemani/iidx/31_epolis/extras/#changing-the-games-language","title":"Changing the game's language","text":"

This is done in-game before card-in by pressing your EFFECT key.

"},{"location":"games/bemani/iidx/31_epolis/extras/#more-about-ea3-configxml","title":"More about ea3-config.xml","text":"

The ea3-config.xml file is located inside the prop folder.

Below is an explanation on what different sections of this file do.

The following lines change the PCBID and HARDID that your system reports to your e-amusement server. There is no need to manually change this as spice2x will do it for us.

<pcbid __type=\"str\">00010203040506070809</pcbid>\n<hardid __type=\"str\">00010203040506070809</hardid>\n

The following line determines what version of the game you are running. You should never change this. It should always say LDJ.

<model __type=\"str\">LDJ</model>\n

The following line determines the game's region. You should never change this. As you can change the language in-game.

<dest __type=\"str\">J</dest>\n

You should never change this. It should always say A for Epolis.

<rev __type=\"str\">A</rev>\n

The following line determines your datecode. Always keep it up to date with your game's current version.

<ext __type=\"str\">2024052100</ext>\n

The following line determine what remote service URL spice2x is supposed to connect to. There is no need to manually change this as spice2x will do it for us.

<services __type=\"str\">http://localhost:8083</services>\n
"},{"location":"games/bemani/iidx/31_epolis/setup/","title":"beatmania IIDX 31 EPOLIS","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

Reasonably modern CPU required

beatmania IIDX 31 and above require an AVX2 capable CPU.

If your CPU is too old, the game will crash with an EXCEPTION_ILLEGAL_INSTRUCTION error.

A known workaround is renaming/deleting the movies folder to prevent the game from loading them altogether.

"},{"location":"games/bemani/iidx/31_epolis/setup/#about-data","title":"About data","text":"

The full game should be around 100gb while updates are only around 2-5gb in size.

Standard (LDJ) / Lightning (TDJ)

Please keep the following in mind as you're going through this guide.

IIDX's codename is LDJ. For IIDX 31 Epolis this would be either:

  • LDJ-010 (TDJ, Lightning cab, 120 FPS)
  • LDJ-012 (LDJ, Standard cab, 60 FPS)

The main difference between 010 and 012 is the game's main .dll file, bm2dx.dll.

This changes which features the game offers, and which conditions the game expects to run under.

  • TDJ expects a 120hz compatible monitor for its main screen, and a second 60hz touchscreen compatible monitor called a subscreen. The second monitor isn't mandatory, we can get around that using spice2x.
  • LDJ expects 60hz monitor for its main screen, and no subscreen.

We'll be using the terms TDJ for Lightning, and LDJ for Standard throughout the guide.

If you're coming from IIDX 30 Resident

You'll want to update your data from LDJ-003 to LDJ-010 or LDJ-012 FIRST then follow this guide as normal.

"},{"location":"games/bemani/iidx/31_epolis/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure with a few folders only, as follows.

If your data doesn't look like this

If you're missing the modules folder and instead have bunch of .dll files next to your folders:

  • Create a modules folder.
  • Move all .dll files inside of it so you end up with a structure as shown above.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

If you don't need to update your data, you can skip over to the Installing Spice2x section.

"},{"location":"games/bemani/iidx/31_epolis/setup/#updating-data","title":"Updating data","text":"Please make sure you're using the right update for your current data.

As we've seen in the About data section, the main difference between LDJ and TDJ is the bm2dx.dll file. When updating from a previous version to the next, our current .dll will be overwritten.

Knowing that, patches re-uploaded by the community tend to be named LDJ-DATECODE-to-LDJ-010/012-DATECODE. Note: If updating from IIDX 30 Resident, it will be LDJ-003-DATECODE-to-LDJ-010/012-DATECODE.

For example LDJ-2024032500-to-LDJ-010-2024050700.

  • 2024032500 being your current data's version, no matter if it's using a TDJ or LDJ .dll file.
  • 2024050700 being the version you would arrive at.
  • 010 meaning you would end up with a TDJ (Lightning Cab) bm2dx.dll file.
  • Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.
  • Open prop\\ea3-config.xml in a text editor and find the following lines near the top.
    <soft>\n        <model __type=\"str\">LDJ</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">E</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024050700</ext>\n    </soft>\n

On the line with <spec __type=\"str\"> the letter needs to match your data type:

  • E for Standard (LDJ-012, LDJ, 60hz)
  • D for Lightning (LDJ-010, TDJ, 120hz)

Replace the letter accordingly if necessary.

On the line with <ext __type=\"str\"> the datecode needs to match your new version.

  • If that's already the case then great! Don't touch anything.
  • If it instead corresponds to our pre-patch datecode, replace it with the new one.

Now save the file.

"},{"location":"games/bemani/iidx/31_epolis/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice64.exe and spicecfg.exe files from the archive to your game's directory.

"},{"location":"games/bemani/iidx/31_epolis/setup/#configuring-spice2x","title":"Configuring Spice2x","text":"

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/iidx/31_epolis/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • P1 Game buttons: 1 to 7, Start, EFFECT, VEFX
  • P1 Keypad: Keypad Insert Card

Only if you're using LDJ:

  • P1 Keypad: 1 to 9

Only if you're playing using a keyboard:

  • Turntable: TT+, TT- and optionally TT+/- which alternates between TT+ and TT- on each press.
"},{"location":"games/bemani/iidx/31_epolis/setup/#analogs-controllercab-only","title":"Analogs (controller/cab only)","text":"

With a controller rather than binding buttons to TT+ and TT-, you need to:

  • For Turntable P1, click Bind.
  • In Device, pick your controller.
  • In Control, pick whichever one corresponds to the turntable.
  • Turn your turntable ensuring that the Preview turns along with it.
  • Click Close, leaving the rest of the settings alone.
"},{"location":"games/bemani/iidx/31_epolis/setup/#overlay","title":"Overlay","text":"

Modifying buttons in this section is not required but you are free to change what you want.

Click on Bind then press the key you want associated with the action.

"},{"location":"games/bemani/iidx/31_epolis/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through spice2x.

If it does, here's how you may link different actions to your lights:

  • Click Bind.
  • In Device, pick your controller.
  • In Light Control, select the corresponding light.
  • Click Close.
  • Repeat for your other lights.
"},{"location":"games/bemani/iidx/31_epolis/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section.

"},{"location":"games/bemani/iidx/31_epolis/setup/#patches","title":"Patches","text":"

Go through the Spice2x Patching page to import patches.

Ever since EPOLIS final (2024-08-26), patches have a description built-in to them.

To view it, hover-over the (?) or (!) to the left of each patch's name.

To prevent issues, avoid patching things you don't need or understand.

"},{"location":"games/bemani/iidx/31_epolis/setup/#api","title":"API","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/iidx/31_epolis/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the question mark at the very left.

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Game Options IIDX Disable Cameras -iidxdisablecams ON Network EA Service URL -url Covered in Connecting to a network

Required For TDJ

Category Option Parameter Setting Game Options IIDX TDJ Mode -iidxtdj ON

If you only have a single 120hz monitor, and not another 60hz touchscreen:

Category Option Parameter Setting Graphics (common) Only Use One Monitor -graphics-force-single-adapter ON

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/iidx/31_epolis/setup/#advanced-development","title":"Advanced & Development","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/iidx/31_epolis/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/iidx/31_epolis/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/bemani/iidx/31_epolis/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/bemani/iidx/31_epolis/setup/#audio","title":"Audio","text":"
  • Open spicecfg.exe.
  • At the very top, click on Shortcuts then Audio Playback Devices.
  • In the popup window, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick the 16 (or 24) bit, 44100 Hz option, click Apply then OK.
"},{"location":"games/bemani/iidx/31_epolis/setup/#standard-lightning-language-settings","title":"Standard / Lightning / Language settings","text":"

Read through the Extra Information page and edit your prop\\ea3-config.xml file if necessary.

"},{"location":"games/bemani/iidx/31_epolis/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

"},{"location":"games/bemani/iidx/31_epolis/setup/#backup-data","title":"BACKUP DATA","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run spice64.exe, press Yes when it asks for elevated privileges.

If it's your first time running the game, you'll immediately be greeted with this screen.

"},{"location":"games/bemani/iidx/31_epolis/setup/#clock-error","title":"CLOCK ERROR","text":"

Press your Test key to initialize the backup data, a message will pop up stating it's been initialized.

Next, you'll get another error.

Let the game run for a bit until the monitor check is complete and you should be taken to the service menu.

Instructions on how to navigate the menu are shown at the bottom of the screen.

  • Press 1 and 2 to go up and down.
  • Press 6 to select/execute.

Start by going up to CLOCK.

Here, simply select SAVE AND EXIT and the clock will be set.

You'll be back in the service menu.

"},{"location":"games/bemani/iidx/31_epolis/setup/#network-options","title":"NETWORK OPTIONS","text":"

Go to NETWORK OPTIONS then SHOP NAME SETTING.

We will need to set a shop name.

  • Name your shop to whatever you'd like. Instructions on how to navigate are at the bottom of the screen.
  • Go to EXIT then SAVE AND EXIT.

Select GAME MODE.

You're all done! The game should load up properly now.

"},{"location":"games/bemani/iidx/31_epolis/setup/#carding-in","title":"Carding in","text":"

Before carding in, you have the option of changing the game's language by pressing your EFFECT key.

For LDJ (Standard)

LDJ should accept keypad number binds:

  • Press your Keypad Insert Card button.
  • Enter your code using your keypad binds.
For TDJ (Lightning)

TDJ will ignore keypad number binds, you need to:

  • Press your Keypad Insert Card button.
  • Press your Toggle Sub Screen overlay button (PgUp by default) to bring up the sub screen.
  • Enter your code by clicking on the subscreen's keypad.
  • If your code is accepted, you may now close the overlay.
"},{"location":"games/bemani/iidx/31_epolis/setup/#optional-installing-omnimix","title":"(optional) Installing Omnimix","text":"

Check out the Data Mods and Omnimix guide.

"},{"location":"games/bemani/iidx/31_epolis/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

For any more game-specific information, check out Extra Information.

"},{"location":"games/bemani/iidx/31_epolis/troubleshooting/","title":"beatmania IIDX 31 EPOLIS","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/iidx/31_epolis/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch!","text":"

This could be due to many things.

Start by checking the audio section in the setup guide.

beatmania IIDX 31 and above require an AVX2 capable CPU. If your CPU is too old, the game will crash with an EXCEPTION_ILLEGAL_INSTRUCTION error. A known workaround is renaming/deleting the movies folder to prevent the game from loading them altogether.

"},{"location":"games/bemani/iidx/31_epolis/troubleshooting/#my-game-is-running-too-slowfast-game-gets-stuck-monitor-error-at-boot-error-5-1503-0043","title":"My game is running too slow/fast / Game gets stuck / Monitor error at boot / Error 5-1503-0043","text":"

Potential causes:

  1. The game could be running over/under its required refresh rate (60 for LDJ, 120 for TDJ) To solve this, make sure v-sync isn't disabled in your graphics card's settings. For NVIDIA users, enable NVIDIA profile optimization (-nvprofile) in the Options tab.
  2. It could be that your computer's performance isn't good enough to keep a steady framerate.
"},{"location":"games/bemani/iidx/31_epolis/troubleshooting/#im-having-performance-issues-my-fps-fluctates","title":"I'm having performance issues / my FPS fluctates!","text":"

If you're having performance issues of some kind, spice2x's PC optimization guide is worth looking at. If none of that works, your PC probably isn't good enough to run the game, sorry.

"},{"location":"games/bemani/iidx/31_epolis/troubleshooting/#unable-to-login-eamuse-error-network-error","title":"Unable to login / Eamuse error / Network error","text":"

Get the proper Asphyxia plugin from our Discord server in the #iidx channel > Resources post. Make sure you didn't enable -smartea in spicecfg's options.

"},{"location":"games/bemani/iidx/31_epolis/troubleshooting/#how-do-i-set-my-offset","title":"How do I set my offset?","text":"

Play through a chart you're comfortable with.

If you're getting too many Fast, increase your offset (+). If you're getting too many Slow, decrease your offset (-).

"},{"location":"games/bemani/iidx/31_epolis/troubleshooting/#my-inputs-arent-working-i-cant-get-past-error-messages","title":"My inputs aren't working / I can't get past error messages!","text":"

If none of your inputs are working, try updating spice2x, you can also try using the beta versions if the stable releases don't work for you.

"},{"location":"games/bemani/iidx/31_epolis/troubleshooting/#my-game-audio-is-super-quiet","title":"My game audio is super quiet!","text":"

When using TDJ mode the audio is very quiet by default. To mitigate this, you can use the Increase Game Volume patch.

"},{"location":"games/bemani/iidx/31_epolis/troubleshooting/#when-i-run-the-game-all-other-audio-is-gone","title":"When I run the game all other audio is gone!","text":"

IIDX uses WASAPI exclusive mode for audio to get better audio latency. Unlike former versions of the games which used DirectSound.

You can use the Shared Mode WASAPI patch to hear other apps while the game is running, at the cost of some audio latency.

"},{"location":"games/bemani/iidx/31_epolis/troubleshooting/#im-not-getting-any-audio-or-my-audio-is-completely-wrecked-and-im-using-an-external-dac","title":"I'm not getting any audio, or my audio is completely wrecked and I'm using an External Dac!","text":"

Many setups have found some difficulty with audio due to various equipment being used. Consider using the Shared Mode WASAPI patch.

"},{"location":"games/bemani/iidx/31_epolis/troubleshooting/#my-audio-is-sloweddistorted-and-im-using-the-shared-mode-wasapi-patch","title":"My audio is slowed/distorted and I'm using the Shared Mode WASAPI patch.","text":"

When using this patch, you must set your audio device's sample rate to 48000 Hz. See audio for more details.

"},{"location":"games/bemani/iidx/32_pinkycrush/extras/","title":"beatmania IIDX 32 Pinky Crush","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/iidx/32_pinkycrush/extras/#standard-lightning-modes","title":"Standard & Lightning modes","text":"

Lightning mode requires a 120hz capable monitor.

To make use of the Lightning Mode, which unlocks the subscreen and 120FPS, we need to go to the contents\\prop folder and edit the ea3-config.xml file.

We're interested in these lines:

    <soft>\n        <model __type=\"str\">LDJ</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">E</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024100900</ext>\n    </soft>\n

This is the line that determines if the game will run in Standard (60 FPS) or Lightning (120 FPS) mode.

<spec __type=\"str\">E</spec>\n
  • E for Standard (LDJ-012, LDJ, 60hz)
  • D for Lightning (LDJ-010, TDJ, 120hz)
"},{"location":"games/bemani/iidx/32_pinkycrush/extras/#changing-the-games-language","title":"Changing the game's language","text":"

This is done in-game before card-in by pressing your EFFECT key.

"},{"location":"games/bemani/iidx/32_pinkycrush/extras/#more-about-ea3-configxml","title":"More about ea3-config.xml","text":"

The ea3-config.xml file is located inside the prop folder.

Below is an explanation on what different sections of this file do.

The following lines change the PCBID and HARDID that your system reports to your e-amusement server. There is no need to manually change this as spice2x will do it for us.

<pcbid __type=\"str\">00010203040506070809</pcbid>\n<hardid __type=\"str\">00010203040506070809</hardid>\n

The following line determines what version of the game you are running. You should never change this. It should always say LDJ.

<model __type=\"str\">LDJ</model>\n

The following line determines the game's region. You should never change this. As you can change the language in-game.

<dest __type=\"str\">J</dest>\n

You should never change this. It should always say A for Pinky Crush.

<rev __type=\"str\">A</rev>\n

The following line determines your datecode. Always keep it up to date with your game's current version.

<ext __type=\"str\">2024100900</ext>\n

The following line determine what remote service URL spice2x is supposed to connect to. There is no need to manually change this as spice2x will do it for us.

<services __type=\"str\">http://localhost:8083</services>\n
"},{"location":"games/bemani/iidx/32_pinkycrush/setup/","title":"beatmania IIDX 32 Pinky Crush","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

Reasonably modern CPU required

beatmania IIDX 31 and above require an AVX2 capable CPU.

If your CPU is too old, the game will crash with an EXCEPTION_ILLEGAL_INSTRUCTION error.

A known workaround is renaming/deleting the movies folder to prevent the game from loading them altogether.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#about-data","title":"About data","text":"

The full game should be around 100gb while updates are only around 2-5gb in size.

Standard (LDJ) / Lightning (TDJ)

Please keep the following in mind as you're going through this guide.

IIDX's codename is LDJ. For IIDX 32 Pinky Crush this would be either:

  • LDJ-010 (TDJ, Lightning cab, 120 FPS)
  • LDJ-012 (LDJ, Standard cab, 60 FPS)

The main difference between 010 and 012 is the game's main .dll file, bm2dx.dll.

This changes which features the game offers, and which conditions the game expects to run under.

  • TDJ expects a 120hz compatible monitor for its main screen, and a second 60hz touchscreen compatible monitor called a subscreen. The second monitor isn't mandatory, we can get around that using spice2x.
  • LDJ expects 60hz monitor for its main screen, and no subscreen.

We'll be using the terms TDJ for Lightning, and LDJ for Standard throughout the guide.

If you're coming from IIDX 30 Resident

You'll want to update your data from LDJ-003 to LDJ-010 or LDJ-012 FIRST then follow this guide as normal.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure with a few folders only, as follows.

If your data doesn't look like this

If you're missing the modules folder and instead have bunch of .dll files next to your folders:

  • Create a modules folder.
  • Move all .dll files inside of it so you end up with a structure as shown above.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

If you don't need to update your data, you can skip over to the Installing Spice2x section.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#updating-data","title":"Updating data","text":"Please make sure you're using the right update for your current data.

As we've seen in the About data section, the main difference between LDJ and TDJ is the bm2dx.dll file. When updating from a previous version to the next, our current .dll will be overwritten.

Knowing that, patches re-uploaded by the community tend to be named LDJ-DATECODE-to-LDJ-010/012-DATECODE. Note: If updating from IIDX 30 Resident, it will be LDJ-003-DATECODE-to-LDJ-010/012-DATECODE.

For example LDJ-2024082600-to-LDJ-010-2024100900.

  • 2024082600 being your current data's version, no matter if it's using a TDJ or LDJ .dll file.
  • 2024100900 being the version you would arrive at.
  • 010 meaning you would end up with a TDJ (Lightning Cab) bm2dx.dll file.
  • Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.
  • Open prop\\ea3-config.xml in a text editor and find the following lines near the top.
    <soft>\n        <model __type=\"str\">LDJ</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">E</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024100900</ext>\n    </soft>\n

On the line with <spec __type=\"str\"> the letter needs to match your data type:

  • E for Standard (LDJ-012, LDJ, 60hz)
  • D for Lightning (LDJ-010, TDJ, 120hz)

Replace the letter accordingly if necessary.

On the line with <ext __type=\"str\"> the datecode needs to match your new version.

  • If that's already the case then great! Don't touch anything.
  • If it instead corresponds to our pre-patch datecode, replace it with the new one.

Now save the file.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice64.exe and spicecfg.exe files from the archive to your game's directory.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#configuring-spice2x","title":"Configuring Spice2x","text":"

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • P1 Game buttons: 1 to 7, Start, EFFECT, VEFX
  • P1 Keypad: Keypad Insert Card

Only if you're using LDJ:

  • P1 Keypad: 1 to 9

Only if you're playing using a keyboard:

  • Turntable: TT+, TT- and optionally TT+/- which alternates between TT+ and TT- on each press.
"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#analogs-controllercab-only","title":"Analogs (controller/cab only)","text":"

With a controller rather than binding buttons to TT+ and TT-, you need to:

  • For Turntable P1, click Bind.
  • In Device, pick your controller.
  • In Control, pick whichever one corresponds to the turntable.
  • Turn your turntable ensuring that the Preview turns along with it.
  • Click Close, leaving the rest of the settings alone.
"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#overlay","title":"Overlay","text":"

Modifying buttons in this section is not required but you are free to change what you want.

Click on Bind then press the key you want associated with the action.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through spice2x.

If it does, here's how you may link different actions to your lights:

  • Click Bind.
  • In Device, pick your controller.
  • In Light Control, select the corresponding light.
  • Click Close.
  • Repeat for your other lights.
"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#patches","title":"Patches","text":"

Go through the Spice2x Patching page to import patches.

Ever since EPOLIS final (2024-08-26), patches have a description built-in to them.

To view it, hover-over the (?) or (!) to the left of each patch's name.

To prevent issues, avoid patching things you don't need or understand.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#api","title":"API","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the question mark at the very left.

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Game Options IIDX Disable Cameras -iidxdisablecams ON Network EA Service URL -url Covered in Connecting to a network

Required For TDJ

Category Option Parameter Setting Game Options IIDX TDJ Mode -iidxtdj ON

If you only have a single 120hz monitor, and not another 60hz touchscreen:

Category Option Parameter Setting Graphics (common) Only Use One Monitor -graphics-force-single-adapter ON

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#advanced-development","title":"Advanced & Development","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#audio","title":"Audio","text":"
  • Open spicecfg.exe.
  • At the very top, click on Shortcuts then Audio Playback Devices.
  • In the popup window, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick the 16 (or 24) bit, 44100 Hz option, click Apply then OK.
"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#standard-lightning-language-settings","title":"Standard / Lightning / Language settings","text":"

Read through the Extra Information page and edit your prop\\ea3-config.xml file if necessary.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#backup-data","title":"BACKUP DATA","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run spice64.exe, press Yes when it asks for elevated privileges.

If it's your first time running the game, you'll immediately be greeted with this screen.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#clock-error","title":"CLOCK ERROR","text":"

Press your Test key to initialize the backup data, a message will pop up stating it's been initialized.

Next, you'll get another error.

Let the game run for a bit until the monitor check is complete and you should be taken to the service menu.

Instructions on how to navigate the menu are shown at the bottom of the screen.

  • Press 1 and 2 to go up and down.
  • Press 6 to select/execute.

Start by going up to CLOCK.

Here, simply select SAVE AND EXIT and the clock will be set.

You'll be back in the service menu.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#network-options","title":"NETWORK OPTIONS","text":"

Go to NETWORK OPTIONS then SHOP NAME SETTING.

We will need to set a shop name.

  • Name your shop to whatever you'd like. Instructions on how to navigate are at the bottom of the screen.
  • Go to EXIT then SAVE AND EXIT.

Select GAME MODE.

You're all done! The game should load up properly now.

"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#carding-in","title":"Carding in","text":"

Before carding in, you have the option of changing the game's language by pressing your EFFECT key.

For LDJ (Standard)

LDJ should accept keypad number binds:

  • Press your Keypad Insert Card button.
  • Enter your code using your keypad binds.
For TDJ (Lightning)

TDJ will ignore keypad number binds, you need to:

  • Press your Keypad Insert Card button.
  • Press your Toggle Sub Screen overlay button (PgUp by default) to bring up the sub screen.
  • Enter your code by clicking on the subscreen's keypad.
  • If your code is accepted, you may now close the overlay.
"},{"location":"games/bemani/iidx/32_pinkycrush/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

For any more game-specific information, check out Extra Information.

"},{"location":"games/bemani/iidx/32_pinkycrush/troubleshooting/","title":"beatmania IIDX 32 Pinky Crush","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/iidx/32_pinkycrush/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch!","text":"

This could be due to many things.

Start by checking the audio section in the setup guide.

beatmania IIDX 31 and above require an AVX2 capable CPU. If your CPU is too old, the game will crash with an EXCEPTION_ILLEGAL_INSTRUCTION error. A known workaround is renaming/deleting the movies folder to prevent the game from loading them altogether.

"},{"location":"games/bemani/iidx/32_pinkycrush/troubleshooting/#my-game-is-running-too-slowfast-game-gets-stuck-monitor-error-at-boot-error-5-1503-0043","title":"My game is running too slow/fast / Game gets stuck / Monitor error at boot / Error 5-1503-0043","text":"

Potential causes:

  1. The game could be running over/under its required refresh rate (60 for LDJ, 120 for TDJ) To solve this, make sure v-sync isn't disabled in your graphics card's settings. For NVIDIA users, enable NVIDIA profile optimization (-nvprofile) in the Options tab.
  2. It could be that your computer's performance isn't good enough to keep a steady framerate.
"},{"location":"games/bemani/iidx/32_pinkycrush/troubleshooting/#im-having-performance-issues-my-fps-fluctates","title":"I'm having performance issues / my FPS fluctates!","text":"

If you're having performance issues of some kind, spice2x's PC optimization guide is worth looking at. If none of that works, your PC probably isn't good enough to run the game, sorry.

"},{"location":"games/bemani/iidx/32_pinkycrush/troubleshooting/#unable-to-login-eamuse-error-network-error","title":"Unable to login / Eamuse error / Network error","text":"

Get the proper Asphyxia plugin from our Discord server in the #iidx channel > Resources post. Make sure you didn't enable -smartea in spicecfg's options.

"},{"location":"games/bemani/iidx/32_pinkycrush/troubleshooting/#how-do-i-set-my-offset","title":"How do I set my offset?","text":"

Play through a chart you're comfortable with.

If you're getting too many Fast, increase your offset (+). If you're getting too many Slow, decrease your offset (-).

"},{"location":"games/bemani/iidx/32_pinkycrush/troubleshooting/#my-inputs-arent-working-i-cant-get-past-error-messages","title":"My inputs aren't working / I can't get past error messages!","text":"

If none of your inputs are working, try updating spice2x, you can also try using the beta versions if the stable releases don't work for you.

"},{"location":"games/bemani/iidx/32_pinkycrush/troubleshooting/#my-game-audio-is-super-quiet","title":"My game audio is super quiet!","text":"

When using TDJ mode the audio is very quiet by default. To mitigate this, you can use the Increase Game Volume patch.

"},{"location":"games/bemani/iidx/32_pinkycrush/troubleshooting/#when-i-run-the-game-all-other-audio-is-gone","title":"When I run the game all other audio is gone!","text":"

IIDX uses WASAPI exclusive mode for audio to get better audio latency. Unlike former versions of the games which used DirectSound.

You can use the Shared Mode WASAPI patch to hear other apps while the game is running, at the cost of some audio latency.

"},{"location":"games/bemani/iidx/32_pinkycrush/troubleshooting/#im-not-getting-any-audio-or-my-audio-is-completely-wrecked-and-im-using-an-external-dac","title":"I'm not getting any audio, or my audio is completely wrecked and I'm using an External Dac!","text":"

Many setups have found some difficulty with audio due to various equipment being used. Consider using the Shared Mode WASAPI patch.

"},{"location":"games/bemani/iidx/32_pinkycrush/troubleshooting/#my-audio-is-sloweddistorted-and-im-using-the-shared-mode-wasapi-patch","title":"My audio is slowed/distorted and I'm using the Shared Mode WASAPI patch.","text":"

When using this patch, you must set your audio device's sample rate to 48000 Hz. See audio for more details.

"},{"location":"games/bemani/iidx/9thstyle/setup/","title":"beatmania IIDX 9th style","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/iidx/9thstyle/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.
"},{"location":"games/bemani/iidx/9thstyle/setup/#installing-bemanitools","title":"Installing Bemanitools","text":"

  • Download Bemanitools.

  • Inside bemanitools-5.48.zip locate iidx-09-to-12.zip.

  • Extract everything inside the folder that contains the bm2dx.exe which is located in \\C02\\D\\C02\\JAG.

Pictured below is what your folder should look like. We've removed any files not necessary for 9th style.

"},{"location":"games/bemani/iidx/9thstyle/setup/#using-iidxhook-09conf","title":"Using iidxhook-09.conf","text":"

  • Download the Bemanitools supplements

  • Open bemanitools-supplement-v1.6.zip and navigate inside misc.zip

  • Inside misc\\d3d8to9, extract d3d8.dll to \\C02\\D\\C02\\JAG.

This enables us to use the graphic options inside iidxhook-09.conf which we will take advantage of.

"},{"location":"games/bemani/iidx/9thstyle/setup/#configuring-bemanitools","title":"Configuring Bemanitools","text":"

To configure your keybinds, open your config.bat file.

"},{"location":"games/bemani/iidx/9thstyle/setup/#buttons","title":"Buttons","text":"

Double click on the right on a button that you wish to bind, then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • P1 Game buttons: 1 to 7, Start, EFFECT, VEFX
  • P1 Keypad: Keypad Insert Card

Only if you're playing using a keyboard:

  • Turntable: TT+, TT- and optionally TT+/- which alternates between TT+ and TT- on each press.
"},{"location":"games/bemani/iidx/9thstyle/setup/#analogs-controllercab-only","title":"Analogs (controller/cab only)","text":"

With a controller rather than binding buttons to TT+ and TT-, you need to:

  • Head to the Analogs tab at the top.
  • In Device, pick your controller.
  • In Control, pick whichever one corresponds to the turntable.
  • Turn your turntable ensuring that the preview turns along with it.
  • Click OK, leaving the rest of the settings alone.
"},{"location":"games/bemani/iidx/9thstyle/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through bemanitools.

If it does, here's how you may link different actions to your lights:

  • In Device, pick your controller.
  • In Game Light, select the corresponding button that will be used for that light.
  • Repeat for your other lights.

If you'd like to play offline, you can head straight to Game resolution and locking FPS

"},{"location":"games/bemani/iidx/9thstyle/setup/#configuring-bemanitools-for-a-network","title":"Configuring Bemanitools for a network","text":"

Head over to the Network tab.

Now we will set up our PIN pad and card.

  • Click on Keyboard device
  • You may or may not have more than one option. To figure out which one is your actual keyboard, select a device inside that list and press a button on the numpad.
  • Once you have found your correct device, the Keyboard status will change (the number and location of the number does not matter, it only matters that it changed).
  • Grab your card, create a .txt and name it however you like. In this example it's called card.txt
  • Place the file in a location that is easily accessible and you won't forget. In this case it's in a seperate folder.

If you don't have a numpad, make sure to tick Use top keyboard row for PIN pad input. This will also change the Card In button to Backspace.

"},{"location":"games/bemani/iidx/9thstyle/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

  • Locate your iidxhook-09.conf

  • Open it with your desired text editor (we're using Notepad++)

  • Replace the eamuse.server=localhost:80 with your desired network URL

  • Replace eamuse.pcbid=XXXXXXXXXXXXXXXXXXXX and eamuse.eamid=XXXXXXXXXXXXXXXXXXXX with your PCBID of your network of choice.

# URL (e.g. http://my.eamuse.server:80/whatever) or IPV4 (e.g. 127.0.0.1:80) of the target eamuse server. The port is optional but defaults to 80.\neamuse.server=localhost:80\n\n# PCBID\neamuse.pcbid=XXXXXXXXXXXXXXXXXXXX\n\n# EAMID\neamuse.eamid=XXXXXXXXXXXXXXXXXXXX\n
"},{"location":"games/bemani/iidx/9thstyle/setup/#game-resolution-and-locking-fps","title":"Game resolution and locking FPS","text":"

We'd like to mention that there are two options when it comes to how the game renders. You can choose between Linear and Point.

Below is an example of how both look like.

Linear

Point

It comes down to your own prefrence what you decide on, Linear is less sharp but doesn't have pixel perfect edges. Point is sharp and is pixel perfect.

Next up, we'll setup borderless window and configure the proper resolution. We're using a 1920x1080 monitor so we will use that.

Repeat the previous step and open your iidxhook-09.conf. We want to find these lines:

# Software limit the frame rate of the rendering loop in hz, e.g. 60 or 59.95 (0.0 = no software limit)\ngfx.frame_rate_limit=0.0\n\n# Run the game windowed\ngfx.windowed=false\n\n# Windowed width, 0 for default size\ngfx.window_width=0\n\n# Windowed height, 0 for default size\ngfx.window_height=0\n\n# Up-/downscale the back buffer's width. This does not change the game's rendering resolution but scales the final frame. Use this to target the native resolution of your monitor/TV, e.g. to avoid over-/underscan, bad image quality or latency caused by the monitors internal upscaler. 0 to disable this feature. Must be set in combination with the corresponding height parameter.\ngfx.scale_back_buffer_width=0\n\n# Up-/downscale the back buffer's height. This does not change the game's rendering resolution but scales the final frame. Use this to target the native resolution of your monitor/TV, e.g. to avoid over-/underscan, bad image quality or latency caused by the monitors internal upscaler. 0 to disable this feature. Must be set in combination with the corresponding width parameter.\ngfx.scale_back_buffer_height=0\n\n# Filter type to use for up-/downscaling the back buffer. Only used if scaling feature was enabled by setting the scaling width and height parameters. Available types: none, linear, point (refer to D3DTEXTUREFILTERTYPE  for explanation).\ngfx.scale_back_buffer_filter=none\n

If you can't seem to find them, press CTRL + F and search for gfx.frame_rate_limit=0.0. This will bring you to the first line we want to edit.

Listed below are the values we want to change them to.

gfx.frame_rate_limit=59.95\ngfx.windowed=true\ngfx.window_width=1920\ngfx.window_height=1080\ngfx.scale_back_buffer_width=1920\ngfx.scale_back_buffer_height=1080\ngfx.scale_back_buffer_filter=linear\n
Unless you'd like to have the game properly windowed you can safely ignore gfx.framed=false.

Make sure to decide on whether you want Linear or Point rendering.

gfx.scale_back_buffer_filter=linear\ngfx.scale_back_buffer_filter=point\n
"},{"location":"games/bemani/iidx/9thstyle/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

"},{"location":"games/bemani/iidx/9thstyle/setup/#clock-error","title":"CLOCK ERROR","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run gamestart.bat.

If it's your first time running the game, you'll immediately be greeted with this screen.

The game will automatically bring you into it's service menu.

Instructions on how to navigate the menu are shown at the bottom of the screen.

  • Press 1 and 2 to go up and down.
  • Press 6 to select/execute.

Navigate to CLOCK SETUP. You do not need to manually change it. Navigate to SAVE AND EXIT.

If you'd like to play offline, you can head straight to Final Notes

"},{"location":"games/bemani/iidx/9thstyle/setup/#enabling-e-amusement-for-online-play","title":"Enabling e-AMUSEMENT for Online Play","text":"

From the service menu, go to e-AMUSEMENT OPTIONS then e-AMUSEMENT SETTINGS.

It'll bring you to this screen, change it so that e-AMUSEMENT switches to ON and it will look like this:

We will need to set a SHOP NAME SETTING and change our PREFECTURE otherwise the game will throw errors at us.

  • Name your shop to whatever you'd like. Instructions on how to navigate are at the bottom of the screen.
  • Navigate to EXIT and select it.
  • Change your prefecture once or how many times you'd like, it doesn't matter as long as it's not the default one.

Select SAVE AND EXIT. The game will now give you a message, which translated means:

e-AMUSEMENT settings have been changed. Please turn the power off and on again.

So, close the game and open it again.

"},{"location":"games/bemani/iidx/9thstyle/setup/#final-notes","title":"Final Notes","text":"

You're all done! Make sure to insert two credits by pressing your SERVICE key. Have fun!

Have any other errors?

Check out the Troubleshooting section.

"},{"location":"games/bemani/iidx/9thstyle/troubleshooting/","title":"beatmania IIDX 9th style","text":""},{"location":"games/bemani/iidx/9thstyle/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

The most common reason for this is the game is running over its required 59.95hz, the game is hardcoded to run at 59.95hz and this cannot be changed. To solve this, check Game resolution and locking FPS again.

"},{"location":"games/bemani/iidx/9thstyle/troubleshooting/#im-getting-network-warning-instead-of-network-ok","title":"I'm getting \"NETWORK WARNING\" instead of \"NETWORK OK\"","text":"

This can be caused by:

  • Invalid PCBID
  • Firewall blocking connections
  • Invalid eamuse url or port specified
  • Game is not run using the Administrator account
"},{"location":"games/bemani/iidx/9thstyle/troubleshooting/#my-background-videos-arent-working","title":"My background videos aren't working!","text":"

You need to install a codec.

  • Open bemanitools-supplement-v1.6.zip and navigate to \\iidx.zip\\iidx\\misc\\ where CLVSD.ax is located.

  • Extract CLVSD.ax inside a folder that you know won't be moved or renamed.

  • Open the command prompt as administrator. Now type regsvr32 \"<location of the file>\\CLVSD.ax\" into the command prompt.

As an example, it could look like this: regsvr32 \"D:\\BEMANI\\IIDX\\CLVSD.ax\"

A prompt should appear telling you that it has been installed successfully. This applies for all styles that require this codec, not just 9th style.

If an error occurs, you didn't run the command prompt as administrator or you messed up the location of the file.

You can not move or delete CLVSD.ax at all, otherwise it will revert the changes and you have to install it again.

"},{"location":"games/bemani/iidx/9thstyle/troubleshooting/#my-game-crashes-immediately","title":"My game crashes immediately!","text":"

This can have multiple reasons. These fixes shouldn't be needed for 9th style since we're addressing them in the guide. We'll add them anyway just in case.

"},{"location":"games/bemani/iidx/9thstyle/troubleshooting/#fix-1-wrong-data-structure","title":"Fix #1 (Wrong data structure)","text":"

Make sure that your unpacked data looks like this:

  • JAx (Game binary revision folder where 'x' can be A, B, C, D, E, F, G)
  • data
  • sidcode.txt

Any other files are optional and don't have to be removed as these are not required to run the game.

"},{"location":"games/bemani/iidx/9thstyle/troubleshooting/#fix-2-rteffectsdll-didnt-get-replaced","title":"Fix #2 (RtEffects.dll didn't get replaced)","text":"

Refer to Preparing data again and check if you have followed all the instructions explained in it.

"},{"location":"games/bemani/jubeat/clan/setup/","title":"jubeat clan","text":"

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.

"},{"location":"games/bemani/jubeat/clan/setup/#getting-started","title":"Getting Started","text":"

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.

"},{"location":"games/bemani/jubeat/clan/setup/#configuring-your-tools","title":"Configuring Your Tools","text":"

Now that you have your files ready, open up your .bat file in your desired text editor (we're using Notepad++) 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.

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.

"},{"location":"games/bemani/jubeat/clan/setup/#configuring-for-a-local-network","title":"Configuring for a Local Network","text":"

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++.

"},{"location":"games/bemani/jubeat/clan/setup/#configuring-for-an-online-network","title":"Configuring for an Online Network","text":"

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++.

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.

"},{"location":"games/bemani/jubeat/clan/setup/#final-steps-and-setting-up-the-game","title":"Final Steps and Setting up the Game","text":"

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!

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.

Enter the GAME OPTIONS menu and proceed to the SHOP SETTINGS menu.

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.

With that, you're all done! Simply exit the service menu or reboot then enjoy the game, have fun!

Have any other errors?

Check out the Troubleshooting section and Error Code section to resolve any issues not seen in this guide to greater depth.

"},{"location":"games/bemani/jubeat/clan/troubleshooting/","title":"jubeat clan","text":""},{"location":"games/bemani/jubeat/clan/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

Bemani PC (ADE-704A)

This board has a E4690 Radeon MXM card.

CPU: Intel Celeron B810

GPU: AMD Radeon E4690

Chipset: Intel HM65

"},{"location":"games/bemani/jubeat/clan/troubleshooting/#my-game-is-running-slowlagging","title":"My Game Is Running Slow/Lagging","text":"

Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.

"},{"location":"games/bemani/jubeat/clan/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

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.

"},{"location":"games/bemani/jubeat/clan/troubleshooting/#occasional-game-stutters-during-play","title":"Occasional Game Stutters During Play","text":"

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.

"},{"location":"games/bemani/jubeat/clan/troubleshooting/#my-touchscreen-isnt-working","title":"My Touchscreen Isn't Working!","text":"

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.

"},{"location":"games/bemani/museca/1plushalf/setup/","title":"MUSECA 1+1/2","text":"

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.

"},{"location":"games/bemani/museca/1plushalf/setup/#getting-started","title":"Getting Started","text":"

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.

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.

"},{"location":"games/bemani/museca/1plushalf/setup/#configuring-your-tools","title":"Configuring Your Tools","text":"

Now that you have your files ready, open up your .bat file in your desired text editor (we're using Notepad++) 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.

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.

"},{"location":"games/bemani/museca/1plushalf/setup/#configuring-for-a-local-network","title":"Configuring for a Local Network","text":"

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!
"},{"location":"games/bemani/museca/1plushalf/setup/#configuring-for-an-online-network","title":"Configuring for an Online Network","text":"

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!

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.

"},{"location":"games/bemani/museca/1plushalf/setup/#final-steps-and-setting-up-the-game","title":"Final Steps and Setting up the Game","text":"

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.

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

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!

Have any other errors?

Check out the Troubleshooting and Error Code sections to resolve any issues not seen in this guide to greater depth.

"},{"location":"games/bemani/museca/1plushalf/troubleshooting/","title":"MUSECA 1+1/2","text":""},{"location":"games/bemani/museca/1plushalf/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

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

"},{"location":"games/bemani/museca/1plushalf/troubleshooting/#my-game-is-running-slowlagging","title":"My Game Is Running Slow/Lagging","text":"

Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.

"},{"location":"games/bemani/museca/1plushalf/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

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.

"},{"location":"games/bemani/museca/1plushalf/troubleshooting/#occasional-game-stutters-during-play","title":"Occasional Game Stutters During Play","text":"

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.

"},{"location":"games/bemani/museca/1plushalf/troubleshooting/#which-offset-is-which","title":"Which Offset Is Which?","text":"

If you're getting too many fasts, increase your offset (+). If you're getting too many slows, decrease your offset (-).

"},{"location":"games/bemani/museca/1plushalf/troubleshooting/#booting-the-game-in-offline-mode","title":"Booting the Game in Offline Mode","text":"

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.

"},{"location":"games/bemani/museca/1plushalf/troubleshooting/#when-i-run-this-game-all-other-background-audio-is-gone-whats-going-on","title":"When I Run This Game All Other Background Audio Is Gone! What's Going On?","text":"

Museca is a 64-bit game utilizing a feature in Windows called WASAPI exclusive mode to obtain less audio latency. Unfortunately, this cannot be changed.

"},{"location":"games/bemani/museca/1plushalf/troubleshooting/#im-not-getting-any-audiomy-audio-is-completely-wrecked-and-im-using-an-external-dac","title":"I'm Not Getting Any Audio/My Audio Is Completely Wrecked and I'm Using an External Dac!","text":"

Several external DACs have issues with WASAPI exclusive mode 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.

"},{"location":"games/bemani/nostalgia/forte/setup/","title":"NOSTALGIA FORTE","text":"

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.

"},{"location":"games/bemani/nostalgia/forte/setup/#getting-started","title":"Getting Started","text":"

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.

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.

"},{"location":"games/bemani/nostalgia/forte/setup/#configuring-your-tools","title":"Configuring Your Tools","text":"

Now that you have your files ready, open up your .bat file in your desired text editor (we're using Notepad++) 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.

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.

"},{"location":"games/bemani/nostalgia/forte/setup/#configuring-for-a-local-network","title":"Configuring for a Local Network","text":"

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!
"},{"location":"games/bemani/nostalgia/forte/setup/#configuring-for-an-online-network","title":"Configuring for an Online Network","text":"

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!
"},{"location":"games/bemani/nostalgia/forte/setup/#final-steps-and-setting-up-the-game","title":"Final Steps and Setting up the Game","text":"

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.

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.

The final menu we must deal with is VIRTUAL COIN, enter the menu and select OPERATION SETTINGS as seen below.

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.

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.

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.

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!

Have any other errors?

Check out the Troubleshooting section and Error Code section to resolve any issues not seen in this guide to greater depth.

"},{"location":"games/bemani/nostalgia/forte/troubleshooting/","title":"NOSTALGIA FORTE","text":""},{"location":"games/bemani/nostalgia/forte/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

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

"},{"location":"games/bemani/nostalgia/forte/troubleshooting/#my-game-is-running-slowlagging","title":"My Game Is Running Slow/Lagging","text":"

Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.

"},{"location":"games/bemani/nostalgia/forte/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

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.

"},{"location":"games/bemani/nostalgia/forte/troubleshooting/#occasional-game-stutters-during-play","title":"Occasional Game Stutters During Play","text":"

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.

"},{"location":"games/bemani/nostalgia/forte/troubleshooting/#which-offset-is-which","title":"Which Offset Is Which?","text":"

If you're getting too many fasts, increase your offset (+). If you're getting too many slows, decrease your offset (-).

"},{"location":"games/bemani/nostalgia/forte/troubleshooting/#no-matter-what-i-do-the-game-crashes-and-i-have-multiple-monitors","title":"No Matter What I Do, the Game Crashes and I Have Multiple Monitors!","text":"

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.

"},{"location":"games/bemani/nostalgia/op2/setup/","title":"NOSTALGIA OP.2","text":"

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.

"},{"location":"games/bemani/nostalgia/op2/setup/#getting-started","title":"Getting Started","text":"

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.

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.

"},{"location":"games/bemani/nostalgia/op2/setup/#configuring-your-tools","title":"Configuring Your Tools","text":"

Now that you have your files ready, open up your .bat file in your desired text editor (we're using Notepad++) 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.

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.

"},{"location":"games/bemani/nostalgia/op2/setup/#configuring-for-a-local-network","title":"Configuring for a Local Network","text":"

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!
"},{"location":"games/bemani/nostalgia/op2/setup/#configuring-for-an-online-network","title":"Configuring for an Online Network","text":"

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!
"},{"location":"games/bemani/nostalgia/op2/setup/#final-steps-and-setting-up-the-game","title":"Final Steps and Setting up the Game","text":"

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.

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.

The final menu we must deal with is VIRTUAL COIN, enter the menu and select OPERATION SETTINGS as seen below.

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.

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.

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.

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!

Have any other errors?

Check out the Troubleshooting section and Error Code section to resolve any issues not seen in this guide to greater depth.

"},{"location":"games/bemani/nostalgia/op2/troubleshooting/","title":"NOSTALGIA OP.2","text":""},{"location":"games/bemani/nostalgia/op2/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

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

"},{"location":"games/bemani/nostalgia/op2/troubleshooting/#my-game-is-running-slowlagging","title":"My Game Is Running Slow/Lagging","text":"

Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.

"},{"location":"games/bemani/nostalgia/op2/troubleshooting/#my-game-is-running-crazy-fast","title":"My Game Is Running Crazy Fast!","text":"

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.

"},{"location":"games/bemani/nostalgia/op2/troubleshooting/#occasional-game-stutters-during-play","title":"Occasional Game Stutters During Play","text":"

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.

"},{"location":"games/bemani/nostalgia/op2/troubleshooting/#which-offset-is-which","title":"Which Offset Is Which?","text":"

If you're getting too many fasts, increase your offset (+). If you're getting too many slows, decrease your offset (-).

"},{"location":"games/bemani/nostalgia/op2/troubleshooting/#no-matter-what-i-do-the-game-crashes-and-i-have-multiple-monitors","title":"No Matter What I Do, the Game Crashes and I Have Multiple Monitors!","text":"

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.

"},{"location":"games/bemani/popn/common/setup/","title":"Setup","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/popn/common/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure with a few folders only, as follows.

If your data doesn't look like this

If you're missing the dev folder, you can safely ignore it as it'll be created by spice2x automatically.

If you're missing the modules folder and instead have bunch of .dll files next to your folders:

  • Create a modules folder.
  • Move all .dll files inside of it so you end up with a structure as shown above.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

If you don't need to update your data, you can skip over to the Installing Spice2x section.

"},{"location":"games/bemani/popn/common/setup/#updating-data","title":"Updating data","text":"Please make sure you're using the right update for your current data.

pop'n music patches re-uploaded by the community tend to be appropriately named M39-DATECODE-to-DATECODE.

For example M39-2024073100-to-2024091700.

  • 2024073100 being your current data's version.
  • 2024091700 being the one you would arrive at.
  • Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.
  • Open prop\\ea3-config.xml in a text editor and find the following lines near the top.
    <soft>\n        <model __type=\"str\">M39</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">A</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024091700</ext>\n    </soft>\n

On the line with <ext __type=\"str\"> the datecode needs to match your new version.

  • If that's already the case then great! Don't touch anything.
  • If it instead corresponds to your pre-patch datecode, replace it with the new one and save the file.
"},{"location":"games/bemani/popn/common/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice.exe and spicecfg.exe files from the archive to your game's directory.

"},{"location":"games/bemani/popn/common/setup/#configuring-spice2x","title":"Configuring Spice2x","text":"

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/popn/common/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • Game buttons: 1 to 9
  • P1 Keypad: 1 to 9, Keypad Insert Card
"},{"location":"games/bemani/popn/common/setup/#overlay","title":"Overlay","text":"

Modifying buttons in this section is not required but you are free to change what you want.

Click on Bind then press the key you want associated with the action.

"},{"location":"games/bemani/popn/common/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through spice2x.

If it does, here's how you may link different actions to your lights:

  • Click Bind.
  • In Device, pick your controller.
  • In Light Control, select the corresponding light.
  • Click Close.
  • Repeat for your other lights.
"},{"location":"games/bemani/popn/common/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section.

"},{"location":"games/bemani/popn/common/setup/#patches","title":"Patches","text":"

Go through the Spice2x Patching page to import patches.

To prevent issues, avoid patching things you don't need or understand.

"},{"location":"games/bemani/popn/common/setup/#api","title":"API","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/popn/common/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the question mark at the very left.

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Network EA Service URL -url Covered in Connecting to a network

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/popn/common/setup/#advanced-development","title":"Advanced & Development","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/popn/common/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/popn/common/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run spice.exe, press Yes when it asks for elevated privileges.

The game will go through a series of checks, let it run, if you've done everything properly they'll pass.

"},{"location":"games/bemani/popn/common/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/bemani/popn/common/troubleshooting/","title":"Troubleshooting","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/popn/common/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch","text":"

Some monitors and display adapters may not support the odd resolution that the game runs at, which is 1360x768 as opposed to the occasionally seen 1366x768. To resolve this, set a custom resolution in your graphics card's settings, or enable GPU resolution scaling.

"},{"location":"games/bemani/popn/common/troubleshooting/#my-game-is-too-slowfast","title":"My game is too slow/fast","text":"

Potential causes:

  1. The game could be running over/under its required refresh rate (60) To solve this, make sure v-sync isn't disabled in your graphics card's settings. For NVIDIA users, enable NVIDIA profile optimization (-nvprofile) in the Options tab. You can also set Force Refresh Rate to 60.
  2. It could be that your computer's performance isn't good enough to keep a steady framerate.
"},{"location":"games/bemani/popn/common/troubleshooting/#my-game-doesnt-have-audio","title":"My game doesn't have audio","text":"

Enable the HDMI Audio Fix patch.

"},{"location":"games/bemani/popn/kaimei_riddles/setup/","title":"Game Setup (pop'n music Kaimei Riddles)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/popn/kaimei_riddles/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure with a few folders only, as follows.

If your data doesn't look like this

If you're missing the dev folder, you can safely ignore it as it'll be created by spice2x automatically.

If you're missing the modules folder and instead have bunch of .dll files next to your folders:

  • Create a modules folder.
  • Move all .dll files inside of it so you end up with a structure as shown above.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

If you don't need to update your data, you can skip over to the Installing Spice2x section.

"},{"location":"games/bemani/popn/kaimei_riddles/setup/#updating-data","title":"Updating data","text":"Please make sure you're using the right update for your current data.

pop'n music patches re-uploaded by the community tend to be appropriately named M39-DATECODE-to-DATECODE.

For example M39-2024073100-to-2024091700.

  • 2024073100 being your current data's version.
  • 2024091700 being the one you would arrive at.
  • Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.
  • Open prop\\ea3-config.xml in a text editor and find the following lines near the top.
    <soft>\n        <model __type=\"str\">M39</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">A</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024091700</ext>\n    </soft>\n

On the line with <ext __type=\"str\"> the datecode needs to match your new version.

  • If that's already the case then great! Don't touch anything.
  • If it instead corresponds to your pre-patch datecode, replace it with the new one and save the file.
"},{"location":"games/bemani/popn/kaimei_riddles/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice.exe and spicecfg.exe files from the archive to your game's directory.

"},{"location":"games/bemani/popn/kaimei_riddles/setup/#configuring-spice2x","title":"Configuring Spice2x","text":"

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/popn/kaimei_riddles/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • Game buttons: 1 to 9
  • P1 Keypad: 1 to 9, Keypad Insert Card
"},{"location":"games/bemani/popn/kaimei_riddles/setup/#overlay","title":"Overlay","text":"

Modifying buttons in this section is not required but you are free to change what you want.

Click on Bind then press the key you want associated with the action.

"},{"location":"games/bemani/popn/kaimei_riddles/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through spice2x.

If it does, here's how you may link different actions to your lights:

  • Click Bind.
  • In Device, pick your controller.
  • In Light Control, select the corresponding light.
  • Click Close.
  • Repeat for your other lights.
"},{"location":"games/bemani/popn/kaimei_riddles/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section.

"},{"location":"games/bemani/popn/kaimei_riddles/setup/#patches","title":"Patches","text":"

Go through the Spice2x Patching page to import patches.

To prevent issues, avoid patching things you don't need or understand.

"},{"location":"games/bemani/popn/kaimei_riddles/setup/#api","title":"API","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/popn/kaimei_riddles/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the question mark at the very left.

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Network EA Service URL -url Covered in Connecting to a network

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/popn/kaimei_riddles/setup/#advanced-development","title":"Advanced & Development","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/popn/kaimei_riddles/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/popn/kaimei_riddles/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run spice.exe, press Yes when it asks for elevated privileges.

The game will go through a series of checks, let it run, if you've done everything properly they'll pass.

"},{"location":"games/bemani/popn/kaimei_riddles/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/bemani/popn/kaimei_riddles/troubleshooting/","title":"Troubleshooting (pop'n music Kaimei Riddles)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/popn/kaimei_riddles/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch","text":"

Some monitors and display adapters may not support the odd resolution that the game runs at, which is 1360x768 as opposed to the occasionally seen 1366x768. To resolve this, set a custom resolution in your graphics card's settings, or enable GPU resolution scaling.

"},{"location":"games/bemani/popn/kaimei_riddles/troubleshooting/#my-game-is-too-slowfast","title":"My game is too slow/fast","text":"

Potential causes:

  1. The game could be running over/under its required refresh rate (60) To solve this, make sure v-sync isn't disabled in your graphics card's settings. For NVIDIA users, enable NVIDIA profile optimization (-nvprofile) in the Options tab. You can also set Force Refresh Rate to 60.
  2. It could be that your computer's performance isn't good enough to keep a steady framerate.
"},{"location":"games/bemani/popn/kaimei_riddles/troubleshooting/#my-game-doesnt-have-audio","title":"My game doesn't have audio","text":"

Enable the HDMI Audio Fix patch.

"},{"location":"games/bemani/popn/peace/setup/","title":"Game Setup (pop'n music peace)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/popn/peace/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure with a few folders only, as follows.

If your data doesn't look like this

If you're missing the dev folder, you can safely ignore it as it'll be created by spice2x automatically.

If you're missing the modules folder and instead have bunch of .dll files next to your folders:

  • Create a modules folder.
  • Move all .dll files inside of it so you end up with a structure as shown above.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

If you don't need to update your data, you can skip over to the Installing Spice2x section.

"},{"location":"games/bemani/popn/peace/setup/#updating-data","title":"Updating data","text":"Please make sure you're using the right update for your current data.

pop'n music patches re-uploaded by the community tend to be appropriately named M39-DATECODE-to-DATECODE.

For example M39-2024073100-to-2024091700.

  • 2024073100 being your current data's version.
  • 2024091700 being the one you would arrive at.
  • Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.
  • Open prop\\ea3-config.xml in a text editor and find the following lines near the top.
    <soft>\n        <model __type=\"str\">M39</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">A</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024091700</ext>\n    </soft>\n

On the line with <ext __type=\"str\"> the datecode needs to match your new version.

  • If that's already the case then great! Don't touch anything.
  • If it instead corresponds to your pre-patch datecode, replace it with the new one and save the file.
"},{"location":"games/bemani/popn/peace/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice.exe and spicecfg.exe files from the archive to your game's directory.

"},{"location":"games/bemani/popn/peace/setup/#configuring-spice2x","title":"Configuring Spice2x","text":"

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/popn/peace/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • Game buttons: 1 to 9
  • P1 Keypad: 1 to 9, Keypad Insert Card
"},{"location":"games/bemani/popn/peace/setup/#overlay","title":"Overlay","text":"

Modifying buttons in this section is not required but you are free to change what you want.

Click on Bind then press the key you want associated with the action.

"},{"location":"games/bemani/popn/peace/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through spice2x.

If it does, here's how you may link different actions to your lights:

  • Click Bind.
  • In Device, pick your controller.
  • In Light Control, select the corresponding light.
  • Click Close.
  • Repeat for your other lights.
"},{"location":"games/bemani/popn/peace/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section.

"},{"location":"games/bemani/popn/peace/setup/#patches","title":"Patches","text":"

Go through the Spice2x Patching page to import patches.

To prevent issues, avoid patching things you don't need or understand.

"},{"location":"games/bemani/popn/peace/setup/#api","title":"API","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/popn/peace/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the question mark at the very left.

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Network EA Service URL -url Covered in Connecting to a network

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/popn/peace/setup/#advanced-development","title":"Advanced & Development","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/popn/peace/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/popn/peace/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run spice.exe, press Yes when it asks for elevated privileges.

The game will go through a series of checks, let it run, if you've done everything properly they'll pass.

"},{"location":"games/bemani/popn/peace/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/bemani/popn/peace/troubleshooting/","title":"Troubleshooting (pop'n music peace)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/popn/peace/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch","text":"

Some monitors and display adapters may not support the odd resolution that the game runs at, which is 1360x768 as opposed to the occasionally seen 1366x768. To resolve this, set a custom resolution in your graphics card's settings, or enable GPU resolution scaling.

"},{"location":"games/bemani/popn/peace/troubleshooting/#my-game-is-too-slowfast","title":"My game is too slow/fast","text":"

Potential causes:

  1. The game could be running over/under its required refresh rate (60) To solve this, make sure v-sync isn't disabled in your graphics card's settings. For NVIDIA users, enable NVIDIA profile optimization (-nvprofile) in the Options tab. You can also set Force Refresh Rate to 60.
  2. It could be that your computer's performance isn't good enough to keep a steady framerate.
"},{"location":"games/bemani/popn/peace/troubleshooting/#my-game-doesnt-have-audio","title":"My game doesn't have audio","text":"

Enable the HDMI Audio Fix patch.

"},{"location":"games/bemani/popn/unilab/setup/","title":"Game Setup (pop'n music UniLab)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/popn/unilab/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure with a few folders only, as follows.

If your data doesn't look like this

If you're missing the dev folder, you can safely ignore it as it'll be created by spice2x automatically.

If you're missing the modules folder and instead have bunch of .dll files next to your folders:

  • Create a modules folder.
  • Move all .dll files inside of it so you end up with a structure as shown above.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

If you don't need to update your data, you can skip over to the Installing Spice2x section.

"},{"location":"games/bemani/popn/unilab/setup/#updating-data","title":"Updating data","text":"Please make sure you're using the right update for your current data.

pop'n music patches re-uploaded by the community tend to be appropriately named M39-DATECODE-to-DATECODE.

For example M39-2024073100-to-2024091700.

  • 2024073100 being your current data's version.
  • 2024091700 being the one you would arrive at.
  • Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.
  • Open prop\\ea3-config.xml in a text editor and find the following lines near the top.
    <soft>\n        <model __type=\"str\">M39</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">A</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024091700</ext>\n    </soft>\n

On the line with <ext __type=\"str\"> the datecode needs to match your new version.

  • If that's already the case then great! Don't touch anything.
  • If it instead corresponds to your pre-patch datecode, replace it with the new one and save the file.
"},{"location":"games/bemani/popn/unilab/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice.exe and spicecfg.exe files from the archive to your game's directory.

"},{"location":"games/bemani/popn/unilab/setup/#configuring-spice2x","title":"Configuring Spice2x","text":"

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/popn/unilab/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • Game buttons: 1 to 9
  • P1 Keypad: 1 to 9, Keypad Insert Card
"},{"location":"games/bemani/popn/unilab/setup/#overlay","title":"Overlay","text":"

Modifying buttons in this section is not required but you are free to change what you want.

Click on Bind then press the key you want associated with the action.

"},{"location":"games/bemani/popn/unilab/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through spice2x.

If it does, here's how you may link different actions to your lights:

  • Click Bind.
  • In Device, pick your controller.
  • In Light Control, select the corresponding light.
  • Click Close.
  • Repeat for your other lights.
"},{"location":"games/bemani/popn/unilab/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section.

"},{"location":"games/bemani/popn/unilab/setup/#patches","title":"Patches","text":"

Go through the Spice2x Patching page to import patches.

To prevent issues, avoid patching things you don't need or understand.

"},{"location":"games/bemani/popn/unilab/setup/#api","title":"API","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/popn/unilab/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the question mark at the very left.

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Network EA Service URL -url Covered in Connecting to a network

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/popn/unilab/setup/#advanced-development","title":"Advanced & Development","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/popn/unilab/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/popn/unilab/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run spice.exe, press Yes when it asks for elevated privileges.

The game will go through a series of checks, let it run, if you've done everything properly they'll pass.

"},{"location":"games/bemani/popn/unilab/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/bemani/popn/unilab/troubleshooting/","title":"Troubleshooting (pop'n music UniLab)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/popn/unilab/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch","text":"

Some monitors and display adapters may not support the odd resolution that the game runs at, which is 1360x768 as opposed to the occasionally seen 1366x768. To resolve this, set a custom resolution in your graphics card's settings, or enable GPU resolution scaling.

"},{"location":"games/bemani/popn/unilab/troubleshooting/#my-game-is-too-slowfast","title":"My game is too slow/fast","text":"

Potential causes:

  1. The game could be running over/under its required refresh rate (60) To solve this, make sure v-sync isn't disabled in your graphics card's settings. For NVIDIA users, enable NVIDIA profile optimization (-nvprofile) in the Options tab. You can also set Force Refresh Rate to 60.
  2. It could be that your computer's performance isn't good enough to keep a steady framerate.
"},{"location":"games/bemani/popn/unilab/troubleshooting/#my-game-doesnt-have-audio","title":"My game doesn't have audio","text":"

Enable the HDMI Audio Fix patch.

"},{"location":"games/bemani/popn/usaneko/setup/","title":"Game Setup (pop'n music Usaneko)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/popn/usaneko/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure with a few folders only, as follows.

If your data doesn't look like this

If you're missing the dev folder, you can safely ignore it as it'll be created by spice2x automatically.

If you're missing the modules folder and instead have bunch of .dll files next to your folders:

  • Create a modules folder.
  • Move all .dll files inside of it so you end up with a structure as shown above.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

If you don't need to update your data, you can skip over to the Installing Spice2x section.

"},{"location":"games/bemani/popn/usaneko/setup/#updating-data","title":"Updating data","text":"Please make sure you're using the right update for your current data.

pop'n music patches re-uploaded by the community tend to be appropriately named M39-DATECODE-to-DATECODE.

For example M39-2024073100-to-2024091700.

  • 2024073100 being your current data's version.
  • 2024091700 being the one you would arrive at.
  • Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.
  • Open prop\\ea3-config.xml in a text editor and find the following lines near the top.
    <soft>\n        <model __type=\"str\">M39</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">A</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024091700</ext>\n    </soft>\n

On the line with <ext __type=\"str\"> the datecode needs to match your new version.

  • If that's already the case then great! Don't touch anything.
  • If it instead corresponds to your pre-patch datecode, replace it with the new one and save the file.
"},{"location":"games/bemani/popn/usaneko/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice.exe and spicecfg.exe files from the archive to your game's directory.

"},{"location":"games/bemani/popn/usaneko/setup/#configuring-spice2x","title":"Configuring Spice2x","text":"

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/popn/usaneko/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • Game buttons: 1 to 9
  • P1 Keypad: 1 to 9, Keypad Insert Card
"},{"location":"games/bemani/popn/usaneko/setup/#overlay","title":"Overlay","text":"

Modifying buttons in this section is not required but you are free to change what you want.

Click on Bind then press the key you want associated with the action.

"},{"location":"games/bemani/popn/usaneko/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through spice2x.

If it does, here's how you may link different actions to your lights:

  • Click Bind.
  • In Device, pick your controller.
  • In Light Control, select the corresponding light.
  • Click Close.
  • Repeat for your other lights.
"},{"location":"games/bemani/popn/usaneko/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section.

"},{"location":"games/bemani/popn/usaneko/setup/#patches","title":"Patches","text":"

Go through the Spice2x Patching page to import patches.

To prevent issues, avoid patching things you don't need or understand.

"},{"location":"games/bemani/popn/usaneko/setup/#api","title":"API","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/popn/usaneko/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the question mark at the very left.

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Network EA Service URL -url Covered in Connecting to a network

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/popn/usaneko/setup/#advanced-development","title":"Advanced & Development","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/popn/usaneko/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/popn/usaneko/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run spice.exe, press Yes when it asks for elevated privileges.

The game will go through a series of checks, let it run, if you've done everything properly they'll pass.

"},{"location":"games/bemani/popn/usaneko/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/bemani/popn/usaneko/troubleshooting/","title":"Troubleshooting (pop'n music Usaneko)","text":"

Warning

Please make sure you downloaded your data from an appropriate source. This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/popn/usaneko/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch","text":"

Some monitors and display adapters may not support the odd resolution that the game runs at, which is 1360x768 as opposed to the occasionally seen 1366x768. To resolve this, set a custom resolution in your graphics card's settings, or enable GPU resolution scaling.

"},{"location":"games/bemani/popn/usaneko/troubleshooting/#my-game-is-too-slowfast","title":"My game is too slow/fast","text":"

Potential causes:

  1. The game could be running over/under its required refresh rate (60) To solve this, make sure v-sync isn't disabled in your graphics card's settings. For NVIDIA users, enable NVIDIA profile optimization (-nvprofile) in the Options tab. You can also set Force Refresh Rate to 60.
  2. It could be that your computer's performance isn't good enough to keep a steady framerate.
"},{"location":"games/bemani/popn/usaneko/troubleshooting/#my-game-doesnt-have-audio","title":"My game doesn't have audio","text":"

Enable the HDMI Audio Fix patch.

"},{"location":"games/bemani/reflecbeat/reflesia/setup/","title":"REFLEC BEAT: The Reflesia of Eternity","text":"

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.

"},{"location":"games/bemani/reflecbeat/reflesia/setup/#getting-started","title":"Getting Started","text":"

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.

"},{"location":"games/bemani/reflecbeat/reflesia/setup/#configuring-your-tools","title":"Configuring Your Tools","text":"

Now that you have your files ready, open up your .bat file in your desired text editor (we're using Notepad++) 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.

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.

"},{"location":"games/bemani/reflecbeat/reflesia/setup/#configuring-for-a-local-network","title":"Configuring for a Local Network","text":"

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!
"},{"location":"games/bemani/reflecbeat/reflesia/setup/#configuring-for-an-online-network","title":"Configuring for an Online Network","text":"

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!

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.

"},{"location":"games/bemani/reflecbeat/reflesia/setup/#final-steps-and-setting-up-the-game","title":"Final Steps and Setting up the Game","text":"

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.

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.

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!

Have any other errors?

Check out the Troubleshooting section and Error Code section to resolve any issues not seen in this guide to greater depth.

"},{"location":"games/bemani/reflecbeat/reflesia/troubleshooting/","title":"REFLEC BEAT: Reflesia","text":""},{"location":"games/bemani/reflecbeat/reflesia/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

Bemani PC (ADE-704A)

CPU: Intel Celeron B810 1.6GHz

GPU: E4690 Radeon MXM

OS: Windows XP Embedded

"},{"location":"games/bemani/reflecbeat/reflesia/troubleshooting/#my-game-doesnt-boot-after-following-the-guide","title":"My Game Doesn't Boot After Following the Guide!","text":"

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 patch.

"},{"location":"games/bemani/reflecbeat/reflesia/troubleshooting/#my-game-is-running-slowlagging","title":"My Game Is Running Slow/Lagging","text":"

Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.

"},{"location":"games/bemani/reflecbeat/reflesia/troubleshooting/#my-game-is-running-crazy-fastafter-finishing-a-song-loading-is-stuck","title":"My Game Is Running Crazy Fast/After Finishing a Song Loading Is Stuck","text":"

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.

"},{"location":"games/bemani/reflecbeat/reflesia/troubleshooting/#which-offset-is-which","title":"Which Offset Is Which?","text":"

If you're getting too many fasts, increase your offset (+). If you're getting too many slows, decrease your offset (-).

"},{"location":"games/bemani/reflecbeat/reflesia/troubleshooting/#failed-to-create-texture-error-in-spicetools","title":"Failed to Create Texture Error in SpiceTools","text":"

If your error is along the lines of a failure to create a texture W:afputils: CTexture::create_texture \u30c6\u30af\u30b9\u30c1\u30e3\u306e\u4f5c\u6210\u306b\u5931\u6557\u3057\u307e\u3057\u305f\u3002 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.

"},{"location":"games/bemani/reflecbeat/reflesia/troubleshooting/#i-get-a-white-screen-that-silently-closes-after-a-few-seconds","title":"I Get a White Screen That Silently Closes After a Few Seconds","text":"

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.

"},{"location":"games/bemani/sdvx/4_heavenlyhaven/setup/","title":"SOUND VOLTEX IV HEAVENLY HAVEN","text":"

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.

"},{"location":"games/bemani/sdvx/4_heavenlyhaven/setup/#getting-started","title":"Getting Started","text":"

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.

"},{"location":"games/bemani/sdvx/4_heavenlyhaven/setup/#configuring-your-tools","title":"Configuring Your Tools","text":"

Now that you have your files ready, open up your .bat file in your desired text editor (we're using Notepad++) 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.

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.

"},{"location":"games/bemani/sdvx/4_heavenlyhaven/setup/#configuring-for-a-local-network","title":"Configuring for a Local Network","text":"

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++.

"},{"location":"games/bemani/sdvx/4_heavenlyhaven/setup/#configuring-for-an-online-network","title":"Configuring for an Online Network","text":"

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++.

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.

"},{"location":"games/bemani/sdvx/4_heavenlyhaven/setup/#final-steps-and-setting-up-the-game","title":"Final Steps and Setting up the Game","text":"

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.

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!

Have any other errors?

Check out the Troubleshooting section and Error Code section to resolve any issues not seen in this guide to greater depth.

"},{"location":"games/bemani/sdvx/4_heavenlyhaven/troubleshooting/","title":"SDVX IV Troubleshooting","text":""},{"location":"games/bemani/sdvx/4_heavenlyhaven/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

Bemani PC Type 4

CPU: Celeron M 440 1.86GHz

GPU: ATI Radeon HD 2400

RAM: 2 GB

OS: Windows XP Embedded

"},{"location":"games/bemani/sdvx/4_heavenlyhaven/troubleshooting/#my-game-is-running-slowlagging","title":"My Game Is Running Slow/Lagging","text":"

Make sure you at least meet the above hardware requirements, try to eliminate any unnecessary background processes during play as well.

"},{"location":"games/bemani/sdvx/4_heavenlyhaven/troubleshooting/#my-game-is-running-crazy-fastafter-finishing-a-song-loading-is-stuck","title":"My Game Is Running Crazy Fast/After Finishing a Song Loading Is Stuck","text":"

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.

"},{"location":"games/bemani/sdvx/4_heavenlyhaven/troubleshooting/#which-offset-is-which","title":"Which Offset Is Which?","text":"

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.

"},{"location":"games/bemani/sdvx/4_heavenlyhaven/troubleshooting/#running-the-game-windowed-and-borderless","title":"Running the Game Windowed and Borderless","text":"

Some players utilizing windowed mode use 3rd party software called Borderless Gaming in order to achieve this, follow the program's instructions accordingly.

"},{"location":"games/bemani/sdvx/4_heavenlyhaven/troubleshooting/#where-are-all-the-navigators","title":"Where Are All the Navigators?","text":"

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.

"},{"location":"games/bemani/sdvx/5_vividwave/setup/","title":"SOUND VOLTEX VIVID WAVE","text":"

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.

"},{"location":"games/bemani/sdvx/5_vividwave/setup/#getting-started","title":"Getting Started","text":"

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.

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.

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!

"},{"location":"games/bemani/sdvx/5_vividwave/setup/#configuring-your-tools","title":"Configuring Your Tools","text":"

Now that you have your files ready, open up your .bat file in your desired text editor (we're using Notepad++) 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.

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.

"},{"location":"games/bemani/sdvx/5_vividwave/setup/#configuring-for-a-local-network","title":"Configuring for a Local Network","text":"

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!
"},{"location":"games/bemani/sdvx/5_vividwave/setup/#configuring-for-an-online-network","title":"Configuring for an Online Network","text":"

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!

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.

"},{"location":"games/bemani/sdvx/5_vividwave/setup/#final-steps-and-setting-up-the-game","title":"Final Steps and Setting up the Game","text":"

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.

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!

Have any other errors?

Check out the Troubleshooting section and Error Code section to resolve any issues not seen in this guide to greater depth.

"},{"location":"games/bemani/sdvx/5_vividwave/troubleshooting/","title":"SDVX VW Troubleshooting","text":""},{"location":"games/bemani/sdvx/5_vividwave/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

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

"},{"location":"games/bemani/sdvx/5_vividwave/troubleshooting/#my-game-is-running-slowlagging","title":"My Game Is Running Slow/Lagging","text":"

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.

"},{"location":"games/bemani/sdvx/5_vividwave/troubleshooting/#my-game-is-running-crazy-fastafter-finishing-a-song-loading-is-stuck","title":"My Game Is Running Crazy Fast/After Finishing a Song Loading Is Stuck","text":"

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.

"},{"location":"games/bemani/sdvx/5_vividwave/troubleshooting/#which-offset-is-which","title":"Which Offset Is Which?","text":"

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.

"},{"location":"games/bemani/sdvx/5_vividwave/troubleshooting/#running-the-game-windowed-and-borderless","title":"Running the Game Windowed and Borderless","text":"

Some players utilizing windowed mode use 3rd party software called Borderless Gaming in order to achieve this, follow the program's instructions accordingly.

"},{"location":"games/bemani/sdvx/5_vividwave/troubleshooting/#where-are-all-the-navigators","title":"Where Are All the Navigators?","text":"

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.

"},{"location":"games/bemani/sdvx/5_vividwave/troubleshooting/#a-note-about-sse-42","title":"A Note About SSE 4.2","text":"

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. But, in the event your processor does not have this, there is a patch available to bypass this.

"},{"location":"games/bemani/sdvx/5_vividwave/troubleshooting/#when-i-run-this-game-all-other-background-audio-is-gone-whats-going-on","title":"When I Run This Game All Other Background Audio Is Gone! What's Going On?","text":"

64-bit versions of SDVX are now utilizing a feature in Windows called WASAPI exclusive mode to obtain less audio latency than the former 32-bit versions of the games which used DirectSound. You can use the Shared Mode WASAPI patch 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.

"},{"location":"games/bemani/sdvx/5_vividwave/troubleshooting/#im-not-getting-any-audiomy-audio-is-completely-wrecked-and-im-using-an-external-dac","title":"I'm Not Getting Any Audio/My Audio Is Completely Wrecked and I'm Using an External Dac!","text":"

Several external DACs have issues with WASAPI exclusive mode 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 patch.

"},{"location":"games/bemani/sdvx/6_exceedgear/extras/","title":"SOUND VOLTEX EXCEED GEAR","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/sdvx/6_exceedgear/extras/#nemsys-valkyrie-modes","title":"Nemsys & Valkyrie modes","text":"

Valkyrie mode requires a 120hz capable monitor, or to have patched your .dll with Valkyrie Mode 60hz.

To make use of the Valkyrie Mode (Subscreen, 120FPS, S-CRITICAL..) you need to go to the contents\\prop folder and edit the ea3-config.xml file.

We're interested in these lines:

    <soft>\n        <model __type=\"str\">KFC</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">G</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024052100</ext>\n    </soft>\n

This is the line that determines if the game will run in Nemsys (60 FPS) or Valkyrie (120 FPS) mode.

<spec __type=\"str\">G</spec>\n

Use:

  • F for Nemsys
  • G for Valkyrie
"},{"location":"games/bemani/sdvx/6_exceedgear/extras/#changing-the-games-language","title":"Changing the game's language","text":"

Go to the contents\\prop folder and edit the ea3-config.xml file.

We're interested in these lines:

    <soft>\n        <model __type=\"str\">KFC</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">G</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024052100</ext>\n    </soft>\n

This is the line that determines which region, and therefore which language the game will use.

<dest __type=\"str\">J</dest>\n

Use:

  • J for Japan (Japanese)
  • K for Korea (Korean + some censored jackets)
  • A for Asia/Australia (English)
  • U for America (English + some censoring in recent versions)
  • Y for Indonesia
"},{"location":"games/bemani/sdvx/6_exceedgear/extras/#more-about-ea3-configxml","title":"More about ea3-config.xml","text":"

The ea3-config.xml file is located inside the prop folder.

Below is an explanation on what different sections of this file do.

The following lines change the PCBID and HARDID that your system reports to your e-amusement server. There is no need to manually change this as spice2x will do it for us.

<pcbid __type=\"str\">00010203040506070809</pcbid>\n<hardid __type=\"str\">00010203040506070809</hardid>\n

The following line determines what version of the game you are running. You should never change this. It should always say KFC.

<model __type=\"str\">KFC</model>\n

You should never change this. It should always say A for Exceed Gear.

<rev __type=\"str\">A</rev>\n

The following line determines your datecode. Always keep it up to date with your game's current version.

<ext __type=\"str\">2024052100</ext>\n

The following line determine what remote service URL spice2x is supposed to connect to. There is no need to manually change this as spice2x will do it for us.

<services __type=\"str\">http://localhost:8083</services>\n
"},{"location":"games/bemani/sdvx/6_exceedgear/setup/","title":"SOUND VOLTEX EXCEED GEAR","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#preparing-data","title":"Preparing data","text":"

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure with a few folders only, as follows.

If your data doesn't look like this

If you're missing the modules folder and instead have bunch of .dll files next to your folders:

  • Create a modules folder.
  • Move all .dll files inside of it so you end up with a structure as shown above.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

If you don't need to update your data, you can skip over to the Installing Spice2x section.

"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#updating-data","title":"Updating data","text":"Please make sure you're using the right update for your current data.

SDVX Patches re-uploaded by the community tend to be appropriately named KFC-DATECODE-to-DATECODE.

For example KFC-2024043000-to-2024052100.

  • 2024043000 being your current data's version.
  • 2024052100 being the one you would arrive at.
  • Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.
  • Open prop\\ea3-config.xml in a text editor and find the following lines near the top.
    <soft>\n        <model __type=\"str\">KFC</model>\n        <dest __type=\"str\">J</dest>\n        <spec __type=\"str\">G</spec>\n        <rev __type=\"str\">A</rev>\n        <ext __type=\"str\">2024052100</ext>\n    </soft>\n

On the line with <ext __type=\"str\"> the datecode needs to match your new version.

  • If that's already the case then great! Don't touch anything.
  • If it instead corresponds to our pre-patch datecode, replace it with the new one and save the file.
"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#installing-spice2x","title":"Installing Spice2x","text":"

If you already have Spice2x installed, make sure it is up to date!

  • Head over to spice2x.github.io and download the latest release.
  • Extract the spice64.exe and spicecfg.exe files from the archive to your game's directory.

If you're using an AMD graphics card

A few more files are required to make your game work with AMD as the game was built for NVIDIA.

  • From the spice2x archive, extract the .dll files found in spice2x\\stubs\\64\\ to your data's modules folder.

"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#configuring-spice2x","title":"Configuring Spice2x","text":"

Open spicecfg.exe, each following sub-section corresponds to a tab at the top.

"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#buttons","title":"Buttons","text":"

Click on Bind then press the key you want associated with the action.

With your controller and/or keyboard plugged in, configure your keys for:

  • Maintenance: Service, Test
  • Game buttons: BT-A, BT-B, BT-C, BT-D, FX-L, FX-R, Start
  • P1 Keypad: Keypad 0 to 9, Keypad Insert Card

Only if you're playing using a keyboard:

  • Knobs: VOL-L Left, VOL-L Right, VOL-R Left, Vol-R Right
"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#analogs-controllercab-only","title":"Analogs (controller/cab only)","text":"

With a controller rather than binding buttons to VOL-L and VOL-R, you need to:

  • Click Bind.
  • In Device, pick your controller.
  • In Control, pick X for VOL-L or Y for VOL-R.
  • Turn your knob ensuring that the Preview knob turns along with it.
  • Click Close, leaving the rest of the settings alone.
  • Repeat for your other knob.
"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#overlay","title":"Overlay","text":"

Modifying buttons in this section is not required but you are free to change what you want.

Click on Bind then press the key you want associated with the action.

"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#lights-controllercab-only","title":"Lights (controller/cab only)","text":"

Your controller might support having its lights controlled by the game through spice2x.

If it does, here's how you may link different actions to your lights:

  • Click Bind.
  • In Device, pick your controller.
  • In Light Control, select the corresponding light.
  • Click Close.
  • Repeat for your other lights.
"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section.

"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#patches","title":"Patches","text":"

Go through the Spice2x Patching page to import patches.

Ever since the 2024-09-10 update, patches have a description built-in to them.

To view it, hover-over the (?) or (!) to the left of each patch's name.

To prevent issues, avoid patching things you don't need or understand.

"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#api","title":"API","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the question mark at the very left.

Be very careful changing options you don't understand as it may cause issues.

Required

Category Option Parameter Setting Game Options SDVX Disable Cameras -sdvxdisablecams ON Network EA Service URL -url Covered in Connecting to a network

Highly Recommended for NVIDIA users ONLY

Category Option Parameter Setting Graphics (common) NVIDIA profile optimization -nvprofile ON"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#advanced-development","title":"Advanced & Development","text":"

Leave everything at default unless you know what you're doing.

"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Open spicecfg.exe and head to the Options tab.

In the Network category, set the following settings:

  • EA Service URL to the URL provided by your network.
  • PCBID to the PCBID provided by your network.

Next you need a card number. If you don't already have one, generate one in the Cards tab. To keep your card number safe, create a new .txt file with ONLY it inside.

Once that's done, head to the Cards tab, for Player 1 click Open... and point to your text file.

Local e-amuse Emulator (Asphyxia)

This is covered in the Asphyxia CORE page.

"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#audio","title":"Audio","text":"
  • Open spicecfg.exe.
  • At the very top, click on Shortcuts then Audio Playback Devices.
  • In the popup window, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick the 16 bit, 44100 Hz (CD Quality) option and click Apply then OK.
"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#monitor-orientation","title":"Monitor orientation","text":"

Before each play session, you will have to make sure your monitor is in Portrait or Portrait (flipped) mode.

To do so:

  • Right click on your desktop.
  • Click Display Options.
  • Look for Display orientation and set it to Portrait or Portrait (flipped).

  • Rotate your monitor vertically.
"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#valkyrie-nemsys-language-settings","title":"Valkyrie / Nemsys / Language settings","text":"

Read through the Extra Information page and edit your prop\\ea3-config.xml file if necessary.

"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

If you've followed all instructions correctly, you're now finally ready to launch the game!

First plug your controller if you have one and run spice64.exe, press Yes when it asks for elevated privileges.

The game will go through a series of checks, let it run, if you've done everything properly they'll pass.

"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#calibration","title":"Calibration","text":"

If you're seeing this screen, it means you need to calibrate your knobs.

Press your Test key. The game will instruct you where to navigate inside the menu.

  • Press BT-A to go up.
  • Press BT-B to go down.
  • Press Start to select.

Select I/O CHECK and press Start.

Select CALIBRATION SETTINGS and press Start.

Select CALIBRATION and press Start.

First, your left knob (VOL-L for keyboard players)

  1. Slowly turn your LEFT knob counterclockwise (VOL-L Left) until the first line says COUNT = OK.
  2. Press Start.
  3. Slowly turn your LEFT knob clockwise (VOL-L Right) until the first line says COUNT = OK.
  4. Press Start.

Now same thing but for the right knob (VOL-R for keyboard players)

  1. Slowly turn your RIGHT knob counterclockwise (VOL-R Left) until the first line says COUNT = OK.
  2. Press Start.
  3. Slowly turn your RIGHT knob clockwise (VOL-R Right) until the first line says COUNT = OK.
  4. Press Start.

Select SAVE AND EXIT and press Start.

Select GAME MODE and press Start.

You're all done! The game should load up properly now.

"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#carding-in","title":"Carding in","text":"

Once the game is done loading, you need to card in.

  • Press your Keypad Insert Card button.
  • Enter your code using your keypad binds.
"},{"location":"games/bemani/sdvx/6_exceedgear/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

For any more game-specific information, check out Extra Information.

"},{"location":"games/bemani/sdvx/6_exceedgear/troubleshooting/","title":"SOUND VOLTEX EXCEED GEAR","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/bemani/sdvx/6_exceedgear/troubleshooting/#im-having-performance-issues","title":"I'm having performance issues!","text":"

If you're having performance issues of some kind, spice2x's PC optimization guide is worth looking at.

"},{"location":"games/bemani/sdvx/6_exceedgear/troubleshooting/#my-game-is-running-slowfast-after-finishing-a-song-the-game-gets-stuck-loading","title":"My game is running slow/fast, After finishing a song the game gets stuck loading!","text":"

The most common reason for this is the game is running over its required refresh rate. To solve this, make sure v-sync isn't disabled in your graphics card's settings.

For NVIDIA users, enable NVIDIA profile optimization (-nvprofile) in the Options tab.

"},{"location":"games/bemani/sdvx/6_exceedgear/troubleshooting/#how-do-i-set-my-offset","title":"How do I set my offset?","text":"

Play through a chart you're comfortable with.

If you're getting too many Late, decrease your offset (-). If you're getting too many Early, increase your offset (+).

Sound Voltex Exceed Gear has two types of offset adjustments, visual and audio based, so be sure to fiddle with both to find desirable settings.

"},{"location":"games/bemani/sdvx/6_exceedgear/troubleshooting/#how-do-i-run-the-game-windowed-borderless","title":"How do I run the game windowed borderless?","text":"

Some players utilize windowed mode and use 3rd party software called Borderless Gaming in order to achieve this, follow the program's instructions accordingly.

"},{"location":"games/bemani/sdvx/6_exceedgear/troubleshooting/#where-are-all-the-navigators","title":"Where are all the navigators?","text":"

Many navigators are locked behind network requirements and they will not show unless connected to a network that has written support for the events they're typically locked behind.

"},{"location":"games/bemani/sdvx/6_exceedgear/troubleshooting/#my-game-audio-is-super-quiet","title":"My game audio is super quiet!","text":"

Press your Test key to enter its menu, go to SOUND OPTIONS and change the volume from 20 to 30.

"},{"location":"games/bemani/sdvx/6_exceedgear/troubleshooting/#when-i-run-the-game-all-other-audio-is-gone","title":"When I run the game all other audio is gone!","text":"

Sound Voltex Exceed Gear uses WASAPI exclusive mode for audio to get better audio latency. Unlike former versions of the games which used DirectSound.

You can use the Shared Mode WASAPI patch to deal with some hardware issues, it can also be used to hear audio outside the game at the cost of audio latency.

"},{"location":"games/bemani/sdvx/6_exceedgear/troubleshooting/#im-not-getting-any-audio-my-game-crashes-due-to-audio","title":"I'm not getting any audio / My game crashes due to audio","text":"

Many setups have found some difficulty with audio due to various equipment being used. Consider using the Shared Mode WASAPI patch.

"},{"location":"games/namco/taikonijiiro/setup/","title":"Taiko no Tatsujin Nijiiro","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/namco/taikonijiiro/setup/#preparing-data","title":"Preparing data","text":"

Taiko is generally distributed as a single folder. For Nijiiro, this will be SBWY 39.06. The game folder should contain an AMCUS, Data and Executable folder.

Nijiiro is a rolling release so please verify your game version by opening AMCUS\\AMConfig.ini and verifying that it says cacfg-game_ver=39.06

NAMCO data is also distributed as .VHDX and .VHD files. These files are useful for archival purposes, but are not required to run the game. Always download the unpacked data for home use.

"},{"location":"games/namco/taikonijiiro/setup/#installing-taikoarcadeloader-tal","title":"Installing TaikoArcadeLoader (TAL)","text":"

TaikoArcadeLoader:

TaikoArcadeLoader is a loader and hardware emulator for Nijiiro. It will allow us to launch the game, as well as configure inputs and network settings. More information can be found at the TAL github page.

  • Download the latest version of TAL from the actions tab of the TAL page. This will be a file named TaikoArcadeLoader. You will need to be logged into github to download this file.

  • Copy the files from TaikoArcadeLoader.zip to your Executable/Release folder. When asked, choose to replace the existing files with the newly copied files.

"},{"location":"games/namco/taikonijiiro/setup/#configuring-taikoarcadeloader","title":"Configuring TaikoArcadeLoader","text":"

The configuration information for TaikoArcadeLoader is stored within config.toml.

Open up config.toml with a text editor of your choice. We'll be using Notepad++.

config.toml is separated into several sections, indicated by the section name in [square brackets]

Information for this can be found at the TAL github page.

The [amauth] section contains network related config

  • server = can be left default if playing on a local server or offline but it is recommend to play on an online network.
  • port = do not change unless you know what you are doing.
  • chassis_id = do not change unless you know what you are doing.
  • shop_id = mostly visual. change if you want to.
  • game_ver = mostly visual. change if you want to.
  • country_code = do not change unless you know what you are doing. 
[amauth]\nserver = \"127.0.0.1\"\nport = \"54430\"\nchassis_id = \"284111080000\"\nshop_id = \"TWO-TORIAL\"\ngame_ver = \"39.06\"\ncountry_code = \"JPN\"\n

The [graphics] section contains patches

  • res = change to your display's resolution.
  • windowed = set to true if you want to run the game in windowed.
  • cursor = mostly visual. change if you want to.
  • vsync = set to true if your display is set to 120hz.
  • fpslimit = do not change unless you know what you are doing.
  • model_res_rate = do not change unless you know what you are doing.
[graphics]\nres = { x = 1920, y = 1080 }\nwindowed = false\ncursor = true\nvsync = false\n# fpslimit = 0\nmodel_res_rate = 1.0\n

The [keyboard] section contains keyboard related config

  • auto_ime = if set to true, changes your keyboard layout to Qwerty until the game is closed.
  • jp_layout = should be set to true for actual japanese keyboards.
[keyboard]\nauto_ime = false\njp_layout = false\n
"},{"location":"games/namco/taikonijiiro/setup/#configuring-inputs","title":"Configuring Inputs","text":"

Depending on the input method you choose, the configuration for them can change slightly. Below are all the input methods available and how to set them up.

Keyboard

Keyboard is the default input method.

The default layout uses:

  • DF JK for the P1 drum input
  • ZX CV for the P2 drum input
  • P to Insert Card
  • F2 to SERVICE
  • Enter to add coins

If you wish to view or change all the default keybinds, you can do so in keyconfig.toml

Controller

The setup for both drum and normal controllers is the same.

  • In config.toml set wait_period = to 0
  • If you are using a controller that does not use keyboard inputs, you need to set SDL keybinds in keyconfig.toml
  • When you're using an analog input for the drums, you need to set analog_input = false to true in config.toml

A list of valid SDL inputs can be found at the bottom of keyconfig.toml

If you're using 2 controllers, use JoyToKey and remove SDL inputs from keyconfig.toml

Physical Card Readers

You can insert your card with physical card readers. If you happen to have one, you can set them up to use them for Taiko no Tatsujin Nijiiro.

AIC Pico
  • In config.toml set card_reader = to false.
  • Update to the latest firmware
  • Inside AMFWConfig.ini change COM4 to the port of your AIC Pico
ACR122U
  • In config.toml set card_reader = to true.
  • Use AkaiiKitsune's tal-cardreader plugin

If you don't have a physical card reader, you can skip over to the Networks section

"},{"location":"games/namco/taikonijiiro/setup/#networks","title":"Networks","text":"

Please choose one of the two solutions, not both!

Online Hosted Servers (Recommended)

There are a few online hosted servers that support Nijiiro, however most of them are currently invite only. Ask your friends where they play, and maybe they'll invite you!

Elara Global Taiko Server

EGTS is the only public Nijiiro server that also comes with an Omnimix verison that includes custom songs and songs from other Taiko games.

Self Hosted Local Servers (Complex)

If you wish to run the game locally, but with the ability to create and save a profile, you can run a server on the same computer you are playing the game on. This server will need to be running before you launch the game, however it can be shut down when you are no longer playing.

Any provided setup instructions are likely to become outdated rather quickly.

Please refer to the included setup instructions on each projects respective web page.

  • TLS - A network service emulator for Nijiiro. Setup can be complex as you are required to build TLS from source using VisualStudio and .sln files.
"},{"location":"games/namco/taikonijiiro/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/namco/taikonijiiro/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/namco/taikonijiiro/setup/#first-launch","title":"First Launch","text":"

Run Taiko.exe to start the game.

Enter the I/O setup screen by pressing F1 on the Attract screen then using the arrow keys and Enter, navigate to I/O TEST -> TAIKO TEST. Adjust these settings to your liking as they vary between controllers and keyboards. If you are unsure just leave the defaults as is.

If you would like to adjust patch settings enter the test menu by pressing F1 on the Attract screen then using the arrow keys and Enter, navigate to MOD MANAGER.

You're all done! The game should load up properly now.

"},{"location":"games/namco/taikonijiiro/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting page.

"},{"location":"games/namco/taikonijiiro/troubleshooting/","title":"Taiko no Tatsujin Nijiiro Troubleshooting","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/namco/taikonijiiro/troubleshooting/#changing-the-language","title":"Changing the Language","text":"

Nijiiro supports changing the language from the test menu. The officially supported languages are:

  • Japanese (Default)
  • English
  • Chinese (zh-TW)
  • Korean

An unofficial mod allows you to change the language to Chinese (simplified), this can be found on the Discord.

Using F1, the arrow keys and Enter, navigate to OTHERS -> LANGUAGE

"},{"location":"games/namco/taikonijiiro/troubleshooting/#my-game-is-frozenblack-screen","title":"My game is frozen/black screen","text":"

You can fix this by running the game as admin. You can also try updating windows and gpu drivers.

"},{"location":"games/namco/taikonijiiro/troubleshooting/#my-game-takes-a-long-time-to-boot","title":"My game takes a long time to boot","text":"

First boot after connecting to a network will be very long (>90s)

The game files for Nijiiro consists of thousands of small .bin files and Windows Defender is known to spend a long time scanning through them during game boot up.

One way to massively speed up boot times is to add the entire game folder as a Windows Defender Exception.

Doing this will prevent Defender from scanning your game folder for viruses.

Only do this if you trust the source of your data!

  • Open Virus & threat protection.
  • Under Virus & threat protection settings click the Manage Settings button.
  • Scroll down to Exclusions and click on Add or remove exclusions.
  • Click the Add an exclusion button, select the folder option, navigate to the root of your game installation and click Select Folder.

"},{"location":"games/namco/taikonijiiro/troubleshooting/#my-game-is-running-crazy-fastslow","title":"My game is running crazy fast/slow","text":"

The game needs to be ran at 120 FPS or things will break.

If you have a display that supports 120hz or higher
  • Set your display to 120hz. You may need to make a custom resolution.
  • In config.toml set vsync = to true.
If you have a display that is less than 120hz
  • In config.toml set vsync = to false and windowed = to true.
"},{"location":"games/namco/taikonijiiro/troubleshooting/#my-game-is-not-connected-to-a-network-but-i-set-one-up","title":"My game is not connected to a network but I set one up","text":"

Disable shop close time or you won't always be able to connect to the network

Using F1 arrow keys and Enter navigate to GAME OPTIONS -> CLOCK/CLOSE TIME SETTING -> SCHEDULE TYPE.

If you are still unable to connect that means you have incorrectly configured your config.toml or your server.

"},{"location":"games/namco/taikonijiiro/troubleshooting/#my-game-is-still-too-bigsmall-after-setting-the-resolution-in-configtoml","title":"My game is still too big/small after setting the resolution in config.toml","text":"

This will happen if you incorrectly set your resolution or scale.

You can check your display resolution by right clicking your desktop and selecting Display settings.

You can set your scale to 100% right above where it says your resolution.

"},{"location":"games/namco/taikonijiiro/troubleshooting/#my-controller-is-dropping-inputs-i-cant-hit-good-drumrolls","title":"My controller is dropping inputs / I can't hit good drumrolls","text":"

This a common issue on some controllers.

In config.toml increase wait_period = by 1, then test it in-game and repeat until it feels correct.

"},{"location":"games/namco/taikonijiiro/troubleshooting/#best-settings-for-nvidia-gpus","title":"Best settings for Nvidia GPUs","text":"

This will help with latency and other issues

In NVIDIA Control Panel set the following settings for Taiko.exe.

  • Low Latency Mode Ultra
  • Power management mode Prefer maximum performance
  • Vertical sync Fast
"},{"location":"games/namco/taikonijiiro/troubleshooting/#audio","title":"Audio","text":"

By default the game will use WASAPI Shared

To use WASAPI exclusive:

  • Inside config.toml, set wasapi_shared = to false

To use ASIO in combination with FlexASIO:

  • Inside config.toml, set wasapi_shared = to false and set asio = to true.
  • Change asio_driver = to asio_driver = \"FlexASIO\"

To change FlexASIO settings refer to this.

"},{"location":"games/sega/chunithm/common/chusan/c2c/","title":"C2c","text":"

You are most likely to have success with Multiplayer when all users are using the SAME data and options, from the same sources. Verify that each person can run the game normally before attempting to network them together.

  • Chunithm expects the cabinets to be using specific IP addresses, 192.168.139.11/12/13/14
  • To achieve this over the internet, we can use SoftEther VPN. Refer to the Setting Up SoftEther VPN Guide for more information.
"},{"location":"games/sega/chunithm/common/chusan/c2c/#configuring-segatoolsini-game-assignments","title":"Configuring segatools.ini & Game Assignments","text":"

segatools.ini

[netnev]\nenable=1\naddrSuffix= last 2 digits of your SoftEther IP\n\n[keychip]\nenable=1\nsubnet=192.168.139.0\nid=(Everyone needs a seperate keychip. If you play on a remote network, chances are you already have your own keychip. If not, you can use the example keychips below.)\n;example keychips: A61E-01D02321145 ; A61E-01A30831145 ; A61E-01E38091145 ; A61E-01E46241145\n\n[system]\ndipsw1=1\n;This has changed since Luminous. Previously if you wish to perform cab-to-cab link, you need to set this to 1 on the Server machine, and 0 on all other client machines.\n;This change is no longer needed, just keep this set to 1 on all machines.\n

GAME ASSIGNMENTS

  • After saving your segatools.ini, launch the game and go into the Service Menu > and go to GAME ASSIGNMENTS.

  • Enable CABINET-TO-CABINET PLAY, and make sure all machine are on the same group (Group A for example).

  • Set one machine to STANDARD, and all other machines to FOLLOW THE STANDARD .

Exit the Service Menu and load into Attract Mode. If the game passes the Group Check then chances are you're good to go! You can now login to a credit and open a cab-to-cab link request to check if the connection is working properly!

"},{"location":"games/sega/chunithm/common/chusan/c2c/#how-to-link","title":"How to Link?","text":"

If you're new to Chunithm and have never tried link-play before and you have no idea how, keep reading.

  • Login to a credit.

  • If you're hosting a cab-to-cab session, choose a song first, then scroll to the far left and press Confirm. The cab-to-cab request is now open.

  • If you're connecting, navigate to the \"Cabinet-to-Cabinet Play\" tab and wait for other players to create a session.

If you are able to see each other's session, congrats! You can now enjoy some cab-to-cab chain action!

"},{"location":"games/sega/chunithm/common/chusan/c2c/#troubleshooting","title":"Troubleshooting","text":"

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/common/chusan/controllers/","title":"Controllers","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with IO DLLs to add support for controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\bin\\ folder and referenced in segatools.ini under the [chuniio] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; Uncomment this if you have custom chuniio implementation comprised of a single 32bit DLL.\n; (will use chu2to3 engine internally)\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.

If you have two DLLs, ending in _x86.dll and _x64.dll (or _chusan.dll and _amdaemon.dll), uncomment the path32= and path64= lines by removing the leading semicolon (;), then add your DLLs after the =:

[chuniio]\n; Uncomment both of these if you have custom chuniio implementation comprised of two DLLs.\n; x86 chuniio to path32, x64 to path64. Both are necessary.\n;(1)!\npath32=controller_x86.dll\npath64=controller_x64.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/common/chusan/controllers/#keyboard","title":"Keyboard","text":"

Keyboard is the default input method, and while not recommended for playing the game, it is useful for testing purposes.

The default layout uses SDFGHJKL for slider input, and Space Bar for the AIRs.

If you wish to change the default keybinds, an explanation on how to set these is included above the [io3] section in your segatools.ini.

"},{"location":"games/sega/chunithm/common/chusan/controllers/#brokenithm","title":"Brokenithm","text":"

Brokenithm allows you to use a mobile device as a CHUNITHM controller. It uses the bottom half of the screen as the ground slider, and sliding into the upper half activates the air sensors.

"},{"location":"games/sega/chunithm/common/chusan/controllers/#android","title":"Android","text":"

Warning

Your computer and your Android device must be on the same local network.

  • Download the latest version of Brokenithm-Android and install it on your Android device.
  • Download the latest version of Brokenithm-Android-Server and extract only brokenithm_server.exe to your App\\bin\\ folder.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run brokenithm_server.exe. A command prompt window should open, saying that it is waiting for a device on port 52468.
  • Open the Brokenithm app on your Android device. Enter your computer's IP address in the Address box on the top right, then tap Start.
  • Run the game as normal.
Getting your computer's IP address

Open Settings -> Network and Internet and select Properties. Scroll down to the bottom and check the address under the IPv4 address field:

That is your computer's IP address.

Automatically launching the Brokenithm server when starting the game

This will only work if you extracted brokenithm_server.exe to App\\bin\\ as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min brokenithm_server\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Improving latency

You can improve latency by running Brokenithm with your Android device tethered to your computer. However, this requires a little extra setup:

  • Connect your Android device to your computer with a USB cable.
  • If you haven't enabled Developer options on your device, do it by navigating to the \"About\" page in your phone's settings, then tap \"Build number\" seven times. This varies by device, so if unsure, look up the instructions for your specific one.
  • Navigate to Developer options and enable USB debugging.
  • On your computer, download and extract Android SDK Platform Tools to your App\\bin\\ folder.
  • Navigate to the App\\bin\\platform-tools folder in File Explorer, click on the address bar, type cmd, and hit Enter to open a command prompt.
  • In the command prompt, type the following command:
adb reverse tcp:52468 tcp:52468\n
  • Start brokenithm_server in TCP mode with the -T command line flag, brokenithm_server.exe -T.
  • On your Android device, open Brokenithm, and change the address to 0.0.0.0.
    • If the text box to the left of the \"SETTINGS\" button say \"UDP\", tap on it once to switch to \"TCP\" mode.
  • Tap on \"START\", and you will now be connected via the USB cable.
  • You can now start the game as normal.

The next time you play the game, you only need to run the adb reverse ... command again. To do this automatically when the game starts, add a line to the start.bat script before the brokenithm_server line:

@echo off\n\npushd %~dp0\n\nstart /min platform-tools\\adb reverse tcp:52468 tcp:52468\nstart /min brokenithm_server -T\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/common/chusan/controllers/#iosipados","title":"iOS/iPadOS","text":"
  • Install Brokenithm on your iOS/iPadOS device by joining the Brokenithm TestFlight (iOS 18 only).
    • If your iOS/iPadOS device doesn't have iOS 18, you will need to sideload a different IPA with Sideloadly.
  • If you have iTunes and/or iCloud installed from the Microsoft Store on your computer, uninstall it.
  • Install the non-Microsoft Store version of iTunes from the website.
  • Download the latest version of Brokenithm-Evolved-iOS server and extract it to App\\bin\\Brokenithm-Server.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run App\\bin\\Brokenithm-Server\\Brokenithm-Evolved-iOS.exe. A command prompt window should open, saying that it is waiting for a device.
  • On your iOS/iPadOS device, open Brokenithm, and connect it to your computer with a USB cable.
  • Run the game as normal.
Automatically launching the Brokenithm server when starting the game

This will only work if you extracted the server to App\\bin\\Brokenithm-Server as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min Brokenithm-Server\\Brokenithm-Evolved-iOS.exe\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/common/chusan/controllers/#tasoller","title":"TASOLLER","text":"

Warning

This guide only covers TASOLLERs running the v2.0 touch firmware. If you've purchased the controller after January 2022, the update should have already been applied.

If you've purchased the controller before then, you will need to update the touch firmware by following the instructions on DJ-DAO's support page.

  • Install the custom IO4 firmware to your controller.
  • Follow the segatools.ini config on the gitea page.
  • Connect the controller to your computer, and then start the game.
Legacy
  • Backup TASOLLER setup if IO4 cfw is not working.
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download TASOLLER IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_v2_x86.dll\npath64=chuniio_tasoller_v2_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/common/chusan/controllers/#tasoller-plus","title":"TASOLLER PLUS","text":"
  • Switch your TASOLLER PLUS to WINUSB mode. You can do so in TASOLLER Options found on the djdao support page.
  • Download TASOLLER PLUS IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_plus_x86.dll\npath64=chuniio_tasoller_plus_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/common/chusan/controllers/#yubideck","title":"YubiDeck","text":"
  • Switch your YubiDeck to HID output mode. Instructions on how to do so are provided in the YubiDeck manual.
  • Download the latest version of YubiDeck IO DLLs and extract it to your App\\bin folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_yubideck_chusan.dll\npath64=chuniio_yubideck_amdaemon.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/common/chusan/controllers/#laverita-3","title":"Laverita 3","text":"
  • Switch your Laverita to IO mode. You can do so in ConfigApp found in the yuancon discord.
  • Change the COM port of your controller. You can do so in Device manager by looking for USB Serial Device you may need to unplug and replug your controller to properly idetify which one is the Laverita.
  • Double click on it
  • Go to Port Settings
  • Click on Advanced
  • From the dropdown select COM1
  • Restart to ensure changes took effect and saved
  • Edit your App\\bin\\segatools.ini to disable io emulation and set led:
[led]\n; Output billboard LED strip data to a named pipe called \"\\\\.\\pipe\\chuni_led\"\ncabLedOutputPipe=0\n; Output billboard LED strip data to serial\ncabLedOutputSerial=1\n\n; Output slider LED data to the named pipe\ncontrollerLedOutputPipe=0\n; Output slider LED data to the serial port\ncontrollerLedOutputSerial=1\n; Use the OpeNITHM protocol for serial LED output\ncontrollerLedOutputOpeNITHM=0\n\n; Serial port to send data to if using serial output. Default is COM5.\nserialPort=COM1\n; Baud rate for serial data (set to 115200 if using OpeNITHM)\nserialBaud=9600\n\n[slider]\n; Enable slider emulation. If you have real AC slider, set this to 0.\n; Slider serial port must be COM1.\nenable=0\n\n[io4]\nenable=0\n
  • Then start the game.
Legacy
  • Backup Laverita 3 setup if IO4 cfw is not working.
  • Switch your Laverita to HID mode. You can do so in ConfigApp
  • Download Laverita IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_laverita_v3_x86.dll\npath64=chuniio_laverita_v3_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/common/chusan/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet slider and air sensors, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/chunithm/common/chusan/setup/","title":"Setup","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of CHUNITHM

You'll want to create a new folder for the game and start from scratch. CHUNITHM DOES NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/common/chusan/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create another empty folder named AppData next to them. It should now look like below.

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/chunithm/common/chusan/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/chunithm/common/chusan/setup/#installing-option-data","title":"Installing option data","text":"

CHUNITHM content updates are distributed through option folders instead of patching the base game. They are named A???, with each ? being a number. Custom options distributed by the community might use letters instead, to distinguish them from official ones.

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

If you plan to connect to a network (Hosted or Local), the A001 option folder for your specific game version is required. This option contains a special Event file that lets the game connect.

"},{"location":"games/sega/chunithm/common/chusan/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

CHUNITHM executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of chusanApp.exe and amdaemon.exe for your game version.

Copy chusanApp.exe and amdaemon.exe to the bin folder of your game data. Agree to overwrite when asked.

"},{"location":"games/sega/chunithm/common/chusan/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/chunithm/common/chusan/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher.

There are many patches for CHUNITHM.

We will only bring up the ones we think could be genuinely useful.

As a general rule of thumb, if you're not sure what a patch does or you're not absolutely certain you need it, leave it alone, regardless of recommendations below.

Patch Recommendation Description Force shared audio mode Either Force the game to use shared mode audio output, letting you listen to other audio sources while the game is running at the cost of audio latency. Force 2 channel audio output Either Try enabling this patch if you don't get audio output at all. Disable song select timer Either Disables the song select timer. No encryption ON Disable encrypting network requests. Required if you plan to run a local server. No TLS ON Disable checking if the server is HTTPS or not. Required if you plan to run a local server. Bypass 1080p monitor check Either Disable checking if the monitor is 1080p when enabling 120FPS. Enable if you cannot set your monitor to 1080p. Bypass 120Hz monitor check Either Disable checking if the monitor is exactly 120Hz when enabling 120FPS. Enable if you cannot set your monitor to 120Hz."},{"location":"games/sega/chunithm/common/chusan/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download segatools.zip. Do not download the source code.
  • Extracting the archive should give you a few more zip files. Find chusan.zip and extract it to the App\\bin folder in your game data.

You should now have a few more files inside the folder, as highlighted:

"},{"location":"games/sega/chunithm/common/chusan/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\bin\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[system]\ndipsw2=1\ndipsw2=1 ; WRONG!\n
"},{"location":"games/sega/chunithm/common/chusan/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

Relative Directories

The ../ in the above example represents the parent directory in a relative path. It is used to navigate up one level in the directory hierarchy.

For example, your segatools.ini is located at /App/bin/segatools.ini and your Option folder is located next to the App folder.

Since segatools.ini is in the /bin/ folder, typing ../ would move you up to the App folder. Since the Option folder is next to the App folder, the second ../ takes you to App's parent folder, which is the folder containing App, Option, etc.

The benefits of using this method include:

  • Avoiding issues that arise when folders have spaces in their names.

  • Being able to move your game folder without redefining the locations of your VFS folders.

  • A cleaner and easier to read segatools.ini, making spotting issues simpler.

"},{"location":"games/sega/chunithm/common/chusan/setup/#system","title":"[system]","text":"
  • If you have a 120Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n
"},{"location":"games/sega/chunithm/common/chusan/setup/#gfx","title":"[gfx]","text":"
  • Set windowed to 0 to run in fullscreen mode and 1 to run in windowed mode.
  • If you have multiple monitors and you're running in fullscreen mode (windowed=0), set monitor to the index of the monitor you want to run the game on.
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number minus one. For example, monitor 2 means monitor index 1.

"},{"location":"games/sega/chunithm/common/chusan/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.139.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\bin\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/common/chusan/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/chunithm/common/chusan/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/common/chusan/setup/#audio","title":"Audio","text":"
  • Right-click on the volume setting in your taskbar and select Sounds.
  • Navigate to the Playback tab, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick either 16 bit, 48000Hz (DVD Quality) or 24 bit, 48000Hz (Studio Quality), click Apply, then OK.
"},{"location":"games/sega/chunithm/common/chusan/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/chunithm/common/chusan/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/chunithm/common/chusan/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\bin\\start.bat. Let the game load until it reaches the screen below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 4th option).

Select \u30b0\u30eb\u30fc\u30d7\u5185\u57fa\u6e96\u6a5f\u8a2d\u5b9a (SET STANDARD IN GROUP, the second option) and toggle this setting to \u57fa\u6e96\u6a5f (STANDARD).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/chunithm/common/chusan/setup/#close-setting","title":"CLOSE SETTING","text":"

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the 10th option).

Navigate to \u6642 (HOUR, the 2nd option) and use the Service button to toggle the setting until it says \u5168\u6642\u523b (ALL TIME).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu, then select \u7d42\u4e86 (also the last option) in the main menu to exit the service menu.

"},{"location":"games/sega/chunithm/common/chusan/setup/#waiting-for-distribution-server","title":"Waiting for Distribution Server","text":"

If you're stuck at the Waiting for Distribution Server screen below, close the game and relaunch.

You're all done! The game should load up properly now.

You can add coins using the Coin key (default F3) and card in by holding the Enter key.

"},{"location":"games/sega/chunithm/common/chusan/setup/#further-configuration","title":"Further configuration","text":"

Input methods and controllers are covered in the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/common/chusan/troubleshooting/","title":"Troubleshooting","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/chunithm/common/chusan/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch!","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120Hz, apply the \"Bypass 120Hz monitor check\"/\"Bypass 1080p monitor check\" on a CHUNITHM web patcher (see Resources).
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\nping 127.0.0.1 -n 31 > nul && taskkill /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/chunithm/common/chusan/troubleshooting/#my-game-takes-a-long-time-to-boot","title":"My game takes a long time to boot!","text":"

CHUNITHM game files consist of thousands of small XML files, which Windows Defender takes a long time to scan through. Add your game folder to the Windows Defender exclusion list.

Danger

Doing this will prevent Windows Defender from scanning your game folder for viruses. Only do this if you trust the source of the data.

"},{"location":"games/sega/chunithm/common/chusan/troubleshooting/#my-game-is-running-too-slowfast","title":"My game is running too slow/fast","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Make sure your monitor's refresh rate is set to 60Hz or 120Hz.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/common/chusan/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chusanApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/common/chusan/troubleshooting/#my-game-crashes-when-i-tab-out-of-fullscreen","title":"My game crashes when I tab out of fullscreen!","text":"

As the game is intended to run on arcade hardware, it doesn't like being minimized.

One workaround for this is to use DXVK. Download the latest version from releases. This will be a dxvk-x.y.z.tar.gz file, which you can open using 7zip. Navigate to the x32 folder, and copy the d3d9.dll file to your game's App\\bin folder, agreeing to overwrite when asked.

You should now be able to tab out of fullscreen without crashing the game.

Warning

The game will not ignore inputs when out of focus.

This means any controller inputs will still be accepted, so try not to lean onto your slider whilst tabbed out!

This also means that you can accidentally enter the service menu by hitting your Test key even if the game is minimised. If you were in the middle of a credit, your scores will be lost.

"},{"location":"games/sega/chunithm/common/chusan/troubleshooting/#when-i-run-the-game-all-other-audio-is-gone","title":"When I run the game all other audio is gone!","text":"

CHUNITHM uses WASAPI exclusive mode for audio to get better latency.

You can apply the \"Shared Audio\" patch on a CHUNITHM web patcher (see Resources) to hear audio outside of the game at the cost of audio latency.

"},{"location":"games/sega/chunithm/common/chusan/troubleshooting/#cabinet-to-cabinetc2c-fixes","title":"Cabinet-to-Cabinet(c2c) Fixes","text":"

c2c can have many problems but you can fix most of them by applying the \"Patch for head-to-head play\" and disabling \"Set all timers to 999\" on a CHUNITHM web patcher (see Resources).

If the above does not work then please ensure both machines have the exact same data and can communicate with each other if they cannot then you can try disabling firewalls or changing the c2c group.

If clicking the c2c button does nothing, you can fix it by resetting the network settings in Windows.

"},{"location":"games/sega/chunithm/luminous/c2c/","title":"Cab-to-Cab Play over Internet (LUMINOUS)","text":"

You are most likely to have success with Multiplayer when all users are using the SAME data and options, from the same sources. Verify that each person can run the game normally before attempting to network them together.

  • Chunithm expects the cabinets to be using specific IP addresses, 192.168.139.11/12/13/14
  • To achieve this over the internet, we can use SoftEther VPN. Refer to the Setting Up SoftEther VPN Guide for more information.
"},{"location":"games/sega/chunithm/luminous/c2c/#configuring-segatoolsini-game-assignments","title":"Configuring segatools.ini & Game Assignments","text":"

segatools.ini

[netnev]\nenable=1\naddrSuffix= last 2 digits of your SoftEther IP\n\n[keychip]\nenable=1\nsubnet=192.168.139.0\nid=(Everyone needs a seperate keychip. If you play on a remote network, chances are you already have your own keychip. If not, you can use the example keychips below.)\n;example keychips: A61E-01D02321145 ; A61E-01A30831145 ; A61E-01E38091145 ; A61E-01E46241145\n\n[system]\ndipsw1=1\n;This has changed since Luminous. Previously if you wish to perform cab-to-cab link, you need to set this to 1 on the Server machine, and 0 on all other client machines.\n;This change is no longer needed, just keep this set to 1 on all machines.\n

GAME ASSIGNMENTS

  • After saving your segatools.ini, launch the game and go into the Service Menu > and go to GAME ASSIGNMENTS.

  • Enable CABINET-TO-CABINET PLAY, and make sure all machine are on the same group (Group A for example).

  • Set one machine to STANDARD, and all other machines to FOLLOW THE STANDARD .

Exit the Service Menu and load into Attract Mode. If the game passes the Group Check then chances are you're good to go! You can now login to a credit and open a cab-to-cab link request to check if the connection is working properly!

"},{"location":"games/sega/chunithm/luminous/c2c/#how-to-link","title":"How to Link?","text":"

If you're new to Chunithm and have never tried link-play before and you have no idea how, keep reading.

  • Login to a credit.

  • If you're hosting a cab-to-cab session, choose a song first, then scroll to the far left and press Confirm. The cab-to-cab request is now open.

  • If you're connecting, navigate to the \"Cabinet-to-Cabinet Play\" tab and wait for other players to create a session.

If you are able to see each other's session, congrats! You can now enjoy some cab-to-cab chain action!

"},{"location":"games/sega/chunithm/luminous/c2c/#troubleshooting","title":"Troubleshooting","text":"

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/luminous/controllers/","title":"Controllers (LUMINOUS)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with IO DLLs to add support for controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\bin\\ folder and referenced in segatools.ini under the [chuniio] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; Uncomment this if you have custom chuniio implementation comprised of a single 32bit DLL.\n; (will use chu2to3 engine internally)\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.

If you have two DLLs, ending in _x86.dll and _x64.dll (or _chusan.dll and _amdaemon.dll), uncomment the path32= and path64= lines by removing the leading semicolon (;), then add your DLLs after the =:

[chuniio]\n; Uncomment both of these if you have custom chuniio implementation comprised of two DLLs.\n; x86 chuniio to path32, x64 to path64. Both are necessary.\n;(1)!\npath32=controller_x86.dll\npath64=controller_x64.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/luminous/controllers/#keyboard","title":"Keyboard","text":"

Keyboard is the default input method, and while not recommended for playing the game, it is useful for testing purposes.

The default layout uses SDFGHJKL for slider input, and Space Bar for the AIRs.

If you wish to change the default keybinds, an explanation on how to set these is included above the [io3] section in your segatools.ini.

"},{"location":"games/sega/chunithm/luminous/controllers/#brokenithm","title":"Brokenithm","text":"

Brokenithm allows you to use a mobile device as a CHUNITHM controller. It uses the bottom half of the screen as the ground slider, and sliding into the upper half activates the air sensors.

"},{"location":"games/sega/chunithm/luminous/controllers/#android","title":"Android","text":"

Warning

Your computer and your Android device must be on the same local network.

  • Download the latest version of Brokenithm-Android and install it on your Android device.
  • Download the latest version of Brokenithm-Android-Server and extract only brokenithm_server.exe to your App\\bin\\ folder.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run brokenithm_server.exe. A command prompt window should open, saying that it is waiting for a device on port 52468.
  • Open the Brokenithm app on your Android device. Enter your computer's IP address in the Address box on the top right, then tap Start.
  • Run the game as normal.
Getting your computer's IP address

Open Settings -> Network and Internet and select Properties. Scroll down to the bottom and check the address under the IPv4 address field:

That is your computer's IP address.

Automatically launching the Brokenithm server when starting the game

This will only work if you extracted brokenithm_server.exe to App\\bin\\ as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min brokenithm_server\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Improving latency

You can improve latency by running Brokenithm with your Android device tethered to your computer. However, this requires a little extra setup:

  • Connect your Android device to your computer with a USB cable.
  • If you haven't enabled Developer options on your device, do it by navigating to the \"About\" page in your phone's settings, then tap \"Build number\" seven times. This varies by device, so if unsure, look up the instructions for your specific one.
  • Navigate to Developer options and enable USB debugging.
  • On your computer, download and extract Android SDK Platform Tools to your App\\bin\\ folder.
  • Navigate to the App\\bin\\platform-tools folder in File Explorer, click on the address bar, type cmd, and hit Enter to open a command prompt.
  • In the command prompt, type the following command:
adb reverse tcp:52468 tcp:52468\n
  • Start brokenithm_server in TCP mode with the -T command line flag, brokenithm_server.exe -T.
  • On your Android device, open Brokenithm, and change the address to 0.0.0.0.
    • If the text box to the left of the \"SETTINGS\" button say \"UDP\", tap on it once to switch to \"TCP\" mode.
  • Tap on \"START\", and you will now be connected via the USB cable.
  • You can now start the game as normal.

The next time you play the game, you only need to run the adb reverse ... command again. To do this automatically when the game starts, add a line to the start.bat script before the brokenithm_server line:

@echo off\n\npushd %~dp0\n\nstart /min platform-tools\\adb reverse tcp:52468 tcp:52468\nstart /min brokenithm_server -T\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/luminous/controllers/#iosipados","title":"iOS/iPadOS","text":"
  • Install Brokenithm on your iOS/iPadOS device by joining the Brokenithm TestFlight (iOS 18 only).
    • If your iOS/iPadOS device doesn't have iOS 18, you will need to sideload a different IPA with Sideloadly.
  • If you have iTunes and/or iCloud installed from the Microsoft Store on your computer, uninstall it.
  • Install the non-Microsoft Store version of iTunes from the website.
  • Download the latest version of Brokenithm-Evolved-iOS server and extract it to App\\bin\\Brokenithm-Server.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run App\\bin\\Brokenithm-Server\\Brokenithm-Evolved-iOS.exe. A command prompt window should open, saying that it is waiting for a device.
  • On your iOS/iPadOS device, open Brokenithm, and connect it to your computer with a USB cable.
  • Run the game as normal.
Automatically launching the Brokenithm server when starting the game

This will only work if you extracted the server to App\\bin\\Brokenithm-Server as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min Brokenithm-Server\\Brokenithm-Evolved-iOS.exe\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/luminous/controllers/#tasoller","title":"TASOLLER","text":"

Warning

This guide only covers TASOLLERs running the v2.0 touch firmware. If you've purchased the controller after January 2022, the update should have already been applied.

If you've purchased the controller before then, you will need to update the touch firmware by following the instructions on DJ-DAO's support page.

  • Install the custom IO4 firmware to your controller.
  • Follow the segatools.ini config on the gitea page.
  • Connect the controller to your computer, and then start the game.
Legacy
  • Backup TASOLLER setup if IO4 cfw is not working.
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download TASOLLER IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_v2_x86.dll\npath64=chuniio_tasoller_v2_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/luminous/controllers/#tasoller-plus","title":"TASOLLER PLUS","text":"
  • Switch your TASOLLER PLUS to WINUSB mode. You can do so in TASOLLER Options found on the djdao support page.
  • Download TASOLLER PLUS IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_plus_x86.dll\npath64=chuniio_tasoller_plus_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/luminous/controllers/#yubideck","title":"YubiDeck","text":"
  • Switch your YubiDeck to HID output mode. Instructions on how to do so are provided in the YubiDeck manual.
  • Download the latest version of YubiDeck IO DLLs and extract it to your App\\bin folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_yubideck_chusan.dll\npath64=chuniio_yubideck_amdaemon.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/luminous/controllers/#laverita-3","title":"Laverita 3","text":"
  • Switch your Laverita to IO mode. You can do so in ConfigApp found in the yuancon discord.
  • Change the COM port of your controller. You can do so in Device manager by looking for USB Serial Device you may need to unplug and replug your controller to properly idetify which one is the Laverita.
  • Double click on it
  • Go to Port Settings
  • Click on Advanced
  • From the dropdown select COM1
  • Restart to ensure changes took effect and saved
  • Edit your App\\bin\\segatools.ini to disable io emulation and set led:
[led]\n; Output billboard LED strip data to a named pipe called \"\\\\.\\pipe\\chuni_led\"\ncabLedOutputPipe=0\n; Output billboard LED strip data to serial\ncabLedOutputSerial=1\n\n; Output slider LED data to the named pipe\ncontrollerLedOutputPipe=0\n; Output slider LED data to the serial port\ncontrollerLedOutputSerial=1\n; Use the OpeNITHM protocol for serial LED output\ncontrollerLedOutputOpeNITHM=0\n\n; Serial port to send data to if using serial output. Default is COM5.\nserialPort=COM1\n; Baud rate for serial data (set to 115200 if using OpeNITHM)\nserialBaud=9600\n\n[slider]\n; Enable slider emulation. If you have real AC slider, set this to 0.\n; Slider serial port must be COM1.\nenable=0\n\n[io4]\nenable=0\n
  • Then start the game.
Legacy
  • Backup Laverita 3 setup if IO4 cfw is not working.
  • Switch your Laverita to HID mode. You can do so in ConfigApp
  • Download Laverita IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_laverita_v3_x86.dll\npath64=chuniio_laverita_v3_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/luminous/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet slider and air sensors, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/chunithm/luminous/setup/","title":"Game Setup (LUMINOUS)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of CHUNITHM

You'll want to create a new folder for the game and start from scratch. CHUNITHM DOES NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/luminous/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create another empty folder named AppData next to them. It should now look like below.

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/chunithm/luminous/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/chunithm/luminous/setup/#installing-option-data","title":"Installing option data","text":"

CHUNITHM content updates are distributed through option folders instead of patching the base game. They are named A???, with each ? being a number. Custom options distributed by the community might use letters instead, to distinguish them from official ones.

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

If you plan to connect to a network (Hosted or Local), the A001 option folder for your specific game version is required. This option contains a special Event file that lets the game connect.

"},{"location":"games/sega/chunithm/luminous/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

CHUNITHM executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of chusanApp.exe and amdaemon.exe for your game version.

Copy chusanApp.exe and amdaemon.exe to the bin folder of your game data. Agree to overwrite when asked.

"},{"location":"games/sega/chunithm/luminous/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/chunithm/luminous/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher.

There are many patches for CHUNITHM.

We will only bring up the ones we think could be genuinely useful.

As a general rule of thumb, if you're not sure what a patch does or you're not absolutely certain you need it, leave it alone, regardless of recommendations below.

Patch Recommendation Description Force shared audio mode Either Force the game to use shared mode audio output, letting you listen to other audio sources while the game is running at the cost of audio latency. Force 2 channel audio output Either Try enabling this patch if you don't get audio output at all. Disable song select timer Either Disables the song select timer. No encryption ON Disable encrypting network requests. Required if you plan to run a local server. No TLS ON Disable checking if the server is HTTPS or not. Required if you plan to run a local server. Bypass 1080p monitor check Either Disable checking if the monitor is 1080p when enabling 120FPS. Enable if you cannot set your monitor to 1080p. Bypass 120Hz monitor check Either Disable checking if the monitor is exactly 120Hz when enabling 120FPS. Enable if you cannot set your monitor to 120Hz."},{"location":"games/sega/chunithm/luminous/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download segatools.zip. Do not download the source code.
  • Extracting the archive should give you a few more zip files. Find chusan.zip and extract it to the App\\bin folder in your game data.

You should now have a few more files inside the folder, as highlighted:

"},{"location":"games/sega/chunithm/luminous/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\bin\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[system]\ndipsw2=1\ndipsw2=1 ; WRONG!\n
"},{"location":"games/sega/chunithm/luminous/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

Relative Directories

The ../ in the above example represents the parent directory in a relative path. It is used to navigate up one level in the directory hierarchy.

For example, your segatools.ini is located at /App/bin/segatools.ini and your Option folder is located next to the App folder.

Since segatools.ini is in the /bin/ folder, typing ../ would move you up to the App folder. Since the Option folder is next to the App folder, the second ../ takes you to App's parent folder, which is the folder containing App, Option, etc.

The benefits of using this method include:

  • Avoiding issues that arise when folders have spaces in their names.

  • Being able to move your game folder without redefining the locations of your VFS folders.

  • A cleaner and easier to read segatools.ini, making spotting issues simpler.

"},{"location":"games/sega/chunithm/luminous/setup/#system","title":"[system]","text":"
  • If you have a 120Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n
"},{"location":"games/sega/chunithm/luminous/setup/#gfx","title":"[gfx]","text":"
  • Set windowed to 0 to run in fullscreen mode and 1 to run in windowed mode.
  • If you have multiple monitors and you're running in fullscreen mode (windowed=0), set monitor to the index of the monitor you want to run the game on.
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number minus one. For example, monitor 2 means monitor index 1.

"},{"location":"games/sega/chunithm/luminous/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.139.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\bin\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/luminous/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/chunithm/luminous/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/luminous/setup/#audio","title":"Audio","text":"
  • Right-click on the volume setting in your taskbar and select Sounds.
  • Navigate to the Playback tab, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick either 16 bit, 48000Hz (DVD Quality) or 24 bit, 48000Hz (Studio Quality), click Apply, then OK.
"},{"location":"games/sega/chunithm/luminous/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/chunithm/luminous/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/chunithm/luminous/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\bin\\start.bat. Let the game load until it reaches the screen below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 4th option).

Select \u30b0\u30eb\u30fc\u30d7\u5185\u57fa\u6e96\u6a5f\u8a2d\u5b9a (SET STANDARD IN GROUP, the second option) and toggle this setting to \u57fa\u6e96\u6a5f (STANDARD).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/chunithm/luminous/setup/#close-setting","title":"CLOSE SETTING","text":"

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the 10th option).

Navigate to \u6642 (HOUR, the 2nd option) and use the Service button to toggle the setting until it says \u5168\u6642\u523b (ALL TIME).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu, then select \u7d42\u4e86 (also the last option) in the main menu to exit the service menu.

"},{"location":"games/sega/chunithm/luminous/setup/#waiting-for-distribution-server","title":"Waiting for Distribution Server","text":"

If you're stuck at the Waiting for Distribution Server screen below, close the game and relaunch.

You're all done! The game should load up properly now.

You can add coins using the Coin key (default F3) and card in by holding the Enter key.

"},{"location":"games/sega/chunithm/luminous/setup/#further-configuration","title":"Further configuration","text":"

Input methods and controllers are covered in the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/luminous/troubleshooting/","title":"Troubleshooting (LUMINOUS)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/chunithm/luminous/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch!","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120Hz, apply the \"Bypass 120Hz monitor check\"/\"Bypass 1080p monitor check\" on a CHUNITHM web patcher (see Resources).
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\nping 127.0.0.1 -n 31 > nul && taskkill /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/chunithm/luminous/troubleshooting/#my-game-takes-a-long-time-to-boot","title":"My game takes a long time to boot!","text":"

CHUNITHM game files consist of thousands of small XML files, which Windows Defender takes a long time to scan through. Add your game folder to the Windows Defender exclusion list.

Danger

Doing this will prevent Windows Defender from scanning your game folder for viruses. Only do this if you trust the source of the data.

"},{"location":"games/sega/chunithm/luminous/troubleshooting/#my-game-is-running-too-slowfast","title":"My game is running too slow/fast","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Make sure your monitor's refresh rate is set to 60Hz or 120Hz.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/luminous/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chusanApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/luminous/troubleshooting/#my-game-crashes-when-i-tab-out-of-fullscreen","title":"My game crashes when I tab out of fullscreen!","text":"

As the game is intended to run on arcade hardware, it doesn't like being minimized.

One workaround for this is to use DXVK. Download the latest version from releases. This will be a dxvk-x.y.z.tar.gz file, which you can open using 7zip. Navigate to the x32 folder, and copy the d3d9.dll file to your game's App\\bin folder, agreeing to overwrite when asked.

You should now be able to tab out of fullscreen without crashing the game.

Warning

The game will not ignore inputs when out of focus.

This means any controller inputs will still be accepted, so try not to lean onto your slider whilst tabbed out!

This also means that you can accidentally enter the service menu by hitting your Test key even if the game is minimised. If you were in the middle of a credit, your scores will be lost.

"},{"location":"games/sega/chunithm/luminous/troubleshooting/#when-i-run-the-game-all-other-audio-is-gone","title":"When I run the game all other audio is gone!","text":"

CHUNITHM uses WASAPI exclusive mode for audio to get better latency.

You can apply the \"Shared Audio\" patch on a CHUNITHM web patcher (see Resources) to hear audio outside of the game at the cost of audio latency.

"},{"location":"games/sega/chunithm/luminous/troubleshooting/#cabinet-to-cabinetc2c-fixes","title":"Cabinet-to-Cabinet(c2c) Fixes","text":"

c2c can have many problems but you can fix most of them by applying the \"Patch for head-to-head play\" and disabling \"Set all timers to 999\" on a CHUNITHM web patcher (see Resources).

If the above does not work then please ensure both machines have the exact same data and can communicate with each other if they cannot then you can try disabling firewalls or changing the c2c group.

If clicking the c2c button does nothing, you can fix it by resetting the network settings in Windows.

"},{"location":"games/sega/chunithm/luminousplus/c2c/","title":"Cab-to-Cab Play over Internet (LUMINOUS PLUS)","text":"

You are most likely to have success with Multiplayer when all users are using the SAME data and options, from the same sources. Verify that each person can run the game normally before attempting to network them together.

  • Chunithm expects the cabinets to be using specific IP addresses, 192.168.139.11/12/13/14
  • To achieve this over the internet, we can use SoftEther VPN. Refer to the Setting Up SoftEther VPN Guide for more information.
"},{"location":"games/sega/chunithm/luminousplus/c2c/#configuring-segatoolsini-game-assignments","title":"Configuring segatools.ini & Game Assignments","text":"

segatools.ini

[netnev]\nenable=1\naddrSuffix= last 2 digits of your SoftEther IP\n\n[keychip]\nenable=1\nsubnet=192.168.139.0\nid=(Everyone needs a seperate keychip. If you play on a remote network, chances are you already have your own keychip. If not, you can use the example keychips below.)\n;example keychips: A61E-01D02321145 ; A61E-01A30831145 ; A61E-01E38091145 ; A61E-01E46241145\n\n[system]\ndipsw1=1\n;This has changed since Luminous. Previously if you wish to perform cab-to-cab link, you need to set this to 1 on the Server machine, and 0 on all other client machines.\n;This change is no longer needed, just keep this set to 1 on all machines.\n

GAME ASSIGNMENTS

  • After saving your segatools.ini, launch the game and go into the Service Menu > and go to GAME ASSIGNMENTS.

  • Enable CABINET-TO-CABINET PLAY, and make sure all machine are on the same group (Group A for example).

  • Set one machine to STANDARD, and all other machines to FOLLOW THE STANDARD .

Exit the Service Menu and load into Attract Mode. If the game passes the Group Check then chances are you're good to go! You can now login to a credit and open a cab-to-cab link request to check if the connection is working properly!

"},{"location":"games/sega/chunithm/luminousplus/c2c/#how-to-link","title":"How to Link?","text":"

If you're new to Chunithm and have never tried link-play before and you have no idea how, keep reading.

  • Login to a credit.

  • If you're hosting a cab-to-cab session, choose a song first, then scroll to the far left and press Confirm. The cab-to-cab request is now open.

  • If you're connecting, navigate to the \"Cabinet-to-Cabinet Play\" tab and wait for other players to create a session.

If you are able to see each other's session, congrats! You can now enjoy some cab-to-cab chain action!

"},{"location":"games/sega/chunithm/luminousplus/c2c/#troubleshooting","title":"Troubleshooting","text":"

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/luminousplus/controllers/","title":"Controllers (LUMINOUS PLUS)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with IO DLLs to add support for controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\bin\\ folder and referenced in segatools.ini under the [chuniio] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; Uncomment this if you have custom chuniio implementation comprised of a single 32bit DLL.\n; (will use chu2to3 engine internally)\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.

If you have two DLLs, ending in _x86.dll and _x64.dll (or _chusan.dll and _amdaemon.dll), uncomment the path32= and path64= lines by removing the leading semicolon (;), then add your DLLs after the =:

[chuniio]\n; Uncomment both of these if you have custom chuniio implementation comprised of two DLLs.\n; x86 chuniio to path32, x64 to path64. Both are necessary.\n;(1)!\npath32=controller_x86.dll\npath64=controller_x64.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/luminousplus/controllers/#keyboard","title":"Keyboard","text":"

Keyboard is the default input method, and while not recommended for playing the game, it is useful for testing purposes.

The default layout uses SDFGHJKL for slider input, and Space Bar for the AIRs.

If you wish to change the default keybinds, an explanation on how to set these is included above the [io3] section in your segatools.ini.

"},{"location":"games/sega/chunithm/luminousplus/controllers/#brokenithm","title":"Brokenithm","text":"

Brokenithm allows you to use a mobile device as a CHUNITHM controller. It uses the bottom half of the screen as the ground slider, and sliding into the upper half activates the air sensors.

"},{"location":"games/sega/chunithm/luminousplus/controllers/#android","title":"Android","text":"

Warning

Your computer and your Android device must be on the same local network.

  • Download the latest version of Brokenithm-Android and install it on your Android device.
  • Download the latest version of Brokenithm-Android-Server and extract only brokenithm_server.exe to your App\\bin\\ folder.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run brokenithm_server.exe. A command prompt window should open, saying that it is waiting for a device on port 52468.
  • Open the Brokenithm app on your Android device. Enter your computer's IP address in the Address box on the top right, then tap Start.
  • Run the game as normal.
Getting your computer's IP address

Open Settings -> Network and Internet and select Properties. Scroll down to the bottom and check the address under the IPv4 address field:

That is your computer's IP address.

Automatically launching the Brokenithm server when starting the game

This will only work if you extracted brokenithm_server.exe to App\\bin\\ as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min brokenithm_server\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Improving latency

You can improve latency by running Brokenithm with your Android device tethered to your computer. However, this requires a little extra setup:

  • Connect your Android device to your computer with a USB cable.
  • If you haven't enabled Developer options on your device, do it by navigating to the \"About\" page in your phone's settings, then tap \"Build number\" seven times. This varies by device, so if unsure, look up the instructions for your specific one.
  • Navigate to Developer options and enable USB debugging.
  • On your computer, download and extract Android SDK Platform Tools to your App\\bin\\ folder.
  • Navigate to the App\\bin\\platform-tools folder in File Explorer, click on the address bar, type cmd, and hit Enter to open a command prompt.
  • In the command prompt, type the following command:
adb reverse tcp:52468 tcp:52468\n
  • Start brokenithm_server in TCP mode with the -T command line flag, brokenithm_server.exe -T.
  • On your Android device, open Brokenithm, and change the address to 0.0.0.0.
    • If the text box to the left of the \"SETTINGS\" button say \"UDP\", tap on it once to switch to \"TCP\" mode.
  • Tap on \"START\", and you will now be connected via the USB cable.
  • You can now start the game as normal.

The next time you play the game, you only need to run the adb reverse ... command again. To do this automatically when the game starts, add a line to the start.bat script before the brokenithm_server line:

@echo off\n\npushd %~dp0\n\nstart /min platform-tools\\adb reverse tcp:52468 tcp:52468\nstart /min brokenithm_server -T\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/luminousplus/controllers/#iosipados","title":"iOS/iPadOS","text":"
  • Install Brokenithm on your iOS/iPadOS device by joining the Brokenithm TestFlight (iOS 18 only).
    • If your iOS/iPadOS device doesn't have iOS 18, you will need to sideload a different IPA with Sideloadly.
  • If you have iTunes and/or iCloud installed from the Microsoft Store on your computer, uninstall it.
  • Install the non-Microsoft Store version of iTunes from the website.
  • Download the latest version of Brokenithm-Evolved-iOS server and extract it to App\\bin\\Brokenithm-Server.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run App\\bin\\Brokenithm-Server\\Brokenithm-Evolved-iOS.exe. A command prompt window should open, saying that it is waiting for a device.
  • On your iOS/iPadOS device, open Brokenithm, and connect it to your computer with a USB cable.
  • Run the game as normal.
Automatically launching the Brokenithm server when starting the game

This will only work if you extracted the server to App\\bin\\Brokenithm-Server as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min Brokenithm-Server\\Brokenithm-Evolved-iOS.exe\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/luminousplus/controllers/#tasoller","title":"TASOLLER","text":"

Warning

This guide only covers TASOLLERs running the v2.0 touch firmware. If you've purchased the controller after January 2022, the update should have already been applied.

If you've purchased the controller before then, you will need to update the touch firmware by following the instructions on DJ-DAO's support page.

  • Install the custom IO4 firmware to your controller.
  • Follow the segatools.ini config on the gitea page.
  • Connect the controller to your computer, and then start the game.
Legacy
  • Backup TASOLLER setup if IO4 cfw is not working.
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download TASOLLER IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_v2_x86.dll\npath64=chuniio_tasoller_v2_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/luminousplus/controllers/#tasoller-plus","title":"TASOLLER PLUS","text":"
  • Switch your TASOLLER PLUS to WINUSB mode. You can do so in TASOLLER Options found on the djdao support page.
  • Download TASOLLER PLUS IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_plus_x86.dll\npath64=chuniio_tasoller_plus_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/luminousplus/controllers/#yubideck","title":"YubiDeck","text":"
  • Switch your YubiDeck to HID output mode. Instructions on how to do so are provided in the YubiDeck manual.
  • Download the latest version of YubiDeck IO DLLs and extract it to your App\\bin folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_yubideck_chusan.dll\npath64=chuniio_yubideck_amdaemon.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/luminousplus/controllers/#laverita-3","title":"Laverita 3","text":"
  • Switch your Laverita to IO mode. You can do so in ConfigApp found in the yuancon discord.
  • Change the COM port of your controller. You can do so in Device manager by looking for USB Serial Device you may need to unplug and replug your controller to properly idetify which one is the Laverita.
  • Double click on it
  • Go to Port Settings
  • Click on Advanced
  • From the dropdown select COM1
  • Restart to ensure changes took effect and saved
  • Edit your App\\bin\\segatools.ini to disable io emulation and set led:
[led]\n; Output billboard LED strip data to a named pipe called \"\\\\.\\pipe\\chuni_led\"\ncabLedOutputPipe=0\n; Output billboard LED strip data to serial\ncabLedOutputSerial=1\n\n; Output slider LED data to the named pipe\ncontrollerLedOutputPipe=0\n; Output slider LED data to the serial port\ncontrollerLedOutputSerial=1\n; Use the OpeNITHM protocol for serial LED output\ncontrollerLedOutputOpeNITHM=0\n\n; Serial port to send data to if using serial output. Default is COM5.\nserialPort=COM1\n; Baud rate for serial data (set to 115200 if using OpeNITHM)\nserialBaud=9600\n\n[slider]\n; Enable slider emulation. If you have real AC slider, set this to 0.\n; Slider serial port must be COM1.\nenable=0\n\n[io4]\nenable=0\n
  • Then start the game.
Legacy
  • Backup Laverita 3 setup if IO4 cfw is not working.
  • Switch your Laverita to HID mode. You can do so in ConfigApp
  • Download Laverita IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_laverita_v3_x86.dll\npath64=chuniio_laverita_v3_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/luminousplus/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet slider and air sensors, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/chunithm/luminousplus/setup/","title":"Game Setup (LUMINOUS PLUS)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of CHUNITHM

You'll want to create a new folder for the game and start from scratch. CHUNITHM DOES NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/luminousplus/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create another empty folder named AppData next to them. It should now look like below.

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/chunithm/luminousplus/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/chunithm/luminousplus/setup/#installing-option-data","title":"Installing option data","text":"

CHUNITHM content updates are distributed through option folders instead of patching the base game. They are named A???, with each ? being a number. Custom options distributed by the community might use letters instead, to distinguish them from official ones.

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

If you plan to connect to a network (Hosted or Local), the A001 option folder for your specific game version is required. This option contains a special Event file that lets the game connect.

"},{"location":"games/sega/chunithm/luminousplus/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

CHUNITHM executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of chusanApp.exe and amdaemon.exe for your game version.

Copy chusanApp.exe and amdaemon.exe to the bin folder of your game data. Agree to overwrite when asked.

"},{"location":"games/sega/chunithm/luminousplus/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/chunithm/luminousplus/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher.

There are many patches for CHUNITHM.

We will only bring up the ones we think could be genuinely useful.

As a general rule of thumb, if you're not sure what a patch does or you're not absolutely certain you need it, leave it alone, regardless of recommendations below.

Patch Recommendation Description Force shared audio mode Either Force the game to use shared mode audio output, letting you listen to other audio sources while the game is running at the cost of audio latency. Force 2 channel audio output Either Try enabling this patch if you don't get audio output at all. Disable song select timer Either Disables the song select timer. No encryption ON Disable encrypting network requests. Required if you plan to run a local server. No TLS ON Disable checking if the server is HTTPS or not. Required if you plan to run a local server. Bypass 1080p monitor check Either Disable checking if the monitor is 1080p when enabling 120FPS. Enable if you cannot set your monitor to 1080p. Bypass 120Hz monitor check Either Disable checking if the monitor is exactly 120Hz when enabling 120FPS. Enable if you cannot set your monitor to 120Hz."},{"location":"games/sega/chunithm/luminousplus/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download segatools.zip. Do not download the source code.
  • Extracting the archive should give you a few more zip files. Find chusan.zip and extract it to the App\\bin folder in your game data.

You should now have a few more files inside the folder, as highlighted:

"},{"location":"games/sega/chunithm/luminousplus/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\bin\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[system]\ndipsw2=1\ndipsw2=1 ; WRONG!\n
"},{"location":"games/sega/chunithm/luminousplus/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

Relative Directories

The ../ in the above example represents the parent directory in a relative path. It is used to navigate up one level in the directory hierarchy.

For example, your segatools.ini is located at /App/bin/segatools.ini and your Option folder is located next to the App folder.

Since segatools.ini is in the /bin/ folder, typing ../ would move you up to the App folder. Since the Option folder is next to the App folder, the second ../ takes you to App's parent folder, which is the folder containing App, Option, etc.

The benefits of using this method include:

  • Avoiding issues that arise when folders have spaces in their names.

  • Being able to move your game folder without redefining the locations of your VFS folders.

  • A cleaner and easier to read segatools.ini, making spotting issues simpler.

"},{"location":"games/sega/chunithm/luminousplus/setup/#system","title":"[system]","text":"
  • If you have a 120Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n
"},{"location":"games/sega/chunithm/luminousplus/setup/#gfx","title":"[gfx]","text":"
  • Set windowed to 0 to run in fullscreen mode and 1 to run in windowed mode.
  • If you have multiple monitors and you're running in fullscreen mode (windowed=0), set monitor to the index of the monitor you want to run the game on.
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number minus one. For example, monitor 2 means monitor index 1.

"},{"location":"games/sega/chunithm/luminousplus/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.139.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\bin\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/luminousplus/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/chunithm/luminousplus/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/luminousplus/setup/#audio","title":"Audio","text":"
  • Right-click on the volume setting in your taskbar and select Sounds.
  • Navigate to the Playback tab, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick either 16 bit, 48000Hz (DVD Quality) or 24 bit, 48000Hz (Studio Quality), click Apply, then OK.
"},{"location":"games/sega/chunithm/luminousplus/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/chunithm/luminousplus/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/chunithm/luminousplus/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\bin\\start.bat. Let the game load until it reaches the screen below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 4th option).

Select \u30b0\u30eb\u30fc\u30d7\u5185\u57fa\u6e96\u6a5f\u8a2d\u5b9a (SET STANDARD IN GROUP, the second option) and toggle this setting to \u57fa\u6e96\u6a5f (STANDARD).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/chunithm/luminousplus/setup/#close-setting","title":"CLOSE SETTING","text":"

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the 10th option).

Navigate to \u6642 (HOUR, the 2nd option) and use the Service button to toggle the setting until it says \u5168\u6642\u523b (ALL TIME).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu, then select \u7d42\u4e86 (also the last option) in the main menu to exit the service menu.

"},{"location":"games/sega/chunithm/luminousplus/setup/#waiting-for-distribution-server","title":"Waiting for Distribution Server","text":"

If you're stuck at the Waiting for Distribution Server screen below, close the game and relaunch.

You're all done! The game should load up properly now.

You can add coins using the Coin key (default F3) and card in by holding the Enter key.

"},{"location":"games/sega/chunithm/luminousplus/setup/#further-configuration","title":"Further configuration","text":"

Input methods and controllers are covered in the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/luminousplus/troubleshooting/","title":"Troubleshooting (LUMINOUS PLUS)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/chunithm/luminousplus/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch!","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120Hz, apply the \"Bypass 120Hz monitor check\"/\"Bypass 1080p monitor check\" on a CHUNITHM web patcher (see Resources).
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\nping 127.0.0.1 -n 31 > nul && taskkill /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/chunithm/luminousplus/troubleshooting/#my-game-takes-a-long-time-to-boot","title":"My game takes a long time to boot!","text":"

CHUNITHM game files consist of thousands of small XML files, which Windows Defender takes a long time to scan through. Add your game folder to the Windows Defender exclusion list.

Danger

Doing this will prevent Windows Defender from scanning your game folder for viruses. Only do this if you trust the source of the data.

"},{"location":"games/sega/chunithm/luminousplus/troubleshooting/#my-game-is-running-too-slowfast","title":"My game is running too slow/fast","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Make sure your monitor's refresh rate is set to 60Hz or 120Hz.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/luminousplus/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chusanApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/luminousplus/troubleshooting/#my-game-crashes-when-i-tab-out-of-fullscreen","title":"My game crashes when I tab out of fullscreen!","text":"

As the game is intended to run on arcade hardware, it doesn't like being minimized.

One workaround for this is to use DXVK. Download the latest version from releases. This will be a dxvk-x.y.z.tar.gz file, which you can open using 7zip. Navigate to the x32 folder, and copy the d3d9.dll file to your game's App\\bin folder, agreeing to overwrite when asked.

You should now be able to tab out of fullscreen without crashing the game.

Warning

The game will not ignore inputs when out of focus.

This means any controller inputs will still be accepted, so try not to lean onto your slider whilst tabbed out!

This also means that you can accidentally enter the service menu by hitting your Test key even if the game is minimised. If you were in the middle of a credit, your scores will be lost.

"},{"location":"games/sega/chunithm/luminousplus/troubleshooting/#when-i-run-the-game-all-other-audio-is-gone","title":"When I run the game all other audio is gone!","text":"

CHUNITHM uses WASAPI exclusive mode for audio to get better latency.

You can apply the \"Shared Audio\" patch on a CHUNITHM web patcher (see Resources) to hear audio outside of the game at the cost of audio latency.

"},{"location":"games/sega/chunithm/luminousplus/troubleshooting/#cabinet-to-cabinetc2c-fixes","title":"Cabinet-to-Cabinet(c2c) Fixes","text":"

c2c can have many problems but you can fix most of them by applying the \"Patch for head-to-head play\" and disabling \"Set all timers to 999\" on a CHUNITHM web patcher (see Resources).

If the above does not work then please ensure both machines have the exact same data and can communicate with each other if they cannot then you can try disabling firewalls or changing the c2c group.

If clicking the c2c button does nothing, you can fix it by resetting the network settings in Windows.

"},{"location":"games/sega/chunithm/new/c2c/","title":"Cab-to-Cab Play over Internet (NEW)","text":"

You are most likely to have success with Multiplayer when all users are using the SAME data and options, from the same sources. Verify that each person can run the game normally before attempting to network them together.

  • Chunithm expects the cabinets to be using specific IP addresses, 192.168.139.11/12/13/14
  • To achieve this over the internet, we can use SoftEther VPN. Refer to the Setting Up SoftEther VPN Guide for more information.
"},{"location":"games/sega/chunithm/new/c2c/#configuring-segatoolsini-game-assignments","title":"Configuring segatools.ini & Game Assignments","text":"

segatools.ini

[netnev]\nenable=1\naddrSuffix= last 2 digits of your SoftEther IP\n\n[keychip]\nenable=1\nsubnet=192.168.139.0\nid=(Everyone needs a seperate keychip. If you play on a remote network, chances are you already have your own keychip. If not, you can use the example keychips below.)\n;example keychips: A61E-01D02321145 ; A61E-01A30831145 ; A61E-01E38091145 ; A61E-01E46241145\n\n[system]\ndipsw1=1\n;This has changed since Luminous. Previously if you wish to perform cab-to-cab link, you need to set this to 1 on the Server machine, and 0 on all other client machines.\n;This change is no longer needed, just keep this set to 1 on all machines.\n

GAME ASSIGNMENTS

  • After saving your segatools.ini, launch the game and go into the Service Menu > and go to GAME ASSIGNMENTS.

  • Enable CABINET-TO-CABINET PLAY, and make sure all machine are on the same group (Group A for example).

  • Set one machine to STANDARD, and all other machines to FOLLOW THE STANDARD .

Exit the Service Menu and load into Attract Mode. If the game passes the Group Check then chances are you're good to go! You can now login to a credit and open a cab-to-cab link request to check if the connection is working properly!

"},{"location":"games/sega/chunithm/new/c2c/#how-to-link","title":"How to Link?","text":"

If you're new to Chunithm and have never tried link-play before and you have no idea how, keep reading.

  • Login to a credit.

  • If you're hosting a cab-to-cab session, choose a song first, then scroll to the far left and press Confirm. The cab-to-cab request is now open.

  • If you're connecting, navigate to the \"Cabinet-to-Cabinet Play\" tab and wait for other players to create a session.

If you are able to see each other's session, congrats! You can now enjoy some cab-to-cab chain action!

"},{"location":"games/sega/chunithm/new/c2c/#troubleshooting","title":"Troubleshooting","text":"

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/new/controllers/","title":"Controllers (NEW)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with IO DLLs to add support for controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\bin\\ folder and referenced in segatools.ini under the [chuniio] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; Uncomment this if you have custom chuniio implementation comprised of a single 32bit DLL.\n; (will use chu2to3 engine internally)\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.

If you have two DLLs, ending in _x86.dll and _x64.dll (or _chusan.dll and _amdaemon.dll), uncomment the path32= and path64= lines by removing the leading semicolon (;), then add your DLLs after the =:

[chuniio]\n; Uncomment both of these if you have custom chuniio implementation comprised of two DLLs.\n; x86 chuniio to path32, x64 to path64. Both are necessary.\n;(1)!\npath32=controller_x86.dll\npath64=controller_x64.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/new/controllers/#keyboard","title":"Keyboard","text":"

Keyboard is the default input method, and while not recommended for playing the game, it is useful for testing purposes.

The default layout uses SDFGHJKL for slider input, and Space Bar for the AIRs.

If you wish to change the default keybinds, an explanation on how to set these is included above the [io3] section in your segatools.ini.

"},{"location":"games/sega/chunithm/new/controllers/#brokenithm","title":"Brokenithm","text":"

Brokenithm allows you to use a mobile device as a CHUNITHM controller. It uses the bottom half of the screen as the ground slider, and sliding into the upper half activates the air sensors.

"},{"location":"games/sega/chunithm/new/controllers/#android","title":"Android","text":"

Warning

Your computer and your Android device must be on the same local network.

  • Download the latest version of Brokenithm-Android and install it on your Android device.
  • Download the latest version of Brokenithm-Android-Server and extract only brokenithm_server.exe to your App\\bin\\ folder.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run brokenithm_server.exe. A command prompt window should open, saying that it is waiting for a device on port 52468.
  • Open the Brokenithm app on your Android device. Enter your computer's IP address in the Address box on the top right, then tap Start.
  • Run the game as normal.
Getting your computer's IP address

Open Settings -> Network and Internet and select Properties. Scroll down to the bottom and check the address under the IPv4 address field:

That is your computer's IP address.

Automatically launching the Brokenithm server when starting the game

This will only work if you extracted brokenithm_server.exe to App\\bin\\ as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min brokenithm_server\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Improving latency

You can improve latency by running Brokenithm with your Android device tethered to your computer. However, this requires a little extra setup:

  • Connect your Android device to your computer with a USB cable.
  • If you haven't enabled Developer options on your device, do it by navigating to the \"About\" page in your phone's settings, then tap \"Build number\" seven times. This varies by device, so if unsure, look up the instructions for your specific one.
  • Navigate to Developer options and enable USB debugging.
  • On your computer, download and extract Android SDK Platform Tools to your App\\bin\\ folder.
  • Navigate to the App\\bin\\platform-tools folder in File Explorer, click on the address bar, type cmd, and hit Enter to open a command prompt.
  • In the command prompt, type the following command:
adb reverse tcp:52468 tcp:52468\n
  • Start brokenithm_server in TCP mode with the -T command line flag, brokenithm_server.exe -T.
  • On your Android device, open Brokenithm, and change the address to 0.0.0.0.
    • If the text box to the left of the \"SETTINGS\" button say \"UDP\", tap on it once to switch to \"TCP\" mode.
  • Tap on \"START\", and you will now be connected via the USB cable.
  • You can now start the game as normal.

The next time you play the game, you only need to run the adb reverse ... command again. To do this automatically when the game starts, add a line to the start.bat script before the brokenithm_server line:

@echo off\n\npushd %~dp0\n\nstart /min platform-tools\\adb reverse tcp:52468 tcp:52468\nstart /min brokenithm_server -T\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/new/controllers/#iosipados","title":"iOS/iPadOS","text":"
  • Install Brokenithm on your iOS/iPadOS device by joining the Brokenithm TestFlight (iOS 18 only).
    • If your iOS/iPadOS device doesn't have iOS 18, you will need to sideload a different IPA with Sideloadly.
  • If you have iTunes and/or iCloud installed from the Microsoft Store on your computer, uninstall it.
  • Install the non-Microsoft Store version of iTunes from the website.
  • Download the latest version of Brokenithm-Evolved-iOS server and extract it to App\\bin\\Brokenithm-Server.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run App\\bin\\Brokenithm-Server\\Brokenithm-Evolved-iOS.exe. A command prompt window should open, saying that it is waiting for a device.
  • On your iOS/iPadOS device, open Brokenithm, and connect it to your computer with a USB cable.
  • Run the game as normal.
Automatically launching the Brokenithm server when starting the game

This will only work if you extracted the server to App\\bin\\Brokenithm-Server as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min Brokenithm-Server\\Brokenithm-Evolved-iOS.exe\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/new/controllers/#tasoller","title":"TASOLLER","text":"

Warning

This guide only covers TASOLLERs running the v2.0 touch firmware. If you've purchased the controller after January 2022, the update should have already been applied.

If you've purchased the controller before then, you will need to update the touch firmware by following the instructions on DJ-DAO's support page.

  • Install the custom IO4 firmware to your controller.
  • Follow the segatools.ini config on the gitea page.
  • Connect the controller to your computer, and then start the game.
Legacy
  • Backup TASOLLER setup if IO4 cfw is not working.
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download TASOLLER IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_v2_x86.dll\npath64=chuniio_tasoller_v2_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/new/controllers/#tasoller-plus","title":"TASOLLER PLUS","text":"
  • Switch your TASOLLER PLUS to WINUSB mode. You can do so in TASOLLER Options found on the djdao support page.
  • Download TASOLLER PLUS IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_plus_x86.dll\npath64=chuniio_tasoller_plus_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/new/controllers/#yubideck","title":"YubiDeck","text":"
  • Switch your YubiDeck to HID output mode. Instructions on how to do so are provided in the YubiDeck manual.
  • Download the latest version of YubiDeck IO DLLs and extract it to your App\\bin folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_yubideck_chusan.dll\npath64=chuniio_yubideck_amdaemon.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/new/controllers/#laverita-3","title":"Laverita 3","text":"
  • Switch your Laverita to IO mode. You can do so in ConfigApp found in the yuancon discord.
  • Change the COM port of your controller. You can do so in Device manager by looking for USB Serial Device you may need to unplug and replug your controller to properly idetify which one is the Laverita.
  • Double click on it
  • Go to Port Settings
  • Click on Advanced
  • From the dropdown select COM1
  • Restart to ensure changes took effect and saved
  • Edit your App\\bin\\segatools.ini to disable io emulation and set led:
[led]\n; Output billboard LED strip data to a named pipe called \"\\\\.\\pipe\\chuni_led\"\ncabLedOutputPipe=0\n; Output billboard LED strip data to serial\ncabLedOutputSerial=1\n\n; Output slider LED data to the named pipe\ncontrollerLedOutputPipe=0\n; Output slider LED data to the serial port\ncontrollerLedOutputSerial=1\n; Use the OpeNITHM protocol for serial LED output\ncontrollerLedOutputOpeNITHM=0\n\n; Serial port to send data to if using serial output. Default is COM5.\nserialPort=COM1\n; Baud rate for serial data (set to 115200 if using OpeNITHM)\nserialBaud=9600\n\n[slider]\n; Enable slider emulation. If you have real AC slider, set this to 0.\n; Slider serial port must be COM1.\nenable=0\n\n[io4]\nenable=0\n
  • Then start the game.
Legacy
  • Backup Laverita 3 setup if IO4 cfw is not working.
  • Switch your Laverita to HID mode. You can do so in ConfigApp
  • Download Laverita IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_laverita_v3_x86.dll\npath64=chuniio_laverita_v3_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/new/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet slider and air sensors, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/chunithm/new/setup/","title":"Game Setup (NEW)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of CHUNITHM

You'll want to create a new folder for the game and start from scratch. CHUNITHM DOES NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/new/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create another empty folder named AppData next to them. It should now look like below.

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/chunithm/new/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/chunithm/new/setup/#installing-option-data","title":"Installing option data","text":"

CHUNITHM content updates are distributed through option folders instead of patching the base game. They are named A???, with each ? being a number. Custom options distributed by the community might use letters instead, to distinguish them from official ones.

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

If you plan to connect to a network (Hosted or Local), the A001 option folder for your specific game version is required. This option contains a special Event file that lets the game connect.

"},{"location":"games/sega/chunithm/new/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

CHUNITHM executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of chusanApp.exe and amdaemon.exe for your game version.

Copy chusanApp.exe and amdaemon.exe to the bin folder of your game data. Agree to overwrite when asked.

"},{"location":"games/sega/chunithm/new/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/chunithm/new/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher.

There are many patches for CHUNITHM.

We will only bring up the ones we think could be genuinely useful.

As a general rule of thumb, if you're not sure what a patch does or you're not absolutely certain you need it, leave it alone, regardless of recommendations below.

Patch Recommendation Description Force shared audio mode Either Force the game to use shared mode audio output, letting you listen to other audio sources while the game is running at the cost of audio latency. Force 2 channel audio output Either Try enabling this patch if you don't get audio output at all. Disable song select timer Either Disables the song select timer. No encryption ON Disable encrypting network requests. Required if you plan to run a local server. No TLS ON Disable checking if the server is HTTPS or not. Required if you plan to run a local server. Bypass 1080p monitor check Either Disable checking if the monitor is 1080p when enabling 120FPS. Enable if you cannot set your monitor to 1080p. Bypass 120Hz monitor check Either Disable checking if the monitor is exactly 120Hz when enabling 120FPS. Enable if you cannot set your monitor to 120Hz."},{"location":"games/sega/chunithm/new/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download segatools.zip. Do not download the source code.
  • Extracting the archive should give you a few more zip files. Find chusan.zip and extract it to the App\\bin folder in your game data.

You should now have a few more files inside the folder, as highlighted:

"},{"location":"games/sega/chunithm/new/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\bin\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[system]\ndipsw2=1\ndipsw2=1 ; WRONG!\n
"},{"location":"games/sega/chunithm/new/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

Relative Directories

The ../ in the above example represents the parent directory in a relative path. It is used to navigate up one level in the directory hierarchy.

For example, your segatools.ini is located at /App/bin/segatools.ini and your Option folder is located next to the App folder.

Since segatools.ini is in the /bin/ folder, typing ../ would move you up to the App folder. Since the Option folder is next to the App folder, the second ../ takes you to App's parent folder, which is the folder containing App, Option, etc.

The benefits of using this method include:

  • Avoiding issues that arise when folders have spaces in their names.

  • Being able to move your game folder without redefining the locations of your VFS folders.

  • A cleaner and easier to read segatools.ini, making spotting issues simpler.

"},{"location":"games/sega/chunithm/new/setup/#system","title":"[system]","text":"
  • If you have a 120Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n
"},{"location":"games/sega/chunithm/new/setup/#gfx","title":"[gfx]","text":"
  • Set windowed to 0 to run in fullscreen mode and 1 to run in windowed mode.
  • If you have multiple monitors and you're running in fullscreen mode (windowed=0), set monitor to the index of the monitor you want to run the game on.
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number minus one. For example, monitor 2 means monitor index 1.

"},{"location":"games/sega/chunithm/new/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.139.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\bin\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/new/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/chunithm/new/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/new/setup/#audio","title":"Audio","text":"
  • Right-click on the volume setting in your taskbar and select Sounds.
  • Navigate to the Playback tab, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick either 16 bit, 48000Hz (DVD Quality) or 24 bit, 48000Hz (Studio Quality), click Apply, then OK.
"},{"location":"games/sega/chunithm/new/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/chunithm/new/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/chunithm/new/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\bin\\start.bat. Let the game load until it reaches the screen below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 4th option).

Select \u30b0\u30eb\u30fc\u30d7\u5185\u57fa\u6e96\u6a5f\u8a2d\u5b9a (SET STANDARD IN GROUP, the second option) and toggle this setting to \u57fa\u6e96\u6a5f (STANDARD).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/chunithm/new/setup/#close-setting","title":"CLOSE SETTING","text":"

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the 10th option).

Navigate to \u6642 (HOUR, the 2nd option) and use the Service button to toggle the setting until it says \u5168\u6642\u523b (ALL TIME).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu, then select \u7d42\u4e86 (also the last option) in the main menu to exit the service menu.

"},{"location":"games/sega/chunithm/new/setup/#waiting-for-distribution-server","title":"Waiting for Distribution Server","text":"

If you're stuck at the Waiting for Distribution Server screen below, close the game and relaunch.

You're all done! The game should load up properly now.

You can add coins using the Coin key (default F3) and card in by holding the Enter key.

"},{"location":"games/sega/chunithm/new/setup/#further-configuration","title":"Further configuration","text":"

Input methods and controllers are covered in the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/new/troubleshooting/","title":"Troubleshooting (NEW)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/chunithm/new/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch!","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120Hz, apply the \"Bypass 120Hz monitor check\"/\"Bypass 1080p monitor check\" on a CHUNITHM web patcher (see Resources).
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\nping 127.0.0.1 -n 31 > nul && taskkill /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/chunithm/new/troubleshooting/#my-game-takes-a-long-time-to-boot","title":"My game takes a long time to boot!","text":"

CHUNITHM game files consist of thousands of small XML files, which Windows Defender takes a long time to scan through. Add your game folder to the Windows Defender exclusion list.

Danger

Doing this will prevent Windows Defender from scanning your game folder for viruses. Only do this if you trust the source of the data.

"},{"location":"games/sega/chunithm/new/troubleshooting/#my-game-is-running-too-slowfast","title":"My game is running too slow/fast","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Make sure your monitor's refresh rate is set to 60Hz or 120Hz.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/new/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chusanApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/new/troubleshooting/#my-game-crashes-when-i-tab-out-of-fullscreen","title":"My game crashes when I tab out of fullscreen!","text":"

As the game is intended to run on arcade hardware, it doesn't like being minimized.

One workaround for this is to use DXVK. Download the latest version from releases. This will be a dxvk-x.y.z.tar.gz file, which you can open using 7zip. Navigate to the x32 folder, and copy the d3d9.dll file to your game's App\\bin folder, agreeing to overwrite when asked.

You should now be able to tab out of fullscreen without crashing the game.

Warning

The game will not ignore inputs when out of focus.

This means any controller inputs will still be accepted, so try not to lean onto your slider whilst tabbed out!

This also means that you can accidentally enter the service menu by hitting your Test key even if the game is minimised. If you were in the middle of a credit, your scores will be lost.

"},{"location":"games/sega/chunithm/new/troubleshooting/#when-i-run-the-game-all-other-audio-is-gone","title":"When I run the game all other audio is gone!","text":"

CHUNITHM uses WASAPI exclusive mode for audio to get better latency.

You can apply the \"Shared Audio\" patch on a CHUNITHM web patcher (see Resources) to hear audio outside of the game at the cost of audio latency.

"},{"location":"games/sega/chunithm/new/troubleshooting/#cabinet-to-cabinetc2c-fixes","title":"Cabinet-to-Cabinet(c2c) Fixes","text":"

c2c can have many problems but you can fix most of them by applying the \"Patch for head-to-head play\" and disabling \"Set all timers to 999\" on a CHUNITHM web patcher (see Resources).

If the above does not work then please ensure both machines have the exact same data and can communicate with each other if they cannot then you can try disabling firewalls or changing the c2c group.

If clicking the c2c button does nothing, you can fix it by resetting the network settings in Windows.

"},{"location":"games/sega/chunithm/newplus/c2c/","title":"Cab-to-Cab Play over Internet (NEW PLUS)","text":"

You are most likely to have success with Multiplayer when all users are using the SAME data and options, from the same sources. Verify that each person can run the game normally before attempting to network them together.

  • Chunithm expects the cabinets to be using specific IP addresses, 192.168.139.11/12/13/14
  • To achieve this over the internet, we can use SoftEther VPN. Refer to the Setting Up SoftEther VPN Guide for more information.
"},{"location":"games/sega/chunithm/newplus/c2c/#configuring-segatoolsini-game-assignments","title":"Configuring segatools.ini & Game Assignments","text":"

segatools.ini

[netnev]\nenable=1\naddrSuffix= last 2 digits of your SoftEther IP\n\n[keychip]\nenable=1\nsubnet=192.168.139.0\nid=(Everyone needs a seperate keychip. If you play on a remote network, chances are you already have your own keychip. If not, you can use the example keychips below.)\n;example keychips: A61E-01D02321145 ; A61E-01A30831145 ; A61E-01E38091145 ; A61E-01E46241145\n\n[system]\ndipsw1=1\n;This has changed since Luminous. Previously if you wish to perform cab-to-cab link, you need to set this to 1 on the Server machine, and 0 on all other client machines.\n;This change is no longer needed, just keep this set to 1 on all machines.\n

GAME ASSIGNMENTS

  • After saving your segatools.ini, launch the game and go into the Service Menu > and go to GAME ASSIGNMENTS.

  • Enable CABINET-TO-CABINET PLAY, and make sure all machine are on the same group (Group A for example).

  • Set one machine to STANDARD, and all other machines to FOLLOW THE STANDARD .

Exit the Service Menu and load into Attract Mode. If the game passes the Group Check then chances are you're good to go! You can now login to a credit and open a cab-to-cab link request to check if the connection is working properly!

"},{"location":"games/sega/chunithm/newplus/c2c/#how-to-link","title":"How to Link?","text":"

If you're new to Chunithm and have never tried link-play before and you have no idea how, keep reading.

  • Login to a credit.

  • If you're hosting a cab-to-cab session, choose a song first, then scroll to the far left and press Confirm. The cab-to-cab request is now open.

  • If you're connecting, navigate to the \"Cabinet-to-Cabinet Play\" tab and wait for other players to create a session.

If you are able to see each other's session, congrats! You can now enjoy some cab-to-cab chain action!

"},{"location":"games/sega/chunithm/newplus/c2c/#troubleshooting","title":"Troubleshooting","text":"

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/newplus/controllers/","title":"Controllers (NEW PLUS)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with IO DLLs to add support for controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\bin\\ folder and referenced in segatools.ini under the [chuniio] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; Uncomment this if you have custom chuniio implementation comprised of a single 32bit DLL.\n; (will use chu2to3 engine internally)\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.

If you have two DLLs, ending in _x86.dll and _x64.dll (or _chusan.dll and _amdaemon.dll), uncomment the path32= and path64= lines by removing the leading semicolon (;), then add your DLLs after the =:

[chuniio]\n; Uncomment both of these if you have custom chuniio implementation comprised of two DLLs.\n; x86 chuniio to path32, x64 to path64. Both are necessary.\n;(1)!\npath32=controller_x86.dll\npath64=controller_x64.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/newplus/controllers/#keyboard","title":"Keyboard","text":"

Keyboard is the default input method, and while not recommended for playing the game, it is useful for testing purposes.

The default layout uses SDFGHJKL for slider input, and Space Bar for the AIRs.

If you wish to change the default keybinds, an explanation on how to set these is included above the [io3] section in your segatools.ini.

"},{"location":"games/sega/chunithm/newplus/controllers/#brokenithm","title":"Brokenithm","text":"

Brokenithm allows you to use a mobile device as a CHUNITHM controller. It uses the bottom half of the screen as the ground slider, and sliding into the upper half activates the air sensors.

"},{"location":"games/sega/chunithm/newplus/controllers/#android","title":"Android","text":"

Warning

Your computer and your Android device must be on the same local network.

  • Download the latest version of Brokenithm-Android and install it on your Android device.
  • Download the latest version of Brokenithm-Android-Server and extract only brokenithm_server.exe to your App\\bin\\ folder.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run brokenithm_server.exe. A command prompt window should open, saying that it is waiting for a device on port 52468.
  • Open the Brokenithm app on your Android device. Enter your computer's IP address in the Address box on the top right, then tap Start.
  • Run the game as normal.
Getting your computer's IP address

Open Settings -> Network and Internet and select Properties. Scroll down to the bottom and check the address under the IPv4 address field:

That is your computer's IP address.

Automatically launching the Brokenithm server when starting the game

This will only work if you extracted brokenithm_server.exe to App\\bin\\ as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min brokenithm_server\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Improving latency

You can improve latency by running Brokenithm with your Android device tethered to your computer. However, this requires a little extra setup:

  • Connect your Android device to your computer with a USB cable.
  • If you haven't enabled Developer options on your device, do it by navigating to the \"About\" page in your phone's settings, then tap \"Build number\" seven times. This varies by device, so if unsure, look up the instructions for your specific one.
  • Navigate to Developer options and enable USB debugging.
  • On your computer, download and extract Android SDK Platform Tools to your App\\bin\\ folder.
  • Navigate to the App\\bin\\platform-tools folder in File Explorer, click on the address bar, type cmd, and hit Enter to open a command prompt.
  • In the command prompt, type the following command:
adb reverse tcp:52468 tcp:52468\n
  • Start brokenithm_server in TCP mode with the -T command line flag, brokenithm_server.exe -T.
  • On your Android device, open Brokenithm, and change the address to 0.0.0.0.
    • If the text box to the left of the \"SETTINGS\" button say \"UDP\", tap on it once to switch to \"TCP\" mode.
  • Tap on \"START\", and you will now be connected via the USB cable.
  • You can now start the game as normal.

The next time you play the game, you only need to run the adb reverse ... command again. To do this automatically when the game starts, add a line to the start.bat script before the brokenithm_server line:

@echo off\n\npushd %~dp0\n\nstart /min platform-tools\\adb reverse tcp:52468 tcp:52468\nstart /min brokenithm_server -T\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/newplus/controllers/#iosipados","title":"iOS/iPadOS","text":"
  • Install Brokenithm on your iOS/iPadOS device by joining the Brokenithm TestFlight (iOS 18 only).
    • If your iOS/iPadOS device doesn't have iOS 18, you will need to sideload a different IPA with Sideloadly.
  • If you have iTunes and/or iCloud installed from the Microsoft Store on your computer, uninstall it.
  • Install the non-Microsoft Store version of iTunes from the website.
  • Download the latest version of Brokenithm-Evolved-iOS server and extract it to App\\bin\\Brokenithm-Server.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run App\\bin\\Brokenithm-Server\\Brokenithm-Evolved-iOS.exe. A command prompt window should open, saying that it is waiting for a device.
  • On your iOS/iPadOS device, open Brokenithm, and connect it to your computer with a USB cable.
  • Run the game as normal.
Automatically launching the Brokenithm server when starting the game

This will only work if you extracted the server to App\\bin\\Brokenithm-Server as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min Brokenithm-Server\\Brokenithm-Evolved-iOS.exe\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/newplus/controllers/#tasoller","title":"TASOLLER","text":"

Warning

This guide only covers TASOLLERs running the v2.0 touch firmware. If you've purchased the controller after January 2022, the update should have already been applied.

If you've purchased the controller before then, you will need to update the touch firmware by following the instructions on DJ-DAO's support page.

  • Install the custom IO4 firmware to your controller.
  • Follow the segatools.ini config on the gitea page.
  • Connect the controller to your computer, and then start the game.
Legacy
  • Backup TASOLLER setup if IO4 cfw is not working.
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download TASOLLER IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_v2_x86.dll\npath64=chuniio_tasoller_v2_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/newplus/controllers/#tasoller-plus","title":"TASOLLER PLUS","text":"
  • Switch your TASOLLER PLUS to WINUSB mode. You can do so in TASOLLER Options found on the djdao support page.
  • Download TASOLLER PLUS IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_plus_x86.dll\npath64=chuniio_tasoller_plus_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/newplus/controllers/#yubideck","title":"YubiDeck","text":"
  • Switch your YubiDeck to HID output mode. Instructions on how to do so are provided in the YubiDeck manual.
  • Download the latest version of YubiDeck IO DLLs and extract it to your App\\bin folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_yubideck_chusan.dll\npath64=chuniio_yubideck_amdaemon.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/newplus/controllers/#laverita-3","title":"Laverita 3","text":"
  • Switch your Laverita to IO mode. You can do so in ConfigApp found in the yuancon discord.
  • Change the COM port of your controller. You can do so in Device manager by looking for USB Serial Device you may need to unplug and replug your controller to properly idetify which one is the Laverita.
  • Double click on it
  • Go to Port Settings
  • Click on Advanced
  • From the dropdown select COM1
  • Restart to ensure changes took effect and saved
  • Edit your App\\bin\\segatools.ini to disable io emulation and set led:
[led]\n; Output billboard LED strip data to a named pipe called \"\\\\.\\pipe\\chuni_led\"\ncabLedOutputPipe=0\n; Output billboard LED strip data to serial\ncabLedOutputSerial=1\n\n; Output slider LED data to the named pipe\ncontrollerLedOutputPipe=0\n; Output slider LED data to the serial port\ncontrollerLedOutputSerial=1\n; Use the OpeNITHM protocol for serial LED output\ncontrollerLedOutputOpeNITHM=0\n\n; Serial port to send data to if using serial output. Default is COM5.\nserialPort=COM1\n; Baud rate for serial data (set to 115200 if using OpeNITHM)\nserialBaud=9600\n\n[slider]\n; Enable slider emulation. If you have real AC slider, set this to 0.\n; Slider serial port must be COM1.\nenable=0\n\n[io4]\nenable=0\n
  • Then start the game.
Legacy
  • Backup Laverita 3 setup if IO4 cfw is not working.
  • Switch your Laverita to HID mode. You can do so in ConfigApp
  • Download Laverita IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_laverita_v3_x86.dll\npath64=chuniio_laverita_v3_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/newplus/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet slider and air sensors, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/chunithm/newplus/setup/","title":"Game Setup (NEW PLUS)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of CHUNITHM

You'll want to create a new folder for the game and start from scratch. CHUNITHM DOES NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/newplus/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create another empty folder named AppData next to them. It should now look like below.

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/chunithm/newplus/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/chunithm/newplus/setup/#installing-option-data","title":"Installing option data","text":"

CHUNITHM content updates are distributed through option folders instead of patching the base game. They are named A???, with each ? being a number. Custom options distributed by the community might use letters instead, to distinguish them from official ones.

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

If you plan to connect to a network (Hosted or Local), the A001 option folder for your specific game version is required. This option contains a special Event file that lets the game connect.

"},{"location":"games/sega/chunithm/newplus/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

CHUNITHM executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of chusanApp.exe and amdaemon.exe for your game version.

Copy chusanApp.exe and amdaemon.exe to the bin folder of your game data. Agree to overwrite when asked.

"},{"location":"games/sega/chunithm/newplus/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/chunithm/newplus/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher.

There are many patches for CHUNITHM.

We will only bring up the ones we think could be genuinely useful.

As a general rule of thumb, if you're not sure what a patch does or you're not absolutely certain you need it, leave it alone, regardless of recommendations below.

Patch Recommendation Description Force shared audio mode Either Force the game to use shared mode audio output, letting you listen to other audio sources while the game is running at the cost of audio latency. Force 2 channel audio output Either Try enabling this patch if you don't get audio output at all. Disable song select timer Either Disables the song select timer. No encryption ON Disable encrypting network requests. Required if you plan to run a local server. No TLS ON Disable checking if the server is HTTPS or not. Required if you plan to run a local server. Bypass 1080p monitor check Either Disable checking if the monitor is 1080p when enabling 120FPS. Enable if you cannot set your monitor to 1080p. Bypass 120Hz monitor check Either Disable checking if the monitor is exactly 120Hz when enabling 120FPS. Enable if you cannot set your monitor to 120Hz."},{"location":"games/sega/chunithm/newplus/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download segatools.zip. Do not download the source code.
  • Extracting the archive should give you a few more zip files. Find chusan.zip and extract it to the App\\bin folder in your game data.

You should now have a few more files inside the folder, as highlighted:

"},{"location":"games/sega/chunithm/newplus/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\bin\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[system]\ndipsw2=1\ndipsw2=1 ; WRONG!\n
"},{"location":"games/sega/chunithm/newplus/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

Relative Directories

The ../ in the above example represents the parent directory in a relative path. It is used to navigate up one level in the directory hierarchy.

For example, your segatools.ini is located at /App/bin/segatools.ini and your Option folder is located next to the App folder.

Since segatools.ini is in the /bin/ folder, typing ../ would move you up to the App folder. Since the Option folder is next to the App folder, the second ../ takes you to App's parent folder, which is the folder containing App, Option, etc.

The benefits of using this method include:

  • Avoiding issues that arise when folders have spaces in their names.

  • Being able to move your game folder without redefining the locations of your VFS folders.

  • A cleaner and easier to read segatools.ini, making spotting issues simpler.

"},{"location":"games/sega/chunithm/newplus/setup/#system","title":"[system]","text":"
  • If you have a 120Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n
"},{"location":"games/sega/chunithm/newplus/setup/#gfx","title":"[gfx]","text":"
  • Set windowed to 0 to run in fullscreen mode and 1 to run in windowed mode.
  • If you have multiple monitors and you're running in fullscreen mode (windowed=0), set monitor to the index of the monitor you want to run the game on.
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number minus one. For example, monitor 2 means monitor index 1.

"},{"location":"games/sega/chunithm/newplus/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.139.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\bin\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/newplus/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/chunithm/newplus/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/newplus/setup/#audio","title":"Audio","text":"
  • Right-click on the volume setting in your taskbar and select Sounds.
  • Navigate to the Playback tab, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick either 16 bit, 48000Hz (DVD Quality) or 24 bit, 48000Hz (Studio Quality), click Apply, then OK.
"},{"location":"games/sega/chunithm/newplus/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/chunithm/newplus/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/chunithm/newplus/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\bin\\start.bat. Let the game load until it reaches the screen below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 4th option).

Select \u30b0\u30eb\u30fc\u30d7\u5185\u57fa\u6e96\u6a5f\u8a2d\u5b9a (SET STANDARD IN GROUP, the second option) and toggle this setting to \u57fa\u6e96\u6a5f (STANDARD).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/chunithm/newplus/setup/#close-setting","title":"CLOSE SETTING","text":"

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the 10th option).

Navigate to \u6642 (HOUR, the 2nd option) and use the Service button to toggle the setting until it says \u5168\u6642\u523b (ALL TIME).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu, then select \u7d42\u4e86 (also the last option) in the main menu to exit the service menu.

"},{"location":"games/sega/chunithm/newplus/setup/#waiting-for-distribution-server","title":"Waiting for Distribution Server","text":"

If you're stuck at the Waiting for Distribution Server screen below, close the game and relaunch.

You're all done! The game should load up properly now.

You can add coins using the Coin key (default F3) and card in by holding the Enter key.

"},{"location":"games/sega/chunithm/newplus/setup/#further-configuration","title":"Further configuration","text":"

Input methods and controllers are covered in the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/newplus/troubleshooting/","title":"Troubleshooting (NEW PLUS)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/chunithm/newplus/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch!","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120Hz, apply the \"Bypass 120Hz monitor check\"/\"Bypass 1080p monitor check\" on a CHUNITHM web patcher (see Resources).
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\nping 127.0.0.1 -n 31 > nul && taskkill /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/chunithm/newplus/troubleshooting/#my-game-takes-a-long-time-to-boot","title":"My game takes a long time to boot!","text":"

CHUNITHM game files consist of thousands of small XML files, which Windows Defender takes a long time to scan through. Add your game folder to the Windows Defender exclusion list.

Danger

Doing this will prevent Windows Defender from scanning your game folder for viruses. Only do this if you trust the source of the data.

"},{"location":"games/sega/chunithm/newplus/troubleshooting/#my-game-is-running-too-slowfast","title":"My game is running too slow/fast","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Make sure your monitor's refresh rate is set to 60Hz or 120Hz.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/newplus/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chusanApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/newplus/troubleshooting/#my-game-crashes-when-i-tab-out-of-fullscreen","title":"My game crashes when I tab out of fullscreen!","text":"

As the game is intended to run on arcade hardware, it doesn't like being minimized.

One workaround for this is to use DXVK. Download the latest version from releases. This will be a dxvk-x.y.z.tar.gz file, which you can open using 7zip. Navigate to the x32 folder, and copy the d3d9.dll file to your game's App\\bin folder, agreeing to overwrite when asked.

You should now be able to tab out of fullscreen without crashing the game.

Warning

The game will not ignore inputs when out of focus.

This means any controller inputs will still be accepted, so try not to lean onto your slider whilst tabbed out!

This also means that you can accidentally enter the service menu by hitting your Test key even if the game is minimised. If you were in the middle of a credit, your scores will be lost.

"},{"location":"games/sega/chunithm/newplus/troubleshooting/#when-i-run-the-game-all-other-audio-is-gone","title":"When I run the game all other audio is gone!","text":"

CHUNITHM uses WASAPI exclusive mode for audio to get better latency.

You can apply the \"Shared Audio\" patch on a CHUNITHM web patcher (see Resources) to hear audio outside of the game at the cost of audio latency.

"},{"location":"games/sega/chunithm/newplus/troubleshooting/#cabinet-to-cabinetc2c-fixes","title":"Cabinet-to-Cabinet(c2c) Fixes","text":"

c2c can have many problems but you can fix most of them by applying the \"Patch for head-to-head play\" and disabling \"Set all timers to 999\" on a CHUNITHM web patcher (see Resources).

If the above does not work then please ensure both machines have the exact same data and can communicate with each other if they cannot then you can try disabling firewalls or changing the c2c group.

If clicking the c2c button does nothing, you can fix it by resetting the network settings in Windows.

"},{"location":"games/sega/chunithm/sun/c2c/","title":"Cab-to-Cab Play over Internet (SUN)","text":"

You are most likely to have success with Multiplayer when all users are using the SAME data and options, from the same sources. Verify that each person can run the game normally before attempting to network them together.

  • Chunithm expects the cabinets to be using specific IP addresses, 192.168.139.11/12/13/14
  • To achieve this over the internet, we can use SoftEther VPN. Refer to the Setting Up SoftEther VPN Guide for more information.
"},{"location":"games/sega/chunithm/sun/c2c/#configuring-segatoolsini-game-assignments","title":"Configuring segatools.ini & Game Assignments","text":"

segatools.ini

[netnev]\nenable=1\naddrSuffix= last 2 digits of your SoftEther IP\n\n[keychip]\nenable=1\nsubnet=192.168.139.0\nid=(Everyone needs a seperate keychip. If you play on a remote network, chances are you already have your own keychip. If not, you can use the example keychips below.)\n;example keychips: A61E-01D02321145 ; A61E-01A30831145 ; A61E-01E38091145 ; A61E-01E46241145\n\n[system]\ndipsw1=1\n;This has changed since Luminous. Previously if you wish to perform cab-to-cab link, you need to set this to 1 on the Server machine, and 0 on all other client machines.\n;This change is no longer needed, just keep this set to 1 on all machines.\n

GAME ASSIGNMENTS

  • After saving your segatools.ini, launch the game and go into the Service Menu > and go to GAME ASSIGNMENTS.

  • Enable CABINET-TO-CABINET PLAY, and make sure all machine are on the same group (Group A for example).

  • Set one machine to STANDARD, and all other machines to FOLLOW THE STANDARD .

Exit the Service Menu and load into Attract Mode. If the game passes the Group Check then chances are you're good to go! You can now login to a credit and open a cab-to-cab link request to check if the connection is working properly!

"},{"location":"games/sega/chunithm/sun/c2c/#how-to-link","title":"How to Link?","text":"

If you're new to Chunithm and have never tried link-play before and you have no idea how, keep reading.

  • Login to a credit.

  • If you're hosting a cab-to-cab session, choose a song first, then scroll to the far left and press Confirm. The cab-to-cab request is now open.

  • If you're connecting, navigate to the \"Cabinet-to-Cabinet Play\" tab and wait for other players to create a session.

If you are able to see each other's session, congrats! You can now enjoy some cab-to-cab chain action!

"},{"location":"games/sega/chunithm/sun/c2c/#troubleshooting","title":"Troubleshooting","text":"

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/sun/controllers/","title":"Controllers (SUN)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with IO DLLs to add support for controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\bin\\ folder and referenced in segatools.ini under the [chuniio] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; Uncomment this if you have custom chuniio implementation comprised of a single 32bit DLL.\n; (will use chu2to3 engine internally)\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.

If you have two DLLs, ending in _x86.dll and _x64.dll (or _chusan.dll and _amdaemon.dll), uncomment the path32= and path64= lines by removing the leading semicolon (;), then add your DLLs after the =:

[chuniio]\n; Uncomment both of these if you have custom chuniio implementation comprised of two DLLs.\n; x86 chuniio to path32, x64 to path64. Both are necessary.\n;(1)!\npath32=controller_x86.dll\npath64=controller_x64.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/sun/controllers/#keyboard","title":"Keyboard","text":"

Keyboard is the default input method, and while not recommended for playing the game, it is useful for testing purposes.

The default layout uses SDFGHJKL for slider input, and Space Bar for the AIRs.

If you wish to change the default keybinds, an explanation on how to set these is included above the [io3] section in your segatools.ini.

"},{"location":"games/sega/chunithm/sun/controllers/#brokenithm","title":"Brokenithm","text":"

Brokenithm allows you to use a mobile device as a CHUNITHM controller. It uses the bottom half of the screen as the ground slider, and sliding into the upper half activates the air sensors.

"},{"location":"games/sega/chunithm/sun/controllers/#android","title":"Android","text":"

Warning

Your computer and your Android device must be on the same local network.

  • Download the latest version of Brokenithm-Android and install it on your Android device.
  • Download the latest version of Brokenithm-Android-Server and extract only brokenithm_server.exe to your App\\bin\\ folder.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run brokenithm_server.exe. A command prompt window should open, saying that it is waiting for a device on port 52468.
  • Open the Brokenithm app on your Android device. Enter your computer's IP address in the Address box on the top right, then tap Start.
  • Run the game as normal.
Getting your computer's IP address

Open Settings -> Network and Internet and select Properties. Scroll down to the bottom and check the address under the IPv4 address field:

That is your computer's IP address.

Automatically launching the Brokenithm server when starting the game

This will only work if you extracted brokenithm_server.exe to App\\bin\\ as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min brokenithm_server\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Improving latency

You can improve latency by running Brokenithm with your Android device tethered to your computer. However, this requires a little extra setup:

  • Connect your Android device to your computer with a USB cable.
  • If you haven't enabled Developer options on your device, do it by navigating to the \"About\" page in your phone's settings, then tap \"Build number\" seven times. This varies by device, so if unsure, look up the instructions for your specific one.
  • Navigate to Developer options and enable USB debugging.
  • On your computer, download and extract Android SDK Platform Tools to your App\\bin\\ folder.
  • Navigate to the App\\bin\\platform-tools folder in File Explorer, click on the address bar, type cmd, and hit Enter to open a command prompt.
  • In the command prompt, type the following command:
adb reverse tcp:52468 tcp:52468\n
  • Start brokenithm_server in TCP mode with the -T command line flag, brokenithm_server.exe -T.
  • On your Android device, open Brokenithm, and change the address to 0.0.0.0.
    • If the text box to the left of the \"SETTINGS\" button say \"UDP\", tap on it once to switch to \"TCP\" mode.
  • Tap on \"START\", and you will now be connected via the USB cable.
  • You can now start the game as normal.

The next time you play the game, you only need to run the adb reverse ... command again. To do this automatically when the game starts, add a line to the start.bat script before the brokenithm_server line:

@echo off\n\npushd %~dp0\n\nstart /min platform-tools\\adb reverse tcp:52468 tcp:52468\nstart /min brokenithm_server -T\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/sun/controllers/#iosipados","title":"iOS/iPadOS","text":"
  • Install Brokenithm on your iOS/iPadOS device by joining the Brokenithm TestFlight (iOS 18 only).
    • If your iOS/iPadOS device doesn't have iOS 18, you will need to sideload a different IPA with Sideloadly.
  • If you have iTunes and/or iCloud installed from the Microsoft Store on your computer, uninstall it.
  • Install the non-Microsoft Store version of iTunes from the website.
  • Download the latest version of Brokenithm-Evolved-iOS server and extract it to App\\bin\\Brokenithm-Server.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run App\\bin\\Brokenithm-Server\\Brokenithm-Evolved-iOS.exe. A command prompt window should open, saying that it is waiting for a device.
  • On your iOS/iPadOS device, open Brokenithm, and connect it to your computer with a USB cable.
  • Run the game as normal.
Automatically launching the Brokenithm server when starting the game

This will only work if you extracted the server to App\\bin\\Brokenithm-Server as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min Brokenithm-Server\\Brokenithm-Evolved-iOS.exe\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/sun/controllers/#tasoller","title":"TASOLLER","text":"

Warning

This guide only covers TASOLLERs running the v2.0 touch firmware. If you've purchased the controller after January 2022, the update should have already been applied.

If you've purchased the controller before then, you will need to update the touch firmware by following the instructions on DJ-DAO's support page.

  • Install the custom IO4 firmware to your controller.
  • Follow the segatools.ini config on the gitea page.
  • Connect the controller to your computer, and then start the game.
Legacy
  • Backup TASOLLER setup if IO4 cfw is not working.
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download TASOLLER IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_v2_x86.dll\npath64=chuniio_tasoller_v2_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/sun/controllers/#tasoller-plus","title":"TASOLLER PLUS","text":"
  • Switch your TASOLLER PLUS to WINUSB mode. You can do so in TASOLLER Options found on the djdao support page.
  • Download TASOLLER PLUS IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_plus_x86.dll\npath64=chuniio_tasoller_plus_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/sun/controllers/#yubideck","title":"YubiDeck","text":"
  • Switch your YubiDeck to HID output mode. Instructions on how to do so are provided in the YubiDeck manual.
  • Download the latest version of YubiDeck IO DLLs and extract it to your App\\bin folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_yubideck_chusan.dll\npath64=chuniio_yubideck_amdaemon.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/sun/controllers/#laverita-3","title":"Laverita 3","text":"
  • Switch your Laverita to IO mode. You can do so in ConfigApp found in the yuancon discord.
  • Change the COM port of your controller. You can do so in Device manager by looking for USB Serial Device you may need to unplug and replug your controller to properly idetify which one is the Laverita.
  • Double click on it
  • Go to Port Settings
  • Click on Advanced
  • From the dropdown select COM1
  • Restart to ensure changes took effect and saved
  • Edit your App\\bin\\segatools.ini to disable io emulation and set led:
[led]\n; Output billboard LED strip data to a named pipe called \"\\\\.\\pipe\\chuni_led\"\ncabLedOutputPipe=0\n; Output billboard LED strip data to serial\ncabLedOutputSerial=1\n\n; Output slider LED data to the named pipe\ncontrollerLedOutputPipe=0\n; Output slider LED data to the serial port\ncontrollerLedOutputSerial=1\n; Use the OpeNITHM protocol for serial LED output\ncontrollerLedOutputOpeNITHM=0\n\n; Serial port to send data to if using serial output. Default is COM5.\nserialPort=COM1\n; Baud rate for serial data (set to 115200 if using OpeNITHM)\nserialBaud=9600\n\n[slider]\n; Enable slider emulation. If you have real AC slider, set this to 0.\n; Slider serial port must be COM1.\nenable=0\n\n[io4]\nenable=0\n
  • Then start the game.
Legacy
  • Backup Laverita 3 setup if IO4 cfw is not working.
  • Switch your Laverita to HID mode. You can do so in ConfigApp
  • Download Laverita IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_laverita_v3_x86.dll\npath64=chuniio_laverita_v3_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/sun/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet slider and air sensors, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/chunithm/sun/setup/","title":"Game Setup (SUN)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of CHUNITHM

You'll want to create a new folder for the game and start from scratch. CHUNITHM DOES NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/sun/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create another empty folder named AppData next to them. It should now look like below.

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/chunithm/sun/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/chunithm/sun/setup/#installing-option-data","title":"Installing option data","text":"

CHUNITHM content updates are distributed through option folders instead of patching the base game. They are named A???, with each ? being a number. Custom options distributed by the community might use letters instead, to distinguish them from official ones.

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

If you plan to connect to a network (Hosted or Local), the A001 option folder for your specific game version is required. This option contains a special Event file that lets the game connect.

"},{"location":"games/sega/chunithm/sun/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

CHUNITHM executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of chusanApp.exe and amdaemon.exe for your game version.

Copy chusanApp.exe and amdaemon.exe to the bin folder of your game data. Agree to overwrite when asked.

"},{"location":"games/sega/chunithm/sun/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/chunithm/sun/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher.

There are many patches for CHUNITHM.

We will only bring up the ones we think could be genuinely useful.

As a general rule of thumb, if you're not sure what a patch does or you're not absolutely certain you need it, leave it alone, regardless of recommendations below.

Patch Recommendation Description Force shared audio mode Either Force the game to use shared mode audio output, letting you listen to other audio sources while the game is running at the cost of audio latency. Force 2 channel audio output Either Try enabling this patch if you don't get audio output at all. Disable song select timer Either Disables the song select timer. No encryption ON Disable encrypting network requests. Required if you plan to run a local server. No TLS ON Disable checking if the server is HTTPS or not. Required if you plan to run a local server. Bypass 1080p monitor check Either Disable checking if the monitor is 1080p when enabling 120FPS. Enable if you cannot set your monitor to 1080p. Bypass 120Hz monitor check Either Disable checking if the monitor is exactly 120Hz when enabling 120FPS. Enable if you cannot set your monitor to 120Hz."},{"location":"games/sega/chunithm/sun/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download segatools.zip. Do not download the source code.
  • Extracting the archive should give you a few more zip files. Find chusan.zip and extract it to the App\\bin folder in your game data.

You should now have a few more files inside the folder, as highlighted:

"},{"location":"games/sega/chunithm/sun/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\bin\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[system]\ndipsw2=1\ndipsw2=1 ; WRONG!\n
"},{"location":"games/sega/chunithm/sun/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

Relative Directories

The ../ in the above example represents the parent directory in a relative path. It is used to navigate up one level in the directory hierarchy.

For example, your segatools.ini is located at /App/bin/segatools.ini and your Option folder is located next to the App folder.

Since segatools.ini is in the /bin/ folder, typing ../ would move you up to the App folder. Since the Option folder is next to the App folder, the second ../ takes you to App's parent folder, which is the folder containing App, Option, etc.

The benefits of using this method include:

  • Avoiding issues that arise when folders have spaces in their names.

  • Being able to move your game folder without redefining the locations of your VFS folders.

  • A cleaner and easier to read segatools.ini, making spotting issues simpler.

"},{"location":"games/sega/chunithm/sun/setup/#system","title":"[system]","text":"
  • If you have a 120Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n
"},{"location":"games/sega/chunithm/sun/setup/#gfx","title":"[gfx]","text":"
  • Set windowed to 0 to run in fullscreen mode and 1 to run in windowed mode.
  • If you have multiple monitors and you're running in fullscreen mode (windowed=0), set monitor to the index of the monitor you want to run the game on.
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number minus one. For example, monitor 2 means monitor index 1.

"},{"location":"games/sega/chunithm/sun/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.139.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\bin\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/sun/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/chunithm/sun/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/sun/setup/#audio","title":"Audio","text":"
  • Right-click on the volume setting in your taskbar and select Sounds.
  • Navigate to the Playback tab, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick either 16 bit, 48000Hz (DVD Quality) or 24 bit, 48000Hz (Studio Quality), click Apply, then OK.
"},{"location":"games/sega/chunithm/sun/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/chunithm/sun/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/chunithm/sun/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\bin\\start.bat. Let the game load until it reaches the screen below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 4th option).

Select \u30b0\u30eb\u30fc\u30d7\u5185\u57fa\u6e96\u6a5f\u8a2d\u5b9a (SET STANDARD IN GROUP, the second option) and toggle this setting to \u57fa\u6e96\u6a5f (STANDARD).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/chunithm/sun/setup/#close-setting","title":"CLOSE SETTING","text":"

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the 10th option).

Navigate to \u6642 (HOUR, the 2nd option) and use the Service button to toggle the setting until it says \u5168\u6642\u523b (ALL TIME).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu, then select \u7d42\u4e86 (also the last option) in the main menu to exit the service menu.

"},{"location":"games/sega/chunithm/sun/setup/#waiting-for-distribution-server","title":"Waiting for Distribution Server","text":"

If you're stuck at the Waiting for Distribution Server screen below, close the game and relaunch.

You're all done! The game should load up properly now.

You can add coins using the Coin key (default F3) and card in by holding the Enter key.

"},{"location":"games/sega/chunithm/sun/setup/#further-configuration","title":"Further configuration","text":"

Input methods and controllers are covered in the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/sun/troubleshooting/","title":"Troubleshooting (SUN)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/chunithm/sun/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch!","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120Hz, apply the \"Bypass 120Hz monitor check\"/\"Bypass 1080p monitor check\" on a CHUNITHM web patcher (see Resources).
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\nping 127.0.0.1 -n 31 > nul && taskkill /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/chunithm/sun/troubleshooting/#my-game-takes-a-long-time-to-boot","title":"My game takes a long time to boot!","text":"

CHUNITHM game files consist of thousands of small XML files, which Windows Defender takes a long time to scan through. Add your game folder to the Windows Defender exclusion list.

Danger

Doing this will prevent Windows Defender from scanning your game folder for viruses. Only do this if you trust the source of the data.

"},{"location":"games/sega/chunithm/sun/troubleshooting/#my-game-is-running-too-slowfast","title":"My game is running too slow/fast","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Make sure your monitor's refresh rate is set to 60Hz or 120Hz.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/sun/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chusanApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/sun/troubleshooting/#my-game-crashes-when-i-tab-out-of-fullscreen","title":"My game crashes when I tab out of fullscreen!","text":"

As the game is intended to run on arcade hardware, it doesn't like being minimized.

One workaround for this is to use DXVK. Download the latest version from releases. This will be a dxvk-x.y.z.tar.gz file, which you can open using 7zip. Navigate to the x32 folder, and copy the d3d9.dll file to your game's App\\bin folder, agreeing to overwrite when asked.

You should now be able to tab out of fullscreen without crashing the game.

Warning

The game will not ignore inputs when out of focus.

This means any controller inputs will still be accepted, so try not to lean onto your slider whilst tabbed out!

This also means that you can accidentally enter the service menu by hitting your Test key even if the game is minimised. If you were in the middle of a credit, your scores will be lost.

"},{"location":"games/sega/chunithm/sun/troubleshooting/#when-i-run-the-game-all-other-audio-is-gone","title":"When I run the game all other audio is gone!","text":"

CHUNITHM uses WASAPI exclusive mode for audio to get better latency.

You can apply the \"Shared Audio\" patch on a CHUNITHM web patcher (see Resources) to hear audio outside of the game at the cost of audio latency.

"},{"location":"games/sega/chunithm/sun/troubleshooting/#cabinet-to-cabinetc2c-fixes","title":"Cabinet-to-Cabinet(c2c) Fixes","text":"

c2c can have many problems but you can fix most of them by applying the \"Patch for head-to-head play\" and disabling \"Set all timers to 999\" on a CHUNITHM web patcher (see Resources).

If the above does not work then please ensure both machines have the exact same data and can communicate with each other if they cannot then you can try disabling firewalls or changing the c2c group.

If clicking the c2c button does nothing, you can fix it by resetting the network settings in Windows.

"},{"location":"games/sega/chunithm/sunplus/c2c/","title":"Cab-to-Cab Play over Internet (SUN PLUS)","text":"

You are most likely to have success with Multiplayer when all users are using the SAME data and options, from the same sources. Verify that each person can run the game normally before attempting to network them together.

  • Chunithm expects the cabinets to be using specific IP addresses, 192.168.139.11/12/13/14
  • To achieve this over the internet, we can use SoftEther VPN. Refer to the Setting Up SoftEther VPN Guide for more information.
"},{"location":"games/sega/chunithm/sunplus/c2c/#configuring-segatoolsini-game-assignments","title":"Configuring segatools.ini & Game Assignments","text":"

segatools.ini

[netnev]\nenable=1\naddrSuffix= last 2 digits of your SoftEther IP\n\n[keychip]\nenable=1\nsubnet=192.168.139.0\nid=(Everyone needs a seperate keychip. If you play on a remote network, chances are you already have your own keychip. If not, you can use the example keychips below.)\n;example keychips: A61E-01D02321145 ; A61E-01A30831145 ; A61E-01E38091145 ; A61E-01E46241145\n\n[system]\ndipsw1=1\n;This has changed since Luminous. Previously if you wish to perform cab-to-cab link, you need to set this to 1 on the Server machine, and 0 on all other client machines.\n;This change is no longer needed, just keep this set to 1 on all machines.\n

GAME ASSIGNMENTS

  • After saving your segatools.ini, launch the game and go into the Service Menu > and go to GAME ASSIGNMENTS.

  • Enable CABINET-TO-CABINET PLAY, and make sure all machine are on the same group (Group A for example).

  • Set one machine to STANDARD, and all other machines to FOLLOW THE STANDARD .

Exit the Service Menu and load into Attract Mode. If the game passes the Group Check then chances are you're good to go! You can now login to a credit and open a cab-to-cab link request to check if the connection is working properly!

"},{"location":"games/sega/chunithm/sunplus/c2c/#how-to-link","title":"How to Link?","text":"

If you're new to Chunithm and have never tried link-play before and you have no idea how, keep reading.

  • Login to a credit.

  • If you're hosting a cab-to-cab session, choose a song first, then scroll to the far left and press Confirm. The cab-to-cab request is now open.

  • If you're connecting, navigate to the \"Cabinet-to-Cabinet Play\" tab and wait for other players to create a session.

If you are able to see each other's session, congrats! You can now enjoy some cab-to-cab chain action!

"},{"location":"games/sega/chunithm/sunplus/c2c/#troubleshooting","title":"Troubleshooting","text":"

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/sunplus/controllers/","title":"Controllers (SUN PLUS)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with IO DLLs to add support for controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\bin\\ folder and referenced in segatools.ini under the [chuniio] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; Uncomment this if you have custom chuniio implementation comprised of a single 32bit DLL.\n; (will use chu2to3 engine internally)\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.

If you have two DLLs, ending in _x86.dll and _x64.dll (or _chusan.dll and _amdaemon.dll), uncomment the path32= and path64= lines by removing the leading semicolon (;), then add your DLLs after the =:

[chuniio]\n; Uncomment both of these if you have custom chuniio implementation comprised of two DLLs.\n; x86 chuniio to path32, x64 to path64. Both are necessary.\n;(1)!\npath32=controller_x86.dll\npath64=controller_x64.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/sunplus/controllers/#keyboard","title":"Keyboard","text":"

Keyboard is the default input method, and while not recommended for playing the game, it is useful for testing purposes.

The default layout uses SDFGHJKL for slider input, and Space Bar for the AIRs.

If you wish to change the default keybinds, an explanation on how to set these is included above the [io3] section in your segatools.ini.

"},{"location":"games/sega/chunithm/sunplus/controllers/#brokenithm","title":"Brokenithm","text":"

Brokenithm allows you to use a mobile device as a CHUNITHM controller. It uses the bottom half of the screen as the ground slider, and sliding into the upper half activates the air sensors.

"},{"location":"games/sega/chunithm/sunplus/controllers/#android","title":"Android","text":"

Warning

Your computer and your Android device must be on the same local network.

  • Download the latest version of Brokenithm-Android and install it on your Android device.
  • Download the latest version of Brokenithm-Android-Server and extract only brokenithm_server.exe to your App\\bin\\ folder.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run brokenithm_server.exe. A command prompt window should open, saying that it is waiting for a device on port 52468.
  • Open the Brokenithm app on your Android device. Enter your computer's IP address in the Address box on the top right, then tap Start.
  • Run the game as normal.
Getting your computer's IP address

Open Settings -> Network and Internet and select Properties. Scroll down to the bottom and check the address under the IPv4 address field:

That is your computer's IP address.

Automatically launching the Brokenithm server when starting the game

This will only work if you extracted brokenithm_server.exe to App\\bin\\ as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min brokenithm_server\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Improving latency

You can improve latency by running Brokenithm with your Android device tethered to your computer. However, this requires a little extra setup:

  • Connect your Android device to your computer with a USB cable.
  • If you haven't enabled Developer options on your device, do it by navigating to the \"About\" page in your phone's settings, then tap \"Build number\" seven times. This varies by device, so if unsure, look up the instructions for your specific one.
  • Navigate to Developer options and enable USB debugging.
  • On your computer, download and extract Android SDK Platform Tools to your App\\bin\\ folder.
  • Navigate to the App\\bin\\platform-tools folder in File Explorer, click on the address bar, type cmd, and hit Enter to open a command prompt.
  • In the command prompt, type the following command:
adb reverse tcp:52468 tcp:52468\n
  • Start brokenithm_server in TCP mode with the -T command line flag, brokenithm_server.exe -T.
  • On your Android device, open Brokenithm, and change the address to 0.0.0.0.
    • If the text box to the left of the \"SETTINGS\" button say \"UDP\", tap on it once to switch to \"TCP\" mode.
  • Tap on \"START\", and you will now be connected via the USB cable.
  • You can now start the game as normal.

The next time you play the game, you only need to run the adb reverse ... command again. To do this automatically when the game starts, add a line to the start.bat script before the brokenithm_server line:

@echo off\n\npushd %~dp0\n\nstart /min platform-tools\\adb reverse tcp:52468 tcp:52468\nstart /min brokenithm_server -T\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/sunplus/controllers/#iosipados","title":"iOS/iPadOS","text":"
  • Install Brokenithm on your iOS/iPadOS device by joining the Brokenithm TestFlight (iOS 18 only).
    • If your iOS/iPadOS device doesn't have iOS 18, you will need to sideload a different IPA with Sideloadly.
  • If you have iTunes and/or iCloud installed from the Microsoft Store on your computer, uninstall it.
  • Install the non-Microsoft Store version of iTunes from the website.
  • Download the latest version of Brokenithm-Evolved-iOS server and extract it to App\\bin\\Brokenithm-Server.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run App\\bin\\Brokenithm-Server\\Brokenithm-Evolved-iOS.exe. A command prompt window should open, saying that it is waiting for a device.
  • On your iOS/iPadOS device, open Brokenithm, and connect it to your computer with a USB cable.
  • Run the game as normal.
Automatically launching the Brokenithm server when starting the game

This will only work if you extracted the server to App\\bin\\Brokenithm-Server as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min Brokenithm-Server\\Brokenithm-Evolved-iOS.exe\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/sunplus/controllers/#tasoller","title":"TASOLLER","text":"

Warning

This guide only covers TASOLLERs running the v2.0 touch firmware. If you've purchased the controller after January 2022, the update should have already been applied.

If you've purchased the controller before then, you will need to update the touch firmware by following the instructions on DJ-DAO's support page.

  • Install the custom IO4 firmware to your controller.
  • Follow the segatools.ini config on the gitea page.
  • Connect the controller to your computer, and then start the game.
Legacy
  • Backup TASOLLER setup if IO4 cfw is not working.
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download TASOLLER IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_v2_x86.dll\npath64=chuniio_tasoller_v2_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/sunplus/controllers/#tasoller-plus","title":"TASOLLER PLUS","text":"
  • Switch your TASOLLER PLUS to WINUSB mode. You can do so in TASOLLER Options found on the djdao support page.
  • Download TASOLLER PLUS IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_plus_x86.dll\npath64=chuniio_tasoller_plus_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/sunplus/controllers/#yubideck","title":"YubiDeck","text":"
  • Switch your YubiDeck to HID output mode. Instructions on how to do so are provided in the YubiDeck manual.
  • Download the latest version of YubiDeck IO DLLs and extract it to your App\\bin folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_yubideck_chusan.dll\npath64=chuniio_yubideck_amdaemon.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/sunplus/controllers/#laverita-3","title":"Laverita 3","text":"
  • Switch your Laverita to IO mode. You can do so in ConfigApp found in the yuancon discord.
  • Change the COM port of your controller. You can do so in Device manager by looking for USB Serial Device you may need to unplug and replug your controller to properly idetify which one is the Laverita.
  • Double click on it
  • Go to Port Settings
  • Click on Advanced
  • From the dropdown select COM1
  • Restart to ensure changes took effect and saved
  • Edit your App\\bin\\segatools.ini to disable io emulation and set led:
[led]\n; Output billboard LED strip data to a named pipe called \"\\\\.\\pipe\\chuni_led\"\ncabLedOutputPipe=0\n; Output billboard LED strip data to serial\ncabLedOutputSerial=1\n\n; Output slider LED data to the named pipe\ncontrollerLedOutputPipe=0\n; Output slider LED data to the serial port\ncontrollerLedOutputSerial=1\n; Use the OpeNITHM protocol for serial LED output\ncontrollerLedOutputOpeNITHM=0\n\n; Serial port to send data to if using serial output. Default is COM5.\nserialPort=COM1\n; Baud rate for serial data (set to 115200 if using OpeNITHM)\nserialBaud=9600\n\n[slider]\n; Enable slider emulation. If you have real AC slider, set this to 0.\n; Slider serial port must be COM1.\nenable=0\n\n[io4]\nenable=0\n
  • Then start the game.
Legacy
  • Backup Laverita 3 setup if IO4 cfw is not working.
  • Switch your Laverita to HID mode. You can do so in ConfigApp
  • Download Laverita IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_laverita_v3_x86.dll\npath64=chuniio_laverita_v3_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/sunplus/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet slider and air sensors, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/chunithm/sunplus/setup/","title":"Game Setup (SUN PLUS)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of CHUNITHM

You'll want to create a new folder for the game and start from scratch. CHUNITHM DOES NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/sunplus/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create another empty folder named AppData next to them. It should now look like below.

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/chunithm/sunplus/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/chunithm/sunplus/setup/#installing-option-data","title":"Installing option data","text":"

CHUNITHM content updates are distributed through option folders instead of patching the base game. They are named A???, with each ? being a number. Custom options distributed by the community might use letters instead, to distinguish them from official ones.

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

If you plan to connect to a network (Hosted or Local), the A001 option folder for your specific game version is required. This option contains a special Event file that lets the game connect.

"},{"location":"games/sega/chunithm/sunplus/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

CHUNITHM executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of chusanApp.exe and amdaemon.exe for your game version.

Copy chusanApp.exe and amdaemon.exe to the bin folder of your game data. Agree to overwrite when asked.

"},{"location":"games/sega/chunithm/sunplus/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/chunithm/sunplus/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher.

There are many patches for CHUNITHM.

We will only bring up the ones we think could be genuinely useful.

As a general rule of thumb, if you're not sure what a patch does or you're not absolutely certain you need it, leave it alone, regardless of recommendations below.

Patch Recommendation Description Force shared audio mode Either Force the game to use shared mode audio output, letting you listen to other audio sources while the game is running at the cost of audio latency. Force 2 channel audio output Either Try enabling this patch if you don't get audio output at all. Disable song select timer Either Disables the song select timer. No encryption ON Disable encrypting network requests. Required if you plan to run a local server. No TLS ON Disable checking if the server is HTTPS or not. Required if you plan to run a local server. Bypass 1080p monitor check Either Disable checking if the monitor is 1080p when enabling 120FPS. Enable if you cannot set your monitor to 1080p. Bypass 120Hz monitor check Either Disable checking if the monitor is exactly 120Hz when enabling 120FPS. Enable if you cannot set your monitor to 120Hz."},{"location":"games/sega/chunithm/sunplus/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download segatools.zip. Do not download the source code.
  • Extracting the archive should give you a few more zip files. Find chusan.zip and extract it to the App\\bin folder in your game data.

You should now have a few more files inside the folder, as highlighted:

"},{"location":"games/sega/chunithm/sunplus/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\bin\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[system]\ndipsw2=1\ndipsw2=1 ; WRONG!\n
"},{"location":"games/sega/chunithm/sunplus/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

Relative Directories

The ../ in the above example represents the parent directory in a relative path. It is used to navigate up one level in the directory hierarchy.

For example, your segatools.ini is located at /App/bin/segatools.ini and your Option folder is located next to the App folder.

Since segatools.ini is in the /bin/ folder, typing ../ would move you up to the App folder. Since the Option folder is next to the App folder, the second ../ takes you to App's parent folder, which is the folder containing App, Option, etc.

The benefits of using this method include:

  • Avoiding issues that arise when folders have spaces in their names.

  • Being able to move your game folder without redefining the locations of your VFS folders.

  • A cleaner and easier to read segatools.ini, making spotting issues simpler.

"},{"location":"games/sega/chunithm/sunplus/setup/#system","title":"[system]","text":"
  • If you have a 120Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n
"},{"location":"games/sega/chunithm/sunplus/setup/#gfx","title":"[gfx]","text":"
  • Set windowed to 0 to run in fullscreen mode and 1 to run in windowed mode.
  • If you have multiple monitors and you're running in fullscreen mode (windowed=0), set monitor to the index of the monitor you want to run the game on.
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number minus one. For example, monitor 2 means monitor index 1.

"},{"location":"games/sega/chunithm/sunplus/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.139.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\bin\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/sunplus/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/chunithm/sunplus/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/sunplus/setup/#audio","title":"Audio","text":"
  • Right-click on the volume setting in your taskbar and select Sounds.
  • Navigate to the Playback tab, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick either 16 bit, 48000Hz (DVD Quality) or 24 bit, 48000Hz (Studio Quality), click Apply, then OK.
"},{"location":"games/sega/chunithm/sunplus/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/chunithm/sunplus/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/chunithm/sunplus/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\bin\\start.bat. Let the game load until it reaches the screen below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 4th option).

Select \u30b0\u30eb\u30fc\u30d7\u5185\u57fa\u6e96\u6a5f\u8a2d\u5b9a (SET STANDARD IN GROUP, the second option) and toggle this setting to \u57fa\u6e96\u6a5f (STANDARD).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/chunithm/sunplus/setup/#close-setting","title":"CLOSE SETTING","text":"

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the 10th option).

Navigate to \u6642 (HOUR, the 2nd option) and use the Service button to toggle the setting until it says \u5168\u6642\u523b (ALL TIME).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu, then select \u7d42\u4e86 (also the last option) in the main menu to exit the service menu.

"},{"location":"games/sega/chunithm/sunplus/setup/#waiting-for-distribution-server","title":"Waiting for Distribution Server","text":"

If you're stuck at the Waiting for Distribution Server screen below, close the game and relaunch.

You're all done! The game should load up properly now.

You can add coins using the Coin key (default F3) and card in by holding the Enter key.

"},{"location":"games/sega/chunithm/sunplus/setup/#further-configuration","title":"Further configuration","text":"

Input methods and controllers are covered in the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/sunplus/troubleshooting/","title":"Troubleshooting (SUN PLUS)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/chunithm/sunplus/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch!","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120Hz, apply the \"Bypass 120Hz monitor check\"/\"Bypass 1080p monitor check\" on a CHUNITHM web patcher (see Resources).
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\nping 127.0.0.1 -n 31 > nul && taskkill /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/chunithm/sunplus/troubleshooting/#my-game-takes-a-long-time-to-boot","title":"My game takes a long time to boot!","text":"

CHUNITHM game files consist of thousands of small XML files, which Windows Defender takes a long time to scan through. Add your game folder to the Windows Defender exclusion list.

Danger

Doing this will prevent Windows Defender from scanning your game folder for viruses. Only do this if you trust the source of the data.

"},{"location":"games/sega/chunithm/sunplus/troubleshooting/#my-game-is-running-too-slowfast","title":"My game is running too slow/fast","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Make sure your monitor's refresh rate is set to 60Hz or 120Hz.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/sunplus/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chusanApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/sunplus/troubleshooting/#my-game-crashes-when-i-tab-out-of-fullscreen","title":"My game crashes when I tab out of fullscreen!","text":"

As the game is intended to run on arcade hardware, it doesn't like being minimized.

One workaround for this is to use DXVK. Download the latest version from releases. This will be a dxvk-x.y.z.tar.gz file, which you can open using 7zip. Navigate to the x32 folder, and copy the d3d9.dll file to your game's App\\bin folder, agreeing to overwrite when asked.

You should now be able to tab out of fullscreen without crashing the game.

Warning

The game will not ignore inputs when out of focus.

This means any controller inputs will still be accepted, so try not to lean onto your slider whilst tabbed out!

This also means that you can accidentally enter the service menu by hitting your Test key even if the game is minimised. If you were in the middle of a credit, your scores will be lost.

"},{"location":"games/sega/chunithm/sunplus/troubleshooting/#when-i-run-the-game-all-other-audio-is-gone","title":"When I run the game all other audio is gone!","text":"

CHUNITHM uses WASAPI exclusive mode for audio to get better latency.

You can apply the \"Shared Audio\" patch on a CHUNITHM web patcher (see Resources) to hear audio outside of the game at the cost of audio latency.

"},{"location":"games/sega/chunithm/sunplus/troubleshooting/#cabinet-to-cabinetc2c-fixes","title":"Cabinet-to-Cabinet(c2c) Fixes","text":"

c2c can have many problems but you can fix most of them by applying the \"Patch for head-to-head play\" and disabling \"Set all timers to 999\" on a CHUNITHM web patcher (see Resources).

If the above does not work then please ensure both machines have the exact same data and can communicate with each other if they cannot then you can try disabling firewalls or changing the c2c group.

If clicking the c2c button does nothing, you can fix it by resetting the network settings in Windows.

"},{"location":"games/sega/chunithm/verse/c2c/","title":"Cab-to-Cab Play over Internet (VERSE)","text":"

You are most likely to have success with Multiplayer when all users are using the SAME data and options, from the same sources. Verify that each person can run the game normally before attempting to network them together.

  • Chunithm expects the cabinets to be using specific IP addresses, 192.168.139.11/12/13/14
  • To achieve this over the internet, we can use SoftEther VPN. Refer to the Setting Up SoftEther VPN Guide for more information.
"},{"location":"games/sega/chunithm/verse/c2c/#configuring-segatoolsini-game-assignments","title":"Configuring segatools.ini & Game Assignments","text":"

segatools.ini

[netnev]\nenable=1\naddrSuffix= last 2 digits of your SoftEther IP\n\n[keychip]\nenable=1\nsubnet=192.168.139.0\nid=(Everyone needs a seperate keychip. If you play on a remote network, chances are you already have your own keychip. If not, you can use the example keychips below.)\n;example keychips: A61E-01D02321145 ; A61E-01A30831145 ; A61E-01E38091145 ; A61E-01E46241145\n\n[system]\ndipsw1=1\n;This has changed since Luminous. Previously if you wish to perform cab-to-cab link, you need to set this to 1 on the Server machine, and 0 on all other client machines.\n;This change is no longer needed, just keep this set to 1 on all machines.\n

GAME ASSIGNMENTS

  • After saving your segatools.ini, launch the game and go into the Service Menu > and go to GAME ASSIGNMENTS.

  • Enable CABINET-TO-CABINET PLAY, and make sure all machine are on the same group (Group A for example).

  • Set one machine to STANDARD, and all other machines to FOLLOW THE STANDARD .

Exit the Service Menu and load into Attract Mode. If the game passes the Group Check then chances are you're good to go! You can now login to a credit and open a cab-to-cab link request to check if the connection is working properly!

"},{"location":"games/sega/chunithm/verse/c2c/#how-to-link","title":"How to Link?","text":"

If you're new to Chunithm and have never tried link-play before and you have no idea how, keep reading.

  • Login to a credit.

  • If you're hosting a cab-to-cab session, choose a song first, then scroll to the far left and press Confirm. The cab-to-cab request is now open.

  • If you're connecting, navigate to the \"Cabinet-to-Cabinet Play\" tab and wait for other players to create a session.

If you are able to see each other's session, congrats! You can now enjoy some cab-to-cab chain action!

"},{"location":"games/sega/chunithm/verse/c2c/#troubleshooting","title":"Troubleshooting","text":"

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/verse/controllers/","title":"Controllers (VERSE)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with IO DLLs to add support for controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\bin\\ folder and referenced in segatools.ini under the [chuniio] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; Uncomment this if you have custom chuniio implementation comprised of a single 32bit DLL.\n; (will use chu2to3 engine internally)\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.

If you have two DLLs, ending in _x86.dll and _x64.dll (or _chusan.dll and _amdaemon.dll), uncomment the path32= and path64= lines by removing the leading semicolon (;), then add your DLLs after the =:

[chuniio]\n; Uncomment both of these if you have custom chuniio implementation comprised of two DLLs.\n; x86 chuniio to path32, x64 to path64. Both are necessary.\n;(1)!\npath32=controller_x86.dll\npath64=controller_x64.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/verse/controllers/#keyboard","title":"Keyboard","text":"

Keyboard is the default input method, and while not recommended for playing the game, it is useful for testing purposes.

The default layout uses SDFGHJKL for slider input, and Space Bar for the AIRs.

If you wish to change the default keybinds, an explanation on how to set these is included above the [io3] section in your segatools.ini.

"},{"location":"games/sega/chunithm/verse/controllers/#brokenithm","title":"Brokenithm","text":"

Brokenithm allows you to use a mobile device as a CHUNITHM controller. It uses the bottom half of the screen as the ground slider, and sliding into the upper half activates the air sensors.

"},{"location":"games/sega/chunithm/verse/controllers/#android","title":"Android","text":"

Warning

Your computer and your Android device must be on the same local network.

  • Download the latest version of Brokenithm-Android and install it on your Android device.
  • Download the latest version of Brokenithm-Android-Server and extract only brokenithm_server.exe to your App\\bin\\ folder.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run brokenithm_server.exe. A command prompt window should open, saying that it is waiting for a device on port 52468.
  • Open the Brokenithm app on your Android device. Enter your computer's IP address in the Address box on the top right, then tap Start.
  • Run the game as normal.
Getting your computer's IP address

Open Settings -> Network and Internet and select Properties. Scroll down to the bottom and check the address under the IPv4 address field:

That is your computer's IP address.

Automatically launching the Brokenithm server when starting the game

This will only work if you extracted brokenithm_server.exe to App\\bin\\ as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min brokenithm_server\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Improving latency

You can improve latency by running Brokenithm with your Android device tethered to your computer. However, this requires a little extra setup:

  • Connect your Android device to your computer with a USB cable.
  • If you haven't enabled Developer options on your device, do it by navigating to the \"About\" page in your phone's settings, then tap \"Build number\" seven times. This varies by device, so if unsure, look up the instructions for your specific one.
  • Navigate to Developer options and enable USB debugging.
  • On your computer, download and extract Android SDK Platform Tools to your App\\bin\\ folder.
  • Navigate to the App\\bin\\platform-tools folder in File Explorer, click on the address bar, type cmd, and hit Enter to open a command prompt.
  • In the command prompt, type the following command:
adb reverse tcp:52468 tcp:52468\n
  • Start brokenithm_server in TCP mode with the -T command line flag, brokenithm_server.exe -T.
  • On your Android device, open Brokenithm, and change the address to 0.0.0.0.
    • If the text box to the left of the \"SETTINGS\" button say \"UDP\", tap on it once to switch to \"TCP\" mode.
  • Tap on \"START\", and you will now be connected via the USB cable.
  • You can now start the game as normal.

The next time you play the game, you only need to run the adb reverse ... command again. To do this automatically when the game starts, add a line to the start.bat script before the brokenithm_server line:

@echo off\n\npushd %~dp0\n\nstart /min platform-tools\\adb reverse tcp:52468 tcp:52468\nstart /min brokenithm_server -T\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/verse/controllers/#iosipados","title":"iOS/iPadOS","text":"
  • Install Brokenithm on your iOS/iPadOS device by joining the Brokenithm TestFlight (iOS 18 only).
    • If your iOS/iPadOS device doesn't have iOS 18, you will need to sideload a different IPA with Sideloadly.
  • If you have iTunes and/or iCloud installed from the Microsoft Store on your computer, uninstall it.
  • Install the non-Microsoft Store version of iTunes from the website.
  • Download the latest version of Brokenithm-Evolved-iOS server and extract it to App\\bin\\Brokenithm-Server.
  • Download the latest version of Brokenithm-Evolved IO DLLs and extract the DLL files to your App\\bin\\ folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[aimeio]\npath=aime_brokenithm.dll\n
[chuniio]\npath32=brokenithm_x86.dll\npath64=brokenithm_x64.dll\n
  • Run App\\bin\\Brokenithm-Server\\Brokenithm-Evolved-iOS.exe. A command prompt window should open, saying that it is waiting for a device.
  • On your iOS/iPadOS device, open Brokenithm, and connect it to your computer with a USB cable.
  • Run the game as normal.
Automatically launching the Brokenithm server when starting the game

This will only work if you extracted the server to App\\bin\\Brokenithm-Server as previously instructed.

You can edit the launch script to launch the Brokenithm server when starting the game. Edit App\\bin\\start.bat to add a line above the existing commands:

@echo off\n\npushd %~dp0\n\nstart /min Brokenithm-Server\\Brokenithm-Evolved-iOS.exe\nstart /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\ninject_x86 -d -k chusanhook_x86.dll chusanApp.exe\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
"},{"location":"games/sega/chunithm/verse/controllers/#tasoller","title":"TASOLLER","text":"

Warning

This guide only covers TASOLLERs running the v2.0 touch firmware. If you've purchased the controller after January 2022, the update should have already been applied.

If you've purchased the controller before then, you will need to update the touch firmware by following the instructions on DJ-DAO's support page.

  • Install the custom IO4 firmware to your controller.
  • Follow the segatools.ini config on the gitea page.
  • Connect the controller to your computer, and then start the game.
Legacy
  • Backup TASOLLER setup if IO4 cfw is not working.
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download TASOLLER IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_v2_x86.dll\npath64=chuniio_tasoller_v2_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/verse/controllers/#tasoller-plus","title":"TASOLLER PLUS","text":"
  • Switch your TASOLLER PLUS to WINUSB mode. You can do so in TASOLLER Options found on the djdao support page.
  • Download TASOLLER PLUS IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_tasoller_plus_x86.dll\npath64=chuniio_tasoller_plus_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/verse/controllers/#yubideck","title":"YubiDeck","text":"
  • Switch your YubiDeck to HID output mode. Instructions on how to do so are provided in the YubiDeck manual.
  • Download the latest version of YubiDeck IO DLLs and extract it to your App\\bin folder.
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_yubideck_chusan.dll\npath64=chuniio_yubideck_amdaemon.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/verse/controllers/#laverita-3","title":"Laverita 3","text":"
  • Switch your Laverita to IO mode. You can do so in ConfigApp found in the yuancon discord.
  • Change the COM port of your controller. You can do so in Device manager by looking for USB Serial Device you may need to unplug and replug your controller to properly idetify which one is the Laverita.
  • Double click on it
  • Go to Port Settings
  • Click on Advanced
  • From the dropdown select COM1
  • Restart to ensure changes took effect and saved
  • Edit your App\\bin\\segatools.ini to disable io emulation and set led:
[led]\n; Output billboard LED strip data to a named pipe called \"\\\\.\\pipe\\chuni_led\"\ncabLedOutputPipe=0\n; Output billboard LED strip data to serial\ncabLedOutputSerial=1\n\n; Output slider LED data to the named pipe\ncontrollerLedOutputPipe=0\n; Output slider LED data to the serial port\ncontrollerLedOutputSerial=1\n; Use the OpeNITHM protocol for serial LED output\ncontrollerLedOutputOpeNITHM=0\n\n; Serial port to send data to if using serial output. Default is COM5.\nserialPort=COM1\n; Baud rate for serial data (set to 115200 if using OpeNITHM)\nserialBaud=9600\n\n[slider]\n; Enable slider emulation. If you have real AC slider, set this to 0.\n; Slider serial port must be COM1.\nenable=0\n\n[io4]\nenable=0\n
  • Then start the game.
Legacy
  • Backup Laverita 3 setup if IO4 cfw is not working.
  • Switch your Laverita to HID mode. You can do so in ConfigApp
  • Download Laverita IO DLLs and extract to your App\\bin folder.
    • chuniio-rs (download chusan.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath32=chuniio_laverita_v3_x86.dll\npath64=chuniio_laverita_v3_x64.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/verse/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet slider and air sensors, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/chunithm/verse/setup/","title":"Game Setup (VERSE)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of CHUNITHM

You'll want to create a new folder for the game and start from scratch. CHUNITHM DOES NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/verse/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create another empty folder named AppData next to them. It should now look like below.

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/chunithm/verse/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/chunithm/verse/setup/#installing-option-data","title":"Installing option data","text":"

CHUNITHM content updates are distributed through option folders instead of patching the base game. They are named A???, with each ? being a number. Custom options distributed by the community might use letters instead, to distinguish them from official ones.

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

If you plan to connect to a network (Hosted or Local), the A001 option folder for your specific game version is required. This option contains a special Event file that lets the game connect.

"},{"location":"games/sega/chunithm/verse/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

CHUNITHM executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of chusanApp.exe and amdaemon.exe for your game version.

Copy chusanApp.exe and amdaemon.exe to the bin folder of your game data. Agree to overwrite when asked.

"},{"location":"games/sega/chunithm/verse/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/chunithm/verse/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher.

There are many patches for CHUNITHM.

We will only bring up the ones we think could be genuinely useful.

As a general rule of thumb, if you're not sure what a patch does or you're not absolutely certain you need it, leave it alone, regardless of recommendations below.

Patch Recommendation Description Force shared audio mode Either Force the game to use shared mode audio output, letting you listen to other audio sources while the game is running at the cost of audio latency. Force 2 channel audio output Either Try enabling this patch if you don't get audio output at all. Disable song select timer Either Disables the song select timer. No encryption ON Disable encrypting network requests. Required if you plan to run a local server. No TLS ON Disable checking if the server is HTTPS or not. Required if you plan to run a local server. Bypass 1080p monitor check Either Disable checking if the monitor is 1080p when enabling 120FPS. Enable if you cannot set your monitor to 1080p. Bypass 120Hz monitor check Either Disable checking if the monitor is exactly 120Hz when enabling 120FPS. Enable if you cannot set your monitor to 120Hz."},{"location":"games/sega/chunithm/verse/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download segatools.zip. Do not download the source code.
  • Extracting the archive should give you a few more zip files. Find chusan.zip and extract it to the App\\bin folder in your game data.

You should now have a few more files inside the folder, as highlighted:

"},{"location":"games/sega/chunithm/verse/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\bin\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[system]\ndipsw2=1\ndipsw2=1 ; WRONG!\n
"},{"location":"games/sega/chunithm/verse/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

Relative Directories

The ../ in the above example represents the parent directory in a relative path. It is used to navigate up one level in the directory hierarchy.

For example, your segatools.ini is located at /App/bin/segatools.ini and your Option folder is located next to the App folder.

Since segatools.ini is in the /bin/ folder, typing ../ would move you up to the App folder. Since the Option folder is next to the App folder, the second ../ takes you to App's parent folder, which is the folder containing App, Option, etc.

The benefits of using this method include:

  • Avoiding issues that arise when folders have spaces in their names.

  • Being able to move your game folder without redefining the locations of your VFS folders.

  • A cleaner and easier to read segatools.ini, making spotting issues simpler.

"},{"location":"games/sega/chunithm/verse/setup/#system","title":"[system]","text":"
  • If you have a 120Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n
"},{"location":"games/sega/chunithm/verse/setup/#gfx","title":"[gfx]","text":"
  • Set windowed to 0 to run in fullscreen mode and 1 to run in windowed mode.
  • If you have multiple monitors and you're running in fullscreen mode (windowed=0), set monitor to the index of the monitor you want to run the game on.
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number minus one. For example, monitor 2 means monitor index 1.

"},{"location":"games/sega/chunithm/verse/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.139.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\bin\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/verse/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/chunithm/verse/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/verse/setup/#audio","title":"Audio","text":"
  • Right-click on the volume setting in your taskbar and select Sounds.
  • Navigate to the Playback tab, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick either 16 bit, 48000Hz (DVD Quality) or 24 bit, 48000Hz (Studio Quality), click Apply, then OK.
"},{"location":"games/sega/chunithm/verse/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/chunithm/verse/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/chunithm/verse/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\bin\\start.bat. Let the game load until it reaches the screen below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 4th option).

Select \u30b0\u30eb\u30fc\u30d7\u5185\u57fa\u6e96\u6a5f\u8a2d\u5b9a (SET STANDARD IN GROUP, the second option) and toggle this setting to \u57fa\u6e96\u6a5f (STANDARD).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/chunithm/verse/setup/#close-setting","title":"CLOSE SETTING","text":"

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the 10th option).

Navigate to \u6642 (HOUR, the 2nd option) and use the Service button to toggle the setting until it says \u5168\u6642\u523b (ALL TIME).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu, then select \u7d42\u4e86 (also the last option) in the main menu to exit the service menu.

"},{"location":"games/sega/chunithm/verse/setup/#waiting-for-distribution-server","title":"Waiting for Distribution Server","text":"

If you're stuck at the Waiting for Distribution Server screen below, close the game and relaunch.

You're all done! The game should load up properly now.

You can add coins using the Coin key (default F3) and card in by holding the Enter key.

"},{"location":"games/sega/chunithm/verse/setup/#further-configuration","title":"Further configuration","text":"

Input methods and controllers are covered in the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/chunithm/verse/troubleshooting/","title":"Troubleshooting (VERSE)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/chunithm/verse/troubleshooting/#my-game-crashes-on-launch","title":"My game crashes on launch!","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120Hz, apply the \"Bypass 120Hz monitor check\"/\"Bypass 1080p monitor check\" on a CHUNITHM web patcher (see Resources).
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject_x64 -d -k chusanhook_x64.dll amdaemon.exe -c config_common.json config_server.json config_client.json config_cvt.json config_sp.json config_hook.json\nping 127.0.0.1 -n 31 > nul && taskkill /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/chunithm/verse/troubleshooting/#my-game-takes-a-long-time-to-boot","title":"My game takes a long time to boot!","text":"

CHUNITHM game files consist of thousands of small XML files, which Windows Defender takes a long time to scan through. Add your game folder to the Windows Defender exclusion list.

Danger

Doing this will prevent Windows Defender from scanning your game folder for viruses. Only do this if you trust the source of the data.

"},{"location":"games/sega/chunithm/verse/troubleshooting/#my-game-is-running-too-slowfast","title":"My game is running too slow/fast","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Make sure your monitor's refresh rate is set to 60Hz or 120Hz.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/verse/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chusanApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/verse/troubleshooting/#my-game-crashes-when-i-tab-out-of-fullscreen","title":"My game crashes when I tab out of fullscreen!","text":"

As the game is intended to run on arcade hardware, it doesn't like being minimized.

One workaround for this is to use DXVK. Download the latest version from releases. This will be a dxvk-x.y.z.tar.gz file, which you can open using 7zip. Navigate to the x32 folder, and copy the d3d9.dll file to your game's App\\bin folder, agreeing to overwrite when asked.

You should now be able to tab out of fullscreen without crashing the game.

Warning

The game will not ignore inputs when out of focus.

This means any controller inputs will still be accepted, so try not to lean onto your slider whilst tabbed out!

This also means that you can accidentally enter the service menu by hitting your Test key even if the game is minimised. If you were in the middle of a credit, your scores will be lost.

"},{"location":"games/sega/chunithm/verse/troubleshooting/#when-i-run-the-game-all-other-audio-is-gone","title":"When I run the game all other audio is gone!","text":"

CHUNITHM uses WASAPI exclusive mode for audio to get better latency.

You can apply the \"Shared Audio\" patch on a CHUNITHM web patcher (see Resources) to hear audio outside of the game at the cost of audio latency.

"},{"location":"games/sega/chunithm/verse/troubleshooting/#cabinet-to-cabinetc2c-fixes","title":"Cabinet-to-Cabinet(c2c) Fixes","text":"

c2c can have many problems but you can fix most of them by applying the \"Patch for head-to-head play\" and disabling \"Set all timers to 999\" on a CHUNITHM web patcher (see Resources).

If the above does not work then please ensure both machines have the exact same data and can communicate with each other if they cannot then you can try disabling firewalls or changing the c2c group.

If clicking the c2c button does nothing, you can fix it by resetting the network settings in Windows.

"},{"location":"games/sega/maimaidx/buddies/controllers/","title":"maimai DX BUDDiES","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with IO DLLs to add support for controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\Package folder and referenced in segatools.ini under the [mai2io] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[mai2io]\n; To use a custom maimai DX IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/maimaidx/buddies/controllers/#keyboardtouchscreen","title":"Keyboard/Touchscreen","text":"

Keyboard/Touchscreen is the default input method

The default layout uses QWEDCXZA for physical buttons (each key representing the physical button's location relative to the center screen)

If you wish to change the default keybinds, an explanation on how to set these is included above the [io4] section in your segatools.ini.

Touch input should automatically work after connecting a touch-screen display

"},{"location":"games/sega/maimaidx/buddies/controllers/#adx-controller","title":"ADX Controller","text":"

First, you will need to purchase a compatible monitor if your controller did not come with one. A list of compatible monitors can be found on this spreadsheet

Plug your controller in and open Device Manager.

Under the Ports (COM & LPT) section, ensure the correct ports are set for both the Touch Panel and Button LED.

  • (Touch Panel) USB Serial Device: COM3
  • (Button LED) USB-SERIAL CH340: COM21

If they are different change the port of the device by Right Clicking on the Device -> Properties -> Port Settings -> COM Port Number

Finally ensure the mai2.ini file in your data's App/Package folder has the following values set under the [AM] section 

[AM]\nTarget=0\nDummyTouchPanel=0\nDummyLED=0\n

This gets your controller working with keyboard inputs. Its highly recommended that you also view this setup guide which provides more detailed instructions, improved drivers, and help with adjusting touch panel sensitivity.

Warning

You DO NOT need to follow the Network Setup steps in the linked guide above if you've already done so while setting up game data

You DO NOT need to follow the Aime Reader setup in the linked guide above if you do not own one.

"},{"location":"games/sega/maimaidx/buddies/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/maimaidx/buddies/setup/","title":"maimai DX BUDDiES","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of maimai DX

Create a new folder for the game and start from scratch. maimai DX DOES NOT like being extracted over old data!

"},{"location":"games/sega/maimaidx/buddies/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files are not set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and filesand press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create two new empty folders named appdata and amfs (and the folder option if not present) next to them as shown below:

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/maimaidx/buddies/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/maimaidx/buddies/setup/#installing-option-data","title":"Installing option data","text":"

maimai DX content updates are distributed through option folders instead of patching the base game.

Options are named with a letter followed by three numbers.

For JPN(SDEZ) data, each new release of maimai DX increments the first letter of the Option (ie. BUDDiES is H??? and BUDDiES+ is I???).

For EXP(SDGA) data, Options will always begin with the letter A (i.e A???)

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

Do not mix option data between versions

"},{"location":"games/sega/maimaidx/buddies/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

maimai DX executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of the following files and the associated configuration file:

  • amdaemon.exe
  • Sinmai.exe
  • Sinmai_Data/Plugins/amdaemon_api.dll
  • Sinmai_Data/Plugins/Cake.dll (JPN/SDEZ only)
  • Sinmai_Data/Managed/AMDaemon.NET.dll
  • Sinmai_Data/Managed/Assembly-CSharp.dll
  • mai2.ini

Copy the files and folders into the App/Package folder of your game data. Agree to overwrite when asked.

Assembly-CSharp Notes

Assembly-CSharp.dll must match your game version. All others can be reused from other game versions.

"},{"location":"games/sega/maimaidx/buddies/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/maimaidx/buddies/setup/#mai2ini","title":"mai2.ini","text":"

Ensure that the App\\Package folder contains mai2.ini.

If this configuration file is missing, create one using the contents below.

[Debug]\nDebug=1\n\n[AM]\nTarget=0\nIgnoreError=1\nDummyTouchPanel=1\nDummyLED=1\nDummyCodeCamera=1\nDummyPhotoCamera=1\n\n[Sound]\nSound8Ch=0\n
"},{"location":"games/sega/maimaidx/buddies/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download the segatools.zip from 2024-03-13. Do not download the source code or latest release.
  • Extracting the archive should give you a few more zip files. Find mai2.zip and extract it to the App/Package folder in your game data.

You should now have a few more files inside the App/Package folder, as highlighted:

Warning

The latest release of segatools currently has issues with maimai, and for the time being an older version of segatools is preferred.

"},{"location":"games/sega/maimaidx/buddies/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\package\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[gpio]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
"},{"location":"games/sega/maimaidx/buddies/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n
AquaMai

It's strongly recommended to use MelonLoader mods to improve QOL. You can find info about the available mods for maimai here AquaMai. For general modding check Unity modding page.

"},{"location":"games/sega/maimaidx/buddies/setup/#setting-launch-options","title":"Setting launch options","text":"

Right click App\\package\\start.bat, select Edit. Locate the line that launches sinmai and edit it according to your preferences:

@echo off\n\npushd %~dp0\n\nstart \"AM Daemon\" /min inject -d -k mai2hook.dll amdaemon.exe -f -c config_common.json config_server.json config_client.json\ninject -d -k mai2hook.dll sinmai -screen-fullscreen 0 -popupwindow -screen-width 2160 -screen-height 1920  -silent-crashes\n\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Launch options
  • -screen-fullscreen 0: windowed
  • -screen-fullscreen 0 -popupwindow: borderless windowed
  • -screen-fullscreen 1: exclusive fullscreen
  • -screen-width <W> -screen-height <H>: resolution
  • -monitor <N>: the monitor to run the game on
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number. For example, monitor 2 means -monitor 2.

"},{"location":"games/sega/maimaidx/buddies/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.172.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\package\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/maimaidx/buddies/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/maimaidx/buddies/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/maimaidx/buddies/setup/#audio","title":"Audio","text":"
  • Right-click on the volume setting in your taskbar and select Sounds.
  • Navigate to the Playback tab, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick either 16 bit, 48000Hz (DVD Quality) or 24 bit, 48000Hz (Studio Quality), click Apply, then OK.
"},{"location":"games/sega/maimaidx/buddies/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/maimaidx/buddies/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/maimaidx/buddies/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\package\\start.bat. Let the game load until you reach a screen with the message below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 7th option).

Select \u5e97\u5185\u30de\u30c3\u30c1\u30f3\u30b0\u306e\u8a2d\u5b9a (IN-STORE MATCHING SETUP, the first option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/maimaidx/buddies/setup/#custom-mods","title":"Custom Mods","text":"

Mods are covered on the Unity modding page.

"},{"location":"games/sega/maimaidx/buddies/setup/#controllers-and-troubleshooting","title":"Controllers and Troubleshooting","text":"

Input methods and controllers are covered in the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/maimaidx/buddies/troubleshooting/","title":"maimai DX BUDDiES","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/maimaidx/buddies/troubleshooting/#my-game-crashes-on-launchstuck-on-starting-system-process","title":"My game crashes on launch/stuck on \"Starting System Process\"","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject -d -k mai2hook.dll amdaemon.exe -f -c config_common.json config_server.json\nping 127.0.0.1 -n 31 > nul && taskkill /F /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/maimaidx/buddies/troubleshooting/#my-game-is-stuck-on-a-black-screen-at-launch","title":"My game is stuck on a black screen at launch!","text":"

This could also be due to many things, the most common of which are:

  • You have one or more incorrect/broken DLL(s) in App\\Package\\Sinmai_Data\\Managed

    This is likely to be Assembly-CSharp.dll, Assembly-CSharp-firstpass.dll, and/or AMDaemon.NET.dll. You can try replacing the DLLs or re-downloading data from elsewhere.

  • An ill-formed keychip is defined in segatools.ini

  • You need to app the OpenSSL fix on Intel Core 10th Gen CPUs and newer.

"},{"location":"games/sega/maimaidx/buddies/troubleshooting/#my-game-is-stuck-on-a-blue-and-black-screen","title":"My game is stuck on a blue and black screen!","text":"

You need to run the data using unprotected/unpacked files. Please refer to the setup guide to find which ones you need and obtain them.

If you believe you've already done this. You might be missing a try installing the latest vcredist

"},{"location":"games/sega/maimaidx/buddies/troubleshooting/#my-game-is-running-too-slowfast-or-the-notes-are-out-of-sync","title":"My game is running too slow/fast or the notes are out of sync!","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Limit Sinmai.exe to run at 60 FPS using a tool like RivaTuner or a patch.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/maimaidx/buddiesplus/controllers/","title":"maimai DX BUDDiES","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with IO DLLs to add support for controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\Package folder and referenced in segatools.ini under the [mai2io] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[mai2io]\n; To use a custom maimai DX IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/maimaidx/buddiesplus/controllers/#keyboardtouchscreen","title":"Keyboard/Touchscreen","text":"

Keyboard/Touchscreen is the default input method

The default layout uses QWEDCXZA for physical buttons (each key representing the physical button's location relative to the center screen)

If you wish to change the default keybinds, an explanation on how to set these is included above the [io4] section in your segatools.ini.

Touch input should automatically work after connecting a touch-screen display

"},{"location":"games/sega/maimaidx/buddiesplus/controllers/#adx-controller","title":"ADX Controller","text":"

First, you will need to purchase a compatible monitor if your controller did not come with one. A list of compatible monitors can be found on this spreadsheet

Plug your controller in and open Device Manager.

Under the Ports (COM & LPT) section, ensure the correct ports are set for both the Touch Panel and Button LED.

  • (Touch Panel) USB Serial Device: COM3
  • (Button LED) USB-SERIAL CH340: COM21

If they are different change the port of the device by Right Clicking on the Device -> Properties -> Port Settings -> COM Port Number

Finally ensure the mai2.ini file in your data's App/Package folder has the following values set under the [AM] section 

[AM]\nTarget=0\nDummyTouchPanel=0\nDummyLED=0\n

This gets your controller working with keyboard inputs. Its highly recommended that you also view this setup guide which provides more detailed instructions, improved drivers, and help with adjusting touch panel sensitivity.

Warning

You DO NOT need to follow the Network Setup steps in the linked guide above if you've already done so while setting up game data

You DO NOT need to follow the Aime Reader setup in the linked guide above if you do not own one.

"},{"location":"games/sega/maimaidx/buddiesplus/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/maimaidx/buddiesplus/setup/","title":"maimai DX BUDDiES","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of maimai DX

Create a new folder for the game and start from scratch. maimai DX DOES NOT like being extracted over old data!

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files are not set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and filesand press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create two new empty folders named appdata and amfs (and the folder option if not present) next to them as shown below:

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#installing-option-data","title":"Installing option data","text":"

maimai DX content updates are distributed through option folders instead of patching the base game.

Options are named with a letter followed by three numbers.

For JPN(SDEZ) data, each new release of maimai DX increments the first letter of the Option (ie. BUDDiES is H??? and BUDDiES+ is I???).

For EXP(SDGA) data, Options will always begin with the letter A (i.e A???)

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

Do not mix option data between versions

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

maimai DX executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of the following files and the associated configuration file:

  • amdaemon.exe
  • Sinmai.exe
  • Sinmai_Data/Plugins/amdaemon_api.dll
  • Sinmai_Data/Plugins/Cake.dll (JPN/SDEZ only)
  • Sinmai_Data/Managed/AMDaemon.NET.dll
  • Sinmai_Data/Managed/Assembly-CSharp.dll
  • mai2.ini

Copy the files and folders into the App/Package folder of your game data. Agree to overwrite when asked.

Assembly-CSharp Notes

Assembly-CSharp.dll must match your game version. All others can be reused from other game versions.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#mai2ini","title":"mai2.ini","text":"

Ensure that the App\\Package folder contains mai2.ini.

If this configuration file is missing, create one using the contents below.

[Debug]\nDebug=1\n\n[AM]\nTarget=0\nIgnoreError=1\nDummyTouchPanel=1\nDummyLED=1\nDummyCodeCamera=1\nDummyPhotoCamera=1\n\n[Sound]\nSound8Ch=0\n
"},{"location":"games/sega/maimaidx/buddiesplus/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download the segatools.zip from 2024-03-13. Do not download the source code or latest release.
  • Extracting the archive should give you a few more zip files. Find mai2.zip and extract it to the App/Package folder in your game data.

You should now have a few more files inside the App/Package folder, as highlighted:

Warning

The latest release of segatools currently has issues with maimai, and for the time being an older version of segatools is preferred.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\package\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[gpio]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
"},{"location":"games/sega/maimaidx/buddiesplus/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n
AquaMai

It's strongly recommended to use MelonLoader mods to improve QOL. You can find info about the available mods for maimai here AquaMai. For general modding check Unity modding page.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#setting-launch-options","title":"Setting launch options","text":"

Right click App\\package\\start.bat, select Edit. Locate the line that launches sinmai and edit it according to your preferences:

@echo off\n\npushd %~dp0\n\nstart \"AM Daemon\" /min inject -d -k mai2hook.dll amdaemon.exe -f -c config_common.json config_server.json config_client.json\ninject -d -k mai2hook.dll sinmai -screen-fullscreen 0 -popupwindow -screen-width 2160 -screen-height 1920  -silent-crashes\n\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Launch options
  • -screen-fullscreen 0: windowed
  • -screen-fullscreen 0 -popupwindow: borderless windowed
  • -screen-fullscreen 1: exclusive fullscreen
  • -screen-width <W> -screen-height <H>: resolution
  • -monitor <N>: the monitor to run the game on
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number. For example, monitor 2 means -monitor 2.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.172.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\package\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/maimaidx/buddiesplus/setup/#audio","title":"Audio","text":"
  • Right-click on the volume setting in your taskbar and select Sounds.
  • Navigate to the Playback tab, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick either 16 bit, 48000Hz (DVD Quality) or 24 bit, 48000Hz (Studio Quality), click Apply, then OK.
"},{"location":"games/sega/maimaidx/buddiesplus/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\package\\start.bat. Let the game load until you reach a screen with the message below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 7th option).

Select \u5e97\u5185\u30de\u30c3\u30c1\u30f3\u30b0\u306e\u8a2d\u5b9a (IN-STORE MATCHING SETUP, the first option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#custom-mods","title":"Custom Mods","text":"

Mods are covered on the Unity modding page.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#controllers-and-troubleshooting","title":"Controllers and Troubleshooting","text":"

Input methods and controllers are covered in the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/maimaidx/buddiesplus/troubleshooting/","title":"maimai DX BUDDiES","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/maimaidx/buddiesplus/troubleshooting/#my-game-crashes-on-launchstuck-on-starting-system-process","title":"My game crashes on launch/stuck on \"Starting System Process\"","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject -d -k mai2hook.dll amdaemon.exe -f -c config_common.json config_server.json\nping 127.0.0.1 -n 31 > nul && taskkill /F /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/maimaidx/buddiesplus/troubleshooting/#my-game-is-stuck-on-a-black-screen-at-launch","title":"My game is stuck on a black screen at launch!","text":"

This could also be due to many things, the most common of which are:

  • You have one or more incorrect/broken DLL(s) in App\\Package\\Sinmai_Data\\Managed

    This is likely to be Assembly-CSharp.dll, Assembly-CSharp-firstpass.dll, and/or AMDaemon.NET.dll. You can try replacing the DLLs or re-downloading data from elsewhere.

  • An ill-formed keychip is defined in segatools.ini

  • You need to app the OpenSSL fix on Intel Core 10th Gen CPUs and newer.

"},{"location":"games/sega/maimaidx/buddiesplus/troubleshooting/#my-game-is-stuck-on-a-blue-and-black-screen","title":"My game is stuck on a blue and black screen!","text":"

You need to run the data using unprotected/unpacked files. Please refer to the setup guide to find which ones you need and obtain them.

If you believe you've already done this. You might be missing a try installing the latest vcredist

"},{"location":"games/sega/maimaidx/buddiesplus/troubleshooting/#my-game-is-running-too-slowfast-or-the-notes-are-out-of-sync","title":"My game is running too slow/fast or the notes are out of sync!","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Limit Sinmai.exe to run at 60 FPS using a tool like RivaTuner or a patch.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/maimaidx/common/controllers/","title":"Controllers","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with IO DLLs to add support for controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\Package folder and referenced in segatools.ini under the [mai2io] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[mai2io]\n; To use a custom maimai DX IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/maimaidx/common/controllers/#keyboardtouchscreen","title":"Keyboard/Touchscreen","text":"

Keyboard/Touchscreen is the default input method

The default layout uses QWEDCXZA for physical buttons (each key representing the physical button's location relative to the center screen)

If you wish to change the default keybinds, an explanation on how to set these is included above the [io4] section in your segatools.ini.

Touch input should automatically work after connecting a touch-screen display

"},{"location":"games/sega/maimaidx/common/controllers/#adx-controller","title":"ADX Controller","text":"

First, you will need to purchase a compatible monitor if your controller did not come with one. A list of compatible monitors can be found on this spreadsheet

Plug your controller in and open Device Manager.

Under the Ports (COM & LPT) section, ensure the correct ports are set for both the Touch Panel and Button LED.

  • (Touch Panel) USB Serial Device: COM3
  • (Button LED) USB-SERIAL CH340: COM21

If they are different change the port of the device by Right Clicking on the Device -> Properties -> Port Settings -> COM Port Number

Finally ensure the mai2.ini file in your data's App/Package folder has the following values set under the [AM] section 

[AM]\nTarget=0\nDummyTouchPanel=0\nDummyLED=0\n

This gets your controller working with keyboard inputs. Its highly recommended that you also view this setup guide which provides more detailed instructions, improved drivers, and help with adjusting touch panel sensitivity.

Warning

You DO NOT need to follow the Network Setup steps in the linked guide above if you've already done so while setting up game data

You DO NOT need to follow the Aime Reader setup in the linked guide above if you do not own one.

"},{"location":"games/sega/maimaidx/common/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/maimaidx/common/setup/","title":"Setup","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of maimai DX

Create a new folder for the game and start from scratch. maimai DX DOES NOT like being extracted over old data!

"},{"location":"games/sega/maimaidx/common/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files are not set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and filesand press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create two new empty folders named appdata and amfs (and the folder option if not present) next to them as shown below:

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/maimaidx/common/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/maimaidx/common/setup/#installing-option-data","title":"Installing option data","text":"

maimai DX content updates are distributed through option folders instead of patching the base game.

Options are named with a letter followed by three numbers.

For JPN(SDEZ) data, each new release of maimai DX increments the first letter of the Option (ie. BUDDiES is H??? and BUDDiES+ is I???).

For EXP(SDGA) data, Options will always begin with the letter A (i.e A???)

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

Do not mix option data between versions

"},{"location":"games/sega/maimaidx/common/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

maimai DX executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of the following files and the associated configuration file:

  • amdaemon.exe
  • Sinmai.exe
  • Sinmai_Data/Plugins/amdaemon_api.dll
  • Sinmai_Data/Plugins/Cake.dll (JPN/SDEZ only)
  • Sinmai_Data/Managed/AMDaemon.NET.dll
  • Sinmai_Data/Managed/Assembly-CSharp.dll
  • mai2.ini

Copy the files and folders into the App/Package folder of your game data. Agree to overwrite when asked.

Assembly-CSharp Notes

Assembly-CSharp.dll must match your game version. All others can be reused from other game versions.

"},{"location":"games/sega/maimaidx/common/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/maimaidx/common/setup/#mai2ini","title":"mai2.ini","text":"

Ensure that the App\\Package folder contains mai2.ini.

If this configuration file is missing, create one using the contents below.

[Debug]\nDebug=1\n\n[AM]\nTarget=0\nIgnoreError=1\nDummyTouchPanel=1\nDummyLED=1\nDummyCodeCamera=1\nDummyPhotoCamera=1\n\n[Sound]\nSound8Ch=0\n
"},{"location":"games/sega/maimaidx/common/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download the segatools.zip from 2024-03-13. Do not download the source code or latest release.
  • Extracting the archive should give you a few more zip files. Find mai2.zip and extract it to the App/Package folder in your game data.

You should now have a few more files inside the App/Package folder, as highlighted:

Warning

The latest release of segatools currently has issues with maimai, and for the time being an older version of segatools is preferred.

"},{"location":"games/sega/maimaidx/common/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\package\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[gpio]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
"},{"location":"games/sega/maimaidx/common/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n
AquaMai

It's strongly recommended to use MelonLoader mods to improve QOL. You can find info about the available mods for maimai here AquaMai. For general modding check Unity modding page.

"},{"location":"games/sega/maimaidx/common/setup/#setting-launch-options","title":"Setting launch options","text":"

Right click App\\package\\start.bat, select Edit. Locate the line that launches sinmai and edit it according to your preferences:

@echo off\n\npushd %~dp0\n\nstart \"AM Daemon\" /min inject -d -k mai2hook.dll amdaemon.exe -f -c config_common.json config_server.json config_client.json\ninject -d -k mai2hook.dll sinmai -screen-fullscreen 0 -popupwindow -screen-width 2160 -screen-height 1920  -silent-crashes\n\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Launch options
  • -screen-fullscreen 0: windowed
  • -screen-fullscreen 0 -popupwindow: borderless windowed
  • -screen-fullscreen 1: exclusive fullscreen
  • -screen-width <W> -screen-height <H>: resolution
  • -monitor <N>: the monitor to run the game on
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number. For example, monitor 2 means -monitor 2.

"},{"location":"games/sega/maimaidx/common/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.172.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\package\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/maimaidx/common/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/maimaidx/common/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/maimaidx/common/setup/#audio","title":"Audio","text":"
  • Right-click on the volume setting in your taskbar and select Sounds.
  • Navigate to the Playback tab, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick either 16 bit, 48000Hz (DVD Quality) or 24 bit, 48000Hz (Studio Quality), click Apply, then OK.
"},{"location":"games/sega/maimaidx/common/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/maimaidx/common/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/maimaidx/common/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\package\\start.bat. Let the game load until you reach a screen with the message below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 7th option).

Select \u5e97\u5185\u30de\u30c3\u30c1\u30f3\u30b0\u306e\u8a2d\u5b9a (IN-STORE MATCHING SETUP, the first option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/maimaidx/common/setup/#custom-mods","title":"Custom Mods","text":"

Mods are covered on the Unity modding page.

"},{"location":"games/sega/maimaidx/common/setup/#controllers-and-troubleshooting","title":"Controllers and Troubleshooting","text":"

Input methods and controllers are covered in the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/maimaidx/common/troubleshooting/","title":"Troubleshooting","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/maimaidx/common/troubleshooting/#my-game-crashes-on-launchstuck-on-starting-system-process","title":"My game crashes on launch/stuck on \"Starting System Process\"","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject -d -k mai2hook.dll amdaemon.exe -f -c config_common.json config_server.json\nping 127.0.0.1 -n 31 > nul && taskkill /F /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/maimaidx/common/troubleshooting/#my-game-is-stuck-on-a-black-screen-at-launch","title":"My game is stuck on a black screen at launch!","text":"

This could also be due to many things, the most common of which are:

  • You have one or more incorrect/broken DLL(s) in App\\Package\\Sinmai_Data\\Managed

    This is likely to be Assembly-CSharp.dll, Assembly-CSharp-firstpass.dll, and/or AMDaemon.NET.dll. You can try replacing the DLLs or re-downloading data from elsewhere.

  • An ill-formed keychip is defined in segatools.ini

  • You need to app the OpenSSL fix on Intel Core 10th Gen CPUs and newer.

"},{"location":"games/sega/maimaidx/common/troubleshooting/#my-game-is-stuck-on-a-blue-and-black-screen","title":"My game is stuck on a blue and black screen!","text":"

You need to run the data using unprotected/unpacked files. Please refer to the setup guide to find which ones you need and obtain them.

If you believe you've already done this. You might be missing a try installing the latest vcredist

"},{"location":"games/sega/maimaidx/common/troubleshooting/#my-game-is-running-too-slowfast-or-the-notes-are-out-of-sync","title":"My game is running too slow/fast or the notes are out of sync!","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Limit Sinmai.exe to run at 60 FPS using a tool like RivaTuner or a patch.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/maimaidx/prism/controllers/","title":"maimai DX PRiSM","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with IO DLLs to add support for controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\Package folder and referenced in segatools.ini under the [mai2io] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[mai2io]\n; To use a custom maimai DX IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/maimaidx/prism/controllers/#keyboardtouchscreen","title":"Keyboard/Touchscreen","text":"

Keyboard/Touchscreen is the default input method

The default layout uses QWEDCXZA for physical buttons (each key representing the physical button's location relative to the center screen)

If you wish to change the default keybinds, an explanation on how to set these is included above the [io4] section in your segatools.ini.

Touch input should automatically work after connecting a touch-screen display

"},{"location":"games/sega/maimaidx/prism/controllers/#adx-controller","title":"ADX Controller","text":"

First, you will need to purchase a compatible monitor if your controller did not come with one. A list of compatible monitors can be found on this spreadsheet

Plug your controller in and open Device Manager.

Under the Ports (COM & LPT) section, ensure the correct ports are set for both the Touch Panel and Button LED.

  • (Touch Panel) USB Serial Device: COM3
  • (Button LED) USB-SERIAL CH340: COM21

If they are different change the port of the device by Right Clicking on the Device -> Properties -> Port Settings -> COM Port Number

Finally ensure the mai2.ini file in your data's App/Package folder has the following values set under the [AM] section 

[AM]\nTarget=0\nDummyTouchPanel=0\nDummyLED=0\n

This gets your controller working with keyboard inputs. Its highly recommended that you also view this setup guide which provides more detailed instructions, improved drivers, and help with adjusting touch panel sensitivity.

Warning

You DO NOT need to follow the Network Setup steps in the linked guide above if you've already done so while setting up game data

You DO NOT need to follow the Aime Reader setup in the linked guide above if you do not own one.

"},{"location":"games/sega/maimaidx/prism/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/maimaidx/prism/setup/","title":"maimai DX PRiSM","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of maimai DX

Create a new folder for the game and start from scratch. maimai DX DOES NOT like being extracted over old data!

"},{"location":"games/sega/maimaidx/prism/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files are not set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and filesand press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create two new empty folders named appdata and amfs (and the folder option if not present) next to them as shown below:

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/maimaidx/prism/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/maimaidx/prism/setup/#installing-option-data","title":"Installing option data","text":"

maimai DX content updates are distributed through option folders instead of patching the base game.

Options are named with a letter followed by three numbers.

For JPN(SDEZ) data, each new release of maimai DX increments the first letter of the Option (ie. BUDDiES is H??? and BUDDiES+ is I???).

For EXP(SDGA) data, Options will always begin with the letter A (i.e A???)

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

Do not mix option data between versions

"},{"location":"games/sega/maimaidx/prism/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

maimai DX executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of the following files and the associated configuration file:

  • amdaemon.exe
  • Sinmai.exe
  • Sinmai_Data/Plugins/amdaemon_api.dll
  • Sinmai_Data/Plugins/Cake.dll (JPN/SDEZ only)
  • Sinmai_Data/Managed/AMDaemon.NET.dll
  • Sinmai_Data/Managed/Assembly-CSharp.dll
  • mai2.ini

Copy the files and folders into the App/Package folder of your game data. Agree to overwrite when asked.

Assembly-CSharp Notes

Assembly-CSharp.dll must match your game version. All others can be reused from other game versions.

"},{"location":"games/sega/maimaidx/prism/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/maimaidx/prism/setup/#mai2ini","title":"mai2.ini","text":"

Ensure that the App\\Package folder contains mai2.ini.

If this configuration file is missing, create one using the contents below.

[Debug]\nDebug=1\n\n[AM]\nTarget=0\nIgnoreError=1\nDummyTouchPanel=1\nDummyLED=1\nDummyCodeCamera=1\nDummyPhotoCamera=1\n\n[Sound]\nSound8Ch=0\n
"},{"location":"games/sega/maimaidx/prism/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download the segatools.zip from 2024-03-13. Do not download the source code or latest release.
  • Extracting the archive should give you a few more zip files. Find mai2.zip and extract it to the App/Package folder in your game data.

You should now have a few more files inside the App/Package folder, as highlighted:

Warning

The latest release of segatools currently has issues with maimai, and for the time being an older version of segatools is preferred.

"},{"location":"games/sega/maimaidx/prism/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\package\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[gpio]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
"},{"location":"games/sega/maimaidx/prism/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n
AquaMai

It's strongly recommended to use MelonLoader mods to improve QOL. You can find info about the available mods for maimai here AquaMai. For general modding check Unity modding page.

"},{"location":"games/sega/maimaidx/prism/setup/#setting-launch-options","title":"Setting launch options","text":"

Right click App\\package\\start.bat, select Edit. Locate the line that launches sinmai and edit it according to your preferences:

@echo off\n\npushd %~dp0\n\nstart \"AM Daemon\" /min inject -d -k mai2hook.dll amdaemon.exe -f -c config_common.json config_server.json config_client.json\ninject -d -k mai2hook.dll sinmai -screen-fullscreen 0 -popupwindow -screen-width 2160 -screen-height 1920  -silent-crashes\n\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Launch options
  • -screen-fullscreen 0: windowed
  • -screen-fullscreen 0 -popupwindow: borderless windowed
  • -screen-fullscreen 1: exclusive fullscreen
  • -screen-width <W> -screen-height <H>: resolution
  • -monitor <N>: the monitor to run the game on
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number. For example, monitor 2 means -monitor 2.

"},{"location":"games/sega/maimaidx/prism/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.172.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\package\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/maimaidx/prism/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/maimaidx/prism/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/maimaidx/prism/setup/#audio","title":"Audio","text":"
  • Right-click on the volume setting in your taskbar and select Sounds.
  • Navigate to the Playback tab, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick either 16 bit, 48000Hz (DVD Quality) or 24 bit, 48000Hz (Studio Quality), click Apply, then OK.
"},{"location":"games/sega/maimaidx/prism/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/maimaidx/prism/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/maimaidx/prism/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\package\\start.bat. Let the game load until you reach a screen with the message below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 7th option).

Select \u5e97\u5185\u30de\u30c3\u30c1\u30f3\u30b0\u306e\u8a2d\u5b9a (IN-STORE MATCHING SETUP, the first option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/maimaidx/prism/setup/#custom-mods","title":"Custom Mods","text":"

Mods are covered on the Unity modding page.

"},{"location":"games/sega/maimaidx/prism/setup/#controllers-and-troubleshooting","title":"Controllers and Troubleshooting","text":"

Input methods and controllers are covered in the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/maimaidx/prism/troubleshooting/","title":"maimai DX PRiSM","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/maimaidx/prism/troubleshooting/#my-game-crashes-on-launchstuck-on-starting-system-process","title":"My game crashes on launch/stuck on \"Starting System Process\"","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject -d -k mai2hook.dll amdaemon.exe -f -c config_common.json config_server.json\nping 127.0.0.1 -n 31 > nul && taskkill /F /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/maimaidx/prism/troubleshooting/#my-game-is-stuck-on-a-black-screen-at-launch","title":"My game is stuck on a black screen at launch!","text":"

This could also be due to many things, the most common of which are:

  • You have one or more incorrect/broken DLL(s) in App\\Package\\Sinmai_Data\\Managed

    This is likely to be Assembly-CSharp.dll, Assembly-CSharp-firstpass.dll, and/or AMDaemon.NET.dll. You can try replacing the DLLs or re-downloading data from elsewhere.

  • An ill-formed keychip is defined in segatools.ini

  • You need to app the OpenSSL fix on Intel Core 10th Gen CPUs and newer.

"},{"location":"games/sega/maimaidx/prism/troubleshooting/#my-game-is-stuck-on-a-blue-and-black-screen","title":"My game is stuck on a blue and black screen!","text":"

You need to run the data using unprotected/unpacked files. Please refer to the setup guide to find which ones you need and obtain them.

If you believe you've already done this. You might be missing a try installing the latest vcredist

"},{"location":"games/sega/maimaidx/prism/troubleshooting/#my-game-is-running-too-slowfast-or-the-notes-are-out-of-sync","title":"My game is running too slow/fast or the notes are out of sync!","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Limit Sinmai.exe to run at 60 FPS using a tool like RivaTuner or a patch.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/maimaidx/prismplus/controllers/","title":"maimai DX PRiSM PLUS","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with IO DLLs to add support for controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\Package folder and referenced in segatools.ini under the [mai2io] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[mai2io]\n; To use a custom maimai DX IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/maimaidx/prismplus/controllers/#keyboardtouchscreen","title":"Keyboard/Touchscreen","text":"

Keyboard/Touchscreen is the default input method

The default layout uses QWEDCXZA for physical buttons (each key representing the physical button's location relative to the center screen)

If you wish to change the default keybinds, an explanation on how to set these is included above the [io4] section in your segatools.ini.

Touch input should automatically work after connecting a touch-screen display

"},{"location":"games/sega/maimaidx/prismplus/controllers/#adx-controller","title":"ADX Controller","text":"

First, you will need to purchase a compatible monitor if your controller did not come with one. A list of compatible monitors can be found on this spreadsheet

Plug your controller in and open Device Manager.

Under the Ports (COM & LPT) section, ensure the correct ports are set for both the Touch Panel and Button LED.

  • (Touch Panel) USB Serial Device: COM3
  • (Button LED) USB-SERIAL CH340: COM21

If they are different change the port of the device by Right Clicking on the Device -> Properties -> Port Settings -> COM Port Number

Finally ensure the mai2.ini file in your data's App/Package folder has the following values set under the [AM] section 

[AM]\nTarget=0\nDummyTouchPanel=0\nDummyLED=0\n

This gets your controller working with keyboard inputs. Its highly recommended that you also view this setup guide which provides more detailed instructions, improved drivers, and help with adjusting touch panel sensitivity.

Warning

You DO NOT need to follow the Network Setup steps in the linked guide above if you've already done so while setting up game data

You DO NOT need to follow the Aime Reader setup in the linked guide above if you do not own one.

"},{"location":"games/sega/maimaidx/prismplus/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/maimaidx/prismplus/setup/","title":"maimai DX PRiSM PLUS","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of maimai DX

Create a new folder for the game and start from scratch. maimai DX DOES NOT like being extracted over old data!

"},{"location":"games/sega/maimaidx/prismplus/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files are not set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and filesand press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create two new empty folders named appdata and amfs (and the folder option if not present) next to them as shown below:

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/maimaidx/prismplus/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/maimaidx/prismplus/setup/#installing-option-data","title":"Installing option data","text":"

maimai DX content updates are distributed through option folders instead of patching the base game.

Options are named with a letter followed by three numbers.

For JPN(SDEZ) data, each new release of maimai DX increments the first letter of the Option (ie. BUDDiES is H??? and BUDDiES+ is I???).

For EXP(SDGA) data, Options will always begin with the letter A (i.e A???)

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

Do not mix option data between versions

"},{"location":"games/sega/maimaidx/prismplus/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

maimai DX executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of the following files and the associated configuration file:

  • amdaemon.exe
  • Sinmai.exe
  • Sinmai_Data/Plugins/amdaemon_api.dll
  • Sinmai_Data/Plugins/Cake.dll (JPN/SDEZ only)
  • Sinmai_Data/Managed/AMDaemon.NET.dll
  • Sinmai_Data/Managed/Assembly-CSharp.dll
  • mai2.ini

Copy the files and folders into the App/Package folder of your game data. Agree to overwrite when asked.

Assembly-CSharp Notes

Assembly-CSharp.dll must match your game version. All others can be reused from other game versions.

"},{"location":"games/sega/maimaidx/prismplus/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/maimaidx/prismplus/setup/#mai2ini","title":"mai2.ini","text":"

Ensure that the App\\Package folder contains mai2.ini.

If this configuration file is missing, create one using the contents below.

[Debug]\nDebug=1\n\n[AM]\nTarget=0\nIgnoreError=1\nDummyTouchPanel=1\nDummyLED=1\nDummyCodeCamera=1\nDummyPhotoCamera=1\n\n[Sound]\nSound8Ch=0\n
"},{"location":"games/sega/maimaidx/prismplus/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download the segatools.zip from 2024-03-13. Do not download the source code or latest release.
  • Extracting the archive should give you a few more zip files. Find mai2.zip and extract it to the App/Package folder in your game data.

You should now have a few more files inside the App/Package folder, as highlighted:

Warning

The latest release of segatools currently has issues with maimai, and for the time being an older version of segatools is preferred.

"},{"location":"games/sega/maimaidx/prismplus/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\package\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[gpio]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
"},{"location":"games/sega/maimaidx/prismplus/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n
AquaMai

It's strongly recommended to use MelonLoader mods to improve QOL. You can find info about the available mods for maimai here AquaMai. For general modding check Unity modding page.

"},{"location":"games/sega/maimaidx/prismplus/setup/#setting-launch-options","title":"Setting launch options","text":"

Right click App\\package\\start.bat, select Edit. Locate the line that launches sinmai and edit it according to your preferences:

@echo off\n\npushd %~dp0\n\nstart \"AM Daemon\" /min inject -d -k mai2hook.dll amdaemon.exe -f -c config_common.json config_server.json config_client.json\ninject -d -k mai2hook.dll sinmai -screen-fullscreen 0 -popupwindow -screen-width 2160 -screen-height 1920  -silent-crashes\n\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Launch options
  • -screen-fullscreen 0: windowed
  • -screen-fullscreen 0 -popupwindow: borderless windowed
  • -screen-fullscreen 1: exclusive fullscreen
  • -screen-width <W> -screen-height <H>: resolution
  • -monitor <N>: the monitor to run the game on
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number. For example, monitor 2 means -monitor 2.

"},{"location":"games/sega/maimaidx/prismplus/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.172.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\package\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/maimaidx/prismplus/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/maimaidx/prismplus/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/maimaidx/prismplus/setup/#audio","title":"Audio","text":"
  • Right-click on the volume setting in your taskbar and select Sounds.
  • Navigate to the Playback tab, right click on your default audio device, and click on Properties.
  • Go to the Advanced tab.
  • Check both boxes under Exclusive Mode.
  • Open the Default Format dropdown.
  • Pick either 16 bit, 48000Hz (DVD Quality) or 24 bit, 48000Hz (Studio Quality), click Apply, then OK.
"},{"location":"games/sega/maimaidx/prismplus/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/maimaidx/prismplus/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/maimaidx/prismplus/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\package\\start.bat. Let the game load until you reach a screen with the message below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 7th option).

Select \u5e97\u5185\u30de\u30c3\u30c1\u30f3\u30b0\u306e\u8a2d\u5b9a (IN-STORE MATCHING SETUP, the first option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/maimaidx/prismplus/setup/#custom-mods","title":"Custom Mods","text":"

Mods are covered on the Unity modding page.

"},{"location":"games/sega/maimaidx/prismplus/setup/#controllers-and-troubleshooting","title":"Controllers and Troubleshooting","text":"

Input methods and controllers are covered in the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/maimaidx/prismplus/troubleshooting/","title":"maimai DX PRiSM PLUS","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/maimaidx/prismplus/troubleshooting/#my-game-crashes-on-launchstuck-on-starting-system-process","title":"My game crashes on launch/stuck on \"Starting System Process\"","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject -d -k mai2hook.dll amdaemon.exe -f -c config_common.json config_server.json\nping 127.0.0.1 -n 31 > nul && taskkill /F /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/maimaidx/prismplus/troubleshooting/#my-game-is-stuck-on-a-black-screen-at-launch","title":"My game is stuck on a black screen at launch!","text":"

This could also be due to many things, the most common of which are:

  • You have one or more incorrect/broken DLL(s) in App\\Package\\Sinmai_Data\\Managed

    This is likely to be Assembly-CSharp.dll, Assembly-CSharp-firstpass.dll, and/or AMDaemon.NET.dll. You can try replacing the DLLs or re-downloading data from elsewhere.

  • An ill-formed keychip is defined in segatools.ini

  • You need to app the OpenSSL fix on Intel Core 10th Gen CPUs and newer.

"},{"location":"games/sega/maimaidx/prismplus/troubleshooting/#my-game-is-stuck-on-a-blue-and-black-screen","title":"My game is stuck on a blue and black screen!","text":"

You need to run the data using unprotected/unpacked files. Please refer to the setup guide to find which ones you need and obtain them.

If you believe you've already done this. You might be missing a try installing the latest vcredist

"},{"location":"games/sega/maimaidx/prismplus/troubleshooting/#my-game-is-running-too-slowfast-or-the-notes-are-out-of-sync","title":"My game is running too slow/fast or the notes are out of sync!","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Limit Sinmai.exe to run at 60 FPS using a tool like RivaTuner or a patch.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/ongeki/brightmemory/controllers/","title":"Controllers (O.N.G.E.K.I. bright MEMORY)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and XInput Controllers. However, it can be configured with IO DLLs to add support for other controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\package folder and referenced in segatools.ini under the [mu3io] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[mu3io]\n; To use a custom O.N.G.E.K.I. IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard/gamepad input.\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/ongeki/brightmemory/controllers/#keyboard-and-mouse","title":"Keyboard and Mouse","text":"

Keyboard and Mouse is the default input method.

To enable mouse lever emulation ensure that the mouse option is set to 1 in the [io4] section of your segatools.ini:

[io4]\n; Set \"1\" to enable mouse lever emulation, \"0\" to use XInput\nmouse=1\n

The default layout use ASD for the left 3 buttons, and JKL for the right 3 buttons. Mouse Left/Right Click are used for the left and right bumper buttons.

If you wish to change the default keybinds, an explanation on how to set these is included above the [io4] section in your segatools.ini.

"},{"location":"games/sega/ongeki/brightmemory/controllers/#xinput-controller","title":"XInput Controller","text":"

XInput controllers are supported by segatools. To enable XInput, ensure that the mouse option is set to 0 in the [io4] section of your segatools.ini:

[io4]\n; Set \"1\" to enable mouse lever emulation, \"0\" to use XInput\nmouse=0\n

If you wish to change the default keybinds, an explanation on how to set these is included above the [io4] section in your segatools.ini.

"},{"location":"games/sega/ongeki/brightmemory/controllers/#mageki","title":"Mageki","text":"

Mageki allows you to use a mobile device as a O.N.G.E.K.I. controller. It replicates the layout of an arcade O.N.G.E.K.I. controller on your mobile device.

Mageki supports both Android and iOS devices. For installation instructions, please refer to the English User Manual on the Mageki GitHub Repository.

Configuring ongeki-io and MU3-input.dll

When moving the zipped contents of MU3Input, move all folders EXCEPT the segatools.ini file into your App\\package folder in a way that matches its file structure. Modify the [mu3io] and [aimeio] sections of your existing segatools.ini file to look like the following:

[mu3io]\npath=MU3Input.dll\n\n[aimeio]\npath=MU3Input.dll\n
If these sections do not exist, add them to the end of your segatools.ini file.

IOConfig doesn't launch for me/This application requires the Windows App Runtime

Download and extract the contents of the Windows App Runtime Version 1.5 Redistributable In the WindowsAppSDK-Installer-x64 folder run WindowsAppRuntimeInstall-x64.exe

If IOConfig still fails to launch, try using the SelfContained version of ongeki-io

"},{"location":"games/sega/ongeki/brightmemory/controllers/#ontroller","title":"ONTROLLER","text":"
  • Navigate to Mu3IO.NET releases and download mu3io.dll. Put this file in your App\\package folder.
  • Edit your segatools.ini to reference the DLL:
[mu3io]\n; To use a custom O.N.G.E.K.I. IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard/gamepad input.\npath=mu3io.dll\n
"},{"location":"games/sega/ongeki/brightmemory/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet slider and air sensors, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/ongeki/brightmemory/setup/","title":"Game Setup (O.N.G.E.K.I. bright MEMORY)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of O.N.G.E.K.I.

You'll want to create a new folder for the game and start from scratch. O.N.G.E.K.I. DOES NOT like being extracted over old data!

"},{"location":"games/sega/ongeki/brightmemory/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create another empty folder named AppData next to them. It should now look like below.

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/ongeki/brightmemory/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/ongeki/brightmemory/setup/#installing-option-data","title":"Installing option data","text":"

O.N.G.E.K.I. content updates are distributed through option folders instead of patching the base game. They are named A???, with each ? being a number. Custom options distributed by the community might use letters instead, to distinguish them from official ones.

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

In some cases, your data may have options in App\\package\\option. If so, move all contents inside to the Option folder where App and AppData are and delete the App\\package\\option folder.

"},{"location":"games/sega/ongeki/brightmemory/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

O.N.G.E.K.I. executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of the following files and the associated configuration file:

  • amdaemon.exe
  • mu3.exe
  • mu3_Data\\Plugins\\amdaemon_api.dll
  • mu3_Data\\Plugins\\chiffre.dll
  • mu3_Data\\Plugins\\libhttp.dll
  • mu3_Data\\Plugins\\QR_Image.dll
  • mu3_Data\\Managed\\AMDaemon.NET.dll
  • mu3_Data\\Managed\\Assembly-CSharp-firstpass.dll
  • mu3_Data\\Managed\\Assembly-CSharp.dll
  • mu3.ini

Copy the files and folders into the App/Package folder of your game data. Agree to overwrite when asked.

Assembly-CSharp Note

Assembly-CSharp.dll must match your game version.

"},{"location":"games/sega/ongeki/brightmemory/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/ongeki/brightmemory/setup/#mu3ini","title":"mu3.ini","text":"

Ensure that the App\\package folder contains mu3.ini.

If this configuration file is missing, create one using the contents below.

[AM]\nIgnoreError=1\nOptionDev=0\nDummyAime=0\nDummyCredit=1\nDummyJVS=0\n\n[Sound]\nWasapiExclusive=0\n

Warning

If you are following the folder structure of this guide, you must ensure that OptionDev is set to 0 in your mu3.ini, or else your Option data will not load.

"},{"location":"games/sega/ongeki/brightmemory/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download segatools.zip. Do not download the source code.
  • Extracting the archive should give you a few more zip files. Find mu3.zip and extract it to the App\\package folder in your game data.

You should now have a few more files inside the folder, as highlighted:

"},{"location":"games/sega/ongeki/brightmemory/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\package\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
"},{"location":"games/sega/ongeki/brightmemory/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n
mu3-mods

It's strongly recommended to use BepInEx mods to improve QOL. You can find info about the available mods for O.N.G.E.K.I. here mu3-mods. For general modding check Unity modding page.

"},{"location":"games/sega/ongeki/brightmemory/setup/#setting-launch-options","title":"Setting launch options","text":"

Right click App\\package\\start.bat, select Edit. Locate the line that launches mu3 and edit it according to your preferences:

@echo off\n\npushd %~dp0\n\nstart \"AM Daemon\" /min inject -d -k mu3hook.dll amdaemon.exe -f -c config_common.json config_server.json config_client.json\ninject -d -k mu3hook.dll mu3 -screen-fullscreen 0 -popupwindow -screen-width 1080 -screen-height 1920\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Launch options
  • -screen-fullscreen 0: windowed
  • -screen-fullscreen 0 -popupwindow: borderless windowed
  • -screen-fullscreen 1: exclusive fullscreen
  • -screen-width <W> -screen-height <H>: resolution
Note about resolution
  • The service menu will only render correctly at 1080x1920.
  • This can be fixed with a patch.
  • -monitor <N>: the monitor to run the game on
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number. For example, monitor 2 means -monitor 2.

"},{"location":"games/sega/ongeki/brightmemory/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.162.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\package\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/ongeki/brightmemory/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/ongeki/brightmemory/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/ongeki/brightmemory/setup/#audio","title":"Audio","text":"
  • Open App\\package\\mu3.ini (or create it if it doesn't exist).
  • Set WasapiExclusive in the Sound section to 0 (create the key if it doesn't exist):
[Sound]\nWasapiExclusive=0\n
"},{"location":"games/sega/ongeki/brightmemory/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/ongeki/brightmemory/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/ongeki/brightmemory/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\package\\start.bat. Let the game load until you reach a screen with the message below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 6th option).

Select \u30b0\u30eb\u30fc\u30d7\u5185\u57fa\u6e96\u6a5f\u306e\u8a2d\u5b9a (SET STANDARD IN GROUP, the second option) and toggle this setting to \u57fa\u6e96\u6a5f (STANDARD).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/ongeki/brightmemory/setup/#close-setting","title":"CLOSE SETTING","text":"

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the 10th option).

Navigate to \u6642 (HOUR, the 2nd option) and use the Service button to toggle the setting until it says \u5168\u6642\u523b (ALL TIME).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu, then select \u7d42\u4e86 (also the last option) in the main menu to exit the service menu.

You're all done! The game should load up properly now.

You can add coins using the Coin key (default F3) and card in by holding the Enter key.

"},{"location":"games/sega/ongeki/brightmemory/setup/#custom-mods","title":"Custom Mods","text":"

Mods are covered on the Unity modding page.

"},{"location":"games/sega/ongeki/brightmemory/setup/#controllers-and-troubleshooting","title":"Controllers and Troubleshooting","text":"

Input methods and controllers are covered on the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/ongeki/brightmemory/troubleshooting/","title":"Troubleshooting (O.N.G.E.K.I. bright MEMORY)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/ongeki/brightmemory/troubleshooting/#my-game-crashes-on-launchstuck-on-starting-system-process","title":"My game crashes on launch/stuck on \"Starting System Process\"","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject -d -k mu3hook.dll amdaemon.exe -f -c config_common.json config_server.json\nping 127.0.0.1 -n 31 > nul && taskkill /F /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/ongeki/brightmemory/troubleshooting/#my-game-is-stuck-on-a-black-screen-at-launch","title":"My game is stuck on a black screen at launch!","text":"

This could also be due to many things, the most common of which are:

  • You have one or more incorrect/broken DLL(s) in App\\package\\mu3_Data\\Managed

    This is likely to be Assembly-CSharp.dll, Assembly-CSharp-firstpass.dll, and/or AMDaemon.NET.dll. You can try replacing the DLLs or re-downloading data from elsewhere.

  • An ill-formed keychip is defined in segatools.ini

"},{"location":"games/sega/ongeki/brightmemory/troubleshooting/#my-game-is-running-too-slowfast-or-the-notes-are-out-of-sync","title":"My game is running too slow/fast or the notes are out of sync!","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Limit mu3.exe to run at 60 FPS using a tool like RivaTuner or a patch.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/ongeki/brightmemory/troubleshooting/#my-lever-controls-arent-working","title":"My lever controls aren't working!","text":"

You may need to calibrate your lever.

From the TEST MENU select \u30ec\u30d0\u30fc\u8a2d\u5b9a (LEVER SETTINGS) and then move the lever left to right ensuring that the game detects the full range of motion.

Then save by selecting \u7d42\u4e86 (EXIT) and then \u4fdd\u5b58\u3059\u308b (SAVE).

"},{"location":"games/sega/ongeki/brightmemory/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for mu3.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/ongeki/common/controllers/","title":"Controllers","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and XInput Controllers. However, it can be configured with IO DLLs to add support for other controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\package folder and referenced in segatools.ini under the [mu3io] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[mu3io]\n; To use a custom O.N.G.E.K.I. IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard/gamepad input.\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/ongeki/common/controllers/#keyboard-and-mouse","title":"Keyboard and Mouse","text":"

Keyboard and Mouse is the default input method.

To enable mouse lever emulation ensure that the mouse option is set to 1 in the [io4] section of your segatools.ini:

[io4]\n; Set \"1\" to enable mouse lever emulation, \"0\" to use XInput\nmouse=1\n

The default layout use ASD for the left 3 buttons, and JKL for the right 3 buttons. Mouse Left/Right Click are used for the left and right bumper buttons.

If you wish to change the default keybinds, an explanation on how to set these is included above the [io4] section in your segatools.ini.

"},{"location":"games/sega/ongeki/common/controllers/#xinput-controller","title":"XInput Controller","text":"

XInput controllers are supported by segatools. To enable XInput, ensure that the mouse option is set to 0 in the [io4] section of your segatools.ini:

[io4]\n; Set \"1\" to enable mouse lever emulation, \"0\" to use XInput\nmouse=0\n

If you wish to change the default keybinds, an explanation on how to set these is included above the [io4] section in your segatools.ini.

"},{"location":"games/sega/ongeki/common/controllers/#mageki","title":"Mageki","text":"

Mageki allows you to use a mobile device as a O.N.G.E.K.I. controller. It replicates the layout of an arcade O.N.G.E.K.I. controller on your mobile device.

Mageki supports both Android and iOS devices. For installation instructions, please refer to the English User Manual on the Mageki GitHub Repository.

Configuring ongeki-io and MU3-input.dll

When moving the zipped contents of MU3Input, move all folders EXCEPT the segatools.ini file into your App\\package folder in a way that matches its file structure. Modify the [mu3io] and [aimeio] sections of your existing segatools.ini file to look like the following:

[mu3io]\npath=MU3Input.dll\n\n[aimeio]\npath=MU3Input.dll\n
If these sections do not exist, add them to the end of your segatools.ini file.

IOConfig doesn't launch for me/This application requires the Windows App Runtime

Download and extract the contents of the Windows App Runtime Version 1.5 Redistributable In the WindowsAppSDK-Installer-x64 folder run WindowsAppRuntimeInstall-x64.exe

If IOConfig still fails to launch, try using the SelfContained version of ongeki-io

"},{"location":"games/sega/ongeki/common/controllers/#ontroller","title":"ONTROLLER","text":"
  • Navigate to Mu3IO.NET releases and download mu3io.dll. Put this file in your App\\package folder.
  • Edit your segatools.ini to reference the DLL:
[mu3io]\n; To use a custom O.N.G.E.K.I. IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard/gamepad input.\npath=mu3io.dll\n
"},{"location":"games/sega/ongeki/common/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet slider and air sensors, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/ongeki/common/setup/","title":"Setup","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of O.N.G.E.K.I.

You'll want to create a new folder for the game and start from scratch. O.N.G.E.K.I. DOES NOT like being extracted over old data!

"},{"location":"games/sega/ongeki/common/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create another empty folder named AppData next to them. It should now look like below.

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/ongeki/common/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/ongeki/common/setup/#installing-option-data","title":"Installing option data","text":"

O.N.G.E.K.I. content updates are distributed through option folders instead of patching the base game. They are named A???, with each ? being a number. Custom options distributed by the community might use letters instead, to distinguish them from official ones.

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

In some cases, your data may have options in App\\package\\option. If so, move all contents inside to the Option folder where App and AppData are and delete the App\\package\\option folder.

"},{"location":"games/sega/ongeki/common/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

O.N.G.E.K.I. executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of the following files and the associated configuration file:

  • amdaemon.exe
  • mu3.exe
  • mu3_Data\\Plugins\\amdaemon_api.dll
  • mu3_Data\\Plugins\\chiffre.dll
  • mu3_Data\\Plugins\\libhttp.dll
  • mu3_Data\\Plugins\\QR_Image.dll
  • mu3_Data\\Managed\\AMDaemon.NET.dll
  • mu3_Data\\Managed\\Assembly-CSharp-firstpass.dll
  • mu3_Data\\Managed\\Assembly-CSharp.dll
  • mu3.ini

Copy the files and folders into the App/Package folder of your game data. Agree to overwrite when asked.

Assembly-CSharp Note

Assembly-CSharp.dll must match your game version.

"},{"location":"games/sega/ongeki/common/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/ongeki/common/setup/#mu3ini","title":"mu3.ini","text":"

Ensure that the App\\package folder contains mu3.ini.

If this configuration file is missing, create one using the contents below.

[AM]\nIgnoreError=1\nOptionDev=0\nDummyAime=0\nDummyCredit=1\nDummyJVS=0\n\n[Sound]\nWasapiExclusive=0\n

Warning

If you are following the folder structure of this guide, you must ensure that OptionDev is set to 0 in your mu3.ini, or else your Option data will not load.

"},{"location":"games/sega/ongeki/common/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download segatools.zip. Do not download the source code.
  • Extracting the archive should give you a few more zip files. Find mu3.zip and extract it to the App\\package folder in your game data.

You should now have a few more files inside the folder, as highlighted:

"},{"location":"games/sega/ongeki/common/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\package\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
"},{"location":"games/sega/ongeki/common/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n
mu3-mods

It's strongly recommended to use BepInEx mods to improve QOL. You can find info about the available mods for O.N.G.E.K.I. here mu3-mods. For general modding check Unity modding page.

"},{"location":"games/sega/ongeki/common/setup/#setting-launch-options","title":"Setting launch options","text":"

Right click App\\package\\start.bat, select Edit. Locate the line that launches mu3 and edit it according to your preferences:

@echo off\n\npushd %~dp0\n\nstart \"AM Daemon\" /min inject -d -k mu3hook.dll amdaemon.exe -f -c config_common.json config_server.json config_client.json\ninject -d -k mu3hook.dll mu3 -screen-fullscreen 0 -popupwindow -screen-width 1080 -screen-height 1920\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Launch options
  • -screen-fullscreen 0: windowed
  • -screen-fullscreen 0 -popupwindow: borderless windowed
  • -screen-fullscreen 1: exclusive fullscreen
  • -screen-width <W> -screen-height <H>: resolution
Note about resolution
  • The service menu will only render correctly at 1080x1920.
  • This can be fixed with a patch.
  • -monitor <N>: the monitor to run the game on
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number. For example, monitor 2 means -monitor 2.

"},{"location":"games/sega/ongeki/common/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.162.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\package\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/ongeki/common/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/ongeki/common/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/ongeki/common/setup/#audio","title":"Audio","text":"
  • Open App\\package\\mu3.ini (or create it if it doesn't exist).
  • Set WasapiExclusive in the Sound section to 0 (create the key if it doesn't exist):
[Sound]\nWasapiExclusive=0\n
"},{"location":"games/sega/ongeki/common/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/ongeki/common/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/ongeki/common/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\package\\start.bat. Let the game load until you reach a screen with the message below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 6th option).

Select \u30b0\u30eb\u30fc\u30d7\u5185\u57fa\u6e96\u6a5f\u306e\u8a2d\u5b9a (SET STANDARD IN GROUP, the second option) and toggle this setting to \u57fa\u6e96\u6a5f (STANDARD).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/ongeki/common/setup/#close-setting","title":"CLOSE SETTING","text":"

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the 10th option).

Navigate to \u6642 (HOUR, the 2nd option) and use the Service button to toggle the setting until it says \u5168\u6642\u523b (ALL TIME).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu, then select \u7d42\u4e86 (also the last option) in the main menu to exit the service menu.

You're all done! The game should load up properly now.

You can add coins using the Coin key (default F3) and card in by holding the Enter key.

"},{"location":"games/sega/ongeki/common/setup/#custom-mods","title":"Custom Mods","text":"

Mods are covered on the Unity modding page.

"},{"location":"games/sega/ongeki/common/setup/#controllers-and-troubleshooting","title":"Controllers and Troubleshooting","text":"

Input methods and controllers are covered on the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/ongeki/common/troubleshooting/","title":"Troubleshooting","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/ongeki/common/troubleshooting/#my-game-crashes-on-launchstuck-on-starting-system-process","title":"My game crashes on launch/stuck on \"Starting System Process\"","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject -d -k mu3hook.dll amdaemon.exe -f -c config_common.json config_server.json\nping 127.0.0.1 -n 31 > nul && taskkill /F /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/ongeki/common/troubleshooting/#my-game-is-stuck-on-a-black-screen-at-launch","title":"My game is stuck on a black screen at launch!","text":"

This could also be due to many things, the most common of which are:

  • You have one or more incorrect/broken DLL(s) in App\\package\\mu3_Data\\Managed

    This is likely to be Assembly-CSharp.dll, Assembly-CSharp-firstpass.dll, and/or AMDaemon.NET.dll. You can try replacing the DLLs or re-downloading data from elsewhere.

  • An ill-formed keychip is defined in segatools.ini

"},{"location":"games/sega/ongeki/common/troubleshooting/#my-game-is-running-too-slowfast-or-the-notes-are-out-of-sync","title":"My game is running too slow/fast or the notes are out of sync!","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Limit mu3.exe to run at 60 FPS using a tool like RivaTuner or a patch.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/ongeki/common/troubleshooting/#my-lever-controls-arent-working","title":"My lever controls aren't working!","text":"

You may need to calibrate your lever.

From the TEST MENU select \u30ec\u30d0\u30fc\u8a2d\u5b9a (LEVER SETTINGS) and then move the lever left to right ensuring that the game detects the full range of motion.

Then save by selecting \u7d42\u4e86 (EXIT) and then \u4fdd\u5b58\u3059\u308b (SAVE).

"},{"location":"games/sega/ongeki/common/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for mu3.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/ongeki/refresh/controllers/","title":"Controllers (O.N.G.E.K.I. Re:Fresh)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and XInput Controllers. However, it can be configured with IO DLLs to add support for other controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\package folder and referenced in segatools.ini under the [mu3io] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[mu3io]\n; To use a custom O.N.G.E.K.I. IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard/gamepad input.\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/ongeki/refresh/controllers/#keyboard-and-mouse","title":"Keyboard and Mouse","text":"

Keyboard and Mouse is the default input method.

To enable mouse lever emulation ensure that the mouse option is set to 1 in the [io4] section of your segatools.ini:

[io4]\n; Set \"1\" to enable mouse lever emulation, \"0\" to use XInput\nmouse=1\n

The default layout use ASD for the left 3 buttons, and JKL for the right 3 buttons. Mouse Left/Right Click are used for the left and right bumper buttons.

If you wish to change the default keybinds, an explanation on how to set these is included above the [io4] section in your segatools.ini.

"},{"location":"games/sega/ongeki/refresh/controllers/#xinput-controller","title":"XInput Controller","text":"

XInput controllers are supported by segatools. To enable XInput, ensure that the mouse option is set to 0 in the [io4] section of your segatools.ini:

[io4]\n; Set \"1\" to enable mouse lever emulation, \"0\" to use XInput\nmouse=0\n

If you wish to change the default keybinds, an explanation on how to set these is included above the [io4] section in your segatools.ini.

"},{"location":"games/sega/ongeki/refresh/controllers/#mageki","title":"Mageki","text":"

Mageki allows you to use a mobile device as a O.N.G.E.K.I. controller. It replicates the layout of an arcade O.N.G.E.K.I. controller on your mobile device.

Mageki supports both Android and iOS devices. For installation instructions, please refer to the English User Manual on the Mageki GitHub Repository.

Configuring ongeki-io and MU3-input.dll

When moving the zipped contents of MU3Input, move all folders EXCEPT the segatools.ini file into your App\\package folder in a way that matches its file structure. Modify the [mu3io] and [aimeio] sections of your existing segatools.ini file to look like the following:

[mu3io]\npath=MU3Input.dll\n\n[aimeio]\npath=MU3Input.dll\n
If these sections do not exist, add them to the end of your segatools.ini file.

IOConfig doesn't launch for me/This application requires the Windows App Runtime

Download and extract the contents of the Windows App Runtime Version 1.5 Redistributable In the WindowsAppSDK-Installer-x64 folder run WindowsAppRuntimeInstall-x64.exe

If IOConfig still fails to launch, try using the SelfContained version of ongeki-io

"},{"location":"games/sega/ongeki/refresh/controllers/#ontroller","title":"ONTROLLER","text":"
  • Navigate to Mu3IO.NET releases and download mu3io.dll. Put this file in your App\\package folder.
  • Edit your segatools.ini to reference the DLL:
[mu3io]\n; To use a custom O.N.G.E.K.I. IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard/gamepad input.\npath=mu3io.dll\n
"},{"location":"games/sega/ongeki/refresh/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you're interested in using a cabinet slider and air sensors, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/ongeki/refresh/setup/","title":"Game Setup (O.N.G.E.K.I. Re:Fresh)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

If you're coming from a previous version of O.N.G.E.K.I.

You'll want to create a new folder for the game and start from scratch. O.N.G.E.K.I. DOES NOT like being extracted over old data!

"},{"location":"games/sega/ongeki/refresh/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

Create another empty folder named AppData next to them. It should now look like below.

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs, Option and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/ongeki/refresh/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract your patch's files to your existing data in a way that matches its file structure. Agree to overwrite files if necessary.

"},{"location":"games/sega/ongeki/refresh/setup/#installing-option-data","title":"Installing option data","text":"

O.N.G.E.K.I. content updates are distributed through option folders instead of patching the base game. They are named A???, with each ? being a number. Custom options distributed by the community might use letters instead, to distinguish them from official ones.

Extract any options you've downloaded into the Option folder. You should end up with a file structure as follows. Do not be worried if you have fewer or more option folders.

In some cases, your data may have options in App\\package\\option. If so, move all contents inside to the Option folder where App and AppData are and delete the App\\package\\option folder.

"},{"location":"games/sega/ongeki/refresh/setup/#installing-unprotected-executables","title":"Installing unprotected executables","text":"

O.N.G.E.K.I. executables are protected and will not run on a regular computer.

Obtain unprotected (also called \"unpacked\" or \"decrypted\" by the community) copies of the following files and the associated configuration file:

  • amdaemon.exe
  • mu3.exe
  • mu3_Data\\Plugins\\amdaemon_api.dll
  • mu3_Data\\Plugins\\chiffre.dll
  • mu3_Data\\Plugins\\libhttp.dll
  • mu3_Data\\Plugins\\QR_Image.dll
  • mu3_Data\\Managed\\AMDaemon.NET.dll
  • mu3_Data\\Managed\\Assembly-CSharp-firstpass.dll
  • mu3_Data\\Managed\\Assembly-CSharp.dll
  • mu3.ini

Copy the files and folders into the App/Package folder of your game data. Agree to overwrite when asked.

Assembly-CSharp Note

Assembly-CSharp.dll must match your game version.

"},{"location":"games/sega/ongeki/refresh/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your unprotected executables came with an amfs folder, and already has a file named ICF1 in it, skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/ongeki/refresh/setup/#mu3ini","title":"mu3.ini","text":"

Ensure that the App\\package folder contains mu3.ini.

If this configuration file is missing, create one using the contents below.

[AM]\nIgnoreError=1\nOptionDev=0\nDummyAime=0\nDummyCredit=1\nDummyJVS=0\n\n[Sound]\nWasapiExclusive=0\n

Warning

If you are following the folder structure of this guide, you must ensure that OptionDev is set to 0 in your mu3.ini, or else your Option data will not load.

"},{"location":"games/sega/ongeki/refresh/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download segatools.zip. Do not download the source code.
  • Extracting the archive should give you a few more zip files. Find mu3.zip and extract it to the App\\package folder in your game data.

You should now have a few more files inside the folder, as highlighted:

"},{"location":"games/sega/ongeki/refresh/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\package\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
"},{"location":"games/sega/ongeki/refresh/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n
mu3-mods

It's strongly recommended to use BepInEx mods to improve QOL. You can find info about the available mods for O.N.G.E.K.I. here mu3-mods. For general modding check Unity modding page.

"},{"location":"games/sega/ongeki/refresh/setup/#setting-launch-options","title":"Setting launch options","text":"

Right click App\\package\\start.bat, select Edit. Locate the line that launches mu3 and edit it according to your preferences:

@echo off\n\npushd %~dp0\n\nstart \"AM Daemon\" /min inject -d -k mu3hook.dll amdaemon.exe -f -c config_common.json config_server.json config_client.json\ninject -d -k mu3hook.dll mu3 -screen-fullscreen 0 -popupwindow -screen-width 1080 -screen-height 1920\ntaskkill /f /im amdaemon.exe > nul 2>&1\n\necho.\necho Game processes have terminated\npause\n
Launch options
  • -screen-fullscreen 0: windowed
  • -screen-fullscreen 0 -popupwindow: borderless windowed
  • -screen-fullscreen 1: exclusive fullscreen
  • -screen-width <W> -screen-height <H>: resolution
Note about resolution
  • The service menu will only render correctly at 1080x1920.
  • This can be fixed with a patch.
  • -monitor <N>: the monitor to run the game on
Getting the monitor index

Navigate to Windows display settings. Each monitor should be assigned a number. The monitor index is that number. For example, monitor 2 means -monitor 2.

"},{"location":"games/sega/ongeki/refresh/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.162.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\package\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/ongeki/refresh/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

These steps are required, otherwise your game won't run.

"},{"location":"games/sega/ongeki/refresh/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/ongeki/refresh/setup/#audio","title":"Audio","text":"
  • Open App\\package\\mu3.ini (or create it if it doesn't exist).
  • Set WasapiExclusive in the Sound section to 0 (create the key if it doesn't exist):
[Sound]\nWasapiExclusive=0\n
"},{"location":"games/sega/ongeki/refresh/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/ongeki/refresh/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page.

Tip

Without an English patch, the service menu will be in Japanese. If you don't know Japanese, Google Lens is a handy tool for navigating this menu.

"},{"location":"games/sega/ongeki/refresh/setup/#game-assignments","title":"GAME ASSIGNMENTS","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Start the game by running App\\package\\start.bat. Let the game load until you reach a screen with the message below.

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

Navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 6th option).

Select \u30b0\u30eb\u30fc\u30d7\u5185\u57fa\u6e96\u6a5f\u306e\u8a2d\u5b9a (SET STANDARD IN GROUP, the second option) and toggle this setting to \u57fa\u6e96\u6a5f (STANDARD).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

"},{"location":"games/sega/ongeki/refresh/setup/#close-setting","title":"CLOSE SETTING","text":"

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the 10th option).

Navigate to \u6642 (HOUR, the 2nd option) and use the Service button to toggle the setting until it says \u5168\u6642\u523b (ALL TIME).

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu, then select \u7d42\u4e86 (also the last option) in the main menu to exit the service menu.

You're all done! The game should load up properly now.

You can add coins using the Coin key (default F3) and card in by holding the Enter key.

"},{"location":"games/sega/ongeki/refresh/setup/#custom-mods","title":"Custom Mods","text":"

Mods are covered on the Unity modding page.

"},{"location":"games/sega/ongeki/refresh/setup/#controllers-and-troubleshooting","title":"Controllers and Troubleshooting","text":"

Input methods and controllers are covered on the Controllers page.

Have any other issues?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/sega/ongeki/refresh/troubleshooting/","title":"Troubleshooting (O.N.G.E.K.I. Re:Fresh)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/ongeki/refresh/troubleshooting/#my-game-crashes-on-launchstuck-on-starting-system-process","title":"My game crashes on launch/stuck on \"Starting System Process\"","text":"

Could be due to many things, the most common of which are:

  • amdaemon crashing in the background. Make sure that the config_*.json files have valid syntax, your ICF files are correct, and the OpenSSL fix is applied on Intel Core 10th Gen CPUs and newer.
Capturing logs from amdaemon for troubleshooting

To assist with troubleshooting, a script can be used to capture logs from amdaemon. Create a file named amdaemontest.bat in App\\bin, then paste the code block below into the file.

@echo off\ncls\necho Attempting to run AM Daemon ...\necho Window should close after 30 seconds\necho Log will be generated at amdaemontest.txt\ncall :sub >amdaemontest.txt\nexit /b\n\n:sub\nset OPENSSL_ia32cap=:~0x20000000\npushd %~dp0\nstart /b \"AM Daemon\" /min inject -d -k mu3hook.dll amdaemon.exe -f -c config_common.json config_server.json\nping 127.0.0.1 -n 31 > nul && taskkill /F /im amdaemon.exe\n

Double-click it to run. The script should run for 30 seconds, and you will get a file named amdaemontest.txt in App\\bin, which you can send to help people troubleshoot your issue.

"},{"location":"games/sega/ongeki/refresh/troubleshooting/#my-game-is-stuck-on-a-black-screen-at-launch","title":"My game is stuck on a black screen at launch!","text":"

This could also be due to many things, the most common of which are:

  • You have one or more incorrect/broken DLL(s) in App\\package\\mu3_Data\\Managed

    This is likely to be Assembly-CSharp.dll, Assembly-CSharp-firstpass.dll, and/or AMDaemon.NET.dll. You can try replacing the DLLs or re-downloading data from elsewhere.

  • An ill-formed keychip is defined in segatools.ini

"},{"location":"games/sega/ongeki/refresh/troubleshooting/#my-game-is-running-too-slowfast-or-the-notes-are-out-of-sync","title":"My game is running too slow/fast or the notes are out of sync!","text":"

The game could be running under or over its required refresh rate.

  • Make sure V-Sync isn't disabled in your graphics settings (called \"Vertical sync\" in NVIDIA Control Panel and \"Wait for Vertical Refresh\" in AMD Control Panel.)
  • Limit mu3.exe to run at 60 FPS using a tool like RivaTuner or a patch.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/ongeki/refresh/troubleshooting/#my-lever-controls-arent-working","title":"My lever controls aren't working!","text":"

You may need to calibrate your lever.

From the TEST MENU select \u30ec\u30d0\u30fc\u8a2d\u5b9a (LEVER SETTINGS) and then move the lever left to right ensuring that the game detects the full range of motion.

Then save by selecting \u7d42\u4e86 (EXIT) and then \u4fdd\u5b58\u3059\u308b (SAVE).

"},{"location":"games/sega/ongeki/refresh/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for mu3.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/wacca/common/controllers/","title":"Controllers","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and XInput Controllers. However, it can be configured with IO DLLs to add support for other controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\bin folder and referenced in segatools.ini under the [mercuryio] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[mercuryio]\n; To use a custom WACCA IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/wacca/common/controllers/#touch-screen-mobile-device","title":"Touch screen / Mobile device","text":"

Both Any2WACCAi and Toucca allows you to use a touch screen or a mobile device as a WACCA controller. It replicates the layout of an arcade WACCA cab.

Installation instructions

Any2WACCAi

Toucca

"},{"location":"games/sega/wacca/common/controllers/#wacvr","title":"WACVR","text":"

WACVR allows you to use a VR Headset to replicate a WACCA cab and use it as a controller.

Setting up WACVR

Download WACVR from here and extract to a folder of your choice. Copy the mercuryio.dll file to the the App/bin folder in your data folder.

Edit your segatools.ini like this:

[mercuryio]\n; To use a custom WACCA IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=mercuryio.dll\n

Start up your VR software as well as SteamVR, then launch WACCA and WACVR.exe. WACVR should set up with WACCA automatically.

Warning

If you're experiencing a warped screen in WACVR, make sure your monitor is set to portrait mode and check the Full display capture box in WACVR.

"},{"location":"games/sega/wacca/common/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you want to run the game on a real cab, check the reDIVE World website

If you're interested in using a cabinet slider, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/wacca/common/setup/","title":"Setup","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/wacca/common/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/wacca/common/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract all updates in order. Agree to overwrite files if necessary.

For example, if you have 3.00.00; install 3.01.00, then 3.02.00, etc.

"},{"location":"games/sega/wacca/common/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your amfs folder already has a file named ICF1, skip this step.

In some cases, your data may have a folder containing ICFs in App\\bin\\amfs. If so, move all contents inside to the amfs folder where App and AppData, delete the App\\bin\\amfs folder, and skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/wacca/common/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher.

"},{"location":"games/sega/wacca/common/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download segatools.zip. Do not download the source code.
  • Extracting the archive should give you a few more zip files. Find mercury.zip and extract it to the App\\bin folder in your game data.

You should now have a few more files inside the folder, as highlighted:

"},{"location":"games/sega/wacca/common/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\bin\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
"},{"location":"games/sega/wacca/common/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\nappdata=../../AppData\n

Relative Directories

The ../ in the above example represents the parent directory in a relative path. It is used to navigate up one level in the directory hierarchy.

For example, your segatools.ini is located at /App/bin/segatools.ini and your amfs folder is located next to the App folder.

Since segatools.ini is in the /bin/ folder, typing ../ would move you up to the App folder. Since the amfs folder is next to the App folder, the second ../ takes you to App's parent folder, which is the folder containing App, amfs, etc.

The benefits of using this method include:

  • Avoiding issues that arise when folders have spaces in their names.

  • Being able to move your game folder without redefining the locations of your VFS folders.

  • A cleaner and easier to read segatools.ini, making spotting issues simpler.

"},{"location":"games/sega/wacca/common/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

This step is not needed if you plan on running the offline patch.

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.174.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\package\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/wacca/common/setup/#pre-launch-requirement","title":"Pre-launch requirement","text":"

This step is required, otherwise your game won't run.

"},{"location":"games/sega/wacca/common/setup/#install-ftdi-leds-driver","title":"Install FTDI LEDs driver","text":"

Download FTDI drivers from here and extract them to a folder of your choice, then copy CDM-v2.12.36.4-WHQL-Certified/amd64/ftd2xx64.dll to /App/WindowsNoEditor/Mercury/Binaries/Win64 and then rename the file to ftd2xx.dll.

"},{"location":"games/sega/wacca/common/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/wacca/common/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/wacca/common/setup/#first-launch","title":"First launch","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Set your display orientation to portrait mode.

Start the game by running App\\bin\\start.bat.

"},{"location":"games/sega/wacca/common/setup/#close-setting","title":"CLOSE SETTING","text":"

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

You can also use the Volume buttons (default UP and DOWN keys) to navigate and the ENTER key to select.

Navigate to SYSTEM SETTING.

Navigate to CLOSING TIME SETTINGS.

Navigate to ALL DAYS OF THE WEEK and use the Service button to toggle the setting until it says OFF.

Select APPLY SETTINGS AND RE-BOOT to save the settings.

Note that this will close your game and you will have to start it again with start.bat.

You're all done! The game should load up properly now.

You can add coins using the Coin key (default F3) and card in by holding the Enter key.

"},{"location":"games/sega/wacca/common/setup/#controllers-and-troubleshooting","title":"Controllers and Troubleshooting","text":"

Input methods and controllers are covered on the Controllers page.

Have any other issues?

Check out the Error Codes page.

"},{"location":"games/sega/wacca/lilyr/controllers/","title":"Controllers (WACCA Lily R)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and XInput Controllers. However, it can be configured with IO DLLs to add support for other controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\bin folder and referenced in segatools.ini under the [mercuryio] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[mercuryio]\n; To use a custom WACCA IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/wacca/lilyr/controllers/#touch-screen-mobile-device","title":"Touch screen / Mobile device","text":"

Both Any2WACCAi and Toucca allows you to use a touch screen or a mobile device as a WACCA controller. It replicates the layout of an arcade WACCA cab.

Installation instructions

Any2WACCAi

Toucca

"},{"location":"games/sega/wacca/lilyr/controllers/#wacvr","title":"WACVR","text":"

WACVR allows you to use a VR Headset to replicate a WACCA cab and use it as a controller.

Setting up WACVR

Download WACVR from here and extract to a folder of your choice. Copy the mercuryio.dll file to the the App/bin folder in your data folder.

Edit your segatools.ini like this:

[mercuryio]\n; To use a custom WACCA IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=mercuryio.dll\n

Start up your VR software as well as SteamVR, then launch WACCA and WACVR.exe. WACVR should set up with WACCA automatically.

Warning

If you're experiencing a warped screen in WACVR, make sure your monitor is set to portrait mode and check the Full display capture box in WACVR.

"},{"location":"games/sega/wacca/lilyr/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you want to run the game on a real cab, check the reDIVE World website

If you're interested in using a cabinet slider, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/wacca/lilyr/setup/","title":"Game Setup (WACCA Lily R)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/wacca/lilyr/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/wacca/lilyr/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract all updates in order. Agree to overwrite files if necessary.

For example, if you have 3.00.00; install 3.01.00, then 3.02.00, etc.

"},{"location":"games/sega/wacca/lilyr/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your amfs folder already has a file named ICF1, skip this step.

In some cases, your data may have a folder containing ICFs in App\\bin\\amfs. If so, move all contents inside to the amfs folder where App and AppData, delete the App\\bin\\amfs folder, and skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/wacca/lilyr/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher.

"},{"location":"games/sega/wacca/lilyr/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download segatools.zip. Do not download the source code.
  • Extracting the archive should give you a few more zip files. Find mercury.zip and extract it to the App\\bin folder in your game data.

You should now have a few more files inside the folder, as highlighted:

"},{"location":"games/sega/wacca/lilyr/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\bin\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
"},{"location":"games/sega/wacca/lilyr/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\nappdata=../../AppData\n

Relative Directories

The ../ in the above example represents the parent directory in a relative path. It is used to navigate up one level in the directory hierarchy.

For example, your segatools.ini is located at /App/bin/segatools.ini and your amfs folder is located next to the App folder.

Since segatools.ini is in the /bin/ folder, typing ../ would move you up to the App folder. Since the amfs folder is next to the App folder, the second ../ takes you to App's parent folder, which is the folder containing App, amfs, etc.

The benefits of using this method include:

  • Avoiding issues that arise when folders have spaces in their names.

  • Being able to move your game folder without redefining the locations of your VFS folders.

  • A cleaner and easier to read segatools.ini, making spotting issues simpler.

"},{"location":"games/sega/wacca/lilyr/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

This step is not needed if you plan on running the offline patch.

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.174.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\package\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/wacca/lilyr/setup/#pre-launch-requirement","title":"Pre-launch requirement","text":"

This step is required, otherwise your game won't run.

"},{"location":"games/sega/wacca/lilyr/setup/#install-ftdi-leds-driver","title":"Install FTDI LEDs driver","text":"

Download FTDI drivers from here and extract them to a folder of your choice, then copy CDM-v2.12.36.4-WHQL-Certified/amd64/ftd2xx64.dll to /App/WindowsNoEditor/Mercury/Binaries/Win64 and then rename the file to ftd2xx.dll.

"},{"location":"games/sega/wacca/lilyr/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/wacca/lilyr/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/wacca/lilyr/setup/#first-launch","title":"First launch","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Set your display orientation to portrait mode.

Start the game by running App\\bin\\start.bat.

"},{"location":"games/sega/wacca/lilyr/setup/#close-setting","title":"CLOSE SETTING","text":"

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

You can also use the Volume buttons (default UP and DOWN keys) to navigate and the ENTER key to select.

Navigate to SYSTEM SETTING.

Navigate to CLOSING TIME SETTINGS.

Navigate to ALL DAYS OF THE WEEK and use the Service button to toggle the setting until it says OFF.

Select APPLY SETTINGS AND RE-BOOT to save the settings.

Note that this will close your game and you will have to start it again with start.bat.

You're all done! The game should load up properly now.

You can add coins using the Coin key (default F3) and card in by holding the Enter key.

"},{"location":"games/sega/wacca/lilyr/setup/#controllers-and-troubleshooting","title":"Controllers and Troubleshooting","text":"

Input methods and controllers are covered on the Controllers page.

Have any other issues?

Check out the Error Codes page.

"},{"location":"games/sega/wacca/reverse/controllers/","title":"Controllers (WACCA Reverse)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

segatools, by default, only accepts keyboard input and XInput Controllers. However, it can be configured with IO DLLs to add support for other controllers.

The controller you plan on using should also be provided with these IO DLLs. If unsure, check the support section for your controller, or contact the vendor directly. Alternate options for the most common controllers are listed below.

These IO DLLs should be copied to your game's App\\bin folder and referenced in segatools.ini under the [mercuryio] section.

If you have a single DLL, uncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[mercuryio]\n; To use a custom WACCA IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\n;(1)!\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/wacca/reverse/controllers/#touch-screen-mobile-device","title":"Touch screen / Mobile device","text":"

Both Any2WACCAi and Toucca allows you to use a touch screen or a mobile device as a WACCA controller. It replicates the layout of an arcade WACCA cab.

Installation instructions

Any2WACCAi

Toucca

"},{"location":"games/sega/wacca/reverse/controllers/#wacvr","title":"WACVR","text":"

WACVR allows you to use a VR Headset to replicate a WACCA cab and use it as a controller.

Setting up WACVR

Download WACVR from here and extract to a folder of your choice. Copy the mercuryio.dll file to the the App/bin folder in your data folder.

Edit your segatools.ini like this:

[mercuryio]\n; To use a custom WACCA IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=mercuryio.dll\n

Start up your VR software as well as SteamVR, then launch WACCA and WACVR.exe. WACVR should set up with WACCA automatically.

Warning

If you're experiencing a warped screen in WACVR, make sure your monitor is set to portrait mode and check the Full display capture box in WACVR.

"},{"location":"games/sega/wacca/reverse/controllers/#arcade-hardware-and-other-controllers","title":"Arcade hardware and other controllers","text":"

If you want to run the game on a real cab, check the reDIVE World website

If you're interested in using a cabinet slider, or possibly even making your own controller, the Cons&Stuff website and Discord community is a great place to start!

"},{"location":"games/sega/wacca/reverse/setup/","title":"Game Setup (WACCA Reverse)","text":"

Please make sure you downloaded your data from an appropriate source.This guide is unable to troubleshoot any problems related to bad or poorly managed data.

"},{"location":"games/sega/wacca/reverse/setup/#preparing-data","title":"Preparing data","text":"

There are currently issues with running game data in the E:\\ or Y:\\ drive.Please extract the data into other drives.

After downloading and extracting your data, we need to make sure your files aren't set to Read-only.

  • Right click the folder containing your data, then click on Properties.
  • In the General tab go down to Attributes, untick Read-only and click Apply.
  • A popup will appear, select Apply changes to this folder, subfolder and files and press OK.
  • Finally, click OK again to exit out of properties.

You should end up with a file structure as follows.

The App folder should have a file structure as follows.

If your data doesn't look like this

If your data looks like the third image:

  • Create an App folder and move all files and folders from the image inside of it.
  • Create empty folders named amfs and AppData next to the App folder.

If extra files are present next to your folders, such as executables, scripts, etc.. remove them. This also means your data was tampered with and we strongly recommend getting new data from somewhere else.

"},{"location":"games/sega/wacca/reverse/setup/#updating-the-base-game","title":"Updating the base game","text":"

Extract all updates in order. Agree to overwrite files if necessary.

For example, if you have 3.00.00; install 3.01.00, then 3.02.00, etc.

"},{"location":"games/sega/wacca/reverse/setup/#installing-icfs","title":"Installing ICFs","text":"

Install Configuration Files (ICFs) tell the game what version it is. Without this your game cannot go online!

If your amfs folder already has a file named ICF1, skip this step.

In some cases, your data may have a folder containing ICFs in App\\bin\\amfs. If so, move all contents inside to the amfs folder where App and AppData, delete the App\\bin\\amfs folder, and skip this step.

Otherwise, obtain copies of ICF1 for your game version and place it in the amfs folder. If it is named something else, rename it to exactly ICF1 without any file extensions.

Showing file extensions

By default, file extensions on Windows are hidden. Enable them by navigating to the View tab in File Explorer and select File name extensions.

"},{"location":"games/sega/wacca/reverse/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher.

"},{"location":"games/sega/wacca/reverse/setup/#installing-segatools","title":"Installing segatools","text":"
  • Head over to segatools releases and download segatools.zip. Do not download the source code.
  • Extracting the archive should give you a few more zip files. Find mercury.zip and extract it to the App\\bin folder in your game data.

You should now have a few more files inside the folder, as highlighted:

"},{"location":"games/sega/wacca/reverse/setup/#configuring-segatools","title":"Configuring segatools","text":"

Since there is no graphical configuration tool for segatools, you will have to edit the configuration file by hand. It is found in App\\bin\\segatools.ini.

It is recommended that you follow along using a text editor with syntax highlighting such as Notepad++.

Each following sub-section will correspond to a section in segatools.ini. If any section is not mentioned, you can skip them.

Warning

If a key already exists in the section, delete everything after = and replace it with your setting. Do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
"},{"location":"games/sega/wacca/reverse/setup/#vfs","title":"[vfs]","text":"

If you've been matching the file structure as described in the Preparing data section, you can fill in this section with the values below:

[vfs]\namfs=../../amfs\nappdata=../../AppData\n

Relative Directories

The ../ in the above example represents the parent directory in a relative path. It is used to navigate up one level in the directory hierarchy.

For example, your segatools.ini is located at /App/bin/segatools.ini and your amfs folder is located next to the App folder.

Since segatools.ini is in the /bin/ folder, typing ../ would move you up to the App folder. Since the amfs folder is next to the App folder, the second ../ takes you to App's parent folder, which is the folder containing App, amfs, etc.

The benefits of using this method include:

  • Avoiding issues that arise when folders have spaces in their names.

  • Being able to move your game folder without redefining the locations of your VFS folders.

  • A cleaner and easier to read segatools.ini, making spotting issues simpler.

"},{"location":"games/sega/wacca/reverse/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Please choose one of the two solutions, not both!

This step is not needed if you plan on running the offline patch.

Remote (Online Network)

Head to the [dns] section inside segatools.ini. Set default to the address provided by your network. Do not add http:// or https:// to the address!

[dns]\ndefault=network.example\n

Then, head to the [keychip] section and add & set id to the keychip ID provided by your network:

[keychip]\nsubnet=192.168.174.0\nid=A69E-XXXXXXXXXXX\n

Finally, you need a card number. Create a file named aime.txt inside App\\package\\DEVICE and type in your 20-digit access code if you already have one, or make one up if you don't. If you're making one up, the access code MUST NOT start with a 3.

Local (ARTEMiS/AquaDX)

Both of these options require non-trivial setup. Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/wacca/reverse/setup/#pre-launch-requirement","title":"Pre-launch requirement","text":"

This step is required, otherwise your game won't run.

"},{"location":"games/sega/wacca/reverse/setup/#install-ftdi-leds-driver","title":"Install FTDI LEDs driver","text":"

Download FTDI drivers from here and extract them to a folder of your choice, then copy CDM-v2.12.36.4-WHQL-Certified/amd64/ftd2xx64.dll to /App/WindowsNoEditor/Mercury/Binaries/Win64 and then rename the file to ftd2xx.dll.

"},{"location":"games/sega/wacca/reverse/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist (VisualCppRedist_AIO_x86_x64.exe)
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/sega/wacca/reverse/setup/#fixing-openssl-on-intel-10th-gen-and-newer-cpus","title":"Fixing OpenSSL on Intel 10th Gen and newer CPUs","text":"

If you have an Intel 10th Gen CPU or newer, you need to patch amdaemon and enable OpenSSL SHA crash bug fix.

"},{"location":"games/sega/wacca/reverse/setup/#first-launch","title":"First launch","text":"

If you've followed all instructions correctly, you're now finally ready to launch the game!

Set your display orientation to portrait mode.

Start the game by running App\\bin\\start.bat.

"},{"location":"games/sega/wacca/reverse/setup/#close-setting","title":"CLOSE SETTING","text":"

Press your Test button (default F1) to enter the service menu. Use the Service button (default F2) to navigate the menu, and Test button to select an option.

You can also use the Volume buttons (default UP and DOWN keys) to navigate and the ENTER key to select.

Navigate to SYSTEM SETTING.

Navigate to CLOSING TIME SETTINGS.

Navigate to ALL DAYS OF THE WEEK and use the Service button to toggle the setting until it says OFF.

Select APPLY SETTINGS AND RE-BOOT to save the settings.

Note that this will close your game and you will have to start it again with start.bat.

You're all done! The game should load up properly now.

You can add coins using the Coin key (default F3) and card in by holding the Enter key.

"},{"location":"games/sega/wacca/reverse/setup/#controllers-and-troubleshooting","title":"Controllers and Troubleshooting","text":"

Input methods and controllers are covered on the Controllers page.

Have any other issues?

Check out the Error Codes page.

"}]} \ No newline at end of file diff --git a/sitemap.xml.gz b/sitemap.xml.gz index 41761f5f2aa929e5dfeac74b0ef57713061d0f3f..e75178279f9194df7106c6394fa1ac41df25a653 100644 GIT binary patch delta 13 Ucmb=gXP58h;9yYVnaExN02XBe{r~^~ delta 13 Ucmb=gXP58h;An7Rn8;oM02$u{lmGw#