📖About Throw-a-TNT

Throwable TNT Plugin

Version: Paper/Spigot 1.21.5
Author: TomMustBe12

Overview

This plugin adds a fun and chaotic new feature - Throwable TNT! Players can right-click while holding TNT to throw a primed TNT projectile. TNT is removed from the player’s inventory in Survival mode and explodes after a customizable short fuse.

Server admins can configure the TNT speed and fuse time, and players can toggle the feature on or off with simple commands.

Features

Throw TNT by right-clicking while holding TNT
Works in survival and creative and consumes one TNT per throw in survival
Primed TNT is spawned and follows a realistic trajectory
Configurable fuse duration and velocity multiplier
OP controlled toggle with /tnttoggle for when not in use
Admin commands for global TNT settings
Full permission control for toggles and admin actions
Config means settings are persistent across reboots.

Commands & Permissions

`/tnttoggle`

Toggles throwable TNT on/off for the executing player
Permission: throwabletnt.toggle (default: OP only)

`/tntspeed <speed>`

Sets the global speed multiplier for thrown TNT
Example: /tntspeed 1.5
Permission: throwabletnt.admin (default: OP only)

`/tntfuse <ticks>`

Sets the global fuse time in ticks (20 ticks = 1 second)
Example: /tntfuse 40 sets a 2-second fuse
Permission: throwabletnt.admin (default: OP only)

`/throwabletnt reload`

Reloads the plugin’s configuration
Permission: throwabletnt.admin (default: OP only)

Permissions Summary

Permission	Description	Default
`throwabletnt.toggle`	Allows players to toggle throwable TNT	OP only
`throwabletnt.admin`	Allows configuring fuse/speed and reloading	OP only

Usage Instructions

Make sure you’re holding TNT in your hand.
Right-click (air or block) to throw the TNT.
If you’re in Survival mode, one TNT will be removed from your inventory.
The TNT will fly forward, then explode after the set fuse time.
Use /tnttoggle to enable or disable your own throwable TNT usage.

Example

/tnttoggle          # Enables or disables throwable TNT for you
/tntspeed 2.0       # Sets the throw speed to double the normal velocity
/tntfuse 60         # Sets fuse time to 3 seconds
/throwabletnt reload  # Reloads config