added descriptions for the new Boulder Dash game elements

diff --git a/docs/elements/bd_acid.txt b/docs/elements/bd_acid.txt
new file mode 100644 (file)
index 0000000..fd41985
--- /dev/null
+++ b/docs/elements/bd_acid.txt
@@ -0,0 +1,2 @@
+Acid eats sand. Sometimes it spreads in all four directions, leaving a small
+explosion behind. If there is no sand to swallow, it just disappears.

diff --git a/docs/elements/bd_amoeba_2.txt b/docs/elements/bd_amoeba_2.txt
new file mode 100644 (file)
index 0000000..5072325
--- /dev/null
+++ b/docs/elements/bd_amoeba_2.txt
@@ -0,0 +1,3 @@
+Another BD style amoeba, which behaves exactly like the other one.
+But it lives its own life. Sometimes, when they collide, they produce an
+explosion.

diff --git a/docs/elements/bd_biter.txt b/docs/elements/bd_biter.txt
new file mode 100644 (file)
index 0000000..6399048
--- /dev/null
+++ b/docs/elements/bd_biter.txt
@@ -0,0 +1,4 @@
+Biters will eat all the dirt they can reach. They move in a predictable way.
+They can also eat diamonds, so better don't let them be taken away. They will
+move through rocks throwing them behind if there is no space for turning. That
+way, you can get rid of rocks blocking your way.

diff --git a/docs/elements/bd_biter_switch.txt b/docs/elements/bd_biter_switch.txt
new file mode 100644 (file)
index 0000000..616f563
--- /dev/null
+++ b/docs/elements/bd_biter_switch.txt
@@ -0,0 +1 @@
+This switch controls the speed of biters.

diff --git a/docs/elements/bd_bladder.txt b/docs/elements/bd_bladder.txt
new file mode 100644 (file)
index 0000000..d4fc834
--- /dev/null
+++ b/docs/elements/bd_bladder.txt
@@ -0,0 +1,2 @@
+Bladders can be pushed around easily. They slowly climb up; if they touch a
+voodoo doll, they convert into clocks. They can also pass slime.

diff --git a/docs/elements/bd_bladder_spender.txt b/docs/elements/bd_bladder_spender.txt
new file mode 100644 (file)
index 0000000..389a72c
--- /dev/null
+++ b/docs/elements/bd_bladder_spender.txt
@@ -0,0 +1 @@
+If there is space above it, the bladder spender turns to a bladder.

diff --git a/docs/elements/bd_bomb.txt b/docs/elements/bd_bomb.txt
new file mode 100644 (file)
index 0000000..c10debf
--- /dev/null
+++ b/docs/elements/bd_bomb.txt
@@ -0,0 +1,3 @@
+You can pick up this bomb like a diamond. To use it, press the snap or drop
+key and a direction... and then quickly run away! You can hold only one bomb
+at a time.

diff --git a/docs/elements/bd_box.txt b/docs/elements/bd_box.txt
new file mode 100644 (file)
index 0000000..6f521fd
--- /dev/null
+++ b/docs/elements/bd_box.txt
@@ -0,0 +1,3 @@
+Sometimes you have to block a passage, for example to protect a voodoo doll.
+This is when a box like this comes handy. You can push it in every direction
+using the snap or drop key.

diff --git a/docs/elements/bd_chasing_rock.txt b/docs/elements/bd_chasing_rock.txt
new file mode 100644 (file)
index 0000000..891d64e
--- /dev/null
+++ b/docs/elements/bd_chasing_rock.txt
@@ -0,0 +1,4 @@
+A chasing rock looks like an ordinary rock. It can even pass slime. It is
+lightweight, you can push it at once, as long as it is sleeping. Once it begins
+to fall, it wakes up and begins chasing you. You can also push awakened rocks,
+if you have eaten the sweet.

diff --git a/docs/elements/bd_clock.txt b/docs/elements/bd_clock.txt
new file mode 100644 (file)
index 0000000..bb74e36
--- /dev/null
+++ b/docs/elements/bd_clock.txt
@@ -0,0 +1 @@
+Collect this to get extra time.

diff --git a/docs/elements/bd_conveyor.txt b/docs/elements/bd_conveyor.txt
new file mode 100644 (file)
index 0000000..c378c0d
--- /dev/null
+++ b/docs/elements/bd_conveyor.txt
@@ -0,0 +1 @@
+Conveyor belts will move around any object that can fall.

diff --git a/docs/elements/bd_conveyor_dir_switch.txt b/docs/elements/bd_conveyor_dir_switch.txt
new file mode 100644 (file)
index 0000000..fb48f7e
--- /dev/null
+++ b/docs/elements/bd_conveyor_dir_switch.txt
@@ -0,0 +1 @@
+This switch can be used to reverse the direction of conveyor belts.

diff --git a/docs/elements/bd_conveyor_switch.txt b/docs/elements/bd_conveyor_switch.txt
new file mode 100644 (file)
index 0000000..f998078
--- /dev/null
+++ b/docs/elements/bd_conveyor_switch.txt
@@ -0,0 +1 @@
+This switch turns the conveyor belts on or off.

diff --git a/docs/elements/bd_covered.txt b/docs/elements/bd_covered.txt
new file mode 100644 (file)
index 0000000..82ec6a1
--- /dev/null
+++ b/docs/elements/bd_covered.txt
@@ -0,0 +1 @@
+Covered tile.

diff --git a/docs/elements/bd_cow.txt b/docs/elements/bd_cow.txt
new file mode 100644 (file)
index 0000000..8abb4e5
--- /dev/null
+++ b/docs/elements/bd_cow.txt
@@ -0,0 +1,2 @@
+This creature wanders around the cave like a guard, but you can touch it.
+If it is enclosed, it turns into a skeleton.

diff --git a/docs/elements/bd_creature_switch.txt b/docs/elements/bd_creature_switch.txt
new file mode 100644 (file)
index 0000000..c731b1d
--- /dev/null
+++ b/docs/elements/bd_creature_switch.txt
@@ -0,0 +1,2 @@
+With this switch you can change the direction of creatures, like guards and
+butterflies. Sometimes it works automatically.

diff --git a/docs/elements/bd_diamond_glued.txt b/docs/elements/bd_diamond_glued.txt
new file mode 100644 (file)
index 0000000..393c6b8
--- /dev/null
+++ b/docs/elements/bd_diamond_glued.txt
@@ -0,0 +1 @@
+Glued diamond.

diff --git a/docs/elements/bd_diamond_key.txt b/docs/elements/bd_diamond_key.txt
new file mode 100644 (file)
index 0000000..61180d6
--- /dev/null
+++ b/docs/elements/bd_diamond_key.txt
@@ -0,0 +1 @@
+If you get this key, all doors will convert into diamonds you can collect.

diff --git a/docs/elements/bd_dragonfly.txt b/docs/elements/bd_dragonfly.txt
new file mode 100644 (file)
index 0000000..b76f2a0
--- /dev/null
+++ b/docs/elements/bd_dragonfly.txt
@@ -0,0 +1,4 @@
+These creatures also guard the diamonds you would like to collect. But they
+move very differently. They like to run straight ahead, and only change
+direction if they bump into something. Like other enemies, you should not touch
+them. But you can easily crush them with rocks.

diff --git a/docs/elements/bd_exit.txt b/docs/elements/bd_exit.txt
new file mode 100644 (file)
index 0000000..7aa0482
--- /dev/null
+++ b/docs/elements/bd_exit.txt
@@ -0,0 +1,4 @@
+After collecting the required number of diamonds, look for a flashing out box
+to exit the cave. Closed out box looks like steel wall, but beware of explosions
+near the out box: You could accidentally destroy an exit. This prevents you from
+successfully finishing the cave.

diff --git a/docs/elements/bd_expandable_steelwall.txt b/docs/elements/bd_expandable_steelwall.txt
new file mode 100644 (file)
index 0000000..74c0406
--- /dev/null
+++ b/docs/elements/bd_expandable_steelwall.txt
@@ -0,0 +1 @@
+Expandable wall, but made of steel. You cannot even blow it up!

diff --git a/docs/elements/bd_expandable_wall.txt b/docs/elements/bd_expandable_wall.txt
new file mode 100644 (file)
index 0000000..16f0669
--- /dev/null
+++ b/docs/elements/bd_expandable_wall.txt
@@ -0,0 +1,3 @@
+Expandable wall expands in horizontal or vertical (or both) direction, if there
+is an empty space to fill up. You should be very careful not to be catched by
+the expanding wall.

diff --git a/docs/elements/bd_expandable_wall_switch.txt b/docs/elements/bd_expandable_wall_switch.txt
new file mode 100644 (file)
index 0000000..6de0c7a
--- /dev/null
+++ b/docs/elements/bd_expandable_wall_switch.txt
@@ -0,0 +1 @@
+With this switch you can control the direction of the expandable wall.

diff --git a/docs/elements/bd_expanding_wall_switch.txt b/docs/elements/bd_expanding_wall_switch.txt
new file mode 100644 (file)
index 0000000..ec0c1dd
--- /dev/null
+++ b/docs/elements/bd_expanding_wall_switch.txt
@@ -0,0 +1 @@
+Using this switch, you can control the direction of the expanding wall.

diff --git a/docs/elements/bd_fake_bonus.txt b/docs/elements/bd_fake_bonus.txt
new file mode 100644 (file)
index 0000000..998a31f
--- /dev/null
+++ b/docs/elements/bd_fake_bonus.txt
@@ -0,0 +1 @@
+Fake bonus.

diff --git a/docs/elements/bd_falling_wall.txt b/docs/elements/bd_falling_wall.txt
new file mode 100644 (file)
index 0000000..193f727
--- /dev/null
+++ b/docs/elements/bd_falling_wall.txt
@@ -0,0 +1,3 @@
+Whenever there is a falling wall above the player merely separated by empty
+space, it starts falling. It does so at any distance. If it hits the player,
+it explodes. If it hits anything else, it just stops.

diff --git a/docs/elements/bd_flying_diamond.txt b/docs/elements/bd_flying_diamond.txt
new file mode 100644 (file)
index 0000000..b2f1c95
--- /dev/null
+++ b/docs/elements/bd_flying_diamond.txt
@@ -0,0 +1,2 @@
+Exactly like a diamond, but instead of falling down, it flies upwards, as
+high as it can.

diff --git a/docs/elements/bd_flying_rock.txt b/docs/elements/bd_flying_rock.txt
new file mode 100644 (file)
index 0000000..a5b5139
--- /dev/null
+++ b/docs/elements/bd_flying_rock.txt
@@ -0,0 +1,2 @@
+The flying variant of a rock. Note that this one can crush enemies as well as
+the player!

diff --git a/docs/elements/bd_gate.txt b/docs/elements/bd_gate.txt
new file mode 100644 (file)
index 0000000..2ccbb6a
--- /dev/null
+++ b/docs/elements/bd_gate.txt
@@ -0,0 +1 @@
+This is a door which can only be opened by the key of the same color.

diff --git a/docs/elements/bd_ghost.txt b/docs/elements/bd_ghost.txt
new file mode 100644 (file)
index 0000000..09215ae
--- /dev/null
+++ b/docs/elements/bd_ghost.txt
@@ -0,0 +1,2 @@
+This is a ghost which wanders aimlessly. If it touches you, it will explode
+in an x-shape to many different elements.

diff --git a/docs/elements/bd_gravestone.txt b/docs/elements/bd_gravestone.txt
new file mode 100644 (file)
index 0000000..6403a72
--- /dev/null
+++ b/docs/elements/bd_gravestone.txt
@@ -0,0 +1 @@
+This is the gravestone for a dead voodoo doll.

diff --git a/docs/elements/bd_gravity_switch.txt b/docs/elements/bd_gravity_switch.txt
new file mode 100644 (file)
index 0000000..6e7d307
--- /dev/null
+++ b/docs/elements/bd_gravity_switch.txt
@@ -0,0 +1,3 @@
+When this switch is active, you can use it to change the gravitation.
+The direction from which you use it will determine the direction the
+gravitation will change to.

diff --git a/docs/elements/bd_inbox.txt b/docs/elements/bd_inbox.txt
new file mode 100644 (file)
index 0000000..d03a012
--- /dev/null
+++ b/docs/elements/bd_inbox.txt
@@ -0,0 +1 @@
+This is where the player enters a cave.

diff --git a/docs/elements/bd_invisible_exit.txt b/docs/elements/bd_invisible_exit.txt
new file mode 100644 (file)
index 0000000..b7c4e23
--- /dev/null
+++ b/docs/elements/bd_invisible_exit.txt
@@ -0,0 +1 @@
+This is also an exit, but it remains non-flashing and thus is difficult to find.

diff --git a/docs/elements/bd_key.txt b/docs/elements/bd_key.txt
new file mode 100644 (file)
index 0000000..99c9ad6
--- /dev/null
+++ b/docs/elements/bd_key.txt
@@ -0,0 +1,2 @@
+There are three types of keys, which open three different colored doors.
+You can collect more from these; and for every door, always one key is used.

diff --git a/docs/elements/bd_lava.txt b/docs/elements/bd_lava.txt
new file mode 100644 (file)
index 0000000..0c68095
--- /dev/null
+++ b/docs/elements/bd_lava.txt
@@ -0,0 +1,2 @@
+Heavy elemenets sink into the lava and disappear without any trace left.
+Creatures can also step into the lava.

diff --git a/docs/elements/bd_mega_rock.txt b/docs/elements/bd_mega_rock.txt
new file mode 100644 (file)
index 0000000..3a45431
--- /dev/null
+++ b/docs/elements/bd_mega_rock.txt
@@ -0,0 +1 @@
+Like an ordinary rock, but this one is so heavy that you cannot push it.

diff --git a/docs/elements/bd_nitro_pack.txt b/docs/elements/bd_nitro_pack.txt
new file mode 100644 (file)
index 0000000..eee0753
--- /dev/null
+++ b/docs/elements/bd_nitro_pack.txt
@@ -0,0 +1 @@
+Nitro pack.

diff --git a/docs/elements/bd_nut.txt b/docs/elements/bd_nut.txt
new file mode 100644 (file)
index 0000000..93fcd0d
--- /dev/null
+++ b/docs/elements/bd_nut.txt
@@ -0,0 +1 @@
+These nuts contain diamonds. If you crack them with a rock, they will be opened.

diff --git a/docs/elements/bd_player.txt b/docs/elements/bd_player.txt
new file mode 100644 (file)
index 0000000..2dccaf5
--- /dev/null
+++ b/docs/elements/bd_player.txt
@@ -0,0 +1,2 @@
+This is the player. The player can move through empty space and sand, can pick
+up diamonds and push rocks, but should avoid fireflies and other enemies.

diff --git a/docs/elements/bd_pneumatic_hammer.txt b/docs/elements/bd_pneumatic_hammer.txt
new file mode 100644 (file)
index 0000000..6509a62
--- /dev/null
+++ b/docs/elements/bd_pneumatic_hammer.txt
@@ -0,0 +1,5 @@
+Sometimes diamonds or keys are buried in walls. You can use a pneumatic hammer
+to break these walls, or simple walls which contain nothing. Stand on something,
+and press the snap or drop key together with a left or right direction key to
+use the hammer on a wall which is near the player, next to the element you
+stand on.

diff --git a/docs/elements/bd_pot.txt b/docs/elements/bd_pot.txt
new file mode 100644 (file)
index 0000000..a023971
--- /dev/null
+++ b/docs/elements/bd_pot.txt
@@ -0,0 +1,2 @@
+Stir the pot, and you will be able to use the gravitation switch. While you are
+stirring the pot, there is no gravitation at all. Press fire after using the pot.

diff --git a/docs/elements/bd_replicator.txt b/docs/elements/bd_replicator.txt
new file mode 100644 (file)
index 0000000..73b608e
--- /dev/null
+++ b/docs/elements/bd_replicator.txt
@@ -0,0 +1,3 @@
+This machine replicates the element which is on top of it. At regular intervals,
+a new element drops out underneath, if there is space to do this. The rate of
+materializing the new elements can be different in every cave.

diff --git a/docs/elements/bd_replicator_switch.txt b/docs/elements/bd_replicator_switch.txt
new file mode 100644 (file)
index 0000000..894a5ff
--- /dev/null
+++ b/docs/elements/bd_replicator_switch.txt
@@ -0,0 +1 @@
+This turns the replicator on or off.

diff --git a/docs/elements/bd_rock_glued.txt b/docs/elements/bd_rock_glued.txt
new file mode 100644 (file)
index 0000000..d308166
--- /dev/null
+++ b/docs/elements/bd_rock_glued.txt
@@ -0,0 +1 @@
+Glued rock.

diff --git a/docs/elements/bd_sand.txt b/docs/elements/bd_sand.txt
new file mode 100644 (file)
index 0000000..2b3f3d2
--- /dev/null
+++ b/docs/elements/bd_sand.txt
@@ -0,0 +1 @@
+You can move through sand, leaving empty space behind. Amoeba can eat it.

diff --git a/docs/elements/bd_sand_ball.txt b/docs/elements/bd_sand_ball.txt
new file mode 100644 (file)
index 0000000..4081eca
--- /dev/null
+++ b/docs/elements/bd_sand_ball.txt
@@ -0,0 +1 @@
+A rolling ball of sand. You cannot push it, but you can dig it away.

diff --git a/docs/elements/bd_sand_glued.txt b/docs/elements/bd_sand_glued.txt
new file mode 100644 (file)
index 0000000..eafa168
--- /dev/null
+++ b/docs/elements/bd_sand_glued.txt
@@ -0,0 +1 @@
+Glued sand.

diff --git a/docs/elements/bd_sand_loose.txt b/docs/elements/bd_sand_loose.txt
new file mode 100644 (file)
index 0000000..125daa0
--- /dev/null
+++ b/docs/elements/bd_sand_loose.txt
@@ -0,0 +1 @@
+A falling piece of sand. You cannot push it, but you can dig it away.

diff --git a/docs/elements/bd_sand_sloped.txt b/docs/elements/bd_sand_sloped.txt
new file mode 100644 (file)
index 0000000..ade2961
--- /dev/null
+++ b/docs/elements/bd_sand_sloped.txt
@@ -0,0 +1,2 @@
+Acts like ordinary sand, but is sloped: Elements like rocks or diamonds
+will roll off to the left or right.

diff --git a/docs/elements/bd_skeleton.txt b/docs/elements/bd_skeleton.txt
new file mode 100644 (file)
index 0000000..d3e5824
--- /dev/null
+++ b/docs/elements/bd_skeleton.txt
@@ -0,0 +1,2 @@
+Sometimes you have to collect skeletons before you can use the pot. In some
+other caves, they must be collected like diamonds to open the exit.

diff --git a/docs/elements/bd_slime.txt b/docs/elements/bd_slime.txt
new file mode 100644 (file)
index 0000000..1876dcf
--- /dev/null
+++ b/docs/elements/bd_slime.txt
@@ -0,0 +1,2 @@
+Slime is permeable. It means that rocks and diamonds laying on the slime can
+randomly pass through.

diff --git a/docs/elements/bd_steelwall.txt b/docs/elements/bd_steelwall.txt
new file mode 100644 (file)
index 0000000..b7f7080
--- /dev/null
+++ b/docs/elements/bd_steelwall.txt
@@ -0,0 +1 @@
+This is rock stable wall. It's impossible to move or blow it up.

diff --git a/docs/elements/bd_steelwall_diggable.txt b/docs/elements/bd_steelwall_diggable.txt
new file mode 100644 (file)
index 0000000..4c5fbe5
--- /dev/null
+++ b/docs/elements/bd_steelwall_diggable.txt
@@ -0,0 +1 @@
+Acts like ordinary steel wall, but you can dig it away.

diff --git a/docs/elements/bd_steelwall_explodable.txt b/docs/elements/bd_steelwall_explodable.txt
new file mode 100644 (file)
index 0000000..2c85c61
--- /dev/null
+++ b/docs/elements/bd_steelwall_explodable.txt
@@ -0,0 +1 @@
+Acts like ordinary steel wall, but can be removed by explosions.

diff --git a/docs/elements/bd_steelwall_sloped.txt b/docs/elements/bd_steelwall_sloped.txt
new file mode 100644 (file)
index 0000000..be4a4c3
--- /dev/null
+++ b/docs/elements/bd_steelwall_sloped.txt
@@ -0,0 +1,2 @@
+Acts like ordinary steel wall, but is sloped: Elements like rocks or diamonds
+will roll off to the left or right.

diff --git a/docs/elements/bd_stonefly.txt b/docs/elements/bd_stonefly.txt
new file mode 100644 (file)
index 0000000..94dbc60
--- /dev/null
+++ b/docs/elements/bd_stonefly.txt
@@ -0,0 +1,2 @@
+This flying moth behaves just like a butterfly, except that it explodes into
+rocks instead of diamonds.

diff --git a/docs/elements/bd_sweet.txt b/docs/elements/bd_sweet.txt
new file mode 100644 (file)
index 0000000..534bf09
--- /dev/null
+++ b/docs/elements/bd_sweet.txt
@@ -0,0 +1,2 @@
+Eat this sweet and you will become strong. You will be able to push rocks at
+once. You will also be able to push chasing rocks.

diff --git a/docs/elements/bd_teleporter.txt b/docs/elements/bd_teleporter.txt
new file mode 100644 (file)
index 0000000..c2408f9
--- /dev/null
+++ b/docs/elements/bd_teleporter.txt
@@ -0,0 +1,3 @@
+The teleporter will move you from one place to another, if you step into it.
+The destination teleporter depends on the direction from which you stepped into
+the teleporter.

diff --git a/docs/elements/bd_time_penalty.txt b/docs/elements/bd_time_penalty.txt
new file mode 100644 (file)
index 0000000..7aa6ece
--- /dev/null
+++ b/docs/elements/bd_time_penalty.txt
@@ -0,0 +1 @@
+Time penalty.

diff --git a/docs/elements/bd_trapped_diamond.txt b/docs/elements/bd_trapped_diamond.txt
new file mode 100644 (file)
index 0000000..484c2cf
--- /dev/null
+++ b/docs/elements/bd_trapped_diamond.txt
@@ -0,0 +1 @@
+This is an indestructible door with a diamond.

diff --git a/docs/elements/bd_voodoo_doll.txt b/docs/elements/bd_voodoo_doll.txt
new file mode 100644 (file)
index 0000000..313aba0
--- /dev/null
+++ b/docs/elements/bd_voodoo_doll.txt
@@ -0,0 +1,6 @@
+This is your player's look-alike. You must protect it against flies. If a
+voodoo doll dies by one of them, your player also dies immediately. This doll
+can have different properties: Sometimes it can collect diamonds for you.
+Sometimes it must be protected from falling rocks. If it is hit by a rock, it
+turns into a gravestone surrounded by steel walls. Also, it may or may not turn
+into a gravestone by nearby explosions.

diff --git a/docs/elements/bd_waiting_rock.txt b/docs/elements/bd_waiting_rock.txt
new file mode 100644 (file)
index 0000000..9e992ba
--- /dev/null
+++ b/docs/elements/bd_waiting_rock.txt
@@ -0,0 +1 @@
+Waiting rock.

diff --git a/docs/elements/bd_wall_diamond.txt b/docs/elements/bd_wall_diamond.txt
new file mode 100644 (file)
index 0000000..c8ca85d
--- /dev/null
+++ b/docs/elements/bd_wall_diamond.txt
@@ -0,0 +1 @@
+This wall contains a diamond which can be freed by using the pneumatic hammer.

diff --git a/docs/elements/bd_wall_diggable.txt b/docs/elements/bd_wall_diggable.txt
new file mode 100644 (file)
index 0000000..42b4de2
--- /dev/null
+++ b/docs/elements/bd_wall_diggable.txt
@@ -0,0 +1 @@
+Acts like ordinary wall, but you can dig it away.

diff --git a/docs/elements/bd_wall_key.txt b/docs/elements/bd_wall_key.txt
new file mode 100644 (file)
index 0000000..6d6eebb
--- /dev/null
+++ b/docs/elements/bd_wall_key.txt
@@ -0,0 +1,2 @@
+This is a key enclosed by a wall. Use the hammer to break this wall and get
+the key.

diff --git a/docs/elements/bd_wall_sloped.txt b/docs/elements/bd_wall_sloped.txt
new file mode 100644 (file)
index 0000000..34f7d46
--- /dev/null
+++ b/docs/elements/bd_wall_sloped.txt
@@ -0,0 +1,2 @@
+Acts like ordinary wall, but is sloped: Elements like rocks or diamonds
+will roll off to the left or right.

diff --git a/docs/elements/bd_water.txt b/docs/elements/bd_water.txt
new file mode 100644 (file)
index 0000000..f52781c
--- /dev/null
+++ b/docs/elements/bd_water.txt
@@ -0,0 +1 @@
+Water, which floods all empty space slowly.