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.
#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.
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!