🧟 Swarm Logic

• Movement in Formation: Zombies don’t just pile up chaotically. The add-on calculates a group center and assigns individual radii to each space so the horde moves as a tactical unit.

• Advanced Siege Positioning (New v1.0.6): When attacking a base, NPCs no longer crowd a single point. The AI now calculates “tactical slots” in a row/tangent to the structure, allowing the swarm to spread out and assault multiple sections of a wall or foundation simultaneously.

• Base Assault AI: If a player takes refuge in their base, the horde will detect nearby structures. Zombies will actively attack foundations, doors, and barricades to reach their objective.

• Ranged Combat & Reload System: NPCs are no longer limited to melee. Human zombies can use firearms with a realistic reload system: when they run out of ammo, they retreat briefly or take a dynamic reload time based on the weapon’s capacity.

• Expanded Boss AI (New v1.0.6): Swarms can now spawn elite Commanders with a lethal arsenal:

  • Dynamic Weapons: Bosses are no longer limited to rockets; they can now wield M249, HMLMG, Miniguns, or Flamethrowers.

  • Suppression Fire: A new specialized fire-logic allows Bosses with automatic weapons to track players and fire realistic bursts, providing a high-end challenge.

  • Smart Rocket Aiming: Improved ballistic calculation for rockets, including pitch/yaw adjustments to ensure they hit the target even from different heights.

• Horde State Machine: The horde intelligently alternates between Dynamic Patrol (walking, running, or observing), Pursuit, and Attack.

• Shoot Alert: If a player shoots a horde member from a distance, the group immediately enters an alert state, locates the attacker, and counterattacks.

• Horde Maintenance: The swarm can call for reinforcements and dynamically regenerate casualties to maintain constant pressure.

⚔️🔥 Base Assaults and Advanced Combat Tactics

• Grenade Use: NPCs can throw F1s, Beancans, Molotovs, or Smoke grenades. The plugin calculates realistic physics, trajectories, and launch probabilities.

• Smart Structure Assaults: The AI recognizes weapon types. Melee zombies tear down structures, while NPCs with firearms provide cover fire instead of hitting walls with their weapons.

• Friendly Fire Prevention: Custom damage mitigation prevents zombies from killing each other with their own grenades or boss explosions.

• Configurable Damage: Precisely adjust the HP damage inflicted on structures and multiply the overall aggression level.

• Realistic Impact Effects: Accurate visual and sound effects based on the material hit (wood, stone, or metal).

🎭 Visual, Sound, and Loot Customization

• Custom Appearance & Outfits: Choose between classic scarecrows, bandits, rebels, or zombified humans. Includes categories like military, survivalist, scavenger, raider, and the “Maniac” set.

• New Boss Outfits (New v1.0.6): Added the “Legendary” (Frontier Hazmat) and “Abyss” (Diver Hazmat) categories for Bosses, alongside the existing Juggernaut, Tactical, and Demon styles.

• Horror Atmosphere: Enable glowing eyes, custom zombie sounds, and realistic death screams.

• Full Loot Control: Toggle whether NPCs drop loot or not. The system now tracks and manages dropped backpacks to ensure items are accessible if enabled.

⚙️ Population Control and Performance

As a server administrator, keeping the server stable is a priority. This plugin is designed to be lightweight and handles memory efficiently.

• Memory Optimization: The plugin includes proper memory release routines, clearing grenade trajectories and weapon data dictionaries immediately when an NPC dies. The formation system is also optimized to handle large swarms (50+ NPCs) dynamically.

• Probability-Based Spawn Control: A dice system to decide whether a horde spawns, preventing the map from becoming overrun.

• Horde Limit per Player & Cooldowns: Set a strict limit on simultaneous hordes attacking a single player and define safe cooldown times between attacks.

• Global Limits: Strictly configure a maximum number of simultaneous zombies and hordes across the entire server to protect FPS.

• Smart and Safe Spawning: Uses advanced NavMesh sampling and water level checks to ensure zombies only spawn on valid terrain (no underwater or inside-rock spawns). Avoids heavy global map scans.

• Spawn Cycle: Zombies can be configured to spawn only during specific times (e.g., from 6:00 PM to 8:00 AM) and self-destruct when the cycle ends.

• Smart Backpack Cleanup (New v1.0.6): To prevent entity bloat, the plugin now specifically tracks and cleans up dropped backpacks (item containers) at dawn, ensuring no leftover entities lag the server.

Featured by:

✅50+ configurable settings

✅8+ strategic performance checks

✅10+ administrative commands

✅Optimized for servers with 50–150+ players

📊 Administration Tools

• Staggered Spawning: Zombies appear one by one with a slight millisecond delay. This advanced technique prevents lag spikes when large hordes are generated.

• Automatic Corpse Cleanup: At dawn (or when the event ends), the plugin intelligently cleans up all swarms and corpses to free up server memory.

• Custom Announcement System: Broadcasts automated chat messages with fully customizable HEX colors and prefixes (e.g., [Zombie Swarm] A massive horde is approaching...).

• Admin Status Reports: Configure automatic notifications for admins regarding active horde status, sizes, and types at set intervals.

🖥️ Server Integration, Commands & Permissions

The plugin offers complete control over the apocalypse cycle. Server Admins (Auth Level 2) have full access by default. The help menu () has been visually redesigned for ease of use./swarm help

🔑 Permissions

If you want to grant access to moderators, event organizers, or specific players without giving them full admin rights, use the following Oxide permission:

• zombieswarmpro.admin — Grants full access to all chat commands./swarm

To grant this permission, use your console (F1) or RCON:

• oxide.grant user <PlayerName or SteamID> zombieswarmpro.admin

• oxide.grant group <GroupName> zombieswarmpro.admin

🧩 Admin Commands

⚙️ Configuration file:

{
"General Settings": {
"Debug Mode (true/false)": false,
"Enable Auto Status Message": true,
"Status Message Interval (Minutes)": 5.0
},
"Broadcast Settings (Admin Messages)": {
"Enable Automatic Broadcast (true/false)": false,
"Broadcast Interval (Minutes)": 30.0,
"Admin Broadcast Message": "This is just an example message (replace).",
"Broadcast Prefix (Label)": "[Zombie Swarm]",
"Prefix Color (HEX)": "#ff6b6b"
},
"Swarm Settings": {
"Zombies Per Swarm (Amount)": 6,
"Max Global Zombies (Total NPC Limit)": 80,
"Max Global Swarms (Limit)": 15,
"Spawn Probability per Player (0-100%)": 30,
"Swarms Per Player (Limit)": 2,
"Maintain Swarm Size (Refill missing zombies)": false,
"Spawn Cooldown per Player (Seconds)": 600.0
},
"Time Settings": {
"Start Hour (0-24h)": 18.0,
"End Hour (0-24h)": 8.0
},
"Spawn Settings": {
"Spawn Min Distance (Meters)": 15.0,
"Spawn Max Distance (Meters)": 25.0,
"Spawn Tick (Seconds)": 0.3
},
"Combat Settings": {
"Enable Base Raiding AI (true/false)": false,
"Damage to Structures (HP per hit)": 15.0,
"Zombie Speed Fraction (0.1 - 1.0 multiplier)": 0.5,
"Player Detection Range (Meters)": 40.0,
"Attack Distance (Meters)": 2.0,
"Formation Slot Radius (Meters)": 1.5,
"Control Logic Tick (Seconds)": 0.5,
"Attack When Shot (true/false)": true,
"Shot Alert Duration (Seconds)": 30.0,
"Zombie Melee Attack Speed Multiplier (1.0 - 2.0)": 1.0,
"Zombie Health (HP)": 200.0
},
"Grenade Settings": {
"Enable Grenades (true/false)": true,
"Allow Smoke Grenades (true/false)": false,
"Grenade Type (f1, beancan, smoke, molotov, random)": "random",
"Grenade Throw Probability (0-100%)": 5,
"Grenade Throw Cooldown (Seconds)": 12.0,
"Disable Zombie Friendly Fire (Explosions/Fire)": true,
"Min Throw Distance (Meters)": 5.0,
"Max Throw Distance (Meters)": 25.0,
"F1 Prefab Path (Fallback)": "assets/prefabs/weapons/f1 grenade/grenade.f1.deployed.prefab",
"Beancan Prefab Path (Fallback)": "assets/prefabs/weapons/beancan grenade/grenade.beancan.deployed.prefab",
"Smoke Prefab Path (Fallback)": "assets/prefabs/tools/smoke grenade/grenade.smoke.deployed.prefab",
"Molotov Prefab Path (Fallback)": "assets/prefabs/weapons/molotov cocktail/grenade.molotov.deployed.prefab"
},
"Patrol Settings": {
"Patrol Random Behavior (true/false)": true,
"Patrol Run Probability (0-100%)": 40,
"Patrol Stop Probability (0-100%)": 30,
"Patrol Stop Duration (Seconds)": 3.0,
"Patrol Walk Duration (Seconds)": 5.0,
"Patrol Run Duration (Seconds)": 4.0,
"Patrol Waypoint Interval (Seconds)": 25.0,
"Patrol Radius (Meters)": 50.0
},
"Entity Settings": {
"Entity Type (scarecrow, npc_human, random)": "scarecrow"
},
"NPC Human Settings": {
"NPC Human Clothing (military, survival, scavenger, worker, raider, ghost, maniac, random)": "random",
"Ranged Weapon Chance (0-100%)": 30,
"List of Melee Weapons": [
"machete",
"bone.club",
"salvaged.cleaver",
"hatchet"
],
"List of Ranged Weapons (pistols and shotguns)": [
"pistol.semiauto",
"pistol.revolver",
"pistol.m92",
"shotgun.pump"
],
"Enable NPC Human Armor (true/false)": true
},
"Boss Settings": {
"Enable Boss NPC (true/false)": false,
"Boss Only with NPC Human Type (true/false)": true,
"Boss Spawn Probability (0-100%)": 40,
"Boss Optimal Range (Meters)": 15.0,
"Boss Health (HP)": 800.0,
"Boss Rocket Damage to Structures (HP)": 150.0,
"Boss Rocket Cooldown (Seconds)": 5.0,
"Boss Rocket Range (Meters)": 20.0,
"Boss Rocket Splash Radius (Meters)": 3.0,
"Boss Outfit Type (juggernaut, tactical, raider, scientist, demon, legendary, abyss, random)": "random",
"Boss Weapon (rocketlauncher, hmlmg, minigun, flamethrower, m249, random)": "random",
"Boss Custom Clothing List (Used if Type is empty)": [
"heavy.plate.helmet",
"heavy.plate.jacket",
"heavy.plate.pants"
],
"Boss Clothing Skin ID (0 = default)": 0
},
"Visual & Sound Settings": {
"Enable Glowing Eyes (true/false)": true,
"Enable Zombie Sound Effects (true/false)": true,
"Death Sound Prefab": "assets/bundled/prefabs/fx/player/gutshot_scream.prefab"
},
"Loot & Corpse Settings": {
"Enable Drop Loot (true/false)": false,
"Clear Corpses in the end (true/false)": true,
"Clear Backpacks in the end (true/false)": true
}
}

🔷 Support

If you find any bugs or would like to see new features, please let me know and we’ll gladly find a way to implement them.

This plugin is constantly being maintained and will continue to evolve with smart new features, gameplay improvements, and more fun mechanics.

Your feedback helps shape the future of this project.

—Alexprojects