Configuration

Config

config.yml
# MineCrates 2.10.0 configuration file
# Created by: extended_clip
# 
# 
# area_handler: World / WorldGuard / MRL / PrisonMines
# area_handler is the name of the hook you want to define crate areas for
# Crate areas are tied to the name of the world / mine / region you choose
# depending on the hook you use.
# 
# crate_despawn_time: <time in seconds that crates will despawn after spawning>
# 
# crate_material: <Material or ID of the crate block that is spawned>
# 
# crate_inventory_name: <name of the inventory shown when the crate is opened>
# 
# ==================================================
# 
# Crate area configuration:
# 
# Almost all entries in areas are optional
# although you must have a drop_counter and drop_chance entry.
# You must also have a rewards section with at least 1 valid reward list for the area to be loaded.
# 
# areas:
#   (region, mine, or world name): 
#     permission: (if you want players to have a certain permission to obtain crates in this area, add the permission node here)
#     drop_counter: (how many blocks need to be broken before a crate has a chance to spawn)
#     drop_chance: (what is the chance out of 100.0 that a crate will spawn when the counter reaches 0)
#     alternate_areas:
#     - (if you would like to allow this area options to be used for other areas)
#     - (that way all rewards and options are shared, you can list the alternate area names here)
#     - world_nether
#     - world_the_end
#     counted_materials:
#     - (if you only want to have certain materials count towards the counter)
#     - (you can list them here, otherwise don't add this option)
#     - DIAMOND_ORE
#     - EMERALD_ORE
#     reward_on_break: <true/false> should rewards be given on break of the block instead of spawning a crate
#     rewards: (this section holds all reward related options specific to this area)
#       (name of this reward list):
#         priority: (if you have multiple lists, the lowest priority list will be applied if player has multiple list permissions)
#         permission: (optional if you require players have certain permission to obtain rewards in this list)
#         max_rewards_per_crate: (max amount of rewards a player can get in a crate from this list)
#         only_owner_can_open: (should only the person this crate spawned for be allowed to open it)
#         crate_spawn_actions: (these actions are performed when a crate holding this reward list is spawned)
#         - [msg] You found a crate
#         - [broadcast] @p found a crate
#         - [command] eco give @p 100
#         - [playersound] ANVIL_LAND 10 1
#         - [worldsound] ANVIL_BREAK 10 1
#         - [effect] helix
#         crate_open_actions: (these actions are performed when a crate holding this reward list is opened)
#         - [msg] You opened a MineCrate!
#         - [broadcast] @p opened a crate
#         - [playersound] CHEST_OPEN 10 1
#         - [effect] atom
#         crate_despawn_actions: (these actions are performed when a crate holding this reward list is despawned if it was not opened)
#         - [msg] You missed your crate
#         - [worldsound] ANVIL_BREAK 10 1
#         - [effect] heart
#         items: (this section holds all of the actual commands / items given as rewards)
#           (unique name for this item reward):
#             chance: (chance this reward will be selected) the chance system is explained below...
#             item: (if this reward is an itemstack, you must specify 'item:' here, otherwise you will specify 'commands:')
#               material: (if this is an item, these are the item options you can use)
#               data: (data value if needed)
#               amount: (amount of this item to give)
#               name: (display name to set on this item)
#               lore:
#               - (add your lore here if you want)
#               - (supports multiple lines)
#               enchantments:
#               - <ENCHANTMENT NAME>,<LEVEL>
#           (unique name for this command reward):
#             chance: 50.0
#             commands:
#             - (list all your commands here, they must start with a valid action identifier)
#             - [command] eco give @p 100
#             - [msg] you got 100 bucks!
# ==================================================
# 
# CRATE SPAWN CHANCE INFORMATION
# 
# This chance can be any double value from 0.01 to 100.0
# it is percentage based, so if you set the chance to 10.0
# there will be a 10% chance a crate will spawn when the break
# counter reaches 0. If you set it to 99.0, there will be a 99% chance
# that a crate will spawn when the counter rewaches 0.
# 
# ==================================================
# 
# REWARD CHANCE INFORMATION
# 
# All rewards in a specific reward list have a chance associated with the item/commands that are executed for that reward.
# All reward chances in a list must add up to or be less than 100.0
# Example:
# 
#     rewards:
#       VIP_REWARDS:
#         priority: 1
#         permission: vip.rewards
#         max_rewards_per_crate: 1
#         only_owner_can_open: true
#         items:
#           item_1:
#             chance: 10.0
#             item:
#               material: DIAMOND
#               amount: 128
#           item_2:
#             chance: 15.0
#             item:
#               material: IRON_INGOT
#               amount: 64
#           item_3:
#             chance: 25.0
#             item:
#               material: DIRT
#               amount: 64
#           command_1:
#             chance: 25.0
#             commands:
#             - [command] eco give @p 25
#             - [msg] You got 25 bucks
# 
# With this example, all of our chances add up to 75.0,
# This means that there is a 25% chance that we get nothing each time a reward is
# being selected. If we want to make sure players always get a reward, we could
# simply add one more reward item or command with the remainder percentage for all of our
# chances to equal 100.0, which would be 25.0.
# This system allows you to set what items are rare, and which items are going to be
# more commonly selected when the plugin chooses rewards.
# Always keep in mind that all reward chances must be less than, or add up to 100.0
# If your combined chance exceeds 100.0, the rewards that are being checked after 100.0 has
# been reached will not be loaded. Also remember, to make it where a player has a chance to get
# no reward, always leave the total chance less than 100.0 as all chance remaining will
# be the chance amount that no reward is chosen.
# 
# ==================================================
# 
# CRATE SPAWN/DESPAWN/OPEN/COMMANDS ACTION IDENTIFIERS
# 
# Any action added to these lists must contain a specific identifier
# as there are more actions than just commands to be executed.
# These actions are as follows:
# 
# [msg] <message>
# This will send a raw message to the target player
# 
# [broadcast] <message>
# This will broadcast a message to the entire server
# 
# [command] <command here>
# This will execute a command in the console
# 
# [worldsound] <sound> <volume> <pitch>
# This will play a sound to the entire world at the crate location
# 
# [playersound] <sound> <volume> <pitch>
# This will play a sound to the target player
# 
# [effect] <effectName>
# This will play a preset effect at the crate location
# 
# effect names:
#   animatedball
#   arc
#   atom
#   bleed
#   circle
#   cloud
#   cone
#   cube
#   cylinder
#   disco
#   dna
#   donut
#   dragon
#   earth
#   explode
#   flame
#   fountain
#   grid
#   heart
#   helix
#   hill
#   icon
#   love
#   music
#   shield
#   smoke
#   sphere
#   star
#   tornado
#   vortex
#   warp
#   wave
#   
# ==================================================
# 
# Optional: display a temporary hologram above the MineCrate when it is spawned.
# 
# To enable this feature, add the following entry to the top of your config file:
# 
# You can either use HolographicDisplays API to display the hologram, or the internal
# hologram mechanics. Set handler: none to disable holograms
# 
# Note: the internal hologram handler is only available for 1.8.8
# More hologram handlers will be coming soon.
# 
# crate_hologram:
#   handler: none/internal/holographicdisplays
#   message:
#   - '%player%s MineCrate'
#   - '(Right click to open)
#   height: 2'
# 
# Inside of the message, you can use the following placeholders:
#  %player% - shows players name who MineCrate is for
#  %area% - name of the area the crate spawned in
#  %rewardlist% - name of the list the rewards were chosen from
#  %rewards% - amount of rewards inside of the MineCrate
# 
# ==================================================

crate_hologram:
  handler: none
  message:
  - '&f%player%''s &aMineCrate'
  - '&e(&7Right click to open&e)'
  height: 2.2
check_updates: true
area_handler: World
ignore_silk_touch: true
crate_despawn_time: 30
crate_material: ENDER_CHEST
crate_inventory_name: '%reward_list_name% &aMineCrate'
messages:
  help:
  - '&aMineCrates &fhelp'
  - '&a/minecrates reload &7- &freload the plugin'
  - '&a/minecrates info &7- &fView minecrates information for the area you are standing'
  - '&a/minecrates ignore &7- &ftoggle on/off ignoring minecrates for yourself'
  ignore_toggle_on: '&aYou are now ignoring MineCrates!'
  ignore_toggle_off: '&fYou are no longer ignoring MineCrates!'
  only_owner_can_open_crate: '&cOnly &f@p &ccan open this &aMineCrate!'
  no_permission: '&cYou don''t have permission to do that!'
areas:
  world:
    permission: minecrates.getcrates.world
    drop_counter: 100
    drop_chance: 50.0
    cooldown: 30
    counted_materials:
    - COAL_ORE
    - IRON_ORE
    - GOLD_ORE
    - DIAMOND_ORE
    rewards:
      vip:
        priority: 1
        permission: minecrates.rewards.world.vip
        max_rewards_per_crate: 1
        only_owner_can_open: true
        crate_spawn_actions:
        - '[message] &aYou found a VIP MineCrate!'
        - '[command] eco give @p 100'
        - '[broadcast] &f@p &afound a MineCrate!'
        - '[effect] helix'
        crate_despawn_actions:
        - '[message] &7Your crate has despawned!'
        - '[effect] helix'
        items:
          example_item:
            chance: 20.0
            item:
              material: DIAMOND
              data: 0
              amount: 64
              name: '&bVIP &3Diamonds'
              lore:
              - This item is only available to players who
              - have permission for this vip reward list!
              enchantments:
              - LUCK,1
          example_command_1:
            chance: 1.0
            commands:
            - '[command] eco give @p 1000000'
            - '[msg] You got 1000000 dollars!'
          example_command_2:
            chance: 30.0
            commands:
            - '[command] eco give @p 500'
            - '[msg] You got 500 dollars!'
          example_command_3:
            chance: 49.0
            commands:
            - '[command] eco give @p 1000'
            - '[msg] You got 1000 dollars!'
      default:
        priority: 2
        max_rewards_per_crate: 1
        only_owner_can_open: false
        crate_spawn_actions:
        - '[message] &aYou found a regular MineCrate!'
        - '[command] eco give @p 100'
        - '[broadcast] &f@p &afound a MineCrate!'
        - '[effect] helix'
        items:
          example_item_1:
            chance: 5.0
            item:
              material: DIAMOND
              amount: 16
          example_item_2:
            chance: 10.0
            item:
              material: IRON_INGOT
              amount: 32
          example_command:
            chance: 85.0
            commands:
            - '[command] eco give @p 250'
            - '[msg] You got 250 dollars!'

Last updated