Venice’s Guile is a mythic-tier relic plugin for Paper servers, designed to introduce a one-of-a-kind weapon forged through rare materials and divine deception. Once crafted, this enchanted Netherite Pickaxe becomes a loot-generating blade of chaos, rewarding players with randomized treasures upon every kill.
🔮 Features:
Custom Crafting Recipe Crafted with Enchanted Golden Apples, Netherite Ingots, Dragon Heads, Emerald Blocks, and Diamond Blocks in a unique 3×3 pattern.
One-Time Crafting Restriction Only one Venice’s Guile can be forged per server. Attempts to duplicate are blocked with a dramatic warning.
Legendary Weapon Attributes
High levels of Fortune AND Looting
Sharpness 15 to weaponize it
Sweeping Edge 10 (for absolutly no reason)
Instamine
Unbreakable
Custom model data and lore
Kill-Triggered Loot Drops
Mob kills drop randomized items from a curated loot pool (diamonds, ancient debris, slime balls, etc.)
Player kills trigger high-tier loot explosions (golden apples, enchanted golden apples, diamonds, netherite, emeralds, XP items, and more)
Command Support /venicesguile (OP only) grants the relic manually for testing or storytelling purposes.
🧠 Lore:
“Forged in deception, rewarded in blood. Each kill whispers wealth into your hands.”
Venice’s Guile is more than a weapon — it’s a symbol of dominance, mystery, and greed. Once it’s in play, the server changes.
Vending Block: Restocked
A modern revival of the classic Vending Block mod, bringing back simple player-to-player trading from Minecraft’s early days. Set up vendors that allow players to trade with each other even when offline, staying faithful to AUTOMATIC_MAIDEN’s (aka minecreatr) original 1.6.4 mod while adding modernized quality-of-life features.
—
### **Features**
* **Simple Player Trading**: Set up a vendor and start trading! No need to meet up to trade.
* **Offline Trading**: Players can use your vendors whenever the world is online, even if you’re not.
* **Transaction Info**: Looking at a vendor shows you what’s for sale.
* **Endless Customization**: Change the texture of the vendor’s base directly in the GUI.
* **Notifications**: Vendors will notify you of transactions and issues (toggleable).
* **Animations**: Choose from different display animations for the item showcase.
* **Display Block**: A new block dedicated to showing off your items!
### **Admin Features**
* **Server-Wide Animation**: Set the default display animation for all players on your server. (Players can override this setting in their client config if desired.)
* **Blacklisting**: Prevent the sale of specific items and restrict certain facade blocks through the server config.
* **Server Admin Screen**: Access special vendor management tools using the Vendor’s Key:
* **_Owner Changing_**: Reassign vendor ownership (useful when players change usernames or for creating server-run shops).
* **_Infinite Inventory_**: Enable unlimited stock for any vendor.
* **_Payment Discarding_**: Automatically void incoming payment items instead of storing them.
* **Remove Key from Creative**: Hide the Vendor’s Key from the Creative menu to prevent unauthorized access.
### **Compatibility**
* **REI/JEI/EMI**: Drag and drop from the item list to set prices and facades.
* **Jade**: Transaction information displays through Jade’s overlay system.
* **Shaders**: Fully compatible. Tested with _Photon_.
* **Resource Packs**: Vendor facades pull textures directly from active resource packs. Tested with _Bare Bones_ and _Bare Metals_.
* **Every Mod**: Use blocks from any mod as vendor facades. Tested with _Biomes O’ Plenty_.
### **Issue Tracker**
This is my first mod! Bugs are to be expected, but I tested as much as I could think of. If you encounter any issues, please report them on the GitHub Issues page.
—
No AI was used in the creation of this mod.
VelKoth
# VelKoth
A modern, high-performance **King of the Hill (KoTH)** plugin built for PaperMC 1.21+ utilizing Java 21 features.
VelKoth supports multiple capture modes (`CAPTURE` and `SCORE`), O(1) mathematical region boundary checks for supreme performance, an automated integrated scheduler, and a robust configurable database-backed reward and statistics system.
## 🚀 Features
– **Modern Architecture**: Compiled against Paper 1.21+ using Java 21, **Folia-supported Regional/Entity Schedulers**, and the Incendo Cloud V2 native Brigadier command framework.
– **Multiple Capture Modes**:
– `CAPTURE`: Traditional KoTH where one player must hold the hill uninterrupted for the duration.
– `SCORE`: Point-based KoTH where players accumulate capture seconds until they reach the target score.
– **High Performance Regions**: Both Cuboid and Cylinder regions utilise O(1) containment algorithms removing loop-based block checks for zero server TPS impact.
– **Team Plugin Integrations**: Fully supports team and faction capturing! Players in the same team, faction, or party can capture hills together without contesting. Supports 12+ plugins natively.
– **Advanced Display Visuals**: Leverages modern Paper Adventure API to push ActionBars, custom BossBars, on-screen Titles, Particle effects, and Sounds. Includes **FastBoard-powered Scoreboards** (with smart-overrides for plugins like TAB and SimpleScore) and native **Paper TextDisplay Holograms** that are fully chunk-safe.
– **Robust Storage System**: Fully asynchronous SQLite/MySQL HikariCP connection pooling storing player total wins, daily wins, and weekly wins.
– **bStats Metrics Integration**: Uses anonymous metrics tracking to keep developers informed on adoption rates and usage.
– **Scheduler Integration**: Define exactly when specific arenas should run via Cron-like syntax or simple time formats. Now supports **Dynamic Scheduling** via in-game commands.
– **Dynamic Configuration**: Built on Okaeri Configs for instant YAML hot-reloading. Every system message, GUI layout, and internal setting can be modified.
– **Comprehensive Rewards**: Execute commands, distribute ItemStacks (with overflow drop handling), or give Vault Economy money to the winners.
– **Enhanced PlaceholderAPI**: Comprehensive support for multi-arena events, absolute/specific next event countdowns, and human-readable time formatting.
– **Developer API**: Features a full suite of Bukkit Events (`KothStartEvent`, `KothWinEvent`, `KothCaptureStartEvent`, etc.) and a static `VelKothAPI` state accessor for developers.
1. Grab the KoTH Wand by typing `/koth wand`.
2. Left-Click one corner of your hill, and Right-Click the opposite corner.
3. Type `/koth create ` to save the region.
4. Modify specific rules, timers, and rewards for this arena in the generated `plugins/VelKoth/arenas.yml` configuration!
### Administering Events
– Start an event manually: `/koth start `
– Pause an ongoing event (maintaining times/scores): `/koth pause `
– Stop an event completely: `/koth stop `
– Configure automatic daily/weekly events in `plugins/VelKoth/config.yml`.
—
## 🪧 Commands
VelKoth features a robust, auto-completing Brigadier command hierarchy.
| Command | Permission | Description |
| :— | :— | :— |
| `/koth help` | `velkoth.use` | View available commands |
| `/koth stats` | `velkoth.use` | View your personal KoTH wins (Daily/Weekly/All-time) |
| `/koth next ` | `velkoth.use` | See when is the next Koth gonna start |
| `/koth list` | `velkoth.admin` | View all arenas and their current status |
| `/koth wand` | `velkoth.admin` | Receive the region selection wand |
| `/koth create ` | `velkoth.admin` | Create a new arena from your wand selection |
| `/koth delete ` | `velkoth.admin` | Permanently delete an arena |
| `/koth start ` | `velkoth.admin` | Force start an arena immediately |
| `/koth pause ` | `velkoth.admin` | Pause an active capture session |
| `/koth resume ` | `velkoth.admin` | Resume a paused capture session |
| `/koth stop ` | `velkoth.admin` | Stop an active arena prematurely |
| `/koth schedule add
—
## 🎁 Rewards
VelKoth supports a powerful reward system that can be managed entirely in-game or via `arenas.yml`. Rewards are granted to the winning player (or all online members of a team/faction if team hooks are active).
### Reward Placeholders
* `%player%`: Name of the winner.
* `%arena%`: ID of the arena.
### Viewing Rewards
You can see exactly what rewards are configured for an arena using:
` /koth reward list `
This will display a numbered list of rewards with human-readable descriptions (e.g., *Command: give diamond 1*).
—
## 📜 Permissions
– **`velkoth.use`**: Default permission granted to all players allowing them to view help and check their personal statistics.
– **`velkoth.admin`**: Default OP permission granting full administrative access to edit arenas, bypass timers, and trigger events.
—
## 📦 Building from Source
To compile the standalone shadow JAR natively (including the Cloud command libraries and Okaeri configs):
“`bash
git clone https://github.com/YourName/VelKoth.git
cd VelKoth
./gradlew clean shadowJar
“`
Your compiled plugin will be deposited in `/build/libs/`.
VeinMainer
**[⚠️]NOTE!** If u have aby issue with the plugin please report to in our discord!
**🔨 VeinMiner Plugin**
**📖 Description:**
VeinMiner is a Minecraft plugin for Paper 1.21+ that adds a new enchantment called Vein Miner. This enchantment allows you to automatically mine entire ore veins with a single hit!
How does it work?
When you mine an ore block with a pickaxe enchanted with Vein Miner (while holding Shift), the plugin automatically finds and mines all connected blocks of the same ore type within a radius of up to 64 blocks.
**✨ Features**
– ⛏️ Automatic vein mining – mine entire veins with one click
– 🎯 Works only on ores – safe for other blocks
– 📚 Custom enchantment – added via datapack
– 🔧 Tool durability – pickaxe loses durability for each mined block
– ⚡ Requires Shift – control when you use the enchantment
**🎮 How to Use**
– Step 1: Get the enchanted book
/veinminer
You will receive an enchanted book with Vein Miner I
– Step 2: Apply enchantment to pickaxe
Open an anvil
Place your pickaxe in the first slot
Place the enchanted book in the second slot
Take the enchanted pickaxe
– Step 3: Mining veins
Hold the enchanted pickaxe in your hand
Hold Shift (sneak)
Mine an ore block
💥 The entire vein will be mined!
**⛏️ Supported Ores**
The plugin works on all ore types:
**Overworld:**
– Download VeinMiner-2.0.jar
– Place it in the plugins/ folder
– Start the server
– The plugin will automatically create a datapack in world/datapacks/veinminer/
– Restart the server or use /reload confirm
**Verify Installation:**
– /datapack list
– You should see [file/veinminer] in the list
**🎯 Commands**
– CommandDescriptionPermission/veinminerGives an enchanted book with Vein Minerveinminer.use
**🔐 Permissions**
– PermissionDescriptionDefaultveinminer.useAllows use of /veinminer commandOP
**⚙️ Mechanics**
**Vein Mining:**
– The plugin searches for all adjacent blocks of the same ore type
– Maximum 64 blocks at once
– Checks only 6 directions (up, down, left, right, front, back)
**Tool Durability:**
– The pickaxe loses 1 durability for each mined block
– If the pickaxe breaks, it disappears from your hand
– You hear the item breaking sound
**Activation Conditions:**
– ✅ Player is holding Shift
– ✅ Holding a pickaxe with Vein Miner enchantment
– ✅ Mining block is an ore
### 1. **Database**
Define the database type and connection details. The plugin supports:
– **MongoDB**: Specify a connection string and database name.
– **SQL**: Provide a JDBC connection string. (No username/password is required for SQLite.)
### 2. **Custom Messages**
Customize messages for server startup, player join/quit, and Discord chat using the MiniMessage format.
We currently support: `de` and `en`
### 3. **Commands**
`/money` – Shows your balance
`/money top` – Shows the TOP 10 Money.
`/money pay (player) (amount)` – Paying Player Money.
`/moneyadmin add (player) (amount)` – Giving the Player Money Balance.
`/moneyadmin remove (player) (amount)` – Removing the Player Money Balance.
`/moneyadmin set (player) (amount)` – Sets the Balance on the Amount.
`/moneyadmin reset (player)` – Resets fully the Money Balance from the Player.
`/moneyadmin transactions (player)` – Shows the player’s transactions
### 4. **Permissions**
`vbank.moneyadmin` | Fully configurable in the Config.yml.
– Permission to use the `/moneyadmin` Command.
—
## Setup Instructions
1. Download and install the plugin on your Minecraft server.
2. Configure the `config.yml` file with your preferred settings:
– Set the database type and connection details.
– Define custom messages using MiniMessage.
3. Restart the server to apply the changes.
—
## Example config
“`yaml
language: en
start_balance: 1000
“`
—
## Example Message Configuration
“`yaml
# Using Minimessage https://docs.advntr.dev/minimessage/format.html
# General Messages
currency_name: “coins”
currency_name_plural: “coins”
currency_name_singular: “coin”
prefix: “[VEconomy] ”
user_not_found: “This user doesnt exist”
no_valid_number: “Enter a valid number”
no_permission: “You don’t have Permission to do this!”
date_format: “MM/dd/yyyy – hh:mm a”
add: “Add”
remove: “Remove”
pay: “Pay”
pay_receive: “Pay receive”
admin_add: “Add (Admin)”
admin_remove: “Remove (Admin)”
admin_set: “Set (Admin)”
admin_reset: “Reset (Admin)”
command_money_own_balance: “You have ”
command_money_pay_self: “You cannot send money to yourself”
command_money_pay_not_enough_money: “You don’t have enough money”
command_money_pay_success: “You have sent to the player”
command_money_pay_success_receiver: “The player has sent you ”
command_moneyadmin_reset_success: “The money of has been reset”
command_moneyadmin_add_success: “The player was given”
command_moneyadmin_set_success: “The player was set to”
command_moneyadmin_remove_not_enough_money: “You cannot bet the money negatively”
command_moneyadmin_remove_success: “You have removed from the player”
# SQL
SQL:
connection-string: “jdbc:sqlite:plugins/VEconomy/database.db”
username: “username” # Not required for sqlite
password: “password” # Not required for sqlite
“`
—
—
## Requirements
* VaultAPI
—
## Notes
– The MiniMessage format is highly flexible for styling and formatting messages. Refer to the MiniMessage documentation for more details.
– SQLite is the simplest database option as it doesn’t require additional setup.
VaultPayday
# 💰 VaultPayday
**An SA:MP-inspired payday system that transforms your Minecraft server’s economy**

## 🎯 What is VaultPayday?
VaultPayday brings the beloved **SA:MP payday system** to Minecraft! Instead of instant job payments, players accumulate earnings that are paid out every **60 minutes of playtime**, creating engaging progression and rewarding active participation.
## ⭐ Key Features
– 🕐 **60-Minute Payday Cycles** – Authentic SA:MP-inspired gameplay
– 💼 **JobsReborn Integration** – Seamless payment interception system
– 📊 **Progress Tracking** – Visual progress bars and status updates
– 🚀 **High Performance** – Supports 200-300 concurrent players
– 🔧 **Zero Configuration** – Works perfectly out of the box
– 🌍 **Multi-World Support** – Enable/disable per world
– 📱 **PlaceholderAPI** – 25+ custom placeholders
– 🛡️ **VIP Multipliers** – Permission-based earning bonuses
## 🎮 How It Works
1. **Job Activity**: Players perform jobs through JobsReborn
2. **Payment Interception**: VaultPayday catches payments instead of paying immediately
3. **Balance Accumulation**: Earnings build up in a “pending balance”
4. **Time Tracking**: Plugin tracks individual playtime across sessions
5. **Payday Event**: Every 60 minutes, the full balance is paid out
6. **Cycle Reset**: Process repeats, keeping players engaged
## 📋 Commands
### Player Commands
– `/payday` – Check progress and pending balance
### Admin Commands
– `/vaultpayday reload` – Reload configuration
– `/vaultpayday reset ` – Reset player’s progress
– `/vaultpayday settime ` – Set playtime
– `/vaultpayday info ` – View player details
– `/vaultpayday stats` – Server statistics
**25+ custom placeholders** for scoreboards, holograms, and other plugins:
– `%vaultpayday_time_remaining%` – Minutes until next payday
– `%vaultpayday_pending_balance%` – Current pending balance
– `%vaultpayday_progress_percentage%` – Progress percentage
– `%vaultpayday_progress_bar%` – Visual progress bar
– `%vaultpayday_status%` – Current status
– And 20+ more advanced placeholders!
# World restrictions
advanced:
worlds:
blacklisted_worlds: [‘creative’, ‘lobby’]
“`
## 🚀 Performance
Built for **enterprise-level performance**:
– ✅ **200-300 concurrent players** supported
– ✅ **<1ms command response** time
- ✅ **<50MB memory usage** at capacity
- ✅ **Zero main thread blocking** operations
- ✅ **Asynchronous database** operations
- ✅ **Smart caching** with automatic cleanup
## 🔌 Dependencies
### Required
- **Vault** - Economy API integration
- **JobsReborn** - Job system integration
### Optional
- **PlaceholderAPI** - For custom placeholders
## 📋 Compatibility
| Platform | Version | Status |
|----------|---------|--------|
| **Paper** | 1.20.x - 1.21.x | ✅ Fully Supported |
| **Spigot** | 1.20.x - 1.21.x | ✅ Fully Supported |
| **Purpur** | 1.20.x - 1.21.x | ✅ Compatible |
**Java Version:** 21+ (Recommended)
## 📊 Live Statistics

VaultPayday includes **bStats integration** with:
- 📈 12 custom analytics charts
- 🔒 GDPR compliant & anonymous
- 📊 Performance metrics for optimization
- 📊 Real-time statistics updated automatically
## 🛠️ Installation
1. Download VaultPayday from Modrinth
2. Install **Vault** and **JobsReborn** plugins
3. Place VaultPayday.jar in your `plugins/` folder
4. Restart your server
5. **Done!** Plugin works immediately with defaults
## 🎉 Why Choose VaultPayday?
- **🎯 Authentic SA:MP Experience** - True to the original concept
- **🚀 Enterprise Performance** - Handles hundreds of players
- **🔧 Zero Setup Required** - Works out of the box
- **📚 Complete Documentation** - Detailed guides and examples
- **💬 Active Support** - Community and direct developer support
- **📈 Proven Track Record** - Used by servers worldwide
## 🌟 Community
- **Issues & Bug Reports:** GitHub Issues
- **Feature Requests:** GitHub Discussions
---
**Transform your server's economy and bring SA:MP nostalgia to Minecraft!**
*Made with ❤️ by devupdates*
Vaultless Economy
# 💰 Vaultless Economy
Vaultless Economy is a modern, lightweight economy plugin designed for **Minecraft 1.21+ servers**.
It provides a simple yet powerful economy system **without relying on Vault or outdated APIs**.
All balances are stored persistently and support **both online and offline players**.
—
## ✨ Features
– 💾 **Offline player economy** (UUID-based)
– 🏆 **Leaderboards** for the richest players
– 🌐 **Fully Geyser-safe** (Bedrock compatible)
– 📁 **YAML-based storage**
– 🛠 **Admin economy commands**
– 🎨 **Customizable messages and prefixes**
– ⚡ **Lightweight & easy to configure**

**Display top player balances effortlessly — Vault-powered, Placeholder-ready.**
A lightweight PlaceholderAPI expansion to show top player money rankings using Vault-compatible economy plugins like EssentialsX. Fully customizable format, easy to set up, and works perfectly with leaderboards, scoreboards, and holograms.
—

> **Display** the richest **Players** of your **Server** easily with:
`%vaultleaderboards_top_%`
> **Allow** players to see their **Rank** + **Balance** with:
`%vaultleaderboards_%`
> Make the placeholders pretty with **MiniMessages**
—

> Just replace `` with any valid Minecraft username
—


VaultEconomy
# VaultEconomy
**VaultEconomy** — это многофункциональный серверный плагин для Minecraft, объединяющий в себе экономику, аукцион, телепортацию, чат-модерацию, PvP-контроль, утилиты и административные инструменты в одном решении.
Плагин предназначен для **Survival / Economy / RPG серверов**, где важны стабильность, гибкая настройка и минимальное количество зависимостей.
—
## 📌 Основная информация
– **Название:** VaultEconomy
– **Версия:** 1.0.4 в даной версии обнавили сохранения валют (ранше был баг)
– **Статус:** Beta (стабильное ядро)
– **Платформы:** Bukkit, Spigot, Paper
– **Minecraft:** 1.13+
– **Зависимости:** Vault
– **Интеграция:** Vault Economy API
—
## 🎯 Назначение плагина
VaultEconomy создан как **единый центр управления сервером**, который заменяет десятки отдельных плагинов:
– экономика и кастомные валюты
– аукцион с GUI
– дома, варпы и спавн
– PvP-контроль
– чат и префиксы
– фильтр чата
– утилиты
– модерация и админ-команды
Один JAR-файл — одна система.
—
# 💰 Экономика
## Основная валюта
– Полная поддержка Vault
– Встроенная серверная валюта
– Совместимость с другими плагинами
– Сохранение данных
### Команды
– `/bits`, `/bal`, `/money` — баланс
– `/baltop` — топ по деньгам
—
## 🪙 Кастомные валюты (Points)
VaultEconomy поддерживает **неограниченное количество кастомных валют**.
### Возможности
– Создание валют
– Выдача и изъятие
– Хранение данных
– Не зависит от основной экономики
### Команды
– `/point create <название>`
– `/point give <валюта> <игрок> <количество>`
– `/point take <валюта> <игрок> <количество>`
– `/point remove <валюта>`
—
# 🏷 Аукцион (Auction System)
Полностью серверный GUI-аукцион.
### Возможности
– Продажа предметов через GUI
– Категории товаров
– Ограничение слотов
– Комиссия сервера
– Блокировка в PvP
– Возврат истёкших лотов
– Глобальные уведомления
### Категории
– Все товары
– Оружие
– Инструменты
– Ресурсы
– Мои товары
### Команды
– `/ah` — открыть аукцион
– `/ahelp` — помощь
### Слоты
Количество активных лотов зависит от прав:
# VaultEconomy
**VaultEconomy** — это многофункциональный серверный плагин для Minecraft, объединяющий в себе экономику, аукцион, телепортацию, чат-модерацию, PvP-контроль, утилиты и административные инструменты в одном решении.
Плагин предназначен для **Survival / Economy / RPG серверов**, где важны стабильность, гибкая настройка и минимальное количество зависимостей.
VaultEconomy создан как **единый центр управления сервером**, который заменяет десятки отдельных плагинов:
– экономика и кастомные валюты
– аукцион с GUI
– дома, варпы и спавн
– PvP-контроль
– чат и префиксы
– фильтр чата
– утилиты
– модерация и админ-команды
Один JAR-файл — одна система.
—
# 💰 Экономика
## Основная валюта
– Полная поддержка Vault
– Встроенная серверная валюта
– Совместимость с другими плагинами
– Сохранение данных
### Команды
– `/bits`, `/bal`, `/money` — баланс
– `/baltop` — топ по деньгам
—
## 🪙 Кастомные валюты (Points)
VaultEconomy поддерживает **неограниченное количество кастомных валют**.
### Возможности
– Создание валют
– Выдача и изъятие
– Хранение данных
– Не зависит от основной экономики
### Команды
– `/point create <название>`
– `/point give <валюта> <игрок> <количество>`
– `/point take <валюта> <игрок> <количество>`
– `/point remove <валюта>`
—
# 🏷 Аукцион (Auction System)
Полностью серверный GUI-аукцион.
### Возможности
– Продажа предметов через GUI
– Категории товаров
– Ограничение слотов
– Комиссия сервера
– Блокировка в PvP
– Возврат истёкших лотов
– Глобальные уведомления
### Категории
– Все товары
– Оружие
– Инструменты
– Ресурсы
– Мои товары
### Команды
– `/ah` — открыть аукцион
– `/ahelp` — помощь
### Слоты
Количество активных лотов зависит от прав:
Большинство изменений применяется без рестарта.
# 🔐 Permissions — VaultEconomy
VaultEconomy использует **гибкую систему прав (permissions)**,
которая позволяет точно контролировать доступ игроков, модераторов
и администраторов ко всем функциям плагина.
Плагин полностью совместим с **LuckPerms**, **PermissionsEx** и аналогами.
—
## 👤 Player Permissions (Игрок)
### `vaulteconomy.user`
**Базовое право обычного игрока**
📌 Обычно выдаётся всем игрокам по умолчанию
📌 Включает основные команды выживания
**A feature-rich, fully animated crate plugin for Paper 1.21.x**
No NMS · No legacy libraries · No external hologram plugin required
—
## ✨ Features
– **12 unique animations** — particles, sounds and visual effects for every style
– **Physical & Virtual Keys** — NBT-tagged items with anti-dupe UUID tracking
– **Pity system** — guaranteed drop after N opens per rarity
– **Reward limits** — global and per-player caps per reward
– **Key shop** — players buy keys with in-game money via `/vc shop`
– **Pouches** — right-clickable reward bags with random number ranges
– **Holograms** — floating Text Display entities, no external plugin needed
– **Placement ID system** — each placed crate gets a unique ID (`/vc remove `)
– **In-game GUI editor** — edit crates without touching YAML files
– **Reward preview** — paginated GUI with normalised drop percentages
– **Best Prizes** — guaranteed bonus reward from a separate pool
– **Bundled items** — give multiple items alongside the main reward
– **Selectable rewards** — players pick their prize from N options
– **Milestones** — bonus rewards after X total crate opens
– **Reward footer** — auto-appended lore showing reward type and rarity
– **NPC support** — Citizens, ZNPCs, ZNPCsPlus, FancyNpcs, or any entity
– **Multi-language** — English, German, French, Spanish built-in + custom locale support
– **Multi-database** — JSON (default), SQLite or MySQL
– **Developer API** — events, programmatic crate opening, key management
1. Drop the JAR into `plugins/`
2. Restart the server
3. `/vc getcrate ExampleRound` — get a crate block
4. Place it in the world
5. `/vc key give ExampleRound 1` — give yourself a key
6. Right-click the crate!
—
## 🎬 Animations
| Name | Style |
|—|—|
| `ROUND` | Slot machine — cycles and locks on the winner |
| `ROUND2` | Mystery boxes — BARRIER boxes orbit with lightning reveal |
| `QUICK` | Slot machine — fast version (~3 s) |
| `COSMIC` | Double counter-rotating orbital rings |
| `DISPLAY` | Single item cycles and lands on the winner |
| `PYRAMID` | Three-tiered rotating pyramid |
| `CONTRABAND` | Items float up and vanish one-by-one |
| `INSTANT` | Particle burst, reward given instantly |
| `AIR_STRIKE` | Items fall from height with lightning |
| `BREAKOUT` | Items burst outward and arc back |
| `METEOR_SHOWER` | Items rain down with flame trails |
| `YIN_YANG` | Two rings converge in a yin-yang pattern |
—
## 🌐 Languages
| Code | Language |
|—|—|
| `en` | English (default) |
| `de` | German / Deutsch |
| `fr` | French / Français |
| `es` | Spanish / Español |
Drop a `messages_.yml` in the plugin folder and set `Language: ` to add any language. Regional locale codes (`en_us`, `pt_br`, etc.) are supported with automatic fallback.
---
## 🗄️ Storage
| Type | Notes |
|---|---|
| `JSON` | Default, zero setup |
| `SQLITE` | File-based SQL, bundled driver |
| `MYSQL` | Full MySQL/MariaDB, auto table creation |