ThrowableArrow

ThrowableArrow is a lightweight Paper plugin that adds simple throwable arrow-like items to Minecraft.

It was designed for servers that want custom consumable projectiles, such as throwing sticks, spikes, darts, or other RPG-style items. Players can right-click with a configured arrow item to launch it as a projectile. The item is consumed, the projectile deals fixed configurable damage, and it cannot be picked up afterward.

Features

• Create custom throwable arrow items using item models
• Configure fixed damage for each throwable item
• Optional support for vanilla minecraft:arrow
• Consume one item on throw
• Prevent thrown arrows from being picked up
• Automatic despawn after a configurable delay
• Cooldown system to avoid spam
• Reload command to apply config changes without restarting the server
• Startup cleanup for old plugin arrows left in the world after a restart or crash

Configuration example

arrow-speed: 2.8
despawn-seconds: 30
cooldown-ticks: 4

# If true, vanilla minecraft:arrow can also be thrown by right-clicking it in hand.
# You must also define minecraft:arrow in the throwables section.
vanilla-arrow: false

throwables: minecraft:arrow: damage: 4.0

namespace:name: damage: 6.0

namespace:name2: damage: 12.0

namespace:name3: damage: 20.0

namespace:name4: damage: 40.0

## Commands

/throwablearrow reload

## Permissions

throwablearrow.reload: description: Allows reloading the ThrowableArrow config. default: op

## Requirements
* Paper server
* Minecraft 1.21.4+
* Custom item models if you want custom throwable items

## How do I use item models?
You need a texture pack compatible with 1.21.4+ and `item_model`.
ThrowableArrow identifies custom throwable items using their Minecraft `item_model`.
The model key in your item plugin must match the key in `config.yml`.

Example config:

```yml
throwables:
  oom:arrows/coolarrow:
    damage: 6.0

In your texture pack, you can have something like this:

{
  "model": {
    "type": "minecraft:model",
    "model": "oom:item/arrows/coolarrow"
  }
}

Then you can give yourself the item in game with /minecraft:give @p minecraft:arrow[minecraft:item_model="oom:arrows/coolarrow"] 1