CraftZChests icon

CraftZChests -----

Auto regenerating chests



Page Last Updated: June 20th, 2021

Description:

Great for Minigames! Automatic chest regeneration. Create chests that drop loot for players and regenerate after a certain amount of time. Very configurable and active support is provided.

Features:
  • Crash protection (/regenall command)
  • Efficient data storage and retrieval
  • Easy-to-use
  • Multiple tiers
  • No lag (tested with over 250 chests on a 3GB server)
  • Particles!
  • Sounds
  • Custom loottables (Support for durability, enchantments, potion color/effects/duration/level)
  • Commands in loottable (Allows things such as awarding players money)
  • Invisible chests config option (Make chests completely invisible using a barrier instead of a chest)
  • Chest "pop" - chest disappears on right-click and loot drops
  • Configurable regeneration time
  • Configure number of items that drop
  • Configure repeated drops
  • Configure item display name
  • Sync chest locations between servers by connecting to the same database. Chests will regen independently, but locations are exactly the same between servers (allows for easy copying of a server).
  • Destroy a chest by sneaking and breaking!
Commands:
  • /cr help - shows these helpful commands
  • /cr reload - reload config and lang files (Note: This will not connect to the database if you just now added that info. You MUST restart).
  • /cr list (tiers/chests) - lists some helpful info about tiers and chests that exist.
  • /cr near - list the locations of all nearby chests.
  • /cr regen <radius> - Regenerates all chests within a certain radius.
  • /cr regenall - Regenerates all chests in the database. Helpful in case of a crash and chests do not regenerate.
  • /cr delete <tier> - Permanently deletes the tier specified AND removes all instances of placed chests of that tier.
  • /cr create <tier> - Creates a tier of the specified name. Pulls up a GUI to add items with ease.
  • /cr get <tier> <amount> - gives you a regen chest of the tier specified to place down.
  • /cr rename <oldTierName> <newTierName> - renames a tier.
Permissions:
  • cr.create
  • cr.delete
  • cr.help
  • cr.rename
  • cr.get
  • cr.reload
  • cr.regen
  • cr.regenall
  • cr.destroy - destroy a chest by sneaking and breaking
  • cr.list
  • cr.near
  • cr.place - allows a player to create a new regen chest by placing it down.

NORMAL:
Screenshot (723).png
HELIX:
Screenshot (735).png
RISING_HALO:
Screenshot (737).png
BURST:
Screenshot (733).png
Z:
Screenshot (729).png
GODLYEXPLOSION ;)
Screenshot (727).png

Code (YAML):
#Configuration file for CraftZChests 1.0.0

language
: eng #Currently only supports English

#The "MASTER SWITCH". Disabling sounds or particles here disables for ALL tiers!
sounds
:
  enabled
: true
    #Not all sounds guaranteed to work in your minecraft version
  default_effect
: ENTITY_PLAYER_LEVELUP #Found here: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html . GET THE LINK FOR YOUR VERSION!
 
particles
:
  enabled
: true
    #Not all particles guaranteed to work in your minecraft version
  default_particle
: FIREWORKS_SPARK #Found here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html GET THE LINK FOR YOUR VERSION!
 
respawn_conditions
:
  player_nearby
:
    enabled
: false
    radius
: 10   #Radius in blocks. A chest won't regen if a player is within this radius. Larger radius creates more lag (keep < 100)
 
datastorage
:
  host
: localhost #These sections only needed if MySQL is chosen
  port
: 3306
  database
: minecraft
  username
: root
  password
: Ilikepi
  tableprefix
: CZ_

Code (YAML):
#DO NOT MODIFY THIS! Randomly generated
ID
: CZC5902

max_item_count
: 4 # Max number of items in total
min_item_count
: 2 # Min number of items in total (2 bread or 1 apple and 1 bread)
allow_item_repeats
: true #Can a certain item in the loottable be given twice?

#regeneration
max_regen_seconds
: 300
min_regen_seconds
: 60

sound
:
  enabled
: true
  effect
: DEFAULT # What sound do you want played when a chest is opened? Put "DEFAULT" to use the one in config.yml
particles
:
  enabled
: true
  effect
: DEFAULT   # What particle do you want when a chest is opened? Put "DEFAULT" to use the one in config.yml
  shape
: NORMAL #Options are NORMAL, HELIX, RISING_HALO, BURST, Z
invisible
: false #Makes the chest into a barrier instead of a physical chest

#loot below

items
:
  item1
:
    material
: BREAD
    weight
: 20
    amount
: 3
  item2
:
    material
: WOOD_SWORD
    weight
: 20
    amount
: 1
    max_durability
: .3
    min_durability
: .1 #Both durabilities must be between 0-1, but 1 cannot be used (tool would be broken). Represents a PERCENT of maximum durability of an item.
    enchants
:
      enchantment1
:
        name
: DAMAGE_ALL #Found here: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/enchantments/Enchantment.html GET THE LINK FOR YOUR VERSION!
        level
: 2
      enchantment2
:
        name
: KNOCKBACK
        level
: 1
  item3
:
    material
: SPLASH_POTION
    weight
: 20
    amount
: 1
    display_name
: '&cPotion of Health'
    potion_effect
: HEAL #Found here: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/potion/PotionEffectType.html GET THE LINK FOR YOUR VERSION!
    potion_level
: 1   #Level begins at 0. (0 means Heal I)
    potion_duration
: 1 #Duration in ticks (20 ticks = 1 second)
    potion_hide_effects
: true
    potion_color
: #NOTE: You MUST use these values to change the color of the potion or all potions will be the same color.
      red
: 43
      green
: 199   #Number between 1-255 for each Red, green, blue. Google "rgb color picker" and take those rgb values.
      blue
: 204
  item4
:
    command
: 'eco give {player } 1'
    weight
: 10
      #OTHER NOTES:
      #FOR 1.12 - use "INK_SACK" for material name AND specify a dye_color!!!
      #Exampleitem:
        #material: INK_SACK
        #dye_color: BLUE ...etc https://helpch.at/docs/1.12.2/org/bukkit/DyeColor.html


How to Install:
1. Download the jar file and drop into your plugins folder.
2. Restart your server.
3. Go into the config.yml and add your MySQL database info
4. Restart your server again.

Need support? Join the discord!

Donate!
While I have released this plugin for free, many many hours of work have gone into it. I would appreciate, especially if you are profiting from my work, any donations using the Paypal link above so I can buy myself some pasta ;). Thank you!

Please leave a review as well! I appreciate any and all feedback. For bug reports see the discord!
Resource Information
Author:
----------
Total Downloads: 522
First Release: Apr 22, 2021
Last Update: Jun 21, 2021
Category: ---------------
All-Time Rating:
2 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings