Configuration

Configuration

YOU MAY ABSOLUTELY NOT USE TABS IN THE CONFIGURATION, THIS WILL CRASH THE PLUGIN. ONLY USE SPACES

config.yml

Entire Config

player-join:
  enable-join-message: true
  join-message: '&e%p joined the game'
  enable-first-join-message: true
  first-join-message: '&1Welcome to the server %p!'
  enable-personal-message: true
  personal-message: '&3Be sure to vote %p :)'
  enable-first-personal-message: true
  first-personal-message: '&2Have a great time %p :)'
  firework: true
  change-gamemode: true
  gamemode: SURVIVAL
  enable-potion-effects: false
  potion-effects:
  - REGENERATION:3:1
  enable-sounds: true
  sounds:
  - NOTE_PIANO:1:1
player-leave:
  enable-leave-message: true
  leave-message: '&e%p left the game'

Explanation

player-join:
  enable-join-message: true
  join-message: '&e%p joined the game'
  enable-first-join-message: true
  first-join-message: '&1Welcome to the server %p!'
  firework: true
  change-gamemode: true
  gamemode: SURVIVAL

In this section you can enable, disable and set the join messages. You can use %p for the player's name and & + character (e.g. &1) for colors. You can find a list of all color codes here. You can also enable/disable the option to spawn a random firework on a players join. Set the default gamemode int the 'gamemode: SURVIVAL' section, the default is SURVIVAL but you also have CREATIVE and ADVENTURE.

  enable-potion-effects: false
  potion-effects:
  - REGENERATION:3:1

In this section the potion effects are handled. The potion effects are given to the player when he joins, the first argument is the potion effect, the second is the time in seconds and the third is the amplifier (level).

  enable-sounds: true
  sounds:
  - NOTE_PIANO:1:1

In this section you can define sounds for joining, there's a similar section for leaving. This is the format for adding sounds:

  sounds:
  - NOTE_PIANO:1:1
  - <sound>:<volume>:<pitch>

The volume and pitch have to be numbers between 0 and 2, they accept decimal numbers. Click here to get a list of all sounds.

player-leave:
  enable-leave-message: true
  leave-message: '&e%p left the game'

In this section you can enable, disable and set the leave messages. You can use %p for the player's name and & + character (e.g. &1) for colors. You can find a list of all color codes here.

inventory.yml

Entire Config

starterskit:
  enable-starterskit: true
  starterskit:
  - WOOD_AXE:1:0:&1%p's axe
  - WOOD_PICKAXE:1:0:&1%p's pickaxe
  - WOOD_SPADE:1:0:&1%p's shovel
  - WOOD_SWORD:1:0:&1%p's sword
  - WOOD_HOE:1:0:&1%p''s hoe
  - COOKIE:10:0:&2Delicious Food
join-inventory:
  enable-join-inventory: true
  clear-old-inventory: false
  join-inventory:
  - PAPER:1:0:&6Welcome %p!:Welcome to the server %p!:0
  - WRITTEN_BOOK:1:0:&6Rules:&7The Server Rules:rules.txt:JoinAndLeavePro:1

Explanation

starterskit:
  enable-starterskit: true
  starterskit:
  - WOOD_AXE:1:0:&1%p's axe
  - WOOD_PICKAXE:1:0:&1%p's pickaxe
  - WOOD_SPADE:1:0:&1%p's shovel
  - WOOD_SWORD:1:0:&1%p's sword
  - WOOD_HOE:1:0:&1%p''s hoe
  - COOKIE:10:0:&2Delicious Food
join-inventory:
  enable-join-inventory: true
  clear-old-inventory: false
  join-inventory:
  - PAPER:1:0:&6Welcome %p!:Welcome to the server %p!:0
  - WRITTEN_BOOK:1:0:&6Rules:&7The Server Rules:rules.txt:JoinAndLeavePro:1

In this section you can enable, disable and configure the starters kit and join-inventory. You can easily enable with true and disable with false.

You can add an item like this:

join-inventory:
  - PAPER:1:0:'&6Paper of Wisdom':'&2Get wiser while reading this paper':0
  - <item id>:<amount>:<data value>:<item name>:<item description>:<slot>
  - <item id>:<amount>:<data value>:<item name>:<item description>
  - <item id>:<amount>:<data value>:<item name>
  - <item id>:<amount>:<data value>
  - <item id>:<amount>

And for books:

join-inventory:
  - WRITTEN_BOOK:1:0:'&6Book of Wisdom':'&2Get wiser while reading this book':wisdom.txt:swordman407:0
  - <item id>:<amount>:<data value>:<item name>:<item description>:<book file>:<author>:<slot>
  - <item id>:<amount>:<data value>:<item name>:<item description>:<book file>:<author>
  - <item id>:<amount>:<data value>:<item name>:<item description>:<book file>

You can force items to be in a slot by adding the id of the slot. And you can enter 0 as default data value. Don't forget to put the ':' between the arguments! You can use %p for the player's name and & + character (e.g. &1) for colors. You can find a list of all color codes here. The book file is the file where the text of the book goes inside the 'books' folder (see this page for more info about book files).

The 'clear-old-inventory:' section is only used when 'enable-join-inventory:' is set to true, if you only want to clear someones inventory when he/she joins, you can set 'join-inventory:' like this:

  join-inventory: []