Roulette - 轮盘赌：经典赌场游戏

💡概述

如果你喜欢使用盔甲架的插件，例如 Vehicles、DiceFurniture，那么你也会喜欢这款插件。它提供了一种全新且友好的方式，使用 WASD 键来玩轮盘赌。

🎮主要特性

• 开源且高度可定制：插件完全开源，几乎所有内容均可配置。
• 沉浸式体验：包含动作栏消息、全息图、烟花效果和精美的轮盘模型。
• 游戏类型：支持欧洲轮盘（单零）和美国轮盘（双零）两种类型。
• 下注方式多样：支持单注、列注、打注（12个数字）、高低、奇偶、0及00等多种下注。
• 多人游戏：最多支持10名玩家同时游戏。
• 游戏内菜单编辑器：可直接在游戏内修改游戏设置。
• 高级功能：

- 支持 HEX 颜色代码（用法：`&#RRGGBB`）。

- 支持权限绕过和通配符。

- 彩虹色全息文字（用法：`&u`）。

- 支持货币缩写（例如：`1000000` 显示为 `1M`）。

- 每个下注位置可自定义获胜倍率。

荷官系统

• 可设置手中物品（小球）。
• 可设置不同名称或隐藏名牌。
• 可通过 Mineskin 网站自定义皮肤。
• 可在荷官肩上显示鹦鹉！
• 具备注视、模仿和邀请玩家的行为。

筹码系统

• 可设置不同价格的筹码。
• 可通过 Mineskin 或 Minecraft-Heads 网站自定义皮肤。
• 图形用户界面（GUI）支持无限翻页。

下注系统

• 多重下注：玩家可在同一局中在多个不同位置下注。
• 下注管理菜单：使用空格键打开新菜单，可添加、移除或更改下注，并更改下注颜色。
• 动态下注：使用 WASD 键移动筹码。在 1.21.2+ 版本中，可直接通过玩家视角移动下注。
• 下注预览：使用粒子效果显示当前下注所覆盖的数字。
• 下注限制：可指定玩家每局游戏的最大下注数量。
• 筹码发光效果。

视觉与动画

• 在 1.19.4+ 版本中，使用文本显示实体展示桌台数字。
• 为单笔下注赢得最多钱的玩家播放“Dab”庆祝动画。

特殊规则

支持轮盘特殊规则：La Partage（分彩）、En Prison（囚禁）和 Surrender（投降）。这些规则仅适用于赔率为1:1的外围投注（红/黑、奇/偶、高/低、列注、打注）。

> 注意：“En Prison”规则仅在所需最少玩家数为1时生效。

其他功能

• 胜利凭证（地图物品）。
• 可更改每个桌台的羊毛/木材类型。
• 交易历史记录。
• 支持 1.17 至最新版本。

🔧安装与依赖

前置需求

• 必需：

- `PacketEvents`

- `Vault`

• 可选：

- `PlaceholderAPI` - 用于支持变量。

- `PlayerPoints` - 可作为 Vault 经济系统的替代。

• 经济系统：需要任一经济插件，如 Essentials、CMI 等。

✨命令与权限

命令列表

• /roulette - 显示所有可用命令的帮助信息。

- 权限：`roulette.help`

• /roulette create <名称> <类型> - 创建指定名称和类型（european/american）的新游戏。

- 权限：`roulette.create`

• /roulette delete <名称> - 删除已存在的游戏。

- 权限：`roulette.delete`

• /roulette sessions - 打开游戏会话菜单。

- 权限：`roulette.sessions`

• /roulette reload - 重载插件配置文件。

- 权限：`roulette.reload`

• /roulette map - 获得一张胜利凭证。

- 权限：`roulette.map`

• /roulette force <数字> - 强制指定获胜数字。

- 权限：`roulette.force`

权限节点

• roulette.help - 允许查看可用命令。
• roulette.create - 允许创建游戏。
• roulette.delete - 允许删除游戏。
• roulette.delete.others - 允许删除他人创建的游戏。
• roulette.reload - 允许重载插件。
• roulette.edit - 允许通过右键点击 NPC 打开游戏编辑器。
• roulette.edit.others - 允许打开他人游戏的编辑器。
• roulette.swapchair - 允许在游戏开始前交换椅子。
• roulette.map - 允许接收胜利凭证。

❓如何使用

如何开始游戏？

• 右键点击桌台的全息图或任何部分以加入游戏。
• 你将被安排在一个座位上，直到游戏开始。
• 选择筹码（每种筹码价格不同）。
• 使用 WASD 键将筹码移动到你想下注的位置。
• 等待下注时间结束。
• 荷官开始旋转轮盘，随机数字即为获胜数字。

如何创建自定义筹码？

• 编辑配置文件 chips.yml。
• 添加一个新部分，名称自定。
• 添加要使用的皮肤 URL 及其价格。可参考文件内的示例。
• 前往 minecraft-heads 网站选择头颅。
• 复制“Minecraft-URL”部分显示的链接。
• 将其粘贴到配置文件中。

如何更改荷官（NPC）皮肤？

• 右键点击荷官 NPC。
• 右键点击 GUI 中的第一个物品。
• 在 mineskin 网站上传你的皮肤并复制“Direct Link”。
• 在游戏聊天框中粘贴该链接。

⭐PlaceholderAPI 变量

如果安装了 PlaceholderAPI，可使用以下变量：

• %roulette_win% - 返回获胜次数。
• %roulette_total% - 返回赢取的总金额。
• %roulette_max% - 返回单次赢取的最高金额。
• %roulette_win_{X=partage/prison/surrender}% - 返回通过特定规则（分彩/囚禁/投降）获胜的次数。

💡重要说明

关于 1.16 版本

插件不支持 1.16 版本。原因在于一个无法由插件避免的视觉错误：当玩家按下脱离载具键时，其他玩家看到他仍处于就坐状态，但该玩家自己却看到自己站起来了。此错误在 1.17 版本中被修复。

反馈与建议

如需报告错误或提出建议，请通过私信（DM）或讨论区进行，请不要在评论（Reviews）区发布。

💡如何创建筹码？

前往配置文件 chips.yml。

添加一个以你想要的名称命名的新配置节。

添加要使用的皮肤 URL 及其价格。可以参考文件内的现有示例。

访问 minecraft-heads 网站并选择一个头颅。

复制出现在 Minecraft-URL 部分的链接。

将其粘贴到配置文件中。

💡如何游玩？

右键点击全息影像或赌桌的任何部分即可加入游戏。

你将被安排在一张椅子上，直到游戏开始。

系统会要求你选择一个筹码（每种筹码价格不同）。

使用 WASD 键可以将你的筹码移动到你想下注的位置。

等待选择时间结束。

庄家将开始旋转轮盘，并随机产生一个获胜数字。

💡如何更改 NPC 皮肤？

右键点击 NPC。

右键点击 GUI 中的第一个物品。

在 mineskin 网站上传你的皮肤并复制 Direct Link。

在聊天框中粘贴该链接。

❓特殊规则及其运作方式

请注意，这些规则仅适用于 对等赔率 的投注，即基本上指外部投注，其赔率为 1:1。这些投注包括：

• 红/黑
• 单/双
• 大/小
• 列 & 打

规则如何运作？

点击此处查看每条规则的详细说明。

关于“监禁”规则

“监禁”规则仅在所需最低玩家数为 1 时适用。这是因为，如果玩家的投注被“监禁”，游戏将重新开始，而玩家会留在赌桌上，其被监禁的投注也将无法移动。

🎮PlaceholderAPI 占位符

• %roulette_wins% - 返回玩家的获胜次数。
• %roulette_winnings% - 返回玩家的总赢取金额。
• %roulette_wins_{partage/prison/surrender}% - 返回玩家在特定特殊规则下的获胜次数。

❓为何不支持 1.16？

原因见此。

简而言之，这是一个视觉错误，允许玩家从一个无法被本插件阻止的载具（此处指盔甲架）上下来。当玩家按下脱离键时，其他玩家会看到他仍处于就坐状态，但该玩家自己会看到自己是站立的，且此操作无法被阻止。此错误在 1.17 版本中已修复。