Bukkit

Lists:

All the item lists are in the 'Lists' folder. To create a new list simply create a new .yml file (or copy a previously created one) with the name you want the list to have. This name is what you will use on the second line of the sign.

Here's what a basic list structure should look like:

  inheritance: OtherListName
  items:
    item1:
    item2:

Description:

inheritance - Will inherit the items from the list OtherListname
items - Here is where you would add the items of the list. More on this below.

Item format example:

items:
  iron_sword:
    spawn:
      chance: 100
      stack: '1-1'
    effects:
      damage_arthropods:
        chance: 100
        lvl: '1-2'
      random1:
        chance: 50
        lvl: '1-2'
    properties:
      data: 80
      name: "Shiny Metal Sword"
      lore:
      - "This is an iron sword. duh."
      - "Omg second line wtf"
    plugins:
      soulbound: pickup

Description:

• spawn:
  
  • chance - The percent chance to spawn at all
    
  • stack - Amount of this item to appear in a single stack. The format is 'minimum-maximum'. Note that certain items should always be '1-1'
    

• effects(Optional):
  
  • effect name - Name of the effect. Can be set to 'random' so the plugin chooses a random effect of the ones available for this item.
    
    • chance - The percent chance for this effect to be applied.
      
    • lvl - The power level of the effect. Varies between effects. Uses the format 'minimum-maximum'.
      

• properties(Optional):
  
  • data - The data value of the item. Can be set to a range (like the 'stack' property). Type 'random' to choose a random data value.
    
  • name - The name set for this item. Overrides the prefix/suffix generator.
  • lore - Item description.
  • color - Here you can dye an item to any rgb combination. For now this only works with leather.
    • red:
    • green:
    • blue:
• plugins(Optional):
  • soulbound - Has three options: 'pickup', 'use' and 'equip'. Requires the 'Soulbound' plugin.
    

Potions:

Potions have the same format as any other item, except they also have these options under every effect:

• effect name
  
  • splash - Makes the potion throw-able
    
  • extend - Extends the duration of the effect
    

Books:

You can set the author, title and text of a book with the 'book' key under 'properties', like so:

• book:
  
  • title - Title of the book
    
  • author - Author of the book
    
  • pages:
  • - page 1 text
  • - page 2 text

The item NEEDS to be a written_book.

Having more then one of the same item in a list:

If you want to put the same item in a single list (aka, two iron swords), then you must simply add a dash ( - ) next to the name with a number unique to each of the same item. Note that it must be the name, not the id. Example:

  iron_sword-1:
    spawn:
      chance: 100
      stack: '1-1'
  iron_sword-2:
    spawn:
      chance: 50
      stack: '1-1'

Settings:

Worlds List:

You can also set up per-world loot chests. When a chest is opened and
does not have a loot sign under it, it checks if the world is on this
list. If it is, it will use the properties set for that particular list.
WARNING:
Putting your world on this list means that ALL chests turn into loot chests,
doesnt matter if theres a sign under it or not.

worlds:																
  NameOfWorld:													
    ListName:
      time: Minutes
      amount(optional): 'minimum-maximum'
      radius(optional): 

Replacing 'NameOfWorld' with the name of the world affected and 'ListName' with the list applied