Описание
# 🛩️ Shahed Drone Mod
## 📖 Description
This mod adds a fully functional **Shahed kamikaze drone** to Minecraft with realistic sound physics, radar detection system, and air raid alert sirens. Perfect for military-themed servers, minigames, or immersive survival gameplay.
---
## ✨ Features
### 🎯 Shahed Drone
- **Kamikaze UAV** that flies to target coordinates and explodes on impact
- **Two dive modes:** Low (150 blocks) and High (500 blocks) altitude approach
- **Smooth flight physics** with client-side prediction for lag-free visuals
- **Massive explosion** with fire, smoke, debris particles and configurable block damage
- **Kill attribution** — kills are credited to the player who launched the drone
### 🖥️ Terminal Block
- **Control interface** to launch drones
- Enter target **X/Z coordinates** manually
- Shows **launch cost** and your coin balance
- Displays **forbidden zone** warnings
- Beautiful hacker-style **green UI**
### 📡 Radar Block
- Detects drones within **1000 blocks** radius
- **Real-time GUI** with scanning animation
- Shows drone positions as **red blinking dots**
- Hover over dots to see **distance**
- Outputs **redstone signal** (0-15) based on closest drone proximity
### 🚨 Siren Block
- **Air raid siren** activated by redstone signal
- Realistic **distance-based volume** (audible up to 300 blocks)
- Sound stops when block is destroyed
- Repeats every 25 seconds while powered
### 🔊 Realistic Sound System
- **3D positional audio** for all sounds
- **Distance-based volume attenuation** for drone engine
- **5 different explosion sounds** with random selection
- **Sound delay** simulating speed of sound (17 blocks/tick)
- Engine **pitch changes** during dive maneuver
- Smooth **volume transitions** based on player distance
---
## 🎮 Commands
All commands require **permission level 2** (operator).
### Launch Drone
```
/shahed attack low
/shahed attack high
```
### View Configuration
```
/shahed config
```
### Modify Settings
| Command | Description |
|---------|-------------|
| `/shahed config spawnX ` | Set drone spawn X coordinate |
| `/shahed config spawnY ` | Set drone spawn Y coordinate (100-320) |
| `/shahed config spawnZ ` | Set drone spawn Z coordinate |
| `/shahed config targetY ` | Set target Y level (-64 to 320) |
| `/shahed config cost ` | Set launch cost in coins (0-64) |
| `/shahed config particles enable/disable` | Toggle explosion particles |
| `/shahed config particles multiplier ` | Set particle amount (100 = default) |
| `/shahed config blockDamage enable/disable` | Toggle explosion block damage |
| `/shahed config logging enable/disable` | Toggle console logging |
| `/shahed config reload` | Reload config from file |
---
## 📦 Blocks & Items
| Item | Description |
|------|-------------|
| 🖥️ **Shahed Terminal** | Control panel to launch drones |
| 📡 **Shahed Radar** | Detects nearby drones, outputs redstone |
| 🚨 **Siren** | Air raid alert, redstone activated |
| 🪙 **Coin** | Currency for launching drones |
---
## ⚙️ Configuration
Config file: `shahed-common.toml`
```toml
[Spawn Settings]
spawnX = 0
spawnY = 200
spawnZ = 0
targetYLevel = 64
[Cost Settings]
launchCostCoins = 10
[Forbidden Zones]
forbiddenZones = ["0,0,100,100"]
[Explosion Effects]
explosionParticlesEnabled = true
explosionParticleMultiplier = 100
explosionBreaksBlocks = true
[Debug]
loggingEnabled = false
```
---
## 📋 Requirements
- **Minecraft:** 1.20.1
- **Forge:** 47.2.0+
- **GeckoLib:** 4.4+
---
## 🎬 Usage Example
1. Place a **Shahed Terminal**
2. Get some **Coins** from creative tab
3. Right-click the terminal
4. Enter target coordinates
5. Click **LAUNCH**
6. Watch the drone fly and explode! 💥
---
## 🌐 Credits
Developed by **krutnet** for KrutEvent