🥥CocoVaults Lite

CocoVaults-Lite Documentation

CocoVaults-Lite is a simplified virtual vault plugin for Minecraft servers. This lighter version provides players with personal storage containers accessible from anywhere, featuring file-based storage backends, intuitive GUI, and essential administrative tools for server management.

Main Features

🏦 Virtual Storage System

• Personal Vaults: Each player gets their own set of virtual storage containers

• GUI Management: Intuitive graphical interface for vault access and management

• Fixed Capacity: Each vault provides 54 slots of storage (double chest size)

• Permission-based System: Configure vault quantity and access based on player permissions

• Vault Unlocking: Special permission system for unlocking specific vault numbers

💾 Storage Backends

• YAML: Simple file-based storage for small servers

• JSON: Modern file-based storage with better performance

🎨 Customization & Management

• Custom Vault Icons: Players can personalize their vault appearances

• Vault Renaming: Custom names with color code support

• Item Blacklist: Prevent specific items from being stored

• Admin Tools: Complete administrative control over player vaults

• Cooldown System: Configurable vault access cooldowns

Configuration

Complete Configuration File

# Version of the configuration file / plugin, do not
# modify this file or you will disrupt the
# version and a new file will be created.
Config-Version: 2.1
Plugin-Version: 2.2-ALPHA

#######################
##  Storage Settings ##
#######################
# Plugin Storage, you can edit them according to your needs.
Storage-Mode:
  # Try migrating your data to a safer operation like JSON
  Mode: JSON # Available: YAML,JSON

#########################
##  Plugin Permissions ##
#########################
# The vault permissions is: cocovaults.quantity.X
Plugin-Permissions:
  ALL: cocovaults.*
  Open-Vaults: cocovaults.open
  Admin-Vaults: cocovaults.admin
  Change-Icons: cocovaults.icons
  Rename: cocovaults.rename
  Rename-Color: cocovaults.rename.color
  GUI-Access: cocovaults.gui

######################
##  Plugin Messages ##
######################
# Plugin messages, you can edit them according to your needs.
Messages:
  Prefix: '<aqua>Coco</aqua><white>Vaults</white> <dark_gray><bold>» </bold></dark_gray>'
  No-Perms: "<red>You don't have permissions to run this command"
  No-Subcmd: "<red>This command doesn't exist"
  No-Player-Found: "<red>This player doesn't exist"
  Reloading: "<yellow>Reloading..."
  Reloaded-Success: "<green>Config was reloaded correctly"
  Only-players: "<red>This command can only be used by players"
  Full-Space: "<red>You can't fit any more things in your Vault"
  No-More-Vaults: "<red>You cannot open more vaults"
  No-Admin: "<red>You cannot open other players' Vaults"
  Blacklisted-Item: "<red>You can't save this in Vaults"
  Opened-Vault: "<green>Vault %vault% <green>opened successfully"
  Changed-Icon: "<green>Vault icon changed correctly"
  Analysis-Error: "<red>There was an error when making this request"
  Saved-Vault: "<green>Vault closed correctly"
  Invalid-Material: "<red>Invalid item material."
  Vault-Deleted: "<red>Vault deleted successfully."
  Vault-Restored: "<green>Vault restored successfully"
  Data-Loading-Error: "<red>Plugin data has not loaded yet"
  Data-Loading-Please-Wait: "<red>Please Wait, Loading data..."
  GUI-Item-Name: "<white>CocoVault <green>%vault%"
  Vault-Closed-Due-To-Inactivity: "<red>The vault was closed due to inactivity"
  No-Valid-Count-Give: '<red>Invalid number of Vaults'
  Gived-Vaults: '<green>You gave %count% number of Vaults to %player%'
  Conversion-Started: "<yellow>Starting conversion of all data from PlayerVaultsX..."
  Conversion-Complete: "<green>Conversion from PlayerVaultsX has completed successfully! %vaults% %players% player vaults have been converted."
  Import-Confirmation: "<yellow>This action will overwrite existing data. Enter the command again to confirm the import."
  Specify-Vault: "<red>Please specify a Vault number or name."
  Vault-Renamed: "<green>Vault renamed to %vault%."
  Invalid-Vault: "<red>Vault invalid or not found."
  Removed-Vaults: "<green>%count% Vaults have been successfully removed from player %player%."
  No-Valid-Count-Remove: "<red>Please specify a valid number of Vaults to remove."
  Not-Enough-Vaults-To-Remove: "<red>The player currently has additional %current% Vaults. You cannot remove %requested% Vaults."
  Vault-Removed: "<green>Vault %vault% has been successfully removed."
  Additional-Vaults-Updated: "<green>The number of additional Vaults has been updated to %current%."
  Vault-Closed-Due-To-Deletion: "<red>One of your Vaults has been deleted by an administrator."
  Storage-Mode-Invalid: "<red>The specified storage mode is invalid or not supported."
  Opened-Vault-Admin: "<green>You have opened the Vault %Vault% of %Player%."
  Vault-Closed: "<green>You have closed your vault."
  Wait-Cooldown: "<red>You must wait %seconds% seconds to open your cocovault again."
  Import-Not-Possible: "<red>Import is not possible. Please Check Console Log"
  Vault-Locked-By-Admin: "<red>Your Vault has been closed because an administrator has edited it."
  Vault-Updated-By-Admin: "<yellow>Your Vault has been updated by an administrator."
  Vault-Locked: "<red>You don't have access to this vault."

####################
##  GUI Settings  ##
####################
# General adjustment of GUIs
GUIs:
  Vault-List-GUI: "<black>CocoVaults GUI - Page %page%"
  GUI-Item-Name: "<white>CocoVault <green>%vault%"
  Player-Vault: "<black>CocoVault %vault%"
  Next-Page-Button: "<white>Next Page ➡"
  Previous-Page-Button: "<white>⬅ Previous Page"

# GUI Items
GUI-Items:
  Default-Vault: CHEST
  Lore-Vaults:
    - '<green>CocoVault - Virtual Chest'
    - ''
    - '<green>Open your CocoVault and access'
    - '<green>your remote storage'
    - ''
    - '<yellow>Occupied space: <white>[<green>%usage%<white>/<dark_gray>54<white>]'
    - '<yellow>Free space: <white>[<green>%free%<white>/<dark_gray>54<white>]'
    - ''
    - '<yellow>Click to open the CocoVault'
  Decoration: BLACK_STAINED_GLASS_PANE
  Next-Page-Item: ARROW
  Previous-Page-Item: ARROW

#################################
##  Miscellaneous Adjustments  ##
#################################
# Important to determine the utility
# and plugin rules
Misc-Settings:
  Max-Vaults: 100
  Open-Cooldown: 1 # 1 second, Useful to avoid problems with openness, -1 to disable. Accept decimal values (float)
  Close-Opens-Main-GUI: false # Close Vault opens the main gui?
  Open-Sound: BLOCK_ENDER_CHEST_OPEN # What sound does Vault do when you open it?
  Close-Sound: BLOCK_ENDER_CHEST_CLOSE # What sound does Vault do when you close it?

######################
##  Item Blacklist  ##
######################
# What should not enter the
# Vaults of the players?
Item-BlackList:
  - DIAMOND_BLOCK
  - DIAMOND

Configuration Options

Storage Settings

Storage-Mode

• Mode: YAML/JSON - Choose your preferred storage backend

  • YAML: Simple file-based storage

  • JSON: Optimized file-based storage

Plugin Permissions

Permission Nodes

• ALL: cocovaults.* - All plugin permissions

• Open-Vaults: cocovaults.open - Permission to open vaults

• Admin-Vaults: cocovaults.admin - Administrative vault access

• Change-Icons: cocovaults.icons - Permission to change vault icons

• Rename: cocovaults.rename - Permission to rename vaults

• Rename-Color: cocovaults.rename.color - Permission to use color codes in names

• GUI-Access: cocovaults.gui - Permission to access GUI

Plugin Messages

All plugin messages support MiniMessage formatting and include:

• Prefix: Plugin message prefix with color formatting

• No-Perms: No permission message

• No-Subcmd: Invalid subcommand message

• No-Player-Found: Player not found message

• Reloading: Plugin reload in progress message

• Reloaded-Success: Successful reload message

• Only-players: Player-only command message

• Full-Space: Vault full message

• No-More-Vaults: Maximum vaults reached message

• No-Admin: No admin permission message

• Blacklisted-Item: Blacklisted item message

• Opened-Vault: Vault opened message (supports %vault% variable)

• Changed-Icon: Icon changed message

• Analysis-Error: Error analysis message

• Saved-Vault: Vault saved message

• Invalid-Material: Invalid material message

• Vault-Deleted: Vault deleted message

• Vault-Restored: Vault restored message

• Data-Loading-Error: Data loading error message

• Data-Loading-Please-Wait: Data loading wait message

• GUI-Item-Name: GUI item display name (supports %vault% variable)

• Vault-Closed-Due-To-Inactivity: Inactivity closure message

• No-Valid-Count-Give: Invalid vault count message

• Gived-Vaults: Vaults given message (supports %count% and %player% variables)

• Conversion-Started: Conversion start message

• Conversion-Complete: Conversion complete message (supports %vaults% and %players% variables)

• Import-Confirmation: Import confirmation message

• Specify-Vault: Specify vault message

• Vault-Renamed: Vault renamed message (supports %vault% variable)

• Invalid-Vault: Invalid vault message

• Removed-Vaults: Vaults removed message (supports %count% and %player% variables)

• No-Valid-Count-Remove: Invalid remove count message

• Not-Enough-Vaults-To-Remove: Insufficient vaults message (supports %current% and %requested% variables)

• Vault-Removed: Single vault removed message (supports %vault% variable)

• Additional-Vaults-Updated: Vault count updated message (supports %current% variable)

• Vault-Closed-Due-To-Deletion: Vault deleted by admin message

• Storage-Mode-Invalid: Invalid storage mode message

• Opened-Vault-Admin: Admin vault access message (supports %Vault% and %Player% variables)

• Vault-Closed: Vault closed message

• Wait-Cooldown: Cooldown wait message (supports %seconds% variable)

• Import-Not-Possible: Import failed message

• Vault-Locked-By-Admin: Admin locked vault message

• Vault-Updated-By-Admin: Admin updated vault message

• Vault-Locked: Locked vault access message

GUI Settings

GUI Names

• Vault-List-GUI: <black>CocoVaults GUI - Page %page% - Main GUI title (supports %page% variable)

• GUI-Item-Name: <white>CocoVault <green>%vault% - Vault item name (supports %vault% variable)

• Player-Vault: <black>CocoVault %vault% - Individual vault title (supports %vault% variable)

• Next-Page-Button: <white>Next Page ➡ - Next page button text

• Previous-Page-Button: <white>⬅ Previous Page - Previous page button text

GUI Items

• Default-Vault: CHEST - Default vault icon material

• Lore-Vaults: List of lore lines for vault items (supports %usage% and %free% variables)

• Decoration: BLACK_STAINED_GLASS_PANE - GUI decoration item

• Next-Page-Item: ARROW - Next page button material

• Previous-Page-Item: ARROW - Previous page button material

Miscellaneous Settings

Misc-Settings

• Max-Vaults: 100 - Maximum number of vaults per player

• Open-Cooldown: 1 - Cooldown in seconds between vault openings (-1 to disable, accepts decimals)

• Close-Opens-Main-GUI: false - Whether closing a vault opens the main GUI

• Open-Sound: BLOCK_ENDER_CHEST_OPEN - Sound played when opening a vault

• Close-Sound: BLOCK_ENDER_CHEST_CLOSE - Sound played when closing a vault

Item Blacklist

Item-BlackList

List of materials that cannot be stored in vaults:

• Example items: DIAMOND_BLOCK, DIAMOND

• Supports any valid Minecraft material name

• Case-sensitive material names

Commands

/cocovaults or /cv

Main command for all vault operations.

Basic Commands

/cv

• Description: Open the vault GUI

• Permission: cocovaults.open

• Usage: /cv or /cocovaults

/cv <number>

• Description: Open a specific vault by number

• Permission: cocovaults.open

• Usage: /cv 1, /cv 5

• Note: Vault number must be within player's limit or unlocked

/cv reload

• Description: Reload plugin configuration

• Permission: cocovaults.admin

• Usage: /cv reload

Administrative Commands

/cv admin <player> <vault>

• Description: Open another player's vault (admin mode)

• Permission: cocovaults.admin

• Usage: /cv admin PlayerName 1

• Effect: Opens player's vault with admin access

/cv give <player> <amount>

• Description: Give additional vaults to a player

• Permission: cocovaults.admin

• Usage: /cv give PlayerName 5

• Effect: Adds extra vaults to player's limit

/cv remove <player> <amount>

• Description: Remove vaults from a player

• Permission: cocovaults.admin

• Usage: /cv remove PlayerName 2

• Effect: Reduces player's vault count

/cv delete <player> <vault>

• Description: Delete a specific vault

• Permission: cocovaults.admin

• Usage: /cv delete PlayerName 3

• Effect: Permanently deletes the specified vault

/cv rename <vault> <name>

• Description: Rename a vault

• Permission: cocovaults.rename

• Usage: /cv rename 1 "My Storage"

• Effect: Changes vault display name

/cv icon <vault>

• Description: Change vault icon to held item

• Permission: cocovaults.icons

• Usage: Hold desired item and use /cv icon 1

• Effect: Changes vault icon in GUI

/cv convert playervaultsx

• Description: Import data from PlayerVaultsX

• Permission: cocovaults.admin

• Usage: /cv convert playervaultsx

• Effect: Migrates data from PlayerVaultsX plugin

/cv storage <mode>

• Description: Switch storage backend

• Permission: cocovaults.admin

• Usage: /cv storage JSON, /cv storage YAML

• Effect: Changes active storage system

Permissions

Basic Permissions

Permission	Description	Default
cocovaults.open	Open personal vaults	All Players
cocovaults.gui	Access vault GUI	All Players
cocovaults.rename	Rename vaults	All Players
cocovaults.rename.color	Use color codes in vault names	All Players
cocovaults.icons	Change vault icons	All Players

Administrative Permissions

Permission	Description	Default
cocovaults.admin	All administrative functions	OP
cocovaults.*	All plugin permissions	OP

Vault Quantity Permissions

Permission	Description	Default
cocovaults.quantity.<number>	Access to specific number of vaults	None
cocovaults.unlocked.<number>	Unlock specific vault number	None

Examples:

• cocovaults.quantity.5 - Player can have 5 vaults

• cocovaults.quantity.20 - Player can have 20 vaults

• cocovaults.unlocked.50 - Player can access vault #50 specifically

Available Variables

In messages and GUI elements you can use the following variables:

• %vault% - Vault number or name

• %player% - Player name

• %page% - GUI page number

• %usage% - Number of used slots in vault

• %free% - Number of free slots in vault

• %count% - Count of vaults

• %current% - Current number of vaults

• %requested% - Requested number of vaults

• %vaults% - Total vaults converted

• %players% - Total players processed

• %seconds% - Cooldown time in seconds

• %Vault% - Vault number (capitalized)

• %Player% - Player name (capitalized)

How It Works

Vault Access System

1. Permission Check: Verifies player has access to requested vault

2. Data Loading: Loads vault data from storage if needed

3. GUI Creation: Creates and displays vault interface

4. Activity Tracking: Tracks player activity for inactivity management

Storage System

1. On-Demand Loading: Loads vault data when needed

2. YAML Storage: Simple file structure for small servers

3. JSON Storage: Better performance for medium servers

4. File Management: Efficient file operations and organization

Installation

Basic Installation

1. Download CocoVaults-Lite plugin

2. Place the .jar file in your server's plugins/ folder

3. Restart the server

4. Configure the generated config.yml file

5. Set up permissions as needed

6. Use /cv reload to apply changes

Migration from Other Plugins

1. Install CocoVaults-Lite

2. Use the import command: /cv convert playervaultsx

3. Verify data migration was successful

4. Remove the old vault plugin

Troubleshooting

Common Issues

Vaults not loading

• Check storage configuration

• Verify file permissions

• Check server logs for error messages

• Ensure proper permissions are set

Permission issues

• Verify permission nodes are correctly set

• Check vault quantity permissions

• Ensure players have basic access permissions

• Test with admin permissions first

Performance issues

• Consider switching to JSON storage if using YAML

• Review server resources

• Check file I/O performance

Debug Information

• Plugin logs important events to console

• Configuration validation on startup

• File access monitoring

Support

For support, bug reports, or feature requests:

• Discord: https://fruitforge.com/discord

---

Lite plugin developed by FruitForge Studio