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.
Particle Patterns
NORMAL:
HELIX:
RISING_HALO:
BURST:
Z:
GODLYEXPLOSION ;)
config.yml
#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_exampleTier.yml
#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.htmlHow 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!
Similar projects
Plugin →Let Me Despawn
Improves performance by tweaking mob despawn rules. Say bye to pesky unintentional persistent mobs.
25MSueta
JourneyMap
Real-time map used for mapping in-game or your browser as you explore.
14.7MSueta
Emotecraft
Create your own emotes in Minecraft.
7.5MSueta
Simple Tpa
A simple tpa plugin which sends requests
5.4MSueta
Common Network
Forge and Fabric Unified Networking Solution
3.9MSueta
Set Home
A lightweight plugin for players to set their homes.
3.8MSueta