CurseForge · Minecraft mod
Cheonsang
Replaces the overworld sky with the real sky for any date and place, with a telescope that uses real optics.
Quick answer
Which Cheonsang release should I use?
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.
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.
Install Fabric Language Kotlin, Fabric API first. We found matching files for this game-version and loader setup.
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.
- 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.
- 02
Bring the mods it needs
Install Fabric Language Kotlin, Fabric API first. We found matching files for this game-version and loader setup.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 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).
/cfindfinds any object,/cwhentells you when and where an object or event is visible, and/cplacesets 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.
/cwhenvisibility 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.
26.3
1 loader buildCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Cheonsang versions and loaders
cheonsang-2.0.2
cheonsang-2.0.2.jar
21 Nov 2026
cheonsang-2.0.1
cheonsang-2.0.1.jar
21 Nov 2026
cheonsang-2.0.0
cheonsang-2.0.0.jar
14 Nov 2026
Looking for an older file? The official CurseForge project page is in Resources.