Zombie Swarm PRO — Complete Installation and Configuration Guide
Requirements
Before installing the plugin, make sure you have:
• A working Rust server
• The uMod framework (Oxide) o (Carbon)
• FTP access or a control panel (Pterodactyl, etc.)
• Administrator privileges on the server
________________________________________
Step-by-Step Installation
1. Upload the plugin
1. Go to the folder:
/serverfiles/oxide/plugins/
2. Upload the file:
ZombieSwarmPro.cs
________________________________________
2. Restart or reload
You can do either:
Option A (recommended):
oxide.reload ZombieSwarmPro
Option B:
Restart the server
________________________________________
3. Verify installation
In the console:
oxide.plugins
You should see:
ZombieSwarmPro
________________________________________
Permissions
The plugin Use:
zombieswarmpro.admin
Grant permissions:
oxide.grant group admin zombieswarmpro.admin
Or to a user:
oxide.grant user "USER" zombieswarmpro.admin
________________________________________
Plugin Commands
Main Command:
/swarm
Subcommands:
Command Function
/swarm clear Removes all hordes
/swarm reload Reloads configuration
/swarm status Displays current status
/swarm entity scarecrow Changes zombie type
/swarm entity npc_human Creates human-type zombies
/swarm entity random Creates random mix
/swarm attack "Player Name": Summons a swarm directly against a specific player, regardless of the time of day (use quotes if the name contains spaces).
/swarm msg: It is a tool for the administrator to send an important announcement to all players on the server instantly. (It is managed in the configuration)
________________________________________
Complete Configuration
File:
/oxide/config/ZombieSwarmPro.json
________________________________________
General Configuration
Parameter Description
Zombies Per Horde Number per horde
Max Global Maximum global number of zombies
Hordes Per Player Number of hordes per player
Damage to Structures Damage to Basics
Recommended:
• PvE: 4–6
• Hardcore: 8–12
________________________________________
Night System or swarm rounds
Parameter Description
Start Hour Start time (18 = night)
End Hour End time (8 = day)
✔ Hordes ONLY appear in this range. (You can also set them to run 24/7 if you wish)
________________________________________
AI and Behavior
Parameter Description
DetectionRange Distance to detect players
AttackDistance Attack distance
ZombieAggression Aggression level (1.0–2.0)
Very important:
• 1.0 = normal
• 2.0 = extremely aggressive
________________________________________
Movement and Speed
Parameter Description
ZombieSpeed Speed (0.1–1.0)
SlotRadius Formation spacing
Tip:
• 0.5 = balanced
• 0.8 = difficult
• 1.0 = Very hardcore
________________________________________
Spawn System
Parameter Description
Spawn Min Distance Minimum distance
Spawn Max Distance Maximum distance
✔ Prevents spawning on top of the player
________________________________________
Patrol System
Parameter Description
PatrolRandom Random behavior
RunProbability Probability of running
StopProbability Probability of stopping
PatrolRadius Patrol radius
________________________________________
Combat Reaction
Parameter Description
Attack When Shot They attack when you shoot
ShotAlertDuration Alert duration
This activates "aggressive horde" mode
________________________________________
NPC Types
Option Description
scarecrow Classic zombies
npc_human Infected humans
random Mix
________________________________________
NPC Equipment Humans
Parameter Options
NPCHumanClothing military, raider, worker, etc.
NPCHumanWeapon machete, hatchet, etc.
EnableNPCHumanArmor true/false
________________________________________
Visual Effects
Parameter Description
EnableGlowingEyes Glowing eyes
EnableZombieSound Sounds
________________________________________
Cleanup
Parameter Description
ClearCorpsesOnDay Cleans corpses
DropLootWhenCleared Drops loot or not
________________________________________
Automatic Message
Parameter Description
EnableSupportMessage Automatic message
SupportMessageInterval Interval (min) Configurable periodic message that shows the number of active swarms and zombies on the map according to the number of players (example: swarms = 6 | zombies = 35/80).
Important Notes (Troubleshooting)
1. NavMesh: Zombies require your map to have a generated NavMesh (standard on official maps). If you are using a custom map and the zombies are not moving, make sure the map has a baked NavMesh.
2. Safe Zones: By default, zombies ignore players inside Safe Zones to prevent abuse in Bandit Camp or Outpost.
3. Performance: The plugin is optimized. If you have a server with limited resources, keep the Max Global Zombies below 100. (This is important)
________________________________________
Support
If you encounter any issues or have suggestions for new features, please open a ticket on my Codefling profile or join my Discord for direct support.
This plugin will receive continuous improvements, including additional features and performance enhancements constantly.
—Alexprojects
________________________________________