ElytraShahed

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

Table of Contents

• 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:

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)

Support Development

If you enjoy ElytraShahed and want to help keep updates coming: