◆ Updated the plugin to support Purpur's server implementation
──────────────────────────────────────────────
The plugin now works for Purpur as well.

If you find any bugs in this update then please enter the discussion and post some information about it - thanks!
I will try to fix any reported bug(s) as soon as possible.

◆ Updated the plugin for 1.21+
────────────────────
The plugin version 2.4.0 is only for 1.21 and above. It is not backwards version compatible. Use version 2.3.0 for 1.20.4 and below.

If you find any bugs in this update then please enter the discussion and post some information about it - thanks!
I will try to fix any reported bug(s) as soon as possible.

◆ Throw Ceggs Without Permissions
────────────────────────
One completely new configuration line was added to the config under the "options" section:
| throw-requires-permission | Default value: true

The new configuration line is for server owners that do not want the throwing of ceggs to be locked behind a permission for players. Useful if you do not use permission plugins.

If you do not want to change the default value of the configuration line, you do not need to add the line to your config.yml upon updating the plugin. However if you would like to change the value so that throwing ceggs does not require permissions to be set for players, then you need to add the configuration line under the "options" section in the config and set the value to false.

Here is an example of how you should add the line under the "options" section in your config.yml if you would like to change the default value:

Code (YAML):

options:
   throw-requires-permission : true

If you find any bugs in this update then please enter the discussion and post some information about it - thanks!
I will try to fix any reported bug(s) as soon as possible.

◆ Egg Q Drop Bug Fix
───────────────
There was a bug that made the egg be thrown when a player dropped an egg. This is now fixed.

◆ Creative QoL
───────────
Eggs thrown in creative mode no longer consume an egg.

If you find any bugs in this update then please enter the discussion and post some information about it, thanks!
I will try to fix any reported bug(s) as soon as possible.

◆ 1.20.4+ and Future Versions Support
─────────────────────────
The plugin has been updated to support the latest version of Minecraft and all the other versions that will come after, there is no longer a need to update the plugin every X amount of Minecraft updates to make sure it works. The plugin should work on all versions of Minecraft from this update on. Apologies for the wait.

If you find any bugs in this update then please enter the discussion and post some information about it, thanks!
I will try to fix any reported bug(s) as soon as possible.

◆ 1.20.2 Support
───────────
The plugin now supports 1.20.2!

◆ Damage Scaling Option
─────────────────
[Requested by Kevin_H]
A new option under the "options" configuration section was added, called:
explosion-entity-damage-percentage

The default value for this option is: 100

Because of how servers handle explosions by default, the radius of an explosion scales the amount of damage they do to entities, but you can change that with this new option!

If you wish to change the value of this option and you already have an existing config.yml file, then just copy and paste the entire line below under the "options" section in your own config.yml file:
If you find any bugs in this update then please enter the discussion and post some information about it, thanks!
I will try to fix any reported bug(s) as soon as possible.

◆ Gamebreaking Bug Fix
────────────────
[ Found by illudota ] Thanks!
Fixed a gamebreaking bug that involved a certain gamemode.

If you find any bugs in this update then please enter the discussion and post some information about it, thanks!
I will try to fix any reported bug(s) as soon as possible.

◆ 1.20 & 1.20.1 Support
───────────────
The plugin now supports 1.20 & 1.20.1 versions of Minecraft. Sorry for the delay.

If you find any bugs in this update then please enter the discussion and post some information about it, thanks!
I will try to fix any reported bug(s) as soon as possible.

◆ Absorption Bug Fix
───────────────
[ Found by Aladeen ]
There was a bug when creeper eggs were thrown into WorldGuard regions that had "creeper-explosion" set to deny, where the creeper eggs would explode and leave lingering absorption effects that the player could walk into and get. This is now fixed.

Thrown creeper eggs that explode in regions that don't allow "creeper-explosion" now just drop to the ground and can be picked up.

If you find any bugs in this update - please enter the discussion and post some information about it - thanks!
I will try to fix any reported bug(s) as soon as possible.

◆ Separate Charged Cooldown
───────────────────── | This feature is disabled by default
Now you can have different cooldown times for normal and charged throwable creeper eggs.

Two completely new configuration lines are added to the config under the "options" section:
| throwing-charged-cooldown-enabled | Default value: false
| throwing-charged-cooldown-in-seconds | Default value: 10.0

◆ API Changes
──────────
Due to the new separate charged cooldown feature, the following API methods are deprecated:
| isOnCooldown( Player player )
| putOnCooldown ( Player player )
| getRemainingCooldownTime ( Player player )
| removeCooldown ( Player player )

The deprecated methods can still be used for legacy reasons but they only interact with the normal cooldowns and not the charged cooldowns.

The deprecated methods are replaced by these methods:
| isOnCooldown ( Player player, Cooldowns cooldownType )
| putOnCooldown ( Player player, Cooldowns cooldownType )
| getRemainingCooldownTime ( Player player, Cooldowns cooldownType )
| removeCooldown ( Player player, Cooldowns cooldownType )

Here is a quick example of using one of the new API methods:

Code (Java):

// Removes the player's charged cooldown.
TCEApi. removeCooldown ( Bukkit. getPlayer ( "PlayerName" ), Cooldowns. CHARGED ) ;

There are two types of cooldowns you can get from the Cooldowns class:

Code (Java):

Cooldowns. NORMAL
Cooldowns. CHARGED

The Cooldowns class can be found here:
dev.pixelmania.throwablecreepereggs.cooldown.Cooldowns

● In accordance to the new feature - if you already had a config file generated before this update and you would like to configure the new feature, then please regenerate your config file or add the following default lines under the "options" section in your config file:

Code (YAML):

throwing-charged-cooldown-enabled : false # The value specifies if charged throwable creeper eggs have a separate cooldown or not.
throwing-charged-cooldown-in-seconds : 10.0 # The cooldown in seconds for the charged throwable creeper eggs.

Here is an example screenshot of where to put the new lines:


If you find any bugs in this update - please enter the discussion and post some information about it - thanks!
I will try to fix any reported bug(s) as soon as possible.

◆ Improved CoreProtect Logging
───────────────────────

When CoreProtect compatibility was enabled, there were double the log entries being created because both the default "#creeper" and the custom log-format entries were being produced, which meant duplicate entries with different names and double the amount of pages when getting logs. In this update it is changed so that throwable creeper eggs only produce the custom log-format entries, but regular creepers can still create the default "#creeper" logs.

◆ Bug Fix
───────
Fixed a bug that caused non-TCE items to be thrown when use-any-creeper-egg was set to true

If you find any bugs in this update - please enter the discussion and post some information about it - thanks!
I will try to fix any reported bug(s) as soon as possible.

◆ Small Bug Fixes
─────────────
There were a couple of bugs that happened at specific times that allowed the placement of throwable creeper eggs, even when allow-placement-of-egg was false in the config. This should be fixed now.

If you find any bugs in this update - please enter the discussion and post some information about it - thanks!
I will try to fix any reported bug(s) as soon as possible.

◆ 1.19.3 Support
────────────
The plugin now supports 1.19.3

◆ Cobweb Interactivity Types
────────────────────
[ Requested by illudota ]
Cobweb interactivity types is a new feature that allows you to change how thrown creeper eggs interact with cobwebs.

There are four types of interactivity types:
The VANILLA type does not change how thrown creeper eggs interact with cobwebs.
| This is the default type

The BOUNCE type will make it so that thrown creeper eggs bounce off of cobwebs when touched from the side or the bottom.

The DESTROY type will make it so that the thrown creeper egg is destroyed upon touching a cobweb.

The EXCLUDE type will make it so that the thrown creeper egg explosion does not destroy any cobwebs.

One completely new configuration line is added to the config:
| cobweb-interaction-type

◆ Changed the log-format default value
───────────────────────────

The log-format line under the CoreProtect compatibility section has a new default value, because before there were spaces in the format so that rollback wouldn't work because the "user" parameter doesn't take kindly to spaces. The new default format: log-format: "#thrown_creeper_egg_by_</player>" It is recommended that you change the format to have no spaces.

● In accordance to the new feature - if you already had a config file generated before this update and you would like to configure the new feature, then please regenerate your config file or add the following default lines on the very bottom of your config file:
If you find any bugs in this update - please enter the discussion and post some information about it - thanks!
I will try to fix any reported bug(s) as soon as possible.

◆ Charged and Normal Give Commands
───────────────────────────
Added a new parameter to the "/tce give" command, with two values:
• Use /tce give <player> normal <quantity> to give the player a non-charged TCE egg.

• Use /tce give <player> charged <quantity> to give the player a charged TCE egg.

You can still use the old command style: "/tce give <player> <quantity>" to give the player a non-charged TCE egg. This is for legacy reasons so the commands that are set in automatic systems still work, but it is preferred that they are switched to the new ones.

◆ Charged Creeper Eggs
─────────────────
A new section in the config was added for charged creeper eggs.

● In accordance to the new charged creeper egg feature; if you already had a config file generated before this update and you would like to configure the charged creeper egg section, then please regenerate your config file or add the following default lines under the "creeper-egg" section in your config file:

◆ Small Fix: Glowing Option
─────────────────────
The glowing option now works on all versions of Minecraft. (1.8 - 1.19)
Glowing is enabled by default on the charged creeper egg. You can change this in the config.

◆ Small Fix: Given Quantities Stacking
────────────────────────────
TCE eggs that were given in different quantities would not stack with other TCE eggs that had a different quantity when given. This should hopefully be fixed now.

If you find any bugs in this update - please enter the discussion and post some information about it - thanks!
I will try to fix any reported bug(s) as soon as possible.

◆ Non-TCE Spawn Egg Bug Fix
─────────────────────
[ Bug Found by _DJDan ] Thanks!
There was a bug where if you clicked with a standard (non TCE) spawn egg in your hand, then multiple NullPointerException errors would appear in the console. This should hopefully be fixed now.

If you find any bugs in this update - please enter the discussion and post some information about it - thanks!
I will try to fix any reported bug(s) as soon as possible.

◆ CoreProtect Compatibility Fix
──────────────────────
[ Issue Found by _DJDan ] Thanks!
There was an issue with how Throwable Creeper Eggs was logging the creeper explosions in older versions of Minecraft. It should hopefully be fixed now.

◆ Support for 1.19.1 & 1.19.2
────────────────────
These versions are now supported.

If you find any bugs in this update - please enter the discussion and post some information about it - thanks!
I will try to fix any reported bug(s) as soon as possible.

◆ 1.19 Support
───────────
The plugin now supports 1.19

If you find any bugs in this update - please enter the discussion and post some information about it - thanks!
I will try to fix any reported bug(s) as soon as possible.

◆ Charged Chance Feature
──────────────────
You can now throw creeper eggs that have a configurable chance out of 100 to turn into charged creepers. The explosion radius is multiplied by a configurable amount for charged creepers.

| Feature disabled by default

One completely new main configuration section is added to the config:
| randomly-charged

● In accordance to the new feature - if you already had a config file generated before this update and you would like to configure the new feature, then please regenerate your config file or add the following default lines on the very bottom of your config file:
◆ Default Messages Section Change In Config
───────────────────────────────
In the default prefix of all the messages, the "TCE" part was yellow colored - "&e" but it has been changed to a green color - "&a".

In the "reloaded-config" line under the "messages" section, "config.yml" was changed to "config".

If you find any bugs in this update - please enter the discussion and post some information about it - thanks!
I will try to fix any reported bug(s) as soon as possible.

◆ Custom Mob Drop Feature
────────────────────
You can now configure which mobs have a certain percentage to drop a throwable creeper egg, and the looting enchantment can increase the chance of dropping, which is also configurable.

One completely new main configuration section is added to the config:
| drop-configuration

| Feature disabled by default

● In accordance to the new feature - if you already had a config file generated before this update and you would like to configure the new feature, then please regenerate your config file or add the following default lines on the very bottom of your config file:
If you find any bugs in this update - please enter the discussion and post some information about it - thanks!
I will try to fix any reported bug(s) as soon as possible.

◆ 1.18.2 Support
────────────
The plugin now supports 1.18.2.
I apologize for not being able to update to 1.18.2 sooner.

If you find any bugs in this update - please enter the discussion and post some information about it.
I will try to fix the bug(s) as soon as possible.

◆ Hopper Fix
─────────
[ Found by illudota ] Thanks!
When throwing creeper eggs (TCE) onto a hopper - it would suck it in, but the TCE egg would still explode and you would also get the TCE egg back. It is now fixed.

◆ Dispenser Fix
───────────
While testing the hopper issue, I also found that dispensers could dispense TCE eggs - and a creeper would spawn. It is now fixed.

◆ About 1.18.2
──────────
The plugin works on 1.18.1 and below, but I still haven't found a fix for the 1.18.2 NBT issue - I apologize.

◆ Bug Fix
───────
[ Found by _DJDan ]
There was a bug when the allow-placement-of-egg line under the options section had the value of false - the issue was that players couldn't place regular creeper eggs until the value was true.

◆ Ease of Use Change
───────────────
When the server is 1.12.2 or under, you can still use the default material line value CREEPER_SPAWN_EGG for a creeper egg, but it is recommended to put MONSTER_EGG instead.

◆ Small Bug Fix
───────────
[ Found by illudota ]
There was a bug when the material was a firework rocket while right clicking on a block with the item - it would result in an error.

◆ Material Customization
─────────────────
[ Requested by Kevin_H ]
Now you can customize the material of the throwable 'creeper egg' item.

◆ Hidden Creeper
────────────
[ Requested by Kevin_H ]
Now you can hide the creeper that appears on top of the creeper egg when exploding.

One new line was added to the creeper-egg section in the config:
> material

One new line was added to the options section in the config:
> hide-creeper-when-exploding

| material is CREEPER_SPAWN_EGG by default in the config.
| hide-creeper-when-exploding is false by default in the config.

● In accordance to the new features - if you already had a config file generated before this update and you would like to configure the new features, then please regenerate your config file or add the following default lines under the correct sections in your current config file:

Code (YAML):

creeper-egg:
   material : CREEPER_SPAWN_EGG

Code (YAML):

options:
   hide-creeper-when-exploding : false # Works best when not thrown into unloaded chunks

◆ API Changes
───────────
The getUniqueEggItem method was updated for the new material customization feature.


Found a Bug?
─────────
If you find any bugs then please send me a message .

◆ 1.18 Support
──────────
1.18 is now finally supported!

◆ Cooldown Feature
──────────────
[ Requested by illudota ]
Now you can finally put an end to those pesky egg spammers!

Two new lines have been added to the options section in the config:
use-throwing-cooldown and throwing-cooldown-in-seconds

One new line was added to the messages section in the config:
throwing-while-cooldown

| Feature enabled by default in the config with a value of 5.0 seconds

● In accordance to the new feature - if you already had a config file generated before this update and you would like to configure the new feature, then please regenerate your config file or add the following default lines under the correct sections in your current config file:
◆ API Changes
───────────
The API was updated with new methods for the cooldown feature.

isOnCooldown ( org.bukkit.entity.Player )
Returns a boolean value which indicates if the player is currently on cooldown.

putOnCooldown ( org.bukkit.entity.Player )
Puts the specified player on cooldown.
Returns a boolean value which returns false if the player is already on cooldown and returns true if the player was successfully put on cooldown.

getRemainingCooldownTime ( org.bukkit.entity.Player )
Get the remaining seconds of the player's cooldown.
Returns a double value which is the remaining time of the player's cooldown and returns 0 if the time is below 0.

removeCooldown ( org.bukkit.entity.Player )
If the player has a cooldown applied when this method is called, then it will be removed and the player can throw an egg.


Found a Bug?
─────────
If you find any bugs then please send me a message.

◆ New Addition
───────────
Added block filtering.

You can now exclude specific blocks from exploding and include specific blocks as well ( if the include type is used, then all the blocks that are not in the filtering list, will be excluded from the explosion )
| Disabled by default in the config
options.explosion-destroys-blocks needs to be true

● In according to the new additions, if you already had a config file generated before this update and you would like to enable and configure the block filtering list, then please regenerate your config or add the new lines somewhere separate from the other lines in your config.yml:

◆ New Addition
───────────
Added CoreProtect compatibility, it can be enabled and configured in the config.yml.
| Disabled by default in the config.yml

◆ Small Issue Fix
───────────
...

● In according to the new additions, if you already had a config file generated before this update and you would like to change the CoreProtect compatibility values, please regenerate your config or add the new lines on the bottom of your config.yml:

◆ New Addition
───────────
Added WildStacker compatibility, the thrown creeper and egg( thrown one ) no longer get stacked ( they were getting stacked and TCE didn't like that so it didn't work properly ).

◆ Small Fix
──────────
Fixed an issue with " use-creeper-fuse-animation". When it was set to true, the creeper egg that the creeper rides on was not removed after the explosion. - ( Thanks Lambsauce )

◆ Small Change
──────────
A new line in the config under " options" was added, it's called " include-spawners-in-explosion" and the value of it ignores the value of " explosion-destroys-blocks", which means that having " explosion-destroys-blocks" as false will still destroy spawners if " include-spawners-in-explosion" is true.

Also, the value of " explosion-radius" needs to be " 2" or higher in order for spawners to be included in the explosions ( if " include-spawners-in-explosion" is true ).

Because of this small change, the " compatibility" lines were removed as new the option replaces it.

● In according to the small change, if you already had a config file generated before this update and you were using the MineableSpawners compatibility lines, then please please regenerate your config or add the new " include-spawners-in-explosion" line under " options" like the other lines ( and the " compatibility" lines can be removed ).

Small Version Incompatibility Fix

◆ New Additions
───────────
• New config line under options called explode-in-mid-air | Default value is true | Value changes whether the TCE Creeper can explode while flying through the air

• New config line under options called explosion-destroys-blocks | Default value is true | Value changes whether the TCE Creeper can explode blocks | The value of this line doesn't affect "tce-break-spawners"

• New config line under options called explosion-damages-entities | Default value is true | Value changes whether the TCE Creeper damages other entities on explosion

◆ Small Change
──────────
• If a player is blown up by another player's TCE creeper, then the death message will include the name of whoever threw the creeper | Example : Player1 was blown up by Creeper is changed to Player1 was blown up by Player2's Creeper

◆ New API Methods
─────────────
• Added new Methods in the API called getWhoThrewCreeperUUID which accepts a parameter of org.bukkit.entity.Item or org.bukkit.entity.Creeper and returns a UUID value of the player that threw the Creeper Egg

• Added new Methods in the API called getWhoThrewCreeperName which accepts a parameter of org.bukkit.entity.Item or org.bukkit.entity.Creeper and returns a String value of the player's name that threw the Creeper Egg

● In according to the new additions, if you already had a config file generated before this update and you would like to change the new options' values, please regenerate your config or add the new lines under " options:" like the other lines.

◆ New Additions
• Added a new line in the config under options which is called throwing-velocity-multiplier which like the name suggests, multiplies the throwing velocity | Default value is 1.0

◆ New Version
• 1.17 versions are now supported

● In according to the new additions, if you already had a config file generated before this update and you would like to change the velocity multiplier, please regenerate your config or add the new line under " options:" like the other lines.
● Before, it wasn't stated anywhere but right after jumping, if a creeper egg is thrown, then it would be thrown a tiny further and a tiny bit faster.

• Added a new line in the config file for toggling spawner breaking with MineableSpawners | In the config file, explosion-radius under options should be set to a minimum of 2 as MineableSpawners checks the radius ( force of explosion ) in order to break the spawners | This option is enabled by default, if you would like to disable this and you already had the plugin installed before the update, please regenerate your config file or add the new lines into the config file on the bottom.
• Changed how creepers explode | Creepers now explode by calling their explode method with NMS instead of just creating an explosion in the world, which now calls EntityExplodeEvent.

◆ New Additions
• Added a method in the API called isCreeperEgg which accepts a parameter of org.bukkit.inventory.ItemStack. This method returns a boolean value if the ItemStack is a Creeper Egg or not through the versions of 1.7 to 1.16.4.

● It is important that if you already have this plugin installed but with an older version, you will need to regenerate the config file when updating to the current version of the plugin.

Please make a backup of your current config by renaming the file to something else and then regenerate the config file by restarting the server or by doing "/reload" (not recommended) to get the new options after updating the plugin.

◆ New Additions
• Added use-creeper-fuse-animation to the config.
This option is only for versions 1.15 and above.

◆ Changes
• The plugin now supports versions below 1.12.2. ( 1.7 to 1.16.4 )
• Several changes to some option names in the config and default lore.

The 1.0.0c version of the plugin now works on 1.13 and above versions of Minecraft.

- Fixed a bug where other spawn eggs couldn't be placed
- Fixed a bug where it multiplies the amount of eggs you get from the /tce give command.

If you would like to download the 1.12.2 ( 1.0.0b ) version of the plugin head over to https://www.spigotmc.org/resources/throwable-creeper-eggs.75877/history

This version of the plugin ( 1.0.0c ) is only for above 1.13