minetest_moon_phase/README.md

Moon phases

Make your sky change follow a cycle

Important: This mod requires at least Minetest 5.2.0 for the game's new sky API. Make sure you have the latest version installed or update your game.

Dependencies

This mod has no hard dependencies whatsoever, so you can use it as you will. However, I do recommend using the skylayer mod. With the Minetest's new sky API it is likely for more mods to change the sky configuration, possibly resulting in conflict. This utility mod can help circumvent these issues if both mods use it.

Commands

This mod comes with two commands to print or change the current moon phase.

• Use /moonphase to view the currently active phase.
• Use /set_moonphase <phase> to change it. <phase> has to be a full number between 1 and 8.

In order to change the phase, you will need the corresponding privilege. Use /grant <player> moonphase to grant it.

Mod Integration

Just like the chat commands, this mod provides a LUA api for accessing the moon phase. It contains a method called moon_phases.get_phase() that will return a numeric value representing the current moon phase. You can also set the phase via moon_phases.set_phase(phase) where phase is an integer between 1 and 8.

Configuration

The mod provides the option to change the length of the moon cycle. By default, the moon texture will change every four (in-game) nights. This results in a total cycle of 32 days.

LICENSE

All source code is licensed under GNU LESSER GENERAL PUBLIC LICENSE version 3. You can find a copy of that license in the repository.

Media

All included moon textures are resized versions of graphics from NASA's Scientific Visualization Studio. These images are part of the Public Domain. You can access the entire (high resolution) album on their website.