VoidChest Configuration Documentation
This document provides a comprehensive guide to configuring the default.yml
file for the VoidChest plugin. Each voidchest type must have its own YAML file (e.g., default.yml
, Supreme.yml
, Epic.yml
, etc.). Below is a detailed explanation of each option available in the default.yml
file, along with examples and additional information.
Table of Contents
Mechanics
block
block
Description: Specifies the type of block that represents the voidchest.
Type: String
Default:
CHEST
Example:
booster
booster
Description: A multiplier that applies to the total income generated by the voidchest.
Type: Float
Default:
1.0
Formula:
(ItemPrice * boost * other boosts...)
Example:
shift click open
shift click open
Description: Defines the action when a player shift-clicks the voidchest.
Type: String
Available Modes:
MENU
,CHEST
,NONE
,CONTAINER
Default:
CHEST
Example:
right click open
right click open
Description: Defines the action when a player right-clicks the voidchest.
Type: String
Available Modes:
MENU
,CHEST
,NONE
,CONTAINER
Default:
MENU
Example:
enable when owner offline
enable when owner offline
Description: Determines if the voidchest should operate when the owner is offline.
Type: Boolean
Default:
true
Example:
paginated inventory
paginated inventory
Description: Specifies whether the inventory should be paginated.
Type: Boolean
Default:
false
Example:
links
links
Description: Determines if the voidchest can have container links.
Type: Boolean
Default:
false
Example:
prevent
prevent
Description: Configures various prevention settings for voidchest placement and interaction.
chest near voidchests
Description: Prevents players from placing a chest next to other voidchests.
Type: Boolean
Default:
false
Example:
voidchests near chests
Description: Prevents players from placing a voidchest next to other chests.
Type: Boolean
Default:
false
Example:
placing voidchests in same chunk
Description: Prevents players from placing a voidchest in the same chunk as other voidchests.
Type: Boolean
Default:
true
Example:
creative mode interaction
Description: Prevents players from interacting with voidchests while in creative mode.
Type: Boolean
Default:
true
Example:
placing other voidchests near
Description: Prevents players from placing other voidchests near the current voidchest.
Type: Boolean
Default:
false
Example:
voidchest from exploding
Description: Prevents voidchests from exploding.
Type: Boolean
Default:
false
Example:
break
break
Description: Configures messages and behaviors when a voidchest is broken.
failed other
Description: Sent when a player breaks a voidchest that belongs to someone else without permission.
Type: Boolean
Default:
true
Example:
permission deny
Description: Sent when a player attempts to break a voidchest without permission.
Type: Boolean
Default:
true
Example:
successful
Description: Sent when a player successfully breaks a voidchest.
Type: Boolean
Default:
true
Example:
store stats
Description: Stores statistics when a voidchest is broken and recovers them when placed again.
Type: Boolean
Default:
false
Example:
drop voidchest on explosion
Description: Determines if voidchests drop when exploded.
Type: Boolean
Default:
false
Example:
place
place
Description: Configures messages and behaviors when a voidchest is placed.
permission deny
Description: Sent when a player places a voidchest without permission.
Type: Boolean
Default:
true
Example:
successful
Description: Sent when a player successfully places a voidchest.
Type: Boolean
Default:
true
Example:
delay check
Description: Delays the check when placing a voidchest.
Type: Boolean
Default:
false
Example:
limit
Description: Limits the number of voidchests a player can place.
Type: Integer
Default:
5
Example:
auto sell
auto sell
Description: Enables or disables auto sell for a new voidchest by default.
Type: Boolean
Default:
true
Example:
purge items
purge items
Description: Enables or disables the purge invalid items for a new voidchest by default.
Type: Boolean
Default:
true
Example:
chunk collector
chunk collector
Description: Enables or disables the chunk collector for a new voidchest by default.
Type: Boolean
Default:
true
Example:
charge
charge
Description: Enables or disables the charge system for a new voidchest by default.
Type: Boolean
Default:
true
Example:
hologram
hologram
Description: Enables or disables the hologram for a new voidchest by default.
Type: Boolean
Default:
true
Example:
bank
bank
Description: Enables or disables the bank for a new voidchest by default.
Type: Boolean
Default:
false
Example:
Options
sell interval
sell interval
Description: Specifies how often the voidchest should attempt to sell items.
Type: Integer
Default:
10
Example:
profit calculator
profit calculator
Description: Defines the priority of profit calculators.
Type: List
Default:
sound
sound
Description: Configures sounds played when a voidchest is placed or broken.
place
Description: Sound played when a voidchest is placed.
Type: String
Default:
LEVEL_UP
Example:
break
Description: Sound played when a voidchest is broken.
Type: String
Default:
ANVIL_BREAK
Example:
upgrade
Description: Sounds played during voidchest upgrades.
success
Description: Sound played when an upgrade is successful.
Type: String
Default:
ORB_PICKUP
Example:
failure
Description: Sound played when an upgrade fails.
Type: String
Default:
VILLAGER_NO
Example:
links
links
Description: Maximum number of links a voidchest can have.
Type: Integer
Default:
3
Example:
auto sell force disable
auto sell force disable
Description: Forcefully disables the auto sell system.
Type: Boolean
Default:
false
Example:
purge items force disable
purge items force disable
Description: Forcefully disables the purge items system.
Type: Boolean
Default:
false
Example:
bank force disable
bank force disable
Description: Forcefully disables the bank system.
Type: Boolean
Default:
false
Example:
chunk collector
chunk collector
Description: Configures the chunk collector settings.
mode
Description: Specifies the mode of the chunk collector.
Type: String
Available Modes:
CHUNK
,BOUNDINGBOX
Default:
CHUNK
Example:
force disable
Description: Forcefully disables the chunk collector.
Type: Boolean
Default:
false
Example:
transfer non sellables
Description: Enables or disables the transfer of non-sellable items.
Type: Boolean
Default:
false
Example:
instant collector
Description: Configures the instant chunk collector.
enabled
Description: Enables or disables the instant chunk collector.
Type: Boolean
Default:
false
Example:
force disable
Description: Forcefully disables the instant chunk collector.
Type: Boolean
Default:
false
Example:
filters
Description: Configures the filter settings.
allow mode
Description: Enables or disables the allow mode for filters.
Type: Boolean
Default:
false
Example:
user allow mode
Description: Allows players to set the filter to allow mode.
Type: Boolean
Default:
false
Example:
force disable allow mode
Description: Forcefully disables the allow mode.
Type: Boolean
Default:
false
Example:
force disable
Description: Forcefully disables the filter system.
Type: Boolean
Default:
false
Example:
Inventory
title
title
Description: Title of the voidchest inventory.
Type: String
Default:
"&c&l%voidchest% Inventory (%currentPage%)"
Example:
size
size
Description: Size of the voidchest inventory.
Type: Integer
Available Sizes:
9
,18
,27
,36
,45
,54
Default:
27
Example:
paginated inventory
paginated inventory
Description: Configures the paginated inventory settings.
max pages
Description: Maximum number of pages in the paginated inventory.
Type: Integer
Default:
5
Example:
slots
Description: Configures the slots in the paginated inventory.
0
Description: Configures the first slot.
Type: Map
Example:
4
Description: Configures the fifth slot.
Type: Map
Example:
8
Description: Configures the ninth slot.
Type: Map
Example:
shop item lore
shop item lore
Description: Lore for shop items.
Type: List
Default:
filter item lore
filter item lore
Description: Lore for filter items.
Type: List
Default:
Charge
force disable
force disable
Description: Forcefully disables the charge system.
Type: Boolean
Default:
false
Example:
break persistent
break persistent
Description: Configures persistent charge settings when a voidchest is broken.
enabled
Description: Enables or disables persistent charge.
Type: Boolean
Default:
false
Example:
save time
Description: Saves the charge time when a voidchest is broken.
Type: Boolean
Default:
false
Example:
hologram
hologram
Description: Configures hologram placeholders.
no fuel
Description: Placeholder text for no fuel.
Type: String
Default:
'No Fuel'
Example:
placeholder
placeholder
Description: Configures item placeholders.
no fuel
Description: Placeholder text for no fuel.
Type: String
Default:
'No Fuel'
Example:
max time
max time
Description: Maximum charge time.
Type: Integer
Default:
172800
Example:
renewal time
renewal time
Description: Charge time to be added.
Type: Integer
Default:
3600
Example:
price
price
Description: Charge price.
Type: Integer
Default:
20000
Example:
Hologram
force disable
force disable
Description: Forcefully disables the hologram system.
Type: Boolean
Default:
false
Example:
height
height
Description: Height of the hologram.
Type: Float
Default:
3.9
Example:
text
text
Description: Text displayed on the hologram.
Type: List
Default:
Item
drop straight to inventory
drop straight to inventory
Description: Determines if the voidchest item should drop directly into the player's inventory when broken.
Type: Boolean
Default:
false
Example:
name
name
Description: Name of the voidchest item.
Type: String
Default:
'&c&l%voidchest% VoidChest'
Example:
lore
lore
Description: Lore of the voidchest item.
Type: List
Default:
Last updated