Skip to main content

GUI Editor

CocoVouchers features a powerful in-game GUI editor for creating and modifying vouchers without editing files manually.

Opening the Editor​

/voucher edit <voucher_name>

Permission: cocovouchers.edit

Editor Overview​

The main editor screen provides access to all voucher settings:

ButtonFunction
📝 Voucher NameRename the voucher
🎯 Click BehaviorChange click type (Right/Left/Shift)
⏱️ CooldownSet redemption cooldown
✅ ConfirmationToggle double-click confirmation
💬 MessagesEdit success/failure messages
📋 RequirementsManage usage requirements
📖 Action CategoriesConfigure all action types
🎲 Chance GroupsSet up chance-based rewards
🎰 Random GroupsConfigure weighted random rewards
⚒️ CraftingSet up crafting recipe

Voucher Name​

Click to rename the voucher:

  • 3-32 characters
  • Letters, numbers, dashes, underscores only
  • Must be unique

Click Behavior​

Cycle through available click types:

  • Right Click - Default
  • Left Click
  • Shift + Right Click
  • Shift + Left Click

Cooldown​

Set the cooldown in seconds:

  • Enter 0 to disable cooldown
  • Cooldown persists across restarts (database)
  • Players with cocovouchers.cooldown.bypass skip cooldowns

Confirmation​

Toggle and configure confirmation:

  • Left-Click: Enable/Disable confirmation
  • Right-Click: Set timeout duration

When enabled, players must click twice to use the voucher.

Messages​

Edit voucher-specific messages:

  • Left-Click: Edit success message
  • Right-Click: Edit failure message

These override the default messages from locale file.

Requirements Menu​

Manage all voucher requirements:

Adding Requirements​

  1. Click Add Requirement
  2. Select requirement type:
    • Permission
    • World
    • Gamemode
    • Placeholder
    • Item
  3. Enter the value in chat

Editing Requirements​

  • Left-Click: Edit the value
  • Right-Click: Toggle inverse (!)
  • Shift + Left-Click: Remove

Clearing All​

Hold Shift + Left-Click on clear button to remove all requirements.

Actions Menu​

The actions menu shows all action categories:

CategoryDescription
Regular ActionsAlways execute
Chance GroupsPercentage-based
Random GroupsWeighted random

Managing Actions​

Click any category to open its action list:

  • Left-Click action: Edit value
  • Right-Click action: Remove
  • Add button: Add new action

Action Types​

When adding actions, select the type:

  • MESSAGE
  • CONSOLE
  • PLAYER
  • SOUND
  • BROADCAST
  • EFFECT
  • ACTIONBAR
  • TITLE
  • BOSSBAR

Chance Groups​

Manage percentage-based reward groups:

Adding Groups​

  1. Click Add Chance Group
  2. A new group with 50% chance is created
  3. Click to edit chance percentage

Editing Groups​

  • Left-Click: Edit chance (0-100%)
  • Right-Click: Open actions for this group
  • Shift + Left-Click: Delete group

Actions in Groups​

Each chance group has its own action list. Click the group to manage its actions.

Random Groups​

Configure weighted random selections:

Adding Groups​

  1. Click Add Random Group
  2. Set how many actions to pick
  3. Add weighted actions

Weight Syntax​

When adding actions, prefix with weight:

{50} CONSOLE give %player% diamond 1

Editing Groups​

  • Left-Click: Edit pick amount
  • Right-Click: Manage actions
  • Shift + Left-Click: Delete group

Crafting Menu​

Configure custom crafting recipes:

Enable/Disable​

Toggle button to enable crafting for this voucher.

Output Amount​

Set how many vouchers the recipe produces (1-64).

Permission​

Set optional permission to craft:

  • Enter permission node
  • Type none to clear

Shape​

Edit the 3x3 crafting grid:

  1. Click row to edit
  2. Enter 3 characters (letters or spaces)
  3. Each letter maps to an ingredient

Ingredients​

Map letters to materials:

  1. Click existing ingredient to change material
  2. Click Add to add new mapping
  3. Shift + Left-Click to remove

Tips​

Quick Editing​

Use the GUI for quick changes, then fine-tune in the YAML file for complex configurations.

Live Preview​

Changes save automatically. Test your voucher immediately with:

/voucher give <your_name> <voucher> 1

Backup​

Before major changes, duplicate your voucher:

/voucher duplicate myvoucher myvoucher_backup

Chat Input​

When prompted for input:

  • Type your value in chat
  • Type cancel to cancel
  • Input times out after 60 seconds

Color codes and hex colors are supported:

&6&lGolden Voucher
&#FF6B35Custom Hex Color