A configurable astronomy mod that adds a realistic night sky with real life stars, planets and much more. This mod is for those who want to explore the stars while playing minecraft.
Features
- Adds over 100,000 real life stars and all constellations
- Adds planets, moons and asteroids that move around the night sky
- Realistic seasonal sun and moon positions, with changing day / night lengths
- Shooting Stars and Meteor Showers
- Rare astronomical events such as eclipses
- Customizable with a menu, you can change the entire solar system
- Fully Client Side (Works on any server)
Stars
Astrocraft replaces Minecraft's default stars with stars from real life. If you are familiar with any constellations, you should be able to pick them out. These stars revolve around the north star (Polaris). The mod renders stars similar to in vanilla (small squares), but they now have color, some being more reddish, others blue.
Planets
By default, all major planets, along with many other objects in the solar system, can be seen using this mod. Planets are rendered similarly to stars when not zoomed in, although typically brighter / larger and more vividly colored.
The positions of these planets in the sky are calculated from their orbital parameters (fully configurable), while also taking into account earth's own orbit. These include:
- Semi-Major Axis
- Orbital period
- Eccentricity
- Inclination
- Obliquity / Axial Tilt (For moons of planets)
- Precession
The brightness or size of a planet is calculated using:
- Absolute Magnitude (H)
- Distance to Earth / Observing Planet
- Distance to the Sun
- Phase Angle (Different phase curve models are used for different planets)
Satellites of planets (including The Moon) or even the Sun use the same algorithm. When the angular diameter of a planet exceeds a certain size, the mod switches from star-like rendering to vanilla-moon-like rendering.
Using a spyglass allows you to see stars, planets, asteroids or moons that are too faint to see with the naked eye. In some cases, large planets can be rendered with a texture, some showing phases like the moon (this is the case with Venus).
Below is a table of the major planets (except Earth), with descriptions of their ingame appearances:
| Planet | Brightness | In-game Color | Notes |
|---|---|---|---|
| Mercury | Moderate | White | Always within ~25° of the sun |
| Venus | Very Bright | White | Always within 45° of the sun |
| Mars | Dim-Bright | Red | Dim when near the sun, bright when in opposition |
| Jupiter | Bright | Yellow-Brown | Four moons visible using a spyglass |
| Saturn | Dim | Yellow-Green | Has rings that are visible with enough zoom |
| Uranus | Very Dim | Cyan | Usually requires a spyglass to view |
| Neptune | Very Dim | Blue | Difficult to view, even with a spyglass |
Over 100 asteroids have also been added. These appear almost indistinguishable from dim stars, but subsequent observations may show their movements.
Changes to the Sun & Moon
Positions in the Sky
Unlike in vanilla minecraft, where the sun, moon and stars pass overhead, they will now be tilted by the latitude set in the configuration (30°N by default). Additionally, the sun's path is also affected by its declination which changes throughout the year cycle (365 ingame days by default). This makes it similar to real life, where the sun only passes overhead in the tropics. Disable the 'Angled Sky' setting in the config for vanilla behavior.
Throughout the year, the sun moves relative to the stars, traveling through the zodiac. This determines which stars can be seen at a given time.
The Moon
The moon's position relative to the sun will depend on the moon's phase. At full moon, the moon stays opposite the sun, just like in vanilla minecraft. However, during a crescent phase, the moon will appear just to the left or right of the sun, and can be seen during the day. This mod also adds moonlight, which lights up the night around the full moon.
Varying Day / Night Lengths
Times of sunrise / sunset are also affected by the sun's declination (longer days around the summer solstice, shorter around the winter solstice). Setting latitude to 90° or -90° in the configuration will simulate polar day / night.
Eclipses
This mod adds rare astronomical events such as eclipses. A lunar eclipse occurs when a full moon coincides with the moon crossing the ecliptic. The moon turns red and moonlight dims for a few minutes. During a new moon, the moon can partially or fully cover the sun, blocking out the sunlight and dimming the sky. Other astronomical objects, such as Mercury and Venus can also eclipse the sun, appearing similarly to sun spots.
Customization
If you have mod menu installed you can open the configuration menu, otherwise edit the config file at: "config/astrocraft.json".
Here you can toggle stars or planets off, disable star color, add your own stars and much more. The main option affecting performance is "Magnitude Limit", reduce this if you need to.
Multiplayer Compatibility
Other players on multiplayer worlds with Astrocraft installed will see the same stars and planets as you. However, this won't be the case if you change certain settings, such as "year length" or planets' orbits. Keep this in mind, if you are viewing the night sky with friends.
Constellations
Astrocraft can assist you in learning the constellations by drawing them in the sky. Enable the "Show Constellations" option under the "Stars" category. It will now show you which stars make up each constellation.
Planets
In the "Planet" category of the menu, you will find a list of all the planets added by the mod. Here you can edit the appearance and orbit of any planet, including earth. Each planet has a list of moons, these can be edited the same way as any planet. You can also add new planets and moons in the config. Using the "Observing Planet" option, you can easily switch the perspective from Earth to any planet or moon. This affects the position of the stars and other planets in the sky. It also allows you to get a close up view of nearby celestial bodies (like Jupiter from Europa)
Other
- Setting the latitude to a value above 90° will activate dynamic latitude (latitude is decided based on Z coordinate. A globe can be simulated by setting latitude to how many blocks away the poles are from the equator on your hypothetical globe. The stars will now tilt as you walk north or south.
- Background stars can be edited using resource packs, at "assets/astrocraft/stars.txt". If you only want to add a few stars, use the custom star list in the menu.
Features not added by this mod
- Nebulae / Galaxies (Except the Milky Way)
- Space Travel (No planet dimensions or rockets, this is only a visual mod)
Incompatibilities
- BadOptimizations: This can be fixed by setting "enable_sky_angle_caching_in_worldrenderer" to "false" in the BadOptimizations config file at "config/badoptimizations.txt".
- Shaders
It is not recommended to use this mod with shaders due to compatibility issues, although this is being worked on.#
Use Sinytra Connector if you want to use with forge, I will not be porting it.
If the mod breaks after updating, try resetting everything in the config, or delete the config file.