Throwable Fireballs v1.9.2

Native Minecraft Version:

1.18

Tested Minecraft Versions:

• 1.13
• 1.14
• 1.15
• 1.16
• 1.17
• 1.18

Source Code:

https://github.com/FlailoftheLord/ThrowableFireballs/tree/master

Contributors:

FlailoftheLord

Donation Link:

https://www.paypal.me/FlailoftheLord

Allow players to throw fireballs by Right clicking with a Firecharge or custom item.

This plugin was Built for 1.18+ ONLY and it may work on 1.13+ However I will not guarantee it to work on legacy minecraft.


Current Stable Version: 1.9.2

For Legacy (1.8-1.12) versions use the Legacy download here:
https://github.com/FlailoftheLord/ThrowableFireballs/releases/tag/Legacy-1.0.2
No features are planned or guaranteed to support legacy minecraft.

My first Public Plugin!!! yay

A little showcase


Simple installation: drop into your Spigot / Bukkit plugins folder and restart the server!


WorldGuard Flags:

Code (Text):

   FIREBALLS-ENTITY-DAMAGE
     -  prevents entities from being damaged by fireballs inside this region.
   FIREBALLS-BLOCK-DAMAGE
     - prevents blocks from exploding as a cause of a fireball impact in this region.
 

All messages can be customized in the config as of version 1.4.0
HEX color code support as of v1.8.4

Spoiler: Config

Code (YAML):

#-----------------------------------------------------------------
#==================================================================#
#                                                                  #
#                 Plugin by FlailoftheLord.                        #
#        -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-                   #
#                                                                  #
#   ______               __        _____                           #
#   |       |           /  \         |        |                    #
#   |__     |          /____\        |        |                    #
#   |       |         /      \       |        |                    #
#   |       |_____   /        \    __|__      |______              #
#                                                                  #
#==================================================================#
#-----------------------------------------------------------------
# Wether the fireball does a natural, Ghast-Initiated explosion.
# NOTE: this will not cause as much knockback and may not cancel block damage.
# if set to true the below values will be ignored.
# if set to false, the plugin will use the below explosion settings
# for creating the explosion manually.
NaturalExplosion: false
# Set the Explosion Power of the Fireball on impact, set it to 0 to disable
FireballExplosionPower: 2
ImmuneBlocks:
- "Chest"
- "trapped_chest"
- "ender_chest"
# This means that any block containing the word 'stone' in its' name will not be blown up.
ImmuneBlockKeywords:
- "stone"
# Set the amount of damage the fireball does to an entity or player.
# 1 = one heart
FireballDamage: 3.5
# Set wether the Fireball does fire on impact or not
FireballSetFire: true
# Any number above 0 will use a different mechanic to launch the fireball, preventing it from exploding on your head sometimes.
LaunchPosition: 0
# Whether you can throw a fireball from your offhand
AllowOffhandThrowing: true
# Should players be allowed to use regular fire charges like fireballs?
UseFirecharge: false
# Set the maximum number of blocks in height you can jump with a fireball
MaxJumpHeight: 8
# List of worlds where throwing fireballs is NOT allowed
NoThrowZones:
- "world_the_end"
- "creative_world"
# Message sent if the world is a 'No-Throw-Zone'
NoThrowZoneMessage: "%prefix% &cYou're not allowed to throw fireballs in this world!"
#Plugin prefix for messages
# simply put the placeholder %prefix% in the message, and it will be replaced by this prefix.
Prefix: "&8(&6Fireballs&8)"
ReloadMessage: |-
    %prefix% &aconfig file successfully reloaded,
     &amake sure to restart the server if changing the fireball recipe!
#Message to send to player if no permissions
NoPermissionMessage: "%prefix% &cYou do not have permission to use this"
#Sent when the player doesn't have the permission "fireballs.craft"
NoCraftPermission: "%prefix% &cYou don't have permission to craft this."
# Whether to show cooldown Messages to player or not
CooldownMessageEnabled: true
#Cooldown Message this message is sent to player when above verbose: is set to true
# use the placeholder %cooldown% for the cooldown time in seconds
CooldownMessage: "%prefix% &cYou must wait %cooldown% seconds before throwing this"
# Cooldown between uses in seconds set to 0 to disable
Cooldown: 1
# Don't want it to look like a Fire Charge?
# Change the type of the Fireball item.
FireballItem: "fire_charge"
# Custom display name for the Fireball Item
FireballName: "&6Fireball"
# Heres the lore...
# add as many lines as you want!! :>
Lore:
- "&7right click to throw"
- "&7grief extreme ;)"
# - - -
# Heres the crafting recipe for the Fireballs!
# Set the AmountGiven to any number to set the amount of the item given when you craft it.
# Each line in the Pattern section is one row in the crafting table (3 x 3)
# Change the Letters to anything between 'A' and 'I' then define which material type each
# letter represents in the Materials section below
# You can get a full list of Item names here:
#    https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
# - - -
# The plugin will give you a warning in the console if one of the items is invalid.
CraftingRecipe:
  AmountGiven: 3
  Pattern:
      1: "ABA"
      2: "BCB"
      3: "ABA"
  Materials:
      A: "GUNPOWDER"
      B: "FIREWORK_STAR"
      C: "GHAST_TEAR"
      D: ""
      E: ""
      F: ""
      G: ""
      H: ""
      I: ""


 

Commands:

Spoiler: Commands

Code (YAML):

/throwablefireballs (/fireballs)
    description: the main command
    usage: /fireballs [help / reload / updateconfig / get / give]
    permission: fireballs.op

 

Permissions:

Spoiler: Permissions

Code (YAML):

 
permissions:
  fireballs.infinite:
    description: don't ever run outta them!
    default: false
  fireballs.op:
    description: use administrative commands
    default: op
  fireballs.throw:
    description: throw ballz ;D
    default: true
  fireballs.commandthrow:
    description: throw balz using commansz
    default: op
  fireballs.bypass:
    description: bypass the cooldown
    default: false
  fireballs.craft:
    default: true
 
 # Permissions
 #   fireballs.op
 #   fireballs.infinite
 #   fireballs.throw
 #   fireballs.commandthrow
 #   fireballs.bypass
 #   fireballs.craft
 
 

On an additional Note: If you want to be able to rollback/undo fireball block damage use CoreProtect: https://www.spigotmc.org/resources/coreprotect.8631/

When asking for Support, please include the following basic information:
- Minecraft version your spigot server is running.
- List of all plugins running on the server alongside ThrowableFireballs
- If there are errors in the console, please include a copy of your console log file as well.

You can reach me for support via DM's or the Discussion Tab on this resource.


Downloads:
10: :>
50:
100: wow thanks!!
200: heh... more?..?...
300: Oh Mai Gaawwwdddd!
400: SCREEEEEEEEEE!!
500: Lol, gotten on Christmas Day! ;p
600: Yeet!
700: WHoa!!
1000: YOINK! tyvm.
2000: EEYYYYY!!
5000: <3
10,000: <#dabbingisnotcringein2020>
25,000: for some reason it's hit over 25k downloads at some point in time... idk, cool that people still use this thing, i guess i'll have to update it more... :copium:



This Plugin is open-source under the terms of the
GNU General Public License v3.0
And by downloading and using this plugin, you agree to the terms of this license.