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

Requirement	Details
Minecraft	Spigot, Paper, or Purpur 1.21.x
Java	Java 21 or newer
Economy	Vault + an economy plugin for money jackpot rooms
PlaceholderAPI	Optional
Database	SQLite by default, MySQL/MariaDB supported

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

Command	Permission	Description
/ucjackpot	ucjackpot.use	Show command help
/ucjackpot rooms	ucjackpot.use	Open the room selector
/ucjackpot open [room]	ucjackpot.use	Open the main GUI for a room
/ucjackpot join [room] [amount]	ucjackpot.join.money	Enter with money
/ucjackpot item [room]	ucjackpot.join.item	Enter with the held item
/ucjackpot ticket [room]	ucjackpot.join.ticket	Enter with a valid ticket
/ucjackpot stats	ucjackpot.stats	Open personal statistics
/ucjackpot top	ucjackpot.top	Show leaderboard
/ucjackpot history	ucjackpot.history	Show recent winners
/ucjackpot mailbox	ucjackpot.mailbox	Claim queued item rewards
/ucjackpot title	ucjackpot.use	Toggle personal draw title notifications
/ucjackpot season [top] [season]	ucjackpot.season	Show season leaderboard

Admin Commands

Command	Permission	Description
/ucjackpot reload	ucjackpot.reload	Reload config, language, GUI, rooms, and aliases
/ucjackpot start [room]	ucjackpot.start	Start a room
/ucjackpot stop [room]	ucjackpot.stop	Stop a room
/ucjackpot cancel [room]	ucjackpot.cancel	Cancel a room and refund active deposits
/ucjackpot draw [room]	ucjackpot.draw	Force a draw
/ucjackpot ticket give <player> <amount> [room]	ucjackpot.ticket.give	Give jackpot tickets
/ucjackpot season reward [season] [limit]	ucjackpot.season.reward	Run season reward commands
/ucjackpot selftest	ucjackpot.selftest	Validate runtime state

ucjackpot.admin grants access to admin commands.

Extra Permissions

Permission	Description
ucjackpot.notify	Receive admin notifications
ucjackpot.bypass.cooldown	Bypass entry cooldown
ucjackpot.bypass.limit	Bypass entry limit

---

PlaceholderAPI

Identifier:

ucjackpot

Placeholder	Description
%ucjackpot_pot%	Total value of the primary jackpot
%ucjackpot_pot_value%	Same as total jackpot value
%ucjackpot_money_pot%	Money pool of the primary jackpot
%ucjackpot_item_pot%	Item value of the primary jackpot
%ucjackpot_entries%	Total entry count
%ucjackpot_players%	Participant count
%ucjackpot_time_left%	Remaining time
%ucjackpot_status%	Primary room status
%ucjackpot_player_entries%	Current player's entry count
%ucjackpot_player_chance%	Current player's winning chance
%ucjackpot_last_winner%	Last winner placeholder

These placeholders currently read from the primary room.

---

License

ucJackpot is free and open source under the MIT License.