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.

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

⚔️🔥 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

• • 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).

⚙️ 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.

Featured by:

✅ New: Real-time Visual Config Panel (/swp)

✅50+ configurable settings

✅8+ strategic performance checks

✅10+ administrative commands

✅Optimized for servers with 50–150+ players

📊 Administration Tools

• Zombie Swarm Pro v1.0.8 includes an optional additional panel (GUI) called the ZSProPanel, which provides a complete in-game graphical interface for editing plugin settings without manually modifying JSON files. Now, administrators can modify all settings in real time within the game. No more manual .json file edits and server restarts to optimize your apocalypse.

• Refined Status Reports: The /swarm status command and automatic messages now show more detail, including the current Boss count and the active/paused state of the system.

• Custom Announcement System: Broadcast automated chat messages with customizable HEX colors and prefixes.

• Redesigned Admin Menu: The help menu (/swarm help) has been visually updated for better readability.

🖥️ 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

• /zwp: Open the Pro Visual Configuration GUI (Panel).
• /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
},
"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 maintained and will continue to evolve with new smart features, gameplay improvements, and more fun mechanics.

Your feedback helps shape the future of this project.