[RU]

🛸 Drone — Управляемый дрон-камикадзе с системой РЭБ!

Drone — это уникальный тактический плагин для серверов Minecraft 1.21.1 (Paper/Spigot), который добавляет в игру полностью управляемые ударные беспилотники типа «Шахед-136», а также технологичные средства защиты — блоки радиоэлектронной борьбы (РЭБ) и детекторы частот.

Этот плагин идеально впишется в концепцию военных, анархических, PvP или RP серверов, добавляя глубину в механику воздушных угроз и обороны баз.

---

🌟 Ключевые Особенности

• ✈️ Реалистичный 3D-силуэт: Дрон генерируется в реальном времени из плотных цветных частиц, создавая узнаваемую треугольную форму (дельта-крыло) беспилотника «Шахед».
• 🕹️ Полное управление: Игрок запускает дрон и переходит в режим наблюдателя. Направление полета полностью синхронизировано с камерой игрока (куда смотрит пилот — туда летит и дрон).
• 🔊 Атмосферный звук двигателя: Полет сопровождается характерным низким жужжанием, имитирующим работу бензинового мотора.
• 🎨 3 Милитари-цвета: Доступны три строгих армейских цвета: черный (black), белый (white) и серый (gray).
• 🛡️ Полноценная система РЭБ (Глушилки): Блоки-глушилки создают защитные зоны. При влете в эту зону дрон теряет управление, у пилота мигает предупреждение о потере связи в Action Bar, а сам дрон падает вертикально вниз.
• 📉 Шанс осечки РЭБ (75%): Упавший в зоне глушения дрон с вероятностью 75% не детонирует на полную мощность (боевая часть дает осечку, создавая лишь маленькую воронку от удара). В остальных 25% случаев происходит полный взрыв.
• 📡 3D-Купол безопасности: Специальный детектор РЭБ при удержании в руке проецирует красивейший полусферический красный купол из плотных частиц вокруг глушилок. Оптимизировано: купол видит только тот игрок, который держит детектор.

---

🛠️ Команды и Права (Commands & Permissions)

Команда	Описание	Право (Permission)	Доступ по умолчанию
/drone [цвет]	Запустить дрон выбранного цвета (black/white/gray)	drone.use	OP (Администраторы)
/drone jammer	Получить блок Глушилки РЭБ (Лодстоун)	drone.admin	OP (Администраторы)
/drone detector	Получить прибор Детектора РЭБ (Осколок эха)	drone.admin	OP (Администраторы)
/drone reload	Перезагрузить файлы конфигурации плагина	drone.reload	OP (Администраторы)

---

⚙️ Конфигурация (config.yml)

Плагин полностью настраивается под баланс вашего сервера. Поддерживается перевод всех строк и HEX-цвета формата &#RRGGBB.

# Настройки взрыва дрона
explosion:
  power: 5.0          # Сила взрыва при обычном попадании (5.0 - мощнее ТНТ)
  set-fire: true       # Поджигать ли блоки вокруг
  break-blocks: true   # Разрушать ли блоки вокруг

# Настройки дрона
drone:
  spawn-height: 10     # На сколько блоков выше игрока спавнить дрон
  particle-size: 1.3   # Размер цветных частиц

# Звук полета ("звук мопеда")
sound:
  type: "ENTITY_BEE_LOOP" 
  volume: 1.5
  pitch: 0.5              # Низкий гудящий тон

# Настройки системы глушилок (РЭБ)
jammer:
  radius: 20                  # Радиус действия глушилки в блоках (сфера/купол)
  material: "LODESTONE"       # Блок глушилки
  detector-material: "ECHO_SHARD" # Предмет детектора
  dud-chance: 75              # Шанс в процентах (0-100), что заглушенный дрон НЕ сдетонирует при падении
  dud-explosion-power: 1.5    # Сила взрыва-ямки, если дрон упал без детонации боевой части

# Доступные цвета дрона
colors:
  default: "gray"
  black: "#1a1a1a"
  white: "#ffffff"
  gray: "#7f8c8d"

# Системные сообщения (поддерживают HEX-цвета типа &#ff0000)
messages:
  prefix: "&#2c3e50[&4&lDRONE&#2c3e50] &r"
  summoned: "%prefix%&#2ecc71Дрон запущен! Вы вошли в режим управления."
  exploded: "%prefix%&#e74c3cДрон успешно детонировал!"
  already-flying: "%prefix%&#e74c3cВыуже управляете дроном!"
  no-permission: "%prefix%&#c0392bУ вас нет прав на использование этой команды!"
  only-players: "Эту команду могут использовать только игроки."
  cancelled: "%prefix%&#f39c12Управление дроном отменено."
  reload: "%prefix%&#2ecc71Конфигурация успешно перезагружена!"
  invalid-color: "%prefix%&#e74c3cНеверный цвет! Доступные цвета: black, white, gray."
  jammed-actionbar: "&#c0392b&l[СВЯЗЬ ПОТЕРЯНА] ДРОН ГЛУШИТСЯ СИСТЕМОЙ РЭБ!"
  jammed-dud: "%prefix%&#f39c12Дрон был заглушен РЭБ и разбился без детонации (осечка)!"
  jammed-detonated: "%prefix%&#e74c3cДрон был заглушен РЭБ, но сдетонировал при падении!"
  jammer-give: "%prefix%&#2ecc71Вы получили Глушилку Дронов (РЭБ)!"
  detector-give: "%prefix%&#2ecc71Вы получили Детектор Глушилок!"

---

📦 Установка и запуск

1. Перенесите скачанный файл Drone.jar в папку plugins на вашем сервере.
2. Запустите или перезапустите сервер для генерации стандартных файлов.
3. Откройте /plugins/Drone/config.yml, настройте плагин под свои предпочтения.
4. На сервере пропишите команду /drone reload для мгновенного применения настроек!

[EN]

🛸 Drone — A controllable kamikaze drone with an electronic warfare system!

Drone is a unique tactical plugin for Minecraft 1.21.1 (Paper/Spigot) servers that adds fully controllable Shahed-136-style attack drones to the game, as well as advanced defensive measures—electronic warfare (EW) blocks and frequency detectors.

This plugin fits perfectly into the concept of military, anarchist, PvP, or RP servers, adding depth to the mechanics of aerial threats and base defense.

---

🌟 Key Features

• ✈️ Realistic 3D Silhouette: The drone is generated in real time from dense colored particles, creating the recognizable triangular shape (delta wing) of the “Shahed” drone.
• 🕹️ Full Control: The player launches the drone and switches to spectator mode. The flight path is fully synchronized with the player’s camera (wherever the pilot looks, the drone flies).
• 🔊 Atmospheric Engine Sound: The flight is accompanied by a characteristic low hum, mimicking the sound of a gasoline engine. The sound stops instantly upon detonation or shutdown.
• 🎨 3 Military Colors: Three austere military colors are available: black (black), white (white), and gray (gray).
• 🛡️ Full-Fledged EW System (Jammers): Jammer blocks create protective zones. Upon entering this zone, the drone loses control, a warning about loss of connection flashes in the pilot’s Action Bar, and the drone itself falls straight down.
• 📉 Chance of Electronic Warfare Misfire (75%): A drone that falls within the jamming zone has a 75% chance of not detonating at full power (the warhead misfires, creating only a small crater from the impact). In the remaining 25% of cases, a full explosion occurs.
• 📡 3D Safety Dome: When held in the hand, a special EW detector projects a beautiful hemispherical red dome of dense particles around the jammers. Optimized: only the player holding the detector can see the dome.

---

🛠️ Commands & Permissions

Command	Description	Permission	Default Access
/drone [color]	Launch a drone of the selected color (black/white/gray)	drone.use	OP (Administrators)
/drone jammer	Obtain an EW Jammer block (Lodestone)	drone.admin	OP (Administrators)
/drone detector	Obtain an EW Detector device (Echo Shard)	drone.admin	OP (Administrators)
/drone reload	Reload plugin configuration files	drone.reload	OP (Administrators)

---

⚙️ Configuration (config.yml)

The plugin is fully customizable to suit your server's balance. All strings and HEX colors in the &#RRGGBB format are supported.

# Drone explosion settings
explosion:
  power: 5.0          # Explosion power on a normal hit (5.0 - more powerful than TNT)
  set-fire: true       # Whether to set surrounding blocks on fire
  break-blocks: true   # Whether to destroy surrounding blocks

# Drone settings
drone:
  spawn-height: 10     # How many blocks above the player to spawn the drone
  particle-size: 1.3   # Size of colored particles

# Flight sound (“moped sound”)
sound:
  type: “ENTITY_BEE_LOOP” 
  volume: 1.5
  pitch: 0.5              # Low humming tone
# Jammer System Settings (Electronic Warfare)
jammer:
  radius: 20                  # Jammer radius in blocks (sphere/dome)
  material: “LODESTONE”       # Jammer block
  detector-material: “ECHO_SHARD” # Detector item
  dud-chance: 75              # Chance in percent (0-100) that a jammed drone will NOT detonate upon impact
  dud-explosion-power: 1.5    # Crater explosion power if the drone falls without the warhead detonating

# Available drone colors
colors:
  default: “gray”
  black: “#1a1a1a”
  white: “#ffffff”
  gray: “#7f8c8d”
# System messages (support HEX colors such as &#ff0000)
messages:
  prefix: “&#2c3e50[&4&lDRONE&#2c3e50] &r”
  summoned: “%prefix%&#2ecc71Drone launched! You have entered control mode.”
  exploded: “%prefix%&#e74c3cThe drone has successfully detonated!”
  already-flying: “%prefix%&#e74c3cYou are already controlling the drone!”
  no-permission: “%prefix%&#c0392bYou do not have permission to use this command!”
  only-players: “Only players can use this command.”
  cancelled: “%prefix%&#f39c12Drone control canceled.”
  reload: “%prefix%&#2ecc71Configuration successfully reloaded!”
  invalid-color: “%prefix%&#e74c3cInvalid color! Available colors: black, white, gray.”
  jammed-actionbar: “&#c0392b&l[LOSS OF COMMUNICATION] DRONE IS BEING JAMMED BY ELECTRONIC COUNTERMEASURES!”
  jammed-dud: “%prefix%&#f39c12The drone was jammed by EW and crashed without detonating (misfire)!”
  jammed-detonated: “%prefix%&#e74c3cThe drone was jammed by EW, but detonated upon impact!”
  jammer-give: “%prefix%&#2ecc71You have received a Drone Jammer (Electronic Countermeasures)!”
  detector-give: “%prefix%&#2ecc71You have received a Jammer Detector!”

---

📦 Installation and Setup

1. Move the downloaded Drone.jar file to the plugins folder on your server.
2. Start or restart the server to generate the standard files.
3. Open /plugins/Drone/config.yml and configure the plugin to your preferences.
4. Run the command /drone reload on the server to apply the settings immediately!