Tutorial - earthsworth/celestial GitHub Wiki

Intro

If you have any problems please contact us on Discord

Celestial is a powerful Lunar Client launcher.

It does not contain Electron and ads, and is lightweight

Table of contents

  1. Install a Java
  2. Download Celestial
  3. Configure Celestial
  4. Troubleshooting

Install Java

We recommend you to choose azul zulu, because LunarClient uses this distribution by default.

If you want to run the latest LunarClient, you need to download JDK 21. (DO NOT USE Java HIGHER THAN 21)

If you want to run a version older than a year, you must download JDK17 (otherwise it will crash).

Are you on GNU/Linux or macOS? We recommended to use a package manager to install Java

Please select the correct OS when downloading. If you are using Windows, please download the .msi file

Download Celestial

You can get files from releases or actions.

If you want to try the latest features, you can download Celestial from actions

Please download the .jar file instead of the source code!

Run Celestial

Please replace the celestial.jar mentioned below with the real file name

Normally, you can just double-click the jar file to start Celestial.

If it says a Java Virtual Machine error, see the Troubleshooting section.

Configure Celestial (Optional)

If you want to enable plugins such as Weave, you need to enable them in Celestial

Switch Language

  1. Click "next" for some times
  2. Find the "Launcher" field
  3. Select your language
  4. Restart Celestial (Click the "X" button)

Configure RAM

Tips: Don't give all your RAM to the game, as this will actually reduce performance.

  1. Go to the "Settings" tab
  2. Drag the slider to config RAM

Weave/LunarCN Loader

LunarCN Loader is deprecated

  1. Switch to the Settings tab
  2. Find the "Addon" field
  3. Click "Weave" and make "Check for updates for Weave" is enabled

Add Mods and JavaAgents

Do not forget to enable modloaders!

  1. Go to the "Version & Launch" tab
  2. Find the "Addons Manager"
  3. Add your mods

Version Spoof

Experimental: If you don't know what you are doing, don't modify!

  1. Go to the "Settings" tab
  2. Set the "Version spoof" field to a vaild version string

Boost up your Download Speed

Please make sure your CPU can allow you to do multithreaded downloads, otherwise performance may be degraded

  1. Switch to the Settings tab
  2. Find the "Launcher" field
  3. Set "Downloader maximum thread" to 64
  4. Restart Celestial (Click the "X" button)

Troubleshooting

Get logs

The launcher log is available at ~/.cubewhy/lunarcn/logs/launcher.log

Do not double-click the file, open a CMD instance and drag the file into it. (on Microsoft Windows)

Starting from version 3.1.0, the launcher log and game log have been merged. Just open launcher.log, and you will see your game log alongside the launcher logs.

If you want to get the game logs, you should run ~/.cubewhy/lunarcn/launcher.bat (or .sh on Linux/macOS) and copy the output in your terminal

Java Virtual Machine Error

Are you using a JRE? Celestial does not support launching from a pure JRE, please use JDK instead

On older versions of Celestial, configuration file errors can also cause VM Errors. Please update your Celestial Launcher first.

First, check the version of Java by running the following command

java -version

If the result contains 21 or 17, run Celestial directly from the command line

java -jar celestial.jar

If not, you may not have Java installed yet, please go back to step 1

If you are sure you have installed it, please modify your PATH and increase the priority of Java21 (or 17)

I am not familiar with Microsoft Windows, please Google the detailed steps