# 可发射的火焰球
## 描述
**可发射的火焰球**插件允许玩家使用**火焰充能**发射火焰球。火焰球的速度、爆炸半径、强度和伤害可以进行自定义。此外，该插件支持生命周期功能，这意味着如果火焰球在指定时间后没有击中任何东西，将自动爆炸，从而防止它们在世界中滞留并导致延迟。
玩家可以通过 `config.yml` 文件或游戏内命令直接配置火焰球的行为。
---
## 特性
- **发射火焰球**: 使用火焰充能右键点击以发射火焰球。
- **击中时爆炸**: 火焰球在击中实体或方块时会爆炸。
- **可配置的生命周期**: 设置火焰球的生命周期，以避免因滞留的火焰球而导致性能问题。
- **可配置的伤害**: 调整火焰球爆炸对实体的伤害。
- **方块破坏**: 配置火焰球是否可以在爆炸时破坏方块。
- **速度和强度自定义**: 控制火焰球的速度和爆炸强度。
---
## 配置
该插件允许通过 `config.yml` 文件进行自定义。该文件应放置在插件的主目录中。
### `config.yml`
```yaml
fireball:
# 火焰球的速度（1.0 为正常速度）
speed: 1.0
# 爆炸半径（受影响的方块数）
explosion_radius: 3
# 爆炸强度（越高 = 爆炸越大）
explosion_strength: 4
# 火焰球是否可以破坏方块（true/false）
can_break_blocks: true
# 火焰球爆炸对实体造成的伤害（0 = 无伤害）
damage: 10
# 每发之间射击的冷却时间，单位为秒（在此处未实现）
cooldown: 0.5
# 火焰球在未击中任何东西时爆炸前的生命周期，单位为秒
lifespan: 30
```
### 配置选项
- **`speed`**: 控制火焰球的移动速度。 默认值为 `1.0`（正常速度）。
- **`explosion_radius`**: 爆炸影响的半径（以方块为单位）。 默认值为 `3` 个方块。
- **`explosion_strength`**: 确定爆炸强度。 值越高，爆炸越强。 默认值为 `4`。
- **`can_break_blocks`**: 如果设置为 `true`，则火焰球爆炸会破坏方块。 设置为 `false` 以防止方块破坏。 默认为 `true`。
- **`damage`**: 火焰球爆炸对实体（玩家、生物等）造成的伤害量（在爆炸半径内）。 设置为 `0` 表示无伤害。 默认值为 `10`。
- **`cooldown`**: 指定连续火焰球射击之间的冷却时间（以秒为单位）。 在当前插件版本中未实现，但可以在未来版本中添加。 默认值为 `0.5` 秒。
- **`lifespan`**: 火焰球的生命周期（以秒为单位）。 如果火焰球在这段时间内没有击中任何东西，它将自动爆炸。 默认为 `30` 秒。
---
## 游戏内命令
您可以使用 `/fireballconfig` 命令直接在游戏中调整插件的设置。
### 命令语法
`/fireballconfig <设置> <值>`
- **`<设置>`**: 您要调整的设置（例如，`speed`、`radius`、`damage`、`lifespan` 等）。
- **`<值>`**: 设置的新值（例如，`speed`、`damage` 等的数字，或 `true/false` 对于诸如 `can_break_blocks` 之类的布尔设置）。
### 示例命令
- `/fireballconfig speed 2.0` - 将火焰球速度设置为 `2.0`。
- `/fireballconfig radius 5` - 将爆炸半径设置为 `5` 个方块。
- `/fireballconfig damage 20` - 将爆炸伤害设置为 `20`。
- `/fireballconfig lifespan 60` - 将火焰球生命周期设置为 `60` 秒。
---
## 使用方法
1. **发射火焰球**: 要发射火焰球，只需用**火焰充能**在手中右键点击即可。
2. **击中时爆炸**: 火焰球将在击中任何方块或实体时爆炸。 爆炸行为可以通过 `config.yml` 文件进行自定义（例如，爆炸半径、强度、方块破坏和伤害）。
3. **超时后自动爆炸**: 如果火焰球在配置的 `lifespan` 内没有击中任何东西（默认值为 30 秒），它将自动爆炸，以防止它在世界中滞留。
---
## 示例用例
1. 玩家向一个生物发射一个火焰球，它在击中时爆炸，对生物造成伤害。
2. 如果玩家将火焰球射向空中，并且它没有击中任何东西，它将在 30 秒后（或配置的任何生命周期内）自动爆炸。
3. 爆炸可以破坏方块（如果配置为执行此操作），并且会造成对任何附近的实体（生物或玩家）的伤害。
---
## 安装
1. 下载 **可发射的火焰球** 插件 `.jar` 文件。
2. 将 `.jar` 文件放置在服务器的 `plugins` 文件夹中。
3. 重新启动服务器以启用插件。
4. 通过编辑插件文件夹中的 `config.yml` 文件来自定义插件设置。
5. 如有必要，使用 `/fireballconfig` 命令在游戏中调整设置。