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