Getting Started

CocoLottery is a feature-rich lottery plugin that allows you to run automated lottery draws with customizable prizes, GUI interface, and Discord webhook integration!

Features

• 🎟️ Ticket System - Players buy tickets to enter the lottery
• 💰 Customizable Prizes - Configure ticket price and prize amounts
• 🖥️ GUI Interface - Beautiful lottery GUI for easy interaction
• ⏰ Automatic Draws - Scheduled lottery draws
• 📊 Statistics - Track tickets, winners, and prizes
• 🔔 Discord Webhooks - Send lottery events to Discord
• 🔌 PlaceholderAPI - Full placeholder support
• 💵 Economy Support - Vault integration or custom currency

Installation

1. Download CocoLottery from SpigotMC
2. Place the .jar file in your plugins folder
3. Restart your server
4. Configure the plugin in plugins/CocoLottery/config.yml

Quick Setup

1. Configure Currency

plugins/CocoLottery/config.yml

currency:
  name: "Dollar"
  symbol: "$"
  allowDecimals: false
  placeholder: "%vault_eco_balance%"
  give_command: "eco give {player} {amount}"
  take_command: "eco take {player} {amount}"

2. Set Lottery Parameters

plugins/CocoLottery/config.yml

lottery:
  ticketPrice: 50000.0      # Price per ticket
  prize: 20000.0            # Base prize amount
  maxTicketsPerPlayer: 3    # Max tickets per player
  minTicketsToDraw: 15      # Minimum tickets needed for draw
  drawingDelaySeconds: 7200 # Time between draws (2 hours)

3. Open the Lottery GUI

/lottery

Or buy tickets directly:

/lottery buy <amount>

Commands Overview

Command	Description
/lottery	Open the lottery GUI
/lottery buy <amount>	Buy lottery tickets
/lottery status	View lottery status
/lottery help	Show help message

Requirements

• Spigot/Paper 1.16.5+
• Java 17+
• Vault (for economy)
• Optional: PlaceholderAPI for placeholders