ElytraShahed

ElytraShahed turns Elytra flights into Shahed-style sorties. Strap on TNT helmets that detonate on any collision, hand out instantly recharging AA-Guns and trigger configurable reactive boosts—all with TNT stock checks, RU/EN l

Download

ElytraShahed

GitHub Releases

License: MIT

Support me on Ko‑fi

ElytraShahed is a Paper plugin that turns Elytra pilots into controllable “Shahed” kamikaze drones with configurable blast power, gives defenders an instant‑recharging anti‑air AA‑Gun, and adds a clean reactive boost for mid‑air thrust. It’s perfect for events, minigames, raids, and chaotic PvP/PvE moments.

- GitHub (source, issues, releases): https://github.com/pon4ikisdonut/ElytraShahed - Modrinth: https://modrinth.com/plugin/elytrashahed

- Why Use - Features - Installation Guide - Commands - Permissions - Configuration - Compatibility - Use Cases - Reporting Issues - Support Development

Why Use

- Make Elytra combat actually thrilling: touch anything → boom. - Give the ground a fair answer: AA‑Gun with automatic recharge. - Provide configurable “rocket thrust” without extra entities or lag. - Keep balance in check with strict permissions and config caps.

Features

- Shahed Mode with Precise Collisions - ` /shahed [scale] ` arms a TNT “helmet”. Any contact with blocks, entities, or firework hits triggers an immediate explosion. - Accurate hitbox checks (BoundingBox/VoxelShape) — no ghosting, no missed hits. - Explosion power = base × scale, clamped by `max-shahed-power`. - Original helmet is restored on disable, death, or logout. - Consumes TNT equal to `scale` (Creative does not consume).

- AA‑Gun (Anti‑Air) - ` /aagun ` grants an unbreakable “AA‑Gun” crossbow preloaded with a powerful red firework. - Automatically recharges after each shot — always ready for the next target. - Great for shooting down flying Shaheds.

- Reactive Boost - Right‑click the configured item (default `NETHERITE_SCRAP`) while gliding to gain sustained forward thrust. - No extra entities — just pure velocity; strength is configurable. - Requires `elytrashahed.reactive`; consumes the item (not in Creative).

- Localization and Rich Logging - Languages: `ru`, `en`, `uk`, `pl`, `de`, `kk`, `es` (switch in config). - Logs key actions: activations, explosions, AA‑Gun deliveries, boosts, config reloads — handy for moderation.

Installation Guide

1. Download the latest JAR from Modrinth or GitHub Releases. 2. Drop it into your server’s `plugins/` folder. 3. Start the server. A default `config.yml` will be generated and startup info (language, max power, boost item/power) will be logged. 4. Quick test: run ` /shahed 3 `, start gliding, clip a block — you should explode and get your original helmet back.

Commands

| Command | Description | Permission | Default | |--------------------|-----------------------------------------------|----------------------------|---------| | `/shahed [scale]` | Toggle Shahed mode or set explosion power | `elytrashahed.shahed` | OP | | `/aagun` | Receive the instant‑recharging AA‑Gun | `elytrashahed.aagun` | OP | | `/elytrareload` | Reload the plugin configuration | `elytrashahed.reload` | OP |

Permissions

- `elytrashahed.shahed` — Control Shahed mode (activate/change scale). - `elytrashahed.aagun` — Receive AA‑Gun crossbow. - `elytrashahed.reactive` — Use reactive boost item. - `elytrashahed.reload` — Reload configuration.

Grant to players via your permissions plugin to open access beyond OPs.

Configuration

Generated at `plugins/ElytraShahed/config.yml`: ```yaml language: ru # ru, en, uk, pl, de, kk, es max-shahed-power: 16 # clamps explosion scale for /shahed reactive-boost-item: NETHERITE_SCRAP reactive-boost-power: 3 ``` - Apply config changes live with ` /elytrareload `.

Compatibility

- Server: Paper 1.21.x - Folia: supported - Java: 21+ - Dependencies: none (single JAR) - Bukkit/Spigot are untested. Older Paper not officially supported.

Use Cases

- “Raid Night”: allow a few pilots to use `elytrashahed.shahed` (cap `max-shahed-power`), arm defenders with AA‑Gun for intense air battles. - Minigame “Shahed vs. AA”: attackers fly with limited TNT; defenders hold AA‑Gun. - PvP servers: keep only the mobility boost behind `elytrashahed.reactive`, enable Shahed during special events.

Reporting Issues

- GitHub Issues: https://github.com/pon4ikisdonut/ElytraShahed/issues - Please include: - Server type/version (Paper/Folia), Java version - Your plugin list (if you suspect conflicts) - `config.yml` and relevant logs (activations/explosions/reloads)