Skip to main content

Getting Started

CocoVouchers is a powerful and flexible voucher/coupon system for Minecraft servers. Create customizable vouchers with actions, requirements, chance rewards, and even custom crafting recipes!

Features​

  • 🎫 Flexible Vouchers - Create unlimited custom vouchers with unique rewards
  • 🎮 GUI Editor - Full in-game GUI editor for creating and modifying vouchers
  • ⚡ Multiple Action Types - Messages, commands, sounds, effects, and more
  • 🎲 Chance Actions - Actions with configurable percentage chances
  • 🎰 Random Actions - Weighted random reward selection
  • ✅ Requirements - Permission, world, gamemode, placeholder, and item checks
  • ⏱️ Cooldowns - Per-voucher cooldown system with database storage
  • 🔧 Crafting Recipes - Create custom crafting recipes for vouchers
  • 💾 Database Support - SQLite and MySQL for cooldown data
  • 🔄 CrazyVouchers Converter - Import vouchers from CrazyVouchers
  • 📦 Multi-Platform - Bukkit/Spigot, Paper, Folia support

Requirements​

  • Java 17 or higher
  • Bukkit/Spigot/Paper 1.18+
  • Optional: PlaceholderAPI for placeholder requirements
  • Optional: HeadDatabase for custom heads

Installation​

  1. Download the latest CocoVouchers.jar
  2. Place it in your plugins folder
  3. Start/restart your server
  4. Configure in plugins/CocoVouchers/config.yml
  5. Create vouchers with /voucher create <name> or edit vouchers/ folder

Quick Start​

Create Your First Voucher​

/voucher create myfirstvoucher

This creates a new voucher file at plugins/CocoVouchers/vouchers/myfirstvoucher.yml.

Edit with GUI​

/voucher edit myfirstvoucher

Opens the in-game GUI editor to customize your voucher.

Give to Players​

/voucher give Steve myfirstvoucher 1

Gives 1 voucher to player Steve.

Browse All Vouchers​

/voucher open

Opens a GUI browser showing all available vouchers.

Folder Structure​

plugins/CocoVouchers/
├── config.yml              # Main configuration
├── guis/                   # GUI configuration files
│   ├── editor-menu.yml
│   ├── actions-menu.yml
│   └── ...
├── locale/                 # Language files
│   └── messages_en.yml
└── vouchers/               # Voucher definitions
    └── template.yml

How Vouchers Work​

  1. Player Right-Clicks - Player uses the voucher item
  2. Requirements Check - Plugin verifies all requirements are met
  3. Confirmation - Optional double-click confirmation
  4. Cooldown Check - Ensures cooldown has passed
  5. Actions Execute - All configured actions run
  6. Chance Actions - Random chance-based rewards
  7. Random Actions - Weighted random selection
  8. Item Consumed - Voucher item is removed

Support​

Need help? Join our Discord server for support!