Kazikazan

A polished scratch-ticket experience for Paper servers

Reveal tiles, match three symbols in a row, and collect rewards automatically. Players can buy tickets with their server economy or receive them from an admin.

✨ Features

Interactive scratch GUI — reveal covered tiles by clicking them.
Three ticket tiers — bronze, silver, and gold, each with configurable prices and reward odds.
Automatic rewards — match three symbols in a row to receive the ticket's preselected reward.
Daily free ticket — optionally grant each player one configurable ticket per day when they join.
Win animation — configurable title, sound, and particle celebration when a player wins.
Custom ticket item — use /kazikazan setitem to set the appearance of newly issued tickets.
Economy support — connects to Worthify's economy hook or a Vault economy provider.
Reward options — coins, golden apples, enchanted golden apples, and ExcellentCrates keys.
English and Turkish UI — select the language in config.yml.
Discord webhook embeds — optional purchase, win, and loss notifications.

📥 Installation

Install Java 21 and a Paper 1.21.x server.
Place Kazikazan-1.0.0.jar in the server's plugins folder.
Install and configure Worthify or Vault with an economy provider for ticket purchases and coin rewards. Install ExcellentCrates if you use crate-key rewards.
Start the server, edit plugins/Kazikazan/config.yml, then run /kazikazan reload or restart.

🌐 Language

Set settings.language in plugins/Kazikazan/config.yml:

settings:
  language: en # en = English, tr = Turkish

Run /kazikazan reload after changing the setting. The plugin ships with Turkish as the default.

🎮 Commands

Command	Description	Permission
`/kazikazan`	View ticket types and rewards	Everyone
`/kazikazan market`	Open the ticket shop	Everyone
`/kazikazan daily`	Open the daily reward chest menu and claim today's ticket	Everyone
`/kazikazan help` or `/kazikazan h`	Show commands available to you	Everyone
`/kazikazan give <player> <amount> [type]`	Give scratch tickets	`admin`
`/kazikazan setitem`	Set the ticket appearance from your main hand	`admin`
`/kazikazan reload`	Reload the configuration	`admin`

Example: /kazikazan give Alex 2 altin

⚙️ Ticket configuration

Ticket types and prices live under scratch.types. Each reward has a weight that controls its relative chance within that ticket type. Reward results are selected when a ticket is created, so changing the odds affects newly issued tickets.

scratch:
  types:
    altin:
      name: '&6Gold Scratch Ticket'
      price: 200
      rewards:
        small_prize:
          name: '&aSmall prize'
          weight: 30
          coins: 125

Set your crate key ID under the relevant reward's excellentcrates-key value. You can configure the ExcellentCrates command root with excellentcrates.key-give-command.

Daily ticket and reward animation

Both features can be enabled or disabled in plugins/Kazikazan/config.yml:

scratch:
  daily-free-ticket:
    enabled: true
    type: bronz # Must match a key under scratch.types
    message: '&dYou received your daily free scratch ticket!'
    gui:
      title: '&8✦ &dDaily Rewards'
      size: 27
      background-material: PURPLE_STAINED_GLASS_PANE
      active-material: CHEST
      claimed-material: LIME_STAINED_GLASS_PANE
      locked-material: BLACK_CONCRETE
      reward-slots: [10, 11, 12, 13, 14, 15, 16]
  reward-animation:
    enabled: true
    title: '&d&lYOU WON!'
    subtitle: '&fYour reward is on its way...'
    big-win-title: '&d&lBIG WIN!'
    big-win-subtitle: '&fYour prize is arriving now!'
    duration-ticks: 40
    result-title: '&d&lYOUR PRIZE!'
    result-display-seconds: 5 # 5 to 8 seconds

Use /kazikazan daily to open the seven-day chest menu. Click the active chest to claim the configured ticket; claimed days turn green, the next chest is shown for tomorrow, and later days stay locked. Each player can claim once per calendar day. A full inventory prevents the claim, so the day is not marked complete until the ticket is successfully added. The win animation uses two title stages, sounds, and particles; the prize title remains visible for 5–8 seconds. Run /kazikazan reload after editing the settings.

🔔 Discord notifications

Set webhook.enabled: true and provide the Discord webhook URL in webhook.url. Purchase, reward, and loss events can be enabled independently. Titles, field labels, colors, and embed text are customizable in the config.

🧱 Compatibility

Minecraft all 1.21.x versions (compiled against the original Paper 1.21 API)
Paper (Spigot-based servers may also work, but Paper is recommended)
Java 21
Optional: Worthify or Vault economy provider
Optional: ExcellentCrates for crate-key prizes

📝 Latest update

Added an optional daily free ticket with configurable ticket type.
Added a configurable win animation with title, sound, and particles.
Removed the scoreboard feature and command.
Slowed down the win sequence and kept the prize title visible for up to 3 seconds.
Added both features to the Turkish and English configuration workflow.

Made By: BaranNp | Alpha_122

Scratchcard

Compatibility

Minecraft: Java Edition

Platforms

Tags

Creators

Details