Back to mods
Cheonsang project artwork

CurseForge · Minecraft mod

Cheonsang

Replaces the overworld sky with the real sky for any date and place, with a telescope that uses real optics.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Cheonsang release should I use?

Updated today
Latest stable file cheonsang-2.0.2
Game version 26.3
Loader Fabric

cheonsang-2.0.2 targets 26.3 with Fabric. The project page does not say whether this file belongs on the client, dedicated server, or both. All 2 required mods have matching files.

Where it goes

Is Cheonsang required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Fabric
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does cheonsang-2.0.2 need?

cheonsang-2.0.2. Change the file and its required mods may change too.

All 2 required mods have matching files

Install Fabric Language Kotlin, Fabric API first. We found matching files for this game-version and loader setup.

Fabric Language Kotlin Needed by cheonsang-2.0.2
required
Matching file found Matched file: Fabric Language Kotlin 1.14.2+kotlin.2.4.21
Fabric API Needed by cheonsang-2.0.2
required
Matching file found Matched file: [26.3] Fabric API 0.166.2+26.3

We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add Cheonsang without breaking your instance.

Built for cheonsang-2.0.2. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use cheonsang-2.0.2. It targets 26.3 with Fabric; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    Install Fabric Language Kotlin, Fabric API first. We found matching files for this game-version and loader setup.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside cheonsang-2.0.2. It opens that exact file at the source.

About this project

What does Cheonsang add?

Cheonsang replaces the Minecraft overworld sky with the real sky for any date and any place on Earth. Stars, the Sun, the Moon and the planets are where they actually are, and you can look at them through a telescope with real optics.

Features

  • Positions of stars, Sun, Moon, planets and planetary moons computed for the observer's date and location. Planets use a truncated VSOP87 theory (1,259 terms); the maximum difference from PyEphem for 1800–2050 is 2.4″ (Neptune) to 12.6″ (Mars).
  • Stars: HYG to magnitude 9 and Tycho-2 to magnitude 13. With the optional Cheonsang Extra pack, 32,061,510 Gaia DR3 stars to magnitude 15.2.
  • Telescope with real optics: aperture 50–305 mm, eyepieces 40–3 mm, limiting magnitude, diffraction and exit pupil.
  • Galaxies, nebulae and globular clusters drawn as they look in an eyepiece, based on Digitized Sky Survey plates.
  • Sky brightness model: twilight, moonlight, airglow, light pollution, dark adaptation, extinction and refraction.
  • Solar and lunar eclipses for the observer's place, meteor showers, aurora and zodiacal light.
  • Western 88 constellations, or the Korean star map Cheonsang Yeolcha Bunyajido (289 asterisms).
  • /cfind finds any object, /cwhen tells you when and where an object or event is visible, and /cplace sets your own observing location.
  • Day and night on screen follow the real Sun altitude, including polar day and polar night. Mob spawning and sleeping follow vanilla rules.
  • English and Korean.

Requirements

  • Minecraft 26.3
  • Fabric Loader 0.20.1 or later
  • Fabric API
  • Fabric Language Kotlin
  • Java 25

On a server, install Cheonsang on the server and on every client.

Optional: Cheonsang Extra

A separate project with large data files: Gaia stars to magnitude 15.2, Milky Way at 16K and 32K, and an 8K Moon map (about 434 MB). Cheonsang works without it.

Known limitations

  • Not compatible with Iris shaders.
  • /cwhen visibility uses altitude, darkness and moonlight only (no light pollution or weather).
  • Stars use J2000 positions with precession only (no nutation, aberration or proper motion). The difference from Stellarium is about 1′.
  • Meteors follow the computer clock, so in multiplayer players see the same meteors only as closely as their clocks agree.

How this mod was made

Planning, data selection, design decisions and in-game testing were done by itsnotfineart. The source code was written with a generative AI assistant (Anthropic Claude). Star, planet and deep-sky data come from real astronomical catalogs and surveys, listed in CREDITS.txt. The icon is hand drawn and all screenshots are taken in game.

Source code and documentation

Source code, user manual and technical documentation: https://github.com/itsnotfineart/cheonsang

License

Source code: MIT. Original textures and icons: CC BY-SA 4.0. Data files keep the licenses of their sources (see CREDITS.txt inside the jar). The deep-sky sketch atlas is derived from the Digitized Sky Surveys and is CC BY-NC-SA 4.0 (non-commercial).

Project description from CurseForge.

Pick your setup

Cheonsang by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

1 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Cheonsang versions and loaders

3 of 3 releases match

Looking for an older file? The official CurseForge project page is in Resources.