Shootable Fireballs

Shootable Fireballs

Description

The Fire Charges plugin allows players to shoot fireballs using Fire Charges. The fireballs can be customized in terms of speed, explosion radius, strength, and damage. Additionally, the plugin supports a lifespan feature, meaning fireballs will automatically explode if they don't hit anything after a specified period of time, preventing them from lingering in the world and causing lag.

Players can also configure the behavior of the fireballs directly through the `config.yml` file or via in-game commands.

---

Features

- Speed and Strength Customization: Right-click with a fire charge to shoot a fireball. - Speed and Strength Customization: Fireballs explode when they hit an entity or block. - Speed and Strength Customization: Set the lifespan of fireballs to avoid performance issues due to lingering fireballs. - Speed and Strength Customization: Adjust the damage done by fireball explosions to entities. - Speed and Strength Customization: Configure whether fireballs can break blocks on explosion. - Speed and Strength Customization: Control the speed of fireballs and the strength of their explosions.

---

Configuration

The plugin allows customization via the `config.yml` file. This file should be placed in the plugin’s main directory.

`config.yml`

```yaml fireball:

Speed of the fireball (1.0 is normal speed)

speed: 1.0

Explosion radius (blocks affected)

explosion_radius: 3

Explosion strength (higher = bigger explosion)

explosion_strength: 4

Whether fireballs can break blocks (true/false)

can_break_blocks: true

Damage dealt by the fireball explosion to entities (0 = no damage)

damage: 10

Cooldown in seconds between shots (not implemented here)

cooldown: 0.5

Lifespan of fireballs in seconds before they explode if they haven't hit anything

lifespan: 30 ```

Configuration Options

- `speed`: Controls how fast the fireball moves. Default value is `1.0` (normal speed).

- `explosion_radius`: The radius (in blocks) affected by the explosion. Default value is `3` blocks.

- `explosion_strength`: Determines the strength of the explosion. The higher the value, the stronger the explosion. Default value is `4`.

- `can_break_blocks`: If set to `true`, the fireball explosion will break blocks. Set to `false` to prevent block destruction. Default is `true`.

- `damage`: The amount of damage the fireball explosion deals to entities (players, mobs, etc.) within the explosion radius. Set to `0` for no damage. Default is `10`.

- `cooldown`: Specifies the cooldown time (in seconds) between consecutive fireball shots. Not implemented in the current version of the plugin but can be added in future versions. Default value is `0.5` seconds.

- `lifespan`: The lifespan (in seconds) of the fireball. If the fireball does not hit anything within this time, it will explode automatically. Set to `30` seconds by default.

---

In-Game Commands

You can use the `/fireballconfig` command to adjust the plugin's settings directly in the game.

Command Syntax

`/fireballconfig <setting> <value>`

- `<value>`: The setting you want to adjust (e.g., `speed`, `radius`, `damage`, `lifespan`, etc.). - `<value>`: The new value for the setting (e.g., a number for `speed`, `damage`, etc., or `true/false` for boolean settings like `can_break_blocks`).

Example Commands

- `/fireballconfig speed 2.0` - Sets the fireball speed to `2.0`. - `/fireballconfig radius 5` - Sets the explosion radius to `5` blocks. - `/fireballconfig damage 20` - Sets the explosion damage to `20`. - `/fireballconfig lifespan 60` - Sets the fireball lifespan to `60` seconds.

---

Usage

1. Fire Charge: To shoot a fireball, simply right-click with a Fire Charge in your hand.

2. Explosion on Impact: The fireball will explode on impact with any block or entity. The explosion behavior is customizable via the `config.yml` file (e.g., explosion radius, strength, block breaking, and damage).

3. Automatic Explosion After Timeout: If a fireball does not hit anything within the configured `lifespan` (default is 30 seconds), it will explode automatically to prevent it from lingering in the world.

---

Example Use Case

1. A player shoots a fireball at a mob, and it explodes on impact, causing damage to the mob. 2. If the player shoots the fireball into the air and it doesn’t hit anything, it will automatically explode after 30 seconds (or whatever lifespan is configured). 3. The explosion can break blocks if configured to do so, and it will deal damage to any nearby entities (mobs or players).

---

Installation

1. Download the Shootable Fireballs plugin `.jar` file. 2. Place the `.jar` file in the `plugins` folder of your server. 3. Restart the server to enable the plugin. 4. Customize the plugin settings by editing the `config.yml` file (located in the plugin's folder). 5. Use the `/fireballconfig` command to adjust settings in-game if needed.