Overview

A tiny lightweight plugin that lets players throw TNT with a left-click. Fully configurable: power, fuse-time, explode-radius, damage, block breaking, hot-reload, and custom identification to avoid mixing with vanilla TNT. Zero dependencies, designed for Spigot/Paper 1.17 and up

Key Features

• Left-click to throw TNT (configurable power & fuse)

• Custom radius & max damage with distance falloff

• Toggle block breaking per explosion

• Optional custom ID in lore to distinguish “our TNT” from vanilla (ON by default)

• /throwabletnt reload to reload configs & messages

• Multi-language via messages_(language).yml

• Zero dependencies, small footprint, event-driven, no schedulers

Commands & Permissions

• /throwabletnt reload - Reload config & messages (permission: throwabletnt.reload)
• /throwabletnt give - Give throwable TNT (permission: throwabletnt.give)

Config Preview:

# After writing the code below, the plugin will load plugins/ThrowableTNT/messages_<code>.yml
# If the file doesn't exist, it falls back to messages_default.yml
language: default

throw:

Throw power multiplier (launch speed)

launch-speed: 1.2

Fuse seconds (integer) before explosion

fuse-seconds: 3

explosion:

Explosion radius: affects shockwave coverage and damage falloff distance

range: 4.0

Max damage at the explosion center; linearly decreases to 0 by 'range'

max-damage: 18.0

Allow breaking blocks (false = damage only, no terrain damage)

allow-block-break: false

item:

Whether to use a "custom identification tag" in the item's lore.

true: Only "our TNT" (with the custom-id lore) can be thrown with left-click.

false: Any TNT (including vanilla TNT) can be thrown with left-click.

use-custom-id: true

The custom identification line written to the item's lore (supports & color codes)

custom-id: "&8ID: THROW-TNT"

Visuals used only for the /give command (Server owner can rename and change description as needed)

name: "&cThrowable TNT" lore: "&7Left-click to throw, explodes after a few seconds"

Cancel players from right-clicking to place "our TNT" on the ground

Only takes effect when use-custom-id=true; does not take effect when identification is off to avoid interfering with vanilla gameplay.

cancel-right-click-place: true

## How to Add Your Own Language
Copy messages_default.yml → messages_your-language.yml

Translate the messages

Set language: your_CODE in config.yml

/throwabletnt reload