ArrowPost

ArrowPost

> Send items to any player — via a homing arrow.

ArrowPost is a Paper 1.21+ plugin that adds a craftable Tracking Bow. Load up to 9 items into it, set a target player, and fire. The arrow warps above them and homes in — dropping the payload at their feet on impact.

---

How It Works

``` 1. Craft or receive a Tracking Bow 2. Sneak + Right-click → load items into the 9-slot payload GUI 3. /aptarget <player> → lock on to a target 4. Shoot → arrow flies, warps above target, homes in 5. Impact → payload drops at their feet ```

If the arrow is blocked before reaching the target it is removed and your payload is preserved — you can shoot again without reloading.

---

Features

- bStats metrics — 4 Ender Pearls + Bow, no permissions required - bStats metrics — sneak + right-click to open; contents persist through restarts - bStats metrics — stored on the player, not the bow; multiple bows can't be used as extra storage - bStats metrics — configurable free-flight delay, then warp teleport above the target and per-tick steering - bStats metrics — arrow follows the target into a new world - bStats metrics — blocked shots leave items intact - bStats metrics — configurable per-player shot cooldown - bStats metrics — PORTAL warp burst, CRIT/ENCHANT trail, smoke + hit on impact - bStats metrics — anonymous usage statistics via bStats metrics

---

Crafting Recipe

``` · E · E B E · E · ```

`E` = Ender Pearl  |  `B` = Bow

---

Commands

| Command | Description | Who | |---------|-------------|-----| | `/aptarget <player>` | Set your homing target | All players (`arrowpost.use`) | | `/aptarget clear` | Clear your current target | All players (`arrowpost.use`) | | `/arrowpost give [player]` | Give a Tracking Bow | Operators only |

Alias: `/ap give [player]`

---

Permissions

| Node | Default | Description | |------|---------|-------------| | `arrowpost.use` | `true` (everyone) | Use the bow and `/aptarget` | | `arrowpost.admin` | `op` | Run `/arrowpost give` |

---

Installation

Drop the jar into your server's `plugins/` folder and restart.

Requirements: Paper 1.21+  |  Java 21+

---

Configuration

`plugins/ArrowPost/config.yml`

```yaml delay-ticks: 40 # Free-flight ticks before homing activates (≥ 20) teleport-height: 500 # Blocks above target the arrow warps to (≥ 5) tracking-radius: 5.0 # Delivery radius in blocks (2.0 – 5.0) arrow-speed: 1.5 # Homing speed in blocks/tick (1.0 – 10.0) cooldown-seconds: 10 # Seconds between shots per player (0 = disabled) effect-particles: true # PORTAL warp, CRIT trail, LARGE_SMOKE on impact effect-sounds: true # Enderman warp, arrow shoot, arrow hit on impact ```

Out-of-range values are automatically clamped on startup with a console warning.

---

License

GNU GPLv3