The Configuration File
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'
- chance - The percent chance to spawn at all
- 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'.
- chance - The percent chance for this effect to be applied.
- 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.
- 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:
- 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.
- plugins(Optional):
- soulbound - Has three options: 'pickup', 'use' and 'equip'. Requires the 'Soulbound' plugin.
- 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
- splash - Makes the potion throw-able
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
- title - Title of the book
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