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