ucJackpot

ucJackpot

ucJackpot is a free, open-source jackpot plugin for Minecraft servers. It brings money jackpots, real item jackpots, ticket entries, multiple room types, animated draw screens, detailed history, mailbox rewards, and multilingual GUI support into one clean plugin.

Items deposited into a jackpot stay as real items. They are not converted into money. When a player wins, they receive the actual item pool. If their inventory is full, rewards are safely moved into the mailbox so nothing is lost.

Preview

Main Menu

Rooms Menu

Money Deposit

Item Selection

Deposits Viewer

Winner Watch Animation

History and Fairness

Features

• Money, item, hybrid, ticket, low-risk, high-risk, and event jackpot rooms
• Real item jackpot rewards instead of item-to-money conversion
• Configurable room files under jackpots/*.yml
• GUI-driven player flow for joining, depositing, watching, reclaiming, and viewing history
• Money deposit shortcuts and manual amount entry
• Multi-stack item selection with configurable item limits
• Reclaim GUI for deposits before the round countdown starts
• Mailbox protection for full inventories and offline item delivery
• Participant-only 10-second draw title animation
• Player toggle for personal draw title notifications
• Chance update notifications through action bar, chat, or disabled mode
• Watch GUI that follows the active draw animation for the selected room
• Draw history with draw id, seed, hash, entry id, deposits, and winner data
• Audit logs for player deposits, claims, cancels, rewards, and draw activity
• Persistent favorite money amount
• PlaceholderAPI support
• Vault economy support
• bStats metrics support
• SQLite by default, with MySQL/MariaDB support
• Dynamic command aliases from config.yml
• Help output adapts to the command alias the player used
• Java 21 build target, compatible with Java 21+ runtimes

Requirements

Vault is only required if you use money-based jackpot rooms. Item-only rooms can work without an economy provider.

Metrics collection

ucJackpot collects anonymous server statistics through bStats, an open-source statistics service for Minecraft software. No player names, player UUIDs, chat messages, economy balances, jackpot deposits, or inventory contents are sent to bStats.

Server owners can opt out globally in:

plugins/bStats/config.yml

or disable ucJackpot metrics in:

plugins/ucJackpot/config.yml

metrics:
  enabled: false

Installation

1. Download ucJackpot-1.0.0.jar.
2. Put the jar into your server plugins/ folder.
3. Start the server once.
4. Edit plugins/ucJackpot/config.yml.
5. Edit jackpot rooms under plugins/ucJackpot/jackpots/.
6. Run /ucjackpot reload.

Default player commands:

• /ucjackpot
• /jackpot
• /jp
• /ucj

Command aliases can be changed in config.yml.

Jackpot Rooms

Rooms are configured with separate files under:

plugins/ucJackpot/jackpots/

Each room can define its own:

• Display name and GUI position
• Entry mode
• Minimum and maximum money amount
• Minimum and maximum selected item stacks
• Ticket behavior
• Countdown timing
• Season id
• Risk and reward style
• Item allowlist or blocklist rules

This makes it possible to run several jackpot styles at the same time, such as a general room, high roller room, item room, ticket room, and event room.

GUI and Language Files

GUI text and chat feedback are separated.

lang/<locale>.yml
gui/<locale>/<menu>.yml

lang files contain chat, action bar, and command feedback.

gui files contain menu titles, item names, lore, slots, materials, filler items, and GUI sounds.

Default language is English. Supported languages:

• English (English)
• Turkish (Türkçe)
• German (Deutsch)
• French (Français)
• Spanish (Español)
• Portuguese (Português)
• Russian (Русский)
• Arabic (العربية)
• Chinese (中文)
• Japanese (日本語)
• Korean (한국어)

Only the configured locale and fallback locale are extracted on startup. If the language is changed in config.yml, running /ucjackpot reload loads the selected language files automatically.

Safety and Fairness

ucJackpot is designed to protect real player items and keep jackpot results traceable.

• Deposited items are matched using real item data
• Durability, metadata, enchantments, and custom tags are preserved
• Invalid or blocked items are rejected before deposit confirmation
• Rewards are delivered after the draw animation finishes
• Overflow item rewards go to the mailbox
• Draw records include seed, hash, draw id, and entry id data
• History menus show who deposited money, items, or tickets into a draw
• Player UUIDs and important actions are written to audit logs

Commands and Permissions

The primary command is /ucjackpot.

Default aliases from config.yml:

• /jackpot
• /jp
• /ucj

Help output uses the label the player typed. For example, /jp shows /jp rooms, while /jackpot shows /jackpot rooms.

Player Commands

Admin Commands

ucjackpot.admin grants access to admin commands.

Extra Permissions

PlaceholderAPI

Identifier:

ucjackpot

These placeholders currently read from the primary room.

License

ucJackpot is free and open source under the MIT License.