BMS 구동기 중 하나인 비토라자(beatoraja) 가이드


------------------------------------------------------------

다운로드 & 실행


https://mocha-repository.info/download.php 에서 비토라자를 받을 수 있다



Latest Release 항목을 보면 3개의 항목이 있다


-jre-win64로 끝나는 항목 : 기본적으로 Windows 64bit용 Java가 포함되어 있는 버전이다. 


-modernchic으로 끝나는 항목 : Java가 포함되어 있지 않은 버전이다. 


그냥 버전명으로 끝나는 항목 : beatoraja가 기존에 설치된 사람이 업데이트 하는데 사용하는 파일이다.



-jre-win64로 된 버전은 내가 Java나 OpenJDK 설치 같은걸 전부 건너뛰고 싶고, Windows 64bit를 사용하는 경우 받으면 된다.


그 외의 경우, -modernchic으로 끝나는걸 받으면 된다.(Windows 32bit, OpenJDK 사용, 다른 OS 등등)



1. -jre-win64를 받은 경우, 압축을 풀면 다음과 같은 내용물이 있다.



일본어 윈도우를 쓰는 경우가 아니라면, beatoraja.exe를 실행하면 실행이 안된다.


beatoraja.exe를 지운 후, beatoraja.bat 파일을 생성한 후 beatoraja.bat 파일을 실행하여 비토라자를 실행하면 된다.


생성해야 되는 beatoraja.bat 파일 내용은 다음과 같다.


REM *** Set system-wide "_JAVA_OPTIONS" environment variable to use OpenGL pipeline (improved performance of > 30% potentially. Also use anti-aliasing for non-LR2 fonts, and finally allow Swing framework to utilize AA and GTKLookAndFeel for config window. ***
set _JAVA_OPTIONS='-Dsun.java2d.opengl=true -Dawt.useSystemAAFontSettings=on -Dswing.aatext=true -Dswing.defaultlaf=com.sun.java.swing.plaf.gtk.GTKLookAndFeel' -Dfile.encoding="UTF-8"
pushd %~dp0
.\jre\bin\java.exe -Xms4g -Xmx4g -cp beatoraja.jar;ir/* bms.player.beatoraja.MainLoader
popd



.exe 파일 제거 후 .bat 파일 생성 후 실행하면 beatoraja가 실행된다.


beatoraja 실행할 때 앞으로도 이 .bat 파일로 실행하면 된다.




2. -modernchic으로 끝나는걸 받은 경우, 압축을 풀면 다음과 같은 내용물이 있다.


이 버전은 Java가 포함되어 있지 않다.


그냥 Java를 설치해서 구동하고 싶은 경우,  https://www.java.com/ko/download/ 에 가서 OS에 맞는 Java를 설치하면 된다


그 다음 beatoraja-config.bat 파일을 열어서


REM *** Set system-wide "_JAVA_OPTIONS" environment variable to use OpenGL pipeline (improved performance of > 30% potentially. Also use anti-aliasing for non-LR2 fonts, and finally allow Swing framework to utilize AA and GTKLookAndFeel for config window. ***
set _JAVA_OPTIONS='-Dsun.java2d.opengl=true -Dawt.useSystemAAFontSettings=on -Dswing.aatext=true -Dswing.defaultlaf=com.sun.java.swing.plaf.gtk.GTKLookAndFeel' -Dfile.encoding="UTF-8"
pushd %~dp0
java -Xms4g -Xmx4g -cp beatoraja.jar;ir/* bms.player.beatoraja.MainLoader
popd

으로 바꿔주면 된다.


첫 줄 맨 뒤에  -Dfile.encoding="UTF-8"  추가

세번째 줄을  java -Xms4g -Xmx4g -cp beatoraja.jar;ir/* bms.player.beatoraja.MainLoader 로 바꾼다고 보면 된다


만약 OpenJDK를 사용해서 구동하고 싶은 경우


https://docs.aws.amazon.com/ko_kr/corretto/latest/corretto-17-ug/downloads-list.html 나 https://jdk.java.net/17/ 에서 JDK를 받고


https://gluonhq.com/products/javafx/ 에서 JavaFX를 받는다



그 다음 beatoraja 폴더 안에 jdk 폴더 안에 jdk 내용물을, javafx-sdk 폴더 안에 javafx 내용물을 밀어 넣는다.


그리고  beatoraja-config.bat 파일을 열어서 


REM *** Set system-wide "_JAVA_OPTIONS" environment variable to use OpenGL pipeline (improved performance of > 30% potentially. Also use anti-aliasing for non-LR2 fonts, and finally allow Swing framework to utilize AA and GTKLookAndFeel for config window. ***
set _JAVA_OPTIONS='-Dsun.java2d.opengl=true -Dawt.useSystemAAFontSettings=on -Dswing.aatext=true -Dswing.defaultlaf=com.sun.java.swing.plaf.gtk.GTKLookAndFeel' -Dfile.encoding="UTF-8"
pushd %~dp0
start /abovenormal /wait /b jdk/bin/java -Xms4g -Xmx4g --module-path javafx-sdk/lib --add-modules=javafx.controls,javafx.fxml -XX:+UseShenandoahGC -XX:+ExplicitGCInvokesConcurrent -XX:+TieredCompilation -XX:+UseNUMA -XX:+AlwaysPreTouch -XX:-UsePerfData -XX:+UseThreadPriorities -XX:+ShowCodeDetailsInExceptionMessages -cp beatoraja.jar;ir/* bms.player.beatoraja.MainLoader
popd


이렇게 바꿔주면 된다



기타 참고 사항


1.  -Xms4g -Xmx4g  부분은 beatoraja에 메모리를 할당하는 부분이라고 알고 있으면 된다.


초기 세팅값은 -Xms1g -Xmx4g인데, 메모리 많으면 더 늘려줘도 된다. 대부분의 경우 저기 있는 값 복사해서 쓰면 된다.


2. 32bit 윈도우의 경우 OS상에서 사용 가능한 메모리가 보통 3.4 ~ 3.6GB 내외로 나올텐데


-Xms1.6g -Xmx1.6g로 세팅해서 쓰면 된다.


3. 만약 실행하는데 에러나는 경우, .bat 파일 아래에 pause 라고 적은 줄 하나 추가해서 올려주면 된다.


보통 에러나는 경우


- java가 없다 or .bat 파일과 .jar 파일이 다른 경로에 있다

- java 환경변수 설정이 잘못되었다

- 메모리 할당을 너무 크게 했거나 값이 잘못되었다

- javaFX가 없다


이 넷 중 하나라고 보면 된다.