arch/mapbuilding/book_build_instr.arc

object book_build_instructions
inherit book_read
name    Building Instructions
name_pl Building Instructions
value 20000
msg
B<Basic Building Instructions>

To build your own home, you can use different items:

* generic builder: this tool lets you build anything. You need one to build.

* generic destroyer: this tool lets you destroy a built item. This will remove
any built item, except floors and walls.

* materials: you need those to build items. For instance, a 'Wood floor
material' enables you to build a woodfloor.

To build an item:

* apply the builder

* mark the material of the item you want to build

* fire the builder in the desired direction.

Of course, the material is used when you build, so you need to buy quite a few.


B<Building Floors and Walls>

Building enables you to put walls and floors where you want.
Building a floor lets you remove walls. This is the only way to remove them.
You can change an existing floor by building another on top. Same goes for walls.
All created floors are magic, and will preserve items you put on them.


B<Building Restrictions>

To build on a spot, all items on this spot must be 'buildable'. Buildable
items will display 'this is a buildable item' when examined.

I<There are several exceptions though:>

* In all cases you can build on marking runes as they are used
for making gates and buttons work together.

* Also you can build signs and talking books on of books and or scrolls,
because they are needed for specifying the message.

* Also, buttons, levers and pedestals can be build
underneath gates. Don't worry, you should have some clear messages on why you
can't build.


B<Building Gates and Buttons/Pedestals>

Some items, like gates, require buttons, pedestals, ..., something to be opened
and closed. To build a gate with its associated button:

* put a marking rune at the spot where you wish to build the door.
The text can be whatever you want, make sure to remember it.

* build the gate on this spot.

* put a marking rune at the spot where you with to put the button.
Use the same text as for the door.

* build the button.

Your button will now activate the gate when you apply it.

Note that you can link together as many gates, buttons, pedestals, as you want.
As long as you use the same text on the marking rune, they will all work together.

To build gates activated by other buttons, just use another text.
Normally all gates with a single marking rune text are either all up or all
down at a given time, however if you want one open while another is closed,
make use of inverted gates.

Also, it is possible to make buttons, levers, and
pedestals underneath gates, however it requires things to be made in a specific
order:

* make 2 marking runes on the square that you want to build the button and gate on.

* build the gate first.

* then build the button underneath it.

This is useful for making a gate avoid crushing people underneath it. Also, you
can use this same technique with inverted gates in order to make a square that
pushes objects placed on it off of it.


B<Removing Items>

To remove built items, you need a 'generic destroyer'.  Simply apply it, and
fire in the desired direction. It will remove the first built item from the
location.  Warning: a destroyer will remove items starting from the lowest
order on the spot. Basically, this means the first removed item will be a
pedestal (underground), then items on floor.  Note that the destroyer will not
remove walls or floors.


B<Signs and Talking Books>

When making signs and talking (or listening) books, you need to place a book or
scroll with the text you want on the square you're building on just like a
marking rune.

With the talking/listening books, they will take the name and
picture of the book used to create them as well.

For the talking and listening
books, you also need to connect them with a marking rune just like gates
buttons and levers, which in the case of the talking books, makes the book say
it's message when activated, and in the case of listening books, it causes
saying the phrase that the book looks for to act like pulling a lever.

For the listening books, the message must be in this format:

<keyword><newline>
<message>

For instance:

I<sesame open>
I<Click.>

Which will make it activate upon the somebody within two squares saying "sesame
open", and will additionally say "Click." upon activation.


B<Building Other Items>

All items not requiring any special handling are built simply by marking the
appropriate material and firing the builder.  Note that, to avoid any issue,
those items can not be picked up.  Note also that you can build an item on
another.
endmsg
end
Revision:	1.1
Committed:	Wed Apr 21 11:28:01 2010 UTC (14 years, 3 months ago) by elmex
Branch:	MAIN
CVS Tags:	rel-3_0, HEAD
Log Message:	replaced building instructions. and workarounded the listening books problem.
#	User	Rev	Content
1	elmex	1.1	object book_build_instructions
2			inherit book_read
3			name Building Instructions
4			name_pl Building Instructions
5			value 20000
6			msg
7			B<Basic Building Instructions>
8
9			To build your own home, you can use different items:
10
11			* generic builder: this tool lets you build anything. You need one to build.
12
13			* generic destroyer: this tool lets you destroy a built item. This will remove
14			any built item, except floors and walls.
15
16			* materials: you need those to build items. For instance, a 'Wood floor
17			material' enables you to build a woodfloor.
18
19			To build an item:
20
21			* apply the builder
22
23			* mark the material of the item you want to build
24
25			* fire the builder in the desired direction.
26
27			Of course, the material is used when you build, so you need to buy quite a few.
28
29
30			B<Building Floors and Walls>
31
32			Building enables you to put walls and floors where you want.
33			Building a floor lets you remove walls. This is the only way to remove them.
34			You can change an existing floor by building another on top. Same goes for walls.
35			All created floors are magic, and will preserve items you put on them.
36
37
38			B<Building Restrictions>
39
40			To build on a spot, all items on this spot must be 'buildable'. Buildable
41			items will display 'this is a buildable item' when examined.
42
43			I<There are several exceptions though:>
44
45			* In all cases you can build on marking runes as they are used
46			for making gates and buttons work together.
47
48			* Also you can build signs and talking books on of books and or scrolls,
49			because they are needed for specifying the message.
50
51			* Also, buttons, levers and pedestals can be build
52			underneath gates. Don't worry, you should have some clear messages on why you
53			can't build.
54
55
56			B<Building Gates and Buttons/Pedestals>
57
58			Some items, like gates, require buttons, pedestals, ..., something to be opened
59			and closed. To build a gate with its associated button:
60
61			* put a marking rune at the spot where you wish to build the door.
62			The text can be whatever you want, make sure to remember it.
63
64			* build the gate on this spot.
65
66			* put a marking rune at the spot where you with to put the button.
67			Use the same text as for the door.
68
69			* build the button.
70
71			Your button will now activate the gate when you apply it.
72
73			Note that you can link together as many gates, buttons, pedestals, as you want.
74			As long as you use the same text on the marking rune, they will all work together.
75
76			To build gates activated by other buttons, just use another text.
77			Normally all gates with a single marking rune text are either all up or all
78			down at a given time, however if you want one open while another is closed,
79			make use of inverted gates.
80
81			Also, it is possible to make buttons, levers, and
82			pedestals underneath gates, however it requires things to be made in a specific
83			order:
84
85			* make 2 marking runes on the square that you want to build the button and gate on.
86
87			* build the gate first.
88
89			* then build the button underneath it.
90
91			This is useful for making a gate avoid crushing people underneath it. Also, you
92			can use this same technique with inverted gates in order to make a square that
93			pushes objects placed on it off of it.
94
95
96			B<Removing Items>
97
98			To remove built items, you need a 'generic destroyer'. Simply apply it, and
99			fire in the desired direction. It will remove the first built item from the
100			location. Warning: a destroyer will remove items starting from the lowest
101			order on the spot. Basically, this means the first removed item will be a
102			pedestal (underground), then items on floor. Note that the destroyer will not
103			remove walls or floors.
104
105
106			B<Signs and Talking Books>
107
108			When making signs and talking (or listening) books, you need to place a book or
109			scroll with the text you want on the square you're building on just like a
110			marking rune.
111
112			With the talking/listening books, they will take the name and
113			picture of the book used to create them as well.
114
115			For the talking and listening
116			books, you also need to connect them with a marking rune just like gates
117			buttons and levers, which in the case of the talking books, makes the book say
118			it's message when activated, and in the case of listening books, it causes
119			saying the phrase that the book looks for to act like pulling a lever.
120
121			For the listening books, the message must be in this format:
122
123			<keyword><newline>
124			<message>
125
126			For instance:
127
128			I<sesame open>
129			I<Click.>
130
131			Which will make it activate upon the somebody within two squares saying "sesame
132			open", and will additionally say "Click." upon activation.
133
134
135			B<Building Other Items>
136
137			All items not requiring any special handling are built simply by marking the
138			appropriate material and firing the builder. Note that, to avoid any issue,
139			those items can not be picked up. Note also that you can build an item on
140			another.
141			endmsg
142			end