These are all the commands you can execute, remember that you need the permissions.

• /chester spawn (type)

  - Spawn a Chester

• /chester add (slots/perkpoints) (amount) [player]

  - Add slots/perkpoints to player

• /chester reload

  - Reload settings

• /chester delete [player]

  - Delete a Chester

Set the permissions correctly, you don't want someone to get free stuff.

• chester.admin

  - Allow use all commands

• chester.spawn.*

  - Spawn any Chester type

• chester.spawn."type"

  - Spawn this Chester type

• chester.add

  - Useful to get points

• chester.reload

  - Reload config

• chester.custom_name.color

  - Use colors in the custom name

• chester.recipe.*

  - Allow craft all Chester types

• chester.recipe."type"

  - Allow craft this Chester type

Are spaces in Chester's inventory. Can be bought using Vault as dependency or with the command: /chester add slots (amount) [player].

To rename our Chester, it is necessary to right-click it, open the profile menu and select the item 'Custon name'. When the menu closes, the new name must be written in the chat.

Perks are improvements that can be assigned to our Chester, these can be purchased with perkpoints, the plugin's own currency.

Current types of perks include following:

• ALL_RESISTANCE (Damage reduced)
• EXPLOSION_RESISTANCE (Explosion damage is reduced)
• FIRE_RESISTANCE (Fire damage is reduced)
• PROJECTILE_RESISTANCE (Projectile damage is reduced)
• SPEED (Speed boost)
• ITEM_FINDER (Increase search radius)
• ITEM_KEEPER (Reduces loss of objects)
• MAX_HEALTH (Add max health)
• REG_BOOST (Add regeneration boost)

type: ALL_RESISTANCE # ( SPEED, FIRE_RESISTANCE, ITEM_FINDER, ITEM_KEEPER, ALL_RESISTANCE, MAX_HEALTH, REG_BOOST, PROJECTILE_RESISTANCE, EXPLOSION_RESISTANCE )
tiers:
    1:
        price: 10
        value: 5
    2:
        price: 15
        value: 15
    3:
        price: 25
        value: 25
    4:
        price: 50
        value: 35
    5:
        price: 75
        value: 45
    6:
        price: 100
        value: 60
item:
    type: SHIELD
    name: "&bExample"
    lore:
    - "&7Example value: &b%perk_example_value%%" # %perk_(yml name)_value%
                        

Chester brings statistics that allow him to keep track of what he was doing. Some of them are:

• Distance traveled
• Collected objects
• Dropped objects

They can be viewed in the Profile menu by placing the cursor on the item Statistics.

There are several types of Chesters among which are Classic and Black. If you want to create your own type, create an .yml file with the name you want and paste the code below:

name: Present Chester
material: CYAN_SHULKER_BOX
max_health: 200
fire_resistance: true
speed: 1.1
item_finder_ratio: 5
resistance:
   all: 25
   explosion: 0
   fire: 0
   projectile: 0
damage:
   by_owner: false
   by_players: true
   drop: false
inmortal: true
slots:
    unlocked: 28
    buy_enable: false
    price_base: 200
    price_extra: 30
    max: 28
perks:
- example # yml name (eg: /perks/example.yml -> example)
filters:
- ores # yml name (eg: /filters/ores.yml -> ores)
- potions
- tools
- wood
recipe:
    enable: false
    permission_enable: true
    craft:
    - K K K
    - K C K
    - K K K
    materials:
        C: CHEST
        K: CAKE
item:
    type: PLAYER_HEAD
    owner: "MHF_Present2"
    name: "&bExample"
    lore:
    - "&ePlace in order to spawn!"
food: # Material or ID/DATA and Health
- WHEAT 2
- MILK_BUCKET 5
- EGG 1
                    

The plugin brings English and Spanish language. If you want to change the displayed language, you have to replace the current one with a new one in config.yml:

lang: ENGLISH

If you want to add your own language, it is as simple as changing the messages below:

no_permission: "&cYou don't have permission to use this command!"
command:
   spawn:
      message: "&eYou has spawned a Chester!"
      error: "&cChester type not found!"
      limit: "&cYou can't have more chesters!"
   reload:
      message: "&eReloaded configuration!"
   add:
      message: "&eYou has added %amount% %type% to %player%'s Chester!"
      error: "&cYou can't add %amount% %type% to %player%'s Chester!"
      error_int_invalid: "&c(&4%error%&c) is not a valid value!"
      error_chester: "&c(&4%error%&c) hasn't a Chester!"
      error_offline: "&c(&4%error%&c) is offline!"
   delete:
      message: "&eYou has delete a %player%'s Chester!"
      error: "&c(&4%error%&c) hasn't a Chester!"
      error_offline: "&c(&4%error%&c) is offline!"
help:
- "&aChester - Commands:"
- "&8 » &7/chester add (slots/perkpoints) (amount) [player] &8- &7(&fAdd value to Chester&7)"
- "&8 » &7/chester reload &8- &7(&fReload config&7)"
- "&8 » &7/chester spawn (type) &8- &7(&fSpawn a Chester&7)"
- "&8 » &7/chester delete [player] &8- &7(&fDelete a Chester&7)"
sit:
   enable: "&eI'm sitting!"
   disable: "&eI'm following!"
spawn:
   message: "&eYou has spawned a Chester!"
   error: "&cYou already has a Chester!"
main_inv:
   title: "%chester% - Profile"
inv:
   title: "%chester% - Inventory"
   message: "&eYou have a new slot for your Chester!"
   error_limit: "&cYou have already reached the limit of available slots!"
   error_money: "&cYou don't have money for this!"
perks_inv:
   title: "%chester% - Perks - Page (%actual_page%-%pages%)"
   buy: "&eYour Chester has been updated!"
   error: "&cYou don't have perkpoints for this!"
filters_inv:
   title: "%chester% - Filters"
   message: "&e%filter_name% is %filter_status%!"
   enable: "Allowed"
   disable: "Denied"

perkpoints_get: "&eYou got %amount% perkpoints!"
death: "&c%chester% is death!"
custom_name: "&eWrite a new name for your Chester!"
custom_name_message: "&eYour Chester now be called %chester%!"
pickup_error: "&cI can't take more items!"

order:
   format: "%active% %value%"
   active: "&c»&4"
   values:
      normal: "Default"
      id: "Material or ID"
      amount: "Amount"

#
# Values for items:
#   - %chester% = Chester name
#   - %health% = Current health
#   - %max_health% = Max health maxima
#   - %price% = Price of a new slot
#   - %pickup% = Statistic of collected objects
#   - %dropped% = Drop item statistics
#   - %distance% = Distance traveled by Chester
#   - %perk_example_value% = Example perk value
#   - %perk_points% = PerkPoints
#   - %perks_actual_page% = Actual page (Perks)
#   - %perks_pages% = Pages (Perks)
#
# Values for perks lore:
#   - %perk_type% =  Perk - type
#   - %perk_value% = Perk - value
#   - %perk_cost% = Perk - cost
#

items:
   order_type:
      type: BOOK
      name: "&bOrder type"
      lore:
      - "&8- &7%order_normal%"
      - "&8- &7%order_id%"
      - "&8- &7%order_amount%"
      - ""
      - "&eClick to change!"
   filter:
      type: HOPPER
      name: "&bFilters"
      lore:
      - "&7Select which items you"
      - "&7want Chester to collect"
      - "&7from the ground."
      - ""
      - "&eClick to change!"
   next:
      type: PAPER
      name: "&eNext page (%perks_actual_page%-%perks_pages%)"
   previous:
      type: PAPER
      name: "&ePrevious page (%perks_actual_page%-%perks_pages%)"
   close:
      type: ARROW
      name: "&cExit"
   back:
      type: ARROW
      name: "&cReturn"
   profile:
      type: CHEST
      name: "&bProfile"
      lore:
      - ""
      - "&eClick to view!"
   info:
      type: CHEST
      name: "&bInformations"
      lore:
      - "&7Name: %chester%"
      - "&7Heath: %health%/%max_health%"
      - "&7PerkPoints: %perk_points%"
   invalid_slot:
      type: GRAY_STAINED_GLASS_PANE
      name: "&cSlot yet to be unlocked"
      lore:
      - "&8» &7Price: &b$%price%"
      - ""
      - "&eClick to purchase!"
   invalid_slot_for_buy:
      type: GRAY_STAINED_GLASS_PANE
      name: "&cSlot yet to be unlocked"
   change_name:
      type: NAME_TAG
      name: "&bChange name"
      lore:
      - "&7Choose a new name"
      - "&7for your Chester."
      - ""
      - "&eClick to rename!"
   stats:
      type: GLOBE_BANNER_PATTERN
      name: "&bStatistics"
      lore:
      - "&8» &7Objects picked-up: &b%pickup%"
      - "&8» &7Objects dropped: &b%dropped%"
      - "&8» &7Distance traveled: &b%distance%"
   perks:
      type: OAK_SAPLING
      name: "&bPerks"
      lore:
      - "&7Upgrade your Chester"
      - "&7with this perks."
      - "&8» &7PerkPoints: &b%perk_points%"
      - ""
      - "&eClick to open!"
   perk_locked:
      type: RED_STAINED_GLASS_PANE
      name: "&cNot available"
   perk_upgrade:
      type: GREEN_STAINED_GLASS_PANE
      name: "&bUpgrade"
      lore:
      - "&8» &7Type: &b%perk_type%"
      - "&8» &7Value: &b%perk_value%"
      - "&8» &7Cost: &b%perk_cost%"
      - ""
      - "&eClick for buy!"
   perk_upgraded:
      type: LIME_STAINED_GLASS_PANE
      name: "&bUpgraded"
      lore:
      - "&8» &7Type: &b%perk_type%"
      - "&8» &7Value: &b%perk_value%"
   pickup:
      type: DIAMOND
      name: "&bPick-up"
      lore:
      - ""
      - "&eClick to pick-up!"
                    

Choose the language, change the menus, sounds, perk points.

lang: spanish
main_inv: # Material or ID/Durability
   background: GRAY_STAINED_GLASS_PANE
   border: BLACK_STAINED_GLASS_PANE
inv:
   border: ORANGE_STAINED_GLASS_PANE
perks_inv:
   border: GRAY_STAINED_GLASS_PANE
filters_inv:
   border: GRAY_STAINED_GLASS_PANE
perkpoints:
   cooldown: 300 # seconds
   amount: 1
sound:
   true: BLOCK_NOTE_BLOCK_BASS
   fail: BLOCK_ANVIL_DESTROY
   walk: BLOCK_BAMBOO_STEP
   death: ENTITY_ARMOR_STAND_BREAK
   damage: ENTITY_ARMOR_STAND_HIT
   pickup: ENTITY_ITEM_PICKUP
   eat: ENTITY_PARROT_EAT

# Spigot: 1.15
# Sounds list: https://helpch.at/docs/1.15/index.html?org/bukkit/Sound.html

# Spigot: 1.8.8
# Sounds list: https://helpch.at/docs/1.8.8/index.html?org/bukkit/Sound.html
                    

If you only need your Chester to collect specific materials, activate the filters. These will help you avoid occupying the storage with junk materials.

name: "Wood"
slot: 21
item:
    type: IRON_AXE
    name: "&bWood"
    lore:
    - "&7Status: %filter_wood_status%"
    - "&7List:"
    - "&8 - &7Oak log/planks"
    - "&8 - &7Spruce log/planks"
    - "&8 - &7Jungle log/planks"
    - "&8 - &7Acacia log/planks"
    - "&8 - &7..."
materials:
- LOG
- WOOD
- WOOD_STEP