Stun Combat Drones

Stun Combat Drones

Electric stun weapons for Factorio 2.0. Immobilize biters with powerful electric shocks.

---

Features

⚡ Stun Grenades

Throwable electric grenades that stun all enemies in a large area. Research "Stun Drones" technology to unlock.

🛡️ Stun Drone Defense System

Armor equipment that automatically launches stun drones at nearby enemies. Requires Stun Drone Ammo. Toggle on/off with Shift+T or the shortcut bar button.

📈 Quality System (Factorio 2.0)

All items fully support the quality system:

• Equipment quality: increases damage, AOE radius, stun duration, and energy efficiency.
• Ammo quality: increases per-shot damage, radius, and stun duration.
• Grenade quality: increases AOE damage, radius, and stun duration.

🔬 5 Upgrade Technologies

• Stun Drone Damage — +20% damage per level (7 levels)
• Stun Drone AOE Radius — +1 tile per level (5 levels)
• Stun Effect Duration — +0.5s per level (6 levels)
• Stun Drone Firing Speed — faster auto-attack (5 levels)
• Stun Drone Defense System — unlocks equipment and ammo

---

How It Works

1. Research Stun Drones (requires Military 3 + Battery) → unlocks Stun Grenades.
2. Research Stun Drone Defense System (requires Power Armor + Personal Laser Defense) → unlocks equipment + ammo.
3. Install equipment in power armor, keep Stun Drone Ammo in inventory.
4. Equipment automatically targets and stuns nearby enemies. Toggle with Shift+T.

---

Technical Details

• Multiplayer safe — per-player data, deterministic cache invalidation.
• Performance optimized — player caching, native find_nearest_enemy API, minimal per-tick overhead.
• Configurable — base stun duration, AOE radius, and detection range via mod settings.

---

Settings

| Setting | Default | Description | |---------|---------|-------------| | Base stun duration | 180 ticks (3s) | Base stun time before upgrades | | Base AOE radius | 4 tiles | Base area of effect | | Auto-launch radius | 30 tiles | Enemy detection range (runtime) |

---

Compatibility

• Factorio: 2.0+
• Dependencies: base >= 2.0
• Space Age: compatible (not required)

---

Localization

• 🇬🇧 English
• 🇷🇺 Русский

---

Links

• Changelog
• FAQ

FAQ

Stun Combat Drones — FAQ

General

Q: What does this mod do? A: Adds electric stun weapons to Factorio: throwable stun grenades and an armor-mounted auto-drone system that stuns and damages nearby enemies.

Q: Is this mod compatible with Factorio 2.0? A: Yes. Version 2.3.0 is fully compatible with Factorio 2.0 and later. All deprecated API features (hr_version, string quality IDs) have been updated.

Q: Does it work with Space Age DLC? A: The mod targets base Factorio 2.0 (base >= 2.0). It does not require Space Age but should work alongside it without conflicts.

Q: Is it multiplayer safe? A: Yes. All data is stored per-player in storage, caches are invalidated deterministically, and startup settings are lazily initialized for late-joining players.

---

Equipment & Drones

Q: How does the Stun Drone Defense System work? A: Install the equipment in your power armor. It will automatically launch stun drones at nearby enemies every few seconds (configurable). Each launch consumes 1 Stun Drone Ammo from your inventory and energy from the equipment's internal buffer.

Q: How do I enable/disable the auto-attack? A: Use the shortcut button in the shortcut bar (lightning bolt icon) or press Shift+T. The system remembers each player's toggle state.

Q: What affects damage and stun duration? A: Three factors:

• Technology levels — research Stun Drone Damage, Duration, Radius, and Speed upgrades.
• Equipment quality — higher quality equipment increases damage (+15% per tier), radius (+0.5 per tier), and stun duration.
• Ammo quality — higher quality ammo increases damage (+10% per tier), radius (+0.25 per tier), and stun duration.

Q: How does the energy system work? A: The equipment has a 500 kJ buffer. At normal quality, this allows ~5 shots before needing to recharge from your armor's power grid. Higher quality equipment reduces energy cost per shot, effectively giving more shots per charge.

Q: Why is the shortcut button greyed out? A: You don't have a Stun Drone Defense System installed in your current armor grid.

---

Stun Grenades

Q: How are grenades different from the auto-drone system? A: Grenades are thrown manually (like regular grenades), have a larger base AOE (+2 tiles), deal 25 base damage (vs 20 for drones), and don't require armor equipment. They still benefit from research upgrades and grenade quality.

Q: Does grenade quality matter? A: Yes! Higher quality grenades deal more damage (+10% per tier), have larger AOE (+0.5 per tier), and stun longer.

---

Settings

| Setting | Type | Default | Description | |---------|------|---------|-------------| | Base stun duration | Startup | 180 ticks (3s) | Base stun time before tech bonuses | | Base AOE radius | Startup | 4 tiles | Base area of effect radius | | Auto-launch radius | Runtime | 30 tiles | Detection range for auto-attack |

---

Troubleshooting

Q: Drones aren't firing even though I have ammo and equipment. A: Check that: (1) the system is toggled ON (shortcut bar), (2) your armor has enough energy, (3) there are enemies within the detection radius.

Q: I'm getting errors after updating from an older version. A: Run on_configuration_changed by loading and saving once. If issues persist, check the mod portal for the latest version.