Beatoraja 실행 방법 - kuroling/kor_beatoraja_wiki GitHub Wiki

Beatoraja는 https://mocha-repository.info/download.php 에서 다운로드 할 수 있습니다.

최신 릴리즈의 Beatoraja는 Latest Release 항목으로 제공됩니다.

현재 Mocha-ir 에서 제공되는 최신 버전은 0.8.8 버전으로, 다음과 같이 제공되고 있습니다.

beatoraja-0.8.8-jre-win64

beatoraja-0.8.8-modernchic

-jre-win64로 끝나는 버전은 윈도우 64bit OS용 Java가 포함되어 배포되는 버전이나, 일본어 윈도우를 바탕으로 제작되어 있어 추가 설정이 필요합니다.

-modernchic으로 끝나는 버전은 Java가 포함되지 않은 상태로 배포되는 버전으로, 추가적인 Java 설치 및 설정이 필요합니다.


-jre-win64 실행 방법

다운로드한 zip 파일의 압축을 푼 후, 압축을 푼 디렉토리 안에 있는 beatoraja.exe 파일을 삭제합니다.

그 다음, 메모장을 이용해 다음 내용을 복사한 후 beatoraja.bat 파일을 생성합니다.

(beatoraja.bat 파일은 압축을 푼 파일이 있는 디렉토리에 있어야 정상적으로 동작합니다.)

생성한 beatoraja.bat 파일을 실행하여 beatoraja를 실행하기 바랍니다.


-modernchic에서 java를 사용해 실행하는 방법

만약 java가 설치되지 않은 경우, Oracle에서 제공하는 java 를 다운로드한 후, 설치합니다.

주의 : Beatoraja는 64bit java 사용을 권장합니다.

다운로드한 beatoraja zip 파일의 압축을 푼 다음, beatoraja.bat 파일의 내용을 이 파일로 변경합니다.

수정한 beatoraja.bat 파일을 사용하여 beatoraja를 실행합니다.


-modernchic에서 openjdk를 사용해 실행하는 방법(고급 사용자 용)

주의 : Beatoraja는 64bit openjdk 사용을 권장합니다.

Openjdk를 사용해 실행하는 경우, Openjdk 및 Javafx가 있어야 Beatoraja를 실행할 수 있습니다.

윈도우 10 이상을 사용하는 경우, 이 파일 을 실행하면 됩니다.

OS 종류에 맞는 Openjdk17 또는 Openjdk21와, Javafx를 다운로드 합니다.

주의 : 일반적으로 Openjdk 사용 시 LTS 버전 사용을 권장합니다. 해당 정보는 여기서 확인할 수 있습니다.(Release에 LTS가 표기된 버전이 LTS 버전입니다. LTS 버전의 Openjdk는 17 / 21입니다.

다운로드한 beatoraja.zip 파일의 압축을 푼 후, jdk 폴더와 javafx-sdk 폴더를 압축을 푼 폴더 안에 생성합니다.

다운로드한 Openjdk의 내용을 beatoraja/jdk 폴더로 이동합니다.

다운로드한 javafx의 내용을 beatoraja/javafx-sdk 폴더로 이동합니다.

그 후, beatoraja.bat 파일을 이 파일로 변경합니다.

수정한 beatoraja.bat 파일을 사용하여 beatoraja를 실행합니다.


.bat 파일 설정 참고 자료

.bat 파일에서 -Xms4g -Xmx4g 부분은 beatoraja에 메모리 할당과 관련이 있습니다.

초기 설정은 -Xms1g -Xmx4g 입니다.

만약 본인의 PC의 메모리가 4GB 이하인 경우, -Xms1.6g -Xmx1.6g로 변경 후 실행하기 바랍니다.

장착된 PC의 메모리 용량에 여유가 있는 경우, 이 설정을 늘려도 되나 31g를 초과시 문제가 생길 수 있습니다.

32bit OS 구동 방법

32bit OS의 경우 -Xms1.6g -Xmx1.6g로 설정하기 바랍니다.


알려진 실행 오류

64bit OS에 32bit java를 설치하여 제대로 실행이 되지 않은 사례가 보고되었습니다.

java 설치 후 환경 변수 설정이 제대로 되지 않아 실행이 되지 않은 사례가 보고되었습니다.

Openjdk 사용 시, javafx가 없어 실행이 되지 않은 경우가 자주 발생합니다. javafx가 있는지 반드시 확인 바랍니다.

Beatoraja는 인텔 HD3000 이하의 내장 그래픽 카드에서는 제대로 동작하지 않습니다.