- **
- 提供列表名称时，将其设置为活动命令列表。
- 不带参数时，显示可用的命令列表以及当前活动的列表。
- **权限:** `rollCommand.admin`
- **/rtest**
- 在不强制冷却期的情况下执行一个随机命令。
- **权限:** `rollCommand.admin`
## 配置
插件的配置定义在 [src/main/resources/config.yml](src/main/resources/config.yml) 中。以下是一个示例配置：
```yaml
chosenList: exampleList
commandLists:
diamondList:
cooldown: 120
commands:
- command: "/give %p diamond 64"
weight: 1
- command: "/give %p diamond_block 32"
weight: 2
- command: "/effect give %p haste 300 2"
weight: 3
exampleList:
cooldown: 60
commands:
- command: "/give %p diamond 1"
weight: 1
- command: "/say Hello, %p!"
weight: 2
funList:
cooldown: 30
commands:
- command: "/effect give %p jump_boost 30 3"
weight: 3
- command: "/effect give %p speed 30 2"
weight: 2
- command: "/give %p cookie 1"
weight: 1
```
**配置细节：**
- **chosenList:**
指定 `/roll` 和 `/rtest` 命令使用的活动命令列表。
- **commandLists:**
在此部分下，每个命令列表（例如 `exampleList`、`diamondList`、`funList`）可以拥有自己的冷却时间（以秒为单位）以及命令列表。
每个命令都定义了影响其随机选择概率的权重。
命令中的 `%p` 将被替换为玩家的名称。
## 插件清单
插件的详细信息存储在 plugin.yml 中。此文件定义：
- 插件的 **名称** 和 **描述**。
- 主类，即 `link.kmaba.rollCommand.App`。
- 命令 (`/roll`、`/rlist` 和 `/rtest`) 以及它们的用法说明。
- 所需的权限：
- `rollCommand.use` (默认：true)
- `rollCommand.admin` (默认：op)
## 快速开始
1. **部署插件：**
将编译后的 jar (`rollCommand-0.0.1.jar`) 放入服务器的 plugins 文件夹中。
2. **配置：**
根据需要调整 config.yml 中的设置。
3. **启动服务器：**
启动或重新加载您的服务器。
4. **使用命令：**
- 执行 `/roll` / `/r` 以从活动列表中执行一个随机命令。
- 使用 `/rlist` 查看可用的命令列表或更改活动列表。
- 使用 `/rtest` 测试命令（需要管理员权限）。
# RollCommand 插件
RollCommand 是一个 Minecraft 插件，允许服务器管理员创建和管理随机执行的命令列表。使用此插件，您可以配置多个命令列表——每个列表都有自己的冷却时间和加权命令选择——为您的服务器增添乐趣和多样性。
## 特性
- **随机命令执行：**
使用 `/roll` 命令从当前选择的列表执行一个随机命令。
- **多个命令列表：**
定义几个命令列表，每个列表具有独特的冷却周期和命令权重。
- **加权命令：**
为命令分配权重，以影响其选择的可能性。
- **游戏内管理：**
使用 `/rlist` 命令显示可用的命令列表并选择一个活动列表。
- **管理员测试：**
执行测试命令 (`/rtest`) 以在不影响冷却时间的情况下运行随机命令（仅限管理员）。
## 命令
- **/roll** (别名: `/r`)
- 从活动命令列表执行一个随机命令。
- **权限:** `rollCommand.use`
- **/rlist