Gamble N' Roll

---

Gamble N' Roll

Hytale 的物品赌博模组。 献祭低稀有度物品，有机会获得高稀有度物品，并带有快捷栏滚动动画和自定义音效。

---

工作原理

1. 使用 /gamble 打开赌博界面
2. 选择等级（例如：普通 -> 精良）
3. 选择要献祭的物品——你可以精确选择放入什么
4. 点击“Roll”并观看快捷栏滚动动画揭晓结果
5. 赢了？你将获得一个随机的高一级稀有度物品。输了？你将获得部分低稀有度物品作为补偿。

---

赌博等级

等级	献祭	奖励
第1级	普通物品	1个精良物品
第2级	精良物品	1个稀有物品
第3级	稀有物品	1个史诗物品
第4级	史诗物品	1个传说物品

每个等级都有可配置的胜率（默认：60% / 45% / 30% / 15%）。失败时，献祭物品的一定比例会以低稀有度物品形式返还（默认：50%）。

---

物品选择界面

主赌博页面是一个完整的交互式GUI，你可以在此选择要献祭的物品：

• 每页20个物品，支持分页
• 稀有度闪光——每个物品显示一个按稀有度（普通、精良、稀有、史诗、传说）着色的闪光图标
• 星标收藏——将物品标记为收藏（跨会话持久化），以便它们排在顶部
• 排序模式——按名称、数量、稀有度、最新或收藏排序
• 智能选择——点击物品即可将其选中用于献祭。进度条会随着你的选择而填充。物品可以单独切换。
• 颜色编码反馈——物品会改变颜色以指示状态：当你拥有足够物品进行赌博时为桃色，聚焦的物品为红色，已选中的物品为绿色勾选标记，尚未选择任何物品时为灰色
• 阈值指示器——已达到献祭要求的物品会被高亮显示，方便你快速扫描哪些已准备就绪
• 全选 / 取消全选按钮，用于快速批量选择

---

快捷栏滚动动画

当你进行赌博时，你的快捷栏会暂时被一个老虎机风格的滚动动画取代：

• 物品在你的快捷栏格子上滚动，伴有“嘀嗒”音效
• 速度逐渐减慢以营造悬念
• 最终结果在中央格子揭示
• 获胜时，快捷栏清空，并将你的新物品在中央展示3秒
• 无论输赢，都会播放一个独特的音效
• 可选的“开始赌博！”音效（使用/gamble sfx start切换）
• 动画期间，会阻止物品掉落以防止干扰

---

快速重掷

使用 /gamble prev 可以重复上一次的赌博（使用相同的物品选择）——无需重新选择所有物品。会显示一个包含等级、物品和当前库存的确认页面。或者使用 /gamble prev skip 完全跳过确认。

---

娱乐模式

在不承担任何风险的情况下试试手气。/gamble fun <1-4> 运行完整的动画，但不献祭或奖励任何物品。适合展示或测试使用。

---

玩家个人统计

使用 /gamble stats 追踪你的赌博历史：

• 总赌博次数、获胜次数、失败次数、胜率
• 献祭的物品数量和赢得的物品数量
• 音效切换状态

统计数据跨会话持久化。

---

设置页面

通过赌博界面中的齿轮图标访问：

• 主音量——调节赌博音效音量
• 图例——所有UI指示符（稀有度颜色、选择状态、收藏夹、阈值）的颜色参考
• 鸣谢

---

命令

命令	描述
/gamble	打开赌博界面
/gamble chance	显示获胜概率和你能承受的物品组合
/gamble stats	显示你的输赢记录
/gamble sfx start	切换开始音效
/gamble prev	用之前的物品组合重新赌博（带确认）
/gamble prev skip	用之前的物品组合重新赌博（跳过确认）
/gamble fun <1-4>	娱乐模式赌博（不损失或赢得物品）
/gamble help	显示命令列表

---

服务器配置

所有管理员设置都在 gamble-config.json 文件中，首次运行时会在插件数据文件夹中生成。编辑文件并重启服务器以应用更改。

设置项	默认值	描述
enabled	true	是否启用赌博功能
odds.COMMON_TO_UNCOMMON	60	第1级的获胜百分比
odds.UNCOMMON_TO_RARE	45	第2级的获胜百分比
odds.RARE_TO_EPIC	30	第3级的获胜百分比
odds.EPIC_TO_LEGENDARY	15	第4级的获胜百分比
refundPercent	50	失败时退还的献祭物品百分比

配置文件使用原子保存并带有备份恢复功能——能防止崩溃。

---

音效

为每个动作定制了音效：

• 嘀嗒声——在滚动动画期间每个格子转动时播放
• 获胜声——获胜时的庆祝音效
• 失败声——失败时的音效
• 大奖声——在赢得史诗和传说物品时的特殊音效
• 开始音效——可选的“开始赌博！”录音（由每位玩家切换）

可以通过编辑 Mods/GambleNRoll/Server/Audio/SoundEvents/SFX/GambleNRoll/ 目录下的JSON文件来调整音量。

---

兼容性

• 与 NewItemIndicator 和 ItemCollector 兼容——在赌博动画期间自动排除相关玩家，以防止错误触发
• 使用 Hytale 内置的物品、背包、UI和音频系统
• 所有玩家数据在服务器重启后持续存在

---

安装

1. 将 GambleNRoll-1.0.0.jar 放入 Mods/ 文件夹（即Mods文件夹的根目录，不要放入子文件夹）
2. 重启服务器
3. 使用 /gamble 打开赌博界面