From a015ad5a5d75e8af3d1a7eaf58b2c8d6fe7886ee Mon Sep 17 00:00:00 2001 From: <> Date: Sat, 29 Nov 2025 14:01:24 +0000 Subject: [PATCH] Deployed 65e76129 with MkDocs version: 1.6.1 --- extras/controllers/index.html | 10 +++++----- img/extras/controllers/maimai/yuancon_adx.webp | Bin 77992 -> 0 bytes img/extras/controllers/maimai/yuancon_ndx.webp | Bin 0 -> 3686 bytes search/search_index.json | 2 +- 4 files changed, 6 insertions(+), 6 deletions(-) delete mode 100644 img/extras/controllers/maimai/yuancon_adx.webp create mode 100644 img/extras/controllers/maimai/yuancon_ndx.webp diff --git a/extras/controllers/index.html b/extras/controllers/index.html index 98ce98b5..6f94bd5b 100644 --- a/extras/controllers/index.html +++ b/extras/controllers/index.html @@ -9650,13 +9650,13 @@ Controllers are ranked based on their popularity within the rhythm game communit

maimai

-ADX +NDX

- +

-

Product page
+

Product page
Vendor: YuanCon
-Price: $1399 + High shipping/Taxes

+Price: $899 + High shipping/Taxes

@@ -9809,7 +9809,7 @@ Controllers are ranked based on their popularity within the rhythm game communit - August 24, 2025 + November 29, 2025 diff --git a/img/extras/controllers/maimai/yuancon_adx.webp b/img/extras/controllers/maimai/yuancon_adx.webp deleted file mode 100644 index 3cd89e0be0ae2b2cb1e84ae8e86995107f3b269c..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 77992 zcmV(>K-j-hNk&GXFaZEpMM6+kP&iDJFaZEBE5S+-O-PJnJ8T==`w+jB1N$!+Ae|B- z`ac1l1O5?T2eH9Ngu{8NXcRypcl@c6QnG z#OWN>dxIO*uP3tg)*itV#y_03MR~4|ng~YRymj(dOQS$;cD+sB{ew@E`28digqu6b zl*IzMI?um{TQ5iw*CLw5^|9)3yg0_RRb5M6Yt@{eS88x#y6Og0FPi!NzKJB6(^y$G zC`Xc+_097PDM(0u>#mvL2sKjcM3O+WCt1ImQ%9jAokvZ&yT7&R&&cqY=u;mW?!=`g ziUiyfulvWTJBd2Rs7m61oFcs?>F#8yvyxb2j1i+Imyc0h>rSFrNkMWjYPLODcZ^95 zO`_RV-nmi(YNC^hpDn6kn`pPpDn=D!R*&DiW7+*p&m#M*>i&I9VoupYedk&i7^t#} z!{&3sQVo6(AA6deFUKmbdv_`qBJE=5I2MUhHWRa7NLkr3Eky7}d~ zzojRx_4M>S0|0k#EI!QR4Y~gwXhmMk4?~xIWF+ zaM^$og{TmTL@FwhxT%U!0~YtJ%Uc}{00q!M2AJRcsRa!H6le;7x~bHVY2B>ja{e5y31`@_C-g7@SdRE&TeGbo z6rm9kAwvsL?hPpgyT)Z*v$qlQ)31?}Eb=a+e;gC}vVhe!1C0^$3ZMZ1C6Yt}2pS3){4smAEd4z9*4rGME`ON0Y_ zk_aIb3-`O`D(YUUBtihtUoO4CJDYh2zVq*u`_H$bfm}Mvo<+Xh zC&u%h$uMm5c0X;cEIx{B1^6%nBH{=_$Y9f**G2c{i)l3J5FWpfLCARv!GDDi|4w zDVBTl<96C@nGBtQ;jrbQ)Y&Uss52Dw949a+0%Y*ON7# zfHP;|*NG6xEJ6S&5fv3B6}7{MQg?ck+A;_s|412D(^rxX(Xr)Zo33Bkv<)>8RjB|L zkP;$_ii!e$-9J1Z??01u&)WAoI`@W72oodObeOO1pWT}e_iRqG3=Jcxs!FK}fJBt2 zs5`sB<-!%Kq_c{ZS7Z5EVm@Imk8-dLe!2R!e*Wu`1`t9LB9RaPf>H_~V1!Jv_DD(= zIrOy3SvsFO{{(Zk=?MTr2oV*EMgfda6cr8*{cG$8dRfe?`PAdsnR|M+R%=6fE`a!u z3kw25lu&SN1PH8c3oFzgmi^V;si=weV zW^?i|?tsbZ)9_Lv;{yU(02G9BLjVw%fFszNS0ms1|3x!|;mpaiH#CgORrw(}EC3)h z8Za21y@NVP#4~^p>Hriw02oRtiq9D1{lHBDK%-gV5cg68!bszAh8grAM5z%&A~AwQ zqXD4ND2kCHG=SIvfN$6{a1AmQAt7ZoB-)TjqyPx~R}BCt0sy2`B(6s)k=2lIEB zy#YWZWR-{%)Zw6QBSA{j@+W<}`wt-^CIHBnK%NQY&Id>mtUvc5fe_eX)*j}T5I)y9 zXP((ZJX-k2YIu8ltQdN57tKI^+^dzk< z)KX3fmn4DknDj!DlQf{VDkP=Ng(MJ4+u4(amyjYTNq^_1|5 z?W~_M*UE=W0>P@=WRuNlKI9HLxkoFl34}v}?m_2E;HjN%suQPeCCNi<-8SdkrnFT; zlJKJ2E*q`u<=lGQ)NRgM%lE`(k291BkW0vcwg9(BK0xx4OOk{1lyLF??XfLc&Ko-`+j|4MWhWqH zr(luBpiv5W!4=>aw#*9P379rop94lCHT;qfb1l6p^7HVLnE0sJSjtM zP}wQe1lr*ZlkS8%@S%MNAbaFB0>Mj5FnbDHUb(2e0{0Z|7}`<6E?Nl--j~*r_vVa2 z6VMng6+N`!me<*|s3%F1W!sh{iHO(LTH87Sov02?2cpxc^=%=~k!`ECZQE8#xh@9% zgG&U8E)|v@Yl8#}dPy+>TJrzbZOd}j?#_#Um2VdMWr6V@W6r&+1blrQH%%K4IA~1^ z!$+K4dNs_zAKn(Wlj~#BO-sY3u~a_JhL;`GBPWzsRO1nsffI=n_{OPm*TCHw&9xF| zd?v>yxIA2D;Ed1avT?V(z@416v}JrIaWXH@Wo?`a+@TKc?u>ihQFHnjsM3!y0-TiCZHUjTOM7C|)wr#u9tTY1ezI*RE zXRkHq&_mm{s!fu!_de&o_kG_Ve?(+9Gcz+Y*kYDE*|HcC8eOqW4O#M-EM{5F%utY- zRZ*D%{|EP;vtt4{-~Yc_k~QVG_dX{qBc-zR-n#AX?(RNsWa#<_xQ^Z3-QC^Yd7jqm zeoL~_BI2C=+k?oe=UMy(pFvv=u=egfXz#`$kXox6Z zpr%py4<~U7=Zn)ejS24BQj?aL#^Bzys&Jz4gJ%tJDCFSI%v*BM-hFUSeB)%{B))Md z+!D*R+Hj}|PWCWcYET!4VdC5vwB5CC4G!+^)Sy_4_U?mgG2fgL7j>OSS~= zRs$Rgrv^6%?cLK(oc0bR2Nk$8@FhvIYTLGLnR(RK2Q1pm%%AkR6Spu|I}tkv%*E@NgCz*I3UOa}{-faVM#4>7Z^wdUxp#suh{|9`pN+WG#T z=UK4VX42kU+LA4c$&wjlnJrl|GlMMSF{8}KN48{{Ewn5!Nw&<)GKmb5#mr25YqR!R zd#&|6&+pza`~$x*Gv~}GC03_Y6=sG#3O(UOUFMcgIJr=TF7GPLoG2W(xqNj;p*`uY z!VGKXcBc&Ec9^-;2`kLxJFa#(?!vTYQelM$X13cfqfXduIPr`^YR|urJ(G$VT|GA?%;MpegQW{ze~8%9?voJ*CvFeoLnsxUJrm)cVw z1y^;U^(jvqW=<4l=EQTWFms~n2`6gZ;$UCo*0yb%SAHKG$K8F< zeUcM5f=W`Is!HwJSekQ=F=7IKhF=d#0KzDd+7LxhYOuf+84|;}uynsWzyPnTe)j;F zOQ8Uv2?B5huqD6&=Ror=as&7XH(Kvrc;$Z8w}b;AHvkoYSN1DQI|uj*kT;qSZtA=O zbkTUDi?#EdP}Fhv2?0@zj%snSrdU~+`wWV~_bPA1;V7iCb`h-IH@<;Q=neo*FM&Ea z0UE9eth?ft`}IT^#pjm1?N@WX4E@p>BZ{OIbZ|KWlT}S6gN>{mkg$=JTifei6KpMl ztVPMkISwb($gaqCGnw-(VMw;fQ>$x8pFmjaVl;6%s@xKs7>BtHTM zdNw?g$om1@F$}`?=6bs-E|fA>cqL96litZ>?Tk8|vXeol@x7BUW+6B$v!&{+-3wqR zfrL&LWJ?FQkkr4YSLg!Hx`nB;+KB~bVeT^FjQUr-+yK8cKrvUm)EgY!yFQUcKge5A z?3eZ!KfaTgz>wjW}QFM?*iz8}UbSBgLr|?fZ%-o%buRO*i_n zCEVa^ksG_%vba^Wb1VA6mbG2^+$jPmwGNCZW4218z${F?i+di?ow07GY4DBB8_C1X z;ABshc9y za1AYF&~ZS-j;lOE@$r9g_TnErK9BR$>E~4LzWjxGIW_P9ylI?Bkd-`*sIdcG8@bcp zfcKh3Ifp4dT}Om)!aEfes*V<~^hIKo###H=d4->jyj8AyLT==ZDx_pe7 zSaopZ-cl{i&;hp;r2}Ygh7KU|$h{a5Qj{TLRYYBxF0VZsWH38B8wXTc87jD!<0#62 zjJEp(ESh@s;Ng2{I|^d-u4V7-7T0hZv}Q5o;sh#gq)-!hRiCf#tR{ax=;)!UiULkP9ZrAEWb>7ukAQ`wDG@c8)i1$bjx0l7KOm*O~ zAIvRruH%-Dh>C4ACtHNF-wvB)QWo}BgbZ3s*qusenkqNUj@pKh5ur3eHbz_#z$}Ui zg9x!jln$D~kQgS+LKrqd4w}S|s52h=-7rd?0;1@&&=RExQ?KwXS&~ zwAe{9VJ86`AXPF{A}SFQOaO3PZz}ynM-r`?qTTg8ayy7zB$s-tGQ}Vlc#Wrx2a|^GIqqE_5R4A)_PBGwgQs|*1ng{}Kqo^M5zgoHPdrm% zAr9#oF98?Z(&X}4Z*YdMn2+UMShEy9hZTgBasYB_C_7nn^~{Dn*!Q1yNJKzdJQyTA zTdDxD=I#ZAuYy*w7GMu3;BLW@xbB<_Z0ur7R^~zntt!zf!WjUN({^3*rl@8!U71|T zMH5rq5^zc?b?5(u45ZiL0_K2AM1T;C2uH2<5R%&hrN=NLSOf_m3~E611fyUCLLK2i z2#zH5q*?jKeP4Q$Mrr2I1BMmd!%3~6O){z=>|;+_Qf8c+aO0NZhQ?4831y>$m3*ej zq;@3%)%!H|Ro*&fLr!yFV88DIO-)l&1LN<~NIk&OI$WA#Cwe$BBc1I4*cCrU#h|nu z?#-7UHq9~S%i<>AvqTk5j_Lrmwxe?n1?1MGf<$mbdoN~r)K$k3`4aBD9g0(72m0I2 z^C}sEX+@*(PI>9tlcf=2B>Ag|s8sZL*?QSnuVU68l3rwW$XEk3rLlFW2kvON!<{vh zsi^U&#V{ELL#H(1UDrSzSYm+2l%CWJI>Tfd2tBqBpv)nyg+9#^NGotp)d0yN@kE6M zKRYccl7fB`94tdwd7v8Dih=O12XR=SE52=e8UadS@Ca!JChH%qtLpkxRf&fU-Ue$0 zo3T=}b#x6IYxLJXU6MQ~j)R;G zHQ%k8lU6*+PZ-u3L5PPt@4OM;EpQ{g!ADBlA>qJ0&-8~xnD|qfb`J4bU?{PZO|`Rhwqws{pLb|vvmg)$ zN~SU}EYyANPSL#+gVn1rYz)rUrPcmFC7t{0TniAiu-$=%rK>s-VdwC)C|zp-R#@Hx zO;e+Z8`GEYTFiwpPEIYE+|{rvXed>1)E|!!ND+vZunipJ=Gq|L-F=`Bq_DJ)UXnC2+oNp`;QcFO-|RU#BeWEg`fA?$j~56j}n3a!AMSo)Z9oZi(23uq_3Y8f^ptwPf2;~uBeqMjC^$#-9$ ze0Fc`4!3IJQm0=}aK*-#Y7aZk^E!VqO=f%?clJM1ZCjo~hzC13$X_z0jtF#;el@Q} zRd8e@Sl-vbUyLo}!2z`ZuIIc0iUB+#lidndB$gWn^nHdeJ~+a;0g$`Ab><5Nm%L z2Z@XApXa*y>{^#D2f2F zat8->V{}EE_(iovF+(V@cvR&G+gniR+t&wnIuF6QO1(~nz$-()spB2)7l&EEFko4&(225s>fu47u!jbM^U2X%S}Q-9Mq@weKk-}*?y zhSl7GrFU9uD7?zEbGB)gp5tP)>|j0XUZYK>>r=Glf#>gmm)*Y@<|aUnrKI;~x8H(` z48hy4G5x7hh2d{@9ME2^CxJ=rD1Gma!HU8x!XAzne_CS+6$aPuDB>0af?Cbdw*kWY zaucY+5lh}3&1KCP^xa9(Z9}T!h<^^~Bli7MnWPzl9WV=+`wDOYF$lPa_5ZaR+?&#C zwrL~nl`K%V0nxVQ`0%VuR23zsHV1>LOo^P1HV*LS5Y0v`Br>WQhPcYbV{dt-0hU`4r-52`!vW?1J1khO`1aW}vot>Ss zrP={HhzP(*LwzQXGen^Q8vz?dGG(oE4yUKZ(Z1=d-jyC66Gv#hSR5oV<5kP;S;RhRdEOW6yP0N zX*O0ET^a;P!JlFAmmvN!_(c;l+oJMw;6uZWwY`i|dLT8L^)MUs zfOSQe?w&NgD6bi2351S77C_nE-~3U%T4-Rpq;0AUbtpjDPa?}0{a^NMVK9Wd#Pn^! zPy8fEaH6NsCoz4B@~7~;C?U_Zv?6+_wxD{y(lc_AJhJ!G01XJnqXk^>!>FP1YFMLA z#kKlitpij4A=N)KFREzqY^Bd;#&5`W^8>BF6dcbfwZS%0F{8M3;0HNmzRSeGF~20* zN4QI%wmLVo)0`bhK*Mo#CzxVkmPi+rNcF;~Z~=(aYd9|IJ}0F(3RuLgjbaszj6EVF ziNgoM?nSM4)KuUT(tyHxV43`-DsyZ4Ibe7uejeOfJ_96k642Q>fB^_(GZYn(V}6g@hDZ$2++uA} zz0Jp!_M@p+CCD*k;3oY;(X-X?qetTJ%=F)p_}WqbZ|!-On2wT&PHNP;hx{TkT0k z%1BrgPj(taRTjQd5hH{v=o#}nN<;ZG7+wc$?kiND7$HaoSx=DeI>-|e3LHw-y>;&Y z3VuN29D2W4%SgI7XOsjjX-PK4hsMX`#))pL|1ayjWxK!O&{d2TnlClx5`ZkHBDj|~ z<(RS;@)A1@lqxZ0|nNH6OkQ9%~&;yl!2Dy$AbC~WiZUs%gV$Gh-b zAER-{??5M3e(4zikuFLG6qb4A;vA1z9stxsl%K0f1-UeIg# z^H7ws6}^zU|s0gWv)){wXv|00izDA9;jYL*)$Rl+ZzdMzm~@1R8zQ`htuj z^pzJ%*a7T7&aoY|G>@5P!?xfM$Jnw>M(K^fv9>D~ipl|YuForqxbDcu)p#XA)V&yi z9lt5Gg0m3#h{&HqNm%%s5Cv?a0F=TgV3gSr&E5N#i`~Mf`8a7sr=KH8(9V{{4FS_3 z`hpb6uB#lh3iTOso`ml!FdaRIW5us)bPAc)#0^t1015_ zgjDoGXZVKXPi(S*2P;E828~Qc<7oV?&R@6l(?on$D?bk?mI2f4P4g=c2r@+q&}`d# zA*LyC+j3&3D*MgdaWehc_pSn>Z;YAEbcSb){I2qgvv z83sn%QF6I*&}fs-{Dt!GcsW7+w5SpoYd*1*5AIg={MMQc6e6YwB}SRL=&NF)Dm{

(3_o;J?!+aZ_YTYS^f&?SITVU--Er?>v4l zHBtaCfd)}TWll5_;t_QYzPu8Ui+K#))4^*a#_n(`9$2c&7G0C|k|;$EYsQLfUQC*c zUOJS`*v7shdDWyHHB%(O3#u90k$tf`ZI{L2+-x+0iEZ7n$qv_)4qAr0+)$^K2ECVP z^3C-digjjdm+nc|2J+dZH3hY}h_HmK7lZg>P6gZ0G8Q`9YJ*)suG@hfipcsczkbMP9$4kcMEp>({oc3N{`Vy^^ z08VA!wbR~<$w*+&maY?EiV%jul{idvGqDC3iBz9M+03tj2I$~9IVkv!+NrKwMVYx3 zCTGU2)Ai*)wQqmluR>sT+QpxSo&GCGr~rrqybWx@kUZmyDgwS4twTPgRbJ6#MF|z` zAfQ-kMK=?-=Gbi7Y$%)Mh%8FCBBA|pADJy3g-MpOHe~HfYh2HjV$EblN9}G(FHT-W zBN{LR<^x}zJ~TiIE=kee228apd(}z9u~BNZAFH_XlCG`sQHSYrv2JkOPom;irAWik zS4AKaT8ThpE*8dEIu^C#_Bpm9$BVb`m>h8sFgm=UmDH}9m_HpDx`PVh60yDvq9ODB zKV8i)7o70;XGg`$MuZpVr)ZbRHU+>r!2a=;4ITzWAW@n@f9?Q5x8?DW2{0uQtpd`r ziFD0Kt?RO|?zGB`pwa1!^(`2L;s;wiHNC^`nNeVrpOcP@$Kjq}fcM+8|LKYQvjDP`$ zB$T^<5`d&whf=&eaQLN#EK%u*wyMe)NK!U86mV#0U*;WU8wsGR0~F%`>_x-{_kqWz z`X@8#SuN3RHMq{?7wx_gNY5lXyt#s7_# z(ad?RF+W}5Zc#fW2A`9$XY{_-01>0{2jzDy-j@%`mPV`y$7Us6U*}#_nClkK` z`2RQa8MwbXVeAz8v41w6q<{ck&V!JBqs2@GPPJyxKd>b_fV;MWDWZ*5yIb}-b-HAK!fwbqV57^CNc z#R(2^5*+mzcRRHG+7~0Dvk-467S)pg`RU{kCXh7LAJ)YfSStjAph5w~JTCXrYtNRabCvbLGZXu7N?m`0n;mH#^OTDYs{gxk z;UAmqviJb`apGN{Lmtmo2rv){w^{1u)K_E)g3-IvZG&Y=sR?l_NSX!-9OiY5?HEa- z^rfJPd=0@Cs{<-jVW8xqEhjdSQQO)iKO zbDSzU+H@K(_Jv(+uk2&03G)kcvVY{Zz0+V-vA*#@%IA0oCw+7Hgofy3GpTRIYTT}W|e#{6f$wbtJ z%&!~T7j*O+Ad5EvUNj17dRw|OfKGh9JF=|8Fd;-NT)nUYm?5@mM1WIqDkUEduo7Ak zbfaYo19{64J(v1x3pmqb;|TXm&4K6!gak|$0Wa5&8xvNR7IQ?KMM!RsrQ{AVMwM-* zYqj;v3+eo&(_;v{vG~+yBm;S^BZ~;r=k-h#Xg>Ad(vm4W$YtzNZ z!GT;kmw^&siBSR))gr+MzT49olY|4X@qj!_1_1+O&5b93ypjJ*S8l<=UIi{I<|+Ua zG~Mkd;j~{C^GN-~$`R7Y%D%OIP11e|!Q}bz-!M-8-d5p%sbrt;gMZ4}UPmO=sg;M9 z*iiJFdf0E<*PKspDfJq#i!pRtap7raeXqiLb+~~| z!`E$wRsWY3`RTh}zg3t~jkj~qA#zWV`wZATvL4JcmCE;wqV&nyU7(n_?N<^BTnD%aLkSFtVC?*c6{7pbc5`LZ;~O+Es5I z%b}UHH?YGa$#Cc=sa$$*fF_t4Es_RchNM;Z;mkO9a@ZQ)$Y5v!ij3MD^icF_N9IJtl`M5FE;JA%OHaCIEYY^J!CVz;qiSU7Qm} z#0mt1iA?=ebAYcBr=yOd)Qr0agvrT|Ng@~Kb0<9eR(Djgxw+FTi@s=GIf64GGwt9q5eoCLX3P` zuolEpO4-emx%JR({=4;;7;tMWBmpRjD|lFR}I*1-&@pa9P(2Z&;xdL=t>M6Go(Z&h^ZiQw2DHUmzOS;^J;# z&aL%qTPcZM``;>->Y-h4YKxCkzq;`$wz~*Xt$*$nttoPyCxnhz+ zO{Y19EWB&`FxIp7h41H~F20Bjwbs~>IwD%}Zf@p6;UOFZUdp4TNhz5gP(rcmT4j5q zG?WA3j$JJfaqtx5&w9NO^t1pYj|JwX%Q#NRXh1n2j9}^PzzhKhNk$9YEI3TYAS5OG z+0I+FSP00kYelcB1%0*ymUdR|REsnSvel$s3gTrUy)79k4Gz-#Jj>)nNC*uPkmAE< z!&iwRu~Qt%t4bxn!v?{&HD9}$)f3t79>X`TJ@*X(d!Z?GjL!+4sN+;kLc7n zK=^nlC3!=&muZGQk?KtKBDdk7^LePq2^hUoojtdMMs}tyBC#6@!%Sb=)j@}zvss#v z*ce=$5kJy^`e|5+kGuM~?4@dl@de}O=YXn*sPqeEnmtID#@2PMOZVFHI=VJBNLIVj zv%;||IG=zxo!qRjuSh@j~ zrK99v0!&~MWCNlop=p2-I>f{gD&52pH1wfQk@Jaix3d9Kys53bdEGn!#3O_-_EFVfO`MxHIXQT-QR)Irw_tJ^o;Bfm zpNRv2^tQ^z0N$yQJGK5Ri7bgbi!o^Cj1>TJ%XvCc!4qSea1jf#i{5hD13i zEi3KEf?LDXCC&3R5%K^^f5YK{9<-fS3Unlz3k`ru?3f{At{0C1#k5HmM#Lcz=g8bE zk9ho%L)vVz2#NYVpZ(}_)Oo-_!*!qLsz%OK<#C@rB(Ar}g*`1u6DVURC)omO`+PR9 z&~@hG{VDo~LVV?B1DY0xOMA4VKCO%DBRXO!)2HPM_yd2o`0>xstaF&d(tO2STpu`$m9xTjL`-8v2QFo3=u{PE!xe(}de zRgLN^YG-Ww$u8tsfJb3}!4<#MsP6nqu?Ye_dlhIe$|Ov}ZYCPu&96Utl&a5k$@c+4 zHkhYEfHQN3vC4o1zN_oJvvRtnS{CnLV!K%tCV)MnOmHmR0$12EME7|Bj0BOsr89sF zmA4heD&B2xgorxQYa}$rY{_r4`ARzJ3@EhGl8Y{)_W)v+fwRmyVs|?6%~#RPB4U6I zv>JcuY#J4G+Dx0uFcHY_Pziq8MQd!I6}jx(wg^G5~t zEiKM8?`V4pg(EqJ@k)HUogYi%L?EVQ2H+PAh}4=kLew5(yz7G1x}-U5eBnlO(##%V zzUkP>a4wTbvY4CC`f>k9(#vGdJG+EJ^`*@!vydVJkt!^|Ir1%vP^hUI00J>OD+VBj z8>2HbfrZ(g*~>?F=Zz!=gOM-%`DHl&EhB@X0DX!$=qC|%ML!zx>E7i3W5mb8VvAk# z@30SzQey5hHsk3bEPs=d=rFP)hnVZUnVNoZGzC5(u7Uton$ca3SAw&3LZwQNZ~G=D z;0l_@LNSo(^zu|}ap;*RJ-;{*W)D^G?@=eCF~jKo!+Ic$#Zr2xPp8I-cSaW!}&Vvm)%l zpWBF2EIe4|6Er3a1krT_&X7Y2ke(2p6Qq^Orho{SXH#?@kwQbH|NK@gJp~se2Pt(g z2wt%w-DU?KDez?u3MlUvYGEQhOw8R5EQ)Dh07lDo-H8*CJGNU9cE`_jP7~L>JldA0 z*H!9&u@7}Tft%Zzp(YSeXoH*YQD1}wfFgyWy8SqyKR$sh@TJEfAOwNtM!^&&_$~oV z022lP)QA(X4B3I_3t*Yh$R0-*41xIp7-%_E1;YDB-ZJZ6C41WDT^{^5Ks>34{QbNC47C4%XZV{UC~W^kN6F+s)|&G&Z`O_P`rV zw=nDN^z^o7Y>&sz>TuLNx?*2GL@|Z-!VnFoz(EW@JGg0i6SwJkCDb_?+fz0R~J=oU@Hr z^3H)swWsGOTDx*ybRfPb`MXhV)}+>Y8wgpobl0Ls&(y6Bi=)o&%)7-lj$C&y27(lk z!W2cZECVRD!~m;&&awVNJ8%);An#!Sz{aRzDD@VWg^`ghWK=!-%+XnP=bjOA0*YdvAzTXx5ohzQUcuqdr+ zy&H-pTE+!7=*xrvHb+G4aQ(F~wgIN5CIEvhD3E1PHJIB^h-C{>V=GLC%0UHB@JSra zs@t-r*QGXVT`=H>dLNeZ>1mq#-%^ZU=J9>Be>KZb1`)t~F~|}S+=K!|wRJ_S zwFt)opklWm#-7%4I4E!$?Er1tbE|V5lXud52w@rqqriwjcXidg69HR!-rGObLX)ti z@D0_1_D5gKYssxI77|qSP_*uFx7&ut0fnWn?BRWLArSxq6x0A@ff`iGTvJK^3O;Wy zQvZWyr-l}Hy?XN8R*PGaSs#CkenTq()G%RDHv*o7462I%@PB!aHy^nv9g9qQy=r6A zM<;BQD><$rKepa%I9{Pt9RMYCrBnP)w){A6->B!8Q1kC`)<4Q-bSj(NOa>wD3Y`so zL1|S4r&TE%&227=&glh*iN=|92_Kn>&IuzNQ@Z6)k)8?L1;s{e+bIXkR3ixkBfn|e zHdtvu$^p`dPf^clH2j5&r0J^N!?k*vlv8P)h%tx0lHY)jM}^Qn*X z%o2TiZor^`Nw3fmh45a!<`dqXvR){p!LQp|X4Tv_auNU(MU@gNfSQ_dRt<)Lu5aC> zIUUv6yaH()RKGXxok3QV-f?6@&)u@yi%hu3q5 zc8jVEUF1Y)ERbZO>$70Hk~SgLL1fx3Qya<5@iA0BSx5-g?! zM#K^fGt@_G0nuWx*4?m4EE|$X zUZ^OmtqwI5Od;|Bw8~!M59AFr8VLig@8yII^$gXt?Rtjtc|@h0Q*m?D4F(f|2~1$* z_{ruBY>hZgUha%qT6H(MT41`UT#FfBVS^b~6@!lIgtNHxx02i4DI5B4fX?ZXG0OQl&KPx8W81IN_c2cmxn z=hv_SJ4V-#>6zFtq%Wk`D>}A=d(_9&pX`US5vDk44B)|rEtQV=q%R|>fl zJp}B}b2ii2zsCGq*5&Uch6NW)T2XE_AAbkgC9um1JZ`^!sIyv+q>i;XfV&`P{@u|5 z9KuQ6YA~hIcff!p%82~7P!_hM7nsP?+~l^OGV-!ztU#6f$5tp1zIb1n4tlBVAVR_- zm;y^70Z>D=eJY-|(tK7Z4hwNgT1JBHsp4k(fAZ!3=6_Ocds$FlYNAM#R6LTArwSGR?LjKrO0RLnjh0e~Yy}*8Ty5;*a3MG=()^ zU6;*^bU@vQ${?RV(A|=q&jbGSJVXe1wN|mV%qbRKo@X3H{D#}t(HYpBVjVIvy9AY) zsu0bsCuKTgBP@;VB@#&x4IphU0NG=AqgF#2(?YIet`7c&yhc$lWbK{Ht zl|CoNU*!Im_Q(EA^MBni9KDC=vsk(+)D_-BY17#idr=*^t4FV{)|>$tC>RQ;ML|9j zgZg@ejgVtdFz87<!DveecJXX&;QOTmdhc({D z@qY$548+d?o|2nW(`nWb_lI^uE9ktsLriCks`I(zA#xd*+>8t&Fp8{|7pJ8%HN#9dd}-6~ zKP=WRFYEq}|DTFh1$dhmX|NkrjTA(10jMfwYM5fGhAEMO0xMN5RX7?TW>fwA4>uF+ zWH2cIqN1v=XnL`{Lg9)rJsL_RB=472RC=P2smO$-{Xo|4;^2>fg&T7UV{F>0wfxA&qHV}0G&(&%mMg$%(=uO1W*hDyXZwr4(&Gflt?(9 zSxjPKLh&&{(@Vdwm?H`Lop;zN-`s5B)} z$-vP#SY)`;KmxM>Xt&y4x0!zydBD|)Gb3RJfS9ZqL?TXd2?rYrc^$z0{KQg(-7NYz z$}OOPGBNMwx1WJOwoFju?b~CBBx8(}Z1PNoTf7HQW0MZU{!dru{RFo2&fBl1eR&yA zCR@M|w-Wn5pBDS)F>5A=gc=?Cov?e!GY^HpWuNSf_ILm^wuq*1;SR6Lftc1*u1BtT z5;Jj*i%x{G1F`lGzgPgqx|^>wfAjngzNx+#XK%E74csL&URq|NA)Xa7rGlu6-1;&x%IfQ&F9_0s zE^2#%+_=r9?pEIK{+4Nw^Fx_U^Z;Ra=9_b8D_^seoatXyiSzDW} zWFgLA)9MX${KXz1IN^(XOwCsit~gNbxMGeDOJG1}ugdCmr4eM%j!;$P{msJTdg}p- z%R~uKw6ZfpVV%EOv%>YQ0<{;wwsd{)!fh;RKM!9wpH@1=)q?w;0p39SAm`Eo%9c?8gb zGCh*zN1*%~&^6HP7lZU18|peavqUd^+h1q5aAoh6764+=>7m!ww17b`gYfPRAnw&+ zED22)5RrsLnQsjo&gac=J2&*0s`o+T{1y`quk*eXGH>WWVtTtm53np5=o`f?60{Eu z@4XB}z8CmC<4pU59SUh4a<)8DzJ6d1^Bb?Deu351KH-;+s<9xoyWpaxry=lYm(5lK z!WxJ`tk(npk*-W&0s{nq3AL(*Lug99DQYlca7+u#AGHYHgPo86+_713Y2B)Xm@&l+ z2wVb9*jix^XaA49wl74Mw$iJH_eigM+RVkpxAdmquMbAY#n!;}j&fm;@6 zr;QcFv~yMFk9rh(&U|k~Lqe~kbB*zT^;P719p-oN1pBkxVgLgbNmKo$l0VB&$KgoD9gfWUwPYG9}-fWj+h`fvC;0Z$H;v@T>= zLjV(I%2wgX2lyB73p?hjc+z(4o2Gke1_WyLO|O#E6)*-O8-NRZ07muaCJMWX&{xp2 zZjH^%$Z5Jrpum6{PO^^GGJ`2xP&=cW^U0~7Zej8;y@&859L~JsBm~A`dLMC^CT`C& z6La(ac?+X9jIEU$8v0T1M(y`9Z2eKQz$>#;*42!D!wzdZN4Tq;f6Q^eKjeqKH#`NI zz?htZTPc3UN6o3i^gr&W2w82FvbLRbj5xmDXv_8qZdRNwT8OnYmDEn-Apc&NQp?1| zOTbV=u?nV&9wESBk`h8+9Yr9R8V0~;Cc7=bNP#ct1Dh?=Jgv<{x0$zB&`$WNqISbg z7-#BQoOQFSx%MaVkFhcAQzS2_UG)MFKu(V@A0WUN^x{WKi&>1wqES$QlAvFJ%>_xq zfx}b*rdvJffiSPc=zPk=)20I^YVGKN3BdMYWJnY^>HP8N&Blfu{x4zJwxB{|pM=Mi zys^$(Z&$*{D$ggMn66!Po@7j*s2Y9W|(kAj6{AsTcqk3A1w5gMdj z&TDNCptsUYBb?jT&V`3?6Vr8WGo4>5FW&)WZNf~cH3b7z-g{5a7)$^Y4xvE|Xao>~ z!Je-G{D{>77#u7h@n!4ZiGlxUbw7C&gmKKD_XoY#fe1Cf*C|ow{Zn1`;by!GT1QHfusZk?ZqIB$Idj; z2oYuwodqI{MnlHOQBlv<-K3TIdv4Z;r9V4=0=X^q<`#Q9lmC@<--nxh!~YDw>(liw zfb&85Iu`qqGM;hxtA>3(ot*<_cf~@T)jnLFQFP0g$+2~y26)02E$GG+Fr!!x0dgtO zX(_M#iP`}u0U&@;RikPOpj4R{1TZm()xf|2;_1zwm_{^gX?&hjpS*;Z5P1B_|KpCo zD4Kt_=0E<+?hiBOgQ)vm!+$b$`Z?mpny>syhLoZ^d8A$M;FDt|dSOx5;!!Q)EFpd>m!vV;_d0W!n;Fc>R zCx_F)w?TnMw6Pn$p6L(ouC#UZwr`c8~e+#WDyhG)CYs6d;o$F6QeVC zQUgQ5sJGD=!G;+HFwCH!0)>cpxA!{crnXw+;+Ocr$dbF}1Fsh!qUE0nuQSxK{_p*2 zj{Ts}5A0Dt;Z@7O-r|2btWPlhTHtHu(?cD5lC?^K4kAn>vU}rp2_(wi(D-Ezn6n0V z14tI5&H-#2B7{>Km4=mZgIW_N@-{#-zyA&Jei>aOw-Vb8?;t$}Ysfpe4M4+*+lNP# zHz8}o|9`bkyA`iNZ?Rnye_reUnY)^&VgG%OcopXP(ss=sZ*J*lvhQ&GmzYrsX5hjU zAb}CUr=b8vIm6DFVMz{5U?OxTFwXX%pMb#y!6|_t2mwqC0)rI;OwnTi6b!&X0ZdIR zFoRYFqpMB@jRUsm$LLo+<)C&N`XNQ~EWii%UFRzS{dV zUa87mc`c!f0do9slMng`4?}(>pQ|bd(HQ{@YePb z!+sG%y2P(ioJlxek682BkNXl}vj%fh!a8VHj|7h;)qYV1EeZ6U#HC74#F4)wAYor) ze76T=QKrcE{Z0Ubz|^Z@woa`n$Dm4G#YX|UHZ1Gdw%KOlBP(@9^(NDA!nrX!#`!SY z`AmqX0G}?jIITkRAG+~peu4IbHuKko{nlWCub|99)&;?}mjx7W33O`C-bh<35m6LD z?&rY5pN?A=yV!!#=$(=R%t+jH2_S@+XA>a|_!53i?bPF2Pysq8Tmt&?{#HT;aB@C# zGj@sagzV-&J;m+;Zj$BHeqGxCj_R+Cns1wIZS#v{K6bM|UE}`dz4QN<`4(uG*3JV% za8<3(F#c4(kD}m5jNxWIT%j|R;EK8z7)YQW!tZ-FuFEb!IM|>PPCb)wihY8QC6wGw zA#O2Kz!c0Btj6dY#Zb%?qug^8M}}_I+&gs{@`L!}6YtY+mP*M_G(5r`8DGT_-~UD8 z?R)GGCnDGkKpHRz&XV9&lXe&pHthll70@yyaLX3P6_cB=3*7t4WDHIGwPuGp=XIq@yFvIXU*!HpQB zUEC!>bv;e@;^@161h4~#z|=z(HmoK9j>0@?EJt=*!w0&k$Rdv{)kkQihq!%g)IZ7K3?Rr^y` z;!lYq%%4d30Ug^r^r*C+f>_KP!F#C-GHp*Cz<^l2PuK2I7BGAtaA6fzV6pBwH0l-< z4zMuJrOR#+N*tiPd*5R>VI+{j(0ScP+fk$Yty0`q$&;A7^W{6SA4@ zcc-qU8AH34nM)Xs?j2iX^Jjke?oVb$--&ibHKO)`mm2k0Z#+x8 z3CDx6jVEU6BLlA^1%40C&5B%Pc)@-mT3>GFx47n~OA7W6Q39|2x~RbwJwWvoG*ScI zLocO)4MBVm3k3iKs1T)Camz}&ZwRq-Lr@qH8{Hr#ICn8tT0Fr!Bs0NoVwrlOY7}#h zo~WyUHMf1xe4b{rVl2>2G9n^OJ=K^<^l3fEkylf!1{IcA@IuaVdZOXyqVDq=FG6-1 zk93+(aMI4}J_-lR(%9h;+Z-ZPzHEXNkHWSbzb~{`-QvlSBSkyWGQ#VNl5gJh?4V-2 z>kD_YN#U?{(39~oG{ui?%n@CUmo+0VzQjVwSVDPeJs+iT^BO(I(=xw^-FZ(3S#;tr z4!=KHMtP(7C&xce^h^htQG_A07JR zX+5&q%RaM=0!s9ZK3n1kuGW=tteSmB_T)-JhM(hLp8%z1U_6xZRpF%h3lajn2-tV- zHHi}(>-R349b{xymrmjh1VqGEu!%ZvFy1f2Md%vp3_m9vA)lOpvrWr){=XsHw%)hD zn;4~A!v-b|PsSLLx5gfPN45|L?wt2Mv}-H7?pbQ*){1iCV1D%Q_wUX}$LDrz`?Nig zu)@5Vo?eNr{?q^0@N@rqx_+Z|&CvGG-^u>FRwwl{H2?fde;xUllf-k{{_2Yz&o61u zGnQDfp6^*z85<(EB$n*jaeOd;^7REj>%ISnd*=0?g8EkTKfbZ>?|!O1C#m=)Jv}K`88H%EN}+9~Cw`sJQ*w|rw8oqtJq zM`#BcsMb%N((f+fwE+4LtSjSP7z<%ErZ3WlcARcbB@eT1Kf-$fP2>}m3*5Br4GH8# zYr7Xx0K_@Kr_7VS$;->B2Y5xzbcV3J3vCY4E zKFGD!leT}loKH0ye7Xm(;sON!i`;SL?VZnf`+sHeS8nhJ|9H^rf9~<~ySx3urav>1 z`TytQe|?(wrQM~3i5SUqJwskowxchrF!8iN7A19I{M2drmH+*IMKu5WTKKnL7yr|3 zp~qJEfS|}6KJ=ky?RlH0*)Mebx#GX0k=TL^Wb1hmZGBYsXRJNFwAFGi`AqehTrw^c zU}&$SNv!5d8XxzP-(b>$YJyLl4K1-KEiei&^_hua7Zn)+gu`@aL|UO_Hz&av4$h@K zjCpGA>u3Tj@*E&{4Av#`nC2VK^J-k__k5&Qx|RU)C8=N$8!N#ZPQE>EjbAAFk$LFI zA3)=oPJPVj>u^4H)1H1Z@mCp|-|_>W^gV{s4ZYoxwsI7lA>cScD7xfaQAEKU=T#_xO>-(2e}i~i^O)>pb3($sRq z=nb8{hIUO|Bzec%U(pEKBqC*C!p_&?QPviYh9z)e>isz>UA+`UJixC8{*#(s474r8?_kG zP&LO<2V&RPtpVII1W+TwgOk21kyHFlM98s>upUoG;w^ARt!uXcK!pYWaW}8)2&vk= zM*v`u0vo&o9nBvy@$a_yKU>BRoY8M0_6;sBa4GA9B`#uxxU0rLIOPA>_Bdd6**%{< zhF^$m;7%>IT)|Mcz#=w33Q1Bwbz1)v?arFTM#kTX zcZswwJk)6>XZ%>gUwclUw)EQKRpXHNZm+E+Hvz6kHB{a4A~JUChMO7N(T0O7Fi?=bhc)B@(O`GX zbOo>EOGTd#M((G;X@F&%!Z<_tr(-9zTH6y*(jhvyda0b2*Ky&c2Npo=E3eMW45m=D z+A*&P7Q3Rw1iM29d~z(gAGj|pJ)nTqi{HRsWqdRhlYC!c!x}%)E)w@N2$QeO;jQ>m zP~n$2DtpfnhhYE^PJQ`n#@T6y5PEeAY~e1eOkK}*Vz1Zq<3`7(|mHNa7yqjXyC!YkCJVdmx8lDGjN&9K=(((gU z7*hSK12FobA$ug1f+*OG%gW+Vu~>A*dpI}kqeq$!Nc5q4V1~Oek{$<*H@qT24zpO= z(B~)qG)g@<-ShK+_>LJ|2Js`PGm1%J8dzP|Wy4NrhG$O(mtN8S1H5U3w5FohqxU$E zw`!G|e&OV@Sm66?imHBwta`{f9xZ}j4L&wNAr>O`CIbi~jBsK308ot+!BP}G2Ef!i zfsQ^R$nq+NLyGZ{)9^a=M*z43%Ddqm=6;j6z0-z7{*r<&F4p2OvJjd01~YAtjiJnJ zH&Yxc^$odwl!>3m$G)7vKb8K4Zh0No!fzMbII#vSY zK$Nc(%B757KCB0*l^XyNQE>^&>oib@JWJ$+N>m0~lBAv^#-jjdId`76549qU9_|s# zn3MB|L_&XCOdtkaWbLmPM+&GSS_KG$%#j6#<58BW?yvC{phT_#fl&-dSY)-x1uLhA zoGMlU^~0i$69SodclVn8#Y`c8lF>OR`&?lFx{`<}AR;jOhA8W2gIHz+F&xYKZV~JP zfloy^8MONm?Gd>XK#Ck}Az}D+_&F+5g{V>)tNU&NNT}lPr1R^5jCdZ->HRCyR;CiF z000*}K?ssGkh}u-oVI4o+Ra;(q@TSbW&i*uT9m^r7|aGm79hZsG6*b6!^UrGhVEen zSH@=m1#B=#Y`PVftZS&LfdY9Ug#fTVbE*_%Avopc$2_`Tt z0!0+z`$*svF@$BB?oy_Y4ouv_1R!xxApnf&NvA?op$ZYEfoWh3X?7A6p`HOUd=(5g zX{%G1#**9GXi5g7$6-@A8E)@r)yn~SbRdA50yqLw3NWP%0x$yELgJvgxm>1YfC*xP zSTeek3PRI!2^v%5-N}3}Ptc5zlcMwd_w19T4nP0D2`UWO#D>0UbEY_N=0<@2F*Aw2 z0d(WljSJ15H3c73J*V_Of zebpMPNb3O1QYN|SopGx)ilqWLFgDMCfdH}8%&8$qBVnv=Mi(McG7FHuhze;0GZP^P0D1U@k*b6c0Lxm#0gWbuT!3mSY|A#K zO;Q>S?9ea(YELHb+861@J@Gc;r^&wiE6CuXS{>Pce9;Cu~>%qMVS_q7S}MG%`MN3os-bi1D=V zMUwUkWHJm1`UMcZ9~`IS$_)&|aX~shN2z(=arg^vq@1=%qb37P5OonAgaT1sH|qfY z7Z5Z8Jb8TWWw27s6ls81u=uPbY83|u2PX|6pX6V}ZqQ~@5}=@Z2808rOiWZ$>5$$? zfXCtlyrU=ICndPNtz7apiZLWdQ-)jWP)qk>`apW{FjYa9iUMd2NVJoRs$K$@C()pQ z*g*XNX;DVaT^r{f_ch=>dp)_qgVW)QmJ)`}9rt2u2x=!BOcm|(!yUD<-0LqicXt5@ z5RNQ^z?kiHbj)L!OqujxQlX{%L$Nfub2j5`0~ulRnBv3-fF-hkS5gM1Os$G~hA`=U zLGJLh8OixzFHlbl>p(3Q9!G*Ituh!KB;t>6M+@ZBO*nd-`uQ>5KpG6x zz=nKWm%S^%zg$2oQ~Jt9Y^Qc&Io~I>ZWcydn&nC`TE2JH>AL*x4_hC zb~@yQ_aJCvdO_DN8({|KXAAu)?j+&>f&xo$pe$hmM?faC211A%ACX?gkUKwKZGcQO z;Yx?$N~@tr~&h^X%GQFpAc5g&kALi zIKcd`+)db$mBfG*8E_y67buGaOaO^n7xA;?o`)DG+7VByZ~GuJ%=91Iuo1d&97 z1#qS{Qa>d1JBb<}uXTvGOcH=93P1qp5L6AG%@|d03fFU~tAok~*E_lMUOR^)O%+5Lg1Uw*X|RR4T{u41|QucmLtGau@V7Q81j9+xDFj0BzlwNmZ;!$75t&045K&( z_d%a014k2kDB_cM%s4V>B@yuzJYHy8k%&5@Av8#ey@*Cov;c|LC@q=Hx4n#?`_L33 zS&{HIVGc3(x+5CuP|vN_tvBxc?m%oa{j5(ttB46t$t!dg4_5c36tcEC2ks?9k2@&k z*(we-m5A~qgL~|50-;uI^-CrgDv<2b9!@~p2IinENW87|sN?fMDobj^T{lc5OM^mf zFN0|>o_}itm*&~zJ$A+=jKqL5aRGh<$qr?k% z_24xdBl-uI0o9~^%}m^{dqokWvSuO=+P;Uj7fTNQC3?wHNjH~Z$;xfLe((l(y^W<( z0|+-*#Vu>kmy|;(gSN#{Q~|XJkKpN32hUQ;8rU!p%}$eTvsIQmve=zByC}OSySD)B z$UsN#sM9M3?SF7L1_nX0Yd@PY=e|e z2@bQEXq8a!;xsRDc+7vM@`MrO1I!`h(Tbk+BZ6CwDB8;G=?HASE! z)1SJIG3X;Kv+MvTf8%ds^M=Kc-ehrim<>GxqgM2Z^EM6Gm)SgenvWO|tix3DtX69_;;B==-q!X0;)m)ObEF&g$&uvP+PX@AaU z74uDR=5~mV3^lKHIR&T+SV)}UKoh4Xa!jt6<6{HdEU!4hqHJ z0i){PQq5$RPI`Q-vC5H73;>psc!!SsNet3J=flr_mdlA$q}7BPUD_1vts^Pkw>(e6 zCxcV*8pBM*i`om1c}gR85o*Ph01*)+6euS?SQ~m8EBGl*NB3p$!Vm9FbSa@g&>QXg zqXD%v7$wXv2zvUlpC|;Ffb06FUwR%hbH52n#}XXy%v|u0#Sbo@8Z6%K2#rd-p=3LE zNL}$aflC1AP!a$^=Iy_(c380zC_sOvbfg;)EY_=0ML5_1OTKDvFun<-2C`8cCAyin zYwP|Yys@N9*e94T^yR0uLq47owlNiqIO@a!(tV>4g_>o(6!a zewyBkM%z+eiF3OXwV#556I>T)VDG(bVRCX}aJ-Jm>1I~bkz#s;Y;@QNi)X2xHS+vu znkGclY#(ISOp}4pX!aEmR*hfMd}lu1Q2&U}u*VF*cmMGt{&eON2mefCtK()KfysD4 z$4{*2T6|!t33}mvh0&BzqQa?6YXsf6=SaPU- zChs*bLxI%UC{t0(o!n}67;)T}z`XlWGMG+Hm~5JSF9s0+7jL$Wv`eD!0^im|nNwQn zM$QdNg&}lyBPx*%NRU|^8&*U<33=U+KDVBkNuw9U2kBh4&=+;4@oYsK%_2#&yPG#)XRcWC63V?A2|OB5XVuB5aB?e~s zUq=%<;0ML%t5~-*Dg#~G-(mGfmkVkCQUOejNS0;m-=zl(0J_Wev9c@MAULO4J*~hapohiEulNcU)m@&c*Mx_S z)p9ge9`xkymlUy=WQL*E3{P<}T|qa-j5fj?ng>7t$SObOUCV|h^OBCLe2#I9>o_j^ zuMC0Ytu(xc02TPTaU#^WzpplER%@)=gCJR%T#ybsL0f1D-cx+O5Xx|QbzV2=9R7GbvIdUtfu2pvR3{6UMC-%|Nj+WX|bZS|TD zdj8~$U)vk4PZMQim>p=$Y-)KV?ciVg(~&|;J8?kKaSDNSRW zB>^BIKtiGwe2Ou~p7PC>?4w4m2iW{F001ID^I{7H%mWzF#;7b2RVn#vNAq!O-u7hZ zn*aTi2mR$I<^wax;8A5k9WTW-#IbtQ;2x7=FaWc&+D$J?Ko< ze;3(P)Q4i3i3KkhD`1O>PuG;p>S ze|jHFFv#?1^mvspad+IVE|oA7uKz^nJ80oXpXcLu5*o>!d1&TcRj*~dNo z(tX{v(_XWSfug7Z1NwH?d;3=f*ZP|DasV7Y7<${^dJ<43U$BK5DaTQ&`pO&GXyoXcQs!Ezpe-w}ovWGPd>>|SNfE~!+91pT zgUF}s$D>ivct{<$cq#9_QAY6wXx+Eq@$&=(rtp{$-qYy(B}2=rVe7T&?6<5tzZcnG z$~|6Y6y!te@Oh+M8`+zhyso+^@pec41(Uj{MJT{8tU2r>0yxOO-XiE8KMe zk6Qn3kiN*Ob@J9PQ}2)WVJsyhk{%?g9yPee*Xq(g2lp7;DXzB!M<>xZsv1BJeD!^s zV~Wn(h=z8;o0!W?;^w$*P?4Ai<_KAihYN1EU$8Z-Y~1Q_Q#MsK zbIGJT`R;!jPE>!IQYfmPCtzs9IN@zzCcvS?=!}HhUAhBz-zd~%V!;obkd4;JP_^I2 z1upwU)a40V2Q(te4f)d4nJv$?xM)@3hR}j|yh6Bohn!!p7wStb_U}KC$6{jEWmUbr ze>AZHgB)(1H60Y`gGQx@7g$pe-~>RVPa-_%M2QG@jkW&W0!*t3IJ-6nBQve20!A5GW8Ybwo;0mm?GN?l=?DetG?3dF5kCN+PW&A>t*y}*% zNO2Dr6Z06`hMQsFo*bCn%5DT*^meRb)xwcFufLz;rMVrC;!K}IKyWis=q+#%BwB-! z2}f}TyO^5 zVM3D3Lhuf6Mi7YjpnSiKy1aCNYq3ek#BGJ_@g`;r2#jC;*N^w9W7t(RdaH|JF^DLU z1~6O?V1T1K>h(3um0TiPa*hn>?7s``)ztY>TE>M)(B;M zJbfJE>DAhFB@a`X1dujxY=%#g(XCt@Sil4kp@Aoa^W@Z3&PxbswoU@hgdI?=tBbHB zRKUPzXX-57)1A*NA8~_81sk)9LPFPhPHmfyY3d3zC zE4ESr7V-`78{oH4%4>`ihH2dB&0)uF?Eb7cI}#Wk!(e3h@Z=Cxalezp}`g1sL^=NMM<|=t*F{6966*`*t`h360)Z+c7P(QTWRG= zZE6W%nC$b@btt;%bd7Ki;P!erL#sw0-Own9^N|2R%}q`W6&1Nxw=l7UX*mSsW~6PT6Yuc zju%>|EN5tg(}+o5WBUKG%=9ThGs1N>(H zdp{FT!>-&cvU}Pt#Q;szGow`Zr;u9<>mr-k71{7r=2tTIvDKi$MILNKKZ079{5IAL zEwmN5X+DgT1;Jr4ZI}@Z!{H)H``=rAH~V3)R|%_xbR$-?AV5)2ec(JM51(@0)cCSZ z@vY!TDUB>w3U+?w&HcZYzBl{dt^TXY_agp;iL(hK+5|OM>pFi5Esp|11+Q3;>y~Il zfTJ|u9+8YI?=#gOh-pl>YFX76bD7~Y2tWYHhr(+yZ}h_p)^K#^cyi|;LYIazSS5oV z>Lyx0hNT`k9O+nlAKTqw3lzGe^%gU{2@^ldw$FtR2YDeLs6Pqg*~o6U<1~IDw3dLy zf2JQTTv%g;2UsBm7iYRn`SzRqpYQVX6%N?#&g62^ySPN4F#_%sn36N-(lb0IT}Ig%n?hoKGa&uCHicf53n2dFO0-iCp)BDu^mBD9-#DyFkgrK^qBX}fE!pp zcuW@`1_Xc}-RJOCDyof}xsTh7mH zYWSyaIM-vo_d6bWOaLp$Fp?9l3x$>BxvuM$x=%fks^N;g00Q8`&eP|H@s~ow{v(8E zfsAYrnMA8%l4Pk0hfnBJRc^)_u{bl$Ju(;n(mG`Us`jvqyHe72Fv^Qa6$Y(3QC3;$ zn)2Jh%#-U_bBN*+0MIS6RYDpxEMF)NGj?{P7qQ6DcPb;qDWVLq7I$<$pdg^kP@KSY zfF9n7El>k+ZruOD0$c#b1At0hE6)Bhdn5iU zkFNgdP2YLv5YGd)M?}=kpv6Qe5Rsb!ib$Lgripwc#TeHgFuRM*UpZ{{>R$UiA~D`2 z(ZyIGp|X~%mcxS0G@jlo@5*&!L3ih{SwOOEi6cF27ENfZUn*mAVn2nc(2muR@y@}i zR1R4Q;9f)z^3T)DIu>iFTRugJuun;|teu-ocfi84B_zWNen8!UHH!%lf~<(eTStV7 zur8Srkw>cb4WByK5sQn~q;SO;@?0SDT<9AH;GEy>BZJGDEy?ooAgBOI2)_W)no`XK zn`MVrlqH6+wnoNAn8ZW45NKVO4|Ro!{MyIkzxKe^cK}B!1LV0LO*MsH?$VUrAQ1sH zUAGoV#@{6LB5uV?fH(Onv=`g})nij)gCP`Z1{7k>71E+GEEqkna;_4U+#V^<)}oDI z5a%$a!9i{yYA2f;#G#fUiLXgLIYil@13)!dGE%DfWs5TJLDLjWPZ``|v4oe|owxlr zgbEP)wLghoh%4&7@IULTu0~9dHaP z(Ol3a>1EP*W|>=b;E3wL&QBpBrwt{R{)&89V6<9F36%N*;TWhKk(b=PNx*G@&6EK$ zK*}B(L-L}@9Bnp7czNazg~gY^65!M;17mS`DhaY4LNU*#70^y$7>dhEved*ZYql&F zUn82s!0r@N*bH2t6`}*M9lq+(Z-4(GUH+eQdJK(FCo(8gIyV z`ymaTJVOuYTq`;M`>VSaI20{Gm@wqtVMiB}{Ms6+nLSoFG3WYC=Cp)9ib{yo z1MygiEs>z#|Mt`-&aj#$?(%H%4G{~sC4d(3R~7yCN+ouTF_V9%DUD{wMg}+mn&y#t z%vi*ZI1IJS#0PMY2YCyP`js@+^2EqhMJ9#EoP;T8hwDr`Yu|Mpk8q) zrJy!S(P|cjZ2$>D$Q|^(1waO<5Uf=UD>Zk0E)V`w8)8j^F+z72+}caOz_GKwmy}AB zBN}&aAAM)Oz2c-92J;Zhnl(LRV2P+jC-N-DSY|Nu`XwtMO02ZU0g{y>rZ7nL7=D`3tz+cRANF?PNkC18~p)Rpn3a3Cxn zG|)iYpPM{Ii+jwb)~k6I<00trK-%CI-N>jxm7|2~`=Y9P>~m9cow) zWms*S&H}ig84Fl+Q?PM+9NJb1{uUf5@G62gh#xG;J3*QTt2>q1XJLR7@`Y2<1pBP9blf>R|7F@?)K z{WA7iB^(|TX@R$&JPWWz8~~k5oyZiFgsVmzz!R#`t)wqLX7G3UzWgQcpEr#99-#z)*Vhc0b?F13Z+<3Fw<>Mpb0pr~%dIxFx-0P-@S}ik1~6 zpY+);90Dz^Teg$d*amhCsUq$>#&QB~DI1?)+5o(cw1knx9CVC2onDUokmk}RU}lNa zngBS`KL&e1&b>dRwW6}m{SEK1#VIMp^vKtNUYpp|o;YR>@e(gG1|fNvf&1h7YNtIP zyZZvX3s@s=0UN-MsLGhjuYAus@!=eNDZ>3<-?=7s?#MC`wRwRKH5g`L#OzB5w&~{! z;@uJXkTcC)%=B&bExliq0;387(nAyxutyJ{$mOUl;#2Nr=?3e|u;`<_mVfh{fiQ}q z0Fk0K;@~9CIXOn*!!Qb=m&arTds#k#NF@N23RuN~Qf1o!RqlZ;+Zn*LbnNRFy=)Nn z8m(-51UHTZHL8CLPxl2*oEMG?-frP;0j#!51su3C*Hh@Vop# zQJ8<-Ow7|5#3|D}SXBoMxe|Ue_VaJsR2fR3PV=mZo~O^AtPUBcY1YnpPjN6NV7uRd zS82XA0*QzO6vRj~SZu@g@(L^fuz6D2+p{Jq^VMiCF#=Dz4-*=!%vErpPSXwfmg`g;mJ~AA`;4LXlbnbbqym$K;|4lwy>k{kb8u6=m9RVqM@z zNEg=?eiNsMOMpeK!X>|cA`RHYul{mWU?i5J3BdokxRk^>SXeU1Yf7V?)P zrPu+uODs+=cf0ag{gNJs6{YLqdOuq0!GNp^mPFpSJ!-IqVSD7+W7^XZb-LfmDh8@F z-O{)+d{-{24-vdc0j&L2KofO)=zC3ao}4)Op(M4m&@ zI)V)eksjSBL>|>0M~AsW62NzhC6u5cHA#N}TXJ67zDA!BS8dC>CqN68DsQ7qOTL|k zVTLn8@xi|9Z%%4f>ej4ru%=W6cy2h>GotLY_*At1BTFT$3Xwf>ox6mdDIrZ+BC`wT zk_$`+1!QC`^ibuBy2Tc?PohA@Ffs=(N-JhK@Tak_U$u#hwxTau!;#z#DC8!#tvPE8 z_96-^T2BFwa>;^BD5G;L#rvY1Tmh z7?86#fFh|~l6_f^VgMRgC2oIiEx1T>o)&@$wv`z4i`JJqhE8)(dBq3Rdm*q3p^BAJBdHpw$L zh0$PlOOS!SZJipo-8<)S?!1J|rkK}H5@;eGAw2B*2M_C3{E7o9>=fj>m+K1Gder@X zBVR7N-L8O7O&;&L?*=fEruv(%)EU*bfh)h=PmUnv;j8&D!_nP^CPYK5(q#M0#zn2Id&2^bZ=@y7dTCv-X2k+8G(_$ zU)<+ZBc4A9_u|EValC)bd0~i4-p{6L@fHQ^Xz*oKE2RVB~c^Uh~B;NibN-a>o%|N z^0R9MmVR|K!Mber?22bjv@vh>r5IKla7aVKVxwiYIbmrp#?UmlHzOZS8n4wMKizPz z6)2$=5J_~9ZML-}1%XY@vuuSTN_eX?hTPgYx%`Ke3GG$2P8ftFKuy9Z(PHf_@0P+v z-INY6oDH2yM9r5T4cLR_hu6^(fN%iF`LO!d!dGX4V=Ys^PaS7L8th*-9uJfV$vK|W z=WCdcwZbOV8y%4-riG_R1{hnt>WOGxnzk=c!l?IuV4nfT+v@>)h;W2-Lgi`K-Q@c@ z0M>`^ywl7-n@Y58q^BgBn(NSWdGY)Yp?}a6p6AWOW5-Z-uKGpo6GN%9dt<2tDp*@p z>(qn$aX)fJ-8#Z9ol9*3Y;b$@ryhTQ>o+g+`cm)parzSWe|QCuB~O3~h+-O;vM{iK zkr)*(?bB>@z&%XKHB6WlA~hl44T0i<23s7^pLr3OW(h zngEapTz%1+ssWqQ5f~#P$aCOyEHjAzmH>Ubs*oB*P|k+0q72a=Kk|r|a(u&s_KqNd zmGt|l60MX$D=oK!RcauB09rt$zfVNAnF9ulEV#8bakNuMN1KL=#gc+UPV0ebyZ|Ry zgrSJVR^Qxe`>cumFnirnY$;@32_rz#tz%=}E3&nnCse(>i`!XL+z^S(x8|)8Zx`yc zETLMCr6wBploijnM`YU`G>zR3tpHA|TFx1VUfUFurM+&Gw-K8lS#OjkwyA_1J&cAi z>H&Rcz;M>~<7bZ^KgFD^HZM>>KqZE3OA0AkGm72>8DkI*P?2+v92Pq()#d%>mC#=b z5|k$w6{8pg21C9%2AIY6(~_MAcv)@Z?AGUmYEmcbbYi)&)01o_150@9BWi|%DK@c< z71<&afxpk~?j68Qvas@Ipg1kBxa)E{hK(O8&C{OcFzhLV7YwHZ*8yNgI6IwHIc~c` zZriU3Y>y~cjruSY8-r0cPbrN5TgCTE{&&EC2gMI?%DLfB{r_{Gn(9j?@(0wL~_`MxQpM=qV?0Ahn^=#~Jdz0QdgrOaK}s<&HB zM!(tA*UD~^d`6|IOf@D1TQIyrK=9f?+uUi51fhR*VVx1j&g1fA|NI5RtCxG00|f^R zpbR`k^5WUQq-qca`PsPZ6R%O|0`nTtvgNe+xZf-?GR+uyq$mgo8=JF)29zaG1MHAW zOFQ7XMigq~9pnL6)zS%>J#-G2K-Gj262gImJK@=+|2H55UhqhqQKP_@$U7p@0TMj* z^^B&{qyUX$1`~A70o^tKvr6ZtmSw!{t*lSvvkGT8I;M2A>ZoBVkI8Yr>M1aM&mfk@ zn+rq1?D_ENli=}UT2b5wQ(lw1=S^RR8P1SLV}>S62hL`&NUe$X-_3bIUd8j)|TyiktPt|un}JV#_9Vq*{rO{;O6x$OiP1_631 z`&$C19&X9hPqyJC>B1q%TDGhn=_?En1JOMPcMy%oWPF`T4-mda) z?vTTjXO8zI^lMk%6F}OvWdg)48mX;y0D1B zdmYF1F-&$DmBE3>3*n8$+NXCSIDid;%X4+TOeYT-q`YvEbV+mpm;j{q)FK!J^IfNsw_MN^}e8D@}s zno}2U>aJ1oX`rgLDtX$)f+@yv0GNbeb8GDlz8R(TY+b)*2 z#w7nP1%v=oEd-E*LrbM$QK<~Am-g}-q^4emRwN=cb({o=-qINs8rTiwN7)Dmo9iuz zJONtq5fr~+q5t?H8`R1UfCNULb#6e0zRc^WI>DO3yNoiJ)`i68n#<(T_rarDpz_&) z7lLD+r%gE{wmQZcN{BaCtD(QIE5AsCb6ke;S2Yi>5WC|Vz-L|e^3Smdpdo&ZY-*GE z3B<{tI5$`Mm+R}caPm5Yt^Hg-v4n#z=O9_Ls4S-oHk|Hr*VM4L^uKY$5@R~R2cHrq+#KReDpS6+%Ayq@=No+ z`iQnFHL~4Xj^$A1?DcrZo?~P*N!vnjnX4~t2!SBbkca8pX)3R2IU`mjGez(-r8$0a z>1kMYv{ko$-c|#utSYLZ2RUV)N4w{=*IE{uwlOi|pNI9w?vcN_ogWRqquenSxIQP| zHd(nOUnzF?flUu?a&phDaC?!G7Kw2oPx*Me=l|NgebZyopJCitqmO`srv13D^Q@n< zu1^~HM`2unufZfhRmz4sYWe95VV(BlWNe6_GEkInNK37drP8LUPS3N@q8V53HX*~) z35G&IYDMcr@-&1zwQ5@-NKGgSfe`|qaU9(` zmBwrXY$p{Uap5nMYP79641vEa_MlWjmo!)*=E)jP9#jW(I0&d!;@ZL`5EC&CQOSkY zgW3kBdy1zzrsIcUmg#+7A5JGhiD*W0Kbkn~HTCPEln7`ztWxG39l~$oRXvPloHf@y z$Q(ekL?p|r#4rB5fB5O=c)v|K=56+V-WCBf$ziDH@M$KR`GrPoZrhoCV`iuki`}kW z$|0_6#lNC&&H?nCOfz$!= z!L>KHnBNrI@JX~OIAQTnxfx$5#KVJAPI?)D15_d^`5;AZSQ9;|p6GMm)l=Z&0AnN! z%jLsrbi@WP!`9LS;1m&(AthF{nDK`@qt20fSp*8O2~9i$BU>P`re!P8j|XcW;HCm$ zNX5%hKyngSm_$c~10YG}*F<3x0oj)+ty z8xEkdd2d*o_#?`C;sd(TP(pYIIZ2t}egNt!-hxS7N#GtXhMN$&0LFtk_2@C~TYI$v z9ALJmo4@I2|HJP;4?q8G`{SqW&u<=(KH4(RJ=t1EYjBm7ci8LNdaN+4xYiS+Gns~! z@Igad!*PGiI^Lt*$B|P3Q0=D53wVcqJ~$_Vf`Fuv7e5Xrwy^37D-~6GJ?6OsBrhp zUJ7?P;utB2b!kw0srw8oL$c!}L&sAz5920|Lg>3lZZGL4gG%1O_tW3*Tgg_1C=iv+h5pd>_vG zzc|<4%TN6`01Tt4EO_R5TJDr1wOyy}Awoz!rjtNww(o^)eaSHHHT5DeFwZ~D{H{96%B^jul&`w zSiKGR>E@*X&Qjey;`kVVI!QDDD3(hH7>CeOcuF=SGYwSqWP3y^+IBhv^^^(C>(^*> zwybdGK}HY}V=j<35@k5}oAY!D{5zw(z>7PPL8MYfVnPdr$D4{%KSOF%yLOOd{o6^<{K!g@E zSWdVL&;byK91fk~Isi6MV;le}g{hnVf0+DLn(6<5c9B^;#r96R)xlVd`-b*iWEN03 z4(DJ91&Q0o=J?~mapQ5lGL7RSUB0LtT^-Bu#Gmi(~vskl2+iMKci5|EeRnQPX( z(~LW98f(Nv7M5!9b)T&9eztg-88Pi1m~VFv)|QB<2tYSt7~pJi-rNs4*->qY$7}Y_ z2#$p{FR8fH53HZ}Yv3R%Sc%i(Wplm-f`By{3m`N6aX@R4jW~;ORONXY6ygjD-Q`)Z z(a=^+NtU+J*`QMZMUK)I#d;<(mE;mJpBJbAm*PbNsHrQ)>Y70yPy;3q?10Lwh{J>| zz~nj7TD^5pf;xJksUYS1&m_Z`htu#|uBoZZo@0bfeF=wTH^dBwkz^~D2#7)|XbZam zqEAK_U?K8N8Y9c;aoxU(32*{#%<1J*gmz+t00f|2Fl4V$tllljr|o1k&(~moiOL1! zfx#8z4!VRK;dA0(6qaESqVRzoa;&Yi=$i+CP0woiwEV?~nNcI&Tm}+GFJ_<6?!@KJ zM+G}f7c?4MWby$}Hw5~ufeW;9a19g7ufciQ^O!x63v(JHNq>9mzV5V zDj-?AgP}jzL|$c@a2oXR?MX(_E-?WIx zL%zPGtCz`O!a3`8WO##)*1XT9Q8>W24-K+ZP*ZK2Zs!&bzP*DmyxtD%6UuX8QCyLrYkZnk!Qc(n)3ML? z?Yp!$()&n}PqRt3X_6CI8WB4I^9@7{oXc-lY+e<%+|#Xj>Osd#^JW23GBF5&8LR`a zJS<125PnfB`XT;2n(|oCag&ntJ$nPgIew6VI0uJC)hY}EVFC1{HWd>n zWk!gnbw)s?_(Pte77i)!dEY(($wWTe%X)pW{upM5NqQs@Oe*&TB#Aa6PXSUw;TS9w zcNb%yI71XJ7~U%ab3#ghnBNT?dv^nrl-`SMj)0nHI)-u2;MLcKDRGU#=3XZQ)L@jH z1JwIa`M#+F+sEOUsfjjFL{#uwFiikM&Nqjx(QW+D1A56RT_Lp_4LlUtN| zgwYtO;=Bbdrp=aSA2p&yAVeZD8)#q$w2~S@L?eZrTxbq;&2|GMeSOv$agOL`Qm{ro zuN|U_MTqURIw2q#gELt%&q~=UkA`NgGp1QQz*shK8ye@P!Oq6FI|MuCV@KR=+z!LLBt5*{od6P31F zDWJMslgxD6K*!j~zlK1-5{3%YVK-nN4!nEA^jMG!B!KNIW!!Kp1;m@QGwb`%aczz> z$%3Mu>n%@dFLFP_&Lyo}CDup?08fgEijfuVyr~|vN5Ay!DrSZl=pYIR8581 zc^egFVt*awJzZqEUdwI!fVSOWovt=~BoMYd;8si2(T2yp$PLq>A^s5MHVn)cJ%2r$B6B)cu1?kKj9S2q$;|G!MK38k7@TaP%=$$qOr>R9(3Qh9j3q-uB#l>#Z52OZwQWph(x!sC*TeayRoyRf zoX5wVV-Us&3B%6~l@6`Y+CXK&t|L!8`xN`*kfaGcE2&yn$D-V7l#UArhSe74BN2(U zA+{n|SMCbiBO3j$Bq-xle{oMbQ_r^T=6D86%vghV8qzEr35`<$#+NS!Y=8uGM6N=$8dq+U({i_i#gAOaB3B39_Zq#~-!pjuz!MHbeg?NS{{o&y7ov}vC=fo@@tN`*KThWx@iN=%*Q8IoG(G`HnGEVU zCqPWWtEj@JEzeJ%MZU@g=a2-H3Z}G@$ZGkaN0P>-(c*T=`?40L1(elUlvi96Q?7?i z!IzsY-lu@^>=-&un&=rbb2K;@($D?oMK)8Ly`60BZB_!KvLE+=96l&(Tje}Ug8@@p zTEI$&R{N(l6inNDol9P$mI}_%`U9kK+qmwrS4)2Jr|bPQWCoO%6&4rKHJ(jX?x^T`f9`ZL8%k$5fU5(I!6W5C#Ga=a+k&# z(Q#y3iQiH*5PN>JJUwyM8QC4hP>&&W6by)AVu18v?H>D_LflA}H)~|fg z1@{Z>cD?7**T1`W8MUh$(4Bvha44&n^zJ*c6uO9Z9dfUXUe6xs&7f1!0D}MjNOZ## zPU@!z%SXUz8E`4MM&^C!+FsL|#<0EADicf}3XL1ii=gA!yX(or(QHa`Cm|C*7 zVfOKQ5Eqq|n{z&TL}T+&!-z@aYK%~*oOSNrj~{z1t6JvyTVmFnd119PYz@$$dW+EF z1lt6wI{gVC*M&6XpRK|CX_Y=@{wSKKo&v*FrhHw@&8m{bk~B`JEne+ zG=4ux21|LtuS`3Pi}6ChjE%=4UJQ;kDk&)Oc0XjV+@%;(0c|@pJ#mAP$~}O{eS2GJ&@B{K2r`mI zlAcd&9kn_WqdBoeFNPX#tNpcfYvNA@Ku5KvW4PAYHfkkBtO928_%W$oCb|vXNgHUB zS(pL5>pbQOy?CqmH-~V)io;$?CizZW4KzR6%Q)-1erT{PljoiK( zyRZb5Osk>aix(R_5c^FSK}CUC3GX(sFsp#m91@RZGC!wlCeUv8?t)usjyXF(0aO+P zk&L3bBqn=77+8765h>`?5g$&(JV$DOZ;Q=hrp&mmsoYM}6eCnBFK=x+kueussd+wL zx2=tVUBINZlsDp=_bA8VZs#qU=QBw+K4R1kV@EWpNcs|%gOyQx_Khg+F12+a7qG5- zUsErmUOIQ1w!CzUt^M_o$~9O^J`LUC&PYE9k<k ze?s*LHwDjRGo-fFR?!PWx4no)7n&QAw{#*nnyAEapr!$XG65v$`%MR$Qv#$2L@W>y zg%MVPDtqI5fN=WpsWqpp)Sf1t27M|O6wt1NDfD*hd0G}V2IL!Tf`&r`9u1prk&^x- zPyu$X1i`E@w3=q>6kBZmHp4~E5eZE?utTg&VNcEg_4Q!fxb7-QQIT9hNMq&qCrnl{{$9J#|Dl?)XWH2|G%@nQlG$R6-a(!HP8fO`E8_GJw>_-q} z@J)_I41l6_#DlI!9%qp2Mv5`FcT+l&M>JrGwH9j4yeQ(IA#ENJlid3N*51CDM1z!w zQ2stlwA;Help(h|HTAhP4pZ57t9>E-C6G%x!J#B~=5PrDJ-ldkR)smiT%};?;xf~C zjHz}=ZH)k*i4cQLIUqRt!SOT1b z$%{CEbMg>Cl#vRBNG0DsTA;8o=l3$OT0O0@1kWnFK20!6Wy9jarn*?;si>6;h$KKw z%X@Um=mbtIfq*{QmWq zsg7^f%J^TJzO8vI`2q7@r^0WwgNAimElT1RabTSe z&$<+Dc0>#K>keFR@-@b0(O1{&4WNwqXr`0a5^==eT8c&VJ?;40W_rn`4XKEB`#^Rr`K ziVOJQklmtGSDUJ<9+?d4_ISwHK4en+ zZ^7&zZ#4zLoDhJB1fWs7oTUL*6FYS791#^2!HdFnnDg}e-j%7&C<(+6Mip4U!xTw? zz%#^<D?e9oDIq^F8tydBBFJ%}i?`Z(=P#Izg~mCvK1xye5lL=t0OO`m%2>Zx4qt zzvRL$2ibK>!Z6=zgovB-PRoW z_q%Q1`MpvuMOy2oOk)pZ#To}0~p4;&sd^FBjJi%UFijHT3R z$HcDe6mCKg;^N|dDxjXL%^zFhx{{j;=}=NgvtvXI9pC2ViI?YtFap`dEPwj4(xY6T zU&kb1r@ZIppZhhgpSbTQ#*Vn^dT6kUKu-!N z@|O+mGq7GE5&HyhRjS7?VG*y`!GkWD%19SLbj{Q$gEXtnpc$=kRiH2zS|q%u=oDDw zAdS;FjCw*L1CD{)vf$?ILNfqbySk$^f>cjFB5}2U0*c`gsa9^72*xOwO8_aZg;4jR z)`O)I3k3!QWbh~x>nM03#nb~1wKx}$BkN%qY!24OwWhHD-W_Tc(n0n5R%%dJO&1>}Syok9p1!07T0IVA6`xF~aE{hy|5>^hB)*?Xac-Z>RAh{ZC4 zA(Rl#0!0SQ9;z)hCr-p$#?9K% zSAEPIFJEI@pEDRh0ucxi7T9t!8m$*FHn)xYs`_Q&hT!BTczbyRUU$`{8ud#K!51mU zAzfBVHmU>-s!re;0wIw4XgxBP`8exZE}@g}CU!UOgtFT4}G zK8|UUgM6D&`}3k8Pym{*&?cV5TEbfmQi|41x)$B2DjF&SGl(n%onKgXYXFRQz(gCThudT!MN>1CW@pA%+FozTZ?8}fHF&OYl(wVz{F(~L9B{6I-p#PaUaf5Sz- zsf0uauU2doSs3ClDM-=+KnP|iL50PMA8Il09n3Qo`bOFSWUo?o|14LzK)C2stZ6H> z2RY4?Pn+DQKpSEt-NbGeQ2Bh7O3?w@d!QYW0*q)xr6+Bwt`HD&?8j9+oG)>ZBX)Y> zTsLQ_%h)R7VgONMs06#G3ue*4Suqp37}T*fNlP|CrjzNJE|KpA{R)8ya}MU15ld5w zF*d=zyU;TA4e+iQfKRxWYtFLL^GridBb+6LT5@a(ZVe1aTGT>|QN3tJlOC`&gmedE zbKGKiK^&TCKCDfz^Ew0SJO(Mc8=T;sLBOQUvK;UL&?*iojPu`vWjLM46<`Y=X=9Vi z!l7v9a~H^I%CpRE>drLv7#9T*Q5>PxCb2{rfE6r*SbgK$tIbx_I{&=&QtKr*M;l!_ z)L@Nhya>pwHtOL;hqT}wVZcE1r{yGOkp^>c07_(2FJ&tvPHp6EK%v1E3n+PCjEOA` zkViySLj%5`Hw&RVAX-yG0PUq3hi0cRno2)povwd2P$G-fB0;?HgB+PNL<7pL)sF9u zS*qI_pkQmolJ@S*VxR>Ow*87GmJIPT1QJw2o3Rk)WDFOqS0vKa1sJ;GSEYv!y z`-0-?wD%i=De`SJ#LtU@U>fgQ_KmXcT9?DF02;T3B+-Jq7$u$c4Sf2G9qh4v^8`CM z6DZZV6d!uas<(*!EXA80C%_4efr}pOwz-V0(6@PALzmYc!ys^K*N2T@qWcVvjL9B@ zy`=r{q8o&Ws%{&@P|K*Ku$aMs(gkjr&vgUya%FqYug-r^-J2Zy?#BXzdwI9>y5q^H zK3F#DfS@8gKPhjet$Vh#GQ$!|8a623Azst8=11%z++ahZR>%9Zrt@-EdLt7HY;irT`$JWuFd$ST5o>bO z)>>zcaRa-@+g?2eL=}7iY=Bn}OOG$vy#AYyTnX>_AWXj3nI+9rZXLVaqw@)O2CwDh ze@we7(!%c2$l6>`&w?tYW+y*3Kfk&iFDkGUh31%IivlnXue$g0`0{=t!wnL9DOdgm z($zP9mM&WB>AF@}Tb41b+Cx5RA-e)~w`vRUV^Qva3Bh6*<5IA?feJ^AZ}3F|l1oG$ zRbzd9pLOYkfj39;Yqx~~UDDb0aUHc7871miwMqbj6tY4yAXI=}4Ak(c+065&eL%&yjUG$O18+h1CSrv{(X3=!Tlhu2o+gEO-b4cIU9N|(Tqy!CpE zYqfrgUa)|PP)c^046hYJquge@+Qe$ zms~FC_>s~Z?c!q)B+Z5%Uawj9@8TA9Uj6L(w%!2X%#+6sh>?|Ezo_vgZ{doFhyeG6 zk_l(JMYMd4mVo{sMiD4LD)Yj=!lmGS-65t58Tf1^P#UUM31w_|XX;AeoHlIW7`a=v zYx3?~R!k%q6_}dy#9_@C;$dllDa|THERGNkp@4u&+}knEe{-$`0K2ZcIWY09 zIgvWG^iy7Fbp}nAD>C%T-1q#xNCbEl@NvL(z#D+8iQav6=BHm-=l-)hWVc`OV=L8w z?-?VN_W;lOO|YFF+n?sH_xmx}b+xUlakbt8`+ch8xP}1`1R5~ztESJSNFtc8N4;l& zn3=3-YNrOqjzV`|GRnAoxl|tOKE#JK6PqIrXHhg#tGS)ki%yrolG7t30~G~G5lbF# zHcM?{p~YDmn=IAd2JG(7Pb7j!?xIzEh<}ZJ3{+`ewa)ua)E@p7GQs2L{VeTz%}l%AH-N*Dl&@)Sx-PSCs$(@L2S86_ z-8l@fH|FkT?#$b=9k*4n70=}uLT2@=B#K>@Wr93l{*pVese34)z_&Y_wGCr)rwU7j zK;4MSKM4w@U2>WFa*!m;IMCE{RqjJt{#F?xMjuBt&at_)iJ<&3RX5Di9v-p_P3C1+ zBHbg;%>&x=+yM`;+)4EqLqm)LvX?H7v=rC2=$=ixsP9Y?U;;Fvg>6|XX^I#oi)Uy= zrdduTfeHkW>`6n0iuxOSK@0unI8oO6liH}0PrKK^jlcB~Jk z*Q;d|$(4|zNw#KW#(Ej@uIu~$gkCu)iot%A2qsI;*lXpdi{J$t7;*CWi@Ath>#Kk_ z)A(!2`8wb>tvgKK0ld3_Uq6;s;2eH5;B+|Pr0a0Ns%XAdeqN96yI}|eAT0-IIh%7} ztuf8Qd3uS8te>0-Q80uMxpcb7{kKPvD3Bj^+6&5S8{d74aNn*Cz->y8>Z70AbOmfZ zmrTInnHEibN`i!{K}frW%WOs@-(zkP1u51tK+tOA@H$}KTEm#5 zfCqN=SFfS}+t8dy4)yjD^Rp0Khs8G6&sQo0)VZJ)9o?#w&&-evT8Xid_K`;zM44$4 zj)-d0HD)O#b8hP9Q~jphTH;Ae|2epU!lHU5$^-s z1KhpX^2Tw{_0Aq}G)1|$M!B|{-Ogz5&fVV1&ULEN1Kv9bM-UoSQjnU}JCP&A|a614$%2ohI&gnU$=YgJCW^aa!CxSYd_6 zY}Rfv7|L615{Ni#U0$uz$2?KGhAEa^1$u`Wwyfu4^tofI6UD~aHlkC6T69#@ikgQ2 zWR}(F5T`%>{931v_A$fvDVQU~6okYDC?T!xL_P6qg)*P2OBIk{JkZHDqGJ>o2GYVC zpSl7IQkkd%FrzFDj8#vWhqqX|d*XFm&q9a%8cH-z%G2s^i>do=d^)DzB8Uowa7=1& z{Av&zxLtClDWvA+6E5C&A|>_WcVZsfEH{39;r@$1biEws%MSzYtUi6LqG0*^t3MiW zoTuq3_(YDpIzH|$XjhB+8*AqT=qA|Dj@8N90>E~}fHX)9Ic{V!ML-E1vn~ymUACr# zB_*YT@XOi z?)dWR-#^6o3sUF=1X6{*;Qd(LmdQ;Jy$Pp!L|63wNs2@IZl7j?G`qBlbh9>Njm4AM zM)u9`B65s&lZq`!fLLGxW1okWkA%W@n;_l{-<^eX!Wb3MWX`$ZTd*w*O+1_=)ZGyf zcV$d_Y_KWHZprnj;Iafo1e9AlNBb(lW1yJ`AW3k8t1S)5X}>f>{^FwfD{I92K0}If zs}eBpo^DoVM}Yf9n{P4MO1kz;UHEu&zculBGyIj8}P`6cMHtj1pfAzya#xi zyXj(M(^Ca(hMI18*-9jg)GXoK_{Tw#RIf!KKcWB_P$Tv2(lLt6Id9EFw+#iAhQ+ zeojv|?fKSV&$jYtJ7pUH>wZ1OE%$EhWj^Nx+TVhu&qYwf0~Q09FLFz6s9wzEFaw5m z3XoVZnDC%XuqRV!LET4kj1jW93~8AR$PILLi_~k|t|m9HTl08wYcr`_AxFLUurj=9KZxF_3^@XA03*NFF+f9KoFmMI;G}%GdL*B zUkuWx(&cM_TS#{RZvpNc_*C|#|G^vFpjzHbShe1^UXCwO9Jr#m>zd8_W9zeh&vzz! zd^+9MUGLS$ALR8%ZaOBZd86gICp$g%@{Te8r7UpaO4QB8o5~-m`_lVy%Y(XyOA|0J zGg?RGJP($M3x~rS4)@mhutk>^5YvS1Hv97GfSMQyYc>TOdDTVo7ikSQPo|fVRP&7pkW^S zBsdiG0Ui3*B*Zi7DVYc6U}$mcxFGJd<5-in3Sl=Lg;{qoA1K5IY#KV`0o2DF*4S2~5kOmXE3o^PXAIr~50acJ zGbVur%09ybRx0&ir5>81FJ^1S*oGrTBynPYJ+YnRv3qekV5w3z@a+oI_%Ohhwd%~*94O}IGd`LN0$iThC~U$iCIA-4Two=B$dS~A|X-W`aM2T zHanyU%^}Br&z^jiXHecnng9XFd=;!5!tM>nNP=R0dV8S(EcldpTWjlmgo4<=HJdTTpMq;c*jgV@fVNe6cHnmxaFMq-6 z#YH+v!YWQDVaGs$LF$D~di3Cd1B$NAK6d`Sg-}G$MQSt@zW>~$Xi&cWvVPai$XJF|J zAz5~RuHC`12_Sblm!+UUl{{z-twY=X?~%$nou)r3hbt+iL3qbsc~i?;}~YJJ!V>)?PCel1yY| zG{#htQ?j&DT1h|=+V0+YnFdhH76mYeoV#S`7zi-_qiadV0b=M?j4N4N1zQZ~MKCh! zq*;+5%B6u6w;Nz|pE3Jw*t#OWUE2haGWJe691By1qmzRV>tSHw&4~eCH^l@TZY|=x zgOVyYi2rarcqu~O>+Ow}x5h5xCi+xyURw;~z{_q|r1{8OKb@X6FrUF%<#eIC+6IrO zucz}}^VEJ+P{$)967rEwUCoUA?Jj}c z1shy1B{_h?-V4zO(;cmgHGQaC{eOSp|Du0L1wa8+1-?Y&5Y9`zE%7ctyj|CV#V&2I zNI{>oQS6T8ieov9X2^o1g>78TaI8;RzwbR!8ujU`!{>>){{1z5OdUIMxW-U#*E61c zcsV(-&DGfASprCar}N2j1nw@3*Qu2ceuFkI+Nkd{#R2r2044K0&0U8vktD}yNL|J= zDPusBGqF`pNSXD@2_aX62rP>uqzY_0H8J}JL9Y}!l!w1p8tLyPK>0AUOF*mY=4y}n zfa9MB^a%a1B#%$3p1SW0fD^#^$dgYVXrCu1L)q+Q(5R1j@9XpW4V-se-!$&#!To9D z{$)37&x+^Ui|7z=X12vTghJ6zI!6N%fmREAAwC8Mrqq>?jjbY2Bd3=I z?T|WpS}_JE65-fFbZ`Jq(5`auC(ZlSBn)X4fGUT*72lk z)R|)asYAwh1A-=vW|J&2bQ7LwhO!9m&vEg&N{5zbE#W~c=@MA& zVG&_~9ffY#TyO3+6cqM%ha>d}9m0mzYH;#8mVs51W*@JP>f}?~%<-yR*Skj(f4PUCf;MI%L!m&IgJ2Ob=e1op=aoEwJu1;Y zNQzkQr8%XdHDcN~^WU~R26LT^drMNaOLZ^(qW948Zf-|DzNFTPB4+?l2d^$9Ln+bh zHeZP8lBfM9qUstz%mRc9Hu+67;1_3{)5ZrU59EP>K)163Fuc`O4=@1wVf_X(*aFVi zV{Dx3HA*#*#)`JCXBHnT;%T#?tLS5ZBf!ZS!-tPVI_rvbig41iAJXy2H1Q^-#3)3b z{r5ftdGy&u*_iQkRwVVPwz%6Jmi&0r4Htp||6^xXcu*Omuv zgeXAn!K;k6=Lu}id%-mvBXP*QALCI6CD`eJ`8>@CL1!CyV%mVji9{5g!M{lmu56>Q zykhbx^HK`MC3hHmQY;UM@;{=CIO*)QTgxg>)ffRuHRKiOexH35IB(`eTM7JFKMnC}q0TfhN93QkP5#xYgj+w}zo%>9zRTggcu9l&`wP2t)f=hj=q(*a7F}uK~7n5R};Dtd$`A4~5 zU$!I+hM^e2eH?xpu%YTAvn!u>0X0w^V5llEx{yGSwpw4`Qs{*$hxE+MqC9A9j?HG* z0z0}YJ=+*)%n7lYU6l|i2}XKo3*yFNU2&~^sl8f{m}n6ZlI}>2h~p%lfB?e)aFCfX zy8DEwp4;}Yu}#5CPN1_ya2+B8tMXt#o0hB*`;#pVT5*q(!&a5sonk zM}=vdKS&nRv8a?`OvH)p$f`ugYhL@q|GmRM@gMK}zx-Ul8w;;Dq#+aO0B+Gs5;20( zwmr4iAS5ES17J?R4UO#_m6aSYd&r?D!<9`pH|yq|a2q-mD(VQqK$x4#V8~rG$E^wz zVt-F+!88*bYa9Tx`d>yq?`GNnU3Cxda*2G8=HDVvU~DUfafpDlUBXnJn|CQ#W1A6H zW>@D3#pVlO4(VgvRUzgL+ZcpwW-I0Ec_iY!_7zH=8!@-d(VZdEj6Dy|?ZJY97=&Vw zB)h6E*Zr(&oq@Fkn|&n4pIhHB!dkF2wi55|2iz~uT!E+gg4F9?!mwk4pW|`Y1>>iC`30?_vZC{ga7kKZ*6+_Hdk#MUi)3jAn zFSoDNZ1LY{xZ+5q5KMTx55t`35;`*7f)+nqPBJx>7M)VQAe59yl}Q3$F* zG713}*X{eo<|Rc86%)B{sO6P;1(3jcvKdy2_uC^vZ{F^jL)eyCQ|NNW-Lo4zovIOr zLMeLXn*=Z?j>m-plZ{|Z;+1kdh9v{qsEk{@(_Y#fgF>|wwWgeFk?#;skq+@SFj}tJ zM{X%oCC@}Ac+44UP5~I*#JMzzv<5%h$uO5lIAI;PpS6nGC$O({n#(1XN|EudTJiUk zWCrrmSbw?#+ndFJmDxFYU{+i}Vb$x_W$Z!T?t5|S) zo=frh$;P>Xaz}^{@QxUZFHAwFv;a2VdyzM^%Gz1H+ix@-+TNeYvFi`YY7?7|tRb{z zwX&J;lg>1%U!k6ZXJV$z!E1aO4XwqDNnw4N1|)rxWiNLN9EAx4Yn5)oC2 z2r&@J5>vR7<#P>&VCrxJut5I;@ZmVQKr{cvF&3OMN08F$aDh;(I?dFgmeZ=}oiV(8 z<=B&X8#f>bzX>ETI*$T6Ch!rbK8>t)HP#(K2Je)~S?)$blKtUS_cY&Ewt~Sz3w=?8 z*W^1n>uw5F;P%QiKu7Qid+3+63x_z4{XUu|hsXF6Rz%Io zoB^s#2B?0dv!xFJtS%kQrBf;MgRofYRu_C5RzoZu^MlWFC}T+kKz|8h0!BKpeukRDR{2u5|K+t-+OS102&VUrj^%vZ>X5jOcDcgyPkw&)$<1?H5G;fe_r3k@Cds! zbTXq-*XwhXspfHr36iC5C~l;V)wj90y5Fjm>%NCTf^%Ayu~l=E~?T}m)Vo`?pNs1nHJYFScJnp;>% z+o%>HEjhA4sFUXaSwN=0A#^NLw9VqazCU+xAai>RRn2?Ayy(pnjzlHj=k!G3LW8k; zWZY?hp}zTZFQY#(<`#5iMY@qJLEPm7y&fX z<1n%1NYQ~%TOR{ND3QWEKR-H)kE>GfAIqaFPunf{JK;IBlw->cd_?;Jo%1F5@@4SN zZ+mC%r7RM-1h`%tQE0$bYjFoOrHiRK6;G1E(Ge^g`G@GX&>Xf4*8}bVbsv7*DKs|F zt|;#`J3z0~~EB^x}24T~;wx;t*p9#yi)(3tt~8MmU=B z@^`UY+KMx39H#YRfFKYI>Sxr_Tp)m>e%i?_EZo8v8@K8K14t~vfsy*$j;vfDgj1g< z*1p@2KnF6)qzAnvGl7H-S#&aRfb8ka(!P4G%ZNHsl$JBnndX72nUd!QYWB&Ds!B*v z3J}C#n%2-D4eM(FO3VVN{4x%|&wbpZ-Egn-0@v32UX#d;Jdem5Xjk*xA-7*H!5Q~` zthkDNf}S3dt}#~=t)YoFT0gftUiTRi=Z+pwAaWO7?{Qpp8(>3qS7~P@abeu3hmapT z^`4jcnyz;6I*5Clyzi_BGXJ1H`W&d4IdfzLCxUbvQg0rdGN-9k-3f6kv*qWWP@oSW z35M!`N90moG!PLGm`zA4K$it$# z-LdmLNS{vuK||8h2bS(Lfe>QD|IT+)(2(bEvE?9Md>D z>+-|s?%J^CivR{QU<6DNBLHhapP_dpIWIlJ9N|OEqJUA1_nU_=D|WI5hcSse`r-b% zNtyHL^;BIVqK*!a2qHkc#bnEU=Q!Bp^x1Z}QQit^)zYXa@O`a0J~@kZ*UNE8Svg)mLz9Hv@Nf0GL?_Na<;q;Ssc_RL4tUSwbaJq@<`9NDGAju*B2-d|3qBGl zE5K!-ZE%9q=Upu`8=WR%!_Z##j+xjxmgqU+{$6CL)D^~_O#%=hMC>NG13MW2_8YFP zC`bm;vbOJ+ZcPA6D1>H-0Sui1JEYAc zVDhYbi#c2~^d>*GjCm)iH=ud-PLB*IJSb(|X0loTpZHoHQ@u*BC&sE0(avr+xkThz zBtaAwPInz8DD#LKbsU#?z^3iVOK~t#w8dgvVeAp#zM4Uw3*fY!sg$UwXC#3k0H%!X ztWH_%KwtYyC^Q>@L4X+;LhWrC)GHIUs;v1_r?u;ndI8H6!`ETIvC7~Va`+=WW$F7bj(HJoRw z9Vt-yy&tYd(4Yc&9FHIdX+Y`_HVC`0h<8vTsqhobI`(`#QA5tx6Iq%zi-uq?b;-bw zqOal;-2;ivBdQ88<;Zo91DUxzY{7tg&>O)|GtFQWk|%txcEB$C{x+l>W>xLH>6XBz z-~>92_1Ov5AFc-vPE*Os;n+1v7AZqsJvZ>UvqR;4NKESx5U{saXh}vCRRX4vaf2w{ zq0l5E6dC7WMA+>t!6;_;gb}gp1_@Y|&PIEqg6uL%IzSJA9pCoxQsKB$UVfRvO7fPV zn{t!Mb|J=##w4b5yKCWL7y#9_@KnfltGAA4 zS*UGSdf1G4Q9Xn*O6jm;oQA;Fp|Jwf>D++>JJaaGhTYOI9vbU2X>&~T{0k;~e{xuo zQ$c%x%|QD^88oOBtCPo@_F6KhlE4C(TtL&_B(Tm4)jWcQp=xhR29|-wgOXQIkH&j! zRBJ(Uu)%$Xkpg zqOu@{9JTWZi^-@pN&ylCA!xX0og2_Hv?E2DV77%X1^9{9Bo^y8a3!p4Zg)$>g&93B zUqWf+vr4tuy0UrOQYMnRkyhede37s#Wu4KZ01Xldk>ECuqZ8LoPRYG##!vtQ2*d~$ z{*NBD9{~_0fkNWJ0-=By9A{r(uf83?u-qnr;$T4So@ zLGf#)?q|>vCILhcMQKC@TUJdwoOuydt1}n*l6jfLRj8$}bFQT6%Hn~CA+-n?v+QY1 zU-6xE5lq~oS}g~w3}aO~qNQLZ>x$84)idKvJ#`xxm;2=Ldds{YJy#rLBn80+{l?cO zCrStliPo)XjX+{DND$0*1%P43ntD4?f19XR))1{*^bsI$aF8x^8o9wi*v;^gjm6XF%hYuIe>{s6>8^@RAV$N zvnFJ@*UWEscT!iKA{@ zyx~CNipB>{PK}8dqf^EiRjaHDMo~E@HqeR09wo*5*icbm;>DNVHgo)>rTzM*Wn8Bn z_AEAW!G;3|N1Gk0`=vzz91w^_2G+yPx2wwPyLE7Lt5q5VatY(ZYWG@>>#Aa-OX0k< ze0lk^=Ogf#PB%}1dHZ~7g^M~E(@t2{J3=ct>`C&aXtY5Tt+}PPc&n$4&ch|l;0x@j zj{S%L4ZdS@8Pgi8)rn*-Mi(ZnATi;GGDBfzSsDw6YDXui1nG$T*q+8NSh@i<#vB9S zht9t+Mv;Wu!OjjlIEzk)-ZL8lPMIuD7UDi+y`=2r0k^Fmc}sIjc)~Vh38@h86O2&d z8|2Z4!8D&1h%$hPPy{RWIC10Majw#`iUEnS2Z#Z5(uGKd*^pQ!jRykqmh@bYdmZ17 zYxXlu^>!xUMeS)vQ;No5r)Yi|!6ArSkBwR#fgnKV5`8&d^?GFc_E z#2_?H9*3yRuzA@~Kf~Oa$}5=;)%(i1<#O3^n^(`gQS_s43?cb&k>t+gpri@qQHATl zE{8b_D31gX5h$N=m6<;75@s{j>gSXv!bCm+^>x|WA2^4ajP`h2GP+5!*4Pe3<6@n5WP$0k`Af$ghyTCIG^`| zF6+g|*4*}Y zupACrSUw1ofFJ5RC)={rgMd`YWB}#4hA7WQ|jPnz=;qj6(fbZB>_0@Npr>I4v|?m z-%hL>Fao%eJJtM{XDNVJ_>O$7+<*hfAE|d0x8OiB0YJQU?#sXaqy0N!sDd#*T8%AZ za%D3j-2oArl&n@_!4t59Fa(%TNK`s#X}te7#8SK?TSnFBGD!d!PJkLEVb-H4Bq?k% zr{nS7uKTsbn~`RP^ziaAcmJTt^=pxnX3D9byK zpXmM{ik|xmLGwywIoPaz9W^ltylZ|3E1xtS7)0a|2hj{t*Z(iVOA-_c1)*E>9T(of z%SKO}WEO)OTi0H%BfO!Z1U14zI28{+gxQ{+w$L>D9uD|NsBqYFLmIzkd-0vJVjlWIIn3+X}=CDR%6t}UmQ9KX!RM`dU$-kXik937K;7rfN=49N25cMNg zhLX9uOM@7NEdZTFfO^ox$wp*skTxqeY*oNzhtYTjINOM?9T|tije?N~03sxd_4#9u z16Dx41-%|>F8?cZ4oh4?!8Z%m*w^tw4mftUJ*1^S+vV0IS4DuD|G-ctkf*zR=b?* z6*>!KAZ8fSt0zJj&>207JN5pMl}>$R-PIoH47k3 zK~Hc%%YD0-!WoFqD4imlU3M4VK9mopxb!-Z*RVzzAwU9S*R$z(;mKT`mjikteI*6V-c|Czb00YN{?JqA`}d2%sN1>sB*Ci z?alWW9ceHPnI)Rs3=&hezwZ{9z@ocw%ZxkoFbx&@8zjpRa@6}V{&^|LlRSk1H0Q)o zTUF@{PEgi8pMu)T?Np{#FDNhaBg6k|W>rx40WwfxHE*O>pZBx2X#tpyqjoHrE9OxB zi2(F(pk4z@tiutf>axn6?+#DlwjgiC(enoV3}~kiwu9MsZ0>ww?C;;)xOYg*ouS8a z7S&|7o;m?UxOpWPO4eMl!N1(%t;KD!YvQ0;-ti(E(e5{oq9~i0&S0TbAqmznBH0|r z@*2ylMQUu>K=I_x5S{`~07nO(?>6rzP4VnWXp(h?0oTNZ>4&Q+e&+T_q0}$bxG7-_F)52BS+cXW1O#0ygUqP(iH!wk*9SeYE`@r2;0J-PC(9(z ztqmCCj*E^t2zL5a7Or0Telz9w` z?Wd{o0Q1bZX2qhbX5H;J&gjFKNF@fc(Ci&-i&=YO z!l`1V_!AFpkNfO8osG_VG{LT9oBPQ1Fh`yeRP5v_CtZ;R2muPBYE+K^C`KXF-U=(V zHL8g?E*5ayCt!T%|)o<^d#&%f6=#1y1Ow@@m22akDz>Cw2g2F3~o(%{g&g zVN31J&7k~XU@nx&JYRMs zT#nB>tLtUY5&>2;AeF*=``GfCm<7W`dzU@q#C6XR5tH5r8YQn5jntG@vY&#E;2Q!E zzz~g)&oNAq#Yxl**+6#>eMMeph`SBuFtG=+percrq)8`6vjO0zaBzVPu>;rlNJR7s zg|LNCcD>nTKfm0cO|I+0)49Mm~BidsB7KVnw2TwiC8cU?y-^xh#6WVa@xb(gpWYnwXy zrW}d63^Os&bkZc{ULofyh4<6F`AlvtT~!=)mC##cV>Q8M%SJAROYO&SK<^1y-_A6F zrP+rT*oT!7Q`gNF`D)&Ljag348qVZ9dMdYEPNKBdfxWu4w>w%rg z_pu7jm=`A*m$hMSi%D6do;@X_tAtsoVt{^}1LzWjwY_i1V?BfpOhE!QS%NPTmpH=V zSOhx+B?b{cU`QsPiUEWDIyXYGlXM)T5!jh(tZvd4+UvMgX++NHmxBy}uM^L^vSZ&C zjxixJ%E$)L=1Mc@5J86lv49J=5{h80kxtomL7R*YiX2L+Ro{*3pUA+#zYgz@^O`7pFEY zpVs6y7tz4lj}r7fA4n|5_~_@qzi?=*s$Sb66auomxx|0QeJyUrO}_s6It_Eh`)6M_ zc04|d;@KH1R$oBN&2qCNm^S7_W>F-RF`pPQZ%^}~NmUjUh3mzSxowybxTNWe&3a&( zIys-Y1j_o=d1WanMOB!O&i2R_2Z{oyQd_mK!Ke2RLq1Gif-=BqaQH(RN_XG{+Dgm< zd7=Y2@Y>m3O;@T4zHnHqns;O*tg}IY9QR8}t!>Ei)XpYb&}HJ}<_LrahE#f3mlgTW zn+;%K%7GAy^%x&+YRie4+CNvlC+nvtbZnSDpGQCu`=*Z|;&i3Mz|5#B1HeP- zi%D%NbgF>@6RTesK_`LFMOS9ez!h!_O?F_rZr-) zI&Il$p7p|9A7bUIL(^L`j~y@DkZH}l8e>1p`rZ}K%Ytf|dO0Y{0yyYjZy8^DS!e(K z5-lPVp#CPTvLR@PlqxI@TQ+o@GPnD-7tNZ#Wiyt?*41TfKzVMJ@|^?}V$yy32GmGD zYTE%G0@hvU^*h_M%8?�B@CMyA9*o0H~InJ)xdei%yNOL-SUrYHfYIK6alU+Q_$( zUro9G%X$uP)_?x`etzo@3yoh{^7gZ9-~R80dtWGX3BokEdReg28)%qi2=7r(Rg5x@ zUHcoflvatZP`*TI6;)Nszv)ot$x5V44%%70)iyBYYSR>*ZCU%(C_t#92_DSsQ>IazU>+IKWYHS~#;0CW<<3QE?^`acJaIwRooPH+9rrN26#!*U5L? z`mJl;2O0&Dme+Q?g~-FeP2?ZZ+tCbn{SgDjslNd-Z=x#r;AID$euwJM7twM8^@zknkNW19$Pgqq@EZ0+uwH%&1Fi4!90eYg;+{9(PA| zS0FGv%rG$00`6TqD!A7rAaMhy8`~2>zZ?^_(H*N|1(}(bxW^mrcIh6aMN9=yk`hI< z?qSOK)nZcHzR=G_zMh2CHCFC+g79rUKD%er8juNm+PAltgM9+1Fnnft4n~Xw((WlN z9e1RPNcW%HmYJ!^E3Gr&dh=(IR*h1)3#pS~&8$}QfEZw89?{*Lb%TY(Wrg&0?72E# z&ktR^U2W>tzR7`eD%?jKCQ|zXN7rq<@v*MB2j}lS?A_Pn1qrd&T zx+PBAu0B(Qhlr05pWfgExH*;tFk(1^3Pcx(y2N$2|4{|sJw1Nz@c0f7b35a@xYxRz zyW(Ff5Nm<-$J{Bw)|I&c1ATxbu zr%shFsErdghj*Z|i(weRpr{UzGvqqPlBhT8^M!a#Ra8Zpdw@P9w_L>DC49(T$a1x4 ztY5a_?rIRQZl}J8M2y$;=G@EGxvilpmSF}nJvAOoR+mb=^RarAM&A|4gPjlEv2bPa~*4iU1e1%Ch_KrHH>KS03fd4q>X*;&#v zi61TzAIQlMwi@mP8ZdKC!VqWjC!8?GhjchYxL^~x@Zn?X@f~)Qyjc}UMvZ~{&xYuC`3TBWG$&+b&rgDOOp8`~aJL@6FLxo_*)`X%cup0rU5 zl1n9kV#m;MuLW#rnzlFruEh8Fu2Er6EZ3&)K30TyxvN|&>nE$0w1W)J8v>9ebG*j` zB2@*2^<-MF%Ne+)KqF`Swy|~RY2ARfMAE3O;NS){wViM#=Tx?KW_;wj*Kmh<%n!`6>#c-I@;KHDX|DMdDT z0Yk0^f^b zZ(efm8PGJ-Pmf=I*8Xm)FfC0f&ZNt!$*p|Vg4ud3K;ij@q&Vp>$$tp5Q#yiUBdWF` zWC)1!pwtXSU>9B?Kmx3@Fe_Ffg6O>`O~=G)n|%xW5CUa<%rK5&OR$In#c_lF7 z_dsVCc^>tHojuce^hP~M&F(YX^)o0tMohF-fHHbzo2*oB-t#0fXaztXP2HV}{As|w zT?QU)40v?LA6$<*w|%TYEZ1V=tuaGP8894%ZLVGr_;$;$pRcEUOx^%Xt->>@(kVxK z8`{KDhN#UZq(}Sj`-@X3SrUD!9D$8=$YXyNWYkbK?uaF(cpdt7)}FD=>}x(Zuuo3S zcHXE8FyTmT-R3xP(ABpc1Pxfkt1~3i|4*6N`;sJEB zk7ngS0_5~WMNR?o4>sKE<@NkC0rD6tQ|*6cG!rk`Db31c4#LZ+?*_pZ>B=Nn^2$xKMGz~C_X=V1!0uK zb7sG>=lCAqSxtT#G0&6NSHVj?BS^QJsWTsU*DNxK+}9-h%?9XC)H6{FG%Z-)Cf@pgvM1O(aMv zO1OB~-xH~gQxi$b_(Xv-$(%RT)$NHJR)M>-b4Us41)4mT;IS%+OJyH z^#@oEIl|%N*BdFedCR}wTYp%jr09UM!(DMJVo5{4Zwo4EGlmi3s%2R|V8WD~64qPB zOW?1)L1vm;RjISfr05VBEHKwq-YZ=CA%2whF!;jY_BvjIv41?3LB zMW{iF;8sVZwsD*t6&6^)l$kQEUwi&Y{OOvs)-*=Swj+0$$DGMb3G}+CqmP-LEO5@o zR}3$gNnm?hTq{x{fVsD|9W0n(((_jKFcueWjU6EGbc<6v46mdD<1Fpbb`t>Fn5f0j z5ElYGOyAeLmvZL1_5fqa%2NLl%e382ElU&2kc#%>X^+_wdv(zLy+sxof>G|liO`=lEsj?T00;`6D6lwM zm@(F4h`WXs=chdQ;y(V>7-1FPjtOd2ld{L1-KUMoj&T!Lb^zSds{_*kL;8sRDwPTY z3oR@<<9@L&bv{|;p)y)nLND3m(%fp5rh{))PF&dQ9E8%POBc&8H}bHkNo#0S^1g}Y z>-{$dgREH}Fd2$)pJE6sj;1-XSGXef8`fjx-@3H>KUE(<-;8!WEGcRlT83j;GaI)t zVL}fW9(~YJuR4sNP=KN+vkzNB%(~8xRuDRxjA&IS%?%<&n1KZ%6bKOUA`k&@YpM}k zpS8uC_F1=1hr}Edy0QO=X}8B3)~=yb4DU_j`+9@Ci9$B-(c^ zP~-;-%l>L`L=o3;TlBs$-x%VjK@_rA*wtx`7>{CB8BK9k6)O59O$DzP&hNP^27tZS zkQAsI`DjKIOr_DTv3Txznb{oxB8FqR97gB`x&ZZid#G~OVw*Z+DUVv1>jLo#gm#aN zj9LiMUCqI{A*Y$;+S=y1mcob-8NkaC^r%{tg;&Fx!}ovUGG6@Y5tJ127_D&$MjEY5 zR5mInIrLtU-SbDLr|{)^ff;xeu)-3d6o#i{I9{`JVq9KRR7@@8H~ zU!%y~G*^fAJqkX#evv_p8UzTriFs+Ab?s=y1JZ!>!B@sx%NRDMG;%;z(uC-pz?q3H za(HaU>p7`9eaTO=BB|7MV71H=&XI?5*dYj65lz0mMA6W9bAn}{3UHoToou2yRglZT z83lm63^B)EC!$4LL=3`qaQw87#7$TyhaqXbVFBSY8Jd z!RXoCe&H-yXCzePP^n?yT5ES6zkH-WTBXJ5>1YWG_(Dx~O50P2h*zgv;|wiO27p#Z z41;4NRCEIYw~TfM2@oyC0g40ONrKU8S-rT}b(@8%)&F4%e#9@V`n8TEwCus008>%= z3uJxYuY1urJ82)Nihu}6qC&nzRA7h#1^Z3U$z^{$+xypv>q!XHQ(6=+f(Fd$>bJ%t z2r+<~VGO)Lw^XfGCuhEea#;X8Wofb&0tAdKbtoJAvIF!iP>?H|RusKO$XJ0m-)la% z5!Nr795jth9>uD&S4R^5(bWl(gVMBnNalM-)m^gVmV=Jj;)>c@GqjTNDwoO>Xr_xG zq7{t%@u01C*l;DQp#i;#rN&>d*CpyG z01N|0fee-m31aQ>0&vC_BS6I6Bv*jm6B6)Ciz^@IFh~_oLW)KObXipznAxd;4KJ|K zxcZg0s#%~i0W5XEE*0`dIlxc#Pm609iGK`!eEu-DtD8ZE01mw7T0g)6G zk(gB}RZ699CNbflv{q8Hg=>SpMVE(h@sJbgwr$&lRsd9oUWZ6x*QAk{-0Af>NA`Zb zz2;=0`MMwg5PUh|Qqm=e~qq6Od=V!uQ$RF4Uh zX=zp_mry8Y+dQBmP|bZjsE=IxBdbFof$#f-68z%440CACp8~KOxci_k{8-+pE3-E=`H-vBeri1ps`Nv7iu z5cy`W_h&f@e1I>u(BtKoBYJxFFd8bCImpRpZ|jz3wcs)wTrVDPAJ5Ufs*)s0A|jD8 zYG25W)0jz#-?i(!>-mrzJu;CA2mBX#0GBT{%;3^cL%1K5JF63cu9sMIy=y@tp+Q(c zZ?PWlHWsy}SYYu;o!2%G?eQG8T*nO50j}$Uk}#_ZbAIGDTh%NbXwLb0(RWykc0Zt5m9Fw92f@FhIaQYT* zTpFlbCQ}V0+i1nD$*!qP=Nr+)Q8@w+B&B{pw7ZqRi=LIF76DG)^SUTgBNz`7sIr>` zcipw(F+h^uHK!JsgVk*~7(K5=inc=`0p3KSQr zx4IsMei6)K2c|BRxmVDRUqJQ0hECVPejBY2XKkD(-6T=ga(6X zG^J`_E6x|DdCs#mx07DKSgvCRfI62f!aD6qOMKRNR^6_m;kkZ(d6kG5Q@UDIhM+nC z3S5%Q#sRF&tU^O4Yx5Bz)eG;<_gVK3%#P#W=!$&H-1u&={3av-NdmAEx*+;>=5JeB zd|W4NzdU;UYoqU*U#;8pD2NspXmhKa&J37XArE1QQknAkYPEpOs^_`+7s!+hWe}Fp zkEXE)GFx-WG~hbcDn&xuq&;K}>2Q(60ukW3rA|bHymC4(7}x2Tmr2u63_DjjJMSk{ ze9=WUAgY5I%nQ-TOk=YzJT`|;_8SE*5e){|HXQiZQIrO~zPFi9YSBp}eB zjqs%tb8f$=`tVQpm(|{{ab3@>o9It7K*lI=AQV6>d60|+pam2Gk*}Uq1#W;`M0x65 zzG4c$n%ocFbfSmypmTXT1`JuWgOkyc1Q~+B1%W~b(LngUz&d_sJ^L2zv7sw$vPzrk z=ala`=deU2xTIs^m{Ux(wwUZ_-4xMib06mt1&m148pkoG0I{lqr8BDUcLyL$X!XD6 zu%nF&rj|GfcDJ(+v;iGQ0hFm&0zh?5>pR&(pM&V0FuQKadVoVke-NN$K6ulu(6+ta z=EqX&awGoOxmh8;LQHWS%AOxc+KI}wF(7)UX5st#cH3tll3O2S_$tC}0OBXz?flAH zD6V)4+qK~?0;IcE9<8)Is$JMZp-=#sio~ESV<12S9w@4F7-D&K(G}u$_0mLk$U6KI zij09AkO%b7U>iu*^Lr)E4bj&j@b~o5x||$Vql$0a`&L#51P*h^ZmOmTTkFhDvJPai-XpvG*}m#CNN1P zfkEYfSSfAUG4Q>pmd)$Yvg(h7Z`Q{C-Z_9Yki}??X-slHa5k7xAz21KsWno0j-{QO zR|W)wV4hE$eax?)bb*~MBdjMp%TO>~uXRHei7 z=F+(sF)o_~Wp^9=;BYMHo5sO%+Q77v1!MpkgG%5`_1v)5aYYePMy1jCi|bP>6ON+Q zw>e-~_q>=i;x=sqYUf2>b)N;4CWM4AnL`}^2%Qksp8)497e*wLmg5H!bsxkQn=O`N zNCw3|Xt4^qz+ezrfF%JariEx2yP&&PaboHJGR-|6vP0^2+K$Nm`-sQ~V~gcNgn2uQ zO@dnD7s?5OdG-KUlm-D7u|>00F|q);%*&bU8YWc5IjE-dD)s(-RReME-+fO=;R2Rj z1ufOVC`O~KYvhX*vGqzhKtcYgNU^_D?}8>8-m3}&CI4d)W?Lg&5cJ}uyqbF%IPf29 zxaz!G*k!45jC3;@d+Sus(fFbu9rxFo+up3Fv3eBq-q`M)JjSu55em>Tq8cWy^+Fv! z{$TtqkNEJdI&TeTO@yXG-0V20>bOVf^q_0gh#{%|6aG8^Qnn?wXvEMGAt6~EfT(7w0s*5!&NPjPgK^*=`x?D@&(}Hv`h|2`MO9N} zrI5fhU!uk-F7L%+D_Uq#lVyaQ_1@WIKFk4A2oc7n+AReYkfA#hw1K!9o_b&j*rGdq zEfflRqFsz>x#Ts6Psz?$F~BMqz;@cPhD;lltSU1%&>Zwj4LWo4(VDh_e3XR=lNXcc zl%iGnnveDam&9~vNLw`5U^(=9XB8yJfC7ulR~Kd;Fm#;qaDwmMyCzeBQGlYdoxUsI zUf>ae1jt=kqJV-RiL)oI zx0++r_^IZ{n9-+5<>{c&tAtA3t#S6DEHITA2hjbSI;Ds$m^Wr$r>9{fIxou#unaHT zERuvZRQ;7+bHaCU6F9xkbER?d=9%Xu`e)j|>Zm|{+`Oy+lmJaDh?!xR5N)=)1hxaW z#6QoeN@zlX1z>?ez?fqaTQpi&fLqjnGJ`=4-ToF270f>S&QeYp`GedWb5<~R0qjAV615l2hi{BDI z(Z9@HMRb*+=1JR1+#r<4)`9DA1@X6uS~*ipWQ?OnP#$>n0OVp*cHavpFl)9-r6%+# zeU4>Z((b;{TWiE|o%TCUjsy-W;S?-F!U|o8^r{yPq6%rX;u8WvP|U7`>_ExwZF2;6 z)UG!e0v3x3P}Mfv-oe{sSb30vCJ}XVN_Wi1(1hX=diC+hd`b~mCk>J0ZokGj_4^xm zG#;|}Dz&W#55N!LO>;04?hZ1LNken$ znuxj!#;7pRm2l8L0r?MalX563WrRV1V0Spoq+n-(hHX-9_B^zamaV2aHdGI?i_Wef z!T>1s&}2nI{J{<()fv6HPwBFUPCx{Q26B$(6QmzSaj$h~AB+kBu;`ttUF6o6Zqc`W zr~{7}<@CZxU9ZyuTs&)z0`iI=v=yA0wfqGrOUKD_yz3#tU*7%koX9}E>S=u6I{{Us z*({6;UtJAvEE?NQ3QkU-AR2)MrkLcmf@`gHI-}8JN08yRV#7HGn4Rhyp{VBH_6QY? z@Qf6-(J~{;^8_(t!QIC90AN2%vw;yIf#QL|^nn|e4?gy}8UuoXXqQ0%9_n03Nk1TT z)1c^!alGwc%*?Ur<%`i}cl%423IYdC9w*)5<911Qgw@ImjrNyZcxBBK5Ay^Z9gmV$ z(?&6H+FgzT;N>FbE8yG|L%D3@H?hHs)W@cjrWfg*sIxbTR&Iw->}nyQXAs&CTAEz|i1b#eodE)}+K7!%fwTlXe}(}tVN@pV zgZ2r})&xpfoxwEV)Hz84n7;ZgzI{_y;NZeQ5{gg&xO7gv;Apl2wy0o)sn>nctmara z2L>oZu}Vycv32fO+pa{B4abb|@!RM}xQp218y4Ry%h>=b;(6QNv?;yN$r6n?ZL=go zHO(Uu9Sj(G`WK%|nu?Hwgy&FK@xWau(B}biOP+S8%vy#PygG#PyD8KC!h=ju0*LZ? zl9h6XftEy?XU$1UrXx?!&5UcF$%#$wOMSMNSzWOUc)vNBH4)FNjAI|rgI-U?1KxyJD3{XF* z39sIc_6tP*-|b|ExGeElq2qWzdf=oK8e1u{r8F$nyIH%)WeIj*QQy+c%dnvSZhfYz z{praw`uOoN_zu?QWvpVs&u%tN>1k5>R4oHxWVjw{nQ!8${XIPx8!>P!Gy9mu<92OB zcH$OA7b&6&*`efp{}kDdxsX`twVDqu~mh9X5W`Atc^xR1qTn2F6IHXiF_&@=JVQ1LH*uoPv zII~g{oPbn8v(2I|@(wM{z4envt|NZcMy$9kX~8udmwPZ7ab$d%Xt8Jlt5l^-N*K#A z{8QS!N(``gKyDlx)G+v>FpnHQ=hrM_g?}6j&^X+O(wIF=K4#na641|obGQzh zNrTck9Do!HE+wI0i4v5(QfGmgOII)k&!Kr><(J$vkxJ!j*^ylU>&|>4^8Q#RnmF$e zsiGC?44I2OghC(TTWofOX zz_!2=$bk)LHsy~J3n%w6Xdg2~iUYtf1$0pvtNS8?L8SHuEg8Vv9tOGG$YT>ju-YZ> zpy(uHV^C=K4j zoIUF32r=V?MxTNJfLP2!ivEB<62l51*$RwBM*#!^ zE)sG~4O}0gc?+A}yAP8az+~HB`(im2>Er^)eox8GC}DBQjY8q_1vq1{8cP$}+MeJ| z{N5M!TQk0260mI>(U3{3zt-E>44E&(m}dN1ARsVCJYvjO7je+Kjcfzmza&ORe(Ie6M1w_D3B6R zbWaC+JP?`1l7oW_R|sqzLvS~&P*D}PN+k16-7b>&$%yIjxa?W3v5&o0vpH1b_!7~cnUqfNJU%YwBjmADlp^Mn@E7q-QZ z2$It=R~i#rp{b|pc|aw#Mf7VB9zF^{UJ!J4ecOrxcXCeMGn&~knRJ`d0GZl}3@nRD zGDAL5C4qPj0P^sa7HDdm0o(0%6^N=U1}=jOu`%&rjtR^$2QwNon808#VZuNi5@w$f zZskciC!dcUfC4Zk^7(xGh;+}IriTb^50npr*V9p%J=if=(Gr3O&BH8>KyEbT^xI8r zJezkjJ#3LtwsMo((K>ti$Dk*ocg~3BFtMPLZCQ$Beb@Ja$Ya1xR4t;rnmk8G^hy$| zll_{OgHo`~aEfUlEkL5AHHK^fD%I22*;*f3@BBVjwjows2YwUY|D6J{kK@2&W+rlr zId0Sw`9E7(KK)ZLH*@$_K zQZVPNR8i}vIt zd%1-<9DVoWzUFB02pz-NMa{w*BRONjbvJDkm5uvoe*6<~_OYnmkHpo)(ovl|&m=lN zkboJy4FQoaZqOq{S|be6Qa77d#2kl86^a-00x z_Mb5OLu=hntYd-(o`0KnPb}r2`BcR8hN{n&y)Xqc!3rvBu7kQL7j&v{&i~~&%nX|T zoFmAubO`Eo)XnXK>^{XiN#5e_+eG)-#|+y}?njUB0nF#*nLKZf3g*Of_*I097sxKm|q!3BnWo02DygF&0iiM@paeAX0@?ayr6#SF3(2h{JQ6OD8hS5YQIjy9W2 z9hJHz7RwoPC8lB<5@vHDF=@|sTnSulO|!oWFE0}~Hertw3K!t5Blu}X6164FHGl-m z>}V+!n>Z3C9QCaUQiH70gGce29t8khDUeN}PN?g{)$JVYZ|PnG-q@XY-MO3F``)9| z5d{i!4E=Hx!$ty(2Rs)xyns#w14*eidl&#?j$#4>=3v5r*)Rr7=HwK9#{lr~_N#3d zLI@C{5fVtz1xJ;tGxXzb`ND!Gy*E7b0lXBgc$4jF3zpjAWSveOnlrbAH@onJWxe(W zT*6!$%w$ezZoS&@Ize-h-kgP>X#I?{J=|({Xn9DjSvunf zHlGknwwA5*ZxL>av}CJ+*HD{-5XRV~DF$2Fc6pZUNGqgP zXz;_ZILA5;mQN|P_u~EkRis3KCd=Qvy9K&;HbD2%x2NT`)7$79=Hy`C zQCMOnsML*`+fQEe^w^XmLYR0)s_Ym=EpNlZ(4ksc{gP_W(|YO9g9z`;jKXXb!u*2o zo)rL1SJMIsfjM|DHNg?mq6)tH6k8M*xJ4GlLUxZ`AmZc4YZ3sMULUD0gr|LDxEJIe z$eUDdVw56M&}&GC`9ixizy&y{S{e-^##Gf{VXam-=rwgwNePy03=$Fo1=Yo6Ibl?a zT#~9fN>WrIA~%~ILQI{ZBaE_9ZKO0bhAgs$m_(0jnA9=3OSYD5WHpAgmvJ1@s1Qly zMw&}G(1y@Lg|@66`0;J){gLBX*HO3cnq5Q#!n&2#s6;#@+pDx*Nt~UyWtV#u7GiLz zQYkt(m}eNIX^GCm^<qeoKh3QtbpQer!TsrKUYxfkN(vqv^y-6BIwpcpAP{GBv$Iqx^m2H~ z33^e0OWw48LB44s$sEfsEnXR%Gwv`K(27V4&e5%LOUG>9KMYD?7svi%951Vt9XAI{ zWrHg~s=^WlqC$zttDI2Ppg;!(2tXm)Rs!bgV`BrhL#Iv=-g_u9JTPYM}|?CG<-q*9_0*Mxub*1t2*YER{6x-3{_xKVL|VbC9hc&g{@Qw3Qxo`2$+3SJ5?Tj^Z)1F6eOp0%i*^Cu0zn+x{k2ZX#(+nrQ(PWfcgRR>2(u zOu(XQ00RR`pXSv*ecY2{+vW#d0su*(sx#-{wL!x@P?T!HK=HspOF$Gr2QV}27+#0p zhKAeU5+0^!>F;QpE8_PKyeB2u6EF;8V)G1E|H5*pv-3fYq|v zl))U-C)L5Ev?>Fz5tIOYDEDd3jFS%&14t5rKVJY8FpswwXJqj-K!Vf6X)ry+q~7n? z$l!aA&z2=O@dPMotDmr(Qw~kIBg@I=(_6FHnIx{0fW@*hJ>eN3)a z2nW}RlT19Q8k>k>C<7>fw)-Cj@L{i*qF`_oRdZ_{^5PH28BcGJlR$lMP!hUQKtz02 zwRd=U`=5O^_ugGD%qIX)n-ti_oM>Q)T7`IUOMn6-VhetLrqLp_Fk%3Vp!k(zF_GQw z@p)#@#+pP3eLwoUmkGiE0tvjSC@5(gzd!68U`R0R#MLsWvm~-*fDE(%5yOxU561!` zKz4ct(3s8^XR3;#pj3UYz}3|PC@3Uu1=&@?T;F%>RsQE$ZzGOlA}GEh9^TZYw(S>g zI0_y>39O0%QyM@xcP(6yn86TOU=dCjOv*ty;phCrNK^w$@Q#HW?r44Ac^^(=a0cAv z%fVnigTM%BnNId73XoKKc939*K)lv%yw?E?4dfVRl$Mm7g848LBa|S+qpqXm(oH+0 z1vdb}*19)0LaZn{rZfQP9+ngb+TPm*`U(|>2pwtm@P~*hqK;3)L`$*^9Y{%_+G3q2 zRO^j3cYgL-(6IM(O!EtaG3SEI^PqGyJV|LTx*^~@ zCi9l$b)(!(*IE9W0h;sqh1f!z#+y^6UI7ISjA|Ngh&;Q_=CA-P*XQ!dB`um35*1UA z8(FXmJ1QdJMd`Gh81)Ja2?gJy07_M%o*SWpl$VxigB*40;Fn~&M?tKJh$NJ~`C(I6 z3Zl03!MAPeS{Dberq4VEMm2Tu0Ub+^MELYc1Z*BMYMSuOMS%quF<{IMM#PpW5(LbS zbG{Uv)J#D?-sB7S5tfR z4|D&>-Zwb%a>K@&iB>P66d}S;SOF2!65#ut01$lO34;sh8vsC|2X@mBJ3#wV6c8{Z zTz1$4^Ems7f4ISWc>po;s>B088L-5A^Ux@Y0^tFCa%Mk zN`mAVm}Ul6iJs7l@(?y)qz9GT}x(X2V##B*IP=2au z`sxQy`;*9n3b|dCu4jJBG1#D|q;y8Hmh%>%Nf{DqE80Nu$iC%Ht;rt9UR}mSeDLJ$ z+1X=W0#FT>V5*6@OYvC%1ZWTl8{`vtHe?>pW1KkyV{UQ*e*nx~*yub|V&M5iKjOV_ z*Q`wwpe5AB{h zP#y#r6$bX3yNWU-jFm>MVq{>ziIYBPyhx408JB?og93&cdJ)s$x&iIzxE9UpWIz5D zk~o74bTRoEuLswJ8^Vh@P%U=Oc;23LpJldu01eDH)oNNcwPQ`PxdeYK9~Ba9*?@_> zTP(SNkBB251d!wG^nADC%Qd=v-8%&x;O~VK12dQ)&cMB!G!S;-CXqy0T;CXA*VmDR zqJZukwc!M%s?hYb@8F;+#LyGxva7{dJi-i?XYR>-)IrrGoJFdbWZmntgNx}|@uPkF zZm<1%{!x}rcvo77JAgO?0|VC8XeC};Bsyn^N1St;@--JB7Qn>1jM-9efB?$?HPqAq zG$868uj?paGHKZtDMGs%_(R`)I0#7)TeNjd7lI`)fTwrVwAMZXO%fF9(rS#g?mFA z6#Cy)^7fTI_yoNC8E2dWHcU!kYM&ICs9Liz<{1=-)MdtOi>hTfGeYZ4dLIowo4Z?!nLc(fn8zy4KvD-0XeSZTfHS}|Ra2k{SD@&{+2+m04q((8 za1*WMBO9N2fP)zrXiNoZiaVA8PC!=~0p;a?!|ly@@erd_&;fU2{kwmYT3js$D|&mS z{Gmi@MvQbEH2Yf@q9%XfzDu#$Q}uzzyQj(Zbg{5d0U2 zOc0)rC!n1vyk@{6cXEro-81Ow(WgY`cL11|=EUG)aruS66Wh$E0ba;V_GYWyVasyp z;BV4y7vcqji)(h8mG~EHp|@-yO_|;5tff~+t4WMyz&4!{^ew4X1&vIVq8O8^dSLee z^(!x#wpTNA3FUG#0jp7iiMG_Y!-u~kJ>@hr%%~11C_F?l1(e#8Il@iL69e0q4?TQ( zYyYBhFOFY6s}&NcRz@21yu&w3X)CH6lSy< zRD-b|7QGp)D*(NzXux2G-G5n-ttYmzZS_e!{&uDr2Zl3ox(%XzZPWS7H=mEa^#Sg4IOn;1akLVE--{^@>IXMcMf&pjeI4mg8KF zy*3NCR#~DI7_*kk=GMdahuT?0sumM1w%1}i*kI7xJ_#@YFseo-zH0SdY7O9aq`o3n#>ZAZAX}}j|wQSOI zaD>@T%AS4=prJdWjufbbghWt;$W1nv+~BrZl%@QwzqD7@R#ucVoI_PpY?hfd&Gn31 zu~D{ajHu7k*c`cRvfp0^VTUSO8Su$M_;8Cw-{+FUKEU7&dB=srzy=4Lci;j5hZF7q zxpns*D3L1{2h$OL5qVh~)=Q8Yfs z%$_DCq)&>0*WeHq`DbKNL_6*vC<*LQ@la44vMGZIN1RY3$HY!pC z3KJ5j5w}1HEU;~RaIpL&9_`~l)Erdtidk%Hr%4*AHqT9)^j_`}{aQ108-6DFfvFN) z1_Iwl4sOXU!7T~vTnXL)2XK1OnbG5I)6cpS5sDH-G5xe*1jA5HdgksIqH#HI2ohX&Rc{@w3x+WpBYq3&_QLa~pw_N}|U=Y3_fR z%K&^HbYkL$Ye-12h7AB9Ya^uHQm#joUpzTr=w8!Cnb7PZfhgjTjPa zyS(D&i{)nR-QRLPKFek0Je;l2MJHPibA*s?l?wA=L8+J+irmX5HKG%uAch4b&~?_2 z3Fi@4PyB;2-J3s&XW5ZeThr{Ol+&nlx-Fg0jy?p8vb~JihbxGGtlQ)I0JzV`?E$fc z10n*bgwU;oA>m;9AmS>+!6CqPefV$Zc4u|tt2Ul~#6~>(T{|ItU+?;d_d8+99%KnY zfZ}1zH`+jU8_t&Pb&?1W@E0X1U;w8+M}Vo#)Xx*OqXEQ3q@gE8n0*vr9({fefXnk^ zp=2{lT17H&%3?CB^fg@iLfdLMyY0W*{uFbPnoPfYTFDVEhs z2PJ4)Vg&IM@nuNp1SdN?vDJ3H*FLo-Po&N45QWok;QP^izu9qi8K~O$@LQSmF|X#s z1ua-w{ck--!Bvj^Li-{fNql$T8POs^ECT2(6U-11AX^${w0#0MOuo=6Km$G1yW=r~ z30xu!taO7rk$bh=8?4Kee~e?M`9vT9N&z4y<{+@`@?d$e4OZ+b4=%(Do@IGg|Fi7C zF=@3~YAC5y)oKPHR-gTqN>g3+trCN^rWQp|kD};rBSqkt@*!bV5FJs7APFR7InVM| z9n5)$nn7vy`8_;?wCM2-t77eT63pZ|Ff zbc|aP-4slXi4;IsB7-^TT&`Bj<#M%L9ULqVu6SvWe?@hL&4HSH!HtJsy&>8cAEjLw z>jtF|D@fWviHNxdib3S-B#KpREuo}{|=xPCuRe(&4C9;N*Wey7@o0YZ;o&6ycp#>wW1nGqoXmiP%+4)B4Y4@Kq**>7y;F4OlPH504Ct=A9#f&gPFB` zoB$aa1fwz!r|}vK4 z7Cmp-ke-@lvzq8pKK-rRO)k9~*T4`cvf{#=<J^r$^;g>y!^G0y)GxQFED4<@V z0MGyc5i#MAvjPKPfSDx(K~N3sYPDJ}+k^Jtt|KzqUNf?5#freL0yXr;Y3QPOJdVXu zi-`z2KK+O^64sY10&VpPzAB=m7mo;J0hT?~Z@nWmCEK+;me(~Nr+K&csFbj=X@nUb zi&h`1Nya<_NKrO4rLp-bvrH|b74hh!xK%c3ra(*Enafs=;@BWLk{N8>L2*|MSM1|i zoFr%K+kfqa^eQl8TdNtRV#pK_Qv1H8+R;(l3E+(*L_h#%oTx1ww0;-sFG747xwGQ- zkj2X+tU^9p8p!(?fLkH}AP@)y@F4(!nQ-u|R^4u&K0H1B_S&#G{GwHtMhCPF|Te0EexF-6>S^bUqV-2w)JH zcnJUw(ZL!RY(H(cKYqJ?<;VZec;|K4+Pa`+&F4>pwpB zJr%X5nqa zoC!Tb+3rh$wx4!$rF)gWa?;QeFyYo{1bAS_+!wDAp87Z!P~-Pi*8Mx~SzOK}Kk{|G zmydC&dSf=sSbq85#!XjIL2;?)d@oE0cdp!tcu8uY1`9B-Y7hkW63bP4uv#wLaN9Vx9MVY zv$j^QN6lpSB+q;wcdluPja|ho+I;I;7#dn{Jx{!!F6LJtRTP-jTdiDRr=$vhsxkb*>|h)w zgQ;SqN2hcKz2nc(qOH=pwr&n@Do^XTO&u>M_-?M`jfW`VSSJreJ{X;um>4xcF^ieO zU}l@ywgcNP2ZMICT&-5igS!R?FDM7L4Mnxyr(ZL0TdY(qiu_2!QJW>+MWjiAAytrq)CukDGxxL7<+0P3~aP#+M}Za?C+~SJ4Za=&ffLU zOHajHnQvhhi#~nUMT^6~ZL@7HE#62)9Z2R+NBh&PoQF@=7Xx$lx?qGIh@AY&K4Yg#4p5-p*W}p zBH#a7yK+%){<#UmlWj^}td zcw=3o)->qEARJ<5fH~kG2<*TPs#V*z2dmY=43q~i7#u94Y^%7GW>HJoSk*}B=xrIG zT2$DoVx1UBwK$IBT3qXjK}_I)(8aZ`S{$o8JPOHb5I+QE_55YK0x)3PkTj!2Z4mOL zEo%ods*$o-dC6^o)V4TNMgj8wZ|Zp*bJKv%I-~PW0*30@XSObnF0ESG#;gjYXbW%d z$wxvFV#_qfUeVZH2pgDoxk^2JGBe7|?%zLqnYFXMwQV-9u3>Z3aYF-JcP&f zP1!g3{ED}hA+*_}Zv(7Y%^_zH05E|GOJu?l84PCTfP=v9T&-5iIH-43kG46 z4z=OoS|fXWZ<-AE#$CNNr4#`GgLzZjRg2xBV|L3-?^@oR&D42Jrd(iyn7Mn^N;{*Y zku*))nI6DqBqh+7o7jJNSa1kdd7ZNQz1;%`cqO+m)jh0vX|*S4+M^%tUV2^l%ey62 z16R~)jZ_WSdgHDdnBoy|LaY?C3YhvB4XsJtVnsuNBU+m8(TDH<$vl}>X4rxqT zKc&bl6EHDY;Z-P$F@B(`^NdrUYm!T0vnZUCp0UBMyfBc*Nnh7K^!oJ4+U>gH#kNa( zd%=82!KR1T*fz@c-WT!kj!vb$T}KysE{;m27(_*e$`2I6(>W|?P0{m4mSLskUbwUO z@aF9H=i1t|%5!Zo?_*P^VXb{j)9ZY2Po7=)KE@pkbOIOv2#kX#hJq=k7z$ux%o7J3 z1c7aDU)gRg8b2d&_TGD{AX$_|wHiyhys^=D4yVnJ|6#s^u!uC8IOYJ%p}xvZ)hZR+ zs1i=FMIy8Gi8#lo3|@y3K#~PGcYdWYH=r~SG6M}OduY`YBs(M%fOp>Eb76lt%Ox7~ zNk>wnAX_Pw7}?tU*sLk~0lbK=MvQyAdKHKOVh}S(fr-`S7rN|6zFK){pi9cu8*QT= z-`sqx&vn-6;mvE)ncge5P7fiUV|R*|03hloFdYmp!2s0MP}XGtU}j@$W(KNycBTqE z`L_>GwjJ0p0{2@wN{}Y8Z z7zIfZB<<60dx|!kwHW^6bd3f;uz>);hHRP*mBB&VCMJs#5h;L(+!7NdS*fMkt;2uz z@at%h7xAwS*J>&z015<aBt?j0k z=7fflKIls8P#SadB^L*qgaG5+o(33zp{5{8W*Y(XitnG)4Dz_r_G*yk3xc=H6*B@R zp5*d*vY`I7G$v|WFK`QR+L=EyXnfyahy@1{+S>0@f7>1Fugy{h4%H8m_(-#Qp|TF3bf zr+UT0me5l~L9lY=dCNx)Ob`F+;fK$J=h}MM-b@4P;cMa3;CMT)b*ud$EFi$KNqCD`tj-fG`l@^$(AE_w_T!68k60 z;k;=EQs}WgqCkQ>*JFy2pRV}|KF@dX4lw~96lg%H@1Un{R}%BmQ%_KvHc?BS+PnQl^llpN-BeQ)1B!?g^}8_;lM2|WgCxam zr|nBAdKBtarG_SKSw61q$Ip=8z3KR5(&Wp#LdOALxGt~FbGL?!91!1G)GDGh17I9L z=TSw&S~FAkl||0J+=7<@#7smSfP%pt(F`ZE)Anj;ie<3wAe44WK)zBAPi7`2U|Pqu zuJsyyw8#@)Y-l1?caKQ(J+6!3^f0 z+$LnuFmS&^AWjsF2rY7opO4ZzV_Bwl}wv0Z^U4sHMe z0tUcLd@ulmKmY*>plL@TAc6`2#mq+~blg+yZOYED>ihow)0%3#UqpJ16)6Bo>`0*y ztdjl#D1zhl=<2N>w_HCJPD;0pVf!EPtjHow8&oHwdt5o*V%h3_;hhq#w9R;iQ?t*+rs+qd^_AMTAw5it~q03aqXV#4@D_zC(}t9jVd3@k~x zU8f%1jK?2;eA8xAbNeSB{n_ai1dMrLfC2&&h&$cc>2Y6=?uv0kSmbphd<%JA^+dP% ziTDDdhC!f!ZQGC1EcrEA8s-f~tz7I0M*VE8Efaw9VO@JXoR|csp+MGDa4^8QaI8>N zaTSda1c%oG1%4rmAcY3i_n4!eUCf4600U5}2FFZ9#Kc5I3>5@KPz<&#hoDTe>gu9+40LLwV-J^NBwi(TR&SS9fOT9_g_Y5X7G0NUR+n0n{Y$^<4`4>y z+B~LBf7|6LG>B0mVs`Ql;JE-aoA2=f>O|m(_-Fjwl{=q)&hyDz&$Mj29e~fBZBYYY z*kE9KjAK@$<*}imaM#`O&rsNuc*^^ELD>Zmwd``B=UJ zgEI>PRFRk)KuDYzjf)6Lwh$di2-9RS0x1HC>Ab0MX#tuRaA>`v%$0gQ_naJnkWT84 ziOFW}<+#f(S2>{#;M8Bi9{%Qp5v)P=>;*ad+*_a1F;+)ctGyf(QxH(VRUjY=0s?FX zGXV?)q`(Y-0NLsqdMXH$U|BUacdS0M*RkmtZ~ty);P%^f^*&Dnr!|9t5Ru!zjiA89 zt_zKfPWfZq<`_hTyE2C8@{j9|vu;kf4tw0?L_`O|L9m~`)$QKJNIJPLD3oA;fn?HJ z0VLsacB1k+)nEW~`(YOusOAYM+0>3&3UIp zrD9g`;BXwQu%jcx4Of-9e`nu)|C-vX1d(!UBn~vvZS{OQb74NbkPFT_t6YwQz_tSg zfSD0612zQ|06;(p044^5h(U@2xF~{|douPTxcu}K%!KBinY2}#W_EqhO=ln8OWa!2 z2>=2>1U%2t600+UaBW=+r%#Vsx8^Z}cFl1(;5N7kRNvNhzx(m@aIk6^YD65^CN(9T z0j7NKI$(q#iHNGG^;WC4#4s7Be@=Ce6Vr-4MFL#}(BoX&eG}mxP?H8hxmx){=5o(T3IPIUUmyp}V1N;T!Ak^)127Xfpb?Jq-_1!R)NUu~~cFVAgk#yc2a!YT@!u&Kk~a zt3Uk5Z*2s2P<7BUUyC!aNgy->u>sI_W7jKSk;ji^-ZnfmXNnW%DYw*5oHCsjC*HtO z5>1n{MMs!WK$eaT8!+UQgBZ+#&D0emP?y~b34FnoL`=?_4R$aExdRYfTs}8O?RW~} zv#RBr;PuULZx_YK91TR(GO2(N06{=@z>I*w6tJ?bCycQGJfE?}A3N9kqp|6-o)f9w z;TCM~fbd1W_vu{w-bJoI542TthL8zh@ zcLjriDIwOp?Q3$yXRZffGJ&bGMcGzh+g8fH*<#Z~7>tqbqiR3Nrjr7gaC{nRdAJTvY-6KlWg zgczzuWKVxt1o+g~*yE>Td}X_zdT6E$tx~>Z;AX|5;%Nk&Fq4gdgGMM6+kP&gn`4gdhKVE~;0Dl7pk0Y05hp-d&Dqaq^oYCy0P ziD_=$$>t)_t7>+5#H5mzcWQ~6zePqX@h{~rGP>oMUE_dh*> zxk<25^=H;Q-z+iIE)+Q1LcSxR=Z@DkG%T9XxR;xscerF5D7zvwT&qhHmRa@B(0Qr5 zA{i9p*%TF#8eyJ%n44-B3N^0Ob**N%L2fMA+5f`F7rtC3?y~(^@5B{wECST8PQ>?q z^u@Z~@i->>30*w`67O2XJ*74X#^3CGiL3=IF~q~IqE4iB3?_GDI=j)B^Z}Mz)dT~p zmUQU3z-Sf<9?SNhG)a8Y;9Lz9r+R)ua!zX*?AvLMb^$ra^YzFh;3o=b!-IOjH6(#e zWkEtN9Q!I?AYFto8J!deLyzIUL_M^fXq+MY8sXqX63Ib{VA_;x6xk>U+ds+POFV2i zAbu=s(RCBquHZHtEyCt>XwuQjTg9vD$^U?zKr3T+jf2_wg%gBdkA$WUq3-5bbI2%w z98)edL1REhlM1RlvEA-sh&a@>yPlLifB2*HOEu4S@>Hc>if?8Zb{Dv+Yy=^c>)Od4 z((XSP0sUOqUuheoQ19HQ+(;1p z`m?o=2^;>B_XJO5jsN!!t>hzI%F$_U_&Ziq!$}2u-Xex%MV#QCKJgIaX7KU>7-^KA z)6-mEMau-g?8m?RgLb=B_A7u&tJ|Jn&Jz4P*itu4VCL&yy&qk|4lzJdg^_s(F*M7S zBAu&6N%n2R+AhGc-6Qa+PsI8HeK27l@wY@V_1iq^1cxMT77_LD z8QTjheF^xs`A|sSE8_r(YCRcF+oYQ!WyP^?1~)hvTvA!$?OS(qg^!u0092@y+L>+rFkVL^($|d z6Zp8G{S=HFSBX@Rwt$1-jay#m)!aCB`z=+WvoU0{G1bbJyAK5Lx&0e!SN5Qm%J zOb{_{XB(d2w~eK~^dv3;dGSfd6=&ofZ{%-RlxdYT@pdJ$%&zh|Tlg&R0nJ-?5clY0 zW~9X=QfLnqrn_>1*TZMoy9XBG+siXC>l={E7_xWyNqW&nPhf6eHqmVl1l(1AVi)$x z1$CQ{S9uJUz+FWheKioQ2(KmCKrwrI&>#o>7<{; z>uz0kWW<98?9gPS#990f8ia$-TQJtbvO50KA$YO~5`KhYt@e`{SahIQ`WMeu8Vw*} zWc!ktPqT_HDp;=czWF|~d**?%h|*c!Cy{LI%xP;>CD{xec6(4Aw~E9obrN^qLO(vk zwPWMM+x&9Z30YM=mT4U&k*5>X!?~_E$?1C%Au(>Gz|`Qp55C&#q2pG7-D|V6xFJ-7D~YYAQ}*oDn~%iCuJpC;QDxAKA`Q+~BHWDUWAxib%hlx9o8we)NjjP zgmWM`Q_&k&=va@AciN{=dr=w8e8O2YxBR)N0=OCTAtQ4qOFy-DQ|Q5AGBW zX*-hJhZrcnAlg-mJKkT*-9xqtl)WIP_ss0Q41Q}Y@oMYu(-F)I%-rrsXF+~1s$v*M z_pp7;b=!j)M-8E+eBS-3uP`9S&2#acvO6NeR(xiDYYQaUyZ+cT? zbSG}#0c^P}{;OGvzF*@w^=DnU30}qj-_(FCGyUR|n~V!Y!Q|uJ@7{$B!GZ)~y1ey09OQNG zfBsaYd>1yO6DC2$itjyI<6xBdY#yroNdFiC*6|2#_5G%JFu4?6TU~ZXFIsr1h>Ff9 zb_viO$ztK=5wM$G%>Zy(;LzZsO<#z>6fH{tFAjPzL!y9M>8XK_tyZGd3Tu4vt4&K( z3YcujEjdCJXl%(izyyd-pG9wkJSsD=q}ICv#=7vVd70%l+V<-)63uil8z#g?54V&S z`Ayq#2WVndh4c7-xSZ^W1@0e4%K^#bbyta*$P**I*>R?$JiPvQHev}9A$s%Ta%j*! zt4x^f#V?YM19Kob_#KM?dlr2|=y6p8<9ly^%V+96Ue2Gby8_km@_vwko$bpD1bW&@?^+ z@g>&+QKOe)V!>1L>}o++azmk5c`!@=IMEkUg+e3=g<+yW+M?#;;9o<~ZI1ui?+LQl z|7y_1O)Vx6SL*RUejoVep=&j+%_GNf0^Z*^?L3nAq&To^3lb zB3IbD_MiyLm$k|@H_~{t{9HkBG`NfxarBJGNXe|m1CO_cZ!WI|O*;uUW(WaO27J10 z5I(&F5qXe5jy=+Fx4XM&!L!?4U*fv3g$gjN@TMzb~q9Fb(_EFiHM2#z- zsE{MFP?REJF+612-nPn_Z>N%477+s?5dM6@{5^S#u*oYe^vGKoaJrx*C~s^l`=i%Y z<4^&w(LkDaKcAiuz23Q+?|Ttlc^|*(XLnB1l1iFX7TcA_WVl1tTB4|8T6&zEJog@{w+)$pbOU4j71=0;l7}9!Cp1Eyp5v3u8P|`?K}oGoSWoH zjlr54>w{hHA(Ywd5hjpHD2^%Cv)m zhGDM>r%Qo}XxyaGf7IICis11B1ho#--((*Tl}+ zC5xkg?V4nJ39?zYrwXo*Pa&U|Y+~o(!l)z5H#QCt6&$pl$hvWI{bwhkWLF$+#Vog- zMFjAKRrp9KbqRSSy-Q48igNm%ARJ#HnMlKU>aZdl7_oGNtRS{+oc^y^srm~166XOrh9c%gAKS8Ts@3xd+iS`K8N>sw)==FIYew=>^jP?-xZ;pw>@9N%WU?lrbdUr12#~6<{-&uk_ z!vf+BLLz=`UwB#bN;+D?(<<_I5dlW!c=r1*K<8b{>eiM9;0=Je7HR(b_%EhfusSRq zCpG%gi551*4_12fLN|0`jYY27vcqa8r*Qz~0k;^^fHOEiEXA^I_KKnXnh0Y}1JHqI z)0mYZ0nRhTlY$B@lIS~xWJh2s2BL2x{ZjXqQJ`|WxBSQ;HP<7-nPW(pZm%iz?V}&6 zeejm9P~ek^PBj_2iH5A|AZ3`aETs@~$@21I!+&GrI%jj_*#_f-M`k~vm-=M3^U8Ro zZY*pg^cz&b<0?F-iEzba1Az=ejhemz`;@LM5<^TtbdH8-VhB6b`QuqFDQGIXY(Ayw z)yD%5zj6}F1tIqA#}2FZdBZ=JDZ|u|m?MJrnfF}*7DSitGzYp^gOebo@3lm;TsdnmCBo5Z9r^-dOTCi_lH!Ij}0uFUcg>=z3z-9mOuDE|A&SOOne4Rs7hct zCoi?8*ARg0vT7T-9Y$D)V@+yV^|8S+nb~<myy_W=VWRLW9k`2sOdwOvQx+AsMAVvHv|HTT%EyZt2D@Od?%R#SHU0+DK*L6i zqEK=v(CH=gB__C+kTdmSDer8l-rh?f3>||8SCOTv7ng5*Bzs{?ZEMDZ#ELqQGmWGG zF)%zrC}yvc2H~kKx8c=AFAfVAI$!F!Dp&frtEQIMhBdnoL8RP5w8E)O#+)b&@6$% zmQuCrvD1XU?FCJD#-8Ib$`wZ#vJ1fNCnjA compendium of information and guides about arcade games. By the community, for the community.

Join our Discord server!

Troubleshooting forums are available in 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":"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 - Alternative patcher for anything we don't support
"},{"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
  • mon's - The longest lasting web patcher, supports a variety of n-1 and older games
"},{"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
  • CPI - (JP) Clear Power Indicator for SP\u260612, also proposes recommendations based on your plays
  • sp12 - IIDX SP\u260612 reference site/difficulty tier list
  • beatmania.app - IIDX INFINITAS difficulty tier list
  • atwiki - IIDX wiki in JP (includes tier lists)
  • textage.cc - Chart viewing resource
  • QPro Viewer by DJ HITOMI - QPRO customization viewer
  • 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 Tier Lists - SDVX difficulty tier lists
  • sdvx.in - Worse looking alternative to SDVX Index (but also has other games available at the top)
  • SDVX Unlock Guide - Translated guide for unlocks
  • SDVX Konasute on Steam Deck - Guide to getting Konasute working on a Steam Deck
"},{"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 - Chart viewer for O.N.G.E.K.I
  • O.N.G.E.K.I. Humen and MLN Rev - Screen captures of all O.N.G.E.K.I. charts
  • Lilyshy's English O.N.G.E.K.I. Guide - Handy O.N.G.E.K.I. resource for players of all skill levels
"},{"location":"resources/#polaris-chord","title":"Polaris Chord","text":"
  • Polaris Touch - Much like Brokenithm, but adapted for Polaris Chord
  • Polaris Touch Godot - Like Polaris Touch, but as a native Android app
"},{"location":"errorcodes/konami/","title":"KONAMI Error Codes","text":"

Synopsis

This section contains various Konami games error codes you might run across and potential steps to resolve them.

"},{"location":"errorcodes/konami/#universal","title":"Universal","text":""},{"location":"errorcodes/konami/#5-0000-0000","title":"5-0000-0000","text":"

This error can be caused by:

  • Having multiple network adapters enabled - try disabling unused ones in Device Manager
  • Game files being set as read-only - ensure all files are writable
"},{"location":"errorcodes/konami/#5-2000-0000-5-2002-0915-5-2600-0000","title":"5-2000-0000 / 5-2002-0915 / 5-2600-0000","text":"

These errors are network related.

Check that:

  • Your internet connection is working
  • Your data version is supported by the server
  • The server is online and running
  • Your EA Service URL (-url) option is correctly set
  • Your PCBID (-p) option is correctly set
"},{"location":"errorcodes/konami/#iidx","title":"IIDX","text":""},{"location":"errorcodes/konami/#5-1500-0002","title":"5-1500-0002","text":"

SOUND DATA CREATE ERROR

Data is corrupt, incomplete, or incorrectly modified. Redownload data from trusted source.

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

USBIO ERROR (NO ANSWER...)

The game times out when trying to communicate with I/O.

  • For home play: I/O emulation could be too slow due to background services (file sync, antivirus, Windows Updates) or bad hardware. Try running tools at higher process priority.
  • For cabinets: Hardware issue with I/O board. Check cables and power supply.
"},{"location":"errorcodes/konami/#5-1505-0001","title":"5-1505-0001","text":"

SSD DATA ERROR

Data is corrupt, incomplete, or incorrectly modified. Redownload data from trusted source.

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

CAMERA DEVICE ERROR

Missing/non-functional camera devices. Either connect necessary cameras, use the -iidxdisablecams Option or patch the game to bypass this check. Can be temporarily bypassed with Test button.

"},{"location":"errorcodes/konami/#5-1503-0043","title":"5-1503-0043","text":"

MONITOR ERROR

The game isn\u00b4t finding a valid monitor. Most likely culprit is your refresh rate being wrong.

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

CLOCK ERROR

Enter Test menu, go to CLOCK, then SAVE AND EXIT.

"},{"location":"errorcodes/konami/#sound-voltex","title":"Sound Voltex","text":""},{"location":"errorcodes/konami/#5-1506-0000","title":"5-1506-0000","text":"

ACIO ERROR

Caused by corrupt libacio.dll. Redownload from a trusted source. If the error persists, redownload entire game data.

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

Caused by modified DLL files in Sound Voltex Booth. Keep files unmodified and reinstall from a trusted source if needed.

"},{"location":"errorcodes/konami/#popn-music","title":"pop'n music","text":""},{"location":"errorcodes/konami/#5-1509-0000","title":"5-1509-0000","text":"

Occurs during gameplay. Verify service URL and PCBID are set correctly.

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

Setup error in pop'n Usaneko. Follow Game Setup and use proper -url and -p parameters in SpiceTools.

"},{"location":"errorcodes/konami/#jubeat","title":"jubeat","text":""},{"location":"errorcodes/konami/#5-2500-0000","title":"5-2500-0000","text":"

BACKUP DATA ERROR

Press your Test button to get past this.

"},{"location":"errorcodes/konami/#gitadora","title":"GITADORA","text":""},{"location":"errorcodes/konami/#5-1506-0000-5-2501-0000","title":"5-1506-0000 / 5-2501-0000","text":"

These errors are typically caused by having multiple network adapters enabled, disable unused ones in Device Manager.

"},{"location":"errorcodes/konami/#5-1698-0000","title":"5-1698-0000","text":"

APPLICATION ERROR

This error usually indicates a problem with your game DLLs. If the error persists, redownload entire game data.

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

BACKUP DATA ERROR

Press your Test button to get past this.

"},{"location":"errorcodes/konami/#nostalgia","title":"NOSTALGIA","text":""},{"location":"errorcodes/konami/#5-1501-0000","title":"5-1501-0000","text":"

This error results from a bad AVS config. Redownload data from trusted source.

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

Synopsis

This section contains various SEGA games error codes you might run across and potential steps to resolve them.

"},{"location":"errorcodes/sega/#universal","title":"Universal","text":""},{"location":"errorcodes/sega/#0000","title":"0000","text":"

Unexpected Error Occured

Data is corrupt, incomplete, or incorrectly modified. Redownload data from trusted 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

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    },\n    \"network\": {\n        \"property\": {\n            \"dhcp\": true\n        }\n    }\n}\n

If your game files does not include config_hook.json, it is OK to create a new file. Then edit the launch script (usually launch.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

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    },\n    \"allnet_accounting\": {\n        \"enable\": false\n    }\n}\n

If your game files does not include config_hook.json, it is OK to create a new file. Then edit the launch script (usually launch.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","title":"CHUNITHM","text":""},{"location":"errorcodes/sega/#3101-3102","title":"3101, 3102","text":"

An unexpected error has occurred with the main deviceInitialization 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 ChuniIO 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

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 your monitor is not set to 1920x1080@120 Hz at 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

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

"},{"location":"errorcodes/sega/#amdaemon","title":"AMDaemon","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\n}\n

The value 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/asphyxia/","title":"Asphyxia","text":""},{"location":"extras/asphyxia/#asphyxia","title":"Asphyxia","text":"

Existing save data

If you have previously used Asphyxia, be sure to backup your savedata folder located next to the plugins directory. This folder contains important data including your game profiles and scores that you may want to keep.

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

Asphyxia is a tool that handles online services for BEMANI games by simulating an e-amusement network, enabling features like score saving, profile management, game events and other online functionality.

It consists of two main components:

  • Asphyxia CORE: The foundational framework that provides the base functionality but no game support by itself
  • Asphyxia PLUGINS: Community-developed modules that implement game-specific features and support
"},{"location":"extras/asphyxia/#downloading-asphyxia","title":"Downloading Asphyxia","text":"
  • Head to Asphyxia CORE's releases page
  • Download the latest asphyxia-core-win-x64.zip archive
  • Prepare a permanent place for your Asphyxia files, preferably an empty folder away from your game data
  • Extract the archive inside of it

You should end up with a structure as follows:

\ud83d\udcc2 asphyxia\n\u2523\u2501 \ud83d\udcc2 plugins\n\u2503  \u2523\u2501 \ud83d\udcc2 _example@identifier\n\u2503  \u2503  \u2517\u2501 ...\n\u2503  \u2523\u2501 \ud83d\udcc4 asphyxia-core.d.ts\n\u2503  \u2523\u2501 \ud83d\udcc4 package.json\n\u2503  \u2517\u2501 \ud83d\udcc4 tsconfig.json\n\u2517\u2501 \u25b6\ufe0f asphyxia-core-x64.exe\n

You can delete the _example@identifier folder, it serves as an example plugin layout for developers

"},{"location":"extras/asphyxia/#installing-plugins","title":"Installing Plugins","text":"

Asphyxia requires a specific plugin for each game you want to use it with

To get started with Asphyxia for your specific game(s), you'll need to install the appropriate plugin(s).

While we maintain a collection of plugins in our Discord server, we may not have support for every game and version. In such cases, you will need to search for community-developed plugins online yourself.

To install plugins from our Discord:

  • Join our Discord server using the logo in the bottom right of the page
  • Navigate to your game's channel
  • Check the pinned Resources message for potential plugin links
  • Download and extract the plugin
  • Place the extracted folders (like sdvx@asphyxia) into your plugins directory

If plugin files are scattered across multiple files/folders, create a single directory for them and move everything inside, following the game@asphyxia naming scheme.

\ud83d\udcc2 asphyxia\n\u2523\u2501 \ud83d\udcc2 plugins\n\u2503  \u2523\u2501 \ud83d\udcc2 sdvx@asphyxia\n\u2503  \u2523\u2501 \ud83d\udcc2 iidx@asphyxia\n\u2503  \u2523\u2501 \ud83d\udcc2 etc.\n\u2503  \u2523\u2501 \ud83d\udcc4 asphyxia-core.d.ts\n\u2503  \u2523\u2501 \ud83d\udcc4 package.json\n\u2503  \u2517\u2501 \ud83d\udcc4 tsconfig.json\n\u2517\u2501 \u25b6\ufe0f asphyxia-core-x64.exe\n
"},{"location":"extras/asphyxia/#starting-and-configuring-asphyxia","title":"Starting and Configuring Asphyxia","text":"

Launch asphyxia-core-x64.exe to start the server. A browser window will automatically open with the Asphyxia WebUI interface.

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

To configure the service URL for your BEMANI game:

  • Open spicecfg.exe
  • Navigate to the Options tab
  • Locate the EA Service URL field
  • Enter the URL shown in Asphyxia WebUI's Dashboard (typically localhost:8083)
"},{"location":"extras/asphyxia/#game-specific-configuration","title":"Game-specific configuration","text":"

Each tab corresponds to steps you need to follow for various games

SDVXIIDX

Settings and WebUI Assets

  • In the WebUI, select SDVX in the left sidebar
  • Under Plugin Settings, find Exceed Gear Data Directory
  • Enter the full path to your game's data folder (the folder containing data, modules, prop, etc.)
  • (Optional) Toggle all four Unlock switches to unlock all game content by default
  • Click Apply to save your changes
  • Close Asphyxia by selecting Process > Shutdown CORE in the top-right corner of the WebUI

Next, update the WebUI assets:

  • Launch asphyxia-core-x64.exe again
  • Click Update Webui Assets in the left sidebar
  • Click Update and confirm the datacode update in ea3-config.xml
  • Wait for the console to show \"Done\" at the top

About expected errors

While importing WebUI assets you may see errors like: - [ifs] MD5 mismatch - /data/graphics/ver06/psd_level.ifs

If you're using the correct plugin and game data, these can usually be ignored.

Final setup

  • Launch SDVX and create a new profile
  • Close the game
  • In the WebUI, navigate to SDVX \u2192 Profiles making sure your new profile appears
  • Customize additional settings through the WebUI interface and make sure everything works as intended

IIDX setup is straightforward:

  • Launch the game with Asphyxia running
  • Create a new profile in-game
  • The profile will automatically appear in the WebUI
  • You can customize additional settings through the WebUI interface and make sure everything works as intended
"},{"location":"extras/asphyxia/#final-words","title":"Final words","text":"

Setup Complete!

Remember to always make sure Asphyxia is running before starting your game!

If you were following a guide, you can now return to it and proceed with the next steps.

"},{"location":"extras/asphyxia/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"extras/audio/","title":"Audio","text":"

Synopsis

This guide explains the different audio modes commonly found in arcade games and their pros and cons, helping you choose the best option for your setup.

Important notice

Recordings and streams must only be shared privately:

  • Through unlisted videos
  • In private streams with friends
  • Within trusted data communities

Sharing content publicly puts you at serious risk of getting banned from arcade venues and communities. Please respect these guidelines.

"},{"location":"extras/audio/#audio-modes","title":"Audio modes","text":""},{"location":"extras/audio/#tldr","title":"TL;DR","text":"Mode DirectSound WASAPI Shared WASAPI Exclusive ASIO Latency Highest Medium Low Lowest when setup correctly Compatibility Highest High High Low Multiple audio streams with extra steps Audio capture with extra steps Recommended for Legacy games Most users Low latency needs Lower latency needs"},{"location":"extras/audio/#directsound","title":"DirectSound","text":"

The legacy Windows audio system, still used by older games.

\u2714\ufe0f Pros:

  • Extremely high compatibility, especially with older games
  • Multiple audio sources can play simultaneously
  • Easy audio capture with OBS, Discord etc.
  • Simple to set up and use

\u274c Cons:

  • Highest latency of all modes
  • Being phased out in favor of WASAPI
  • Limited audio quality compared to modern modes

\ud83d\udca1 Pro tip: Use spice2x's -lowlatencysharedaudio setting to reduce latency.

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

The modern Windows standard audio mode. Recommended for most users.

\u2714\ufe0f Pros:

  • Works with most modern games and applications
  • Multiple audio sources can play simultaneously
  • Easy audio capture with OBS, Discord etc.
  • Good balance of latency and compatibility

\u274c Cons:

  • Higher latency than Exclusive mode
  • Some games may require patches/configuration for Shared mode

\ud83d\udca1 Pro tip: Use spice2x's -lowlatencysharedaudio setting to reduce latency.

"},{"location":"extras/audio/#wasapi-exclusive","title":"WASAPI Exclusive","text":"Hardware compatibility notice

Your audio device must explicitly support exclusive mode. Check your audio settings:

Gives one application complete control over the audio device.

\u2714\ufe0f Pros:

  • Significantly lower latency than Shared mode
  • More consistent audio processing than Shared mode
  • Better for rhythm games if you don't mind the cons

\u274c Cons:

  • Only one application can output audio at a time
  • No audio capture without special hardware/software
  • Can cause system-wide audio interruptions
"},{"location":"extras/audio/#asio","title":"ASIO","text":"

Hardware requirements

For optimal results, use a dedicated ASIO-compatible audio interface. Software solutions like ASIO4ALL or FlexASIO exist but have limitations:

  • Added processing overhead
  • May not improve latency over WASAPI Exclusive
  • Mostly useful when:
    • Games are incompatible with your audio device
    • ASIO is the only supported mode
    • You need specific ASIO features

Professional audio standard designed for audio interfaces and music production.

\u2714\ufe0f Pros:

  • Lowest possible latency when properly configured
  • Direct hardware control
  • Precise buffer size adjustment
  • Professional-grade audio quality
  • Bypass Windows audio stack
  • Capture is possible when routed through Voicemeeter at the cost of very little added latency

\u274c Cons:

  • Requires specialized hardware for best results
  • Complex setup process
  • Usually limited to one application at a time
  • No direct audio capture support
  • System performance heavily impacts stability
  • May require significant tweaking
"},{"location":"extras/audio/#asio-recordingstreaming","title":"ASIO Recording/Streaming","text":"

This guide assumes your game already uses ASIO and you want to record/stream with audio

"},{"location":"extras/audio/#required-software","title":"Required software","text":"

ASIO bypasses the Windows audio system that recording/streaming applications use, so you'll need additional software to route the audio:

  • Voicemeeter Banana - For audio routing
  • OBS Studio - For recording and streaming

Install both applications before continuing.

"},{"location":"extras/audio/#game-configuration","title":"Game configuration","text":"

Set your game's ASIO output device to Voicemeeter Virtual ASIO:

  • For spice2x games: Look for settings like -iidxasio or -sdvxasio at the top of spicecfg's Options tab
  • For other games: The location depends on your setup, but look for ASIO device selection
"},{"location":"extras/audio/#voicemeeter-configuration","title":"Voicemeeter configuration","text":"

First, configure recommended settings:

  1. Click Menu in the top right
  2. Enable settings shown below to ensure Voicemeeter:
    • Starts with Windows
    • Auto-recovers from audio issues

Next, set up ASIO output:

  1. Click the A1 button in the top right
  2. Select the ASIO (Steinberg) tab
  3. Choose your ASIO device

Finally, configure audio routing:

  1. Locate the 4th column in the interface
  2. Enable only the A1 and B1 toggles as shown:

"},{"location":"extras/audio/#obs-studio-configuration","title":"OBS Studio Configuration","text":"

  1. Run OBS Studio's initial configuration wizard if you haven't already

  2. Set up audio capture:

    • In the Sources panel, click + and select Audio Input Capture
    • For the Device, select VoiceMeeter Output (B1)

  3. Enable audio monitoring:

    • Click the gear icon in the Audio Mixer panel
    • Find your Audio Input Capture source
    • Change Audio Monitoring to Monitor and Output

  4. Configure OBS audio settings:

    • Go to File > Settings
    • In the Audio tab:
      • Set Sample Rate to match your ASIO/game settings
      • For Monitoring Device, select any unused input such as a VoiceMeeter In
    • Save changes with Apply and OK

  5. Add video capture:

    • In Sources, add either Display Capture or Game Capture
    • Adjust OBS video and output settings as needed
"},{"location":"extras/audio/#using-this-setup","title":"Using this setup","text":"

First, ensure Voicemeeter and OBS Studio are running.

Next, configure your desired OBS output and video settings.

  • For streaming and recording, now use OBS as normal.

  • For Discord sharing:

    • Right-click the OBS preview window
    • Select Fullscreen Projector (Preview)
    • Choose which monitor to show the projector on
    • Press Alt+Tab to switch away from the projector window
    • In Discord, share the projector window
"},{"location":"extras/audio/#further-reading","title":"Further reading","text":"
  • spice2x wiki
"},{"location":"extras/controllers/","title":"Controllers","text":"

Synopsis

This guide provides an overview of popular arcade-style rhythm game controllers currently available to buy. Controllers are ranked based on their popularity within the rhythm game community.

"},{"location":"extras/controllers/#konami","title":"KONAMI","text":""},{"location":"extras/controllers/#beatmania-iidx","title":"beatmania IIDX","text":"

Lightning cabinets typically use Sanwa buttons, 50g springs, 50g microswitches

PHOENIXWAN+ LMT

Product page Vendor: gamo2 Price range: $299 ~ $447.50 + Shipping/Taxes Recommended setup: $425 (Sanwa 50g, Omron 50g, default LEDs)

This controller is widely considered the gold standard for IIDX controllers. With high-quality construction materials, a few spring and switch options, and an arcade-like textured turntable. The PHOENIXWAN's proven reliability makes it the top choice for both new and experienced players.

DX6TH

Product page Vendor: YuanCon Price range: $209 ~ $334 + Shipping/Taxes Recommended setup: $334 (Sanwa 50g, defaults)

The DX6TH is a good alternative to the PHOENIXWAN, offering decent build quality at a lower price point. However, its glossy acrylic turntable attracts dust and fingerprints easily, and doesn't match the premium feel of the PHOENIXWAN's LMT surface.

"},{"location":"extras/controllers/#sound-voltex","title":"Sound Voltex","text":"

Valkyrie cabinets typically use Sanwa buttons, 20g springs, 100g microswitches

FAUCETWO+

Products: VW Skin - EG Skin Vendor: gamo2 Price range: $169 ~ $466.20 + Shipping/Taxes Recommended setup: $296 (Sanwa 20g, Omron 100g)

The FAUCETWO+ probably is the most popular Sound Voltex controller on the market. It features improved knob durability compared to the original FAUCETWO, eliminating the need to regularly replace damping sheets. For microswitches, we recommend choosing Omron over LHS1F switches, as Omrons are generally more durable, cost-effective, and easier to source.

SDVX12

Products: Black - White - Black&Blue - White&Purple - Pink&Gold - Pink - Gold Vendor: YuanCon Price range: $188 ~ $333 + Shipping/Taxes Recommended setup: $333 (Sanwa 20g, LHS1F 100g)

The SDVX12 is YuanCon's alternative to the FAUCETWO+. While well-built, its main limitation is restricted customization. You can only choose between Chinese buttons with 50g springs, or Sanwa buttons with 20g springs and LHS1F 100g microswitches. The LHS1F switches are generally less durable than the Omron switches available for the FAUCETWO+.

SDVX LITE 3

Product page Vendor: YuanCon Price range: $138 ~ $283 + Shipping/Taxes Recommended setup: $283 (Sanwa 20g, LHS1F 100g)

The SDVX LITE 3 is a more compact and affordable version of the SDVX12. By trimming its sides, it remains arcade-accurate without wasting space. Like its larger counterpart, it has limited customization options (see SDVX12 description above). Despite this, its lower price point makes it an excellent entry-level choice for players of all skill levels.

"},{"location":"extras/controllers/#popn-music","title":"pop'n music","text":"POPOLLER

Product page Vendor: gamo2 Price range: $229 ~ $279 + Shipping/Taxes Recommended setup: $279 (SAMDUCKSA buttons)

It should be noted a few users have reported SAMDUCKSA buttons spinning in place, your mileage may vary.

YuanCon's Pop'n Controller

Product page Vendor: YuanCon Price: $149 + Shipping/Taxes

"},{"location":"extras/controllers/#dance-dance-revolution","title":"Dance Dance Revolution","text":"L-TEK / iamats

Catalog Vendor: L-TEK

L-TEK produces high-quality DDR dance pads at various price points. Due to their extensive product lineup, we recommend browsing their catalog directly to find the pad that best suits your needs and budget.

YuanCon Pad Single/Double

Products: Single - Double Vendor: YuanCon Price range: $1199 ~ $2519 + High shipping/taxes

YuanCon proposes single and double DDR pads. While seemingly very well built, they also are extremely expensive.

"},{"location":"extras/controllers/#nostalgia","title":"NOSTALGIA","text":"NOSTROLLER

Product page Vendor: gamo2 Price: $349 + Shipping/Taxes

The NOSTROLLER is the only dedicated controller option for NOSTALGIA. While information about this controller is limited due to its niche market, it's worth noting that any MIDI keyboard with enough keys can also be configured to work with the game.

"},{"location":"extras/controllers/#sega","title":"SEGA","text":""},{"location":"extras/controllers/#chunithm","title":"CHUNITHM","text":"TASOLLER+

Product page Vendor: gamo2 Price: $349 + Shipping/Taxes

The TASOLLER+ is widely regarded as the definitive CHUNITHM controller. Its premium aluminum construction, exceptional build quality, sleek aesthetics and customizable sensitivity and lighting make it the top choice for players looking for an authentic arcade experience at home.

Laverita 3

Products: Without stand - With stand Vendor: YuanCon Price: $328 + Shipping/Taxes Note: Shipping is much higher for the \"with stand\" version

The Laverita 3 is YuanCon's alternative to the TASOLLER+. While it's a fully functional controller that gets the job done, its build quality doesn't quite match the premium feel of the TASOLLER+. Users should also note that the controller's performance can be affected by high humidity environments.

"},{"location":"extras/controllers/#maimai","title":"maimai","text":"ADX

Product page Vendor: YuanCon Price: $1399 + High shipping/Taxes

"},{"location":"extras/controllers/#ongeki","title":"O.N.G.E.K.I.","text":"ONTROLLER

Product page Vendor: gamo2 Price range: $399 ~ $731 + Shipping/Taxes

The ONTROLLER is currently the only arcade-accurate O.N.G.E.K.I. controller available on the market. While its high price point may be a barrier for some, the controller's excellent build quality and five available configurations make it an attractive option for players seeking an authentic arcade experience.

YUANGEKI

Product page Vendor: YuanCon Price: $222 + Shipping/Taxes

The YUANGEKI is YuanCon's compact O.N.G.E.K.I. controller. While the side buttons are positioned closer together compared to the arcade layout, the controller offers solid performance at a more affordable price point.

"},{"location":"extras/controllers/#namco","title":"NAMCO","text":""},{"location":"extras/controllers/#taiko-no-tatsujin","title":"Taiko no Tatsujin","text":"

Many of these controllers offer different configurations. Make sure to pick the correct one for the plaform(s) you plan to play on

"},{"location":"extras/controllers/#arcade-accurate","title":"Arcade-accurate","text":"ZhongTaiko

Product page Vendor: ZhongTaiko Price range: $399 ~ $599 + Shipping/Taxes

ZhongTaiko offers the highest quality full-size Taiko controllers on the market. Their Pro version perfectly replicates the feel of arcade Nijiiro cabinets, while their more affordable Standard version still outperforms a lot of contenders in build quality and responsiveness.

TDC17

Product page Vendor: rythmagica Price range: $261.95 ~ $307.95 + Shipping/Taxes

The TDC17 is a solid arcade-style Taiko controller offering good build quality and responsiveness at a competitive price point. While it does not quite matching ZhongTaiko's quality, it provides a solid and authentic arcade experience for players seeking a high-end option at a great price point.

TAIKOLLER

Product page Vendor: gamo2 Price: $329 + Shipping/Taxes

The TAIKOLLER is gamo2's arcade-style Taiko controller. It is very similar to YuanCon's TAIKO FORCE LV6, while being cheaper for customers outside of China.

TAIKO FORCE LV6

Product page Vendor: YuanCon Price range: $466 ~ $554 + Shipping/Taxes

The TAIKO FORCE LV6 is YuanCon's arcade-style Taiko controller. It is very similar to gamo2's TAIKOLLER. While the official store price is higher, it can be purchased at a significant discount through TaoBao (Chinese marketplace), though international buyers will need to use a proxy service.

"},{"location":"extras/controllers/#tatacons-much-smaller-than-arcade-but-plenty-capable","title":"Tatacons (much smaller than arcade but plenty capable)","text":"TDC10 Pro

Product page Vendor: rythmagica Price: $139.95 + Shipping/Taxes

The TDC10 Pro is a smaller, more affordable version of the TDC17. It stands out as the highest quality Tatacon controller currently available, delivering excellent build quality and responsiveness at a competitive price point. For players seeking a compact but premium Taiko controller, this is THE choice.

HORI Official Tatacons

Catalog Vendor: HORI Price range: $68 ~ 157 + Shipping/Taxes

HORI Tatacons are officially licensed controllers available for multiple platforms. While they are widely accessible, most models suffer from hit registration issues that require modifications to fix. Given these reliability concerns, we strongly recommend the TDC10 Pro as a better alternative.

IINE Tatacon

Product page Vendor: IINE Price: $55.95 + Shipping/Taxes

IINE's Tatacon is a budget alternative to HORI's official controllers. While more affordable, it shares similar hit registration problems that require modifications to resolve. For a reliable, high-quality experience, we recommend investing in the TDC10 Pro instead.

"},{"location":"extras/controllers/#in-betweens-not-quite-ac-size-not-quite-tatacon","title":"In-betweens (not quite AC-size, not quite Tatacon)","text":"IINE Taiko Pro Max

Product page Vendor: IINE Price: $180.95 + Shipping/Taxes

IINE's Taiko Pro Max comes in at an odd spot between arcade-accurate controllers and Tatacons. It feels really cheap but might do the trick if the size and price point sound good to you.

"},{"location":"extras/datamods/","title":"Modding (Konami)","text":"

Synopsis

This guide will cover how to mod your KONAMI 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
"},{"location":"extras/datamods/#installing-mod-files","title":"Installing mod files","text":"
  • Create a data_mods folder next to the others in your game files if it doesn't exist
  • Place your mod files inside data_mods in a way that respects the following structure data_mods/mod_folder/<data folders/<data_files>

You can think of the mod folder coming to overwrite your game's data folder at runtime. If you're confused, the following may help you understand what we mean.

\ud83d\udcc2data\n\u2523\u2501\ud83d\udcc2graphic\n\u2523\u2501\ud83d\udcc2info\n\u2523\u2501\ud83d\udcc2movie\n\u2517\u2501\ud83d\udcc2sound\n\ud83d\udcc2data_mods \n\u2517\u2501\ud83d\udcc2mod_folder\n   \u2523\u2501\ud83d\udcc2graphic - Files that modify data/graphic go here\n   \u2523\u2501\ud83d\udcc2info    - Files that modify data/info go here\n   \u2523\u2501\ud83d\udcc2movie   - Files that modify data/movie go here\n   \u2517\u2501\ud83d\udcc2sound   - Files that modify data/sound go here\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

Example: Omnimix for beatmania IIDX 31 EPOLIS

Directory: contents/data_mods/

Directory: contents/data_mods/omnimix_31

"},{"location":"extras/datamods/#loading-mods-data-files-ifs_layeredfs","title":"Loading mods data files (ifs_layeredfs)","text":"

Overwriting game files with mods is heavily discouraged, as there is no clean way of undoing that. This is where ifs_layeredfs comes in, to load modded data files without permanently modifying your game data.

  • Download the most recent release of ifs_layeredfs

  • Open the archive

  • 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

Follow the Injecting DLL Hooks section to load this DLL.

"},{"location":"extras/datamods/#installing-omnifix-for-iidx-omnimix-only","title":"Installing Omnifix (for IIDX Omnimix only)","text":"

Compatibility

Supported game versions For unsupported game versions, you'll have to patch Omnimix with spice2x or web patching.

Omnimix files require modification of your game DLL which can't be handled by ifs_layeredfs. This is where Omnifix comes in, as a commonly agreed upon way of loading Omnimix for beatmania IIDX.

  • Download the latest release archive for omnifix much like you did with ifs_layeredfs
  • Extract the omnifix.dll file contained in the archive to your game's modules folder

Follow the Injecting DLL Hooks section to load this DLL.

Note that Omnifix also offers optional launch parameters you may want to consider.

"},{"location":"extras/datamods/#injecting-dll-hooks","title":"Injecting DLL Hooks","text":"

Adding DLL files to your modules folder won't necessarily make them load automatically. You sometimes need to tell spice2x to load each file individually, like with the DLLs mentioned in this guide.

  • Open your game's spicecfg.exe
  • Head to the options tab
  • Find the Inject DLL Hooks option under Common
  • Add the name of the DLL file(s) you want to load inside the text box

Example: ifs_hook.dll omnifix.dll

You may list one or multiple DLL files separated by a space. The order does matter, as it dictates in which order the DLL files are loaded. We recommend loading ifs_hook.dll before all else.

"},{"location":"extras/hexguide/","title":"Game Patching (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/linux_konami/","title":"Linux (Konami)","text":"

Synopsis

Konami arcade games and associated community tooling are built to run on Windows. This guide will document the best currently known ways to get games working on Linux systems.

Compatibility

ONLY the following game and versions are confirmed to work with the process described in this guide.

Game Version(s) Caveats (if any) Sound Voltex Exceed Gear Subscreen clicks don't work DanceDanceRevolution World Mahjong Fight Girl

This guide was primarily written targetting arch-based systems running KDE and pipewire. Instructions should still be distro and DE agnostic, but your mileage may vary.

"},{"location":"extras/linux_konami/#pre-requisites","title":"Pre-requisites","text":"
  • A Linux system with:
    • pipewire as an audio backend
    • wine with wow64 included (default on arch since June 2025)
    • winetricks curl unzip installed
    • gstreamer gst-plugins-good gst-plugins-ugly gst-libav for codecs (package names may vary)
  • Compatible game data placed inside a \ud83d\udcc2contents directory
  • Your game's regular setup guide opened in another tab
Extra requirements for NixOS

spice2x requires an optional wine feature which NixOS does not enable by default. Apart from that, a patch for winetricks is needed due to weirdness with winetricks on NixOS with WoW64 wine.

To fix this, copy this to your confiuration: 

environment.systemPackages = [\n  (\n    pkgs.wine-with-pcsclite.override {\n      wineBuild = \"wineWow64\";\n    }\n  )\n];\n\nnixpkgs.overlays = [\n  (\n    final: prev: {\n      wine-with-pcsclite = prev.wine.overrideAttrs (old: {\n        buildInputs = old.buildInputs ++ [final.pcsclite];\n        configureFlags = old.configureFlags ++ [\"--with-pcsclite\"];\n      });\n      winetricks = prev.winetricks.overrideAttrs (old: {\n        patches = [\n          (final.fetchpatch {\n            # make WINE_BIN and WINESERVER_BIN overridable\n            # see https://github.com/NixOS/nixpkgs/issues/338367\n            url = \"https://github.com/Winetricks/winetricks/commit/1d441b422d9a9cc8b0a53fa203557957ca1adc44.patch\";\n            hash = \"sha256-AYXV2qLHlxuyHC5VqUjDu4qi1TcAl2pMSAi8TEp8db4=\";\n          })\n        ];\n        postInstall =\n          old.postInstall\n          + ''\n            sed -i \\\n              -e '2i : \"''${WINESERVER_BIN:=/run/current-system/sw/bin/wineserver}\"' \\\n              -e '2i : \"''${WINE_BIN:=/run/current-system/sw/bin/.wine}\"' \\\n              \"$out/bin/winetricks\"\n          '';\n      });\n    }\n  )\n];\n

"},{"location":"extras/linux_konami/#automated-setup-for-spice2x-compatible-games","title":"Automated setup (for spice2x compatible games)","text":"
  • Download the sp2x-linux-setup.sh script from NotAkitake/sp2x-linux-setup
  • Place it next to your \ud83d\udcc2contents directory contaning compatible game files
  • Make the script executable chmod +x sp2x-linux-setup.sh
  • Run the script and follow instructions
"},{"location":"extras/linux_konami/#manual-setup","title":"Manual setup","text":"

This section will mostly describe what the automated process above achieves

"},{"location":"extras/linux_konami/#installing-spice2x","title":"Installing spice2x","text":"

This process is largely the same as windows and can be found in your game's setup guide. Simply place the spice.exe or spice64.exe executable inside \ud83d\udcc2contents.

We won't need spicecfg.exe however. Instead we will later pass -cfg as a launch argument to the main spice2x executable later.

NVIDIA Stubs

For ALL graphics cards: If your game's setup guide has a Additional steps for AMD and Intel graphics cards warning in its Installing spice2x section, do what it says.

"},{"location":"extras/linux_konami/#wine-prefix","title":"Wine prefix","text":"

Double check commands

We provide ready-made command for simplicity, however don't blindy copy and execute them. ALWAYS double check command before running them, and substitute REPLACE_THIS_PATH with your own location.

"},{"location":"extras/linux_konami/#initializing","title":"Initializing","text":"

  • Create an empty \ud83d\udcc2prefix directory in the location of your choosing We advise creating a new prefix for every game and placing it next to \ud83d\udcc2contents.

  • Run the following command to initialize a new wine prefix without being prompted for mono or gecko.

WINEARCH=win64 WINEPREFIX=REPLACE_THIS_PATH/prefix WINEDLLOVERRIDES=\"mscoree=d;mshtml=d\" wineboot --init\n
"},{"location":"extras/linux_konami/#common-dependencies","title":"Common dependencies","text":"

Some dependencies are required across most games, install them to your prefix using winetricks as follows:

WINEARCH=win64 WINEPREFIX=REPLACE_THIS_PATH/prefix winetricks -q dxvk d3dcompiler_42 d3dcompiler_43 d3dcompiler_46 d3dcompiler_47\n
"},{"location":"extras/linux_konami/#game-specific-dependencies","title":"Game-specific dependencies","text":"

If there is no tab for your game, you may skip this step

Default (none)DDR

Install these to your prefix for background movies to play, otherwise the game will crash.

WINEARCH=win64 WINEPREFIX=REPLACE_THIS_PATH/prefix winetricks -q quartz devenum amstream windowscodecs\n
"},{"location":"extras/linux_konami/#optional-pipewire-audio-sink","title":"(optional) PipeWire audio sink","text":"

You can create an audio device games will accept that routes audio to your desired hardware

It may not be necessary for all games as it depends on your specific setup and game. You could try following the rest of the guide without this virtual sink first to see whether you need it or not.

  • Create the .config/pipewire/pipewire.conf.d directory in your home directory if it doesn't already exist
mkdir -p \"$HOME/.config/pipewire/pipewire.conf.d\"\n
  • Create a spice2x-sink.conf file in that directory containing:
context.modules = [\n  {\n    name = libpipewire-module-loopback\n    args = {\n      audio.position = [ FL FR ]\n      capture.props = {\n        media.class = Audio/Sink\n        audio.format = S16LE\n        audio.rate = 44100\n        audio.channels = 2\n        node.name = spice2x41\n        node.description = \"spice2x @ 44100Hz\"\n      }\n      playback.props = {\n        node.passive = true\n        node.name = spice2x41.output\n        node.description = \"SPICE2X 44100Hz OUTPUT\"\n        target.object = \"alsa_output.pci-0000_04_00.6.HiFi__hw_Generic_1__sink\"\n        audio.format = S16LE\n      }\n    }\n  }\n]\n

The audio.rate may need to be set to 48000 on a per game-basis, but for the games covered here, 44100 is fine.

The target.object set above means audio will be routed the first audio device it finds. If you have multiple audio devices available and want to make sure it outputs to a specific one, run:

pw-cli list-objects | awk '/node.name/ {name=$0} /media.class/ && /Audio\\/Sink/ {gsub(/.*= \"|\"/,\"\",name); print name}'\n

Replace the target.object device with the output line corresponding to your desired output device. For example:

target.object = \"alsa_output.usb-Focusrite_Scarlett_Solo_4th_Gen_S1APY0Z3611B4E-00.HiFi__Line1__sink\"\n
  • Finally, save and exit then restart pipewire. On systemd distros you may do it by running:
systemctl --user restart pipewire.service pipewire-pulse.socket\n
"},{"location":"extras/linux_konami/#optional-launcher-scripts","title":"(optional) Launcher scripts","text":"

This section will help you create two bash scripts you may use to start and configure your game

They are not mandatory but very handy to have, rather than remembering commands to run spice executables with the right prefix, paths, arguments, etc..

Game start

Let's create the main launch script first, which will also be used by our second script.

  • Next to your contents directory, create a launch.sh file containing:
#!/usr/bin/env bash\n# Game Launcher\n\nSCRIPT_DIR=\"$(cd \"$(dirname \"$0\")\" && pwd)\"\nexport WINEARCH=win64\nexport WINEPREFIX=\"REPLACE_THIS_PATH/prefix\"\n\n# Default arguments\nARGS=\"\"\n\n# Optional: Add arguments per line\n# ARGS=\"$ARGS -url localhost:8083\"     # Network URL\n# ARGS=\"$ARGS -p 01FXXXXXXXXXXXXXXXXX\" # PCBID\n\n# Append args to this script\nARGS=\"$ARGS $*\"\n\ncd \"$SCRIPT_DIR/contents\" || exit\nwine \"spice64.exe\" $ARGS\n

  • On the first highlighted line: make sure WINEPREFIX points to your game prefix created earlier

  • On the second highlighted line: replace spice64.exe with spice.exe if necessary

  • Make the script executable by running chmod +x launch.sh

Game config

To get a graphical interface replicating what spicecfg.exe does, we can simply call our previous script and pass -cfg as an argument.

  • Next to your previous script, create a config.sh file containing:
#!/usr/bin/env bash\n# Config Launcher\n\nSCRIPT_DIR=\"$(cd \"$(dirname \"$0\")\" && pwd)\"\n\"$SCRIPT_DIR/launch.sh\" -cfg\n

  • On the last line, make sure the file name matches the previous script

  • Make the script executable by running chmod +x config.sh

Try executing config.sh

The spice2x configuration window for your game should appear. Your game should also be detected and show in the top right!

If your game isn't detected, it's highly likely paths are wrong somewhere in your scripts.

"},{"location":"extras/linux_konami/#game-specific-last-steps","title":"Game-specific last steps","text":"

If there is no tab for your game, you may skip this step

Default (none)SDVX
  • You need to patch Shared Mode WASAPI to ensure audio comes through wine. Either use the previously created config.sh to start spicecfg, or use the command in the next section. If you don't know how patches work, follow instructions in our spice2x patching guide.

  • You need to set your monitor orientation to portait before playing

  • OR If you want to play the game windowed and keep your display in landscape orientation:

    • Create a wine_desktop.reg file containing:
    Windows Registry Editor Version 5.00\n\n[HKEY_CURRENT_USER\\Software\\Wine\\Explorer]\n\"Desktop\"=\"Default\"\n\n[HKEY_CURRENT_USER\\Software\\Wine\\Explorer\\Desktops]\n\"Default\"=\"1080x1920\"\n
    • Fix the paths in the command below and run it. Then feel free to delete the .reg file:
    WINEARCH=win64 WINEPREFIX=REPLACE_THIS_PATH/prefix wine regedit REPLACE_THIS_PATH/wine_desktop.reg\n
"},{"location":"extras/linux_konami/#whats-next","title":"What's next?","text":"

Linux-specific instructions are over

Head to your game's setup guide, straight to the \"Configuring spice2x\" section.

  • IF you opted to use the PipeWire audio sink, set it as your default audio device before starting the game
  • Skip the Configuring audio section
  • Skip any section asking you to install VCRedist and/or DirectX, our prefix takes care of that

  • Use the previously created config.sh instead of spicecfg, and launch.sh to start the game OR If you opted not to create scripts, instead use this, fixing the paths and spice executable name:

    cd REPLACE_THIS_PATH/contents && WINEARCH=win64 WINEPREFIX=REPLACE_THIS_PATH/prefix wine \"spice64.exe\" -cfg\n

    And use the same command without the -cfg argument to start the game.

"},{"location":"extras/patchsp2x/","title":"Game Patching (spice2x)","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":"Game Patching (web)","text":"

Known web patchers: Resources

For BEMANI games consider spice2x Patching

This patching method is outdated for BEMANI games.

However if your game isn't supported, follow this guide.

Before proceeding

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

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

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

For this example, we'll be using our web patcher. Almost every other patcher looks and functions exactly the same as this one.

If your game is not supported by our web patcher, 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 CHUNITHM VERSE.

Here, either:

  • Drag and drop the .dll or .exe 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 or .exe 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 file will start downloading.

Backup your original .dll or .exe file first!

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

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

"},{"location":"extras/unity/","title":"Modding (Unity)","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":"extras/zerotier/","title":"Cab-to-Cab (ZeroTier)","text":""},{"location":"extras/zerotier/#zerotier-for-cabinet-to-cabinet-play","title":"ZeroTier for Cabinet-to-Cabinet Play","text":"

Warning for CHUNITHM

CHUNITHM has stricter network requirements than other SEGA games and needs a specific subnet. In this guide, we will use the subnet 192.168.196.0 as an example. However, to run CHUNITHM, you must change it to the subnet 192.168.139.0. If you don't, cabinets set to \"FOLLOW THE STANDARD\" will fail to connect. You will also need to adjust the IPv4 Auto-Assign setting of your Zerotier network accordingly by changing 196 to 139.

"},{"location":"extras/zerotier/#installing","title":"Installing","text":"

Go to the ZeroTier download page. Download and run the Windows installer. After installation, the program will open automatically in your taskbar.

"},{"location":"extras/zerotier/#joining-a-network","title":"Joining a network","text":"

Connecting to a network

To join a network on ZeroTier, you will need its 16-digit Network ID.

  • Start ZeroTier if it's not already running
  • Right click on the ZeroTier icon in your taskbar
  • Click on \"Join New Network\"
  • Enter the Network ID
  • Click on \"Join\"

That's it!

Checking your connection

Open your Command Prompt, and run the command ipconfig Your IP address will appear under Ethernet adapter ZeroTier One [NETWORK ID] next to IPv4 Address

To check if you can successfully reach another computer on the network, run the command ping [IPv4 Address] replacing [IPv4 Address] with the IP address of the other computer, not your own.

Configuration for segatools

Edit segatools.ini with the following content:

[netnev]\nenable=1\naddrSuffix= The last segment of your ZeroTier IP address (e.g., if your IP is 192.168.196.5, set addrSuffix = 5)\n\n[keychip]\nsubnet=192.168.196.0\n\n[system]\ndipsw1=1 ;Set this to 1 on the host machine and set this to 0 on all others\n

Each person must have their own keychip

If you play on a remote network, you likely already have your own keychip. If not, you can use these example keychips: A61E-01D02321145 ; A61E-01A30831145 ; A61E-01E38091145 ; A61E-01E46241145

When starting your game, make sure to allow any Windows Firewall pop-ups (such as for amdaemon.exe, mu3.exe, chusanApp.exe...)

If you didn't see a pop-up

This could mean one of two things.

Either you have already allowed it, and cab-to-cab is working successfully. That's great! No need to change anything. Or, you denied access, and cab-to-cab isn't working. In that case follow these steps:

  • Open the Windows Control Panel
  • Click on System and Security
  • Click on Windows Defender Firewall
  • On the left side, click on Advanced settings
  • In the new window, click on Inbound Rules and look for your game's executables
  • Right click on one of them, then click on Properties
  • Select Allow the connection then press OK
  • Repeat this for all game executables

Alternatively, you can disable your firewall for both public and private networks. Please note that this should only be a temporary measure for testing, as it poses a security risk to your computer.

Configuration for spice2x

  • Open spicecfg.exe
  • Navigate to the Development tab
  • Enter your ZeroTier IP in the Preferred NetAdapter IP field
  • Enter 255.255.255.0 in the Preferred NetAdapter Subnet field
"},{"location":"extras/zerotier/#creating-a-network","title":"Creating a network","text":"
  • Go to my.zerotier.com and create an account
  • Create a network
  • Click on its name in the list to configure it

About your Network ID

Your Network ID is displayed on your account's homepage, and in the configuration menu. This allows you and others to join your network.

If your network is set to Public then anyone with it can join it. Treat it like a password.

"},{"location":"extras/zerotier/#network-configuration","title":"Network configuration","text":"

Following tabs correspond to the ones found in the configuration menu, follow both \"Basics\" and \"Advanced\"

BasicsAdvanced

Name

Either keep the default random name, or rename it to your liking.

Access Control

  • Private: This is the default option and will require you to accept people who want to join your network
  • Public: Recommended, anyone with the Network ID can join without authorization

Managed Routes

Delete the already existing entry. Under \"Add Routes\", set \"Destination\" as 192.168.196.0/24 then press \"Submit\".

IPv4 Auto-Assign

Delete the already existing entry. Under \"Add IPv4 Address Pools\" set \"Range Start\" as 192.168.196.1 and \"Range End\" as 192.168.196.254 then press \"Submit\".

You should end up with this:

"},{"location":"games/konami/beatstream/animutribe/setup/","title":"Game Setup","text":""},{"location":"games/konami/beatstream/animutribe/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/beatstream/animutribe/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/beatstream/animutribe/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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 60 Hz, the game is hardcoded to run at 60 Hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60 Hz. 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 60 Hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.

"},{"location":"games/konami/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/konami/ddr/a20/setup/","title":"Game Setup","text":""},{"location":"games/konami/ddr/a20/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

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/konami/ddr/a20/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 20 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/ddr/a20/setup/#updating-data","title":"Updating data","text":"

Please make sure you're using the right update for your current data.

DDR updates have MDX and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., MDX_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., MDX_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/ddr/a20/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

For MDX-001 (32 bits)
  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
For MDX-003 (64 bits)
  • Visit spice2x.github.io to download the latest release
  • Extract both spice64.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice64.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
"},{"location":"games/konami/ddr/a20/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

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

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

  • Maintenance: Service, Test
  • Game buttons: Up, Down, Left, Right
  • Menu buttons: Start, Up, Down, Left, Right
  • Keypad: Keypad Insert Card, 1 to 9

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

No need to change anything here

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

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/ddr/a20/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/ddr/a20/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/ddr/a20/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/ddr/a20/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/ddr/a20/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

For any issues not covered here, spice2x's Known issues page might prove useful

"},{"location":"games/konami/ddr/a20/troubleshooting/#technical-problems","title":"Technical problems","text":""},{"location":"games/konami/ddr/a20/troubleshooting/#crashes","title":"Crashes","text":"Game crashes on startup or when starting a song / No background and no music video

This is probably due to missing or incorrectly registered codecs. From version 25-08-17 of spice2x onwards, the codecs will be registered automatically when you launch the game, so please update your installation. If this does not resolve the issue, or if you do not wish to update, please follow the DDR section on the spice2x wiki.

"},{"location":"games/konami/ddr/a20/troubleshooting/#performance","title":"Performance","text":"

Check out spice2x's PC optimization guide

Game is running too slow/fast

Try to eliminate any unnecessary background processes during play and ensure your screen's framerate is set to 60 FPS.

"},{"location":"games/konami/ddr/a20/troubleshooting/#other","title":"Other","text":"Where are the option for Dancers/Shading/Measure lines/Fast-Slow/Layering?

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 our spice2x Patching guide.

"},{"location":"games/konami/ddr/a20plus/setup/","title":"Game Setup","text":""},{"location":"games/konami/ddr/a20plus/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

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/konami/ddr/a20plus/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 20 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/ddr/a20plus/setup/#updating-data","title":"Updating data","text":"

Please make sure you're using the right update for your current data.

DDR updates have MDX and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., MDX_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., MDX_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/ddr/a20plus/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

For MDX-001 (32 bits)
  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
For MDX-003 (64 bits)
  • Visit spice2x.github.io to download the latest release
  • Extract both spice64.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice64.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
"},{"location":"games/konami/ddr/a20plus/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

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

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

  • Maintenance: Service, Test
  • Game buttons: Up, Down, Left, Right
  • Menu buttons: Start, Up, Down, Left, Right
  • Keypad: Keypad Insert Card, 1 to 9

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

No need to change anything here

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

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/ddr/a20plus/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/ddr/a20plus/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/ddr/a20plus/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/ddr/a20plus/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/ddr/a20plus/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

For any issues not covered here, spice2x's Known issues page might prove useful

"},{"location":"games/konami/ddr/a20plus/troubleshooting/#technical-problems","title":"Technical problems","text":""},{"location":"games/konami/ddr/a20plus/troubleshooting/#crashes","title":"Crashes","text":"Game crashes on startup or when starting a song / No background and no music video

This is probably due to missing or incorrectly registered codecs. From version 25-08-17 of spice2x onwards, the codecs will be registered automatically when you launch the game, so please update your installation. If this does not resolve the issue, or if you do not wish to update, please follow the DDR section on the spice2x wiki.

"},{"location":"games/konami/ddr/a20plus/troubleshooting/#performance","title":"Performance","text":"

Check out spice2x's PC optimization guide

Game is running too slow/fast

Try to eliminate any unnecessary background processes during play and ensure your screen's framerate is set to 60 FPS.

"},{"location":"games/konami/ddr/a20plus/troubleshooting/#other","title":"Other","text":"Where are the option for Dancers/Shading/Measure lines/Fast-Slow/Layering?

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 our spice2x Patching guide.

"},{"location":"games/konami/ddr/a3/setup/","title":"Game Setup","text":""},{"location":"games/konami/ddr/a3/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

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/konami/ddr/a3/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 20 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/ddr/a3/setup/#updating-data","title":"Updating data","text":"

Please make sure you're using the right update for your current data.

DDR updates have MDX and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., MDX_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., MDX_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/ddr/a3/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

For MDX-001 (32 bits)
  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
For MDX-003 (64 bits)
  • Visit spice2x.github.io to download the latest release
  • Extract both spice64.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice64.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
"},{"location":"games/konami/ddr/a3/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

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

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

  • Maintenance: Service, Test
  • Game buttons: Up, Down, Left, Right
  • Menu buttons: Start, Up, Down, Left, Right
  • Keypad: Keypad Insert Card, 1 to 9

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

No need to change anything here

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

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/ddr/a3/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/ddr/a3/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/ddr/a3/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/ddr/a3/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/ddr/a3/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

For any issues not covered here, spice2x's Known issues page might prove useful

"},{"location":"games/konami/ddr/a3/troubleshooting/#technical-problems","title":"Technical problems","text":""},{"location":"games/konami/ddr/a3/troubleshooting/#crashes","title":"Crashes","text":"Game crashes on startup or when starting a song / No background and no music video

This is probably due to missing or incorrectly registered codecs. From version 25-08-17 of spice2x onwards, the codecs will be registered automatically when you launch the game, so please update your installation. If this does not resolve the issue, or if you do not wish to update, please follow the DDR section on the spice2x wiki.

"},{"location":"games/konami/ddr/a3/troubleshooting/#performance","title":"Performance","text":"

Check out spice2x's PC optimization guide

Game is running too slow/fast

Try to eliminate any unnecessary background processes during play and ensure your screen's framerate is set to 60 FPS.

"},{"location":"games/konami/ddr/a3/troubleshooting/#other","title":"Other","text":"Where are the option for Dancers/Shading/Measure lines/Fast-Slow/Layering?

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 our spice2x Patching guide.

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

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

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/konami/ddr/common/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 20 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/ddr/common/setup/#updating-data","title":"Updating data","text":"

Please make sure you're using the right update for your current data.

DDR updates have MDX and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., MDX_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., MDX_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/ddr/common/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

For MDX-001 (32 bits)
  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
For MDX-003 (64 bits)
  • Visit spice2x.github.io to download the latest release
  • Extract both spice64.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice64.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
"},{"location":"games/konami/ddr/common/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

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

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

  • Maintenance: Service, Test
  • Game buttons: Up, Down, Left, Right
  • Menu buttons: Start, Up, Down, Left, Right
  • Keypad: Keypad Insert Card, 1 to 9

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

No need to change anything here

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

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/ddr/common/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/ddr/common/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/ddr/common/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

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

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

For any issues not covered here, spice2x's Known issues page might prove useful

"},{"location":"games/konami/ddr/common/troubleshooting/#technical-problems","title":"Technical problems","text":""},{"location":"games/konami/ddr/common/troubleshooting/#crashes","title":"Crashes","text":"Game crashes on startup or when starting a song / No background and no music video

This is probably due to missing or incorrectly registered codecs. From version 25-08-17 of spice2x onwards, the codecs will be registered automatically when you launch the game, so please update your installation. If this does not resolve the issue, or if you do not wish to update, please follow the DDR section on the spice2x wiki.

"},{"location":"games/konami/ddr/common/troubleshooting/#performance","title":"Performance","text":"

Check out spice2x's PC optimization guide

Game is running too slow/fast

Try to eliminate any unnecessary background processes during play and ensure your screen's framerate is set to 60 FPS.

"},{"location":"games/konami/ddr/common/troubleshooting/#other","title":"Other","text":"Where are the option for Dancers/Shading/Measure lines/Fast-Slow/Layering?

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 our spice2x Patching guide.

"},{"location":"games/konami/ddr/world/setup/","title":"Game Setup","text":""},{"location":"games/konami/ddr/world/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

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/konami/ddr/world/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 20 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/ddr/world/setup/#updating-data","title":"Updating data","text":"

Please make sure you're using the right update for your current data.

DDR updates have MDX and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., MDX_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., MDX_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/ddr/world/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

For MDX-001 (32 bits)
  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
For MDX-003 (64 bits)
  • Visit spice2x.github.io to download the latest release
  • Extract both spice64.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice64.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
"},{"location":"games/konami/ddr/world/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

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

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

  • Maintenance: Service, Test
  • Game buttons: Up, Down, Left, Right
  • Menu buttons: Start, Up, Down, Left, Right
  • Keypad: Keypad Insert Card, 1 to 9

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

No need to change anything here

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

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/ddr/world/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/ddr/world/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/ddr/world/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/ddr/world/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/ddr/world/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

For any issues not covered here, spice2x's Known issues page might prove useful

"},{"location":"games/konami/ddr/world/troubleshooting/#technical-problems","title":"Technical problems","text":""},{"location":"games/konami/ddr/world/troubleshooting/#crashes","title":"Crashes","text":"Game crashes on startup or when starting a song / No background and no music video

This is probably due to missing or incorrectly registered codecs. From version 25-08-17 of spice2x onwards, the codecs will be registered automatically when you launch the game, so please update your installation. If this does not resolve the issue, or if you do not wish to update, please follow the DDR section on the spice2x wiki.

"},{"location":"games/konami/ddr/world/troubleshooting/#performance","title":"Performance","text":"

Check out spice2x's PC optimization guide

Game is running too slow/fast

Try to eliminate any unnecessary background processes during play and ensure your screen's framerate is set to 60 FPS.

"},{"location":"games/konami/ddr/world/troubleshooting/#other","title":"Other","text":"Where are the option for Dancers/Shading/Measure lines/Fast-Slow/Layering?

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 our spice2x Patching guide.

"},{"location":"games/konami/gitadora/exchain/setup/","title":"Game Setup","text":""},{"location":"games/konami/gitadora/exchain/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/gitadora/exchain/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/gitadora/exchain/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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 60 Hz, the game is hardcoded to run at 60 Hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60 Hz. 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 60 Hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/gitadora/fuzzup/setup/","title":"Game Setup","text":""},{"location":"games/konami/gitadora/fuzzup/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/gitadora/fuzzup/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a Network section

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/gitadora/fuzzup/setup/#pre-launch-requirements","title":"Pre-launch Requirements","text":"

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

"},{"location":"games/konami/gitadora/fuzzup/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/konami/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/konami/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/konami/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/konami/gitadora/fuzzup/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/konami/gitadora/fuzzup/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/gitadora/fuzzup/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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 60 Hz. This is a requirement for the game to run at the correct speed. The game is hardcoded to run at 60 Hz 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/konami/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/konami/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/konami/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/konami/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/konami/gitadora/matixx/setup/","title":"Game Setup","text":""},{"location":"games/konami/gitadora/matixx/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/gitadora/matixx/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/gitadora/matixx/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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 60 Hz, the game is hardcoded to run at 60 Hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60 Hz. 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 60 Hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/10thstyle/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/10thstyle/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/iidx/10thstyle/setup/#configuring-bemanitools","title":"Configuring Bemanitools","text":"

To configure your keybinds, open your config.bat file

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/10thstyle/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/iidx/10thstyle/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/10thstyle/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/11_red/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/11_red/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/iidx/11_red/setup/#configuring-bemanitools","title":"Configuring Bemanitools","text":"

To configure your keybinds, open your config.bat file

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/11_red/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/11_red/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/12_happysky/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/12_happysky/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/iidx/12_happysky/setup/#configuring-bemanitools","title":"Configuring Bemanitools","text":"

To configure your keybinds, open your config.bat file

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/12_happysky/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/12_happysky/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/13_distorted/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/13_distorted/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/iidx/13_distorted/setup/#configuring-bemanitools","title":"Configuring Bemanitools","text":"

To configure your keybinds, open your config.bat file

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/13_distorted/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/13_distorted/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/14_gold/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/14_gold/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/iidx/14_gold/setup/#configuring-bemanitools","title":"Configuring Bemanitools","text":"

To configure your keybinds, open your config.bat file

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/14_gold/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/14_gold/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/16_empress/extras/","title":"Extra Information","text":""},{"location":"games/konami/iidx/16_empress/extras/#extra-information","title":"Extra Information","text":""},{"location":"games/konami/iidx/16_empress/extras/#output-modes","title":"Output modes","text":"

Output Mode

This game supports two output modes: S-VIDEO and VGA. The difference between these two is:

  • S-VIDEO runs at 59.95hz
  • VGA runs at 60.05hz

By default, the output mode is set automatically by the game.

If for some reason you want to change the output mode of your game, do the following:

Open your iidxhook-xx.conf. Find a line that says: 

gfx.frame_rate_limit=xx.xx\n

  • Depending on the output mode of your choice, replace xx.xx with either 59.95 or 60.05

Now, in the service menu of your game:

  • Go to GAME OPTIONS

  • Go to the line that says OUTPUT MODE and change it to your desired mode

  • Select SAVE AND EXIT

That's it!

"},{"location":"games/konami/iidx/16_empress/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/16_empress/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/iidx/16_empress/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 26 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like:

\ud83d\udcc2yyyymmddrr (revision directory, y = year digit, m = month digit, d = day digit, r = revision digit)\n\ud83d\udcc2data\n\ud83d\udcc4sidcode.txt\n
"},{"location":"games/konami/iidx/16_empress/setup/#installing-bemanitools","title":"Installing Bemanitools","text":"

  • Download the latest Bemanitools release here

  • Inside bemanitools-x.xx.zip locate iidx-14-to-17.zip

  • Extract all files from iidx-14-to-17.zip to your revision directory (yyyymmddrr)

You may delete the gamestart-[14,15,17].bat and iidxhook-[14,15,17].conf files as you only need the ones for 16 (Empress)

  • Download the latest Bemanitools supplements release here

  • Inside bemanitools-supplement-vx.x.zip locate misc.zip

  • Inside misc\\d3d8to9\\, extract d3d8.dll to your revision directory

This lets you configure graphics options inside iidxhook-xx.conf (xx being your game version number)

For background movies to work, you need to install and register a codec.

This also applies for IIDX 12 to 18, if you'd done it before you shouldn't need to again and may skip this step.

  • Inside bemanitools-supplement-vx.x.zip locate and open iidx.zip

  • Inside iidx\\misc\\, extract CLVSD.ax to any directory where the file can stay long term As an example we will be using your Documents folder, but it really could be anywhere you prefer.

  • Open a command prompt as administrator, and run regsvr32 \"CHOSEN_PATH\\CLVSD.ax\" For the Documents folder, the command would be regsvr32 \"C:\\Users\\YOUR_USERNAME\\Documents\\CLVSD.ax\"

You should get confirmation that the file has been registered successfully.

If an error occurs, you most likely didn't start your command prompt as administrator, or the location to CLVSD.ax was incorrect.

In the end, here's what the expected data structure should look like:

\ud83d\udcc4bm2dx.exe\n\ud83d\udcc4config.bat\n\ud83d\udcc4config.exe\n\ud83d\udcc4d3d8.dll\n\ud83d\udcc4d3dx9_24.dll\n\ud83d\udcc4dbghelp.dll\n\ud83d\udcc4eamio.dll\n\ud83d\udcc4gamestart-16.bat\n\ud83d\udcc4gcidata.nsd\n\ud83d\udcc4geninput.dll\n\ud83d\udcc4iidxhook3.dll\n\ud83d\udcc4iidxhook-16.conf\n\ud83d\udcc4iidxio.dll\n\ud83d\udcc4inject.exe\n\ud83d\udcc4libacio.dll\n\ud83d\udcc4libavs-win32.dll\n\ud83d\udcc4libavs-win32-ea3.dll\n\ud83d\udcc4vefx.txt\n\ud83d\udcc4vefxio.dll\n
"},{"location":"games/konami/iidx/16_empress/setup/#configuring-bemanitools","title":"Configuring Bemanitools","text":"

Open the config.bat file. The following tabs correspond to the ones in the configuration window.

ButtonsLightsAnalogsNetwork

This tab is used to bind your keyboard and controller buttons

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.

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • In Device, pick your controller
  • In Game Light, select the corresponding button that will be used for that light
  • Repeat for your other lights

This tab is used to bind analog controls like the turntable

Ignore this tab if you play with a keyboard

Bind your controller's turntable

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

This tab lets you configure which cards are used to save your game profile to

If you haven't generated a card number before, you can grab one from here

Now we will set up our PIN pad and card.

  • Click on Keyboard device for whichever player's card reader you want to use
  • 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 Keypad status will change (the number and location of the number does not matter, it only matters that it changed)
  • Create a .txt file in a location that is easily accessible, and name it however you like
  • Inside the file, paste in your card number. Example: E0045812F8AFB2DE
  • Point to the file you created by clicking Browse... and selecting it

If you don't have a numpad, tick Use top keyboard row for PIN pad input. This will also change the Card In button to Backspace

"},{"location":"games/konami/iidx/16_empress/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open iidxhook-xx.conf (xx being your game version) with a text editor

  • In the line eamuse.server=localhost:80, replace localhost:80 with your provided network url

  • In the lines eamuse.pcbid=XXXXXXXXXXXXXXXXXXXX and eamuse.eamid=XXXXXXXXXXXXXXXXXXXX, replace the part after = with your provided PCBID

  • Example: 

    # 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=http://be.ma.ni/\n\n# PCBID\neamuse.pcbid=ABMYPRECIOUSPCBIDCDE\n\n# EAMID\neamuse.eamid=ABMYPRECIOUSPCBIDCDE\n

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open iidxhook-xx.conf (xx being your game version) with a text editor

  • In the line eamuse.server=localhost:80, replace localhost:80 to point to your asphyxia server, typically localhost:8083

  • Example: 

    # 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:8083\n

"},{"location":"games/konami/iidx/16_empress/setup/#configuring-graphics","title":"Configuring graphics","text":"

  • Open your iidxhook-xx.conf (xx being your game version)

  • Locate and change the options we're interested in:

gfx.framed=false                    # Only matters if windowed. False for borderless, True for decorations (title bar, etc..)\ngfx.frame_rate_limit=0.0            # Set this to 59.95\ngfx.windowed=false                  # False for fullscreen, True for windowed\ngfx.window_width=0                  # Set to your desired game width (recommended: monitor width)\ngfx.window_height=0                 # Set to your desired game height (recommended: monitor height)\ngfx.scale_back_buffer_width=0       # Set to your desired game width (recommended: monitor width)\ngfx.scale_back_buffer_height=0      # Set to your desired game height (recommended: monitor height)\ngfx.scale_back_buffer_filter=none   # Set to point or linear (pick one from examples below)\n

Here are visual examples of the two filter options:

point (sharp, pixel perfect)

linear (less sharp, not pixel perfect)

"},{"location":"games/konami/iidx/16_empress/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/iidx/16_empress/setup/#first-launch","title":"First launch","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 as Administrator.

If it's your first time running the game, you'll soon be greeted with this screen.

Press your Test key to initialize the backup data, a message will pop up stating it's been initialized.

If right here you get USB I/O ERROR ERROR(FM TRNS-OUT) or USB I/O ERROR ERROR(FM-DL TIMEOUT) instead of the BACKUP DATA ERROR, reboot the game and it should get fixed.

Next, you'll get another error.

Press your Test key again and let the game run for a bit until the monitor check is complete.

You will now 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.

Go to NETWORK OPTIONS then e-AMUSEMENT SETTINGS.

You will need to set a shop name.

  • Name your shop to whatever you'd like. Again, navigation instructions are at the bottom of the screen
  • Go to EXIT then SAVE AND EXIT

Select GAME OPTIONS.

Here, you want to select a display type.

This setting affects timing offset in the song.

  • TYPE A: No frame offset - Intended for CRT displays
  • TYPE B: +1 frame offset - Intended for LCD displays

We recommend starting with TYPE B and changing this later if you encounter any issues.

  • Go to SAVE AND EXIT then GAME MODE

You're all done! The game should load up properly now. Insert credits by pressing your SERVICE key!

"},{"location":"games/konami/iidx/16_empress/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/iidx/16_empress/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/16_empress/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you get any error codes that weren't listed in the guides here, check out the Bemanitools docs

"},{"location":"games/konami/iidx/16_empress/troubleshooting/#technical-problems","title":"Technical problems","text":""},{"location":"games/konami/iidx/16_empress/troubleshooting/#crashes","title":"Crashes","text":"

Riva Tuner Statistics Server (RTSS) and MSI Afterburner are known to cause odd crashes.If you have them installed, close them both before starting any arcade game

I'm using a laptop with a hybrid internal+dedicated GPU setup

Laptops often have odd issues running data. The game may open on the wrong monitor, run at the wrong resolution or framerate, or simply crashes.

There is currently no known fix for this, other than maybe playing in windowed mode, or using a desktop PC instead.

"},{"location":"games/konami/iidx/16_empress/troubleshooting/#performance","title":"Performance","text":"Game is running too slow/fast

Your game is likely running at an incorrect framerate. The expected framerates is 59.95fps for S-VIDEO output mode, and 60.05fps for VGA output mode.

For more information regarding output modes, check out the Extra Information page

Try these steps to resolve framerate issues:

  • Double-check that your selected output mode in the service menu matches the refresh rate in your iidxhook-xx.conf file.
  • Close any software that can affect framerates (like RTSS)
  • Close unnecessary background programs
  • Ensure V-SYNC is not forcefully disabled in your graphics card control panel

If issues persist:

  • Double-check that you followed all steps in the setup guide correctly
  • Your data may be corrupt in one way or another, you could try starting from scratch using trusted data sources

For issues with desync, check out the Bemanitools IIDX syncbook

"},{"location":"games/konami/iidx/16_empress/troubleshooting/#other","title":"Other","text":"Background videos not working

The CLVSD codec is not registered. Follow the instructions in the setup guide.

"},{"location":"games/konami/iidx/24_sinobuz/extras/","title":"Extra Information","text":""},{"location":"games/konami/iidx/24_sinobuz/extras/#extra-information","title":"Extra Information","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/iidx/24_sinobuz/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

You should never change this. It should always say A for SINOBUZ.

<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\">2017082800</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/konami/iidx/24_sinobuz/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/24_sinobuz/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/iidx/24_sinobuz/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 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/konami/iidx/24_sinobuz/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/konami/iidx/24_sinobuz/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

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

"},{"location":"games/konami/iidx/24_sinobuz/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: 1 to 9, 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/konami/iidx/24_sinobuz/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/konami/iidx/24_sinobuz/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/konami/iidx/24_sinobuz/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/konami/iidx/24_sinobuz/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section

"},{"location":"games/konami/iidx/24_sinobuz/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/konami/iidx/24_sinobuz/setup/#api","title":"API","text":"

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

"},{"location":"games/konami/iidx/24_sinobuz/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the its name with your mouse

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/konami/iidx/24_sinobuz/setup/#advanced-development","title":"Advanced & Development","text":"

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

"},{"location":"games/konami/iidx/24_sinobuz/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/konami/iidx/24_sinobuz/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

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

"},{"location":"games/konami/iidx/24_sinobuz/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/konami/iidx/24_sinobuz/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/konami/iidx/24_sinobuz/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page

"},{"location":"games/konami/iidx/24_sinobuz/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 spice.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/konami/iidx/24_sinobuz/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/konami/iidx/24_sinobuz/setup/#definition-type","title":"DEFINITION TYPE","text":"

Go to GAME OPTIONS then DEFINITION TYPE.

Choose either HD or HD* depending on your preferences.

HD* adds +1.0 offset in-game, while HD doesn't.

Once done selecting, select YES then SAVE AND EXIT.

"},{"location":"games/konami/iidx/24_sinobuz/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/konami/iidx/24_sinobuz/setup/#carding-in","title":"Carding in","text":"

To card into the game:

  1. Press your Keypad Insert Card button.
  2. Enter your code using your keypad binds.
"},{"location":"games/konami/iidx/24_sinobuz/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/konami/iidx/24_sinobuz/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/24_sinobuz/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/iidx/24_sinobuz/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/konami/iidx/24_sinobuz/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/konami/iidx/24_sinobuz/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/konami/iidx/24_sinobuz/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/konami/iidx/25_cannonballers/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/25_cannonballers/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/25_cannonballers/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/25_cannonballers/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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 60 Hz, the game is hardcoded to run at 60 Hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60 Hz. 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 60 Hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/26_rootage/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/26_rootage/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/26_rootage/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/26_rootage/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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 60 Hz, the game is hardcoded to run at 60 Hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60 Hz. 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 60 Hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/27_heroicverse/extras/","title":"Extra Information","text":""},{"location":"games/konami/iidx/27_heroicverse/extras/#extra-information","title":"Extra Information","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/iidx/27_heroicverse/extras/#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/konami/iidx/27_heroicverse/extras/#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/konami/iidx/27_heroicverse/extras/#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/konami/iidx/27_heroicverse/extras/#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/konami/iidx/27_heroicverse/extras/#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/konami/iidx/27_heroicverse/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/27_heroicverse/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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 in the Extra Information

"},{"location":"games/konami/iidx/27_heroicverse/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/27_heroicverse/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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 60 Hz or 120 Hz 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 60 Hz or TDJ 120 Hz 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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/30_resident/extras/","title":"Extra Information","text":""},{"location":"games/konami/iidx/30_resident/extras/#extra-information","title":"Extra Information","text":""},{"location":"games/konami/iidx/30_resident/extras/#standard-and-lightning-modes","title":"Standard and Lightning modes","text":"

Lightning mode requires a 120 Hz 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, 60 Hz)
  • E for Standard (LDJ-012, LDJ, 60 Hz)
  • D for Lightning (LDJ-010, TDJ, 120 Hz)
"},{"location":"games/konami/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/konami/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\">2023090500</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/konami/iidx/30_resident/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/30_resident/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/iidx/30_resident/setup/#standard-and-lightning-modes","title":"Standard and Lightning modes","text":"

Before proceeding with the setup, it's important to understand the two cabinet types for IIDX:

  • Lightning (TDJ/LDJ-010):

    • Runs at 120 FPS
    • Requires a 120 Hz main monitor
    • Optional second touchscreen 60 Hz monitor called a subscreen

  • Standard/Legacy (LDJ/LDJ-003/LDJ-012):

    • Runs at 60 FPS
    • Requires a 60 Hz main monitor
    • No subscreen

The game data comes in three variants based on the bm2dx.dll file. You can patch an LDJ dll to run in TDJ mode, but this will disable video recording.

For simplicity, we'll use \"TDJ\" for Lightning Mode and \"LDJ\" for Standard Mode throughout our guides.

"},{"location":"games/konami/iidx/30_resident/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 95 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/iidx/30_resident/setup/#updating-data","title":"Updating data","text":"

Make sure you're using the right update for your current game version

IIDX updates have LDJ and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., LDJ_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., LDJ_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/iidx/30_resident/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice64.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice64.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
Additional steps for AMD and Intel graphics cards

Since KONAMI games are designed for NVIDIA GPU's, AMD and Intel users need additional files:

  • Locate the spice2x\\stubs\\64\\ folder in the spice2x archive
  • Extract all .dll files from there into your game's modules folder
"},{"location":"games/konami/iidx/30_resident/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

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

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

  • Maintenance: Service, Test
  • Game buttons: SW1 to SW7, Start, EFFECT, VEFX
  • Keypad: Keypad Insert Card, 1 to 9

Only if you play with a keyboard:

  • Turntable: TT+, TT- and optionally TT+/- which alternates between TT+ and TT- on each press.

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

This tab is used to bind analog controls like the turntable

Ignore this tab if you play with a keyboard

Bind your controller's turntable

With a controller, instead of binding TT+ or TT- in the Buttons tab, you need to:

  • Click Bind
  • In Device, pick your controller
  • In Control, pick the control that updates the preview when turning the turntable, typically X
  • Click Close, leaving the rest of the settings alone

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

Important

Enable IIDX Disable Cameras (-iidxdisablecams) unless you have a webcam connected and wish to use it with the camera hook from the advanced tab.

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

Optional: Enabling TDJ (Lightning mode)

You may want to enable IITX TDJ Mode (-iidxtdj) if your main monitor is 120 Hz capable.

Optional: Camera hook

With a webcam connected, you can:

  • Enable IIDX Cam Hook (-iidxtdjcamhook)
  • Make sure IIDX Disable Cameras (-iidxdisablecams) from the Options tab is disabled
  • Optionally enable IIDX Camera Order Flip (-iidxflipcams) if you have two cameras connected and the wrong one is being used

This allows spice2x to try and interface with your webcam to enable camera functionality in the game.

You can then bind a button to the Camera Control overlay in the Overlay tab to adjust camera settings.

No need to change anything here

"},{"location":"games/konami/iidx/30_resident/setup/#configuring-audio","title":"Configuring audio","text":"

Check out our general Audio guide to understand audio modes better, at least the TL;DR

  • 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

Then, depending follow instructions for your desired audio mode:

Setup for WASAPI Exclusive (default)
  • Check both boxes under Exclusive Mode
  • Open the Default Format dropdown
  • Pick the 16 bit, 44100 Hz (CD Quality) option, click Apply then OK
Setup for WASAPI Shared
  • Open the Default Format dropdown
  • Pick the 16 bit, 48000 Hz (DVD Quality) option, click Apply then OK
  • Return to spicecfg, go to the Patches tab
  • Following the patching guide and patch Shared Mode WASAPI

Optionally: go to the Options tab, and at the very bottom enable Low Latency Shared Audio to help mitigate the latency penalty from using Shared audio.

Setup for ASIO (requires specialized hardware)
  • Check both boxes under Exclusive Mode
  • Open the Default Format dropdown
  • Pick the 16 bit, 44100 Hz (CD Quality) option, click Apply then OK
"},{"location":"games/konami/iidx/30_resident/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/iidx/30_resident/setup/#configuring-your-game","title":"Configuring your game","text":"

Read through the Extra Information page

"},{"location":"games/konami/iidx/30_resident/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/iidx/30_resident/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/iidx/30_resident/setup/#first-launch","title":"First launch","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.

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.

Press your Test key again and let the game run for a bit until the monitor check is complete.

You will now 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.

Go to NETWORK OPTIONS then SHOP NAME SETTING.

You will need to set a shop name.

  • Name your shop to whatever you'd like. Again, navigation instructions 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/konami/iidx/30_resident/setup/#carding-in","title":"Carding in","text":"

Before carding in, you have the option to change the game's language by pressing your EFFECT key

For LDJ (Standard mode)

LDJ should accept keypad number binds:

  • Press your Keypad Insert Card button.
  • Enter your code using your keypad binds.
For TDJ (Lightning mode)

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/konami/iidx/30_resident/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/iidx/30_resident/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/30_resident/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

For any issues not covered here, spice2x's Known issues page might prove useful

"},{"location":"games/konami/iidx/30_resident/troubleshooting/#technical-problems","title":"Technical problems","text":""},{"location":"games/konami/iidx/30_resident/troubleshooting/#crashes","title":"Crashes","text":"

Riva Tuner Statistics Server (RTSS) and MSI Afterburner are known to cause odd crashes.If you have them installed, close them both before starting any arcade game

W:SuperstepSound: Audio device is not available!!! in logs

  • Open log.txt using an editor that supports SHIFT-JIS encoding for Japanese text (like Notepad++)

  • Search for Superstep

If you find a line with Audio device is not available!!!, it means the game refuses to boot due to a misconfigured or missing audio device. Check the setup guide's Configuring audio section as well as our general Audio guide to understand the issue better.

I'm using a laptop with a hybrid internal+dedicated GPU setup

Laptops often have odd issues running data. The game may open on the wrong monitor, run at the wrong resolution or framerate, or simply crashes.

There is currently no known fix for this, other than maybe playing in windowed mode, or using a desktop PC instead.

"},{"location":"games/konami/iidx/30_resident/troubleshooting/#performance","title":"Performance","text":"

Check out spice2x's PC optimization guide

Game is running too slow/fast / Monitor error 5-1503-0043

Your game is likely running at an incorrect framerate. The expected framerates are:

  • Legacy cab mode: 60 FPS
  • Lightning Model cab mode: 120 FPS

Try these steps to resolve framerate issues:

  • Make sure that your patch or DLL matches your cab mode
  • Close any software that can affect framerates (like RTSS)
  • Close unnecessary background programs
  • Ensure V-SYNC is not forcefully disabled in your graphics card control panel
  • For NVIDIA users: Enable NVIDIA profile optimization (-nvprofile) in spicecfg's Options tab

If issues persist:

  • Double-check that you followed all steps in the setup guide correctly
  • Your PC hardware might be insufficient to keep a steady 120 FPS, you can try switching to Legacy cab mode
  • Your data may be corrupt in one way or another, you could try starting from scratch using trusted data sources
"},{"location":"games/konami/iidx/30_resident/troubleshooting/#audio","title":"Audio","text":"

Check out our Audio guide to understand audio modes better

Ensure your default audio device's sample rate is set properly

  • 44100 Hz sample rate for WASAPI Exclusive and ASIO
  • 48000 Hz if your game is patched with Shared Mode WASAPI
I can't change my device's sample rate

If you're using gaming peripherals (Logitech/Razer/Steelseries) or external audio devices (audio interfaces/sound bars):

  • Check if you can modify the sample rate in the device's software/control panel
  • If not, try uninstalling the device's software. This may restore control over Windows audio settings

If you still can't change the sample rate:

  • Configure the game's audio mode to match your device's current sample rate instead
  • Try using a different audio device
I can't hear anything else than the game

Your game's audio is setup to run in WASAPI Exclusive or ASIO modes.

Check out our Audio guide to understand audio modes better.

If you're using WASAPI Exclusive, you'll want to patch the game with Shared Mode WASAPI to hear other applications.

If you're using ASIO, unless your audio interface mixes WASAPI and ASIO streams when outputting, you'll only be able to hear one application when ASIO is in use. In this case, you'll need to route all audio through software such as Voicemeeter, and have Voicemeeter output the mix to your ASIO device.

Game audio is too quiet

When using TDJ mode the audio is very quiet by default. To mitigate this, you can use the Increase Game Volume patch.

"},{"location":"games/konami/iidx/30_resident/troubleshooting/#subscreen","title":"Subscreen","text":"

For more in-depth troubleshooting, refer to the spice2x Subscreen troubleshooting page

Touch input isn't being registered

If you're using a physical touch screen, make sure to close all spice2x overlays, including the FPS counter. If you're using the virtual subscreen, ensure that the -iidxnativetouch option is not enabled.

"},{"location":"games/konami/iidx/31_epolis/extras/","title":"Extra Information","text":""},{"location":"games/konami/iidx/31_epolis/extras/#extra-information","title":"Extra Information","text":""},{"location":"games/konami/iidx/31_epolis/extras/#standard-and-lightning-modes","title":"Standard and Lightning modes","text":"

Lightning mode requires a 120 Hz 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, 60 Hz)
  • D for Lightning (LDJ-010, TDJ, 120 Hz)
"},{"location":"games/konami/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/konami/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 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/konami/iidx/31_epolis/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/31_epolis/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/iidx/31_epolis/setup/#standard-and-lightning-modes","title":"Standard and Lightning modes","text":"

Before proceeding with the setup, it's important to understand the two cabinet types for IIDX:

  • Lightning (TDJ/LDJ-010):

    • Runs at 120 FPS
    • Requires a 120 Hz main monitor
    • Optional second touchscreen 60 Hz monitor called a subscreen

  • Standard/Legacy (LDJ/LDJ-012):

    • Runs at 60 FPS
    • Requires a 60 Hz main monitor
    • No subscreen

The game data comes in two variants based on the bm2dx.dll file. You can patch an LDJ dll to run in TDJ mode, but this will disable video recording.

For simplicity, we'll use \"TDJ\" for Lightning Mode and \"LDJ\" for Standard Mode throughout our guides.

"},{"location":"games/konami/iidx/31_epolis/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 100 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/iidx/31_epolis/setup/#updating-data","title":"Updating data","text":"

Make sure you're using the right update for your current game version

IIDX updates have LDJ and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., LDJ_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., LDJ_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/iidx/31_epolis/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice64.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice64.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
Additional steps for AMD and Intel graphics cards

Since KONAMI games are designed for NVIDIA GPU's, AMD and Intel users need additional files:

  • Locate the spice2x\\stubs\\64\\ folder in the spice2x archive
  • Extract all .dll files from there into your game's modules folder
"},{"location":"games/konami/iidx/31_epolis/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

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

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

  • Maintenance: Service, Test
  • Game buttons: SW1 to SW7, Start, EFFECT, VEFX
  • Keypad: Keypad Insert Card, 1 to 9

Only if you play with a keyboard:

  • Turntable: TT+, TT- and optionally TT+/- which alternates between TT+ and TT- on each press.

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

This tab is used to bind analog controls like the turntable

Ignore this tab if you play with a keyboard

Bind your controller's turntable

With a controller, instead of binding TT+ or TT- in the Buttons tab, you need to:

  • Click Bind
  • In Device, pick your controller
  • In Control, pick the control that updates the preview when turning the turntable, typically X
  • Click Close, leaving the rest of the settings alone

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

Important

Enable IIDX Disable Cameras (-iidxdisablecams) unless you have a webcam connected and wish to use it with the camera hook from the advanced tab.

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

Optional: Enabling TDJ (Lightning mode)

You may want to enable IITX TDJ Mode (-iidxtdj) if your main monitor is 120 Hz capable.

Optional: Camera hook

With a webcam connected, you can:

  • Enable IIDX Cam Hook (-iidxtdjcamhook)
  • Make sure IIDX Disable Cameras (-iidxdisablecams) from the Options tab is disabled
  • Optionally enable IIDX Camera Order Flip (-iidxflipcams) if you have two cameras connected and the wrong one is being used

This allows spice2x to try and interface with your webcam to enable camera functionality in the game.

You can then bind a button to the Camera Control overlay in the Overlay tab to adjust camera settings.

No need to change anything here

"},{"location":"games/konami/iidx/31_epolis/setup/#configuring-audio","title":"Configuring audio","text":"

Check out our general Audio guide to understand audio modes better, at least the TL;DR

  • 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

Then, depending follow instructions for your desired audio mode:

Setup for WASAPI Exclusive (default)
  • Check both boxes under Exclusive Mode
  • Open the Default Format dropdown
  • Pick the 16 bit, 44100 Hz (CD Quality) option, click Apply then OK
Setup for WASAPI Shared
  • Open the Default Format dropdown
  • Pick the 16 bit, 48000 Hz (DVD Quality) option, click Apply then OK
  • Return to spicecfg, go to the Patches tab
  • Following the patching guide and patch Shared Mode WASAPI

Optionally: go to the Options tab, and at the very bottom enable Low Latency Shared Audio to help mitigate the latency penalty from using Shared audio.

Setup for ASIO (requires specialized hardware)
  • Check both boxes under Exclusive Mode
  • Open the Default Format dropdown
  • Pick the 16 bit, 44100 Hz (CD Quality) option, click Apply then OK
"},{"location":"games/konami/iidx/31_epolis/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/iidx/31_epolis/setup/#configuring-your-game","title":"Configuring your game","text":"

Read through the Extra Information page

"},{"location":"games/konami/iidx/31_epolis/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/iidx/31_epolis/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/iidx/31_epolis/setup/#first-launch","title":"First launch","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.

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.

Press your Test key again and let the game run for a bit until the monitor check is complete.

You will now 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.

Go to NETWORK OPTIONS then SHOP NAME SETTING.

You will need to set a shop name.

  • Name your shop to whatever you'd like. Again, navigation instructions 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/konami/iidx/31_epolis/setup/#carding-in","title":"Carding in","text":"

Before carding in, you have the option to change the game's language by pressing your EFFECT key

For LDJ (Standard mode)

LDJ should accept keypad number binds:

  • Press your Keypad Insert Card button.
  • Enter your code using your keypad binds.
For TDJ (Lightning mode)

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/konami/iidx/31_epolis/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/iidx/31_epolis/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/31_epolis/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

For any issues not covered here, spice2x's Known issues page might prove useful

"},{"location":"games/konami/iidx/31_epolis/troubleshooting/#technical-problems","title":"Technical problems","text":""},{"location":"games/konami/iidx/31_epolis/troubleshooting/#crashes","title":"Crashes","text":"

Riva Tuner Statistics Server (RTSS) and MSI Afterburner are known to cause odd crashes.If you have them installed, close them both before starting any arcade game

W:SuperstepSound: Audio device is not available!!! in logs

  • Open log.txt using an editor that supports SHIFT-JIS encoding for Japanese text (like Notepad++)

  • Search for Superstep

If you find a line with Audio device is not available!!!, it means the game refuses to boot due to a misconfigured or missing audio device. Check the setup guide's Configuring audio section as well as our general Audio guide to understand the issue better.

EXCEPTION_ILLEGAL_INSTRUCTION in logs

  • Open log.txt using an editor that supports SHIFT-JIS encoding for Japanese text (like Notepad++)

  • Search for EXCEPTION_ILLEGAL_INSTRUCTION

beatmania IIDX 31 and above require a CPU that is AVX2 capable. If you encounter this message, it may indicate that your CPU is too old and does not support AVX2. A known workaround is renaming/deleting the movies folder to prevent the game from loading them altogether.

I'm using a laptop with a hybrid internal+dedicated GPU setup

Laptops often have odd issues running data. The game may open on the wrong monitor, run at the wrong resolution or framerate, or simply crashes.

There is currently no known fix for this, other than maybe playing in windowed mode, or using a desktop PC instead.

"},{"location":"games/konami/iidx/31_epolis/troubleshooting/#performance","title":"Performance","text":"

Check out spice2x's PC optimization guide

Game is running too slow/fast / Monitor error 5-1503-0043

Your game is likely running at an incorrect framerate. The expected framerates are:

  • Legacy cab mode: 60 FPS
  • Lightning Model cab mode: 120 FPS

Try these steps to resolve framerate issues:

  • Make sure that your patch or DLL matches your cab mode
  • Close any software that can affect framerates (like RTSS)
  • Close unnecessary background programs
  • Ensure V-SYNC is not forcefully disabled in your graphics card control panel
  • For NVIDIA users: Enable NVIDIA profile optimization (-nvprofile) in spicecfg's Options tab

If issues persist:

  • Double-check that you followed all steps in the setup guide correctly
  • Your PC hardware might be insufficient to keep a steady 120 FPS, you can try switching to Legacy cab mode
  • Your data may be corrupt in one way or another, you could try starting from scratch using trusted data sources
"},{"location":"games/konami/iidx/31_epolis/troubleshooting/#audio","title":"Audio","text":"

Check out our Audio guide to understand audio modes better

Ensure your default audio device's sample rate is set properly

  • 44100 Hz sample rate for WASAPI Exclusive and ASIO
  • 48000 Hz if your game is patched with Shared Mode WASAPI
I can't change my device's sample rate

If you're using gaming peripherals (Logitech/Razer/Steelseries) or external audio devices (audio interfaces/sound bars):

  • Check if you can modify the sample rate in the device's software/control panel
  • If not, try uninstalling the device's software. This may restore control over Windows audio settings

If you still can't change the sample rate:

  • Configure the game's audio mode to match your device's current sample rate instead
  • Try using a different audio device
I can't hear anything else than the game

Your game's audio is setup to run in WASAPI Exclusive or ASIO modes.

Check out our Audio guide to understand audio modes better.

If you're using WASAPI Exclusive, you'll want to patch the game with Shared Mode WASAPI to hear other applications.

If you're using ASIO, unless your audio interface mixes WASAPI and ASIO streams when outputting, you'll only be able to hear one application when ASIO is in use. In this case, you'll need to route all audio through software such as Voicemeeter, and have Voicemeeter output the mix to your ASIO device.

Game audio is too quiet

When using TDJ mode the audio is very quiet by default. To mitigate this, you can use the Increase Game Volume patch.

"},{"location":"games/konami/iidx/31_epolis/troubleshooting/#subscreen","title":"Subscreen","text":"

For more in-depth troubleshooting, refer to the spice2x Subscreen troubleshooting page

Touch input isn't being registered

If you're using a physical touch screen, make sure to close all spice2x overlays, including the FPS counter. If you're using the virtual subscreen, ensure that the -iidxnativetouch option is not enabled.

"},{"location":"games/konami/iidx/32_pinkycrush/extras/","title":"Extra Information","text":""},{"location":"games/konami/iidx/32_pinkycrush/extras/#extra-information","title":"Extra Information","text":""},{"location":"games/konami/iidx/32_pinkycrush/extras/#standard-and-lightning-modes","title":"Standard and Lightning modes","text":"

Lightning mode requires a 120 Hz 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, 60 Hz)
  • D for Lightning (LDJ-010, TDJ, 120 Hz)
"},{"location":"games/konami/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/konami/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/konami/iidx/32_pinkycrush/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/32_pinkycrush/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/iidx/32_pinkycrush/setup/#standard-and-lightning-modes","title":"Standard and Lightning modes","text":"

Before proceeding with the setup, it's important to understand the two cabinet types for IIDX:

  • Lightning (TDJ/LDJ-010):

    • Runs at 120 FPS
    • Requires a 120 Hz main monitor
    • Optional second touchscreen 60 Hz monitor called a subscreen

  • Standard/Legacy (LDJ/LDJ-012):

    • Runs at 60 FPS
    • Requires a 60 Hz main monitor
    • No subscreen

The game data comes in two variants based on the bm2dx.dll file. You can patch an LDJ dll to run in TDJ mode, but this will disable video recording.

For simplicity, we'll use \"TDJ\" for Lightning Mode and \"LDJ\" for Standard Mode throughout our guides.

"},{"location":"games/konami/iidx/32_pinkycrush/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 100 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/iidx/32_pinkycrush/setup/#updating-data","title":"Updating data","text":"

Make sure you're using the right update for your current game version

IIDX updates have LDJ and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., LDJ_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., LDJ_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/iidx/32_pinkycrush/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice64.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice64.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
Additional steps for AMD and Intel graphics cards

Since KONAMI games are designed for NVIDIA GPU's, AMD and Intel users need additional files:

  • Locate the spice2x\\stubs\\64\\ folder in the spice2x archive
  • Extract all .dll files from there into your game's modules folder
"},{"location":"games/konami/iidx/32_pinkycrush/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

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

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

  • Maintenance: Service, Test
  • Game buttons: SW1 to SW7, Start, EFFECT, VEFX
  • Keypad: Keypad Insert Card, 1 to 9

Only if you play with a keyboard:

  • Turntable: TT+, TT- and optionally TT+/- which alternates between TT+ and TT- on each press.

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

This tab is used to bind analog controls like the turntable

Ignore this tab if you play with a keyboard

Bind your controller's turntable

With a controller, instead of binding TT+ or TT- in the Buttons tab, you need to:

  • Click Bind
  • In Device, pick your controller
  • In Control, pick the control that updates the preview when turning the turntable, typically X
  • Click Close, leaving the rest of the settings alone

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

Important

Enable IIDX Disable Cameras (-iidxdisablecams) unless you have a webcam connected and wish to use it with the camera hook from the advanced tab.

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

Optional: Enabling TDJ (Lightning mode)

You may want to enable IITX TDJ Mode (-iidxtdj) if your main monitor is 120 Hz capable.

Optional: Camera hook

With a webcam connected, you can:

  • Enable IIDX Cam Hook (-iidxtdjcamhook)
  • Make sure IIDX Disable Cameras (-iidxdisablecams) from the Options tab is disabled
  • Optionally enable IIDX Camera Order Flip (-iidxflipcams) if you have two cameras connected and the wrong one is being used

This allows spice2x to try and interface with your webcam to enable camera functionality in the game.

You can then bind a button to the Camera Control overlay in the Overlay tab to adjust camera settings.

No need to change anything here

"},{"location":"games/konami/iidx/32_pinkycrush/setup/#configuring-audio","title":"Configuring audio","text":"

Check out our general Audio guide to understand audio modes better, at least the TL;DR

  • 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

Then, depending follow instructions for your desired audio mode:

Setup for WASAPI Exclusive (default)
  • Check both boxes under Exclusive Mode
  • Open the Default Format dropdown
  • Pick the 16 bit, 44100 Hz (CD Quality) option, click Apply then OK
Setup for WASAPI Shared
  • Open the Default Format dropdown
  • Pick the 16 bit, 48000 Hz (DVD Quality) option, click Apply then OK
  • Return to spicecfg, go to the Patches tab
  • Following the patching guide and patch Shared Mode WASAPI

Optionally: go to the Options tab, and at the very bottom enable Low Latency Shared Audio to help mitigate the latency penalty from using Shared audio.

Setup for ASIO (requires specialized hardware)
  • Check both boxes under Exclusive Mode
  • Open the Default Format dropdown
  • Pick the 16 bit, 44100 Hz (CD Quality) option, click Apply then OK
"},{"location":"games/konami/iidx/32_pinkycrush/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/iidx/32_pinkycrush/setup/#configuring-your-game","title":"Configuring your game","text":"

Read through the Extra Information page

"},{"location":"games/konami/iidx/32_pinkycrush/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/iidx/32_pinkycrush/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/iidx/32_pinkycrush/setup/#first-launch","title":"First launch","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.

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.

Press your Test key again and let the game run for a bit until the monitor check is complete.

You will now 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.

Go to NETWORK OPTIONS then SHOP NAME SETTING.

You will need to set a shop name.

  • Name your shop to whatever you'd like. Again, navigation instructions 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/konami/iidx/32_pinkycrush/setup/#carding-in","title":"Carding in","text":"

Before carding in, you have the option to change the game's language by pressing your EFFECT key

For LDJ (Standard mode)

LDJ should accept keypad number binds:

  • Press your Keypad Insert Card button.
  • Enter your code using your keypad binds.
For TDJ (Lightning mode)

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/konami/iidx/32_pinkycrush/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/iidx/32_pinkycrush/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/32_pinkycrush/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

For any issues not covered here, spice2x's Known issues page might prove useful

"},{"location":"games/konami/iidx/32_pinkycrush/troubleshooting/#technical-problems","title":"Technical problems","text":""},{"location":"games/konami/iidx/32_pinkycrush/troubleshooting/#crashes","title":"Crashes","text":"

Riva Tuner Statistics Server (RTSS) and MSI Afterburner are known to cause odd crashes.If you have them installed, close them both before starting any arcade game

W:SuperstepSound: Audio device is not available!!! in logs

  • Open log.txt using an editor that supports SHIFT-JIS encoding for Japanese text (like Notepad++)

  • Search for Superstep

If you find a line with Audio device is not available!!!, it means the game refuses to boot due to a misconfigured or missing audio device. Check the setup guide's Configuring audio section as well as our general Audio guide to understand the issue better.

EXCEPTION_ILLEGAL_INSTRUCTION in logs

  • Open log.txt using an editor that supports SHIFT-JIS encoding for Japanese text (like Notepad++)

  • Search for EXCEPTION_ILLEGAL_INSTRUCTION

beatmania IIDX 31 and above require a CPU that is AVX2 capable. If you encounter this message, it may indicate that your CPU is too old and does not support AVX2. A known workaround is renaming/deleting the movies folder to prevent the game from loading them altogether.

I'm using a laptop with a hybrid internal+dedicated GPU setup

Laptops often have odd issues running data. The game may open on the wrong monitor, run at the wrong resolution or framerate, or simply crashes.

There is currently no known fix for this, other than maybe playing in windowed mode, or using a desktop PC instead.

"},{"location":"games/konami/iidx/32_pinkycrush/troubleshooting/#performance","title":"Performance","text":"

Check out spice2x's PC optimization guide

Game is running too slow/fast / Monitor error 5-1503-0043

Your game is likely running at an incorrect framerate. The expected framerates are:

  • Legacy cab mode: 60 FPS
  • Lightning Model cab mode: 120 FPS

Try these steps to resolve framerate issues:

  • Make sure that your patch or DLL matches your cab mode
  • Close any software that can affect framerates (like RTSS)
  • Close unnecessary background programs
  • Ensure V-SYNC is not forcefully disabled in your graphics card control panel
  • For NVIDIA users: Enable NVIDIA profile optimization (-nvprofile) in spicecfg's Options tab

If issues persist:

  • Double-check that you followed all steps in the setup guide correctly
  • Your PC hardware might be insufficient to keep a steady 120 FPS, you can try switching to Legacy cab mode
  • Your data may be corrupt in one way or another, you could try starting from scratch using trusted data sources
"},{"location":"games/konami/iidx/32_pinkycrush/troubleshooting/#audio","title":"Audio","text":"

Check out our Audio guide to understand audio modes better

Ensure your default audio device's sample rate is set properly

  • 44100 Hz sample rate for WASAPI Exclusive and ASIO
  • 48000 Hz if your game is patched with Shared Mode WASAPI
I can't change my device's sample rate

If you're using gaming peripherals (Logitech/Razer/Steelseries) or external audio devices (audio interfaces/sound bars):

  • Check if you can modify the sample rate in the device's software/control panel
  • If not, try uninstalling the device's software. This may restore control over Windows audio settings

If you still can't change the sample rate:

  • Configure the game's audio mode to match your device's current sample rate instead
  • Try using a different audio device
I can't hear anything else than the game

Your game's audio is setup to run in WASAPI Exclusive or ASIO modes.

Check out our Audio guide to understand audio modes better.

If you're using WASAPI Exclusive, you'll want to patch the game with Shared Mode WASAPI to hear other applications.

If you're using ASIO, unless your audio interface mixes WASAPI and ASIO streams when outputting, you'll only be able to hear one application when ASIO is in use. In this case, you'll need to route all audio through software such as Voicemeeter, and have Voicemeeter output the mix to your ASIO device.

Game audio is too quiet

When using TDJ mode the audio is very quiet by default. To mitigate this, you can use the Increase Game Volume patch.

"},{"location":"games/konami/iidx/32_pinkycrush/troubleshooting/#subscreen","title":"Subscreen","text":"

For more in-depth troubleshooting, refer to the spice2x Subscreen troubleshooting page

Touch input isn't being registered

If you're using a physical touch screen, make sure to close all spice2x overlays, including the FPS counter. If you're using the virtual subscreen, ensure that the -iidxnativetouch option is not enabled.

"},{"location":"games/konami/iidx/33_sparkleshower/extras/","title":"Extra Information","text":""},{"location":"games/konami/iidx/33_sparkleshower/extras/#extra-information","title":"Extra Information","text":""},{"location":"games/konami/iidx/33_sparkleshower/extras/#standard-and-lightning-modes","title":"Standard and Lightning modes","text":"

Lightning mode requires a 120 Hz 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, 60 Hz)
  • D for Lightning (LDJ-010, TDJ, 120 Hz)
"},{"location":"games/konami/iidx/33_sparkleshower/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/konami/iidx/33_sparkleshower/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/konami/iidx/33_sparkleshower/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/33_sparkleshower/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/iidx/33_sparkleshower/setup/#standard-and-lightning-modes","title":"Standard and Lightning modes","text":"

Before proceeding with the setup, it's important to understand the two cabinet types for IIDX:

  • Lightning (TDJ/LDJ-010):

    • Runs at 120 FPS
    • Requires a 120 Hz main monitor
    • Optional second touchscreen 60 Hz monitor called a subscreen

  • Standard/Legacy (LDJ/LDJ-012):

    • Runs at 60 FPS
    • Requires a 60 Hz main monitor
    • No subscreen

The game data comes in two variants based on the bm2dx.dll file. You can patch an LDJ dll to run in TDJ mode, but this will disable video recording.

For simplicity, we'll use \"TDJ\" for Lightning Mode and \"LDJ\" for Standard Mode throughout our guides.

"},{"location":"games/konami/iidx/33_sparkleshower/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 100 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/iidx/33_sparkleshower/setup/#updating-data","title":"Updating data","text":"

Make sure you're using the right update for your current game version

IIDX updates have LDJ and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., LDJ_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., LDJ_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/iidx/33_sparkleshower/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice64.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice64.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
Additional steps for AMD and Intel graphics cards

Since KONAMI games are designed for NVIDIA GPU's, AMD and Intel users need additional files:

  • Locate the spice2x\\stubs\\64\\ folder in the spice2x archive
  • Extract all .dll files from there into your game's modules folder
"},{"location":"games/konami/iidx/33_sparkleshower/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

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

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

  • Maintenance: Service, Test
  • Game buttons: SW1 to SW7, Start, EFFECT, VEFX
  • Keypad: Keypad Insert Card, 1 to 9

Only if you play with a keyboard:

  • Turntable: TT+, TT- and optionally TT+/- which alternates between TT+ and TT- on each press.

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

This tab is used to bind analog controls like the turntable

Ignore this tab if you play with a keyboard

Bind your controller's turntable

With a controller, instead of binding TT+ or TT- in the Buttons tab, you need to:

  • Click Bind
  • In Device, pick your controller
  • In Control, pick the control that updates the preview when turning the turntable, typically X
  • Click Close, leaving the rest of the settings alone

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

Important

Enable IIDX Disable Cameras (-iidxdisablecams) unless you have a webcam connected and wish to use it with the camera hook from the advanced tab.

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

Optional: Enabling TDJ (Lightning mode)

You may want to enable IITX TDJ Mode (-iidxtdj) if your main monitor is 120 Hz capable.

Optional: Camera hook

With a webcam connected, you can:

  • Enable IIDX Cam Hook (-iidxtdjcamhook)
  • Make sure IIDX Disable Cameras (-iidxdisablecams) from the Options tab is disabled
  • Optionally enable IIDX Camera Order Flip (-iidxflipcams) if you have two cameras connected and the wrong one is being used

This allows spice2x to try and interface with your webcam to enable camera functionality in the game.

You can then bind a button to the Camera Control overlay in the Overlay tab to adjust camera settings.

No need to change anything here

"},{"location":"games/konami/iidx/33_sparkleshower/setup/#configuring-audio","title":"Configuring audio","text":"

Check out our general Audio guide to understand audio modes better, at least the TL;DR

  • 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

Then, depending follow instructions for your desired audio mode:

Setup for WASAPI Exclusive (default)
  • Check both boxes under Exclusive Mode
  • Open the Default Format dropdown
  • Pick the 16 bit, 44100 Hz (CD Quality) option, click Apply then OK
Setup for WASAPI Shared
  • Open the Default Format dropdown
  • Pick the 16 bit, 48000 Hz (DVD Quality) option, click Apply then OK
  • Return to spicecfg, go to the Patches tab
  • Following the patching guide and patch Shared Mode WASAPI

Optionally: go to the Options tab, and at the very bottom enable Low Latency Shared Audio to help mitigate the latency penalty from using Shared audio.

Setup for ASIO (requires specialized hardware)
  • Check both boxes under Exclusive Mode
  • Open the Default Format dropdown
  • Pick the 16 bit, 44100 Hz (CD Quality) option, click Apply then OK
"},{"location":"games/konami/iidx/33_sparkleshower/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/iidx/33_sparkleshower/setup/#configuring-your-game","title":"Configuring your game","text":"

Read through the Extra Information page

"},{"location":"games/konami/iidx/33_sparkleshower/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/iidx/33_sparkleshower/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/iidx/33_sparkleshower/setup/#first-launch","title":"First launch","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.

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.

Press your Test key again and let the game run for a bit until the monitor check is complete.

You will now 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.

Go to NETWORK OPTIONS then SHOP NAME SETTING.

You will need to set a shop name.

  • Name your shop to whatever you'd like. Again, navigation instructions 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/konami/iidx/33_sparkleshower/setup/#carding-in","title":"Carding in","text":"

Before carding in, you have the option to change the game's language by pressing your EFFECT key

For LDJ (Standard mode)

LDJ should accept keypad number binds:

  • Press your Keypad Insert Card button.
  • Enter your code using your keypad binds.
For TDJ (Lightning mode)

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/konami/iidx/33_sparkleshower/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/iidx/33_sparkleshower/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/33_sparkleshower/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

For any issues not covered here, spice2x's Known issues page might prove useful

"},{"location":"games/konami/iidx/33_sparkleshower/troubleshooting/#technical-problems","title":"Technical problems","text":""},{"location":"games/konami/iidx/33_sparkleshower/troubleshooting/#crashes","title":"Crashes","text":"

Riva Tuner Statistics Server (RTSS) and MSI Afterburner are known to cause odd crashes.If you have them installed, close them both before starting any arcade game

W:SuperstepSound: Audio device is not available!!! in logs

  • Open log.txt using an editor that supports SHIFT-JIS encoding for Japanese text (like Notepad++)

  • Search for Superstep

If you find a line with Audio device is not available!!!, it means the game refuses to boot due to a misconfigured or missing audio device. Check the setup guide's Configuring audio section as well as our general Audio guide to understand the issue better.

EXCEPTION_ILLEGAL_INSTRUCTION in logs

  • Open log.txt using an editor that supports SHIFT-JIS encoding for Japanese text (like Notepad++)

  • Search for EXCEPTION_ILLEGAL_INSTRUCTION

beatmania IIDX 31 and above require a CPU that is AVX2 capable. If you encounter this message, it may indicate that your CPU is too old and does not support AVX2. A known workaround is renaming/deleting the movies folder to prevent the game from loading them altogether.

I'm using a laptop with a hybrid internal+dedicated GPU setup

Laptops often have odd issues running data. The game may open on the wrong monitor, run at the wrong resolution or framerate, or simply crashes.

There is currently no known fix for this, other than maybe playing in windowed mode, or using a desktop PC instead.

"},{"location":"games/konami/iidx/33_sparkleshower/troubleshooting/#performance","title":"Performance","text":"

Check out spice2x's PC optimization guide

Game is running too slow/fast / Monitor error 5-1503-0043

Your game is likely running at an incorrect framerate. The expected framerates are:

  • Legacy cab mode: 60 FPS
  • Lightning Model cab mode: 120 FPS

Try these steps to resolve framerate issues:

  • Make sure that your patch or DLL matches your cab mode
  • Close any software that can affect framerates (like RTSS)
  • Close unnecessary background programs
  • Ensure V-SYNC is not forcefully disabled in your graphics card control panel
  • For NVIDIA users: Enable NVIDIA profile optimization (-nvprofile) in spicecfg's Options tab

If issues persist:

  • Double-check that you followed all steps in the setup guide correctly
  • Your PC hardware might be insufficient to keep a steady 120 FPS, you can try switching to Legacy cab mode
  • Your data may be corrupt in one way or another, you could try starting from scratch using trusted data sources
"},{"location":"games/konami/iidx/33_sparkleshower/troubleshooting/#audio","title":"Audio","text":"

Check out our Audio guide to understand audio modes better

Ensure your default audio device's sample rate is set properly

  • 44100 Hz sample rate for WASAPI Exclusive and ASIO
  • 48000 Hz if your game is patched with Shared Mode WASAPI
I can't change my device's sample rate

If you're using gaming peripherals (Logitech/Razer/Steelseries) or external audio devices (audio interfaces/sound bars):

  • Check if you can modify the sample rate in the device's software/control panel
  • If not, try uninstalling the device's software. This may restore control over Windows audio settings

If you still can't change the sample rate:

  • Configure the game's audio mode to match your device's current sample rate instead
  • Try using a different audio device
I can't hear anything else than the game

Your game's audio is setup to run in WASAPI Exclusive or ASIO modes.

Check out our Audio guide to understand audio modes better.

If you're using WASAPI Exclusive, you'll want to patch the game with Shared Mode WASAPI to hear other applications.

If you're using ASIO, unless your audio interface mixes WASAPI and ASIO streams when outputting, you'll only be able to hear one application when ASIO is in use. In this case, you'll need to route all audio through software such as Voicemeeter, and have Voicemeeter output the mix to your ASIO device.

Game audio is too quiet

When using TDJ mode the audio is very quiet by default. To mitigate this, you can use the Increase Game Volume patch.

"},{"location":"games/konami/iidx/33_sparkleshower/troubleshooting/#subscreen","title":"Subscreen","text":"

For more in-depth troubleshooting, refer to the spice2x Subscreen troubleshooting page

Touch input isn't being registered

If you're using a physical touch screen, make sure to close all spice2x overlays, including the FPS counter. If you're using the virtual subscreen, ensure that the -iidxnativetouch option is not enabled.

"},{"location":"games/konami/iidx/9thstyle/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/9thstyle/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/iidx/9thstyle/setup/#configuring-bemanitools","title":"Configuring Bemanitools","text":"

To configure your keybinds, open your config.bat file

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/9thstyle/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page

"},{"location":"games/konami/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/konami/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/konami/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/konami/iidx/9thstyle/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/9thstyle/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/common/31plus/extras/","title":"Extra Information","text":""},{"location":"games/konami/iidx/common/31plus/extras/#standard-and-lightning-modes","title":"Standard and Lightning modes","text":"

Lightning mode requires a 120 Hz 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, 60 Hz)
  • D for Lightning (LDJ-010, TDJ, 120 Hz)
"},{"location":"games/konami/iidx/common/31plus/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/konami/iidx/common/31plus/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/konami/iidx/common/31plus/setup/","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/iidx/common/31plus/setup/#standard-and-lightning-modes","title":"Standard and Lightning modes","text":"

Before proceeding with the setup, it's important to understand the two cabinet types for IIDX:

  • Lightning (TDJ/LDJ-010):

    • Runs at 120 FPS
    • Requires a 120 Hz main monitor
    • Optional second touchscreen 60 Hz monitor called a subscreen

  • Standard/Legacy (LDJ/LDJ-012):

    • Runs at 60 FPS
    • Requires a 60 Hz main monitor
    • No subscreen

The game data comes in two variants based on the bm2dx.dll file. You can patch an LDJ dll to run in TDJ mode, but this will disable video recording.

For simplicity, we'll use \"TDJ\" for Lightning Mode and \"LDJ\" for Standard Mode throughout our guides.

"},{"location":"games/konami/iidx/common/31plus/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 100 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/iidx/common/31plus/setup/#updating-data","title":"Updating data","text":"

Make sure you're using the right update for your current game version

IIDX updates have LDJ and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., LDJ_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., LDJ_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/iidx/common/31plus/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice64.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice64.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
Additional steps for AMD and Intel graphics cards

Since KONAMI games are designed for NVIDIA GPU's, AMD and Intel users need additional files:

  • Locate the spice2x\\stubs\\64\\ folder in the spice2x archive
  • Extract all .dll files from there into your game's modules folder
"},{"location":"games/konami/iidx/common/31plus/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

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

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

  • Maintenance: Service, Test
  • Game buttons: SW1 to SW7, Start, EFFECT, VEFX
  • Keypad: Keypad Insert Card, 1 to 9

Only if you play with a keyboard:

  • Turntable: TT+, TT- and optionally TT+/- which alternates between TT+ and TT- on each press.

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

This tab is used to bind analog controls like the turntable

Ignore this tab if you play with a keyboard

Bind your controller's turntable

With a controller, instead of binding TT+ or TT- in the Buttons tab, you need to:

  • Click Bind
  • In Device, pick your controller
  • In Control, pick the control that updates the preview when turning the turntable, typically X
  • Click Close, leaving the rest of the settings alone

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

Important

Enable IIDX Disable Cameras (-iidxdisablecams) unless you have a webcam connected and wish to use it with the camera hook from the advanced tab.

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

Optional: Enabling TDJ (Lightning mode)

You may want to enable IITX TDJ Mode (-iidxtdj) if your main monitor is 120 Hz capable.

Optional: Camera hook

With a webcam connected, you can:

  • Enable IIDX Cam Hook (-iidxtdjcamhook)
  • Make sure IIDX Disable Cameras (-iidxdisablecams) from the Options tab is disabled
  • Optionally enable IIDX Camera Order Flip (-iidxflipcams) if you have two cameras connected and the wrong one is being used

This allows spice2x to try and interface with your webcam to enable camera functionality in the game.

You can then bind a button to the Camera Control overlay in the Overlay tab to adjust camera settings.

No need to change anything here

"},{"location":"games/konami/iidx/common/31plus/setup/#configuring-audio","title":"Configuring audio","text":"

Check out our general Audio guide to understand audio modes better, at least the TL;DR

  • 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

Then, depending follow instructions for your desired audio mode:

Setup for WASAPI Exclusive (default)
  • Check both boxes under Exclusive Mode
  • Open the Default Format dropdown
  • Pick the 16 bit, 44100 Hz (CD Quality) option, click Apply then OK
Setup for WASAPI Shared
  • Open the Default Format dropdown
  • Pick the 16 bit, 48000 Hz (DVD Quality) option, click Apply then OK
  • Return to spicecfg, go to the Patches tab
  • Following the patching guide and patch Shared Mode WASAPI

Optionally: go to the Options tab, and at the very bottom enable Low Latency Shared Audio to help mitigate the latency penalty from using Shared audio.

Setup for ASIO (requires specialized hardware)
  • Check both boxes under Exclusive Mode
  • Open the Default Format dropdown
  • Pick the 16 bit, 44100 Hz (CD Quality) option, click Apply then OK
"},{"location":"games/konami/iidx/common/31plus/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/iidx/common/31plus/setup/#configuring-your-game","title":"Configuring your game","text":"

Read through the Extra Information page

"},{"location":"games/konami/iidx/common/31plus/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/iidx/common/31plus/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/iidx/common/31plus/setup/#first-launch","title":"First launch","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.

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.

Press your Test key again and let the game run for a bit until the monitor check is complete.

You will now 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.

Go to NETWORK OPTIONS then SHOP NAME SETTING.

You will need to set a shop name.

  • Name your shop to whatever you'd like. Again, navigation instructions 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/konami/iidx/common/31plus/setup/#carding-in","title":"Carding in","text":"

Before carding in, you have the option to change the game's language by pressing your EFFECT key

For LDJ (Standard mode)

LDJ should accept keypad number binds:

  • Press your Keypad Insert Card button.
  • Enter your code using your keypad binds.
For TDJ (Lightning mode)

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/konami/iidx/common/31plus/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/iidx/common/31plus/troubleshooting/","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

For any issues not covered here, spice2x's Known issues page might prove useful

"},{"location":"games/konami/iidx/common/31plus/troubleshooting/#technical-problems","title":"Technical problems","text":""},{"location":"games/konami/iidx/common/31plus/troubleshooting/#crashes","title":"Crashes","text":"

Riva Tuner Statistics Server (RTSS) and MSI Afterburner are known to cause odd crashes.If you have them installed, close them both before starting any arcade game

W:SuperstepSound: Audio device is not available!!! in logs

  • Open log.txt using an editor that supports SHIFT-JIS encoding for Japanese text (like Notepad++)

  • Search for Superstep

If you find a line with Audio device is not available!!!, it means the game refuses to boot due to a misconfigured or missing audio device. Check the setup guide's Configuring audio section as well as our general Audio guide to understand the issue better.

EXCEPTION_ILLEGAL_INSTRUCTION in logs

  • Open log.txt using an editor that supports SHIFT-JIS encoding for Japanese text (like Notepad++)

  • Search for EXCEPTION_ILLEGAL_INSTRUCTION

beatmania IIDX 31 and above require a CPU that is AVX2 capable. If you encounter this message, it may indicate that your CPU is too old and does not support AVX2. A known workaround is renaming/deleting the movies folder to prevent the game from loading them altogether.

I'm using a laptop with a hybrid internal+dedicated GPU setup

Laptops often have odd issues running data. The game may open on the wrong monitor, run at the wrong resolution or framerate, or simply crashes.

There is currently no known fix for this, other than maybe playing in windowed mode, or using a desktop PC instead.

"},{"location":"games/konami/iidx/common/31plus/troubleshooting/#performance","title":"Performance","text":"

Check out spice2x's PC optimization guide

Game is running too slow/fast / Monitor error 5-1503-0043

Your game is likely running at an incorrect framerate. The expected framerates are:

  • Legacy cab mode: 60 FPS
  • Lightning Model cab mode: 120 FPS

Try these steps to resolve framerate issues:

  • Make sure that your patch or DLL matches your cab mode
  • Close any software that can affect framerates (like RTSS)
  • Close unnecessary background programs
  • Ensure V-SYNC is not forcefully disabled in your graphics card control panel
  • For NVIDIA users: Enable NVIDIA profile optimization (-nvprofile) in spicecfg's Options tab

If issues persist:

  • Double-check that you followed all steps in the setup guide correctly
  • Your PC hardware might be insufficient to keep a steady 120 FPS, you can try switching to Legacy cab mode
  • Your data may be corrupt in one way or another, you could try starting from scratch using trusted data sources
"},{"location":"games/konami/iidx/common/31plus/troubleshooting/#audio","title":"Audio","text":"

Check out our Audio guide to understand audio modes better

Ensure your default audio device's sample rate is set properly

  • 44100 Hz sample rate for WASAPI Exclusive and ASIO
  • 48000 Hz if your game is patched with Shared Mode WASAPI
I can't change my device's sample rate

If you're using gaming peripherals (Logitech/Razer/Steelseries) or external audio devices (audio interfaces/sound bars):

  • Check if you can modify the sample rate in the device's software/control panel
  • If not, try uninstalling the device's software. This may restore control over Windows audio settings

If you still can't change the sample rate:

  • Configure the game's audio mode to match your device's current sample rate instead
  • Try using a different audio device
I can't hear anything else than the game

Your game's audio is setup to run in WASAPI Exclusive or ASIO modes.

Check out our Audio guide to understand audio modes better.

If you're using WASAPI Exclusive, you'll want to patch the game with Shared Mode WASAPI to hear other applications.

If you're using ASIO, unless your audio interface mixes WASAPI and ASIO streams when outputting, you'll only be able to hear one application when ASIO is in use. In this case, you'll need to route all audio through software such as Voicemeeter, and have Voicemeeter output the mix to your ASIO device.

Game audio is too quiet

When using TDJ mode the audio is very quiet by default. To mitigate this, you can use the Increase Game Volume patch.

"},{"location":"games/konami/iidx/common/31plus/troubleshooting/#subscreen","title":"Subscreen","text":"

For more in-depth troubleshooting, refer to the spice2x Subscreen troubleshooting page

Touch input isn't being registered

If you're using a physical touch screen, make sure to close all spice2x overlays, including the FPS counter. If you're using the virtual subscreen, ensure that the -iidxnativetouch option is not enabled.

"},{"location":"games/konami/jubeat/avenue/setup/","title":"Game Setup","text":""},{"location":"games/konami/jubeat/avenue/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/jubeat/avenue/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 10 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\u2699\ufe0fmsvcr100.dll\n

If your data does not look like this

If you have other .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/jubeat/avenue/setup/#updating-data","title":"Updating data","text":"

Make sure you're using the right update for your current game version

jubeat updates have L44 and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., L44_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., L44_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/jubeat/avenue/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\u2699\ufe0fmsvcr100.dll\n\ud83c\udf36\ufe0fspice.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
Additional steps for AMD and Intel graphics cards

Since KONAMI games are designed for NVIDIA GPU's, AMD and Intel users need additional files:

  • Locate the spice2x\\stubs\\32\\ folder in the spice2x archive
  • Extract all .dll files from there into your game's modules folder
"},{"location":"games/konami/jubeat/avenue/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

Click on Bind or Naive 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: Button 1 to Button 16
  • Keypad: Keypad Insert Card

Using a touch screen

spice2x supports using a touch screen instead of the 16 game buttons. In that case, you don't need to bind these buttons.

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

No need to change anything here

"},{"location":"games/konami/jubeat/avenue/setup/#configuring-audio","title":"Configuring 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
  • Open the Default Format dropdown
  • Pick the 16 bit, 48000 Hz (DVD Quality) option, click Apply then OK

Optionally: go to the Options tab in spicecfg.exe, and at the very bottom enable Low Latency Shared Audio to help mitigate audio latency.

"},{"location":"games/konami/jubeat/avenue/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/jubeat/avenue/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/jubeat/avenue/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/jubeat/avenue/setup/#first-launch","title":"First launch","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 spice.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.

Press your Test key to initialize the backup data, another message with the same error will pop up. Press your Test key again to open the service menu.

You will be greeted by a warning asking you to reboot the game, you can safely ignore it for the moment.

Instructions on how to navigate the menu are shown on the screen.

Go to GAME OPTIONS, then SHOP SETTINGS.

You will need to set a shop name.

  • Name your shop to whatever you'd like. Again, navigation instructions are on the screen.
  • Press the EXIT button.

Then, set the shop area to whatever region you'd like.

Select SAVE AND EXIT then EXIT.

Finally, restart the game.

You're all done! The game should load up properly now

"},{"location":"games/konami/jubeat/avenue/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/jubeat/beyondtheavenue/setup/","title":"Game Setup","text":""},{"location":"games/konami/jubeat/beyondtheavenue/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/jubeat/beyondtheavenue/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 10 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\u2699\ufe0fmsvcr100.dll\n

If your data does not look like this

If you have other .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/jubeat/beyondtheavenue/setup/#updating-data","title":"Updating data","text":"

Make sure you're using the right update for your current game version

jubeat updates have L44 and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., L44_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., L44_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/jubeat/beyondtheavenue/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\u2699\ufe0fmsvcr100.dll\n\ud83c\udf36\ufe0fspice.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
Additional steps for AMD and Intel graphics cards

Since KONAMI games are designed for NVIDIA GPU's, AMD and Intel users need additional files:

  • Locate the spice2x\\stubs\\32\\ folder in the spice2x archive
  • Extract all .dll files from there into your game's modules folder
"},{"location":"games/konami/jubeat/beyondtheavenue/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

Click on Bind or Naive 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: Button 1 to Button 16
  • Keypad: Keypad Insert Card

Using a touch screen

spice2x supports using a touch screen instead of the 16 game buttons. In that case, you don't need to bind these buttons.

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

No need to change anything here

"},{"location":"games/konami/jubeat/beyondtheavenue/setup/#configuring-audio","title":"Configuring 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
  • Open the Default Format dropdown
  • Pick the 16 bit, 48000 Hz (DVD Quality) option, click Apply then OK

Optionally: go to the Options tab in spicecfg.exe, and at the very bottom enable Low Latency Shared Audio to help mitigate audio latency.

"},{"location":"games/konami/jubeat/beyondtheavenue/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/jubeat/beyondtheavenue/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/jubeat/beyondtheavenue/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/jubeat/beyondtheavenue/setup/#first-launch","title":"First launch","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 spice.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.

Press your Test key to initialize the backup data, another message with the same error will pop up. Press your Test key again to open the service menu.

You will be greeted by a warning asking you to reboot the game, you can safely ignore it for the moment.

Instructions on how to navigate the menu are shown on the screen.

Go to GAME OPTIONS, then SHOP SETTINGS.

You will need to set a shop name.

  • Name your shop to whatever you'd like. Again, navigation instructions are on the screen.
  • Press the EXIT button.

Then, set the shop area to whatever region you'd like.

Select SAVE AND EXIT then EXIT.

Finally, restart the game.

You're all done! The game should load up properly now

"},{"location":"games/konami/jubeat/beyondtheavenue/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/jubeat/common/setup/","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 10 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\u2699\ufe0fmsvcr100.dll\n

If your data does not look like this

If you have other .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/jubeat/common/setup/#updating-data","title":"Updating data","text":"

Make sure you're using the right update for your current game version

jubeat updates have L44 and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., L44_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., L44_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/jubeat/common/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\u2699\ufe0fmsvcr100.dll\n\ud83c\udf36\ufe0fspice.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
Additional steps for AMD and Intel graphics cards

Since KONAMI games are designed for NVIDIA GPU's, AMD and Intel users need additional files:

  • Locate the spice2x\\stubs\\32\\ folder in the spice2x archive
  • Extract all .dll files from there into your game's modules folder
"},{"location":"games/konami/jubeat/common/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

Click on Bind or Naive 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: Button 1 to Button 16
  • Keypad: Keypad Insert Card

Using a touch screen

spice2x supports using a touch screen instead of the 16 game buttons. In that case, you don't need to bind these buttons.

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

No need to change anything here

"},{"location":"games/konami/jubeat/common/setup/#configuring-audio","title":"Configuring 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
  • Open the Default Format dropdown
  • Pick the 16 bit, 48000 Hz (DVD Quality) option, click Apply then OK

Optionally: go to the Options tab in spicecfg.exe, and at the very bottom enable Low Latency Shared Audio to help mitigate audio latency.

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

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/jubeat/common/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/jubeat/common/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/jubeat/common/setup/#first-launch","title":"First launch","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 spice.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.

Press your Test key to initialize the backup data, another message with the same error will pop up. Press your Test key again to open the service menu.

You will be greeted by a warning asking you to reboot the game, you can safely ignore it for the moment.

Instructions on how to navigate the menu are shown on the screen.

Go to GAME OPTIONS, then SHOP SETTINGS.

You will need to set a shop name.

  • Name your shop to whatever you'd like. Again, navigation instructions are on the screen.
  • Press the EXIT button.

Then, set the shop area to whatever region you'd like.

Select SAVE AND EXIT then EXIT.

Finally, restart the game.

You're all done! The game should load up properly now

"},{"location":"games/konami/jubeat/common/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/jubeat/festo/setup/","title":"Game Setup","text":""},{"location":"games/konami/jubeat/festo/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/jubeat/festo/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 10 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\u2699\ufe0fmsvcr100.dll\n

If your data does not look like this

If you have other .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/jubeat/festo/setup/#updating-data","title":"Updating data","text":"

Make sure you're using the right update for your current game version

jubeat updates have L44 and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., L44_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., L44_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/jubeat/festo/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\u2699\ufe0fmsvcr100.dll\n\ud83c\udf36\ufe0fspice.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
Additional steps for AMD and Intel graphics cards

Since KONAMI games are designed for NVIDIA GPU's, AMD and Intel users need additional files:

  • Locate the spice2x\\stubs\\32\\ folder in the spice2x archive
  • Extract all .dll files from there into your game's modules folder
"},{"location":"games/konami/jubeat/festo/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

Click on Bind or Naive 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: Button 1 to Button 16
  • Keypad: Keypad Insert Card

Using a touch screen

spice2x supports using a touch screen instead of the 16 game buttons. In that case, you don't need to bind these buttons.

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

No need to change anything here

"},{"location":"games/konami/jubeat/festo/setup/#configuring-audio","title":"Configuring 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
  • Open the Default Format dropdown
  • Pick the 16 bit, 48000 Hz (DVD Quality) option, click Apply then OK

Optionally: go to the Options tab in spicecfg.exe, and at the very bottom enable Low Latency Shared Audio to help mitigate audio latency.

"},{"location":"games/konami/jubeat/festo/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/jubeat/festo/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/jubeat/festo/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/jubeat/festo/setup/#first-launch","title":"First launch","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 spice.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.

Press your Test key to initialize the backup data, another message with the same error will pop up. Press your Test key again to open the service menu.

You will be greeted by a warning asking you to reboot the game, you can safely ignore it for the moment.

Instructions on how to navigate the menu are shown on the screen.

Go to GAME OPTIONS, then SHOP SETTINGS.

You will need to set a shop name.

  • Name your shop to whatever you'd like. Again, navigation instructions are on the screen.
  • Press the EXIT button.

Then, set the shop area to whatever region you'd like.

Select SAVE AND EXIT then EXIT.

Finally, restart the game.

You're all done! The game should load up properly now

"},{"location":"games/konami/jubeat/festo/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/mfg/setup/","title":"Game Setup","text":""},{"location":"games/konami/mfg/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/mfg/setup/#preparing-data","title":"Preparing Data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 5 GB or larger

Here's what the expected data structure should look like: 

\ud83d\udcc2prop\n\ud83d\udcc2modules\n\ud83d\udcc2game\n\ud83d\udcc4game.inf\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/konami/mfg/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice64.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2prop\n\ud83d\udcc2modules\n\ud83d\udcc2game\n\ud83d\udcc4game.inf\n\ud83c\udf36\ufe0fspice64.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
"},{"location":"games/konami/mfg/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

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

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

  • Maintenance: Service, Test

Mahjong Fight Girl is a touchscreen game, so it does not need any extra button configuration beyond the above.

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

No need to change anything here

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

No need to change anything here

No need to change anything here

Choose Cab Type

Mahjong Fight Girl has multiple cab types. HG is currently the only supported cab type.

No need to change anything here

No need to change anything here

"},{"location":"games/konami/mfg/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/mfg/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/mfg/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/mfg/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/mfg/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/mfg/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

For any issues not covered here, spice2x's Known issues page might prove useful

"},{"location":"games/konami/mfg/troubleshooting/#technical-problems","title":"Technical problems","text":"I can't select anything on screen

Make sure your cab type in spicecfg is set to HG

"},{"location":"games/konami/museca/1plushalf/setup/","title":"Game Setup","text":""},{"location":"games/konami/museca/1plushalf/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/museca/1plushalf/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 2.7 GB.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/konami/museca/1plushalf/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice64.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice64.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
Additional steps for AMD and Intel graphics cards

Since KONAMI games are designed for NVIDIA GPU's, AMD and Intel users need additional files:

  • Locate the spice2x\\stubs\\64\\ folder in the spice2x archive
  • Extract all .dll files from there into your game's modules folder
"},{"location":"games/konami/museca/1plushalf/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

Click on Bind or Naive 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, Start
  • Game buttons: Disk# Press (1 to 5), Foot Pedal
  • P1 Keypad: Keypad 0 to 9, Keypad Insert Card

Only if you play with a keyboard:

  • Disks: Disk#- (1 to 5), Disk#+ (1 to 5) (Disk#- is counter-clockwise, while Disk#+ is clockwise.)

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

This tab is used to bind analog controls like the disks

Ignore this tab if you play with a keyboard

Bind your controller's disks

With a controller, instead of binding your disks in the Buttons tab, you need to:

  • Click Bind
  • In Device, pick your controller
  • In Control, pick the control that updates the preview when turning the corresponding disk
  • Click Close, leaving the rest of the settings alone
  • Repeat for your other disks

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

No need to change anything here

"},{"location":"games/konami/museca/1plushalf/setup/#configuring-audio","title":"Configuring Audio","text":"

Check out our general Audio guide to understand audio modes better, at least the TL;DR

This game only supports WASAPI Exclusive mode. Some audio devices may not support this

  • 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, click Apply then OK
"},{"location":"games/konami/museca/1plushalf/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/museca/1plushalf/setup/#monitor-orientation","title":"Monitor Orientation","text":"

This game requires your main monitor to be set to Portait or Portait (flipped) mode

You will play in Portait mode (Recommended)
  • Right click on your Desktop
  • Select Display settings
  • Look for Display orientation and set it to Portrait or Portrait (flipped)
  • Rotate your monitor 90\u00b0
You cannot play in Portait mode

In this case, your only option is to:

  • Open spicecfg, go to the Options tab
  • Set the game to Windowed Mode (-w)
  • Set your desired Window Resolution (-windowsize) for the game
"},{"location":"games/konami/museca/1plushalf/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/museca/1plushalf/setup/#first-launch","title":"First launch","text":"

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

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.

If you're seeing this screen, it means you need to press the Test button to initialize the game's backup data.

Once the game shows BACKUP DATA: INITIALIZED, restart the game.

You're all done! The game should load up properly now

"},{"location":"games/konami/museca/1plushalf/setup/#museca-plus","title":"M\u00daSECA PLUS","text":"

Since M\u00daSECA is no longer receiving official updates, community mods like M\u00daSECA PLUS exist to enhance the game with additional content and English translations

"},{"location":"games/konami/museca/1plushalf/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/museca/1plushalf/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/museca/1plushalf/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

For any issues not covered here, spice2x's Known issues page might prove useful

"},{"location":"games/konami/museca/1plushalf/troubleshooting/#technical-problems","title":"Technical Problems","text":"I'm using a laptop with a hybrid internal+dedicated GPU setup

Laptops often have odd issues running data. The game may open on the wrong monitor, run at the wrong resolution or framerate, or simply crashes.

There is currently no known fix for this, other than maybe playing in windowed mode, or using a desktop PC instead.

"},{"location":"games/konami/museca/1plushalf/troubleshooting/#performance","title":"Performance","text":"

Check out spice2x's PC optimization guide

Game is running too slow/fast

Your game is likely running at an incorrect framerate. M\u00daSECA expects the game to run at 60 fps constantly.

Try these steps to resolve framerate issues:

  • Verify your monitor's refresh ratae is set at exactly 60 Hz.
  • Close any software that can affect framerates (like RTSS)
  • Close unnecessary background programs
  • Ensure V-SYNC is not forcefully disabled in your graphics card control panel
  • For NVIDIA users: Enable NVIDIA profile optimization (-nvprofile) in spicecfg's Options tab

If issues persist:

  • Double-check that you followed all steps in the setup guide correctly
  • Your PC hardware might be insufficient to keep a steady 60 FPS. Make sure your PC meets the requirements of this game.
  • Your data may be corrupt in one way or another, you could try starting from scratch using trusted data sources.

Your PC may not meet the specifications for M\u00daSECA. In the arcade, it runs on a Konami PC (ADE-6291):

  • CPU: AMD RX-421BD

  • GPU: Radeon R7

  • RAM: 4 GB

  • OS: Windows 7 Embedded

"},{"location":"games/konami/museca/1plushalf/troubleshooting/#audio","title":"Audio","text":"I can't hear anything else than the game!

Museca only supports WASAPI exclusive for its audio. This means the game takes exclusive control of your audio device while running, which cannot be changed.

I'm not getting any audio/My audio is completely wrecked and I'm using an external DAC!

Many external DACs do not work with WASAPI exclusive mode and therefore won't function with Museca. Usually, you'll need to use your motherboard's onboard audio or a DAC confirmed to be compatible.

"},{"location":"games/konami/museca/1plushalf/troubleshooting/#faq","title":"FAQ","text":"How to run the game in windowed borderless mode?

You'll need to use 3rd party software like Borderless Gaming in order to achieve this.

Can the game be run offline?

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/konami/nostalgia/forte/setup/","title":"Game Setup","text":""},{"location":"games/konami/nostalgia/forte/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/nostalgia/forte/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/nostalgia/forte/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/nostalgia/forte/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

Konami 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/konami/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/konami/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 60 Hz, the game is hardcoded to run at 60 Hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60 Hz. 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 60 Hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.

"},{"location":"games/konami/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/konami/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/konami/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/konami/nostalgia/op2/setup/","title":"Game Setup","text":""},{"location":"games/konami/nostalgia/op2/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/nostalgia/op2/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/nostalgia/op2/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/nostalgia/op2/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

Konami 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/konami/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/konami/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 60 Hz, the game is hardcoded to run at 60 Hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60 Hz. 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 60 Hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.

"},{"location":"games/konami/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/konami/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/konami/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/konami/popn/common/setup/","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 20 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/popn/common/setup/#updating-data","title":"Updating data","text":"

Make sure you're using the right update for your current game version

pop'n music updates have M39 and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., M39_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., M39_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/popn/common/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
"},{"location":"games/konami/popn/common/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIAdvancedOptionsDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

Click on Bind or Naive 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

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

We recommend using popnhax instead of spice2x patching

No need to change anything here

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

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

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/popn/common/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller

You're all done! The game should load up properly now

"},{"location":"games/konami/popn/common/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/popn/common/troubleshooting/","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/popn/common/troubleshooting/#my-game-doesnt-have-audio","title":"My game doesn't have audio","text":"

Enable the HDMI Audio Fix patch.

"},{"location":"games/konami/popn/kaimei_riddles/setup/","title":"Game Setup","text":""},{"location":"games/konami/popn/kaimei_riddles/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/popn/kaimei_riddles/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 20 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/popn/kaimei_riddles/setup/#updating-data","title":"Updating data","text":"

Make sure you're using the right update for your current game version

pop'n music updates have M39 and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., M39_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., M39_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/popn/kaimei_riddles/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
"},{"location":"games/konami/popn/kaimei_riddles/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIAdvancedOptionsDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

Click on Bind or Naive 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

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

We recommend using popnhax instead of spice2x patching

No need to change anything here

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

"},{"location":"games/konami/popn/kaimei_riddles/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/popn/kaimei_riddles/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller

You're all done! The game should load up properly now

"},{"location":"games/konami/popn/kaimei_riddles/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/popn/kaimei_riddles/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/popn/kaimei_riddles/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/popn/peace/setup/","title":"Game Setup","text":""},{"location":"games/konami/popn/peace/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/popn/peace/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 20 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/popn/peace/setup/#updating-data","title":"Updating data","text":"

Make sure you're using the right update for your current game version

pop'n music updates have M39 and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., M39_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., M39_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/popn/peace/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
"},{"location":"games/konami/popn/peace/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIAdvancedOptionsDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

Click on Bind or Naive 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

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

We recommend using popnhax instead of spice2x patching

No need to change anything here

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

"},{"location":"games/konami/popn/peace/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/popn/peace/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller

You're all done! The game should load up properly now

"},{"location":"games/konami/popn/peace/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/popn/peace/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/popn/peace/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/popn/peace/troubleshooting/#my-game-doesnt-have-audio","title":"My game doesn't have audio","text":"

Enable the HDMI Audio Fix patch.

"},{"location":"games/konami/popn/unilab/setup/","title":"Game Setup","text":""},{"location":"games/konami/popn/unilab/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/popn/unilab/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 20 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/popn/unilab/setup/#updating-data","title":"Updating data","text":"

Make sure you're using the right update for your current game version

pop'n music updates have M39 and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., M39_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., M39_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/popn/unilab/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
"},{"location":"games/konami/popn/unilab/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIAdvancedOptionsDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

Click on Bind or Naive 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

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

We recommend using popnhax instead of spice2x patching

No need to change anything here

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

"},{"location":"games/konami/popn/unilab/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/popn/unilab/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller

You're all done! The game should load up properly now

"},{"location":"games/konami/popn/unilab/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/popn/unilab/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/popn/unilab/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/popn/unilab/troubleshooting/#my-game-doesnt-have-audio","title":"My game doesn't have audio","text":"

Enable the HDMI Audio Fix patch.

"},{"location":"games/konami/popn/usaneko/setup/","title":"Game Setup","text":""},{"location":"games/konami/popn/usaneko/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/popn/usaneko/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 20 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/popn/usaneko/setup/#updating-data","title":"Updating data","text":"

Make sure you're using the right update for your current game version

pop'n music updates have M39 and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., M39_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., M39_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/popn/usaneko/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
"},{"location":"games/konami/popn/usaneko/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIAdvancedOptionsDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

Click on Bind or Naive 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

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

We recommend using popnhax instead of spice2x patching

No need to change anything here

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

"},{"location":"games/konami/popn/usaneko/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/popn/usaneko/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller

You're all done! The game should load up properly now

"},{"location":"games/konami/popn/usaneko/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/popn/usaneko/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/popn/usaneko/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/popn/usaneko/troubleshooting/#my-game-doesnt-have-audio","title":"My game doesn't have audio","text":"

Enable the HDMI Audio Fix patch.

"},{"location":"games/konami/reflecbeat/reflesia/setup/","title":"Game Setup","text":""},{"location":"games/konami/reflecbeat/reflesia/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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.

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!

"},{"location":"games/konami/reflecbeat/reflesia/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other errors?

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

"},{"location":"games/konami/reflecbeat/reflesia/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/reflecbeat/reflesia/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/reflecbeat/reflesia/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

Konami PC (ADE-704A)

CPU: Intel Celeron B810 1.6GHz

GPU: E4690 Radeon MXM

OS: Windows XP Embedded

"},{"location":"games/konami/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/konami/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/konami/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 60 Hz, the game is hardcoded to run at 60 Hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60 Hz. 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 60 Hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.

"},{"location":"games/konami/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/konami/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/konami/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/konami/sdvx/4_heavenlyhaven/setup/","title":"Game Setup","text":""},{"location":"games/konami/sdvx/4_heavenlyhaven/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/sdvx/4_heavenlyhaven/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/sdvx/4_heavenlyhaven/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/sdvx/4_heavenlyhaven/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

Konami PC Type 4

CPU: Celeron M 440 1.86GHz

GPU: ATI Radeon HD 2400

RAM: 2 GB

OS: Windows XP Embedded

"},{"location":"games/konami/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/konami/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 60 Hz, the game is hardcoded to run at 60 Hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60 Hz. 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 60 Hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.

"},{"location":"games/konami/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/konami/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/konami/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/konami/sdvx/5_vividwave/setup/","title":"Game Setup","text":""},{"location":"games/konami/sdvx/5_vividwave/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/sdvx/5_vividwave/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/sdvx/5_vividwave/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/sdvx/5_vividwave/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

Konami 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/konami/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/konami/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 60 Hz, the game is hardcoded to run at 60 Hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60 Hz. 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 60 Hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/sdvx/6_exceedgear/extras/","title":"Extra Information","text":""},{"location":"games/konami/sdvx/6_exceedgear/extras/#extra-information","title":"Extra Information","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/sdvx/6_exceedgear/extras/#nemsys-and-valkyrie-modes","title":"Nemsys and Valkyrie modes","text":"

Valkyrie mode requires a 120 Hz capable monitor, or to have patched your .dll with Valkyrie Mode 60 Hz

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/konami/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/konami/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/konami/sdvx/6_exceedgear/setup/","title":"Game Setup","text":""},{"location":"games/konami/sdvx/6_exceedgear/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/sdvx/6_exceedgear/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 20 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2ext\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/sdvx/6_exceedgear/setup/#updating-data","title":"Updating data","text":"

For a comprehensive list of all game updates in chronological order, visit KonamiWiki

Make sure you're using the right update for your current game version

SDVX updates have KFC and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., KFC_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., KFC-OldDateCode-NewDateCode.rar)

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/sdvx/6_exceedgear/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice64.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2ext\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice64.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
Additional steps for AMD and Intel graphics cards

Since KONAMI games are designed for NVIDIA GPU's, AMD and Intel users need additional files:

  • Locate the spice2x\\stubs\\64\\ folder in the spice2x archive
  • Extract all .dll files from there into your game's modules folder
"},{"location":"games/konami/sdvx/6_exceedgear/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

Click on Bind or Naive 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 play with a keyboard:

  • Knobs: VOL-L Left, VOL-L Right, VOL-R Left, Vol-R Right

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

This tab is used to bind analog controls like knobs

Ignore this tab if you play with a keyboard

Bind your controller's knobs

With a controller, instead of binding to VOL-L and VOL-R in the Buttons tab, you need to:

  • Click Bind
  • In Device, pick your controller
  • In Control, pick the control that updates the preview when turning the corresponding knob
  • Click Close, leaving the rest of the settings alone
  • Repeat for your other knob

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

No need to change anything here

"},{"location":"games/konami/sdvx/6_exceedgear/setup/#configuring-audio","title":"Configuring audio","text":"

Check out our general Audio guide to understand audio modes better, at least the TL;DR

  • 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

Then, depending follow instructions for your desired audio mode:

Setup for WASAPI Exclusive (default)
  • Check both boxes under Exclusive Mode
  • Open the Default Format dropdown
  • Pick the 16 bit, 44100 Hz (CD Quality) option, click Apply then OK
Setup for WASAPI Shared
  • Open the Default Format dropdown
  • Pick the 16 bit, 48000 Hz (DVD Quality) option, click Apply then OK
  • Return to spicecfg, go to the Patches tab
  • Following the patching guide and patch Shared Mode WASAPI

Optionally: go to the Options tab, and at the very bottom enable Low Latency Shared Audio to help mitigate the latency penalty from using Shared audio.

Setup for ASIO (requires specialized hardware)
  • Check both boxes under Exclusive Mode
  • Open the Default Format dropdown
  • Pick the 16 bit, 44100 Hz (CD Quality) option, click Apply then OK
"},{"location":"games/konami/sdvx/6_exceedgear/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/sdvx/6_exceedgear/setup/#configuring-your-game","title":"Configuring your game","text":"

Read through the Extra Information page

"},{"location":"games/konami/sdvx/6_exceedgear/setup/#monitor-orientation","title":"Monitor Orientation","text":"

This game requires your main monitor to be set to Portait or Portait (flipped) mode

You will play in Portait mode (Recommended)
  • Right click on your Desktop
  • Select Display settings
  • Look for Display orientation and set it to Portrait or Portrait (flipped)
  • Rotate your monitor 90\u00b0
You cannot play in Portait mode

In this case, your only option is to:

  • Open spicecfg, go to the Options tab
  • Set the game to Windowed Mode (-w)
  • Set your desired Window Resolution (-windowsize) for the game
"},{"location":"games/konami/sdvx/6_exceedgear/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/sdvx/6_exceedgear/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/sdvx/6_exceedgear/setup/#first-launch","title":"First launch","text":"

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

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.

If you're seeing this screen, it means you need to calibrate your knobs.

Press your Test key to go to the service menu.

Instructions on how to navigate the menu are shown at the bottom of the screen:

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

  • Slowly turn your LEFT knob counterclockwise (VOL-L Left) until the line says COUNT = OK then press Start.
  • Slowly turn your LEFT knob clockwise (VOL-L Right) until the line says COUNT = OK then press Start.

Now same thing but for the right knob (VOL-R for keyboard players)

  • Slowly turn your RIGHT knob counterclockwise (VOL-R Left) until the line says COUNT = OK then press Start.
  • Slowly turn your RIGHT knob clockwise (VOL-R Right) until the line says COUNT = OK then 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/konami/sdvx/6_exceedgear/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/sdvx/6_exceedgear/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/sdvx/6_exceedgear/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

For any issues not covered here, spice2x's Known issues page might prove useful

"},{"location":"games/konami/sdvx/6_exceedgear/troubleshooting/#technical-problems","title":"Technical problems","text":""},{"location":"games/konami/sdvx/6_exceedgear/troubleshooting/#crashes","title":"Crashes","text":"

Riva Tuner Statistics Server (RTSS) and MSI Afterburner are known to cause odd crashes.If you have them installed, close them both before starting any arcade game

W:BM2D: CreateLayer() \u6307\u5b9a\u3057\u305f\u30ec\u30a4\u30e4\u30fc\u306f\u5b58\u5728\u3057\u307e\u305b\u3093 then EXCEPTION_ACCESS_VIOLATION in logs

  • Open log.txt using an editor that supports SHIFT-JIS encoding for Japanese text (like Notepad++)

  • Look for this error message: W:BM2D: CreateLayer() \u6307\u5b9a\u3057\u305f\u30ec\u30a4\u30e4\u30fc\u306f\u5b58\u5728\u3057\u307e\u305b\u3093 touch_effect Note: While touch_effect is common, the missing resource name may vary

If you find it, and it's followed by: W:signal: exception raised: EXCEPTION_ACCESS_VIOLATION

Then there's a problem with your game data.

  • Make sure there are no DLL files next to the main game directories (data, prop, etc.) If there are, move them all under the modules directory

For game version 2024-11-05 and newer, check the following files in your modules directory:

  • afp-core.dll should be 1,015 KB
  • afp-utils.dll should be 179 KB

If the sizes don't match:

  • Redownload 2024110500 and newer updates
  • Re-apply all updates in chronological order, always copying all DLL files to the modules directory

If the issue isn't resolved by now, we recommend performing a fresh installation using trusted data sources.

W:SuperstepSound: Audio device is not available!!! in logs

  • Open log.txt using an editor that supports SHIFT-JIS encoding for Japanese text (like Notepad++)

  • Search for Superstep

If you find a line with Audio device is not available!!!, it means the game refuses to boot due to a misconfigured or missing audio device. Check the setup guide's Configuring audio section as well as our general Audio guide to understand the issue better.

I'm using a laptop with a hybrid internal+dedicated GPU setup

Laptops often have odd issues running data. The game may open on the wrong monitor, run at the wrong resolution or framerate, or simply crashes.

There is currently no known fix for this, other than maybe playing in windowed mode, or using a desktop PC instead.

"},{"location":"games/konami/sdvx/6_exceedgear/troubleshooting/#performance","title":"Performance","text":"

Check out spice2x's PC optimization guide

Game is running too slow/fast

Your game is likely running at an incorrect framerate. The expected framerates are:

  • Nemsys mode: 60 FPS
  • Valkyrie mode: 120 FPS

Try these steps to resolve framerate issues:

  • Close any software that can affect framerates (like RTSS)
  • Close unnecessary background programs
  • Ensure V-SYNC is not forcefully disabled in your graphics card control panel
  • For NVIDIA users: Enable NVIDIA profile optimization (-nvprofile) in spicecfg's Options tab

If issues persist:

  • Double-check that you followed all steps in the setup guide correctly
  • Your PC hardware might be insufficient to keep a steady 120 FPS, you can try to either:
    • Patch the game with Valkyrie Mode 60 Hz to stick in Valkyrie mode but run at 60 FPS
    • Switch to Nemsys mode
  • Your data may be corrupt in one way or another, you could try starting from scratch using trusted data sources.
"},{"location":"games/konami/sdvx/6_exceedgear/troubleshooting/#audio","title":"Audio","text":"

Check out our Audio guide to understand audio modes better

Ensure your default audio device's sample rate is set properly

  • 44100 Hz sample rate for WASAPI Exclusive and ASIO
  • 48000 Hz if your game is patched with Shared Mode WASAPI
I can't change my device's sample rate

If you're using gaming peripherals (Logitech/Razer/Steelseries) or external audio devices (audio interfaces/sound bars):

  • Check if you can modify the sample rate in the device's software/control panel
  • If not, try uninstalling the device's software. This may restore control over Windows audio settings

If you still can't change the sample rate:

  • Configure the game's audio mode to match your device's current sample rate instead
  • Try using a different audio device
I can't hear anything else than the game

Your game's audio is setup to run in WASAPI Exclusive or ASIO modes.

Check out our Audio guide to understand audio modes better.

If you're using WASAPI Exclusive, you'll want to patch the game with Shared Mode WASAPI to hear other applications.

If you're using ASIO, unless your audio interface mixes WASAPI and ASIO streams when outputting, you'll only be able to hear one application when ASIO is in use. In this case, you'll need to route all audio through software such as Voicemeeter, and have Voicemeeter output the mix to your ASIO device.

Game audio is too quiet/loud
  • Make sure to not be in a credit as your current progress will be lost
  • Bind and press your Test key to enter the Test menu
  • Go to SOUND OPTIONS and change the volume at will
  • SAVE AND EXIT > GAME MODE to return to the game
"},{"location":"games/konami/sdvx/6_exceedgear/troubleshooting/#subscreen","title":"Subscreen","text":"

For more in-depth troubleshooting, refer to the spice2x Subscreen troubleshooting page

Touch input isn't being registered

If you're using a physical touch screen, make sure to close all spice2x overlays, including the FPS counter. If you're using the virtual subscreen, ensure that the -sdvxnativetouch option is not enabled.

"},{"location":"games/konami/sdvx/6_exceedgear/troubleshooting/#faq","title":"FAQ","text":"How to run the game in windowed borderless mode?

You'll need to use 3rd party software like Borderless Gaming in order to achieve this.

Where are all the navigators? Why am I missing songs?

A lot of content is locked behind events and will not show up unless connected to a network that has written support for these events.

It may also be that the content is only available in specific regions like Japan and your game is configured with another region.

You can fix this by patching Fake Region to Japan (J).

"},{"location":"games/namco/taikonijiiro/setup/","title":"Game Setup","text":""},{"location":"games/namco/taikonijiiro/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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 120 Hz.
  • 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

!!! danger \"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
  • 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":"Troubleshooting","text":""},{"location":"games/namco/taikonijiiro/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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 120 Hz or higher
  • Set your display to 120 Hz. You may need to make a custom resolution.
  • In config.toml set vsync = to true.
If you have a display that is less than 120 Hz
  • In config.toml set vsync = to false and windowed = to true.
  • Alternatively you can use RTSS.
"},{"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:

  • Inside config.toml, set wasapi_shared = to false and set asio = to true.
  • Change asio_driver = to asio_driver = \"<Your ASIO Driver Name>\"

For more information refer to the general Audio guide.

"},{"location":"games/sega/chunithm/air/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/chunithm/air/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/air/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/air/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/air/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/air/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/air/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with an IO DLL to add support for controllers.

The controller you plan on using should also be provided with an IO DLL. 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.

To add your IO DLL, ncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; To use a custom Chunithm IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/air/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/air/controllers/#tasoller","title":"TASOLLER","text":"
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download the TASOLLER IO DLL corrosponding to your firmware version and extract to your App\\bin folder.
    • chuniio-rs (download chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_v2.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/air/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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_plus.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/air/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 chuni 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]\npath=chuniio_yubideck_v3.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/air/controllers/#laverita-3","title":"Laverita 3","text":"
  • 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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_laverita_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/air/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/air/setup/","title":"Game Setup","text":""},{"location":"games/sega/chunithm/air/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/air/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2startup\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0foxGetHwInfo.exe\n\ud83d\udcddoxGetHwInfo.ini\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/air/setup/#updating-data","title":"Updating data","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/air/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/air/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/air/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

Patch Recommendation Description Disable shop close lockout Either Disables the shop lockout from 12 to 8PM JST. 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."},{"location":"games/sega/chunithm/air/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chuni.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchunihook.dll\n\u25b6\ufe0finject.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/air/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/air/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][gfx]

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/air/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"games/sega/chunithm/air/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/air/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/air/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth option).

Select \u914d\u4fe1\u30b5\u30fc\u30d0\u30fc\u8a2d\u5b9a (DISTRIBUTION SEVER SETTING, the first option) and toggle this setting to \u30b5\u30fc\u30d0\u30fc (SERVER).

Select \u7b50\u4f53\u30b0\u30eb\u30fc\u30d7\u8a2d\u5b9a (CABINET GROUP SETTINGS, the second option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

Select \u306f\u3044 (YES) and select \u9589\u3058\u308b

After this, your game will close. Open it back up, and enter the service menu again.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/air/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/air/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/air/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/chunithm/air/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/air/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.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/air/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chuniApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/air/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/air/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/air/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/airplus/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/chunithm/airplus/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/airplus/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/airplus/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/airplus/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/airplus/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/airplus/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with an IO DLL to add support for controllers.

The controller you plan on using should also be provided with an IO DLL. 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.

To add your IO DLL, ncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; To use a custom Chunithm IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/airplus/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/airplus/controllers/#tasoller","title":"TASOLLER","text":"
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download the TASOLLER IO DLL corrosponding to your firmware version and extract to your App\\bin folder.
    • chuniio-rs (download chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_v2.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/airplus/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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_plus.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/airplus/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 chuni 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]\npath=chuniio_yubideck_v3.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/airplus/controllers/#laverita-3","title":"Laverita 3","text":"
  • 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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_laverita_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/airplus/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/airplus/setup/","title":"Game Setup","text":""},{"location":"games/sega/chunithm/airplus/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/airplus/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2startup\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0foxGetHwInfo.exe\n\ud83d\udcddoxGetHwInfo.ini\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/airplus/setup/#updating-data","title":"Updating data","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/airplus/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/airplus/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/airplus/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

Patch Recommendation Description Disable shop close lockout Either Disables the shop lockout from 12 to 8PM JST. 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."},{"location":"games/sega/chunithm/airplus/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chuni.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchunihook.dll\n\u25b6\ufe0finject.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/airplus/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/airplus/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][gfx]

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/airplus/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"games/sega/chunithm/airplus/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/airplus/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/airplus/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth option).

Select \u914d\u4fe1\u30b5\u30fc\u30d0\u30fc\u8a2d\u5b9a (DISTRIBUTION SEVER SETTING, the first option) and toggle this setting to \u30b5\u30fc\u30d0\u30fc (SERVER).

Select \u7b50\u4f53\u30b0\u30eb\u30fc\u30d7\u8a2d\u5b9a (CABINET GROUP SETTINGS, the second option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

Select \u306f\u3044 (YES) and select \u9589\u3058\u308b

After this, your game will close. Open it back up, and enter the service menu again.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/airplus/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/airplus/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/airplus/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/chunithm/airplus/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/airplus/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.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/airplus/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chuniApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/airplus/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/airplus/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/airplus/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/amazon/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/chunithm/amazon/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/amazon/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/amazon/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/amazon/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/amazon/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/amazon/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with an IO DLL to add support for controllers.

The controller you plan on using should also be provided with an IO DLL. 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.

To add your IO DLL, ncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; To use a custom Chunithm IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/amazon/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/amazon/controllers/#tasoller","title":"TASOLLER","text":"
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download the TASOLLER IO DLL corrosponding to your firmware version and extract to your App\\bin folder.
    • chuniio-rs (download chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_v2.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/amazon/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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_plus.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/amazon/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 chuni 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]\npath=chuniio_yubideck_v3.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/amazon/controllers/#laverita-3","title":"Laverita 3","text":"
  • 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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_laverita_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/amazon/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/amazon/setup/","title":"Game Setup","text":""},{"location":"games/sega/chunithm/amazon/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/amazon/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2startup\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0foxGetHwInfo.exe\n\ud83d\udcddoxGetHwInfo.ini\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/amazon/setup/#updating-data","title":"Updating data","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/amazon/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/amazon/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/amazon/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

Patch Recommendation Description Disable shop close lockout Either Disables the shop lockout from 12 to 8PM JST. 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."},{"location":"games/sega/chunithm/amazon/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chuni.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchunihook.dll\n\u25b6\ufe0finject.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/amazon/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/amazon/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][gfx]

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/amazon/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"games/sega/chunithm/amazon/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/amazon/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/amazon/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth option).

Select \u914d\u4fe1\u30b5\u30fc\u30d0\u30fc\u8a2d\u5b9a (DISTRIBUTION SEVER SETTING, the first option) and toggle this setting to \u30b5\u30fc\u30d0\u30fc (SERVER).

Select \u7b50\u4f53\u30b0\u30eb\u30fc\u30d7\u8a2d\u5b9a (CABINET GROUP SETTINGS, the second option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

Select \u306f\u3044 (YES) and select \u9589\u3058\u308b

After this, your game will close. Open it back up, and enter the service menu again.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/amazon/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/amazon/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/amazon/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/chunithm/amazon/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/amazon/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.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/amazon/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chuniApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/amazon/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/amazon/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/amazon/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/amazonplus/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/chunithm/amazonplus/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/amazonplus/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/amazonplus/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/amazonplus/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/amazonplus/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/amazonplus/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with an IO DLL to add support for controllers.

The controller you plan on using should also be provided with an IO DLL. 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.

To add your IO DLL, ncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; To use a custom Chunithm IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/amazonplus/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/amazonplus/controllers/#tasoller","title":"TASOLLER","text":"
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download the TASOLLER IO DLL corrosponding to your firmware version and extract to your App\\bin folder.
    • chuniio-rs (download chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_v2.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/amazonplus/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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_plus.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/amazonplus/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 chuni 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]\npath=chuniio_yubideck_v3.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/amazonplus/controllers/#laverita-3","title":"Laverita 3","text":"
  • 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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_laverita_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/amazonplus/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/amazonplus/setup/","title":"Game Setup","text":""},{"location":"games/sega/chunithm/amazonplus/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/amazonplus/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2startup\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0foxGetHwInfo.exe\n\ud83d\udcddoxGetHwInfo.ini\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/amazonplus/setup/#updating-data","title":"Updating data","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/amazonplus/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/amazonplus/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/amazonplus/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

Patch Recommendation Description Disable shop close lockout Either Disables the shop lockout from 12 to 8PM JST. 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."},{"location":"games/sega/chunithm/amazonplus/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chuni.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchunihook.dll\n\u25b6\ufe0finject.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/amazonplus/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/amazonplus/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][gfx]

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/amazonplus/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"games/sega/chunithm/amazonplus/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/amazonplus/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/amazonplus/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth option).

Select \u914d\u4fe1\u30b5\u30fc\u30d0\u30fc\u8a2d\u5b9a (DISTRIBUTION SEVER SETTING, the first option) and toggle this setting to \u30b5\u30fc\u30d0\u30fc (SERVER).

Select \u7b50\u4f53\u30b0\u30eb\u30fc\u30d7\u8a2d\u5b9a (CABINET GROUP SETTINGS, the second option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

Select \u306f\u3044 (YES) and select \u9589\u3058\u308b

After this, your game will close. Open it back up, and enter the service menu again.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/amazonplus/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/amazonplus/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/amazonplus/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/chunithm/amazonplus/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/amazonplus/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.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/amazonplus/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chuniApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/amazonplus/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/amazonplus/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/amazonplus/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/chunithm/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/chunithm/chunithm/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/chunithm/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/chunithm/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/chunithm/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/chunithm/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/chunithm/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with an IO DLL to add support for controllers.

The controller you plan on using should also be provided with an IO DLL. 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.

To add your IO DLL, ncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; To use a custom Chunithm IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/chunithm/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/chunithm/controllers/#tasoller","title":"TASOLLER","text":"
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download the TASOLLER IO DLL corrosponding to your firmware version and extract to your App\\bin folder.
    • chuniio-rs (download chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_v2.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/chunithm/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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_plus.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/chunithm/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 chuni 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]\npath=chuniio_yubideck_v3.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/chunithm/controllers/#laverita-3","title":"Laverita 3","text":"
  • 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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_laverita_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/chunithm/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/chunithm/setup/","title":"Game Setup","text":"

Warning

This guide is for the original version of CHUNITHM released in 2015. If you want to run a newer version, please find and follow the right guide.

"},{"location":"games/sega/chunithm/chunithm/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/chunithm/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2startup\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0foxGetHwInfo.exe\n\ud83d\udcddoxGetHwInfo.ini\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/chunithm/setup/#updating-data","title":"Updating data","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/chunithm/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/chunithm/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/chunithm/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

Patch Recommendation Description Disable shop close lockout Either Disables the shop lockout from 12 to 8PM JST. 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."},{"location":"games/sega/chunithm/chunithm/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chuni.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchunihook.dll\n\u25b6\ufe0finject.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/chunithm/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/chunithm/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][gfx]

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/chunithm/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"games/sega/chunithm/chunithm/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/chunithm/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/chunithm/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth option).

Select \u914d\u4fe1\u30b5\u30fc\u30d0\u30fc\u8a2d\u5b9a (DISTRIBUTION SEVER SETTING, the first option) and toggle this setting to \u30b5\u30fc\u30d0\u30fc (SERVER).

Select \u7b50\u4f53\u30b0\u30eb\u30fc\u30d7\u8a2d\u5b9a (CABINET GROUP SETTINGS, the second option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

Select \u306f\u3044 (YES) and select \u9589\u3058\u308b

After this, your game will close. Open it back up, and enter the service menu again.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/chunithm/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/chunithm/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/chunithm/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/chunithm/chunithm/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/chunithm/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.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/chunithm/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chuniApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/chunithm/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/chunithm/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/chunithm/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/common/chuni/c2c/","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/common/chuni/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/chuni/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/chuni/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/common/chuni/controllers/","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with an IO DLL to add support for controllers.

The controller you plan on using should also be provided with an IO DLL. 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.

To add your IO DLL, ncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; To use a custom Chunithm IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/common/chuni/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/chuni/controllers/#tasoller","title":"TASOLLER","text":"
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download the TASOLLER IO DLL corrosponding to your firmware version and extract to your App\\bin folder.
    • chuniio-rs (download chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_v2.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/common/chuni/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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_plus.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/common/chuni/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 chuni 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]\npath=chuniio_yubideck_v3.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/common/chuni/controllers/#laverita-3","title":"Laverita 3","text":"
  • 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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_laverita_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/common/chuni/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/chuni/setup/","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/common/chuni/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2startup\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0foxGetHwInfo.exe\n\ud83d\udcddoxGetHwInfo.ini\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/common/chuni/setup/#updating-data","title":"Updating data","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/chuni/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/common/chuni/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 chuniApp.exe and aimeReaderHost.exe for your game version.

  • Copy chuniApp.exe and aimeReaderHost.exe to data's App\\bin folder
  • Agree to overwrite when asked
"},{"location":"games/sega/chunithm/common/chuni/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/chuni/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

Patch Recommendation Description Disable shop close lockout Either Disables the shop lockout from 12 to 8PM JST. 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."},{"location":"games/sega/chunithm/common/chuni/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chuni.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchunihook.dll\n\u25b6\ufe0finject.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/common/chuni/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][gfx] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/common/chuni/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/chuni/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"games/sega/chunithm/common/chuni/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/common/chuni/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/common/chuni/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth option).

Select \u914d\u4fe1\u30b5\u30fc\u30d0\u30fc\u8a2d\u5b9a (DISTRIBUTION SEVER SETTING, the first option) and toggle this setting to \u30b5\u30fc\u30d0\u30fc (SERVER).

Select \u7b50\u4f53\u30b0\u30eb\u30fc\u30d7\u8a2d\u5b9a (CABINET GROUP SETTINGS, the second option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

Select \u306f\u3044 (YES) and select \u9589\u3058\u308b

After this, your game will close. Open it back up, and enter the service menu again.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/chuni/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/common/chuni/setup_belowcrystal/","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/common/chuni/setup_belowcrystal/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2startup\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0foxGetHwInfo.exe\n\ud83d\udcddoxGetHwInfo.ini\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/common/chuni/setup_belowcrystal/#updating-data","title":"Updating data","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/chuni/setup_belowcrystal/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/common/chuni/setup_belowcrystal/#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/chuni/setup_belowcrystal/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

Patch Recommendation Description Disable shop close lockout Either Disables the shop lockout from 12 to 8PM JST. 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."},{"location":"games/sega/chunithm/common/chuni/setup_belowcrystal/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chuni.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchunihook.dll\n\u25b6\ufe0finject.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/common/chuni/setup_belowcrystal/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/chuni/setup_belowcrystal/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][gfx]

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/common/chuni/setup_belowcrystal/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"games/sega/chunithm/common/chuni/setup_belowcrystal/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/common/chuni/setup_belowcrystal/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/common/chuni/setup_belowcrystal/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth option).

Select \u914d\u4fe1\u30b5\u30fc\u30d0\u30fc\u8a2d\u5b9a (DISTRIBUTION SEVER SETTING, the first option) and toggle this setting to \u30b5\u30fc\u30d0\u30fc (SERVER).

Select \u7b50\u4f53\u30b0\u30eb\u30fc\u30d7\u8a2d\u5b9a (CABINET GROUP SETTINGS, the second option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

Select \u306f\u3044 (YES) and select \u9589\u3058\u308b

After this, your game will close. Open it back up, and enter the service menu again.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/chuni/setup_belowcrystal/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/common/chuni/troubleshooting/","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/chunithm/common/chuni/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/chuni/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.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/common/chuni/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chuniApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/common/chuni/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/chuni/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/chuni/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/common/chusan/c2c/","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/common/chusan/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/common/chusan/controllers/","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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\\launch.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 launch.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\\launch.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 mode 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":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/common/chusan/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2license\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/common/chusan/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"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 data's App\\bin folder
  • 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

Avoid patching anything you don't need or understand unless explicitly told to

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 120 Hz monitor check Either Disable checking if the monitor is exactly 120 Hz when enabling 120FPS. Enable if you cannot set your monitor to 120 Hz."},{"location":"games/sega/chunithm/common/chusan/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chusan.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchusanhook_x64.dll\n\u2699\ufe0fchusanhook_x86.dll\n\ud83d\udcc4config_hook.json\n\u25b6\ufe0finject_x64.exe\n\u25b6\ufe0finject_x86.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/common/chusan/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][system][gfx] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

  • If you have a 120 Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60 Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/common/chusan/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/common/chusan/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/common/chusan/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/common/chusan/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth 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.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/common/chusan/troubleshooting/","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60 Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120 Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120 Hz, apply the \"Bypass 120 Hz 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\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 60 Hz or 120 Hz.

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/crystal/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/chunithm/crystal/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/crystal/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/crystal/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/crystal/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/crystal/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/crystal/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with an IO DLL to add support for controllers.

The controller you plan on using should also be provided with an IO DLL. 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.

To add your IO DLL, ncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; To use a custom Chunithm IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/crystal/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/crystal/controllers/#tasoller","title":"TASOLLER","text":"
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download the TASOLLER IO DLL corrosponding to your firmware version and extract to your App\\bin folder.
    • chuniio-rs (download chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_v2.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/crystal/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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_plus.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/crystal/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 chuni 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]\npath=chuniio_yubideck_v3.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/crystal/controllers/#laverita-3","title":"Laverita 3","text":"
  • 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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_laverita_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/crystal/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/crystal/setup/","title":"Game Setup","text":""},{"location":"games/sega/chunithm/crystal/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/crystal/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2startup\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0foxGetHwInfo.exe\n\ud83d\udcddoxGetHwInfo.ini\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/crystal/setup/#updating-data","title":"Updating data","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/crystal/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/crystal/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/crystal/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

Patch Recommendation Description Disable shop close lockout Either Disables the shop lockout from 12 to 8PM JST. 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."},{"location":"games/sega/chunithm/crystal/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chuni.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchunihook.dll\n\u25b6\ufe0finject.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/crystal/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/crystal/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][gfx]

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/crystal/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"games/sega/chunithm/crystal/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/crystal/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/crystal/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth option).

Select \u914d\u4fe1\u30b5\u30fc\u30d0\u30fc\u8a2d\u5b9a (DISTRIBUTION SEVER SETTING, the first option) and toggle this setting to \u30b5\u30fc\u30d0\u30fc (SERVER).

Select \u7b50\u4f53\u30b0\u30eb\u30fc\u30d7\u8a2d\u5b9a (CABINET GROUP SETTINGS, the second option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

Select \u306f\u3044 (YES) and select \u9589\u3058\u308b

After this, your game will close. Open it back up, and enter the service menu again.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/crystal/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/crystal/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/crystal/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/chunithm/crystal/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/crystal/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.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/crystal/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chuniApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/crystal/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/crystal/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/crystal/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/crystalplus/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/chunithm/crystalplus/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/crystalplus/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/crystalplus/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/crystalplus/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/crystalplus/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/crystalplus/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with an IO DLL to add support for controllers.

The controller you plan on using should also be provided with an IO DLL. 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.

To add your IO DLL, ncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; To use a custom Chunithm IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/crystalplus/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/crystalplus/controllers/#tasoller","title":"TASOLLER","text":"
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download the TASOLLER IO DLL corrosponding to your firmware version and extract to your App\\bin folder.
    • chuniio-rs (download chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_v2.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/crystalplus/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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_plus.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/crystalplus/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 chuni 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]\npath=chuniio_yubideck_v3.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/crystalplus/controllers/#laverita-3","title":"Laverita 3","text":"
  • 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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_laverita_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/crystalplus/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/crystalplus/setup/","title":"Game Setup","text":""},{"location":"games/sega/chunithm/crystalplus/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/crystalplus/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2startup\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0foxGetHwInfo.exe\n\ud83d\udcddoxGetHwInfo.ini\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/crystalplus/setup/#updating-data","title":"Updating data","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/crystalplus/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/crystalplus/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 chuniApp.exe and aimeReaderHost.exe for your game version.

  • Copy chuniApp.exe and aimeReaderHost.exe to data's App\\bin folder
  • Agree to overwrite when asked
"},{"location":"games/sega/chunithm/crystalplus/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/crystalplus/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

Patch Recommendation Description Disable shop close lockout Either Disables the shop lockout from 12 to 8PM JST. 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."},{"location":"games/sega/chunithm/crystalplus/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chuni.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchunihook.dll\n\u25b6\ufe0finject.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/crystalplus/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][gfx] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/crystalplus/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/crystalplus/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"games/sega/chunithm/crystalplus/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/crystalplus/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/crystalplus/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth option).

Select \u914d\u4fe1\u30b5\u30fc\u30d0\u30fc\u8a2d\u5b9a (DISTRIBUTION SEVER SETTING, the first option) and toggle this setting to \u30b5\u30fc\u30d0\u30fc (SERVER).

Select \u7b50\u4f53\u30b0\u30eb\u30fc\u30d7\u8a2d\u5b9a (CABINET GROUP SETTINGS, the second option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

Select \u306f\u3044 (YES) and select \u9589\u3058\u308b

After this, your game will close. Open it back up, and enter the service menu again.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/crystalplus/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/crystalplus/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/crystalplus/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/chunithm/crystalplus/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/crystalplus/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.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/crystalplus/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chuniApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/crystalplus/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/crystalplus/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/crystalplus/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","text":""},{"location":"games/sega/chunithm/luminous/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/luminous/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/luminous/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/luminous/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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\\launch.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 launch.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\\launch.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 mode 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","text":""},{"location":"games/sega/chunithm/luminous/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/luminous/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2license\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/luminous/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"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 data's App\\bin folder
  • 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

Avoid patching anything you don't need or understand unless explicitly told to

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 120 Hz monitor check Either Disable checking if the monitor is exactly 120 Hz when enabling 120FPS. Enable if you cannot set your monitor to 120 Hz."},{"location":"games/sega/chunithm/luminous/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chusan.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchusanhook_x64.dll\n\u2699\ufe0fchusanhook_x86.dll\n\ud83d\udcc4config_hook.json\n\u25b6\ufe0finject_x64.exe\n\u25b6\ufe0finject_x86.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/luminous/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][system][gfx] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

  • If you have a 120 Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60 Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/luminous/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/luminous/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/luminous/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/luminous/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth 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.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/luminous/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/luminous/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60 Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120 Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120 Hz, apply the \"Bypass 120 Hz 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\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 60 Hz or 120 Hz.

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","text":""},{"location":"games/sega/chunithm/luminousplus/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/luminousplus/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/luminousplus/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/luminousplus/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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\\launch.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 launch.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\\launch.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 mode 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","text":""},{"location":"games/sega/chunithm/luminousplus/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/luminousplus/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2license\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/luminousplus/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"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 data's App\\bin folder
  • 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

Avoid patching anything you don't need or understand unless explicitly told to

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 120 Hz monitor check Either Disable checking if the monitor is exactly 120 Hz when enabling 120FPS. Enable if you cannot set your monitor to 120 Hz."},{"location":"games/sega/chunithm/luminousplus/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chusan.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchusanhook_x64.dll\n\u2699\ufe0fchusanhook_x86.dll\n\ud83d\udcc4config_hook.json\n\u25b6\ufe0finject_x64.exe\n\u25b6\ufe0finject_x86.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/luminousplus/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][system][gfx] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

  • If you have a 120 Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60 Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/luminousplus/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/luminousplus/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/luminousplus/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/luminousplus/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth 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.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/luminousplus/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/luminousplus/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60 Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120 Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120 Hz, apply the \"Bypass 120 Hz 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\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 60 Hz or 120 Hz.

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","text":""},{"location":"games/sega/chunithm/new/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/new/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/new/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/new/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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\\launch.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 launch.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\\launch.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 mode 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","text":""},{"location":"games/sega/chunithm/new/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/new/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2license\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/new/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"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 data's App\\bin folder
  • 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

Avoid patching anything you don't need or understand unless explicitly told to

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 120 Hz monitor check Either Disable checking if the monitor is exactly 120 Hz when enabling 120FPS. Enable if you cannot set your monitor to 120 Hz."},{"location":"games/sega/chunithm/new/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chusan.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchusanhook_x64.dll\n\u2699\ufe0fchusanhook_x86.dll\n\ud83d\udcc4config_hook.json\n\u25b6\ufe0finject_x64.exe\n\u25b6\ufe0finject_x86.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/new/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][system][gfx] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

  • If you have a 120 Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60 Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/new/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/new/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/new/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/new/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth 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.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/new/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/new/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60 Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120 Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120 Hz, apply the \"Bypass 120 Hz 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\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 60 Hz or 120 Hz.

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","text":""},{"location":"games/sega/chunithm/newplus/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/newplus/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/newplus/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/newplus/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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\\launch.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 launch.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\\launch.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 mode 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","text":""},{"location":"games/sega/chunithm/newplus/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/newplus/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2license\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/newplus/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"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 data's App\\bin folder
  • 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

Avoid patching anything you don't need or understand unless explicitly told to

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 120 Hz monitor check Either Disable checking if the monitor is exactly 120 Hz when enabling 120FPS. Enable if you cannot set your monitor to 120 Hz."},{"location":"games/sega/chunithm/newplus/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chusan.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchusanhook_x64.dll\n\u2699\ufe0fchusanhook_x86.dll\n\ud83d\udcc4config_hook.json\n\u25b6\ufe0finject_x64.exe\n\u25b6\ufe0finject_x86.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/newplus/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][system][gfx] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

  • If you have a 120 Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60 Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/newplus/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/newplus/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/newplus/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/newplus/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth 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.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/newplus/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/newplus/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60 Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120 Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120 Hz, apply the \"Bypass 120 Hz 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\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 60 Hz or 120 Hz.

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/paradise/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/chunithm/paradise/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/paradise/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/paradise/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/paradise/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/paradise/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/paradise/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with an IO DLL to add support for controllers.

The controller you plan on using should also be provided with an IO DLL. 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.

To add your IO DLL, ncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; To use a custom Chunithm IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/paradise/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/paradise/controllers/#tasoller","title":"TASOLLER","text":"
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download the TASOLLER IO DLL corrosponding to your firmware version and extract to your App\\bin folder.
    • chuniio-rs (download chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_v2.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/paradise/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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_plus.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/paradise/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 chuni 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]\npath=chuniio_yubideck_v3.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/paradise/controllers/#laverita-3","title":"Laverita 3","text":"
  • 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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_laverita_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/paradise/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/paradise/setup/","title":"Game Setup","text":""},{"location":"games/sega/chunithm/paradise/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/paradise/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2startup\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0foxGetHwInfo.exe\n\ud83d\udcddoxGetHwInfo.ini\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/paradise/setup/#updating-data","title":"Updating data","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/paradise/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/paradise/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 chuniApp.exe and aimeReaderHost.exe for your game version.

  • Copy chuniApp.exe and aimeReaderHost.exe to data's App\\bin folder
  • Agree to overwrite when asked
"},{"location":"games/sega/chunithm/paradise/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/paradise/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

Patch Recommendation Description Disable shop close lockout Either Disables the shop lockout from 12 to 8PM JST. 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."},{"location":"games/sega/chunithm/paradise/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chuni.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchunihook.dll\n\u25b6\ufe0finject.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/paradise/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][gfx] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/paradise/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/paradise/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"games/sega/chunithm/paradise/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/paradise/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/paradise/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth option).

Select \u914d\u4fe1\u30b5\u30fc\u30d0\u30fc\u8a2d\u5b9a (DISTRIBUTION SEVER SETTING, the first option) and toggle this setting to \u30b5\u30fc\u30d0\u30fc (SERVER).

Select \u7b50\u4f53\u30b0\u30eb\u30fc\u30d7\u8a2d\u5b9a (CABINET GROUP SETTINGS, the second option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

Select \u306f\u3044 (YES) and select \u9589\u3058\u308b

After this, your game will close. Open it back up, and enter the service menu again.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/paradise/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/paradise/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/paradise/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/chunithm/paradise/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/paradise/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.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/paradise/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chuniApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/paradise/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/paradise/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/paradise/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/paradiselost/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/chunithm/paradiselost/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/paradiselost/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/paradiselost/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/paradiselost/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/paradiselost/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/paradiselost/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with an IO DLL to add support for controllers.

The controller you plan on using should also be provided with an IO DLL. 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.

To add your IO DLL, ncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; To use a custom Chunithm IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/paradiselost/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/paradiselost/controllers/#tasoller","title":"TASOLLER","text":"
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download the TASOLLER IO DLL corrosponding to your firmware version and extract to your App\\bin folder.
    • chuniio-rs (download chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_v2.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/paradiselost/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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_plus.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/paradiselost/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 chuni 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]\npath=chuniio_yubideck_v3.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/paradiselost/controllers/#laverita-3","title":"Laverita 3","text":"
  • 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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_laverita_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/paradiselost/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/paradiselost/setup/","title":"Game Setup","text":""},{"location":"games/sega/chunithm/paradiselost/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/paradiselost/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2startup\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0foxGetHwInfo.exe\n\ud83d\udcddoxGetHwInfo.ini\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/paradiselost/setup/#updating-data","title":"Updating data","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/paradiselost/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/paradiselost/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 chuniApp.exe and aimeReaderHost.exe for your game version.

  • Copy chuniApp.exe and aimeReaderHost.exe to data's App\\bin folder
  • Agree to overwrite when asked
"},{"location":"games/sega/chunithm/paradiselost/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/paradiselost/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

Patch Recommendation Description Disable shop close lockout Either Disables the shop lockout from 12 to 8PM JST. 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."},{"location":"games/sega/chunithm/paradiselost/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chuni.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchunihook.dll\n\u25b6\ufe0finject.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/paradiselost/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][gfx] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/paradiselost/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/paradiselost/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"games/sega/chunithm/paradiselost/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/paradiselost/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/paradiselost/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth option).

Select \u914d\u4fe1\u30b5\u30fc\u30d0\u30fc\u8a2d\u5b9a (DISTRIBUTION SEVER SETTING, the first option) and toggle this setting to \u30b5\u30fc\u30d0\u30fc (SERVER).

Select \u7b50\u4f53\u30b0\u30eb\u30fc\u30d7\u8a2d\u5b9a (CABINET GROUP SETTINGS, the second option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

Select \u306f\u3044 (YES) and select \u9589\u3058\u308b

After this, your game will close. Open it back up, and enter the service menu again.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/paradiselost/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/paradiselost/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/paradiselost/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/chunithm/paradiselost/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/paradiselost/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.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/paradiselost/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chuniApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/paradiselost/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/paradiselost/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/paradiselost/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/plus/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/chunithm/plus/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/plus/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/plus/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/plus/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/plus/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/plus/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with an IO DLL to add support for controllers.

The controller you plan on using should also be provided with an IO DLL. 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.

To add your IO DLL, ncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; To use a custom Chunithm IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/plus/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/plus/controllers/#tasoller","title":"TASOLLER","text":"
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download the TASOLLER IO DLL corrosponding to your firmware version and extract to your App\\bin folder.
    • chuniio-rs (download chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_v2.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/plus/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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_plus.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/plus/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 chuni 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]\npath=chuniio_yubideck_v3.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/plus/controllers/#laverita-3","title":"Laverita 3","text":"
  • 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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_laverita_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/plus/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/plus/setup/","title":"Game Setup","text":""},{"location":"games/sega/chunithm/plus/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/plus/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2startup\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0foxGetHwInfo.exe\n\ud83d\udcddoxGetHwInfo.ini\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/plus/setup/#updating-data","title":"Updating data","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/plus/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/plus/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/plus/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

Patch Recommendation Description Disable shop close lockout Either Disables the shop lockout from 12 to 8PM JST. 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."},{"location":"games/sega/chunithm/plus/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chuni.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchunihook.dll\n\u25b6\ufe0finject.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/plus/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/plus/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][gfx]

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/plus/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"games/sega/chunithm/plus/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/plus/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/plus/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth option).

Select \u914d\u4fe1\u30b5\u30fc\u30d0\u30fc\u8a2d\u5b9a (DISTRIBUTION SEVER SETTING, the first option) and toggle this setting to \u30b5\u30fc\u30d0\u30fc (SERVER).

Select \u7b50\u4f53\u30b0\u30eb\u30fc\u30d7\u8a2d\u5b9a (CABINET GROUP SETTINGS, the second option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

Select \u306f\u3044 (YES) and select \u9589\u3058\u308b

After this, your game will close. Open it back up, and enter the service menu again.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/plus/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/plus/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/plus/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/chunithm/plus/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/plus/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.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/plus/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chuniApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/plus/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/plus/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/plus/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/star/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/chunithm/star/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/star/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/star/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/star/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/star/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/star/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with an IO DLL to add support for controllers.

The controller you plan on using should also be provided with an IO DLL. 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.

To add your IO DLL, ncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; To use a custom Chunithm IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/star/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/star/controllers/#tasoller","title":"TASOLLER","text":"
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download the TASOLLER IO DLL corrosponding to your firmware version and extract to your App\\bin folder.
    • chuniio-rs (download chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_v2.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/star/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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_plus.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/star/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 chuni 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]\npath=chuniio_yubideck_v3.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/star/controllers/#laverita-3","title":"Laverita 3","text":"
  • 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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_laverita_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/star/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/star/setup/","title":"Game Setup","text":""},{"location":"games/sega/chunithm/star/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/star/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2startup\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0foxGetHwInfo.exe\n\ud83d\udcddoxGetHwInfo.ini\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/star/setup/#updating-data","title":"Updating data","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/star/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/star/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/star/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

Patch Recommendation Description Disable shop close lockout Either Disables the shop lockout from 12 to 8PM JST. 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."},{"location":"games/sega/chunithm/star/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chuni.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchunihook.dll\n\u25b6\ufe0finject.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/star/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/star/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][gfx]

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/star/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"games/sega/chunithm/star/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/star/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/star/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth option).

Select \u914d\u4fe1\u30b5\u30fc\u30d0\u30fc\u8a2d\u5b9a (DISTRIBUTION SEVER SETTING, the first option) and toggle this setting to \u30b5\u30fc\u30d0\u30fc (SERVER).

Select \u7b50\u4f53\u30b0\u30eb\u30fc\u30d7\u8a2d\u5b9a (CABINET GROUP SETTINGS, the second option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

Select \u306f\u3044 (YES) and select \u9589\u3058\u308b

After this, your game will close. Open it back up, and enter the service menu again.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/star/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/star/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/star/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/chunithm/star/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/star/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.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/star/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chuniApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/star/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/star/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/star/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/starplus/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/chunithm/starplus/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/starplus/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/starplus/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/starplus/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/starplus/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/starplus/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with an IO DLL to add support for controllers.

The controller you plan on using should also be provided with an IO DLL. 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.

To add your IO DLL, ncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; To use a custom Chunithm IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/starplus/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/starplus/controllers/#tasoller","title":"TASOLLER","text":"
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download the TASOLLER IO DLL corrosponding to your firmware version and extract to your App\\bin folder.
    • chuniio-rs (download chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_v2.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/starplus/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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_plus.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/starplus/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 chuni 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]\npath=chuniio_yubideck_v3.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/starplus/controllers/#laverita-3","title":"Laverita 3","text":"
  • 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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_laverita_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/starplus/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/starplus/setup/","title":"Game Setup","text":""},{"location":"games/sega/chunithm/starplus/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/starplus/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2startup\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0foxGetHwInfo.exe\n\ud83d\udcddoxGetHwInfo.ini\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/starplus/setup/#updating-data","title":"Updating data","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/starplus/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/starplus/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/starplus/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

Patch Recommendation Description Disable shop close lockout Either Disables the shop lockout from 12 to 8PM JST. 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."},{"location":"games/sega/chunithm/starplus/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chuni.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchunihook.dll\n\u25b6\ufe0finject.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/starplus/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/starplus/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][gfx]

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/starplus/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"games/sega/chunithm/starplus/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/starplus/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/starplus/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth option).

Select \u914d\u4fe1\u30b5\u30fc\u30d0\u30fc\u8a2d\u5b9a (DISTRIBUTION SEVER SETTING, the first option) and toggle this setting to \u30b5\u30fc\u30d0\u30fc (SERVER).

Select \u7b50\u4f53\u30b0\u30eb\u30fc\u30d7\u8a2d\u5b9a (CABINET GROUP SETTINGS, the second option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

Select \u306f\u3044 (YES) and select \u9589\u3058\u308b

After this, your game will close. Open it back up, and enter the service menu again.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/starplus/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/starplus/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/starplus/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/chunithm/starplus/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/starplus/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.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/starplus/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chuniApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/starplus/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/starplus/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/starplus/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","text":""},{"location":"games/sega/chunithm/sun/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/sun/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/sun/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/sun/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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\\launch.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 launch.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\\launch.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 mode 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","text":""},{"location":"games/sega/chunithm/sun/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/sun/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2license\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/sun/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"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 data's App\\bin folder
  • 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

Avoid patching anything you don't need or understand unless explicitly told to

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 120 Hz monitor check Either Disable checking if the monitor is exactly 120 Hz when enabling 120FPS. Enable if you cannot set your monitor to 120 Hz."},{"location":"games/sega/chunithm/sun/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chusan.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchusanhook_x64.dll\n\u2699\ufe0fchusanhook_x86.dll\n\ud83d\udcc4config_hook.json\n\u25b6\ufe0finject_x64.exe\n\u25b6\ufe0finject_x86.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/sun/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][system][gfx] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

  • If you have a 120 Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60 Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/sun/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/sun/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/sun/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/sun/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth 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.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/sun/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/sun/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60 Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120 Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120 Hz, apply the \"Bypass 120 Hz 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\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 60 Hz or 120 Hz.

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","text":""},{"location":"games/sega/chunithm/sunplus/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/sunplus/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/sunplus/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/sunplus/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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\\launch.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 launch.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\\launch.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 mode 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","text":""},{"location":"games/sega/chunithm/sunplus/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/sunplus/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2license\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/sunplus/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"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 data's App\\bin folder
  • 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

Avoid patching anything you don't need or understand unless explicitly told to

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 120 Hz monitor check Either Disable checking if the monitor is exactly 120 Hz when enabling 120FPS. Enable if you cannot set your monitor to 120 Hz."},{"location":"games/sega/chunithm/sunplus/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chusan.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchusanhook_x64.dll\n\u2699\ufe0fchusanhook_x86.dll\n\ud83d\udcc4config_hook.json\n\u25b6\ufe0finject_x64.exe\n\u25b6\ufe0finject_x86.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/sunplus/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][system][gfx] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

  • If you have a 120 Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60 Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/sunplus/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/sunplus/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/sunplus/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/sunplus/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth 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.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/sunplus/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/sunplus/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60 Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120 Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120 Hz, apply the \"Bypass 120 Hz 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\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 60 Hz or 120 Hz.

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","text":""},{"location":"games/sega/chunithm/verse/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/verse/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/verse/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/verse/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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\\launch.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 launch.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\\launch.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 mode 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","text":""},{"location":"games/sega/chunithm/verse/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/verse/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2license\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/verse/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"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 data's App\\bin folder
  • 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

Avoid patching anything you don't need or understand unless explicitly told to

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 120 Hz monitor check Either Disable checking if the monitor is exactly 120 Hz when enabling 120FPS. Enable if you cannot set your monitor to 120 Hz."},{"location":"games/sega/chunithm/verse/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chusan.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchusanhook_x64.dll\n\u2699\ufe0fchusanhook_x86.dll\n\ud83d\udcc4config_hook.json\n\u25b6\ufe0finject_x64.exe\n\u25b6\ufe0finject_x86.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/verse/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][system][gfx] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

  • If you have a 120 Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60 Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/verse/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/verse/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/verse/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/verse/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth 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.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/verse/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/verse/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60 Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120 Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120 Hz, apply the \"Bypass 120 Hz 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\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 60 Hz or 120 Hz.

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/chunithm/x-verse/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/chunithm/x-verse/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/x-verse/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/x-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/x-verse/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/x-verse/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/x-verse/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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/x-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/x-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/x-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\\launch.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 launch.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/x-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\\launch.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/x-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/x-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/x-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/x-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 mode 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/x-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/x-verse/setup/","title":"Game Setup","text":""},{"location":"games/sega/chunithm/x-verse/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/x-verse/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2license\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/x-verse/setup/#updating-data","title":"Updating data","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/x-verse/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/x-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 data's App\\bin folder
  • Agree to overwrite when asked
"},{"location":"games/sega/chunithm/x-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/x-verse/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

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 120 Hz monitor check Either Disable checking if the monitor is exactly 120 Hz when enabling 120FPS. Enable if you cannot set your monitor to 120 Hz."},{"location":"games/sega/chunithm/x-verse/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chusan.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchusanhook_x64.dll\n\u2699\ufe0fchusanhook_x86.dll\n\ud83d\udcc4config_hook.json\n\u25b6\ufe0finject_x64.exe\n\u25b6\ufe0finject_x86.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/x-verse/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][system][gfx] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

  • If you have a 120 Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60 Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/x-verse/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/x-verse/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/x-verse/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/x-verse/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/x-verse/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth 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.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/x-verse/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/x-verse/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/x-verse/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/chunithm/x-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.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60 Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120 Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120 Hz, apply the \"Bypass 120 Hz 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\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/x-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/x-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 60 Hz or 120 Hz.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/x-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/x-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/x-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/x-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":"Controllers","text":""},{"location":"games/sega/maimaidx/buddies/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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":"Game Setup","text":""},{"location":"games/sega/maimaidx/buddies/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/maimaidx/buddies/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2license\n\ud83d\udcc2package\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/maimaidx/buddies/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

  • maimai DX JPN(SDEZ): each new release of maimai DX increments the first letter of the Options (ie. H??? for BUDDiES, I??? BUDDiES+)
  • maimai DX EXP(SDGA): Options will always begin with the letter A (i.e A???)
  • ??? represents a sequence of numbers

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2H005\n\u2523\u2501\ud83d\udcc2H011\n\u2523\u2501\ud83d\udcc2H031\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example H005 then H011

Do not mix option data between game 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 of the following folders and files:
\u25b6\ufe0famdaemon.exe\n\u25b6\ufe0fSinmai.exe\n\ud83d\udcc2Sinmai_Data\n\u2523\u2501\ud83d\udcc2Plugins\n\u2503  \u2523\u2501\u2699\ufe0famdaemon_api.dll\n\u2503  \u2517\u2501\u2699\ufe0fCake.dll (JPN/SDEZ only)\n\u2517\u2501\ud83d\udcc2Managed\n   \u2523\u2501\u2699\ufe0fAMDaemon.NET.dll\n   \u2517\u2501\u2699\ufe0fAssembly-CSharp.dll\n\ud83d\udcddmai2.ini\n
  • Copy all of the above to your data's App\\package folder
  • Agree to overwrite when asked

Assembly-CSharp Notes

Assembly-CSharp.dll must match your game version. All other files can be reused between 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":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find mai2.zip and extract it to your data's App\\package folder

You should now have these files added to your App\\package directory:

\ud83d\udcc2DEVICE\n\u25b6\ufe0finject.exe\n\u2699\ufe0fmai2hook.dll\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/maimaidx/buddies/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\package\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

AquaMai

Find more information about AquaMai on their GitHub page. Also check our Unity modding guide.

"},{"location":"games/sega/maimaidx/buddies/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/maimaidx/buddies/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/maimaidx/buddies/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/maimaidx/buddies/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\package\\launch.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.

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/maimaidx/buddies/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/maimaidx/buddies/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/maimaidx/buddies/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
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\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

"},{"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":"Controllers","text":""},{"location":"games/sega/maimaidx/buddiesplus/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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":"Game Setup","text":""},{"location":"games/sega/maimaidx/buddiesplus/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2license\n\ud83d\udcc2package\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

  • maimai DX JPN(SDEZ): each new release of maimai DX increments the first letter of the Options (ie. H??? for BUDDiES, I??? BUDDiES+)
  • maimai DX EXP(SDGA): Options will always begin with the letter A (i.e A???)
  • ??? represents a sequence of numbers

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2H005\n\u2523\u2501\ud83d\udcc2H011\n\u2523\u2501\ud83d\udcc2H031\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example H005 then H011

Do not mix option data between game 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 of the following folders and files:
\u25b6\ufe0famdaemon.exe\n\u25b6\ufe0fSinmai.exe\n\ud83d\udcc2Sinmai_Data\n\u2523\u2501\ud83d\udcc2Plugins\n\u2503  \u2523\u2501\u2699\ufe0famdaemon_api.dll\n\u2503  \u2517\u2501\u2699\ufe0fCake.dll (JPN/SDEZ only)\n\u2517\u2501\ud83d\udcc2Managed\n   \u2523\u2501\u2699\ufe0fAMDaemon.NET.dll\n   \u2517\u2501\u2699\ufe0fAssembly-CSharp.dll\n\ud83d\udcddmai2.ini\n
  • Copy all of the above to your data's App\\package folder
  • Agree to overwrite when asked

Assembly-CSharp Notes

Assembly-CSharp.dll must match your game version. All other files can be reused between 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":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find mai2.zip and extract it to your data's App\\package folder

You should now have these files added to your App\\package directory:

\ud83d\udcc2DEVICE\n\u25b6\ufe0finject.exe\n\u2699\ufe0fmai2hook.dll\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/maimaidx/buddiesplus/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\package\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

AquaMai

Find more information about AquaMai on their GitHub page. Also check our Unity modding guide.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/maimaidx/buddiesplus/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/maimaidx/buddiesplus/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\package\\launch.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.

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/maimaidx/buddiesplus/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/maimaidx/buddiesplus/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/maimaidx/buddiesplus/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
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\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

"},{"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/circle/controllers/","title":"Controllers","text":""},{"location":"games/sega/maimaidx/circle/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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/circle/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/circle/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/circle/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/circle/setup/","title":"Game Setup","text":""},{"location":"games/sega/maimaidx/circle/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/maimaidx/circle/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2license\n\ud83d\udcc2package\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/maimaidx/circle/setup/#updating-data","title":"Updating data","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/circle/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

  • maimai DX JPN(SDEZ): each new release of maimai DX increments the first letter of the Options (ie. H??? for BUDDiES, I??? BUDDiES+)
  • maimai DX EXP(SDGA): Options will always begin with the letter A (i.e A???)
  • ??? represents a sequence of numbers

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2H005\n\u2523\u2501\ud83d\udcc2H011\n\u2523\u2501\ud83d\udcc2H031\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example H005 then H011

Do not mix option data between game versions

"},{"location":"games/sega/maimaidx/circle/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 of the following folders and files:
\u25b6\ufe0famdaemon.exe\n\u25b6\ufe0fSinmai.exe\n\ud83d\udcc2Sinmai_Data\n\u2523\u2501\ud83d\udcc2Plugins\n\u2503  \u2523\u2501\u2699\ufe0famdaemon_api.dll\n\u2503  \u2517\u2501\u2699\ufe0fCake.dll (JPN/SDEZ only)\n\u2517\u2501\ud83d\udcc2Managed\n   \u2523\u2501\u2699\ufe0fAMDaemon.NET.dll\n   \u2517\u2501\u2699\ufe0fAssembly-CSharp.dll\n\ud83d\udcddmai2.ini\n
  • Copy all of the above to your data's App\\package folder
  • Agree to overwrite when asked

Assembly-CSharp Notes

Assembly-CSharp.dll must match your game version. All other files can be reused between game versions.

"},{"location":"games/sega/maimaidx/circle/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/circle/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/circle/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find mai2.zip and extract it to your data's App\\package folder

You should now have these files added to your App\\package directory:

\ud83d\udcc2DEVICE\n\u25b6\ufe0finject.exe\n\u2699\ufe0fmai2hook.dll\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/maimaidx/circle/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\package\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

AquaMai

Find more information about AquaMai on their GitHub page. Also check our Unity modding guide.

"},{"location":"games/sega/maimaidx/circle/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/circle/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/maimaidx/circle/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/maimaidx/circle/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/maimaidx/circle/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\package\\launch.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.

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/maimaidx/circle/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/maimaidx/circle/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/maimaidx/circle/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/maimaidx/circle/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.
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\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/circle/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

"},{"location":"games/sega/maimaidx/circle/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/circle/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":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

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

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2license\n\ud83d\udcc2package\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/maimaidx/common/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

  • maimai DX JPN(SDEZ): each new release of maimai DX increments the first letter of the Options (ie. H??? for BUDDiES, I??? BUDDiES+)
  • maimai DX EXP(SDGA): Options will always begin with the letter A (i.e A???)
  • ??? represents a sequence of numbers

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2H005\n\u2523\u2501\ud83d\udcc2H011\n\u2523\u2501\ud83d\udcc2H031\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example H005 then H011

Do not mix option data between game 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 of the following folders and files:
\u25b6\ufe0famdaemon.exe\n\u25b6\ufe0fSinmai.exe\n\ud83d\udcc2Sinmai_Data\n\u2523\u2501\ud83d\udcc2Plugins\n\u2503  \u2523\u2501\u2699\ufe0famdaemon_api.dll\n\u2503  \u2517\u2501\u2699\ufe0fCake.dll (JPN/SDEZ only)\n\u2517\u2501\ud83d\udcc2Managed\n   \u2523\u2501\u2699\ufe0fAMDaemon.NET.dll\n   \u2517\u2501\u2699\ufe0fAssembly-CSharp.dll\n\ud83d\udcddmai2.ini\n
  • Copy all of the above to your data's App\\package folder
  • Agree to overwrite when asked

Assembly-CSharp Notes

Assembly-CSharp.dll must match your game version. All other files can be reused between 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":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find mai2.zip and extract it to your data's App\\package folder

You should now have these files added to your App\\package directory:

\ud83d\udcc2DEVICE\n\u25b6\ufe0finject.exe\n\u2699\ufe0fmai2hook.dll\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/maimaidx/common/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\package\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

AquaMai

Find more information about AquaMai on their GitHub page. Also check our Unity modding guide.

"},{"location":"games/sega/maimaidx/common/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/maimaidx/common/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/maimaidx/common/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/maimaidx/common/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\package\\launch.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.

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/maimaidx/common/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/maimaidx/common/troubleshooting/","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
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\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

"},{"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":"Controllers","text":""},{"location":"games/sega/maimaidx/prism/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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":"Game Setup","text":""},{"location":"games/sega/maimaidx/prism/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/maimaidx/prism/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2license\n\ud83d\udcc2package\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/maimaidx/prism/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

  • maimai DX JPN(SDEZ): each new release of maimai DX increments the first letter of the Options (ie. H??? for BUDDiES, I??? BUDDiES+)
  • maimai DX EXP(SDGA): Options will always begin with the letter A (i.e A???)
  • ??? represents a sequence of numbers

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2H005\n\u2523\u2501\ud83d\udcc2H011\n\u2523\u2501\ud83d\udcc2H031\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example H005 then H011

Do not mix option data between game 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 of the following folders and files:
\u25b6\ufe0famdaemon.exe\n\u25b6\ufe0fSinmai.exe\n\ud83d\udcc2Sinmai_Data\n\u2523\u2501\ud83d\udcc2Plugins\n\u2503  \u2523\u2501\u2699\ufe0famdaemon_api.dll\n\u2503  \u2517\u2501\u2699\ufe0fCake.dll (JPN/SDEZ only)\n\u2517\u2501\ud83d\udcc2Managed\n   \u2523\u2501\u2699\ufe0fAMDaemon.NET.dll\n   \u2517\u2501\u2699\ufe0fAssembly-CSharp.dll\n\ud83d\udcddmai2.ini\n
  • Copy all of the above to your data's App\\package folder
  • Agree to overwrite when asked

Assembly-CSharp Notes

Assembly-CSharp.dll must match your game version. All other files can be reused between 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":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find mai2.zip and extract it to your data's App\\package folder

You should now have these files added to your App\\package directory:

\ud83d\udcc2DEVICE\n\u25b6\ufe0finject.exe\n\u2699\ufe0fmai2hook.dll\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/maimaidx/prism/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\package\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

AquaMai

Find more information about AquaMai on their GitHub page. Also check our Unity modding guide.

"},{"location":"games/sega/maimaidx/prism/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/maimaidx/prism/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/maimaidx/prism/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/maimaidx/prism/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\package\\launch.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.

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/maimaidx/prism/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/maimaidx/prism/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/maimaidx/prism/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
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\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

"},{"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":"Controllers","text":""},{"location":"games/sega/maimaidx/prismplus/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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":"Game Setup","text":""},{"location":"games/sega/maimaidx/prismplus/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/maimaidx/prismplus/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2license\n\ud83d\udcc2package\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/maimaidx/prismplus/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

  • maimai DX JPN(SDEZ): each new release of maimai DX increments the first letter of the Options (ie. H??? for BUDDiES, I??? BUDDiES+)
  • maimai DX EXP(SDGA): Options will always begin with the letter A (i.e A???)
  • ??? represents a sequence of numbers

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2H005\n\u2523\u2501\ud83d\udcc2H011\n\u2523\u2501\ud83d\udcc2H031\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example H005 then H011

Do not mix option data between game 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 of the following folders and files:
\u25b6\ufe0famdaemon.exe\n\u25b6\ufe0fSinmai.exe\n\ud83d\udcc2Sinmai_Data\n\u2523\u2501\ud83d\udcc2Plugins\n\u2503  \u2523\u2501\u2699\ufe0famdaemon_api.dll\n\u2503  \u2517\u2501\u2699\ufe0fCake.dll (JPN/SDEZ only)\n\u2517\u2501\ud83d\udcc2Managed\n   \u2523\u2501\u2699\ufe0fAMDaemon.NET.dll\n   \u2517\u2501\u2699\ufe0fAssembly-CSharp.dll\n\ud83d\udcddmai2.ini\n
  • Copy all of the above to your data's App\\package folder
  • Agree to overwrite when asked

Assembly-CSharp Notes

Assembly-CSharp.dll must match your game version. All other files can be reused between 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":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find mai2.zip and extract it to your data's App\\package folder

You should now have these files added to your App\\package directory:

\ud83d\udcc2DEVICE\n\u25b6\ufe0finject.exe\n\u2699\ufe0fmai2hook.dll\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/maimaidx/prismplus/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\package\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

AquaMai

Find more information about AquaMai on their GitHub page. Also check our Unity modding guide.

"},{"location":"games/sega/maimaidx/prismplus/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/maimaidx/prismplus/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/maimaidx/prismplus/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/maimaidx/prismplus/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\package\\launch.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.

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/maimaidx/prismplus/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/maimaidx/prismplus/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/maimaidx/prismplus/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
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\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

"},{"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/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/ongeki/brightmemory/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/ongeki/brightmemory/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 6th option)

  • Make sure all machines 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/ongeki/brightmemory/c2c/#how-to-link","title":"How to link?","text":"

If you're new to O.N.G.E.K.I. 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/ongeki/brightmemory/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/ongeki/brightmemory/controllers/","title":"Controllers","text":""},{"location":"games/sega/ongeki/brightmemory/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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/#yuangeki","title":"YUANGEKI","text":"

This controller does not support IO4 mode. Instead, refer to the Keyboard and Mouse section.

"},{"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","text":""},{"location":"games/sega/ongeki/brightmemory/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/ongeki/brightmemory/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2license\n\ud83d\udcc2package\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpxGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\u25b6\ufe0fRotateDisplay.exe\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/ongeki/brightmemory/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

For O.N.G.E.K.I., official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A002\n\u2523\u2501\ud83d\udcc2A012\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A001 then A012

"},{"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 of the following folders and files:
\u25b6\ufe0famdaemon.exe\n\u25b6\ufe0fmu3.exe\n\ud83d\udcc2mu3_Data\n\u2523\u2501\ud83d\udcc2Plugins\n\u2503  \u2523\u2501\u2699\ufe0famdaemon_api.dll\n\u2503  \u2523\u2501\u2699\ufe0fchiffre.dll\n\u2503  \u2523\u2501\u2699\ufe0flibhttp.dll\n\u2503  \u2517\u2501\u2699\ufe0fQR_Image.dll\n\u2517\u2501\ud83d\udcc2Managed\n   \u2523\u2501\u2699\ufe0fAMDaemon.NET.dll\n   \u2523\u2501\u2699\ufe0fAssembly-CSharp-firstpass.dll\n   \u2517\u2501\u2699\ufe0fAssembly-CSharp.dll\n\ud83d\udcddmu3.ini\n
  • Copy all of the above to your data's App\\package folder
  • Agree to overwrite when asked

Assembly-CSharp Notes

Assembly-CSharp.dll must match your game version. All other files can be reused between game versions.

"},{"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

When using the folder structure proposed in this guide, setting OptionDev=0 in mu3.ini is required for the game to properly load Option data.

"},{"location":"games/sega/ongeki/brightmemory/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find mu3.zip and extract it to your data's App\\package folder

You should now have these files added to your App\\package directory:

\ud83d\udcc2DEVICE\n\u25b6\ufe0finject.exe\n\u2699\ufe0fmu3hook.dll\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/ongeki/brightmemory/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\package\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

mu3-mods

Find more info about O.N.G.E.K.I. mods here mu3-mods. Also check our Unity modding guide.

"},{"location":"games/sega/ongeki/brightmemory/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/ongeki/brightmemory/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/ongeki/brightmemory/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/ongeki/brightmemory/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/ongeki/brightmemory/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\package\\launch.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.

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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/ongeki/brightmemory/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/ongeki/brightmemory/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
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\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/c2c/","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/ongeki/common/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 6th option)

  • Make sure all machines 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/ongeki/common/c2c/#how-to-link","title":"How to link?","text":"

If you're new to O.N.G.E.K.I. 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/ongeki/common/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/ongeki/common/controllers/","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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/#yuangeki","title":"YUANGEKI","text":"

This controller does not support IO4 mode. Instead, refer to the Keyboard and Mouse section.

"},{"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":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

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

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2license\n\ud83d\udcc2package\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpxGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\u25b6\ufe0fRotateDisplay.exe\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/ongeki/common/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

For O.N.G.E.K.I., official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A002\n\u2523\u2501\ud83d\udcc2A012\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A001 then A012

"},{"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 of the following folders and files:
\u25b6\ufe0famdaemon.exe\n\u25b6\ufe0fmu3.exe\n\ud83d\udcc2mu3_Data\n\u2523\u2501\ud83d\udcc2Plugins\n\u2503  \u2523\u2501\u2699\ufe0famdaemon_api.dll\n\u2503  \u2523\u2501\u2699\ufe0fchiffre.dll\n\u2503  \u2523\u2501\u2699\ufe0flibhttp.dll\n\u2503  \u2517\u2501\u2699\ufe0fQR_Image.dll\n\u2517\u2501\ud83d\udcc2Managed\n   \u2523\u2501\u2699\ufe0fAMDaemon.NET.dll\n   \u2523\u2501\u2699\ufe0fAssembly-CSharp-firstpass.dll\n   \u2517\u2501\u2699\ufe0fAssembly-CSharp.dll\n\ud83d\udcddmu3.ini\n
  • Copy all of the above to your data's App\\package folder
  • Agree to overwrite when asked

Assembly-CSharp Notes

Assembly-CSharp.dll must match your game version. All other files can be reused between game versions.

"},{"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

When using the folder structure proposed in this guide, setting OptionDev=0 in mu3.ini is required for the game to properly load Option data.

"},{"location":"games/sega/ongeki/common/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find mu3.zip and extract it to your data's App\\package folder

You should now have these files added to your App\\package directory:

\ud83d\udcc2DEVICE\n\u25b6\ufe0finject.exe\n\u2699\ufe0fmu3hook.dll\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/ongeki/common/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\package\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

mu3-mods

Find more info about O.N.G.E.K.I. mods here mu3-mods. Also check our Unity modding guide.

"},{"location":"games/sega/ongeki/common/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/ongeki/common/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/ongeki/common/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/ongeki/common/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/ongeki/common/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\package\\launch.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.

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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/ongeki/common/troubleshooting/","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
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\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/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/ongeki/refresh/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/ongeki/refresh/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 6th option)

  • Make sure all machines 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/ongeki/refresh/c2c/#how-to-link","title":"How to link?","text":"

If you're new to O.N.G.E.K.I. 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/ongeki/refresh/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/ongeki/refresh/controllers/","title":"Controllers","text":""},{"location":"games/sega/ongeki/refresh/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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/#yuangeki","title":"YUANGEKI","text":"

This controller does not support IO4 mode. Instead, refer to the Keyboard and Mouse section.

"},{"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","text":""},{"location":"games/sega/ongeki/refresh/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/ongeki/refresh/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2license\n\ud83d\udcc2package\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpxGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\u25b6\ufe0fRotateDisplay.exe\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/ongeki/refresh/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

For O.N.G.E.K.I., official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A002\n\u2523\u2501\ud83d\udcc2A012\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A001 then A012

"},{"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 of the following folders and files:
\u25b6\ufe0famdaemon.exe\n\u25b6\ufe0fmu3.exe\n\ud83d\udcc2mu3_Data\n\u2523\u2501\ud83d\udcc2Plugins\n\u2503  \u2523\u2501\u2699\ufe0famdaemon_api.dll\n\u2503  \u2523\u2501\u2699\ufe0fchiffre.dll\n\u2503  \u2523\u2501\u2699\ufe0flibhttp.dll\n\u2503  \u2517\u2501\u2699\ufe0fQR_Image.dll\n\u2517\u2501\ud83d\udcc2Managed\n   \u2523\u2501\u2699\ufe0fAMDaemon.NET.dll\n   \u2523\u2501\u2699\ufe0fAssembly-CSharp-firstpass.dll\n   \u2517\u2501\u2699\ufe0fAssembly-CSharp.dll\n\ud83d\udcddmu3.ini\n
  • Copy all of the above to your data's App\\package folder
  • Agree to overwrite when asked

Assembly-CSharp Notes

Assembly-CSharp.dll must match your game version. All other files can be reused between game versions.

"},{"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

When using the folder structure proposed in this guide, setting OptionDev=0 in mu3.ini is required for the game to properly load Option data.

"},{"location":"games/sega/ongeki/refresh/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find mu3.zip and extract it to your data's App\\package folder

You should now have these files added to your App\\package directory:

\ud83d\udcc2DEVICE\n\u25b6\ufe0finject.exe\n\u2699\ufe0fmu3hook.dll\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/ongeki/refresh/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\package\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

mu3-mods

Find more info about O.N.G.E.K.I. mods here mu3-mods. Also check our Unity modding guide.

"},{"location":"games/sega/ongeki/refresh/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/ongeki/refresh/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/ongeki/refresh/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/ongeki/refresh/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/ongeki/refresh/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\package\\launch.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.

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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/ongeki/refresh/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/ongeki/refresh/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
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\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/reverse/controllers/","title":"Controllers","text":""},{"location":"games/sega/wacca/reverse/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

com0com issues

If you're getting errors such as Could not find file 'COM5', and particularly if you're on Windows 11, com0com v3 may be causing issues. Install com0com v2 instead.

"},{"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","text":""},{"location":"games/sega/wacca/reverse/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

Wireless Device

The Chinese SDJE Version requires a custom piece of hardware that will likely not work with known tools.

If you're having issues with a \"Wireless Device\" during boot or network testing, you likely need a different version of the game data.

"},{"location":"games/sega/wacca/reverse/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2pxbin\n\ud83d\udcc2WindowsNoEditor\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpxGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/wacca/reverse/setup/#updating-data","title":"Updating data","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/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 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/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

Avoid patching anything you don't need or understand unless explicitly told to

"},{"location":"games/sega/wacca/reverse/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find mercury.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u25b6\ufe0finject.exe\n\u2699\ufe0fmercuryhook.dll\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/wacca/reverse/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

"},{"location":"games/sega/wacca/reverse/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/wacca/reverse/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/wacca/reverse/setup/#installing-ftdi-leds-driver","title":"Installing FTDI LEDs driver","text":"
  • Download the FTDI drivers
  • Extract them
  • Copy CDM-v2.12.36.4-WHQL-Certified/amd64/ftd2xx64.dll to /App/WindowsNoEditor/Mercury/Binaries/Win64/
  • Rename the file to ftd2xx.dll
"},{"location":"games/sega/wacca/reverse/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/wacca/reverse/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"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\\launch.bat.

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 launch.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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/taito/tetoteconnect/setup/","title":"Game Setup","text":""},{"location":"games/taito/tetoteconnect/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/taito/tetoteconnect/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 5 GB or larger.

Here's what the expected data structure should look like: 

\ud83d\udcc2[SYSTEM]\n\ud83d\udcc2MonoBleedingEdge\n\ud83d\udcc2System Volume Information\n\ud83d\udcc2Vision_Data\n\u25b6\ufe0fgame.exe\n\ud83d\udcc4game.inf\n\u25b6\ufe0fRunVisionProd.bat\n\u25b6\ufe0fSetting.bat\n\u25b6\ufe0fUnityCrashHandler64.exe\n\u2699\ufe0fUnityPlayer.dll\n\u25b6\ufe0fVision.exe\n\u2699\ufe0fWinPixEventRuntime.dll\n
"},{"location":"games/taito/tetoteconnect/setup/#installing-bepinex","title":"Installing BepInEx","text":"
  • Download the most recent BepInEx 5 release (BepInEx_win_x64_5.x.y.z.zip)

We need BepInEx 5 since as of writing, BepInEx 6 does not support the required plugin

  • Extract the archive to the root folder of your game data

You should now have these files added to your directory:

\ud83d\udcc2BepInEx\n\ud83d\udcc4.doorstop_version\n\ud83d\udcc4changelog.txt\n\ud83d\udcdddoorstop_config.ini\n\u2699\ufe0fwinhttp.dll\n
"},{"location":"games/taito/tetoteconnect/setup/#installing-tetoco","title":"Installing tetoco","text":"
  • Head over to tetoco releases
  • Download tetoco.dll
  • Create a folder called plugins in the BepInEx folder
  • Move the dll file to that newly created folder

You should end up with a file structure as follows:

\ud83d\udcc2BepInEx\n\u2517 \ud83d\udcc2plugins\n  \u2517\u2699\ufe0ftetoco.dll\n
"},{"location":"games/taito/tetoteconnect/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/taito/tetoteconnect/setup/#monitor-orientation","title":"Monitor orientation","text":"

With tetoco installed, the game won't automatically rotate to portrait mode when starting it

The game can be played in landscape mode but a lot of the play area will be lost, it's best to set your monitor to portrait mode before launching the game.

Manually rotating
  • Right click on your Desktop
  • Select Display settings
  • Look for Display orientation and set it to Portrait or Portrait (flipped)
  • Rotate your monitor 90\u00b0
Automatically rotating

Right click on this link then Save Link As and place the windows-display-orientation-script.ps1 file in your game's directory.

Create a new start.bat file, and set its content to this, it will set your monitor as Portrait (flipped), and automatically rotate it back once you close the game.

powershell.exe -ExecutionPolicy Bypass -File \"windows-display-orientation-script.ps1\" 0 90\nVision.exe\npowershell.exe -ExecutionPolicy Bypass -File \"windows-display-orientation-script.ps1\" 0 0\n

Alternatively, you can set it to Portrait (not flipped) by changing 90 to 270.

powershell.exe -ExecutionPolicy Bypass -File \"windows-display-orientation-script.ps1\" 0 270\nVision.exe\npowershell.exe -ExecutionPolicy Bypass -File \"windows-display-orientation-script.ps1\" 0 0\n
"},{"location":"games/taito/tetoteconnect/setup/#first-launch","title":"First launch","text":"

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

Start the game by running Vision.exe, or start.bat if you followed the automatic monitor rotation part.

You're all done! The game should load up properly now.

You can use the Login as Local button to use your local save profile.

The T key can be pressed to access the service menu.

"},{"location":"games/taito/tetoteconnect/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

By default, tetoco uses its own local network and saves data locally

Please follow this step only if you have a network to connect to.

Remote (Online Network)
  • Open the automatically created configuration file BepInEx\\config\\tetoco.cfg
  • Set UseLocalServer to false
  • Then, set RemoteServer to the address provided by your network
  • Finally, set the CardId provided by your network
"},{"location":"snippets/common/audio_48khz/","title":"Audio 48khz","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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":"snippets/common/before_playing/","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"snippets/common/data_readonly/","title":"Data readonly","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties
"},{"location":"snippets/common/data_warning/","title":"Data warning","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"snippets/common/help/","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"snippets/common/old_guide/","title":"Old guide","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

"},{"location":"snippets/common/reminder_beforeplaying/","title":"Reminder beforeplaying","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor orientation is correct for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"snippets/common/setup_vcredist_directx/","title":"Setup vcredist directx","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"snippets/konami/common/btools_cards/","title":"Btools cards","text":"
!!! info \"This tab lets you configure which cards are used to save your game profile to\"\n\n!!! warning \"If you haven't generated a card number before, you can grab one from [here](https://kawashi.ro/card)\"\n\n!!! tip \"\"\n\n    Now we will set up our PIN pad and card.\n\n    - Click on `Keyboard device` for whichever player's card reader you want to use\n    - 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\n    - Once you have found your correct device, the `Keypad status` will change **(the number and location of the number does not matter, it only matters that it changed)**\n    - Create a `.txt` file in a location that is easily accessible, and name it however you like\n    - Inside the file, paste in your card number. Example: `E0045812F8AFB2DE`\n    - Point to the file you created by clicking `Browse...` and selecting it\n\n!!! info \"If you don't have a numpad, tick `Use top keyboard row for PIN pad input`. This will also change the `Card In` button to `Backspace`\"\n
"},{"location":"snippets/konami/common/btools_lights/","title":"Btools lights","text":"
!!! info \"This tab allows you to configure controller lights to sync with the game\"\n    Not all controllers support this, but it does not affect gameplay and is completely optional.\n\n!!! tip \"\"\n\n    - In `Device`, pick your controller\n    - In `Game Light`, select the corresponding button that will be used for that light\n    - Repeat for your other lights\n
"},{"location":"snippets/konami/common/cpu_avx2/","title":"Cpu avx2","text":"

AVX2 capable CPU required

This game requires your CPU to be compatible with AVX2 instructions.

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":"snippets/konami/common/data_bad/","title":"Data bad","text":"

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"snippets/konami/common/data_update/","title":"Data update","text":"
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"snippets/konami/common/display_portraitfirst/","title":"Display portraitfirst","text":"

This game requires your main monitor to be set to Portait or Portait (flipped) mode

You will play in Portait mode (Recommended)
  • Right click on your Desktop
  • Select Display settings
  • Look for Display orientation and set it to Portrait or Portrait (flipped)
  • Rotate your monitor 90\u00b0
You cannot play in Portait mode

In this case, your only option is to:

  • Open spicecfg, go to the Options tab
  • Set the game to Windowed Mode (-w)
  • Set your desired Window Resolution (-windowsize) for the game
"},{"location":"snippets/konami/common/setup_audio/","title":"Setup audio","text":"

Check out our general Audio guide to understand audio modes better, at least the TL;DR

  • 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

Then, depending follow instructions for your desired audio mode:

Setup for WASAPI Exclusive (default)
  • Check both boxes under Exclusive Mode
  • Open the Default Format dropdown
  • Pick the 16 bit, 44100 Hz (CD Quality) option, click Apply then OK
Setup for WASAPI Shared
  • Open the Default Format dropdown
  • Pick the 16 bit, 48000 Hz (DVD Quality) option, click Apply then OK
  • Return to spicecfg, go to the Patches tab
  • Following the patching guide and patch Shared Mode WASAPI

Optionally: go to the Options tab, and at the very bottom enable Low Latency Shared Audio to help mitigate the latency penalty from using Shared audio.

Setup for ASIO (requires specialized hardware)
  • Check both boxes under Exclusive Mode
  • Open the Default Format dropdown
  • Pick the 16 bit, 44100 Hz (CD Quality) option, click Apply then OK
"},{"location":"snippets/konami/common/setup_audio_wasapiexcl_only/","title":"Setup audio wasapiexcl only","text":"

Check out our general Audio guide to understand audio modes better, at least the TL;DR

This game only supports WASAPI Exclusive mode. Some audio devices may not support this

  • 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, click Apply then OK
"},{"location":"snippets/konami/common/setup_network/","title":"Setup network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"snippets/konami/common/spice2x32_install/","title":"Spice2x32 install","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
"},{"location":"snippets/konami/common/spice2x32_stubs/","title":"Spice2x32 stubs","text":"Additional steps for AMD and Intel graphics cards

Since KONAMI games are designed for NVIDIA GPU's, AMD and Intel users need additional files:

  • Locate the spice2x\\stubs\\32\\ folder in the spice2x archive
  • Extract all .dll files from there into your game's modules folder
"},{"location":"snippets/konami/common/spice2x64_install/","title":"Spice2x64 install","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice64.exe and spicecfg.exe from the archive into your game's directory
"},{"location":"snippets/konami/common/spice2x64_stubs/","title":"Spice2x64 stubs","text":"Additional steps for AMD and Intel graphics cards

Since KONAMI games are designed for NVIDIA GPU's, AMD and Intel users need additional files:

  • Locate the spice2x\\stubs\\64\\ folder in the spice2x archive
  • Extract all .dll files from there into your game's modules folder
"},{"location":"snippets/konami/common/spicecfg_buttons/","title":"Spicecfg buttons","text":"
!!! info \"This tab is used to bind your keyboard and controller buttons\"\n\n!!! info \"Bind vs Naive\"\n\n    **Bind** - Use for controllers and hardware devices. **More responsive** and detects any HID device.  \n    **Naive** - Use for device agnostic keyboard binds. **Less responsive** but works with simulated keystrokes.\n
"},{"location":"snippets/konami/common/spicecfg_buttons_additionalinfo/","title":"Spicecfg buttons additionalinfo","text":"
!!! info \"Additional info\"\n\n    - Use page navigation at the bottom to bind multiple buttons to the same input\n    - Check **Bind Many** to bind multiple controls in sequence\n    - Click **Edit** after binding for advanced options (invert, MIDI sensitivity, etc.)\n
"},{"location":"snippets/konami/common/spicecfg_cards/","title":"Spicecfg cards","text":"
!!! info \"This tab lets you configure which cards are used to save your game profile to\"\n\n??? tip \"If you own a physical e-amuse/FeliCa card and a compatible NFC card reader\"\n\n    Setup instructions vary depending on your specific reader model.\n\n    Navigate to the `Advanced` tab and scroll down to the `NFC Card Readers` section.  \n    Browse the available options and hover over each one to view descriptions and configuration guidance.\n\n    **There is no need for you to specify cards for either player in this tab when using a card reader.**\n\n??? tip \"If you don't, you can use a virtual card number instead\"\n\n    If you already have generated a card number before, you may use this one.\n\n    To generate a new card number for Player 1 or 2:\n\n    - Click on `Open...`\n    - Choose where to save your card number\n    - Give it a file name (e.g. `card0.txt`)\n    - Click save\n    - Finally, click on `Generate`\n\n    This will automatically generate a valid card number for you and keep it in the file you specified.\n
"},{"location":"snippets/konami/common/spicecfg_lights/","title":"Spicecfg lights","text":"
!!! info \"This tab allows you to configure controller lights to sync with the game\"\n\n    Not all controllers support this, but it does not affect gameplay and is completely optional.\n\n!!! tip \"\"\n\n    - Click `Bind`\n    - In `Device`, pick your controller\n    - In `Light Control`, select the corresponding light\n    - Click `Close`\n    - Repeat for your other lights\n
"},{"location":"snippets/konami/common/spicecfg_nochange/","title":"Spicecfg nochange","text":"
!!! warning \"No need to change anything here\"\n
"},{"location":"snippets/konami/common/spicecfg_options_nvprofile/","title":"Spicecfg options nvprofile","text":"
!!! tip \"NVIDIA GPU users ONLY\"\n\n    Enable `NVIDIA profile optimization (-nvprofile)` to let spice2x create an optimized profile for your game.\n
"},{"location":"snippets/konami/common/spicecfg_overlay/","title":"Spicecfg overlay","text":"
!!! info \"This tab is used to bind keys to toggle spice2x and game-related overlays\"\n\n!!! tip \"Binding extra buttons here is optional, defaults are fine\"\n\n    Click on `Bind` or `Naive` then press the key you want associated with the action.\n
"},{"location":"snippets/konami/common/spicecfg_patches/","title":"Spicecfg patches","text":"
!!! info \"Go through the [spice2x Patching](/extras/patchsp2x.md) to import and pick patches\"\n
"},{"location":"snippets/konami/common/spicecfg_preamble/","title":"Spicecfg preamble","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

"},{"location":"snippets/konami/iidx/btools_analogs/","title":"Btools analogs","text":"
!!! info \"This tab is used to bind analog controls like the turntable\"\n\n!!! warning \"Ignore this tab if you play with a keyboard\"\n\n!!! tip \"Bind your controller's turntable\"\n\n    With a controller rather than binding buttons to `TT+` and `TT-`, you need to:\n\n    - Head to the `Analogs` tab at the top\n    - In `Device`, pick your controller\n    - In `Control`, pick whichever one corresponds to the turntable\n    - Turn your turntable ensuring that the preview turns along with it\n    - Click `OK`, leaving the rest of the settings alone\n
"},{"location":"snippets/konami/iidx/btools_buttons/","title":"Btools buttons","text":"
!!! info \"This tab is used to bind your keyboard and controller buttons\"\n\n!!! tip \"\"\n\n    Double click on the right on a button that you wish to bind, then press the key you want associated with the action.\n\n    With your controller and/or keyboard plugged in, configure your keys for:\n\n    - **Maintenance**: `Service, Test`\n    - **P1 Game buttons**: `1 to 7, Start, EFFECT, VEFX` \n    - **P1 Keypad**: `Keypad Insert Card`\n\n    **Only if** you're playing using a keyboard:\n\n    - **Turntable**: `TT+, TT-` **and optionally** `TT+/-` which alternates between `TT+` and `TT-` on each press.\n
"},{"location":"snippets/konami/iidx/btools_clvsd/","title":"Btools clvsd","text":"

For background movies to work, you need to install and register a codec.

This also applies for IIDX 12 to 18, if you'd done it before you shouldn't need to again and may skip this step.

  • Inside bemanitools-supplement-vx.x.zip locate and open iidx.zip

  • Inside iidx\\misc\\, extract CLVSD.ax to any directory where the file can stay long term As an example we will be using your Documents folder, but it really could be anywhere you prefer.

  • Open a command prompt as administrator, and run regsvr32 \"CHOSEN_PATH\\CLVSD.ax\" For the Documents folder, the command would be regsvr32 \"C:\\Users\\YOUR_USERNAME\\Documents\\CLVSD.ax\"

You should get confirmation that the file has been registered successfully.

If an error occurs, you most likely didn't start your command prompt as administrator, or the location to CLVSD.ax was incorrect.

"},{"location":"snippets/konami/iidx/btools_connecting_network/","title":"Btools connecting network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open iidxhook-xx.conf (xx being your game version) with a text editor

  • In the line eamuse.server=localhost:80, replace localhost:80 with your provided network url

  • In the lines eamuse.pcbid=XXXXXXXXXXXXXXXXXXXX and eamuse.eamid=XXXXXXXXXXXXXXXXXXXX, replace the part after = with your provided PCBID

  • Example: 

    # 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=http://be.ma.ni/\n\n# PCBID\neamuse.pcbid=ABMYPRECIOUSPCBIDCDE\n\n# EAMID\neamuse.eamid=ABMYPRECIOUSPCBIDCDE\n

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open iidxhook-xx.conf (xx being your game version) with a text editor

  • In the line eamuse.server=localhost:80, replace localhost:80 to point to your asphyxia server, typically localhost:8083

  • Example: 

    # 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:8083\n

"},{"location":"snippets/konami/iidx/btools_d3d8to9/","title":"Btools d3d8to9","text":"

  • Download the latest Bemanitools supplements release here

  • Inside bemanitools-supplement-vx.x.zip locate misc.zip

  • Inside misc\\d3d8to9\\, extract d3d8.dll to your revision directory

This lets you configure graphics options inside iidxhook-xx.conf (xx being your game version number)

"},{"location":"snippets/konami/iidx/btools_graphics/","title":"Btools graphics","text":"

  • Open your iidxhook-xx.conf (xx being your game version)

  • Locate and change the options we're interested in:

gfx.framed=false                    # Only matters if windowed. False for borderless, True for decorations (title bar, etc..)\ngfx.frame_rate_limit=0.0            # Set this to 59.95\ngfx.windowed=false                  # False for fullscreen, True for windowed\ngfx.window_width=0                  # Set to your desired game width (recommended: monitor width)\ngfx.window_height=0                 # Set to your desired game height (recommended: monitor height)\ngfx.scale_back_buffer_width=0       # Set to your desired game width (recommended: monitor width)\ngfx.scale_back_buffer_height=0      # Set to your desired game height (recommended: monitor height)\ngfx.scale_back_buffer_filter=none   # Set to point or linear (pick one from examples below)\n

Here are visual examples of the two filter options:

point (sharp, pixel perfect)

linear (less sharp, not pixel perfect)

"},{"location":"snippets/konami/iidx/ldj_vs_tdj/","title":"Ldj vs tdj","text":"

Before proceeding with the setup, it's important to understand the two cabinet types for IIDX:

  • Lightning (TDJ/LDJ-010):

    • Runs at 120 FPS
    • Requires a 120 Hz main monitor
    • Optional second touchscreen 60 Hz monitor called a subscreen

  • Standard/Legacy (LDJ/LDJ-012):

    • Runs at 60 FPS
    • Requires a 60 Hz main monitor
    • No subscreen

The game data comes in two variants based on the bm2dx.dll file. You can patch an LDJ dll to run in TDJ mode, but this will disable video recording.

For simplicity, we'll use \"TDJ\" for Lightning Mode and \"LDJ\" for Standard Mode throughout our guides.

"},{"location":"snippets/konami/iidx/spicecfg_advanced_camhook/","title":"Spicecfg advanced camhook","text":"
!!! tip \"Optional: Camera hook\"\n\n    With a webcam connected, you can:\n\n    - Enable `IIDX Cam Hook (-iidxtdjcamhook)`\n    - Make sure `IIDX Disable Cameras (-iidxdisablecams)` from the `Options` tab is disabled\n    - Optionally enable `IIDX Camera Order Flip (-iidxflipcams)` if you have two cameras connected and the wrong one is being used\n\n    This allows spice2x to try and interface with your webcam to enable camera functionality in the game.\n\n    You can then bind a button to the `Camera Control` overlay in the Overlay tab to adjust camera settings.\n
"},{"location":"snippets/konami/iidx/spicecfg_analogs/","title":"Spicecfg analogs","text":"
!!! info \"This tab is used to bind analog controls like the turntable\"\n\n!!! warning \"Ignore this tab if you play with a keyboard\"\n\n!!! tip \"Bind your controller's turntable\"\n\n    With a controller, instead of binding `TT+` or `TT-` in the `Buttons` tab, you need to:\n\n    - Click `Bind`\n    - In `Device`, pick your controller\n    - In `Control`, pick the control that updates the preview when turning the turntable, typically `X`\n    - Click `Close`, leaving the rest of the settings alone\n
"},{"location":"snippets/konami/iidx/spicecfg_buttons/","title":"Spicecfg buttons","text":"
!!! tip \"Binding your buttons\"\n\n    Click on `Bind` or `Naive` then press the key you want associated with the action.\n\n    With your controller and/or keyboard plugged in, configure your keys for P1 and/or P2:\n\n    - **Maintenance**: `Service, Test`\n    - **Game buttons**: `SW1 to SW7, Start, EFFECT, VEFX` \n    - **Keypad**: `Keypad Insert Card`, `1 to 9`\n\n    **Only if** you play with a keyboard:\n\n    - **Turntable**: `TT+, TT-` **and optionally** `TT+/-` which alternates between `TT+` and `TT-` on each press.\n
"},{"location":"snippets/konami/iidx/spicecfg_options_disablecams/","title":"Spicecfg options disablecams","text":"
!!! tip \"Important\"\n\n    Enable `IIDX Disable Cameras (-iidxdisablecams)` **unless** you have a webcam connected and wish to use it with the camera hook from the advanced tab.\n
"},{"location":"snippets/konami/iidx/spicecfg_options_tdj/","title":"Spicecfg options tdj","text":"
!!! tip \"Optional: Enabling TDJ (Lightning mode)\"\n\n    You may want to enable `IITX TDJ Mode (-iidxtdj)` if your main monitor is 120 Hz capable.\n
"},{"location":"snippets/konami/sdvx/spicecfg_analogs/","title":"Spicecfg analogs","text":"
!!! info \"This tab is used to bind analog controls like knobs\"\n\n!!! warning \"Ignore this tab if you play with a keyboard\"\n\n!!! tip \"Bind your controller's knobs\"\n\n    With a controller, instead of binding to `VOL-L` and `VOL-R` in the `Buttons` tab, you need to:\n\n    - Click `Bind`\n    - In `Device`, pick your controller\n    - In `Control`, pick the control that updates the preview when turning the corresponding knob\n    - Click `Close`, leaving the rest of the settings alone\n    - Repeat for your other knob\n
"},{"location":"snippets/konami/sdvx/spicecfg_buttons/","title":"Spicecfg buttons","text":"
!!! tip \"Binding your buttons\"\n\n    Click on `Bind` or `Naive` then press the key you want associated with the action.\n\n    With your controller and/or keyboard plugged in, configure your keys for:\n\n    - **Maintenance:** `Service, Test`\n    - **Game buttons:** `BT-A, BT-B, BT-C, BT-D, FX-L, FX-R, Start`\n    - **P1 Keypad**: `Keypad 0 to 9, Keypad Insert Card`\n\n    **Only if** you play with a keyboard:\n\n    - **Knobs:** `VOL-L Left, VOL-L Right, VOL-R Left, Vol-R Right`\n
"},{"location":"snippets/sega/chunithm/data_options/","title":"Data options","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"snippets/sega/chunithm/segatools_gfx/","title":"Segatools gfx","text":"
!!! tip \"Display settings\"\n\n    - Use `windowed=0` for fullscreen mode or `windowed=1` for windowed mode\n    - For multi-monitor setups in fullscreen mode, specify your target display using the `monitor` index setting\n\n??? info \"Finding your monitor index\"\n\n    Open Windows display settings to find your monitor numbers.  \n    Your monitor's index is one less than the displayed number.    \n    For example, if Windows shows \"Display 2\", use monitor index 1.\n
"},{"location":"snippets/sega/common/data_bad/","title":"Data bad","text":"

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"snippets/sega/common/data_driveletter/","title":"Data driveletter","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

"},{"location":"snippets/sega/common/data_icfs/","title":"Data 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":"snippets/sega/common/data_modding/","title":"Data modding","text":"Modding

Mods are covered on the Unity modding page.

"},{"location":"snippets/sega/common/data_old/","title":"Data old","text":"

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"snippets/sega/common/data_preparation/","title":"Data preparation","text":"
Here's what the expected original data structure should look like:\n\n```\n\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n```\n\nCreate another empty folder named `AppData` next to them:\n\n```\n\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n```\n\nThe `App` folder should have a file structure as follows:\n
"},{"location":"snippets/sega/common/data_updating/","title":"Data updating","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":"snippets/sega/common/network_local/","title":"Network local","text":"Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"snippets/sega/common/network_local_artemisonly/","title":"Network local artemisonly","text":"Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"snippets/sega/common/network_preamble/","title":"Network preamble","text":"

Pick one or the other, not both!

"},{"location":"snippets/sega/common/network_remote/","title":"Network remote","text":"Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
"},{"location":"snippets/sega/common/patching/","title":"Patching","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

"},{"location":"snippets/sega/common/segatools_install/","title":"Segatools install","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
"},{"location":"snippets/sega/common/segatools_preamble_bin/","title":"Segatools preamble bin","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
"},{"location":"snippets/sega/common/segatools_preamble_package/","title":"Segatools preamble package","text":"

You'll need to manually edit App\\package\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
"},{"location":"snippets/sega/common/segatools_relativepaths/","title":"Segatools relativepaths","text":"
??? info \"Relative Paths\"\n\n    Relative paths make your configuration portable and easier to maintain.\n\n    Say your game folder structure looks like this:\n\n    ```\n    \ud83d\udcc2Game Folder\n    \u2523\u2501\ud83d\udcc2App\n    \u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n    \u2517\u2501\ud83d\udcc2Option\n    ```\n\n    If `segatools.ini` needs to access the `Option` folder, you can use `../../Option/`:\n\n    - `../` moves up from `bin` to `App`\n    - `../` moves up again from `App` to the root `Game Folder`\n    - Then it can access the `Option` folder\n
"},{"location":"snippets/sega/common/segatools_vfs/","title":"Segatools vfs","text":"
!!! tip \"\"\n\n    If you've followed our recommended file structure, use these values:\n\n    ```ini\n    [vfs]\n    amfs=../../amfs\n    option=../../Option\n    appdata=../../AppData\n    ```\n\n    If not, point those to their respective folders.\n
"},{"location":"snippets/sega/common/service_jp_googlelens/","title":"Service jp googlelens","text":"

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":"snippets/sega/common/success/","title":"Success","text":"

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

"}]} \ 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 in 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":"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 - Alternative patcher for anything we don't support
"},{"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
  • mon's - The longest lasting web patcher, supports a variety of n-1 and older games
"},{"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
  • CPI - (JP) Clear Power Indicator for SP\u260612, also proposes recommendations based on your plays
  • sp12 - IIDX SP\u260612 reference site/difficulty tier list
  • beatmania.app - IIDX INFINITAS difficulty tier list
  • atwiki - IIDX wiki in JP (includes tier lists)
  • textage.cc - Chart viewing resource
  • QPro Viewer by DJ HITOMI - QPRO customization viewer
  • 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 Tier Lists - SDVX difficulty tier lists
  • sdvx.in - Worse looking alternative to SDVX Index (but also has other games available at the top)
  • SDVX Unlock Guide - Translated guide for unlocks
  • SDVX Konasute on Steam Deck - Guide to getting Konasute working on a Steam Deck
"},{"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 - Chart viewer for O.N.G.E.K.I
  • O.N.G.E.K.I. Humen and MLN Rev - Screen captures of all O.N.G.E.K.I. charts
  • Lilyshy's English O.N.G.E.K.I. Guide - Handy O.N.G.E.K.I. resource for players of all skill levels
"},{"location":"resources/#polaris-chord","title":"Polaris Chord","text":"
  • Polaris Touch - Much like Brokenithm, but adapted for Polaris Chord
  • Polaris Touch Godot - Like Polaris Touch, but as a native Android app
"},{"location":"errorcodes/konami/","title":"KONAMI Error Codes","text":"

Synopsis

This section contains various Konami games error codes you might run across and potential steps to resolve them.

"},{"location":"errorcodes/konami/#universal","title":"Universal","text":""},{"location":"errorcodes/konami/#5-0000-0000","title":"5-0000-0000","text":"

This error can be caused by:

  • Having multiple network adapters enabled - try disabling unused ones in Device Manager
  • Game files being set as read-only - ensure all files are writable
"},{"location":"errorcodes/konami/#5-2000-0000-5-2002-0915-5-2600-0000","title":"5-2000-0000 / 5-2002-0915 / 5-2600-0000","text":"

These errors are network related.

Check that:

  • Your internet connection is working
  • Your data version is supported by the server
  • The server is online and running
  • Your EA Service URL (-url) option is correctly set
  • Your PCBID (-p) option is correctly set
"},{"location":"errorcodes/konami/#iidx","title":"IIDX","text":""},{"location":"errorcodes/konami/#5-1500-0002","title":"5-1500-0002","text":"

SOUND DATA CREATE ERROR

Data is corrupt, incomplete, or incorrectly modified. Redownload data from trusted source.

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

USBIO ERROR (NO ANSWER...)

The game times out when trying to communicate with I/O.

  • For home play: I/O emulation could be too slow due to background services (file sync, antivirus, Windows Updates) or bad hardware. Try running tools at higher process priority.
  • For cabinets: Hardware issue with I/O board. Check cables and power supply.
"},{"location":"errorcodes/konami/#5-1505-0001","title":"5-1505-0001","text":"

SSD DATA ERROR

Data is corrupt, incomplete, or incorrectly modified. Redownload data from trusted source.

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

CAMERA DEVICE ERROR

Missing/non-functional camera devices. Either connect necessary cameras, use the -iidxdisablecams Option or patch the game to bypass this check. Can be temporarily bypassed with Test button.

"},{"location":"errorcodes/konami/#5-1503-0043","title":"5-1503-0043","text":"

MONITOR ERROR

The game isn\u00b4t finding a valid monitor. Most likely culprit is your refresh rate being wrong.

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

CLOCK ERROR

Enter Test menu, go to CLOCK, then SAVE AND EXIT.

"},{"location":"errorcodes/konami/#sound-voltex","title":"Sound Voltex","text":""},{"location":"errorcodes/konami/#5-1506-0000","title":"5-1506-0000","text":"

ACIO ERROR

Caused by corrupt libacio.dll. Redownload from a trusted source. If the error persists, redownload entire game data.

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

Caused by modified DLL files in Sound Voltex Booth. Keep files unmodified and reinstall from a trusted source if needed.

"},{"location":"errorcodes/konami/#popn-music","title":"pop'n music","text":""},{"location":"errorcodes/konami/#5-1509-0000","title":"5-1509-0000","text":"

Occurs during gameplay. Verify service URL and PCBID are set correctly.

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

Setup error in pop'n Usaneko. Follow Game Setup and use proper -url and -p parameters in SpiceTools.

"},{"location":"errorcodes/konami/#jubeat","title":"jubeat","text":""},{"location":"errorcodes/konami/#5-2500-0000","title":"5-2500-0000","text":"

BACKUP DATA ERROR

Press your Test button to get past this.

"},{"location":"errorcodes/konami/#gitadora","title":"GITADORA","text":""},{"location":"errorcodes/konami/#5-1506-0000-5-2501-0000","title":"5-1506-0000 / 5-2501-0000","text":"

These errors are typically caused by having multiple network adapters enabled, disable unused ones in Device Manager.

"},{"location":"errorcodes/konami/#5-1698-0000","title":"5-1698-0000","text":"

APPLICATION ERROR

This error usually indicates a problem with your game DLLs. If the error persists, redownload entire game data.

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

BACKUP DATA ERROR

Press your Test button to get past this.

"},{"location":"errorcodes/konami/#nostalgia","title":"NOSTALGIA","text":""},{"location":"errorcodes/konami/#5-1501-0000","title":"5-1501-0000","text":"

This error results from a bad AVS config. Redownload data from trusted source.

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

Synopsis

This section contains various SEGA games error codes you might run across and potential steps to resolve them.

"},{"location":"errorcodes/sega/#universal","title":"Universal","text":""},{"location":"errorcodes/sega/#0000","title":"0000","text":"

Unexpected Error Occured

Data is corrupt, incomplete, or incorrectly modified. Redownload data from trusted 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

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    },\n    \"network\": {\n        \"property\": {\n            \"dhcp\": true\n        }\n    }\n}\n

If your game files does not include config_hook.json, it is OK to create a new file. Then edit the launch script (usually launch.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

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    },\n    \"allnet_accounting\": {\n        \"enable\": false\n    }\n}\n

If your game files does not include config_hook.json, it is OK to create a new file. Then edit the launch script (usually launch.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","title":"CHUNITHM","text":""},{"location":"errorcodes/sega/#3101-3102","title":"3101, 3102","text":"

An unexpected error has occurred with the main deviceInitialization 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 ChuniIO 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

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 your monitor is not set to 1920x1080@120 Hz at 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

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

"},{"location":"errorcodes/sega/#amdaemon","title":"AMDaemon","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\n}\n

The value 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/asphyxia/","title":"Asphyxia","text":""},{"location":"extras/asphyxia/#asphyxia","title":"Asphyxia","text":"

Existing save data

If you have previously used Asphyxia, be sure to backup your savedata folder located next to the plugins directory. This folder contains important data including your game profiles and scores that you may want to keep.

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

Asphyxia is a tool that handles online services for BEMANI games by simulating an e-amusement network, enabling features like score saving, profile management, game events and other online functionality.

It consists of two main components:

  • Asphyxia CORE: The foundational framework that provides the base functionality but no game support by itself
  • Asphyxia PLUGINS: Community-developed modules that implement game-specific features and support
"},{"location":"extras/asphyxia/#downloading-asphyxia","title":"Downloading Asphyxia","text":"
  • Head to Asphyxia CORE's releases page
  • Download the latest asphyxia-core-win-x64.zip archive
  • Prepare a permanent place for your Asphyxia files, preferably an empty folder away from your game data
  • Extract the archive inside of it

You should end up with a structure as follows:

\ud83d\udcc2 asphyxia\n\u2523\u2501 \ud83d\udcc2 plugins\n\u2503  \u2523\u2501 \ud83d\udcc2 _example@identifier\n\u2503  \u2503  \u2517\u2501 ...\n\u2503  \u2523\u2501 \ud83d\udcc4 asphyxia-core.d.ts\n\u2503  \u2523\u2501 \ud83d\udcc4 package.json\n\u2503  \u2517\u2501 \ud83d\udcc4 tsconfig.json\n\u2517\u2501 \u25b6\ufe0f asphyxia-core-x64.exe\n

You can delete the _example@identifier folder, it serves as an example plugin layout for developers

"},{"location":"extras/asphyxia/#installing-plugins","title":"Installing Plugins","text":"

Asphyxia requires a specific plugin for each game you want to use it with

To get started with Asphyxia for your specific game(s), you'll need to install the appropriate plugin(s).

While we maintain a collection of plugins in our Discord server, we may not have support for every game and version. In such cases, you will need to search for community-developed plugins online yourself.

To install plugins from our Discord:

  • Join our Discord server using the logo in the bottom right of the page
  • Navigate to your game's channel
  • Check the pinned Resources message for potential plugin links
  • Download and extract the plugin
  • Place the extracted folders (like sdvx@asphyxia) into your plugins directory

If plugin files are scattered across multiple files/folders, create a single directory for them and move everything inside, following the game@asphyxia naming scheme.

\ud83d\udcc2 asphyxia\n\u2523\u2501 \ud83d\udcc2 plugins\n\u2503  \u2523\u2501 \ud83d\udcc2 sdvx@asphyxia\n\u2503  \u2523\u2501 \ud83d\udcc2 iidx@asphyxia\n\u2503  \u2523\u2501 \ud83d\udcc2 etc.\n\u2503  \u2523\u2501 \ud83d\udcc4 asphyxia-core.d.ts\n\u2503  \u2523\u2501 \ud83d\udcc4 package.json\n\u2503  \u2517\u2501 \ud83d\udcc4 tsconfig.json\n\u2517\u2501 \u25b6\ufe0f asphyxia-core-x64.exe\n
"},{"location":"extras/asphyxia/#starting-and-configuring-asphyxia","title":"Starting and Configuring Asphyxia","text":"

Launch asphyxia-core-x64.exe to start the server. A browser window will automatically open with the Asphyxia WebUI interface.

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

To configure the service URL for your BEMANI game:

  • Open spicecfg.exe
  • Navigate to the Options tab
  • Locate the EA Service URL field
  • Enter the URL shown in Asphyxia WebUI's Dashboard (typically localhost:8083)
"},{"location":"extras/asphyxia/#game-specific-configuration","title":"Game-specific configuration","text":"

Each tab corresponds to steps you need to follow for various games

SDVXIIDX

Settings and WebUI Assets

  • In the WebUI, select SDVX in the left sidebar
  • Under Plugin Settings, find Exceed Gear Data Directory
  • Enter the full path to your game's data folder (the folder containing data, modules, prop, etc.)
  • (Optional) Toggle all four Unlock switches to unlock all game content by default
  • Click Apply to save your changes
  • Close Asphyxia by selecting Process > Shutdown CORE in the top-right corner of the WebUI

Next, update the WebUI assets:

  • Launch asphyxia-core-x64.exe again
  • Click Update Webui Assets in the left sidebar
  • Click Update and confirm the datacode update in ea3-config.xml
  • Wait for the console to show \"Done\" at the top

About expected errors

While importing WebUI assets you may see errors like: - [ifs] MD5 mismatch - /data/graphics/ver06/psd_level.ifs

If you're using the correct plugin and game data, these can usually be ignored.

Final setup

  • Launch SDVX and create a new profile
  • Close the game
  • In the WebUI, navigate to SDVX \u2192 Profiles making sure your new profile appears
  • Customize additional settings through the WebUI interface and make sure everything works as intended

IIDX setup is straightforward:

  • Launch the game with Asphyxia running
  • Create a new profile in-game
  • The profile will automatically appear in the WebUI
  • You can customize additional settings through the WebUI interface and make sure everything works as intended
"},{"location":"extras/asphyxia/#final-words","title":"Final words","text":"

Setup Complete!

Remember to always make sure Asphyxia is running before starting your game!

If you were following a guide, you can now return to it and proceed with the next steps.

"},{"location":"extras/asphyxia/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"extras/audio/","title":"Audio","text":"

Synopsis

This guide explains the different audio modes commonly found in arcade games and their pros and cons, helping you choose the best option for your setup.

Important notice

Recordings and streams must only be shared privately:

  • Through unlisted videos
  • In private streams with friends
  • Within trusted data communities

Sharing content publicly puts you at serious risk of getting banned from arcade venues and communities. Please respect these guidelines.

"},{"location":"extras/audio/#audio-modes","title":"Audio modes","text":""},{"location":"extras/audio/#tldr","title":"TL;DR","text":"Mode DirectSound WASAPI Shared WASAPI Exclusive ASIO Latency Highest Medium Low Lowest when setup correctly Compatibility Highest High High Low Multiple audio streams with extra steps Audio capture with extra steps Recommended for Legacy games Most users Low latency needs Lower latency needs"},{"location":"extras/audio/#directsound","title":"DirectSound","text":"

The legacy Windows audio system, still used by older games.

\u2714\ufe0f Pros:

  • Extremely high compatibility, especially with older games
  • Multiple audio sources can play simultaneously
  • Easy audio capture with OBS, Discord etc.
  • Simple to set up and use

\u274c Cons:

  • Highest latency of all modes
  • Being phased out in favor of WASAPI
  • Limited audio quality compared to modern modes

\ud83d\udca1 Pro tip: Use spice2x's -lowlatencysharedaudio setting to reduce latency.

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

The modern Windows standard audio mode. Recommended for most users.

\u2714\ufe0f Pros:

  • Works with most modern games and applications
  • Multiple audio sources can play simultaneously
  • Easy audio capture with OBS, Discord etc.
  • Good balance of latency and compatibility

\u274c Cons:

  • Higher latency than Exclusive mode
  • Some games may require patches/configuration for Shared mode

\ud83d\udca1 Pro tip: Use spice2x's -lowlatencysharedaudio setting to reduce latency.

"},{"location":"extras/audio/#wasapi-exclusive","title":"WASAPI Exclusive","text":"Hardware compatibility notice

Your audio device must explicitly support exclusive mode. Check your audio settings:

Gives one application complete control over the audio device.

\u2714\ufe0f Pros:

  • Significantly lower latency than Shared mode
  • More consistent audio processing than Shared mode
  • Better for rhythm games if you don't mind the cons

\u274c Cons:

  • Only one application can output audio at a time
  • No audio capture without special hardware/software
  • Can cause system-wide audio interruptions
"},{"location":"extras/audio/#asio","title":"ASIO","text":"

Hardware requirements

For optimal results, use a dedicated ASIO-compatible audio interface. Software solutions like ASIO4ALL or FlexASIO exist but have limitations:

  • Added processing overhead
  • May not improve latency over WASAPI Exclusive
  • Mostly useful when:
    • Games are incompatible with your audio device
    • ASIO is the only supported mode
    • You need specific ASIO features

Professional audio standard designed for audio interfaces and music production.

\u2714\ufe0f Pros:

  • Lowest possible latency when properly configured
  • Direct hardware control
  • Precise buffer size adjustment
  • Professional-grade audio quality
  • Bypass Windows audio stack
  • Capture is possible when routed through Voicemeeter at the cost of very little added latency

\u274c Cons:

  • Requires specialized hardware for best results
  • Complex setup process
  • Usually limited to one application at a time
  • No direct audio capture support
  • System performance heavily impacts stability
  • May require significant tweaking
"},{"location":"extras/audio/#asio-recordingstreaming","title":"ASIO Recording/Streaming","text":"

This guide assumes your game already uses ASIO and you want to record/stream with audio

"},{"location":"extras/audio/#required-software","title":"Required software","text":"

ASIO bypasses the Windows audio system that recording/streaming applications use, so you'll need additional software to route the audio:

  • Voicemeeter Banana - For audio routing
  • OBS Studio - For recording and streaming

Install both applications before continuing.

"},{"location":"extras/audio/#game-configuration","title":"Game configuration","text":"

Set your game's ASIO output device to Voicemeeter Virtual ASIO:

  • For spice2x games: Look for settings like -iidxasio or -sdvxasio at the top of spicecfg's Options tab
  • For other games: The location depends on your setup, but look for ASIO device selection
"},{"location":"extras/audio/#voicemeeter-configuration","title":"Voicemeeter configuration","text":"

First, configure recommended settings:

  1. Click Menu in the top right
  2. Enable settings shown below to ensure Voicemeeter:
    • Starts with Windows
    • Auto-recovers from audio issues

Next, set up ASIO output:

  1. Click the A1 button in the top right
  2. Select the ASIO (Steinberg) tab
  3. Choose your ASIO device

Finally, configure audio routing:

  1. Locate the 4th column in the interface
  2. Enable only the A1 and B1 toggles as shown:

"},{"location":"extras/audio/#obs-studio-configuration","title":"OBS Studio Configuration","text":"

  1. Run OBS Studio's initial configuration wizard if you haven't already

  2. Set up audio capture:

    • In the Sources panel, click + and select Audio Input Capture
    • For the Device, select VoiceMeeter Output (B1)

  3. Enable audio monitoring:

    • Click the gear icon in the Audio Mixer panel
    • Find your Audio Input Capture source
    • Change Audio Monitoring to Monitor and Output

  4. Configure OBS audio settings:

    • Go to File > Settings
    • In the Audio tab:
      • Set Sample Rate to match your ASIO/game settings
      • For Monitoring Device, select any unused input such as a VoiceMeeter In
    • Save changes with Apply and OK

  5. Add video capture:

    • In Sources, add either Display Capture or Game Capture
    • Adjust OBS video and output settings as needed
"},{"location":"extras/audio/#using-this-setup","title":"Using this setup","text":"

First, ensure Voicemeeter and OBS Studio are running.

Next, configure your desired OBS output and video settings.

  • For streaming and recording, now use OBS as normal.

  • For Discord sharing:

    • Right-click the OBS preview window
    • Select Fullscreen Projector (Preview)
    • Choose which monitor to show the projector on
    • Press Alt+Tab to switch away from the projector window
    • In Discord, share the projector window
"},{"location":"extras/audio/#further-reading","title":"Further reading","text":"
  • spice2x wiki
"},{"location":"extras/controllers/","title":"Controllers","text":"

Synopsis

This guide provides an overview of popular arcade-style rhythm game controllers currently available to buy. Controllers are ranked based on their popularity within the rhythm game community.

"},{"location":"extras/controllers/#konami","title":"KONAMI","text":""},{"location":"extras/controllers/#beatmania-iidx","title":"beatmania IIDX","text":"

Lightning cabinets typically use Sanwa buttons, 50g springs, 50g microswitches

PHOENIXWAN+ LMT

Product page Vendor: gamo2 Price range: $299 ~ $447.50 + Shipping/Taxes Recommended setup: $425 (Sanwa 50g, Omron 50g, default LEDs)

This controller is widely considered the gold standard for IIDX controllers. With high-quality construction materials, a few spring and switch options, and an arcade-like textured turntable. The PHOENIXWAN's proven reliability makes it the top choice for both new and experienced players.

DX6TH

Product page Vendor: YuanCon Price range: $209 ~ $334 + Shipping/Taxes Recommended setup: $334 (Sanwa 50g, defaults)

The DX6TH is a good alternative to the PHOENIXWAN, offering decent build quality at a lower price point. However, its glossy acrylic turntable attracts dust and fingerprints easily, and doesn't match the premium feel of the PHOENIXWAN's LMT surface.

"},{"location":"extras/controllers/#sound-voltex","title":"Sound Voltex","text":"

Valkyrie cabinets typically use Sanwa buttons, 20g springs, 100g microswitches

FAUCETWO+

Products: VW Skin - EG Skin Vendor: gamo2 Price range: $169 ~ $466.20 + Shipping/Taxes Recommended setup: $296 (Sanwa 20g, Omron 100g)

The FAUCETWO+ probably is the most popular Sound Voltex controller on the market. It features improved knob durability compared to the original FAUCETWO, eliminating the need to regularly replace damping sheets. For microswitches, we recommend choosing Omron over LHS1F switches, as Omrons are generally more durable, cost-effective, and easier to source.

SDVX12

Products: Black - White - Black&Blue - White&Purple - Pink&Gold - Pink - Gold Vendor: YuanCon Price range: $188 ~ $333 + Shipping/Taxes Recommended setup: $333 (Sanwa 20g, LHS1F 100g)

The SDVX12 is YuanCon's alternative to the FAUCETWO+. While well-built, its main limitation is restricted customization. You can only choose between Chinese buttons with 50g springs, or Sanwa buttons with 20g springs and LHS1F 100g microswitches. The LHS1F switches are generally less durable than the Omron switches available for the FAUCETWO+.

SDVX LITE 3

Product page Vendor: YuanCon Price range: $138 ~ $283 + Shipping/Taxes Recommended setup: $283 (Sanwa 20g, LHS1F 100g)

The SDVX LITE 3 is a more compact and affordable version of the SDVX12. By trimming its sides, it remains arcade-accurate without wasting space. Like its larger counterpart, it has limited customization options (see SDVX12 description above). Despite this, its lower price point makes it an excellent entry-level choice for players of all skill levels.

"},{"location":"extras/controllers/#popn-music","title":"pop'n music","text":"POPOLLER

Product page Vendor: gamo2 Price range: $229 ~ $279 + Shipping/Taxes Recommended setup: $279 (SAMDUCKSA buttons)

It should be noted a few users have reported SAMDUCKSA buttons spinning in place, your mileage may vary.

YuanCon's Pop'n Controller

Product page Vendor: YuanCon Price: $149 + Shipping/Taxes

"},{"location":"extras/controllers/#dance-dance-revolution","title":"Dance Dance Revolution","text":"L-TEK / iamats

Catalog Vendor: L-TEK

L-TEK produces high-quality DDR dance pads at various price points. Due to their extensive product lineup, we recommend browsing their catalog directly to find the pad that best suits your needs and budget.

YuanCon Pad Single/Double

Products: Single - Double Vendor: YuanCon Price range: $1199 ~ $2519 + High shipping/taxes

YuanCon proposes single and double DDR pads. While seemingly very well built, they also are extremely expensive.

"},{"location":"extras/controllers/#nostalgia","title":"NOSTALGIA","text":"NOSTROLLER

Product page Vendor: gamo2 Price: $349 + Shipping/Taxes

The NOSTROLLER is the only dedicated controller option for NOSTALGIA. While information about this controller is limited due to its niche market, it's worth noting that any MIDI keyboard with enough keys can also be configured to work with the game.

"},{"location":"extras/controllers/#sega","title":"SEGA","text":""},{"location":"extras/controllers/#chunithm","title":"CHUNITHM","text":"TASOLLER+

Product page Vendor: gamo2 Price: $349 + Shipping/Taxes

The TASOLLER+ is widely regarded as the definitive CHUNITHM controller. Its premium aluminum construction, exceptional build quality, sleek aesthetics and customizable sensitivity and lighting make it the top choice for players looking for an authentic arcade experience at home.

Laverita 3

Products: Without stand - With stand Vendor: YuanCon Price: $328 + Shipping/Taxes Note: Shipping is much higher for the \"with stand\" version

The Laverita 3 is YuanCon's alternative to the TASOLLER+. While it's a fully functional controller that gets the job done, its build quality doesn't quite match the premium feel of the TASOLLER+. Users should also note that the controller's performance can be affected by high humidity environments.

"},{"location":"extras/controllers/#maimai","title":"maimai","text":"NDX

Product page Vendor: YuanCon Price: $899 + High shipping/Taxes

"},{"location":"extras/controllers/#ongeki","title":"O.N.G.E.K.I.","text":"ONTROLLER

Product page Vendor: gamo2 Price range: $399 ~ $731 + Shipping/Taxes

The ONTROLLER is currently the only arcade-accurate O.N.G.E.K.I. controller available on the market. While its high price point may be a barrier for some, the controller's excellent build quality and five available configurations make it an attractive option for players seeking an authentic arcade experience.

YUANGEKI

Product page Vendor: YuanCon Price: $222 + Shipping/Taxes

The YUANGEKI is YuanCon's compact O.N.G.E.K.I. controller. While the side buttons are positioned closer together compared to the arcade layout, the controller offers solid performance at a more affordable price point.

"},{"location":"extras/controllers/#namco","title":"NAMCO","text":""},{"location":"extras/controllers/#taiko-no-tatsujin","title":"Taiko no Tatsujin","text":"

Many of these controllers offer different configurations. Make sure to pick the correct one for the plaform(s) you plan to play on

"},{"location":"extras/controllers/#arcade-accurate","title":"Arcade-accurate","text":"ZhongTaiko

Product page Vendor: ZhongTaiko Price range: $399 ~ $599 + Shipping/Taxes

ZhongTaiko offers the highest quality full-size Taiko controllers on the market. Their Pro version perfectly replicates the feel of arcade Nijiiro cabinets, while their more affordable Standard version still outperforms a lot of contenders in build quality and responsiveness.

TDC17

Product page Vendor: rythmagica Price range: $261.95 ~ $307.95 + Shipping/Taxes

The TDC17 is a solid arcade-style Taiko controller offering good build quality and responsiveness at a competitive price point. While it does not quite matching ZhongTaiko's quality, it provides a solid and authentic arcade experience for players seeking a high-end option at a great price point.

TAIKOLLER

Product page Vendor: gamo2 Price: $329 + Shipping/Taxes

The TAIKOLLER is gamo2's arcade-style Taiko controller. It is very similar to YuanCon's TAIKO FORCE LV6, while being cheaper for customers outside of China.

TAIKO FORCE LV6

Product page Vendor: YuanCon Price range: $466 ~ $554 + Shipping/Taxes

The TAIKO FORCE LV6 is YuanCon's arcade-style Taiko controller. It is very similar to gamo2's TAIKOLLER. While the official store price is higher, it can be purchased at a significant discount through TaoBao (Chinese marketplace), though international buyers will need to use a proxy service.

"},{"location":"extras/controllers/#tatacons-much-smaller-than-arcade-but-plenty-capable","title":"Tatacons (much smaller than arcade but plenty capable)","text":"TDC10 Pro

Product page Vendor: rythmagica Price: $139.95 + Shipping/Taxes

The TDC10 Pro is a smaller, more affordable version of the TDC17. It stands out as the highest quality Tatacon controller currently available, delivering excellent build quality and responsiveness at a competitive price point. For players seeking a compact but premium Taiko controller, this is THE choice.

HORI Official Tatacons

Catalog Vendor: HORI Price range: $68 ~ 157 + Shipping/Taxes

HORI Tatacons are officially licensed controllers available for multiple platforms. While they are widely accessible, most models suffer from hit registration issues that require modifications to fix. Given these reliability concerns, we strongly recommend the TDC10 Pro as a better alternative.

IINE Tatacon

Product page Vendor: IINE Price: $55.95 + Shipping/Taxes

IINE's Tatacon is a budget alternative to HORI's official controllers. While more affordable, it shares similar hit registration problems that require modifications to resolve. For a reliable, high-quality experience, we recommend investing in the TDC10 Pro instead.

"},{"location":"extras/controllers/#in-betweens-not-quite-ac-size-not-quite-tatacon","title":"In-betweens (not quite AC-size, not quite Tatacon)","text":"IINE Taiko Pro Max

Product page Vendor: IINE Price: $180.95 + Shipping/Taxes

IINE's Taiko Pro Max comes in at an odd spot between arcade-accurate controllers and Tatacons. It feels really cheap but might do the trick if the size and price point sound good to you.

"},{"location":"extras/datamods/","title":"Modding (Konami)","text":"

Synopsis

This guide will cover how to mod your KONAMI 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
"},{"location":"extras/datamods/#installing-mod-files","title":"Installing mod files","text":"
  • Create a data_mods folder next to the others in your game files if it doesn't exist
  • Place your mod files inside data_mods in a way that respects the following structure data_mods/mod_folder/<data folders/<data_files>

You can think of the mod folder coming to overwrite your game's data folder at runtime. If you're confused, the following may help you understand what we mean.

\ud83d\udcc2data\n\u2523\u2501\ud83d\udcc2graphic\n\u2523\u2501\ud83d\udcc2info\n\u2523\u2501\ud83d\udcc2movie\n\u2517\u2501\ud83d\udcc2sound\n\ud83d\udcc2data_mods \n\u2517\u2501\ud83d\udcc2mod_folder\n   \u2523\u2501\ud83d\udcc2graphic - Files that modify data/graphic go here\n   \u2523\u2501\ud83d\udcc2info    - Files that modify data/info go here\n   \u2523\u2501\ud83d\udcc2movie   - Files that modify data/movie go here\n   \u2517\u2501\ud83d\udcc2sound   - Files that modify data/sound go here\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

Example: Omnimix for beatmania IIDX 31 EPOLIS

Directory: contents/data_mods/

Directory: contents/data_mods/omnimix_31

"},{"location":"extras/datamods/#loading-mods-data-files-ifs_layeredfs","title":"Loading mods data files (ifs_layeredfs)","text":"

Overwriting game files with mods is heavily discouraged, as there is no clean way of undoing that. This is where ifs_layeredfs comes in, to load modded data files without permanently modifying your game data.

  • Download the most recent release of ifs_layeredfs

  • Open the archive

  • 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

Follow the Injecting DLL Hooks section to load this DLL.

"},{"location":"extras/datamods/#installing-omnifix-for-iidx-omnimix-only","title":"Installing Omnifix (for IIDX Omnimix only)","text":"

Compatibility

Supported game versions For unsupported game versions, you'll have to patch Omnimix with spice2x or web patching.

Omnimix files require modification of your game DLL which can't be handled by ifs_layeredfs. This is where Omnifix comes in, as a commonly agreed upon way of loading Omnimix for beatmania IIDX.

  • Download the latest release archive for omnifix much like you did with ifs_layeredfs
  • Extract the omnifix.dll file contained in the archive to your game's modules folder

Follow the Injecting DLL Hooks section to load this DLL.

Note that Omnifix also offers optional launch parameters you may want to consider.

"},{"location":"extras/datamods/#injecting-dll-hooks","title":"Injecting DLL Hooks","text":"

Adding DLL files to your modules folder won't necessarily make them load automatically. You sometimes need to tell spice2x to load each file individually, like with the DLLs mentioned in this guide.

  • Open your game's spicecfg.exe
  • Head to the options tab
  • Find the Inject DLL Hooks option under Common
  • Add the name of the DLL file(s) you want to load inside the text box

Example: ifs_hook.dll omnifix.dll

You may list one or multiple DLL files separated by a space. The order does matter, as it dictates in which order the DLL files are loaded. We recommend loading ifs_hook.dll before all else.

"},{"location":"extras/hexguide/","title":"Game Patching (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/linux_konami/","title":"Linux (Konami)","text":"

Synopsis

Konami arcade games and associated community tooling are built to run on Windows. This guide will document the best currently known ways to get games working on Linux systems.

Compatibility

ONLY the following game and versions are confirmed to work with the process described in this guide.

Game Version(s) Caveats (if any) Sound Voltex Exceed Gear Subscreen clicks don't work DanceDanceRevolution World Mahjong Fight Girl

This guide was primarily written targetting arch-based systems running KDE and pipewire. Instructions should still be distro and DE agnostic, but your mileage may vary.

"},{"location":"extras/linux_konami/#pre-requisites","title":"Pre-requisites","text":"
  • A Linux system with:
    • pipewire as an audio backend
    • wine with wow64 included (default on arch since June 2025)
    • winetricks curl unzip installed
    • gstreamer gst-plugins-good gst-plugins-ugly gst-libav for codecs (package names may vary)
  • Compatible game data placed inside a \ud83d\udcc2contents directory
  • Your game's regular setup guide opened in another tab
Extra requirements for NixOS

spice2x requires an optional wine feature which NixOS does not enable by default. Apart from that, a patch for winetricks is needed due to weirdness with winetricks on NixOS with WoW64 wine.

To fix this, copy this to your confiuration: 

environment.systemPackages = [\n  (\n    pkgs.wine-with-pcsclite.override {\n      wineBuild = \"wineWow64\";\n    }\n  )\n];\n\nnixpkgs.overlays = [\n  (\n    final: prev: {\n      wine-with-pcsclite = prev.wine.overrideAttrs (old: {\n        buildInputs = old.buildInputs ++ [final.pcsclite];\n        configureFlags = old.configureFlags ++ [\"--with-pcsclite\"];\n      });\n      winetricks = prev.winetricks.overrideAttrs (old: {\n        patches = [\n          (final.fetchpatch {\n            # make WINE_BIN and WINESERVER_BIN overridable\n            # see https://github.com/NixOS/nixpkgs/issues/338367\n            url = \"https://github.com/Winetricks/winetricks/commit/1d441b422d9a9cc8b0a53fa203557957ca1adc44.patch\";\n            hash = \"sha256-AYXV2qLHlxuyHC5VqUjDu4qi1TcAl2pMSAi8TEp8db4=\";\n          })\n        ];\n        postInstall =\n          old.postInstall\n          + ''\n            sed -i \\\n              -e '2i : \"''${WINESERVER_BIN:=/run/current-system/sw/bin/wineserver}\"' \\\n              -e '2i : \"''${WINE_BIN:=/run/current-system/sw/bin/.wine}\"' \\\n              \"$out/bin/winetricks\"\n          '';\n      });\n    }\n  )\n];\n

"},{"location":"extras/linux_konami/#automated-setup-for-spice2x-compatible-games","title":"Automated setup (for spice2x compatible games)","text":"
  • Download the sp2x-linux-setup.sh script from NotAkitake/sp2x-linux-setup
  • Place it next to your \ud83d\udcc2contents directory contaning compatible game files
  • Make the script executable chmod +x sp2x-linux-setup.sh
  • Run the script and follow instructions
"},{"location":"extras/linux_konami/#manual-setup","title":"Manual setup","text":"

This section will mostly describe what the automated process above achieves

"},{"location":"extras/linux_konami/#installing-spice2x","title":"Installing spice2x","text":"

This process is largely the same as windows and can be found in your game's setup guide. Simply place the spice.exe or spice64.exe executable inside \ud83d\udcc2contents.

We won't need spicecfg.exe however. Instead we will later pass -cfg as a launch argument to the main spice2x executable later.

NVIDIA Stubs

For ALL graphics cards: If your game's setup guide has a Additional steps for AMD and Intel graphics cards warning in its Installing spice2x section, do what it says.

"},{"location":"extras/linux_konami/#wine-prefix","title":"Wine prefix","text":"

Double check commands

We provide ready-made command for simplicity, however don't blindy copy and execute them. ALWAYS double check command before running them, and substitute REPLACE_THIS_PATH with your own location.

"},{"location":"extras/linux_konami/#initializing","title":"Initializing","text":"

  • Create an empty \ud83d\udcc2prefix directory in the location of your choosing We advise creating a new prefix for every game and placing it next to \ud83d\udcc2contents.

  • Run the following command to initialize a new wine prefix without being prompted for mono or gecko.

WINEARCH=win64 WINEPREFIX=REPLACE_THIS_PATH/prefix WINEDLLOVERRIDES=\"mscoree=d;mshtml=d\" wineboot --init\n
"},{"location":"extras/linux_konami/#common-dependencies","title":"Common dependencies","text":"

Some dependencies are required across most games, install them to your prefix using winetricks as follows:

WINEARCH=win64 WINEPREFIX=REPLACE_THIS_PATH/prefix winetricks -q dxvk d3dcompiler_42 d3dcompiler_43 d3dcompiler_46 d3dcompiler_47\n
"},{"location":"extras/linux_konami/#game-specific-dependencies","title":"Game-specific dependencies","text":"

If there is no tab for your game, you may skip this step

Default (none)DDR

Install these to your prefix for background movies to play, otherwise the game will crash.

WINEARCH=win64 WINEPREFIX=REPLACE_THIS_PATH/prefix winetricks -q quartz devenum amstream windowscodecs\n
"},{"location":"extras/linux_konami/#optional-pipewire-audio-sink","title":"(optional) PipeWire audio sink","text":"

You can create an audio device games will accept that routes audio to your desired hardware

It may not be necessary for all games as it depends on your specific setup and game. You could try following the rest of the guide without this virtual sink first to see whether you need it or not.

  • Create the .config/pipewire/pipewire.conf.d directory in your home directory if it doesn't already exist
mkdir -p \"$HOME/.config/pipewire/pipewire.conf.d\"\n
  • Create a spice2x-sink.conf file in that directory containing:
context.modules = [\n  {\n    name = libpipewire-module-loopback\n    args = {\n      audio.position = [ FL FR ]\n      capture.props = {\n        media.class = Audio/Sink\n        audio.format = S16LE\n        audio.rate = 44100\n        audio.channels = 2\n        node.name = spice2x41\n        node.description = \"spice2x @ 44100Hz\"\n      }\n      playback.props = {\n        node.passive = true\n        node.name = spice2x41.output\n        node.description = \"SPICE2X 44100Hz OUTPUT\"\n        target.object = \"alsa_output.pci-0000_04_00.6.HiFi__hw_Generic_1__sink\"\n        audio.format = S16LE\n      }\n    }\n  }\n]\n

The audio.rate may need to be set to 48000 on a per game-basis, but for the games covered here, 44100 is fine.

The target.object set above means audio will be routed the first audio device it finds. If you have multiple audio devices available and want to make sure it outputs to a specific one, run:

pw-cli list-objects | awk '/node.name/ {name=$0} /media.class/ && /Audio\\/Sink/ {gsub(/.*= \"|\"/,\"\",name); print name}'\n

Replace the target.object device with the output line corresponding to your desired output device. For example:

target.object = \"alsa_output.usb-Focusrite_Scarlett_Solo_4th_Gen_S1APY0Z3611B4E-00.HiFi__Line1__sink\"\n
  • Finally, save and exit then restart pipewire. On systemd distros you may do it by running:
systemctl --user restart pipewire.service pipewire-pulse.socket\n
"},{"location":"extras/linux_konami/#optional-launcher-scripts","title":"(optional) Launcher scripts","text":"

This section will help you create two bash scripts you may use to start and configure your game

They are not mandatory but very handy to have, rather than remembering commands to run spice executables with the right prefix, paths, arguments, etc..

Game start

Let's create the main launch script first, which will also be used by our second script.

  • Next to your contents directory, create a launch.sh file containing:
#!/usr/bin/env bash\n# Game Launcher\n\nSCRIPT_DIR=\"$(cd \"$(dirname \"$0\")\" && pwd)\"\nexport WINEARCH=win64\nexport WINEPREFIX=\"REPLACE_THIS_PATH/prefix\"\n\n# Default arguments\nARGS=\"\"\n\n# Optional: Add arguments per line\n# ARGS=\"$ARGS -url localhost:8083\"     # Network URL\n# ARGS=\"$ARGS -p 01FXXXXXXXXXXXXXXXXX\" # PCBID\n\n# Append args to this script\nARGS=\"$ARGS $*\"\n\ncd \"$SCRIPT_DIR/contents\" || exit\nwine \"spice64.exe\" $ARGS\n

  • On the first highlighted line: make sure WINEPREFIX points to your game prefix created earlier

  • On the second highlighted line: replace spice64.exe with spice.exe if necessary

  • Make the script executable by running chmod +x launch.sh

Game config

To get a graphical interface replicating what spicecfg.exe does, we can simply call our previous script and pass -cfg as an argument.

  • Next to your previous script, create a config.sh file containing:
#!/usr/bin/env bash\n# Config Launcher\n\nSCRIPT_DIR=\"$(cd \"$(dirname \"$0\")\" && pwd)\"\n\"$SCRIPT_DIR/launch.sh\" -cfg\n

  • On the last line, make sure the file name matches the previous script

  • Make the script executable by running chmod +x config.sh

Try executing config.sh

The spice2x configuration window for your game should appear. Your game should also be detected and show in the top right!

If your game isn't detected, it's highly likely paths are wrong somewhere in your scripts.

"},{"location":"extras/linux_konami/#game-specific-last-steps","title":"Game-specific last steps","text":"

If there is no tab for your game, you may skip this step

Default (none)SDVX
  • You need to patch Shared Mode WASAPI to ensure audio comes through wine. Either use the previously created config.sh to start spicecfg, or use the command in the next section. If you don't know how patches work, follow instructions in our spice2x patching guide.

  • You need to set your monitor orientation to portait before playing

  • OR If you want to play the game windowed and keep your display in landscape orientation:

    • Create a wine_desktop.reg file containing:
    Windows Registry Editor Version 5.00\n\n[HKEY_CURRENT_USER\\Software\\Wine\\Explorer]\n\"Desktop\"=\"Default\"\n\n[HKEY_CURRENT_USER\\Software\\Wine\\Explorer\\Desktops]\n\"Default\"=\"1080x1920\"\n
    • Fix the paths in the command below and run it. Then feel free to delete the .reg file:
    WINEARCH=win64 WINEPREFIX=REPLACE_THIS_PATH/prefix wine regedit REPLACE_THIS_PATH/wine_desktop.reg\n
"},{"location":"extras/linux_konami/#whats-next","title":"What's next?","text":"

Linux-specific instructions are over

Head to your game's setup guide, straight to the \"Configuring spice2x\" section.

  • IF you opted to use the PipeWire audio sink, set it as your default audio device before starting the game
  • Skip the Configuring audio section
  • Skip any section asking you to install VCRedist and/or DirectX, our prefix takes care of that

  • Use the previously created config.sh instead of spicecfg, and launch.sh to start the game OR If you opted not to create scripts, instead use this, fixing the paths and spice executable name:

    cd REPLACE_THIS_PATH/contents && WINEARCH=win64 WINEPREFIX=REPLACE_THIS_PATH/prefix wine \"spice64.exe\" -cfg\n

    And use the same command without the -cfg argument to start the game.

"},{"location":"extras/patchsp2x/","title":"Game Patching (spice2x)","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":"Game Patching (web)","text":"

Known web patchers: Resources

For BEMANI games consider spice2x Patching

This patching method is outdated for BEMANI games.

However if your game isn't supported, follow this guide.

Before proceeding

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

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

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

For this example, we'll be using our web patcher. Almost every other patcher looks and functions exactly the same as this one.

If your game is not supported by our web patcher, 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 CHUNITHM VERSE.

Here, either:

  • Drag and drop the .dll or .exe 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 or .exe 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 file will start downloading.

Backup your original .dll or .exe file first!

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

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

"},{"location":"extras/unity/","title":"Modding (Unity)","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":"extras/zerotier/","title":"Cab-to-Cab (ZeroTier)","text":""},{"location":"extras/zerotier/#zerotier-for-cabinet-to-cabinet-play","title":"ZeroTier for Cabinet-to-Cabinet Play","text":"

Warning for CHUNITHM

CHUNITHM has stricter network requirements than other SEGA games and needs a specific subnet. In this guide, we will use the subnet 192.168.196.0 as an example. However, to run CHUNITHM, you must change it to the subnet 192.168.139.0. If you don't, cabinets set to \"FOLLOW THE STANDARD\" will fail to connect. You will also need to adjust the IPv4 Auto-Assign setting of your Zerotier network accordingly by changing 196 to 139.

"},{"location":"extras/zerotier/#installing","title":"Installing","text":"

Go to the ZeroTier download page. Download and run the Windows installer. After installation, the program will open automatically in your taskbar.

"},{"location":"extras/zerotier/#joining-a-network","title":"Joining a network","text":"

Connecting to a network

To join a network on ZeroTier, you will need its 16-digit Network ID.

  • Start ZeroTier if it's not already running
  • Right click on the ZeroTier icon in your taskbar
  • Click on \"Join New Network\"
  • Enter the Network ID
  • Click on \"Join\"

That's it!

Checking your connection

Open your Command Prompt, and run the command ipconfig Your IP address will appear under Ethernet adapter ZeroTier One [NETWORK ID] next to IPv4 Address

To check if you can successfully reach another computer on the network, run the command ping [IPv4 Address] replacing [IPv4 Address] with the IP address of the other computer, not your own.

Configuration for segatools

Edit segatools.ini with the following content:

[netnev]\nenable=1\naddrSuffix= The last segment of your ZeroTier IP address (e.g., if your IP is 192.168.196.5, set addrSuffix = 5)\n\n[keychip]\nsubnet=192.168.196.0\n\n[system]\ndipsw1=1 ;Set this to 1 on the host machine and set this to 0 on all others\n

Each person must have their own keychip

If you play on a remote network, you likely already have your own keychip. If not, you can use these example keychips: A61E-01D02321145 ; A61E-01A30831145 ; A61E-01E38091145 ; A61E-01E46241145

When starting your game, make sure to allow any Windows Firewall pop-ups (such as for amdaemon.exe, mu3.exe, chusanApp.exe...)

If you didn't see a pop-up

This could mean one of two things.

Either you have already allowed it, and cab-to-cab is working successfully. That's great! No need to change anything. Or, you denied access, and cab-to-cab isn't working. In that case follow these steps:

  • Open the Windows Control Panel
  • Click on System and Security
  • Click on Windows Defender Firewall
  • On the left side, click on Advanced settings
  • In the new window, click on Inbound Rules and look for your game's executables
  • Right click on one of them, then click on Properties
  • Select Allow the connection then press OK
  • Repeat this for all game executables

Alternatively, you can disable your firewall for both public and private networks. Please note that this should only be a temporary measure for testing, as it poses a security risk to your computer.

Configuration for spice2x

  • Open spicecfg.exe
  • Navigate to the Development tab
  • Enter your ZeroTier IP in the Preferred NetAdapter IP field
  • Enter 255.255.255.0 in the Preferred NetAdapter Subnet field
"},{"location":"extras/zerotier/#creating-a-network","title":"Creating a network","text":"
  • Go to my.zerotier.com and create an account
  • Create a network
  • Click on its name in the list to configure it

About your Network ID

Your Network ID is displayed on your account's homepage, and in the configuration menu. This allows you and others to join your network.

If your network is set to Public then anyone with it can join it. Treat it like a password.

"},{"location":"extras/zerotier/#network-configuration","title":"Network configuration","text":"

Following tabs correspond to the ones found in the configuration menu, follow both \"Basics\" and \"Advanced\"

BasicsAdvanced

Name

Either keep the default random name, or rename it to your liking.

Access Control

  • Private: This is the default option and will require you to accept people who want to join your network
  • Public: Recommended, anyone with the Network ID can join without authorization

Managed Routes

Delete the already existing entry. Under \"Add Routes\", set \"Destination\" as 192.168.196.0/24 then press \"Submit\".

IPv4 Auto-Assign

Delete the already existing entry. Under \"Add IPv4 Address Pools\" set \"Range Start\" as 192.168.196.1 and \"Range End\" as 192.168.196.254 then press \"Submit\".

You should end up with this:

"},{"location":"games/konami/beatstream/animutribe/setup/","title":"Game Setup","text":""},{"location":"games/konami/beatstream/animutribe/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/beatstream/animutribe/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/beatstream/animutribe/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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 60 Hz, the game is hardcoded to run at 60 Hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60 Hz. 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 60 Hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.

"},{"location":"games/konami/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/konami/ddr/a20/setup/","title":"Game Setup","text":""},{"location":"games/konami/ddr/a20/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

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/konami/ddr/a20/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 20 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/ddr/a20/setup/#updating-data","title":"Updating data","text":"

Please make sure you're using the right update for your current data.

DDR updates have MDX and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., MDX_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., MDX_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/ddr/a20/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

For MDX-001 (32 bits)
  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
For MDX-003 (64 bits)
  • Visit spice2x.github.io to download the latest release
  • Extract both spice64.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice64.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
"},{"location":"games/konami/ddr/a20/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

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

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

  • Maintenance: Service, Test
  • Game buttons: Up, Down, Left, Right
  • Menu buttons: Start, Up, Down, Left, Right
  • Keypad: Keypad Insert Card, 1 to 9

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

No need to change anything here

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

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/ddr/a20/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/ddr/a20/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/ddr/a20/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/ddr/a20/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/ddr/a20/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

For any issues not covered here, spice2x's Known issues page might prove useful

"},{"location":"games/konami/ddr/a20/troubleshooting/#technical-problems","title":"Technical problems","text":""},{"location":"games/konami/ddr/a20/troubleshooting/#crashes","title":"Crashes","text":"Game crashes on startup or when starting a song / No background and no music video

This is probably due to missing or incorrectly registered codecs. From version 25-08-17 of spice2x onwards, the codecs will be registered automatically when you launch the game, so please update your installation. If this does not resolve the issue, or if you do not wish to update, please follow the DDR section on the spice2x wiki.

"},{"location":"games/konami/ddr/a20/troubleshooting/#performance","title":"Performance","text":"

Check out spice2x's PC optimization guide

Game is running too slow/fast

Try to eliminate any unnecessary background processes during play and ensure your screen's framerate is set to 60 FPS.

"},{"location":"games/konami/ddr/a20/troubleshooting/#other","title":"Other","text":"Where are the option for Dancers/Shading/Measure lines/Fast-Slow/Layering?

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 our spice2x Patching guide.

"},{"location":"games/konami/ddr/a20plus/setup/","title":"Game Setup","text":""},{"location":"games/konami/ddr/a20plus/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

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/konami/ddr/a20plus/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 20 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/ddr/a20plus/setup/#updating-data","title":"Updating data","text":"

Please make sure you're using the right update for your current data.

DDR updates have MDX and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., MDX_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., MDX_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/ddr/a20plus/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

For MDX-001 (32 bits)
  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
For MDX-003 (64 bits)
  • Visit spice2x.github.io to download the latest release
  • Extract both spice64.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice64.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
"},{"location":"games/konami/ddr/a20plus/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

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

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

  • Maintenance: Service, Test
  • Game buttons: Up, Down, Left, Right
  • Menu buttons: Start, Up, Down, Left, Right
  • Keypad: Keypad Insert Card, 1 to 9

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

No need to change anything here

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

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/ddr/a20plus/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/ddr/a20plus/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/ddr/a20plus/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/ddr/a20plus/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/ddr/a20plus/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

For any issues not covered here, spice2x's Known issues page might prove useful

"},{"location":"games/konami/ddr/a20plus/troubleshooting/#technical-problems","title":"Technical problems","text":""},{"location":"games/konami/ddr/a20plus/troubleshooting/#crashes","title":"Crashes","text":"Game crashes on startup or when starting a song / No background and no music video

This is probably due to missing or incorrectly registered codecs. From version 25-08-17 of spice2x onwards, the codecs will be registered automatically when you launch the game, so please update your installation. If this does not resolve the issue, or if you do not wish to update, please follow the DDR section on the spice2x wiki.

"},{"location":"games/konami/ddr/a20plus/troubleshooting/#performance","title":"Performance","text":"

Check out spice2x's PC optimization guide

Game is running too slow/fast

Try to eliminate any unnecessary background processes during play and ensure your screen's framerate is set to 60 FPS.

"},{"location":"games/konami/ddr/a20plus/troubleshooting/#other","title":"Other","text":"Where are the option for Dancers/Shading/Measure lines/Fast-Slow/Layering?

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 our spice2x Patching guide.

"},{"location":"games/konami/ddr/a3/setup/","title":"Game Setup","text":""},{"location":"games/konami/ddr/a3/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

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/konami/ddr/a3/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 20 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/ddr/a3/setup/#updating-data","title":"Updating data","text":"

Please make sure you're using the right update for your current data.

DDR updates have MDX and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., MDX_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., MDX_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/ddr/a3/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

For MDX-001 (32 bits)
  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
For MDX-003 (64 bits)
  • Visit spice2x.github.io to download the latest release
  • Extract both spice64.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice64.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
"},{"location":"games/konami/ddr/a3/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

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

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

  • Maintenance: Service, Test
  • Game buttons: Up, Down, Left, Right
  • Menu buttons: Start, Up, Down, Left, Right
  • Keypad: Keypad Insert Card, 1 to 9

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

No need to change anything here

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

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/ddr/a3/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/ddr/a3/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/ddr/a3/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/ddr/a3/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/ddr/a3/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

For any issues not covered here, spice2x's Known issues page might prove useful

"},{"location":"games/konami/ddr/a3/troubleshooting/#technical-problems","title":"Technical problems","text":""},{"location":"games/konami/ddr/a3/troubleshooting/#crashes","title":"Crashes","text":"Game crashes on startup or when starting a song / No background and no music video

This is probably due to missing or incorrectly registered codecs. From version 25-08-17 of spice2x onwards, the codecs will be registered automatically when you launch the game, so please update your installation. If this does not resolve the issue, or if you do not wish to update, please follow the DDR section on the spice2x wiki.

"},{"location":"games/konami/ddr/a3/troubleshooting/#performance","title":"Performance","text":"

Check out spice2x's PC optimization guide

Game is running too slow/fast

Try to eliminate any unnecessary background processes during play and ensure your screen's framerate is set to 60 FPS.

"},{"location":"games/konami/ddr/a3/troubleshooting/#other","title":"Other","text":"Where are the option for Dancers/Shading/Measure lines/Fast-Slow/Layering?

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 our spice2x Patching guide.

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

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

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/konami/ddr/common/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 20 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/ddr/common/setup/#updating-data","title":"Updating data","text":"

Please make sure you're using the right update for your current data.

DDR updates have MDX and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., MDX_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., MDX_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/ddr/common/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

For MDX-001 (32 bits)
  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
For MDX-003 (64 bits)
  • Visit spice2x.github.io to download the latest release
  • Extract both spice64.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice64.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
"},{"location":"games/konami/ddr/common/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

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

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

  • Maintenance: Service, Test
  • Game buttons: Up, Down, Left, Right
  • Menu buttons: Start, Up, Down, Left, Right
  • Keypad: Keypad Insert Card, 1 to 9

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

No need to change anything here

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

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/ddr/common/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/ddr/common/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/ddr/common/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

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

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

For any issues not covered here, spice2x's Known issues page might prove useful

"},{"location":"games/konami/ddr/common/troubleshooting/#technical-problems","title":"Technical problems","text":""},{"location":"games/konami/ddr/common/troubleshooting/#crashes","title":"Crashes","text":"Game crashes on startup or when starting a song / No background and no music video

This is probably due to missing or incorrectly registered codecs. From version 25-08-17 of spice2x onwards, the codecs will be registered automatically when you launch the game, so please update your installation. If this does not resolve the issue, or if you do not wish to update, please follow the DDR section on the spice2x wiki.

"},{"location":"games/konami/ddr/common/troubleshooting/#performance","title":"Performance","text":"

Check out spice2x's PC optimization guide

Game is running too slow/fast

Try to eliminate any unnecessary background processes during play and ensure your screen's framerate is set to 60 FPS.

"},{"location":"games/konami/ddr/common/troubleshooting/#other","title":"Other","text":"Where are the option for Dancers/Shading/Measure lines/Fast-Slow/Layering?

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 our spice2x Patching guide.

"},{"location":"games/konami/ddr/world/setup/","title":"Game Setup","text":""},{"location":"games/konami/ddr/world/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

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/konami/ddr/world/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 20 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/ddr/world/setup/#updating-data","title":"Updating data","text":"

Please make sure you're using the right update for your current data.

DDR updates have MDX and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., MDX_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., MDX_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/ddr/world/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

For MDX-001 (32 bits)
  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
For MDX-003 (64 bits)
  • Visit spice2x.github.io to download the latest release
  • Extract both spice64.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2arkdata\n\ud83d\udcc2com\n\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice64.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
"},{"location":"games/konami/ddr/world/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

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

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

  • Maintenance: Service, Test
  • Game buttons: Up, Down, Left, Right
  • Menu buttons: Start, Up, Down, Left, Right
  • Keypad: Keypad Insert Card, 1 to 9

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

No need to change anything here

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

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/ddr/world/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/ddr/world/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/ddr/world/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/ddr/world/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/ddr/world/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

For any issues not covered here, spice2x's Known issues page might prove useful

"},{"location":"games/konami/ddr/world/troubleshooting/#technical-problems","title":"Technical problems","text":""},{"location":"games/konami/ddr/world/troubleshooting/#crashes","title":"Crashes","text":"Game crashes on startup or when starting a song / No background and no music video

This is probably due to missing or incorrectly registered codecs. From version 25-08-17 of spice2x onwards, the codecs will be registered automatically when you launch the game, so please update your installation. If this does not resolve the issue, or if you do not wish to update, please follow the DDR section on the spice2x wiki.

"},{"location":"games/konami/ddr/world/troubleshooting/#performance","title":"Performance","text":"

Check out spice2x's PC optimization guide

Game is running too slow/fast

Try to eliminate any unnecessary background processes during play and ensure your screen's framerate is set to 60 FPS.

"},{"location":"games/konami/ddr/world/troubleshooting/#other","title":"Other","text":"Where are the option for Dancers/Shading/Measure lines/Fast-Slow/Layering?

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 our spice2x Patching guide.

"},{"location":"games/konami/gitadora/exchain/setup/","title":"Game Setup","text":""},{"location":"games/konami/gitadora/exchain/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/gitadora/exchain/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/gitadora/exchain/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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 60 Hz, the game is hardcoded to run at 60 Hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60 Hz. 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 60 Hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/gitadora/fuzzup/setup/","title":"Game Setup","text":""},{"location":"games/konami/gitadora/fuzzup/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/gitadora/fuzzup/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a Network section

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/gitadora/fuzzup/setup/#pre-launch-requirements","title":"Pre-launch Requirements","text":"

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

"},{"location":"games/konami/gitadora/fuzzup/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/konami/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/konami/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/konami/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/konami/gitadora/fuzzup/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other issue?

Check out the Troubleshooting and Error Codes pages.

"},{"location":"games/konami/gitadora/fuzzup/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/gitadora/fuzzup/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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 60 Hz. This is a requirement for the game to run at the correct speed. The game is hardcoded to run at 60 Hz 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/konami/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/konami/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/konami/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/konami/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/konami/gitadora/matixx/setup/","title":"Game Setup","text":""},{"location":"games/konami/gitadora/matixx/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/gitadora/matixx/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/gitadora/matixx/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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 60 Hz, the game is hardcoded to run at 60 Hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60 Hz. 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 60 Hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/10thstyle/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/10thstyle/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/iidx/10thstyle/setup/#configuring-bemanitools","title":"Configuring Bemanitools","text":"

To configure your keybinds, open your config.bat file

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/10thstyle/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/iidx/10thstyle/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/10thstyle/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/11_red/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/11_red/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/iidx/11_red/setup/#configuring-bemanitools","title":"Configuring Bemanitools","text":"

To configure your keybinds, open your config.bat file

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/11_red/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/11_red/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/12_happysky/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/12_happysky/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/iidx/12_happysky/setup/#configuring-bemanitools","title":"Configuring Bemanitools","text":"

To configure your keybinds, open your config.bat file

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/12_happysky/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/12_happysky/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/13_distorted/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/13_distorted/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/iidx/13_distorted/setup/#configuring-bemanitools","title":"Configuring Bemanitools","text":"

To configure your keybinds, open your config.bat file

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/13_distorted/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/13_distorted/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/14_gold/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/14_gold/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/iidx/14_gold/setup/#configuring-bemanitools","title":"Configuring Bemanitools","text":"

To configure your keybinds, open your config.bat file

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/14_gold/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/14_gold/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/16_empress/extras/","title":"Extra Information","text":""},{"location":"games/konami/iidx/16_empress/extras/#extra-information","title":"Extra Information","text":""},{"location":"games/konami/iidx/16_empress/extras/#output-modes","title":"Output modes","text":"

Output Mode

This game supports two output modes: S-VIDEO and VGA. The difference between these two is:

  • S-VIDEO runs at 59.95hz
  • VGA runs at 60.05hz

By default, the output mode is set automatically by the game.

If for some reason you want to change the output mode of your game, do the following:

Open your iidxhook-xx.conf. Find a line that says: 

gfx.frame_rate_limit=xx.xx\n

  • Depending on the output mode of your choice, replace xx.xx with either 59.95 or 60.05

Now, in the service menu of your game:

  • Go to GAME OPTIONS

  • Go to the line that says OUTPUT MODE and change it to your desired mode

  • Select SAVE AND EXIT

That's it!

"},{"location":"games/konami/iidx/16_empress/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/16_empress/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/iidx/16_empress/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 26 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like:

\ud83d\udcc2yyyymmddrr (revision directory, y = year digit, m = month digit, d = day digit, r = revision digit)\n\ud83d\udcc2data\n\ud83d\udcc4sidcode.txt\n
"},{"location":"games/konami/iidx/16_empress/setup/#installing-bemanitools","title":"Installing Bemanitools","text":"

  • Download the latest Bemanitools release here

  • Inside bemanitools-x.xx.zip locate iidx-14-to-17.zip

  • Extract all files from iidx-14-to-17.zip to your revision directory (yyyymmddrr)

You may delete the gamestart-[14,15,17].bat and iidxhook-[14,15,17].conf files as you only need the ones for 16 (Empress)

  • Download the latest Bemanitools supplements release here

  • Inside bemanitools-supplement-vx.x.zip locate misc.zip

  • Inside misc\\d3d8to9\\, extract d3d8.dll to your revision directory

This lets you configure graphics options inside iidxhook-xx.conf (xx being your game version number)

For background movies to work, you need to install and register a codec.

This also applies for IIDX 12 to 18, if you'd done it before you shouldn't need to again and may skip this step.

  • Inside bemanitools-supplement-vx.x.zip locate and open iidx.zip

  • Inside iidx\\misc\\, extract CLVSD.ax to any directory where the file can stay long term As an example we will be using your Documents folder, but it really could be anywhere you prefer.

  • Open a command prompt as administrator, and run regsvr32 \"CHOSEN_PATH\\CLVSD.ax\" For the Documents folder, the command would be regsvr32 \"C:\\Users\\YOUR_USERNAME\\Documents\\CLVSD.ax\"

You should get confirmation that the file has been registered successfully.

If an error occurs, you most likely didn't start your command prompt as administrator, or the location to CLVSD.ax was incorrect.

In the end, here's what the expected data structure should look like:

\ud83d\udcc4bm2dx.exe\n\ud83d\udcc4config.bat\n\ud83d\udcc4config.exe\n\ud83d\udcc4d3d8.dll\n\ud83d\udcc4d3dx9_24.dll\n\ud83d\udcc4dbghelp.dll\n\ud83d\udcc4eamio.dll\n\ud83d\udcc4gamestart-16.bat\n\ud83d\udcc4gcidata.nsd\n\ud83d\udcc4geninput.dll\n\ud83d\udcc4iidxhook3.dll\n\ud83d\udcc4iidxhook-16.conf\n\ud83d\udcc4iidxio.dll\n\ud83d\udcc4inject.exe\n\ud83d\udcc4libacio.dll\n\ud83d\udcc4libavs-win32.dll\n\ud83d\udcc4libavs-win32-ea3.dll\n\ud83d\udcc4vefx.txt\n\ud83d\udcc4vefxio.dll\n
"},{"location":"games/konami/iidx/16_empress/setup/#configuring-bemanitools","title":"Configuring Bemanitools","text":"

Open the config.bat file. The following tabs correspond to the ones in the configuration window.

ButtonsLightsAnalogsNetwork

This tab is used to bind your keyboard and controller buttons

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.

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • In Device, pick your controller
  • In Game Light, select the corresponding button that will be used for that light
  • Repeat for your other lights

This tab is used to bind analog controls like the turntable

Ignore this tab if you play with a keyboard

Bind your controller's turntable

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

This tab lets you configure which cards are used to save your game profile to

If you haven't generated a card number before, you can grab one from here

Now we will set up our PIN pad and card.

  • Click on Keyboard device for whichever player's card reader you want to use
  • 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 Keypad status will change (the number and location of the number does not matter, it only matters that it changed)
  • Create a .txt file in a location that is easily accessible, and name it however you like
  • Inside the file, paste in your card number. Example: E0045812F8AFB2DE
  • Point to the file you created by clicking Browse... and selecting it

If you don't have a numpad, tick Use top keyboard row for PIN pad input. This will also change the Card In button to Backspace

"},{"location":"games/konami/iidx/16_empress/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open iidxhook-xx.conf (xx being your game version) with a text editor

  • In the line eamuse.server=localhost:80, replace localhost:80 with your provided network url

  • In the lines eamuse.pcbid=XXXXXXXXXXXXXXXXXXXX and eamuse.eamid=XXXXXXXXXXXXXXXXXXXX, replace the part after = with your provided PCBID

  • Example: 

    # 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=http://be.ma.ni/\n\n# PCBID\neamuse.pcbid=ABMYPRECIOUSPCBIDCDE\n\n# EAMID\neamuse.eamid=ABMYPRECIOUSPCBIDCDE\n

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open iidxhook-xx.conf (xx being your game version) with a text editor

  • In the line eamuse.server=localhost:80, replace localhost:80 to point to your asphyxia server, typically localhost:8083

  • Example: 

    # 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:8083\n

"},{"location":"games/konami/iidx/16_empress/setup/#configuring-graphics","title":"Configuring graphics","text":"

  • Open your iidxhook-xx.conf (xx being your game version)

  • Locate and change the options we're interested in:

gfx.framed=false                    # Only matters if windowed. False for borderless, True for decorations (title bar, etc..)\ngfx.frame_rate_limit=0.0            # Set this to 59.95\ngfx.windowed=false                  # False for fullscreen, True for windowed\ngfx.window_width=0                  # Set to your desired game width (recommended: monitor width)\ngfx.window_height=0                 # Set to your desired game height (recommended: monitor height)\ngfx.scale_back_buffer_width=0       # Set to your desired game width (recommended: monitor width)\ngfx.scale_back_buffer_height=0      # Set to your desired game height (recommended: monitor height)\ngfx.scale_back_buffer_filter=none   # Set to point or linear (pick one from examples below)\n

Here are visual examples of the two filter options:

point (sharp, pixel perfect)

linear (less sharp, not pixel perfect)

"},{"location":"games/konami/iidx/16_empress/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/iidx/16_empress/setup/#first-launch","title":"First launch","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 as Administrator.

If it's your first time running the game, you'll soon be greeted with this screen.

Press your Test key to initialize the backup data, a message will pop up stating it's been initialized.

If right here you get USB I/O ERROR ERROR(FM TRNS-OUT) or USB I/O ERROR ERROR(FM-DL TIMEOUT) instead of the BACKUP DATA ERROR, reboot the game and it should get fixed.

Next, you'll get another error.

Press your Test key again and let the game run for a bit until the monitor check is complete.

You will now 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.

Go to NETWORK OPTIONS then e-AMUSEMENT SETTINGS.

You will need to set a shop name.

  • Name your shop to whatever you'd like. Again, navigation instructions are at the bottom of the screen
  • Go to EXIT then SAVE AND EXIT

Select GAME OPTIONS.

Here, you want to select a display type.

This setting affects timing offset in the song.

  • TYPE A: No frame offset - Intended for CRT displays
  • TYPE B: +1 frame offset - Intended for LCD displays

We recommend starting with TYPE B and changing this later if you encounter any issues.

  • Go to SAVE AND EXIT then GAME MODE

You're all done! The game should load up properly now. Insert credits by pressing your SERVICE key!

"},{"location":"games/konami/iidx/16_empress/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/iidx/16_empress/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/16_empress/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you get any error codes that weren't listed in the guides here, check out the Bemanitools docs

"},{"location":"games/konami/iidx/16_empress/troubleshooting/#technical-problems","title":"Technical problems","text":""},{"location":"games/konami/iidx/16_empress/troubleshooting/#crashes","title":"Crashes","text":"

Riva Tuner Statistics Server (RTSS) and MSI Afterburner are known to cause odd crashes.If you have them installed, close them both before starting any arcade game

I'm using a laptop with a hybrid internal+dedicated GPU setup

Laptops often have odd issues running data. The game may open on the wrong monitor, run at the wrong resolution or framerate, or simply crashes.

There is currently no known fix for this, other than maybe playing in windowed mode, or using a desktop PC instead.

"},{"location":"games/konami/iidx/16_empress/troubleshooting/#performance","title":"Performance","text":"Game is running too slow/fast

Your game is likely running at an incorrect framerate. The expected framerates is 59.95fps for S-VIDEO output mode, and 60.05fps for VGA output mode.

For more information regarding output modes, check out the Extra Information page

Try these steps to resolve framerate issues:

  • Double-check that your selected output mode in the service menu matches the refresh rate in your iidxhook-xx.conf file.
  • Close any software that can affect framerates (like RTSS)
  • Close unnecessary background programs
  • Ensure V-SYNC is not forcefully disabled in your graphics card control panel

If issues persist:

  • Double-check that you followed all steps in the setup guide correctly
  • Your data may be corrupt in one way or another, you could try starting from scratch using trusted data sources

For issues with desync, check out the Bemanitools IIDX syncbook

"},{"location":"games/konami/iidx/16_empress/troubleshooting/#other","title":"Other","text":"Background videos not working

The CLVSD codec is not registered. Follow the instructions in the setup guide.

"},{"location":"games/konami/iidx/24_sinobuz/extras/","title":"Extra Information","text":""},{"location":"games/konami/iidx/24_sinobuz/extras/#extra-information","title":"Extra Information","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/iidx/24_sinobuz/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

You should never change this. It should always say A for SINOBUZ.

<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\">2017082800</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/konami/iidx/24_sinobuz/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/24_sinobuz/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/iidx/24_sinobuz/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 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/konami/iidx/24_sinobuz/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/konami/iidx/24_sinobuz/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

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

"},{"location":"games/konami/iidx/24_sinobuz/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: 1 to 9, 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/konami/iidx/24_sinobuz/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/konami/iidx/24_sinobuz/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/konami/iidx/24_sinobuz/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/konami/iidx/24_sinobuz/setup/#cards","title":"Cards","text":"

Covered in the Connecting to a network section

"},{"location":"games/konami/iidx/24_sinobuz/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/konami/iidx/24_sinobuz/setup/#api","title":"API","text":"

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

"},{"location":"games/konami/iidx/24_sinobuz/setup/#options","title":"Options","text":"

If you don't know what an option does, hover over the its name with your mouse

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/konami/iidx/24_sinobuz/setup/#advanced-development","title":"Advanced & Development","text":"

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

"},{"location":"games/konami/iidx/24_sinobuz/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/konami/iidx/24_sinobuz/setup/#pre-launch-requirements","title":"Pre-launch requirements","text":"

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

"},{"location":"games/konami/iidx/24_sinobuz/setup/#vcredist-directx","title":"VCRedist & DirectX","text":"
  • Download and install the latest VCRedist
  • Download and install the DirectX End-User Runtimes
"},{"location":"games/konami/iidx/24_sinobuz/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/konami/iidx/24_sinobuz/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page

"},{"location":"games/konami/iidx/24_sinobuz/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 spice.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/konami/iidx/24_sinobuz/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/konami/iidx/24_sinobuz/setup/#definition-type","title":"DEFINITION TYPE","text":"

Go to GAME OPTIONS then DEFINITION TYPE.

Choose either HD or HD* depending on your preferences.

HD* adds +1.0 offset in-game, while HD doesn't.

Once done selecting, select YES then SAVE AND EXIT.

"},{"location":"games/konami/iidx/24_sinobuz/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/konami/iidx/24_sinobuz/setup/#carding-in","title":"Carding in","text":"

To card into the game:

  1. Press your Keypad Insert Card button.
  2. Enter your code using your keypad binds.
"},{"location":"games/konami/iidx/24_sinobuz/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/konami/iidx/24_sinobuz/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/24_sinobuz/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/iidx/24_sinobuz/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/konami/iidx/24_sinobuz/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/konami/iidx/24_sinobuz/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/konami/iidx/24_sinobuz/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/konami/iidx/25_cannonballers/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/25_cannonballers/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/25_cannonballers/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/25_cannonballers/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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 60 Hz, the game is hardcoded to run at 60 Hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60 Hz. 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 60 Hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/26_rootage/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/26_rootage/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/26_rootage/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/26_rootage/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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 60 Hz, the game is hardcoded to run at 60 Hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60 Hz. 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 60 Hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/27_heroicverse/extras/","title":"Extra Information","text":""},{"location":"games/konami/iidx/27_heroicverse/extras/#extra-information","title":"Extra Information","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/iidx/27_heroicverse/extras/#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/konami/iidx/27_heroicverse/extras/#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/konami/iidx/27_heroicverse/extras/#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/konami/iidx/27_heroicverse/extras/#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/konami/iidx/27_heroicverse/extras/#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/konami/iidx/27_heroicverse/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/27_heroicverse/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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 in the Extra Information

"},{"location":"games/konami/iidx/27_heroicverse/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/27_heroicverse/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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 60 Hz or 120 Hz 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 60 Hz or TDJ 120 Hz 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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/30_resident/extras/","title":"Extra Information","text":""},{"location":"games/konami/iidx/30_resident/extras/#extra-information","title":"Extra Information","text":""},{"location":"games/konami/iidx/30_resident/extras/#standard-and-lightning-modes","title":"Standard and Lightning modes","text":"

Lightning mode requires a 120 Hz 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, 60 Hz)
  • E for Standard (LDJ-012, LDJ, 60 Hz)
  • D for Lightning (LDJ-010, TDJ, 120 Hz)
"},{"location":"games/konami/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/konami/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\">2023090500</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/konami/iidx/30_resident/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/30_resident/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/iidx/30_resident/setup/#standard-and-lightning-modes","title":"Standard and Lightning modes","text":"

Before proceeding with the setup, it's important to understand the two cabinet types for IIDX:

  • Lightning (TDJ/LDJ-010):

    • Runs at 120 FPS
    • Requires a 120 Hz main monitor
    • Optional second touchscreen 60 Hz monitor called a subscreen

  • Standard/Legacy (LDJ/LDJ-003/LDJ-012):

    • Runs at 60 FPS
    • Requires a 60 Hz main monitor
    • No subscreen

The game data comes in three variants based on the bm2dx.dll file. You can patch an LDJ dll to run in TDJ mode, but this will disable video recording.

For simplicity, we'll use \"TDJ\" for Lightning Mode and \"LDJ\" for Standard Mode throughout our guides.

"},{"location":"games/konami/iidx/30_resident/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 95 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/iidx/30_resident/setup/#updating-data","title":"Updating data","text":"

Make sure you're using the right update for your current game version

IIDX updates have LDJ and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., LDJ_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., LDJ_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/iidx/30_resident/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice64.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice64.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
Additional steps for AMD and Intel graphics cards

Since KONAMI games are designed for NVIDIA GPU's, AMD and Intel users need additional files:

  • Locate the spice2x\\stubs\\64\\ folder in the spice2x archive
  • Extract all .dll files from there into your game's modules folder
"},{"location":"games/konami/iidx/30_resident/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

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

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

  • Maintenance: Service, Test
  • Game buttons: SW1 to SW7, Start, EFFECT, VEFX
  • Keypad: Keypad Insert Card, 1 to 9

Only if you play with a keyboard:

  • Turntable: TT+, TT- and optionally TT+/- which alternates between TT+ and TT- on each press.

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

This tab is used to bind analog controls like the turntable

Ignore this tab if you play with a keyboard

Bind your controller's turntable

With a controller, instead of binding TT+ or TT- in the Buttons tab, you need to:

  • Click Bind
  • In Device, pick your controller
  • In Control, pick the control that updates the preview when turning the turntable, typically X
  • Click Close, leaving the rest of the settings alone

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

Important

Enable IIDX Disable Cameras (-iidxdisablecams) unless you have a webcam connected and wish to use it with the camera hook from the advanced tab.

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

Optional: Enabling TDJ (Lightning mode)

You may want to enable IITX TDJ Mode (-iidxtdj) if your main monitor is 120 Hz capable.

Optional: Camera hook

With a webcam connected, you can:

  • Enable IIDX Cam Hook (-iidxtdjcamhook)
  • Make sure IIDX Disable Cameras (-iidxdisablecams) from the Options tab is disabled
  • Optionally enable IIDX Camera Order Flip (-iidxflipcams) if you have two cameras connected and the wrong one is being used

This allows spice2x to try and interface with your webcam to enable camera functionality in the game.

You can then bind a button to the Camera Control overlay in the Overlay tab to adjust camera settings.

No need to change anything here

"},{"location":"games/konami/iidx/30_resident/setup/#configuring-audio","title":"Configuring audio","text":"

Check out our general Audio guide to understand audio modes better, at least the TL;DR

  • 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

Then, depending follow instructions for your desired audio mode:

Setup for WASAPI Exclusive (default)
  • Check both boxes under Exclusive Mode
  • Open the Default Format dropdown
  • Pick the 16 bit, 44100 Hz (CD Quality) option, click Apply then OK
Setup for WASAPI Shared
  • Open the Default Format dropdown
  • Pick the 16 bit, 48000 Hz (DVD Quality) option, click Apply then OK
  • Return to spicecfg, go to the Patches tab
  • Following the patching guide and patch Shared Mode WASAPI

Optionally: go to the Options tab, and at the very bottom enable Low Latency Shared Audio to help mitigate the latency penalty from using Shared audio.

Setup for ASIO (requires specialized hardware)
  • Check both boxes under Exclusive Mode
  • Open the Default Format dropdown
  • Pick the 16 bit, 44100 Hz (CD Quality) option, click Apply then OK
"},{"location":"games/konami/iidx/30_resident/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/iidx/30_resident/setup/#configuring-your-game","title":"Configuring your game","text":"

Read through the Extra Information page

"},{"location":"games/konami/iidx/30_resident/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/iidx/30_resident/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/iidx/30_resident/setup/#first-launch","title":"First launch","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.

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.

Press your Test key again and let the game run for a bit until the monitor check is complete.

You will now 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.

Go to NETWORK OPTIONS then SHOP NAME SETTING.

You will need to set a shop name.

  • Name your shop to whatever you'd like. Again, navigation instructions 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/konami/iidx/30_resident/setup/#carding-in","title":"Carding in","text":"

Before carding in, you have the option to change the game's language by pressing your EFFECT key

For LDJ (Standard mode)

LDJ should accept keypad number binds:

  • Press your Keypad Insert Card button.
  • Enter your code using your keypad binds.
For TDJ (Lightning mode)

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/konami/iidx/30_resident/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/iidx/30_resident/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/30_resident/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

For any issues not covered here, spice2x's Known issues page might prove useful

"},{"location":"games/konami/iidx/30_resident/troubleshooting/#technical-problems","title":"Technical problems","text":""},{"location":"games/konami/iidx/30_resident/troubleshooting/#crashes","title":"Crashes","text":"

Riva Tuner Statistics Server (RTSS) and MSI Afterburner are known to cause odd crashes.If you have them installed, close them both before starting any arcade game

W:SuperstepSound: Audio device is not available!!! in logs

  • Open log.txt using an editor that supports SHIFT-JIS encoding for Japanese text (like Notepad++)

  • Search for Superstep

If you find a line with Audio device is not available!!!, it means the game refuses to boot due to a misconfigured or missing audio device. Check the setup guide's Configuring audio section as well as our general Audio guide to understand the issue better.

I'm using a laptop with a hybrid internal+dedicated GPU setup

Laptops often have odd issues running data. The game may open on the wrong monitor, run at the wrong resolution or framerate, or simply crashes.

There is currently no known fix for this, other than maybe playing in windowed mode, or using a desktop PC instead.

"},{"location":"games/konami/iidx/30_resident/troubleshooting/#performance","title":"Performance","text":"

Check out spice2x's PC optimization guide

Game is running too slow/fast / Monitor error 5-1503-0043

Your game is likely running at an incorrect framerate. The expected framerates are:

  • Legacy cab mode: 60 FPS
  • Lightning Model cab mode: 120 FPS

Try these steps to resolve framerate issues:

  • Make sure that your patch or DLL matches your cab mode
  • Close any software that can affect framerates (like RTSS)
  • Close unnecessary background programs
  • Ensure V-SYNC is not forcefully disabled in your graphics card control panel
  • For NVIDIA users: Enable NVIDIA profile optimization (-nvprofile) in spicecfg's Options tab

If issues persist:

  • Double-check that you followed all steps in the setup guide correctly
  • Your PC hardware might be insufficient to keep a steady 120 FPS, you can try switching to Legacy cab mode
  • Your data may be corrupt in one way or another, you could try starting from scratch using trusted data sources
"},{"location":"games/konami/iidx/30_resident/troubleshooting/#audio","title":"Audio","text":"

Check out our Audio guide to understand audio modes better

Ensure your default audio device's sample rate is set properly

  • 44100 Hz sample rate for WASAPI Exclusive and ASIO
  • 48000 Hz if your game is patched with Shared Mode WASAPI
I can't change my device's sample rate

If you're using gaming peripherals (Logitech/Razer/Steelseries) or external audio devices (audio interfaces/sound bars):

  • Check if you can modify the sample rate in the device's software/control panel
  • If not, try uninstalling the device's software. This may restore control over Windows audio settings

If you still can't change the sample rate:

  • Configure the game's audio mode to match your device's current sample rate instead
  • Try using a different audio device
I can't hear anything else than the game

Your game's audio is setup to run in WASAPI Exclusive or ASIO modes.

Check out our Audio guide to understand audio modes better.

If you're using WASAPI Exclusive, you'll want to patch the game with Shared Mode WASAPI to hear other applications.

If you're using ASIO, unless your audio interface mixes WASAPI and ASIO streams when outputting, you'll only be able to hear one application when ASIO is in use. In this case, you'll need to route all audio through software such as Voicemeeter, and have Voicemeeter output the mix to your ASIO device.

Game audio is too quiet

When using TDJ mode the audio is very quiet by default. To mitigate this, you can use the Increase Game Volume patch.

"},{"location":"games/konami/iidx/30_resident/troubleshooting/#subscreen","title":"Subscreen","text":"

For more in-depth troubleshooting, refer to the spice2x Subscreen troubleshooting page

Touch input isn't being registered

If you're using a physical touch screen, make sure to close all spice2x overlays, including the FPS counter. If you're using the virtual subscreen, ensure that the -iidxnativetouch option is not enabled.

"},{"location":"games/konami/iidx/31_epolis/extras/","title":"Extra Information","text":""},{"location":"games/konami/iidx/31_epolis/extras/#extra-information","title":"Extra Information","text":""},{"location":"games/konami/iidx/31_epolis/extras/#standard-and-lightning-modes","title":"Standard and Lightning modes","text":"

Lightning mode requires a 120 Hz 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, 60 Hz)
  • D for Lightning (LDJ-010, TDJ, 120 Hz)
"},{"location":"games/konami/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/konami/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 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/konami/iidx/31_epolis/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/31_epolis/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/iidx/31_epolis/setup/#standard-and-lightning-modes","title":"Standard and Lightning modes","text":"

Before proceeding with the setup, it's important to understand the two cabinet types for IIDX:

  • Lightning (TDJ/LDJ-010):

    • Runs at 120 FPS
    • Requires a 120 Hz main monitor
    • Optional second touchscreen 60 Hz monitor called a subscreen

  • Standard/Legacy (LDJ/LDJ-012):

    • Runs at 60 FPS
    • Requires a 60 Hz main monitor
    • No subscreen

The game data comes in two variants based on the bm2dx.dll file. You can patch an LDJ dll to run in TDJ mode, but this will disable video recording.

For simplicity, we'll use \"TDJ\" for Lightning Mode and \"LDJ\" for Standard Mode throughout our guides.

"},{"location":"games/konami/iidx/31_epolis/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 100 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/iidx/31_epolis/setup/#updating-data","title":"Updating data","text":"

Make sure you're using the right update for your current game version

IIDX updates have LDJ and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., LDJ_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., LDJ_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/iidx/31_epolis/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice64.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice64.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
Additional steps for AMD and Intel graphics cards

Since KONAMI games are designed for NVIDIA GPU's, AMD and Intel users need additional files:

  • Locate the spice2x\\stubs\\64\\ folder in the spice2x archive
  • Extract all .dll files from there into your game's modules folder
"},{"location":"games/konami/iidx/31_epolis/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

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

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

  • Maintenance: Service, Test
  • Game buttons: SW1 to SW7, Start, EFFECT, VEFX
  • Keypad: Keypad Insert Card, 1 to 9

Only if you play with a keyboard:

  • Turntable: TT+, TT- and optionally TT+/- which alternates between TT+ and TT- on each press.

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

This tab is used to bind analog controls like the turntable

Ignore this tab if you play with a keyboard

Bind your controller's turntable

With a controller, instead of binding TT+ or TT- in the Buttons tab, you need to:

  • Click Bind
  • In Device, pick your controller
  • In Control, pick the control that updates the preview when turning the turntable, typically X
  • Click Close, leaving the rest of the settings alone

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

Important

Enable IIDX Disable Cameras (-iidxdisablecams) unless you have a webcam connected and wish to use it with the camera hook from the advanced tab.

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

Optional: Enabling TDJ (Lightning mode)

You may want to enable IITX TDJ Mode (-iidxtdj) if your main monitor is 120 Hz capable.

Optional: Camera hook

With a webcam connected, you can:

  • Enable IIDX Cam Hook (-iidxtdjcamhook)
  • Make sure IIDX Disable Cameras (-iidxdisablecams) from the Options tab is disabled
  • Optionally enable IIDX Camera Order Flip (-iidxflipcams) if you have two cameras connected and the wrong one is being used

This allows spice2x to try and interface with your webcam to enable camera functionality in the game.

You can then bind a button to the Camera Control overlay in the Overlay tab to adjust camera settings.

No need to change anything here

"},{"location":"games/konami/iidx/31_epolis/setup/#configuring-audio","title":"Configuring audio","text":"

Check out our general Audio guide to understand audio modes better, at least the TL;DR

  • 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

Then, depending follow instructions for your desired audio mode:

Setup for WASAPI Exclusive (default)
  • Check both boxes under Exclusive Mode
  • Open the Default Format dropdown
  • Pick the 16 bit, 44100 Hz (CD Quality) option, click Apply then OK
Setup for WASAPI Shared
  • Open the Default Format dropdown
  • Pick the 16 bit, 48000 Hz (DVD Quality) option, click Apply then OK
  • Return to spicecfg, go to the Patches tab
  • Following the patching guide and patch Shared Mode WASAPI

Optionally: go to the Options tab, and at the very bottom enable Low Latency Shared Audio to help mitigate the latency penalty from using Shared audio.

Setup for ASIO (requires specialized hardware)
  • Check both boxes under Exclusive Mode
  • Open the Default Format dropdown
  • Pick the 16 bit, 44100 Hz (CD Quality) option, click Apply then OK
"},{"location":"games/konami/iidx/31_epolis/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/iidx/31_epolis/setup/#configuring-your-game","title":"Configuring your game","text":"

Read through the Extra Information page

"},{"location":"games/konami/iidx/31_epolis/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/iidx/31_epolis/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/iidx/31_epolis/setup/#first-launch","title":"First launch","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.

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.

Press your Test key again and let the game run for a bit until the monitor check is complete.

You will now 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.

Go to NETWORK OPTIONS then SHOP NAME SETTING.

You will need to set a shop name.

  • Name your shop to whatever you'd like. Again, navigation instructions 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/konami/iidx/31_epolis/setup/#carding-in","title":"Carding in","text":"

Before carding in, you have the option to change the game's language by pressing your EFFECT key

For LDJ (Standard mode)

LDJ should accept keypad number binds:

  • Press your Keypad Insert Card button.
  • Enter your code using your keypad binds.
For TDJ (Lightning mode)

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/konami/iidx/31_epolis/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/iidx/31_epolis/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/31_epolis/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

For any issues not covered here, spice2x's Known issues page might prove useful

"},{"location":"games/konami/iidx/31_epolis/troubleshooting/#technical-problems","title":"Technical problems","text":""},{"location":"games/konami/iidx/31_epolis/troubleshooting/#crashes","title":"Crashes","text":"

Riva Tuner Statistics Server (RTSS) and MSI Afterburner are known to cause odd crashes.If you have them installed, close them both before starting any arcade game

W:SuperstepSound: Audio device is not available!!! in logs

  • Open log.txt using an editor that supports SHIFT-JIS encoding for Japanese text (like Notepad++)

  • Search for Superstep

If you find a line with Audio device is not available!!!, it means the game refuses to boot due to a misconfigured or missing audio device. Check the setup guide's Configuring audio section as well as our general Audio guide to understand the issue better.

EXCEPTION_ILLEGAL_INSTRUCTION in logs

  • Open log.txt using an editor that supports SHIFT-JIS encoding for Japanese text (like Notepad++)

  • Search for EXCEPTION_ILLEGAL_INSTRUCTION

beatmania IIDX 31 and above require a CPU that is AVX2 capable. If you encounter this message, it may indicate that your CPU is too old and does not support AVX2. A known workaround is renaming/deleting the movies folder to prevent the game from loading them altogether.

I'm using a laptop with a hybrid internal+dedicated GPU setup

Laptops often have odd issues running data. The game may open on the wrong monitor, run at the wrong resolution or framerate, or simply crashes.

There is currently no known fix for this, other than maybe playing in windowed mode, or using a desktop PC instead.

"},{"location":"games/konami/iidx/31_epolis/troubleshooting/#performance","title":"Performance","text":"

Check out spice2x's PC optimization guide

Game is running too slow/fast / Monitor error 5-1503-0043

Your game is likely running at an incorrect framerate. The expected framerates are:

  • Legacy cab mode: 60 FPS
  • Lightning Model cab mode: 120 FPS

Try these steps to resolve framerate issues:

  • Make sure that your patch or DLL matches your cab mode
  • Close any software that can affect framerates (like RTSS)
  • Close unnecessary background programs
  • Ensure V-SYNC is not forcefully disabled in your graphics card control panel
  • For NVIDIA users: Enable NVIDIA profile optimization (-nvprofile) in spicecfg's Options tab

If issues persist:

  • Double-check that you followed all steps in the setup guide correctly
  • Your PC hardware might be insufficient to keep a steady 120 FPS, you can try switching to Legacy cab mode
  • Your data may be corrupt in one way or another, you could try starting from scratch using trusted data sources
"},{"location":"games/konami/iidx/31_epolis/troubleshooting/#audio","title":"Audio","text":"

Check out our Audio guide to understand audio modes better

Ensure your default audio device's sample rate is set properly

  • 44100 Hz sample rate for WASAPI Exclusive and ASIO
  • 48000 Hz if your game is patched with Shared Mode WASAPI
I can't change my device's sample rate

If you're using gaming peripherals (Logitech/Razer/Steelseries) or external audio devices (audio interfaces/sound bars):

  • Check if you can modify the sample rate in the device's software/control panel
  • If not, try uninstalling the device's software. This may restore control over Windows audio settings

If you still can't change the sample rate:

  • Configure the game's audio mode to match your device's current sample rate instead
  • Try using a different audio device
I can't hear anything else than the game

Your game's audio is setup to run in WASAPI Exclusive or ASIO modes.

Check out our Audio guide to understand audio modes better.

If you're using WASAPI Exclusive, you'll want to patch the game with Shared Mode WASAPI to hear other applications.

If you're using ASIO, unless your audio interface mixes WASAPI and ASIO streams when outputting, you'll only be able to hear one application when ASIO is in use. In this case, you'll need to route all audio through software such as Voicemeeter, and have Voicemeeter output the mix to your ASIO device.

Game audio is too quiet

When using TDJ mode the audio is very quiet by default. To mitigate this, you can use the Increase Game Volume patch.

"},{"location":"games/konami/iidx/31_epolis/troubleshooting/#subscreen","title":"Subscreen","text":"

For more in-depth troubleshooting, refer to the spice2x Subscreen troubleshooting page

Touch input isn't being registered

If you're using a physical touch screen, make sure to close all spice2x overlays, including the FPS counter. If you're using the virtual subscreen, ensure that the -iidxnativetouch option is not enabled.

"},{"location":"games/konami/iidx/32_pinkycrush/extras/","title":"Extra Information","text":""},{"location":"games/konami/iidx/32_pinkycrush/extras/#extra-information","title":"Extra Information","text":""},{"location":"games/konami/iidx/32_pinkycrush/extras/#standard-and-lightning-modes","title":"Standard and Lightning modes","text":"

Lightning mode requires a 120 Hz 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, 60 Hz)
  • D for Lightning (LDJ-010, TDJ, 120 Hz)
"},{"location":"games/konami/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/konami/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/konami/iidx/32_pinkycrush/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/32_pinkycrush/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/iidx/32_pinkycrush/setup/#standard-and-lightning-modes","title":"Standard and Lightning modes","text":"

Before proceeding with the setup, it's important to understand the two cabinet types for IIDX:

  • Lightning (TDJ/LDJ-010):

    • Runs at 120 FPS
    • Requires a 120 Hz main monitor
    • Optional second touchscreen 60 Hz monitor called a subscreen

  • Standard/Legacy (LDJ/LDJ-012):

    • Runs at 60 FPS
    • Requires a 60 Hz main monitor
    • No subscreen

The game data comes in two variants based on the bm2dx.dll file. You can patch an LDJ dll to run in TDJ mode, but this will disable video recording.

For simplicity, we'll use \"TDJ\" for Lightning Mode and \"LDJ\" for Standard Mode throughout our guides.

"},{"location":"games/konami/iidx/32_pinkycrush/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 100 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/iidx/32_pinkycrush/setup/#updating-data","title":"Updating data","text":"

Make sure you're using the right update for your current game version

IIDX updates have LDJ and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., LDJ_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., LDJ_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/iidx/32_pinkycrush/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice64.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice64.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
Additional steps for AMD and Intel graphics cards

Since KONAMI games are designed for NVIDIA GPU's, AMD and Intel users need additional files:

  • Locate the spice2x\\stubs\\64\\ folder in the spice2x archive
  • Extract all .dll files from there into your game's modules folder
"},{"location":"games/konami/iidx/32_pinkycrush/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

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

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

  • Maintenance: Service, Test
  • Game buttons: SW1 to SW7, Start, EFFECT, VEFX
  • Keypad: Keypad Insert Card, 1 to 9

Only if you play with a keyboard:

  • Turntable: TT+, TT- and optionally TT+/- which alternates between TT+ and TT- on each press.

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

This tab is used to bind analog controls like the turntable

Ignore this tab if you play with a keyboard

Bind your controller's turntable

With a controller, instead of binding TT+ or TT- in the Buttons tab, you need to:

  • Click Bind
  • In Device, pick your controller
  • In Control, pick the control that updates the preview when turning the turntable, typically X
  • Click Close, leaving the rest of the settings alone

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

Important

Enable IIDX Disable Cameras (-iidxdisablecams) unless you have a webcam connected and wish to use it with the camera hook from the advanced tab.

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

Optional: Enabling TDJ (Lightning mode)

You may want to enable IITX TDJ Mode (-iidxtdj) if your main monitor is 120 Hz capable.

Optional: Camera hook

With a webcam connected, you can:

  • Enable IIDX Cam Hook (-iidxtdjcamhook)
  • Make sure IIDX Disable Cameras (-iidxdisablecams) from the Options tab is disabled
  • Optionally enable IIDX Camera Order Flip (-iidxflipcams) if you have two cameras connected and the wrong one is being used

This allows spice2x to try and interface with your webcam to enable camera functionality in the game.

You can then bind a button to the Camera Control overlay in the Overlay tab to adjust camera settings.

No need to change anything here

"},{"location":"games/konami/iidx/32_pinkycrush/setup/#configuring-audio","title":"Configuring audio","text":"

Check out our general Audio guide to understand audio modes better, at least the TL;DR

  • 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

Then, depending follow instructions for your desired audio mode:

Setup for WASAPI Exclusive (default)
  • Check both boxes under Exclusive Mode
  • Open the Default Format dropdown
  • Pick the 16 bit, 44100 Hz (CD Quality) option, click Apply then OK
Setup for WASAPI Shared
  • Open the Default Format dropdown
  • Pick the 16 bit, 48000 Hz (DVD Quality) option, click Apply then OK
  • Return to spicecfg, go to the Patches tab
  • Following the patching guide and patch Shared Mode WASAPI

Optionally: go to the Options tab, and at the very bottom enable Low Latency Shared Audio to help mitigate the latency penalty from using Shared audio.

Setup for ASIO (requires specialized hardware)
  • Check both boxes under Exclusive Mode
  • Open the Default Format dropdown
  • Pick the 16 bit, 44100 Hz (CD Quality) option, click Apply then OK
"},{"location":"games/konami/iidx/32_pinkycrush/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/iidx/32_pinkycrush/setup/#configuring-your-game","title":"Configuring your game","text":"

Read through the Extra Information page

"},{"location":"games/konami/iidx/32_pinkycrush/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/iidx/32_pinkycrush/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/iidx/32_pinkycrush/setup/#first-launch","title":"First launch","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.

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.

Press your Test key again and let the game run for a bit until the monitor check is complete.

You will now 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.

Go to NETWORK OPTIONS then SHOP NAME SETTING.

You will need to set a shop name.

  • Name your shop to whatever you'd like. Again, navigation instructions 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/konami/iidx/32_pinkycrush/setup/#carding-in","title":"Carding in","text":"

Before carding in, you have the option to change the game's language by pressing your EFFECT key

For LDJ (Standard mode)

LDJ should accept keypad number binds:

  • Press your Keypad Insert Card button.
  • Enter your code using your keypad binds.
For TDJ (Lightning mode)

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/konami/iidx/32_pinkycrush/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/iidx/32_pinkycrush/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/32_pinkycrush/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

For any issues not covered here, spice2x's Known issues page might prove useful

"},{"location":"games/konami/iidx/32_pinkycrush/troubleshooting/#technical-problems","title":"Technical problems","text":""},{"location":"games/konami/iidx/32_pinkycrush/troubleshooting/#crashes","title":"Crashes","text":"

Riva Tuner Statistics Server (RTSS) and MSI Afterburner are known to cause odd crashes.If you have them installed, close them both before starting any arcade game

W:SuperstepSound: Audio device is not available!!! in logs

  • Open log.txt using an editor that supports SHIFT-JIS encoding for Japanese text (like Notepad++)

  • Search for Superstep

If you find a line with Audio device is not available!!!, it means the game refuses to boot due to a misconfigured or missing audio device. Check the setup guide's Configuring audio section as well as our general Audio guide to understand the issue better.

EXCEPTION_ILLEGAL_INSTRUCTION in logs

  • Open log.txt using an editor that supports SHIFT-JIS encoding for Japanese text (like Notepad++)

  • Search for EXCEPTION_ILLEGAL_INSTRUCTION

beatmania IIDX 31 and above require a CPU that is AVX2 capable. If you encounter this message, it may indicate that your CPU is too old and does not support AVX2. A known workaround is renaming/deleting the movies folder to prevent the game from loading them altogether.

I'm using a laptop with a hybrid internal+dedicated GPU setup

Laptops often have odd issues running data. The game may open on the wrong monitor, run at the wrong resolution or framerate, or simply crashes.

There is currently no known fix for this, other than maybe playing in windowed mode, or using a desktop PC instead.

"},{"location":"games/konami/iidx/32_pinkycrush/troubleshooting/#performance","title":"Performance","text":"

Check out spice2x's PC optimization guide

Game is running too slow/fast / Monitor error 5-1503-0043

Your game is likely running at an incorrect framerate. The expected framerates are:

  • Legacy cab mode: 60 FPS
  • Lightning Model cab mode: 120 FPS

Try these steps to resolve framerate issues:

  • Make sure that your patch or DLL matches your cab mode
  • Close any software that can affect framerates (like RTSS)
  • Close unnecessary background programs
  • Ensure V-SYNC is not forcefully disabled in your graphics card control panel
  • For NVIDIA users: Enable NVIDIA profile optimization (-nvprofile) in spicecfg's Options tab

If issues persist:

  • Double-check that you followed all steps in the setup guide correctly
  • Your PC hardware might be insufficient to keep a steady 120 FPS, you can try switching to Legacy cab mode
  • Your data may be corrupt in one way or another, you could try starting from scratch using trusted data sources
"},{"location":"games/konami/iidx/32_pinkycrush/troubleshooting/#audio","title":"Audio","text":"

Check out our Audio guide to understand audio modes better

Ensure your default audio device's sample rate is set properly

  • 44100 Hz sample rate for WASAPI Exclusive and ASIO
  • 48000 Hz if your game is patched with Shared Mode WASAPI
I can't change my device's sample rate

If you're using gaming peripherals (Logitech/Razer/Steelseries) or external audio devices (audio interfaces/sound bars):

  • Check if you can modify the sample rate in the device's software/control panel
  • If not, try uninstalling the device's software. This may restore control over Windows audio settings

If you still can't change the sample rate:

  • Configure the game's audio mode to match your device's current sample rate instead
  • Try using a different audio device
I can't hear anything else than the game

Your game's audio is setup to run in WASAPI Exclusive or ASIO modes.

Check out our Audio guide to understand audio modes better.

If you're using WASAPI Exclusive, you'll want to patch the game with Shared Mode WASAPI to hear other applications.

If you're using ASIO, unless your audio interface mixes WASAPI and ASIO streams when outputting, you'll only be able to hear one application when ASIO is in use. In this case, you'll need to route all audio through software such as Voicemeeter, and have Voicemeeter output the mix to your ASIO device.

Game audio is too quiet

When using TDJ mode the audio is very quiet by default. To mitigate this, you can use the Increase Game Volume patch.

"},{"location":"games/konami/iidx/32_pinkycrush/troubleshooting/#subscreen","title":"Subscreen","text":"

For more in-depth troubleshooting, refer to the spice2x Subscreen troubleshooting page

Touch input isn't being registered

If you're using a physical touch screen, make sure to close all spice2x overlays, including the FPS counter. If you're using the virtual subscreen, ensure that the -iidxnativetouch option is not enabled.

"},{"location":"games/konami/iidx/33_sparkleshower/extras/","title":"Extra Information","text":""},{"location":"games/konami/iidx/33_sparkleshower/extras/#extra-information","title":"Extra Information","text":""},{"location":"games/konami/iidx/33_sparkleshower/extras/#standard-and-lightning-modes","title":"Standard and Lightning modes","text":"

Lightning mode requires a 120 Hz 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, 60 Hz)
  • D for Lightning (LDJ-010, TDJ, 120 Hz)
"},{"location":"games/konami/iidx/33_sparkleshower/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/konami/iidx/33_sparkleshower/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/konami/iidx/33_sparkleshower/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/33_sparkleshower/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/iidx/33_sparkleshower/setup/#standard-and-lightning-modes","title":"Standard and Lightning modes","text":"

Before proceeding with the setup, it's important to understand the two cabinet types for IIDX:

  • Lightning (TDJ/LDJ-010):

    • Runs at 120 FPS
    • Requires a 120 Hz main monitor
    • Optional second touchscreen 60 Hz monitor called a subscreen

  • Standard/Legacy (LDJ/LDJ-012):

    • Runs at 60 FPS
    • Requires a 60 Hz main monitor
    • No subscreen

The game data comes in two variants based on the bm2dx.dll file. You can patch an LDJ dll to run in TDJ mode, but this will disable video recording.

For simplicity, we'll use \"TDJ\" for Lightning Mode and \"LDJ\" for Standard Mode throughout our guides.

"},{"location":"games/konami/iidx/33_sparkleshower/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 100 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/iidx/33_sparkleshower/setup/#updating-data","title":"Updating data","text":"

Make sure you're using the right update for your current game version

IIDX updates have LDJ and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., LDJ_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., LDJ_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/iidx/33_sparkleshower/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice64.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice64.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
Additional steps for AMD and Intel graphics cards

Since KONAMI games are designed for NVIDIA GPU's, AMD and Intel users need additional files:

  • Locate the spice2x\\stubs\\64\\ folder in the spice2x archive
  • Extract all .dll files from there into your game's modules folder
"},{"location":"games/konami/iidx/33_sparkleshower/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

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

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

  • Maintenance: Service, Test
  • Game buttons: SW1 to SW7, Start, EFFECT, VEFX
  • Keypad: Keypad Insert Card, 1 to 9

Only if you play with a keyboard:

  • Turntable: TT+, TT- and optionally TT+/- which alternates between TT+ and TT- on each press.

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

This tab is used to bind analog controls like the turntable

Ignore this tab if you play with a keyboard

Bind your controller's turntable

With a controller, instead of binding TT+ or TT- in the Buttons tab, you need to:

  • Click Bind
  • In Device, pick your controller
  • In Control, pick the control that updates the preview when turning the turntable, typically X
  • Click Close, leaving the rest of the settings alone

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

Important

Enable IIDX Disable Cameras (-iidxdisablecams) unless you have a webcam connected and wish to use it with the camera hook from the advanced tab.

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

Optional: Enabling TDJ (Lightning mode)

You may want to enable IITX TDJ Mode (-iidxtdj) if your main monitor is 120 Hz capable.

Optional: Camera hook

With a webcam connected, you can:

  • Enable IIDX Cam Hook (-iidxtdjcamhook)
  • Make sure IIDX Disable Cameras (-iidxdisablecams) from the Options tab is disabled
  • Optionally enable IIDX Camera Order Flip (-iidxflipcams) if you have two cameras connected and the wrong one is being used

This allows spice2x to try and interface with your webcam to enable camera functionality in the game.

You can then bind a button to the Camera Control overlay in the Overlay tab to adjust camera settings.

No need to change anything here

"},{"location":"games/konami/iidx/33_sparkleshower/setup/#configuring-audio","title":"Configuring audio","text":"

Check out our general Audio guide to understand audio modes better, at least the TL;DR

  • 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

Then, depending follow instructions for your desired audio mode:

Setup for WASAPI Exclusive (default)
  • Check both boxes under Exclusive Mode
  • Open the Default Format dropdown
  • Pick the 16 bit, 44100 Hz (CD Quality) option, click Apply then OK
Setup for WASAPI Shared
  • Open the Default Format dropdown
  • Pick the 16 bit, 48000 Hz (DVD Quality) option, click Apply then OK
  • Return to spicecfg, go to the Patches tab
  • Following the patching guide and patch Shared Mode WASAPI

Optionally: go to the Options tab, and at the very bottom enable Low Latency Shared Audio to help mitigate the latency penalty from using Shared audio.

Setup for ASIO (requires specialized hardware)
  • Check both boxes under Exclusive Mode
  • Open the Default Format dropdown
  • Pick the 16 bit, 44100 Hz (CD Quality) option, click Apply then OK
"},{"location":"games/konami/iidx/33_sparkleshower/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/iidx/33_sparkleshower/setup/#configuring-your-game","title":"Configuring your game","text":"

Read through the Extra Information page

"},{"location":"games/konami/iidx/33_sparkleshower/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/iidx/33_sparkleshower/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/iidx/33_sparkleshower/setup/#first-launch","title":"First launch","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.

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.

Press your Test key again and let the game run for a bit until the monitor check is complete.

You will now 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.

Go to NETWORK OPTIONS then SHOP NAME SETTING.

You will need to set a shop name.

  • Name your shop to whatever you'd like. Again, navigation instructions 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/konami/iidx/33_sparkleshower/setup/#carding-in","title":"Carding in","text":"

Before carding in, you have the option to change the game's language by pressing your EFFECT key

For LDJ (Standard mode)

LDJ should accept keypad number binds:

  • Press your Keypad Insert Card button.
  • Enter your code using your keypad binds.
For TDJ (Lightning mode)

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/konami/iidx/33_sparkleshower/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/iidx/33_sparkleshower/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/33_sparkleshower/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

For any issues not covered here, spice2x's Known issues page might prove useful

"},{"location":"games/konami/iidx/33_sparkleshower/troubleshooting/#technical-problems","title":"Technical problems","text":""},{"location":"games/konami/iidx/33_sparkleshower/troubleshooting/#crashes","title":"Crashes","text":"

Riva Tuner Statistics Server (RTSS) and MSI Afterburner are known to cause odd crashes.If you have them installed, close them both before starting any arcade game

W:SuperstepSound: Audio device is not available!!! in logs

  • Open log.txt using an editor that supports SHIFT-JIS encoding for Japanese text (like Notepad++)

  • Search for Superstep

If you find a line with Audio device is not available!!!, it means the game refuses to boot due to a misconfigured or missing audio device. Check the setup guide's Configuring audio section as well as our general Audio guide to understand the issue better.

EXCEPTION_ILLEGAL_INSTRUCTION in logs

  • Open log.txt using an editor that supports SHIFT-JIS encoding for Japanese text (like Notepad++)

  • Search for EXCEPTION_ILLEGAL_INSTRUCTION

beatmania IIDX 31 and above require a CPU that is AVX2 capable. If you encounter this message, it may indicate that your CPU is too old and does not support AVX2. A known workaround is renaming/deleting the movies folder to prevent the game from loading them altogether.

I'm using a laptop with a hybrid internal+dedicated GPU setup

Laptops often have odd issues running data. The game may open on the wrong monitor, run at the wrong resolution or framerate, or simply crashes.

There is currently no known fix for this, other than maybe playing in windowed mode, or using a desktop PC instead.

"},{"location":"games/konami/iidx/33_sparkleshower/troubleshooting/#performance","title":"Performance","text":"

Check out spice2x's PC optimization guide

Game is running too slow/fast / Monitor error 5-1503-0043

Your game is likely running at an incorrect framerate. The expected framerates are:

  • Legacy cab mode: 60 FPS
  • Lightning Model cab mode: 120 FPS

Try these steps to resolve framerate issues:

  • Make sure that your patch or DLL matches your cab mode
  • Close any software that can affect framerates (like RTSS)
  • Close unnecessary background programs
  • Ensure V-SYNC is not forcefully disabled in your graphics card control panel
  • For NVIDIA users: Enable NVIDIA profile optimization (-nvprofile) in spicecfg's Options tab

If issues persist:

  • Double-check that you followed all steps in the setup guide correctly
  • Your PC hardware might be insufficient to keep a steady 120 FPS, you can try switching to Legacy cab mode
  • Your data may be corrupt in one way or another, you could try starting from scratch using trusted data sources
"},{"location":"games/konami/iidx/33_sparkleshower/troubleshooting/#audio","title":"Audio","text":"

Check out our Audio guide to understand audio modes better

Ensure your default audio device's sample rate is set properly

  • 44100 Hz sample rate for WASAPI Exclusive and ASIO
  • 48000 Hz if your game is patched with Shared Mode WASAPI
I can't change my device's sample rate

If you're using gaming peripherals (Logitech/Razer/Steelseries) or external audio devices (audio interfaces/sound bars):

  • Check if you can modify the sample rate in the device's software/control panel
  • If not, try uninstalling the device's software. This may restore control over Windows audio settings

If you still can't change the sample rate:

  • Configure the game's audio mode to match your device's current sample rate instead
  • Try using a different audio device
I can't hear anything else than the game

Your game's audio is setup to run in WASAPI Exclusive or ASIO modes.

Check out our Audio guide to understand audio modes better.

If you're using WASAPI Exclusive, you'll want to patch the game with Shared Mode WASAPI to hear other applications.

If you're using ASIO, unless your audio interface mixes WASAPI and ASIO streams when outputting, you'll only be able to hear one application when ASIO is in use. In this case, you'll need to route all audio through software such as Voicemeeter, and have Voicemeeter output the mix to your ASIO device.

Game audio is too quiet

When using TDJ mode the audio is very quiet by default. To mitigate this, you can use the Increase Game Volume patch.

"},{"location":"games/konami/iidx/33_sparkleshower/troubleshooting/#subscreen","title":"Subscreen","text":"

For more in-depth troubleshooting, refer to the spice2x Subscreen troubleshooting page

Touch input isn't being registered

If you're using a physical touch screen, make sure to close all spice2x overlays, including the FPS counter. If you're using the virtual subscreen, ensure that the -iidxnativetouch option is not enabled.

"},{"location":"games/konami/iidx/9thstyle/setup/","title":"Game Setup","text":""},{"location":"games/konami/iidx/9thstyle/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/iidx/9thstyle/setup/#configuring-bemanitools","title":"Configuring Bemanitools","text":"

To configure your keybinds, open your config.bat file

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/9thstyle/setup/#first-launch","title":"First launch","text":"

If you have any issues running the game, refer to the Troubleshooting page

"},{"location":"games/konami/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/konami/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/konami/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/konami/iidx/9thstyle/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/iidx/9thstyle/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/iidx/common/31plus/extras/","title":"Extra Information","text":""},{"location":"games/konami/iidx/common/31plus/extras/#standard-and-lightning-modes","title":"Standard and Lightning modes","text":"

Lightning mode requires a 120 Hz 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, 60 Hz)
  • D for Lightning (LDJ-010, TDJ, 120 Hz)
"},{"location":"games/konami/iidx/common/31plus/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/konami/iidx/common/31plus/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/konami/iidx/common/31plus/setup/","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/iidx/common/31plus/setup/#standard-and-lightning-modes","title":"Standard and Lightning modes","text":"

Before proceeding with the setup, it's important to understand the two cabinet types for IIDX:

  • Lightning (TDJ/LDJ-010):

    • Runs at 120 FPS
    • Requires a 120 Hz main monitor
    • Optional second touchscreen 60 Hz monitor called a subscreen

  • Standard/Legacy (LDJ/LDJ-012):

    • Runs at 60 FPS
    • Requires a 60 Hz main monitor
    • No subscreen

The game data comes in two variants based on the bm2dx.dll file. You can patch an LDJ dll to run in TDJ mode, but this will disable video recording.

For simplicity, we'll use \"TDJ\" for Lightning Mode and \"LDJ\" for Standard Mode throughout our guides.

"},{"location":"games/konami/iidx/common/31plus/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 100 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/iidx/common/31plus/setup/#updating-data","title":"Updating data","text":"

Make sure you're using the right update for your current game version

IIDX updates have LDJ and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., LDJ_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., LDJ_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/iidx/common/31plus/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice64.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice64.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
Additional steps for AMD and Intel graphics cards

Since KONAMI games are designed for NVIDIA GPU's, AMD and Intel users need additional files:

  • Locate the spice2x\\stubs\\64\\ folder in the spice2x archive
  • Extract all .dll files from there into your game's modules folder
"},{"location":"games/konami/iidx/common/31plus/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

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

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

  • Maintenance: Service, Test
  • Game buttons: SW1 to SW7, Start, EFFECT, VEFX
  • Keypad: Keypad Insert Card, 1 to 9

Only if you play with a keyboard:

  • Turntable: TT+, TT- and optionally TT+/- which alternates between TT+ and TT- on each press.

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

This tab is used to bind analog controls like the turntable

Ignore this tab if you play with a keyboard

Bind your controller's turntable

With a controller, instead of binding TT+ or TT- in the Buttons tab, you need to:

  • Click Bind
  • In Device, pick your controller
  • In Control, pick the control that updates the preview when turning the turntable, typically X
  • Click Close, leaving the rest of the settings alone

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

Important

Enable IIDX Disable Cameras (-iidxdisablecams) unless you have a webcam connected and wish to use it with the camera hook from the advanced tab.

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

Optional: Enabling TDJ (Lightning mode)

You may want to enable IITX TDJ Mode (-iidxtdj) if your main monitor is 120 Hz capable.

Optional: Camera hook

With a webcam connected, you can:

  • Enable IIDX Cam Hook (-iidxtdjcamhook)
  • Make sure IIDX Disable Cameras (-iidxdisablecams) from the Options tab is disabled
  • Optionally enable IIDX Camera Order Flip (-iidxflipcams) if you have two cameras connected and the wrong one is being used

This allows spice2x to try and interface with your webcam to enable camera functionality in the game.

You can then bind a button to the Camera Control overlay in the Overlay tab to adjust camera settings.

No need to change anything here

"},{"location":"games/konami/iidx/common/31plus/setup/#configuring-audio","title":"Configuring audio","text":"

Check out our general Audio guide to understand audio modes better, at least the TL;DR

  • 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

Then, depending follow instructions for your desired audio mode:

Setup for WASAPI Exclusive (default)
  • Check both boxes under Exclusive Mode
  • Open the Default Format dropdown
  • Pick the 16 bit, 44100 Hz (CD Quality) option, click Apply then OK
Setup for WASAPI Shared
  • Open the Default Format dropdown
  • Pick the 16 bit, 48000 Hz (DVD Quality) option, click Apply then OK
  • Return to spicecfg, go to the Patches tab
  • Following the patching guide and patch Shared Mode WASAPI

Optionally: go to the Options tab, and at the very bottom enable Low Latency Shared Audio to help mitigate the latency penalty from using Shared audio.

Setup for ASIO (requires specialized hardware)
  • Check both boxes under Exclusive Mode
  • Open the Default Format dropdown
  • Pick the 16 bit, 44100 Hz (CD Quality) option, click Apply then OK
"},{"location":"games/konami/iidx/common/31plus/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/iidx/common/31plus/setup/#configuring-your-game","title":"Configuring your game","text":"

Read through the Extra Information page

"},{"location":"games/konami/iidx/common/31plus/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/iidx/common/31plus/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/iidx/common/31plus/setup/#first-launch","title":"First launch","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.

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.

Press your Test key again and let the game run for a bit until the monitor check is complete.

You will now 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.

Go to NETWORK OPTIONS then SHOP NAME SETTING.

You will need to set a shop name.

  • Name your shop to whatever you'd like. Again, navigation instructions 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/konami/iidx/common/31plus/setup/#carding-in","title":"Carding in","text":"

Before carding in, you have the option to change the game's language by pressing your EFFECT key

For LDJ (Standard mode)

LDJ should accept keypad number binds:

  • Press your Keypad Insert Card button.
  • Enter your code using your keypad binds.
For TDJ (Lightning mode)

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/konami/iidx/common/31plus/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/iidx/common/31plus/troubleshooting/","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

For any issues not covered here, spice2x's Known issues page might prove useful

"},{"location":"games/konami/iidx/common/31plus/troubleshooting/#technical-problems","title":"Technical problems","text":""},{"location":"games/konami/iidx/common/31plus/troubleshooting/#crashes","title":"Crashes","text":"

Riva Tuner Statistics Server (RTSS) and MSI Afterburner are known to cause odd crashes.If you have them installed, close them both before starting any arcade game

W:SuperstepSound: Audio device is not available!!! in logs

  • Open log.txt using an editor that supports SHIFT-JIS encoding for Japanese text (like Notepad++)

  • Search for Superstep

If you find a line with Audio device is not available!!!, it means the game refuses to boot due to a misconfigured or missing audio device. Check the setup guide's Configuring audio section as well as our general Audio guide to understand the issue better.

EXCEPTION_ILLEGAL_INSTRUCTION in logs

  • Open log.txt using an editor that supports SHIFT-JIS encoding for Japanese text (like Notepad++)

  • Search for EXCEPTION_ILLEGAL_INSTRUCTION

beatmania IIDX 31 and above require a CPU that is AVX2 capable. If you encounter this message, it may indicate that your CPU is too old and does not support AVX2. A known workaround is renaming/deleting the movies folder to prevent the game from loading them altogether.

I'm using a laptop with a hybrid internal+dedicated GPU setup

Laptops often have odd issues running data. The game may open on the wrong monitor, run at the wrong resolution or framerate, or simply crashes.

There is currently no known fix for this, other than maybe playing in windowed mode, or using a desktop PC instead.

"},{"location":"games/konami/iidx/common/31plus/troubleshooting/#performance","title":"Performance","text":"

Check out spice2x's PC optimization guide

Game is running too slow/fast / Monitor error 5-1503-0043

Your game is likely running at an incorrect framerate. The expected framerates are:

  • Legacy cab mode: 60 FPS
  • Lightning Model cab mode: 120 FPS

Try these steps to resolve framerate issues:

  • Make sure that your patch or DLL matches your cab mode
  • Close any software that can affect framerates (like RTSS)
  • Close unnecessary background programs
  • Ensure V-SYNC is not forcefully disabled in your graphics card control panel
  • For NVIDIA users: Enable NVIDIA profile optimization (-nvprofile) in spicecfg's Options tab

If issues persist:

  • Double-check that you followed all steps in the setup guide correctly
  • Your PC hardware might be insufficient to keep a steady 120 FPS, you can try switching to Legacy cab mode
  • Your data may be corrupt in one way or another, you could try starting from scratch using trusted data sources
"},{"location":"games/konami/iidx/common/31plus/troubleshooting/#audio","title":"Audio","text":"

Check out our Audio guide to understand audio modes better

Ensure your default audio device's sample rate is set properly

  • 44100 Hz sample rate for WASAPI Exclusive and ASIO
  • 48000 Hz if your game is patched with Shared Mode WASAPI
I can't change my device's sample rate

If you're using gaming peripherals (Logitech/Razer/Steelseries) or external audio devices (audio interfaces/sound bars):

  • Check if you can modify the sample rate in the device's software/control panel
  • If not, try uninstalling the device's software. This may restore control over Windows audio settings

If you still can't change the sample rate:

  • Configure the game's audio mode to match your device's current sample rate instead
  • Try using a different audio device
I can't hear anything else than the game

Your game's audio is setup to run in WASAPI Exclusive or ASIO modes.

Check out our Audio guide to understand audio modes better.

If you're using WASAPI Exclusive, you'll want to patch the game with Shared Mode WASAPI to hear other applications.

If you're using ASIO, unless your audio interface mixes WASAPI and ASIO streams when outputting, you'll only be able to hear one application when ASIO is in use. In this case, you'll need to route all audio through software such as Voicemeeter, and have Voicemeeter output the mix to your ASIO device.

Game audio is too quiet

When using TDJ mode the audio is very quiet by default. To mitigate this, you can use the Increase Game Volume patch.

"},{"location":"games/konami/iidx/common/31plus/troubleshooting/#subscreen","title":"Subscreen","text":"

For more in-depth troubleshooting, refer to the spice2x Subscreen troubleshooting page

Touch input isn't being registered

If you're using a physical touch screen, make sure to close all spice2x overlays, including the FPS counter. If you're using the virtual subscreen, ensure that the -iidxnativetouch option is not enabled.

"},{"location":"games/konami/jubeat/avenue/setup/","title":"Game Setup","text":""},{"location":"games/konami/jubeat/avenue/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/jubeat/avenue/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 10 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\u2699\ufe0fmsvcr100.dll\n

If your data does not look like this

If you have other .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/jubeat/avenue/setup/#updating-data","title":"Updating data","text":"

Make sure you're using the right update for your current game version

jubeat updates have L44 and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., L44_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., L44_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/jubeat/avenue/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\u2699\ufe0fmsvcr100.dll\n\ud83c\udf36\ufe0fspice.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
Additional steps for AMD and Intel graphics cards

Since KONAMI games are designed for NVIDIA GPU's, AMD and Intel users need additional files:

  • Locate the spice2x\\stubs\\32\\ folder in the spice2x archive
  • Extract all .dll files from there into your game's modules folder
"},{"location":"games/konami/jubeat/avenue/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

Click on Bind or Naive 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: Button 1 to Button 16
  • Keypad: Keypad Insert Card

Using a touch screen

spice2x supports using a touch screen instead of the 16 game buttons. In that case, you don't need to bind these buttons.

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

No need to change anything here

"},{"location":"games/konami/jubeat/avenue/setup/#configuring-audio","title":"Configuring 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
  • Open the Default Format dropdown
  • Pick the 16 bit, 48000 Hz (DVD Quality) option, click Apply then OK

Optionally: go to the Options tab in spicecfg.exe, and at the very bottom enable Low Latency Shared Audio to help mitigate audio latency.

"},{"location":"games/konami/jubeat/avenue/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/jubeat/avenue/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/jubeat/avenue/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/jubeat/avenue/setup/#first-launch","title":"First launch","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 spice.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.

Press your Test key to initialize the backup data, another message with the same error will pop up. Press your Test key again to open the service menu.

You will be greeted by a warning asking you to reboot the game, you can safely ignore it for the moment.

Instructions on how to navigate the menu are shown on the screen.

Go to GAME OPTIONS, then SHOP SETTINGS.

You will need to set a shop name.

  • Name your shop to whatever you'd like. Again, navigation instructions are on the screen.
  • Press the EXIT button.

Then, set the shop area to whatever region you'd like.

Select SAVE AND EXIT then EXIT.

Finally, restart the game.

You're all done! The game should load up properly now

"},{"location":"games/konami/jubeat/avenue/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/jubeat/beyondtheavenue/setup/","title":"Game Setup","text":""},{"location":"games/konami/jubeat/beyondtheavenue/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/jubeat/beyondtheavenue/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 10 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\u2699\ufe0fmsvcr100.dll\n

If your data does not look like this

If you have other .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/jubeat/beyondtheavenue/setup/#updating-data","title":"Updating data","text":"

Make sure you're using the right update for your current game version

jubeat updates have L44 and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., L44_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., L44_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/jubeat/beyondtheavenue/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\u2699\ufe0fmsvcr100.dll\n\ud83c\udf36\ufe0fspice.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
Additional steps for AMD and Intel graphics cards

Since KONAMI games are designed for NVIDIA GPU's, AMD and Intel users need additional files:

  • Locate the spice2x\\stubs\\32\\ folder in the spice2x archive
  • Extract all .dll files from there into your game's modules folder
"},{"location":"games/konami/jubeat/beyondtheavenue/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

Click on Bind or Naive 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: Button 1 to Button 16
  • Keypad: Keypad Insert Card

Using a touch screen

spice2x supports using a touch screen instead of the 16 game buttons. In that case, you don't need to bind these buttons.

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

No need to change anything here

"},{"location":"games/konami/jubeat/beyondtheavenue/setup/#configuring-audio","title":"Configuring 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
  • Open the Default Format dropdown
  • Pick the 16 bit, 48000 Hz (DVD Quality) option, click Apply then OK

Optionally: go to the Options tab in spicecfg.exe, and at the very bottom enable Low Latency Shared Audio to help mitigate audio latency.

"},{"location":"games/konami/jubeat/beyondtheavenue/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/jubeat/beyondtheavenue/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/jubeat/beyondtheavenue/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/jubeat/beyondtheavenue/setup/#first-launch","title":"First launch","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 spice.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.

Press your Test key to initialize the backup data, another message with the same error will pop up. Press your Test key again to open the service menu.

You will be greeted by a warning asking you to reboot the game, you can safely ignore it for the moment.

Instructions on how to navigate the menu are shown on the screen.

Go to GAME OPTIONS, then SHOP SETTINGS.

You will need to set a shop name.

  • Name your shop to whatever you'd like. Again, navigation instructions are on the screen.
  • Press the EXIT button.

Then, set the shop area to whatever region you'd like.

Select SAVE AND EXIT then EXIT.

Finally, restart the game.

You're all done! The game should load up properly now

"},{"location":"games/konami/jubeat/beyondtheavenue/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/jubeat/common/setup/","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 10 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\u2699\ufe0fmsvcr100.dll\n

If your data does not look like this

If you have other .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/jubeat/common/setup/#updating-data","title":"Updating data","text":"

Make sure you're using the right update for your current game version

jubeat updates have L44 and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., L44_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., L44_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/jubeat/common/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\u2699\ufe0fmsvcr100.dll\n\ud83c\udf36\ufe0fspice.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
Additional steps for AMD and Intel graphics cards

Since KONAMI games are designed for NVIDIA GPU's, AMD and Intel users need additional files:

  • Locate the spice2x\\stubs\\32\\ folder in the spice2x archive
  • Extract all .dll files from there into your game's modules folder
"},{"location":"games/konami/jubeat/common/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

Click on Bind or Naive 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: Button 1 to Button 16
  • Keypad: Keypad Insert Card

Using a touch screen

spice2x supports using a touch screen instead of the 16 game buttons. In that case, you don't need to bind these buttons.

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

No need to change anything here

"},{"location":"games/konami/jubeat/common/setup/#configuring-audio","title":"Configuring 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
  • Open the Default Format dropdown
  • Pick the 16 bit, 48000 Hz (DVD Quality) option, click Apply then OK

Optionally: go to the Options tab in spicecfg.exe, and at the very bottom enable Low Latency Shared Audio to help mitigate audio latency.

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

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/jubeat/common/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/jubeat/common/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/jubeat/common/setup/#first-launch","title":"First launch","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 spice.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.

Press your Test key to initialize the backup data, another message with the same error will pop up. Press your Test key again to open the service menu.

You will be greeted by a warning asking you to reboot the game, you can safely ignore it for the moment.

Instructions on how to navigate the menu are shown on the screen.

Go to GAME OPTIONS, then SHOP SETTINGS.

You will need to set a shop name.

  • Name your shop to whatever you'd like. Again, navigation instructions are on the screen.
  • Press the EXIT button.

Then, set the shop area to whatever region you'd like.

Select SAVE AND EXIT then EXIT.

Finally, restart the game.

You're all done! The game should load up properly now

"},{"location":"games/konami/jubeat/common/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/jubeat/festo/setup/","title":"Game Setup","text":""},{"location":"games/konami/jubeat/festo/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/jubeat/festo/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 10 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\u2699\ufe0fmsvcr100.dll\n

If your data does not look like this

If you have other .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/jubeat/festo/setup/#updating-data","title":"Updating data","text":"

Make sure you're using the right update for your current game version

jubeat updates have L44 and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., L44_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., L44_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/jubeat/festo/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\u2699\ufe0fmsvcr100.dll\n\ud83c\udf36\ufe0fspice.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
Additional steps for AMD and Intel graphics cards

Since KONAMI games are designed for NVIDIA GPU's, AMD and Intel users need additional files:

  • Locate the spice2x\\stubs\\32\\ folder in the spice2x archive
  • Extract all .dll files from there into your game's modules folder
"},{"location":"games/konami/jubeat/festo/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

Click on Bind or Naive 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: Button 1 to Button 16
  • Keypad: Keypad Insert Card

Using a touch screen

spice2x supports using a touch screen instead of the 16 game buttons. In that case, you don't need to bind these buttons.

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

No need to change anything here

"},{"location":"games/konami/jubeat/festo/setup/#configuring-audio","title":"Configuring 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
  • Open the Default Format dropdown
  • Pick the 16 bit, 48000 Hz (DVD Quality) option, click Apply then OK

Optionally: go to the Options tab in spicecfg.exe, and at the very bottom enable Low Latency Shared Audio to help mitigate audio latency.

"},{"location":"games/konami/jubeat/festo/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/jubeat/festo/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/jubeat/festo/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/jubeat/festo/setup/#first-launch","title":"First launch","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 spice.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.

Press your Test key to initialize the backup data, another message with the same error will pop up. Press your Test key again to open the service menu.

You will be greeted by a warning asking you to reboot the game, you can safely ignore it for the moment.

Instructions on how to navigate the menu are shown on the screen.

Go to GAME OPTIONS, then SHOP SETTINGS.

You will need to set a shop name.

  • Name your shop to whatever you'd like. Again, navigation instructions are on the screen.
  • Press the EXIT button.

Then, set the shop area to whatever region you'd like.

Select SAVE AND EXIT then EXIT.

Finally, restart the game.

You're all done! The game should load up properly now

"},{"location":"games/konami/jubeat/festo/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/mfg/setup/","title":"Game Setup","text":""},{"location":"games/konami/mfg/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/mfg/setup/#preparing-data","title":"Preparing Data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 5 GB or larger

Here's what the expected data structure should look like: 

\ud83d\udcc2prop\n\ud83d\udcc2modules\n\ud83d\udcc2game\n\ud83d\udcc4game.inf\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/konami/mfg/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice64.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2prop\n\ud83d\udcc2modules\n\ud83d\udcc2game\n\ud83d\udcc4game.inf\n\ud83c\udf36\ufe0fspice64.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
"},{"location":"games/konami/mfg/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

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

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

  • Maintenance: Service, Test

Mahjong Fight Girl is a touchscreen game, so it does not need any extra button configuration beyond the above.

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

No need to change anything here

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

No need to change anything here

No need to change anything here

Choose Cab Type

Mahjong Fight Girl has multiple cab types. HG is currently the only supported cab type.

No need to change anything here

No need to change anything here

"},{"location":"games/konami/mfg/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/mfg/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/mfg/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/mfg/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/mfg/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/mfg/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

For any issues not covered here, spice2x's Known issues page might prove useful

"},{"location":"games/konami/mfg/troubleshooting/#technical-problems","title":"Technical problems","text":"I can't select anything on screen

Make sure your cab type in spicecfg is set to HG

"},{"location":"games/konami/museca/1plushalf/setup/","title":"Game Setup","text":""},{"location":"games/konami/museca/1plushalf/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/museca/1plushalf/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 2.7 GB.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/konami/museca/1plushalf/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice64.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice64.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
Additional steps for AMD and Intel graphics cards

Since KONAMI games are designed for NVIDIA GPU's, AMD and Intel users need additional files:

  • Locate the spice2x\\stubs\\64\\ folder in the spice2x archive
  • Extract all .dll files from there into your game's modules folder
"},{"location":"games/konami/museca/1plushalf/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

Click on Bind or Naive 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, Start
  • Game buttons: Disk# Press (1 to 5), Foot Pedal
  • P1 Keypad: Keypad 0 to 9, Keypad Insert Card

Only if you play with a keyboard:

  • Disks: Disk#- (1 to 5), Disk#+ (1 to 5) (Disk#- is counter-clockwise, while Disk#+ is clockwise.)

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

This tab is used to bind analog controls like the disks

Ignore this tab if you play with a keyboard

Bind your controller's disks

With a controller, instead of binding your disks in the Buttons tab, you need to:

  • Click Bind
  • In Device, pick your controller
  • In Control, pick the control that updates the preview when turning the corresponding disk
  • Click Close, leaving the rest of the settings alone
  • Repeat for your other disks

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

No need to change anything here

"},{"location":"games/konami/museca/1plushalf/setup/#configuring-audio","title":"Configuring Audio","text":"

Check out our general Audio guide to understand audio modes better, at least the TL;DR

This game only supports WASAPI Exclusive mode. Some audio devices may not support this

  • 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, click Apply then OK
"},{"location":"games/konami/museca/1plushalf/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/museca/1plushalf/setup/#monitor-orientation","title":"Monitor Orientation","text":"

This game requires your main monitor to be set to Portait or Portait (flipped) mode

You will play in Portait mode (Recommended)
  • Right click on your Desktop
  • Select Display settings
  • Look for Display orientation and set it to Portrait or Portrait (flipped)
  • Rotate your monitor 90\u00b0
You cannot play in Portait mode

In this case, your only option is to:

  • Open spicecfg, go to the Options tab
  • Set the game to Windowed Mode (-w)
  • Set your desired Window Resolution (-windowsize) for the game
"},{"location":"games/konami/museca/1plushalf/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/museca/1plushalf/setup/#first-launch","title":"First launch","text":"

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

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.

If you're seeing this screen, it means you need to press the Test button to initialize the game's backup data.

Once the game shows BACKUP DATA: INITIALIZED, restart the game.

You're all done! The game should load up properly now

"},{"location":"games/konami/museca/1plushalf/setup/#museca-plus","title":"M\u00daSECA PLUS","text":"

Since M\u00daSECA is no longer receiving official updates, community mods like M\u00daSECA PLUS exist to enhance the game with additional content and English translations

"},{"location":"games/konami/museca/1plushalf/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/museca/1plushalf/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/museca/1plushalf/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

For any issues not covered here, spice2x's Known issues page might prove useful

"},{"location":"games/konami/museca/1plushalf/troubleshooting/#technical-problems","title":"Technical Problems","text":"I'm using a laptop with a hybrid internal+dedicated GPU setup

Laptops often have odd issues running data. The game may open on the wrong monitor, run at the wrong resolution or framerate, or simply crashes.

There is currently no known fix for this, other than maybe playing in windowed mode, or using a desktop PC instead.

"},{"location":"games/konami/museca/1plushalf/troubleshooting/#performance","title":"Performance","text":"

Check out spice2x's PC optimization guide

Game is running too slow/fast

Your game is likely running at an incorrect framerate. M\u00daSECA expects the game to run at 60 fps constantly.

Try these steps to resolve framerate issues:

  • Verify your monitor's refresh ratae is set at exactly 60 Hz.
  • Close any software that can affect framerates (like RTSS)
  • Close unnecessary background programs
  • Ensure V-SYNC is not forcefully disabled in your graphics card control panel
  • For NVIDIA users: Enable NVIDIA profile optimization (-nvprofile) in spicecfg's Options tab

If issues persist:

  • Double-check that you followed all steps in the setup guide correctly
  • Your PC hardware might be insufficient to keep a steady 60 FPS. Make sure your PC meets the requirements of this game.
  • Your data may be corrupt in one way or another, you could try starting from scratch using trusted data sources.

Your PC may not meet the specifications for M\u00daSECA. In the arcade, it runs on a Konami PC (ADE-6291):

  • CPU: AMD RX-421BD

  • GPU: Radeon R7

  • RAM: 4 GB

  • OS: Windows 7 Embedded

"},{"location":"games/konami/museca/1plushalf/troubleshooting/#audio","title":"Audio","text":"I can't hear anything else than the game!

Museca only supports WASAPI exclusive for its audio. This means the game takes exclusive control of your audio device while running, which cannot be changed.

I'm not getting any audio/My audio is completely wrecked and I'm using an external DAC!

Many external DACs do not work with WASAPI exclusive mode and therefore won't function with Museca. Usually, you'll need to use your motherboard's onboard audio or a DAC confirmed to be compatible.

"},{"location":"games/konami/museca/1plushalf/troubleshooting/#faq","title":"FAQ","text":"How to run the game in windowed borderless mode?

You'll need to use 3rd party software like Borderless Gaming in order to achieve this.

Can the game be run offline?

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/konami/nostalgia/forte/setup/","title":"Game Setup","text":""},{"location":"games/konami/nostalgia/forte/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/nostalgia/forte/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/nostalgia/forte/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/nostalgia/forte/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

Konami 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/konami/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/konami/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 60 Hz, the game is hardcoded to run at 60 Hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60 Hz. 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 60 Hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.

"},{"location":"games/konami/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/konami/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/konami/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/konami/nostalgia/op2/setup/","title":"Game Setup","text":""},{"location":"games/konami/nostalgia/op2/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/nostalgia/op2/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/nostalgia/op2/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/nostalgia/op2/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

Konami 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/konami/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/konami/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 60 Hz, the game is hardcoded to run at 60 Hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60 Hz. 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 60 Hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.

"},{"location":"games/konami/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/konami/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/konami/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/konami/popn/common/setup/","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 20 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/popn/common/setup/#updating-data","title":"Updating data","text":"

Make sure you're using the right update for your current game version

pop'n music updates have M39 and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., M39_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., M39_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/popn/common/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
"},{"location":"games/konami/popn/common/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIAdvancedOptionsDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

Click on Bind or Naive 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

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

We recommend using popnhax instead of spice2x patching

No need to change anything here

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

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

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/popn/common/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller

You're all done! The game should load up properly now

"},{"location":"games/konami/popn/common/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/popn/common/troubleshooting/","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/popn/common/troubleshooting/#my-game-doesnt-have-audio","title":"My game doesn't have audio","text":"

Enable the HDMI Audio Fix patch.

"},{"location":"games/konami/popn/kaimei_riddles/setup/","title":"Game Setup","text":""},{"location":"games/konami/popn/kaimei_riddles/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/popn/kaimei_riddles/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 20 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/popn/kaimei_riddles/setup/#updating-data","title":"Updating data","text":"

Make sure you're using the right update for your current game version

pop'n music updates have M39 and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., M39_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., M39_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/popn/kaimei_riddles/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
"},{"location":"games/konami/popn/kaimei_riddles/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIAdvancedOptionsDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

Click on Bind or Naive 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

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

We recommend using popnhax instead of spice2x patching

No need to change anything here

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

"},{"location":"games/konami/popn/kaimei_riddles/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/popn/kaimei_riddles/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller

You're all done! The game should load up properly now

"},{"location":"games/konami/popn/kaimei_riddles/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/popn/kaimei_riddles/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/popn/kaimei_riddles/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/popn/peace/setup/","title":"Game Setup","text":""},{"location":"games/konami/popn/peace/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/popn/peace/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 20 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/popn/peace/setup/#updating-data","title":"Updating data","text":"

Make sure you're using the right update for your current game version

pop'n music updates have M39 and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., M39_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., M39_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/popn/peace/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
"},{"location":"games/konami/popn/peace/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIAdvancedOptionsDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

Click on Bind or Naive 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

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

We recommend using popnhax instead of spice2x patching

No need to change anything here

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

"},{"location":"games/konami/popn/peace/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/popn/peace/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller

You're all done! The game should load up properly now

"},{"location":"games/konami/popn/peace/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/popn/peace/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/popn/peace/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/popn/peace/troubleshooting/#my-game-doesnt-have-audio","title":"My game doesn't have audio","text":"

Enable the HDMI Audio Fix patch.

"},{"location":"games/konami/popn/unilab/setup/","title":"Game Setup","text":""},{"location":"games/konami/popn/unilab/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/popn/unilab/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 20 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/popn/unilab/setup/#updating-data","title":"Updating data","text":"

Make sure you're using the right update for your current game version

pop'n music updates have M39 and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., M39_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., M39_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/popn/unilab/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
"},{"location":"games/konami/popn/unilab/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIAdvancedOptionsDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

Click on Bind or Naive 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

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

We recommend using popnhax instead of spice2x patching

No need to change anything here

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

"},{"location":"games/konami/popn/unilab/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/popn/unilab/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller

You're all done! The game should load up properly now

"},{"location":"games/konami/popn/unilab/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/popn/unilab/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/popn/unilab/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/popn/unilab/troubleshooting/#my-game-doesnt-have-audio","title":"My game doesn't have audio","text":"

Enable the HDMI Audio Fix patch.

"},{"location":"games/konami/popn/usaneko/setup/","title":"Game Setup","text":""},{"location":"games/konami/popn/usaneko/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/popn/usaneko/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 20 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/popn/usaneko/setup/#updating-data","title":"Updating data","text":"

Make sure you're using the right update for your current game version

pop'n music updates have M39 and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., M39_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., M39_OldDateCode-NewDateCode.rar)

A date code should look something like this: YYYYMMDDXX

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/popn/usaneko/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
"},{"location":"games/konami/popn/usaneko/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIAdvancedOptionsDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

Click on Bind or Naive 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

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

No need to change anything here

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

We recommend using popnhax instead of spice2x patching

No need to change anything here

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

"},{"location":"games/konami/popn/usaneko/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/popn/usaneko/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller

You're all done! The game should load up properly now

"},{"location":"games/konami/popn/usaneko/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/popn/usaneko/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/popn/usaneko/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/popn/usaneko/troubleshooting/#my-game-doesnt-have-audio","title":"My game doesn't have audio","text":"

Enable the HDMI Audio Fix patch.

"},{"location":"games/konami/reflecbeat/reflesia/setup/","title":"Game Setup","text":""},{"location":"games/konami/reflecbeat/reflesia/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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.

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!

"},{"location":"games/konami/reflecbeat/reflesia/setup/#troubleshooting","title":"Troubleshooting","text":"

Have any other errors?

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

"},{"location":"games/konami/reflecbeat/reflesia/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/reflecbeat/reflesia/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/reflecbeat/reflesia/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

Konami PC (ADE-704A)

CPU: Intel Celeron B810 1.6GHz

GPU: E4690 Radeon MXM

OS: Windows XP Embedded

"},{"location":"games/konami/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/konami/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/konami/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 60 Hz, the game is hardcoded to run at 60 Hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60 Hz. 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 60 Hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.

"},{"location":"games/konami/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/konami/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/konami/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/konami/sdvx/4_heavenlyhaven/setup/","title":"Game Setup","text":""},{"location":"games/konami/sdvx/4_heavenlyhaven/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/sdvx/4_heavenlyhaven/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/sdvx/4_heavenlyhaven/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/sdvx/4_heavenlyhaven/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

Konami PC Type 4

CPU: Celeron M 440 1.86GHz

GPU: ATI Radeon HD 2400

RAM: 2 GB

OS: Windows XP Embedded

"},{"location":"games/konami/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/konami/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 60 Hz, the game is hardcoded to run at 60 Hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60 Hz. 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 60 Hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.

"},{"location":"games/konami/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/konami/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/konami/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/konami/sdvx/5_vividwave/setup/","title":"Game Setup","text":""},{"location":"games/konami/sdvx/5_vividwave/setup/#game-setup","title":"Game Setup","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/sdvx/5_vividwave/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/sdvx/5_vividwave/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/sdvx/5_vividwave/troubleshooting/#hardware-specs","title":"Hardware Specs","text":"

Konami 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/konami/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/konami/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 60 Hz, the game is hardcoded to run at 60 Hz and this cannot be changed. To solve this, set your monitor's refresh rate to 60 Hz. 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 60 Hz, consider trying a different panel or forcing vsync on in your GPU's graphics settings.

"},{"location":"games/konami/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/konami/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/konami/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/konami/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/konami/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/konami/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/konami/sdvx/6_exceedgear/extras/","title":"Extra Information","text":""},{"location":"games/konami/sdvx/6_exceedgear/extras/#extra-information","title":"Extra Information","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/sdvx/6_exceedgear/extras/#nemsys-and-valkyrie-modes","title":"Nemsys and Valkyrie modes","text":"

Valkyrie mode requires a 120 Hz capable monitor, or to have patched your .dll with Valkyrie Mode 60 Hz

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/konami/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/konami/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/konami/sdvx/6_exceedgear/setup/","title":"Game Setup","text":""},{"location":"games/konami/sdvx/6_exceedgear/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/konami/sdvx/6_exceedgear/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 20 GB or larger. If your data is significantly smaller, you likely have an update archive instead of the full game data.

Here's what the expected data structure should look like: 

\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2ext\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

If your data is already up-to-date, you can skip ahead to the Installing spice2x section

"},{"location":"games/konami/sdvx/6_exceedgear/setup/#updating-data","title":"Updating data","text":"

For a comprehensive list of all game updates in chronological order, visit KonamiWiki

Make sure you're using the right update for your current game version

SDVX updates have KFC and one or two datecodes in their archive names.

Single datecode: Contains one update (e.g., KFC_NewDateCode.7z) Two datecodes: Updates from the older to newer version (e.g., KFC-OldDateCode-NewDateCode.rar)

In the two-datecode example:

  • OldDateCode is the older date, the game version required to apply this update
  • NewDateCode is the newer date, and is the version you'll arrive at after applying the update
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"games/konami/sdvx/6_exceedgear/setup/#installing-spice2x","title":"Installing spice2x","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice64.exe and spicecfg.exe from the archive into your game's directory
\ud83d\udcc2data\n\ud83d\udcc2dev\n\ud83d\udcc2ext\n\ud83d\udcc2modules\n\ud83d\udcc2prop\n\ud83c\udf36\ufe0fspice64.exe\n\ud83c\udf36\ufe0fspicecfg.exe\n
Additional steps for AMD and Intel graphics cards

Since KONAMI games are designed for NVIDIA GPU's, AMD and Intel users need additional files:

  • Locate the spice2x\\stubs\\64\\ folder in the spice2x archive
  • Extract all .dll files from there into your game's modules folder
"},{"location":"games/konami/sdvx/6_exceedgear/setup/#configuring-spice2x","title":"Configuring spice2x","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

ButtonsAnalogsOverlayLightsCardsPatchesAPIOptionsAdvancedDevelopment

This tab is used to bind your keyboard and controller buttons

Bind vs Naive

Bind - Use for controllers and hardware devices. More responsive and detects any HID device. Naive - Use for device agnostic keyboard binds. Less responsive but works with simulated keystrokes.

Binding your buttons

Click on Bind or Naive 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 play with a keyboard:

  • Knobs: VOL-L Left, VOL-L Right, VOL-R Left, Vol-R Right

Additional info

  • Use page navigation at the bottom to bind multiple buttons to the same input
  • Check Bind Many to bind multiple controls in sequence
  • Click Edit after binding for advanced options (invert, MIDI sensitivity, etc.)

This tab is used to bind analog controls like knobs

Ignore this tab if you play with a keyboard

Bind your controller's knobs

With a controller, instead of binding to VOL-L and VOL-R in the Buttons tab, you need to:

  • Click Bind
  • In Device, pick your controller
  • In Control, pick the control that updates the preview when turning the corresponding knob
  • Click Close, leaving the rest of the settings alone
  • Repeat for your other knob

This tab is used to bind keys to toggle spice2x and game-related overlays

Binding extra buttons here is optional, defaults are fine

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

This tab allows you to configure controller lights to sync with the game

Not all controllers support this, but it does not affect gameplay and is completely optional.

  • Click Bind
  • In Device, pick your controller
  • In Light Control, select the corresponding light
  • Click Close
  • Repeat for your other lights

This tab lets you configure which cards are used to save your game profile to

If you own a physical e-amuse/FeliCa card and a compatible NFC card reader

Setup instructions vary depending on your specific reader model.

Navigate to the Advanced tab and scroll down to the NFC Card Readers section. Browse the available options and hover over each one to view descriptions and configuration guidance.

There is no need for you to specify cards for either player in this tab when using a card reader.

If you don't, you can use a virtual card number instead

If you already have generated a card number before, you may use this one.

To generate a new card number for Player 1 or 2:

  • Click on Open...
  • Choose where to save your card number
  • Give it a file name (e.g. card0.txt)
  • Click save
  • Finally, click on Generate

This will automatically generate a valid card number for you and keep it in the file you specified.

Go through the spice2x Patching to import and pick patches

No need to change anything here

NVIDIA GPU users ONLY

Enable NVIDIA profile optimization (-nvprofile) to let spice2x create an optimized profile for your game.

No need to change anything here

No need to change anything here

"},{"location":"games/konami/sdvx/6_exceedgear/setup/#configuring-audio","title":"Configuring audio","text":"

Check out our general Audio guide to understand audio modes better, at least the TL;DR

  • 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

Then, depending follow instructions for your desired audio mode:

Setup for WASAPI Exclusive (default)
  • Check both boxes under Exclusive Mode
  • Open the Default Format dropdown
  • Pick the 16 bit, 44100 Hz (CD Quality) option, click Apply then OK
Setup for WASAPI Shared
  • Open the Default Format dropdown
  • Pick the 16 bit, 48000 Hz (DVD Quality) option, click Apply then OK
  • Return to spicecfg, go to the Patches tab
  • Following the patching guide and patch Shared Mode WASAPI

Optionally: go to the Options tab, and at the very bottom enable Low Latency Shared Audio to help mitigate the latency penalty from using Shared audio.

Setup for ASIO (requires specialized hardware)
  • Check both boxes under Exclusive Mode
  • Open the Default Format dropdown
  • Pick the 16 bit, 44100 Hz (CD Quality) option, click Apply then OK
"},{"location":"games/konami/sdvx/6_exceedgear/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"games/konami/sdvx/6_exceedgear/setup/#configuring-your-game","title":"Configuring your game","text":"

Read through the Extra Information page

"},{"location":"games/konami/sdvx/6_exceedgear/setup/#monitor-orientation","title":"Monitor Orientation","text":"

This game requires your main monitor to be set to Portait or Portait (flipped) mode

You will play in Portait mode (Recommended)
  • Right click on your Desktop
  • Select Display settings
  • Look for Display orientation and set it to Portrait or Portrait (flipped)
  • Rotate your monitor 90\u00b0
You cannot play in Portait mode

In this case, your only option is to:

  • Open spicecfg, go to the Options tab
  • Set the game to Windowed Mode (-w)
  • Set your desired Window Resolution (-windowsize) for the game
"},{"location":"games/konami/sdvx/6_exceedgear/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/konami/sdvx/6_exceedgear/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/konami/sdvx/6_exceedgear/setup/#first-launch","title":"First launch","text":"

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

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.

If you're seeing this screen, it means you need to calibrate your knobs.

Press your Test key to go to the service menu.

Instructions on how to navigate the menu are shown at the bottom of the screen:

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

  • Slowly turn your LEFT knob counterclockwise (VOL-L Left) until the line says COUNT = OK then press Start.
  • Slowly turn your LEFT knob clockwise (VOL-L Right) until the line says COUNT = OK then press Start.

Now same thing but for the right knob (VOL-R for keyboard players)

  • Slowly turn your RIGHT knob counterclockwise (VOL-R Left) until the line says COUNT = OK then press Start.
  • Slowly turn your RIGHT knob clockwise (VOL-R Right) until the line says COUNT = OK then 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/konami/sdvx/6_exceedgear/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/konami/sdvx/6_exceedgear/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/konami/sdvx/6_exceedgear/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

For any issues not covered here, spice2x's Known issues page might prove useful

"},{"location":"games/konami/sdvx/6_exceedgear/troubleshooting/#technical-problems","title":"Technical problems","text":""},{"location":"games/konami/sdvx/6_exceedgear/troubleshooting/#crashes","title":"Crashes","text":"

Riva Tuner Statistics Server (RTSS) and MSI Afterburner are known to cause odd crashes.If you have them installed, close them both before starting any arcade game

W:BM2D: CreateLayer() \u6307\u5b9a\u3057\u305f\u30ec\u30a4\u30e4\u30fc\u306f\u5b58\u5728\u3057\u307e\u305b\u3093 then EXCEPTION_ACCESS_VIOLATION in logs

  • Open log.txt using an editor that supports SHIFT-JIS encoding for Japanese text (like Notepad++)

  • Look for this error message: W:BM2D: CreateLayer() \u6307\u5b9a\u3057\u305f\u30ec\u30a4\u30e4\u30fc\u306f\u5b58\u5728\u3057\u307e\u305b\u3093 touch_effect Note: While touch_effect is common, the missing resource name may vary

If you find it, and it's followed by: W:signal: exception raised: EXCEPTION_ACCESS_VIOLATION

Then there's a problem with your game data.

  • Make sure there are no DLL files next to the main game directories (data, prop, etc.) If there are, move them all under the modules directory

For game version 2024-11-05 and newer, check the following files in your modules directory:

  • afp-core.dll should be 1,015 KB
  • afp-utils.dll should be 179 KB

If the sizes don't match:

  • Redownload 2024110500 and newer updates
  • Re-apply all updates in chronological order, always copying all DLL files to the modules directory

If the issue isn't resolved by now, we recommend performing a fresh installation using trusted data sources.

W:SuperstepSound: Audio device is not available!!! in logs

  • Open log.txt using an editor that supports SHIFT-JIS encoding for Japanese text (like Notepad++)

  • Search for Superstep

If you find a line with Audio device is not available!!!, it means the game refuses to boot due to a misconfigured or missing audio device. Check the setup guide's Configuring audio section as well as our general Audio guide to understand the issue better.

I'm using a laptop with a hybrid internal+dedicated GPU setup

Laptops often have odd issues running data. The game may open on the wrong monitor, run at the wrong resolution or framerate, or simply crashes.

There is currently no known fix for this, other than maybe playing in windowed mode, or using a desktop PC instead.

"},{"location":"games/konami/sdvx/6_exceedgear/troubleshooting/#performance","title":"Performance","text":"

Check out spice2x's PC optimization guide

Game is running too slow/fast

Your game is likely running at an incorrect framerate. The expected framerates are:

  • Nemsys mode: 60 FPS
  • Valkyrie mode: 120 FPS

Try these steps to resolve framerate issues:

  • Close any software that can affect framerates (like RTSS)
  • Close unnecessary background programs
  • Ensure V-SYNC is not forcefully disabled in your graphics card control panel
  • For NVIDIA users: Enable NVIDIA profile optimization (-nvprofile) in spicecfg's Options tab

If issues persist:

  • Double-check that you followed all steps in the setup guide correctly
  • Your PC hardware might be insufficient to keep a steady 120 FPS, you can try to either:
    • Patch the game with Valkyrie Mode 60 Hz to stick in Valkyrie mode but run at 60 FPS
    • Switch to Nemsys mode
  • Your data may be corrupt in one way or another, you could try starting from scratch using trusted data sources.
"},{"location":"games/konami/sdvx/6_exceedgear/troubleshooting/#audio","title":"Audio","text":"

Check out our Audio guide to understand audio modes better

Ensure your default audio device's sample rate is set properly

  • 44100 Hz sample rate for WASAPI Exclusive and ASIO
  • 48000 Hz if your game is patched with Shared Mode WASAPI
I can't change my device's sample rate

If you're using gaming peripherals (Logitech/Razer/Steelseries) or external audio devices (audio interfaces/sound bars):

  • Check if you can modify the sample rate in the device's software/control panel
  • If not, try uninstalling the device's software. This may restore control over Windows audio settings

If you still can't change the sample rate:

  • Configure the game's audio mode to match your device's current sample rate instead
  • Try using a different audio device
I can't hear anything else than the game

Your game's audio is setup to run in WASAPI Exclusive or ASIO modes.

Check out our Audio guide to understand audio modes better.

If you're using WASAPI Exclusive, you'll want to patch the game with Shared Mode WASAPI to hear other applications.

If you're using ASIO, unless your audio interface mixes WASAPI and ASIO streams when outputting, you'll only be able to hear one application when ASIO is in use. In this case, you'll need to route all audio through software such as Voicemeeter, and have Voicemeeter output the mix to your ASIO device.

Game audio is too quiet/loud
  • Make sure to not be in a credit as your current progress will be lost
  • Bind and press your Test key to enter the Test menu
  • Go to SOUND OPTIONS and change the volume at will
  • SAVE AND EXIT > GAME MODE to return to the game
"},{"location":"games/konami/sdvx/6_exceedgear/troubleshooting/#subscreen","title":"Subscreen","text":"

For more in-depth troubleshooting, refer to the spice2x Subscreen troubleshooting page

Touch input isn't being registered

If you're using a physical touch screen, make sure to close all spice2x overlays, including the FPS counter. If you're using the virtual subscreen, ensure that the -sdvxnativetouch option is not enabled.

"},{"location":"games/konami/sdvx/6_exceedgear/troubleshooting/#faq","title":"FAQ","text":"How to run the game in windowed borderless mode?

You'll need to use 3rd party software like Borderless Gaming in order to achieve this.

Where are all the navigators? Why am I missing songs?

A lot of content is locked behind events and will not show up unless connected to a network that has written support for these events.

It may also be that the content is only available in specific regions like Japan and your game is configured with another region.

You can fix this by patching Fake Region to Japan (J).

"},{"location":"games/namco/taikonijiiro/setup/","title":"Game Setup","text":""},{"location":"games/namco/taikonijiiro/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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 120 Hz.
  • 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

!!! danger \"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
  • 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":"Troubleshooting","text":""},{"location":"games/namco/taikonijiiro/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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 120 Hz or higher
  • Set your display to 120 Hz. You may need to make a custom resolution.
  • In config.toml set vsync = to true.
If you have a display that is less than 120 Hz
  • In config.toml set vsync = to false and windowed = to true.
  • Alternatively you can use RTSS.
"},{"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:

  • Inside config.toml, set wasapi_shared = to false and set asio = to true.
  • Change asio_driver = to asio_driver = \"<Your ASIO Driver Name>\"

For more information refer to the general Audio guide.

"},{"location":"games/sega/chunithm/air/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/chunithm/air/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/air/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/air/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/air/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/air/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/air/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with an IO DLL to add support for controllers.

The controller you plan on using should also be provided with an IO DLL. 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.

To add your IO DLL, ncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; To use a custom Chunithm IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/air/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/air/controllers/#tasoller","title":"TASOLLER","text":"
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download the TASOLLER IO DLL corrosponding to your firmware version and extract to your App\\bin folder.
    • chuniio-rs (download chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_v2.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/air/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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_plus.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/air/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 chuni 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]\npath=chuniio_yubideck_v3.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/air/controllers/#laverita-3","title":"Laverita 3","text":"
  • 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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_laverita_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/air/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/air/setup/","title":"Game Setup","text":""},{"location":"games/sega/chunithm/air/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/air/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2startup\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0foxGetHwInfo.exe\n\ud83d\udcddoxGetHwInfo.ini\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/air/setup/#updating-data","title":"Updating data","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/air/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/air/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/air/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

Patch Recommendation Description Disable shop close lockout Either Disables the shop lockout from 12 to 8PM JST. 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."},{"location":"games/sega/chunithm/air/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chuni.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchunihook.dll\n\u25b6\ufe0finject.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/air/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/air/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][gfx]

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/air/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"games/sega/chunithm/air/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/air/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/air/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth option).

Select \u914d\u4fe1\u30b5\u30fc\u30d0\u30fc\u8a2d\u5b9a (DISTRIBUTION SEVER SETTING, the first option) and toggle this setting to \u30b5\u30fc\u30d0\u30fc (SERVER).

Select \u7b50\u4f53\u30b0\u30eb\u30fc\u30d7\u8a2d\u5b9a (CABINET GROUP SETTINGS, the second option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

Select \u306f\u3044 (YES) and select \u9589\u3058\u308b

After this, your game will close. Open it back up, and enter the service menu again.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/air/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/air/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/air/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/chunithm/air/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/air/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.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/air/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chuniApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/air/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/air/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/air/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/airplus/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/chunithm/airplus/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/airplus/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/airplus/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/airplus/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/airplus/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/airplus/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with an IO DLL to add support for controllers.

The controller you plan on using should also be provided with an IO DLL. 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.

To add your IO DLL, ncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; To use a custom Chunithm IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/airplus/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/airplus/controllers/#tasoller","title":"TASOLLER","text":"
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download the TASOLLER IO DLL corrosponding to your firmware version and extract to your App\\bin folder.
    • chuniio-rs (download chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_v2.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/airplus/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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_plus.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/airplus/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 chuni 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]\npath=chuniio_yubideck_v3.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/airplus/controllers/#laverita-3","title":"Laverita 3","text":"
  • 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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_laverita_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/airplus/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/airplus/setup/","title":"Game Setup","text":""},{"location":"games/sega/chunithm/airplus/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/airplus/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2startup\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0foxGetHwInfo.exe\n\ud83d\udcddoxGetHwInfo.ini\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/airplus/setup/#updating-data","title":"Updating data","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/airplus/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/airplus/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/airplus/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

Patch Recommendation Description Disable shop close lockout Either Disables the shop lockout from 12 to 8PM JST. 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."},{"location":"games/sega/chunithm/airplus/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chuni.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchunihook.dll\n\u25b6\ufe0finject.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/airplus/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/airplus/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][gfx]

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/airplus/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"games/sega/chunithm/airplus/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/airplus/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/airplus/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth option).

Select \u914d\u4fe1\u30b5\u30fc\u30d0\u30fc\u8a2d\u5b9a (DISTRIBUTION SEVER SETTING, the first option) and toggle this setting to \u30b5\u30fc\u30d0\u30fc (SERVER).

Select \u7b50\u4f53\u30b0\u30eb\u30fc\u30d7\u8a2d\u5b9a (CABINET GROUP SETTINGS, the second option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

Select \u306f\u3044 (YES) and select \u9589\u3058\u308b

After this, your game will close. Open it back up, and enter the service menu again.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/airplus/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/airplus/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/airplus/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/chunithm/airplus/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/airplus/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.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/airplus/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chuniApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/airplus/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/airplus/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/airplus/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/amazon/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/chunithm/amazon/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/amazon/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/amazon/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/amazon/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/amazon/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/amazon/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with an IO DLL to add support for controllers.

The controller you plan on using should also be provided with an IO DLL. 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.

To add your IO DLL, ncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; To use a custom Chunithm IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/amazon/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/amazon/controllers/#tasoller","title":"TASOLLER","text":"
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download the TASOLLER IO DLL corrosponding to your firmware version and extract to your App\\bin folder.
    • chuniio-rs (download chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_v2.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/amazon/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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_plus.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/amazon/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 chuni 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]\npath=chuniio_yubideck_v3.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/amazon/controllers/#laverita-3","title":"Laverita 3","text":"
  • 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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_laverita_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/amazon/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/amazon/setup/","title":"Game Setup","text":""},{"location":"games/sega/chunithm/amazon/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/amazon/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2startup\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0foxGetHwInfo.exe\n\ud83d\udcddoxGetHwInfo.ini\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/amazon/setup/#updating-data","title":"Updating data","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/amazon/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/amazon/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/amazon/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

Patch Recommendation Description Disable shop close lockout Either Disables the shop lockout from 12 to 8PM JST. 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."},{"location":"games/sega/chunithm/amazon/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chuni.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchunihook.dll\n\u25b6\ufe0finject.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/amazon/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/amazon/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][gfx]

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/amazon/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"games/sega/chunithm/amazon/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/amazon/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/amazon/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth option).

Select \u914d\u4fe1\u30b5\u30fc\u30d0\u30fc\u8a2d\u5b9a (DISTRIBUTION SEVER SETTING, the first option) and toggle this setting to \u30b5\u30fc\u30d0\u30fc (SERVER).

Select \u7b50\u4f53\u30b0\u30eb\u30fc\u30d7\u8a2d\u5b9a (CABINET GROUP SETTINGS, the second option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

Select \u306f\u3044 (YES) and select \u9589\u3058\u308b

After this, your game will close. Open it back up, and enter the service menu again.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/amazon/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/amazon/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/amazon/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/chunithm/amazon/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/amazon/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.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/amazon/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chuniApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/amazon/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/amazon/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/amazon/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/amazonplus/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/chunithm/amazonplus/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/amazonplus/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/amazonplus/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/amazonplus/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/amazonplus/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/amazonplus/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with an IO DLL to add support for controllers.

The controller you plan on using should also be provided with an IO DLL. 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.

To add your IO DLL, ncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; To use a custom Chunithm IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/amazonplus/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/amazonplus/controllers/#tasoller","title":"TASOLLER","text":"
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download the TASOLLER IO DLL corrosponding to your firmware version and extract to your App\\bin folder.
    • chuniio-rs (download chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_v2.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/amazonplus/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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_plus.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/amazonplus/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 chuni 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]\npath=chuniio_yubideck_v3.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/amazonplus/controllers/#laverita-3","title":"Laverita 3","text":"
  • 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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_laverita_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/amazonplus/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/amazonplus/setup/","title":"Game Setup","text":""},{"location":"games/sega/chunithm/amazonplus/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/amazonplus/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2startup\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0foxGetHwInfo.exe\n\ud83d\udcddoxGetHwInfo.ini\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/amazonplus/setup/#updating-data","title":"Updating data","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/amazonplus/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/amazonplus/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/amazonplus/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

Patch Recommendation Description Disable shop close lockout Either Disables the shop lockout from 12 to 8PM JST. 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."},{"location":"games/sega/chunithm/amazonplus/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chuni.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchunihook.dll\n\u25b6\ufe0finject.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/amazonplus/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/amazonplus/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][gfx]

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/amazonplus/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"games/sega/chunithm/amazonplus/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/amazonplus/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/amazonplus/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth option).

Select \u914d\u4fe1\u30b5\u30fc\u30d0\u30fc\u8a2d\u5b9a (DISTRIBUTION SEVER SETTING, the first option) and toggle this setting to \u30b5\u30fc\u30d0\u30fc (SERVER).

Select \u7b50\u4f53\u30b0\u30eb\u30fc\u30d7\u8a2d\u5b9a (CABINET GROUP SETTINGS, the second option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

Select \u306f\u3044 (YES) and select \u9589\u3058\u308b

After this, your game will close. Open it back up, and enter the service menu again.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/amazonplus/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/amazonplus/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/amazonplus/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/chunithm/amazonplus/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/amazonplus/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.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/amazonplus/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chuniApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/amazonplus/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/amazonplus/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/amazonplus/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/chunithm/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/chunithm/chunithm/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/chunithm/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/chunithm/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/chunithm/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/chunithm/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/chunithm/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with an IO DLL to add support for controllers.

The controller you plan on using should also be provided with an IO DLL. 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.

To add your IO DLL, ncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; To use a custom Chunithm IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/chunithm/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/chunithm/controllers/#tasoller","title":"TASOLLER","text":"
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download the TASOLLER IO DLL corrosponding to your firmware version and extract to your App\\bin folder.
    • chuniio-rs (download chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_v2.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/chunithm/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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_plus.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/chunithm/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 chuni 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]\npath=chuniio_yubideck_v3.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/chunithm/controllers/#laverita-3","title":"Laverita 3","text":"
  • 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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_laverita_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/chunithm/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/chunithm/setup/","title":"Game Setup","text":"

Warning

This guide is for the original version of CHUNITHM released in 2015. If you want to run a newer version, please find and follow the right guide.

"},{"location":"games/sega/chunithm/chunithm/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/chunithm/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2startup\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0foxGetHwInfo.exe\n\ud83d\udcddoxGetHwInfo.ini\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/chunithm/setup/#updating-data","title":"Updating data","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/chunithm/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/chunithm/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/chunithm/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

Patch Recommendation Description Disable shop close lockout Either Disables the shop lockout from 12 to 8PM JST. 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."},{"location":"games/sega/chunithm/chunithm/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chuni.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchunihook.dll\n\u25b6\ufe0finject.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/chunithm/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/chunithm/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][gfx]

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/chunithm/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"games/sega/chunithm/chunithm/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/chunithm/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/chunithm/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth option).

Select \u914d\u4fe1\u30b5\u30fc\u30d0\u30fc\u8a2d\u5b9a (DISTRIBUTION SEVER SETTING, the first option) and toggle this setting to \u30b5\u30fc\u30d0\u30fc (SERVER).

Select \u7b50\u4f53\u30b0\u30eb\u30fc\u30d7\u8a2d\u5b9a (CABINET GROUP SETTINGS, the second option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

Select \u306f\u3044 (YES) and select \u9589\u3058\u308b

After this, your game will close. Open it back up, and enter the service menu again.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/chunithm/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/chunithm/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/chunithm/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/chunithm/chunithm/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/chunithm/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.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/chunithm/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chuniApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/chunithm/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/chunithm/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/chunithm/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/common/chuni/c2c/","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/common/chuni/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/chuni/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/chuni/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/common/chuni/controllers/","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with an IO DLL to add support for controllers.

The controller you plan on using should also be provided with an IO DLL. 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.

To add your IO DLL, ncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; To use a custom Chunithm IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/common/chuni/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/chuni/controllers/#tasoller","title":"TASOLLER","text":"
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download the TASOLLER IO DLL corrosponding to your firmware version and extract to your App\\bin folder.
    • chuniio-rs (download chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_v2.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/common/chuni/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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_plus.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/common/chuni/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 chuni 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]\npath=chuniio_yubideck_v3.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/common/chuni/controllers/#laverita-3","title":"Laverita 3","text":"
  • 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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_laverita_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/common/chuni/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/chuni/setup/","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/common/chuni/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2startup\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0foxGetHwInfo.exe\n\ud83d\udcddoxGetHwInfo.ini\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/common/chuni/setup/#updating-data","title":"Updating data","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/chuni/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/common/chuni/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 chuniApp.exe and aimeReaderHost.exe for your game version.

  • Copy chuniApp.exe and aimeReaderHost.exe to data's App\\bin folder
  • Agree to overwrite when asked
"},{"location":"games/sega/chunithm/common/chuni/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/chuni/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

Patch Recommendation Description Disable shop close lockout Either Disables the shop lockout from 12 to 8PM JST. 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."},{"location":"games/sega/chunithm/common/chuni/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chuni.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchunihook.dll\n\u25b6\ufe0finject.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/common/chuni/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][gfx] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/common/chuni/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/chuni/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"games/sega/chunithm/common/chuni/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/common/chuni/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/common/chuni/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth option).

Select \u914d\u4fe1\u30b5\u30fc\u30d0\u30fc\u8a2d\u5b9a (DISTRIBUTION SEVER SETTING, the first option) and toggle this setting to \u30b5\u30fc\u30d0\u30fc (SERVER).

Select \u7b50\u4f53\u30b0\u30eb\u30fc\u30d7\u8a2d\u5b9a (CABINET GROUP SETTINGS, the second option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

Select \u306f\u3044 (YES) and select \u9589\u3058\u308b

After this, your game will close. Open it back up, and enter the service menu again.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/chuni/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/common/chuni/setup_belowcrystal/","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/common/chuni/setup_belowcrystal/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2startup\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0foxGetHwInfo.exe\n\ud83d\udcddoxGetHwInfo.ini\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/common/chuni/setup_belowcrystal/#updating-data","title":"Updating data","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/chuni/setup_belowcrystal/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/common/chuni/setup_belowcrystal/#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/chuni/setup_belowcrystal/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

Patch Recommendation Description Disable shop close lockout Either Disables the shop lockout from 12 to 8PM JST. 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."},{"location":"games/sega/chunithm/common/chuni/setup_belowcrystal/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chuni.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchunihook.dll\n\u25b6\ufe0finject.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/common/chuni/setup_belowcrystal/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/chuni/setup_belowcrystal/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][gfx]

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/common/chuni/setup_belowcrystal/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"games/sega/chunithm/common/chuni/setup_belowcrystal/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/common/chuni/setup_belowcrystal/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/common/chuni/setup_belowcrystal/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth option).

Select \u914d\u4fe1\u30b5\u30fc\u30d0\u30fc\u8a2d\u5b9a (DISTRIBUTION SEVER SETTING, the first option) and toggle this setting to \u30b5\u30fc\u30d0\u30fc (SERVER).

Select \u7b50\u4f53\u30b0\u30eb\u30fc\u30d7\u8a2d\u5b9a (CABINET GROUP SETTINGS, the second option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

Select \u306f\u3044 (YES) and select \u9589\u3058\u308b

After this, your game will close. Open it back up, and enter the service menu again.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/chuni/setup_belowcrystal/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/common/chuni/troubleshooting/","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/chunithm/common/chuni/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/chuni/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.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/common/chuni/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chuniApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/common/chuni/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/chuni/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/chuni/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/common/chusan/c2c/","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/common/chusan/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/common/chusan/controllers/","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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\\launch.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 launch.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\\launch.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 mode 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":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/common/chusan/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2license\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/common/chusan/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"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 data's App\\bin folder
  • 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

Avoid patching anything you don't need or understand unless explicitly told to

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 120 Hz monitor check Either Disable checking if the monitor is exactly 120 Hz when enabling 120FPS. Enable if you cannot set your monitor to 120 Hz."},{"location":"games/sega/chunithm/common/chusan/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chusan.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchusanhook_x64.dll\n\u2699\ufe0fchusanhook_x86.dll\n\ud83d\udcc4config_hook.json\n\u25b6\ufe0finject_x64.exe\n\u25b6\ufe0finject_x86.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/common/chusan/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][system][gfx] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

  • If you have a 120 Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60 Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/common/chusan/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/common/chusan/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/common/chusan/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/common/chusan/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth 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.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/common/chusan/troubleshooting/","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60 Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120 Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120 Hz, apply the \"Bypass 120 Hz 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\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 60 Hz or 120 Hz.

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/crystal/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/chunithm/crystal/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/crystal/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/crystal/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/crystal/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/crystal/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/crystal/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with an IO DLL to add support for controllers.

The controller you plan on using should also be provided with an IO DLL. 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.

To add your IO DLL, ncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; To use a custom Chunithm IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/crystal/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/crystal/controllers/#tasoller","title":"TASOLLER","text":"
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download the TASOLLER IO DLL corrosponding to your firmware version and extract to your App\\bin folder.
    • chuniio-rs (download chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_v2.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/crystal/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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_plus.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/crystal/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 chuni 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]\npath=chuniio_yubideck_v3.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/crystal/controllers/#laverita-3","title":"Laverita 3","text":"
  • 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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_laverita_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/crystal/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/crystal/setup/","title":"Game Setup","text":""},{"location":"games/sega/chunithm/crystal/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/crystal/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2startup\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0foxGetHwInfo.exe\n\ud83d\udcddoxGetHwInfo.ini\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/crystal/setup/#updating-data","title":"Updating data","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/crystal/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/crystal/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/crystal/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

Patch Recommendation Description Disable shop close lockout Either Disables the shop lockout from 12 to 8PM JST. 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."},{"location":"games/sega/chunithm/crystal/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chuni.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchunihook.dll\n\u25b6\ufe0finject.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/crystal/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/crystal/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][gfx]

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/crystal/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"games/sega/chunithm/crystal/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/crystal/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/crystal/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth option).

Select \u914d\u4fe1\u30b5\u30fc\u30d0\u30fc\u8a2d\u5b9a (DISTRIBUTION SEVER SETTING, the first option) and toggle this setting to \u30b5\u30fc\u30d0\u30fc (SERVER).

Select \u7b50\u4f53\u30b0\u30eb\u30fc\u30d7\u8a2d\u5b9a (CABINET GROUP SETTINGS, the second option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

Select \u306f\u3044 (YES) and select \u9589\u3058\u308b

After this, your game will close. Open it back up, and enter the service menu again.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/crystal/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/crystal/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/crystal/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/chunithm/crystal/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/crystal/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.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/crystal/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chuniApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/crystal/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/crystal/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/crystal/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/crystalplus/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/chunithm/crystalplus/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/crystalplus/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/crystalplus/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/crystalplus/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/crystalplus/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/crystalplus/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with an IO DLL to add support for controllers.

The controller you plan on using should also be provided with an IO DLL. 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.

To add your IO DLL, ncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; To use a custom Chunithm IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/crystalplus/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/crystalplus/controllers/#tasoller","title":"TASOLLER","text":"
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download the TASOLLER IO DLL corrosponding to your firmware version and extract to your App\\bin folder.
    • chuniio-rs (download chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_v2.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/crystalplus/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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_plus.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/crystalplus/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 chuni 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]\npath=chuniio_yubideck_v3.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/crystalplus/controllers/#laverita-3","title":"Laverita 3","text":"
  • 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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_laverita_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/crystalplus/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/crystalplus/setup/","title":"Game Setup","text":""},{"location":"games/sega/chunithm/crystalplus/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/crystalplus/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2startup\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0foxGetHwInfo.exe\n\ud83d\udcddoxGetHwInfo.ini\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/crystalplus/setup/#updating-data","title":"Updating data","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/crystalplus/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/crystalplus/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 chuniApp.exe and aimeReaderHost.exe for your game version.

  • Copy chuniApp.exe and aimeReaderHost.exe to data's App\\bin folder
  • Agree to overwrite when asked
"},{"location":"games/sega/chunithm/crystalplus/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/crystalplus/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

Patch Recommendation Description Disable shop close lockout Either Disables the shop lockout from 12 to 8PM JST. 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."},{"location":"games/sega/chunithm/crystalplus/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chuni.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchunihook.dll\n\u25b6\ufe0finject.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/crystalplus/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][gfx] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/crystalplus/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/crystalplus/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"games/sega/chunithm/crystalplus/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/crystalplus/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/crystalplus/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth option).

Select \u914d\u4fe1\u30b5\u30fc\u30d0\u30fc\u8a2d\u5b9a (DISTRIBUTION SEVER SETTING, the first option) and toggle this setting to \u30b5\u30fc\u30d0\u30fc (SERVER).

Select \u7b50\u4f53\u30b0\u30eb\u30fc\u30d7\u8a2d\u5b9a (CABINET GROUP SETTINGS, the second option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

Select \u306f\u3044 (YES) and select \u9589\u3058\u308b

After this, your game will close. Open it back up, and enter the service menu again.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/crystalplus/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/crystalplus/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/crystalplus/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/chunithm/crystalplus/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/crystalplus/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.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/crystalplus/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chuniApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/crystalplus/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/crystalplus/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/crystalplus/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","text":""},{"location":"games/sega/chunithm/luminous/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/luminous/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/luminous/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/luminous/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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\\launch.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 launch.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\\launch.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 mode 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","text":""},{"location":"games/sega/chunithm/luminous/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/luminous/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2license\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/luminous/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"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 data's App\\bin folder
  • 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

Avoid patching anything you don't need or understand unless explicitly told to

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 120 Hz monitor check Either Disable checking if the monitor is exactly 120 Hz when enabling 120FPS. Enable if you cannot set your monitor to 120 Hz."},{"location":"games/sega/chunithm/luminous/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chusan.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchusanhook_x64.dll\n\u2699\ufe0fchusanhook_x86.dll\n\ud83d\udcc4config_hook.json\n\u25b6\ufe0finject_x64.exe\n\u25b6\ufe0finject_x86.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/luminous/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][system][gfx] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

  • If you have a 120 Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60 Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/luminous/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/luminous/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/luminous/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/luminous/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth 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.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/luminous/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/luminous/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60 Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120 Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120 Hz, apply the \"Bypass 120 Hz 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\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 60 Hz or 120 Hz.

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","text":""},{"location":"games/sega/chunithm/luminousplus/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/luminousplus/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/luminousplus/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/luminousplus/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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\\launch.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 launch.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\\launch.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 mode 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","text":""},{"location":"games/sega/chunithm/luminousplus/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/luminousplus/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2license\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/luminousplus/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"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 data's App\\bin folder
  • 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

Avoid patching anything you don't need or understand unless explicitly told to

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 120 Hz monitor check Either Disable checking if the monitor is exactly 120 Hz when enabling 120FPS. Enable if you cannot set your monitor to 120 Hz."},{"location":"games/sega/chunithm/luminousplus/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chusan.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchusanhook_x64.dll\n\u2699\ufe0fchusanhook_x86.dll\n\ud83d\udcc4config_hook.json\n\u25b6\ufe0finject_x64.exe\n\u25b6\ufe0finject_x86.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/luminousplus/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][system][gfx] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

  • If you have a 120 Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60 Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/luminousplus/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/luminousplus/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/luminousplus/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/luminousplus/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth 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.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/luminousplus/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/luminousplus/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60 Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120 Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120 Hz, apply the \"Bypass 120 Hz 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\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 60 Hz or 120 Hz.

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","text":""},{"location":"games/sega/chunithm/new/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/new/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/new/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/new/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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\\launch.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 launch.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\\launch.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 mode 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","text":""},{"location":"games/sega/chunithm/new/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/new/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2license\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/new/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"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 data's App\\bin folder
  • 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

Avoid patching anything you don't need or understand unless explicitly told to

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 120 Hz monitor check Either Disable checking if the monitor is exactly 120 Hz when enabling 120FPS. Enable if you cannot set your monitor to 120 Hz."},{"location":"games/sega/chunithm/new/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chusan.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchusanhook_x64.dll\n\u2699\ufe0fchusanhook_x86.dll\n\ud83d\udcc4config_hook.json\n\u25b6\ufe0finject_x64.exe\n\u25b6\ufe0finject_x86.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/new/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][system][gfx] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

  • If you have a 120 Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60 Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/new/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/new/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/new/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/new/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth 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.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/new/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/new/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60 Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120 Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120 Hz, apply the \"Bypass 120 Hz 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\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 60 Hz or 120 Hz.

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","text":""},{"location":"games/sega/chunithm/newplus/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/newplus/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/newplus/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/newplus/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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\\launch.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 launch.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\\launch.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 mode 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","text":""},{"location":"games/sega/chunithm/newplus/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/newplus/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2license\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/newplus/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"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 data's App\\bin folder
  • 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

Avoid patching anything you don't need or understand unless explicitly told to

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 120 Hz monitor check Either Disable checking if the monitor is exactly 120 Hz when enabling 120FPS. Enable if you cannot set your monitor to 120 Hz."},{"location":"games/sega/chunithm/newplus/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chusan.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchusanhook_x64.dll\n\u2699\ufe0fchusanhook_x86.dll\n\ud83d\udcc4config_hook.json\n\u25b6\ufe0finject_x64.exe\n\u25b6\ufe0finject_x86.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/newplus/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][system][gfx] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

  • If you have a 120 Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60 Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/newplus/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/newplus/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/newplus/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/newplus/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth 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.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/newplus/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/newplus/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60 Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120 Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120 Hz, apply the \"Bypass 120 Hz 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\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 60 Hz or 120 Hz.

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/paradise/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/chunithm/paradise/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/paradise/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/paradise/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/paradise/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/paradise/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/paradise/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with an IO DLL to add support for controllers.

The controller you plan on using should also be provided with an IO DLL. 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.

To add your IO DLL, ncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; To use a custom Chunithm IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/paradise/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/paradise/controllers/#tasoller","title":"TASOLLER","text":"
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download the TASOLLER IO DLL corrosponding to your firmware version and extract to your App\\bin folder.
    • chuniio-rs (download chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_v2.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/paradise/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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_plus.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/paradise/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 chuni 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]\npath=chuniio_yubideck_v3.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/paradise/controllers/#laverita-3","title":"Laverita 3","text":"
  • 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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_laverita_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/paradise/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/paradise/setup/","title":"Game Setup","text":""},{"location":"games/sega/chunithm/paradise/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/paradise/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2startup\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0foxGetHwInfo.exe\n\ud83d\udcddoxGetHwInfo.ini\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/paradise/setup/#updating-data","title":"Updating data","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/paradise/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/paradise/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 chuniApp.exe and aimeReaderHost.exe for your game version.

  • Copy chuniApp.exe and aimeReaderHost.exe to data's App\\bin folder
  • Agree to overwrite when asked
"},{"location":"games/sega/chunithm/paradise/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/paradise/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

Patch Recommendation Description Disable shop close lockout Either Disables the shop lockout from 12 to 8PM JST. 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."},{"location":"games/sega/chunithm/paradise/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chuni.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchunihook.dll\n\u25b6\ufe0finject.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/paradise/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][gfx] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/paradise/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/paradise/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"games/sega/chunithm/paradise/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/paradise/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/paradise/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth option).

Select \u914d\u4fe1\u30b5\u30fc\u30d0\u30fc\u8a2d\u5b9a (DISTRIBUTION SEVER SETTING, the first option) and toggle this setting to \u30b5\u30fc\u30d0\u30fc (SERVER).

Select \u7b50\u4f53\u30b0\u30eb\u30fc\u30d7\u8a2d\u5b9a (CABINET GROUP SETTINGS, the second option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

Select \u306f\u3044 (YES) and select \u9589\u3058\u308b

After this, your game will close. Open it back up, and enter the service menu again.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/paradise/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/paradise/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/paradise/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/chunithm/paradise/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/paradise/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.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/paradise/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chuniApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/paradise/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/paradise/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/paradise/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/paradiselost/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/chunithm/paradiselost/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/paradiselost/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/paradiselost/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/paradiselost/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/paradiselost/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/paradiselost/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with an IO DLL to add support for controllers.

The controller you plan on using should also be provided with an IO DLL. 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.

To add your IO DLL, ncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; To use a custom Chunithm IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/paradiselost/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/paradiselost/controllers/#tasoller","title":"TASOLLER","text":"
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download the TASOLLER IO DLL corrosponding to your firmware version and extract to your App\\bin folder.
    • chuniio-rs (download chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_v2.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/paradiselost/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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_plus.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/paradiselost/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 chuni 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]\npath=chuniio_yubideck_v3.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/paradiselost/controllers/#laverita-3","title":"Laverita 3","text":"
  • 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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_laverita_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/paradiselost/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/paradiselost/setup/","title":"Game Setup","text":""},{"location":"games/sega/chunithm/paradiselost/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/paradiselost/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2startup\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0foxGetHwInfo.exe\n\ud83d\udcddoxGetHwInfo.ini\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/paradiselost/setup/#updating-data","title":"Updating data","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/paradiselost/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/paradiselost/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 chuniApp.exe and aimeReaderHost.exe for your game version.

  • Copy chuniApp.exe and aimeReaderHost.exe to data's App\\bin folder
  • Agree to overwrite when asked
"},{"location":"games/sega/chunithm/paradiselost/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/paradiselost/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

Patch Recommendation Description Disable shop close lockout Either Disables the shop lockout from 12 to 8PM JST. 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."},{"location":"games/sega/chunithm/paradiselost/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chuni.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchunihook.dll\n\u25b6\ufe0finject.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/paradiselost/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][gfx] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/paradiselost/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/paradiselost/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"games/sega/chunithm/paradiselost/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/paradiselost/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/paradiselost/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth option).

Select \u914d\u4fe1\u30b5\u30fc\u30d0\u30fc\u8a2d\u5b9a (DISTRIBUTION SEVER SETTING, the first option) and toggle this setting to \u30b5\u30fc\u30d0\u30fc (SERVER).

Select \u7b50\u4f53\u30b0\u30eb\u30fc\u30d7\u8a2d\u5b9a (CABINET GROUP SETTINGS, the second option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

Select \u306f\u3044 (YES) and select \u9589\u3058\u308b

After this, your game will close. Open it back up, and enter the service menu again.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/paradiselost/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/paradiselost/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/paradiselost/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/chunithm/paradiselost/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/paradiselost/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.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/paradiselost/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chuniApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/paradiselost/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/paradiselost/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/paradiselost/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/plus/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/chunithm/plus/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/plus/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/plus/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/plus/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/plus/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/plus/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with an IO DLL to add support for controllers.

The controller you plan on using should also be provided with an IO DLL. 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.

To add your IO DLL, ncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; To use a custom Chunithm IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/plus/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/plus/controllers/#tasoller","title":"TASOLLER","text":"
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download the TASOLLER IO DLL corrosponding to your firmware version and extract to your App\\bin folder.
    • chuniio-rs (download chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_v2.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/plus/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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_plus.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/plus/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 chuni 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]\npath=chuniio_yubideck_v3.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/plus/controllers/#laverita-3","title":"Laverita 3","text":"
  • 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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_laverita_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/plus/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/plus/setup/","title":"Game Setup","text":""},{"location":"games/sega/chunithm/plus/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/plus/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2startup\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0foxGetHwInfo.exe\n\ud83d\udcddoxGetHwInfo.ini\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/plus/setup/#updating-data","title":"Updating data","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/plus/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/plus/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/plus/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

Patch Recommendation Description Disable shop close lockout Either Disables the shop lockout from 12 to 8PM JST. 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."},{"location":"games/sega/chunithm/plus/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chuni.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchunihook.dll\n\u25b6\ufe0finject.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/plus/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/plus/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][gfx]

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/plus/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"games/sega/chunithm/plus/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/plus/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/plus/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth option).

Select \u914d\u4fe1\u30b5\u30fc\u30d0\u30fc\u8a2d\u5b9a (DISTRIBUTION SEVER SETTING, the first option) and toggle this setting to \u30b5\u30fc\u30d0\u30fc (SERVER).

Select \u7b50\u4f53\u30b0\u30eb\u30fc\u30d7\u8a2d\u5b9a (CABINET GROUP SETTINGS, the second option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

Select \u306f\u3044 (YES) and select \u9589\u3058\u308b

After this, your game will close. Open it back up, and enter the service menu again.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/plus/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/plus/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/plus/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/chunithm/plus/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/plus/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.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/plus/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chuniApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/plus/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/plus/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/plus/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/star/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/chunithm/star/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/star/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/star/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/star/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/star/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/star/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with an IO DLL to add support for controllers.

The controller you plan on using should also be provided with an IO DLL. 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.

To add your IO DLL, ncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; To use a custom Chunithm IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/star/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/star/controllers/#tasoller","title":"TASOLLER","text":"
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download the TASOLLER IO DLL corrosponding to your firmware version and extract to your App\\bin folder.
    • chuniio-rs (download chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_v2.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/star/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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_plus.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/star/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 chuni 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]\npath=chuniio_yubideck_v3.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/star/controllers/#laverita-3","title":"Laverita 3","text":"
  • 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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_laverita_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/star/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/star/setup/","title":"Game Setup","text":""},{"location":"games/sega/chunithm/star/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/star/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2startup\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0foxGetHwInfo.exe\n\ud83d\udcddoxGetHwInfo.ini\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/star/setup/#updating-data","title":"Updating data","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/star/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/star/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/star/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

Patch Recommendation Description Disable shop close lockout Either Disables the shop lockout from 12 to 8PM JST. 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."},{"location":"games/sega/chunithm/star/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chuni.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchunihook.dll\n\u25b6\ufe0finject.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/star/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/star/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][gfx]

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/star/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"games/sega/chunithm/star/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/star/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/star/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth option).

Select \u914d\u4fe1\u30b5\u30fc\u30d0\u30fc\u8a2d\u5b9a (DISTRIBUTION SEVER SETTING, the first option) and toggle this setting to \u30b5\u30fc\u30d0\u30fc (SERVER).

Select \u7b50\u4f53\u30b0\u30eb\u30fc\u30d7\u8a2d\u5b9a (CABINET GROUP SETTINGS, the second option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

Select \u306f\u3044 (YES) and select \u9589\u3058\u308b

After this, your game will close. Open it back up, and enter the service menu again.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/star/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/star/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/star/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/chunithm/star/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/star/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.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/star/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chuniApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/star/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/star/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/star/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/starplus/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/chunithm/starplus/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/starplus/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/starplus/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/starplus/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/starplus/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/starplus/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

segatools, by default, only accepts keyboard input and does not recognize any controllers. However, it can be configured with an IO DLL to add support for controllers.

The controller you plan on using should also be provided with an IO DLL. 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.

To add your IO DLL, ncomment the path= line by removing the leading semicolon (;), then add your DLL's file name after the =:

[chuniio]\n; To use a custom Chunithm IO DLL enter its path here.\n; Leave empty if you want to use Segatools built-in keyboard input.\npath=controller.dll\n
  1. Note that there is no leading semicolon.
"},{"location":"games/sega/chunithm/starplus/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/starplus/controllers/#tasoller","title":"TASOLLER","text":"
  • Install the custom Host and LED firmware to your controller. Instructions on how to do so is provided in the linked archive.
  • Download the TASOLLER IO DLL corrosponding to your firmware version and extract to your App\\bin folder.
    • chuniio-rs (download chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_v2.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/starplus/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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_tasoller_plus.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/starplus/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 chuni 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]\npath=chuniio_yubideck_v3.dll\n
  • Optionally, reference the included AimeIO DLL to use the controller's built-in card reader:
[aimeio]\npath=aimeio_yubideck_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/starplus/controllers/#laverita-3","title":"Laverita 3","text":"
  • 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 chuni.zip)
  • Edit your App\\bin\\segatools.ini to reference the extracted DLLs:
[chuniio]\npath=chuniio_laverita_v3.dll\n
  • Connect the controller to your computer, and then start the game.
"},{"location":"games/sega/chunithm/starplus/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/starplus/setup/","title":"Game Setup","text":""},{"location":"games/sega/chunithm/starplus/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/starplus/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2startup\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0foxGetHwInfo.exe\n\ud83d\udcddoxGetHwInfo.ini\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/starplus/setup/#updating-data","title":"Updating data","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/starplus/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/starplus/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/starplus/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

Patch Recommendation Description Disable shop close lockout Either Disables the shop lockout from 12 to 8PM JST. 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."},{"location":"games/sega/chunithm/starplus/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chuni.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchunihook.dll\n\u25b6\ufe0finject.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/starplus/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/starplus/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][gfx]

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/starplus/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"games/sega/chunithm/starplus/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/starplus/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/starplus/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth option).

Select \u914d\u4fe1\u30b5\u30fc\u30d0\u30fc\u8a2d\u5b9a (DISTRIBUTION SEVER SETTING, the first option) and toggle this setting to \u30b5\u30fc\u30d0\u30fc (SERVER).

Select \u7b50\u4f53\u30b0\u30eb\u30fc\u30d7\u8a2d\u5b9a (CABINET GROUP SETTINGS, the second option) and toggle this setting to OFF.

Select \u7d42\u4e86 (EXIT, the last option) to exit to the main service menu.

Select \u306f\u3044 (YES) and select \u9589\u3058\u308b

After this, your game will close. Open it back up, and enter the service menu again.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/starplus/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/starplus/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/starplus/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/chunithm/starplus/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/starplus/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.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/starplus/troubleshooting/#my-game-is-stuttering","title":"My game is stuttering","text":"

For NVIDIA users, create an override for chuniApp.exe in NVIDIA Control Panel and change \"Power management mode\" to \"Prefer maximum performance\".

"},{"location":"games/sega/chunithm/starplus/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/starplus/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/starplus/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","text":""},{"location":"games/sega/chunithm/sun/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/sun/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/sun/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/sun/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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\\launch.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 launch.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\\launch.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 mode 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","text":""},{"location":"games/sega/chunithm/sun/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/sun/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2license\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/sun/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"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 data's App\\bin folder
  • 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

Avoid patching anything you don't need or understand unless explicitly told to

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 120 Hz monitor check Either Disable checking if the monitor is exactly 120 Hz when enabling 120FPS. Enable if you cannot set your monitor to 120 Hz."},{"location":"games/sega/chunithm/sun/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chusan.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchusanhook_x64.dll\n\u2699\ufe0fchusanhook_x86.dll\n\ud83d\udcc4config_hook.json\n\u25b6\ufe0finject_x64.exe\n\u25b6\ufe0finject_x86.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/sun/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][system][gfx] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

  • If you have a 120 Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60 Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/sun/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/sun/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/sun/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/sun/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth 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.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/sun/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/sun/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60 Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120 Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120 Hz, apply the \"Bypass 120 Hz 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\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 60 Hz or 120 Hz.

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","text":""},{"location":"games/sega/chunithm/sunplus/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/sunplus/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/sunplus/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/sunplus/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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\\launch.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 launch.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\\launch.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 mode 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","text":""},{"location":"games/sega/chunithm/sunplus/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/sunplus/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2license\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/sunplus/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"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 data's App\\bin folder
  • 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

Avoid patching anything you don't need or understand unless explicitly told to

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 120 Hz monitor check Either Disable checking if the monitor is exactly 120 Hz when enabling 120FPS. Enable if you cannot set your monitor to 120 Hz."},{"location":"games/sega/chunithm/sunplus/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chusan.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchusanhook_x64.dll\n\u2699\ufe0fchusanhook_x86.dll\n\ud83d\udcc4config_hook.json\n\u25b6\ufe0finject_x64.exe\n\u25b6\ufe0finject_x86.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/sunplus/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][system][gfx] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

  • If you have a 120 Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60 Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/sunplus/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/sunplus/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/sunplus/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/sunplus/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth 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.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/sunplus/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/sunplus/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60 Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120 Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120 Hz, apply the \"Bypass 120 Hz 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\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 60 Hz or 120 Hz.

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","text":""},{"location":"games/sega/chunithm/verse/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/verse/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/verse/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/verse/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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\\launch.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 launch.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\\launch.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 mode 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","text":""},{"location":"games/sega/chunithm/verse/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/verse/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2license\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/verse/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"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 data's App\\bin folder
  • 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

Avoid patching anything you don't need or understand unless explicitly told to

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 120 Hz monitor check Either Disable checking if the monitor is exactly 120 Hz when enabling 120FPS. Enable if you cannot set your monitor to 120 Hz."},{"location":"games/sega/chunithm/verse/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chusan.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchusanhook_x64.dll\n\u2699\ufe0fchusanhook_x86.dll\n\ud83d\udcc4config_hook.json\n\u25b6\ufe0finject_x64.exe\n\u25b6\ufe0finject_x86.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/verse/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][system][gfx] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

  • If you have a 120 Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60 Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/verse/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/verse/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/verse/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/verse/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth 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.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/verse/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/verse/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60 Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120 Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120 Hz, apply the \"Bypass 120 Hz 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\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 60 Hz or 120 Hz.

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/chunithm/x-verse/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/chunithm/x-verse/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/chunithm/x-verse/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to GAME ASSIGNMENTS

  • Make sure all machines 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/x-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/x-verse/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/x-verse/controllers/","title":"Controllers","text":""},{"location":"games/sega/chunithm/x-verse/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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/x-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/x-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/x-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\\launch.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 launch.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/x-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\\launch.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/x-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/x-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/x-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/x-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 mode 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/x-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/x-verse/setup/","title":"Game Setup","text":""},{"location":"games/sega/chunithm/x-verse/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/chunithm/x-verse/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2data\n\ud83d\udcc2firm\n\ud83d\udcc2license\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/chunithm/x-verse/setup/#updating-data","title":"Updating data","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/x-verse/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"games/sega/chunithm/x-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 data's App\\bin folder
  • Agree to overwrite when asked
"},{"location":"games/sega/chunithm/x-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/x-verse/setup/#patching-the-game","title":"Patching the game","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

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 120 Hz monitor check Either Disable checking if the monitor is exactly 120 Hz when enabling 120FPS. Enable if you cannot set your monitor to 120 Hz."},{"location":"games/sega/chunithm/x-verse/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find chusan.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u2699\ufe0fchusanhook_x64.dll\n\u2699\ufe0fchusanhook_x86.dll\n\ud83d\udcc4config_hook.json\n\u25b6\ufe0finject_x64.exe\n\u25b6\ufe0finject_x86.exe\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/chunithm/x-verse/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs][system][gfx] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

  • If you have a 120 Hz monitor, set dipsw2 and dipsw3 to 0:
[system]\ndipsw2=0\ndipsw3=0\n
  • If you have a 60 Hz monitor, set dipsw2 and dipsw3 to 1:
[system]\ndipsw2=1\ndipsw3=1\n

Display settings

  • Use windowed=0 for fullscreen mode or windowed=1 for windowed mode
  • For multi-monitor setups in fullscreen mode, specify your target display using the monitor index setting
Finding your monitor index

Open Windows display settings to find your monitor numbers. Your monitor's index is one less than the displayed number. For example, if Windows shows \"Display 2\", use monitor index 1.

"},{"location":"games/sega/chunithm/x-verse/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/x-verse/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/chunithm/x-verse/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/chunithm/x-verse/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/chunithm/x-verse/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\bin\\launch.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 fourth 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.

Navigate to \u9589\u5e97\u8a2d\u5b9a (CLOSE SETTING, the tenth option).

Navigate to \u6642 (HOUR, the second 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.

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/x-verse/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/chunithm/x-verse/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/chunithm/x-verse/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/chunithm/x-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.
  • Using the incorrect dipswitch settings for your refresh rate (e.g. dipsw3=0 on a 60 Hz screen). Refer to the game setup guide to fix it.
  • Enabling 120FPS on a monitor that is not exactly 120 Hz or exactly 1080p. If you cannot set your monitor's refresh rate to 120 Hz, apply the \"Bypass 120 Hz 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\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/x-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/x-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 60 Hz or 120 Hz.

It could also be that your computer's performance isn't good enough to keep a steady framerate.

"},{"location":"games/sega/chunithm/x-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/x-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/x-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/x-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":"Controllers","text":""},{"location":"games/sega/maimaidx/buddies/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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":"Game Setup","text":""},{"location":"games/sega/maimaidx/buddies/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/maimaidx/buddies/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2license\n\ud83d\udcc2package\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/maimaidx/buddies/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

  • maimai DX JPN(SDEZ): each new release of maimai DX increments the first letter of the Options (ie. H??? for BUDDiES, I??? BUDDiES+)
  • maimai DX EXP(SDGA): Options will always begin with the letter A (i.e A???)
  • ??? represents a sequence of numbers

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2H005\n\u2523\u2501\ud83d\udcc2H011\n\u2523\u2501\ud83d\udcc2H031\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example H005 then H011

Do not mix option data between game 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 of the following folders and files:
\u25b6\ufe0famdaemon.exe\n\u25b6\ufe0fSinmai.exe\n\ud83d\udcc2Sinmai_Data\n\u2523\u2501\ud83d\udcc2Plugins\n\u2503  \u2523\u2501\u2699\ufe0famdaemon_api.dll\n\u2503  \u2517\u2501\u2699\ufe0fCake.dll (JPN/SDEZ only)\n\u2517\u2501\ud83d\udcc2Managed\n   \u2523\u2501\u2699\ufe0fAMDaemon.NET.dll\n   \u2517\u2501\u2699\ufe0fAssembly-CSharp.dll\n\ud83d\udcddmai2.ini\n
  • Copy all of the above to your data's App\\package folder
  • Agree to overwrite when asked

Assembly-CSharp Notes

Assembly-CSharp.dll must match your game version. All other files can be reused between 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":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find mai2.zip and extract it to your data's App\\package folder

You should now have these files added to your App\\package directory:

\ud83d\udcc2DEVICE\n\u25b6\ufe0finject.exe\n\u2699\ufe0fmai2hook.dll\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/maimaidx/buddies/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\package\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

AquaMai

Find more information about AquaMai on their GitHub page. Also check our Unity modding guide.

"},{"location":"games/sega/maimaidx/buddies/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/maimaidx/buddies/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/maimaidx/buddies/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/maimaidx/buddies/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\package\\launch.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.

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/maimaidx/buddies/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/maimaidx/buddies/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/maimaidx/buddies/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
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\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

"},{"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":"Controllers","text":""},{"location":"games/sega/maimaidx/buddiesplus/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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":"Game Setup","text":""},{"location":"games/sega/maimaidx/buddiesplus/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2license\n\ud83d\udcc2package\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

  • maimai DX JPN(SDEZ): each new release of maimai DX increments the first letter of the Options (ie. H??? for BUDDiES, I??? BUDDiES+)
  • maimai DX EXP(SDGA): Options will always begin with the letter A (i.e A???)
  • ??? represents a sequence of numbers

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2H005\n\u2523\u2501\ud83d\udcc2H011\n\u2523\u2501\ud83d\udcc2H031\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example H005 then H011

Do not mix option data between game 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 of the following folders and files:
\u25b6\ufe0famdaemon.exe\n\u25b6\ufe0fSinmai.exe\n\ud83d\udcc2Sinmai_Data\n\u2523\u2501\ud83d\udcc2Plugins\n\u2503  \u2523\u2501\u2699\ufe0famdaemon_api.dll\n\u2503  \u2517\u2501\u2699\ufe0fCake.dll (JPN/SDEZ only)\n\u2517\u2501\ud83d\udcc2Managed\n   \u2523\u2501\u2699\ufe0fAMDaemon.NET.dll\n   \u2517\u2501\u2699\ufe0fAssembly-CSharp.dll\n\ud83d\udcddmai2.ini\n
  • Copy all of the above to your data's App\\package folder
  • Agree to overwrite when asked

Assembly-CSharp Notes

Assembly-CSharp.dll must match your game version. All other files can be reused between 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":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find mai2.zip and extract it to your data's App\\package folder

You should now have these files added to your App\\package directory:

\ud83d\udcc2DEVICE\n\u25b6\ufe0finject.exe\n\u2699\ufe0fmai2hook.dll\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/maimaidx/buddiesplus/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\package\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

AquaMai

Find more information about AquaMai on their GitHub page. Also check our Unity modding guide.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/maimaidx/buddiesplus/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/maimaidx/buddiesplus/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/maimaidx/buddiesplus/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\package\\launch.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.

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/maimaidx/buddiesplus/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/maimaidx/buddiesplus/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/maimaidx/buddiesplus/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
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\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

"},{"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/circle/controllers/","title":"Controllers","text":""},{"location":"games/sega/maimaidx/circle/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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/circle/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/circle/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/circle/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/circle/setup/","title":"Game Setup","text":""},{"location":"games/sega/maimaidx/circle/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/maimaidx/circle/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2license\n\ud83d\udcc2package\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/maimaidx/circle/setup/#updating-data","title":"Updating data","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/circle/setup/#installing-option-data","title":"Installing option data","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

  • maimai DX JPN(SDEZ): each new release of maimai DX increments the first letter of the Options (ie. H??? for BUDDiES, I??? BUDDiES+)
  • maimai DX EXP(SDGA): Options will always begin with the letter A (i.e A???)
  • ??? represents a sequence of numbers

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2H005\n\u2523\u2501\ud83d\udcc2H011\n\u2523\u2501\ud83d\udcc2H031\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example H005 then H011

Do not mix option data between game versions

"},{"location":"games/sega/maimaidx/circle/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 of the following folders and files:
\u25b6\ufe0famdaemon.exe\n\u25b6\ufe0fSinmai.exe\n\ud83d\udcc2Sinmai_Data\n\u2523\u2501\ud83d\udcc2Plugins\n\u2503  \u2523\u2501\u2699\ufe0famdaemon_api.dll\n\u2503  \u2517\u2501\u2699\ufe0fCake.dll (JPN/SDEZ only)\n\u2517\u2501\ud83d\udcc2Managed\n   \u2523\u2501\u2699\ufe0fAMDaemon.NET.dll\n   \u2517\u2501\u2699\ufe0fAssembly-CSharp.dll\n\ud83d\udcddmai2.ini\n
  • Copy all of the above to your data's App\\package folder
  • Agree to overwrite when asked

Assembly-CSharp Notes

Assembly-CSharp.dll must match your game version. All other files can be reused between game versions.

"},{"location":"games/sega/maimaidx/circle/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/circle/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/circle/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find mai2.zip and extract it to your data's App\\package folder

You should now have these files added to your App\\package directory:

\ud83d\udcc2DEVICE\n\u25b6\ufe0finject.exe\n\u2699\ufe0fmai2hook.dll\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/maimaidx/circle/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\package\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

AquaMai

Find more information about AquaMai on their GitHub page. Also check our Unity modding guide.

"},{"location":"games/sega/maimaidx/circle/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/circle/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/maimaidx/circle/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/maimaidx/circle/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/maimaidx/circle/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\package\\launch.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.

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/maimaidx/circle/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/maimaidx/circle/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/maimaidx/circle/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/sega/maimaidx/circle/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.
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\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/circle/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

"},{"location":"games/sega/maimaidx/circle/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/circle/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":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

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

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2license\n\ud83d\udcc2package\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/maimaidx/common/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

  • maimai DX JPN(SDEZ): each new release of maimai DX increments the first letter of the Options (ie. H??? for BUDDiES, I??? BUDDiES+)
  • maimai DX EXP(SDGA): Options will always begin with the letter A (i.e A???)
  • ??? represents a sequence of numbers

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2H005\n\u2523\u2501\ud83d\udcc2H011\n\u2523\u2501\ud83d\udcc2H031\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example H005 then H011

Do not mix option data between game 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 of the following folders and files:
\u25b6\ufe0famdaemon.exe\n\u25b6\ufe0fSinmai.exe\n\ud83d\udcc2Sinmai_Data\n\u2523\u2501\ud83d\udcc2Plugins\n\u2503  \u2523\u2501\u2699\ufe0famdaemon_api.dll\n\u2503  \u2517\u2501\u2699\ufe0fCake.dll (JPN/SDEZ only)\n\u2517\u2501\ud83d\udcc2Managed\n   \u2523\u2501\u2699\ufe0fAMDaemon.NET.dll\n   \u2517\u2501\u2699\ufe0fAssembly-CSharp.dll\n\ud83d\udcddmai2.ini\n
  • Copy all of the above to your data's App\\package folder
  • Agree to overwrite when asked

Assembly-CSharp Notes

Assembly-CSharp.dll must match your game version. All other files can be reused between 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":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find mai2.zip and extract it to your data's App\\package folder

You should now have these files added to your App\\package directory:

\ud83d\udcc2DEVICE\n\u25b6\ufe0finject.exe\n\u2699\ufe0fmai2hook.dll\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/maimaidx/common/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\package\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

AquaMai

Find more information about AquaMai on their GitHub page. Also check our Unity modding guide.

"},{"location":"games/sega/maimaidx/common/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/maimaidx/common/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/maimaidx/common/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/maimaidx/common/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\package\\launch.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.

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/maimaidx/common/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/maimaidx/common/troubleshooting/","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
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\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

"},{"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":"Controllers","text":""},{"location":"games/sega/maimaidx/prism/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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":"Game Setup","text":""},{"location":"games/sega/maimaidx/prism/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/maimaidx/prism/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2license\n\ud83d\udcc2package\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/maimaidx/prism/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

  • maimai DX JPN(SDEZ): each new release of maimai DX increments the first letter of the Options (ie. H??? for BUDDiES, I??? BUDDiES+)
  • maimai DX EXP(SDGA): Options will always begin with the letter A (i.e A???)
  • ??? represents a sequence of numbers

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2H005\n\u2523\u2501\ud83d\udcc2H011\n\u2523\u2501\ud83d\udcc2H031\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example H005 then H011

Do not mix option data between game 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 of the following folders and files:
\u25b6\ufe0famdaemon.exe\n\u25b6\ufe0fSinmai.exe\n\ud83d\udcc2Sinmai_Data\n\u2523\u2501\ud83d\udcc2Plugins\n\u2503  \u2523\u2501\u2699\ufe0famdaemon_api.dll\n\u2503  \u2517\u2501\u2699\ufe0fCake.dll (JPN/SDEZ only)\n\u2517\u2501\ud83d\udcc2Managed\n   \u2523\u2501\u2699\ufe0fAMDaemon.NET.dll\n   \u2517\u2501\u2699\ufe0fAssembly-CSharp.dll\n\ud83d\udcddmai2.ini\n
  • Copy all of the above to your data's App\\package folder
  • Agree to overwrite when asked

Assembly-CSharp Notes

Assembly-CSharp.dll must match your game version. All other files can be reused between 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":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find mai2.zip and extract it to your data's App\\package folder

You should now have these files added to your App\\package directory:

\ud83d\udcc2DEVICE\n\u25b6\ufe0finject.exe\n\u2699\ufe0fmai2hook.dll\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/maimaidx/prism/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\package\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

AquaMai

Find more information about AquaMai on their GitHub page. Also check our Unity modding guide.

"},{"location":"games/sega/maimaidx/prism/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/maimaidx/prism/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/maimaidx/prism/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/maimaidx/prism/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\package\\launch.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.

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/maimaidx/prism/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/maimaidx/prism/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/maimaidx/prism/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
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\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

"},{"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":"Controllers","text":""},{"location":"games/sega/maimaidx/prismplus/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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":"Game Setup","text":""},{"location":"games/sega/maimaidx/prismplus/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/maimaidx/prismplus/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2license\n\ud83d\udcc2package\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpwGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/maimaidx/prismplus/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

  • maimai DX JPN(SDEZ): each new release of maimai DX increments the first letter of the Options (ie. H??? for BUDDiES, I??? BUDDiES+)
  • maimai DX EXP(SDGA): Options will always begin with the letter A (i.e A???)
  • ??? represents a sequence of numbers

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2H005\n\u2523\u2501\ud83d\udcc2H011\n\u2523\u2501\ud83d\udcc2H031\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example H005 then H011

Do not mix option data between game 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 of the following folders and files:
\u25b6\ufe0famdaemon.exe\n\u25b6\ufe0fSinmai.exe\n\ud83d\udcc2Sinmai_Data\n\u2523\u2501\ud83d\udcc2Plugins\n\u2503  \u2523\u2501\u2699\ufe0famdaemon_api.dll\n\u2503  \u2517\u2501\u2699\ufe0fCake.dll (JPN/SDEZ only)\n\u2517\u2501\ud83d\udcc2Managed\n   \u2523\u2501\u2699\ufe0fAMDaemon.NET.dll\n   \u2517\u2501\u2699\ufe0fAssembly-CSharp.dll\n\ud83d\udcddmai2.ini\n
  • Copy all of the above to your data's App\\package folder
  • Agree to overwrite when asked

Assembly-CSharp Notes

Assembly-CSharp.dll must match your game version. All other files can be reused between 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":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find mai2.zip and extract it to your data's App\\package folder

You should now have these files added to your App\\package directory:

\ud83d\udcc2DEVICE\n\u25b6\ufe0finject.exe\n\u2699\ufe0fmai2hook.dll\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/maimaidx/prismplus/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\package\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

AquaMai

Find more information about AquaMai on their GitHub page. Also check our Unity modding guide.

"},{"location":"games/sega/maimaidx/prismplus/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/maimaidx/prismplus/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/maimaidx/prismplus/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/maimaidx/prismplus/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\package\\launch.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.

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/maimaidx/prismplus/setup/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/maimaidx/prismplus/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/maimaidx/prismplus/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
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\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

"},{"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/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/ongeki/brightmemory/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/ongeki/brightmemory/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 6th option)

  • Make sure all machines 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/ongeki/brightmemory/c2c/#how-to-link","title":"How to link?","text":"

If you're new to O.N.G.E.K.I. 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/ongeki/brightmemory/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/ongeki/brightmemory/controllers/","title":"Controllers","text":""},{"location":"games/sega/ongeki/brightmemory/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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/#yuangeki","title":"YUANGEKI","text":"

This controller does not support IO4 mode. Instead, refer to the Keyboard and Mouse section.

"},{"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","text":""},{"location":"games/sega/ongeki/brightmemory/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/ongeki/brightmemory/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2license\n\ud83d\udcc2package\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpxGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\u25b6\ufe0fRotateDisplay.exe\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/ongeki/brightmemory/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

For O.N.G.E.K.I., official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A002\n\u2523\u2501\ud83d\udcc2A012\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A001 then A012

"},{"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 of the following folders and files:
\u25b6\ufe0famdaemon.exe\n\u25b6\ufe0fmu3.exe\n\ud83d\udcc2mu3_Data\n\u2523\u2501\ud83d\udcc2Plugins\n\u2503  \u2523\u2501\u2699\ufe0famdaemon_api.dll\n\u2503  \u2523\u2501\u2699\ufe0fchiffre.dll\n\u2503  \u2523\u2501\u2699\ufe0flibhttp.dll\n\u2503  \u2517\u2501\u2699\ufe0fQR_Image.dll\n\u2517\u2501\ud83d\udcc2Managed\n   \u2523\u2501\u2699\ufe0fAMDaemon.NET.dll\n   \u2523\u2501\u2699\ufe0fAssembly-CSharp-firstpass.dll\n   \u2517\u2501\u2699\ufe0fAssembly-CSharp.dll\n\ud83d\udcddmu3.ini\n
  • Copy all of the above to your data's App\\package folder
  • Agree to overwrite when asked

Assembly-CSharp Notes

Assembly-CSharp.dll must match your game version. All other files can be reused between game versions.

"},{"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

When using the folder structure proposed in this guide, setting OptionDev=0 in mu3.ini is required for the game to properly load Option data.

"},{"location":"games/sega/ongeki/brightmemory/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find mu3.zip and extract it to your data's App\\package folder

You should now have these files added to your App\\package directory:

\ud83d\udcc2DEVICE\n\u25b6\ufe0finject.exe\n\u2699\ufe0fmu3hook.dll\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/ongeki/brightmemory/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\package\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

mu3-mods

Find more info about O.N.G.E.K.I. mods here mu3-mods. Also check our Unity modding guide.

"},{"location":"games/sega/ongeki/brightmemory/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/ongeki/brightmemory/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/ongeki/brightmemory/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/ongeki/brightmemory/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/ongeki/brightmemory/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\package\\launch.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.

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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/ongeki/brightmemory/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/ongeki/brightmemory/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
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\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/c2c/","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/ongeki/common/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 6th option)

  • Make sure all machines 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/ongeki/common/c2c/#how-to-link","title":"How to link?","text":"

If you're new to O.N.G.E.K.I. 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/ongeki/common/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/ongeki/common/controllers/","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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/#yuangeki","title":"YUANGEKI","text":"

This controller does not support IO4 mode. Instead, refer to the Keyboard and Mouse section.

"},{"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":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

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

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2license\n\ud83d\udcc2package\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpxGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\u25b6\ufe0fRotateDisplay.exe\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/ongeki/common/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

For O.N.G.E.K.I., official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A002\n\u2523\u2501\ud83d\udcc2A012\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A001 then A012

"},{"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 of the following folders and files:
\u25b6\ufe0famdaemon.exe\n\u25b6\ufe0fmu3.exe\n\ud83d\udcc2mu3_Data\n\u2523\u2501\ud83d\udcc2Plugins\n\u2503  \u2523\u2501\u2699\ufe0famdaemon_api.dll\n\u2503  \u2523\u2501\u2699\ufe0fchiffre.dll\n\u2503  \u2523\u2501\u2699\ufe0flibhttp.dll\n\u2503  \u2517\u2501\u2699\ufe0fQR_Image.dll\n\u2517\u2501\ud83d\udcc2Managed\n   \u2523\u2501\u2699\ufe0fAMDaemon.NET.dll\n   \u2523\u2501\u2699\ufe0fAssembly-CSharp-firstpass.dll\n   \u2517\u2501\u2699\ufe0fAssembly-CSharp.dll\n\ud83d\udcddmu3.ini\n
  • Copy all of the above to your data's App\\package folder
  • Agree to overwrite when asked

Assembly-CSharp Notes

Assembly-CSharp.dll must match your game version. All other files can be reused between game versions.

"},{"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

When using the folder structure proposed in this guide, setting OptionDev=0 in mu3.ini is required for the game to properly load Option data.

"},{"location":"games/sega/ongeki/common/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find mu3.zip and extract it to your data's App\\package folder

You should now have these files added to your App\\package directory:

\ud83d\udcc2DEVICE\n\u25b6\ufe0finject.exe\n\u2699\ufe0fmu3hook.dll\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/ongeki/common/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\package\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

mu3-mods

Find more info about O.N.G.E.K.I. mods here mu3-mods. Also check our Unity modding guide.

"},{"location":"games/sega/ongeki/common/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/ongeki/common/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/ongeki/common/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/ongeki/common/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/ongeki/common/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\package\\launch.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.

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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/ongeki/common/troubleshooting/","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
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\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/c2c/","title":"Cab-to-Cab","text":""},{"location":"games/sega/ongeki/refresh/c2c/#cab-to-cab-over-internet","title":"Cab-to-Cab over Internet","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

"},{"location":"games/sega/ongeki/refresh/c2c/#initial-setup","title":"Initial setup","text":"

Network

Every machine needs to be on the same LAN. If you wish to achieve that over the internet, follow the ZeroTier setup guide.

GAME ASSIGNMENTS

  • Open the Service Menu and navigate to \u30b2\u30fc\u30e0\u8a2d\u5b9a (GAME ASSIGNMENTS, the 6th option)

  • Make sure all machines 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/ongeki/refresh/c2c/#how-to-link","title":"How to link?","text":"

If you're new to O.N.G.E.K.I. 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/ongeki/refresh/c2c/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/ongeki/refresh/controllers/","title":"Controllers","text":""},{"location":"games/sega/ongeki/refresh/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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/#yuangeki","title":"YUANGEKI","text":"

This controller does not support IO4 mode. Instead, refer to the Keyboard and Mouse section.

"},{"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","text":""},{"location":"games/sega/ongeki/refresh/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"games/sega/ongeki/refresh/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2license\n\ud83d\udcc2package\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpxGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\u25b6\ufe0fRotateDisplay.exe\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/ongeki/refresh/setup/#updating-data","title":"Updating data","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":"

SEGA games receive content updates through option folders rather than direct game file updates.

For O.N.G.E.K.I., official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A002\n\u2523\u2501\ud83d\udcc2A012\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A001 then A012

"},{"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 of the following folders and files:
\u25b6\ufe0famdaemon.exe\n\u25b6\ufe0fmu3.exe\n\ud83d\udcc2mu3_Data\n\u2523\u2501\ud83d\udcc2Plugins\n\u2503  \u2523\u2501\u2699\ufe0famdaemon_api.dll\n\u2503  \u2523\u2501\u2699\ufe0fchiffre.dll\n\u2503  \u2523\u2501\u2699\ufe0flibhttp.dll\n\u2503  \u2517\u2501\u2699\ufe0fQR_Image.dll\n\u2517\u2501\ud83d\udcc2Managed\n   \u2523\u2501\u2699\ufe0fAMDaemon.NET.dll\n   \u2523\u2501\u2699\ufe0fAssembly-CSharp-firstpass.dll\n   \u2517\u2501\u2699\ufe0fAssembly-CSharp.dll\n\ud83d\udcddmu3.ini\n
  • Copy all of the above to your data's App\\package folder
  • Agree to overwrite when asked

Assembly-CSharp Notes

Assembly-CSharp.dll must match your game version. All other files can be reused between game versions.

"},{"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

When using the folder structure proposed in this guide, setting OptionDev=0 in mu3.ini is required for the game to properly load Option data.

"},{"location":"games/sega/ongeki/refresh/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find mu3.zip and extract it to your data's App\\package folder

You should now have these files added to your App\\package directory:

\ud83d\udcc2DEVICE\n\u25b6\ufe0finject.exe\n\u2699\ufe0fmu3hook.dll\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/ongeki/refresh/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\package\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

mu3-mods

Find more info about O.N.G.E.K.I. mods here mu3-mods. Also check our Unity modding guide.

"},{"location":"games/sega/ongeki/refresh/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/ongeki/refresh/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/ongeki/refresh/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/ongeki/refresh/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"games/sega/ongeki/refresh/setup/#first-launch","title":"First launch","text":"

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.

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

Start the game by running App\\package\\launch.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.

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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/sega/ongeki/refresh/troubleshooting/","title":"Troubleshooting","text":""},{"location":"games/sega/ongeki/refresh/troubleshooting/#troubleshooting","title":"Troubleshooting","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"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.
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\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/reverse/controllers/","title":"Controllers","text":""},{"location":"games/sega/wacca/reverse/controllers/#controllers","title":"Controllers","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

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

com0com issues

If you're getting errors such as Could not find file 'COM5', and particularly if you're on Windows 11, com0com v3 may be causing issues. Install com0com v2 instead.

"},{"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","text":""},{"location":"games/sega/wacca/reverse/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

Wireless Device

The Chinese SDJE Version requires a custom piece of hardware that will likely not work with known tools.

If you're having issues with a \"Wireless Device\" during boot or network testing, you likely need a different version of the game data.

"},{"location":"games/sega/wacca/reverse/setup/#preparing-data","title":"Preparing data","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

Here's what the expected original data structure should look like:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n

Create another empty folder named AppData next to them:

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n

The App folder should have a file structure as follows:

\ud83d\udcc2bin\n\ud83d\udcc2pxbin\n\ud83d\udcc2WindowsNoEditor\n\ud83d\udcc4firewall.cfg\n\u25b6\ufe0fgame.bat\n\u25b6\ufe0fpxGetHwinfo.exe\n\ud83d\udcddpxGetHwInfo.ini\n\ud83d\udcc4system_config.json\n

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"games/sega/wacca/reverse/setup/#updating-data","title":"Updating data","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/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 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/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

Avoid patching anything you don't need or understand unless explicitly told to

"},{"location":"games/sega/wacca/reverse/setup/#installing-segatools","title":"Installing segatools","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
  • Find mercury.zip and extract it to your data's App\\bin folder

You should now have these files added to your App\\bin directory:

\ud83d\udcc2DEVICE\n\u25b6\ufe0finject.exe\n\u2699\ufe0fmercuryhook.dll\n\ud83d\udcddsegatools.ini\n\u25b6\ufe0flaunch.bat\n
"},{"location":"games/sega/wacca/reverse/setup/#configuring-segatools","title":"Configuring segatools","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
[vfs] Relative Paths

Relative paths make your configuration portable and easier to maintain.

Say your game folder structure looks like this:

\ud83d\udcc2Game Folder\n\u2523\u2501\ud83d\udcc2App\n\u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n\u2517\u2501\ud83d\udcc2Option\n

If segatools.ini needs to access the Option folder, you can use ../../Option/:

  • ../ moves up from bin to App
  • ../ moves up again from App to the root Game Folder
  • Then it can access the Option folder

If you've followed our recommended file structure, use these values:

[vfs]\namfs=../../amfs\noption=../../Option\nappdata=../../AppData\n

If not, point those to their respective folders.

"},{"location":"games/sega/wacca/reverse/setup/#configuring-audio","title":"Configuring audio","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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/wacca/reverse/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

Pick one or the other, not both!

Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"games/sega/wacca/reverse/setup/#installing-ftdi-leds-driver","title":"Installing FTDI LEDs driver","text":"
  • Download the FTDI drivers
  • Extract them
  • Copy CDM-v2.12.36.4-WHQL-Certified/amd64/ftd2xx64.dll to /App/WindowsNoEditor/Mercury/Binaries/Win64/
  • Rename the file to ftd2xx.dll
"},{"location":"games/sega/wacca/reverse/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/sega/wacca/reverse/setup/#before-playing","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"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\\launch.bat.

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 launch.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/#help","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"games/taito/tetoteconnect/setup/","title":"Game Setup","text":""},{"location":"games/taito/tetoteconnect/setup/#game-setup","title":"Game Setup","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"games/taito/tetoteconnect/setup/#preparing-data","title":"Preparing data","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties

The complete game data should be approximately 5 GB or larger.

Here's what the expected data structure should look like: 

\ud83d\udcc2[SYSTEM]\n\ud83d\udcc2MonoBleedingEdge\n\ud83d\udcc2System Volume Information\n\ud83d\udcc2Vision_Data\n\u25b6\ufe0fgame.exe\n\ud83d\udcc4game.inf\n\u25b6\ufe0fRunVisionProd.bat\n\u25b6\ufe0fSetting.bat\n\u25b6\ufe0fUnityCrashHandler64.exe\n\u2699\ufe0fUnityPlayer.dll\n\u25b6\ufe0fVision.exe\n\u2699\ufe0fWinPixEventRuntime.dll\n
"},{"location":"games/taito/tetoteconnect/setup/#installing-bepinex","title":"Installing BepInEx","text":"
  • Download the most recent BepInEx 5 release (BepInEx_win_x64_5.x.y.z.zip)

We need BepInEx 5 since as of writing, BepInEx 6 does not support the required plugin

  • Extract the archive to the root folder of your game data

You should now have these files added to your directory:

\ud83d\udcc2BepInEx\n\ud83d\udcc4.doorstop_version\n\ud83d\udcc4changelog.txt\n\ud83d\udcdddoorstop_config.ini\n\u2699\ufe0fwinhttp.dll\n
"},{"location":"games/taito/tetoteconnect/setup/#installing-tetoco","title":"Installing tetoco","text":"
  • Head over to tetoco releases
  • Download tetoco.dll
  • Create a folder called plugins in the BepInEx folder
  • Move the dll file to that newly created folder

You should end up with a file structure as follows:

\ud83d\udcc2BepInEx\n\u2517 \ud83d\udcc2plugins\n  \u2517\u2699\ufe0ftetoco.dll\n
"},{"location":"games/taito/tetoteconnect/setup/#installing-vcredist-directx","title":"Installing VCRedist & DirectX","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"games/taito/tetoteconnect/setup/#monitor-orientation","title":"Monitor orientation","text":"

With tetoco installed, the game won't automatically rotate to portrait mode when starting it

The game can be played in landscape mode but a lot of the play area will be lost, it's best to set your monitor to portrait mode before launching the game.

Manually rotating
  • Right click on your Desktop
  • Select Display settings
  • Look for Display orientation and set it to Portrait or Portrait (flipped)
  • Rotate your monitor 90\u00b0
Automatically rotating

Right click on this link then Save Link As and place the windows-display-orientation-script.ps1 file in your game's directory.

Create a new start.bat file, and set its content to this, it will set your monitor as Portrait (flipped), and automatically rotate it back once you close the game.

powershell.exe -ExecutionPolicy Bypass -File \"windows-display-orientation-script.ps1\" 0 90\nVision.exe\npowershell.exe -ExecutionPolicy Bypass -File \"windows-display-orientation-script.ps1\" 0 0\n

Alternatively, you can set it to Portrait (not flipped) by changing 90 to 270.

powershell.exe -ExecutionPolicy Bypass -File \"windows-display-orientation-script.ps1\" 0 270\nVision.exe\npowershell.exe -ExecutionPolicy Bypass -File \"windows-display-orientation-script.ps1\" 0 0\n
"},{"location":"games/taito/tetoteconnect/setup/#first-launch","title":"First launch","text":"

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

Start the game by running Vision.exe, or start.bat if you followed the automatic monitor rotation part.

You're all done! The game should load up properly now.

You can use the Login as Local button to use your local save profile.

The T key can be pressed to access the service menu.

"},{"location":"games/taito/tetoteconnect/setup/#connecting-to-a-network","title":"Connecting to a network","text":"

By default, tetoco uses its own local network and saves data locally

Please follow this step only if you have a network to connect to.

Remote (Online Network)
  • Open the automatically created configuration file BepInEx\\config\\tetoco.cfg
  • Set UseLocalServer to false
  • Then, set RemoteServer to the address provided by your network
  • Finally, set the CardId provided by your network
"},{"location":"snippets/common/audio_48khz/","title":"Audio 48khz","text":"
  • Open sound settings
    • On Windows 10: Right-click on the volume icon in your taskbar and select Sounds
    • On Windows 11: Right-click on the volume icon in your taskbar and select Sound settings then scroll down and click on More sound settings
  • 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":"snippets/common/before_playing/","title":"Before playing","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor is oriented properly for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"snippets/common/data_readonly/","title":"Data readonly","text":"

Ensure your game files are not marked as read-only:

  • Right click the directory containing your files
  • Click on Properties
  • Under the General tab, find Attributes and uncheck Read-only
  • Click Apply
  • When prompted, select Apply changes to this folder, subfolders and files
  • Click OK to confirm, then OK again to close Properties
"},{"location":"snippets/common/data_warning/","title":"Data warning","text":"

You must obtain clean, unmodified and complete data to proceed with our guides

Corrupted or incomplete files will cause unpredictable issues we can't cover. TWO-TORIAL does not provide or distribute game data. Do not ask.

"},{"location":"snippets/common/help/","title":"Help","text":"

Something's wrong?

Make sure you've followed all steps correctly and also read other relevant guides.

Still stuck? You can join our Discord community server for support! Click on the Discord logo at the bottom right of the page.

"},{"location":"snippets/common/old_guide/","title":"Old guide","text":"

This guide is in need of a revision, it is not up to our current standards

The information it provides is still likely good but we can't guarantee it.

TWO-TORIAL is a community-driven project with limited resources. If you want to help us out, you're more than welcome to contribute!

"},{"location":"snippets/common/reminder_beforeplaying/","title":"Reminder beforeplaying","text":"

A few things to remember before each play session

  • Close of any applications running in the background which could affect performance
  • Double-check your monitor orientation is correct for this game
  • Double-check your sample rate is correct for this game
  • Connect your controller
"},{"location":"snippets/common/setup_vcredist_directx/","title":"Setup vcredist directx","text":"

Download and install:

  • VCRedist All-in-one
  • DirectX End-User Runtimes
"},{"location":"snippets/konami/common/btools_cards/","title":"Btools cards","text":"
!!! info \"This tab lets you configure which cards are used to save your game profile to\"\n\n!!! warning \"If you haven't generated a card number before, you can grab one from [here](https://kawashi.ro/card)\"\n\n!!! tip \"\"\n\n    Now we will set up our PIN pad and card.\n\n    - Click on `Keyboard device` for whichever player's card reader you want to use\n    - 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\n    - Once you have found your correct device, the `Keypad status` will change **(the number and location of the number does not matter, it only matters that it changed)**\n    - Create a `.txt` file in a location that is easily accessible, and name it however you like\n    - Inside the file, paste in your card number. Example: `E0045812F8AFB2DE`\n    - Point to the file you created by clicking `Browse...` and selecting it\n\n!!! info \"If you don't have a numpad, tick `Use top keyboard row for PIN pad input`. This will also change the `Card In` button to `Backspace`\"\n
"},{"location":"snippets/konami/common/btools_lights/","title":"Btools lights","text":"
!!! info \"This tab allows you to configure controller lights to sync with the game\"\n    Not all controllers support this, but it does not affect gameplay and is completely optional.\n\n!!! tip \"\"\n\n    - In `Device`, pick your controller\n    - In `Game Light`, select the corresponding button that will be used for that light\n    - Repeat for your other lights\n
"},{"location":"snippets/konami/common/cpu_avx2/","title":"Cpu avx2","text":"

AVX2 capable CPU required

This game requires your CPU to be compatible with AVX2 instructions.

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":"snippets/konami/common/data_bad/","title":"Data bad","text":"

If your data does not look like this

If you have .dll files next to your data, prop, etc., folders:

  • Create a modules folder if it does not exist already
  • Move all .dll files into it

If extra directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"snippets/konami/common/data_update/","title":"Data update","text":"
  • Extract the update to your game directory, ensure directories align and overwrite files when prompted
  • Open prop\\ea3-config.xml and find the <ext> line: 
    <ext __type=\"str\">NewDateCode</ext>\n
  • Update the datecode to match your new game version and save
  • If prop\\bootstrap.xml exists, also update its <release_code> line: 
    <release_code>NewDateCode</release_code>\n
"},{"location":"snippets/konami/common/display_portraitfirst/","title":"Display portraitfirst","text":"

This game requires your main monitor to be set to Portait or Portait (flipped) mode

You will play in Portait mode (Recommended)
  • Right click on your Desktop
  • Select Display settings
  • Look for Display orientation and set it to Portrait or Portrait (flipped)
  • Rotate your monitor 90\u00b0
You cannot play in Portait mode

In this case, your only option is to:

  • Open spicecfg, go to the Options tab
  • Set the game to Windowed Mode (-w)
  • Set your desired Window Resolution (-windowsize) for the game
"},{"location":"snippets/konami/common/setup_audio/","title":"Setup audio","text":"

Check out our general Audio guide to understand audio modes better, at least the TL;DR

  • 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

Then, depending follow instructions for your desired audio mode:

Setup for WASAPI Exclusive (default)
  • Check both boxes under Exclusive Mode
  • Open the Default Format dropdown
  • Pick the 16 bit, 44100 Hz (CD Quality) option, click Apply then OK
Setup for WASAPI Shared
  • Open the Default Format dropdown
  • Pick the 16 bit, 48000 Hz (DVD Quality) option, click Apply then OK
  • Return to spicecfg, go to the Patches tab
  • Following the patching guide and patch Shared Mode WASAPI

Optionally: go to the Options tab, and at the very bottom enable Low Latency Shared Audio to help mitigate the latency penalty from using Shared audio.

Setup for ASIO (requires specialized hardware)
  • Check both boxes under Exclusive Mode
  • Open the Default Format dropdown
  • Pick the 16 bit, 44100 Hz (CD Quality) option, click Apply then OK
"},{"location":"snippets/konami/common/setup_audio_wasapiexcl_only/","title":"Setup audio wasapiexcl only","text":"

Check out our general Audio guide to understand audio modes better, at least the TL;DR

This game only supports WASAPI Exclusive mode. Some audio devices may not support this

  • 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, click Apply then OK
"},{"location":"snippets/konami/common/setup_network/","title":"Setup network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open spicecfg.exe and head to the Options tab

Under the Network category, set the following settings provided by your network:

  • EA Service URL (-url)
  • PCBID (-p)

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open spicecfg.exe and head to the Options tab
  • Under the Network category, set your EA Service URL (-url) to point to your asphyxia server, typically localhost:8083
"},{"location":"snippets/konami/common/spice2x32_install/","title":"Spice2x32 install","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice.exe and spicecfg.exe from the archive into your game's directory
"},{"location":"snippets/konami/common/spice2x32_stubs/","title":"Spice2x32 stubs","text":"Additional steps for AMD and Intel graphics cards

Since KONAMI games are designed for NVIDIA GPU's, AMD and Intel users need additional files:

  • Locate the spice2x\\stubs\\32\\ folder in the spice2x archive
  • Extract all .dll files from there into your game's modules folder
"},{"location":"snippets/konami/common/spice2x64_install/","title":"Spice2x64 install","text":"

If you already have spice2x installed, ensure you're using the latest version

  • Visit spice2x.github.io to download the latest release
  • Extract both spice64.exe and spicecfg.exe from the archive into your game's directory
"},{"location":"snippets/konami/common/spice2x64_stubs/","title":"Spice2x64 stubs","text":"Additional steps for AMD and Intel graphics cards

Since KONAMI games are designed for NVIDIA GPU's, AMD and Intel users need additional files:

  • Locate the spice2x\\stubs\\64\\ folder in the spice2x archive
  • Extract all .dll files from there into your game's modules folder
"},{"location":"snippets/konami/common/spicecfg_buttons/","title":"Spicecfg buttons","text":"
!!! info \"This tab is used to bind your keyboard and controller buttons\"\n\n!!! info \"Bind vs Naive\"\n\n    **Bind** - Use for controllers and hardware devices. **More responsive** and detects any HID device.  \n    **Naive** - Use for device agnostic keyboard binds. **Less responsive** but works with simulated keystrokes.\n
"},{"location":"snippets/konami/common/spicecfg_buttons_additionalinfo/","title":"Spicecfg buttons additionalinfo","text":"
!!! info \"Additional info\"\n\n    - Use page navigation at the bottom to bind multiple buttons to the same input\n    - Check **Bind Many** to bind multiple controls in sequence\n    - Click **Edit** after binding for advanced options (invert, MIDI sensitivity, etc.)\n
"},{"location":"snippets/konami/common/spicecfg_cards/","title":"Spicecfg cards","text":"
!!! info \"This tab lets you configure which cards are used to save your game profile to\"\n\n??? tip \"If you own a physical e-amuse/FeliCa card and a compatible NFC card reader\"\n\n    Setup instructions vary depending on your specific reader model.\n\n    Navigate to the `Advanced` tab and scroll down to the `NFC Card Readers` section.  \n    Browse the available options and hover over each one to view descriptions and configuration guidance.\n\n    **There is no need for you to specify cards for either player in this tab when using a card reader.**\n\n??? tip \"If you don't, you can use a virtual card number instead\"\n\n    If you already have generated a card number before, you may use this one.\n\n    To generate a new card number for Player 1 or 2:\n\n    - Click on `Open...`\n    - Choose where to save your card number\n    - Give it a file name (e.g. `card0.txt`)\n    - Click save\n    - Finally, click on `Generate`\n\n    This will automatically generate a valid card number for you and keep it in the file you specified.\n
"},{"location":"snippets/konami/common/spicecfg_lights/","title":"Spicecfg lights","text":"
!!! info \"This tab allows you to configure controller lights to sync with the game\"\n\n    Not all controllers support this, but it does not affect gameplay and is completely optional.\n\n!!! tip \"\"\n\n    - Click `Bind`\n    - In `Device`, pick your controller\n    - In `Light Control`, select the corresponding light\n    - Click `Close`\n    - Repeat for your other lights\n
"},{"location":"snippets/konami/common/spicecfg_nochange/","title":"Spicecfg nochange","text":"
!!! warning \"No need to change anything here\"\n
"},{"location":"snippets/konami/common/spicecfg_options_nvprofile/","title":"Spicecfg options nvprofile","text":"
!!! tip \"NVIDIA GPU users ONLY\"\n\n    Enable `NVIDIA profile optimization (-nvprofile)` to let spice2x create an optimized profile for your game.\n
"},{"location":"snippets/konami/common/spicecfg_overlay/","title":"Spicecfg overlay","text":"
!!! info \"This tab is used to bind keys to toggle spice2x and game-related overlays\"\n\n!!! tip \"Binding extra buttons here is optional, defaults are fine\"\n\n    Click on `Bind` or `Naive` then press the key you want associated with the action.\n
"},{"location":"snippets/konami/common/spicecfg_patches/","title":"Spicecfg patches","text":"
!!! info \"Go through the [spice2x Patching](/extras/patchsp2x.md) to import and pick patches\"\n
"},{"location":"snippets/konami/common/spicecfg_preamble/","title":"Spicecfg preamble","text":"

Following tabs correspond to the ones found in spicecfg

Additional information is available at spice2x's wiki.

Avoid changing or patching anything you don't need or understand unless explicitly told to

"},{"location":"snippets/konami/iidx/btools_analogs/","title":"Btools analogs","text":"
!!! info \"This tab is used to bind analog controls like the turntable\"\n\n!!! warning \"Ignore this tab if you play with a keyboard\"\n\n!!! tip \"Bind your controller's turntable\"\n\n    With a controller rather than binding buttons to `TT+` and `TT-`, you need to:\n\n    - Head to the `Analogs` tab at the top\n    - In `Device`, pick your controller\n    - In `Control`, pick whichever one corresponds to the turntable\n    - Turn your turntable ensuring that the preview turns along with it\n    - Click `OK`, leaving the rest of the settings alone\n
"},{"location":"snippets/konami/iidx/btools_buttons/","title":"Btools buttons","text":"
!!! info \"This tab is used to bind your keyboard and controller buttons\"\n\n!!! tip \"\"\n\n    Double click on the right on a button that you wish to bind, then press the key you want associated with the action.\n\n    With your controller and/or keyboard plugged in, configure your keys for:\n\n    - **Maintenance**: `Service, Test`\n    - **P1 Game buttons**: `1 to 7, Start, EFFECT, VEFX` \n    - **P1 Keypad**: `Keypad Insert Card`\n\n    **Only if** you're playing using a keyboard:\n\n    - **Turntable**: `TT+, TT-` **and optionally** `TT+/-` which alternates between `TT+` and `TT-` on each press.\n
"},{"location":"snippets/konami/iidx/btools_clvsd/","title":"Btools clvsd","text":"

For background movies to work, you need to install and register a codec.

This also applies for IIDX 12 to 18, if you'd done it before you shouldn't need to again and may skip this step.

  • Inside bemanitools-supplement-vx.x.zip locate and open iidx.zip

  • Inside iidx\\misc\\, extract CLVSD.ax to any directory where the file can stay long term As an example we will be using your Documents folder, but it really could be anywhere you prefer.

  • Open a command prompt as administrator, and run regsvr32 \"CHOSEN_PATH\\CLVSD.ax\" For the Documents folder, the command would be regsvr32 \"C:\\Users\\YOUR_USERNAME\\Documents\\CLVSD.ax\"

You should get confirmation that the file has been registered successfully.

If an error occurs, you most likely didn't start your command prompt as administrator, or the location to CLVSD.ax was incorrect.

"},{"location":"snippets/konami/iidx/btools_connecting_network/","title":"Btools connecting network","text":"

Pick one or the other, not both!

Option 1: Remote (Online Network)

Remote networks typically require an invitation to join. You'll need to connect with members of the community who can provide you with an invite.

Your network should provide you with the necessary information to proceed:

  • Open iidxhook-xx.conf (xx being your game version) with a text editor

  • In the line eamuse.server=localhost:80, replace localhost:80 with your provided network url

  • In the lines eamuse.pcbid=XXXXXXXXXXXXXXXXXXXX and eamuse.eamid=XXXXXXXXXXXXXXXXXXXX, replace the part after = with your provided PCBID

  • Example: 

    # 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=http://be.ma.ni/\n\n# PCBID\neamuse.pcbid=ABMYPRECIOUSPCBIDCDE\n\n# EAMID\neamuse.eamid=ABMYPRECIOUSPCBIDCDE\n

Option 2: Local e-amuse Emulator (Asphyxia)

For instructions on setting up Asphyxia, please refer to our Asphyxia setup guide.

After Asphyxia is setup with the proper plugin for your game:

  • Open iidxhook-xx.conf (xx being your game version) with a text editor

  • In the line eamuse.server=localhost:80, replace localhost:80 to point to your asphyxia server, typically localhost:8083

  • Example: 

    # 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:8083\n

"},{"location":"snippets/konami/iidx/btools_d3d8to9/","title":"Btools d3d8to9","text":"

  • Download the latest Bemanitools supplements release here

  • Inside bemanitools-supplement-vx.x.zip locate misc.zip

  • Inside misc\\d3d8to9\\, extract d3d8.dll to your revision directory

This lets you configure graphics options inside iidxhook-xx.conf (xx being your game version number)

"},{"location":"snippets/konami/iidx/btools_graphics/","title":"Btools graphics","text":"

  • Open your iidxhook-xx.conf (xx being your game version)

  • Locate and change the options we're interested in:

gfx.framed=false                    # Only matters if windowed. False for borderless, True for decorations (title bar, etc..)\ngfx.frame_rate_limit=0.0            # Set this to 59.95\ngfx.windowed=false                  # False for fullscreen, True for windowed\ngfx.window_width=0                  # Set to your desired game width (recommended: monitor width)\ngfx.window_height=0                 # Set to your desired game height (recommended: monitor height)\ngfx.scale_back_buffer_width=0       # Set to your desired game width (recommended: monitor width)\ngfx.scale_back_buffer_height=0      # Set to your desired game height (recommended: monitor height)\ngfx.scale_back_buffer_filter=none   # Set to point or linear (pick one from examples below)\n

Here are visual examples of the two filter options:

point (sharp, pixel perfect)

linear (less sharp, not pixel perfect)

"},{"location":"snippets/konami/iidx/ldj_vs_tdj/","title":"Ldj vs tdj","text":"

Before proceeding with the setup, it's important to understand the two cabinet types for IIDX:

  • Lightning (TDJ/LDJ-010):

    • Runs at 120 FPS
    • Requires a 120 Hz main monitor
    • Optional second touchscreen 60 Hz monitor called a subscreen

  • Standard/Legacy (LDJ/LDJ-012):

    • Runs at 60 FPS
    • Requires a 60 Hz main monitor
    • No subscreen

The game data comes in two variants based on the bm2dx.dll file. You can patch an LDJ dll to run in TDJ mode, but this will disable video recording.

For simplicity, we'll use \"TDJ\" for Lightning Mode and \"LDJ\" for Standard Mode throughout our guides.

"},{"location":"snippets/konami/iidx/spicecfg_advanced_camhook/","title":"Spicecfg advanced camhook","text":"
!!! tip \"Optional: Camera hook\"\n\n    With a webcam connected, you can:\n\n    - Enable `IIDX Cam Hook (-iidxtdjcamhook)`\n    - Make sure `IIDX Disable Cameras (-iidxdisablecams)` from the `Options` tab is disabled\n    - Optionally enable `IIDX Camera Order Flip (-iidxflipcams)` if you have two cameras connected and the wrong one is being used\n\n    This allows spice2x to try and interface with your webcam to enable camera functionality in the game.\n\n    You can then bind a button to the `Camera Control` overlay in the Overlay tab to adjust camera settings.\n
"},{"location":"snippets/konami/iidx/spicecfg_analogs/","title":"Spicecfg analogs","text":"
!!! info \"This tab is used to bind analog controls like the turntable\"\n\n!!! warning \"Ignore this tab if you play with a keyboard\"\n\n!!! tip \"Bind your controller's turntable\"\n\n    With a controller, instead of binding `TT+` or `TT-` in the `Buttons` tab, you need to:\n\n    - Click `Bind`\n    - In `Device`, pick your controller\n    - In `Control`, pick the control that updates the preview when turning the turntable, typically `X`\n    - Click `Close`, leaving the rest of the settings alone\n
"},{"location":"snippets/konami/iidx/spicecfg_buttons/","title":"Spicecfg buttons","text":"
!!! tip \"Binding your buttons\"\n\n    Click on `Bind` or `Naive` then press the key you want associated with the action.\n\n    With your controller and/or keyboard plugged in, configure your keys for P1 and/or P2:\n\n    - **Maintenance**: `Service, Test`\n    - **Game buttons**: `SW1 to SW7, Start, EFFECT, VEFX` \n    - **Keypad**: `Keypad Insert Card`, `1 to 9`\n\n    **Only if** you play with a keyboard:\n\n    - **Turntable**: `TT+, TT-` **and optionally** `TT+/-` which alternates between `TT+` and `TT-` on each press.\n
"},{"location":"snippets/konami/iidx/spicecfg_options_disablecams/","title":"Spicecfg options disablecams","text":"
!!! tip \"Important\"\n\n    Enable `IIDX Disable Cameras (-iidxdisablecams)` **unless** you have a webcam connected and wish to use it with the camera hook from the advanced tab.\n
"},{"location":"snippets/konami/iidx/spicecfg_options_tdj/","title":"Spicecfg options tdj","text":"
!!! tip \"Optional: Enabling TDJ (Lightning mode)\"\n\n    You may want to enable `IITX TDJ Mode (-iidxtdj)` if your main monitor is 120 Hz capable.\n
"},{"location":"snippets/konami/sdvx/spicecfg_analogs/","title":"Spicecfg analogs","text":"
!!! info \"This tab is used to bind analog controls like knobs\"\n\n!!! warning \"Ignore this tab if you play with a keyboard\"\n\n!!! tip \"Bind your controller's knobs\"\n\n    With a controller, instead of binding to `VOL-L` and `VOL-R` in the `Buttons` tab, you need to:\n\n    - Click `Bind`\n    - In `Device`, pick your controller\n    - In `Control`, pick the control that updates the preview when turning the corresponding knob\n    - Click `Close`, leaving the rest of the settings alone\n    - Repeat for your other knob\n
"},{"location":"snippets/konami/sdvx/spicecfg_buttons/","title":"Spicecfg buttons","text":"
!!! tip \"Binding your buttons\"\n\n    Click on `Bind` or `Naive` then press the key you want associated with the action.\n\n    With your controller and/or keyboard plugged in, configure your keys for:\n\n    - **Maintenance:** `Service, Test`\n    - **Game buttons:** `BT-A, BT-B, BT-C, BT-D, FX-L, FX-R, Start`\n    - **P1 Keypad**: `Keypad 0 to 9, Keypad Insert Card`\n\n    **Only if** you play with a keyboard:\n\n    - **Knobs:** `VOL-L Left, VOL-L Right, VOL-R Left, Vol-R Right`\n
"},{"location":"snippets/sega/chunithm/data_options/","title":"Data options","text":"

SEGA games receive content updates through option folders rather than direct game file updates.

For CHUNITHM, official options are named A???, where ??? represents a sequence of numbers. Community-created options often use letters instead of numbers to differentiate them from official releases.

After downloading option files, extract them into your game's Option folder.

\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n\u2523\u2501\ud83d\udcc2A001\n\u2523\u2501\ud83d\udcc2A121\n\u2523\u2501\ud83d\udcc2A131\n\u2517\u2501 etc.\n

Option numbers don't always follow a sequential patternIt's common to see the numbers jump, for example A113 then A121

The A001 option folder may be required for network connectivity

"},{"location":"snippets/sega/chunithm/segatools_gfx/","title":"Segatools gfx","text":"
!!! tip \"Display settings\"\n\n    - Use `windowed=0` for fullscreen mode or `windowed=1` for windowed mode\n    - For multi-monitor setups in fullscreen mode, specify your target display using the `monitor` index setting\n\n??? info \"Finding your monitor index\"\n\n    Open Windows display settings to find your monitor numbers.  \n    Your monitor's index is one less than the displayed number.    \n    For example, if Windows shows \"Display 2\", use monitor index 1.\n
"},{"location":"snippets/sega/common/data_bad/","title":"Data bad","text":"

If your data doesn't look like this

If your data looks like the third example:

  • 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 directories or files are still present (executables, scripts, etc.), remove them.

This also indicates tampered data, we strongly recommend obtaining clean data from elsewhere.

"},{"location":"snippets/sega/common/data_driveletter/","title":"Data driveletter","text":"

Game data cannot run on E:\\ or Y:\\ drives, use a different drive letter

"},{"location":"snippets/sega/common/data_icfs/","title":"Data 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":"snippets/sega/common/data_modding/","title":"Data modding","text":"Modding

Mods are covered on the Unity modding page.

"},{"location":"snippets/sega/common/data_old/","title":"Data old","text":"

If you're coming from a previous version of the game

You'll want to create a new folder for the game and start from scratch. SEGA games DO NOT like being extracted over old data!

"},{"location":"snippets/sega/common/data_preparation/","title":"Data preparation","text":"
Here's what the expected original data structure should look like:\n\n```\n\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2Option\n```\n\nCreate another empty folder named `AppData` next to them:\n\n```\n\ud83d\udcc2amfs\n\ud83d\udcc2App\n\ud83d\udcc2AppData\n\ud83d\udcc2Option\n```\n\nThe `App` folder should have a file structure as follows:\n
"},{"location":"snippets/sega/common/data_updating/","title":"Data updating","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":"snippets/sega/common/network_local/","title":"Network local","text":"Option 2: Local (ARTEMiS/AquaDX)

Refer to the official guides for ARTEMiS and AquaDX to set up a local server.

"},{"location":"snippets/sega/common/network_local_artemisonly/","title":"Network local artemisonly","text":"Option 2: Local (ARTEMiS)

Refer to the official guide for ARTEMiS to set up a local server.

"},{"location":"snippets/sega/common/network_preamble/","title":"Network preamble","text":"

Pick one or the other, not both!

"},{"location":"snippets/sega/common/network_remote/","title":"Network remote","text":"Option 1: 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 Do not change the subnet from its default unless told to by your network!
[keychip]\nsubnet=192.168.XXX.XXX\nid=A69E-XXXXXXXXXXX\n
  • Create a file named aime.txt inside App\\bin\\DEVICE and type in a 20-digit access code If you don't already have one, simply make one up, just know it must not start with the number 3!
\ud83d\udcc4aime.txt\n    01234567890123456789\n
"},{"location":"snippets/sega/common/patching/","title":"Patching","text":"

Go through the Web Patching guide to learn how to use a web patcher

Avoid patching anything you don't need or understand unless explicitly told to

"},{"location":"snippets/sega/common/segatools_install/","title":"Segatools install","text":"

If you already have segatools installed, ensure you're using the latest version

  • Head over to segatools releases
  • Download segatools.zip
  • Extract the archive
"},{"location":"snippets/sega/common/segatools_preamble_bin/","title":"Segatools preamble bin","text":"

You'll need to manually edit App\\bin\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
"},{"location":"snippets/sega/common/segatools_preamble_package/","title":"Segatools preamble package","text":"

You'll need to manually edit App\\package\\segatools.ini as segatools has no graphical configuration tool.

We recommend using a text editor with syntax highlighting such as Notepad++.

The following sections match those found in segatools.ini - skip any sections not listed below.

If a key already exists in a section, simply change its value after =, do not add another key.

[system]\ndipsw1=1\ndipsw1=1 ; WRONG!\n
"},{"location":"snippets/sega/common/segatools_relativepaths/","title":"Segatools relativepaths","text":"
??? info \"Relative Paths\"\n\n    Relative paths make your configuration portable and easier to maintain.\n\n    Say your game folder structure looks like this:\n\n    ```\n    \ud83d\udcc2Game Folder\n    \u2523\u2501\ud83d\udcc2App\n    \u2503 \u2517\u2501\ud83d\udcddsegatools.ini\n    \u2517\u2501\ud83d\udcc2Option\n    ```\n\n    If `segatools.ini` needs to access the `Option` folder, you can use `../../Option/`:\n\n    - `../` moves up from `bin` to `App`\n    - `../` moves up again from `App` to the root `Game Folder`\n    - Then it can access the `Option` folder\n
"},{"location":"snippets/sega/common/segatools_vfs/","title":"Segatools vfs","text":"
!!! tip \"\"\n\n    If you've followed our recommended file structure, use these values:\n\n    ```ini\n    [vfs]\n    amfs=../../amfs\n    option=../../Option\n    appdata=../../AppData\n    ```\n\n    If not, point those to their respective folders.\n
"},{"location":"snippets/sega/common/service_jp_googlelens/","title":"Service jp googlelens","text":"

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":"snippets/sega/common/success/","title":"Success","text":"

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

"}]} \ No newline at end of file