mirror of
https://github.com/t-affeldt/minetest_moon_phase.git
synced 2025-01-07 00:30:29 +01:00
51 lines
3.0 KiB
Markdown
51 lines
3.0 KiB
Markdown
# Moon phases
|
|
Make your moon follow a realistic 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](https://www.minetest.net/downloads/).
|
|
|
|
## Dependencies
|
|
This mod has no hard dependencies whatsoever, so you can use it as you will.
|
|
If you are also using *climate_api* then it will use the included skybox registration instead of overriding the player configuration. Thus, moon_phases will will be compatible with your weather packs.
|
|
|
|
## Changes in v2.0
|
|
- New classic moon textures!
|
|
- Skybox changes. The sky will brighten up during a full moon and turn dark during a new moon.
|
|
- Less stored data: Moon cycle now used Minetest's ``get_day_count()`` and only stores a date offset when changed via commands.
|
|
- Climate API integration. Use moon phases with your favorite weather mod
|
|
|
|
## 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.
|
|
- Use ``/set_moonstyle <style>`` to choose a texture preset. ``classic`` will result in a quadratic moon
|
|
inspired by default Minetest. ``realistic`` will result in 256x images of the real moon.
|
|
|
|
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.
|
|
The texture style of a specific player can be set with ``moon_phases.set_style(player, style)`` where ``style`` referes to either
|
|
``classic`` or ``realistic``.
|
|
|
|
## 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.
|
|
|
|
You can also set the default texture style for all players. You can choose between the same options as with the ``/set_moonstyle`` command.
|
|
|
|
## LICENSE
|
|
All source code is written by me and licensed under GNU LESSER GENERAL PUBLIC LICENSE version 3.
|
|
You can find a copy of that license in the repository.
|
|
|
|
## Media
|
|
All moon textures marked as "classic" are made by Cap for this mod and usable under a *CC BY-SA (3.0)* license.
|
|
|
|
All included "realistic" moon textures are resized versions of graphics from *NASA's Scientific Visualization Studio* by [Ernie Wright](https://svs.gsfc.nasa.gov/cgi-bin/search.cgi?person=1059).
|
|
These images are part of the Public Domain as *CC BY-SA 3.0*.
|
|
You can access the entire (high resolution) album on [their website](https://svs.gsfc.nasa.gov/4769#28564). See [NASA's media guidelines](https://www.nasa.gov/multimedia/guidelines/index.html) for more information on licensing.
|