🛩️ 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 <x y z> <target_x target_y target_z> low
/shahed attack <x y z> <target_x target_y target_z> high

View Configuration

/shahed config

Modify Settings

Command	Description
/shahed config spawnX <value>	Set drone spawn X coordinate
/shahed config spawnY <value>	Set drone spawn Y coordinate (100-320)
/shahed config spawnZ <value>	Set drone spawn Z coordinate
/shahed config targetY <value>	Set target Y level (-64 to 320)
/shahed config cost <value>	Set launch cost in coins (0-64)
/shahed config particles enable/disable	Toggle explosion particles
/shahed config particles multiplier <0-500>	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

[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