ucJackpot

插件

· 作者 unecroe

高级开源奖池插件,支持货币、物品、门票、GUI、历史记录、公平性以及多语言

0 本站下载 0 关注 更新于 5 个月前

最新 1.0.0 · 1.21.11 · Bukkit / Folia

一键开服(送7天)

ucJackpot

ucJackpot 是一款免费的开源 Minecraft 服务器抽奖插件。它将金钱抽奖、实物奖品抽奖、门票入场、多种房间类型、动态开奖动画、详细历史记录、邮箱奖励以及多语言 GUI 支持整合在一个简洁的插件中。

存入抽奖池的物品保持为真实物品,不会转换为货币。当玩家中奖时,他们将获得实际的物品池。如果背包已满,奖励会自动安全地移至邮箱,确保不会丢失任何内容。


预览

主菜单

Main Menu

房间菜单

Rooms Menu

存款(金钱)

Money Deposit

物品选择

Item Selection

存款查看器

Deposits Viewer

获胜者观看动画

Winner Watch Animation

历史与公平性

History and Fairness

功能特性

  • 支持金钱、实物、混合、门票、低风险、高风险及活动类型的抽奖房间
  • 实物奖品奖励,而非将物品转换为货币
  • 可配置的房间文件位于 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

安装

  1. 下载 ucJackpot-1.0.0.jar。
  2. 将 jar 文件放入服务器的 plugins/ 文件夹。
  3. 启动服务器一次。
  4. 编辑 plugins/ucJackpot/config.yml。
  5. 编辑 plugins/ucJackpot/jackpots/ 下的抽奖房间配置。
  6. 运行 /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 的默认别名:

  • /jackpot
  • /jp
  • /ucj

帮助输出使用玩家输入的标签。例如,输入 /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 许可证免费开源。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源