Zombie Swarm PRO 1.0.4

🧟 Core AI and Horde Logic

Formation Movement: Zombies don't just pile up chaotically. The plugin calculates a center of mass (centroid) and assigns individual radii to each space so the horde moves as a tactical unit.

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

• Horde State Machine: The horde intelligently alternates between three states:

• Dynamic Patrol: They don't wander aimlessly. The AI uses a random behavior system with customizable probabilities to run, walk, or suddenly stop and observe, making their movements completely unpredictable for players.

• Pursuit: They pursue the player when the player enters their detection range.

• Attack: They engage in melee combat and assault structures.

• Shoot Alert: If a player shoots a horde member from a distance, the group will immediately enter a state of alert, locate the attacker, and counterattack.

• Horde Maintenance: Did the players manage to eliminate a couple of zombies from the squad? If you activate this option, the swarm will call for reinforcements and dynamically regenerate casualties to maintain constant pressure on the prey.

⚔️🔥 Base Assaults and Humanized NPCs

• Structure Assaults: If a player tries to hide inside their base to escape the swarm, they won't be safe! The zombies will detect if the target is inside a building and will start tearing down doors, walls, and barricades to get in.

• Configurable Damage and Aggression: You can precisely adjust the amount of damage (HP) inflicted on structures per hit and multiply their aggression level.

• Realistic Impact Effects: When hitting wood, stone, or metal (even the highest quality), the plugin generates accurate visual and sound effects based on the material, creating a terrifying immersion in a true zombie siege.

🎭 Visual, Sound, and Loot Customization

• Custom Appearance: Decide if you want to be attacked by classic scarecrows, zombified humans, or a random combination.

• Themed Clothing and Weapons: If you use human NPCs, you can randomly dress them in military, survivalist, construction worker, raider, and even a fun but creepy "ghost sheet" outfit. They can also carry machetes, knives, axes, or bone clubs.

• Horror Atmosphere (Sounds and Eyes): You can enable glowing eyes to make them stand out in the darkness of night, custom zombie sounds, and terrifying scream effects when they die.

• Full Loot Control: Don't want players to get rich by killing zombies? You can disable their loot so the hordes are a pure danger and not a source of resources, or leave it enabled as a reward.

⚙️ Population Control and Performance

• As a server administrator, I know how the number of NPCs can affect performance. This plugin was designed from the ground up to be lightweight.

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

• Horde Limit per Player: In addition to timeouts, you can set a strict limit on how many simultaneous hordes can attack a single player at the same time, ensuring a fair and balanced survival experience.

• Player Cooldown: Prevent a single player from being constantly harassed by defining a safe cooldown time 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: The plugin uses advanced NavMesh sampling and water level checks to ensure that zombies only spawn on valid and accessible terrain, thus preventing erroneous spawns underwater or inside rocks.

• No Global Scanning: The code avoids heavy scans of the entire map, using efficient NavMesh calls and a controlled refresh rate.

• Spawn Cycle: Zombies can be configured to spawn only during the night or day (e.g., from 6:00 PM to 8:00 AM) and self-destruct at the end of the cycle.

📊  Administration Tools

• Staggered Spawning: Zombies don't all spawn at once, preventing lag spikes on the server. They appear one by one with a slight millisecond delay, an advanced technique for optimizing performance (lag-free).

• 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 (Broadcast): Informs the entire server about events via automated chat messages. Includes fully customizable HEX colors and prefixes (Example: [Zombie Swarm] Beware! A massive horde is approaching...). Announcements can also be broadcasted at automatic time intervals.

• Admin Status Reports: Configure the plugin to automatically notify admins with active horde status, sizes, and types at intervals, allowing you to monitor server activity in real-time.

🖥️ Server Integration, Commands & Permissions

The plugin offers complete control over the apocalypse cycle. Server Admins (Auth Level 2) have full access by default.

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 how many swarms are active, the total number of zombies on the map, and the current entity type.

•   /swarm clear: Immediately clears all swarms, zombies, and corpses from the map (ending events).

•   /swarm reload: Reloads the configuration file and restarts the system without needing to restart the server.

•   /swarm entity [npc_human | scarecrow]: Changes the type of NPC that spawns in real-time without editing files.

•   /swarm attack "Player Name": Summons a swarm directly against a specific player, regardless of the time of day (perfect for events or streamers).

•   /swarm msg: Instantly broadcasts a custom important announcement to all players on the server.

⚙️ Configuration file:

{
  "General Settings": {
    "Debug Mode (true/false)": false,
    "Enable Auto Status Message": true,
    "Status Message Interval (Minutes)": 10.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)": 12.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)": true,
    "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 Aggression Multiplier (1.0 - 2.0)": 1.5,
    "Zombie Health (HP)": 200.0
  },
  "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, random)": "random",
    "NPC Human Weapon (machete, bone.club, salvaged.cleaver, hatchet, random)": "random",
    "Enable NPC Human Armor (true/false)": true
  },
  "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": {
    "Clear Corpses in the end (true/false)": true,
    "Enable Drop Loot (true/false)": true
  }
}

Support

If you find any bugs or have any suggestions for new features, please let me know.

You can also join my Discord server to share feedback, suggestions, and ideas with the community. 👉 Discord

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

https://imgur.com/cMAMUq3