Dice Roller (Roleplay Dice & Random Player Selector!) - Dice Roller - 角色扮演骰子与随机玩家选择器

Dice Roller 是一款专为角色扮演设计的骰子插件，让你在服务器中轻松投掷各种骰子，结果可以私下查看或广播给所有人，并支持丰富的自定义选项。

💡核心功能

• 投掷经典的角色扮演骰子（如 D20、D100），结果可选择仅自己可见或向全服广播。
• 一次性投掷多个骰子，并显示每个骰子的结果与总和。
• 从当前在线的玩家中随机选择一位。
• 投掷自定义面数的骰子。
• 在投掷时产生粒子效果（需 Minecraft 1.9 及以上版本）。
• 可在配置中设置单次最大投掷数量，并提供权限以绕过此限制。
• 可为投掷和广播投掷设置冷却时间。
• 所有提示信息均可通过配置文件自定义。
• 支持 Venture Chat！可在指定的聊天频道内进行投掷。

🎮命令列表

基础与管理命令

• /diceroller - 显示插件帮助信息。
• /diceroller reload - 重载所有配置和消息文件。

私人投掷命令 (/roll)

• /roll d<#> - 投掷一个指定面数的预设骰子。
• /roll d<#> [数量] - 投掷多个指定面数的预设骰子。
• /roll c<#> - 投掷一个指定面数的自定义骰子。
• /roll c<#> [数量] - 投掷多个指定面数的自定义骰子。
• /roll player - 随机选择一名在线玩家。

> 注意：使用 /roll 命令的结果默认仅对执行命令的玩家可见。

广播投掷命令 (/broll)

• /broll d<#> - 投掷一个预设骰子并将结果广播给全服。
• /broll d<#> [数量] - 投掷多个预设骰子并将结果广播给全服。
• /broll c<#> - 投掷一个自定义骰子并将结果广播给全服。
• /broll c<#> [数量] - 投掷多个自定义骰子并将结果广播给全服。
• /broll player - 随机选择一名在线玩家并将结果广播给全服。

> 注意：使用 /broll 命令需要相应的广播权限。

🔧权限节点

管理权限

• diceroller.* - 拥有 Dice Roller 插件的所有权限。
• diceroller.reload - 允许重载配置和 messages.yml 文件。
• diceroller.help - 允许查看基础帮助信息。

查看与绕过权限

• diceroller.broadcast.view - 允许玩家查看广播的骰子结果。
• diceroller.bypass.* - 允许绕过所有限制。
• diceroller.bypass.max - 允许绕过配置中设置的单次最大投掷数限制。
• diceroller.bypass.roll - 允许绕过普通投掷的冷却时间。
• diceroller.bypass.broadcast - 允许绕过广播投掷的冷却时间。
• diceroller.seeall - 允许查看其他玩家使用 /roll 进行的私人投掷结果。

私人投掷权限 (/roll)

• diceroller.roll.* - 允许使用所有 /roll 命令选项。
• diceroller.roll.custom - 允许使用 /roll 投掷自定义骰子。
• diceroller.roll.player - 允许使用 /roll player 随机选择玩家。
• diceroller.roll - 允许使用基础的 /roll 命令及预设骰子。

广播投掷权限 (/broll)

• diceroller.broadcast.* - 允许使用所有 /broll 命令选项。
• diceroller.broadcast.custom - 允许使用 /broll 广播投掷自定义骰子。
• diceroller.broadcast.player - 允许使用 /broll player 广播随机选择玩家。
• diceroller.broadcast - 允许使用基础的 /broll 命令及预设骰子。

✨默认配置摘要

config.yml 主要设置

venturechat:
  use: false # 是否启用VentureChat集成
  use-whitelist: false # 是否使用频道白名单
  whitelist-channels: # 允许使用投掷命令的频道列表
    - local
    - roller

commands:
  base:
    command: "diceroller"
    aliases: ["dr", "droller"]
  roll:
    command: "roll"
    aliases: []
  broadcast-roll:
    command: "broll"
    aliases: ["broadcastroll"]

particle-count: 10 # 投掷时的粒子数量
personal-cooldown: 0.2 # 私人投掷冷却时间（秒）
broadcast-cooldown: 1 # 广播投掷冷却时间（秒）
max-rolls: 10 # 单次命令允许的最大投掷次数

# 使用普通 /roll d<#> 时可投掷的预设骰子面数列表
accepted-rolls: [2, 4, 6, 8, 10, 12, 20, 100]

messages.yml 消息变量

所有消息均支持颜色代码（使用 & 符号）。常用变量包括：

• %prefix% - 消息前缀
• %player% - 玩家名
• %sides% - 骰子面数
• %result% - 单次投掷结果
• %count% - 投掷次数
• %total% - 多次投掷总和
• %results% - 多次投掷的详细结果列表
• %seconds% - 冷却剩余秒数