ucJackpot
ucJackpot 是一款免费的开源 Minecraft 服务器抽奖插件。它将金钱抽奖、实物奖品抽奖、门票入场、多种房间类型、动态开奖动画、详细历史记录、邮箱奖励以及多语言 GUI 支持整合在一个简洁的插件中。
存入抽奖池的物品保持为真实物品,不会转换为货币。当玩家中奖时,他们将获得实际的物品池。如果背包已满,奖励会自动安全地移至邮箱,确保不会丢失任何内容。
预览
主菜单
房间菜单
存款(金钱)
物品选择
存款查看器
获胜者观看动画
历史与公平性
功能特性
- 支持金钱、实物、混合、门票、低风险、高风险及活动类型的抽奖房间
- 实物奖品奖励,而非将物品转换为货币
- 可配置的房间文件位于
jackpots/*.yml
- 基于 GUI 的玩家流程,支持加入、存款、观看、领取和查看历史记录
- 快捷存款方式和手动输入金额
- 支持多堆叠物品选择,并可配置物品数量限制
- 在轮次倒计时开始前,提供用于取回存款的 GUI
- 针对背包满员的情况提供邮箱保护,并支持离线物品投递
- 仅限参与者的 10 秒开奖标题动画
- 玩家可切换个人开奖标题通知开关
- 通过操作栏、聊天或禁用模式发送概率更新通知
- 跟随所选房间活跃开奖动画的观看 GUI
- 包含开奖 ID、种子、哈希值、入场 ID、存款和中奖者数据的开奖历史记录
- 审计日志记录玩家的存款、领取、取消、奖励及开奖活动
- 持久化保存偏好的固定金额
- 支持 PlaceholderAPI
- 支持 Vault 经济系统
- 支持 bStats 指标统计
- 默认使用 SQLite,支持 MySQL/MariaDB
- 从
config.yml 动态生成命令别名
- 帮助输出会根据玩家使用的命令别名进行自适应显示
- 基于 Java 21 构建,兼容 Java 21+ 运行时环境
要求
| 要求 |
详情 |
| Minecraft |
Spigot、Paper 或 Purpur 1.21.x |
| Java |
Java 21 或更高版本 |
| 经济系统 |
Vault + 一个用于金钱抽奖房间的经济插件 |
| PlaceholderAPI |
可选 |
| 数据库 |
默认 SQLite,支持 MySQL/MariaDB |
仅在使用基于金钱的抽奖房间时才需要 Vault。纯物品房间可以在没有经济提供商的情况下运行。
指标收集
ucJackpot 通过 bStats 收集匿名服务器统计数据,bStats 是一个面向 Minecraft 软件的开源统计服务。发送给 bStats 的数据不包含任何玩家名称、玩家 UUID、聊天消息、经济余额、抽奖存款或背包内容。
服务器管理员可以在以下位置全局退出:
plugins/bStats/config.yml
或在以下位置禁用 ucJackpot 的指标数据:
plugins/ucJackpot/config.yml
metrics:
enabled: false
安装
- 下载
ucJackpot-1.0.0.jar。
- 将 jar 文件放入服务器的
plugins/ 文件夹。
- 启动服务器一次。
- 编辑
plugins/ucJackpot/config.yml。
- 编辑
plugins/ucJackpot/jackpots/ 下的抽奖房间配置。
- 运行
/ucjackpot reload。
默认玩家命令:
/ucjackpot
/jackpot
/jp
/ucj
命令别名可在 config.yml 中更改。
抽奖房间
房间通过以下目录下的单独文件进行配置:
plugins/ucJackpot/jackpots/
每个房间可以定义自己的:
- 显示名称和 GUI 位置
- 入场模式
- 最低和最高金额
- 最低和最高选定物品堆叠数
- 门票行为
- 倒计时时间
- 赛季 ID
- 风险与奖励风格
- 物品白名单或黑名单规则
这使得同时运行多种抽奖风格成为可能,例如通用房间、高注码房间、实物房间、门票房间和活动房间。
GUI 和语言文件
GUI 文本和聊天反馈是分离的。
lang/<locale>.yml
gui/<locale>/<menu>.yml
lang 文件包含聊天、操作栏和命令反馈。
gui 文件包含菜单标题、物品名称、描述、槽位、材质、填充物品和 GUI 音效。
默认语言为英语。支持的语言包括:
- English (English)
- Turkish (Türkçe)
- German (Deutsch)
- French (Français)
- Spanish (Español)
- Portuguese (Português)
- Russian (Русский)
- Arabic (العربية)
- Chinese (中文)
- Japanese (日本語)
- Korean (한국어)
仅在启动时提取已配置的区域设置和回退区域设置。如果在 config.yml 中更改了语言,运行 /ucjackpot reload 会自动加载所选语言的配置文件。
安全与公平
ucJackpot 旨在保护玩家的真实物品,并确保奖池结果的透明度可追溯。
- 存入的物品通过真实的物品数据进行匹配
- 耐久度、元数据、附魔和自定义标签得以保留
- 无效或被阻止的物品在存款确认前会被拒绝
- 奖励会在抽奖动画结束后发放
- 溢出的物品奖励会发送到邮箱
- 抽奖记录包含种子值、哈希值、抽奖 ID 和参与 ID 数据
- 历史记录菜单显示谁向抽奖中存入了金钱、物品或门票
- 玩家 UUID 和重要操作会写入审计日志
命令与权限
主要命令为 /ucjackpot。
来自 config.yml 的默认别名:
帮助输出使用玩家输入的标签。例如,输入 /jp 会显示 /jp rooms,而输入 /jackpot 会显示 /jackpot rooms。
玩家命令
| 命令 |
权限 |
描述 |
/ucjackpot |
ucjackpot.use |
显示命令帮助 |
/ucjackpot rooms |
ucjackpot.use |
打开房间选择器 |
/ucjackpot open [room] |
ucjackpot.use |
打开指定房间的主 GUI |
/ucjackpot join [room] [amount] |
ucjackpot.join.money |
使用金钱参与 |
/ucjackpot item [room] |
ucjackpot.join.item |
使用手持物品参与 |
/ucjackpot ticket [room] |
ucjackpot.join.ticket |
使用有效门票参与 |
/ucjackpot stats |
ucjackpot.stats |
打开个人统计数据 |
/ucjackpot top |
ucjackpot.top |
显示排行榜 |
/ucjackpot history |
ucjackpot.history |
显示最近获奖者 |
/ucjackpot mailbox |
ucjackpot.mailbox |
领取队列中的物品奖励 |
/ucjackpot title |
ucjackpot.use |
切换个人抽奖标题通知 |
/ucjackpot season [top] [season] |
ucjackpot.season |
显示赛季排行榜 |
管理员命令
| 命令 |
权限 |
描述 |
/ucjackpot reload |
ucjackpot.reload |
重载配置、语言、GUI、房间和别名 |
/ucjackpot start [room] |
ucjackpot.start |
启动一个房间 |
/ucjackpot stop [room] |
ucjackpot.stop |
停止一个房间 |
/ucjackpot cancel [room] |
ucjackpot.cancel |
取消一个房间并退款所有活跃存款 |
/ucjackpot draw [room] |
ucjackpot.draw |
强制进行抽奖 |
/ucjackpot ticket give <player> <amount> [room] |
ucjackpot.ticket.give |
给予奖池门票 |
/ucjackpot season reward [season] [limit] |
ucjackpot.season.reward |
执行赛季奖励命令 |
/ucjackpot selftest |
ucjackpot.selftest |
验证运行时状态 |
ucjackpot.admin 授予访问管理员命令的权限。
额外权限
| 权限 |
描述 |
ucjackpot.notify |
接收管理员通知 |
ucjackpot.bypass.cooldown |
绕过参与冷却时间 |
ucjackpot.bypass.limit |
绕过参与限制 |
PlaceholderAPI
标识符:
ucjackpot
| 占位符 |
描述 |
%ucjackpot_pot% |
主奖池的总价值 |
%ucjackpot_pot_value% |
与主奖池总价值相同 |
%ucjackpot_money_pot% |
主奖池的金钱池 |
%ucjackpot_item_pot% |
主奖池的物品价值 |
%ucjackpot_entries% |
总参与次数 |
%ucjackpot_players% |
参与者数量 |
%ucjackpot_time_left% |
剩余时间 |
%ucjackpot_status% |
主房间状态 |
%ucjackpot_player_entries% |
当前玩家的参与次数 |
%ucjackpot_player_chance% |
当前玩家的获胜几率 |
%ucjackpot_last_winner% |
上一位获奖者占位符 |
这些占位符目前从主房间读取数据。
许可证
ucJackpot 基于 MIT 许可证免费开源。
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
- Download
ucJackpot-1.0.0.jar.
- Put the jar into your server
plugins/ folder.
- Start the server once.
- Edit
plugins/ucJackpot/config.yml.
- Edit jackpot rooms under
plugins/ucJackpot/jackpots/.
- 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:
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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧