Add sneak-jumping technique

[minetest_tutorial_subgame.git] / mods / tutorial / init.lua

tutorial = {}

-- intllib support
local S
if (minetest.get_modpath("intllib")) then
        dofile(minetest.get_modpath("intllib").."/intllib.lua")
        S = intllib.Getter(minetest.get_current_modname())
else
  S = function ( s ) return s end
end

-- Saves tutorial state into file
function tutorial.save_state()
        local str = minetest.serialize(tutorial.state)
        local filepath = minetest.get_worldpath().."/tutorialdata.mt"
        local file = io.open(filepath, "w")
        if(file) then
                file:write(str)
                minetest.log("action", "[tutorial] Tutorial state has been written into "..filepath..".")
        else
                minetest.log("error", "[tutorial] An attempt to save the tutorial state into "..filepath.." failed.")
        end
end


-- load tutorial state from file

local filepath = minetest.get_worldpath().."/tutorialdata.mt"
local file = io.open(filepath, "r")
local read = false
if file then
        local string = file:read()
        io.close(file)
        if(string ~= nil) then
                tutorial.state = minetest.deserialize(string)
                minetest.log("action", "[tutorial] Tutorial state has been read from "..filepath..".")
                read = true
        end
end
if(read==false) then
        tutorial.state = {}

        -- Is this the first time the player joins this tutorial?
        tutorial.state.first_join = true
        -- These variables store wheather a message for those events has been shown yet.
        tutorial.state.first_gold = false
        tutorial.state.last_gold = false
        tutorial.state.first_diamond = false
        tutorial.state.last_diamond = false
end

function tutorial.convert_newlines(str)
        if(type(str)~="string") then
                return "ERROR: No string found!"
        end

        local function convert(s)
                return s:gsub("\n", function(slash, what)
                        return ","
                end)
        end

        return convert(str)
end

function tutorial.register_infosign(itemstringpart, caption, fulltext)
        minetest.register_node("tutorial:sign_"..itemstringpart, {
                description = string.format(S("tutorial sign '%s'"), S(caption)),
                drawtype = "signlike",
                tiles = {"default_sign_wall.png"},
                inventory_image = "default_sign_wall.png",
                wield_image = "default_sign_wall.png",
                paramtype = "light",
                paramtype2 = "wallmounted",
                sunlight_propagates = true,
                is_ground_content = false,
                walkable = false,
                selection_box = { type = "wallmounted" },
                groups = {immortal=1,attached_node=1,tutorial_sign=1},
                legacy_wallmounted = true,
                sounds = default.node_sound_defaults(),
                on_construct = function(pos)
                        local meta = minetest.get_meta(pos)
                        local formspec = ""..
                        "size[12,6]"..
                        "label[-0.15,-0.4;"..minetest.formspec_escape(S(caption)).."]"..
                        "tablecolumns[text]"..
                        "tableoptions[background=#000000;highlight=#000000;border=false]"..
                        "table[0,0.25;12,5.2;infosign_text;"..
                        tutorial.convert_newlines(minetest.formspec_escape(S(fulltext)))..
                        "]"..
                        "button_exit[4.5,5.5;3,1;close;"..minetest.formspec_escape(S("Close")).."]"
                        meta:set_string("formspec", formspec)
                        meta:set_string("infotext", string.format(S("%s (Right-click to read)"), S(caption)))
                        meta:set_string("id", itemstringpart)
                        meta:set_string("caption", caption)
                end
        })
end

minetest.register_abm( {
        nodenames = {"group:tutorial_sign"},
        interval = 1,
        chance = 1,
        action = function(pos, node, active_object_count, active_object_count_wider)
                local meta = minetest.get_meta(pos)
                local id = meta:get_string("id")
                local caption = meta:get_string("caption")
                local formspec = ""..
                        "size[12,6]"..
                        "label[-0.15,-0.4;"..minetest.formspec_escape(S(caption)).."]"..
                        "tablecolumns[text]"..
                        "tableoptions[background=#000000;highlight=#000000;border=false]"..
                        "table[0,0.25;12,5.2;infosign_text;"..
                        tutorial.convert_newlines(minetest.formspec_escape(S(tutorial.texts[id])))..
                        "]"..
                        "button_exit[4.5,5.5;3,1;close;"..minetest.formspec_escape(S("Close")).."]"
                        meta:set_string("formspec", formspec)
                        meta:set_string("infotext", string.format(S("%s (Right-click to read)"), S(caption)))

        end }
)



-- Number of gold ingots/lumps
tutorial.gold = 13

-- Number of hidden diamonds
tutorial.diamonds = 12


        
tutorial.texts = {}
tutorial.texts.intro =
[[Welcome! This tutorial will teach you the most crucial basics of Minetest.
This tutorial assumes that you have not changed the default keybindings yet.

Let's start for the most important keybindings right now:

   Look around: Move the mouse
   Walk forwards: [W]
   Strafe left: [A]
   Walk backwards: [S]
   Strafe right: [D]
   Action: [Right mouse button]
  Pause menu (you can exit the game here): [Esc]

You will find signs with more introductionary texts throughout this tutorial.
The "action" key has many uses. For now, let's just say you need it to read
the signs. Look at one and right-click it to read it.

To look at a sign, make sure you are close enough to it and the crosshair in the
center of the screen points directly on the sign.

You can exit the tutorial at any time, the world will be automatically saved.

Now feel free to walk around a bit and read the other signs to learn more.]]

tutorial.texts.minetest =
[[Minetest itself is not a game, it is a game engine.
To be able to actually play it, you need something called a "Minetest game",
sometimes also called "subgame" or just "game". In this tutorial, we use the term,
"subgame".

Don't worry, Minetest comes pre-installed with a rather simple default subgame, oddly,
also called "Minetest"

This tutorial teaches you the basics of Minetest (the engine), things which are true for
all subgames. This tutorial does not teach you how to play a particular subgame, not
even the default one.

Minetest as well as the default subgame are unfinished at the moment, so please forgive
us when not everything works out perfectly.]]

tutorial.texts.subgame =
[[Now since you probably now the basics, you may want to actually play or build something.
Minetest comes bundled with a default subgame, which you may try out now.
Sadly, there is currently no tutorial for the default subgame.
You may want to read the "Getting Started" section of the Community Wiki,
which is more specific about the default subgame.
Said document can be found at:

<http://wiki.minetest.net/Getting_Started>

Alternatively, you may check out one of the subgames which are shared on the Minetest forums.]]


tutorial.texts.creative =
[[The creative mode is turned on. If you are here to learn how to play Minetest,
you should probably leave now, turn creative mode off and restart the
tutorial.

Roughly spoken, creative mode is for messing around with the game without
the normal gameplay restraints.

You can leave now by pressing "Leave tutorial", or later, by pressing [Esc].]]

tutorial.texts.notsingleplayer =
[[You are now playing the tutorial in multiplayer mode.
But this tutorial is optimized for the singleplayer mode.
This tutorial does not work properly with more than 1 player.

Unless you are sure no other players will join, you should
leave now and start the tutorial in singleplayer mode.]]

tutorial.texts.cam =
[=[Minetest has 3 different camera modes which determine the way you see the world.
The three modes are:

- First-person view (default)
- Third-person view from behind
- Third-person view from the front

You can change the camera mode by pressing [F7] (but you have to close this
window first).

   Switch camera mode: [F7]]=]

tutorial.texts.blocks =
[[The world of Minetest is made entirely out of blocks, or voxels, to be precise.
Blocks can be added or removed with the correct tools.

In this section, we'll show you a few special but common blocks which behave in unexpected,
ways.,

Of course, subgames can come up with more special weird blocks.]]

tutorial.texts.falling_node =
[[Some blocks need to rest on top of another block, otherwise, they fall down.
Try it and mine the block below the uppermost block.]]

tutorial.texts.attached_node =
[[Some blocks have to be attached to another block, otherwise, they drop as an item
as if you would have mined it.

Attached here is a picture frame. You can't collect or mine it directly, but if you mine
the block it is attached to, it will drop as an item which you can collect.]]

tutorial.texts.disable_jump =
[[These nasty blocks on the floor prevent you from jumping when you stand on them.]]

tutorial.texts.runover = 
[[This abyss behind this sign is so small that you can even walk over it,
as long as you don't stop midway. But you can jump over it anyways, just to be,
safe.]]

tutorial.texts.jumpup =
[[You can't reach this upper block by walking. But luckily, you are able to jump.
For our purposes, you can jump just high enough to reach one block above you.
But you can't two blocks high.
Press the space bar once to jump at a constant height.

   Jump: [Space]

Now try it to continue.]]


tutorial.texts.jumpover =
[=[Here is a slightly larger abyss. Luckily, you can also jump just far enough to
cross a gap of this width. Don't worry, the abyss is not deep enough to hurt you
when you fall down. There are stairs which lead back up here.

   Jump: [Space]]=]

tutorial.texts.orientation =
[[From this point on, there will be branching paths. For orientation, we placed
some arrow signs. They just show a short text when you hover them, that's all.

You don't have to follow the sections in any particular order, with one exception,
for which you will be informed.]]

tutorial.texts.sneak =
[=[Sneaking is a special move. As long as you sneak, you walk slower, but you are
guaranteed to not accidentally fall off the edge of a block. This also allows you to
"lean over" in a sense.
To sneak, keep the sneak key pressed. As soon as you release the sneak key,
you walk at normal speed again. Be careful not releasing the sneak key when you
are at a ledge, you might fall!

   Sneak: [Shift]

Keep in mind that the [Shift] key is used for a large number of other things in Minetest.
Sneaking only works when you are not in a liquid, stand on solid ground and are not at a
ladder.

You may try out sneaking at this little blocky pyramid.]=]

tutorial.texts.sneakjump =
[=[You can jump slightly higher if you jump while holding the sneak key.

   Sneak: [Shift]
   Jump: [Space]]=]

tutorial.texts.hotbar =
[[At the bottom of the screen you see 8 squares. This is called the 'hotbar'.
The hotbar allows you to quickly access some items from your inventory.
In our case, the upper 8 slots in your inventory.
You can change the selected item with the mouse wheel, if you have one, or with the
number keys.

   Select previous item in hotbar: [Mouse wheel up]
   Select next item in hotbar: [Mouse wheel down]
   Select item #N in hotbar: the key with the number #N

The item you've seleted is also the item you wield. This will be important later for
tools, mining, building, etc.]]


tutorial.texts.eat =
[[In this chest you find some comestibles. Comestibles are items which instantly
heal you when eaten. This removes the item from your inventory.
To eat one, select the comestible in your hotbar, then click the left mouse button.
Unlike other items, you cannot punch or attack while holding a comestible. To be able
to attack, you have to select something else.
Of course, this does not have to be the only way to heal you.

   Eat comestible: [Left mouse button]

Don't forget to take the gold ingot.]]

tutorial.texts.chest =
[[Treasure chests are a common sight in Minetest. They are actually not built-in
into the game.]]

tutorial.texts.damageblock =
[[Careful! These spikes hurt you when you stand inside, so don't walk into them.
Try to walk around and get the gold ingot.

They damage you every second you stand in them.

This is one of the many ways you can get hurt in Minetest.]]

tutorial.texts.ladder =
[[This is a ladder. Ladders help you to climb up great heights or to climb down safely.
To climb a ladder, go into the block occupied by the ladder and hold one of the
following keys:

   Climb up ladder: [Space]
   Climb down ladder: [Shift]

Note that sneaking and jumping do not work when you are at a ladder.]]

tutorial.texts.swim =
[[What you see here is a small swimming pool. You are able to swim and dive.
Diving usually costs you breath. While diving, 10 bubbles appear in the heads-up display.
These bubbles disappear over time while diving and when you are out of bubbles,
you slowly lose some health points. You have to back up to the surface from time to
time to restore the bubbles.

Movement in a liquid is slightly different than on solid ground:

   Swim forwards: [W]
   Swim backwards: [S]
   Swim leftwards: [A]
   Swim rightwards: [D]
   Swim upwards: [Space]
   Swim downwards: [Shift]

At the bottom of the pool lies a gold ingot. Try to get it!]]


tutorial.texts.dive = 
[=[To get to the other side, you have to dive here. Don't worry, the tunnel is not
long. But don't stay too long in the water, or else you take damage.
At the bottom of the pool lies a gold ingot. Try to get it!

   Swim forwards: [W]
   Swim backwards: [S]
   Swim leftwards: [A]
   Swim rightwards: [D]
   Swim upwards: [Space]
   Swim downwards: [Shift]]=]

tutorial.texts.waterfall = ""..
[=[You can easily swim up this waterfall. Go into the water and hold the space bar until you're
at the top

   Swim forwards: [W]
   Swim backwards: [S]
   Swim leftwards: [A]
   Swim rightwards: [D]
   Swim upwards: [Space]
   Swim downwards: [Shift]]=]

tutorial.texts.liquidtypes =
[=[Liquids behave somewhat weirdly in Minetest. Actually, there are 2 kinds of liquids.
If you watched the waterfall closely, you may have noticed that there is a slight difference
between the water blocks that make the waterfall, and those up here in the basin.

Minetest distinguishes between liquid source and flowing liquid.

A liquid source block is always a full cube.
A flowing liquid block looks slightly different. Often, it is not a full cube, but has a more or less
triangular shape. Also, flowing liquids usually have an unique "flowing" animation, but this may
not be the case for all liquids.

Up in the basin, you see four rows of liquid sources, followed by one row of flowing
liquids, followed by the waterfall itself. The waterfall itself is solely made of flowing liquids.

Liquid sources generate flowing liquids around them. Liquid sources can also exist on their own.
Flowing liquids are not able to exist on their own. They have to originate from a liquid source.
If the liquid source is gone, or the way to one is blocked, the flowing liquid will slowly dry
out.

To the right of this sign is a special block. When used, it will block the liquid flow.
Use that block, being close enough and looking at it, and watch the waterfall dry out.

   Use something: [Right mouse button]]=]

tutorial.texts.viscosity =
[[Minetest mods can introduce various liquids which differ in their properties.
Probably the most important property is their viscosity. Here you have some
pools which differ in their viscosity. Feel free to try them out.]]

tutorial.texts.pointing1 =
[[An important general concept in Minetest is pointing. As mentioned earlier,
there is a crosshair in the center of the screen.

You can point several things in Minetest:

- Blocks
- Dropped items
- Other players
- Many other things

You can only point one thing at once, or nothing at all. You can tell when
you point something if it is surrounded by a thin cuboid wireframe.

To point something, three conditions have to be met:
1. The thing in question must be pointable at all
2. Your crosshair must be exactly over the thing in question
3. You must be close enough to the thing

When a thing is pointed, you can do different stuff with it; e.g. collecting it,
punching it, building to it, etc. We come to all that later.

Now collect that apple from the small tree in front of this sign, and the gold bar.
To do that, you must point it and click with the left mouse button.]]


tutorial.texts.pointing2 =
[[The distance you need to point to things solely depends on the tool you carry.
Most tools share a default value but some tools may have a longer or shorter distance.

At the moment, your only "tool" is the hand. It was good enough to collect the apple
from the small tree.

Above this sign hang some apples, but you cannot reach them by normal means. At the
wall in front of this sign lies a special example tool which you can use to retrieve the apple
from afar.

To take the tool, point to it and click the left mouse button. Then select it with the
mouse wheel or the number keys. You will learn more about tools in a different section.]]

tutorial.texts.health =
[[Unless you have damage disabled, all players start with 20 hit points (HP), represented
by ten hearts in the heads-up display. One HP is represented by half a heart in this
tutorial, but the actual representation can vary from subgame to subgame.

You can take damage for the following reasons (including, but not limited to):
- Falling too deep
- Standing in a block which hurts you
- Attacks from other players
- Staying too long in a liquid

In this tutorial, you can regain health by eating a comestible. This is only an example,
mods and subgames may come with other mechanisms to heal you.

When you lose all your hit points, you die. Death is normally not really that bad in Minetest.
When you die, you will usually lose all your possessions. You are able to put yourself
into the world immediately again. This is called "respawning". Normally you appear at a
more or less random location.
In the tutorial you can die, too, but don't worry about that. You will
respawn at a special location you can't normally reach and keep all your posessions.
Subgames may introduce special events on a player's death.]]

tutorial.texts.death =
[[Oops! So it seems you just have died. Don't worry, you don't have lost any of your
possessions and you have been revived. You are still in Tutorial World at a different
location.

You have arrived at the so-called respawn location of Tutorial World. You will
always appear here after you died. This is called "respawning". In most worlds,
however, you will respawn in a slightly randomized location.

The tutorial uses a so-called fixed spawn point, so you respawn always at the same
spot. This is unusual for singleplayer worlds, but in online play, some servers
use fixed spawn points, too.

Under normal conditions you would have lost all or a part of your possessions or some
other bad thing would have happened to you. But not here, this is a tutorial.

To continue, just drop out at the end of that gangway. The drop is safe.]]




tutorial.texts.items =
[[Throughout your journey, you will probably collect many items. Once you collected
them, blocks are considered to be items, too.

Items can be stored in your inventory and selected with the hotbar (see the other signs).
You can wield any items; you can even punch with almost any item to hurt enemies.
Usually, you will deal a minimal default damage with most items. Even if you do not hold,
an item at all.
If you don't want to have an item anymore, you can always throw it away. Likewise,
you can collect items which lie around by pointing and leftclicking them.

   Collect item: [Left mouse button]
   Drop carried item stack: [Q]
   Drop single item from carried item stack: [Shift] + [Q]

On the table at the right to this sign lies an item stack of 50 rocks so you have some items,
to test out the inventory.]]

tutorial.texts.tools =
[[A tool is a special kind of item.
Tools can be used for many things, such as:
- Breaking blocks
- Collecting liquids
- Rotating blocks
- Many others!
The number of tools which are possible in Minetest is innumberable and are
too many to cover in this tutorial.
But at least we will look at a very common and important tool type: mining tools,
We will come to that in the mining section.

Many tools wear off and get destroyed after you used them for a while. In an
inventory the tool's "health" is indicated by a colored bar

Tools may be able to be repaired, see the sign about repairing.]]

tutorial.texts.inventory =
[[The inventory menu usually contains the player inventory. This allows you
to carry along items throughout the world.

Every inventory is made out of slots where you can store items in. You can store one
entire stack of items per slot, the only condition is that the items are of the same
type. In this tutorial all items except for tools stack up to 99 items, but this number
can vary in actual subgames.

Here are the controls which explain how to move around the items within the inventory:

In the game:
   Open inventory menu: [I]

When the inventory is opened and you don't hold any items:
   Take item stack: [Left mouse button]
   Take 10 items from item stack: [Middle mouse button]
   Take half item stack: [Right mouse button]

When you took an item stack in the inventory:
   Put item stack: [Left mouse button]
   Put 10 items from item stack: [Middle mouse button]
   Put single item from item stack: [Right mouse button]

You can also drop an item stack by holding it in the inventory, then clicking anywhere
outside of the window.]]

tutorial.texts.chest =
[[This is a chest. You can view its contents by right-clicking it. In the menu you will see
two inventories, on the upper part the chest inventory and on the lower part the player
inventory. Exchanging items works exactly the same as in the inventory menu.]]


tutorial.texts.build = 
[[Another important task in Minetest is building blocks.
"Building" here refers to the task of placing one block in your possession onto
another block in the world.
Unlike mining, building a block happens instantanous. To build, select a block in your
hotbar, point to any block in the world and press the right mouse button.
Your block will be immediately placed on the pointed side.
It is important that the block you want to build to is pointable. This means you cannot build
next to or on liquids by normal means.

   Build on ordinary block: [Right mouse button]

Try to get up to that little hole by using the wood blocks in the chest. There is another
gold ingot waiting for you.]]

tutorial.texts.mine =
[[Mining is a method to remove a single block with a mining tool. It is a very important
task in Minetest which you will use often.

(It is recommended that you go to the crafting and items house first. It is right in front of
this sign.)

To be able to mine a block, you need

1. to have minable block, after all,
2. to point on the block and
3. to carry an appropriate tool.

   Mine: [Left mouse button]

When you are ready, hold the left mouse button while pointing the block. Depending on
the block type and the tool properties, this can take some time. Some tools are fast with
some particular block types, some other tools may be slower to mine other block types.
If you do not carry an appropriate tool, you are not able to mine the block at all.
You can tell that you are actually mining when you see cracks or some other animation
on the block in question.

When done mining, blocks will often add one or more items to your inventory. This is called
the "drop" of a block and depends on the block type. Now try to mine those large cubes in
this area, using different tools. Note that all blocks here are just examples to show you
different kinds of drops.]]

tutorial.texts.mine_cobble =
[[This is cobblestone. You can mine it with a pickaxe.
This cobblestone will always drop itself, that means, cobblestone. Dropping itself is the
usual dropping behaviour of a block, throughout many subgames.]]

tutorial.texts.mine_wood =
[[These are wooden planks. In the tutorial, you can only mine those blocks with an axe.
Wooden planks drop themselves.

In Minetest, we use the term "mining" in a general sense, regardless of the material.]]

tutorial.texts.mine_conglomerate =
[[This is a cube of conglomerate. You need a pickaxe to mine it.
Conglomerate drops something based on probability. Conglomerate randomly drops between 1
and 5 rocks, when mined.]]

tutorial.texts.mine_glass =
[[This is some weak glass. You can break it with your bare hands. Or you can use your pickaxe,
which is faster. Note that it looks slightly different than the other glass in this world.
These glass blocks don't drop anything.]]

tutorial.texts.mine_stone =
[[This is stone. You need a pickaxe to mine it. When mined, stone will drop cobblestone.]]

tutorial.texts.mine_immortal =
[[There can always be some blocks which are not minable by any tool. In our tutorial, all
those castle walls can't me mined, for example.]]

tutorial.texts.craft1 =
[[Crafting is the task of taking several items and combining them to form a new item.
Crafting is another important task in Minetest.

To craft something, you need a few items and a so-called crafting grid.

In this tutorial, you have a grid of size 3 times 3 in your inventory.
Let's get right into crafting:

1. Take 3 sheets of paper from the chest next to this sign.
2. Open the inventory menu with [I].
3. Place the paper in the crafting grid so that they form a 1×3 vertical line.
4. A book should appear in the output slot. Click on it to take it,
   then put it in your player inventory.

This process consumes the paper.
When you have the book in your inventory, go on with the next sign.]]

tutorial.texts.craft2 =
[[To craft the book you have used a so-called crafting recipe. You must know the crafting
recipes as well so you can craft.

The crafting recipe you used in particular is a so-called shaped recipe. This means the
pattern you place in the crafting grid matters, but you can move the entire pattern
freely.

There is another kind of crafting recipe: Shapeless.
Shapeless recipes only care about which items you place in the crafting grid, but not in
which pattern. In the next chest you find some wheat. Let's make dough from it! For this,
you have to place at least 1 wheat in 4 different slots, but the other slots must be empty.
What is special about this recipe is that you can place them anywhere in the grid.

When you got your dough, go on with the next sign.]]

tutorial.texts.craft3 =
[[Do you got your dough? Good.

You may have noticed that crafting always consumes one item from each occupied slot
of the crafting grid. This is true for all crafting recipes.
You can speed crafting up a bit when you click with the middle mouse button on the
item in the output slot. Doing so will attempt to do the same craft up to 10 times,
instead of just once.

Feel free to try it with the remaining wheat or just go on with the next sign.]]

tutorial.texts.craft4 =
[[Another important thing to know about crafting are so-called groups. Crafting recipes do
not always require you to use the exactly same items every time.
This tutorial has a special recipe for books. In the chest, you will find paper in 4
different colors. You can also make a book by placing 3 paper sheets of any color
in a vertical line.
The paper color does not matter here, you can use only white paper, only orange paper
or even mix it. What is important here are the occupied slots.
This is possible because all 4 types of (example) paper belong to the same group and
our book recipe accepts not only white paper, but any paper of that group.

Feel free to experiment a bit around with this.]]

tutorial.texts.smelt =
[[This is a furnace. Furnaces can be used to turn a smeltable item with help of a fuel
to a new item. Many items can be furnace fuels, but not all. A few items are smeltable.

In order to operate a furnace, you have to put the smeltable item into the 'Source' slot
and the fuel into the 'Fuel' slot.
As soon as the items have been placed, the furnace automatically starts to smelt the
items. The furnace becomes active and consumes an item in the fuel slot. The flame
goes on and will continue burning for a given time. The time depends on the fuel type.
Some fuels burn very short, and other burn longer. In the furnace menu, the burn time
is indicated by the flame symbol. As soon as the flame goes out, the furnace may
continue burning if there is still fuel and smeltable material in the furnace,
otherwise, the furnace becomes inactive again.
The smeltable material has to be exposed to the flame for a given time as well. This
time depends on the type of the material, too. Some material smelt faster than others.
You can see the smelting progress of a single item on the progress arrow. If one item
has been smelt, the result goes to one of the output slots, where you can take it.

In the left chest you find some fuels and in the right chest you find some materials to
smelt. Feel free to experiment with the furnace a bit. Smelt the gold lump to receive
this station's gold bar.

Again, this furnace is just an example; the exact operation may differ slightly from
subgame to subgame.]]

tutorial.texts.repair =
[[Some subgames may come with a special recipe which allows you to repair your tools.
In those, repairing works always the same way:
Place two more or less worn out tools of the same kind into the crafting crid and
take the result. The result is a new tool which is slightly repaired by a fixed percentage.

Of course, this tutorial comes with such a recipe. The chest next to this sign stores
some damaged tools which you may try to repair now.]]


tutorial.texts.use =
[=[You will often meet some blocks you can use. Something special happens when you
right-click while pointing on them.
In fact, you already used such blocks: All the signs you read are "usable" blocks.

There is a strange device next to this sign. Use it and see what happens.

   Use usable block: [Right mouse button]]=]


tutorial.texts.basic_end =
[[If you think you have enough of this tutorial, you can leave at any time. There are
13 gold ingots at the stations to be found, to help you keep track.

You can find the gold ingots at the following stations:
- Ladders
- Sneaking
- Swimming
- Diving
- Waterfall
- Viscosity
- Comestibles and Eating
- Pointing
- Crafting
- Smelting
- Mining
- Building
- Damage and Health

If you've got 13 gold ingots (in total), you probably know now everything which can be
learned from this tutorial. Collecting the gold ingots is optional.

After you closed this dialog, you can press [Esc] to open the pause menu and return
to the main menu or quit Minetest.

In the next room there are some further signs with information, but it is entirely optional
and not related to gameplay.]]

tutorial.texts.fallout =
[[You somehow managed to fall from the castle or got otherwise below it!
How did you do that?

Anyways, you've got teleported back to the starting location. Whatever you did, be more
careful next time.]]

tutorial.texts.first_gold = 
[[You have collected your first gold ingot. Those will help you to keep track in this tutorial.
There are 14 gold ingots in this tutorial.

There is a gold ingot at every important station. If you collected all ingots, you are
done with the tutorial, but collecting the gold ingots is not mandatory.]]

tutorial.texts.last_gold =
[[You have collected all the gold ingots in this tutorial.

This means you have now travelled to each station. If you read and understood everything,
you have learned everything which can be learned from this tutorial.

If this is the case, you are finished with this tutorial and can leave now. But feel
free to stay in this world to explore the area a bit further.

You may also want to visit the Good-Bye room, which has a few more informational
signs with supplemental information, but nothing of is is essential or gameplay-relevant.

If you want to stay, you leave later by pressing [Esc] to open the pause menu and then
return to the main menu or quit Minetest.]]

tutorial.texts.first_diamond =
[[Great, you have found and collected a hidden diamond! In Tutorial World, there are 12 hidden
diamonds. Can you find them all? The first diamond may have been easy to collect, but the
remaining 11 diamonds probably won't be that easy.

If you manage to find them all, you will be awarded a symbolic prize.]]

tutorial.texts.last_diamond =
[[Congratulations!
You have collected all the diamonds of Tutorial World!

To recognize this achievement, you have been awarded with a diamond cup. It has been placed in
the Good-Bye Room for you.]]


tutorial.texts.controls =
[[To recap, here is an overview over the most important default controls:

   Move forwards: [W]
   Move left: [A]
   Move backwards: [S]
   Move right: [D]
   Jump: [Space]
   Sneak: [Shift]
   Move upwards (ladder/liquid): [Space]
   Move downwards (ladder/liquid): [Shift]

   Toggle camera mode: [F7]

   Select item in hotbar: [Mouse wheel]
   Select item in hotbar: [0] - [9]
   Inventory menu: [I]

   Collect pointed item: [Left mouse button]
   Drop item stack: [Q]
   Drop single item: [Shift] + [Q]

   Punch: [Left mouse button]
   Mine: [Left mouse button]
   Build/use: [Right mouse button]
   Build: [Shift] + [Right mouse button]

   Abort/open pause menu: [Esc]

You can review a shorter version of the controls in the pause menu.]]


tutorial.texts.online =
[[You may want to check out these online resources related to Minetest:

Official homepage of Minetest: <http://minetest.net/>
The main place to find the most recent version of Minetest.

Community wiki: <http://wiki.minetest.net/>
A community-based documentation website for Minetest. Anyone with an account can edit
it! It also features a documentation of the default game, which was NOT covered by
this tutorial.

Webforums: <http://forums.minetest.net/>
A web-based discussion platform where you can discuss everything related to Minetest.
This is also a place where player-made mods and subgames are published and
discussed. The discussions are mainly in English, but there is also space for
discussion in other languages.

Chat: <irc://irc.freenode.net#minetest>
A generic Internet Relay Chat channel for everything related to Minetest where people can
meet to discuss in real-time.
If you do not understand IRC, see the Community Wiki for help.]]


tutorial.register_infosign("intro", "Introduction", tutorial.texts.intro)
tutorial.register_infosign("minetest", "Minetest", tutorial.texts.minetest)
tutorial.register_infosign("cam", "Player Camera", tutorial.texts.cam)
tutorial.register_infosign("runover", "Small Abysses", tutorial.texts.runover)
tutorial.register_infosign("jumpup", "Jumping (1)", tutorial.texts.jumpup)
tutorial.register_infosign("jumpover", "Jumping (2)", tutorial.texts.jumpover)
tutorial.register_infosign("sneak", "Sneaking", tutorial.texts.sneak)
tutorial.register_infosign("sneakjump", "Sneak-jumping", tutorial.texts.sneakjump)
tutorial.register_infosign("orientation", "Information about the following tutorial sections", tutorial.texts.orientation)
tutorial.register_infosign("hotbar", "Hotbar", tutorial.texts.hotbar)
tutorial.register_infosign("eat", "Comestibles and Eating", tutorial.texts.eat)
tutorial.register_infosign("chest", "Chests", tutorial.texts.chest)
tutorial.register_infosign("damageblock", "Blocks Which Hurt You", tutorial.texts.damageblock)
tutorial.register_infosign("ladder", "Climbing Ladders", tutorial.texts.ladder)
tutorial.register_infosign("swim", "Swimming", tutorial.texts.swim)
tutorial.register_infosign("dive", "Diving", tutorial.texts.dive)
tutorial.register_infosign("waterfall", "Swimming up a Waterfall", tutorial.texts.waterfall)
tutorial.register_infosign("viscosity", "Viscosity", tutorial.texts.viscosity)
tutorial.register_infosign("liquidtypes", "Liquid sources and flowing liquids", tutorial.texts.liquidtypes)
tutorial.register_infosign("pointing1", "Pointing (1)", tutorial.texts.pointing1)
tutorial.register_infosign("pointing2", "Pointing (2)", tutorial.texts.pointing2)
tutorial.register_infosign("health", "Health and Damage", tutorial.texts.health)
tutorial.register_infosign("death", "Death and Respawning", tutorial.texts.death)
tutorial.register_infosign("items", "Items", tutorial.texts.items)
tutorial.register_infosign("tools", "Tools", tutorial.texts.tools)
tutorial.register_infosign("inventory", "Using the Inventory", tutorial.texts.inventory)
tutorial.register_infosign("chest", "Comment About Chests", tutorial.texts.chest)
tutorial.register_infosign("build", "Building Some Blocks", tutorial.texts.build)
tutorial.register_infosign("mine", "Mining blocks", tutorial.texts.mine)
tutorial.register_infosign("mine_cobble", "Mining example: Cobblestone", tutorial.texts.mine_cobble)
tutorial.register_infosign("mine_stone", "Mining example: Stone", tutorial.texts.mine_stone)
tutorial.register_infosign("mine_conglomerate", "Mining example: Conglomerate", tutorial.texts.mine_conglomerate)
tutorial.register_infosign("mine_wood", "Mining example: Wooden Planks", tutorial.texts.mine_wood)
tutorial.register_infosign("mine_glass", "Mining example: Weak glass", tutorial.texts.mine_glass)
tutorial.register_infosign("mine_immortal", "Unminable blocks", tutorial.texts.mine_immortal)
tutorial.register_infosign("blocks", "Special blocks", tutorial.texts.blocks)
tutorial.register_infosign("disable_jump", "No-jumping blocks", tutorial.texts.disable_jump)
tutorial.register_infosign("falling_node", "Falling blocks", tutorial.texts.falling_node)
tutorial.register_infosign("attached_node", "Attached blocks", tutorial.texts.attached_node)
tutorial.register_infosign("use", "Using blocks", tutorial.texts.use)
tutorial.register_infosign("craft1", "Crafting Basics", tutorial.texts.craft1)
tutorial.register_infosign("craft2", "Crafting using Shapeless Recipes", tutorial.texts.craft2)
tutorial.register_infosign("craft3", "Crafting Faster", tutorial.texts.craft3)
tutorial.register_infosign("craft4", "Crafting Groups", tutorial.texts.craft4)
tutorial.register_infosign("smelt", "Furnace Operation Instructions", tutorial.texts.smelt)
tutorial.register_infosign("repair", "Repairing Tools", tutorial.texts.repair)
tutorial.register_infosign("basic_end", "End of the Basic Tutorial", tutorial.texts.basic_end)
tutorial.register_infosign("controls", "Controls Overview", tutorial.texts.controls)
tutorial.register_infosign("online", "Online Resources", tutorial.texts.online)
tutorial.register_infosign("subgame", "Subgames", tutorial.texts.subgame)

minetest.register_node("tutorial:wall", {
        description = S("reinforced wall"),
        tiles = {"default_stone_brick.png"},
        is_ground_content = true,
        groups = {immortal=1},
        sounds = default.node_sound_stone_defaults(),
})

minetest.register_node("tutorial:reinforced_glass", {
        description = S("reinforced glass"),
        drawtype = "glasslike",
        tiles = {"tutorial_reinforced_glass.png"},
        inventory_image = minetest.inventorycube("tutorial_reinforced_glass.png"),
        paramtype = "light",
        sunlight_propagates = true,
        groups = { immortal=1 },
        sounds = default.node_sound_glass_defaults(),
})

minetest.register_node("tutorial:weak_glass", {
        description = S("weak glass"),
        drawtype = "glasslike",
        tiles = {"tutorial_weak_glass.png"},
        inventory_image = minetest.inventorycube("tutorial_weak_glass.png"),
        paramtype = "light",
        sunlight_propagates = true,
        groups = { cracky=3, oddly_breakable_by_hand=1 },
        drop = "",
        sounds = default.node_sound_glass_defaults(),
})


minetest.register_tool("tutorial:snatcher", {
        description = S("apple snatcher"),
        inventory_image = "tutorial_snatcher.png",
        wield_image = "tutorial_snatcher.png",
        wield_scale = { x = 1, y = 1, z = 1 },
        range = 10,
        tool_capabilities = {},
})

--[[ A special switch which, when flipped, exchanges day for night and vice versa. ]]
minetest.register_node("tutorial:day", {
        description = S("day/night switch (day)"),
        tiles = { "tutorial_day.png" },
        groups = {immortal=1},
        on_rightclick = function(pos, node, clicker, itemstack, pointed_thing)
                minetest.set_timeofday(0)
                minetest.set_node(pos, {name="tutorial:night"})
        end
})
minetest.register_node("tutorial:night", {
        description = S("day/night switch (night)"),
        tiles = { "tutorial_night.png" },
        groups = {immortal=1},
        on_rightclick = function(pos, node, clicker, itemstack, pointed_thing)
                minetest.set_timeofday(0.5)
                minetest.set_node(pos, {name="tutorial:day"})
        end
})

--[[ A special switch which "activates" and "deactivates" the waterfall in Tutorial World.
It only works on a prepared map! ]]
minetest.register_node("tutorial:waterfall_on", {
        description = S("waterfall switch (on)"),
        tiles = { "tutorial_waterfall_on.png" },
        groups = {immortal=1},
        on_rightclick = function(pos, node, clicker, itemstack, pointed_thing)
                local wpos = { y = 5, z = 86 }
                for x=33,46 do
                        wpos.x = x
                        minetest.set_node(wpos, {name="tutorial:wall"})
                end
                minetest.set_node({x=30,y=7,z=91}, {name="tutorial:waterfall_off"})
                minetest.set_node({x=40,y=2,z=86}, {name="tutorial:waterfall_off"})
        end
})
minetest.register_node("tutorial:waterfall_off", {
        description = S("waterfall switch (off)"),
        tiles = { "tutorial_waterfall_off.png" },
        groups = {immortal=1},
        on_rightclick = function(pos, node, clicker, itemstack, pointed_thing)
                local wpos = { y = 5, z = 86 }
                for x=33,46 do
                        wpos.x = x
                        minetest.remove_node(wpos)
                end
                minetest.set_node({x=30,y=7,z=91}, {name="tutorial:waterfall_on"})
                minetest.set_node({x=40,y=2,z=86}, {name="tutorial:waterfall_on"})
        end
})

-- Ruler (used in sneaking section)
minetest.register_node("tutorial:ruler", {
        description = S("ruler"),
        drawtype = "signlike",
        selection_box = {
                type = "wallmounted",
                wall_side = { -0.5, -0.5, 1/16, -0.4, 0.5, 0.5 },
        },
        walkable = false,
        tiles = { "tutorial_ruler.png" },
        inventory_image = "tutorial_ruler.png",
        wield_image = "tutorial_ruler.png",
        paramtype = "light",
        paramtype2 = "wallmounted",
        sunlight_propagates = true,
        groups = {immortal=1, attached_node=1},
})


--[[ Tutorial cups, awarded for achievements ]]
tutorial.cupnodebox = {
        type = "fixed",
        fixed = {
                {-0.3,-0.5,-0.3,0.3,-0.4,0.3}, -- stand
                {-0.1,-0.4,-0.1,0.1,0,0.1}, -- handle
                {-0.3,0,-0.3,0.3,0.1,0.3}, -- cup (lower part)
                -- the 4 sides of the upper part
                {-0.2,0.1,-0.3,0.2,0.5,-0.2},
                {-0.2,0.1,0.2,0.2,0.5,0.3},
                {-0.3,0.1,-0.3,-0.2,0.5,0.3},
                {0.2,0.1,-0.3,0.3,0.5,0.3},
        }
}

--[[ awarded for collecting all gold ingots ]]
minetest.register_node("tutorial:cup_gold", {
        description = S("golden cup"),
        tiles = { "default_gold_block.png" },
        paramtype = "light",
        drawtype = "nodebox",
        node_box = tutorial.cupnodebox,
        groups = { immortal = 1 }
})

--[[ awarded for collecting all diamonds ]]
minetest.register_node("tutorial:cup_diamond", {
        description = S("diamond cup"),
        tiles = { "default_diamond_block.png" },
        paramtype = "light",
        drawtype = "nodebox",
        node_box = tutorial.cupnodebox,
        groups = { immortal = 1 }
})



--[[ This function shows a simple dialog window with scrollable text
        name: name of the player to show the formspec to
        caption: Caption of the dialog window (not escaped)
        text: The text to be shown. Must be escaped manually for formspec, an unescaped
              comma generates a line break.
]]
function tutorial.show_default_dialog(name, caption, text)
        local formspec = "size[12,6]"..
        "label[-0.15,-0.4;"..minetest.formspec_escape(caption).."]"..
        "tablecolumns[text]"..
        "tableoptions[background=#000000;highlight=#000000;border=false]"..
        "table[0,0.25;12,5.2;text_table;"..
        tutorial.convert_newlines(minetest.formspec_escape(S(text)))..
        "]"..
        "button_exit[4.5,5.5;3,1;close;"..S("Close").."]"
        minetest.show_formspec(name, "tutorial_dialog", formspec)
end

minetest.register_on_joinplayer(function(player)
        local formspec = nil
        if(minetest.is_singleplayer() == false) then
                formspec = "size[12,6]"..
                "label[-0.15,-0.4;"..minetest.formspec_escape(S("Warning: You're not playing in singleplayer mode")).."]"..
                "tablecolumns[text]"..
                "tableoptions[background=#000000;highlight=#000000;border=false]"..
                "table[0,0.25;12,5.2;creative_text;"..
                tutorial.convert_newlines(minetest.formspec_escape(S(tutorial.texts.notsingleplayer)))..
                "]"..
                "button_exit[2.5,5.5;3,1;close;"..minetest.formspec_escape(S("Continue anyways")).."]"..
                "button_exit[6.5,5.5;3,1;leave;"..minetest.formspec_escape(S("Leave tutorial")).."]"
        elseif(minetest.setting_getbool("creative_mode")) then
                formspec = "size[12,6]"..
                "label[-0.15,-0.4;"..(minetest.formspec_escape(S("Warning: Creative mode is active"))).."]"..
                "tablecolumns[text]"..
                "tableoptions[background=#000000;highlight=#000000;border=false]"..
                "table[0,0.25;12,5.2;creative_text;"..
                tutorial.convert_newlines(minetest.formspec_escape(S(tutorial.texts.creative)))..
                "]"..
                "button_exit[2.5,5.5;3,1;close;"..minetest.formspec_escape(S("Continue anyways")).."]"..
                "button_exit[6.5,5.5;3,1;leave;"..minetest.formspec_escape(S("Leave tutorial")).."]"

        else
                if(tutorial.state.first_join==true) then
                        formspec = "size[12,6]"..
                        "label[-0.15,-0.4;"..minetest.formspec_escape(S("Introduction")).."]"..
                        "tablecolumns[text]"..
                        "tableoptions[background=#000000;highlight=#000000;border=false]"..
                        "table[0,0.25;12,5.2;intro_text;"..
                        tutorial.convert_newlines(minetest.formspec_escape(S(tutorial.texts.intro)))..
                        "]"..
                        "button_exit[4.5,5.5;3,1;close;"..minetest.formspec_escape(S("Close")).."]"
                end
                tutorial.state.first_join = false
                tutorial.save_state()
        end
        if(formspec~=nil) then
                minetest.show_formspec(player:get_player_name(), "intro", formspec)
        end
end
)

minetest.register_on_player_receive_fields(function(player, formname, fields)
        if(fields.leave) then
                minetest.kick_player(player:get_player_name(), S("You have voluntarily exited the tutorial."))
        end
        if(fields.gotostart) then
                tutorial.back_to_start(player)
        end
        if(fields.gotoend) then
                tutorial.go_to_end(player)
        end
end)

tutorial.steptimer = 0
minetest.register_globalstep(function(dtime)
        tutorial.steptimer = tutorial.steptimer + dtime
        local players = minetest.get_connected_players()
        if(tutorial.steptimer > 2) then
                for p=1,#players do
                        local player = players[p]
                        local name = player:get_player_name()
                        if(player:getpos().y < -12 and (not minetest.setting_getbool("creative_mode"))) then
                        -- teleport players back to the start when they fell away
                                tutorial.back_to_start(player)
                                tutorial.show_default_dialog(name, S("You fell from the castle!"), tutorial.texts.fallout)

                        else
                                local inv = player:get_inventory()
                                local state_changed = false

                                if(tutorial.state.first_gold ~= true) then
                                        local gold_stack = ItemStack("default:gold_ingot 1")
                                        if(inv:contains_item("main", gold_stack)) then
                                                tutorial.show_default_dialog(
                                                        name,
                                                        S("Gold ingots in the tutorial"),
                                                        tutorial.texts.first_gold
                                                )
                                                tutorial.state.first_gold = true
                                                state_changed = true
                                        end
                                end
                                if(tutorial.state.last_gold ~= true) then
                                        local gold_stack = ItemStack("default:gold_ingot "..tostring(tutorial.gold))
                                        if(inv:contains_item("main", gold_stack)) then
                                                local formspec = "size[12,6]"..
                                                "label[-0.15,-0.4;"..minetest.formspec_escape(S("You've finished the tutorial!")).."]"..
                                                "tablecolumns[text]"..
                                                "tableoptions[background=#000000;highlight=#000000;border=false]"..
                                                "table[0,0.25;12,5.2;creative_text;"..
                                                tutorial.convert_newlines(minetest.formspec_escape(S(tutorial.texts.last_gold)))..
                                                "]"..
                                                "button_exit[0.5,5.5;3,1;close;"..minetest.formspec_escape(S("Continue")).."]"..
                                                "button_exit[4.5,5.5;3,1;leave;"..minetest.formspec_escape(S("Leave tutorial")).."]"..
                                                "button_exit[8.5,5.5;3,1;gotoend;"..minetest.formspec_escape(S("Go to Good-Bye room")).."]"

                                                minetest.show_formspec(name, "tutorial_last_gold", formspec)

                                                minetest.set_node({x=19,y=2,z=72}, {name="tutorial:cup_gold"})
                                                tutorial.state.last_gold = true
                                                state_changed = true
                                        end
                                end

                                if(tutorial.state.first_diamond ~= true) then
                                        local diamond_stack = ItemStack("default:diamond 1")
                                        if(inv:contains_item("main", diamond_stack)) then
                                                tutorial.show_default_dialog(
                                                        name,
                                                        S("You found a hidden diamond!"),
                                                        tutorial.texts.first_diamond
                                                )
                                                tutorial.state.first_diamond = true
                                                state_changed = true
                                        end
                                end
                                if(tutorial.state.last_diamond ~= true) then
                                        local diamond_stack = ItemStack("default:diamond "..tostring(tutorial.diamonds))
                                        if(inv:contains_item("main", diamond_stack)) then
                                                local formspec = "size[12,6]"..
                                                "label[-0.15,-0.4;"..minetest.formspec_escape(S("You have collected all hidden diamonds!")).."]"..
                                                "tablecolumns[text]"..
                                                "tableoptions[background=#000000;highlight=#000000;border=false]"..
                                                "table[0,0.25;12,5.2;last_diamond_text;"..
                                                tutorial.convert_newlines(minetest.formspec_escape(S(tutorial.texts.last_diamond)))..
                                                "]"..
                                                "button_exit[2.5,5.5;3,1;close;"..minetest.formspec_escape(S("Continue")).."]"..
                                                "button_exit[6.5,5.5;3,1;gotoend;"..minetest.formspec_escape(S("Go to Good-Bye room")).."]"
                                                minetest.show_formspec(name, "tutorial_last_diamond", formspec)

                                                minetest.set_node({x=19,y=2,z=74}, {name="tutorial:cup_diamond"})
                                                tutorial.state.last_diamond = true
                                                state_changed = true
                                        end
                                end

                                if(state_changed) then
                                        tutorial.save_state()
                                end
                        end
                end
                tutorial.steptimer = 0
        end
end)

function tutorial.back_to_start(player)
        player:setpos({x=42,y=0.5,z=28})
end

function tutorial.go_to_end(player)
        player:setpos({x=23,y=0.5,z=74})
end

--[[
FIXME: This does not work in 0.4.10 thanks to a bug. Uncomment this as soon as
set_physics_override gets fixed

function tutorial.disable_sneak_glitch(player)
        player:set_physics_override({sneak_glitch=false, sneak=false})
end

minetest.register_on_newplayer(tutorial.disable_sneak_glitch)
minetest.register_on_joinplayer(tutorial.disable_sneak_glitch)
minetest.register_on_respawnplayer(tutorial.disable_sneak_glitch)
]]


--[[
Helper tools for sign text extracting
must be called with /lua from luacmd
An ugly, quick and dirty hack.
TODO: Toss away intllib in favor of gettext as soon as possible
]]

function tutorial.convert_newlines_for_intllib(str)
        local function convert(s)
                return s:gsub("\n", function(slash, what)
                        return "\\n"
                end)
        end

        return convert(str)
end

function tutorial.extract_texts()
        local filepath = minetest.get_modpath("tutorial").."/locale/template_texts.txt"
        local file = io.open(filepath, "w")
        if(file) then
                for k,v in pairs(tutorial.texts) do
                        file:write("# Tutorial text: "..k.."\n")
                        file:write(tutorial.convert_newlines_for_intllib(v).."\n\n")
                end
        else
                minetest.log("error", "[tutorial] An attempt to write into "..filepath.." failed.")
        end
        io.close(file)
end