MKFireballs

MKFireballs

> Bring fireball mechanic to any gameplay!

Realistic throwable fireballs with knockback in the style of FireballFight 1.8.9 for Minecraft 1.16.5+.

Features

- Full customization — fireballs fly in a straight trajectory without gravity, just like in FireballFight - Full customization — impact knockback with adjustable horizontal and vertical force - Full customization — the shooter also receives knockback (can be disabled) - Full customization — configurable cooldowns for each fireball type - Full customization — create unique fireballs via an interactive chat wizard - Full customization — region protection from block destruction (blacklist/whitelist modes) - Full customization — velocity, explosion power, fire setting, lifetime, item material

Installation

1. Download the latest version of the plugin 2. Place the `.jar` file into your server's `plugins` folder 3. Restart the server 4. Configure `config.yml` to your liking

Dependencies

- WorldGuard 7.x (or compatible fork) - WorldGuard 7.x (optional, for region protection)

Commands

| Command | Description | Permission | |---------|-------------|------------| | `/mkfireballs help` | Show help menu | — | | `/mkfireballs reload` | Reload configuration | `mkfireballs.admin` | | `/mkfireballs list` | List all fireballs | — | | `/mkfireballs give <name> [player] [amount]` | Give a fireball | `mkfireballs.admin` | | `/mkfireballs create <name>` | Create a custom fireball (chat wizard) | `mkfireballs.admin` | | `/mkfireballs delete <name>` | Delete a custom fireball | `mkfireballs.admin` |

Aliases: `/mkfb`, `/fireballs`

Permissions

| Permission | Description | Default | |------------|-------------|---------| | `mkfireballs.use` | Use fireballs | Everyone | | `mkfireballs.admin` | Access admin commands | OP | | `mkfireballs.bypass.cooldown` | Bypass cooldowns | OP |

Configuration

config.yml

```yaml

Plugin prefix

prefix: "&6&l[MKFB] &r"

Global fireball settings

fireball: velocity: 1.6 # Flight speed break-blocks: true # Block destruction explosion-power: 2.5 # Explosion power (1.0 = TNT) set-fire: false # Block ignition max-lifetime-ticks: 200 # Lifetime (20 ticks = 1 second) default-cooldown: 5 # Default cooldown (seconds)

Knockback settings

knockback: enabled: true horizontal: 1.2 # Horizontal force vertical: 0.45 # Vertical force max-vertical: 1.0 # Maximum vertical velocity radius: 4.0 # Application radius affect-shooter: true # Knockback for the shooter shooter-multiplier: 1.0 # Multiplier for the shooter

WorldGuard integration

worldguard: enabled: true mode: blacklist # blacklist or whitelist regions: - "spawn" - "lobby"

Default item

default-item: material: FIRE_CHARGE name: "&c&lFireball" lore: - "&7Right-click to throw" - "&7Cooldown: &e{seconds}s" ```

Custom Fireballs

Custom fireballs are created using the `/mkfb create <name>` command and saved as individual `.yml` files in the `plugins/MKFireballs/fireballs/` folder.

Chat wizard prompts: 1. Display Name (supports `&` color codes) 2. Material (e.g., `FIRE_CHARGE`, `BLAZE_POWDER`) 3. Cooldown (seconds) 4. Velocity (flight speed) 5. Explosion power 6. Break blocks (true/false) 7. Set fire (true/false) 8. Max lifetime ticks 9. Knockback enabled (true/false) 10. Knockback horizontal 11. Knockback vertical 12. Knockback radius

To cancel, type `cancel` in chat.

Usage

1. Give yourself a fireball with `/mkfb give default <player>` 2. Hold the item in your hand 3. Right-click to throw 4. The fireball will fly straight and explode on impact or after its lifetime expires

Licence

This project is distributed under the MIT License