--- deliantra/arch/mapbuilding/talking.arc	2006/02/06 20:26:03	1.1
+++ deliantra/arch/mapbuilding/talking.arc	2009/10/10 07:14:49	1.8
@@ -1,20 +1,42 @@
-Object building_earbook
+object building_earbook
 name Listening book material
+name_pl Listening book materials
+slaying magic_ear
+face mbbook.x11
 nrof 1
-weight 1000
-value 70000
 type 161
 subtype 3
-face mbbook.111
-slaying magic_ear
+value 70000
+weight 1000
+msg
+Creates a book which triggers other map elements when someone says the key phrase to it or within two squares.
+
+Place a Marking Rune on the map square before building. The rune will be removed, and the book will be linked to all other elements on the map marked with the same text.
+
+Place a book or scroll, which will become the listening book, on top of the Marking Rune. The text should be in a special format like:
+
+@match blah
+
+This will cause the book to trigger when "blah" is said. You can optionally also add text for the book to say in response on a separate line below the @match.
+endmsg
 end
-Object building_mouthbook
+
+object building_mouthbook
 name Talking book material
+name_pl Talking book materials
+slaying magic_mouth
+face mbbook.x11
 nrof 1
-weight 1000
-value 45000
 type 161
 subtype 3
-face mbbook.111
-slaying magic_mouth
+value 45000
+weight 1000
+msg
+Creates a book which speaks when triggered by another map element.
+
+Place a Marking Rune on the map square before building. The rune will be removed, and the book will be linked to all other elements on the map marked with the same text.
+
+Place a book or scroll, which will become the talking book, on top of the Marking Rune. The text is the message to be spoken by the talking book.
+endmsg
 end
+