=========
Bookshelf
=========

Readable bookshelves make bookshelves "readable" on right click. Lines of text read from the bookshelves file will be printed to the player's chat on each right click, simulating usage of the bookshelf.

.. image:: /images/bookshelf/reading.png
    :align: center

Customizing the lines
=====================

A default collection of quotations is provided in the books.txt file that comes with the CraftBook download. It is found in plugins/craftbook/

You can add new lines, remove lines, or replace the entire file altogether. Each line of text is one "book". The file can be as big or as small as you want it to be.

Configuration
=============

========================================== ============================================================= =======
Node                                       Comment                                                       Default
========================================== ============================================================= =======
mechanics.Bookcase.read-when-sneaking      Enable reading while sneaking.                                no
mechanics.Bookcase.read-when-holding-block Allow bookshelves to work when the player is holding a block. false
========================================== ============================================================= =======


Permissions
===========

+-------------------------------+--------------------------------------+
|  Permission Node              |  Effect                              |
+===============================+======================================+
|  craftbook.mech.bookshelf.use |  Allows use of Readable Bookshelves. |
+-------------------------------+--------------------------------------+