Throwablearrow

# 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

```yml 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: ```yml { "model": { "type": "minecraft:model", "model": "oom:item/arrows/coolarrow" } } ``` Then you can give yourself the item in game with `/minecraft:give @p minecraft:arrow 1`