Zombie Swarm PRO

Description

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: When attacking a base, NPCs no longer crowd a single point. The AI calculates “tactical slots” in a row/tangent to the structure, allowing the swarm to spread out and assault multiple sections simultaneously.
  • Base Assault AI: If a player takes refuge, the horde will detect nearby structures and actively attack foundations, doors, and barricades to reach their objective.
  • Ranged Combat & Reload System: NPCs 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 weapon capacity.
  • NPC Interaction Modes (New v1.0.7): Administrators can now define how the swarm interacts with other NPCs on the server:
    • attack: The swarm will engage any other NPC they encounter.
    • passive: Defensive behavior only (only counter-attack).
    • ignore: Completely ignore external NPCs to focus only on players.
  • Overhauled Boss AI (Updated v1.0.7): Elite Commanders now feature more lethal and configurable intelligence:
    • Configurable Engagement Range: A new “Boss Vision Range” setting allows precise control over how far a Boss can detect and track enemies.
    • Weapon Damage Levels: Heavy weapons (Minigun, HMLMG, M249) can now be set to Low, Medium, or High damage modes for perfect server balance.
    • Advanced Target Memory: Bosses now maintain target memory more reliably and use improved aiming logic to prevent losing players behind cover.
    • Suppression Fire & Smart Rocket Aiming: Specialized logic for automatic bursts and ballistic calculations for rockets (pitch/yaw) to ensure hits from different heights.
  • Horde State Machine: The horde intelligently alternates between Dynamic Patrol (walking, running, or observing), Pursuit, and Attack.

Base Assaults and Advanced Combat

• • 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 from classic scarecrows, bandits, rebels, or zombified humans.
  • Expanded Character Presets (New v1.0.7):
    • New Human Archetypes: Added jason and prisoner presets.
    • New Boss Outfits: Added krieg and nomad styles to the existing Juggernaut, Tactical, Demon, Legendary, and Abyss categories.

Population Control and Performance

• Memory & Performance Optimization (Updated v1.0.7):
  • Improved active swarm tracking and target validation to reduce CPU overhead.
  • Fixed edge cases where Boss routines could continue after death, ensuring complete memory release.
  • The formation system is optimized to handle large swarms (50+ NPCs) without frame drops.
• Smart Spawning (New v1.0.7):
  • Improved /swarm here command: Now spawns the horde in front of the admin instead of directly on their position.
  • Advanced NavMesh sampling and safety validation to prevent spawns underwater or inside rocks.
• Strict Global Limits: Configure a maximum number of simultaneous zombies and hordes across the entire server to protect FPS.
• Spawn Cycle & Cleanup: Zombies can be configured to spawn only at night and self-destruct at dawn.
• Smart Entity Cleanup: Automatic tracking and removal of dropped backpacks and expired event entities to prevent server bloat.
• Detailed Debug Logging: New diagnostic messages for swarm generation and spawn attempts to help admins troubleshoot their configuration.

Administration Tools

• • Refined Status Reports: The /swarm status command and automatic messages provide real-time details, including current Boss counts, active swarm entities, and the system’s paused/active state.
  • Advanced Debug Logging (New v1.0.7): Added a new diagnostic layer. The plugin now generates detailed logs for swarm generation, Boss spawning, event cleanup, and failed spawn attempts, allowing admins to troubleshoot configuration issues with precision.
  • Improved Forced Spawning (New v1.0.7): The /swarm here command has been optimized for convenience; it now spawns the horde and Bosses directly in front of the administrator’s view instead of on top of their current position.
  • Custom Announcement System: Broadcast automated chat messages to the server with full support for customizable HEX colors and unique prefixes.
  • Redesigned Admin Menu: The help menu (/swarm help) is visually optimized for better readability, making it easier to manage the apocalypse on the fly.

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 (/swarm help) has been visually redesigned for ease of use.

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 /swarm chat commands.

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:

• /swarm status: Shows active swarms, total zombies on the map, and current entity type.
• /swarm toggle: Pauses or resumes the automatic swarm generation on the server.
• /swarm clear: Immediately clears all swarms, zombies, and corpses from the map.
• /swarm reload: Reloads the configuration file without restarting the server.
• /swarm entity [npc_human | scarecrow]: Changes the NPC type in real-time.
• /swarm here: Forces a swarm to spawn exactly at your current position.
• /swarm attack "Player Name": Summons a swarm against a specific player instantly.
• /swarm boss "Player Name": Sends a Boss directly to attack a specific player.
• /swarm cancel "Player Name": Cancels and removes an active swarm attacking a specific player.
• /swarm msg: Broadcasts a custom announcement to all players.

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,
"Interaction with other NPCs (attack / passive / ignore)": "ignore"
},
"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)": 20.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, jason, raider, ghost, maniac, prisoner, 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 Vision/Engagement Range (Meters)": 30.0,
"Boss Rocket Splash Radius (Meters)": 3.0,
"Boss Outfit Type (juggernaut, tactical, raider, scientist, demon, krieg, abyss, nomad, random)": "random",
"Boss Weapon (rocketlauncher, hmlmg, minigun, flamethrower, m249, random)": "random",
"Boss Heavy Weapon Damage Level (low, medium, high)": "medium",
"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",
"Ambient/Scream Sound Prefab": "assets/bundled/prefabs/fx/player/beartrap_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.