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

• Realistic physics — fireballs fly in a straight trajectory without gravity, just like in FireballFight
• Customizable knockback — impact knockback with adjustable horizontal and vertical force
• Rocket Jump — the shooter also receives knockback (can be disabled)
• Cooldown system — configurable cooldowns for each fireball type
• Custom fireballs — create unique fireballs via an interactive chat wizard
• WorldGuard integration — 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

• Paper 1.16.5+ (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

# 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