Sample-Configuration-File

Sample Configuration File

Below is an example of the default config values for Shelf-It and an explanation of what they do.


Options:
  Rows_per_shelf: 2
  //Sets the number of rows each bookshelf contains. Valid values are 0-6.
  //Decreasing this number later is okay, as a shelf will always adjust
  // to hold its contents until it can conform to the value here

  Items_allowed_in_shelves:
  - 340
  - 386
  - 387
  - 403
  // Lists the items allowed in shelves by their id  

  Block_access_from_top/bottom: false
  //When enabled, players may only open a bookshelf from the sides.
  //Used to hide shelves.
 
  Free_old_books_from_free_shelves: false
  //When set to true, allows free type shelves to give out free old style books
  
  Prevent_free_shelf_item_eating: true
  //When set to true, prevents free shelves from accepting new book items that would be lost when the shelf is closed
  
  Bookshelf_title: Bookshelf
  //Sets inventory title of regular bookshelves [1-32 characters long]
  //Titles support the following color codes:
  //&0 BLACK
  //&1 DARK BLUE
  //&2 DARK GREEN
  //&3 DARK AQUA
  //&4 DARK RED
  //&5 DARK PURPLE 
  //&6 GOLD
  //&7 GRAY
  //&8 DARK GRAY
  //&9 INDIGO
  //&A GREEN
  //&B AQUA
  //&C RED
  //&D PINK
  //&E YELLOW
  //&F  WHITE
  //&M STRIKE THROUGH
  //&N UNDERLINED
  //&L BOLD
  //&K RANDOM
  //&O ITALIC

  Free_bookshelf_title: Free Books
  //Sets inventory title of free-type bookshelves [1-32 characters long]
  
  Shelf Protection:
    From_fire: false
    //When enabled, bookshelves containing books cannot be destroyed by fire.

    From_explosions: false
    //If True, bookshelves containing books cannot be destroyed by explosions.  

  WorldGuard:
    Enable_region_shelf_protection: true
    //If true, enables region based shelf protection
  
    Excluded_regions:
    - Add your regions here
    //Regions listed here by name will not be affected by the region based protection

  World Type Defaults:
    YourWorld: Free or Single
    //Sets the type of bookshelf that bookshelves default to in the worlds listed here.
    //Set to "Free" for free type shelves or "Single" for single-book-display type shelves
  
  Shop Shelves:
    Enabled: true
    //Allows or disallows for the use and creation of shop shelves
  
    Shop_bookshelf_title: 'Books for !$!'
    //Sets the inventory title for shop-type shelves. !$! is replaced by the shops price and
    //  !N! is replaced by the name of the shops owner.