Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/seraxis/lr2oraja-endlessdream/llms.txt

Use this file to discover all available pages before exploring further.

This guide walks you through installing LR2oraja Endless Dream. By the end you will have a working Endless Dream directory that you can launch like a standard beatoraja install. Choose the tab below that matches your situation: starting fresh with no existing beatoraja install, or upgrading from an install you already have.

​
Java 17 requirement

Endless Dream requires Java 17 with JavaFX. The JRE bundled inside the beatoraja-0.8.8 JRE zip does not include JavaFX and cannot run Endless Dream.
Download the Liberica JDK Full for your operating system. On the download page, set Version to 17 LTS and Package to Full JDK. The Full JDK includes JavaFX, which is required. After installing, verify by running java -version in a terminal — you should see openjdk 17 or similar.

​
Download Endless Dream

Download the jar for your operating system from the releases page. The file will be named lr2oraja-0.8.8-endlessdream-<platform>-<version>.jar. Keep this file handy; you will copy it into your beatoraja directory in the steps below. Available builds:
  • Windows — lr2oraja-0.8.8-endlessdream-windows-<version>.jar
  • Linux — lr2oraja-0.8.8-endlessdream-linux-<version>.jar
  • macOS (Apple Silicon) — lr2oraja-0.8.8-endlessdream-macos-aarch64-<version>.jar
  • macOS (Intel) — lr2oraja-0.8.8-endlessdream-macos-<version>.jar
Development builds are published as releases on every commit if you need the latest changes.

​
Installation

Use this path if you do not already have a beatoraja install and want to set everything up from nothing.
1

Download the beatoraja 0.8.8 base package

Download the latest beatoraja-0.8.8 JRE bundled version. This zip contains the full beatoraja directory layout including skins, fonts, and default configuration files.
2

Unzip the archive

Extract the zip file to a location on your computer where you keep applications — for example, C:\Games\beatoraja0.8.8 on Windows or ~/Applications/beatoraja0.8.8 on macOS and Linux.
3

Delete the original beatoraja jar

Open the unzipped directory. Find the file named beatoraja.jar and delete it. This is the upstream beatoraja executable that Endless Dream will replace.
4

Copy the Endless Dream jar into the directory

Copy the lr2oraja-0.8.8-endlessdream-<platform>-<version>.jar you downloaded earlier into the beatoraja directory (the same folder where beatoraja.jar was).
5

Rename the jar to beatoraja.jar

Rename the copied lr2oraja.*.jar file to exactly beatoraja.jar. The launcher scripts (beatoraja.bat on Windows, beatoraja.sh on Linux and macOS) expect this filename.

​
Verify the installation

After following the steps above, your directory should contain beatoraja.jar (the renamed Endless Dream jar) alongside the standard beatoraja directory contents (skin/, player/, font/, table/, launcher scripts, and so on). On Windows you can launch the game with beatoraja.bat; on Linux and macOS use beatoraja.sh or invoke the jar directly with java -jar beatoraja.jar.
On Windows, if double-clicking beatoraja.bat opens a command window and then closes immediately, your java command is not pointing to the Liberica JDK 17 Full installation. Set the JAVA_HOME environment variable to the Liberica JDK 17 installation directory, or edit beatoraja.bat to use the full path to the java executable.

​
Next steps

With Endless Dream installed, continue to Configure Endless Dream After Installation to add your BMS music folders, choose a skin, and set up audio before playing your first chart.

Build docs developers (and LLMs) love

Get started for freeTalk to us