CustomTNT

CustomTNT is a Minecraft plugin that adds fully customizable TNT types with unique explosion effects, block interactions, and mechanics. Perfect for servers looking to enhance gameplay with dynamic explosive tools.

Features

• Create custom TNT variants with configurable names, power, fire effects, and block replacement.
• Unique TNT types such as:
  • Fluid Cleaner TNT – Removes water and lava within a 10-block radius.
  • Frost TNT – Freezes water and creates ice in a 5-block radius.
  • Mini TNT – Small explosion, safe for building.
  • Medium TNT – Moderate explosion, ignites blocks.
  • Mega TNT – Massive explosion with wide destruction.

Commands

/customtnt get <key>
Gives a player a custom TNT item by its key.

Examples

• /customtnt get liquidcleaner – Receive Fluid Cleaner TNT.
• /customtnt get frost – Receive Frost TNT.

Permissions

• customtnt.admin – Required to use /customtnt commands.

Configuration

All TNT types can be configured in the plugin’s config.yml.
Each TNT entry supports:

• name – Custom display name (supports gradients).
• power – Explosion power (radius is roughly power / 2).
• setfire – Whether the TNT ignites nearby blocks.
• breakblocks – Whether the TNT breaks blocks.
• replaceblocks – Configure block replacement (e.g., turn water/lava into air or ice).
• description – Lore text shown on the item.

For developers

Plugin provides a simple API that allows developers to hook into custom TNT explosions. You can listen to the CustomTntExploadEvent to detect when a custom TNT type explodes and modify its behavior. Methods:

• CustomTnt getCustomTnt() – Returns the CustomTnt object representing the exploding TNT (contains its key, power, and configuration).
• EntityExplodeEvent getEvent() – Returns the original Bukkit EntityExplodeEvent, allowing you to cancel or modify the explosion.