Rename mod: walls → hades_walls
[minetest_hades/hades_revisited.git] / README.md
blob9b6096f1f1e7cd863b64f62ff30f0d9f1c22da5b
1 # Hades Revisited
2 Version 0.14.3
4 A game for Minetest, focused on terraforming and landscaping.
5 Based on *Minetest Hades* by Glünngi.
7 THIS IS A PREVIEW VERSION OF THE GAME. This game is playable,
8 but incomplete. And future versions might change a lot
9 and will often be incompatible and break your old worlds.
11 Requires Minetest 5.4.0.
13 ## Introduction
14 Due to a gross miscalculation of the gravitational pull of the volcanic
15 planet Hades, the latest terraforming attempt of your space crew went
16 horribly wrong! You managed to survive, but it seems you are stranded
17 on this hellhole of a planet full of lava, stone and ash for good!
19 You still have a pickaxe and a few apples. Also, water is hidden inside
20 the tall and chaotic stone spires. So your only chance of survival is to
21 search for water, use your crafting skills to form some soil and plant
22 apple trees. More plants might follow. The underground holds great riches,
23 but also great dangers, lava is death. With your new acquired resources,
24 maybe, just maybe, you will turn Planet Hades into a nice, habitable place.
26 But beware: Many were not so lucky: Mutants will haunt on the surface and
27 who knows what dangers might hide in the deep underground?
29 ## Installation
30 You need Minetest 5.4.0 to play Hades Revisited. Minetest can be found
31 online at <https://github.com/minetest/minetest/>.
33 ### Automatic installation with ContentDB
34 This is the easiest method.
36 This game is available in Minetest's official ContentDB! If you have an
37 internet connection, just go into Minetest and browse the Content
38 section to install the latest and greatest version of the game.
40 ### Manual installation
41 If for some reason you must install this game manually, just insert
42 the Hades Revisited directory into
44     /games/hades_revisited
46 in the Minetest data folder.
48 ## Important notices and short game guide
50 * Be sure the `minetest.conf` file in the main Minetest 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`
51 * There only 1 biome, with the focus on terraforming and landscaping
52 * Not everyone will like this game. But maybe there are some freaks out there ;-)
54 An attempt to colonize planet Hades went horribly wrong: Your exploration ship disintegrated and you survived with very limited supplies.
55 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.
56 So there are the basics for life, you just need to help it to get the nature going, make the planet habitable and survive.
57 Not every colonist has duly arrived. Most of them have been mutated and strayed around the planet.
58 There are creatures and most of them live in the underground and darkness.
60 ## How to start:
61 You start with the following items: 1 steel pickaxe, 12 apples, 1 wall lamp and a stick.
62 Watch out for flowing lava above you at first!
64 Next you should dig some stone to craft a stone sword with the stick.
65 Now explore the area and search for some water.
67 Dig some stone and ash to craft fertile sand and place it in neighbor to water to become dirt.
68 Take a dirt and a apple to craft a sapling. Plant the sapling on dirt to become wood and leaves from the tree.
69 If you ran out of apples or lost your pickaxe, kill some mutants. They sometimes drop apples, pickaxes and other things.
70 Make more dirt and place it near water.
72 Take 2 mossy stone (near water) and a dirt to craft grass.
74 Grass + dirt = tropical grass.
76 Dig the grass and the tropical grass to get some seeds.
78 Plant the seeds on the soil that you have placed over the water source.
80 And now survive with the crafting guide.
83 ## Things you should know
85 ### Block transformations
86 * Fertile sand (which must be crafted) turns into dirt in the near of 10 nodes to water and direct contact of a dirt.
87 * Volcanic ash turns into volcanic sand if leaves are nearly.
88 * Volcanic sand turns into fertile sand if leaves are nearly.
89 * Volcanic ash slowly turns into clay when next to water.
90 * Flowing water turns lava source into water source and flowing lava into volcanic gravel.
91 * Stone, tuff and cobblestone become burned when next to lava.
92 * Stone, tuff and cobblestone become mossy when next to water.
93 * Mossy cobblestone turns into gravel when next to flowing water.
94 * 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.
95 * Volcanic gravel turns into obsidian below Y=-1000. It must have direct contact to lava and water must be nearly.
96 * Sugarcane appears near of papyrus. It dosnt need water to grow, just dirt
98 ### Other gameplay stuff
99 * There is no fire
100 * Beds let you set the spawn point, you can't skip the night
101 * Volcanic gravel can only be dug by a shovel.
102 * Mobs spawn on stone, ash and tuff
103 * Tuff is too breakable for tools so it can't be used to craft stone tools
104 * There are no buckets, you need a water pump to spread water.
105 * Weak torches can be upgraded with a string to bright torches
106 * Plants grow with light level of 8 or higher. Underground farming is thus possible
107 * 2 emeralds = 1 sapphire. 2 sapphires = 1 ruby. 2 rubies = 1 diamond.
108 * 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
109 * Pale tree saplings can be planted on ash
110 * Cacti grow on ash
111 * Prismatic furnance is faster than the original furnance and has more slots
113 ### Ores
115 Ores generate at and below the following Y levels:
117 * Coal: +60
118 * Iron:  0
119 * Copper: -115
120 * Tin: -115
121 * Mese: -200
122 * Gold: -333
123 * Emerald: +20
124 * Sapphire: - 300
125 * Ruby: -900
126 * Diamond: -1200
127 * Max. ore generation at -10000
129 ## Hints
130 ### A save mining experience:
132     w = water
133     l = ladder
134     o = light
135     s = stone
136     - = air
137     X = lava
139     ***********
140     ssswlsss
141     ssswlsss
142     ssswloss
143     ssswlsss
144     ssswlsss
145     ssswssss
146     ss-w--ss
147     ss-w--ss
148     XXXXXXXX
149     ssssssss
150     ***********
152 ## List of external mods (incomplete)
153 **Important**: A lot of the mods used in this game have been heavily changed
154 from their original.
156 `hades_furniture` (based on `3dforniture`)
157 <https://forum.minetest.net/viewtopic.php?id=2207>
159 `hades_bags` (based on `bags`)
160 <https://forum.minetest.net/viewtopic.php?id=3081>
162 `hades_bedrock` (based on `bedrock`)
163 <http://www.moontest.org/viewtopic.php?f=11&t=9231>
165 `hades_farming` (based on `farming_plus`)
166 <https://forum.minetest.net/viewtopic.php?id=2787>
168 `hades_glowcrystals` (badsed on `glowcrystals`)
169 <https://forum.minetest.net/viewtopic.php?id=9047>
171 `hades_mapgen_lakes` (based on `highlandpools`)
172 <https://forum.minetest.net/viewtopic.php?id=8400>
174 `hades_itemshow` (based on `item_frames`)
175 <https://forum.minetest.net/viewtopic.php?id=5600>
177 `hades_chests` (based on `kerova`)
178 <https://forum.minetest.net/viewtopic.php?id=8054>
180 `mobs` (Mobs Redo)
181 <https://forum.minetest.net/viewtopic.php?t=9917>
182 <https://forum.minetest.net/viewtopic.php?f=15&t=9184>
184 `pipeworks`
185 <https://forum.minetest.net/viewtopic.php?t=2155>
187 `hades_plantslib` (massively-trimmed down version of `plantslib`)
188 <https://forum.minetest.net/viewtopic.php?id=3898>
190 `signs_lib`
191 <https://forum.minetest.net/viewtopic.php?id=2041>
193 `hades_trash` (based on `trash_can`)
194 <https://forum.minetest.net/viewtopic.php?id=6315>
196 `hades_vines` (based on `vines`)
197 <https://forum.minetest.net/viewtopic.php?id=2344>
199 `hades_doors` (based on sorcerykid’s Doors Redux)
200 <https://forum.minetest.net/viewtopic.php?t=24459>
203 ## Licensing
204 This game is free software. It has been licensed under these licenses:
206 * GNU LGPLv2.1 (or later) for the code
207 * CC BY-SA 3.0 for the media
209 Some mods have separate licenses:
211 * `hades_doors`: LGPLv3 for code, CC BY-SA 3.0 for media
212 * `hades_furniture`: GPLv2
213 * `hades_bags`: New BSD License
214 * `hades_bedrock`: zlib license
215 * `signs_lib`: LGPLv3
216 * `hades_bushes`: MIT License for code, CC BY-SA 4.0 for media
218 For detailed credits and author information, check out the readme files of the
219 individual mods (in the `mods` directory).
221 Sorry for the mess, it might be cleaned up later.