# Hades Revisited
Version 0.17.0

A game for Luanti, focused on terraforming and landscaping.
Based on *Minetest Hades* by Glünngi.

THIS IS A PREVIEW VERSION OF THE GAME. This game is playable,
but incomplete. Future versions might change a lot.

Requires Luanti version 5.10.0 or later.

## Introduction

Due to a gross miscalculation of the gravitational pull of the volcanic
planet Hades, the latest terraforming attempt of your space crew went
horribly wrong! You managed to survive, but it seems you are stranded
on this hellhole of a planet full of lava, stone and ash for good!

You still have a pickaxe and some apples. Also, water is hidden inside
the tall and chaotic stone spires. So your only chance of survival is to
search for water, use your crafting skills to form some soil and plant
apple trees. More plants might follow. The underground holds great riches,
but also great dangers. Lava is death. With your new acquired resources,
maybe, just maybe, you will turn Planet Hades into a nice, habitable place.

But beware: Many were not so lucky: Mutants will haunt on the surface and
who knows what dangers might hide in the deep underground?

## Installation

### Automatic installation with ContentDB
This is the easiest method.

This game is available in Luanti’s official ContentDB! If you have an
internet connection, just go into Luanti and browse the Content
section to install the latest and greatest version of the game.

### Manual installation
If for some reason you must install this game manually, just insert
the Hades Revisited directory into

    /games/hades_revisited

in the Luanti data folder.

## Important notices and short game guide

* Be sure the `minetest.conf` file in the main Luanti directory doesn’t have any parameters who are in conflict with the `minetest.conf` file from the `hades_revisited` directory. Especially mapgen parameters or stuff like `give_initial_stuff = false`
* There only 1 biome, with the focus on terraforming and landscaping
* Not everyone will like this game. But maybe there are some freaks out there ;-)

An attempt to colonize planet Hades went horribly wrong: Your exploration ship disintegrated and you survived with very limited supplies.
Hades is a very young planet and characterized by highly volcanic activities and a lot of fertile ash. Asteroids have brought some water on Hades.
So there are the basics for life, you just need to help it to get the nature going, make the planet habitable and survive.
Not every colonist has duly arrived. Most of them have been mutated and strayed around the planet.
There are creatures and most of them live in the underground and darkness.

## How to start:

You start with the following items: 1 steel pickaxe, 12 apples, 1 wall lamp and a stick.
Watch out for flowing lava above you at first!

Next you should dig some stone to craft a stone sword with the stick.
Now explore the area and search for some water.

Dig some stone and ash. Then craft volcanic sand from those items, then
craft fertile sand from volcanic sand and stone.

Place the fertile sand next to water and wait for it to become dirt.
Turn one of your apples into apple seeds in the crafting menu.
Plant it on dirt and wait for it to grow to an apple sapling, then an apple tree.
The apple tree takes some time to bear apples, but once it does, you can pluck them and either eat them or craft them to more seeds.
Punch the tree trunk to get it, use it to craft wood, a very useful resource.
Make more dirt and place it near water.

If you ran out of fruit and seeds, or lost your pickaxe, fight some mutants. They sometimes drop apples, pickaxes and other things.

Use 2 mossy cobblestone or mossy tuff (can be found near water) combine it with dirt to craft grass seeds.

Grass + dirt = tropical grass seeds.

Dig the grass and the tropical grass to get some new seeds. Read the tooltip to learn how they grow.

Some seeds need wet soil. To get wet soil, craft a hoe and use it on dirt to get normal soil, then put water nearby to make it wet.

Now you should know enough to survive. Use the crafting guide to find out more recipes.
Read the tooltips of new items carefully to learn how they work.

## Things you should know

### Block transformations

* Fertile sand turns into dirt in the near of 10 nodes to water and direct contact of a dirt.
* Volcanic ash turns into volcanic sand if leaves are nearby.
* Volcanic sand turns into fertile sand if leaves are nearby.
* Volcanic ash slowly turns into clay when next to water.
* Flowing water turns lava source into water source and flowing lava into volcanic gravel.
* Stone, tuff and cobblestone become burned when next to lava.
* Stone, tuff and cobblestone become mossy when next to water.
* Mossy cobblestone turns into gravel when next to flowing water.
* Chondrite turns into marble if it is below -500 and it must be in near 4 nodes to lava and it also must have direct contact to water.
* Volcanic gravel turns into obsidian below Y=-1000. It must have direct contact to lava and water and must be nearby.
* Sugarcane appears near papyrus. It doesn’t need water to grow, just dirt.

### Other gameplay stuff

* There are 3 seasons: Spring, Summer and Fall. Each season has a different sky, and plants will grow differently in each season. The game starts in spring.
* There is no fire
* Beds let you set the spawn point, you can’t skip the night
* Volcanic gravel can only be dug by a shovel.
* Mobs spawn on stone, ash and tuff
* Tuff is too breakable for tools so it can’t be used to craft stone tools. Basalt, however, is fine.
* There are no buckets; you can transport water by using glass tanks
* Weak torches can be upgraded with a cotton (string) to bright torches
* Many plants grow with light level of 8 or higher. Underground farming is thus possible
* 2 emeralds = 1 sapphire. 2 sapphires = 1 ruby. 2 rubies = 1 diamond.
* With the Staff of Gaia you can turn following blocks into dirt: ash, volcanic sand, fertile sand, burned stone, stone, cobble, mossy stone, tuff, burned tuff, mossy tuff, mossy cobble
* Pale tree saplings can be planted on ash
* Cacti grow on ash (but sand is better)
* Prismatic furnace is faster than the regular furnace and has more slots
* You can center doors with the screwdriver

### Ores

Ores generate at and below the following altitudes:

    Coal . . . . . .    +60
    Iron:  . . . . .      0
    Copper:  . . . .   -115
    Tin: . . . . . .   -115
    Mese:  . . . . .   -200
    Gold:  . . . . .   -333
    Emerald: . . . .    +20
    Sapphire:  . . .   -300
    Ruby:  . . . . .   -900
    Diamond: . . . .  -1200

Craft an altimeter to learn your current altitude.

Maximum ore generation is at altitude of -10000 or below.

## Info for developers

If you’re a modder or game developer, please read `DEVELOPERS.md`.

## List of external mods (incomplete)

**Important**: A lot of the mods used in this game have been heavily changed from their original.

`hades_furniture` (based on `3dforniture`)
<https://forum.minetest.net/viewtopic.php?id=2207>

`hades_bags` (based on `bags`)
<https://forum.minetest.net/viewtopic.php?id=3081>

`hades_bedrock` (based on `bedrock`)
<http://www.moontest.org/viewtopic.php?f=11&t=9231>

`hades_farming` (based on `farming_plus`)
<https://forum.minetest.net/viewtopic.php?id=2787>

`hades_glowcrystals` (based on `glowcrystals`)
<https://forum.minetest.net/viewtopic.php?id=9047>

`hades_mapgen_lakes` (based on `highlandpools`)
<https://forum.minetest.net/viewtopic.php?id=8400>

`hades_itemshow` (based on `item_frames`)
<https://forum.minetest.net/viewtopic.php?id=5600>

`hades_chests` (based on `kerova`)
<https://forum.minetest.net/viewtopic.php?id=8054>

`mobs` (Mobs Redo)
<https://forum.minetest.net/viewtopic.php?t=9917>
<https://forum.minetest.net/viewtopic.php?f=15&t=9184>

`hades_plantslib` (massively-trimmed down version of `plantslib`)
<https://forum.minetest.net/viewtopic.php?id=3898>

`signs_lib`
<https://forum.minetest.net/viewtopic.php?id=2041>

`hades_trash` (based on `trash_can`)
<https://forum.minetest.net/viewtopic.php?id=6315>

`hades_vines` (based on `vines`)
<https://forum.minetest.net/viewtopic.php?id=2344>

`hades_doors` (based on sorcerykid’s Doors Redux)
<https://forum.minetest.net/viewtopic.php?t=24459>


## Licensing
This game is free software. It has been licensed under these licenses:

* LGPLv2.1 (or any later version) for the code
* CC BY-SA 3.0 for the media

Some mods have separate licenses:

* `hades_doors`: LGPLv3 for code, CC BY-SA 3.0 for media
* `hades_furniture`: GPLv2
* `hades_bags`: New BSD
* `hades_bedrock`: zlib
* `signs_lib`: LGPLv3
* `hades_bushes`: MIT for code, CC BY-SA 4.0 for media
* `hades_core`: CC BY-SA 4.0 for media

For detailed credits and author information, check out the readme files of the
individual mods (in the `mods` directory).

Sorry for the mess, it might be cleaned up later.

### License references

This is a reference of all license name abbreviations of the licenses listed above:

* GPLv3: GNU General Public License version 3 <https://www.gnu.org/licenses/gpl-3.0.en.html>
* GPLv2: GNU General Public License version 2 <https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html>
* LGPLv3: GNU Lesser General Public License version 3 <https://www.gnu.org/licenses/lgpl-3.0>
* LGPLv2.1: GNU Lesser General Public License version 2.1 <https://www.gnu.org/licenses/old-licenses/lgpl-2.1>
* MIT: The MIT License <https://mit-license.org/>
* New BSD: New BSD License (also known as “3-Clause BSD License”) <https://opensource.org/license/BSD-3-clause>
* zlib: zlib License <https://opensource.org/license/zlib>
* CC BY-SA 3.0: Creative Commons Attribution-ShareAlike 3.0 Unported <https://creativecommons.org/licenses/by-sa/3.0/>
* CC BY-SA 4.0: Creative Commons Attribution-ShareAlike 4.0 International <https://creativecommons.org/licenses/by-sa/4.0/>
